Partage via

Utiliser le catalogue avec Power Platform CLI

  • Article

Le catalogue dans Power Platform permet aux développeurs et aux créateurs de :

  • Faites du crowdsourcing et trouvez facilement des modèles et des composants au sein de leur environnement.
  • Trouver et installer la version de référence la plus récente d’un composant.
  • Démarrez avec des modèles et des composants qui apportent une valeur immédiate.

Avant de pouvoir utiliser les éléments du catalogue, vous devez l’installer et le configurer. Plus d’informations : Administrer le catalogue

Les créateurs et les développeurs d’applications peuvent soumettre des élément au catalogue, afin qu’ils puissent aider leurs collègues à résoudre les problèmes de l’entreprise.

Important

Environnements gérés sont nécessaires pour soumettre des articles au catalogue. Cependant, vous pouvez installer des éléments à partir de n’importe quel environnement. En savoir plus sur Environnements gérés

Démarrage

  1. Installer Power Platform CLI
  2. Accédez au catalogue en tant que soumissionnaire ou Lecteur

Installer Power Platform CLI

Effectuez la procédure d'installation de Power Platform CLI : Installer Microsoft Power Platform CLI

Obtenir un accès au catalogue en tant qu’expéditeur ou que lecteur

Contactez votre administrateur pour accorder l’accès au catalogue. Le rôle de sécurité Expéditeur de catalogues doit être associé à votre compte d’utilisateur ou à une équipe à laquelle vous appartenez. Informations complémentaires : Modifier un accès utilisateur

Utiliser le catalogue

Après avoir installé Power Platform CLI, vous devez créer un profil d’authentification en utilisant la commande pac auth create. En utilisant le profil d’authentification de l’environnement où le catalogue est installé, vous pouvez effectuer les tâches suivantes avec PAC CLI :

  1. Consultez les catalogues disponibles dans votre locataire
  2. Voir les articles du catalogue
  3. Installer des éléments du catalogue
  4. Soumettre des articles au catalogue
  5. Vérifier l’état des soumissions du catalogue

Afficher les catalogues disponibles dans votre locataire

Utilisez la commande pac admin list pour afficher les catalogues disponibles dans votre locataire.

Note

Cette commande nécessite un profil d’authentification Administrateur.

Lorsque vous utilisez cette commande, vous devez utiliser le paramètre suivant --application avec la valeur 83a35943-cb41-4266-b7d2-81d60f383695.

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

83a35943-cb41-4266-b7d2-81d60f383695 est l’ID d’application associé au catalogue.

Afficher les éléments du catalogue

Utilisez la commande pac catalog list pour afficher les éléments du catalogue.

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

Installer des éléments à partir du catalogue

Utilisez la commande pac catalog install pour installer des éléments à partir du catalogue.

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

Soumettre des éléments au catalogue

Pour soumettre un élément au catalogue, les éléments suivants sont nécessaires :

  • Un package de solutions ou Package Deployer contenant l’élément que vous souhaitez soumettre
  • Un document JSON des métadonnées d’envoi

Utilisez la commande pac catalog create-submission pour obtenir un exemple de document JSON des métadonnées d’envoi. Vous devez modifier ce document et d’autres attributs d’envoi peuvent être ajoutés. Pour plus d’informations : Attributs d’envois

Une fois que votre document JSON des métadonnées d’envoi est prêt, utilisez la commande pac catalog submit pour le soumettre.

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

Vérifier le statut des envois de catalogues

Utilisez la commande pac catalog status pour vérifier le statut des envois de catalogues.

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

Attributs d’envois

Avant de pouvoir soumettre des éléments à un catalogue, vous devez préparer un document JSON qui décrit les éléments que vous souhaitez soumettre. Pour plus d’informations : Soumettre des éléments au catalogue

Pour vous aider, la commande pac catalog create-submission génère un exemple de fichier submission.json.

Note

D’autres attributs sont pris en charge dans le fichier d’envoi et ceux-ci sont traités dans la section suivante.

Vous devez modifier ce fichier pour soumettre un élément. Voici un exemple d’envoi créé à partir du JSON ci-dessus.

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

Données obligatoires

Les éléments suivants sont requis pour tous les envois :

Serveur de publication

Crée un enregistrement d’éditeur qui peut être associé à un ou plusieurs groupes Microsoft Entra ID contenant des utilisateurs autorisés qui peuvent apporter des mises à jour à l’élément du catalogue ultérieurement.

Ne confondez pas ce terme avec l’éditeur de solutions. L’éditeur d’éléments de catalogue n’est pas utilisé avec les solutions.

Vous devez fournir l’ID d’éditeur DisplayName au minimum. L’ID peut être n’importe quelle valeur de chaîne. Le système vérifie si cet éditeur existe, sinon le crée et lui attribue un identifiant.

Par exemple, l’équipe de développeurs informatiques RH peut créer un éditeur et identifier les développeurs à l’aide d’un Microsoft Entra ID Groupe.

Voici un exemple de enregistrement publié :

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

Article de catalogue

Solution Power Platform actuelle. Un package est ce qui est stocké dans le catalogue.

id et displayName sont obligatoires. description et businessCategories sont facultatifs.

La liste de valeur des catégories métier prédéfinies se trouve dans l’annexe. ComponentUsedInApplication est destiné à une utilisation future uniquement.

Voici un exemple d’élément du catalogue incluant ses contacts engineeringName et supportName qui sont obligatoires.

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

Contact technique

Contact du développeur de produit.

Contact que le consommateur de l’élément du catalogue peut contacter s’il a des questions techniques pour étendre ou réutiliser l’application à d’autres fins.

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

Exemple

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

Contact du support

Spécialiste du support informatique.

Peut être identique au contact technique que le consommateur d’un élément de catalogue peut contacter s’il rencontre des problèmes avec l’application.

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

Les éléments suivants sont fortement recommandés, mais pas obligatoires.

small48x48image

Fournissez des informations sur l’icône à afficher dans Créateur ou une autre interface utilisateur de découverte. Si vous ne fournissez pas cette image, une icône par défaut du système est utilisée.

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

Documents

Vous pouvez transmettre ici des captures d’écran de votre application pour aider les créateurs à identifier si cette application fournit la fonctionnalité ou la capacité qu’ils recherchent.

La chose la plus courante que font les gens avant de télécharger une application ou un modèle est de regarder ses images et ses captures d’écran pour comprendre les fonctionnalités au lieu de lire la description.

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

Lien de l’URL vers la documentation d’aide.

URL complètes auxquelles vos utilisateurs peuvent accéder. Ces URL peuvent être des liens vers des documents internes ou des ressources SharePoint.

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

Les éléments suivants sont facultatifs

Portail source

Source d’envoi.

Lors de la soumission à partir de Power Platform CLI, utilisez 526430005 comme valeur du portail source. Pour les autres sources, utilisez 526430000.

Catégories métier

Une ou plusieurs des catégories métier peuvent être incluses dans l’envoi à partir de la liste ci-dessous.

Code Description
526430000 Customer Service
526430001 Gestion du projet
526430002 Planification et gestion du calendrier
526430003 Gestion du courrier électronique
526430004 Fichiers et documentation
526430005 Notification et rappels
526430006 Analyses
526430007 Collaboration
526430008 Commerce
526430009 Finance
526430010 Conformité et informations légales
526430011 Vente
526430012 Outils informatiques
526430013 Marketing
526430014 Opérations et chaîne d’approvisionnement
526430015 Internet des objets
526430016 Machine Learning d’IA
526430017 Géolocalisation
526430018 Ressources humaines

Actuellement, de nouvelles catégories métier ne peuvent pas être configurées.

Operation

Valeurs possibles :

  • CreateOrUpdate
  • Create
  • Update
  • Disabled

Utilisez CreateOrUpdate pour les nouveaux envois.

  "operation": "CreateOrUpdate"

Justification métier

Explique la valeur commerciale créée par cet élément du catalogue. Ces informations sont visibles par les approbateurs et apparaissent dans l’expérience de consommation planifiée dans l’expérience utilisateur détection créateur.

Les utilisateurs peuvent dire, par exemple, que leur envoi contribue à la réduction des coûts ou à la productivité. Certaines organisations exigent certaines classes de valeur et ces valeurs peuvent être saisies ici.

La chaîne peut contenir du texte HTML ou enrichi (RTF).

"businessJustification": "Submit your travel expenses!"

large216x216Image

Fournissez des informations sur l’icône à afficher dans le créateur ou une autre interface utilisateur de découverte.

Certaines expériences utilisateur utilisent des icônes plus grandes pour afficher les cartes pour la découverte.

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

Exemple des métadonnées l’image.

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

Politique de confidentialité

Lien de l’URL vers les politiques pertinentes.

Politiques concernant l’utilisation prudente du composant ou de l’application soumis.

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

Lien de l’URL vers les conditions générales pertinentes.

Tous termes juridiques ou directives internes pour l’évaluation du consommateur de l’article du catalogue.

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

Voir aussi

Administrer le catalogue