Расширение конвейера в Power Platform

Конвейеры могут быть адаптированы для удовлетворения уникальных потребностей организации. Например, вы можете добавлять утверждения, развертывать через субъекты-службы, а также интегрировать конвейеры с внутренними системами учета, Azure DevOps, GitHub и т. д. Поскольку используются бизнес-события Microsoft Dataverse, бизнес-логика может выполняться внутри Power Automate или других подписчиков. Вне зависимости от того, насколько сложен конвейер внутри, процесс развертывания остается простым для создателей.

Внимание

• Новые расширения конвейеров постепенно развертываются во всех регионах и, возможно, еще недоступны в вашем регионе.
• Существующим пользователям конвейера может потребоваться обновить приложение конвейеров Power Platform, чтобы активировать новые функции. Вы можете управлять обновлениями в Центре администрирования Power Platform.
• Личные конвейеры, созданные в Power Apps (make.powerapps.com), не могут быть расширены.

Доступно расширение с ограниченным доступом

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

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

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

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

• Параметр «Требуется шаг перед развертыванием» обеспечивает дополнительную гибкость для вставки настраиваемого шага после утверждения развертывания. Например, если требуется окончательное одобрение.

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

Заметка

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

Понимание триггеров и действий конвейеров

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

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

Расширение с ограничением доступа	Триггер, срабатывающий при начале шага	Триггер завершения шага	Несвязанное действие	Используемое подключение
Требуется шаг перед экспортом	OnDeploymentRequested	Неприменимо	ОбновитьСтатусЭтапаПередЭкспортом	Любое удостоверение с доступом для обновления записи выполнения этапа развертывания
Делегированное развертывание	OnApprovalStarted	OnDeploymentCompleted	Создание подключения в качестве субъекта-службы или владельца этапа конвейера (смотря что настроено на этапе конвейера). Владелец этапа конвейера должен быть владельцем субъекта-службы в Microsoft Entra ID.
Необходим этап перед развертыванием	OnPreDeploymentStarted	OnPreDeploymentCompleted	UpdatePreDeploymentStepStatus	Любое удостоверение с доступом для обновления записи выполнения этапа развертывания

Заметка

Триггер OnDeploymentRequested активируется для всех развертываний.

Триггеры

Триггеры доступны в облачных потоках Power Automate в хост-среде конвейеров в триггереПри выполнении действия в соединителе Dataverse.

• Catalog: Microsoft Dataverse Common.
• Категория: конвейеры Power Platform.
• Имя таблицы: (Нет).
• Имя действия: Выберите вариант из списка. Конвейеры предоставляют следующие пользовательские действия, позволяющие создать триггер в облачных потоках Power Automate. События, связанные с утверждением и OnPreDeployment*, срабатывают только при включении соответствующего расширения. OnDeploymentRequested
OnApprovalStarted
OnApprovalCompleted
OnPreDeploymentStarted
OnPreDeploymentCompleted
OnDeploymentStarted
OnDeploymentCompleted

Здесь приведен пример снимка экрана с триггером.

Триггеры Конвейеров в Power Automate

Условия триггера

Условия срабатывания триггера в Power Automate позволяют настроить триггер таким образом, чтобы поток выполнялся только при выполнении определенных условий. Например, вам может потребоваться запустить разные потоки и связанную с ними бизнес-логику в разных конвейерах или этапах конвейера. Это также позволяет минимизировать количество выполнений потоков и поддерживать низкое потребление запросов Power Platform.

Запуск потока для определенного конвейера

Запускает выполнение потока для всех этапов конвейера (Contoso Pipeline). В этом примере замените Contoso Pipeline на имя вашего конвейера:

@equals(triggerOutputs()?['body/OutputParameters/DeploymentPipelineName'], 'Contoso Pipeline')

Запуск потока для определенного этапа в конвейере

Запускает поток для этапа развертывания с именем этапа, равным «Contoso UAT»:

@equals(triggerOutputs()?['body/OutputParameters/DeploymentStageName'], 'Contoso UAT')

Запуск потока для определенных этапов в конвейере

Запускает поток для этапов развертывания с именем этапа, содержащим «QA»:

@contains(triggerOutputs()?['body/OutputParameters/DeploymentStageName'], 'QA')

Дополнительные сведения о выражениях, используемых в условиях, см. в разделе Использования выражений в условиях для проверки нескольких значений.

Действия

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

Эти параметры предоставляются во всех действиях для соответствующих расширений с проверкой.

• UpdatePreExportStepStatus, UpdateApprovalStatus и PreDeploymentStepStatus:
  • 10 — это статус ожидания, установленный системой.
  • 20 за выполнение шага.
  • 30 за отклонение шага. Развертывание не будет продолжено, и его состояние изменится на «Сбой». Вы также можете добавить комментарии как для разработчика, так и для администратора, чтобы указать причину отклонения.
• ApprovalComments и комментарии перед развертыванием:
  • Комментарии, которые видны создателю в журнале выполнения конвейеров. Они предназначены для того, чтобы утверждающие могли делиться комментариями с запрашивающим утверждение создателем. Например, почему их развертывание было отклонено или информация о процессах конкретной компании.
• PreExportProperties и ApprovalProperties:
  • Администраторы могут хранить здесь информацию или пользовательские параметры, не раскрывая их пользователям — например, ссылку на выполнение или утверждение рабочей процедуры или другие соответствующие данные. Цель состоит в том, чтобы обеспечить гибкость и упростить пользовательские отчеты для данных, связанных с развертыванием.

Примеры

Загрузите и затем импортируйте требуемое управляемое решение в хост-среду конвейеров. Эти примеры можно настроить в соответствии с уникальными потребностями вашей организации.

Примеры расширяемости пайплайнов

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

Примеры делегированного развертывания

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

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

• Запуск конвейеров в Power Platform

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

• Расширение потока в Microsoft Power Platform — модуль обучения
• Что представляют собой облачные потоки?
  
• Используйте коннектор Dataverse с облачными потоками