Dokumentacja dokumentu przesyłania elementów wykazu

Podczas przesyłania elementu do wykazu należy uwzględnić dane w formacie JSON. W tym artykule opisano prawidłowe właściwości tego dokumentu. Ten kod JSON jest przykładem:

{
  "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"
      }
  }
}

W tej tabeli opisano właściwości dokumentu przesyłania:

Publisher

Użyj tych danych, aby określić właściwość elementu publisherDetails przesyłania wykazu.

Tworzy rekord wydawcy, który może być skojarzony z co najmniej jedną grupą identyfikatorów Entra firmy Microsoft zawierającą autoryzowanych użytkowników, którzy mogą wprowadzać aktualizacje do elementu wykazu w przyszłości.

Musisz podać publisherDisplayName wartość minimalną. publisherId może być dowolną wartością ciągu. System sprawdza, czy ten wydawca istnieje, a następnie tworzy go i przypisuje element publisherId.

Na przykład zespół IT działu kadr deweloperów może utworzyć wydawcę i identyfikator deweloperów przy użyciu grupy Identyfikator entra firmy Microsoft.

Oto przykład rekordu wydawcy zawierającego operacje dodawania osoby i grupy Identyfikator entra

{
   "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"
      }
   ]
}

CatalogUPNOperation

Użyj tych danych, aby określić właściwość wydawcypublisherUpnList .

Definiuje operację dodawania lub usuwania osób, które mogą przesyłać nowe lub aktualizowane elementy wykazu jako ten wydawca.

CatalogGroupOperation

Użyj tych danych, aby określić właściwość wydawcypublisherAADGroupOIDS .

Definiuje operację dodawania lub usuwania grupy identyfikatorów entra, która może uzyskiwać dostęp do tego wydawcy.

CatalogItemDefinition

Użyj tych danych, aby określić właściwość elementu catalogItemDefinition przesyłania wykazu.

Te właściwości definiują przesyłany element wykazu. Jest to rzeczywiste rozwiązanie platformy Power Platform. Pakiet jest przechowywany w wykazie.

Oto przykład elementu wykazu, w tym jego engineeringName i supportName kontakty, które są obowiązkowe.

"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"
   }
   }
}

Szczegóły oferty

Użyj tych danych, aby określić właściwość CatalogItemDefinitionoffer .

Te właściwości definiują szczegóły przesyłania elementu wykazu.

Kategorie biznesowe

Ustaw właściwość OfferDetailsbusinessCategories na co najmniej jedną z następujących kategorii biznesowych:

Obecnie nie można skonfigurować nowych kategorii biznesowych, ale można je pobrać z kategorii biznesowej wykazu (mspcat_catalogbusinesscategory) wyboru globalnego.

CatalogFileAsset

Te właściwości definiują plik, do których odwołuje się katalogItemDefinitionpackageFile i właściwości OfferDetailssmall48x48Image, , large216x216ImageuseCaseDocumentvideos, documents, i screenshots .

PersonContactInformation

Te właściwości definiują osoby w elemencie katalogu OfferDetailsengineeringName i supportName właściwości.