Partekatu bidez

Katalogoko elementuak bidaltzeko dokumentuaren erreferentzia

Datuak JSON formatuan sartu behar dituzu elementu bat katalogora bidaltzerakoan. Artikulu honetan dokumentu horren baliozko propietateak azaltzen dira. JSON hau adibide bat da:

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

Taula honetan bidalketa-dokumentuaren propietateak azaltzen dira:

Propietateak Mota Beharrezkoa Deskribapena
modelVersion kate No Bidalketa-dokumentuaren bertsio-zenbakia. Lehenetsia 1.0.0.0 da.
sourcePortal osoko zenbakia No Eskaera honen iturria identifikatzen du. Lehenetsia 526430005 PAC CLI da. Beste iturri batzuetarako, erabili 526430000. Funtzioak mspcat_GetPowerCatalogDetails zerrenda osoa itzultzen du. Propietateak mspcat_GetPowerCatalogDetailsResponse.CatalogDetails.sourceOptions erabilgarri dauden aukerak zerrendatzen ditu.
submissionId Guid No Aurkezpena identifikatzeko. Balio hau atzerriko gakoa da, eskaera beste sistema batzuekin estekatu ahal izateko.
operation kate Bai Etorkizuneko hedapena eta gaur egun ez da errespetatzen. Erabili beharreko eragiketa mota. Baliozko balioak:
- CreateOrUpdate (Lehenetsia)
- Create
- Update
- Disabled
businessJustification kate No Onartzaileari aurkezpenaren negozio-balioa deskribatzen du. Balio honek HTML edo RTF (Rich Text Format) izan dezake. Informazio hori planifikatutako kontsumo-esperientzian agertzen da maker discovery erabiltzailearen esperientzian. Erabiltzaileek esan dezakete beren aurkezpenak kostuak murrizten edo produktibitatea murrizten laguntzen duela, adibidez. Erakunde batzuek balio klase jakin batzuk eskatzen dituzte eta balio horiek hemen sar daitezke.
publisherDetails Argitaletxea Bai Artikulu honekin lotutako argitaratzailea.
catalogItemDefinition CatalogItemDefinition Bai Bidaltzen ari den katalogoko elementua definitzen du.

Argitaratzailea

Erabili datu hauek katalogoa bidaltzeko elementuaren propietatea publisherDetails zehazteko.

Argitaratzaile erregistro bat sortzen du, baimendutako erabiltzaileak dituzten Microsoft Entra ID talde batekin edo gehiagorekin lotu daitekeena, aurrerantzean katalogoko elementua eguneratu dezaketenak.

Oharra

Ez nahastu termino hau Solution Publisher-ekin. Katalogoko elementuen argitaratzailea ez da irtenbideekin erabiltzen.

Gutxienez eman publisherDisplayName behar duzu. publisherId Edozein kate-balio izan daiteke. Sistemak argitaratzaile hori existitzen den egiaztatzen du, bestela sortzen du eta publisherId.

Adibidez, HR IT garatzaileen taldeak argitaratzaile bat sor dezake eta garatzaileak identifikatu ditzake Microsoft Entra ID talde bat erabiliz.

Hona hemen argitaletxearen erregistro baten lagin bat, pertsona bat eta Entra ID talde bat gehitzeko eragiketak biltzen dituena

{
   "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"
      }
   ]
}
Propietateak Mota Beharrezkoa Deskribapena
publisherId kate Bai Argitaratzaile honen ID esklusiboa. Erabili ID hau argitaratzaile hau identifikatzeko argitaletxe honen katalogo-elementu bat sortzen edo eguneratzen ari zaren bakoitzean. Katalogoko elementuak argitaletxe bakar bati soilik elkartu daitezke aldi berean. Balioa GUID edo katea izan daiteke. Behin ezarrita, mantendu egin behar da.
publisherDisplayName kate Bai Kontsumitzaileek datu horiek katalogoko galerian ikusten dituzte.
publisherUpnList CatalogUPNOperation[aldatu | aldatu iturburu kodea] No Katalogoko elementu berriak edo eguneratuak argitaratzaile gisa bidal ditzaketen pertsonak. Bidaltzailea bidaltzen duen erabiltzailea beti sartzen da argitaratzailea sortzen den lehen aldian.
publisherAADGroupOIDS Katalogo-taldearen eragiketa[aldatu | aldatu iturburu kodea] No Entra ID Argitaletxe honetara sartzeko baimena duten kideek duten taldeak.

CatalogUPNOperation

Erabili datu hauek PublisherpublisherUpnList propietatea zehazteko.

Katalogoko elementu berriak edo eguneratu ditzaketen pertsonak gehitzeko edo kentzeko eragiketa bat definitzen du.

Propietateak Mota Beharrezkoa Deskribapena
action kate Bai UPN honekin egin beharreko ekintza. Baliozko balioak: Add edo Remove.
upn kate Bai Erabiltzailearen izen nagusia (UPN).
userOid Guid Bai Erabiltzailearen objektu-identifikatzailea.

Katalogo-taldearen eragiketa

Erabili datu hauek PublisherpublisherAADGroupOIDS propietatea zehazteko.

Argitaratzaile honetara atzitu daitekeen Entra ID talde bat gehitzeko edo kentzeko eragiketa definitzen du.

Propietateak Mota Beharrezkoa Deskribapena
action kate Bai UPN honekin egin beharreko ekintza. Baliozko balioak: Add edo Remove.
groupName kate Bai Taldearen izena.
groupOid Guid Bai Taldearen objektu-identifikatzailea.
groupType kate Bai Zuzendutako talde mota. Baliozko balioak eta SecurityModerndira.

CatalogItemDefinition

Erabili datu hauek katalogoa bidaltzeko elementuaren propietatea catalogItemDefinition zehazteko.

Propietate hauek bidaltzen ari den katalogoko elementua definitzen dute. Hau da Power Platform-en benetako irtenbidea. Pakete bat katalogoan gordetzen dena da.

Hona hemen katalogoko elementu baten adibide bat, derrigorrezkoak diren kontaktuak engineeringName barne supportName .

"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"
   }
   }
}
Propietateak Mota Beharrezkoa Deskribapena
id Guid Bai Katalogoko elementuaren ID esklusiboa. Erabili ID hau katalogoko elementua eguneratzean edo instalatzean.
displayName kate Bai Kontsumitzaileei katalogoko galerietan erakusten zaien izena.
description kate No Kontsumitzaileei katalogoko galerietan erakusten zaien deskribapena.
offer Eskaintzaren xehetasunak Bai Katalogoko elementuen bidalketaren xehetasunak.
packageFile KatalogoaFitxategiaAktiboa Bai Bidalketaren katalogo-paketearen fitxategia non eskuratu azaltzen du.

Eskaintzaren xehetasunak

Erabili datu hauek CatalogItemDefinitionoffer propietatea zehazteko.

Propietate horiek katalogoko elementuaren bidalketaren xehetasunak definitzen dituzte.

Propietateak Mota Beharrezkoa Deskribapena
businessCategories int[aldatu | aldatu iturburu kodea] No Helburuko katalogoak errespetatzen dituen aukera-aukeren balioen zerrenda. Katalogoko elementu honekin lotu beharreko negozio-kategoriak identifikatzen ditu. Ikus Negozio-kategoriak erabili beharreko balio baliozkoak ikusteko.
type kate Bai Katalogoko elementu mota. Baliozko balioak:
- Application
- Component_Collection
supportsApplicationTypes katea[] No Onartutako aplikazio moten zerrenda. Baliozko balioak:
- CanvasApps
- ModelApps
- PowerPortals
- PowerAutomate
deploymentType kate Bai Katalogoko elementu hau hedatzeko hedapen mota adierazten du. Baliozko balioak:
- Normal Kudeatutako elementu bat adierazten du.
- Template Kudeatu gabeko irtenbidearen kopia, beste sortzaile batzuek nahi duten moduan edita dezaketena.
Informazio gehiago katalogoko elementu motei buruz
searchKeywords katea[] No Katalogoko elementu hau aurkitzeko erabil ditzaketen hitzak.
small48x48Image KatalogoaFitxategiaAktiboa No Galeria ikuspegirako irudia. Irudi hau ematen ez baduzu, sistemaren ikono lehenetsia erabiliko da.
large216x216Image KatalogoaFitxategiaAktiboa No Xehetasunen ikuspegirako irudia. Eman ikono bat sortzailean edo beste aurkikuntza interfazean bistaratzeko. Erabiltzaile esperientzia batzuek ikono handiagoak erabiltzen dituzte aurkikuntzarako txartelak errendatzeko.
useCaseDocument KatalogoaFitxategiaAktiboa No Erabili kasuaren deskribapena eta azalpena onartzaileentzat.
videos CatalogFileAsset[] No Xehetasunen ikuspegiak bideo/gif fitxategi horietarako estekak bistaratzen ditu.
documents CatalogFileAsset[] No Xehetasun-ikuspegiak fitxategi horietarako estekak bistaratzen ditu.
screenshots CatalogFileAsset[] No Xehetasun-ikuspegiak irudi hauek bistaratzen ditu. Zure aplikazioaren pantaila-argazkiak pasa ditzakezu hemen aplikazio honek bilatzen ari diren funtzionalitatea edo gaitasuna eskaintzen duen ala ez identifikatzen laguntzeko. Jendeak aplikazio edo txantiloi bat deskargatu aurretik egiten duen gauzarik ohikoena bere irudiak eta pantaila-argazkiak begiratzea da, gaitasunak ulertzeko, deskribapena irakurri beharrean.
helpLink URIa No Dokumentaziorako esteka. URL hauek barneko dokumentuetarako edo sharepoint baliabideetarako estekak izan daitezke.
privacyPolicyLink URIa No Pribatutasun dokumentuaren esteka. Aurkezten ari den osagaiaren edo aplikazioaren erabilera zainduari buruzko politikak.
legalTermsLink URIa No Baldintza eta baldintzen dokumentuaren esteka. Katalogoko elementuaren kontsumitzailea ebaluatzeko legezko baldintzak edo barne-jarraibideak.
legalTerms kate No Baldintza eta baldintzen dokumentuaren markdown, HTML edo testu-bertsioa. Katalogoko elementuaren kontsumitzailea ebaluatzeko legezko baldintzak edo barne-jarraibideak.
sourceCodeRepositoryLink URIa No Iturburu-kodearen biltegira esteka
engineeringName PertsonaKontaktu-informazioa Bai Katalogoko elementu hau garatu duen ingeniariaren edo taldearen harremanetarako informazioa.
supportName PertsonaKontaktu-informazioa No Katalogoko elementu hau onartzen duen laguntzaren edo taldearen harremanetarako informazioa. Katalogoko elementu baten kontsumitzaileak aplikazioarekin arazoak izanez gero harremanetan jar daitekeen ingeniaritza kontaktua bezalakoa izan daiteke.

Negozio-kategoriak

Ezarri OfferDetailsbusinessCategories propietatea negozio-kategoria hauetako batean edo gehiagotan:

Kodea Deskribapena
526430000 Bezeroarentza zerbitzua
526430001 Proiektuen kudeaketa
526430002 Egutegiaren kudeaketa eta planifikazioa
526430003 Mezu-kudeaketa
526430004 Fitxategiak eta dokumentazioa
526430005 Jakinarazpenak eta oroigarriak
526430006 Estatistikak
526430007 Elkarlana
526430008 Commerce
526430009 Finantza
526430010 Betetzea eta legea
526430011 Sales
526430012 IT tresnak
526430013 Marketing
526430014 Eragiketak eta hornikuntza katea
526430015 Gauzen Internet
526430016 AI Machine Learning
526430017 Geokokapena
526430018 Giza baliabideak

Gaur egun, negozio-kategoria berriak ezin dira konfiguratu, baina Katalogoko negozio-kategoria (mspcat_catalogbusinesscategory) aukera globaletik berreskuratu daitezke.

KatalogoaFitxategiaAktiboa

Propietate hauek CatalogItemDefinitionpackageFile eta OfferDetailssmall48x48Image, large216x216Image, useCaseDocument, videos, documentseta screenshots propietateetan erreferentzia duten fitxategi bat definitzen dute.

Propietateak Mota Beharrezkoa Deskribapena
name kate Bai Fitxategiaren izena.
filesaslink URIa Bai Fitxategia deskargatzeko esteka. Estekak autentifikazioa eskatzen badu, eman sarbide partekatuaren sinadura (SAS) URLa.

PertsonaKontaktu-informazioa

Propietate hauek katalogoko elementuaren OfferDetailsengineeringName eta supportName propietateak definitzen dituzte.

Propietateak Mota Beharrezkoa Deskribapena
firstName kate No Pertsonaren izen-abizenak.
lastName kate Bai Pertsonaren abizenak.
email kate Bai Pertsonaren helbide elektronikoa.
phoneNumber kate No Pertsonaren telefono zenbakia.
  • Last updated on