pac package

Príkazy na prácu s projektmi balíkov Dataverse.

Príkazy

Command	Description
pac package add-external-package	Pridá balík, ktorý je pre systém riešenia Dataverse externý do projektu Package Deployer Package.
pac package add-reference	Pridanie odkazu na projekt riešenia Dataverse
pac package add-solution	Pridá vopred vytvorený súbor riešenia Dataverse do projektu Package Deployer Package.
pac package compile	(Ukážka) Kompiluje balík. S rozhraním typu --package-type erp kompiluje modely X++ pomocou xppc.exe z nainštalovanej súpravy SDK a vytvorí nasaditeľný zip na model.
pac package db-sync	(Ukážka) Synchronizuje databázu aplikácie Finance and Operations s funkciou Dataverse.
pac package deploy	Nasadenie balíka do služby Dataverse
pac package init	Inicializuje adresár s novým projektom balíka Dataverse
pac package show	Zobrazenie podrobností o balíku Dataverse

pac package add-external-package

Pridá balík, ktorý je pre systém riešenia Dataverse externý do projektu Package Deployer Package.

Povinné parametre pre package add-external-package

--package-type -t

Typ balíka, ktorý sa pridáva. Napríklad: "xpp" pre balíky FnO.

--path -p

Cesta k externému balíku

Voliteľné parametre pre package add-external-package

--import-order

Celé číslo určujú ktoré poradie vloží túto položku do konečného ImportConfig.xml súboru v čase zostavenia. Záporné čísla sa vložia pred existujúce prvky. Kladné čísla sa pridajú po existujúcich prvkoch.

--skip-validation -sv

Pridá položku do súboru projektu aj vtedy, ak súbor neexistuje alebo sa javí ako neplatný. Poznámka: Použitie tohto postupu neovplyvňuje žiadne overenie vykonané službou MSBuild.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

pac package add-reference

Pridanie odkazu na projekt riešenia Dataverse

Príklad

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

Povinné parametre pre package add-reference

--path -p

Cesta k odkazovanému projektu riešenia Dataverse

Voliteľné parametre pre package add-reference

--dependency-overrides

Zoznam prepísania s oddeľovačmi bodkočiarky. Táto hodnota prepíše všetky informácie o závislostiach kódované v metaúdajoch riešenia. Každé prepísanie by malo byť vo formáte: <uniquename>:<minVersion>:<maxVersion>. Tam, kde sú minVersion a maxVersion voliteľné, ale mali by byť vo formáte verzie .NET.

Poznámka: Použite zoznam s oddeľovačmi bodkočiarky prepísania závislostí vo formáte <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Explicitne určuje požadovaný režim pri importovaní tohto riešenia.

Použite jednu z týchto hodnôt:

• sync
• async

--import-order

Celé číslo určujú ktoré poradie vloží túto položku do konečného ImportConfig.xml súboru v čase zostavenia. Záporné čísla sa vložia pred existujúce prvky. Kladné čísla sa pridajú po existujúcich prvkoch.

--missing-dependency-behavior

Určuje správanie pri importe, keď v cieľovom prostredí chýba závislosť tohto riešenia.

Použite jednu z týchto hodnôt:

• skip
• fault

--overwrite-unmanaged-customizations

Explicitne udáva, či sa majú prepísať nespravované prispôsobenia pri importovaní tohto riešenia.

Použite jednu z týchto hodnôt:

• true
• false

--publish-workflows-activate-plugins

Explicitne udáva, či sa majú pracovné postupy publikovať a aktivovať doplnky pri importovaní tohto riešenia.

Použite jednu z týchto hodnôt:

• true
• false

pac package add-solution

Pridá vopred vytvorený súbor riešenia Dataverse do projektu Package Deployer Package.

Povinné parametre pre package add-solution

--path -p

Cesta k súboru riešenia Dataverse. Súbor musí byť komprimovaný.

Voliteľné parametre pre package add-solution

--dependency-overrides

Zoznam prepísania s oddeľovačmi bodkočiarky. Táto hodnota prepíše všetky informácie o závislostiach kódované v metaúdajoch riešenia. Každé prepísanie by malo byť vo formáte: <uniquename>:<minVersion>:<maxVersion>. Tam, kde sú minVersion a maxVersion voliteľné, ale mali by byť vo formáte verzie .NET.

Poznámka: Použite zoznam s oddeľovačmi bodkočiarky prepísania závislostí vo formáte <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Explicitne určuje požadovaný režim pri importovaní tohto riešenia.

Použite jednu z týchto hodnôt:

• sync
• async

--import-order

Celé číslo určujú ktoré poradie vloží túto položku do konečného ImportConfig.xml súboru v čase zostavenia. Záporné čísla sa vložia pred existujúce prvky. Kladné čísla sa pridajú po existujúcich prvkoch.

--missing-dependency-behavior

Určuje správanie pri importe, keď v cieľovom prostredí chýba závislosť tohto riešenia.

Použite jednu z týchto hodnôt:

• skip
• fault

--overwrite-unmanaged-customizations

Explicitne udáva, či sa majú prepísať nespravované prispôsobenia pri importovaní tohto riešenia.

Použite jednu z týchto hodnôt:

• true
• false

--publish-workflows-activate-plugins

Explicitne udáva, či sa majú pracovné postupy publikovať a aktivovať doplnky pri importovaní tohto riešenia.

Použite jednu z týchto hodnôt:

• true
• false

--skip-validation -sv

Pridá položku do súboru projektu aj vtedy, ak súbor neexistuje alebo sa javí ako neplatný. Poznámka: Použitie tohto postupu neovplyvňuje žiadne overenie vykonané službou MSBuild.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

pac package compile

(Ukážka) Kompiluje balík. S rozhraním typu --package-type erp kompiluje modely X++ pomocou xppc.exe z nainštalovanej súpravy SDK a vytvorí nasaditeľný zip na model.

Povinné parametre pre package compile

--package-type -pt

Cieľová platforma na nasadenie. Povolené hodnoty: dataverse, erp (Ukážka). Predvolená hodnota: dataverse.

Voliteľné parametre pre package compile

--app-version -av

Štvordielna verzia aplikácie F&O súpravy SDK, ktorá sa má kompilovať (napr. 10.0.2588.0). Ak tento parameter vynecháte, použije sa súprava SDK zaregistrovaná pre aktívne prostredie.

--incremental

Kompilovať iba zmenené artefakty (prechádza -incremental do XPPC).

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--language -lang

Zoznam miestnych nastavení oddelených čiarkou na kompilovanie označení pre (napríklad en-US alebo en-US,fr,de). Ak je táto možnosť vynechaná, labelC vytvorí každé miestne nastavenie nájdené v zdroji – zodpovedá predvolenému správaniu Visual Studio modeloch zostáv. Ovplyvní iba fázu označení. xppc + osvedčené postupy + balenie spustite raz pri kombinovanom výstupe.

--license-file -lf

Cesta k súboru s licenciou nezávislého dodávateľa softvéru na injekciu do každého vyrobeného modelu ZIP. Zapísané do <súboru Model>/priehradka/<názov> súboru v zip.

--model -m

Názvy modelov, ktoré sa majú kompilovať. Akceptuje jeden názov alebo zoznam oddelený čiarkou. Ak je tento parameter vynechaný, všetky modely uvedené v rozhraní .erp/xpp.json sa skompilujú.

--output

Adresár, do ktorého sa zapíšu nasaditeľné ZID. Predvolená hodnota: <repoRoot>/bin.

--outputDirectory -o

Výstupný adresár

--skip-bp

Vynechajte krok kontroly najvhodnejších postupov. V predvolenom nastavení spustí kompilačný kanál označenia –> X++ –> osvedčené postupy.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--solution-root -sr

Koreňový priečinok riešenia X++ (obsahuje .erp/xpp.json). Nastaví sa ako predvolený aktuálny adresár.

pac package db-sync

(Ukážka) Synchronizuje databázu aplikácie Finance and Operations s funkciou Dataverse.

Voliteľné parametre pre package db-sync

--argument-file -af

(Ukážka) Cesta k súboru JSON zodpovedajúcemu zmluve IncrementalSyncParameters (alebo ModuleSyncParameters). Vyžaduje sa pre funkciu --db-sync Incremental.

--db-sync -ds

Režim synchronizácie databázy. Povolené hodnoty: Full (Celé), Module (Modul), Incremental (Prírastkové). Predvolená hodnota: Úplné.

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--modules -m

(Ukážka) Zoznam názvov modulov oddelených čiarkou na synchronizáciu. Pri synchronizácii databázy sa vyžaduje modul .

pac package deploy

Nasadenie balíka do služby Dataverse

Poznámka

Tento príkaz je k dispozícii len pre .NET Full Framework verzie rozhrania PAC CLI.

Príklad

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

Voliteľné parametre pre package deploy

--argument-file -af

(Ukážka) Cesta k súboru JSON zodpovedajúcemu zmluve IncrementalSyncParameters (alebo ModuleSyncParameters). Vyžaduje sa pre funkciu --db-sync Incremental.

--build-type -bt

(Ukážka) Ako sa balík použije. Povolené hodnoty: Full (Úplné), Incremental (Prírastkové), Delete (Odstrániť). Predvolená hodnota: Úplné. Používa sa s rozhraním erp typu --package.

--db-sync -ds

(Ukážka) Režim synchronizácie databázy sa spustí po nasadení. Povolené hodnoty: None ,Full (Žiadne), Full (Plný), Module (Modul), Incremental (Prírastkové). Predvolená hodnota: Žiadne. Používa sa s rozhraním erp typu --package.

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--logConsole -c

Výstupný denník do konzoly

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

--logFile -lf

Cesta k súboru denníka

--modules -m

(Ukážka) Zoznam názvov modulov oddelených čiarkou na synchronizáciu. Pri synchronizácii databázy sa vyžaduje modul .

--outputDirectory -o

(Ukážka) Iba režim riešenia: koreňový priečinok obsahujúci .erp/xpp.json. Nastaví sa ako predvolený aktuálny adresár. Keď sa balík --package vynechá v časti --package-type erp, všetky modely uvedené v tabuľke .erp/xpp.json sa nasadzujú v poradí závislosti.

--package -p

Cesta k balíku dll alebo zip súboru s balíkom.

--package-type -pt

Cieľová platforma na nasadenie. Povolené hodnoty: dataverse, erp (Ukážka). Predvolená hodnota: dataverse.

--release-type -rt

(Ukážka) Klasifikácia balíkov. Povolené hodnoty: Dev, Release. Predvolené: Vývojár. Balíky vydaní vynútia úplnú synchronizáciu databázy na serveri. Používa sa s rozhraním erp typu --package.

--settings -s

Nastavenia balíka runtime, ktoré sa odovzdajú do balíka, ktorý sa práve nasadzuje. Formát reťazca musí byť key=value|key=value.

Poznámka: Formát reťazca musí byť key=value|key=value.

--solution -sz

Cesta k súboru riešenia Dataverse. Súbor musí byť komprimovaný vo formáte ZIP alebo CAB.

--solution-root -sr

(Ukážka) Iba režim riešenia: koreňový priečinok obsahujúci .erp/xpp.json. Nastaví sa ako predvolený aktuálny adresár. Keď sa balík --package vynechá v časti --package-type erp, všetky modely uvedené v tabuľke .erp/xpp.json sa nasadzujú v poradí závislosti.

--verbose -vdbg

Vyžmýkajte podrobné denníky do výstupov denníka.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

Poznámky

Parametre môžete použiť naraz logFilelogConsole , prípadne použiť jeden parameter alebo druhý.

pac package init

Inicializuje adresár s novým projektom balíka Dataverse

Príklad

pac package init --outputdirectory c:\samplepackage

Voliteľné parametre pre package init

--layer -l

(Ukážka) Vrstva X++. Povolené hodnoty: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Predvolená hodnota: ISV.

--model -m

(Ukážka) Názov modelu X++ pre podpornú funkciu. Akceptuje jeden názov alebo zoznam oddelený čiarkou (napríklad ModelA,ModelB). Povinné, keď je typ --package-type erp.

--outputDirectory -o

Výstupný adresár

--package-name

Nastaví predvolený názov balíka. Vzťahuje sa na generovanie importExtension.GetNameOfImport.

--package-type -pt

Typ projektu balíka pre podpornú službu. Povolené hodnoty: dataverse, erp (Ukážka). Predvolená hodnota: dataverse.

--publisher -pub

(Ukážka) Publisher názov zapísaný do popisovača modelu. Predvolená hodnota: Microsoft.

--source-root -sr

(Ukážka) Koreňová cesta zdroja (vzhľadom na výstupný adresár), kde budú modely dynamické. Predvolené: ./src.

pac package show

Zobrazenie podrobností o balíku Dataverse

Poznámka

Tento príkaz je k dispozícii len pre .NET Full Framework verzie rozhrania PAC CLI.

Príklad

pac package show c:\samplepackage.dll

Povinné parametre pre package show

--package -p

Cesta k balíku dll alebo zip súboru s balíkom.

Voliteľné parametre pre package show

--environment -env

Určuje cieľovú hodnotu Dataverse. Hodnotou môže byť identifikátor GUID alebo absolútna URL adresa protokolu https. Ak nie je určené, použije sa aktívna organizácia vybratá pre aktuálny profil overenia.

--logFile -lf

Cesta k súboru denníka

--verbose -vdbg

Vyžmýkajte podrobné denníky do výstupov denníka.

Tento parameter nevyžaduje žiadnu hodnotu. Je to prepínač.

Pozrite tiež

príkazové skupiny rozhrania Microsoft Power Platform CLI
Prehľad rozhrania Microsoft Power Platform CLI