pac package

Команды для работы с проектами пакетов Dataverse.

Commands

Command	Description
pac package add-external-package	Добавляет пакет, который является внешним в системе решения Dataverse, в проект пакета развертывания пакетов.
pac package add-reference	Добавляет ссылку на проект решения Dataverse
pac package add-solution	Добавляет предварительно созданный файл решения Dataverse в проект пакета развертывания пакетов.
pac package compile	(предварительная версия) Компилирует пакет. При использовании erp типа --package компилирует модели X++ с помощью xppc.exe из установленного пакета SDK и создает развернутый ZIP-файл для каждой модели.
pac package db-sync	(предварительная версия) Синхронизирует базу данных приложения Finance and Operations с 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

Example

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

(предварительная версия) Компилирует пакет. При использовании erp типа --package компилирует модели 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-файл модели. Записано в <имя модели>/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

(предварительная версия) Синхронизирует базу данных приложения Finance and Operations с Dataverse.

Необязательные параметры для package db-sync

--argument-file -af

(предварительная версия) Путь к JSON-файлу, соответствующий контракту IncrementalSyncParameters (или ModuleSyncParameters). Требуется для добавочного инкрементного --db-sync.

--db-sync -ds

Режим синхронизации базы данных. Допустимые значения: Full, Module, Incremental. Значение по умолчанию: full.

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--modules -m

(предварительная версия) Разделенный запятыми список имен модулей для синхронизации. Требуется, когда —-db-sync — Module.

pac package deploy

Развертывание пакета в Dataverse

Замечание

Эта команда доступна только для версии .NET Full Framework интерфейса командной строки PAC.

Example

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

Необязательные параметры для package deploy

--argument-file -af

(предварительная версия) Путь к JSON-файлу, соответствующий контракту IncrementalSyncParameters (или ModuleSyncParameters). Требуется для добавочного инкрементного --db-sync.

--build-type -bt

(предварительная версия) Как применяется пакет. Допустимые значения: Full, Incremental, Delete. Значение по умолчанию: full. Используется с типом --package-type erp.

--db-sync -ds

(предварительная версия) Режим синхронизации базы данных для запуска после развертывания. Допустимые значения: None, Full, Module, Incremental. Значение по умолчанию: нет. Используется с типом --package-type erp.

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--logConsole -c

Выходной журнал в консоль

Этот параметр не требует значения. Это переключатель.

--logFile -lf

Путь к файлу журнала

--modules -m

(предварительная версия) Разделенный запятыми список имен модулей для синхронизации. Требуется, когда —-db-sync — Module.

--outputDirectory -o

(предварительная версия) Только в режиме решения: корневая папка, содержащая .erp/xpp.json. По умолчанию отображается текущий каталог. Если пакет --package опущен в формате erp типа --package, все модели, перечисленные в .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 опущен в формате erp типа --package, все модели, перечисленные в .erp/xpp.json, развертываются в порядке зависимостей.

--verbose -vdbg

Вывод подробных журналов в выходные данные журнала.

Этот параметр не требует значения. Это переключатель.

Замечания

Вы можете использовать оба logFile параметра и logConsole параметры вместе, либо использовать один или другой параметр.

pac package init

Инициализирует каталог с помощью нового проекта пакета Dataverse

Example

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-is 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.

Example

pac package show c:\samplepackage.dll

Обязательные параметры для package show

--package -p

Путь к dll-файлу пакета или ZIP-файлу с пакетом.

Необязательные параметры для package show

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--logFile -lf

Путь к файлу журнала

--verbose -vdbg

Вывод подробных журналов в выходные данные журнала.

Этот параметр не требует значения. Это переключатель.

См. также

Группы команд Командной строки Microsoft Power Platform
Обзор интерфейса командной строки Microsoft Power Platform