Управление приложениями логики в Visual Studio
Область применения: Azure Logic Apps (потребление)
Вы можете создавать, изменять, развертывать приложения логики и управлять ими на портале Azure, но также можно использовать Visual Studio, чтобы добавить свои приложения логики в систему управления версиями, публиковать разные версии и создавать шаблоны Azure Resource Manager для различных сред развертывания. С помощью Visual Studio Cloud Explorer вы можете найти приложения логики и другие ресурсы Azure и управлять ими. Например, вы можете открывать, загружать, редактировать, запускать, просматривать журнал запусков, а также отключать и включать приложения логики, которые уже развернуты на портале Azure. Если вы ранее не работали с Azure Logic Apps в Visual Studio, узнайте о создании приложений логики с помощью Visual Studio.
Вы также можете управлять своими приложениями логики на портале Azure.
Важно!
Развертывание или публикация приложения логики из Visual Studio перезаписывает версию этого приложения на портале Azure. Поэтому, если вы вносите изменения на портале Azure, которые нужно сохранить, обновите приложение логики в Visual Studio с портала Azure перед следующим развертыванием или публикацией из Visual Studio.
Необходимые компоненты
Подписка Azure. Если у вас еще нет подписки Azure, зарегистрируйтесь для получения бесплатной учетной записи Azure.
Скачайте и установите эти средства, если вы еще этого не сделали:
Visual Studio 2019, 2017 или 2015 — выпуски Community или выше. Сейчас расширение Azure Logic Apps для Visual Studio 2022 недоступно. В этом кратком руководстве используется бесплатная версия Visual Studio Community 2017.
Важно!
При установке Visual Studio 2019 или 2017 обязательно выберите рабочую нагрузку разработки Azure. Дополнительные сведения см. в разделе Управление ресурсами, связанными с учетными записями Azure, в Visual Studio Cloud Explorer.
Чтобы установить Cloud Explorer для Visual Studio 2015, скачайте Cloud Explorer из Visual Studio Marketplace. Дополнительные сведения см. в разделе Управление ресурсами, связанными с учетными записями Azure, в Visual Studio Cloud Explorer (2015).
Новейшие средства Azure Logic Apps для расширения Visual Studio нужной версии:
Вы можете скачать и установить средства Azure Logic Apps напрямую из Visual Studio Marketplace или узнать, как установить это расширение из Visual Studio. После завершения установки перезагрузите Visual Studio.
Чтобы использовать подписки Azure для государственных организаций в Visual Studio, ознакомьтесь с приведенными ниже разделами. В них описывается дополнительная настройка.
Доступ к Интернету при использовании встроенного конструктора 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. Узнайте о проектах группы ресурсов Azure для приложений логики в Visual Studio.
В Visual Studio откройте проект группы ресурсов Azure, содержащий ваше приложение логики.
В обозревателе решений в контекстном меню файла <имя-приложения-логики>.json выберите пункт Открыть в конструкторе приложений логики. (Клавиатура: CTRL+L)
Совет
Если у вас нет этой команды в Visual Studio 2019, проверьте, установлены ли последние обновления Visual Studio и расширение Azure Logic Apps Tools.
Убедитесь, что фокус находится в конструкторе приложений логики, выбрав вкладку или область конструктора, чтобы в окне свойств отображалось свойство Integration Account (Учетная запись интеграции) вашего приложения логики.
Совет
Если окно свойств еще не открыто, в меню Вид выберите пункт Окно свойств. (На клавиатуре нажмите клавишу F4)
Откройте список свойства Integration Account (Учетная запись интеграции) и выберите учетную запись интеграции, которую хотите связать с приложением логики, например:
Когда все будет готово, не забудьте сохранить решение Visual Studio.
После того как вы установите свойство учетной записи интеграции в Visual Studio и сохраните приложение логики как шаблон Azure Resource Manager, этот шаблон также будет содержать объявление параметров для выбранной учетной записи интеграции. Дополнительные сведения о параметрах шаблонов и приложениях логики см. в разделе Обзор. Автоматизация развертывания приложений логики.
Изменение расположения развертывания
Если приложение логики в Visual Studio существует как JSON-файл в проекте группы ресурсов Azure, который вы используете для автоматизации развертывания, этому приложению логики задается тип расположения и определенное расположение. В качестве расположения задается либо регион Azure, либо имеющаяся среда службы интеграции (ISE).
Чтобы изменить тип расположения или расположение приложения логики, необходимо открыть файл определения рабочего процесса приложения логики (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.
Убедитесь, что фокус находится в конструкторе приложений логики, выбрав вкладку или область конструктора, чтобы в окне свойств отображались свойства Choose Location Type (Выбор типа расположения) и Расположение вашего приложения логики. Для типа расположения проекта можно задать значение Регион или Среда службы интеграции.
Совет
Если окно свойств еще не открыто, в меню Вид выберите пункт Окно свойств. (На клавиатуре нажмите клавишу F4)
Чтобы изменить тип расположения, откройте список свойства Choose Location Type (Выбор типа расположения) и выберите нужный тип расположения.
Например, если задан тип расположения Среда службы интеграции, можно выбрать Регион.
Чтобы изменить конкретное расположение, откройте список свойства Расположение. В зависимости от типа расположения выберите нужное расположение, например следующим образом.
Выбор другого региона Azure:
Выбор другой среды службы интеграции:
Когда все будет готово, не забудьте сохранить решение Visual Studio.
Когда вы изменяете тип расположения или расположение в Visual Studio и сохраняете приложение логики в качестве шаблона Azure Resource Manager, этот шаблон также включает объявления параметров для этих типа расположения и расположения. Дополнительные сведения о параметрах шаблонов и приложениях логики см. в разделе Обзор. Автоматизация развертывания приложений логики.
Обновление из Azure
Если вы измените приложение логики на портале Azure, чтобы сохранить эти изменения, необходимо обновить версию этого приложения с изменениями в Visual Studio.
В Visual Studio в панели инструментов конструктора приложений логики нажмите кнопку Refresh (Обновить).
–или–
В Cloud Explorer Visual Studio откройте контекстное меню приложения логики и выберите Обновить.
Публикация обновлений приложения логики
Когда вы будете готовы развернуть обновления приложения логики из Visual Studio в Azure, в панели инструментов конструктора приложений логики нажмите кнопку Опубликовать.
Запуск приложения логики вручную
В Visual Studio вы можете вручную запустить приложение логики, развернутое в Azure. В панели инструментов конструктора приложений логики нажмите кнопку Run Trigger (Запустить триггер).
Просмотр журнала выполнения
Чтобы проверить состояние приложения логики и диагностировать проблемы, связанные с запуском этого приложения, можно просмотреть подробные сведения для запусков в 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. Теперь ознакомьтесь с настройкой определений приложения логики для развертывания: