pac package

Comandi per l'uso dei progetti di pacchetto Dataverse.

Commands

Command	Description
pac package add-external-package	Aggiunge un pacchetto esterno al sistema della soluzione Dataverse a un progetto Package Deployer Package.
pac package add-reference	Aggiunge un riferimento al progetto di soluzione Dataverse
pac package add-solution	Aggiunge un file di soluzione Dataverse predefinito a un progetto Package Deployer Package.
pac package compile	(Anteprima) Compila un pacchetto. Con --package-type erp compila modelli X++ usando xppc.exe dall'SDK installato e produce un file ZIP distribuibile per modello.
pac package db-sync	(Anteprima) Sincronizza il database dell'applicazione Finance and Operations con Dataverse.
pac package deploy	Distribuisce il pacchetto in Dataverse
pac package init	Inizializza una directory con un nuovo progetto di pacchetto Dataverse
pac package show	Mostra i dettagli del pacchetto Dataverse

pac package add-external-package

Aggiunge un pacchetto esterno al sistema della soluzione Dataverse a un progetto Package Deployer Package.

Parametri obbligatori per package add-external-package

--package-type -t

Tipo del pacchetto da aggiungere. Ad esempio: 'xpp' per i pacchetti FnO.

--path -p

Percorso del pacchetto esterno

Parametri facoltativi per package add-external-package

--import-order

Numero intero che indica l'ordine di inserire questo elemento nel file finale ImportConfig.xml in fase di compilazione. I numeri negativi vengono inseriti prima degli elementi esistenti. I numeri positivi vengono aggiunti dopo gli elementi esistenti.

--skip-validation -sv

Aggiunge l'elemento al file di progetto anche se il file non esiste o sembra non valido. Nota: l'uso di questo non influisce sulla convalida eseguita da MSBuild.

Questo parametro non richiede alcun valore. È un cambio.

pac package add-reference

Aggiunge un riferimento al progetto di soluzione Dataverse

Example

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

Parametri obbligatori per package add-reference

--path -p

Percorso del progetto di soluzione Dataverse di riferimento

Parametri facoltativi per package add-reference

--dependency-overrides

Elenco delimitato da punto e virgola di sostituzioni. Questo valore esegue l'override di tutte le informazioni sulle dipendenze codificate nei metadati della soluzione. Ogni override deve essere nel formato : <uniquename>:<minVersion>:<maxVersion>. Dove minVersion e maxVersion sono facoltativi, ma devono essere nella sintassi del formato della versione .NET.

Nota: usare un elenco delimitato da punto e virgola di override delle dipendenze del formato <uniquename>:<minVersion:>maxVersion<>.

--import-mode

Specifica in modo esplicito la modalità richiesta durante l'importazione di questa soluzione.

Usare uno di questi valori:

• sync
• async

--import-order

Numero intero che indica l'ordine di inserire questo elemento nel file finale ImportConfig.xml in fase di compilazione. I numeri negativi vengono inseriti prima degli elementi esistenti. I numeri positivi vengono aggiunti dopo gli elementi esistenti.

--missing-dependency-behavior

Specifica il comportamento da importare quando manca una dipendenza di questa soluzione dall'ambiente di destinazione.

Usare uno di questi valori:

• skip
• fault

--overwrite-unmanaged-customizations

Indica in modo esplicito se sovrascrivere le personalizzazioni non gestite quando questa soluzione viene importata.

Usare uno di questi valori:

• true
• false

--publish-workflows-activate-plugins

Indica in modo esplicito se pubblicare i flussi di lavoro e attivare i plug-in quando questa soluzione viene importata.

Usare uno di questi valori:

• true
• false

pac package add-solution

Aggiunge un file di soluzione Dataverse predefinito a un progetto Package Deployer Package.

Parametri obbligatori per package add-solution

--path -p

Percorso del file della soluzione Dataverse. Il file deve essere un file ZIP compresso.

Parametri facoltativi per package add-solution

--dependency-overrides

Elenco delimitato da punto e virgola di sostituzioni. Questo valore esegue l'override di tutte le informazioni sulle dipendenze codificate nei metadati della soluzione. Ogni override deve essere nel formato : <uniquename>:<minVersion>:<maxVersion>. Dove minVersion e maxVersion sono facoltativi, ma devono essere nella sintassi del formato della versione .NET.

Nota: usare un elenco delimitato da punto e virgola di override delle dipendenze del formato <uniquename>:<minVersion:>maxVersion<>.

--import-mode

Specifica in modo esplicito la modalità richiesta durante l'importazione di questa soluzione.

Usare uno di questi valori:

• sync
• async

--import-order

Numero intero che indica l'ordine di inserire questo elemento nel file finale ImportConfig.xml in fase di compilazione. I numeri negativi vengono inseriti prima degli elementi esistenti. I numeri positivi vengono aggiunti dopo gli elementi esistenti.

--missing-dependency-behavior

Specifica il comportamento da importare quando manca una dipendenza di questa soluzione dall'ambiente di destinazione.

Usare uno di questi valori:

• skip
• fault

--overwrite-unmanaged-customizations

Indica in modo esplicito se sovrascrivere le personalizzazioni non gestite quando questa soluzione viene importata.

Usare uno di questi valori:

• true
• false

--publish-workflows-activate-plugins

Indica in modo esplicito se pubblicare i flussi di lavoro e attivare i plug-in quando questa soluzione viene importata.

Usare uno di questi valori:

• true
• false

--skip-validation -sv

Aggiunge l'elemento al file di progetto anche se il file non esiste o sembra non valido. Nota: l'uso di questo non influisce sulla convalida eseguita da MSBuild.

Questo parametro non richiede alcun valore. È un cambio.

pac package compile

(Anteprima) Compila un pacchetto. Con --package-type erp compila modelli X++ usando xppc.exe dall'SDK installato e produce un file ZIP distribuibile per modello.

Parametri obbligatori per package compile

--package-type -pt

Piattaforma di destinazione per la distribuzione. Valori consentiti: dataverse, erp (anteprima). Impostazione predefinita: dataverse.

Parametri facoltativi per package compile

--app-version -av

Versione dell'applicazione F&O in quattro parti dell'SDK da compilare in (ad esempio 10.0.2588.0). Se omesso, viene usato l'SDK registrato per l'ambiente attivo.

--incremental

Compilare solo gli artefatti modificati (passa -incremental a xppc).

Questo parametro non richiede alcun valore. È un cambio.

--language -lang

Elenco delimitato da virgole di impostazioni locali per cui compilare le etichette ,ad esempio en-US o en-US,fr,de). Quando viene omesso, LabelC compila tutte le impostazioni locali presenti nell'origine, corrisponde al comportamento predefinito dei modelli di compilazione di Visual Studio. Influisce solo sulla fase delle etichette; xppc + best-practices + package vengono eseguiti una volta sull'output combinato.

--license-file -lf

Percorso di un file di licenza ISV da inserire in ogni file ZIP del modello prodotto. Scritto in <Model>/bin/<filename> all'interno del file ZIP.

--model -m

Nomi del modello da compilare. Accetta un singolo nome o un elenco delimitato da virgole. Se omesso, vengono compilati tutti i modelli elencati in .erp/xpp.json.

--output

Directory in cui verranno scritti gli ZIP distribuibili. Impostazione predefinita: <repoRoot>/bin.

--outputDirectory -o

Directory di output

--skip-bp

Ignorare il passaggio di controllo delle procedure consigliate. Per impostazione predefinita, la pipeline di compilazione esegue etichette -> X++ -> procedure consigliate.

Questo parametro non richiede alcun valore. È un cambio.

--solution-root -sr

Cartella radice della soluzione X++ (contiene .erp/xpp.json). Di default si trova nella directory corrente.

pac package db-sync

(Anteprima) Sincronizza il database dell'applicazione Finance and Operations con Dataverse.

Parametri facoltativi per package db-sync

--argument-file -af

(Anteprima) Percorso di un file JSON corrispondente al contratto IncrementalSyncParameters (o ModuleSyncParameters). Obbligatorio per --db-sync Incremental.

--db-sync -ds

Modalità di sincronizzazione del database. Valori consentiti: Full, Module, Incremental. Impostazione predefinita: completa.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--modules -m

(Anteprima) Elenco delimitato da virgole di nomi di modulo da sincronizzare. Obbligatorio quando --db-sync è Module.

pac package deploy

Distribuisce il pacchetto in Dataverse

Annotazioni

Questo comando è disponibile solo per la versione .NET Full Framework dell'interfaccia della riga di comando pac.

Example

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

Parametri facoltativi per package deploy

--argument-file -af

(Anteprima) Percorso di un file JSON corrispondente al contratto IncrementalSyncParameters (o ModuleSyncParameters). Obbligatorio per --db-sync Incremental.

--build-type -bt

(Anteprima) Modalità di applicazione del pacchetto. Valori consentiti: Full, Incremental, Delete. Impostazione predefinita: completa. Usato con --package-type erp.

--db-sync -ds

(Anteprima) Modalità di sincronizzazione del database da eseguire dopo la distribuzione. Valori consentiti: None, Full, Module, Incremental. Impostazione predefinita: nessuna. Usato con --package-type erp.

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--logConsole -c

Log di output nella console

Questo parametro non richiede alcun valore. È un cambio.

--logFile -lf

Percorso del file di log

--modules -m

(Anteprima) Elenco delimitato da virgole di nomi di modulo da sincronizzare. Obbligatorio quando --db-sync è Module.

--outputDirectory -o

(Anteprima) Solo in modalità soluzione: cartella radice contenente .erp/xpp.json. Di default si trova nella directory corrente. Quando --package viene omesso in --package-type erp, tutti i modelli elencati in .erp/xpp.json vengono distribuiti in ordine di dipendenza.

--package -p

Percorso di una DLL del pacchetto o di un file ZIP con un pacchetto.

--package-type -pt

Piattaforma di destinazione per la distribuzione. Valori consentiti: dataverse, erp (anteprima). Impostazione predefinita: dataverse.

--release-type -rt

(Anteprima) Classificazione dei pacchetti. Valori consentiti: Dev, Release. Impostazione predefinita: Sviluppo. I pacchetti di rilascio forzano una sincronizzazione completa del database nel server. Usato con --package-type erp.

--settings -s

Impostazioni del pacchetto di runtime passate al pacchetto in fase di distribuzione. Il formato della stringa deve essere key=value|key=value.

Nota: il formato della stringa deve essere key=value|key=value.

--solution -sz

Percorso del file della soluzione Dataverse. Il file deve essere un file ZIP o CAB compresso.

--solution-root -sr

(Anteprima) Solo in modalità soluzione: cartella radice contenente .erp/xpp.json. Di default si trova nella directory corrente. Quando --package viene omesso in --package-type erp, tutti i modelli elencati in .erp/xpp.json vengono distribuiti in ordine di dipendenza.

--verbose -vdbg

Generare log dettagliati negli output del log.

Questo parametro non richiede alcun valore. È un cambio.

Osservazioni:

È possibile usare entrambi logFile i parametri e logConsole insieme oppure usare un parametro o l'altro.

pac package init

Inizializza una directory con un nuovo progetto di pacchetto Dataverse

Example

pac package init --outputdirectory c:\samplepackage

Parametri facoltativi per package init

--layer -l

(Anteprima) Livello X++. Valori consentiti: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Impostazione predefinita: ISV.

--model -m

(Anteprima) Nomi dei modelli X++ da scaffolding. Accetta un singolo nome o un elenco delimitato da virgole,ad esempio ModelA,ModelB. Obbligatorio quando --package-type è erp.

--outputDirectory -o

Directory di output

--package-name

Imposta il nome predefinito del pacchetto. Si applica alla generazione di ImportExtension.GetNameOfImport.

--package-type -pt

Tipo di progetto di pacchetto da eseguire per lo scaffolding. Valori consentiti: dataverse, erp (anteprima). Impostazione predefinita: dataverse.

--publisher -pub

(Anteprima) Publisher nome scritto nel descrittore del modello. Impostazione predefinita: Microsoft.

--source-root -sr

(Anteprima) Percorso radice di origine (relativo alla directory di output) in cui verranno attivati i modelli. Impostazione predefinita: ./src.

pac package show

Mostra i dettagli del pacchetto Dataverse

Annotazioni

Questo comando è disponibile solo per la versione .NET Full Framework dell'interfaccia della riga di comando pac.

Example

pac package show c:\samplepackage.dll

Parametri obbligatori per package show

--package -p

Percorso di una DLL del pacchetto o di un file ZIP con un pacchetto.

Parametri facoltativi per package show

--environment -env

Specifica l'oggetto Dataverse di destinazione. Il valore può essere un GUID o un URL https assoluto. Se non specificato, verrà usata l'organizzazione attiva selezionata per il profilo di autenticazione corrente.

--logFile -lf

Percorso del file di log

--verbose -vdbg

Generare log dettagliati negli output del log.

Questo parametro non richiede alcun valore. È un cambio.

Vedere anche

Gruppi di comandi dell'interfaccia della riga di comando di Microsoft Power Platform
Panoramica dell'interfaccia della riga di comando di Microsoft Power Platform