Как использовать Искру для разработки и доработки в 1С

Как сделать это с Искрой

Запрос «напиши обработку для 1С» оставляет слишком много неизвестного. Одинаковая бизнес-задача решается по-разному в разных конфигурациях, версиях и контекстах выполнения. Официальное описание платформы подчеркивает связь встроенного языка с объектами конфигурации и событиями. Поэтому передавайте Искре фактические имена объектов, типы реквизитов и место вызова. Названия из учебного примера ниже вымышлены и не обозначают готовую обработку для типовой базы.

1. Зафиксируйте среду до обсуждения кода. Выпишите точную версию платформы, название и релиз конфигурации, режим совместимости, клиент и способ запуска. Укажите, допустимо ли расширение или внешняя обработка, какие ограничения поддержки действуют. Эти сведения разработчик берет из своей среды, а не из ответа модели. Не называйте выбранный релиз актуальным для всех.
2. Опишите проверяемый результат. Выберите одну функцию: например, расчет суммы строк для предварительного просмотра без записи и проведения документов. Укажите входные типы, допустимые значения, выход, поведение на ошибке и правила округления. Отдельно перечислите запрещенные действия: изменение базы, отправка писем, запись файлов или внешние вызовы.
3. Передайте минимальные метаданные. Вместо полной выгрузки базы дайте имена нужных объектов, табличных частей, реквизитов и их типов. Приложите фрагмент существующего модуля без секретов и пример обезличенных строк. Уточните контекст клиента или сервера, доступные общие модули и права пользователя. Модель не должна придумывать нужный справочник по его предполагаемому смыслу.
4. Получите план и черновик отдельно. Сначала согласуйте алгоритм и вопросы, затем просите реализацию для указанного места вызова. Отделяйте язык запросов от встроенного языка, а расчет от обработчика формы. Если точная сигнатура метода не подтверждена, попросите пометить это. Короткий неполный пример лучше назвать псевдокодом, чем выдавать за готовый модуль.
5. Проверьте на тестовой копии. Разработчик создает разрешенную тестовую копию без лишних персональных данных и проверяет, что внешние обмены не затронут рабочие системы. Затем выполняет синтаксическую проверку и тестовые сценарии: обычные строки, пустой набор, неверный тип, отрицательное количество, права. Результат сравнивается с ручным расчетом, а не только с отсутствием ошибки.
6. Подготовьте проверяемую поставку. Сохраните изменение отдельно, приложите список затронутых объектов, тестовые результаты, ограничения и порядок возврата прежней версии. Другой разработчик проверяет запросы, клиент-серверные вызовы и права. Применение к рабочей базе выполняется по принятой процедуре после согласования, не автоматически из чата.

Готовый промпт - скопируйте и вставьте

Замените подсказки в квадратных скобках своими данными. Проверьте, какие материалы разрешено передавать в вашу установку Искры.

Помоги с небольшой доработкой 1С, сначала без изменения базы.
Среда: платформа [точная версия], конфигурация [имя и релиз], режим совместимости [значение], клиент [тип], место выполнения [клиент/сервер, модуль и событие]. Допустимый способ изменения: [расширение/внешняя обработка/другое согласованное]. Метаданные: [имена объектов, табличных частей, реквизитов и типов]. Доступные модули и права: [данные].
Задача: [результат]. Контракт: [вход, выход, ограничения, округление, ошибки]. Исходный фрагмент: [код]. Тестовые данные и ожидаемые значения: [таблица]. Запрещены: запись и проведение документов, изменение справочников, обмены и внешние вызовы.
Сначала найди пробелы и предложи алгоритм. После согласования подготовь отдельную функцию и пример вызова именно для заданной среды. Не выдумывай объекты конфигурации и сигнатуры API. Все неподтвержденные места обозначь [проверить по синтакс-помощнику]. Объясни клиент-серверные ограничения и дай проверки обычного, пустого и ошибочного входа. Если точной реализации пока недостаточно данных, выдай явно обозначенный псевдокод. Не утверждай, что код исполнялся, без фактического запуска. В конце составь чек-лист проверки в тестовой копии и перечень затронутых объектов.

Что можно сделать дальше

Что важно учесть перед использованием результата

ИИ помогает готовить алгоритм, объяснять фрагменты и составлять проверки для разработчика 1С. Он не заменяет знание конкретной конфигурации.

Зачем это нужно

Основной риск связан с незаметным допущением: модель называет знакомый объект, которого нет в вашей базе, или предлагает вызов в неподходящем контексте.

Как получить полезный результат

Согласуйте контракт и метаданные, получите минимальную доработку и проверьте ее отдельно от рабочей базы. Источником точных сигнатур служит документация вашей версии.

Где пригодится результат

Такой порядок сокращает неопределенность задачи и делает обсуждение с разработчиком предметным. Он не дает гарантии совместимости и не разрешает изменения рабочей базы.

Учебный расчет предварительной суммы без записи

Учебный редакционный пример. Данные вымышлены; это не запись реального запуска Искры.

Полный вход

Скачать текст

Вымышленная учебная конфигурация. Вход функции: ТаблицаЗначений с колонками Количество (целое неотрицательное) и ЦенаКоп (целое неотрицательное). Строки: Количество=2, ЦенаКоп=15000; Количество=3, ЦенаКоп=20000. Выход: целая сумма в копейках. Пустой набор дает 0; неверный тип и отрицательное значение дают явную ошибку с номером строки. Вход не меняется. В реальной задаче точные версии платформы и конфигурации заполняет разработчик.

Пример результата

Скачать текст

Ожидаемый расчет: 2 × 15000 + 3 × 20000 = 90000 копеек, то есть 900 рублей. Псевдокод, не исполняемый модуль 1С:
СуммаКоп := 0
ДЛЯ каждой строки входа
  ПРОВЕРИТЬ целочисленность и неотрицательность Количество, ЦенаКоп
  ПРИ ошибке завершить расчет с номером строки
  СуммаКоп := СуммаКоп + Количество * ЦенаКоп
КОНЕЦ ЦИКЛА
ВЕРНУТЬ СуммаКоп
Вызов, тип результата и точную обработку ошибок разработчик адаптирует по документации выбранной версии. В платформе 1С этот пример не запускался.

Как проверить пример

• Ручная сумма равна 90000 копеек, рубли и копейки не смешиваются.
• Пустая таблица дает 0, строка с отрицательным количеством не пропускается молча.
• После проверки исходные строки и документы базы не изменены.

Ошибки, которые стоит проверить

Копировать метаданные из чужой конфигурации

Похожее имя документа не подтверждает его реквизиты. Используйте структуру своей базы и отмечайте учебные имена.

Считать синтаксическую проверку достаточной

Модуль может компилироваться, но неверно учитывать права, контекст или данные. Нужны сценарии с ожидаемыми значениями.

Проверять на рабочей базе

Даже небольшой обработчик может иметь побочные действия. Тестовую копию и отключение опасных обменов готовит ответственный специалист.

Связанные материалы

• ИИ для программиста: Контракт новой функции и проверка сгенерированного кода.
• ИИ для бухгалтера: Формулировка учетной задачи и проверка бизнес-смысла расчетов.
• Анализ данных: Подготовка контрольной таблицы для проверки результата.

Все статьи о работе в Искре →