Настройка BPMN-элемента Platform GraphQL Connector
После добавления BPMN-элемента на схему бизнес-процесса вам нужно настроить параметры этого BPMN-элемента.
Чтобы настроить параметры BPMN-элемента Platform GraphQL Connector:
-
На BPMN-схеме выберите элемент, параметры которого вы хотите настроить.
-
На панели справа укажите следующие параметры BPMN-элемента:
-
Main → Сервис (обязательный параметр): из раскрывающегося списка выберите имя сервиса Платформы, который поддерживает GraphQL, например, storagedata.
-
Main → Метод (обязательный параметр): из раскрывающегося списка выберите имя метода, который вы хотите вызвать.
Нажмите кнопку Конструктор GraphQL и в окне конструктора запроса, которое отображается, сгенерируйте запрос или сделайте следующее:
-
В области Запрос введите текст запроса на языке GraphQL.
В области Переменные вы можете описать переменные, используемые в запросе.
По нажатию кнопки Схема GraphQL вы можете просмотреть схему данных текущего проекта и системного проекта, а также методы для работы с этими данными. DevTools генерирует схему данных на основе классов, описанных в проекте в файле
DataModel.mdmodel
, и классов системного проекта. -
Нажмите Выполнить запрос и в области Результат просмотрите результат выполнения запроса на сервере.
Если вы сконструировали запрос неверно, в области Результат отображается ошибка.
-
Закройте окно конструктора запроса.
-
-
Template (обязательный параметр): из раскрывающегося списка выберите Platform GraphQL Connector, если на этапе создания схемы бизнес-процесса вы указали тип элемента Service task.
-
Type → Type (обязательный параметр): введите
ru.platform:graphql:1
. -
Input mapping → Variables (необязательный параметр): введите переменные, используемые в GraphQL-запросе. Например, переменные и их значения могут быть записаны следующим образом:
{
"author": "author33",
"content": "content333"
} -
Output mapping → resultExpression (необязательный параметр): введите выражение на языке FEEL для описания способа преобразования и сохранения данных ответа на запрос в переменных бизнес-процесса. Например, введите следующее выражение:
{bpmnProcessId: response.processes.bpmnProcessId}
-
Output mapping → resultVariables (обязательный параметр): введите переменную для записи результата выполнения запроса.
-
Error handling → errorExpression (необязательный параметр): введите выражение на языке FEEL для описания условия обработки ошибок выполнения GraphQL-запроса и управления поведением бизнес-процесса. В выражении используйте коды ошибок сервиса BPMS Платформы. Например, введите следующее выражение:
if error.type= "ru.platform.mdcamundaactionconnector.actionConnector.graphql.GraphqRemoteException" then bpmnError("er1", error.message) else null
-
Retries → Retries (обязательный параметр): введите количество попыток выполнения GraphQL-запроса.
-
Retries → retryBackoff (обязательный параметр): введите время задержки (в секундах) между попытками выполнения GraphQL-запроса.
-
-
Вверху справа нажмите Сохранить.
Теперь (или позже, например, по завершении настройки всех BPMN-элементов) вы можете перейти к следующим необходимым для этого BPMN-элемента настройкам:
- настройке настройке межсервисного взаимодействия для сервиса, который вы выбрали на этапе настройки этого BPMN-элемента, и сервиса MDCamundaActionConnector;
- настройке разрешения системному пользователю system_user_mdcamundaactionconnector_client на действия с объектами или группами объектов, относящимися к сервису, который вы выбрали на этапе настройки этого BPMN-элемента.