pac package

Komandos, skirtos darbui su "Dataverse" paketo projektais.

Komandas

Komanda	Apibūdinimas
pac package add-external-package	Į "Package Deployer Package" projektą įtraukiamas paketas, kuris yra išorinis "Dataverse" sprendimo sistemai.
pac package add-reference	Įtraukia nuorodą į "Dataverse" sprendimo projektą
pac package add-solution	Įtraukia iš anksto nustatytą "Dataverse" sprendimo failą į "Package Deployer Package" projektą.
pac package compile	(Peržiūra) Kompiliuoja paketą. Naudojant --package-type erp, kompiliuojami X++ modeliai naudojant xppc.exe iš įdiegto SDK ir sukuria diegiamą ZIP kiekvienam modeliui.
pac package db-sync	(Peržiūra) Sinchronizuoja "Finance and Operations" programos duomenų bazę su "Dataverse".
pac package deploy	Diegia paketą "Dataverse"
pac package init	Inicijuoja katalogą su nauju "Dataverse" paketo projektu
pac package show	Rodoma "Dataverse" paketo išsami informacija

pac package add-external-package

Į "Package Deployer Package" projektą įtraukiamas paketas, kuris yra išorinis "Dataverse" sprendimo sistemai.

Būtini parametrai package add-external-package

--package-type -t

Įtraukiamo paketo tipas. Pvz.: "xpp" FnO paketams.

--path -p

Išorinio paketo kelias

Pasirinktiniai parametrai, skirti package add-external-package

--import-order

Sveikasis skaičius, nurodantis šio elemento įterpimo į galutinį ImportConfig.xml failą kūrimo metu tvarką. Neigiami skaičiai įterpiami prieš esamus elementus. Teigiami skaičiai pridedami po esamų elementų.

--skip-validation -sv

Įtraukia elementą į projekto failą, net jei failo nėra arba jis netinkamas. Pastaba: tai neturi įtakos "MSBuild" atliktai patikrai.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

pac package add-reference

Įtraukia nuorodą į "Dataverse" sprendimo projektą

Pavyzdžiui

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

Būtini parametrai package add-reference

--path -p

Kelias į nurodomą "Dataverse" sprendimo projektą

Pasirinktiniai parametrai, skirti package add-reference

--dependency-overrides

Kabliataškiais atskirtų nepaisymo sąrašas. Ši reikšmė perrašo bet kokią priklausomybės informaciją, užkoduotą sprendimo metaduomenyse. Kiekvienas nepaisymas turėtų būti šio formato: <uniquename>:<minVersion>:<maxVersion>. Kur minVersion ir maxVersion yra pasirinktiniai, bet turi būti .NET versijos formato sintaksė.

Pastaba: naudokite kabliataškiais atskirtą priklausomybės nepaisymo sąrašą, kurio formatas <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Aiškiai nurodo reikalingą režimą importuojant šį sprendimą.

Naudokite vieną iš šių reikšmių:

• sync
• async

--import-order

Sveikasis skaičius, nurodantis šio elemento įterpimo į galutinį ImportConfig.xml failą kūrimo metu tvarką. Neigiami skaičiai įterpiami prieš esamus elementus. Teigiami skaičiai pridedami po esamų elementų.

--missing-dependency-behavior

Nurodo importavimo veikimą, kai paskirties aplinkoje trūksta šio sprendimo priklausomybės.

Naudokite vieną iš šių reikšmių:

• skip
• fault

--overwrite-unmanaged-customizations

Aiškiai nurodoma, ar perrašyti nevaldomus tinkinimus, kai importuojamas šis sprendimas.

Naudokite vieną iš šių reikšmių:

• true
• false

--publish-workflows-activate-plugins

Aiškiai nurodoma, ar publikuoti darbo eigas ir aktyvinti priedus, kai importuojamas šis sprendimas.

Naudokite vieną iš šių reikšmių:

• true
• false

pac package add-solution

Įtraukia iš anksto nustatytą "Dataverse" sprendimo failą į "Package Deployer Package" projektą.

Būtini parametrai package add-solution

--path -p

Kelias į "Dataverse" sprendimo failą. Failas turi būti suglaudintas ZIP failas.

Pasirinktiniai parametrai, skirti package add-solution

--dependency-overrides

Kabliataškiais atskirtų nepaisymo sąrašas. Ši reikšmė perrašo bet kokią priklausomybės informaciją, užkoduotą sprendimo metaduomenyse. Kiekvienas nepaisymas turėtų būti šio formato: <uniquename>:<minVersion>:<maxVersion>. Kur minVersion ir maxVersion yra pasirinktiniai, bet turi būti .NET versijos formato sintaksė.

Pastaba: naudokite kabliataškiais atskirtą priklausomybės nepaisymo sąrašą, kurio formatas <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Aiškiai nurodo reikalingą režimą importuojant šį sprendimą.

Naudokite vieną iš šių reikšmių:

• sync
• async

--import-order

Sveikasis skaičius, nurodantis šio elemento įterpimo į galutinį ImportConfig.xml failą kūrimo metu tvarką. Neigiami skaičiai įterpiami prieš esamus elementus. Teigiami skaičiai pridedami po esamų elementų.

--missing-dependency-behavior

Nurodo importavimo veikimą, kai paskirties aplinkoje trūksta šio sprendimo priklausomybės.

Naudokite vieną iš šių reikšmių:

• skip
• fault

--overwrite-unmanaged-customizations

Aiškiai nurodoma, ar perrašyti nevaldomus tinkinimus, kai importuojamas šis sprendimas.

Naudokite vieną iš šių reikšmių:

• true
• false

--publish-workflows-activate-plugins

Aiškiai nurodoma, ar publikuoti darbo eigas ir aktyvinti priedus, kai importuojamas šis sprendimas.

Naudokite vieną iš šių reikšmių:

• true
• false

--skip-validation -sv

Įtraukia elementą į projekto failą, net jei failo nėra arba jis netinkamas. Pastaba: tai neturi įtakos "MSBuild" atliktai patikrai.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

pac package compile

(Peržiūra) Kompiliuoja paketą. Naudojant --package-type erp, kompiliuojami X++ modeliai naudojant xppc.exe iš įdiegto SDK ir sukuria diegiamą ZIP kiekvienam modeliui.

Būtini parametrai package compile

--package-type -pt

Tikslinė diegimo platforma. Leistinos reikšmės: dataverse, erp (Preview). Numatytoji reikšmė: "dataverse".

Pasirinktiniai parametrai, skirti package compile

--app-version -av

SDK F&O programos keturių dalių versija, pagal kurią galima kompiliuoti (pvz., 10.0.2588.0). Kai jis praleidžiamas, naudojamas aktyvioje aplinkoje užregistruotas SDK.

--incremental

Kompiliuoti tik pakeistus artefaktus (eina -incremental į xppc).

Šiam parametrui nereikia reikšmės. Tai jungiklis.

--language -lang

Kableliais atskirtų lokalių sąrašas, skirtas sukompiliuoti etiketes (pvz., en-US arba en-US, fr,de). Jei neįtraukta, "LabelC" sukuria kiekvieną lokalę, rastą šaltinyje – atitinka Visual Studio numatytąjį komponavimo versijų modelių veikimą. Paveikia tik etikečių etapą; xppc + best-practices + paketas veikia vieną kartą per bendrą išvestį.

--license-file -lf

Kelias į ISV licencijos failą, kad būtų galima švirkšti į kiekvieną pagamintą modelio ZIP. Parašyta model<>/bin/<filename> viduje ZIP.

--model -m

Kompiliuoti norimo (-ų) modelio (-ių) pavadinimas (-ai). Priima vieną vardą arba kableliais atskirtą sąrašą. Kai jis praleidžiamas, kompiliuojami visi .erp/xpp.json išvardyti modeliai.

--output

Katalogas, kuriame bus parašyti diegiami ZIP. Numatytoji reikšmė: <repoRoot>/bin.

--outputDirectory -o

Išvesties katalogas

--skip-bp

Praleiskite geriausių praktikų patikros veiksmą. Pagal numatytuosius nustatymus kompiliavimo srauto paleidimo žymos –> X++ –> geriausios praktikos.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

--solution-root -sr

X++ sprendimo šakninis aplankas (jame yra .erp/xpp.json). Numatytoji dabartinio katalogo reikšmė.

pac package db-sync

(Peržiūra) Sinchronizuoja "Finance and Operations" programos duomenų bazę su "Dataverse".

Pasirinktiniai parametrai, skirti package db-sync

--argument-file -af

(Peržiūra) Kelias į JSON failą, atitinkantį IncrementalSyncParameters (arba ModuleSyncParameters) sutartį. Būtina --db-sync incremental.

--db-sync -ds

Duomenų bazės sinchronizavimo režimas. Leistinos reikšmės: Visas, Modulis, Papildantysis. Numatytoji reikšmė: Visas.

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--modules -m

(Peržiūra) Kableliais atskirtų sinchronizuotų modulių pavadinimų sąrašas. Būtina, kai --db-sync yra Modulis.

pac package deploy

Diegia paketą "Dataverse"

Pastaba.

Ši komanda galima tik PAC CLI ".NET Full Framework" versijai.

Pavyzdžiui

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

Pasirinktiniai parametrai, skirti package deploy

--argument-file -af

(Peržiūra) Kelias į JSON failą, atitinkantį IncrementalSyncParameters (arba ModuleSyncParameters) sutartį. Būtina --db-sync incremental.

--build-type -bt

(Peržiūra) Kaip taikomas paketas. Leistinos reikšmės: Visas, Papildantysis, Naikinti. Numatytoji reikšmė: Visas. Naudojamas su --package-type erp.

--db-sync -ds

(Peržiūra) Įdiegus paleidžiamas duomenų bazės sinchronizavimo režimas. Leistinos reikšmės: None, Full, Module, Incremental. Numatytoji reikšmė: Nėra. Naudojamas su --package-type erp.

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--logConsole -c

Išvesties žurnalas konsolėje

Šiam parametrui nereikia reikšmės. Tai jungiklis.

--logFile -lf

Žurnalo failo kelias

--modules -m

(Peržiūra) Kableliais atskirtų sinchronizuotų modulių pavadinimų sąrašas. Būtina, kai --db-sync yra Modulis.

--outputDirectory -o

(Peržiūra) Tik sprendimo režimas: šakninis aplankas, kuriame yra .erp/xpp.json. Numatytoji dabartinio katalogo reikšmė. Kai --package praleidžiamas dalyje --package-type erp, visi modeliai, išvardyti .erp/xpp.json, diegiami priklausomybės tvarka.

--package -p

Kelias į paketo dll arba zip failą su paketu.

--package-type -pt

Tikslinė diegimo platforma. Leistinos reikšmės: dataverse, erp (Preview). Numatytoji reikšmė: "dataverse".

--release-type -rt

(Peržiūra) Paketo klasifikacija. Leistinos reikšmės: "Dev", "Release". Numatytoji reikšmė: nuokr. Leidimų paketai priverstinai sinchronizuoja visą duomenų bazę serveryje. Naudojamas su --package-type erp.

--settings -s

Vykdyklės paketo parametrai, perduoti į diegiamą paketą. Eilutės formatas turi būti key=value|key=value.

Pastaba: eilutės formatas turi būti key=value|key=value.

--solution -sz

Kelias į "Dataverse" sprendimo failą. Failas turi būti suglaudintas ZIP arba CAB failas.

--solution-root -sr

(Peržiūra) Tik sprendimo režimas: šakninis aplankas, kuriame yra .erp/xpp.json. Numatytoji dabartinio katalogo reikšmė. Kai --package praleidžiamas dalyje --package-type erp, visi modeliai, išvardyti .erp/xpp.json, diegiami priklausomybės tvarka.

--verbose -vdbg

Į žurnalo išvestis įvesdami daugiažodžius žurnalus.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

Pastabos

Galite naudoti abu logFile parametrus ir logConsole kartu arba naudoti vieną ar kitą parametrą.

pac package init

Inicijuoja katalogą su nauju "Dataverse" paketo projektu

Pavyzdžiui

pac package init --outputdirectory c:\samplepackage

Pasirinktiniai parametrai, skirti package init

--layer -l

(Peržiūra) X++ sluoksnis. Leistinos reikšmės: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Numatytoji reikšmė: ISV.

--model -m

(Peržiūra) X++ modelio (-ių), kurį (-iuos) norite kurti, pavadinimas (-ai). Priima vieną vardą arba kableliais atskirtą sąrašą (pvz., ModelisA, ModelisB). Būtina, kai --package-type yra erp.

--outputDirectory -o

Išvesties katalogas

--package-name

Nustato numatytąjį paketo pavadinimą. Taikoma "ImportExtension.GetNameOfImport" generavimui.

--package-type -pt

Kurtinų paketo projekto tipas. Leistinos reikšmės: dataverse, erp (Preview). Numatytoji reikšmė: "dataverse".

--publisher -pub

(Peržiūra) Publisher pavadinimą, parašytą modelio apraše. Numatytoji reikšmė: „Microsoft“.

--source-root -sr

(Peržiūra) Šaltinio šakninis kelias (susijęs su išvesties katalogu), kur veiks modeliai. Numatytoji reikšmė: ./src.

pac package show

Rodoma "Dataverse" paketo išsami informacija

Pastaba.

Ši komanda galima tik PAC CLI ".NET Full Framework" versijai.

Pavyzdžiui

pac package show c:\samplepackage.dll

Būtini parametrai package show

--package -p

Kelias į paketo dll arba zip failą su paketu.

Pasirinktiniai parametrai, skirti package show

--environment -env

Nurodo tikslinį "Dataverse". Reikšmė gali būti GUID arba absoliutus https URL. Jei nenurodyta, bus naudojama aktyvi organizacija, pasirinkta dabartiniam autentifikavimo profiliui.

--logFile -lf

Žurnalo failo kelias

--verbose -vdbg

Į žurnalo išvestis įvesdami daugiažodžius žurnalus.

Šiam parametrui nereikia reikšmės. Tai jungiklis.

Taip pat žr.

"Microsoft Power Platform" CLI komandų grupės
"Microsoft Power Platform" CLI apžvalga