目錄項目提交文件參考

當您將項目提交至目錄時，您必須包含 JSON 格式的資料。 本文說明該檔的有效屬性。 此 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"
      }
    },
      "packageFile": {
         "name": "packageFileName.zip",
         "filesaslink": "https://Contoso.blob.core.windows.net/ContosoConferencesCustomConnector/packageFileName.zip"
      }
  }
}

下表說明提交文件的內容：

Publisher

使用此資料來指定型錄提交項目 publisherDetails 內容。

建立可與一或多個 Microsoft Entra ID 群組相關聯的發行者記錄，其中包含授權使用者，這些使用者可以繼續更新目錄專案。

您至少需要提供。publisherDisplayName publisherId 可以是任何字串值。 系統會檢查該發行者是否存在，否則會建立它並指派 publisherId.

例如，開發人員的 HR IT 小組可以建立發行者，並使用 Microsoft Entra ID 群組來識別開發人員。

以下是發行者記錄的範例，其中包含新增人員和 Entra ID 群組的作業

{
   "publisherId": "MyPublisherId",
   "publisherDisplayName": "Contoso Publishing",
   "publisherUpnList": [
      {
         "action": "Add",
         "upn": "john.doe@contoso.com"
      }
   ],
   "publisherAADGroupOIDS": [
      {
         "action": "Add",
         "groupName": "PowerCatalogSubmitters",
         "groupOID": "2ded6de9-ab44-4478-9bd4-e609947daa2e",
         "groupType": "Security"
      }
   ]
}

目錄UPN操作

使用此資料來指定 PublisherpublisherUpnList 屬性。

定義一個作業，以新增或移除可以提交新或更新目錄項目作為此發行者的人員。

CatalogGroup作業

使用此資料來指定 PublisherpublisherAADGroupOIDS 屬性。

定義新增或移除可存取此發行者的 Entra ID 群組的作業。

目錄項目定義

使用此資料來指定型錄提交項目 catalogItemDefinition 內容。

這些內容會定義要提交的型錄項目。 這是實際的 Power Platform 解決方案。 套件是儲存在型錄中的內容。

以下是目錄項目的範例，包括其engineeringNamesupportName和必填的連絡人。

"catalogItemDefinition": {
   "id": "ContosoTravelsApp",
   "displayName": "Contoso Travel Expense App",
   "description": "Submit expenses on the go!",
   "offer": {
   "businessCategories": [526430000, 526430001, 526430002],
   "type": "Component_Collection",
   "deploymentType": "Normal",
   "small48x48Image": {
      "name": "Small48Image",
      "fileSasLink": "https://www.contoso.com/icon48.jpg"      
   },
   "large216x216Image": {
      "name": "Large216image2",
      "fileSasLink": "https://www.contoso.com/icon216.jpg"
   },
   "documents": [
      {
         "name": "ImaNewfile",
         "fileSasLink": "https://www.contoso.com/screenshot1.jpg"
      },
      {
         "name": "ImaNewfile2",
         "fileSasLink": "https://www.contoso.com/screenshot2.jpg"
      }
   ],
   "helpLink": "https://www.contoso.com/help.html",
   "privacyPolicyLink": "https://www.contoso.com/privacy.html",
   "legalTerms": "https://www.contoso.com/legal.html",
   "engineeringName": {
      "firstName": "John",
      "lastName": "Roon",
      "email": "john@contoso.com",
      "phoneNumber": "999-111-1234"
   },
   "supportName": {
      "firstName": "Jane",
      "lastName": "Drill",
      "email": "jane@contoso.com",
      "phoneNumber": "999-111-1234"
   }
   }
}

優惠詳情

使用此資料來指定 CatalogItemDefinitionoffer 屬性。

這些內容會定義型錄項目提交的詳細資料。

業務類別

將 OfferDetailsbusinessCategories 屬性設定為下列一或多個業務類別：

目前無法設定新的業務類別，但可以從目錄業務類別 （mspcat_catalogbusinesscategory） 全域選項中擷取。

目錄檔案資產

這些屬性會定義 CatalogItemDefinitionpackageFile 和 OfferDetailssmall48x48Image、large216x216Image、useCaseDocumentvideosdocuments、 和screenshots屬性中參考的檔案。

人員聯絡資訊

這些屬性會定義目錄項目 OfferDetailsengineeringName 和 supportName 屬性中的人員。