Добавление и запуск кода JavaScript вместе с рабочими процессами для Azure Logic Apps

Область применения: Azure Logic Apps (Потребление + Стандартный)

Чтобы выполнять пользовательские задачи интеграции, встроенные в рабочий процесс в Azure Logic Apps, можно напрямую добавлять и запускать простые фрагменты кода JavaScript из рабочего процесса в портал Azure. Для этой задачи используйте действие встроенного кода с именем Execute JavaScript Code. Это действие возвращает результат из фрагмента кода, чтобы можно было использовать эти выходные данные в последующих действиях рабочего процесса. Это действие также имеет разные ограничения на основе того, имеет ли рабочий процесс потребления или стандарта и лучше подходит для фрагментов кода со следующими атрибутами:

Чтобы запустить код, который не соответствует этим атрибутам, можно создать и вызвать функцию с помощью Функции Azure.

В этом руководстве показано, как действие работает в примере рабочего процесса, который начинается с триггера Office 365 Outlook. Рабочий процесс запускается, когда новое сообщение электронной почты поступает в связанную учетную запись электронной почты Outlook. Пример фрагмента кода извлекает все адреса электронной почты, которые существуют в тексте электронной почты, и возвращает эти адреса в качестве выходных данных, которые можно использовать в последующем действии.

На следующей схеме показаны основные моменты из примера рабочего процесса:

Необходимые компоненты

• Учетная запись и подписка Azure. Если у вас нет ее, вы можете зарегистрироваться для получения бесплатной учетной записи Azure.

• Рабочий процесс приложения логики, куда нужно добавить фрагмент кода. Рабочий процесс уже должен начинаться с триггера.

  В этом примере используется триггер Outlook Office 365, который называется при поступлении нового сообщения электронной почты.

  Если у вас нет рабочего процесса, см. следующую документацию:

  • Потребление. Создание рабочего процесса приложения логики потребления

  • Стандартный: создание примеров рабочих процессов приложения логики "Стандартный"

• В зависимости от того, есть ли рабочий процесс приложения логики "Потребление" или "Стандартный", ознакомьтесь со следующими требованиями:

  • Рабочий процесс потребления

    • Node.js версии 8.11.10

    • Ссылка на учетную запись интеграции, пустую или иначе, из ресурса приложения логики.

      Внимание

      Убедитесь, что используется учетная запись интеграции, соответствующая вашему случаю или сценарию использования.

      Например, учетные записи интеграции Бесплатного уровня предназначены только для пробного использования и не предназначены для рабочих нагрузок. Они ограничены в ресурсах и пропускной способности и не поддерживаются соглашением об уровне обслуживания (SLA).

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

  • Стандартный рабочий процесс

    • Node.js версии 16.x.x.

    • Учетная запись интеграции не требуется.

Добавление действия "Выполнение кода JavaScript"

Ссылка на выходные данные триггера и действия с помощью объекта workflowContext

В фрагменте кода конструктора можно использовать список динамического содержимого для выбора маркера, который ссылается на выходные данные триггера или любое предыдущее действие. При выборе маркера действие Execute JavaScript Code разрешает этот маркер объекту JSON только для workflowContext чтения. Этот объект предоставляет коду доступ к выходным данным триггера, любым предыдущим действиям и рабочему процессу. Объект использует следующую структуру и включает actions, trigger, и workflowсвойства, которые также являются объектами:

{
   "workflowContext": {
      "actions": {
         "<action-name-1>": @actions('<action-name-1>'),
         "<action-name-2>": @actions('<action-name-2>')
      },
      "trigger": {
         @trigger()
      },
      "workflow": {
         @workflow()
      }
   }
}

В следующей таблице содержатся дополнительные сведения об этих свойствах:

В этом примере workflowContext объект JSON может иметь следующие примеры свойств и значений из триггера Outlook:

{
   "workflowContext": {
      "trigger": {
         "name": "When_a_new_email_arrives",
         "inputs": {
            "host": {
               "connection": {
                  "name": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Web/connections/office365"
               }
            },
            "method": "get",
            "path": "/Mail/OnNewEmail",
            "queries": {
               "includeAttachments": "False"
            }
         },
         "outputs": {
            "headers": {
               "Pragma": "no-cache",
               "Content-Type": "application/json; charset=utf-8",
               "Expires": "-1",
               "Content-Length": "962095"
            },
            "body": {
               "Id": "AAMkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgBGAAAAAABmZwxUQtCGTqSPpjjMQeD",
               "DateTimeReceived": "2019-03-28T19:42:16+00:00",
               "HasAttachment": false,
               "Subject": "Hello World",
               "BodyPreview": "Hello World",
               "Importance": 1,
               "ConversationId": "AAQkADY0NGZhNjdhLTRmZTQtNGFhOC1iYjFlLTk0MjZlZjczMWRhNgAQ",
               "IsRead": false,
               "IsHtml": true,
               "Body": "Hello World",
               "From": "<sender>@<domain>.com",
               "To": "<recipient-2>@<domain>.com;<recipient-2>@<domain>.com",
               "Cc": null,
               "Bcc": null,
               "Attachments": []
            }
         },
         "startTime": "2019-05-03T14:30:45.971564Z",
         "endTime": "2019-05-03T14:30:50.1746874Z",
         "scheduledTime": "2019-05-03T14:30:45.8778117Z",
         "trackingId": "1cd5ffbd-f989-4df5-a96a-6e9ce31d03c5",
         "clientTrackingId": "08586447130394969981639729333CU06",
         "originHistoryName": "08586447130394969981639729333CU06",
         "code": "OK",
         "status": "Succeeded"
      },
      "workflow": {
         "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>",
         "name": "<logic-app-workflow-name>",
         "type": "Microsoft.Logic/workflows",
         "location": "<Azure-region>",
         "run": {
            "id": "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.Logic/workflows/<logic-app-workflow-name>/runs/08586453954668694173655267965CU00",
            "name": "08586453954668694173655267965CU00",
            "type": "Microsoft.Logic/workflows/runs"
         }
      }
   }
}

Добавление зависимостей в качестве параметров в действие "Выполнение кода JavaScript"

В некоторых сценариях может потребоваться явное требование, чтобы действие Execute JavaScript Code включает выходные данные из триггера или действий, ссылающихся на код в качестве зависимостей. Например, необходимо выполнить этот дополнительный шаг, если код ссылается на выходные данные, недоступные во время выполнения рабочего процесса. Во время создания рабочего процесса обработчик Azure Logic Apps анализирует фрагмент кода, чтобы определить, ссылается ли код на какие-либо выходные данные триггера или действия. Если эти ссылки существуют, обработчик автоматически включает эти выходные данные. Во время выполнения рабочего процесса, если указанный триггер или выходные данные действия не найдены в объекте workflowContext, обработчик создает ошибку. Чтобы устранить эту ошибку, необходимо добавить этот триггер или действие в качестве явной зависимости для действия Execute JavaScript Code . Другой сценарий, требующий выполнения этого шага, заключается в том, что workflowContext объект ссылается на имя триггера или действия, использующего оператор dot (.).

Чтобы добавить триггер или действие в качестве зависимости, добавьте параметры триггера или действия , применимые к действию Execute JavaScript Code . Затем добавьте имена триггеров или действий, как они отображаются в базовом определении JSON рабочего процесса.

Например, предположим, что действие Отправить электронное письмо с подтверждением соединителя Office 365 Outlook предшествует фрагменту кода в примере рабочего процесса. В следующем примере фрагмента кода содержится ссылка на выходные данные SelectedOption из этого действия.

В этом примере необходимо добавить только параметр Действия, а затем добавить имя Send_approval_emailJSON действия в параметр. Таким образом, вы указываете, что действие Execute JavaScript Code явно включает выходные данные из действия отправки утверждения электронной почты .

Поиск имени триггера или действия в формате JSON

Перед началом работы вам потребуется имя JSON для триггера или действия в определении базового рабочего процесса.

• Имена в определении рабочего процесса содержат символы подчеркивания (_) вместо пробелов.

• Если имя действия использует оператор dot (.), включите этот оператор, например:

  My.Action.Name

Добавление имени триггера или действия в действие "Выполнение кода JavaScript"

1. В действии "Выполнение кода JavaScript" откройте список параметров "Добавить новый".

2. В списке параметров выберите следующие параметры, которые требуются вашему сценарию.

   Параметр	Описание
   Действия	Включите выходные данные из предыдущих действий в качестве зависимостей. При выборе этого параметра появится запрос действий, которые нужно добавить.
   Триггер	Включите выходные данные триггера в качестве зависимостей. При выборе этого параметра появится запрос на включение результатов триггера. В списке Триггер выберите Да.

3. В этом примере выберите параметр Действия.

   

4. В поле Элемент действия — 1 введите имя действия JSON.

   

5. Чтобы добавить еще одно имя действия, выберите Добавить новый элемент.

6. Закончив работу, сохраните свой рабочий процесс.

Справочник по действиям

Дополнительные сведения о структуре и синтаксисе действия Выполнить код JavaScript в базовом определении рабочего процесса с помощью языка определения рабочего процесса см. справочный раздел этого действия.

Следующие шаги

• Управляемые соединители для Azure Logic Apps.
• Встроенные триггеры и действия в Azure Logic Apps