Desko77 Прикладные сценарии БСП
Справочник отвечает на вопрос КАК ПРИМЕНЯТЬ механизм библиотеки. На вопросы
существует ли вызов, какая у него сигнатура и в каком контексте он доступен
отвечает другой скил - 1c-bsp-api.
Разделение точек входа:
| Вопрос | Скил |
|---|---|
| как сделать X через БСП, каким механизмом, в каком порядке | этот |
| какая сигнатура, существует ли вызов, серверный он или клиентский | 1c-bsp-api |
| как зарегистрировать свою обработку или команду в библиотеке | 1c-bsp-command, 1c-bsp-registration |
Разведение по триггерам не означает взаимного исключения: прикладной сценарий
ДОЛЖЕН проверять вызовы через 1c-bsp-api, и это часть работы, а не переход к
другому скилу.
Порядок работы
Определи МЕХАНИЗМ задачи и возьми справочник по таблице ниже. Грузится один справочник НА МЕХАНИЗМ: задача из трех механизмов законно требует трех. Справочник "на всякий случай" не грузится.
Внутри справочника найди сценарий по заголовку
###и прочитай его диапазоном. Файл целиком не загружается.Проверь каждый вызов перед тем, как его написать. Имена в БСП длинные и составные, поэтому выдумка выглядит как настоящее имя:
python skills/1c-bsp-api/scripts/bsp-api.py check РегламентныеЗаданияСервер.НайтиЗаданияПроверка сообщает и об устаревании, а не только о существовании. Код возврата 1, если вызова нет.
Сценария нет в справочниках - искать по теме через
ssl_searchсервера1c-mcp_ssl_server, затем подтверждать найденное проверкой из пункта 3. MCP судит по документации и называет методы, которых в этой версии нет.
При расхождении источников прав тот, что ближе к поставке: исходник модуля
старше справочника 1c-bsp-api, справочник старше MCP.
Справочники по механизмам
| Механизм и ключевые слова | Файл |
|---|---|
| реквизит объекта без чтения объекта, сообщение пользователю, коллекции, безопасный режим, режим работы базы | references/base-functionality.md |
| задание по расписанию, планировщик, включить и выключить задание, расписание | references/scheduled-jobs.md |
| текущий пользователь, полнота прав, внешний пользователь, учетная запись базы | references/users.md |
| право на запись, роль, профиль группы доступа, наборы значений доступа, пересчет прав | references/access-management.md |
| печать, печатная форма, команда печати, макет, менеджер печати | references/printing.md |
| присоединенный файл, вложение, том хранения, сканирование, открыть файл | references/attached-files.md |
| обработчик обновления, переход на новую версию, отложенное обновление, версия ИБ | references/infobase-update.md |
| установка обновления, поиск обновлений, резервная копия перед обновлением | references/configuration-update.md |
| вариант отчета, размещение отчета в разделах, команда отчета на форме | references/report-variants.md |
| внешняя обработка, дополнительный отчет, внешняя печатная форма, подключить обработку | references/external-reports-processors.md |
| команда на форме от другой подсистемы, размещение команд, обновление команд после записи | references/attachable-commands.md |
| дополнительный реквизит, дополнительное сведение, набор свойств, метки | references/additional-properties.md |
| запрет правки поля после проведения, разблокировка реквизитов на форме | references/attribute-locking.md |
| закрытый период, дата запрета изменения, запрет загрузки данных | references/period-end-closing.md |
| история изменений объекта, версия объекта, откат к прежней версии | references/object-versioning.md |
| префикс номера, префикс базы, префикс организации, номер на печать | references/object-prefixes.md |
| синхронизация баз, узел обмена, регистрация изменений, универсальный формат | references/data-exchange.md |
| адрес, телефон, почта объекта, вид контактной информации | references/contact-information.md |
| отправить письмо, загрузить входящие, учетная запись почты, небезопасный HTML | references/email.md |
| дубли элементов, замена на оригинал, удаление помеченных, ссылочная целостность | references/duplicates-and-deletion.md |
| подписать объект, сертификат, штамп подписи в печатной форме | references/digital-signature.md |
| доверенность ФНС, облачная подпись DSS, мобильная подпись | references/signature-services.md |
| задача, бизнес-процесс, адресация по роли, отложенный старт | references/business-processes.md |
| данные на нескольких языках, подстановка языка в запрос | references/multilanguage.md |
| шаблон письма, подстановка данных объекта, получатели по шаблону | references/message-templates.md |
| персональные данные, согласие субъекта, срок уничтожения | references/personal-data.md |
| курс валюты, сумма прописью, банк по БИК, рабочие даты по графику и календарю | references/currencies-banks-calendars.md |
| регион по коду, коды адреса, адресный реестр | references/address-classifier.md |
| загрузка из файла в справочник, групповое изменение, выгрузка в файлы, структура подчиненности | references/bulk-data-operations.md |
| напоминание, заметка, текущие дела, письма и звонки контакту | references/user-workplace.md |
| загрузка по сети и прокси, SMS, штрихкод, внешняя компонента | references/integration-basics.md |
| проверка корректности данных, регистр проблем, рассылка отчетов по расписанию | references/accounting-checks-and-reports.md |
| состояние бумажного оригинала, склонение по падежам, конструктор формул | references/document-workflow-extras.md |
| публикация OData, сообщение при запуске, отчет о движениях, ручной порядок в списке | references/extension-points.md |
| сведения об организации, ответственные лица, форма настроек программы | references/organizations-and-settings.md |
| завершение сеансов, безопасный режим и разрешения, журнал действий, резервная копия | references/administration.md |
| замер ключевой операции, статистика использования, полнотекстовый поиск, итоги | references/monitoring-and-search.md |
| модель сервиса и разделение данных, обсуждения, анкетирование | references/service-model-and-collaboration.md |
Реестр тем закрыт целиком: 70 тем главы 3 документации в 38 справочниках. Механизмы, у которых прикладного интерфейса нет, названы явно вместе с причиной - это тоже знание, и оно удерживает от поиска несуществующих модулей.
Если справочника еще нет
ssl_search сервера 1c-mcp_ssl_server - векторный поиск по документации БСП.
Запрос формулируется описанием задачи на русском: ssl_search("фоновое задание прогресс"). У сервера РОВНО ОДИН инструмент; имен вида get_function_info или
search_modules на нем нет.
Существование найденного подтверждается bsp-api.py check, а не самим поиском.
Происхождение
Сценарии написаны нами по документации ИТС и исходникам библиотеки. Имена,
сигнатуры, состав параметров и номера версий - факты и взяты как есть; сигнатуры
и регионы берутся из поставки библиотеки, потому что документация с ней местами
расходится. Примеры BSL свои и проверены check.