Выполнение операций с данными в 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

   

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

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

   

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

Если вы используете Office 365 Outlook — отправьте действие электронной почты, в следующем примере показан результат:

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

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

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

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

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

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

   

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

3. В свойстве Заголовок укажите пользовательский текст заголовка, который необходимо использовать.

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

Для возврата значений из массива можно использовать функцию item() с действием Создать таблицу CSV. В цикле For_each можно использовать items() функцию.

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

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

Apples,1
Oranges,2

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

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

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

   

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

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

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

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

   

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

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

   

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

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

В определении JSON действия в массиве 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 — отправьте действие электронной почты, в следующем примере показан результат:

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

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

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

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

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

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

2. Откройте список Столбцы и выберите Пользовательский.

3. В свойстве Заголовок укажите пользовательский текст заголовка, который необходимо использовать.

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

Для возврата значений из массива можно использовать функцию item() с действием Создать таблицу HTML. В цикле For_each можно использовать функцию items().

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

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

Apples,1
Oranges,2

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

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

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

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

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

   Примеры:

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

   

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

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

   

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

В определении JSON действия в массиве 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 — отправьте действие электронной почты, в следующем примере показан результат:

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

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

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

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

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

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

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

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

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

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

      body('Filter_array')

      

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

      

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

Если вы используете Office 365 Outlook — отправьте действие электронной почты, в следующем примере показан результат:

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

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

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

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

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

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

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

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

   

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

Если вы используете Office 365 Outlook — отправьте действие электронной почты, в следующем примере показан результат:

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

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

Чтобы попробовать действие Анализа JSON , выполните следующие действия с помощью конструктора рабочих процессов. Или, если вы предпочитаете работать в редакторе представления кода, можно скопировать примеры определений действий JSON и инициализировать определения действий переменных из этого руководства в базовое определение рабочего процесса приложения логики: примеры кода операций данных — анализ 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 — отправьте действие электронной почты, в следующем примере показан результат:

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

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

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

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

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

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

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

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

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

      body('Select')

      

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

      

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

Если вы используете Office 365 Outlook — отправьте действие электронной почты, в следующем примере показан результат:

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

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

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

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

Fruit,Number Apples,1 Oranges,2

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

Fruit,Number
Apples,1
Oranges,2

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

replace(body('Create_CSV_table'),'','<br/>')

replace(body('Create_HTML_table'),'','<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": "[email protected]"
			}
		}
	}
}

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

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