pac package

Các lệnh để làm việc với các dự án gói Dataverse.

Lệnh

Lệnh	Sự miêu tả
pac package add-external-package	Thêm gói bên ngoài hệ thống giải pháp Dataverse vào dự án Gói Triển khai Gói.
pac package add-reference	Thêm tham chiếu đến dự án giải pháp Dataverse
pac package add-solution	Thêm tệp giải pháp Dataverse dựng sẵn vào dự án Gói Triển khai Gói.
pac package compile	(Xem trước) Biên soạn một gói. Với --gói-loại erp, biên dịch X++ mô hình sử dụng xppc.exe từ SDK được cài đặt và tạo ra một ZIP triển khai cho mỗi mô hình.
pac package db-sync	(Xem trước) Đồng bộ hóa cơ sở dữ liệu ứng dụng Tài chính và Vận hành với Dataverse.
pac package deploy	Triển khai gói đến Dataverse
pac package init	Khởi tạo thư mục với dự án gói Dataverse mới
pac package show	Hiển thị chi tiết của gói Dataverse

pac package add-external-package

Thêm gói bên ngoài hệ thống giải pháp Dataverse vào dự án Gói Triển khai Gói.

Tham số Bắt buộc cho package add-external-package

--package-type -t

Loại gói đang được thêm vào. Ví dụ: 'xpp' cho các gói FnO.

--path -p

Đường dẫn đến gói bên ngoài

Tham số Tùy chọn cho package add-external-package

--import-order

Số nguyên cho biết thứ tự chèn mục này vào tệp cuối cùng ImportConfig.xml thời gian dựng. Số âm được chèn vào trước các thành phần hiện có. Số dương được cộng sau các thành phần hiện có.

--skip-validation -sv

Thêm mục vào tệp dự án ngay cả khi tệp không tồn tại hoặc có vẻ như không hợp lệ. Lưu ý: Việc sử dụng tính năng này không ảnh hưởng đến bất kỳ xác thực nào được thực hiện bởi MSBuild.

Tham số này không yêu cầu giá trị. Đó là công tắc.

pac package add-reference

Thêm tham chiếu đến dự án giải pháp Dataverse

Ví dụ:

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

Tham số Bắt buộc cho package add-reference

--path -p

Đường dẫn đến dự án giải pháp Dataverse được tham chiếu

Tham số Tùy chọn cho package add-reference

--dependency-overrides

Danh sách các ghi đè được phân cách bằng dấu chấm phẩy. Giá trị này sẽ ghi đè mọi thông tin phụ thuộc được mã hóa trong siêu dữ liệu của giải pháp. Mỗi ghi đè phải có định dạng: <uniquename>:<minVersion>:<maxVersion>. Trong đó minVersion và maxVersion là tùy chọn nhưng phải có cú pháp định dạng phiên bản .NET.

Lưu ý: Sử dụng danh sách phân cách bằng dấu chấm phẩy gồm các ghi đè phụ thuộc của định <dạng uniquename>:<minVersion>:<maxVersion>.

--import-mode

Xác định rõ chế độ bắt buộc khi nhập giải pháp này.

Sử dụng một trong các giá trị sau:

• sync
• async

--import-order

Số nguyên cho biết thứ tự chèn mục này vào tệp cuối cùng ImportConfig.xml thời gian dựng. Số âm được chèn vào trước các thành phần hiện có. Số dương được cộng sau các thành phần hiện có.

--missing-dependency-behavior

Xác định hành vi khi nhập khi một phụ thuộc của giải pháp này bị thiếu trong môi trường đích.

Sử dụng một trong các giá trị sau:

• skip
• fault

--overwrite-unmanaged-customizations

Rõ ràng cho biết có ghi đè các tùy chỉnh không được quản lý khi nhập giải pháp này hay không.

Sử dụng một trong các giá trị sau:

• true
• false

--publish-workflows-activate-plugins

Rõ ràng cho biết có phát hành dòng công việc và kích hoạt bổ trợ khi nhập giải pháp này hay không.

Sử dụng một trong các giá trị sau:

• true
• false

pac package add-solution

Thêm tệp giải pháp Dataverse dựng sẵn vào dự án Gói Triển khai Gói.

Tham số Bắt buộc cho package add-solution

--path -p

Đường dẫn đến tệp giải pháp Dataverse. Tệp phải là tệp ZIP nén.

Tham số Tùy chọn cho package add-solution

--dependency-overrides

Danh sách các ghi đè được phân cách bằng dấu chấm phẩy. Giá trị này sẽ ghi đè mọi thông tin phụ thuộc được mã hóa trong siêu dữ liệu của giải pháp. Mỗi ghi đè phải có định dạng: <uniquename>:<minVersion>:<maxVersion>. Trong đó minVersion và maxVersion là tùy chọn nhưng phải có cú pháp định dạng phiên bản .NET.

Lưu ý: Sử dụng danh sách phân cách bằng dấu chấm phẩy gồm các ghi đè phụ thuộc của định <dạng uniquename>:<minVersion>:<maxVersion>.

--import-mode

Xác định rõ chế độ bắt buộc khi nhập giải pháp này.

Sử dụng một trong các giá trị sau:

• sync
• async

--import-order

Số nguyên cho biết thứ tự chèn mục này vào tệp cuối cùng ImportConfig.xml thời gian dựng. Số âm được chèn vào trước các thành phần hiện có. Số dương được cộng sau các thành phần hiện có.

--missing-dependency-behavior

Xác định hành vi khi nhập khi một phụ thuộc của giải pháp này bị thiếu trong môi trường đích.

Sử dụng một trong các giá trị sau:

• skip
• fault

--overwrite-unmanaged-customizations

Rõ ràng cho biết có ghi đè các tùy chỉnh không được quản lý khi nhập giải pháp này hay không.

Sử dụng một trong các giá trị sau:

• true
• false

--publish-workflows-activate-plugins

Rõ ràng cho biết có phát hành dòng công việc và kích hoạt bổ trợ khi nhập giải pháp này hay không.

Sử dụng một trong các giá trị sau:

• true
• false

--skip-validation -sv

Thêm mục vào tệp dự án ngay cả khi tệp không tồn tại hoặc có vẻ như không hợp lệ. Lưu ý: Việc sử dụng tính năng này không ảnh hưởng đến bất kỳ xác thực nào được thực hiện bởi MSBuild.

Tham số này không yêu cầu giá trị. Đó là công tắc.

pac package compile

(Xem trước) Biên soạn một gói. Với --gói-loại erp, biên dịch X++ mô hình sử dụng xppc.exe từ SDK được cài đặt và tạo ra một ZIP triển khai cho mỗi mô hình.

Tham số Bắt buộc cho package compile

--package-type -pt

Nền tảng mục tiêu để triển khai. Giá trị được phép: dataverse, erp (Preview). Mặc định: dataverse.

Tham số Tùy chọn cho package compile

--app-version -av

Phiên bản ứng dụng F&O bốn phần của SDK để biên dịch dựa trên (ví dụ: 10.0.2588.0). Khi bỏ qua, SDK đăng ký cho môi trường hoạt động được sử dụng.

--incremental

Biên dịch chỉ thay đổi artifacts (pass -incremental để xppc).

Tham số này không yêu cầu giá trị. Đó là công tắc.

--language -lang

Danh sách bản địa được phân tách bằng dấu phẩy để biên dịch nhãn cho (ví dụ: en-US hoặc en-US,fr,de). Khi bị bỏ qua, LabelC sẽ xây dựng mọi ngôn ngữ có trong nguồn — khớp với hành Visual Studio mô hình Bản dựng mặc định của bạn. Chỉ ảnh hưởng đến giai đoạn nhãn; xppc + cách thực hành tốt nhất + gói chạy một lần trong kết hợp đầu ra.

--license-file -lf

Đường dẫn đến tệp giấy phép ISV để tiêm vào từng ZIP mô hình được sản xuất. Ghi vào <Model>/bin/<filename> bên trong ZIP.

--model -m

Tên mô hình để biên dịch. Chấp nhận một tên đơn hoặc danh sách được phân tách bằng dấu phẩy. Khi bỏ qua, tất cả các mô hình được liệt kê trong .erp /xpp.json được biên soạn.

--output

Thư mục nơi ZIP có thể triển khai sẽ được ghi. Mặc định: <repoRoot>/bin.

--outputDirectory -o

Thư mục đầu ra

--skip-bp

Bỏ qua bước kiểm tra thực hành tốt nhất. Theo mặc định, quy trình biên dịch sẽ chạy nhãn -> X++ - cách thực> hành tốt nhất.

Tham số này không yêu cầu giá trị. Đó là công tắc.

--solution-root -sr

Thư mục gốc của giải pháp X++ (chứa .erp/xpp.json). Mặc định cho thư mục hiện tại.

pac package db-sync

(Xem trước) Đồng bộ hóa cơ sở dữ liệu ứng dụng Tài chính và Vận hành với Dataverse.

Tham số Tùy chọn cho package db-sync

--argument-file -af

(Xem trước) Đường dẫn đến tệp JSON khớp với hợp đồng IncrementalSyncParameters (hoặc ModuleSyncParameters). Bắt buộc đối với Tăng dần --db-sync.

--db-sync -ds

Chế độ đồng bộ hóa cơ sở dữ liệu. Giá trị được phép: Đầy đủ, Mô-đun, Gia tăng. Mặc định: Đầy đủ.

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--modules -m

(Xem trước) Danh sách tên mô-đun được phân tách bằng dấu phẩy để đồng bộ. Bắt buộc khi --db-sync là Mô-đun.

pac package deploy

Triển khai gói đến Dataverse

Lưu ý

Lệnh này chỉ khả dụng cho phiên bản .NET Full Framework của PAC CLI.

Ví dụ:

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

Tham số Tùy chọn cho package deploy

--argument-file -af

(Xem trước) Đường dẫn đến tệp JSON khớp với hợp đồng IncrementalSyncParameters (hoặc ModuleSyncParameters). Bắt buộc đối với Tăng dần --db-sync.

--build-type -bt

(Xem trước) Cách gói được áp dụng. Giá trị được phép: Đầy đủ, Tăng dần, Xóa. Mặc định: Đầy đủ. Được sử dụng với --package-type erp.

--db-sync -ds

(Xem trước) Chế độ đồng bộ hóa cơ sở dữ liệu sẽ chạy sau khi triển khai. Giá trị được phép: None, Full, Module, Incremental. Mặc định: Không có. Được sử dụng với --package-type erp.

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--logConsole -c

Nhật ký đầu ra vào bảng điều khiển

Tham số này không yêu cầu giá trị. Đó là công tắc.

--logFile -lf

Đường dẫn tệp sổ ghi

--modules -m

(Xem trước) Danh sách tên mô-đun được phân tách bằng dấu phẩy để đồng bộ. Bắt buộc khi --db-sync là Mô-đun.

--outputDirectory -o

(Xem trước) Chỉ chế độ giải pháp: thư mục gốc chứa .erp/xpp.json. Mặc định cho thư mục hiện tại. Khi --package được bỏ qua dưới --package-type erp, tất cả các mô hình được liệt kê trong .erp/xpp.json được triển khai theo thứ tự phụ thuộc.

--package -p

Đường dẫn đến tệp zip hoặc dll gói có gói.

--package-type -pt

Nền tảng mục tiêu để triển khai. Giá trị được phép: dataverse, erp (Preview). Mặc định: dataverse.

--release-type -rt

(Xem trước) Phân loại gói hàng. Giá trị được phép: Dev, Release. Mặc định: Dev. Gói phát hành buộc phải đồng bộ cơ sở dữ liệu đầy đủ trên máy chủ. Được sử dụng với --package-type erp.

--settings -s

Thiết đặt Gói Thời gian chạy được chuyển đến gói đang được triển khai. Định dạng của chuỗi phải là key=value|key=value.

Lưu ý: Định dạng của chuỗi phải là key=value|key=value.

--solution -sz

Đường dẫn đến tệp giải pháp Dataverse. Tệp phải là tệp ZIP hoặc CAB đã nén.

--solution-root -sr

(Xem trước) Chỉ chế độ giải pháp: thư mục gốc chứa .erp/xpp.json. Mặc định cho thư mục hiện tại. Khi --package được bỏ qua dưới --package-type erp, tất cả các mô hình được liệt kê trong .erp/xpp.json được triển khai theo thứ tự phụ thuộc.

--verbose -vdbg

Phát ra nhật ký chi tiết đến đầu ra của nhật ký.

Tham số này không yêu cầu giá trị. Đó là công tắc.

Ghi chú

Bạn có thể dùng cả hai logFile tham logConsole số cùng nhau, hoặc dùng tham số này hay tham số kia.

pac package init

Khởi tạo thư mục với dự án gói Dataverse mới

Ví dụ:

pac package init --outputdirectory c:\samplepackage

Tham số Tùy chọn cho package init

--layer -l

(Xem trước) Lớp X++. Giá trị được phép: USR, CUS, VAR, SL1, SL2, SL3, BUS, HFX, GLS, DIS, ISV. Mặc định: ISV.

--model -m

(Xem trước) Tên của (các) mô hình X++ vào giàn giáo. Chấp nhận một tên hoặc danh sách được phân tách bằng dấu phẩy (ví dụ: ModelA,ModelB). Bắt buộc khi --package-type bị lỗi.

--outputDirectory -o

Thư mục đầu ra

--package-name

Đặt tên mặc định của gói. Áp dụng cho thế hệ ImportExtension.GetNameOfImport.

--package-type -pt

Loại dự án gói vào giàn giáo. Giá trị được phép: dataverse, erp (Preview). Mặc định: dataverse.

--publisher -pub

(Xem trước) Publisher được viết vào mô hình mô tả. Mặc định: Microsoft.

--source-root -sr

(Xem trước) Đường dẫn gốc nguồn (tương đối với thư mục đầu ra) nơi các mô hình sẽ sống. Mặc định: ./src.

pac package show

Hiển thị chi tiết của gói Dataverse

Lưu ý

Lệnh này chỉ khả dụng cho phiên bản .NET Full Framework của PAC CLI.

Ví dụ:

pac package show c:\samplepackage.dll

Tham số Bắt buộc cho package show

--package -p

Đường dẫn đến tệp zip hoặc dll gói có gói.

Tham số Tùy chọn cho package show

--environment -env

Xác định Dataverse đích. Giá trị có thể là GUID hoặc URL https tuyệt đối. Khi không được chỉ định, tổ chức hiện hoạt được chọn cho hồ sơ xác thực hiện tại sẽ được sử dụng.

--logFile -lf

Đường dẫn tệp sổ ghi

--verbose -vdbg

Phát ra nhật ký chi tiết đến đầu ra của nhật ký.

Tham số này không yêu cầu giá trị. Đó là công tắc.

Xem thêm

Microsoft Power Platform lệnh CLI
Tổng quan về MICROSOFT Power Platform CLI