pac package

Comandos para trabajar con proyectos de paquete de Dataverse.

Comandos

Command	Description
pac package add-external-package	Agrega un paquete externo al sistema de solución de Dataverse a un proyecto de paquete de Package Deployer.
pac package add-reference	Agrega referencia al proyecto de solución de Dataverse
pac package add-solution	Agrega un archivo de solución de Dataverse precompilado a un proyecto de paquete de Package Deployer.
pac package compile	(Versión preliminar) Compila un paquete. Con --package-type erp, compila modelos X++ mediante xppc.exe desde el SDK instalado y genera un ZIP implementable por modelo.
pac package db-sync	(Versión preliminar) Sincroniza la base de datos de la aplicación Finance and Operations con Dataverse.
pac package deploy	Implementa el paquete en Dataverse
pac package init	Inicializa un directorio con un nuevo proyecto de paquete de Dataverse
pac package show	Muestra detalles del paquete de Dataverse

pac package add-external-package

Agrega un paquete externo al sistema de solución de Dataverse a un proyecto de paquete de Package Deployer.

Parámetros necesarios para package add-external-package

--package-type -t

El tipo de paquete que se agrega. Por ejemplo: 'xpp' para paquetes FnO.

--path -p

Ruta de acceso al paquete externo

Parámetros opcionales para package add-external-package

--import-order

Un número entero que indica el orden para insertar este elemento en el archivo ImportConfig.xml final en el momento de la compilación. Los números negativos se insertan antes de los elementos existentes. Los números positivos se agregan después de los elementos existentes.

--skip-validation -sv

Agrega el elemento al archivo de proyecto aunque el archivo no exista o parezca no válido. Nota: Usar esto no afecta ninguna validación realizada por MSBuild.

Este parámetro no requiere ningún valor. Es un modificador.

pac package add-reference

Agrega referencia al proyecto de solución de Dataverse

Ejemplo

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

Parámetros necesarios para package add-reference

--path -p

Ruta de acceso al proyecto de solución de Dataverse al que se hace referencia

Parámetros opcionales para package add-reference

--dependency-overrides

Una lista delimitada por punto y coma de anulaciones. Este valor anula cualquier información de dependencia codificada en los metadatos de la solución. Cada anulación debe tener el formato: <uniquename>:<minVersion>:<maxVersion>. Donde minVersion y maxVersion son opcionales pero deben estar en la sintaxis de formato de versión .NET.

Nota :Utilice una lista delimitada por punto y coma de anulaciones de dependencia del formato < nombre único> :< minVersión> :< Versión máxima>.

--import-mode

Especifica explícitamente el modo necesario al importar esta solución.

Utilice uno de estos valores:

• sync
• async

--import-order

Un número entero que indica el orden para insertar este elemento en el archivo ImportConfig.xml final en el momento de la compilación. Los números negativos se insertan antes de los elementos existentes. Los números positivos se agregan después de los elementos existentes.

--missing-dependency-behavior

Especifica el comportamiento de la importación cuando falta una dependencia de esta solución en el entorno de destino.

Utilice uno de estos valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explícitamente si se deben reemplazar las personalizaciones no administradas cuando se importe esta solución.

Utilice uno de estos valores:

• true
• false

--publish-workflows-activate-plugins

Indica explícitamente si se deben publicar los flujos de trabajo y activar los complementos cuando se importe esta solución.

Utilice uno de estos valores:

• true
• false

pac package add-solution

Agrega un archivo de solución de Dataverse precompilado a un proyecto de paquete de Package Deployer.

Parámetros necesarios para package add-solution

--path -p

Ruta de acceso al archivo de la solución de Dataverse. El archivo debe ser un archivo ZIP comprimido.

Parámetros opcionales para package add-solution

--dependency-overrides

Una lista delimitada por punto y coma de anulaciones. Este valor anula cualquier información de dependencia codificada en los metadatos de la solución. Cada anulación debe tener el formato: <uniquename>:<minVersion>:<maxVersion>. Donde minVersion y maxVersion son opcionales pero deben estar en la sintaxis de formato de versión .NET.

Nota :Utilice una lista delimitada por punto y coma de anulaciones de dependencia del formato < nombre único> :< minVersión> :< Versión máxima>.

--import-mode

Especifica explícitamente el modo necesario al importar esta solución.

Utilice uno de estos valores:

• sync
• async

--import-order

Un número entero que indica el orden para insertar este elemento en el archivo ImportConfig.xml final en el momento de la compilación. Los números negativos se insertan antes de los elementos existentes. Los números positivos se agregan después de los elementos existentes.

--missing-dependency-behavior

Especifica el comportamiento de la importación cuando falta una dependencia de esta solución en el entorno de destino.

Utilice uno de estos valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explícitamente si se deben reemplazar las personalizaciones no administradas cuando se importe esta solución.

Utilice uno de estos valores:

• true
• false

--publish-workflows-activate-plugins

Indica explícitamente si se deben publicar los flujos de trabajo y activar los complementos cuando se importe esta solución.

Utilice uno de estos valores:

• true
• false

--skip-validation -sv

Agrega el elemento al archivo de proyecto aunque el archivo no exista o parezca no válido. Nota: Usar esto no afecta ninguna validación realizada por MSBuild.

Este parámetro no requiere ningún valor. Es un modificador.

pac package compile

(Versión preliminar) Compila un paquete. Con --package-type erp, compila modelos X++ mediante xppc.exe desde el SDK instalado y genera un ZIP implementable por modelo.

Parámetros necesarios para package compile

--package-type -pt

Plataforma de destino para la implementación. Valores permitidos: dataverse, erp (versión preliminar). Valor predeterminado: dataverse.

Parámetros opcionales para package compile

--app-version -av

Versión de aplicación de F&O de cuatro partes del SDK con la que compilar (por ejemplo, 10.0.2588.0). Cuando se omite, se usa el SDK registrado para el entorno activo.

--incremental

Compile solo artefactos modificados (pasa -incremental a xppc).

Este parámetro no requiere ningún valor. Es un modificador.

--language -lang

Lista separada por comas de configuraciones regionales para compilar etiquetas (por ejemplo, en-US o en-US,fr,de). Cuando se omite, LabelC compila cada configuración regional que se encuentra en el origen, coincide con el comportamiento predeterminado de los modelos de compilación de Visual Studio. Solo afecta a la fase de etiquetas; xppc + procedimientos recomendados + paquete se ejecutan una vez en la salida combinada.

--license-file -lf

Ruta de acceso a un archivo de licencia de ISV para insertar en cada archivo ZIP de modelo generado. Escrito en <Model>/bin/<filename> dentro del archivo ZIP.

--model -m

Nombres de modelo que se van a compilar. Acepta un solo nombre o una lista separada por comas. Cuando se omite, se compilan todos los modelos enumerados en .erp/xpp.json.

--output

Directorio en el que se escribirán los ZIP que se pueden implementar. Valor predeterminado: <repoRoot>/bin.

--outputDirectory -o

Directorio de salida

--skip-bp

Omita el paso de comprobación de procedimientos recomendados. De forma predeterminada, la canalización de compilación ejecuta etiquetas (> X++):> procedimientos recomendados.

Este parámetro no requiere ningún valor. Es un modificador.

--solution-root -sr

Carpeta raíz de la solución X++ (contiene .erp/xpp.json). Por defecto se usa el directorio actual.

pac package db-sync

(Versión preliminar) Sincroniza la base de datos de la aplicación Finance and Operations con Dataverse.

Parámetros opcionales para package db-sync

--argument-file -af

(Versión preliminar) Ruta de acceso a un archivo JSON que coincida con el contrato IncrementalSyncParameters (o ModuleSyncParameters). Necesario para --db-sync Incremental.

--db-sync -ds

Modo de sincronización de base de datos. Valores permitidos: Full, Module, Incremental. Valor predeterminado: Completo.

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--modules -m

(Versión preliminar) Lista separada por comas de nombres de módulo que se van a sincronizar. Obligatorio cuando --db-sync es Module.

pac package deploy

Implementa el paquete en Dataverse

Nota

Este comando solo está disponible para la versión .NET Full Framework de PAC CLI.

Ejemplo

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

Parámetros opcionales para package deploy

--argument-file -af

(Versión preliminar) Ruta de acceso a un archivo JSON que coincida con el contrato IncrementalSyncParameters (o ModuleSyncParameters). Necesario para --db-sync Incremental.

--build-type -bt

(Versión preliminar) Cómo se aplica el paquete. Valores permitidos: Full, Incremental, Delete. Valor predeterminado: Completo. Se usa con --package-type erp.

--db-sync -ds

(Versión preliminar) Modo de sincronización de base de datos para ejecutarse después de la implementación. Valores permitidos: None, Full, Module, Incremental. Predeterminado: Ninguno. Se usa con --package-type erp.

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--logConsole -c

Registro de salida a la consola

Este parámetro no requiere ningún valor. Es un modificador.

--logFile -lf

Ruta de acceso del archivo de registro

--modules -m

(Versión preliminar) Lista separada por comas de nombres de módulo que se van a sincronizar. Obligatorio cuando --db-sync es Module.

--outputDirectory -o

(Versión preliminar) Solo en modo solución: carpeta raíz que contiene .erp/xpp.json. Por defecto se usa el directorio actual. Cuando --package se omite en --package-type erp, todos los modelos enumerados en .erp/xpp.json se implementan en orden de dependencia.

--package -p

Ruta de acceso a un archivo DLL de paquete o un archivo zip con un paquete.

--package-type -pt

Plataforma de destino para la implementación. Valores permitidos: dataverse, erp (versión preliminar). Valor predeterminado: dataverse.

--release-type -rt

(Versión preliminar) Clasificación de paquetes. Valores permitidos: Desarrollo, Versión. Valor predeterminado: desarrollo. Los paquetes de versión fuerzan una sincronización completa de la base de datos en el servidor. Se usa con --package-type erp.

--settings -s

Configuración del paquete de tiempo de ejecución que se pasa al paquete que se está implementando. El formato de la columna debe ser key=value|key=value.

Nota :El formato de la cadena debe ser key=value|key=value.

--solution -sz

Ruta de acceso al archivo de la solución de Dataverse. El archivo debe ser un archivo ZIP o CAB comprimido.

--solution-root -sr

(Versión preliminar) Solo en modo solución: carpeta raíz que contiene .erp/xpp.json. Por defecto se usa el directorio actual. Cuando --package se omite en --package-type erp, todos los modelos enumerados en .erp/xpp.json se implementan en orden de dependencia.

--verbose -vdbg

Emitir registros detallados para las salidas de registro.

Este parámetro no requiere ningún valor. Es un modificador.

Comentarios

Puede usar ambos parámetros logFile y logConsole juntos o utilizar uno u otro parámetro.

pac package init

Inicializa un directorio con un nuevo proyecto de paquete de Dataverse

Ejemplo

pac package init --outputdirectory c:\samplepackage

Parámetros opcionales para package init

--layer -l

(Versión preliminar) Capa X++. Valores permitidos: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Valor predeterminado: ISV.

--model -m

(Versión preliminar) Nombres de los modelos X++ que se van a aplicar scaffolding. Acepta un solo nombre o una lista separada por comas (por ejemplo, ModelA,ModelB). Obligatorio cuando --package-type es erp.

--outputDirectory -o

Directorio de salida

--package-name

Establece el nombre predeterminado del paquete. Se aplica a la generación de ImportExtension.GetNameOfImport.

--package-type -pt

Tipo de proyecto de paquete en scaffolding. Valores permitidos: dataverse, erp (versión preliminar). Valor predeterminado: dataverse.

--publisher -pub

(Versión preliminar) Publisher nombre escrito en el descriptor de modelo. Predeterminado: Microsoft.

--source-root -sr

(Versión preliminar) Ruta de acceso raíz de origen (relativa al directorio de salida) donde residirán los modelos. Valor predeterminado: ./src.

pac package show

Muestra detalles del paquete de Dataverse

Nota

Este comando solo está disponible para la versión .NET Full Framework de PAC CLI.

Ejemplo

pac package show c:\samplepackage.dll

Parámetros necesarios para package show

--package -p

Ruta de acceso a un archivo DLL de paquete o un archivo zip con un paquete.

Parámetros opcionales para package show

--environment -env

Especifica el Dataverse de destino. El valor puede ser una URL de Guid o HTTPS absoluta. Si no se especifica, se utilizará la organización activa seleccionada para el perfil de autenticación actual.

--logFile -lf

Ruta de acceso del archivo de registro

--verbose -vdbg

Emitir registros detallados para las salidas de registro.

Este parámetro no requiere ningún valor. Es un modificador.

Consulte también

Grupos de comandos de Microsoft Power Platform CLI
Microsoft Power PlatformVisión general del CLI