Управление приложениями логики в Visual Studio

Вы можете создавать, изменять, развертывать приложения логики и управлять ими на портале 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.

Предварительные требования

Поиск приложений логики

В Visual Studio с помощью Cloud Explorer можно найти все приложения логики, которые связаны с подпиской Azure и развернуты на портале Azure.

  1. Запустите Visual Studio. В меню Представление выберите Cloud Explorer.

  2. В Cloud Explorer щелкните значок Управление учетными записями. Выберите подписку Azure, связанную с вашими приложениями логики, а затем нажмите кнопку Применить. Пример:

    Выбор значка "Управление учетными записями"

  3. Рядом со значком Управление учетными записями выберите пункт Типы ресурсов. В своей подписке Azure разверните узел Logic Apps, чтобы просмотреть все развернутые приложения логики, связанные с вашей подпиской.

Затем откройте свое приложение логики в редакторе приложений логики.

Открытие приложений логики в Visual Studio

В Visual Studio вы можете открывать приложения логики, которые были созданы и развернуты либо напрямую на портале Azure, либо как проекты группы ресурсов Azure Resource Manager в Visual Studio.

  1. Откройте Cloud Explorer и найдите свое приложение логики.

  2. В контекстном меню приложения логики выберите Открыть в редакторе приложений логики.

    Совет

    Если у вас нет этой команды в Visual Studio 2019, убедитесь, что установлены последние обновления для Visual Studio.

    Открытие развернутого приложения логики с портала Azure

    Когда приложение логики откроется в конструкторе Logic Apps, в нижней части конструктора можно выбрать пункт Просмотр кода, чтобы просмотреть базовую структуру определения приложения логики. Если вы хотите создать шаблон развертывания для приложения логики, узнайте о загрузке шаблона Azure Resource Manager для этого приложения. Узнайте больше о шаблонах Resource Manager.

Скачивание из Azure

Приложения логики можно загрузить с портала Azure и сохранить их в виде шаблонов Azure Resource Manager. Затем вы можете локально изменить шаблоны в Visual Studio и настроить приложения логики для разных сред развертывания. При загрузке приложений логики автоматически параметризуются их определения внутри шаблонов Resource Manager, которые также используют формат JSON.

  1. В Visual Studio откройте приложение логики, которое вы хотите загрузить из Azure, с помощью Cloud Explorer.

  2. В контекстном меню приложения логики выберите Открыть в редакторе приложений логики.

    Совет

    Если у вас нет этой команды в Visual Studio 2019, убедитесь, что установлены последние обновления для Visual Studio.

    Приложение логики откроется в конструкторе приложений логики.

  3. В панели инструментов конструктора нажмите кнопку Download (Загрузить).

    Загрузка приложения логики с портала Azure

  4. Когда появится запрос указать расположение, перейдите к нему и сохраните шаблон 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.

  1. В Visual Studio откройте проект группы ресурсов Azure, содержащий ваше приложение логики.

  2. В обозревателе решений в контекстном меню файла <имя-приложения-логики>.json выберите пункт Open With Logic App Designer (Открыть в конструкторе приложений логики). (Или нажмите клавиши CTRL+L)

    Открытие JSON-файла приложения логики с помощью конструктора приложений логики

    Совет

    Если у вас нет этой команды в Visual Studio 2019, проверьте, установлены ли последние обновления Visual Studio и расширение Azure Logic Apps Tools.

  3. Убедитесь, что фокус находится в конструкторе приложений логики, выбрав вкладку или область конструктора, чтобы в окне свойств отображалось свойство Integration Account (Учетная запись интеграции) вашего приложения логики.

    Окно свойств — свойство "Учетная запись интеграции"

    Совет

    Если окно свойств еще не открыто, в меню Вид выберите пункт Окно свойств. (На клавиатуре нажмите клавишу F4)

  4. Откройте список свойства Integration Account (Учетная запись интеграции) и выберите учетную запись интеграции, которую хотите связать с приложением логики, например:

    Открытие списка свойства "Учетная запись интеграции"

  5. Когда все будет готово, не забудьте сохранить решение Visual Studio.

После того как вы установите свойство учетной записи интеграции в Visual Studio и сохраните приложение логики как шаблон Azure Resource Manager, этот шаблон также будет содержать объявление параметров для выбранной учетной записи интеграции. Дополнительные сведения о параметрах шаблонов и приложениях логики см. в разделе Обзор. Автоматизация развертывания приложений логики.

Изменение расположения развертывания

Если приложение логики в Visual Studio существует как JSON-файл в проекте группы ресурсов Azure, который вы используете для автоматизации развертывания, этому приложению логики задается тип расположения и определенное расположение. В качестве расположения задается либо регион Azure, либо имеющаяся среда службы интеграции (ISE).

Чтобы изменить тип расположения или расположение приложения логики, необходимо открыть файл определения рабочего процесса приложения логики (JSON-файл) в обозревателе решений с помощью конструктора приложений логики. Эти свойства нельзя изменить с помощью Cloud Explorer.

Важно!

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

  1. В Visual Studio откройте проект группы ресурсов Azure, содержащий ваше приложение логики.

  2. В обозревателе решений в контекстном меню файла <logic-app-name>.json выберите пункт Open With Logic App Designer (Открыть в конструкторе приложений логики). (Или нажмите клавиши CTRL+L)

    Открытие JSON-файла приложения логики с помощью конструктора приложений логики

    Совет

    Если у вас нет этой команды в Visual Studio 2019, проверьте, установлены ли последние обновления Visual Studio и расширение Azure Logic Apps Tools.

  3. Убедитесь, что фокус находится в конструкторе приложений логики, выбрав вкладку или область конструктора, чтобы в окне свойств отображались свойства Choose Location Type (Выбор типа расположения) и Расположение вашего приложения логики. Для типа расположения проекта можно задать значение Регион или Среда службы интеграции.

    Окно свойств — свойства "Выбор типа расположения" и "Расположение"

    Совет

    Если окно свойств еще не открыто, в меню Вид выберите пункт Окно свойств. (На клавиатуре нажмите клавишу F4)

  4. Чтобы изменить тип расположения, откройте список свойства Choose Location Type (Выбор типа расположения) и выберите нужный тип расположения.

    Например, если задан тип расположения Среда службы интеграции, можно выбрать Регион.

    Свойство "Выбор типа расположения" — изменение типа расположения

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

    • Выбор другого региона Azure:

      Открытие списка свойства Location и выбор другого региона Azure

    • Выбор другой среды службы интеграции:

      Открытие списка свойства Location и выбор другой среды службы интеграции

  6. Когда все будет готово, не забудьте сохранить решение Visual Studio.

Когда вы изменяете тип расположения или расположение в Visual Studio и сохраняете приложение логики в качестве шаблона Azure Resource Manager, этот шаблон также включает объявления параметров для этих типа расположения и расположения. Дополнительные сведения о параметрах шаблонов и приложениях логики см. в разделе Обзор. Автоматизация развертывания приложений логики.

Обновление из Azure

Если вы измените приложение логики на портале Azure, чтобы сохранить эти изменения, необходимо обновить версию этого приложения с изменениями в Visual Studio.

  • В Visual Studio в панели инструментов конструктора приложений логики нажмите кнопку Refresh (Обновить).

    -или-

  • В Cloud Explorer Visual Studio откройте контекстное меню приложения логики и выберите Обновить.

Обновление приложения логики с изменениями

Публикация обновлений приложения логики

Когда вы будете готовы развернуть обновления приложения логики из Visual Studio в Azure, в панели инструментов конструктора приложений логики нажмите кнопку Опубликовать.

Публикация обновленного приложения логики на портале Azure

Запуск приложения логики вручную

В Visual Studio вы можете вручную запустить приложение логики, развернутое в Azure. В панели инструментов конструктора приложений логики нажмите кнопку Run Trigger (Запустить триггер).

Запуск триггера для приложения логики вручную

Просмотр журнала выполнения

Чтобы проверить состояние приложения логики и диагностировать проблемы, связанные с запуском этого приложения, можно просмотреть подробные сведения для запусков в Visual Studio, например входные и выходные данные.

  1. В Cloud Explorer откройте контекстное меню приложения логики и выберите Открыть журнал запусков.

    Открытие журнала выполнения для приложения логики

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

    Просмотр сведений о конкретном запуске

    Совет

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

  3. Разверните шаги, входные и выходные данные которых хотите просмотреть, например:

    Просмотр входных и выходных данных для каждого шага

Отключение и включение приложений логики

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

  • Служба Logic Apps продолжит все выполняющиеся и ожидающие выполнения операции, пока они не будут завершены. Этот процесс может занять некоторое время в зависимости от объема или от невыполненной работы.

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

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

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

    Чтобы предотвратить срабатывание триггера из-за необработанных элементов с момента последнего выполнения, очистите состояние триггера перед повторной активацией приложения логики:

    1. В приложении логики измените любую часть триггера рабочего процесса.
    2. Сохраните изменения. На этом шаге выполняется сброс текущего состояния триггера.
    3. Повторно активируйте приложение логики.

Отключение приложений логики

В Cloud Explorer откройте контекстное меню приложения логики и выберите Отключить.

Отключение приложения логики в Cloud Explorer

Включение приложений логики

В Cloud Explorer откройте контекстное меню приложения логики и выберите Включить.

Включение приложения логики в Cloud Explorer

Удаление приложений логики

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

  • Служба Logic Apps попытается отменить все выполняющиеся и ожидающие выполнения операции.

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

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

  • Если удалить и повторно создать рабочий процесс, его метаданные будут отличаться от метаданных удаленного рабочего процесса. Необходимо заново сохранить любой рабочий процесс, вызвавший удаленный рабочий процесс. Так вызывающий объект получит правильные сведения о воссозданном рабочем процессе. В противном случае вызовы к повторно созданному рабочему процессу завершатся ошибкой Unauthorized. Такое поведение также применяется к рабочим процессам, использующим артефакты в учетных записях интеграции, и рабочим процессам, вызывающим функции Azure.

Чтобы удалить приложение логики с портала Azure, в Cloud Explorer откройте его контекстное меню и выберите Удалить.

Удаление приложения логики с портала Azure

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

При открытии проекта приложения логики в конструкторе Logic Apps может не отображаться параметр для выбора подписки Azure. Вместо этого приложение логики откроется не с той подпиской Azure, которую вы хотите использовать. Это происходит, потому что после открытия JSON-файла для приложения логики Visual Studio кэширует первую выбранную подписку для использования в будущем. Чтобы устранить эту проблему, попробуйте одно из этих действий:

  • Переименуйте JSON-файл приложения логики. Кэш подписки зависит от имени файла.

  • Чтобы удалить ранее выбранные подписки для всех приложений логики в решении, удалите скрытую папку параметров Visual Studio (.vs) в каталоге решения. Это расположение хранит сведения о подписке.

Дальнейшие действия

Из этой статьи вы узнали, как управлять развернутыми приложениями логики в Visual Studio. Теперь ознакомьтесь с настройкой определений приложения логики для развертывания: