次の方法で共有


カタログアイテムの送信と承認

人々はカタログ アイテムを承認のために送信する必要があり、他のユーザーが使用できるようにするには管理者がそれを承認する必要があります。

カタログに送信するには、次が必要となります:

  • 送信するアイテムを含むソリューション、または Package Deployer パッケージ。

  • 送信メタデータ JSON 文書。

    pac category create-submission コマンドを使用して、送信メタデータ JSON ドキュメントの例を取得します。 さらに送信属性を追加するには、このドキュメントを編集する必要があります。 詳細: 送信の属性

送信の属性

アイテムをカタログに送信する前に、送信するアイテムを説明する JSON ドキュメントを準備する必要があります。

これを支援するために、pac category create-submission コマンドによりサンプル submission.json ファイルが生成されます。

アイテムを提出するには、このファイルを編集する必要があります。 次に例を示します。

{
  "modelVersion": "1.0.0.0",
  "operation": "CreateOrUpdate",
  "sourcePortal": 526430005,
  "businessJustification": "Power Platform custom connector for Conference API",
  "publisherDetails": {
    "publisherId": "ContosoConferencesTeam",
    "publisherDisplayName": "Catalog Conferences Team"
  },
  "catalogItemDefinition": {
    "id": "ContosoConferencesCustomConnector",
    "displayName": "Contoso Conference Custom Connector",
    "description": "Demo Custom connector to query Conference Speakers & Sessions",
    "offer": {
      "type": "Component_Collection",
      "deploymentType": "Normal",
      "engineeringName": {
        "firstName": "Jennifer",
        "lastName": "Wilkins",
        "email": "jwilkins@contoso.com",
        "phoneNumber": "555-111-1234"
      },
      "supportName": {
        "firstName": "Aidan",
        "lastName": "Hunt",
        "email": "ahunt@contoso.com",
        "phoneNumber": "555-111-1234"
      }
    }
  }
}

提出ファイルの有効なプロパティについて説明します

アイテムをカタログに送信する

カタログに送信されるアイテムは、パッケージ展開パッケージに含める必要があります。 パッケージ展開パッケージには、ソリューション zip ファイルと、パッケージの展開時に適用するオプションの手順が含まれています。 Package Deployer パッケージがない場合は、アイテムを含むソリューション用にパッケージを作成できます。

送信メタデータ JSON ドキュメントが完成したら、pac catalog submit コマンドを使用して送信します。

カタログ提出 JSON ドキュメントを参照するには、必須の --path パラメーターを使用します。

すでに Package Deployer パッケージをお持ちの場合:

  • Package Deployer パッケージを参照するには、--package-zip パラメータを使用します。
  • それ以外の場合は、--solution-zip パラメータを使ってこのソリューションを参照してください。 submit コマンドは、バックグラウンドでパッケージを作成します。

送信要求のステータスのポーリングを組み合わせる場合は、--poll-status パラメータを使ってください。 それ以外の場合は、カタログ送信のステータスを確認するで説明されているように、pac catalog statusコマンドを使ってください。

pac catalog submit -p "BuildDemoSubmission.json" -sz "ContosoConference_1_0_0_1_managed.zip"
Creating package for catalog submit request...
Connected to... TestCatalog
Connected as user@domain
Tracking id for this submission is 0e6b119d-80f3-ed11-8849-000d3a0a2d9d

Microsoft Power Platform CLI とは?

管理されていないソリューションから Package Deployer パッケージを作成する

mspcat_SubmitCatalogApprovalRequestで説明されているように、 メッセージを .NET 用 SDK または Web API で使用する場合、送信 JSON ファイルに、Package Deployer パッケージ ファイルをダウンロードするための URL を指定するように で設定された packageFilefilesaslinkプロパティが含まれている必要があります。 自動的に行われるため、pac catalog submit コマンドでこれを行う必要はありません。

この URL は、Dataverse 資格情報なしでファイルをダウンロードできる任意の場所を表すことができますが、パブリックのダウンロード場所にファイルを配置することはお勧めしません。 代わりに、パッケージ送信ストア (mspcat_PackageStore) テーブルを使用して、テナント内の任意の環境から非管理ソリューションを使用して Package Deployer パッケージを生成できます。 このプロセスは、PackageFile (mspcat_PackageFile) ファイル列にパッケージを含むレコードをこのテーブルに生成します。 その後、GetFileSasUrl のメッセージを使って共有アクセス署名 (SAS) URL を取得し、1 時間以内にファイルを匿名でダウンロードできるようにします。 URL は 1 時間以内にのみ有効であるため、ファイルをダウンロードするためのアクセスが期限切れにならないように、このプロセスを自動化する必要があります。

注意

この例では、mspcat_PackageStore.mspcat_packagefile 列を使用していますが、GetFileSasUrl メッセージでは、Dataverse 内の任意のファイルまたはイメージ列の SAS URL を提供できます。 共有アクセス署名を使用した Dataverse ファイルへの制限付きアクセス権の付与

Process

  1. 以下の値でパッケージ送信ストア (mspcat_PackageStore) レコードを作成します

    Column 価値
    mspcat_name アンマネージド ソリューションの名前
    mspcat_solutionuniquename アンマネージド ソリューションの一意の名前
    mspcat_intendeddeploymenttype 526430000導入の
    mspcat_operation 958090001
  2. statuscode の値を 958090003 から 958090004 に更新します。

    この更新により、プロセスが開始されます。

  3. statuscode958090001に変わるまで待ちます。

  4. GetFileSasUrlの URL を取得するには を使用します。 これは、GetFileSasUrlResponse オブジェクトを返します。

  5. CatalogFileAsset JSON オブジェクトを次のプロパティを設定するように作成します。

    Property 価値
    name GetFileSasUrlResponse.FileName
    filesaslink GetFileSasUrlResponse.SasUrl
  6. これを、JSON 送信ファイルの CatalogItemDefinitionpackageFile プロパティに設定します。

  7. mspcat_SubmitCatalogApprovalRequest を使用して、カタログにアイテムを送信するの説明に従って、送信します

PAC CLI pac catalog submit コマンド がこれを管理します。

カタログの送信状況を確認する

承認要求 (mspcat_certificationrequest) テーブルstatuscode Choices/Options オプション。 完了 (2) は、送信が成功したことを表します。

価値 ラべル
6 提出済み
526430001 InProgress
526430002 送信者を待機しています
526430003 展開を保留しています
526430008 下書きです
526430009 処理中
2 Completed
526430000 破棄済み
526430004 Rejected
526430005 マーケティング コンテンツ
526430006 重複した要求
526430010 失敗した事前検証

pac category status コマンドを使用して、カタログ送信のステータスを確認します。

pac catalog status --tracking-id 0e6b119d-80f3-ed11-8849-000d3a0a2d9d --type submit
Connected to... TestCatalog
Connected as user@domain
Status of the Submit request: Submitted

Microsoft Power Platform CLI とは?

カタログの提出を承認する

カタログの送信は通常、Power Platform カタログ マネージャー アプリケーション内で承認されます。

この操作を実行するための PAC CLI コマンドはありません。

次の手順