Katalogelemente anzeigen, übermitteln und installieren (Vorschau)

  • Artikel

[Dieser Artikel ist Teil der Dokumentation zur Vorschauversion und kann geändert werden.]

Bevor Sie mit Katalogelemente arbeiten können, müssen Sie sie installieren und konfigurieren. Weitere Informationen: Erste Schritte

Anwendungsentwickler und Entwickler können Artikel an den Katalog übermitteln, damit sie ihren Kollegen bei der Lösung geschäftlicher Probleme helfen können.

Starten Sie

  1. PAC-CLI installieren
  2. Zugriff auf den Katalog als Absender oder Leser erhalten

PAC-CLI installieren

Befolgen Sie die Schritte zur Installation der Power Platform CLI hier: Microsoft Power Platform CLI installieren

Verwenden Sie die Befehle pac catalog, um mit dem Katalog zu interagieren.

Zugriff auf den Katalog als Absender oder Leser erhalten

Wenden Sie sich an den Administrator, um Zugriff auf den Katalog zu erhalten. Sie müssen die Sicherheitsrolle Katalogabsender mit Ihrem Benutzerkonto oder einem Team verknüpfen, dem Sie angehören. Weitere Informationen: Benutzer einrichten.

Den Katalog verwenden

Nachdem Sie die PAC-CLI installiert haben, müssen Sie mit dem Befehl pac auth create ein Authentifizierungsprofil erstellen. Mithilfe des Authentifizierungsprofils für die Umgebung, in der der Katalog installiert ist, können Sie mit der PAC-CLI die folgenden Aufgaben ausführen:

  1. Verfügbare Kataloge in Ihrem Mandanten anzeigen
  2. Elemente im Katalog anzeigen
  3. Elemente aus dem Katalog installieren
  4. Elemente an den Katalog übermitteln
  5. Den Status der Katalogübermittlungen überprüfen

Verfügbare Kataloge in Ihrem Mandanten anzeigen

Verwenden Sie den Befehl pac admin list, um die in Ihrem Mandanten verfügbaren Kataloge anzuzeigen.

Anmerkung

Für diesen Befehl ist ein Administrator-Authentifizierungsprofil erforderlich.

Wenn Sie diesen Befehl verwenden, müssen Sie den folgenden Parameter --application mit dem Wert 83a35943-cb41-4266-b7d2-81d60f383695 verwenden.

pac admin list --application 83a35943-cb41-4266-b7d2-81d60f383695

83a35943-cb41-4266-b7d2-81d60f383695 ist die Anwendungs-ID, die dem Katalog zugeordnet ist. Die Anforderung, diesen Wert einzubeziehen, wird in einem zukünftigen Update entfernt.

Elemente im Katalog anzeigen

Verwenden Sie den Befehl pac catalog list, um Elemente im Katalog anzuzeigen.

pac catalog list 
Connected to... TestCatalog
Connected as user@domain
Listing all published catalog items from the current Dataverse Organization...
Catalog Item Name                   Publisher Name            Catalog Item Id                      Revision Id                          Version Status
Contoso Conference Custom Connector Catalog Conferences Team  ContosoConferencesCustomConnector    4e882dd6-74f3-ed11-8849-000d3a0a286b 1.0.0.1 Published
Contoso Themed Components           ContosoPublisher          ContosoThemedComponents              efbc469d-f1b2-ed11-83fd-000d3a0a2d9d 1.0.0.1 Published

Elemente aus dem Katalog installieren

Verwenden Sie den Befehl pac catalog install, um Elemente aus dem Katalog zu installieren.

pac catalog install -tu https://<your org>.crm.dynamics.com/ -cid ContosoConferencesCustomConnector
Connected to... TestCatalog
Connected as user@domain
ContosoConferencesCustomConnector
Tracking id for this installation is 202012ec-80f3-ed11-8849-000d3a0a2d9d

Elemente an den Katalog übermitteln

Zum Übermitteln eines Elements an den Katalog benötigen Sie Folgendes:

  • Ein Lösungs- oder Paketbereitstellungspaket, das das Element enthält, das Sie übermitteln möchten
  • Ein Metadaten-JSON-Dokument für die Übermittlung

Verwenden Sie den Befehl pac catalog create-submission, um ein Beispiel für ein JSON-Dokument mit Metadaten für die Übermittlung abzurufen. Sie müssen dieses Dokument bearbeiten und weitere Übermittlungsattribute können hinzugefügt werden. Weitere Informationen Übermittlungsattribute

Nachdem Ihr JSON-Dokument mit den Übermittlungsmetadaten fertig ist, verwenden Sie zum Senden den Befehl pac catalog submit.

pac catalog submit -p "BuildDemoSubmission.json" -sz "ContosoConference_1_0_0_1_managed.zip"
Creating package for catalog submit request...
Connected to... TestCatalog
Connected as user@domain
Tracking id for this submission is 0e6b119d-80f3-ed11-8849-000d3a0a2d9d

Den Status der Katalogübermittlungen überprüfen

Verwenden Sie den Befehl pac catalogue status, um den Status der Katalogübermittlungen zu überprüfen.

pac catalog status --tracking-id 0e6b119d-80f3-ed11-8849-000d3a0a2d9d --type submit
Connected to... TestCatalog
Connected as user@domain
Status of the Submit request: Submitted

Übermittlungsattribute

Bevor Sie Elemente an einen Katalog übermitteln können, müssen Sie ein JSON-Dokument vorbereiten, das die Elemente beschreibt, die Sie übermitteln möchten. Weitere Informationen: Elemente an den Katalog übermitteln

Um Ihnen zu helfen, generiert der Befehl pac catalog create-submission eine Beispieldatei submission.json.

Anmerkung

In der Übermittlungsdatei werden weitere Attribute unterstützt, die im folgenden Abschnitt behandelt werden.

Sie müssen diese Datei bearbeiten, um ein Element zu übermitteln. Hier ist eine Beispielübermittlung, die aus dem obigen JSON erstellt wurde.

{
  "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@mouse.com",
        "phoneNumber": "555-111-1234"
      }
    }
  }
}

Erforderliche Daten

Folgende Elemente werden für alle Übermittlungen benötigt:

Verleger

Erstellt einen Herausgeberdatensatz, der einer oder mehreren Microsoft Entra ID-Gruppen mit autorisierten Benutzern zugeordnet werden kann, die künftig Aktualisierungen am Katalogelement vornehmen können.

Verwechseln Sie diesen Begriff nicht mit Lösungsherausgeber. Der Katalogelement-Herausgeber ist ein völlig anderes Konzept.

Sie müssen mindestens die Herausgeber-ID DisplayName angeben. ID kann ein beliebiger Zeichenfolgenwert sein Das System prüft, ob dieser Herausgeber existiert, erstellt ihn andernfalls und weist eine ID zu.

Beispiel: Das HR-IT-Entwicklerteam kann einen Herausgeber erstellen und die Entwickelnden mithilfe einer Microsoft Entra ID-Gruppe identifizieren.

Hier ist ein Beispiel eines Herausgeberdatensatzes:

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

Katalogartikel

Die eigentliche Power Platform-Lösung (das Paket ist das, was im Katalog gespeichert ist)

id und displayName sind Pflichtfelder. description und businessCategories sind optional.

Die Werteliste der ausgewählten Unternehmenskategorien befindet sich im Anhang. ComponentUsedInApplication dient nur zur späteren Verwendung.

Hier ist ein Beispiel für ein Katalogelement einschließlich seiner Kontakte engineeringName und supportName, die obligatorisch sind.

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

Technischer Kontakt

Entwickler Ihres Produkts - Kontakt

Kontakt, an den sich der Verbraucher eines Katalogelements wenden kann, wenn er technische Fragen zur Erweiterung oder Wiederverwendung der App für einen anderen Zweck hat.

"engineeringName": {
   "firstName": "String"
   "lastName": "String (required)"
   "email": "String (required)"
   "phoneNumber": "String"
}

Beispiel

   "engineeringName": {
      "firstName": "John",
      "lastName": "Roon",
      "email": "john@contoso.com",
      "phoneNumber": "999-111-1234"
   },

Supportkontakt

Spezialist für IT-Business-Support

Kann mit dem technischen Kontakt identisch sein, an den sich der Verbraucher des Katalogelements wenden kann, wenn er Probleme mit der besagten Anwendung hat

"supportName": {
   "firstName": "String"
   "lastName": "String (required)"
   "email": "String (required)"
   "phoneNumber": "String"
}

Folgende Elemente werden dringend empfohlen, sind aber nicht erforderlich.

small48x48image

Geben Sie Informationen zum Symbol an, das in Maker/Anderer Discovery UX angezeigt werden soll. Wenn Sie dieses Bild nicht bereitstellen, wird ein Systemstandardsymbol verwendet.

"small48x48image":{
   "name": "String",
   "fileSasLink": "Fully qualified publicly accessible url"
}

Dokumente

Sie können hier Screenshots Ihrer Anwendung weitergeben, um der Makers-ID zu helfen, wenn diese App die von ihnen gesuchten Funktionen oder Fähigkeiten bietet.

Bevor man eine App oder Vorlage herunterlädt, schaut man sich am häufigsten die Bilder und Screenshots an, um die Leistungsfähigkeit im Vergleich zum Lesen der Beschreibung einzuschätzen.

{
   "name": "String",
   "fileSasLink": "Fully qualified publicly accessible url"
}

URL-Link zur Hilfedokumentation

Vollqualifizierte URLs, auf die Ihre Benutzer zugreifen können Diese URLs können Links zu internen Dokumenten oder Sharepoint-Ressourcen sein.

 "helpLink": "https://www.yourcompany.com"

Die folgenden Elemente sind optional.

Quellportal

Quelle der Übermittlung

Wenn Sie über die PAC-CLI senden, verwenden Sie 526430005 als Quellportalwert. Verwenden Sie für andere Quellen 526430000.

Geschäftskategorien

Eine oder mehrere der Unternehmenskategorien können in die Übermittlung aus der folgenden Liste aufgenommen werden.

Code Beschreibung
526430000 Customer Service
526430001 Projektmanagement
526430002 Kalenderverwaltung und -planung
526430003 E-Mail-Verwaltung
526430004 Dateien und Dokumentation
526430005 Benachrichtigungen und Erinnerungen
526430006 Analysen
526430007 Zusammenarbeit
526430008 Commerce
526430009 Finanzen
526430010 Konformität und Rechtliches
526430011 Vertrieb
526430012 IT-Tools
526430013 Marketing
526430014 Betriebsabläufe und Lieferkette
526430015 Das Internet der Dinge
526430016 KI/Maschinelles Lernen
526430017 Geolocation
526430018 Human Resources

Derzeit können keine neuen Unternehmenskategorien konfiguriert werden. Für die Zukunft ist Unterstützung für die Konfiguration weiterer Kategorien geplant.

Operation

Mögliche Werte:

  • CreateOrUpdate
  • Create
  • Update
  • Disabled

Verwenden Sie CreateOrUpdate für neue Übermittlungen.

  "operation": "CreateOrUpdate"

Geschäftliche Begründung

Erläutert den Geschäftswert, der durch dieses Katalogelement geschaffen wird Diese Informationen sind für Genehmiger sichtbar und erscheinen in der geplanten Verbrauchserfahrung in der Maker Discovery-Benutzererfahrung.

Benutzer können beispielsweise sagen, dass ihre Übermittlung zur Kostensenkung oder Produktivität beiträgt. Einige Organisationen verlangen bestimmte Werteklassen und diese Werte können hier eingegeben werden.

Die Zeichenfolge kann HTML oder Rich Text (RTF) enthalten.

"businessJustification": "Submit your travel expenses!"

large216x216Image

Geben Sie Informationen zum Symbol an, das in Maker/Other Discovery UX angezeigt werden soll.

Bei manchen Benutzeroberflächen werden größere Symbole zum Rendern von Karten zur Entdeckung verwendet.

name: String
fileSasLink: fully qualified publicly accessible url
LogicalName: string, for future use, ignored
recId: guid, for future use, ignored
attributeName: string, for future use, ignored

Hier sehen Sie ein Beispiel für die Metadaten des Bilds.

      "large216x216Image": {
        "name": "Large216image2",
        "fileSasLink": "https://mywebsite/largeicon.jpeg"
      },

Datenschutzrichtlinie

URL-Link zu relevanten Richtlinien

Richtlinien zur sorgfältigen Verwendung der übermittelten Komponente oder Anwendung

"privacyPolicyLink": "https://www.mycompany.com/privacy.html"

URL-Link zu den entsprechenden Bestimmungen

Alle rechtlichen Bestimmungen/internen Richtlinien zur Bewertung des Katalogelements durch den Verbraucher

"legalTerms": "https://www.mycompany.com/legalterms.html"

Siehe auch

Katalog in Power Platform (Vorschau)
Den Katalog verwalten (Vorschau)