Область применения
Предназначена для обеспечения интеграций платформы 1С 8.2, 8.3 с внешними сервисами, работающими на GraphQL. Может быть использована для технического обеспечения такой интеграции для пользователей или организаций.
Технические требования
- Версии ОС: Windows 7 SP1, 8, 8.1, 10, 11. Windows Server 2008 R2, 2012-2022.
- Необходим установленный .Net Framework v4.6.1
- Версии 1С: 8.3 (любые версии), 8.2 (без гарантий, работа не тестировалась)
Код внешней обработки 1С - открыт (в целях демонстрации).
Код внешней компоненты - закрыт.
Функциональные возможности
- URL - адрес хоста для подключения веб-сокет (http(s)).
- Токен - токен авторизации (authorization bearer token) если он требуется (указывается без префикса "bearer" ).
- Команда - текст запроса (операции) на языке GraphQL.
- Variables - текст переменных на языке GraphQL.
- Headers - список "кастомных" http-заголовков, которые могут быть добавлены при соединении. Колонка Name - имя заголовка, Value - значение.
- "Начать работу" - начинает работу компоненты.
- "Закончить работу" - заканчивает работу компоненты.
- "Выполнить" - отправляет команду GraphQL.
Состав поставки
Архив поставки включает файлы:
- РаботаСGraphQL.epf - демонстрационная внешняя обработка 1С.
- Файлы (.dll, .tlb) - файлы внешней компоненты.
- Readme.txt - инструкция по подключению компоненты.
Демонстрация решения
Руководство по использованию
После подключения компоненты, вся работы с ней осуществляется через вызов методов из 1С. В качестве руководства ниже описание API компоненты.
Методы:
-
bool StartWorking(str url, str token="", str[] headers = null) - включает работу компоненты. Массив строк headers ("неопределено" по умолчанию) - массив своих заголовков, если необходимо. Пример передачи можно увидеть в обработке. Возвращает true - признак включения.
-
bool PutCommand(str command, string variable = null) - посылает команду(запрос) и переменные GraphQL. В результате в обработчике "ВнешнееСобытие" должно прийти событие с именем "ReceiveResponseEvent" с ответом от GraphQL сервера.
-
bool EndWorking() - заканчивает работу компоненты. Возвращает true - признак выключения.
-
string GetStatusAndData() - получает в виде строки информацию о признаке работы компоненты (IsStarted) и количестве команд для отправки (CommandCount) а также полученных ответов (ResponseCount). Формат получаемой строки следующий: "[КлючСвойства1]:[ЗначениеCвойства1];[КлючСвойства2]:[ЗначениеCвойства2]...".
Взаимодействие с внешней компонентой реализовано по асинхронному паттерну. Со стороны 1С необходимо вызывать методы "НачатьВызов<ИмяМетода>", где ИмяМетода - это имя определенного метода API компоненты. 1С принимает данные от компоненты через обработчик "ВнешнееСобытие". Пример взаимодействия можно посмотреть в приложенной обработке.
Причины купить
Единственный плагин для платформы 1С добавляющий поддержку GraphQL.
Техническая поддержка и обновления
Бесплатный период техподдержки составляет 1 месяц со дня покупки
Также после приобретения вы получаете 1 месяц бесплатных обновлений.
По окончании бесплатного периода вы можете приобрести услугу технической поддержки с доступом к обновлениям на платной основе.
Проверить наличие обновлений можно в личном кабинете. Если обновления недоступны - загрузить новую версию можно после покупки обновлений/технической поддержки.
Задать вопрос по программе можно по кнопке "Техподдержка" на странице описания.
При создании тикета необходимо предоставить:
- Номер заказа
- Описание вопроса. Если это ошибки - напишите порядок ваших действий с программой, которые к ней привели (приложите видео/скриншоты/отчеты об ошибке)
- Точную конфигурацию 1С, и версию платформы, на которой используете купленное решение (наименование и версию 1С можно взять из раздела "О программе"), версию купленной программы.
К созданной заявке подключается специалист. Дальнейшее обсуждение проблемы будет проходить в тикете техподдержки. Стандартный срок реакции - 24 часа в рабочие дни с момента обращения.