pac package

Comandos para trabalhar com projetos de pacote do Dataverse.

Commands

Command	Description
pac package add-external-package	Adiciona um pacote externo ao sistema de solução do Dataverse a um projeto de Pacote do Implantador de Pacotes.
pac package add-reference	Adiciona referência ao projeto de solução do Dataverse
pac package add-solution	Adiciona um arquivo de solução predefinido do Dataverse a um projeto de Pacote do Implantador de Pacotes.
pac package compile	(Versão prévia) Compila um pacote. Com o erp do tipo --package, compila modelos X++ usando xppc.exe do SDK instalado e produz um ZIP implantável por modelo.
pac package db-sync	(Versão prévia) Sincroniza o banco de dados do aplicativo Finanças e Operações com o Dataverse.
pac package deploy	Implanta o pacote no Dataverse
pac package init	Inicializa um diretório com um novo projeto de pacote do Dataverse
pac package show	Mostra detalhes do pacote do Dataverse

pac package add-external-package

Adiciona um pacote externo ao sistema de solução do Dataverse a um projeto de Pacote do Implantador de Pacotes.

Parâmetros necessários para package add-external-package

--package-type -t

O tipo do pacote que está sendo adicionado. Por exemplo: 'xpp' para pacotes FnO.

--path -p

Caminho para o pacote externo

Parâmetros opcionais para package add-external-package

--import-order

Um número inteiro que indica a ordem para inserir esse item no arquivo de ImportConfig.xml final no momento do build. Números negativos são inseridos antes dos elementos existentes. Números positivos são adicionados após os elementos existentes.

--skip-validation -sv

Adiciona o item ao arquivo de projeto mesmo que o arquivo não exista ou pareça ser inválido. Observação: usar isso não afeta nenhuma validação executada pelo MSBuild.

Esse parâmetro não requer nenhum valor. É um comutador.

pac package add-reference

Adiciona referência ao projeto de solução do Dataverse

Example

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

Parâmetros necessários para package add-reference

--path -p

O caminho para o projeto de solução do Dataverse referenciado

Parâmetros opcionais para package add-reference

--dependency-overrides

Uma lista delimitada por ponto-e-vírgula de substituições. Esse valor substitui todas as informações de dependência codificadas nos metadados da solução. Cada substituição deve estar no formato: <uniquename>:<minVersion>:<maxVersion>. Onde minVersion e maxVersion são opcionais, mas devem estar na sintaxe de formato de versão do .NET.

Observação: use uma lista delimitada por ponto-e-vírgula de substituições de dependência do formato <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Especifica explicitamente o modo necessário ao importar essa solução.

Use um destes valores:

• sync
• async

--import-order

Um número inteiro que indica a ordem para inserir esse item no arquivo de ImportConfig.xml final no momento do build. Números negativos são inseridos antes dos elementos existentes. Números positivos são adicionados após os elementos existentes.

--missing-dependency-behavior

Especifica o comportamento na importação quando uma dependência dessa solução está ausente do ambiente de destino.

Use um destes valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explicitamente se as personalizações não gerenciadas devem ser substituídas quando essa solução é importada.

Use um destes valores:

• true
• false

--publish-workflows-activate-plugins

Indica explicitamente se os fluxos de trabalho devem ser publicados e ativar plug-ins quando essa solução for importada.

Use um destes valores:

• true
• false

pac package add-solution

Adiciona um arquivo de solução predefinido do Dataverse a um projeto de Pacote do Implantador de Pacotes.

Parâmetros necessários para package add-solution

--path -p

Caminho para o arquivo de solução do Dataverse. O arquivo deve ser um arquivo ZIP compactado.

Parâmetros opcionais para package add-solution

--dependency-overrides

Uma lista delimitada por ponto-e-vírgula de substituições. Esse valor substitui todas as informações de dependência codificadas nos metadados da solução. Cada substituição deve estar no formato: <uniquename>:<minVersion>:<maxVersion>. Onde minVersion e maxVersion são opcionais, mas devem estar na sintaxe de formato de versão do .NET.

Observação: use uma lista delimitada por ponto-e-vírgula de substituições de dependência do formato <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Especifica explicitamente o modo necessário ao importar essa solução.

Use um destes valores:

• sync
• async

--import-order

Um número inteiro que indica a ordem para inserir esse item no arquivo de ImportConfig.xml final no momento do build. Números negativos são inseridos antes dos elementos existentes. Números positivos são adicionados após os elementos existentes.

--missing-dependency-behavior

Especifica o comportamento na importação quando uma dependência dessa solução está ausente do ambiente de destino.

Use um destes valores:

• skip
• fault

--overwrite-unmanaged-customizations

Indica explicitamente se as personalizações não gerenciadas devem ser substituídas quando essa solução é importada.

Use um destes valores:

• true
• false

--publish-workflows-activate-plugins

Indica explicitamente se os fluxos de trabalho devem ser publicados e ativar plug-ins quando essa solução for importada.

Use um destes valores:

• true
• false

--skip-validation -sv

Adiciona o item ao arquivo de projeto mesmo que o arquivo não exista ou pareça ser inválido. Observação: usar isso não afeta nenhuma validação executada pelo MSBuild.

Esse parâmetro não requer nenhum valor. É um comutador.

pac package compile

(Versão prévia) Compila um pacote. Com o erp do tipo --package, compila modelos X++ usando xppc.exe do SDK instalado e produz um ZIP implantável por modelo.

Parâmetros necessários para package compile

--package-type -pt

Plataforma de destino para implantação. Valores permitidos: dataverse, erp (versão prévia). Padrão: dataverse.

Parâmetros opcionais para package compile

--app-version -av

Versão do aplicativo F&O de quatro partes do SDK para compilar (por exemplo, 10.0.2588.0). Quando omitido, o SDK registrado para o ambiente ativo é usado.

--incremental

Compile apenas artefatos alterados (passa -incremental para xppc).

Esse parâmetro não requer nenhum valor. É um comutador.

--language -lang

Lista separada por vírgulas de localidades para compilar rótulos (por exemplo, en-US ou en-US,fr,de). Quando omitido, o LabelC cria cada localidade encontrada na origem – corresponde ao comportamento padrão de Modelos de Build de Visual Studio. Afeta apenas o estágio de rótulos; xppc + práticas recomendadas + execução de pacote uma vez pela saída combinada.

--license-file -lf

Caminho para um arquivo de licença ISV para injetar em cada ZIP de modelo produzido. Gravado em <Model>/bin/<filename> dentro do ZIP.

--model -m

Nome do modelo a ser compilado. Aceita um único nome ou uma lista separada por vírgulas. Quando omitidos, todos os modelos listados em .erp/xpp.json são compilados.

--output

Diretório em que os ZIPs implantáveis serão gravados. Padrão: <repoRoot>/bin.

--outputDirectory -o

Diretório de saída

--skip-bp

Ignore a etapa de verificação de práticas recomendadas. Por padrão, o pipeline de compilação executa rótulos –> X++ –> práticas recomendadas.

Esse parâmetro não requer nenhum valor. É um comutador.

--solution-root -sr

Pasta raiz da solução X++ (contém .erp/xpp.json). O diretório atual é padrão.

pac package db-sync

(Versão prévia) Sincroniza o banco de dados do aplicativo Finanças e Operações com o Dataverse.

Parâmetros opcionais para package db-sync

--argument-file -af

(Versão prévia) Caminho para um arquivo JSON que corresponda ao contrato IncrementalSyncParameters (ou ModuleSyncParameters). Necessário para --db-sync Incremental.

--db-sync -ds

Modo de sincronização de banco de dados. Valores permitidos: Completo, Módulo, Incremental. Padrão: Completo.

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--modules -m

(Versão prévia) Lista separada por vírgulas de nomes de módulo a serem sincronizados. Necessário quando --db-sync é Module.

pac package deploy

Implanta o pacote no Dataverse

Observação

Esse comando só está disponível para a versão do .NET Full Framework da CLI do PAC.

Example

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

Parâmetros opcionais para package deploy

--argument-file -af

(Versão prévia) Caminho para um arquivo JSON que corresponda ao contrato IncrementalSyncParameters (ou ModuleSyncParameters). Necessário para --db-sync Incremental.

--build-type -bt

(Versão prévia) Como o pacote é aplicado. Valores permitidos: Completo, Incremental, Excluir. Padrão: Completo. Usado com o erp do tipo --package.

--db-sync -ds

(Versão prévia) Modo de sincronização de banco de dados a ser executado após a implantação. Valores permitidos: Nenhum, Completo, Módulo, Incremental. Padrão: nenhum. Usado com o erp do tipo --package.

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--logConsole -c

Log de saída para o console

Esse parâmetro não requer nenhum valor. É um comutador.

--logFile -lf

Caminho do arquivo de log

--modules -m

(Versão prévia) Lista separada por vírgulas de nomes de módulo a serem sincronizados. Necessário quando --db-sync é Module.

--outputDirectory -o

(Versão prévia) Somente modo de solução: pasta raiz contendo .erp/xpp.json. O diretório atual é padrão. Quando --package é omitido em --package-type erp, todos os modelos listados em .erp/xpp.json são implantados em ordem de dependência.

--package -p

Caminho para um arquivo dll ou zip de pacote com um pacote.

--package-type -pt

Plataforma de destino para implantação. Valores permitidos: dataverse, erp (versão prévia). Padrão: dataverse.

--release-type -rt

(Versão prévia) Classificação de pacote. Valores permitidos: Desenvolvimento, Versão. Padrão: Desenvolvimento. Os pacotes de versão forçam uma sincronização de banco de dados completa no servidor. Usado com o erp do tipo --package.

--settings -s

Configurações de pacote de runtime que são passadas para o pacote que está sendo implantado. O formato da cadeia de caracteres deve ser key=value|key=value.

Observação: o formato da cadeia de caracteres deve ser key=value|key=value.

--solution -sz

Caminho para o arquivo de solução do Dataverse. O arquivo deve ser um arquivo ZIP ou CAB compactado.

--solution-root -sr

(Versão prévia) Somente modo de solução: pasta raiz contendo .erp/xpp.json. O diretório atual é padrão. Quando --package é omitido em --package-type erp, todos os modelos listados em .erp/xpp.json são implantados em ordem de dependência.

--verbose -vdbg

Emita logs detalhados nas saídas de log.

Esse parâmetro não requer nenhum valor. É um comutador.

Observações

Você pode usar parâmetros e logFile parâmetros logConsole juntos ou usar um parâmetro ou outro.

pac package init

Inicializa um diretório com um novo projeto de pacote do Dataverse

Example

pac package init --outputdirectory c:\samplepackage

Parâmetros opcionais para package init

--layer -l

(Versão prévia) Camada X++. Valores permitidos: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Padrão: ISV.

--model -m

(Versão prévia) Nome(s) dos modelos X++ a serem scaffold. Aceita um único nome ou uma lista separada por vírgulas (por exemplo, ModelA, ModelB). Necessário quando --package-type é erp.

--outputDirectory -o

Diretório de saída

--package-name

Define o nome padrão do pacote. Aplica-se à geração de ImportExtension.GetNameOfImport.

--package-type -pt

Tipo de projeto de pacote a ser scaffold. Valores permitidos: dataverse, erp (versão prévia). Padrão: dataverse.

--publisher -pub

(Versão prévia) Publisher nome escrito no descritor de modelo. Padrão: Microsoft.

--source-root -sr

(Versão prévia) Caminho raiz de origem (em relação ao diretório de saída) em que os modelos viverão. Padrão: ./src.

pac package show

Mostra detalhes do pacote do Dataverse

Observação

Esse comando só está disponível para a versão do .NET Full Framework da CLI do PAC.

Example

pac package show c:\samplepackage.dll

Parâmetros necessários para package show

--package -p

Caminho para um arquivo dll ou zip de pacote com um pacote.

Parâmetros opcionais para package show

--environment -env

Especifica o Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--logFile -lf

Caminho do arquivo de log

--verbose -vdbg

Emita logs detalhados nas saídas de log.

Esse parâmetro não requer nenhum valor. É um comutador.

Consulte também

Grupos de comandos da CLI do Microsoft Power Platform
Visão geral da CLI do Microsoft Power Platform