pac package

Commandes permettant d’utiliser des projets de package Dataverse.

Commandes

Command	Description
pac package add-external-package	Ajoute un package externe au système de solution Dataverse à un projet de package Package Deployer.
pac package add-reference	Ajoute une référence au projet de solution Dataverse
pac package add-solution	Ajoute un fichier de solution Dataverse prédéfini à un projet de package Package Deployer.
pac package compile	(Préversion) Compile un package. Avec --package-type erp, compile des modèles X++ à l’aide de xppc.exe à partir du KIT de développement logiciel (SDK) installé et produit un fichier ZIP déployable par modèle.
pac package db-sync	(Préversion) Synchronise la base de données d’application Finance and Operations avec Dataverse.
pac package deploy	Déploie le package dans Dataverse
pac package init	Initialise un répertoire avec un nouveau projet de package Dataverse
pac package show	Affiche les détails du package Dataverse

pac package add-external-package

Ajoute un package externe au système de solution Dataverse à un projet de package Package Deployer.

Paramètres requis pour package add-external-package

--package-type -t

Type de package ajouté. Par exemple : « xpp » pour les packages FnO.

--path -p

Chemin d’accès au package externe

Paramètres facultatifs pour package add-external-package

--import-order

Nombre entier qui indique l’ordre d’insertion de cet élément dans le fichier ImportConfig.xml final au moment de la build. Les nombres négatifs sont insérés avant les éléments existants. Les nombres positifs sont ajoutés après les éléments existants.

--skip-validation -sv

Ajoute l’élément au fichier du projet même si le fichier n’existe pas ou semble non valide. Remarque : l’utilisation de ce paramètre n’affecte aucune validation effectuée par MSBuild.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

pac package add-reference

Ajoute une référence au projet de solution Dataverse

Exemple

pac package add-reference --path c:\Users\Downloads\SampleSolution

Paramètres requis pour package add-reference

--path -p

Chemin d’accès au projet de solution Dataverse référencé

Paramètres facultatifs pour package add-reference

--dependency-overrides

Liste de remplacements délimitée par des points-virgules. Cette valeur remplace toutes les informations de dépendance encodées dans les métadonnées de la solution. Chaque remplacement doit être au format : <uniquename>:<minVersion>:<maxVersion>. Où minVersion et maxVersion sont facultatifs mais doivent être dans la syntaxe du format de version .NET.

Note :Utilisez une liste délimitée par des points-virgules de remplacements de dépendances du format < nom unique> :< Version min> :< maxVersion>.

--import-mode

Spécifie explicitement le mode requis lors de l’importation de cette solution.

Utilisez l’une de ces valeurs :

• sync
• async

--import-order

Nombre entier qui indique l’ordre d’insertion de cet élément dans le fichier ImportConfig.xml final au moment de la build. Les nombres négatifs sont insérés avant les éléments existants. Les nombres positifs sont ajoutés après les éléments existants.

--missing-dependency-behavior

Spécifie le comportement d’importation lorsqu’une dépendance de cette solution est manquante dans l’environnement cible.

Utilisez l’une de ces valeurs :

• skip
• fault

--overwrite-unmanaged-customizations

Indique explicitement si les personnalisations non gérées doivent être remplacées lors de l’importation de cette solution.

Utilisez l’une de ces valeurs :

• true
• false

--publish-workflows-activate-plugins

Indique explicitement s’il faut publier les workflows et activer les plug-ins lors de l’importation de cette solution.

Utilisez l’une de ces valeurs :

• true
• false

pac package add-solution

Ajoute un fichier de solution Dataverse prédéfini à un projet de package Package Deployer.

Paramètres requis pour package add-solution

--path -p

Chemin d’accès au fichier de solution Dataverse. Le fichier doit être un fichier ZIP compressé.

Paramètres facultatifs pour package add-solution

--dependency-overrides

Liste de remplacements délimitée par des points-virgules. Cette valeur remplace toutes les informations de dépendance encodées dans les métadonnées de la solution. Chaque remplacement doit être au format : <uniquename>:<minVersion>:<maxVersion>. Où minVersion et maxVersion sont facultatifs mais doivent être dans la syntaxe du format de version .NET.

Note :Utilisez une liste délimitée par des points-virgules de remplacements de dépendances du format < nom unique> :< Version min> :< maxVersion>.

--import-mode

Spécifie explicitement le mode requis lors de l’importation de cette solution.

Utilisez l’une de ces valeurs :

• sync
• async

--import-order

Nombre entier qui indique l’ordre d’insertion de cet élément dans le fichier ImportConfig.xml final au moment de la build. Les nombres négatifs sont insérés avant les éléments existants. Les nombres positifs sont ajoutés après les éléments existants.

--missing-dependency-behavior

Spécifie le comportement d’importation lorsqu’une dépendance de cette solution est manquante dans l’environnement cible.

Utilisez l’une de ces valeurs :

• skip
• fault

--overwrite-unmanaged-customizations

Indique explicitement si les personnalisations non gérées doivent être remplacées lors de l’importation de cette solution.

Utilisez l’une de ces valeurs :

• true
• false

--publish-workflows-activate-plugins

Indique explicitement s’il faut publier les workflows et activer les plug-ins lors de l’importation de cette solution.

Utilisez l’une de ces valeurs :

• true
• false

--skip-validation -sv

Ajoute l’élément au fichier du projet même si le fichier n’existe pas ou semble non valide. Remarque : l’utilisation de ce paramètre n’affecte aucune validation effectuée par MSBuild.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

pac package compile

(Préversion) Compile un package. Avec --package-type erp, compile des modèles X++ à l’aide de xppc.exe à partir du KIT de développement logiciel (SDK) installé et produit un fichier ZIP déployable par modèle.

Paramètres requis pour package compile

--package-type -pt

Plateforme cible pour le déploiement. Valeurs autorisées : dataverse, erp (préversion). Valeur par défaut : dataverse.

Paramètres facultatifs pour package compile

--app-version -av

Version de l’application F&O en quatre parties du Kit de développement logiciel (SDK) à compiler (par exemple, 10.0.2588.0). En cas d’omission, le Kit de développement logiciel (SDK) inscrit pour l’environnement actif est utilisé.

--incremental

Compilez uniquement les artefacts modifiés (passe -incremental à xppc).

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--language -lang

Liste séparée par des virgules des paramètres régionaux pour laquelle compiler des étiquettes (par exemple, en-US ou en-US,fr,de). En cas d'omission, LabelC génère tous les paramètres régionaux trouvés dans la source : correspond au comportement des modèles de build par défaut de Visual Studio. Affecte uniquement l’étape des étiquettes ; xppc + meilleures pratiques + package exécuté une fois sur la sortie combinée.

--license-file -lf

Chemin d’accès à un fichier de licence ISV pour injecter dans chaque fichier zip de modèle produit. Écrit dans <Model>/bin/<filename> à l’intérieur du fichier ZIP.

--model -m

Nom(s) du modèle à compiler. Accepte un nom unique ou une liste séparée par des virgules. En cas d’omission, tous les modèles répertoriés dans .erp/xpp.json sont compilés.

--output

Répertoire dans lequel les ADRESSES ZIP déployables seront écrites. Valeur par défaut : <repoRoot>/bin.

--outputDirectory -o

Répertoire de sortie

--skip-bp

Ignorez l’étape de vérification des meilleures pratiques. Par défaut, le pipeline de compilation exécute des étiquettes -> X++ -> meilleures pratiques.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--solution-root -sr

Dossier racine de la solution X++ (contient .erp/xpp.json). Par défaut, c’est le répertoire actuel.

pac package db-sync

(Préversion) Synchronise la base de données d’application Finance and Operations avec Dataverse.

Paramètres facultatifs pour package db-sync

--argument-file -af

(Préversion) Chemin d’accès à un fichier JSON correspondant au contrat IncrementalSyncParameters (ou ModuleSyncParameters). Obligatoire pour --db-sync Incrémentiel.

--db-sync -ds

Mode de synchronisation de base de données. Valeurs autorisées : Full, Module, Incremental. Valeur par défaut : Complète.

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--modules -m

(Préversion) Liste séparée par des virgules des noms de modules à synchroniser. Obligatoire lorsque --db-sync est Module.

pac package deploy

Déploie le package dans Dataverse

Note

Cette commande est uniquement disponible pour la version .NET Full Framework de l’interface de ligne de commande PAC.

Exemple

pac package deploy --logFile c:\samplelogdata --package c:\samplepackage

Paramètres facultatifs pour package deploy

--argument-file -af

(Préversion) Chemin d’accès à un fichier JSON correspondant au contrat IncrementalSyncParameters (ou ModuleSyncParameters). Obligatoire pour --db-sync Incrémentiel.

--build-type -bt

(Préversion) Comment le package est appliqué. Valeurs autorisées : Full, Incremental, Delete. Valeur par défaut : Complète. Utilisé avec --package-type erp.

--db-sync -ds

(Préversion) Mode de synchronisation de base de données à exécuter après le déploiement. Valeurs autorisées : None, Full, Module, Incremental. Valeur par défaut : None. Utilisé avec --package-type erp.

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--logConsole -c

Journal de sortie de la console

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

--logFile -lf

Chemin d’accès au fichier journal

--modules -m

(Préversion) Liste séparée par des virgules des noms de modules à synchroniser. Obligatoire lorsque --db-sync est Module.

--outputDirectory -o

(Préversion) Mode solution uniquement : dossier racine contenant .erp/xpp.json. Par défaut, c’est le répertoire actuel. Lorsque --package est omis sous --package-type erp, tous les modèles répertoriés dans .erp/xpp.json sont déployés dans l’ordre de dépendance.

--package -p

Chemin d’accès à un fichier dll ou zip avec un package.

--package-type -pt

Plateforme cible pour le déploiement. Valeurs autorisées : dataverse, erp (préversion). Valeur par défaut : dataverse.

--release-type -rt

(Préversion) Classification des packages. Valeurs autorisées : Dev, Release. Valeur par défaut : Dev. Les packages de mise en production forcent une synchronisation complète de base de données sur le serveur. Utilisé avec --package-type erp.

--settings -s

Paramètres de package d’exécution transmis au package en cours de déploiement. Le format de la chaîne doit être key=value|key=value.

Note : Le format de la chaîne doit être key=value|key=value.

--solution -sz

Chemin d’accès au fichier de solution Dataverse. Le fichier doit être un fichier ZIP ou CAB compressé.

--solution-root -sr

(Préversion) Mode solution uniquement : dossier racine contenant .erp/xpp.json. Par défaut, c’est le répertoire actuel. Lorsque --package est omis sous --package-type erp, tous les modèles répertoriés dans .erp/xpp.json sont déployés dans l’ordre de dépendance.

--verbose -vdbg

Émet des journaux détaillés pour les sorties de journal.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

Remarques

Vous pouvez utiliser les deux paramètres logFile et logConsole ensemble ou utilisez un paramètre ou un autre.

pac package init

Initialise un répertoire avec un nouveau projet de package Dataverse

Exemple

pac package init --outputdirectory c:\samplepackage

Paramètres facultatifs pour package init

--layer -l

(Préversion) Couche X++. Valeurs autorisées : USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Valeur par défaut : ISV.

--model -m

(Préversion) Nom(s) du ou des modèles X++ à générer automatiquement. Accepte un nom unique ou une liste séparée par des virgules (par exemple, ModelA,ModelB). Obligatoire lorsque --package-type est erp.

--outputDirectory -o

Répertoire de sortie

--package-name

Définit le nom du package par défaut. S’applique à la génération de ImportExtension.GetNameOfImport.

--package-type -pt

Type de projet de package à générer automatiquement. Valeurs autorisées : dataverse, erp (préversion). Valeur par défaut : dataverse.

--publisher -pub

(Préversion) Publisher nom écrit dans le descripteur de modèle. Par défaut : Microsoft.

--source-root -sr

(Préversion) Chemin d’accès racine source (par rapport au répertoire de sortie) où les modèles sont dynamiques. Valeur par défaut : ./src.

pac package show

Affiche les détails du package Dataverse

Note

Cette commande est uniquement disponible pour la version .NET Full Framework de l’interface de ligne de commande PAC.

Exemple

pac package show c:\samplepackage.dll

Paramètres requis pour package show

--package -p

Chemin d’accès à un fichier dll ou zip avec un package.

Paramètres facultatifs pour package show

--environment -env

Spécifie le Dataverse cible. La valeur peut être un GUID ou une URL https absolue. Lorsque la valeur n’est pas spécifiée, l’organisation active sélectionnée pour le profil d’authentification actuel sera utilisée.

--logFile -lf

Chemin d’accès au fichier journal

--verbose -vdbg

Émet des journaux détaillés pour les sorties de journal.

Ce paramètre ne requiert aucune valeur. C’est un commutateur.

Voir aussi

Groupes de commandes Microsoft Power Platform CLI
Microsoft Power PlatformVue d’ensemble d’un processus CLI