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

Это содержимое относится к: версии 4.0 (GA) | Предыдущие версии:v3.1 (GA) версии 3.0 (GA)

Внимание

В этом руководстве и соединителе аналитики документов логики предназначены для REST API аналитики документов версии 3.0 и пересылки.

Azure Logic Apps — это облачная платформа, которую можно использовать для автоматизации рабочих процессов без написания кода. Платформа позволяет легко интегрировать Корпорацию Майкрософт и приложения с приложениями, данными, службами и системами. Logic App — это ресурс Azure, который создают для разработки рабочего процесса. Ниже приведено несколько примеров применения Logic App:

• Создание визуального представления для коммерческих и рабочих процессов.
• Интегрирование рабочих процессов с программным обеспечением как службой (SaaS) и корпоративными приложениями.
• Автоматизация интеграции корпоративных приложений (EAI), бизнес-бизнеса (B2B) и задач обмена электронными данными (EDI).

Дополнительные сведения см. в разделе"Общие сведения о Logic Apps".

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

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

Выберите рабочий процесс с помощью файла из учетной записи Microsoft OneDrive или сайта Microsoft ShareDrive:

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

Для работы с этим учебником требуются следующие ресурсы:

• Подписка Azure. Вы можете создать бесплатную подписку Azure

• Бесплатная облачная учетная запись хранения OneDrive или OneDrive для бизнеса.

  Примечание.

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

• Бесплатная учетная запись Outlook online или Office 365 для электронной почты**.

• Пример счета для тестирования Logic App. Для работы с этим учебником можно загрузить и использовать пример документа со счетом.

• Ресурс аналитики документов. После получения подписки Azure создайте ресурс аналитики документов в портал Azure, чтобы получить ключ и конечную точку. Если у вас есть существующий ресурс аналитики документов, перейдите непосредственно на страницу ресурсов. Используйте бесплатную ценовую категорию (F0), чтобы опробовать службу, а затем выполните обновление до платного уровня для рабочей среды.

  • После развертывания ресурса нажмите Перейти к ресурсу. Скопируйте значения Ключи и конечная точка из вашего ресурса на портале Azure и вставьте их в удобное место, например в программу Блокнот. Для подключения приложения к API аналитики документов нужны значения ключей и конечных точек. Дополнительные сведения см. в статье о создании ресурса аналитики документов.

    

Создание папки OneDrive

Прежде чем перейти к созданию Logic App, необходимо настроить папку OneDrive.

1. Войдите на домашнюю страницу OneDrive или OneDrive для бизнеса.

2. Нажмите кнопку ➕ "Добавить новую " в левой верхней левой боковой панели и выберите папку.

   

3. Введите имя новой папки и нажмите кнопку Создать.

   

4. В файлах отображается новая папка.

   

5. Сейчас мы закончим работу с OneDrive.

Создание ресурса Logic App

На этом этапе у вас должен быть ресурс аналитики документов и папка OneDrive. Теперь нужно создать ресурс Logic App.

1. Перейдите на портал Azure.

2. Выберите " ➕ Создать ресурс " на домашней странице Azure.

   

3. Выполните поиск и выберите Logic App на панели поиска.

4. Нажмите кнопку "Создать"

   

5. Далее нужно указать в полях Создать Logic App следующие значения:

   • Подписка. Выберите текущую подписку.
   • Группа ресурсов. Группа ресурсов Azure, содержащая ресурс. Выберите ту же группу ресурсов, что и для ресурса аналитики документов.
   • Тип. Выберите Потребление. Тип ресурса "Потребление" выполняется в глобальной мультитенантной среде Azure Logic Apps и использует модель выставления счетов на основе потребления.
   • Имя приложения логики. Введите имя для ресурса. Рекомендуется использовать описательное имя, например ВашеИмяLogicApp.
   • Опубликовать. Выберите рабочий процесс.
   • Регион. Выберите свой локальный регион.
   • Включите анализ журналов. Для этого проекта выберите Нет.
   • Тип плана. Выберите Потребление. Тип ресурса "Потребление" выполняется в глобальной мультитенантной среде Azure Logic Apps и использует модель выставления счетов на основе потребления.
   • Избыточность зоны. Выберите "Отключено".

6. Когда вы закончите, у вас есть что-то подобное следующему изображению (группа ресурсов, имя приложения логики и регион могут отличаться). После проверки этих значений выберите Проверить и создать в левом нижнем углу.

   

7. Выполняется короткая проверка. После успешного завершения выберите Создать в левом нижнем углу.

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

9. Наконец, вы перенаправляетесь на страницу конструктора Logic Apps. На домашней странице доступно короткое видео с общей информацией о Logic Apps. Когда вы будете готовы приступить к разработке приложения логики, нажмите кнопку "Пустое приложение логики" в разделе "Шаблоны ".

   

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

    

Создание потока автоматизации

Теперь, когда вы настроили и настроили ресурс логики соединитель приложений, создадим поток автоматизации и протестируем его!

1. Выполните поиск и выберите учетную запись OneDrive или OneDrive для бизнеса на панели поиска. Затем выберите триггер создания файла.

   

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

   Совет

   При попытке войти в соединитель OneDrive с помощью учетной записи Office 365, может появиться следующее сообщение об ошибке: Не удается войти с помощью учетной записи @MICROSOFT.COM.

   • Эта ошибка возникает потому, что OneDrive является облачным хранилищем для личного использования, доступ к которому можно получить с помощью учетной записи Outlook.com или Microsoft Live, но не с помощью учетной записи Office 365.
   • Для использования учетной записи Office 365 можно выбрать соединитель OneDrive для бизнеса. Убедитесь, что папка OneDrive для этого проекта создана в учетной записи OneDrive для бизнеса.

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

   

4. Далее необходимо добавить новый шаг в рабочий процесс. Нажмите кнопку "Создать шаг" ➕ под вновь созданным узлом OneDrive.

   

5. Новый узел добавляется в представление конструктора приложений логики. Найдите Распознаватель документов (аналитика документов) встроке поиска операций и выберите "Анализ документа для предварительно созданных или пользовательских моделей" (API версии 3.0) из списка.

   

6. Теперь появится окно для создания подключения. В частности, вы подключите ресурс аналитики документов к Студии Logic Apps Designer Studio:

   • Введите Имя подключения. Оно должно быть простым для запоминания.

   • Введите URL-адрес конечной точки ресурса аналитики документов и ключ учетной записи, скопированный ранее. Если вы пропустили этот шаг ранее или потеряли строки, вы можете вернуться к ресурсу аналитики документов и скопировать их еще раз. По завершении нажмите Создать.

     

   Примечание.

   Если вы уже выполнили вход с помощью учетных данных, предыдущий шаг пропускается.

7. Затем вы увидите окно параметров выбора для соединителя "Анализ документа для предварительно созданных или пользовательских моделей" (API версии 3.0).

   

8. Заполните поля следующим образом:

   • Идентификатор модели. Укажите модель, которую вы хотите вызвать, в этом случае мы вызываем предварительно созданную модель счета, поэтому введите предварительно созданный счет.

   • Содержимое файла документа и изображения. Выберите это поле. Появится всплывающее окно динамического содержимого. Если это не так, нажмите кнопку "Добавить динамическое содержимое" под полем и выберите "Файл". Этот шаг по сути отправляет файлы для анализа в предварительно созданную модель счета для аналитики документов. После того, как значок Содержимое файла отобразится в поле Содержимое документа/изображения, этот шаг можно считать успешно выполненным.

   • URL-адрес документа или изображения. Пропустите это поле для этого проекта, так как мы уже указываем на содержимое файла непосредственно из папки OneDrive.

   • Добавьте новый параметр. Пропустите это поле для этого проекта.

     

9. Нам нужно добавить еще несколько шагов. Снова нажмите кнопку ➕ Создать шаг, чтобы добавить еще одно действие.

10. В строке поиска по выбору операции введите control и выберите плитку Control .

    

11. Прокрутите вниз и выберите плитку "Для каждого элемента управления" в списке элементов управления .

    

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

    

13. Теперь выберите " Добавить действие " в окне "Для каждого шага".

14. В строке поиска по выбору операции введите Outlook и выберите Outlook.com (личные) или Office 365 Outlook (work).

15. В списке действий прокрутите вниз, пока не найдете сообщение электронной почты (версия 2) и выберите это действие.

    

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

17. Для выполнения некоторых полей мы будем использовать следующее выражение:

       items('For_each')?['fields']?['FIELD-NAME']?['content']

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

   

2. Скопируйте и вставьте указанную выше формулу и замените FIELD-NAME именем поля, которое нужно извлечь. Полный список доступных полей см. на странице концепции для данного API. В этом случае мы используем предварительно созданные значения поля модели выставления счетов.

3. Все почти готово! Внесите изменения в следующие поля:

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

   • Тема. Введите счет, полученный от: и добавьте следующее выражение:

   
            items('For_each')?['fields']?['VendorName']?['content']
   

   • Текст. Мы будем добавлять отдельные данные о счете:

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

     
            items('For_each')?['fields']?['InvoiceId']?['content']
     

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

     
              items('For_each')?['fields']?['DueDate']?['content']
     

     • Сумма типа : и добавьте следующее выражение:

     
              items('For_each')?['fields']?['AmountDue']?['content']
     

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

     
              items('For_each')?['fields']?['AmountDue']?['confidence']
     

   • По завершении окно выглядит примерно так, как показано на следующем рисунке:

     

4. В левом верхнем углу выберите "Сохранить".

   

Примечание.

• Эта текущая версия возвращает только один счет на PDF.
• Для каждого цикла требуется вокруг действия отправки электронной почты, чтобы включить выходной формат, который может возвращать несколько счетов из PDF-файлов в будущем.

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

Для работы с этим учебником требуются следующие ресурсы:

• Подписка Azure. Вы можете создать бесплатную подписку Azure

• Доступ к сайту SharePoint.

• Бесплатная учетная запись электронной почты Outlook Online или Office 365.

• Пример счета для тестирования Logic App. Для работы с этим учебником можно загрузить и использовать пример документа со счетом.

• Ресурс аналитики документов. После получения подписки Azure создайте ресурс аналитики документов в портал Azure, чтобы получить ключ и конечную точку. Если у вас есть существующий ресурс аналитики документов, перейдите непосредственно на страницу ресурсов. Используйте бесплатную ценовую категорию (F0), чтобы опробовать службу, а затем выполните обновление до платного уровня для рабочей среды.

  • После развертывания ресурса нажмите Перейти к ресурсу. Скопируйте значения Ключи и конечная точка из вашего ресурса на портале Azure и вставьте их в удобное место, например в программу Блокнот. Для подключения приложения к API аналитики документов нужны значения ключей и конечных точек. Дополнительные сведения см. в статье о создании ресурса аналитики документов.

    

Создание папки SharePoint

Прежде чем перейти к созданию приложения логики, необходимо настроить папку Sharepoint.

1. Войдите на домашнюю страницу сайта SharePoint .

2. Нажмите кнопку "Документы", а затем ➕ нажмите кнопку "Создать " в левом верхнем углу окна сайта и выберите "Папка".

   

3. Введите имя новой папки и нажмите кнопку Создать.

   

4. Новая папка находится в библиотеке сайта.

   

5. Сейчас мы закончим работу с SharePoint.

Создание ресурса приложения логики

На этом этапе у вас должен быть ресурс аналитики документов и папка SharePoint. Теперь нужно создать ресурс Logic App.

1. Перейдите на портал Azure.

2. Выберите " ➕ Создать ресурс " на домашней странице Azure.

   

3. Выполните поиск и выберите Logic App на панели поиска.

4. Нажмите кнопку "Создать"

   

5. Затем вы завершите поля "Создать приложение логики" со следующими значениями:

   • Подписка. Выберите текущую подписку.
   • Группа ресурсов. Группа ресурсов Azure, содержащая ресурс. Выберите ту же группу ресурсов, что и для ресурса аналитики документов.
   • Тип. Выберите Потребление. Тип ресурса "Потребление" выполняется в глобальной мультитенантной среде Azure Logic Apps и использует модель выставления счетов на основе потребления.
   • Имя приложения логики. Введите имя для ресурса. Рекомендуется использовать описательное имя, например ВашеИмяLogicApp.
   • Опубликовать. Выберите рабочий процесс.
   • Регион. Выберите свой локальный регион.
   • Включите анализ журналов. Для этого проекта выберите Нет.
   • Тип плана. Выберите Потребление. Тип ресурса "Потребление" выполняется в глобальной мультитенантной среде Azure Logic Apps и использует модель выставления счетов на основе потребления.
   • Избыточность зоны. Выберите "Отключено".

6. Когда вы закончите, у вас есть что-то подобное следующему изображению (группа ресурсов, имя приложения логики и регион могут отличаться). После проверки этих значений выберите Проверить и создать в левом нижнем углу.

   

7. Выполняется короткая проверка. После успешного завершения выберите Создать в левом нижнем углу.

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

9. Наконец, вы перенаправляетесь на страницу конструктора Logic Apps. На домашней странице доступно короткое видео с общей информацией о Logic Apps. Когда вы будете готовы приступить к разработке приложения логики, нажмите кнопку "Пустое приложение логики" в разделе "Шаблоны ".

   

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

    

11. Найдите и выберите SharePoint в строке поиска. Затем выберите триггер создания файла (только свойства).

    

12. Logic Apps автоматически входит в учетную запись SharePoint.

13. После подключения учетной записи заполните поля "Адрес сайта" и "Имя библиотеки". Выберите поле "Добавить новый параметр" и выберите "Папка".

    

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

    

    Совет

    Щелкните стрелку в конце каждой указанной папки, чтобы перейти к следующей папке в пути:

15. Затем мы добавим еще один шаг в рабочий процесс. Нажмите кнопку "Создать шаг" ➕ под вновь созданным узлом SharePoint.

16. Выполните поиск и выберите SharePoint в строке поиска еще раз. Затем выберите действие "Получить содержимое файла".

17. Заполните поля следующим образом:

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

    

18. Мы добавим еще один новый шаг в рабочий процесс. Нажмите кнопку "Создать шаг" ➕ под вновь созданным узлом SharePoint.

19. Новый узел добавляется в представление конструктора приложений логики. Найдите Распознаватель документов (аналитика документов) встроке поиска операций и выберите "Анализ документа для предварительно созданных или пользовательских моделей" (API версии 3.0) из списка.

    

20. Теперь вы увидите окно, в котором можно создать подключение. В частности, вы подключите ресурс аналитики документов к Студии Logic Apps Designer Studio:

    • Введите Имя подключения. Оно должно быть простым для запоминания.

    • Введите URL-адрес конечной точки ресурса аналитики документов и ключ учетной записи, скопированный ранее. Если вы пропустили этот шаг ранее или потеряли строки, вы можете вернуться к ресурсу аналитики документов и скопировать их еще раз. По завершении нажмите Создать.

      

    Примечание.

    Если вы уже выполнили вход с помощью учетных данных, предыдущий шаг пропускается.

21. Затем вы увидите окно параметров выбора для соединителя Анализа документа для предварительно созданных или пользовательских моделей (API версии 3.0).

    

22. Заполните поля следующим образом:

    • Идентификатор модели. Укажите модель, которую вы хотите вызвать, в этом случае мы вызываем предварительно созданную модель счета, поэтому введите предварительно созданный счет.
    • Содержимое файла документа и изображения. Выберите это поле. Появится всплывающее окно динамического содержимого. Если это не так, нажмите кнопку "Добавить динамическое содержимое" под полем и выберите "Файл". Этот шаг по сути отправляет файлы для анализа в предварительно созданную модель счета для аналитики документов. После того, как значок Содержимое файла отобразится в поле Содержимое документа/изображения, этот шаг можно считать успешно выполненным.
    • URL-адрес документа или изображения. Пропустите это поле для этого проекта, так как мы уже указываем на содержимое файла непосредственно из папки OneDrive.
    • Добавьте новый параметр. Пропустите это поле для этого проекта.

23. Нам нужно добавить еще несколько шагов. Снова нажмите кнопку ➕ Создать шаг, чтобы добавить еще одно действие.

24. Элемент управления и выбор плитки Control .

    

25. Прокрутите вниз и выберите плитку "Для каждого элемента управления" в списке элементов управления .

    

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

    

27. Теперь выберите "Добавить действие" в окне "Для каждого шага".

28. В строке поиска по выбору операции введите Outlook и выберите Outlook.com (личные) или Office 365 Outlook (work).

29. В списке действий прокрутите вниз, пока не найдете сообщение электронной почты (версия 2) и выберите это действие.

    

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

31. Для выполнения некоторых полей мы будем использовать следующее выражение:

          items('For_each')?['fields']?['FIELD-NAME']?['content']

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

   

2. Скопируйте и вставьте указанную выше формулу и замените FIELD-NAME именем поля, которое нужно извлечь. Полный список доступных полей см. на странице концепции для данного API. В этом случае мы используем предварительно созданные значения поля модели выставления счетов.

3. Все почти готово! Внесите изменения в следующие поля:

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

   • Тема. Введите счет, полученный от: и оставьте курсор расположен после двоеточия.

   • Введите следующее выражение в поле выражения и нажмите кнопку "ОК".

   
      items('For_each')?['fields']?['VendorName']?['content']
   

   • После ввода выражения в поле нажмите кнопку "ОК", а значок формулы появится в месте, где вы оставили курсор:

   

   

• Текст. Мы будем добавлять отдельные данные о счете:

  • Введите идентификатор счета: и, используя тот же метод, что и раньше: поместите курсор, скопируйте следующее выражение в поле выражения и нажмите кнопку ОК следующего выражения:

  
          items('For_each')?['fields']?['InvoiceId']?['content']
  

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

  
          items('For_each')?['fields']?['DueDate']?['content']
  

  • Сумма типа : и добавьте следующее выражение:

  
          items('For_each')?['fields']?['AmountDue']?['content']
  

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

  
          items('For_each')?['fields']?['AmountDue']?['confidence']
  

• По завершении окно выглядит примерно так, как показано на следующем рисунке:

  

1. В левом верхнем углу выберите "Сохранить".

   

Примечание.

• Эта текущая версия возвращает только один счет на PDF.
• Для каждого цикла требуется вокруг действия отправки электронной почты, чтобы включить выходной формат, который может возвращать несколько счетов из PDF-файлов в будущем.

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

Тестирование потока автоматизации

Давайте быстро рассмотрим, что мы выполнили, прежде чем тестировать наш поток:

• В этом сценарии мы создали триггер. Триггер активируется при создании файла в предварительно указанной папке в учетной записи OneDrive.
• Мы добавили действие аналитики документов в наш поток. В этом сценарии мы решили использовать API счетов для автоматического анализа счета из папки OneDrive.
• Мы добавили в поток действие Outlook.com. Мы отправили некоторые из проанализированных данных счета на предварительно определенный адрес электронной почты.

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

1. Чтобы протестировать приложение логики, сначала откройте новую вкладку и перейдите к папке OneDrive, настроенной в начале этого руководства. Добавьте этот файл в папку Образец счета в OneDrive.

2. Вернитесь на вкладку конструктора Logic App и нажмите кнопку Запустить триггер, затем выберите Запустить в раскрывающемся меню.

   

3. Появится сообщение в правом верхнем углу, указывающее, что триггер выполнен успешно:

   

4. Перейдите на страницу обзора приложения логики, выбрав ссылку на имя приложения в левом верхнем углу.

   

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

   

6. Если выполнение завершилось сбоем, проверьте неудачный шаг, чтобы убедиться, что вы ввели правильные сведения.

   

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

   

8. После завершения отключите или удалите приложение логики, чтобы остановить использование.

   

Поздравляем! Вы выполнили это руководство.

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

Дополнительные сведения о моделях аналитики документов