Управление приложениями логики с помощью Visual Studio (не рекомендуется)
Область применения: Azure Logic Apps (потребление)
Внимание
Расширение Azure Logic Apps для Visual Studio устарело и больше не получает обновления. Сведения о создании рабочих процессов приложений логики и управлении ими с помощью локальной среды разработки см. в следующей документации:
Вы можете создавать, изменять, управлять и развертывать автоматизированные рабочие процессы, которые интегрируют службы, системы, приложения и данные между предприятиями и организациями с помощью Azure Logic Apps. Хотя эти задачи можно выполнить в портал Azure, можно также использовать локальную среду разработки для создания проектов приложений логики, которые можно добавлять в систему управления версиями, публиковать разные версии и создавать шаблоны Azure Resource Manager для разных сред развертывания.
Необходимые компоненты
Подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.
Скачайте и установите эти средства, если вы еще этого не сделали:
Visual Studio 2019 — выпуск Community или более поздней версии. Сейчас расширение Azure Logic Apps для Visual Studio 2022 недоступно. В этом руководстве используется Visual Studio Community 2017, который является бесплатным.
Внимание
При установке Visual Studio 2019 убедитесь, что выбрана рабочая нагрузка разработки Azure. Дополнительные сведения см. в разделе Управление ресурсами, связанными с учетными записями Azure, в Visual Studio Cloud Explorer.
Последние средства Azure Logic Apps для расширения Visual Studio для Visual Studio 2019
Вы можете скачать и установить средства Azure Logic Apps напрямую из Visual Studio Marketplace или узнать, как установить это расширение из Visual Studio. После завершения установки перезагрузите Visual Studio.
Сведения об использовании подписок Azure для государственных организаций с Visual Studio см. в кратком руководстве. Подключение к Azure для государственных организаций с помощью Visual Studio для дополнительной настройки.
Доступ к Интернету при использовании внедренного конструктора рабочих процессов для Azure Logic Apps
Конструктору требуется подключение к Интернету, чтобы создать ресурсы в Azure и считать свойства и данные из соединителей в приложении логики.
Поиск приложений логики
В Visual Studio с помощью Cloud Explorer можно найти все приложения логики, которые связаны с подпиской Azure и развернуты на портале Azure.
Откройте Visual Studio. В меню Представление выберите Cloud Explorer.
В Cloud Explorer щелкните значок Управление учетными записями. Выберите подписку Azure, связанную с вашими приложениями логики, а затем нажмите кнопку Применить. Например:
Рядом со значком Управление учетными записями выберите пункт Типы ресурсов. В своей подписке Azure разверните узел Logic Apps, чтобы просмотреть все развернутые приложения логики, связанные с вашей подпиской.
Затем откройте свое приложение логики в редакторе приложений логики.
Открытие приложений логики в Visual Studio
В Visual Studio вы можете открывать приложения логики, которые были созданы и развернуты либо напрямую на портале Azure, либо как проекты группы ресурсов Azure Resource Manager в Visual Studio.
В контекстном меню приложения логики выберите Открыть в редакторе приложений логики.
Совет
Если у вас нет этой команды в Visual Studio 2019, убедитесь, что установлены последние обновления для Visual Studio.
Когда приложение логики откроется в конструкторе Logic Apps, в нижней части конструктора можно выбрать пункт Просмотр кода, чтобы просмотреть базовую структуру определения приложения логики. Если вы хотите создать шаблон развертывания для приложения логики, узнайте о загрузке шаблона Azure Resource Manager для этого приложения. Узнайте больше о шаблонах Resource Manager.
Скачивание из Azure
Приложения логики можно загрузить с портала Azure и сохранить их в виде шаблонов Azure Resource Manager. Затем вы можете локально изменить шаблоны в Visual Studio и настроить приложения логики для разных сред развертывания. При загрузке приложений логики автоматически параметризуются их определения внутри шаблонов Resource Manager, которые также используют формат JSON.
В Visual Studio откройте приложение логики, которое вы хотите загрузить из Azure, с помощью Cloud Explorer.
В контекстном меню приложения логики выберите Открыть в редакторе приложений логики.
Совет
Если у вас нет этой команды в Visual Studio 2019, убедитесь, что установлены последние обновления для Visual Studio.
Приложение логики открывается в конструкторе рабочих процессов.
В панели инструментов конструктора нажмите кнопку Download (Загрузить).
Когда появится запрос указать расположение, перейдите к нему и сохраните шаблон Resource Manager для определения этого приложения логики в виде JSON-файла.
Определение вашего приложения логики появится в подразделе
resourcesвнутри шаблона Resource Manager. Теперь вы можете изменить определение приложения логики и шаблон Resource Manager с помощью Visual Studio. Вы также можете добавить шаблон в решение Visual Studio как проект группы ресурсов Azure. Узнайте о проектах группы ресурсов Azure для приложений логики в Visual Studio.
Привязка к учетной запись интеграции
Чтобы выполнять сборку приложений логики для корпоративных сценариев интеграции B2B, можно связать приложение логики с ранее созданной учетной записью интеграции, которая находится в том же регионе, что и приложение логики. Учетная запись интеграции содержит артефакты B2B, такие как торговые партнеры, соглашения, схемы и сопоставления, и позволяет приложению логики использовать соединители B2B для проверки XML, а также кодирования и декодирования неструктурированных файлов. Хотя можно создать эту ссылку на портале Azure, вы также можете использовать Visual Studio после того, как будут выполнены предварительные требования, а приложение логики будет существует в виде JSON-файла в проекте группы ресурсов Azure.
В Visual Studio откройте проект группы ресурсов Azure, содержащий ваше приложение логики.
В обозревателе решений в контекстном меню файла <имя-приложения-логики>.json выберите пункт Открыть в конструкторе приложений логики. (Клавиатура: CTRL+L)
Совет
Если у вас нет этой команды в Visual Studio 2019, проверьте, установлены ли последние обновления Visual Studio и расширение Azure Logic Apps Tools.
Убедитесь, что конструктор рабочих процессов имеет фокус, выбрав вкладку или поверхность конструктора, чтобы окно свойств отображало свойство учетной записи интеграции для приложения логики.
Совет
Если окно свойств еще не открыто, в меню Вид выберите пункт Окно свойств. (На клавиатуре нажмите клавишу F4)
Откройте список свойства Integration Account (Учетная запись интеграции) и выберите учетную запись интеграции, которую хотите связать с приложением логики, например:
Когда все будет готово, не забудьте сохранить решение Visual Studio.
После того как вы установите свойство учетной записи интеграции в Visual Studio и сохраните приложение логики как шаблон Azure Resource Manager, этот шаблон также будет содержать объявление параметров для выбранной учетной записи интеграции. Дополнительные сведения о параметрах шаблонов и приложениях логики см. в разделе Обзор. Автоматизация развертывания приложений логики.
Изменение расположения развертывания
В Visual Studio, если приложение логики существует в виде файла JSON (.json) в проекте группы ресурсов Azure, используемом для автоматизации развертывания, это приложение логики имеет тип расположения и определенное расположение, которое является регионом Azure.
Чтобы изменить тип или расположение приложения логики, необходимо открыть файл определения рабочего процесса приложения логики (.json) из Обозреватель решений с помощью конструктора рабочих процессов. Эти свойства нельзя изменить с помощью Cloud Explorer.
В Visual Studio откройте проект группы ресурсов Azure, содержащий ваше приложение логики.
В обозревателе решений в контекстном меню файла
<logic-app-name>.jsonвыберите пункт Open With Logic App Designer (Открыть в конструкторе приложений логики). (Клавиатура: CTRL+L)Совет
Если у вас нет этой команды в Visual Studio 2019, проверьте, установлены ли последние обновления Visual Studio и расширение Azure Logic Apps Tools.
Убедитесь, что конструктор рабочих процессов имеет фокус, выбрав вкладку или область конструктора, чтобы окно свойств отображали свойства "Выбор типа расположения и расположения" для приложения логики.
Тип расположения проекта имеет значение Region.
Совет
Если окно свойств еще не открыто, в меню Вид выберите пункт Окно свойств. (На клавиатуре нажмите клавишу F4)
Чтобы изменить конкретное расположение, откройте список свойства Расположение. В зависимости от типа расположения выберите нужное расположение, например следующим образом.
Когда все будет готово, не забудьте сохранить решение Visual Studio.
Когда вы изменяете тип расположения или расположение в Visual Studio и сохраняете приложение логики в качестве шаблона Azure Resource Manager, этот шаблон также включает объявления параметров для этих типа расположения и расположения. Дополнительные сведения о параметрах шаблонов и приложениях логики см. в разделе Обзор. Автоматизация развертывания приложений логики.
Обновление из Azure
Если вы измените приложение логики на портале Azure, чтобы сохранить эти изменения, необходимо обновить версию этого приложения с изменениями в Visual Studio.
На панели инструментов конструктора рабочих процессов в Visual Studio выберите "Обновить".
–или–
В Cloud Explorer Visual Studio откройте контекстное меню приложения логики и выберите Обновить.
Публикация обновлений приложения логики
Когда вы будете готовы развернуть обновления приложения логики из Visual Studio в Azure, на панели инструментов конструктора рабочих процессов выберите "Опубликовать".
Запуск приложения логики вручную
В Visual Studio вы можете вручную запустить приложение логики, развернутое в Azure. На панели инструментов конструктора рабочих процессов выберите "Запустить триггер".
Просмотр журнала выполнения
Чтобы проверить состояние приложения логики и диагностировать проблемы, связанные с запуском этого приложения, можно просмотреть подробные сведения для запусков в Visual Studio, например входные и выходные данные.
В Cloud Explorer откройте контекстное меню приложения логики и выберите Открыть журнал запусков.
Чтобы просмотреть сведения об определенном запуске, дважды щелкните его. Например:
Совет
Чтобы отсортировать таблицу по свойству, щелкните заголовок столбца для этого свойства.
Разверните шаги, входные и выходные данные которых хотите просмотреть, например:
Отключение и включение приложений логики
Чтобы предотвратить срабатывание триггера в следующий раз при выполнении условия триггера, отключите приложение логики. Отключение приложения логики влияет на экземпляры рабочих процессов следующим образом:
Azure Logic Apps продолжит все выполняющиеся и ожидающие выполнения операции, пока они не будут завершены. Этот процесс может занять некоторое время в зависимости от объема или от невыполненной работы.
Azure Logic Apps не будет создавать или выполнять новые экземпляры рабочего процесса.
Триггер не будет срабатывать при следующем выполнении условий.
Состояние триггера запоминает точку, в которой приложение логики было остановлено. Таким образом, при повторной активации приложения логики триггер срабатывает для всех необработанных элементов с момента последнего запуска.
Чтобы предотвратить срабатывание триггера из-за необработанных элементов с момента последнего выполнения, очистите состояние триггера перед повторной активацией приложения логики:
В приложении логики измените любую часть триггера рабочего процесса.
Сохранение изменений. На этом шаге выполняется сброс текущего состояния триггера.
Когда рабочий процесс отключен, вы по-прежнему можете повторно отправлять выполнения.
Отключение приложений логики
В Cloud Explorer откройте контекстное меню приложения логики и выберите Отключить.
Включение приложений логики
В Cloud Explorer откройте контекстное меню приложения логики и выберите Включить.
Удаление приложения логики
Удаление приложения логики влияет на экземпляры рабочих процессов следующим образом:
Azure Logic Apps пытается отменить все выполняющиеся и ожидающие выполнения операции.
Даже при большом объеме или невыполненной работе большинство выполнений будут отменены до их завершения или запуска. Но процесс отмены может занять некоторое время. При этом некоторые выполнения могут быть возобновлены, пока среда выполнения обрабатывает отмену.
Azure Logic Apps не будет создавать или выполнять новые экземпляры рабочего процесса.
Если удалить и повторно создать рабочий процесс, его метаданные будут отличаться от метаданных удаленного рабочего процесса. Необходимо заново сохранить любой рабочий процесс, вызвавший удаленный рабочий процесс. Так вызывающий объект получит правильные сведения о воссозданном рабочем процессе. В противном случае вызовы к повторно созданному рабочему процессу завершатся ошибкой
Unauthorized. Такое поведение также применяется к рабочим процессам, использующим артефакты в учетных записях интеграции, и рабочим процессам, вызывающим функции Azure.
Чтобы удалить приложение логики с портала Azure, в Cloud Explorer откройте его контекстное меню и выберите Удалить.
Устранение неполадок
При открытии проекта приложения логики в конструкторе Logic Apps может не отображаться параметр для выбора подписки Azure. Вместо этого приложение логики откроется не с той подпиской Azure, которую вы хотите использовать. Это происходит, потому что после открытия JSON-файла для приложения логики Visual Studio кэширует первую выбранную подписку для использования в будущем. Чтобы устранить эту проблему, попробуйте одно из этих действий:
Переименуйте JSON-файл приложения логики. Кэш подписки зависит от имени файла.
Чтобы удалить ранее выбранные подписки для всех приложений логики в решении, удалите скрытую папку параметров Visual Studio (.vs) в каталоге решения. Это расположение хранит сведения о подписке.
Следующие шаги
Из этой статьи вы узнали, как управлять развернутыми приложениями логики в Visual Studio. Теперь ознакомьтесь с настройкой определений приложения логики для развертывания: