Выполнение операций с данными в Azure Logic Apps

Область применения: Azure Logic Apps (Consumption + Standard)

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

• Создайте объект string или JavaScript Object Notation (JSON) из нескольких входных данных с разными типами данных. Затем можно использовать эту строку как единый ввод данных, а не повторно вводить одни и те же данные.
• Создайте понятные для пользователя маркеры из свойств объектов JavaScript (JSON), чтобы можно было легко использовать эти свойства в рабочем процессе.
• Создайте таблицу HTML или CSV из массива.
• Создайте массив из другого массива на основе указанного фильтра или условия.
• Создайте массив на основе указанных свойств для всех элементов в другом массиве.
• Создайте строку из всех элементов массива и отделите эти элементы с помощью указанного символа.

Предварительные условия

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

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

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

Действия операций с данными

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

Действия JSON

Следующие действия помогают работать с данными в формате нотации объектов JavaScript (JSON).

Чтобы создать более сложные преобразования JSON, см. раздел Выполнение сложных преобразований JSON с помощью шаблона Liquid.

Действия массива

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

Составить действие

Используйте действие Compose для создания одного вывода, например JSON-объекта, с нескольких входов. Ваши входные данные могут иметь разные типы, такие как целые числа, булевые числа, массивы, JSON-объекты и любые другие родные типы, поддерживаемые Azure Logic Apps, включая бинарные и XML. Вы можете использовать выходные данные в действиях, следующих за действием Compose. Действие Compose также помогает избежать многократного ввода одних и того же входных данных при создании рабочего процесса приложения логики.

Например, можно создать сообщение JSON из нескольких переменных, таких как строковые переменные, в которых хранятся имена и фамилии людей, и целочисленной переменной, которая хранит возраст людей. В этом примере действие Compose принимает следующие входные данные:

{ "age": <ageVar>, "fullName": "<lastNameVar>, <firstNameVar>" }

И создает следующие выходные данные:

{"age":35,"fullName":"Owens,Sophia"}

Чтобы попробовать действие Compose , выполните следующие действия с помощью конструктора рабочих процессов. Или, если вам больше нравится работать в редакторе представления кода, вы можете скопировать примеры действий Compose и определений переменных для действия Initialize variables из этого руководства в базовое определение рабочего процесса вашего логического приложения: Примеры кода операций с данными — Compose. Дополнительные сведения о действии Compose в определении рабочего процесса JSON см. в действии Compose.

Тестирование рабочего процесса

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

1. В рабочем процессе добавьте действие, которое может отправить результаты из действия Compose .

   В этом примере по-прежнему используется действие Outlook Office 365 с именем Send an email (V2):

   

2. В этом действии для каждого поля, в котором будут отображаться результаты, выберите внутри каждого поля и выберите список динамического содержимого (значок молнии). В списке в действии "Создание " выберите "Выходные данные".

   В этом примере результат отображается в тексте электронной почты, поэтому вы добавляете поле "Выходные данные " в поле "Текст ":

   

3. Сохраните рабочий процесс и запустите рабочий процесс вручную. На панели инструментов конструктора выберите Выполнить>Выполнить.

Если вы используете действие Office 365 Outlook - Отправить письмо (V2), следующий пример показывает результат:

Действие "Создать таблицу CSV"

Чтобы создать таблицу с разделительными запятыми (CSV), которая содержит свойства и значения из объектов Нотации объектов JavaScript (JSON) в массиве, используйте действие с именем Create CSV table. Затем можно использовать итоговую таблицу в действиях, которые следуют за действием Создать таблицу CSV.

Чтобы попробовать действие "Создать таблицу CSV", выполните следующие действия с помощью конструктора рабочих процессов. Или, если вы предпочитаете работать в редакторе представления кода, вы можете скопировать из этого руководства пример действия Create CSV table и определения переменных для действия Initialize variables в базовое определение рабочего процесса вашего приложения логики: Data operation code examples - Create CSV table. Дополнительные сведения о действии Создать таблицу CSV в определении рабочего процесса JSON см. в разделе Действие таблицы.

Настройка формата таблицы

По умолчанию свойство Columns автоматически создаёт столбцы таблицы на основе элементов массива. Чтобы задать пользовательские заголовки и значения, выполните следующие действия.

1. Если свойство "Столбцы" не отображается в поле сведений о действии, в списке дополнительных параметров выберите "Столбцы".

   

2. Откройте список Столбцы и выберите Настраиваемый.

3. В свойстве Header введите пользовательский текст заголовка для использования.

4. В свойстве Value введите пользовательское значение для использования.

Чтобы вернуть значения из массива, используйте item() функцию с действием Create CSV table . В цикле For_each используйте функцию items() function.

Например, предположим, что столбцы таблицы должны иметь только значения свойств, а не имена свойств из массива. Чтобы возвращать только эти значения, выполните следующие действия для работы в представлении конструктора или в представлении кода.

В этом примере возвращается следующий результат:

Apples,1
Oranges,2

Работа в представлении конструктора

В действии "Создать таблицу CSV" сохраните столбец заголовка пустым. Для каждой строки в столбце Значение разыменуйте каждое необходимое свойство массива. Каждая строка в столбце Значение возвращает все значения для указанного свойства массива и преобразуется в столбец в таблице.

1. Для каждого нужного свойства массива в столбце "Значение " выберите внутри поля редактирования и щелкните значок функции, который открывает редактор выражений. Убедитесь, что список Function выделен.

   

2. В редакторе выражений введите следующее выражение, но замените <array-property-name> на имя свойства массива для нужного значения. Когда вы закончите работу с каждым выражением, нажмите кнопку "Добавить".

   Синтаксис: item()?['<array-property-name>']

   Примеры значений:

   • item()?['Description']
   • item()?['Product_ID']

   

   Дополнительные сведения см. в разделе функция item().

3. Повторите предыдущие шаги для каждого свойства массива. После завершения действия действие выглядит примерно так:

   

4. Сохраните свой рабочий процесс. На панели инструментов конструктора выберите Сохранить.

Работа в представлении кода

В JSON-определении действия Create CSV table в массиве columns задайте свойству header пустую строку. Для каждого свойства value разыменуйте каждое необходимое свойство массива.

1. На панели инструментов конструктора выберите представление кода.

2. В редакторе кода найдите массив действия columns . Для каждого нужного столбца значений массива добавьте пустое header свойство и следующее выражение для value свойства:

   Синтаксис:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   Пример:

   "Create_CSV_table": {
      "type": "Table",
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "CSV",
         "from": "@variables('myJSONArray')"
      }
   }
   

   Примечание.

   Если вы копируете пример в код, убедитесь, что включили действие runAfter в конце определения Create_CSV_table.

3. Вернитесь к представлению конструктора, чтобы проверить результаты.

Тестирование рабочего процесса

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

1. В рабочем процессе добавьте действие, которое может отправить результаты из действия "Создать таблицу CSV".

   В этом примере по-прежнему используется действие Outlook Office 365 с именем Send an email (V2).

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

   

3. Сохраните рабочий процесс и запустите рабочий процесс вручную. На панели инструментов конструктора выберите Выполнить>Выполнить.

Если вы используете действие Office 365 Outlook - Отправить письмо (V2), следующий пример показывает результат:

Действие "Создать таблицу HTML"

Чтобы создать таблицу HTML, которая имеет свойства и значения из объектов нотации объектов JavaScript (JSON) в массиве, используйте действие Создать таблицу HTML. Затем можно использовать итоговую таблицу в действиях, которые следуют за действием Создать таблицу HTML.

Чтобы попробовать действие "Создать таблицу HTML", выполните следующие действия с помощью конструктора рабочих процессов. Или, если вы предпочитаете работать в редакторе представления кода, можно скопировать из этого руководства пример действия Создать таблицу HTML и определения переменных для действия Инициализировать переменные в базовое определение рабочего процесса вашего логического приложения: Примеры кода для операций с данными — Создать таблицу HTML. Для получения дополнительной информации о действии Создать таблицу HTML в определении рабочего процесса JSON, см. раздел Действие таблицы.

Настройка формата таблицы

По умолчанию свойство Columns автоматически создаёт столбцы таблицы на основе элементов массива. Чтобы задать пользовательские заголовки и значения, выполните следующие действия.

1. Если свойство "Столбцы" не отображается в поле сведений о действии, в списке дополнительных параметров выберите "Столбцы".

2. Откройте список Столбцы и выберите Настраиваемый.

3. В свойстве Header введите пользовательский текст заголовка для использования.

4. В свойстве Value введите пользовательское значение для использования.

Чтобы вернуть значения из массива, используйте item() функцию с действием Create HTML table . В цикле For_each используйте функцию items() function.

Например, предположим, что столбцы таблицы должны иметь только значения свойств, а не имена свойств из массива. Чтобы возвращать только эти значения, выполните следующие действия для работы в представлении конструктора или в представлении кода.

В этом примере возвращается следующий результат:

Apples,1
Oranges,2

Работа в представлении конструктора

В действии "Создать таблицу HTML" сохраните столбец заголовка пустым. Для каждой строки в столбце Значение разыменуйте каждое необходимое свойство массива. Каждая строка в столбце Значение возвращает все значения для указанного свойства массива и преобразуется в столбец в таблице.

1. Для каждого нужного свойства массива в столбце "Значение " выберите внутри поля редактирования и щелкните значок функции, который открывает редактор выражений. Убедитесь, что список Function выделен.

2. В редакторе выражений введите следующее выражение, но замените <array-property-name> на имя свойства массива для нужного значения. Когда вы закончите работу с каждым выражением, нажмите кнопку "Добавить".

   Синтаксис: item()?['<array-property-name>']

   Примеры:

   • item()?['Description']
   • item()?['Product_ID']

   

   Дополнительные сведения см. в разделе функция item().

3. Повторите предыдущие шаги для каждого свойства массива. После завершения действия действие выглядит примерно так:

   

Работа в представлении кода

В определении JSON для действия Create HTML table в массиве columns задайте для свойства header пустую строку. Для каждого свойства value разыменуйте каждое необходимое свойство массива.

1. На панели инструментов конструктора выберите представление кода.

2. В редакторе кода найдите массив действия columns . Для каждого нужного столбца значений массива добавьте пустое header свойство и следующее выражение для value свойства:

   Синтаксис:

   {
      "header": "",
      "value": "@item()?['<array-property-name>']"
   }
   

   Пример:

   "Create_HTML_table": {
      "type": "Table",
      "inputs": {
         "columns": [
            { 
               "header": "",
               "value": "@item()?['Description']"
            },
            { 
               "header": "",
               "value": "@item()?['Product_ID']"
            }
         ],
         "format": "HTML",
         "from": "@variables('myJSONArray')"
      }
   }
   

   Примечание.

   Если вы копируете пример в код, убедитесь, что включили действие runAfter в конце определения Create_HTML_table.

3. Вернитесь к представлению конструктора, чтобы проверить результаты.

Тестирование рабочего процесса

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

1. В рабочем процессе добавьте действие, которое может отправлять результаты из действия "Создание таблицы HTML".

   В этом примере по-прежнему используется действие Outlook Office 365 с именем Send an email (V2).

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

   

3. Сохраните рабочий процесс и запустите рабочий процесс вручную. На панели инструментов конструктора выберите Выполнить>Выполнить.

Если вы используете действие Office 365 Outlook - Отправить письмо (V2), следующий пример показывает результат:

Действие "Фильтр массива"

Используйте действие Filter array , чтобы создать массив подмножества из существующего массива, где элементы подмножества соответствуют определённым критериям. Затем вы можете использовать полученный фильтрованный массив в действиях, следующих за действием Filter array .

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

Тестирование рабочего процесса

Чтобы убедиться, создаёт ли действие массива фильтра ожидаемые результаты, отправьте себе уведомление с указанием результатов действия массива фильтра .

1. В рабочем процессе добавьте действие, которое может отправлять результаты из действия массива фильтров.

   В этом примере по-прежнему используется действие Outlook Office 365 с именем Send an email (V2).

2. В этом действии выполните следующие действия.

   1. Для каждого ящика, где вы хотите видеть результаты, выберите его, а затем иконку функции. Иконка открывает редактор выражений. Убедитесь, что список Function выделен.

   2. Чтобы получить выходные данные массива из действия фильтра, введите следующее выражение, которое использует функцию body() с именем действия фильтра и нажмите кнопку "Добавить".

      body('Filter_array')

      

      Разрешенное выражение указывает, чтобы отобразить выходные данные из действия Filter_array в тексте электронной почты при отправке:

      

3. Сохраните рабочий процесс и запустите рабочий процесс вручную. На панели инструментов конструктора выберите Выполнить>Выполнить.

Если вы используете действие Office 365 Outlook - Отправить письмо (V2), следующий пример показывает результат:

Действие присоединения

Чтобы создать строку, содержащую все элементы из массива, и разделить эти элементы определенным символом разделителя, используйте действие Соединить. Затем можно использовать строку в действиях, которые следуют действию Join .

Чтобы попробовать действие "Присоединиться ", выполните следующие действия с помощью конструктора рабочих процессов. Или, если вы предпочитаете работать в редакторе представления кода, вы можете скопировать из этого руководства пример действия Join и определения переменных для действия Initialize variables в базовое определение workflow вашего приложения логики: Примеры кода операций с данными — Join. Дополнительные сведения о действии "Присоединение" в определении базового рабочего процесса см. в действии "Присоединение".

Тестирование рабочего процесса

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

1. В рабочем процессе добавьте действие, которое может отправить результаты из действия "Присоединиться ".

   В этом примере по-прежнему используется действие Outlook Office 365 с именем Send an email (V2).

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

   

3. Сохраните рабочий процесс и запустите рабочий процесс вручную. На панели инструментов конструктора выберите Выполнить>Выполнить.

Если вы используете действие Office 365 Outlook - Отправить письмо (V2), следующий пример показывает результат:

Действие "Анализ JSON"

Чтобы ссылаться или получить доступ к свойствам в контенте JavaScript Object Notation (JSON), создайте удобные поля или токены для этих свойств с помощью действия Parse JSON . Вы можете выбрать эти свойства из списка динамического контента, когда указываете входные данные для последующих действий в вашем рабочем процессе. Для этого действия можно либо предоставить схему JSON, либо создать схему JSON из образца содержимого JSON или полезных данных.

Чтобы попробовать действие Анализа JSON , выполните следующие действия с помощью конструктора рабочих процессов. Или, если вам удобнее работать в редакторе представления кода, вы можете скопировать из этого руководства пример действия Parse JSON и определения переменных для действия Initialize variables в базовое определение рабочего процесса вашего приложения логики: Примеры кода операций с данными — Parse JSON. Дополнительную информацию об этом действии в определении базового процесса см. в разделе Действие "Анализ JSON".

Тестирование рабочего процесса

Чтобы подтвердить, что действие Анализ JSON создает ожидаемые результаты, отправьте уведомление, которое включает выходные данные из действия Анализ JSON.

1. В рабочем процессе добавьте действие, которое может отправлять результаты из действия Анализа JSON .

   В этом примере по-прежнему используется действие Outlook Office 365 с именем Send an email (V2).

2. В этом действии для каждого поля, в котором будут отображаться результаты, выберите внутри каждого поля редактирования, а затем щелкните значок молнии, который открывает список динамического содержимого. В этом списке в действии Анализа JSON выберите свойства из проанализированного объекта JSON.

   В этом примере выбираются следующие свойства: Body FirstName, Body LastName и Body Email.

   

   После завершения действия отправки сообщения электронной почты выглядит примерно так:

   

3. Сохраните рабочий процесс и запустите рабочий процесс вручную. На панели инструментов конструктора выберите Выполнить>Выполнить.

Если вы используете действие Office 365 Outlook - Отправить письмо (V2), следующий пример показывает результат:

Выбор действия

По умолчанию действие Select создает массив, содержащий объекты JSON, созданные из значений в существующем массиве. Например, можно создать объект JSON для каждого значения в целочисленном массиве. Укажите свойства, которые должны иметь каждый объект JSON, и сопоставить значения из исходного массива со свойствами. Хотя объекты JSON компонента можно изменить, выходной массив всегда имеет одинаковое количество элементов, что и исходный массив. Чтобы использовать выходной массив из действия Select, последующие действия должны принимать массивы в качестве входных данных или преобразовать выходной массив в другой совместимый формат.

Чтобы попробовать действие Select , выполните следующие действия с помощью конструктора рабочих процессов. Или, если вы предпочитаете работать в редакторе представления кода, вы можете скопировать из этого руководства пример действия Select и определения переменных для действия Initialize variables в базовое определение рабочего процесса вашего приложения логики: примеры кода для операций с данными — Select. Дополнительную информацию об этом действии в определении базового процесса см. в разделе Выбор действия.

Тестирование рабочего процесса

Чтобы подтвердить, что действие Выбрать создает ожидаемые результаты, отправьте уведомление, которое включает выходные данные из действия Выбрать.

1. В рабочем процессе добавьте действие, которое может отправить результаты из действия Select.

2. В этом действии выполните следующие действия.

   1. Для каждого ящика, где вы хотите видеть результаты, выберите его, а затем иконку функции. Иконка открывает редактор выражений. Убедитесь, что список Function выделен.

   2. Чтобы получить выходные данные массива из действия Select, введите следующее выражение, которое использует функцию body() с именем действия Select и нажмите кнопку "Добавить".

      body('Select')

      

      Вычисленное выражение указывает на необходимость отображения выходных данных действия Select в теле электронного письма при отправке.

      

3. Сохраните рабочий процесс и запустите рабочий процесс вручную. На панели инструментов конструктора выберите Выполнить>Выполнить.

Если вы используете действие Office 365 Outlook - Отправить письмо (V2), следующий пример показывает результат:

Устранение неполадок

Форматирование данных таблицы

Если ваша CSV-таблица или HTML-таблица возвращает неправильно отформатированные данные, убедитесь, что входные данные включают разрывы строк между строками.

Неправильное форматирование:

Fruit,Number Apples,1 Oranges,2

Правильное форматирование:

Fruit,Number
Apples,1
Oranges,2

Чтобы добавить разрывы строк между строками, добавьте в таблицу одно из следующих выражений:

replace(body('Create_CSV_table'),'\r\n','<br/>')

replace(body('Create_HTML_table'),'\r\n','<br/>')

Например:

{
	"Send_an_email": {
		"inputs": {
			"body": {
				"Body": "<p>Results from Create CSV table action:<br/>\n<br/>\n<br/>\n@{replace(body('Create_CSV_table'),'\r\n','<br/>')}</p>",
				"Subject": "Create CSV table results",
				"To": "sophia.owen@fabrikam.com"
			}
		}
	}
}

Связанный контент

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