pac package

Comandos para traballar con proxectos de paquetes Dataverse.

Comandos

Comando	Descrición
pac package add-external-package	Engade un paquete externo ao sistema de solucións de Dataverse a un proxecto de paquete Package Deployer.
pac package add-reference	Engade referencia ao proxecto de solución de Dataverse
pac package add-solution	Engade un ficheiro de solución de Dataverse preconstruído a un proxecto de paquete Package Deployer.
pac package compile	(Vista previa) Compila un paquete. Co erp do tipo --package, compila modelos X++ usando xppc.exe do SDK instalado e produce un ZIP despregable por modelo.
pac package db-sync	(Vista previa) Sincroniza a base de datos de aplicacións de Finanzas e Operacións con Dataverse.
pac package deploy	Envía o paquete a Dataverse
pac package init	Inicializa un cartafol cun novo proxecto de paquete de Dataverse
pac package show	Mostra os detalles do paquete de Dataverse

pac package add-external-package

Engade un paquete externo ao sistema de solucións de Dataverse a un proxecto de paquete Package Deployer.

Parámetros requiridos para package add-external-package

--package-type -t

O tipo de paquete que se engade. Por exemplo: 'xpp' para paquetes FnO.

--path -p

Camiño ao paquete externo

Parámetros opcionais para package add-external-package

--import-order

Número enteiro que indica a orde para inserir este elemento no ficheiro ImportConfig.xml final no momento da compilación. Os números negativos insírense antes dos elementos existentes. Os números positivos engádense despois dos elementos existentes.

--skip-validation -sv

Engade o elemento ao ficheiro do proxecto aínda que o ficheiro non exista ou pareza non ser válido. Nota: O uso desta opción non afecta a ningunha validación realizada por MSBuild.

Este parámetro non precisa de valor. É un cambio.

pac package add-reference

Engade referencia ao proxecto de solución de Dataverse

Exemplo

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

Parámetros requiridos para package add-reference

--path -p

A ruta cara ao proxecto de solución de Dataverse referenciado

Parámetros opcionais para package add-reference

--dependency-overrides

Unha lista de overrides delimitada por punto e virgula. Este valor supera calquera información de dependencia codificada nos metadatos da solución. Cada rexeitamento debe estar no formato: <uniquename>:<minVersion>:<maxVersion>. Onde minVersion e maxVersion son opcionais, pero deberían estar na sintaxe do formato de versión de .NET.

Nota: Use unha lista delimitada por punto e virgula de substitucións de dependencias do formato <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Especifica explicitamente o modo necesario ao importar esta solución.

Utiliza un destes valores:

• sync
• async

--import-order

Número enteiro que indica a orde para inserir este elemento no ficheiro ImportConfig.xml final no momento da compilación. Os números negativos insírense antes dos elementos existentes. Os números positivos engádense despois dos elementos existentes.

--missing-dependency-behavior

Especifica o comportamento na importación cando falta unha dependencia desta solución no entorno de destino.

Utiliza un destes valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explicitamente se se deben sobrescribir as personalizacións non xestionadas cando se importe esta solución.

Utiliza un destes valores:

• true
• false

--publish-workflows-activate-plugins

Indica explicitamente se se deben publicar os fluxos de traballo e activar os complementos cando se importe esta solución.

Utiliza un destes valores:

• true
• false

pac package add-solution

Engade un ficheiro de solución de Dataverse preconstruído a un proxecto de paquete Package Deployer.

Parámetros requiridos para package add-solution

--path -p

Ruta ao ficheiro da solución de Dataverse. O ficheiro debe ser un ficheiro ZIP comprimido.

Parámetros opcionais para package add-solution

--dependency-overrides

Unha lista de overrides delimitada por punto e virgula. Este valor supera calquera información de dependencia codificada nos metadatos da solución. Cada rexeitamento debe estar no formato: <uniquename>:<minVersion>:<maxVersion>. Onde minVersion e maxVersion son opcionais, pero deberían estar na sintaxe do formato de versión de .NET.

Nota: Use unha lista delimitada por punto e virgula de substitucións de dependencias do formato <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Especifica explicitamente o modo necesario ao importar esta solución.

Utiliza un destes valores:

• sync
• async

--import-order

Número enteiro que indica a orde para inserir este elemento no ficheiro ImportConfig.xml final no momento da compilación. Os números negativos insírense antes dos elementos existentes. Os números positivos engádense despois dos elementos existentes.

--missing-dependency-behavior

Especifica o comportamento na importación cando falta unha dependencia desta solución no entorno de destino.

Utiliza un destes valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explicitamente se se deben sobrescribir as personalizacións non xestionadas cando se importe esta solución.

Utiliza un destes valores:

• true
• false

--publish-workflows-activate-plugins

Indica explicitamente se se deben publicar os fluxos de traballo e activar os complementos cando se importe esta solución.

Utiliza un destes valores:

• true
• false

--skip-validation -sv

Engade o elemento ao ficheiro do proxecto aínda que o ficheiro non exista ou pareza non ser válido. Nota: O uso desta opción non afecta a ningunha validación realizada por MSBuild.

Este parámetro non precisa de valor. É un cambio.

pac package compile

(Vista previa) Compila un paquete. Co erp do tipo --package, compila modelos X++ usando xppc.exe do SDK instalado e produce un ZIP despregable por modelo.

Parámetros requiridos para package compile

--package-type -pt

Plataforma obxectivo para despregamento. Valores permitidos: dataverse, erp (Vista previa). Por defecto: dataverse.

Parámetros opcionais para package compile

--app-version -av

Versión de aplicación F&O en catro partes do SDK para compilar (por exemplo, 10.0.2588.0). Cando se omite, úsase o SDK rexistrado para o ambiente activo.

--incremental

Compilar só cambiaba os artefactos (pasa -incremental a xppc).

Este parámetro non precisa de valor. É un cambio.

--language -lang

Lista separada por comas de lugares para compilar etiquetas (por exemplo, en-US ou en-US,fr,de). Cando se omite, LabelC constrúe todas as localizacións atopadas na fonte — coincidindo co comportamento predeterminado dos Modelos de Compilación de Visual Studio. Só afecta á etapa de etiquetas; xppc + boas prácticas + paquete executa unha vez sobre a saída combinada.

--license-file -lf

Ruta cara a un ficheiro de licenza ISV para inxectar en cada ZIP de modelo producido. Escrito en <Model>/bin/<nome> de arquivo dentro do ZIP.

--model -m

Nome(s) modelo(s) para compilar. Acepta un nome único ou unha lista separada por comas. Cando se omiten, compilan todos os modelos listados en .erp/xpp.json.

--output

Directorio onde se escribirán os ZIPs despregables. Por defecto: <repoRoot>/bin.

--outputDirectory -o

Cartafol de saída

--skip-bp

Salta o paso de comprobación das boas prácticas. Por defecto, o pipeline de compilación executa etiquetas -> X++ -> boas prácticas.

Este parámetro non precisa de valor. É un cambio.

--solution-root -sr

Carpeta raíz da solución X++ (contén .erp/xpp.json). Por defecto está no directorio actual.

pac package db-sync

(Vista previa) Sincroniza a base de datos de aplicacións de Finanzas e Operacións con Dataverse.

Parámetros opcionais para package db-sync

--argument-file -af

(Vista previa) Ruta cara a un ficheiro JSON que coincide co contrato IncrementalSyncParameters (ou ModuleSyncParameters). Requirido para --db-sync Incremental.

--db-sync -ds

Modo de sincronización da base de datos. Valores permitidos: Completo, Módulo, Incremental. Predeterminado: Cheo.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--modules -m

(Vista previa) Lista separada por comas de nomes de módulos para sincronizar. Requírese cando --db-sync é Module.

pac package deploy

Envía o paquete a Dataverse

Nota

Este comando só está dispoñible para a versión .NET Full Framework da CLI de PAC.

Exemplo

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

Parámetros opcionais para package deploy

--argument-file -af

(Vista previa) Ruta cara a un ficheiro JSON que coincide co contrato IncrementalSyncParameters (ou ModuleSyncParameters). Requirido para --db-sync Incremental.

--build-type -bt

(Avance) Como se aplica o paquete. Valores permitidos: Full, Incremental, Delete. Predeterminado: Cheo. Usado con --package-type erp.

--db-sync -ds

(Vista previa) Modo de sincronización da base de datos para executar despois do despregamento. Valores permitidos: Ningún, Completo, Módulo, Incremental. Por defecto: Ningunha. Usado con --package-type erp.

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--logConsole -c

Saída do rexistro á consola

Este parámetro non precisa de valor. É un cambio.

--logFile -lf

Rota do ficheiro de rexistro

--modules -m

(Vista previa) Lista separada por comas de nomes de módulos para sincronizar. Requírese cando --db-sync é Module.

--outputDirectory -o

(Vista prèvia) Só modo solución: carpeta raíz que contén .erp/xpp.json. Por defecto está no directorio actual. Cando --package se omite baixo --package-type erp, todos os modelos listados en .erp/xpp.json despréganse en orde de dependencia.

--package -p

Ruta a un ficheiro dll ou zip dun paquete cun paquete.

--package-type -pt

Plataforma obxectivo para despregamento. Valores permitidos: dataverse, erp (Vista previa). Por defecto: dataverse.

--release-type -rt

(Avance) Clasificación do paquete. Valores permitidos: Dev, Release. Por defecto: Dev. Os paquetes de liberación forzan unha sincronización completa da base de datos no servidor. Usado con --package-type erp.

--settings -s

Configuración do paquete en tempo de execución que se pasa ao paquete que se está a despregar. O formato da cadea debe ser key=value|key=value.

Nota: O formato da cadea debe ser key=value|key=value.

--solution -sz

Ruta ao ficheiro da solución de Dataverse. O ficheiro debe ser un ficheiro ZIP ou CAB comprimido.

--solution-root -sr

(Vista prèvia) Só modo solución: carpeta raíz que contén .erp/xpp.json. Por defecto está no directorio actual. Cando --package se omite baixo --package-type erp, todos os modelos listados en .erp/xpp.json despréganse en orde de dependencia.

--verbose -vdbg

Emite rexistros detallados ás saídas do rexistro.

Este parámetro non precisa de valor. É un cambio.

Comentarios

Podes usar ambos logFile os parámetros xuntos logConsole ou usar un parámetro ou outro.

pac package init

Inicializa un cartafol cun novo proxecto de paquete de Dataverse

Exemplo

pac package init --outputdirectory c:\samplepackage

Parámetros opcionais para package init

--layer -l

(Vista previa) Capa X++. Valores permitidos: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Por defecto: ISV.

--model -m

(Vista prèvia) Nome(s) do(s) modelo(s) X++ para andamio. Acepta un nome único ou unha lista separada por comas (por exemplo, ModelA, ModelB). Requírese cando o tipo de paquete é erp.

--outputDirectory -o

Cartafol de saída

--package-name

Establece o nome predeterminado do paquete. Aplícase á xeración de ImportExtension.GetNameOfImport.

--package-type -pt

Tipo de proxecto de paquete a andamio. Valores permitidos: dataverse, erp (Vista previa). Por defecto: dataverse.

--publisher -pub

(Avance) Nome do Publisher escrito no descriptor modelo. Por defecto: Microsoft.

--source-root -sr

(Vista previa) Ruta raíz de orixe (relativa ao directorio de saída) onde estarán os modelos. Por defecto: ./src.

pac package show

Mostra os detalles do paquete de Dataverse

Nota

Este comando só está dispoñible para a versión .NET Full Framework da CLI de PAC.

Exemplo

pac package show c:\samplepackage.dll

Parámetros requiridos para package show

--package -p

Ruta a un ficheiro dll ou zip dun paquete cun paquete.

Parámetros opcionais para package show

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--logFile -lf

Rota do ficheiro de rexistro

--verbose -vdbg

Emite rexistros detallados ás saídas do rexistro.

Este parámetro non precisa de valor. É un cambio.

Véxase tamén

Grupos de comandos da CLI de Microsoft Power Platform
Visión xeral da CLI de Microsoft Power Platform