Внешняя компонента GraphQL клиент для 1С

Область применения

Предназначена для обеспечения интеграций платформы 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.

Состав поставки

Архив поставки включает файлы:

1. РаботаСGraphQL.epf - демонстрационная внешняя обработка 1С.
2. Файлы (.dll, .tlb) - файлы внешней компоненты.
3. 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. Номер заказа
2. Описание вопроса. Если это ошибки - напишите порядок ваших действий с программой, которые к ней привели (приложите видео/скриншоты/отчеты об ошибке)
3. Точную конфигурацию 1С, и версию платформы, на которой используете купленное решение (наименование и версию 1С можно взять из раздела "О программе"), версию купленной программы.

К созданной заявке подключается специалист. Дальнейшее обсуждение проблемы будет проходить в тикете техподдержки. Стандартный срок реакции - 24 часа в рабочие дни с момента обращения.

Техподдержка