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

  • Статья

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

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

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

Другие способы работы с данными см . в функциях обработки данных, которые предоставляет Azure Logic Apps.

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

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

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

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

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

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

Действия JSON

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

Действие Description
Создание Создание сообщения или строки из нескольких наборов входных данных, которые могут иметь разные типы данных. Затем можно использовать эту строку как единый ввод данных, а не повторно вводить одни и те же данные. Например, можно создать одно сообщение JSON с разных входных данных.
Синтаксический анализ JSON Создайте понятные маркеры данных для свойств в содержимом JSON, чтобы можно было проще использовать свойства в приложениях логики.

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

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

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

Действие Description
Создать таблицу CSV Создание таблицы значений с разделителями-запятыми (CSV) из массива.
Создать таблицу HTML Создание таблицы HTML из массива.
Фильтр массива Создание подмножества массива из массива на основе указанного фильтра или условия.
Присоединение Создание строки из всех элементов массива и разделение этих элементов указанным разделителем.
Select Создание массива из указанных свойств для всех элементов в другом массиве.

Действие compose

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

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

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

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

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

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

  1. В портал Azure, Visual Studio или Visual Studio Code откройте рабочий процесс приложения логики в конструкторе.

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

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the Compose action.

  2. В рабочем процессе, где вы хотите создать выходные данные, выполните одно из следующих действий:

    • Чтобы добавить действие под последним шагом, выберите Создать шаг.

    • Чтобы добавить действие между шагами, наведите указатель мыши на соединяющую стрелку. Появится знак "плюс" (+). Щелкните значок плюса, а затем выберите Добавить действие.

  3. Под полем поиска Выберите операцию щелкните Встроенные. В поле поиска введите создание.

  4. В списке действий выберите действие с именем Compose.

    Screenshot showing the designer for a Consumption workflow, the

  5. В поле "Входные данные" введите входные данные, используемые для создания выходных данных.

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

    Screenshot showing the designer for a Consumption workflow, the

    На следующем снимке экрана показан готовый пример действия Compose :

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  6. Сохраните результаты своих действий. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

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

    Screenshot showing the Azure portal, designer for an example Consumption workflow, and the

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

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

Screenshot showing an email with the

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

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

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

  1. В портал Azure, Visual Studio или Visual Studio Code откройте рабочий процесс приложения логики в конструкторе.

    В этом примере используется портал Azure и пример рабочего процесса с триггером повторения, а затем действием инициализации переменной. Действие настраивается для создания переменной, в которой исходное значение является массивом с некоторыми свойствами и значениями в формате JSON.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. В рабочем процессе, где вы хотите создать таблицу CSV, выполните одно из следующих действий:

    • Чтобы добавить действие под последним шагом, выберите Создать шаг.

    • Чтобы добавить действие между шагами, наведите указатель мыши на соединяющую стрелку. Появится знак "плюс" (+). Щелкните значок плюса, а затем выберите Добавить действие.

  3. Под полем поиска Выберите операцию щелкните Встроенные. В поле поиска введите таблицу CSV.

  4. В списке действий выберите действие с именем Create CSV table.

    Screenshot showing the designer for a Consumption workflow, the

  5. В поле From введите массив или выражение, используемое для создания таблицы.

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

    Screenshot showing the designer for a Consumption workflow, the

    Примечание.

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

    На следующем снимка экрана показан завершенный пример действия создания таблицы CSV:

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  6. Сохраните результаты своих действий. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

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

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

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

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

Apples,1
Oranges,2

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

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

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

  2. В этом списке выберите выражение , чтобы открыть редактор выражений.

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

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

    Примеры:

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

    Screenshot showing the

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

    Screenshot showing the

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

    Теперь действие "Создать таблицу CSV" похоже на следующий пример:

    Screenshot showing the

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

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

  1. В конструкторе перейдите в представление кода.

    • Потребление: на панели инструментов конструктора выберите представление кода.
    • Стандартный: в меню навигации рабочего процесса в разделе "Разработчик" выберите "Код".

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

    Синтаксис:

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

    Пример:

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

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

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

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

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

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

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

    Screenshot showing a Consumption workflow with the

    Примечание.

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

    Screenshot showing a Consumption workflow and the dynamic content list with

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

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

Screenshot showing an email with the

Примечание.

Если таблица возвращается с неправильным форматированием, см. раздел о проверке форматирования данных в таблице.

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

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

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

  1. В портал Azure, Visual Studio или Visual Studio Code откройте рабочий процесс приложения логики в конструкторе.

    В этом примере используется портал Azure и пример рабочего процесса с триггером повторения, а затем действием инициализации переменной. Действие настраивается для создания переменной, в которой исходное значение является массивом с некоторыми свойствами и значениями в формате JSON.

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

  2. В рабочем процессе, где вы хотите создать HTML-таблицу, выполните одно из следующих действий:

    • Чтобы добавить действие под последним шагом, выберите Создать шаг.

    • Чтобы добавить действие между шагами, наведите указатель мыши на соединяющую стрелку. Появится знак "плюс" (+). Щелкните значок плюса, а затем выберите Добавить действие.

  3. Под полем поиска Выберите операцию щелкните Встроенные. В поле поиска введите html-таблицу.

  4. В списке действий выберите действие с именем Create HTML table.

    Screenshot showing the designer for a Consumption workflow, the

  5. В поле From введите массив или выражение, используемое для создания таблицы.

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

    Screenshot showing the designer for a Consumption workflow, the

    Примечание.

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

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

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  6. Сохраните результаты своих действий. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

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

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

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

Apples,1
Oranges,2

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

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

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

  2. В этом списке выберите выражение , чтобы открыть редактор выражений.

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

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

    Примеры:

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

    Screenshot showing the

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

    Screenshot showing the

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

    Теперь действие "Создать таблицу HTML" похоже на следующий пример:

    Screenshot showing the

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

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

  1. В конструкторе перейдите в представление кода.

    • Потребление: на панели инструментов конструктора выберите представление кода.
    • Стандартный: в меню навигации рабочего процесса в разделе "Разработчик" выберите "Код".

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

    Синтаксис:

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

    Пример:

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

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

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

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

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

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

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

    Screenshot showing a Consumption workflow with the

    Примечание.

    • Если в списке динамического содержимого отображается сообщение о том, что не удается найти выходные данные в соответствии с этим форматом ввода, нажмите кнопку "Подробнее " рядом с меткой таблицы HTML в списке.

      Screenshot showing a Consumption workflow and the dynamic content list with

    • При включении выходных данных таблицы HTML в действие электронной почты убедитесь, что для свойства Is HTML задано значение "Да" в расширенных параметрах действия электронной почты. Таким образом, действие электронной почты правильно форматирует таблицу HTML. Однако если таблица возвращается с неправильным форматированием, узнайте, как проверка форматирование данных таблицы.

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

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

Screenshot showing an email with the

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

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

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

Примечание.

Любой текст фильтра, используемый в условии, чувствителен к регистру. Кроме того, действие не может изменить формат или компоненты элементов в массиве.

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

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

  1. В портал Azure, Visual Studio или Visual Studio Code откройте рабочий процесс приложения логики в конструкторе.

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

    Примечание.

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

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

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

    • Чтобы добавить действие под последним шагом, выберите Создать шаг.

    • Чтобы добавить действие между шагами, наведите указатель мыши на соединяющую стрелку. Появится знак "плюс" (+). Щелкните значок плюса, а затем выберите Добавить действие.

  3. Под полем поиска Выберите операцию щелкните Встроенные. В поле поиска введите массив фильтров.

  4. В списке действий выберите действие с именем массива фильтров.

    Screenshot showing the designer for a Consumption workflow, the

  5. В поле From введите массив или выражение для использования в качестве фильтра.

    В этом примере выберите поле "Из ", которое открывает список динамического содержимого. В этом списке выберите ранее созданную переменную:

    Screenshot showing the designer for a Consumption workflow, the

  6. Для создания условия укажите элементы массива для сравнения, выберите оператор сравнения и укажите значение для сравнения.

    В этом примере функция item() используется для доступа к каждому элементу в массиве, а действие "Фильтровать массив" выполняет поиск элементов массива, где значение больше одного. На следующем снимка экрана показан готовый пример действия фильтра массива :

    Screenshot showing the designer for a Consumption workflow and the finished example for the

  7. Сохраните результаты своих действий. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

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

    2. В этом списке выберите выражение , чтобы открыть редактор выражений.

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

      actionBody('Filter_array')

      Screenshot showing a Consumption workflow with the

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

      Screenshot showing a Consumption workflow with the finished

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

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

Screenshot showing an email with the

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

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

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

  1. В портал Azure, Visual Studio или Visual Studio Code откройте рабочий процесс приложения логики в конструкторе.

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

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

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

    • Чтобы добавить действие под последним шагом, выберите Создать шаг.

    • Чтобы добавить действие между шагами, наведите указатель мыши на соединяющую стрелку. Появится знак "плюс" (+). Щелкните значок плюса, а затем выберите Добавить действие.

  3. Под полем поиска Выберите операцию щелкните Встроенные. В поле поиска введите соединение.

  4. В списке действий выберите действие с именем Join.

    Screenshot showing the designer for a Consumption workflow, the

  5. В поле From введите массив с элементами, которые нужно объединить в виде строки.

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

    Screenshot showing the designer for a Consumption workflow, the

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

    В этом примере в качестве разделителя используется двоеточие (:).

    Screenshot showing where to provide the separator character.

  7. Сохраните результаты своих действий. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

    Screenshot showing a Consumption workflow with the finished

    Примечание.

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

    Screenshot showing a Consumption workflow and the dynamic content list with

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

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

Screenshot showing an email with the

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

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

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

  1. В портал Azure, Visual Studio или Visual Studio Code откройте рабочий процесс приложения логики в конструкторе.

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

    {
    "Member": {
        "Email": "Sophia.Owen@fabrikam.com",
        "FirstName": "Sophia",
        "LastName": "Owen"
    }
}

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

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

    • Чтобы добавить действие под последним шагом, выберите Создать шаг.

    • Чтобы добавить действие между шагами, наведите указатель мыши на соединяющую стрелку. Появится знак "плюс" (+). Щелкните значок плюса, а затем выберите Добавить действие.

  3. Под полем поиска Выберите операцию щелкните Встроенные. В поле поиска введите json синтаксического анализа.

  4. В списке действий выберите действие с именем Parse JSON.

    Screenshot showing the designer for a Consumption workflow, the

  5. В поле "Содержимое " введите объект JSON, который требуется проанализировать.

    В этом примере выберите в поле "Содержимое ", которое открывает динамический список содержимого. В этом списке выберите ранее созданную переменную:

    Screenshot showing the designer for a Consumption workflow, the

  6. В поле "Схема" введите схему JSON, описывающую объект JSON или полезные данные, которые необходимо проанализировать.

    В этом примере используйте следующую схему для примера объекта JSON:

    {
    "type": "object",
    "properties": {
        "Member": {
            "type": "object",
            "properties": {
                "Email": {
                    "type": "string"
                },
                "FirstName": {
                    "type": "string"
                },
                "LastName": {
                    "type": "string"
                }
            }
        }
    }
}

    Screenshot showing the designer for a Consumption workflow, the

    Если у вас нет схемы, можно создать схему из объекта JSON:

    1. В действии Parse JSON в поле "Схема" выберите "Использовать пример полезных данных для создания схемы".

    2. В поле "Ввод" или вставьте пример полезных данных JSON, введите содержимое или объект JSON, а затем нажмите кнопку "Готово", например:

      {
    "Member": {
       "Email": "Sophia.Owen@fabrikam.com",
       "FirstName": "Sophia",
       "LastName": "Owen"
    }
}

      Screenshot showing the designer for a Consumption workflow, the

  7. Сохраните результаты своих действий. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

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

    Screenshot showing a Consumption workflow with JSON properties in the

    Примечание.

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

    Screenshot showing a Standard workflow and the dynamic content list with

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

    Screenshot showing a Consumption workflow with the finished

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

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

Screenshot showing an email with the

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

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

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

Совет

Пример создания массива со строками или целыми числами, созданными из значений в массиве объектов JSON, см. в определениях действий переменных Select и Initliaze в примерах кода операций данных — Select.

  1. В портал Azure, Visual Studio или Visual Studio Code откройте рабочий процесс приложения логики в конструкторе.

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

    Screenshot showing the Azure portal and the designer with a sample Consumption workflow for the

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

    • Чтобы добавить действие под последним шагом, выберите Создать шаг.

    • Чтобы добавить действие между шагами, наведите указатель мыши на соединяющую стрелку. Появится знак "плюс" (+). Щелкните значок плюса, а затем выберите Добавить действие.

  3. Под полем поиска Выберите операцию щелкните Встроенные. В поле поиска введите команду.

  4. В списке действий выберите действие с именем Select.

    Screenshot showing the designer for a Consumption workflow, the

  5. В поле From введите исходный массив, который вы хотите использовать.

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

    Screenshot showing the designer for a Consumption workflow, the

  6. Для свойства Map в левом столбце введите имя свойства, чтобы описать все значения в исходном массиве.

    В этом примере используется Product_ID в качестве имени свойства для целых значений в исходном массиве. Таким образом, каждое значение, например, 1, 2, 3 и 4, является идентификатором продукта.

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

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

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

    2. В этом списке выберите выражение , чтобы открыть редактор выражений.

    3. В редакторе выражений введите функцию с именем item(), а затем нажмите кнопку "ОК".

    Screenshot showing the designer for a Consumption workflow, the

    Действие Select теперь похоже на следующий пример:

    Screenshot showing the

  8. Сохраните результаты своих действий. На панели инструментов конструктора выберите Сохранить.

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

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

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

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

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

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

    2. В этом списке выберите выражение , чтобы открыть редактор выражений.

    3. Чтобы получить выходные данные массива из действия Select, введите следующее выражение, которое использует функцию actionBody() с именем действия Select и нажмите кнопку ОК:

      actionBody('Select')

      Screenshot showing a Consumption workflow with the

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

      Screenshot showing a Consumption workflow with the finished

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

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

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

Screenshot showing an email with the

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

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

Если таблица 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": "sophia.owen@fabrikam.com"
			}
		}
	}
}

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