v...

Документация IntegroXL

Надстройка Excel с функциями для работы с ФИО, ИНН и деловыми документами.
Все функции начинаются с INTEGRO_ — начните вводить в ячейке и Excel покажет список.

Сервер: excel.adarcorpstore.store Версия: ...
Кнопка «Пронумеровать»
Проставляет порядковые номера 1, 2, 3... в каждую ячейку выделенного диапазона слева направо, сверху вниз. Находится на вкладке IntegroXL ленты Excel.
Как использовать
  1. Выделите диапазон ячеек
  2. Нажмите кнопку «Пронумеровать» на вкладке IntegroXL
Кнопка «Найти заявку» + авто-поиск по Enter
Ищет номер заявки в столбце B активного листа и переводит курсор на найденную ячейку.

Работает двумя способами:
  1. Авто-поиск: введите номер в ячейку A1 и нажмите Enter — переход происходит автоматически, без нажатия кнопки.
  2. Кнопка «Найти заявку»: нажмите кнопку на вкладке IntegroXL — явный поиск с сообщением, если не найдено.
Алгоритм поиска
ШагДействие
1Читает значение из ячейки A1
2Ищет точное совпадение в столбце B
3Если не найдено — ищет частичное совпадение
4При успехе — переходит к ячейке, строка состояния показывает номер строки
5Если не найдено (кнопка) — показывает сообщение. Авто-режим молчит.
INTEGRO_FIO
=INTEGRO_FIO(фио; падеж; [формат])
Склоняет ФИО в нужный падеж русского языка. Определяет пол автоматически по отчеству. Поддерживает сокращённый формат «Фамилия И.О.»
Параметры
ПараметрТипОписание
фиоСтрокаобязательныйПолное ФИО: «Иванов Иван Иванович»
падежЧисло 1–6обязательныйНомер падежа (см. таблицу ниже)
форматСтроканеобязательный"full" — полное ФИО (по умолч.), "short" — «Фамилия И.О.»
Номера падежей
ПадежВопросПример (Иванов Иван)
1Именительныйкто?Иванов Иван
2Родительныйкого?Иванова Ивана
3Дательныйкому?Иванову Ивану
4Винительныйкого?Иванова Ивана
5Творительныйкем?Ивановым Иваном
6Предложныйо ком?Иванове Иване
Примеры
=INTEGRO_FIO(A1; 2)
Иванова Ивана Ивановича
=INTEGRO_FIO(A1; 3)
Иванову Ивану Ивановичу
=INTEGRO_FIO(A1; 5)
Ивановым Иваном Ивановичем
=INTEGRO_FIO(A1; 2; "short")
Иванова И.И.
=INTEGRO_FIO("Петрова Мария Сергеевна"; 1)
Петрова Мария Сергеевна
INTEGRO_СКЛОН_ФИО
=INTEGRO_СКЛОН_ФИО(фио; падеж; [формат])
Склоняет ФИО в любом формате: полное, И.И., И., фамилия + имя. Сохраняет стиль записи (инициалы не меняются).
Примеры
=INTEGRO_СКЛОН_ФИО("Иванов Иван Иванович";2)
Иванова Ивана Ивановича
=INTEGRO_СКЛОН_ФИО("Иванов И.И.";3)
Иванову И.И.
=INTEGRO_СКЛОН_ФИО("Иванов И.";5)
Ивановым И.
INTEGRO_СКЛОН_ДОЛЖНОСТЬ
=INTEGRO_СКЛОН_ДОЛЖНОСТЬ(должность; падеж; [число])
Склоняет должность с согласованием слов. Дополнение в родительном («главного технолога») не меняет падеж.
Примеры
=INTEGRO_СКЛОН_ДОЛЖНОСТЬ("Технический директор";2)
Технического директора
=INTEGRO_СКЛОН_ДОЛЖНОСТЬ("Генеральный директор";3)
Генеральному директору
=INTEGRO_СКЛОН_ДОЛЖНОСТЬ("Заместитель главного технолога";3)
Заместителю главного технолога
INTEGRO_GREETING
=INTEGRO_GREETING(фио)
Формирует официальное обращение к человеку. Автоматически определяет пол по отчеству и возвращает «Уважаемый» или «Уважаемая» с именем и отчеством.
Параметры
ПараметрТипОписание
фиоСтрокаобязательныйПолное ФИО: «Иванов Иван Иванович»
Примеры
=INTEGRO_GREETING("Иванов Иван Иванович")
Уважаемый Иван Иванович!
=INTEGRO_GREETING("Петрова Мария Сергеевна")
Уважаемая Мария Сергеевна!
=INTEGRO_GREETING(A1)
из ячейки A1
INTEGRO_СЛОВО
=INTEGRO_СЛОВО(слово; падеж; [число])
Склоняет русское слово или фразу в нужный падеж и число. Работает с существительными, прилагательными и словосочетаниями. Удобно для автоматического формирования договоров и актов.
Параметры
ПараметрТипОписание
словоСтрокаобязательныйСлово или фраза: «договор», «генеральный директор»
падежЧисло 1–6обязательныйНомер падежа (1=именит., 2=родит., 3=дат., 4=винит., 5=творит., 6=предложн.)
числоСтроканеобязательный"ед" — единственное (по умолч.), "мн" — множественное
Примеры
=INTEGRO_СЛОВО("договор"; 2)
договора
=INTEGRO_СЛОВО("директор"; 3)
директору
=INTEGRO_СЛОВО("акт"; 5)
актом
=INTEGRO_СЛОВО("акт"; 2; "мн")
актов
=INTEGRO_СЛОВО("генеральный директор"; 3)
генеральному директору
INTEGRO_СУММА_ПРОПИСЬЮ
=INTEGRO_СУММА_ПРОПИСЬЮ(число; [валюта])
Преобразует числовое значение в сумму прописью на русском языке. Поддерживает рубли, доллары и евро. Принимает целые числа и числа с копейками.
Параметры
ПараметрТипОписание
числоЧислообязательныйСумма: 1500, 1500.50, или ссылка на ячейку
валютаСтроканеобязательный"rub" — рубли (по умолч.), "usd" — доллары, "eur" — евро
Примеры
=INTEGRO_СУММА_ПРОПИСЬЮ(1500)
Одна тысяча пятьсот рублей 00 коп.
=INTEGRO_СУММА_ПРОПИСЬЮ(1500,5)
Одна тысяча пятьсот рублей 50 коп.
=INTEGRO_СУММА_ПРОПИСЬЮ(250000,99)
Двести пятьдесят тысяч рублей 99 коп.
=INTEGRO_СУММА_ПРОПИСЬЮ(A1)
сумма из ячейки A1
INTEGRO_ГИПЕРССЫЛКА
=INTEGRO_ГИПЕРССЫЛКА(номер_заявки; Заявки!$B:$B; Заявки!$C:$C)
Находит заявку в столбце B, читает адрес гиперссылки из ячейки столбца C (не отображаемый текст «УЗГА»), отрезает префикс \\192.168.5.11\pdf\Каурцев_А\Чертежи\ и возвращает УЗГА\2026\814.

Важно: ПРОСМОТРX возвращает только видимый текст — используйте трёхаргументный синтаксис.
Параметры
ПараметрТипОписание
номер_заявкиСтрокаобязательныйНомер для поиска, напр. Номер_Заявки_Отказное
col_поискаДиапазонобязательныйСтолбец номеров: Заявки!$B:$B
col_результатаДиапазонобязательныйСтолбец гиперссылок: Заявки!$C:$C
Примеры
=INTEGRO_ГИПЕРССЫЛКА(Номер_Заявки_Отказное;Заявки!$B:$B;Заявки!$C:$C)
УЗГА\2026\814
=ГИПЕРССЫЛКА("\\192.168.5.11\pdf\Каурцев_А\Чертежи\"&INTEGRO_ГИПЕРССЫЛКА(Номер_Заявки_Отказное;Заявки!$B:$B;Заявки!$C:$C);"УЗГА")
кликабельная ссылка
INTEGRO_ПАПКА_ОТВЕТОВ
=INTEGRO_ПАПКА_ОТВЕТОВ($F$2; Заявки!$B:$B; Заявки!$C:$C; B2; A2)
Полный UNC-путь к папке ответов поставщика на листе «Почта». Служебные папки вверху столбца AE: «Отказы» (AE2), «КП направлены» (AE3).
Примеры
=INTEGRO_ПАПКА_ОТВЕТОВ($F$2;Заявки!$B:$B;Заявки!$C:$C;B2;A2)
…\Ответы поставщиков\1 Камаз
=INTEGRO_ПАПКА_ОТВЕТОВ($F$2;Заявки!$B:$B;Заявки!$C:$C;;; "отказ")
…\Ответы поставщиков\Отказы
=INTEGRO_ПАПКА_ОТВЕТОВ($F$2;Заявки!$B:$B;Заявки!$C:$C;;; "кп")
…\Ответы поставщиков\КП направлены
INTEGRO_INN
=INTEGRO_INN(инн; [поле])
Ищет организацию по ИНН через сервис DaData (ЕГРЮЛ/ЕГРИП) и возвращает запрошенные данные: название, должность руководителя или ФИО руководителя.
Параметры
ПараметрТипОписание
иннСтрока/ЧислообязательныйИНН организации (10 цифр) или ИП (12 цифр)
полеСтроканеобязательный "name" — краткое название (по умолч.)
"name_full" — полное название
"director_post" — должность руководителя
"director_fio" — ФИО руководителя
Примеры
=INTEGRO_INN(A1)
ООО «Ромашка»
=INTEGRO_INN(A1; "name_full")
ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ «РОМАШКА»
=INTEGRO_INN(A1; "director_post")
Генеральный директор
=INTEGRO_INN(A1; "director_fio")
Иванов Иван Иванович
INTEGRO_ДОЛЖНОСТЬ
=INTEGRO_ДОЛЖНОСТЬ(инн)
Возвращает должность руководителя компании по ИНН. Сокращение функции INTEGRO_INN(инн; "director_post").
Примеры
=INTEGRO_ДОЛЖНОСТЬ(A1)
Генеральный директор
=INTEGRO_ДОЛЖНОСТЬ(A1)
Директор
INTEGRO_КРАТКОЕ_ИМЯ
=INTEGRO_КРАТКОЕ_ИМЯ(инн)
Возвращает краткое наименование компании по ИНН. Сокращение функции INTEGRO_INN(инн; "name").
Примеры
=INTEGRO_КРАТКОЕ_ИМЯ(A1)
ООО «Ромашка»
INTEGRO_РУКОВОДИТЕЛЬ
=INTEGRO_РУКОВОДИТЕЛЬ(инн)
Возвращает ФИО руководителя компании по ИНН. Сокращение функции INTEGRO_INN(инн; "director_fio").
Примеры
=INTEGRO_РУКОВОДИТЕЛЬ(A1)
Иванов Иван Иванович
Безопасность
Перед каждым деплоем на сервер автоматически запускается агент кибербезопасности — scripts/security_check.py. Он проверяет проект на уязвимости и, при необходимости, исправляет их автоматически.
Что проверяется
КодУровеньПроверкаАвто-фикс
SEC-001CRITICALЗахардкоженные пароли / API-ключи / токены в исходниках
SEC-002WARNINGFlask debug=True вне блока __main__
SEC-003WARNINGОтсутствуют HTTP-заголовки безопасности в Flask✅ да
SEC-004WARNINGФайл .env / *.xlam не в .gitignore✅ да
SEC-005WARNINGHTTP-ссылки (вместо HTTPS) в исходном коде
SEC-006INFOНезафиксированные версии пакетов в requirements.txt
SEC-007WARNINGVBA Shell() с динамическими пользовательскими данными
SEC-008WARNINGFlask /api/-маршрут без валидации имени функции
SEC-009CRITICALФайл .env не найден или не хватает ключей
Запуск вручную
python scripts/security_check.py --fix
проверка + авто-фикс
python scripts/security_check.py
только проверка
python scripts/security_check.py --fix --strict
блокировать при WARNING
Интеграция в деплой
Проверка запускается автоматически как Шаг 0 при каждом деплое. Если найдены CRITICAL-уязвимости — деплой блокируется до их устранения.

История версий

ВерсияДатаИзменения
1.2.3627.06.2026Кнопка «Обновить» открывает install.html (стабильно с Kaspersky)
1.2.3527.06.2026Кнопка «Обновить» — модуль UpdateLogic через обычный Import
1.2.3427.06.2026Исправлены кнопка «Обновить» и закрытие Excel (DoUpdate, ClearBanner)
1.2.3327.06.2026Исправлена кнопка «Обновить IntegroXL» (модуль Updater)
1.2.3227.06.2026Исправлены ошибки при закрытии Excel (отмена отложенных макросов)
1.2.3127.06.2026Убрана автопроверка обновлений при старте Excel (только кнопка «Обновить»)
1.2.3027.06.2026Исправлен вызов IntegroXL_CheckUpdates при загрузке надстройки
1.2.2927.06.2026Исправлена ошибка при запуске Excel (отложенная проверка обновлений)
1.2.2827.06.2026Исправлено автообновление по кнопке «Обновить IntegroXL» (скачивание + перезапуск Excel)
1.2.2725.06.2026Обновление одной кнопкой «Обновить IntegroXL»
1.2.2625.06.2026Нет лишних окон сохранения при открытии файла (ссылки, формулы Online)
1.2.2522.06.2026Иконка «КП заказчику»: стандартная MailMergeMergeToDocument
1.2.2422.06.2026Размер иконки «КП заказчику» 32×32
1.2.2322.06.2026Иконка кнопки «КП заказчику»
1.2.2222.06.2026Кнопка «КП заказчику»: нумерация К####, пустой Word, запись в Номер_КП_Заказчик
1.2.1224.06.2026INTEGRO_ПАПКА_ОТВЕТОВ: папки «Отказы» и «КП направлены»
1.2.1124.06.2026INTEGRO_ПАПКА_ОТВЕТОВ — путь к папке ответов/отказов (лист «Почта»)
1.1.005.06.2026INTEGRO_СКЛОН_ФИО, INTEGRO_СКЛОН_ДОЛЖНОСТЬ; исправлен #ИМЯ? при OneDrive
1.0.905.06.2026INTEGRO_ГИПЕРССЫЛКА: чтение адреса из ячейки с ГИПЕРССЫЛКА
1.0.805.06.2026Новая функция: INTEGRO_ГИПЕРССЫЛКА — извлечение относительного пути из UNC
1.0.728.05.2026Авто-поиск по Enter в A1: курсор переходит к заявке в столбце B
1.0.628.05.2026Кнопка «Найти заявку» — поиск по номеру из ячейки A1 в столбце B
1.0.527.05.2026Новая функция: INTEGRO_СУММА_ПРОПИСЬЮ
1.0.427.05.2026Кнопка «О программе» с версией и ссылкой на сайт
1.0.327.05.2026Новая функция: INTEGRO_СЛОВО — склонение слов по падежам
1.0.227.05.2026Все функции с префиксом INTEGRO_. Страница установки
1.0.126.05.2026INTEGRO_ДОЛЖНОСТЬ, INTEGRO_КРАТКОЕ_ИМЯ, INTEGRO_РУКОВОДИТЕЛЬ
1.0.026.05.2026Первый релиз: INTEGRO_FIO, INTEGRO_INN, INTEGRO_GREETING, нумерация