Referenca dokumenta za slanje stavke kataloga

Prilikom slanja stavke u katalog morate uvrstiti podatke u JSON obliku. U ovom se članku opisuju valjana svojstva tog dokumenta. Ovaj JSON je primjer:

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

U ovoj su tablici opisana svojstva dokumenta za slanje:

Svojstvo Tip Obvezno Opis
modelVersion niz Ne Broj verzije poslanog dokumenta. Zadana je vrijednost 1.0.0.0.
sourcePortal cijeli br. Ne Određuje izvor ovog zahtjeva. Po zadanom je 526430005 TO PAC CLI. Za druge izvore koristite 526430000. Funkcija mspcat_GetPowerCatalogDetails vraća cijeli popis. Svojstvo mspcat_GetPowerCatalogDetailsResponse.CatalogDetails.sourceOptions sadrži popis dostupnih mogućnosti.
submissionId guid Ne Guid za identifikaciju slanja. Ta je vrijednost vanjski ključ koji omogućuje povezivanje zahtjeva s drugim sustavima.
operation niz Jest Za buduće proširenje i trenutno se ne poštuje. Vrsta operacije koja će se koristiti. Valjane vrijednosti:
- CreateOrUpdate (Zadano)
- Create
- Update
- Disabled
businessJustification niz Ne Opisuje poslovnu vrijednost slanja odobravatelju. Ta vrijednost može sadržavati HTML ili oblik obogaćenog teksta (RTF). Te se informacije prikazuju u iskustvu planirane potrošnje u korisničkom sučelju za otkrivanje proizvođača. Korisnici mogu reći da im slanje pomaže u smanjenju troškova ili produktivnosti, primjerice. Neke tvrtke ili ustanove zahtijevaju određene klase vrijednosti i te se vrijednosti mogu unijeti ovdje.
publisherDetails Izdavač Jest Izdavač povezan s ovim slanjem stavke.
catalogItemDefinition CatalogItemDefinition Jest Definira stavku kataloga koja se šalje.

Izdavač

Koristite ove podatke za određivanje svojstva stavke slanja kataloga publisherDetails .

Stvara izdavački zapis koji se može povezati s jednom ili više grupa Id sudionika tvrtke Microsoft koji sadrže ovlaštene korisnike koji ubuduće mogu ažurirati stavku kataloga.

Napomena

Nemojte pobrkati taj pojam s izdavačom rješenja. Izdavač stavke kataloga ne koristi se s rješenjima.

Morate navedite publisherDisplayName minimalno. publisherId može biti bilo koja vrijednost niza. Sustav provjerava postoji li taj izdavač, inače ga stvara i dodjeljuje publisherId.

IT tim za ljudske sustave razvojnih inženjera, primjerice, može stvoriti izdavača i ID razvojnim inženjerima pomoću grupe Microsoft Entra ID.

Evo primjera zapisa izdavača koji obuhvaća operacije za dodavanje osobe i grupe ID sudionika

{
   "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"
      }
   ]
}
Svojstvo Tip Obvezno Opis
publisherId niz Jest Jedinstveni ID za ovog izdavača. Pomoću ovog ID-a identificirajte ovog izdavača svaki put kada stvarate ili ažurirate stavku kataloga za ovog izdavača. Stavke kataloga moguće je istodobno pridružiti samo jednom izdavaču. Vrijednost može biti GUID ili niz. Nakon postavljanja, mora se održavati.
publisherDisplayName niz Jest Korisnici te podatke vide u galeriji kataloga.
publisherUpnList CatalogUPNOperation[] Ne Osobe koje mogu slati nove ili ažurirati stavke kataloga kao ovog izdavača. Prilikom prvog stvaranja programa Publisher uvijek uključuje korisnika koji ga je poslao.
publisherAADGroupOIDS CatalogGroupOperation[] Ne Grupe id-a sudionika čiji članovi smiju pristupiti ovom izdavaču.

CatalogUPNOperation

Koristite ove podatke za određivanje svojstva PublisherpublisherUpnList .

Definira postupak dodavanja ili uklanjanja osoba koje mogu slati nove ili ažurirati stavke kataloga kao ovog izdavača.

Svojstvo Tip Obvezno Opis
action niz Jest Akcija koju treba poduzeti s ovim UPN-om. Valjane vrijednosti: Add ili Remove.
upn niz Jest Korisničko glavno ime (UPN) korisnika.
userOid guid Jest Identifikator objekta za korisnika.

CatalogGroupOperation

Koristite ove podatke za određivanje svojstva PublisherpublisherAADGroupOIDS .

Definira operaciju za dodavanje ili uklanjanje grupe ID sudionika koja može pristupiti ovom izdavaču.

Svojstvo Tip Obvezno Opis
action niz Jest Akcija koju treba poduzeti s ovim UPN-om. Valjane vrijednosti: Add ili Remove.
groupName niz Jest Naziv grupe.
groupOid guid Jest Identifikator objekta za grupu.
groupType niz Jest Vrsta grupe koja se rješava. Valjane su vrijednosti Security i Modern.

CatalogItemDefinition

Koristite ove podatke za određivanje svojstva stavke slanja kataloga catalogItemDefinition .

Ova svojstva definiraju stavku kataloga koja se šalje. To je stvarno rješenje za Power Platform. Paket je pohranjen u katalogu.

Evo primjera stavke kataloga s obaveznim kontaktima engineeringNamesupportName i stavkama iz kataloga.

"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"
   }
   }
}
Svojstvo Tip Obvezno Opis
id guid Jest Jedinstveni ID stavke kataloga. Taj ID koristite kada ažurirate ili instalirate stavku kataloga.
displayName niz Jest Naziv koji se prikazuje korisnicima u galerijama kataloga.
description niz Ne Opis koji se prikazuje korisnicima u galerijama kataloga.
offer Pojedinosti ponude Jest Pojedinosti slanja stavke kataloga.
packageFile CatalogFileAsset Jest U članku se opisuje gdje nabaviti datoteku paketa kataloga za slanje.

Pojedinosti ponude

Koristite ove podatke za određivanje svojstva CatalogItemDefinitionoffer .

Ta svojstva definiraju pojedinosti slanja stavke kataloga.

Svojstvo Tip Obvezno Opis
businessCategories int[] Ne Popis vrijednosti mogućnosti odabira koje poštuje ciljni katalog. Određuje poslovne kategorije koje će se pridružiti ovoj stavci kataloga. Valjane vrijednosti za korištenje potražite u odjeljku Poslovne kategorije.
type niz Jest Vrsta stavke kataloga. Valjane vrijednosti:
- Application
- Component_Collection
supportsApplicationTypes niz[] Ne Popis podržanih vrsta aplikacija. Valjane vrijednosti:
- CanvasApps
- ModelApps
- PowerPortals
- PowerAutomate
deploymentType niz Jest Označava vrstu implementacije za uvođenje ove stavke kataloga. Valjane vrijednosti:
- Normal predstavlja upravljane stavke.
- Template Kopiju neupravljanog rješenja koju ostali stvaratelji mogu uređivati na način koji odašiljaju.
Dodatne informacije o vrstama stavki kataloga
searchKeywords niz[] Ne Riječi koje korisnici mogu koristiti za pronalaženje ove stavke kataloga.
small48x48Image CatalogFileAsset Ne Slika za prikaz galerije. Ako ne navedite tu sliku, koristi se zadana ikona sustava.
large216x216Image CatalogFileAsset Ne Slika za detaljni prikaz. Navedite ikonu koja će se prikazati u proizvođaču ili drugom korisničkom sučelju za otkrivanje. Neka korisnička sučelja koriste veće ikone za renderiranje kartica radi otkrivanja.
useCaseDocument CatalogFileAsset Ne Korištenje opisa slučaja i objašnjenja odobravateljima.
videos CatalogFileAsset[] Ne U prikazu detalja prikazuju se veze na te video/gif datoteke.
documents CatalogFileAsset[] Ne U prikazu detalja prikazuju se veze na te datoteke.
screenshots CatalogFileAsset[] Ne U prikazu detalja te se slike prikazuju. Snimke zaslona možete proslijediti ovdje u aplikaciji da biste lakše utvrdili nudi li aplikacija funkcionalnost ili mogućnosti koje traže. Najčešće korisnici prije preuzimanja aplikacije ili predloška mogu pogledati njezine slike i snimke zaslona da bi razumjeli mogućnosti umjesto čitanja opisa.
helpLink uri Ne Veza na dokumentaciju. Ti URL-ovi mogu biti veze na interne dokumente ili resurse sustava SharePoint.
privacyPolicyLink uri Ne Veza na dokument o zaštiti privatnosti. Pravilnici o pažljivom korištenju komponente ili aplikacije koja se šalje.
legalTermsLink uri Ne Veza na dokument s uvjetima i odredbama. Svi pravni uvjeti ili interne smjernice za procjenu potrošača stavke kataloga.
legalTerms niz Ne Markdown, HTML ili tekstna verzija dokumenta s uvjetima i odredbama. Svi pravni uvjeti ili interne smjernice za procjenu potrošača stavke kataloga.
sourceCodeRepositoryLink uri Ne Veza na spremište izvornog koda
engineeringName PersonContactInformation Jest Podaci za kontakt za inženjera ili grupu koji su razvili ovu stavku kataloga.
supportName PersonContactInformation Ne Podaci za kontakt za podršku ili grupu koji podržavaju ovu stavku kataloga. Može biti isti kao i inženjerski kontakt s kojim se korisnik stavke kataloga može obratiti ako naiđete na probleme s aplikacijom.

Poslovne kategorije

Postavite svojstvo OfferDetailsbusinessCategories na jednu ili više ovih poslovnih kategorija:

Kôd Opis
526430000 Službu
526430001 Upravljanje projektom
526430002 Upravljanje kalendarom i raspoređivanje
526430003 Upravljanje e-poštom
526430004 Datoteke i dokumentacija
526430005 Obavijesti i podsjetnici
526430006 Analitika
526430007 Suradnja
526430008 Commerce
526430009 Financije
526430010 Usklađenost i pravne napomene
526430011 Sales
526430012 IT alati
526430013 Marketing
526430014 Lanac operacija i opskrbe
526430015 internet stvari
526430016 Strojno učenje AI
526430017 Geolokacija
526430018 Ljudski potencijali

Trenutno nove poslovne kategorije nije moguće konfigurirati, ali ih je moguće dohvatiti iz globalnog izbora kategorije kataloga (mspcat_catalogbusinesscategory).

CatalogFileAsset

Ta svojstva definiraju datoteku referenciranu u svojstvima CatalogItemDefinitionpackageFile i OfferDetailssmall48x48Image, large216x216Image, useCaseDocument, videos, documentsi screenshots .

Svojstvo Tip Obvezno Opis
name niz Jest Naziv datoteke.
filesaslink uri Jest Veza za preuzimanje datoteke. Ako je za vezu potrebna provjera autentičnosti, navedite URL za potpis zajedničkog pristupa (SAS).

PersonContactInformation

Ta svojstva definiraju osobe u stavci kataloga OfferDetailsengineeringName i svojstva supportName .

Svojstvo Tip Obvezno Opis
firstName niz Ne Ime osobe.
lastName niz Jest Ime obitelji osobe.
email niz Jest Adresa e-pošte osobe.
phoneNumber niz Ne Telefonski broj osobe.
  • Last updated on