pac package

Команди за работа с проекти на пакети Dataverse.

Команди

Command	Описание
pac package add-external-package	Добавя пакет, който е външен за системата за решения Dataverse, към проект на пакет за разполагане на пакети.
pac package add-reference	Добавя препратка към проект на решение на Dataverse
pac package add-solution	Добавя предварително сглобяем файл с решение dataverse към проект на пакет за разполагане на пакет.
pac package compile	(Предварителен преглед) Съставя пакет. С --package-type erp компилира X++ модели, като използва xppc.exe от инсталирания SDK и създава разположим ZIP за модел.
pac package db-sync	(Предварителен преглед) Синхронизира приложната база данни "Финанси и операции" с Dataverse.
pac package deploy	Разполага пакета в Dataverse
pac package init	Инициализира указател с нов проект на пакет dataverse
pac package show	Показва подробни данни за пакета Dataverse

pac package add-external-package

Добавя пакет, който е външен за системата за решения Dataverse, към проект на пакет за разполагане на пакети.

Задължителни параметри за package add-external-package

--package-type -t

Типът на добавения пакет. Например: "xpp" за FnO пакети.

--path -p

Път до външния пакет

Незадължителни параметри за package add-external-package

--import-order

Цяло число, което показва реда за вмъкване на този елемент в крайния ImportConfig.xml файл по време на компилацията. Отрицателните числа се вмъкват преди съществуващите елементи. След съществуващи елементи се добавят положителни числа.

--skip-validation -sv

Добавя елемента към файла на проекта дори ако файлът не съществува или изглежда невалиден. Забележка: Използването на това не засяга никоя проверка, извършвана от MSBuild.

Този параметър не изисква стойност. Това е превключвател.

pac package add-reference

Добавя препратка към проект на решение на Dataverse

Пример

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

Задължителни параметри за package add-reference

--path -p

Пътят до адресирания проект за решение на Dataverse

Незадължителни параметри за package add-reference

--dependency-overrides

Списък с разделители точка и запетая от замествания. Тази стойност замества всяка информация за зависимости, кодирана в метаданните на решението. Всяко заместване трябва да бъде във формат: <uniquename>:<minVersion>:<maxVersion>. Където minVersion и maxVersion са незадължителни, но трябва да са в синтаксис на версията на .NET.

Забележка: Използвайте списък с разделители точка и запетая на замествания на зависимости на формата <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Задава явно необходимия режим при импортиране на това решение.

Използвайте една от следните стойности:

• sync
• async

--import-order

Цяло число, което показва реда за вмъкване на този елемент в крайния ImportConfig.xml файл по време на компилацията. Отрицателните числа се вмъкват преди съществуващите елементи. След съществуващи елементи се добавят положителни числа.

--missing-dependency-behavior

Задава поведението при импортиране, когато липсва зависимост на това решение от целевата среда.

Използвайте една от следните стойности:

• skip
• fault

--overwrite-unmanaged-customizations

Показва изрично дали да се презапишат неуправлявани персонализации, когато това решение се импортира.

Използвайте една от следните стойности:

• true
• false

--publish-workflows-activate-plugins

Показва изрично дали да публикувате работните потоци и да активирате добавките, когато това решение се импортира.

Използвайте една от следните стойности:

• true
• false

pac package add-solution

Добавя предварително сглобяем файл с решение dataverse към проект на пакет за разполагане на пакет.

Задължителни параметри за package add-solution

--path -p

Път до файла на решението на Dataverse. Файлът трябва да бъде компресиран ZIP файл.

Незадължителни параметри за package add-solution

--dependency-overrides

Списък с разделители точка и запетая от замествания. Тази стойност замества всяка информация за зависимости, кодирана в метаданните на решението. Всяко заместване трябва да бъде във формат: <uniquename>:<minVersion>:<maxVersion>. Където minVersion и maxVersion са незадължителни, но трябва да са в синтаксис на версията на .NET.

Забележка: Използвайте списък с разделители точка и запетая на замествания на зависимости на формата <uniquename>:<minVersion>:<maxVersion>.

--import-mode

Задава явно необходимия режим при импортиране на това решение.

Използвайте една от следните стойности:

• sync
• async

--import-order

Цяло число, което показва реда за вмъкване на този елемент в крайния ImportConfig.xml файл по време на компилацията. Отрицателните числа се вмъкват преди съществуващите елементи. След съществуващи елементи се добавят положителни числа.

--missing-dependency-behavior

Задава поведението при импортиране, когато липсва зависимост на това решение от целевата среда.

Използвайте една от следните стойности:

• skip
• fault

--overwrite-unmanaged-customizations

Показва изрично дали да се презапишат неуправлявани персонализации, когато това решение се импортира.

Използвайте една от следните стойности:

• true
• false

--publish-workflows-activate-plugins

Показва изрично дали да публикувате работните потоци и да активирате добавките, когато това решение се импортира.

Използвайте една от следните стойности:

• true
• false

--skip-validation -sv

Добавя елемента към файла на проекта дори ако файлът не съществува или изглежда невалиден. Забележка: Използването на това не засяга никоя проверка, извършвана от MSBuild.

Този параметър не изисква стойност. Това е превключвател.

pac package compile

(Предварителен преглед) Съставя пакет. С --package-type erp компилира X++ модели, като използва xppc.exe от инсталирания SDK и създава разположим ZIP за модел.

Задължителни параметри за package compile

--package-type -pt

Целева платформа за разполагане. Разрешени стойности: dataverse, erp (предварителен преглед). По подразбиране: dataverse.

Незадължителни параметри за package compile

--app-version -av

Версия на F&O приложение от четири части на SDK за компилиране (например 10.0.2588.0). Когато се пропусне, се използва SDK, регистриран за активната среда.

--incremental

Компилиране само на променени артефакти (преминава -incremental към xppc).

Този параметър не изисква стойност. Това е превключвател.

--language -lang

Разделен със запетаи списък с езиково-географски променливи за съставяне на етикети (например en-US или en-US,fr,de). Когато липсва, LabelC изгражда всяка езиково-географска променлива, намерена в източника – съответства на поведението на моделите на компилации по подразбиране на Visual Studio. Засяга само етапа на етикетите; xppc + най-добри практики + пакет се изпълнява веднъж върху комбинираната продукция.

--license-file -lf

Път към ISV лиценз файл, за да се инжектира във всеки произвеждан модел ZIP. Написано в <Model>/bin/<filename> вътре в ZIP файла.

--model -m

Имена на модели за компилиране. Приема едно име или списък, разделен със запетая. Когато се пропусне, се компилират всички модели, изброени в .erp/xpp.json.

--output

Указател, където ще бъдат написани разположимите ZIP. По подразбиране: <repoRoot>/bin.

--outputDirectory -o

Изходна директория

--skip-bp

Пропуснете стъпката за проверка на най-добрите практики. По подразбиране конвейерът за компилиране изпълнява етикети –> X++ –> най-добри практики.

Този параметър не изисква стойност. Това е превключвател.

--solution-root -sr

Главна папка на решението X++ (съдържа .erp/xpp.json). По подразбиране е текущата директория.

pac package db-sync

(Предварителен преглед) Синхронизира приложната база данни "Финанси и операции" с Dataverse.

Незадължителни параметри за package db-sync

--argument-file -af

(Предварителен преглед) Път до JSON файл, съответстващ на договора IncrementalSyncParameters (или ModuleSyncParameters). Задължително за --db-sync Постъпково.

--db-sync -ds

Режим на синхронизиране на база данни. Разрешени стойности: Пълни, Модул, Постъпково. По подразбиране: Пълно.

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--modules -m

(Предварителен преглед) Разделен със запетаи списък с имена на модули за синхронизиране. Задължително, когато --db-sync е Module.

pac package deploy

Разполага пакета в Dataverse

Бележка

Тази команда е налична само за версията на .NET Full Framework на PAC CLI.

Пример

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

Незадължителни параметри за package deploy

--argument-file -af

(Предварителен преглед) Път до JSON файл, съответстващ на договора IncrementalSyncParameters (или ModuleSyncParameters). Задължително за --db-sync Постъпково.

--build-type -bt

(Предварителен преглед) Как се прилага пакетът. Разрешени стойности: Пълни, Постъпково, Изтриване. По подразбиране: Пълно. Използва се с --package-type erp.

--db-sync -ds

(Предварителен преглед) Режим на синхронизиране на база данни, който да се изпълнява след разполагане. Разрешени стойности: Няма, Пълни, Модул, Постъпково. По подразбиране: Няма. Използва се с --package-type erp.

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--logConsole -c

Изходен регистрационен файл към конзолата

Този параметър не изисква стойност. Това е превключвател.

--logFile -lf

Път до регистрационния файл

--modules -m

(Предварителен преглед) Разделен със запетаи списък с имена на модули за синхронизиране. Задължително, когато --db-sync е Module.

--outputDirectory -o

(Предварителен преглед) Само режим на решение: главна папка, съдържаща .erp/xpp.json. По подразбиране е текущата директория. Когато --package е пропуснато под --package-type erp, всички модели, изброени в .erp/xpp.json са разположени в ред на зависимост.

--package -p

Път до dll или zip файл на пакет.

--package-type -pt

Целева платформа за разполагане. Разрешени стойности: dataverse, erp (предварителен преглед). По подразбиране: dataverse.

--release-type -rt

(Предварителен преглед) Класификация на пакетите. Разрешени стойности: Dev, Release. По подразбиране: Откл. Пакетите за издаване принуждават пълно синхронизиране на базата данни на сървъра. Използва се с --package-type erp.

--settings -s

Настройки на пакета по време на изпълнение, които се предават към пакета, който се разполага. Форматът на низа трябва да бъде key=value|key=value.

Забележка: Форматът на низа трябва да бъде key=value|key=value.

--solution -sz

Път до файла на решението на Dataverse. Файлът трябва да бъде компресиран ZIP или CAB файл.

--solution-root -sr

(Предварителен преглед) Само режим на решение: главна папка, съдържаща .erp/xpp.json. По подразбиране е текущата директория. Когато --package е пропуснато под --package-type erp, всички модели, изброени в .erp/xpp.json са разположени в ред на зависимост.

--verbose -vdbg

Излъчват многословни регистрационни файлове в изходите от регистрационния файл.

Този параметър не изисква стойност. Това е превключвател.

Забележки

Можете да използвате и двата logFile параметъра заедно logConsole или един параметър или друг.

pac package init

Инициализира указател с нов проект на пакет dataverse

Пример

pac package init --outputdirectory c:\samplepackage

Незадължителни параметри за package init

--layer -l

(Предварителен преглед) X++ слой. Разрешени стойности: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. По подразбиране: ISV.

--model -m

(Предварителен преглед) Име(на) на X++ модела(ите) на скеле. Приема едно име или списък, разделен със запетая (напр. ModelA,ModelB). Задължително, когато --package-type е erp.

--outputDirectory -o

Изходна директория

--package-name

Задава името по подразбиране на пакета. Отнася се за генерирането на ImportExtension.GetNameOfImport.

--package-type -pt

Тип проект на пакет за скеле. Разрешени стойности: dataverse, erp (предварителен преглед). По подразбиране: dataverse.

--publisher -pub

(Предварителен преглед) Publisher име, написано в дескриптора на модела. По подразбиране: Microsoft.

--source-root -sr

(Предварителен преглед) Главен път до източника (спрямо изходната директория), където ще се живеят модели. По подразбиране: ./src.

pac package show

Показва подробни данни за пакета Dataverse

Бележка

Тази команда е налична само за версията на .NET Full Framework на PAC CLI.

Пример

pac package show c:\samplepackage.dll

Задължителни параметри за package show

--package -p

Път до dll или zip файл на пакет.

Незадължителни параметри за package show

--environment -env

Указва целевия Dataverse. Стойността може да бъде GUID или абсолютен HTTPS URL адрес. Когато не е зададена, ще се използва активната организация, избрана за текущия профил за удостоверяване.

--logFile -lf

Път до регистрационния файл

--verbose -vdbg

Излъчват многословни регистрационни файлове в изходите от регистрационния файл.

Този параметър не изисква стойност. Това е превключвател.

Вижте също

CLI командни групи на Microsoft Power Platform
Общ преглед на CLI за Microsoft Power Platform