pac package

Polecenia do pracy z projektami pakietu Dataverse.

Commands

Command	Description
pac package add-external-package	Dodaje pakiet zewnętrzny do systemu rozwiązania Dataverse w projekcie Package Deployer Package.
pac package add-reference	Dodaje odwołanie do projektu rozwiązania Dataverse
pac package add-solution	Dodaje wstępnie utworzony plik rozwiązania Dataverse do projektu Package Deployer Package.
pac package compile	(Wersja zapoznawcza) Kompiluje pakiet. W przypadku modelu --package-type erp kompiluje modele X++ przy użyciu xppc.exe z zainstalowanego zestawu SDK i tworzy możliwy do wdrożenia plik ZIP dla każdego modelu.
pac package db-sync	(Wersja zapoznawcza) Synchronizuje bazę danych aplikacji Finance and Operations z usługą Dataverse.
pac package deploy	Wdraża pakiet w usłudze Dataverse
pac package init	Inicjuje katalog przy użyciu nowego projektu pakietu Dataverse
pac package show	Pokazuje szczegóły pakietu Dataverse

pac package add-external-package

Dodaje pakiet zewnętrzny do systemu rozwiązania Dataverse w projekcie Package Deployer Package.

Wymagane parametry dla package add-external-package

--package-type -t

Typ dodawanego pakietu. Na przykład: "xpp" dla pakietów FnO.

--path -p

Ścieżka do pakietu zewnętrznego

Parametry opcjonalne dla package add-external-package

--import-order

Liczba całkowita wskazująca kolejność wstawiania tego elementu do końcowego pliku ImportConfig.xml w czasie kompilacji. Liczby ujemne są wstawiane przed istniejącymi elementami. Liczby dodatnie są dodawane po istniejących elementach.

--skip-validation -sv

Dodaje element do pliku projektu, nawet jeśli plik nie istnieje lub wydaje się być nieprawidłowy. Uwaga: użycie tej metody nie ma wpływu na walidację wykonywaną przez program MSBuild.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

pac package add-reference

Dodaje odwołanie do projektu rozwiązania Dataverse

Example

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

Wymagane parametry dla package add-reference

--path -p

Ścieżka do przywoływnego projektu rozwiązania Dataverse

Parametry opcjonalne dla package add-reference

--dependency-overrides

Rozdzielana średnikami lista przesłonięć. Ta wartość zastępuje wszelkie informacje o zależnościach zakodowane w metadanych rozwiązania. Każde zastąpienie powinno mieć format: <uniquename>:<minVersion>:<maxVersion>. Gdzie parametr minVersion i maxVersion są opcjonalne, ale powinny być w składni formatu wersji platformy .NET.

Uwaga: Użyj rozdzielanej średnikami listy przesłonięć zależności w formacie <uniquename>:minVersion:<>maxVersion<>.

--import-mode

Jawnie określa wymagany tryb podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• sync
• async

--import-order

Liczba całkowita wskazująca kolejność wstawiania tego elementu do końcowego pliku ImportConfig.xml w czasie kompilacji. Liczby ujemne są wstawiane przed istniejącymi elementami. Liczby dodatnie są dodawane po istniejących elementach.

--missing-dependency-behavior

Określa zachowanie podczas importowania, gdy w środowisku docelowym brakuje zależności tego rozwiązania.

Użyj jednej z następujących wartości:

• skip
• fault

--overwrite-unmanaged-customizations

Jawnie wskazuje, czy zastąpić niezarządzane dostosowania podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

--publish-workflows-activate-plugins

Jawnie wskazuje, czy należy opublikować przepływy pracy i aktywować wtyczki podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

pac package add-solution

Dodaje wstępnie utworzony plik rozwiązania Dataverse do projektu Package Deployer Package.

Wymagane parametry dla package add-solution

--path -p

Ścieżka do pliku rozwiązania Dataverse. Plik musi być skompresowanym plikiem ZIP.

Parametry opcjonalne dla package add-solution

--dependency-overrides

Rozdzielana średnikami lista przesłonięć. Ta wartość zastępuje wszelkie informacje o zależnościach zakodowane w metadanych rozwiązania. Każde zastąpienie powinno mieć format: <uniquename>:<minVersion>:<maxVersion>. Gdzie parametr minVersion i maxVersion są opcjonalne, ale powinny być w składni formatu wersji platformy .NET.

Uwaga: Użyj rozdzielanej średnikami listy przesłonięć zależności w formacie <uniquename>:minVersion:<>maxVersion<>.

--import-mode

Jawnie określa wymagany tryb podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• sync
• async

--import-order

Liczba całkowita wskazująca kolejność wstawiania tego elementu do końcowego pliku ImportConfig.xml w czasie kompilacji. Liczby ujemne są wstawiane przed istniejącymi elementami. Liczby dodatnie są dodawane po istniejących elementach.

--missing-dependency-behavior

Określa zachowanie podczas importowania, gdy w środowisku docelowym brakuje zależności tego rozwiązania.

Użyj jednej z następujących wartości:

• skip
• fault

--overwrite-unmanaged-customizations

Jawnie wskazuje, czy zastąpić niezarządzane dostosowania podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

--publish-workflows-activate-plugins

Jawnie wskazuje, czy należy opublikować przepływy pracy i aktywować wtyczki podczas importowania tego rozwiązania.

Użyj jednej z następujących wartości:

• true
• false

--skip-validation -sv

Dodaje element do pliku projektu, nawet jeśli plik nie istnieje lub wydaje się być nieprawidłowy. Uwaga: użycie tej metody nie ma wpływu na walidację wykonywaną przez program MSBuild.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

pac package compile

(Wersja zapoznawcza) Kompiluje pakiet. W przypadku modelu --package-type erp kompiluje modele X++ przy użyciu xppc.exe z zainstalowanego zestawu SDK i tworzy możliwy do wdrożenia plik ZIP dla każdego modelu.

Wymagane parametry dla package compile

--package-type -pt

Platforma docelowa do wdrożenia. Dozwolone wartości: dataverse, erp (wersja zapoznawcza). Ustawienie domyślne: dataverse.

Parametry opcjonalne dla package compile

--app-version -av

Czteroczęściowa wersja aplikacji F&O zestawu SDK do skompilowania (np. 10.0.2588.0). Po pominięciu używany jest zestaw SDK zarejestrowany dla aktywnego środowiska.

--incremental

Kompilowanie tylko zmienionych artefaktów (przekazuje -incremental do xppc).

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--language -lang

Rozdzielona przecinkami lista ustawień regionalnych do kompilowania etykiet (np. en-US lub en-US,fr,de). Po pominięciu funkcja LabelC tworzy wszystkie ustawienia regionalne znalezione w źródle — dopasowuje domyślne zachowanie modeli kompilacji Visual Studio. Dotyczy tylko etapu etykiet; xppc + best-practices + package run once over the combined output (xppc + best-practices + package run once over the combined output).

--license-file -lf

Ścieżka do pliku licencji niezależnego dostawcy oprogramowania w celu wstrzyknięcia do każdego utworzonego modelu ZIP. Zapisano w pliku <ZIP> model/bin/<nazwa pliku> .

--model -m

Nazwy modeli do skompilowania. Akceptuje jedną nazwę lub listę rozdzielaną przecinkami. Po pominięciu wszystkie modele wymienione w pliku erp/xpp.json są kompilowane.

--output

Katalog, w którym zostaną zapisane wdrożone adresy ZIPs. Ustawienie domyślne: <repoRoot>/bin.

--outputDirectory -o

Katalog wyjściowy

--skip-bp

Pomiń krok sprawdzania najlepszych rozwiązań. Domyślnie etykiety przebiegów potoku kompilacji —> X++ —> najlepsze rozwiązania.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--solution-root -sr

Folder główny rozwiązania X++ (zawiera plik erp/xpp.json). Domyślnie jest to aktualny katalog.

pac package db-sync

(Wersja zapoznawcza) Synchronizuje bazę danych aplikacji Finance and Operations z usługą Dataverse.

Parametry opcjonalne dla package db-sync

--argument-file -af

(Wersja zapoznawcza) Ścieżka do pliku JSON zgodnego z kontraktem IncrementalSyncParameters (lub ModuleSyncParameters). Wymagane dla przyrostowego elementu --db-sync.

--db-sync -ds

Tryb synchronizacji bazy danych. Dozwolone wartości: Pełne, Moduł, Przyrostowe. Ustawienie domyślne: Pełne.

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--modules -m

(Wersja zapoznawcza) Rozdzielona przecinkami lista nazw modułów do synchronizacji. Wymagane, gdy --db-sync jest modułem.

pac package deploy

Wdraża pakiet w usłudze Dataverse

Uwaga / Notatka

To polecenie jest dostępne tylko dla wersji platformy .NET Full Framework interfejsu wiersza polecenia PAC.

Example

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

Parametry opcjonalne dla package deploy

--argument-file -af

(Wersja zapoznawcza) Ścieżka do pliku JSON zgodnego z kontraktem IncrementalSyncParameters (lub ModuleSyncParameters). Wymagane dla przyrostowego elementu --db-sync.

--build-type -bt

(Wersja zapoznawcza) Sposób stosowania pakietu. Dozwolone wartości: Pełne, Przyrostowe, Usuń. Ustawienie domyślne: Pełne. Używany z --package-type erp.

--db-sync -ds

(Wersja zapoznawcza) Tryb synchronizacji bazy danych do uruchomienia po wdrożeniu. Dozwolone wartości: Brak, Pełny, Moduł, Przyrostowy. Ustawienie domyślne: Brak. Używany z --package-type erp.

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--logConsole -c

Dziennik wyjściowy do konsoli

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--logFile -lf

Ścieżka pliku dziennika

--modules -m

(Wersja zapoznawcza) Rozdzielona przecinkami lista nazw modułów do synchronizacji. Wymagane, gdy --db-sync jest modułem.

--outputDirectory -o

(Wersja zapoznawcza) Tylko tryb rozwiązania: folder główny zawierający plik erp/xpp.json. Domyślnie jest to aktualny katalog. Gdy parametr --package zostanie pominięty w obszarze --package-type erp, wszystkie modele wymienione w pliku .erp/xpp.json są wdrażane w kolejności zależności.

--package -p

Ścieżka do pliku dll pakietu lub pliku zip z pakietem.

--package-type -pt

Platforma docelowa do wdrożenia. Dozwolone wartości: dataverse, erp (wersja zapoznawcza). Ustawienie domyślne: dataverse.

--release-type -rt

(Wersja zapoznawcza) Klasyfikacja pakietów. Dozwolone wartości: Dev, Release. Ustawienie domyślne: Dev. Pakiety wydań wymuszają pełną synchronizację bazy danych na serwerze. Używany z --package-type erp.

--settings -s

Ustawienia pakietu środowiska uruchomieniowego przekazywane do wdrażanego pakietu. Format ciągu musi mieć wartość key=value|key=value.

Uwaga: format ciągu musi mieć wartość key=value|key=value.

--solution -sz

Ścieżka do pliku rozwiązania Dataverse. Plik musi być skompresowanym plikiem ZIP lub CAB.

--solution-root -sr

(Wersja zapoznawcza) Tylko tryb rozwiązania: folder główny zawierający plik erp/xpp.json. Domyślnie jest to aktualny katalog. Gdy parametr --package zostanie pominięty w obszarze --package-type erp, wszystkie modele wymienione w pliku .erp/xpp.json są wdrażane w kolejności zależności.

--verbose -vdbg

Emituj pełne dzienniki do danych wyjściowych dziennika.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

Uwagi

Można użyć obu logFile parametrów i logConsole razem albo użyć jednego parametru lub drugiego.

pac package init

Inicjuje katalog przy użyciu nowego projektu pakietu Dataverse

Example

pac package init --outputdirectory c:\samplepackage

Parametry opcjonalne dla package init

--layer -l

(Wersja zapoznawcza) Warstwa X++. Dozwolone wartości: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Ustawienie domyślne: niezależnego dostawcy oprogramowania.

--model -m

(Wersja zapoznawcza) Nazwy modeli X++ do szkieletu. Akceptuje pojedynczą nazwę lub listę rozdzielaną przecinkami (np. ModelA, ModelB). Wymagane, gdy parametr --package-type to erp.

--outputDirectory -o

Katalog wyjściowy

--package-name

Ustawia domyślną nazwę pakietu. Dotyczy generowania polecenia ImportExtension.GetNameOfImport.

--package-type -pt

Typ projektu pakietu do szkieletu. Dozwolone wartości: dataverse, erp (wersja zapoznawcza). Ustawienie domyślne: dataverse.

--publisher -pub

(Wersja zapoznawcza) Publisher nazwa zapisana w deskryptorze modelu. Domyślnie: Microsoft.

--source-root -sr

(Wersja zapoznawcza) Źródłowa ścieżka główna (względna do katalogu wyjściowego), w której będą żyć modele. Wartość domyślna: ./src.

pac package show

Pokazuje szczegóły pakietu Dataverse

Uwaga / Notatka

To polecenie jest dostępne tylko dla wersji platformy .NET Full Framework interfejsu wiersza polecenia PAC.

Example

pac package show c:\samplepackage.dll

Wymagane parametry dla package show

--package -p

Ścieżka do pliku dll pakietu lub pliku zip z pakietem.

Parametry opcjonalne dla package show

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--logFile -lf

Ścieżka pliku dziennika

--verbose -vdbg

Emituj pełne dzienniki do danych wyjściowych dziennika.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

Zobacz także

Grupy poleceń interfejsu wiersza polecenia platformy Microsoft Power Platform
Omówienie interfejsu wiersza polecenia platformy Microsoft Power Platform