ALM アクセラレータの展開設定
ALM アクセラレータ エクスポート パイプライン では、展開設定ペイロードを使用して、特定のソリューションと環境のための展開パイプラインをカスタマイズします。 展開設定ペイロードは、エクスポート パイプラインにパラメーターとして渡される JSON 文字列です。
次のテーブルは、各展開環境用のペイロードに含まれる展開設定を説明しています。
展開パイプライン設定
| 設定 | Required | Description |
|---|---|---|
| ApprovalType | いいえ | 展開パイプラインで使用する承認のタイプ |
| BuildName | はい | ビルド パイプラインの名前 |
| BuildTemplate | いいえ | ビルド パイプライン テンプレートの名前 |
| DeploymentEnvironmentName | はい | 展開環境の名前 |
| DeploymentEnvironmentUrl | はい | 展開環境の URL |
| EnvironmentUrl | はい | 開発/作成者環境の URL |
| ServiceConnectionName | はい | 開発/作成者環境へのサービス接続の名前 |
| StepType | いいえ | 展開パイプラインで使用するステップの種類 |
ユーザー設定
| 設定 | Required | Description |
|---|---|---|
| environmentvariable.environment-variable-schema-name | いいえ | 展開中に環境で環境変数の値を設定します。 |
| canvasshare.aadGroupId.canvas-app-schema-name | いいえ | キャンバスアプリを共有する Microsoft Entra グループ ID を設定します。 キャンバス アプリを複数の Microsoft Entra グループで共有する場合には、一意識別子 (.1 または .2) を設定の末尾に付けることができます。 |
| canvasshare.roleName.canvas-app-schema-name | いいえ | Microsoft Entra グループに割り当てるロールを設定します。 有効なオプションは、CanView、CanViewAndShare、および CanEdit です。 キャンバス アプリを複数の Microsoft Entra グループで共有する場合には、一意識別子 (.1 または .2) を設定の末尾に付けることができます。 |
| owner.ownerEmail.flow-name.flow-id | いいえ | ソリューションが展開環境にインポートされた後にフローが割り当てられた所有者を設定します。 |
| flow.sharing.flow-name.flow-id | いいえ | 展開環境でのソリューションのインポート後に、フローに関連するプロセス レコードを共有する Dataverse Microsoft Entra グループ チームを設定します。 |
| activateflow.activateas.flow-name.flow-id | いいえ | フローをアクティブ化するときに偽装するユーザーを設定します。 設定しない場合、接続作成ユーザーまたは所有者がフローのアクティブ化に使用されます。 |
| activateflow.order.flow-name.flow-id | いいえ | フローをアクティブ化する順序を設定すると、親/子フローをアクティブ化する場合に便利です。 ただし、順序が設定されていない場合、パイプラインは起動するフローがある限りフローの起動を試みます。 |
| activateflow.activate.flow-name.flow-id | いいえ | 特定のケースでは、フローを展開環境で意図的にオフの状態にする可能性があります。 この設定によって、展開時にフローをオンにするパイプラインか、オンにしないパイプラインがトリガーされます。 |
| connector.teamname.connector-name.connector-id | いいえ | ソリューションを展開環境にインポートした後に、カスタム コネクタに関連するコネクタ レコードを共有する Dataverse Microsoft Entra グループ チームを設定します。 |
| groupTeam.teamid.aadGroupId | いいえ | 展開環境で作成する Dataverse グループ チームを設定します。 |
| businessUnit.teamid.aadGroupId | いいえ | グループ チームに関連付けられた Dataverse 部署を設定します。 |
| webhookurl.webookname | いいえ | 展開環境で更新する webhook の URL を設定します。 |
| sdkstep.unsec.sdkstepid | いいえ | SDK 手順の保護されていない構成を設定して、展開環境で更新します。 |
| sdkstep.sec.sdkstepid | いいえ | SDK 手順の安全な構成を設定して、展開環境で更新します。 |
| TriggerSolutionUpgrade | いいえ | 環境への展開時にソリューションのアップグレードを適用するかどうかを設定します。 |
UserSettings は、展開パイプラインで設定される変数の配列です。 エクスポート パイプラインが実行されると、これらの値のプレースホルダーを使用して、展開設定とカスタム展開設定ファイルが生成されます。 展開パイプラインが実行されるとき、ほとんどのプレースホルダーが展開設定ペイロードの値で置き換えられます。 例外は、特定の予約済みパイプライン変数です (TriggerSolutionUpgrade など)。これは展開設定やカスタム展開設定に含まれません。 さらに、UseDeploymentSettingsPlaceholders が False に設定されている場合、プレースホルダーは使用されません。 代わりに、値は展開設定ファイルとカスタム展開設定ファイルに直接設定されます。
展開設定のスキーマ
展開設定のスキーマは、Dataverse ソリューションで展開した後に、構成が必要なコンポーネントに基づいています。 新しい機能が ALM アクセラレータに追加されると更新されます。 スキーマは、deployment-settings.schema.json ファイルで定義されます。
展開設定のサンプル ペイロード
サンプル ペイロードは、ALM アクセラレータ パイプラインの共通ペイロードの例です。 サンプル ペイロードは、deployment-settings.sample.json ファイルで定義されます。