Ниже приведён подробный план действий и рекомендации для обновления макроса, чтобы он корректно заполнял заявление по новой форме. План можно разделить на несколько этапов.
1. Анализ нового заявления
Получите актуальную версию формы.
Убедитесь, что у вас есть последняя версия заявления (на испанском языке). Это позволит определить, какие поля добавлены, изменены или удалены.
Составьте карту полей.
Сравните новую форму с предыдущей версией, в которой макрос работал корректно. Занесите в таблицу для каждого поля:
Название поля (как в новом заявлении).
Описание (назначение и ожидаемый формат данных).
Соответствующее поле из старой версии, если оно есть.
Определите логические группы данных.
Возможно, изменения затрагивают не только заголовки, но и порядок ввода, типы данных (например, даты, текст, числовые значения) или обязательность заполнения.
2. Анализ существующего макроса
Разберите текущий код макроса.
Определите, какие части кода отвечают за заполнение полей заявления и синхронизацию с Bitrix24. Выясните, где используются переменные, передающие данные клиента.
Проверьте подключения к API или интеграционные модули.
Если макрос взаимодействует с API Bitrix24, оцените, требуется ли адаптация запросов (на случай, если в новой схеме заявки появились новые идентификаторы или изменился формат передачи данных).
Найдите участки, зависящие от формата заявления.
Например, если ранее использовалась разметка для заполнения текстовых блоков или шаблонов, проверьте, как они соотносятся с новой структурой.
3. Внесение изменений в макрос
Обновите список переменных.
Добавьте новые переменные для новых полей и, при необходимости, скорректируйте имена уже существующих переменных. Поддержание читаемости кода и комментариев помогает в долгосрочной поддержке.
Измените алгоритм заполнения полей.
Перепишите участки кода, в которых происходит маппинг данных из исходного источника (например, база данных или форма ввода клиента) в поля нового заявления:
Проверьте соответствие типов данных (например, преобразование формата даты или приведение строки к нужному виду).
Если порядок или способ заполнения изменился (например, разбивка на несколько блоков), адаптируйте алгоритм.
Корректировка интеграции с Bitrix24.
Если в Bitrix24 внесены изменения – изменилось название сделки или поля – обновите соответствующие части кода:
Проверьте, что вызовы API содержат корректные параметры.
При необходимости добавьте обработку новых полей или условий.
Обработка ошибок и валидация.
Добавьте проверки, которые помогут обнаруживать случаи, когда данные введены некорректно или один из ключевых элементов отсутствует. Можно добавить отладочные сообщения или логирование для упрощения диагностики.
4. Тестирование и отладка
Локальное тестирование.
Проверьте изменения на тестовых данных. Создайте несколько типовых сценариев, включая случаи с корректно заполненными данными и ошибочными вариантами, чтобы убедиться, что макрос обрабатывает все ситуации.
Проверка корректности заполнения.
Сравните результаты работы макроса с тем, что ожидается в новом заявлении и в сделке Bitrix24. Обратите внимание на:
Полноту заполнения (нет ли незаполненных полей).
Соответствие формата (например, правильная локализация для испанского языка).
Отсутствие сбоев или некорректных данных.
Используйте этапное тестирование.
Рекомендуется сначала протестировать отдельные компоненты (например, заполнение заявления), а затем провести интеграционное тестирование всей цепочки.
5. Документирование и поддержка
Обновите техническую документацию.
Занесите изменения в документацию по макросу: опишите структуру нового заявления, используемые переменные, логику работы и возможные ошибки.
Сохраните резервную копию предыдущей версии.
Перед внедрением нового макроса, рекомендуется сохранить архив текущей версии, чтобы иметь возможность откатиться в случае непредвиденных проблем.
Добавьте комментарии в код.
Чёткие комментарии облегчат поддержку и позволят другим сотрудникам быстрее понять внесённые изменения.
Обучение пользователей.
Проведите инструктаж для сотрудников, которые будут использовать данный макрос, чтобы они знали об изменениях в процессе оформления заявлений и возможных нюансах работы с новой версией.
Резюме
Обновление макроса предполагает тщательный анализ изменений в заявлении, адаптацию существующего кода под новую структуру, тестирование и документирование всех изменений. Такой пошаговый подход поможет обеспечить корректную работу макроса как для заполнения испанской версии заявления, так и для синхронизации данных с Bitrix24.
Если возникнут дополнительные вопросы по конкретным частям кода или интеграции с Bitrix24, можно обсудить детали, чтобы внести необходимые уточнения.
