Κοινοποίηση μέσω

Αναφορά εγγράφου υποβολής στοιχείων καταλόγου

Πρέπει να συμπεριλάβετε δεδομένα σε μορφή 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"
      }
  }
}

Αυτός ο πίνακας περιγράφει τις ιδιότητες για το έγγραφο υποβολής:

Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
modelVersion string Όχι Αριθμός έκδοσης του εγγράφου υποβολής. Η προεπιλογή είναι 1.0.0.0.
sourcePortal int Όχι Προσδιορίζει την προέλευση αυτής της αίτησης. 526430005 Η προεπιλογή είναι η CLI PAC. Για άλλες προελεύσεις, χρησιμοποιήστε 526430000. Η mspcat_GetPowerCatalogDetails συνάρτηση επιστρέφει την πλήρη λίστα. Η mspcat_GetPowerCatalogDetailsResponse.CatalogDetails.sourceOptions ιδιότητα παραθέτει τις διαθέσιμες επιλογές.
submissionId guid Όχι Guid για τον προσδιορισμό της υποβολής. Αυτή η τιμή είναι ένα εξωτερικό κλειδί που επιτρέπει τη σύνδεση της αίτησης με άλλα συστήματα.
operation string Ναι Για μελλοντική επέκταση και δεν τηρείται προς το παρόν. Ο τύπος της λειτουργίας που θα χρησιμοποιηθεί. Έγκυρες τιμές:
- CreateOrUpdate (Προεπιλογή)
- Create
- Update
- Disabled
businessJustification string Όχι Περιγράφει την επιχειρηματική αξία της υποβολής στον υπεύθυνο έγκρισης. Αυτή η τιμή μπορεί να περιέχει ΜΟΡΦΉ HTML ή μορφή εμπλουτισμένου κειμένου (RTF). Αυτές οι πληροφορίες εμφανίζονται στην προγραμματισμένη εμπειρία κατανάλωσης στην εμπειρία χρήστη εντοπισμού δημιουργού. Οι χρήστες μπορεί να πουν ότι η υποβολή τους βοηθά στη μείωση του κόστους ή την παραγωγικότητα, για παράδειγμα. Ορισμένοι οργανισμοί απαιτούν ορισμένες τιμής και αυτές οι τιμές μπορούν να καταχωρηθούν εδώ.
publisherDetails Εκδότης Ναι Ο εκδότης που σχετίζεται με αυτή την υποβολή στοιχείου.
catalogItemDefinition CatalogItemDefinition Ναι Καθορίζει το στοιχείο καταλόγου που υποβάλλεται.

Εκδότης

Χρησιμοποιήστε αυτά τα δεδομένα για να καθορίσετε την ιδιότητα στοιχείου publisherDetails υποβολής καταλόγου.

Δημιουργεί μια εγγραφή εκδότη που μπορεί να συσχετιστεί με μία ή περισσότερες ομάδες αναγνωριστικού Microsoft Entra που περιέχουν εξουσιοδοτημένους χρήστες που μπορούν να ενημερώνουν το στοιχείο καταλόγου στο μέλλον.

Σημείωμα

Μην συγχέετε αυτόν τον όρο με τον Εκδότη λύσεων. Ο εκδότης στοιχείων καταλόγου δεν χρησιμοποιείται με λύσεις.

Πρέπει να παρέχετε το publisherDisplayName ελάχιστο. publisherId Το μπορεί να είναι οποιαδήποτε τιμή συμβολοσειράς. Το σύστημα ελέγχει αν υπάρχει αυτός ο εκδότης, διαφορετικά τον δημιουργεί και αντιστοιχίζει ένα publisherId.

Για παράδειγμα, η ομάδα IT ανθρώπινου δυναμικού των προγραμματιστών μπορεί να δημιουργήσει έναν εκδότη και ένα αναγνωριστικό για τους προγραμματιστές, χρησιμοποιώντας μια ομάδα αναγνωριστικών Microsoft Entra.

Ακολουθεί ένα δείγμα μιας εγγραφής εκδότη που περιλαμβάνει λειτουργίες για την προσθήκη ενός ατόμου και μιας ομάδας αναγνωριστικών 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"
      }
   ]
}
Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
publisherId string Ναι Το μοναδικό αναγνωριστικό για αυτόν τον εκδότη. Χρησιμοποιήστε αυτό το αναγνωριστικό για να προσδιορίσετε αυτόν τον εκδότη κάθε φορά που δημιουργείτε ή ενημερώνετε ένα στοιχείο καταλόγου για αυτόν τον εκδότη. Τα Στοιχεία καταλόγου μπορούν να συσχετιστούν μόνο με έναν εκδότη κάθε φορά. Η τιμή μπορεί να είναι GUID ή συμβολοσειρά. Αφού οριστεί, πρέπει να διατηρηθεί.
publisherDisplayName string Ναι Οι καταναλωτές βλέπουν αυτά τα δεδομένα στη συλλογή καταλόγων.
publisherUpnList CatalogUPNOperation[] Όχι Άτομα που μπορούν να υποβάλουν νέα ή να ενημερώνουν στοιχεία καταλόγου ως αυτόν τον εκδότη. Περιλαμβάνει πάντα τον χρήστη που υποβάλλει την πρώτη φορά που δημιουργείται ο Εκδότης.
publisherAADGroupOIDS CatalogGroupOperation[] Όχι Ομάδες αναγνωριστικού Entra των οποίων τα μέλη επιτρέπεται να έχουν πρόσβαση σε αυτόν τον εκδότη.

CatalogUPNOperation

Χρησιμοποιήστε αυτά τα δεδομένα για να καθορίσετε την ιδιότητα Του ΕκδότηpublisherUpnList .

Ορίζει μια λειτουργία για την προσθήκη ή κατάργηση ατόμων που μπορούν να υποβάλλουν νέα ή να ενημερώνουν στοιχεία καταλόγου ως αυτόν τον εκδότη.

Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
action string Ναι Η ενέργεια που θα γίνει με αυτό το UPN. Έγκυρες τιμές: Add ή Remove.
upn string Ναι Το κύριο όνομα χρήστη (UPN) του χρήστη.
userOid guid Ναι Αναγνωριστικό αντικειμένου για τον χρήστη.

CatalogGroupOperation

Χρησιμοποιήστε αυτά τα δεδομένα για να καθορίσετε την ιδιότητα Του ΕκδότηpublisherAADGroupOIDS .

Ορίζει μια λειτουργία για την προσθήκη ή κατάργηση μιας ομάδας αναγνωριστικού Entra που μπορεί να έχει πρόσβαση σε αυτόν τον εκδότη.

Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
action string Ναι Η ενέργεια που θα γίνει με αυτό το UPN. Έγκυρες τιμές: Add ή Remove.
groupName string Ναι Το όνομα της ομάδας.
groupOid guid Ναι Αναγνωριστικό αντικειμένου για την ομάδα.
groupType string Ναι Ο τύπος ομάδας που αντιμετωπίζεται. Οι έγκυρες τιμές είναι Security και Modern.

CatalogItemDefinition

Χρησιμοποιήστε αυτά τα δεδομένα για να καθορίσετε την ιδιότητα στοιχείου catalogItemDefinition υποβολής καταλόγου.

Αυτές οι ιδιότητες ορίζουν το στοιχείο καταλόγου που υποβάλλεται. Αυτή είναι η πραγματική λύση Power Platform. Ένα πακέτο είναι αυτό που αποθηκεύεται στον κατάλογο.

Ακολουθεί ένα παράδειγμα ενός στοιχείου καταλόγου, συμπεριλαμβανομένων των επαφών του engineeringName και 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"
   }
   }
}
Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
id guid Ναι Το μοναδικό αναγνωριστικό του στοιχείου καταλόγου. Χρησιμοποιήστε αυτό το αναγνωριστικό κατά την ενημέρωση ή την εγκατάσταση του στοιχείου καταλόγου.
displayName string Ναι Το όνομα που εμφανίζεται στους καταναλωτές στις συλλογές καταλόγου.
description string Όχι Περιγραφή που εμφανίζεται στους καταναλωτές στις συλλογές καταλόγου.
offer OfferDetails Ναι Οι λεπτομέρειες της υποβολής στοιχείων καταλόγου.
packageFile CatalogFileAsset Ναι Περιγράφει πού μπορείτε να λάβετε το αρχείο πακέτου καταλόγου για την υποβολή.

OfferDetails

Χρησιμοποιήστε αυτά τα δεδομένα για να καθορίσετε την ιδιότητα CatalogItemDefinitionoffer .

Αυτές οι ιδιότητες ορίζουν τις λεπτομέρειες της υποβολής στοιχείου καταλόγου.

Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
businessCategories int[] Όχι Λίστα τιμών επιλογών επιλογής που τηρούνται από τον κατάλογο προορισμού. Προσδιορίζει τις επιχειρηματικές κατηγορίες για να συσχετίσετε με αυτό το στοιχείο καταλόγου. Ανατρέξτε στο θέμα Κατηγορίες επιχειρήσεων για τις έγκυρες τιμές που θα χρησιμοποιήσετε.
type string Ναι Τύπος στοιχείου καταλόγου. Έγκυρες τιμές:
- Application
- Component_Collection
supportsApplicationTypes string[] Όχι Λίστα με τους υποστηριζόμενους τύπους εφαρμογών. Έγκυρες τιμές:
- CanvasApps
- ModelApps
- PowerPortals
- PowerAutomate
deploymentType string Ναι Υποδεικνύει τον τύπο ανάπτυξης για την ανάπτυξη αυτού του στοιχείου καταλόγου. Έγκυρες τιμές:
- Normal Το αντιπροσωπεύει ένα διαχειριζόμενο στοιχείο.
- Template Ένα αντίγραφο της μη διαχειριζόμενης λύσης σας που μπορούν να επεξεργαστούν άλλοι δημιουργοί με όποιον και αν επιλέξουν.
Μάθετε περισσότερα σχετικά με τους τύπους στοιχείων καταλόγου
searchKeywords string[] Όχι Λέξεις που μπορεί να χρησιμοποιούν οι χρήστες για να βρουν αυτό το στοιχείο καταλόγου.
small48x48Image CatalogFileAsset Όχι Εικόνα για προβολή συλλογής. Εάν δεν παρέχετε αυτή την εικόνα, χρησιμοποιείται ένα προεπιλεγμένο εικονίδιο συστήματος.
large216x216Image CatalogFileAsset Όχι Εικόνα για προβολή λεπτομερειών. Καταχωρήστε ένα εικονίδιο που θα εμφανίζεται στον δημιουργό ή σε άλλο περιβάλλον εργασίας χρήστη εντοπισμού. Ορισμένες εμπειρίες χρήστη χρησιμοποιούν μεγαλύτερα εικονίδια για την απόδοση καρτών για εντοπισμό.
useCaseDocument CatalogFileAsset Όχι Χρησιμοποιήστε την περιγραφή της υπόθεσης και επεξήγηση για τους υπεύθυνους έγκρισης.
videos CatalogFileAsset[] Όχι Η προβολή λεπτομερειών εμφανίζει συνδέσεις σε αυτά τα αρχεία βίντεο/gif.
documents CatalogFileAsset[] Όχι Η προβολή λεπτομερειών εμφανίζει συνδέσεις σε αυτά τα αρχεία.
screenshots CatalogFileAsset[] Όχι Η προβολή λεπτομερειών εμφανίζει αυτές τις εικόνες. Μπορείτε να διαβιβάσετε στιγμιότυπα οθόνης εδώ της εφαρμογής σας για να βοηθήσετε τους δημιουργούς να προσδιορίσουν εάν αυτή η εφαρμογή παρέχει τη λειτουργικότητα ή τη δυνατότητα που αναζητούν. Το πιο συνηθισμένο πράγμα που κάνουν οι χρήστες πριν από τη λήψη μιας εφαρμογής ή ενός προτύπου είναι να δουν τις εικόνες και τα στιγμιότυπα οθόνης για να κατανοήσουν τις δυνατότητες αντί να διαβάσουν την περιγραφή.
helpLink uri Όχι Σύνδεση προς τεκμηρίωση. Αυτές οι διευθύνσεις URL μπορεί να είναι συνδέσεις σε εσωτερικά έγγραφα ή πόρους sharepoint.
privacyPolicyLink uri Όχι Σύνδεση προς έγγραφο προστασίας προσωπικών δεδομένων. Πολιτικές σχετικά με την προσεκτική χρήση του στοιχείου ή της εφαρμογής που υποβάλλεται.
legalTermsLink uri Όχι Σύνδεση με το έγγραφο Όρων και Προϋποθέσεων. Οποιοιδήποτε νομικοί όροι ή εσωτερικές οδηγίες για την αξιολόγηση του καταναλωτή του στοιχείου καταλόγου.
legalTerms string Όχι Markdown, HTML ή έκδοση κειμένου του εγγράφου "Όροι και προϋποθέσεις". Οποιοιδήποτε νομικοί όροι ή εσωτερικές οδηγίες για την αξιολόγηση του καταναλωτή του στοιχείου καταλόγου.
sourceCodeRepositoryLink uri Όχι Σύνδεση στο αποθετήριο πηγαίου κώδικα
engineeringName PersonContactInformation Ναι Στοιχεία επικοινωνίας για μηχανικό ή ομάδα που ανέπτυξαν αυτό το στοιχείο καταλόγου.
supportName PersonContactInformation Όχι Στοιχεία επικοινωνίας για υποστήριξη ή ομάδα που υποστηρίζει αυτό το στοιχείο καταλόγου. Μπορεί να είναι ίδια με την επαφή του μηχανικού που μπορεί να προσεγγίσει ο καταναλωτής ενός στοιχείου καταλόγου εάν αντιμετωπίσει προβλήματα με την εφαρμογή.

Κατηγορίες επιχειρήσεων

Ορίστε την ιδιότητα OfferDetailsbusinessCategories σε μία ή περισσότερες από αυτές τις επιχειρηματικές κατηγορίες:

Κωδικός Περιγραφή
526430000 Εξυπηρέτηση πελατών
526430001 Διαχείριση έργων
526430002 Διαχείριση ημερολογίου και προγραμματισμός
526430003 Διαχείριση ηλεκτρονικού ταχυδρομείου
526430004 Αρχεία και τεκμηρίωση
526430005 Ειδοποίηση και υπενθυμίσεις
526430006 Αναλύσεις
526430007 Συνεργασία
526430008 Εμπόριο
526430009 Χρηματοδοτώ
526430010 Συμμόρφωση και νομικές πληροφορίες
526430011 Πωλήσεις
526430012 Εργαλεία IT
526430013 Εμπορία
526430014 Λειτουργίες & αλυσίδα εφοδιασμού
526430015 Internet of Things
526430016 Εκμάθηση μηχανής AI
526430017 Γεωεντοπισμός
526430018 Ανθρώπινο δυναμικό

Προς το παρόν, δεν είναι δυνατή η ρύθμιση των παραμέτρων νέων επιχειρηματικών κατηγοριών, αλλά μπορούν να ανακτηθούν από την καθολική επιλογή Κατηγορία επιχείρησης (mspcat_catalogbusinesscategory).

CatalogFileAsset

Αυτές οι ιδιότητες ορίζουν ένα αρχείο που αναφέρεται στις ιδιότητες CatalogItemDefinitionpackageFile και OfferDetailssmall48x48Image, large216x216Image, useCaseDocument, videos, documentsκαι screenshots .

Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
name string Ναι Το όνομα του αρχείου.
filesaslink uri Ναι Σύνδεση για λήψη του αρχείου. Εάν η σύνδεση απαιτεί έλεγχο ταυτότητας, δώστε μια διεύθυνση URL υπογραφής κοινόχρηστης πρόσβασης (SAS).

PersonContactInformation

Αυτές οι ιδιότητες ορίζουν άτομα στο στοιχείο καταλόγου OfferDetailsengineeringName και supportName ιδιότητες.

Ιδιοκτησία Δακτυλογραφώ Απαραίτητο Περιγραφή
firstName string Όχι Όνομα ατόμου.
lastName string Ναι Όνομα οικογένειας ατόμου.
email string Ναι Διεύθυνση ηλεκτρονικού ταχυδρομείου ατόμου.
phoneNumber string Όχι Αριθμός τηλεφώνου ατόμου.
  • Last updated on