Создание и публикация шаблонов рабочих процессов для Azure Logic Apps

Применяется к: Azure Logic Apps (Расход + Стандарт)

Azure Logic Apps предоставляет предварительно созданные, многократно используемые шаблоны автоматизации и интеграции, которые можно использовать для ускорения процесса создания приложений интеграции. Эти шаблоны следуют часто используемым шаблонам и помогают упростить разработку, предоставляя начальную точку или базовый план с предопределенной бизнес-логикой и конфигурациями.

Шаблоны могут включать один или несколько рабочих процессов вместе с их подключениями, параметрами и документацией. Azure Logic Apps предлагает следующие типы шаблонов:

Тип шаблона	Описание
Рабочий процесс	Повторно используемые шаблоны, создающие отдельные рабочие процессы.
Ускорители	Пакетные решения, содержащие несколько связанных рабочих процессов.

Эти шаблоны можно найти в коллекции шаблонов, которая открывается при выборе создания рабочего процесса, начиная с шаблона. Коллекция уже содержит шаблоны, созданные Корпорацией Майкрософт, для общих шаблонов проектирования и интеграции.

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

Шаблоны организации позволяют стандартизировать шаблоны интеграции, делиться передовым опытом и повторно использовать типовые решения в пределах предприятия, не делая их общедоступными. Эта возможность особенно полезна для предприятий, которые хотят повысить согласованность при сохранении параметров открытыми для гибкости. Независимо от того, включают ли ваши сценарии внедрение внутренних API, обработку логики для конкретного домена или применение шаблонов архитектуры, шаблоны организации помогают масштабировать и расти во время контроля.

Шаблоны Azure Logic Apps также предоставляют следующие возможности:

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

• Напрямую используйте API и внутренние системы в шаблонах без необходимости выносить их наружу.

• Скачайте пакеты шаблонов и при необходимости добавьте их в общедоступный репозиторий шаблонов рабочих процессов для Azure Logic Apps в GitHub.

• Переведите свои шаблоны из тестирования в рабочую среду, используя встроенные средства управления жизненным циклом в Azure DevOps, которые обеспечивают упорядоченность команды, но сохраняют гибкость.

• В качестве ресурсов первого класса в Azure шаблоны поддерживают управление доступом на основе ролей Azure (RBAC).

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

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

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

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

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

• Для использования только вашей организации. См. раздел "Создание шаблона рабочего процесса" на портале Azure.

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

• Для всех клиентов Azure. См. раздел "Создание шаблона рабочего процесса— вручную".

  Этот путь предусматривает создание пакета шаблона и отправку пакета в виде pull-запроса в общедоступный репозиторий шаблонов рабочего процесса для Azure Logic Apps в GitHub.

Предпосылки

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

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

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

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

  • Создание примера рабочего процесса приложения логики потребления

  • Создание примера рабочего процесса стандартного приложения логики

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

  Чтобы сохранить эти образы так, чтобы ваш шаблон мог их использовать, требуется учетная запись хранения Azure и контейнер блоб-объектов.

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

  1. На портале Azure откройте ресурс и рабочий процесс приложения логики исходного кода в конструкторе.

  2. Настройте рабочий процесс для создания двух снимков экрана: одна версия, которая работает с светлой темой веб-браузера и другой версией, которая работает с темной темой веб-браузера.

  3. Создайте снимки экрана с помощью предпочтительного средства записи экрана. Не включайте слишком много пробелов в рабочем процессе.

  4. Сохраните каждое изображение с расширением имени файла .png и именем, которое следует соглашениям об именах и стилях, например <имя-изображение>-light.png и <имя-изображение>-dark.png.

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

     Это важно

     URL-адрес включает ключ или токен с разделяемой подписью доступа (SAS), который предоставляет разрешения, например, службам хранения. Убедитесь, что ключ SAS защищен так же, как вы защищаете ключ учетной записи от несанкционированного использования.

Лучшие практики

В этом списке приведены рекомендации по созданию шаблона рабочего процесса.

• Не используйте жестко закодированные свойства и их значения в определениях триггеров и действий.

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

• Ресурсы и рабочие процессы стандартного приложения логики

  • Используйте встроенные операции как можно больше. Например, соединитель Хранилище BLOB-объектов Azure имеет следующие версии, доступные для стандартных рабочих процессов:

    • Встроенные операции поставщика услуг отображаются в галерее коннекторов под фильтром Встроенные. Эти версии размещаются и запускаются с помощью среды выполнения Azure Logic Apps с одним клиентом, обеспечивая более высокую производительность, пропускную способность и другие преимущества.

    • Операции управляемых в Azure API соединителей отображаются в галерее соединителей под фильтром Общие. Эти версии размещаются и запускаются в мультитенантной среде Azure с помощью общих глобальных ресурсов.

Создание шаблона рабочего процесса

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

Только для организации

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

1. В поле поиска на портале Azure найдите и выберите шаблоны приложений логики.

2. На панели инструментов шаблонов Logic Apps нажмите кнопку "Создать".

3. На странице "Создание шаблона Azure Logic Apps " на вкладке "Основы " укажите следующие сведения:

   Параметр	Обязательное поле	значение	Описание
   Подписка	Да	< название подписки Azure>	Подписка Azure, используемая с шаблоном рабочего процесса.
   Группа ресурсов	Да	< имя группы ресурсов>	Имя группы ресурсов Azure, используемой с шаблоном.
   Имя	Да	< имя шаблона>	Имя ресурса шаблона рабочего процесса.
   Регион	Да	< Azure-region>	Регион Azure для создания ресурса шаблона рабочего процесса.

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

   Azure создает ресурс шаблона.

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

Выбор определения исходного рабочего процесса

1. В меню ресурсов шаблона в разделе "Шаблон" выберите "Шаблон".

2. На странице "Шаблон " на вкладке "Рабочие процессы" нажмите кнопку "Добавить".

3. На панели "Управление рабочими процессами" на вкладке "Выбор рабочих процессов " укажите следующие сведения:

   Параметр	Обязательное поле	значение	Описание
   Подписка	Да	< название подписки Azure>	Имя подписки Azure с исходным приложением логики.
   Группа ресурсов	Да	< имя группы ресурсов>	Название группы ресурсов Azure, содержащей исходное приложение логики.
   Экземпляр приложения логики	Да	< source-logic-app>	Имя исходного приложения логики с рабочим процессом, который вы хотите использовать.
   Бизнес-процессы	Да	< исходные рабочие процессы>	Для приложения логики потребления выберите единственный существующий рабочий процесс, используемый в шаблоне. Для стандартного логического приложения выберите как минимум один рабочий процесс для использования в вашем шаблоне.

4. Когда все будет готово, нажмите кнопку Далее.

5. На вкладке "Настройка рабочих процессов" укажите следующие сведения для каждого выбранного исходного рабочего процесса:

   Параметр	Обязательное поле	значение	Описание
   Имя рабочего процесса	Да	< JSON-workflow-name>	Имя JSON для рабочего процесса, который может использовать только строчные буквы, цифры и дефисы, и которые можно переименовать только один раз.
   Государство	Да	С сохранением состояния или без сохранения состояния	Сохранение и хранение журнала выполнения рабочего процесса, входных данных операций и выходных данных операций по умолчанию.
   Сводка	Да	< краткое описание>	Краткое общее описание назначения шаблона.
   Описание	нет	< подробное описание>	Описание с более подробными сведениями о шаблоне.
   Необходимые условия	нет	< Необходимые условия>	Все необходимые требования, прежде чем использовать шаблон.

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

   Образ рабочего процесса	Описание
   URL-адрес SAS в светлом режиме	URL-адрес SAS для образа предварительной версии рабочего процесса с светлой темой, хранящегося в контейнере объектов BLOB в учетной записи хранения Azure.
   URL-адрес SAS в режиме темного режима	URL-адрес SAS для образа предварительного просмотра рабочего процесса в тёмной теме, хранящегося в контейнере BLOB из учетной записи хранения Azure.

7. По завершении выберите Сохранить.

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

8. На вкладке "Подключения" просмотрите и подтвердите подключения, которые Azure автоматически извлекает из исходных рабочих процессов.

   Вам не нужно предпринимать никаких других действий.

9. Затем нажмите кнопку Далее.

Настройка параметров

На вкладке "Параметры" добавьте настройку для всех параметров, которые требуется для рабочего процесса.

1. На вкладке "Параметры" выберите значок редактирования параметра.

2. Укажите следующие сведения для параметра:

   Недвижимость	Обязательное поле	Описание
   Отображаемое имя	Да	Имя параметра, отображаемое на портале Azure.
   Значение по умолчанию	нет	Значение по умолчанию для параметра.
   Описание	нет	Описание назначения параметра.
   Обязательное поле	нет	Требуется ли для рабочего процесса параметр.

3. По завершении выберите Сохранить.

Укажите сведения о шаблоне

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

1. На вкладке "Профиль" укажите следующие сведения о шаблоне:

   Недвижимость	Обязательное поле	Описание
   Отображаемое имя	Да	Отображаемое имя шаблона рабочего процесса, которое выводится в галерее шаблонов.
   К/Автор	Да	Имя издателя шаблона рабочего процесса.
   Сводка	Да	Описание созданного шаблона рабочего процесса.
   Рекомендуемые соединители	Да	Выберите основные типы соединителей в шаблоне рабочего процесса.
   Категория	нет	Категория, к которой принадлежит шаблон.
   Теги	нет	Все теги, которые вы хотите использовать для маркировки рабочего процесса.

2. Затем нажмите кнопку Далее.

3. На вкладке "Сводка " просмотрите и подтвердите все предоставленные сведения.

Публикация для тестирования

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

1. На вкладке "Сводка" или на предыдущей вкладке в нижней части списка "Сохранить" выберите "Сохранить и опубликовать" для тестирования.

   

   Azure публикует шаблон, который отображает метку Testing в коллекции шаблонов.

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

   1. В списке состояния выберите "Опубликовано для тестирования". В строке фильтров выберите "Мои шаблоны".

      Шаблон отображается с меткой тестирования , например:

      

   2. Завершите создание рабочего процесса, тестирование шаблона и внесение необходимых изменений.

Публикация для рабочей среды

Чтобы изменить метку шаблона с Testing на Production в коллекции шаблонов, выполните следующие действия.

1. На портале Azure найдите и откройте шаблонный ресурс.

2. На боковой панели шаблона в разделе "Шаблон" выберите "Шаблон".

3. На странице "Шаблон " нажмите кнопку "Далее " и повторите, пока не откроется вкладка "Профиль ".

4. В списке Сохранить выберите Сохранить + опубликовать для продакшна.

   

Удаление шаблона из коллекции

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

1. На портале Azure найдите и откройте шаблонный ресурс.

2. На боковой панели шаблона в разделе "Шаблон" выберите "Шаблон".

3. На странице "Шаблон " нажмите кнопку "Далее " и повторите, пока не откроется вкладка "Профиль ".

4. В списке Save выберите Save + unpublish template.

   

Весь Azure

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

Что такое пакет шаблона?

В следующей таблице описаны необходимые и необязательные файлы в пакете шаблона:

Имя файла	Обязательное поле	Описание
workflow.json	Да	JSON-файл с определением рабочего процесса.
manifest.json	Да	JSON-файл со сведениями о рабочем процессе и связанных компонентах.
< image-name>-dark.png	Да	Файл изображения с рабочим процессом в виде снимка экрана только для чтения в формате .png и работает с темной темой браузера.
< image-name>-light.png	Да	Файл изображения с рабочим процессом как снимок экрана только для чтения в формате .png и работает с светлой темой браузера.
< map-name>.json, .xml или .xslt	нет	Все артефакты, такие как карты и схемы, поддерживающие шаблон рабочего процесса.
< настраиваемая сборка>.dll	нет	Все пользовательские сборки, поддерживающие шаблон рабочего процесса.
readme.md	нет	Файл Markdown с инструкциями, процедурами или другими сведениями для шаблона рабочего процесса.

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

Создание папки пакета шаблона

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

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

  <

  Примеры см. в репозитории шаблонов рабочего процесса для Azure Logic Apps в GitHub.

• Чтобы правильно зарегистрировать папку пакета шаблона, необходимо добавить имя папки в корневой файл manifest.json репозитория.

Создание файла workflow.json

Файл workflow.json содержит базовое определение рабочего процесса в формате JSON. Чтобы создать файл workflow.json , необходимо скопировать и сохранить определение рабочего процесса в виде файла с именем workflow.json.

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

При создании рабочего процесса конструктор автоматически включает ссылки на все добавленные встроенные подключения, подключения поставщика услуг, управляемые подключения API или библиотеки в базовом определении рабочего процесса.

После завершения скопируйте определение базового рабочего процесса в пустой файл workflow.json .

Копирование определения базового рабочего процесса

1. На портале Azure в меню рабочего процесса в разделе "Разработчик" выберите "Код".

2. В окне представления кода скопируйте полное определение рабочего процесса, например:

   

3. Сохраните определение рабочего процесса в пустом файле с именем workflow.json.

Ссылки на параметры в workflow.json

При ссылке на параметры в файле workflow.json необходимо отразить имена параметров, которые используют суффикс _#workflowname# следующим образом:

"name": "@parameters('<parameter-name>_#workflowname#')"

Например:

"name": "@parameters('sharepoint-folder-path_#workflowname#')"

Ссылки на подключения в workflow.json

При ссылке на подключения в файле workflow.json необходимо отразить имена подключений, которые используют суффикс _#workflowname# следующим образом:

"referenceName": "<connector-ID>_#workflowname#",
"connectionName": "<connector-ID>_#workflowname#"

Например:

"referenceName": "azureaisearch_#workflowname#",
"connectionName": "azureaisearch_#workflowname#"

Дополнительные сведения об идентификаторе соединителя см. в разделе "Поиск идентификатора соединителя".

Создание файла manifest.json

Файл manifest.json описывает связь между рабочим процессом и связанными компонентами. В настоящее время необходимо вручную создать этот файл или перепрофилировать файл manifest.json из существующего предварительно созданного шаблона в репозитории шаблонов рабочих процессов Azure Logic Apps в GitHub. При создании файла manifest.json обязательно просмотрите имена и соглашения о стиле.

В следующей таблице описаны атрибуты в файле manifest.json :

Имя атрибута	Обязательное поле	значение	Описание
title	Да	< заголовок шаблона>	Заголовок, отображаемый в коллекции шаблонов, который открывается при добавлении рабочего процесса из шаблона в портал Azure.
description	Да	< описание шаблона>	Описание шаблона, которое отображается в области обзора шаблона в коллекции шаблонов.
prerequisites	нет	< предварительные требования к шаблону>	Все необходимые условия для использования шаблона. Отображается в области обзора шаблона. Вы можете связаться с другими документами из этого раздела.
tags	нет	< шаблон-tags-array>	Теги шаблонов, используемые для поиска или фильтрации шаблонов.
skus	Да	standard, consumption	Тип рабочего процесса приложения логики, поддерживаемый шаблоном. Если вы не уверены, используйте standard.
kinds	нет	stateful, stateless	Режим рабочего процесса, определяющий, хранятся ли состояния журнала выполнения и операций. По умолчанию все рабочие процессы доступны как в режиме без отслеживания состояния, так и в режиме без отслеживания состояния. Если рабочий процесс выполняется только в режиме с отслеживанием состояния, используйте этот атрибут, чтобы сделать это требование явным.
detailsDescription	нет	См. описание.	Любые другие подробные сведения о описании шаблона.
details	нет	См. описание.	Сведения о шаблоне для фильтрации коллекции шаблонов. - By: издатель шаблона, например Microsoft. - Type: Workflow - Trigger: тип триггера, например , RecurrenceEventили Request.
artifacts	Да	< артефакты-массив>	Все соответствующие файлы в пакете шаблона и включают следующие атрибуты: - type: тип файла, определяющий подходящее расположение для копирования файла, например workflow. - file: имя файла и расширение, например workflow.json.
images	Да	См. описание.	Имена файлов образа рабочего процесса для светлых и темных тем браузера: - light: имя изображения для светлой темы, например рабочий процесс-свет - dark: имя изображения для темной темы, например рабочий процесс темный.
parameters	Да, но может быть пустым, если нет.	< массив workflow-parameters-array>	Параметры действий в шаблоне рабочего процесса. Для каждого параметра необходимо указать следующие свойства: - name: имя параметра должно иметь суффикс, _#workflowname#. Используйте только буквенно-цифровые символы, дефисы или символы подчеркивания и следуйте этому формату: <parameter-name>_#workflowname# - displayName: понятное отображаемое имя параметра. См . соглашения о именах и стилях. - type: тип данных параметра, например String или Int. - default: значение по умолчанию параметра, если таковое имеется. Если нет, оставьте это значение пустой строкой. - description Сведения о параметре и другие важные или полезные сведения. - required: true или false.
connections	Да, но может быть пустым, если нет.	< массив подключений>	Подключения для создания с помощью шаблона рабочего процесса. Каждое подключение имеет следующие свойства: - connectorId: идентификатор соединителя должен иметь суффикс, _#workflowname#. Используйте только буквенно-цифровые символы, дефисы или символы подчеркивания и следуйте этому формату: <connector-ID>_#workflowname# Чтобы найти идентификатор соединителя, ознакомьтесь с идентификатором соединителя. - kind: тип узла среды выполнения соединителя, который предназначен inapp для встроенных операций и соединителей поставщика услуг или shared управляемых соединителей, размещенных в Azure. В коллекции соединителей встроенные операции и соединители поставщика услуг помечены как In App, а управляемые соединители помечены как Общие.
featuredConnections	нет	< featured-connections-array>	По умолчанию в коллекции шаблонов отображаются значки для предварительно созданных операций и соединителей в Azure Logic Apps, используемых каждым шаблоном. Чтобы включить значки для любых других операций, можно использовать featuredConnections атрибут. Каждая операция должна иметь следующие атрибуты: - kind: тип операции - type: тип операции Сведения о поиске этих значений см. в разделе "Поиск типа и типа операции" для раздела FeaturedConnections.

В файле manifest.json для пакета шаблона рабочего процесса добавьте те же имена образов в images раздел без расширения имени файла .png, например:

"images": {
    "dark": "workflow-dark",
    "light": "workflow-light"
}

Поиск идентификатора соединителя

Чтобы найти идентификатор соединителя для подключения в файле manifest.json или ссылку на подключение в файле workflow.json, выполните следующие действия.

1. Откройте ресурс приложения логики на портале Azure.

2. В меню приложения логики в разделе "Рабочие процессы" выберите "Подключения".

3. Выберите вкладку "Представление JSON".

4. В зависимости от типа подключения выполните следующие действия.

   • Для управляемого подключения к API общего доступа, размещенного и запускаемого в Azure:

     1. Найдите раздел managedApiConnections.

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

        /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/<connection-name>

        Например, в следующем тексте показан идентификатор соединителя для соединителя SharePoint:

        /subscriptions/#subscription#/providers/Microsoft.Web/locations/#location#/managedApis/sharepointonline

   • Для подключения поставщика услуг, размещенного в среде выполнения Azure Logic Apps с одним клиентом:

     1. Найдите раздел serviceProviderConnections.

     2. Для каждого подключения найдите id атрибут в атрибуте serviceProvider .

     3. Скопируйте и сохраните следующее значение:

        /serviceProviders/<connection-name>

        Например, в следующем тексте показан идентификатор соединителя для соединителя поиска ИИ Azure:

        /serviceProviders/azureaisearch.

Поиск свойств операции "kind" и "type" для featuredConnections

В файлеmanifest.json раздел может содержать значки для любых других операций, featuredConnections которые необходимо включить в коллекцию шаблонов на портале Azure. Для этого раздела, являющегося массивом, необходимо указать kind атрибуты type для каждой операции.

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

1. В меню рабочего процесса в разделе "Разработчик" выберите "Код".

2. В окне представления кода в actions разделе найдите нужную операцию, а затем найдите и kind значенияtype.

Добавление пакета шаблона в репозиторий GitHub

Чтобы опубликовать пакет шаблона в галерее шаблонов рабочих процессов на портале Azure, необходимо настроить учетную запись GitHub, посетить репозиторий шаблонов рабочего процесса в GitHub для Azure Logic Apps и создать запрос на вытягивание для пакета шаблона, чтобы команда Azure Logic Apps могла просмотреть и проверить ваш PR.

1. Создайте учетную запись GitHub, если у вас нет учетной записи.

   Дополнительные сведения см. в статье "Начало работы с учетной записью GitHub".

2. Перейдите в репозиторий шаблонов рабочего процесса с именем LogicAppsTemplates для Azure Logic Apps в GitHub.

3. Создайте собственную вилку, которая является удаленной копией репозитория LogicAppsTemplates в GitHub.

   Дополнительные сведения см. в разделе "Вилка репозитория".

4. Чтобы локально работать, клонируйте вилку на компьютер.

   1. Выполните следующие действия, чтобы скачать, установить и настроить Git.

   2. Перейдите в вилку с следующим URL-адресом:

      https://github.com/<your-username>/LogicAppsTemplates

   3. На локальном компьютере создайте папку с именем GitHub, если у вас еще нет. Не клонируйте приложение синхронизации OneDrive папку.

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

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

   6. После получения рабочей ветви перейдите на корневой уровень в локальном репозитории и создайте папку пакета шаблона.

   7. Добавьте файлы шаблонов в папку пакета шаблона и обновите файл manifest.json корневого уровня с именем папки.

   8. Когда вы будете готовы зафиксировать изменения в локальном репозитории, например сохранение моментального снимка, выполните следующие команды с помощью средства командной строки Git или других средств:

      git add .

      git commit -m "<commit-short-description>"

   9. Чтобы отправить моментальный снимок в удаленный вилку, выполните следующую команду:

      git push origin <your-working-branch>

5. В GitHub создайте запрос на вытягивание для сравнения <рабочей ветви с основной ветвью> в репозитории LogicAppsTemplates.

   1. Перейдите на страницу запросов на вытягивание репозитория и выберите новый запрос на вытягивание.

   2. В разделе "Сравнение изменений" выберите "Сравнить между вилками".

   3. Убедитесь, что запрос на вытягивание имеет следующие параметры, а затем нажмите кнопку "Создать запрос на вытягивание".

      Базовый репозиторий	База	Головной репозиторий	Сравнить
      Azure/LogicAppsTemplates	главный	< имя> пользователя/LogicAppsTemplates	< ваша рабочая ветвь>

      

   4. Введите название и описание запроса на вытягивание. Чтобы завершить работу, нажмите кнопку "Создать запрос на вытягивание".

   5. Подождите, пока команда Azure Logic Apps рассмотрит ваш запрос на вытягивание.

   Дополнительные сведения см. в разделе "Создание запроса на вытягивание из вилки".

Имена и соглашения о стиле

Площадь	Соглашение
Конфиденциальные данные	Не добавляйте и не добавляйте персональные и конфиденциальные данные в файлы шаблонов, снимки экрана, описания или тестовые данные. Например, эти данные включают идентификаторы подписок, имена пользователей, пароли и т. д.
Имена папок	Чтобы упростить удобочитаемость, используйте строчные регистры и дефисы, когда это возможно. См . руководство по стилю Майкрософт.
Имена файлов изображений	Используйте .png в качестве расширения имени файла, нижнего регистра и дефиса, например workflow-light.png.
Названия продуктов, услуг, технологий и фирменной марки	Следуйте официальным орфографическим и прописным буквам. Например: — Если вы ссылаетесь на имя службы или платформу, используйте Azure Logic Apps, а не "Logic Apps". — При ссылке на ресурс или экземпляр используйте "приложения логики" или "приложение логики", а не "Приложение логики" или "Logic Apps". — При ссылке на последовательность триггеров и действий используйте "рабочий процесс приложения логики" или "рабочий процесс".
Аббревиатуры и акронимы	Используйте расширенное имя для продуктов, услуг, технологий, фирменной марки и необычных технических терминов, а не аббревиатур или акронимов. Допустимы распространенные акронимы, такие как HTTP и URL-адрес. Например, используйте Visual Studio Code, а не VS Code. См . акронимы — руководство по стилю Майкрософт.
Другой текст	— Используйте вариант предложения для заголовков, заголовков и текста контента, что означает, что вы прописываете только первую букву, если у вас нет продукта, службы, технологии или фирменного названия. - Не прописывайте обычные существительные и статьи, такие как "a", "a", "и", "or", "the" и т. д.
Голосовая связь	— Используйте голос второго пользователя (вы и ваш), а не третий (пользователи, разработчики, клиенты), если вам не нужно ссылаться на определенные роли. См . руководство по стилю Майкрософт. — Используйте активный, прямой, но понятный тон, когда это возможно. Активный голос фокусируется на теме и глаголах в тексте, а пассивный голос фокусируется на объекте в тексте.
Словарь	— Используйте простые, распространенные, повседневные слова, такие как "use", а не "use" или "use". - Не используйте слова, фразы, жаргон, коллоквиализмы, идиомы или сленги, которые не переводят хорошо на разных языках. — Используйте "пожалуйста" только для определенных сценариев. См. руководство по стилю Майкрософт. — Используйте "например" или "например", а не "например" или "т. е.". — Не используйте направления, такие как "здесь", "здесь", "выше", "ниже", "справа" и "слева", которые не доступны.
Пунктуация	— Для ряда элементов добавьте последнюю запятую перед объединением, например "и". Например, "яблоки, апельсины и бананы". См . руководство по стилю Майкрософт с запятыми. — заканчивать полные предложения соответствующими знаками препинания. Не используйте восклицательные знаки. См . руководство по стилю Майкрософт.
Форматирование	— Для кода следуйте соглашению о стиле для языка этого кода. — Не используйте жестко закодированные ссылки, которые прерываются при изменении URL-адресов. В запросе pr попросите вместо этого использовать ссылку перенаправления. — Для ссылок используйте следующий формат: For more information, see [descriptive-link-text](URL)]. — Используйте описательный текст ссылки, а не универсальный или расплывчатый текст ссылки, например "See [here](URL)". — Используйте числа только для шагов в процедуре, а не для списков, у которых нет определенного порядка. См . статью "Списки" — руководство по стилю Майкрософт. — Используйте только одно пространство после препинания, если код отступа не выполняется.

Дополнительные рекомендации см. в руководстве по стилю Майкрософт и глобальных советах по написанию.

Связанный контент

Создание рабочих процессов приложения логики из предварительно созданных шаблонов