Kataloga preces iesniegšanas dokumenta atsauce

Iesniedzot preci katalogā, dati ir jāiekļauj JSON formātā. Šajā rakstā ir aprakstīti šī dokumenta derīgie rekvizīti. Šis JSON ir piemērs:

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

Šajā tabulā ir aprakstīti iesniegšanas dokumenta rekvizīti:

Rekvizīts Tips Obligāti Apraksts
modelVersion virkne Nē. Iesnieguma dokumenta versijas numurs. Noklusējums ir 1.0.0.0.
sourcePortal int Nē. Identificē šī pieprasījuma avotu. Noklusējumi 526430005 , kas ir PAC CLI. Citiem avotiem izmantojiet 526430000. Funkcija mspcat_GetPowerCatalogDetails atgriež pilnu sarakstu. Rekvizītā mspcat_GetPowerCatalogDetailsResponse.CatalogDetails.sourceOptions ir uzskaitītas pieejamās opcijas.
submissionId guid Nē. GUID, lai identificētu iesniegumu. Šī vērtība ir ārējā atslēga, kas ļauj saistīt pieprasījumu ar citām sistēmām.
operation virkne Jā Turpmākai paplašināšanai un pašlaik netiek ievērots. Izmantojamās darbības veids. Derīgas vērtības:
- CreateOrUpdate (Noklusējums)
- Create
- Update
- Disabled
businessJustification virkne Nē. Apraksta apstiprinātājam iesniegtā iesnieguma uzņēmējdarbības vērtību. Šī vērtība var saturēt HTML vai bagātinātā teksta formātu (RTF). Šī informācija tiek parādīta plānotajā patēriņa pieredzē veidotāja atklāšanas lietotāja pieredzē. Lietotāji var teikt, ka viņu iesniegums palīdz, piemēram, samazināt izmaksas vai produktivitāti. Dažām organizācijām ir nepieciešamas noteiktas vērtību klases, un šīs vērtības var ievadīt šeit.
publisherDetails Publisher Jā Izdevējs, kas saistīts ar šī vienuma iesniegšanu.
catalogItemDefinition CatalogItemDefinition Jā Definē iesniedzamo kataloga vienumu.

Izdevējs

Izmantojiet šos datus, lai norādītu kataloga iesniegšanas vienuma publisherDetails rekvizītu.

Izveido izdevēja ierakstu, ko var saistīt ar vienu vai vairākām Microsoft Entra ID grupām, kurās ir autorizēti lietotāji, kuri turpmāk var veikt kataloga vienuma atjauninājumus.

Piezīmes

Nejauciet šo terminu ar risinājumu izdevēju. Kataloga vienumu izdevējs netiek izmantots kopā ar risinājumiem.

Jums ir publisherDisplayName jānodrošina vismaz. publisherId var būt jebkura virknes vērtība. Sistēma pārbauda, vai izdevējs pastāv, citādi to izveido un piešķir .publisherId

Piemēram, HR IT izstrādātāju komanda var izveidot izdevēju un identificēt izstrādātājus, izmantojot Microsoft Entra ID grupu.

Tālāk ir sniegts izdevēja ieraksta paraugs, kas ietver personas un Entra ID grupas pievienošanas operācijas

{
   "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"
      }
   ]
}
Rekvizīts Tips Obligāti Apraksts
publisherId virkne Jā Šī izdevēja unikālais ID. Izmantojiet šo ID, lai identificētu šo izdevēju ikreiz, kad veidojat vai atjaunināt šī izdevēja kataloga vienumu. Kataloga vienumus vienlaikus var saistīt tikai ar vienu izdevēju. Vērtība var būt GUID vai virkne. Kad tas ir iestatīts, tas ir jāuztur.
publisherDisplayName virkne Jā Patērētāji šos datus redz kataloga galerijā.
publisherUpnList CatalogUPNOperation[] Nē. Personas, kas var iesniegt jaunus vai atjaunināt kataloga vienumus kā šis izdevējs. Vienmēr iekļauj iesniedzēju lietotāju, kad izdevējs tiek izveidots pirmo reizi.
publisherAADGroupOIDS Kataloga grupas operācija[] Nē. Entra ID grupas, kuru dalībniekiem ir atļauts piekļūt šim izdevējam.

CatalogUPNOperation

Izmantojiet šos datus, lai norādītu rekvizītu PublisherpublisherUpnList .

Definē darbību, lai pievienotu vai noņemtu personas, kuras var iesniegt jaunus vai atjaunināt kataloga vienumus kā šis izdevējs.

Rekvizīts Tips Obligāti Apraksts
action virkne Jā Darbība, kas jāveic ar šo UPN. Derīgas vērtības: Add vai Remove.
upn virkne Jā Lietotāja pamatvārds (UPN).
userOid guid Jā Lietotāja objekta identifikators.

Kataloga grupas operācija

Izmantojiet šos datus, lai norādītu rekvizītu PublisherpublisherAADGroupOIDS .

Definē operāciju, lai pievienotu vai noņemtu Entra ID grupu, kas var piekļūt šim izdevējam.

Rekvizīts Tips Obligāti Apraksts
action virkne Jā Darbība, kas jāveic ar šo UPN. Derīgas vērtības: Add vai Remove.
groupName virkne Jā Grupas nosaukums.
groupOid guid Jā Grupas objekta identifikators.
groupType virkne Jā Uzrunātās grupas veids. Derīgas vērtības ir Security un Modern.

CatalogItemDefinition

Izmantojiet šos datus, lai norādītu kataloga iesniegšanas vienuma catalogItemDefinition rekvizītu.

Šie rekvizīti definē iesniedzamo kataloga vienumu. Šis ir faktiskais Power Platform risinājums. Pakete ir katalogā glabātā pakete.

Tālāk ir sniegts kataloga vienuma piemērs, ieskaitot tā engineeringName un kontaktpersonas, kas ir supportName obligātas.

"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"
   }
   }
}
Rekvizīts Tips Obligāti Apraksts
id guid Jā Kataloga krājuma unikālais ID. Izmantojiet šo ID, atjauninot vai instalējot kataloga vienumu.
displayName virkne Jā Nosaukums, kas patērētājiem tiek parādīts kataloga galerijās.
description virkne Nē. Apraksts patērētājiem tiek parādīts kataloga galerijās.
offer Piedāvājuma detaļas Jā Detalizēta informācija par kataloga vienuma iesniegšanu.
packageFile Kataloga faila aktīvs Jā Aprakstīts, kur iegūt kataloga pakotnes failu iesniegšanai.

Piedāvājuma detaļas

Izmantojiet šos datus, lai norādītu rekvizītu CatalogItemDefinitionoffer .

Šie rekvizīti definē kataloga krājuma iesniegšanas detaļas.

Rekvizīts Tips Obligāti Apraksts
businessCategories int[] Nē. Izvēles opciju vērtību saraksts, ko ievēro mērķa katalogs. Identificē biznesa kategorijas, kas jāsaista ar šo kataloga vienumu. Skatiet sadaļu Uzņēmumu kategorijas , lai uzzinātu derīgās vērtības.
type virkne Jā Kataloga vienuma tips. Derīgas vērtības:
- Application
- Component_Collection
supportsApplicationTypes virkne[] Nē. Atbalstīto lietojumprogrammu tipu saraksts. Derīgas vērtības:
- CanvasApps
- ModelApps
- PowerPortals
- PowerAutomate
deploymentType virkne Jā Norāda izvietošanas veidu, lai izvietotu šo kataloga vienumu. Derīgas vērtības:
- Normal apzīmē pārvaldītu vienumu.
- Template Jūsu nepārvaldītā risinājuma kopija, ko citi veidotāji var rediģēt, kā viņi vēlas.
Papildinformācija par kataloga krājumu tipiem
searchKeywords virkne[] Nē. Vārdi, ko lietotāji var izmantot, lai atrastu šo kataloga vienumu.
small48x48Image Kataloga faila aktīvs Nē. Attēls galerijas skatam. Ja nenorādāt šo attēlu, tiek izmantota sistēmas noklusējuma ikona.
large216x216Image Kataloga faila aktīvs Nē. Attēls detalizētam skatam. Norādiet ikonu, kas jāparāda veidotāja vai citā atklāšanas lietotāja interfeisā. Dažās lietotāju pieredzēs tiek izmantotas lielākas ikonas, lai atveidotu kartītes atklāšanai.
useCaseDocument Kataloga faila aktīvs Nē. Lietošanas gadījuma apraksts un paskaidrojums apstiprinātājiem.
videos Kataloga faila aktīvs[] Nē. Detalizētajā skatā tiek parādītas saites uz šiem video/gif failiem.
documents Kataloga faila aktīvs[] Nē. Detalizētajā skatā tiek parādītas saites uz šiem failiem.
screenshots Kataloga faila aktīvs[] Nē. Detalizētajā skatā tiek parādīti šie attēli. Šeit varat nodot savas lietojumprogrammas ekrānuzņēmumus, lai palīdzētu veidotājiem noteikt, vai šī lietotne nodrošina meklēto funkcionalitāti vai iespējas. Visbiežāk, ko cilvēki dara pirms lietotnes vai veidnes lejupielādes, ir aplūkot tās attēlus un ekrānuzņēmumus, lai saprastu iespējas, nevis lasīt aprakstu.
helpLink URI Nē. Saite uz dokumentāciju. Šie URL var būt saites uz iekšējiem dokumentiem vai SharePoint resursiem.
privacyPolicyLink URI Nē. Saite uz konfidencialitātes dokumentu. Politikas par iesniegtā komponenta vai lietojumprogrammas rūpīgu lietošanu.
legalTermsLink URI Nē. Saite uz noteikumu un nosacījumu dokumentu. Jebkuri juridiskie noteikumi vai iekšējās vadlīnijas kataloga preces patērētāja novērtēšanai.
legalTerms virkne Nē. Noteikumu un nosacījumu dokumenta Markdown, HTML vai teksta versija. Jebkuri juridiskie noteikumi vai iekšējās vadlīnijas kataloga preces patērētāja novērtēšanai.
sourceCodeRepositoryLink URI Nē. Saite uz avota koda repozitoriju
engineeringName PersonKontaktinformācija Jā Inženiera vai grupas kontaktinformācija, kas izstrādāja šo kataloga vienumu.
supportName PersonKontaktinformācija Nē. Atbalsta vai grupas kontaktinformācija, kas atbalsta šo kataloga vienumu. Var būt tāds pats kā inženiertehniskā kontaktpersona, ar kuru kataloga vienuma patērētājs var sazināties, ja rodas problēmas ar lietojumprogrammu.

Uzņēmumu kategorijas

Iestatiet rekvizītu OfferDetailsbusinessCategories uz vienu vai vairākām tālāk norādītajām uzņēmējdarbības kategorijām.

Kods Apraksts
526430000 Klientu apkalpošana
526430001 Projektu vadība
526430002 Kalendāra pārvaldība un plānošana
526430003 E-pasta pārvaldība
526430004 Faili un dokumentācija
526430005 Paziņojumi un atgādinājumi
526430006 Analīze
526430007 Sadarbība
526430008 Commerce
526430009 Finance
526430010 Atbilstība un juridiskie jautājumi
526430011 Sales
526430012 IT rīki
526430013 Marketing
526430014 Operācijas un piegādes ķēde
526430015 lietiskais internets
526430016 AI mašīnmācīšanās
526430017 Ģeogrāfiskā atrašanās vieta
526430018 Cilvēkresursu

Pašlaik jaunas biznesa kategorijas nevar konfigurēt, bet tās var izgūt no globālās izvēles Kataloga biznesa kategorija (mspcat_catalogbusinesscategory).

Kataloga faila aktīvs

Šie rekvizīti definē failu, uz kuru ir atsauce CatalogItemDefinitionpackageFile un rekvizītos OfferDetailssmall48x48Image, large216x216Image, useCaseDocument, videosdocuments, , un screenshots rekvizīti.

Rekvizīts Tips Obligāti Apraksts
name virkne Jā Faila nosaukums.
filesaslink URI Jā Saite, lai lejupielādētu failu. Ja saitei ir nepieciešama autentifikācija, norādiet koplietojamās piekļuves paraksta (SAS) URL.

PersonKontaktinformācija

Šie rekvizīti definē personas kataloga vienumā OfferDetailsengineeringName un supportName rekvizīti.

Rekvizīts Tips Obligāti Apraksts
firstName virkne Nē. Personas vārds.
lastName virkne Jā Personas uzvārds.
email virkne Jā Personas e-pasta adrese.
phoneNumber virkne Nē. Personas tālruņa numurs.
  • Last updated on