Tham chiếu CLI đảo dữ liệu (bản xem trước)

Lưu ý

  • Đây là một tính năng xem trước.
  • Các tính năng xem trước không được dùng cho sản xuất và có thể có chức năng bị hạn chế. Những tính năng này khả dụng trước khi có bản phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.

Bài viết này mô tả các lệnh có sẵn trong CLI Dataverse. Mỗi lệnh hỗ trợ một tùy --help chọn liệt kê mức sử dụng, tùy chọn và ví dụ. Các lệnh trả về dữ liệu sẽ hỗ trợ --json tùy chọn đầu ra JSON thô hữu ích trong tập lệnh.

Các tùy chọn chung sau đây có thể được sử dụng với bất kỳ lệnh nào:

Tùy chọn Mô tả
--log-level <level> Đặt mức ghi nhật ký: Trace, Debug, Information, Warning, Error, hoặc Critical. Mặc định: Warning.
--log-file Đăng nhập vào tệp trong thư mục tạm thời thay vì bảng điều khiển.
--context <value> Ngữ cảnh thao tác được nối vào Tác nhân Người dùng. Bạn cũng có thể đặt biến DATAVERSE_OPERATION_CONTEXT môi trường.
Lệnh Mô tả
api describe Mô tả API
api invoke Gọi API theo tên
api list Danh sách API có thể phát hiện
api request Gửi yêu cầu HTTP đã xác thực
auth create Tạo hồ sơ xác thực mới
auth list Liệt kê tất cả hồ sơ xác thực
auth remove Loại bỏ hồ sơ xác thực
auth select Chọn cấu hình xác thực hiện hoạt
auth who Hiện hồ sơ xác thực hiện tại
data associate Nối kết hai bản ghi thông qua mối quan hệ
data count Đếm số bản ghi trong bảng
data create Tạo một bản ghi mới
data delete Xóa bản ghi
data describe Mô tả sơ đồ của một thực thể
data disassociate Loại bỏ mối quan hệ giữa hai bản ghi
data get Truy xuất một bản ghi duy nhất bằng ID hoặc khóa thay thế
data query Thực hiện truy vấn OData, FetchXML hoặc SQL
data update Cập nhật bản ghi hiện tại
data upload Tải tệp lên cột tệp trên bản ghi hiện có
data upsert Tạo hoặc cập nhật bản ghi bằng phím thay thế
erp batch cancel Hủy bỏ công việc lô Tài chính và Thao tác
erp batch list Liệt kê công việc lô Tài chính và Vận hành
install Cài đặt một phiên bản cụ thể hoặc cập nhật lên phiên bản mới nhất
mcp Khởi động máy chủ MCP cho Dataverse hoặc ERP
mcp allow Cho phép ứng dụng dưới dạng máy khách MCP
org list Liệt kê tất cả các môi trường trợ năng
org who Hiển thị thông tin người dùng và tổ chức hiện tại
skill delete Xóa kỹ năng khỏi Dataverse
skill download Tải xuống một kỹ năng từ Dataverse
skill list Liệt kê các kỹ năng hoạt động trong môi trường
skill upload Tải một kỹ năng lên Dataverse

Lưu ý

Nhiều lệnh hỗ trợ một tùy --target <dataverse\|erp> chọn định tuyến các hoạt động dataverse (mặc định) hoặc môi trường tài chính và hoạt động (ERP) được liên kết. Các lệnh kết nối với môi trường hỗ trợ tùy --environment <url> chọn (-env) để ghi đè URL môi trường của hồ sơ hiện tại.

api describe lệnh

Hiển thị siêu dữ liệu cho một API đơn. Đối với API tùy chỉnh Dataverse, đầu ra bao gồm thông số yêu cầu và mô tả thuộc tính phản hồi khi siêu dữ liệu cung cấp chúng.

Theo mặc định, tên đảo dữ liệu không được chuẩn bị. Bạn có thể sử dụng tên đủ điều kiện ERP trong biểu mẫu erp:ServiceGroup/Service/Operation.

api describe tham số

Tham số Mô tả
--target Giải quyết tên không đủ điều kiện chống lại hoặc dataverseerp.
--service-group Chỉ ERP. Thu hẹp phạm vi tra cứu thao tác thành một nhóm dịch vụ.
--service Chỉ ERP. Thu hẹp phạm vi tra cứu thao tác thành một dịch vụ.
--environment Ghi đè URL môi trường Dataverse.
--json Xuất JSON thô.

api describe Ví dụ

dataverse api describe sample_CustomAPIExample
dataverse api describe msdyn_DoesKBExist
dataverse api describe GetUserSessionInfo --target erp --service-group UserSessionService --service AifUserSessionService

api invoke lệnh

Gọi một API đã khám phá theo tên. Dùng cú name=value pháp cho tham số. Nếu một giá trị có chứa dấu cách, hãy trích dẫn toàn bộ mã thông báo. Một số API Dataverse chấp nhận tham số chuỗi có nội dung chính là JSON. Trong trường hợp đó, hãy chuyển văn bản JSON làm giá trị bằng cách sử dụng các quy tắc thoát và trích dẫn bình thường của shell.

Theo mặc định, các phản hồi JSON được hiển thị ở định dạng văn bản thân thiện giữ tên thuộc tính đầu ra. Sử --json dụng để bảo toàn tải trọng JSON thô.

api invoke tham số

Tham số Mô tả
--target Giải quyết tên không đủ điều kiện chống lại hoặc dataverseerp.
--service-group Chỉ ERP. Thu hẹp phạm vi tra cứu thao tác thành một nhóm dịch vụ.
--service Chỉ ERP. Thu hẹp phạm vi tra cứu thao tác thành một dịch vụ.
--param Thêm tham số đã đặt tên vào biểu name=value mẫu. Có thể lặp lại.
--bind Đường dẫn liên kết cho API Dataverse liên kết thực thể.
--method, -X Ghi đè phương thức HTTP suy ra.
--body Sử dụng nội dung JSON thô thay vì các tham số đã đặt tên.
--body-file Đọc nội dung JSON thô từ tệp.
--header, -H Thêm đầu trang HTTP trong biểu key:value mẫu.
--include, -i Bao gồm trạng thái phản hồi và tiêu đề.
--environment Ghi đè URL môi trường Dataverse.
--json Xuất JSON thô thay vì văn bản thân thiện.

api invoke Ví dụ

Gọi ra một hàm Dataverse. Ví dụ này cho thấy cách sử dụng hàm Dynamics 365 Contact Center CCaaS_GetPresence này.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Gọi hành động AISummarize Dataverse với dấu cách trong một giá trị tham số:

dataverse api invoke AISummarize "Text=The customer reported intermittent login failures..."

Gọi dịch vụ tùy chỉnh ERP:

dataverse api invoke GetUserSessionInfo --target erp --service-group UserSessionService --service AifUserSessionService

api list lệnh

Liệt kê các API có thể phát hiện, chẳng hạn như API tùy chỉnh Dataverse và các điểm cuối dịch vụ có thể gọi của ERP. Kết quả hiển thị danh tính API, tên thân thiện, loại và mô tả khi có sẵn. Bạn có thể truyền thuật ngữ truy vấn tùy chọn để lọc kết quả.

api list tham số

Tham số Mô tả
--target Hệ thống đích để tìm kiếm: dataverse (mặc định) hoặc erp.
--service-group Chỉ ERP. Lọc thành một nhóm dịch vụ đơn lẻ.
--service Chỉ ERP. Lọc một dịch vụ duy nhất.
--limit Số API tối đa cần trả về. Mặc định: 50.
--page Số trang dựa trên 1 khi phân trang qua kết quả. Mặc định: 1.
--environment Ghi đè URL môi trường Dataverse.
--json Xuất JSON thô.

api list Ví dụ

dataverse api list
dataverse api list invoice --target dataverse
dataverse api list --target erp GetUserSessionInfo
dataverse api list --target erp --service-group UserSessionService --service AifUserSessionService

api request lệnh

Gửi yêu cầu HTTP xác thực thô đến Dataverse hoặc ERP. Sử dụng lệnh này khi bạn cần toàn quyền kiểm soát đường dẫn, phương pháp, tiêu đề và nội dung.

api request tham số

Tham số Mô tả
--target Hệ thống đích: dataverse hoặc erp. Bắt buộc.
--path Đường dẫn yêu cầu. Bắt buộc.
--method, -X Phương thức HTTP. Mặc định: GET, hoặc POST khi một nội dung được cung cấp.
--body Nội dung yêu cầu JSON tại chỗ.
--body-file Tệp chứa nội dung yêu cầu đối tượng JSON.
--header, -H Thêm đầu trang HTTP trong biểu key:value mẫu.
--include, -i Bao gồm trạng thái phản hồi và tiêu đề.
--environment Ghi đè URL môi trường Dataverse.

api request Ví dụ

dataverse api request --target dataverse --path /api/data/v9.2/sample_CustomAPIExample --body "{\"Input\":\"value\"}"
dataverse api request --target erp --path /api/services/UserSessionService/AifUserSessionService/GetUserSessionInfo --body "{}"

auth create lệnh

Tạo hồ sơ xác thực mới.

auth create tham số

Sử dụng các tham số này để xác định hành vi của auth create lệnh.

Tham số Mô tả
--environment, -env URL cho môi trường Dataverse mà bạn muốn xác thực.
--name, -n Tên tùy chọn cho hồ sơ. Sử dụng tên để chọn hồ sơ sau này.
--cloud, -ci Đám mây đích: Public, UsGov, UsGovHigh, UsGovDodhoặc China.
--deviceCode, -dc Sử dụng dòng xác thực mã thiết bị, cho môi trường không có trình duyệt.
--username, -un Tên người dùng cho tên người dùng và xác thực mật khẩu.
--password, -p Mật khẩu cho tên người dùng và xác thực mật khẩu.
--applicationId, -id ID ứng dụng (máy khách) cho xác thực chính của dịch vụ (SPN).
--clientSecret, -cs Bí mật máy khách cho xác thực chính của dịch vụ.
--certificateDiskPath, -cdp Đường dẫn đến tệp chứng chỉ .pfx để xác thực dựa trên chứng chỉ.
--certificatePassword, -cp Mật khẩu cho chứng chỉ.
--tenant, -t ID đối tượng thuê. Bắt buộc đối với xác thực chính của dịch vụ.
--managedIdentity, -mi Sử dụng danh Azure được quản lý.
--githubFederated, -ghf Sử dụng GitHub Actions xác thực liên kết.
--azureDevOpsFederated, -adof Sử dụng Azure DevOps xác thực liên kết.
--clientid, -cid Id ứng dụng Microsoft Entra tùy chỉnh để sử dụng thay vì ứng dụng Dataverse CLI mặc định.
--no-default-environment Không đặt môi trường làm mặc định.
--accept-cleartext-caching Cho phép bộ đệm ẩn mã thông báo văn bản thuần trên Linux.

auth create Ví dụ

Các ví dụ sau đây thể hiện cách sử dụng auth create lệnh.

Xác thực tương tác

Lệnh này sẽ mở hộp thoại trình duyệt hoặc hệ thống để biết thêm thông tin.

dataverse auth create --environment https://myorg.crm.dynamics.com

Hồ sơ có tên

Tạo hồ sơ với một tên cụ thể.

dataverse auth create --environment https://myorg.crm.dynamics.com --name prod

Dòng mã thiết bị

Sử dụng dòng mã thiết bị cho môi trường không có trình duyệt.

dataverse auth create --environment https://myorg.crm.dynamics.com --deviceCode

Tên dịch vụ chính với bí mật máy khách

Sử dụng tên dịch vụ chính khi bạn cần xác thực không được hỗ trợ, chẳng hạn như trong quy trình CI/CD hoặc một tập lệnh tự động khác khi không thể đăng nhập tương tác. Cung cấp ID ứng dụng, bí mật máy khách và ID đối tượng thuê của đăng ký ứng dụng có quyền truy cập môi trường.

dataverse auth create --applicationId <appId> --clientSecret <secret> --tenant <tenantId>

ID máy khách ứng dụng Entra tùy chỉnh

Sử dụng đăng ký ứng dụng của riêng bạn thay vì mặc định.

dataverse auth create --environment https://myorg.crm.dynamics.com --clientid <your-app-guid>

auth list lệnh

Liệt kê tất cả hồ sơ xác thực. Thêm --json cho đầu ra JSON thô.

auth list Ví dụ

dataverse auth list
dataverse auth list --json

auth remove lệnh

Loại bỏ một hoặc tất cả các cấu hình xác thực.

auth remove tham số

Tham số Mô tả
--index, -i Loại bỏ cấu hình với chỉ mục 1 dựa trên đã xác định, như minh họa trong auth list.
--name, -n Loại bỏ hồ sơ với tên đã xác định.
--all Xóa tất cả hồ sơ.

auth remove Ví dụ

dataverse auth remove --index 1
dataverse auth remove --name prod
dataverse auth remove --all

auth select lệnh

Chọn cấu hình xác thực hiện hoạt. Chạy lệnh mà không có tùy chọn để liệt kê tất cả hồ sơ.

auth select tham số

Tham số Mô tả
--index, -i Chọn cấu hình theo chỉ mục 1 dựa trên cấu hình, như được hiển thị trong auth list.
--name, -n Chọn hồ sơ theo tên.

auth select Ví dụ

Mở bộ chọn tương tác. Sử dụng các phím mũi tên hoặc nhập để lọc:

dataverse auth select

Chọn một hồ sơ theo chỉ mục hoặc theo tên:

dataverse auth select --index 1
dataverse auth select --name prod

auth who lệnh

Hiện hồ sơ xác thực hiện hoạt hiện tại. Thêm --json cho đầu ra JSON thô.

auth who Ví dụ

dataverse auth who
dataverse auth who --json

data associate lệnh

Liên kết hai bản ghi thông qua thuộc tính dẫn hướng (mối quan hệ). Lệnh này chỉ được hỗ trợ cho Dataverse.

data associate tham số

Tham số Mô tả
--table, -t Tên bộ thực thể của bản ghi chính. Bắt buộc.
--id, -i GUID của bản ghi chính. Bắt buộc.
--relationship, -rel Tên thuộc tính dẫn hướng. Bắt buộc.
--related Tên bộ thực thể của bảng liên quan. Bắt buộc.
--related-id GUID của bản ghi liên quan. Bắt buộc.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data associate Ví dụ

dataverse data associate --table accounts --id <guid> --relationship contact_customer_accounts --related contacts --related-id <related-guid>

data count lệnh

Đếm các bản ghi trong bảng, được lọc theo tùy chọn.

data count tham số

Tham số Mô tả
--table, -t Tên bộ thực thể. Bắt buộc trừ khi bạn sử dụng --fetchxml.
--filter, -f Biểu thức OData $filter .
--fetchxml Truy vấn tổng hợp FetchXML cho số đếm phức.
--target Định tuyến đến dataverse (mặc định) hoặc môi trường được liên erp kết.
--cross-company Chỉ ERP. Đếm trên tất cả các công ty. Mặc định: công ty mặc định của người dùng.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data count Ví dụ

dataverse data count --table accounts
dataverse data count --target erp --table Currencies --filter "CurrencyCode eq 'AED'"

data create lệnh

Tạo bản ghi mới trong bảng Dataverse. Đặt cột tra cứu bằng cú @odata.bind pháp.

data create tham số

Tham số Mô tả
--table, -t Tên bộ thực thể. Bắt buộc.
--data, -d Đối tượng JSON với các giá trị trường.
--data-file Đường dẫn đến tệp JSON với dữ liệu bản ghi.
--return, -r Trả về bản ghi đã tạo đầy đủ.
--target Định tuyến đến dataverse (mặc định) hoặc môi trường được liên erp kết.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data create Ví dụ

dataverse data create --table accounts --data '{"name":"Contoso"}'
dataverse data create --table contacts --data '{"firstname":"Alice","parentcustomerid_account@odata.bind":"accounts(<guid>)"}'

Mẹo

Sử dụng --data-file cho JSON phức tạp. Dùng để --return --json lấy bản ghi được tạo đầy đủ.

data delete lệnh

Xóa một bản ghi bằng khóa chính hoặc bằng khóa thay thế.

data delete tham số

Tham số Mô tả
--table, -t Tên bộ thực thể. Bắt buộc.
--id, -i GUID bản ghi.
--key, -k Khóa thay thế.
--no-confirm Bỏ qua lời nhắc xác nhận.
--target Định tuyến đến dataverse (mặc định) hoặc môi trường được liên erp kết.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data delete Ví dụ

dataverse data delete --table accounts --id 00000000-0000-0000-0000-000000000001 --no-confirm

data describe lệnh

Mô tả sơ đồ của thực thể OData. Đối với Dataverse, các lệnh gọi EntityDefinitions(LogicalName='<table>') được điều $expand khiển bởi --include, cộng với một cuộc gọi thứ hai đến customapis khi --include actions được thiết lập. Các hành động Dataverse dựng sẵn chẳng Assign hạn SetState như và không được liệt kê. Đối với ERP, một lệnh gọi duy nhất để trả về /Metadata/PublicEntities thuộc tính, hành động liên kết và dẫn hướng với nhau.

data describe tham số

Tham số Mô tả
--target Đích: dataverse (mặc định) hoặc erp.
--table, -t Bắt buộc. Đối với Dataverse, tên lô-gic, chẳng hạn như account. Đối với ERP, tên bộ thực thể, chẳng hạn như BatchJobs.
--include Danh sách các phần được phân tách bằng dấu phẩy bao gồm: entity, properties, relations, actions, hoặc all. Biệt danh: attributes=properties, . relationships=relations Mặc định cho ERP: all. Mặc định cho Dataverse: entity,properties.
--json Xuất JSON thô.

data describe Ví dụ

dataverse data describe --table account
dataverse data describe --target dataverse --table account --include all
dataverse data describe --target erp --table BatchJobs

data disassociate lệnh

Loại bỏ mối quan hệ giữa hai bản ghi. Lệnh này chỉ được hỗ trợ cho Dataverse.

data disassociate tham số

Tham số Mô tả
--table, -t Tên bộ thực thể của bản ghi chính. Bắt buộc.
--id, -i GUID của bản ghi chính. Bắt buộc.
--relationship, -rel Tên thuộc tính dẫn hướng. Bắt buộc.
--related-id GUID của bản ghi liên quan, cho mối quan hệ nhiều-nhiều. Bỏ qua tham số này để xóa tra cứu.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data disassociate Ví dụ

dataverse data disassociate --table accounts --id <guid> --relationship contact_customer_accounts --related-id <related-guid>

data get lệnh

Truy xuất một bản ghi bằng ID (khóa chính) hoặc bằng khóa thay thế.

data get tham số

Tham số Mô tả
--table, -t Tên bộ thực thể. Bắt buộc.
--id, -i GUID bản ghi (khóa chính).
--key, -k Khóa thay thế, ví dụ "col='val'".
--select, -s Danh sách cột được phân tách bằng dấu phẩy ($select).
--expand, -x Biểu thức OData cho $expand các bản ghi liên quan.
--target Định tuyến đến dataverse (mặc định) hoặc môi trường được liên erp kết.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data get Ví dụ

dataverse data get --table accounts --id 00000000-0000-0000-0000-000000000001
dataverse data get --target erp --table Currencies --key "CurrencyCode='AED'" --select "CurrencyCode,Name"

data query lệnh

Thực hiện truy vấn OData, FetchXML hoặc SQL đối với bảng Dataverse.

data query tham số

Tham số Mô tả
--table, -t Thực thể đặt tên cho truy vấn. Bắt buộc đối với truy vấn OData.
--select, -s Danh sách cột được phân tách bằng dấu phẩy ($select).
--filter, -f Biểu thức OData $filter .
--orderby, -o Biểu thức OData $orderby .
--top Số bản ghi tối đa trả về (1-5000).
--expand, -x Biểu thức OData cho $expand các bản ghi liên quan.
--fetchxml Truy vấn FetchXML nội tuyến.
--fetchxml-file Đường dẫn đến tệp chứa truy vấn FetchXML.
--sql Truy vấn SQL SELECT (bản xem trước).
--sql-file Đường dẫn đến tệp có chứa truy vấn SQL.
--all, -a Làm theo phân trang để truy xuất tất cả các bản ghi.
--max-records Số bản ghi tối đa để truy xuất khi sử dụng --all. Mặc định: 100000.
--target Định tuyến đến dataverse (mặc định) hoặc môi trường được liên erp kết.
--cross-company Chỉ ERP. Truy vấn trên tất cả các công ty. Mặc định: công ty mặc định của người dùng.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data query Ví dụ

dataverse data query --table accounts --select "name,revenue" --filter "revenue gt 1000000"
dataverse data query --fetchxml "<fetch><entity name='account'><attribute name='name'/></entity></fetch>"
dataverse data query --sql "SELECT name, revenue FROM account WHERE revenue > 1000000"
dataverse data query --target erp --table Currencies --select "CurrencyCode,Name" --top 10

Tìm hiểu thêm

data update lệnh

Cập nhật một hoặc nhiều trường trên bản ghi hiện có, được ID xác định hoặc bằng khóa thay thế. Đặt cột tra cứu bằng cú @odata.bind pháp.

data update tham số

Tham số Mô tả
--table, -t Tên bộ thực thể. Bắt buộc.
--id, -i GUID bản ghi.
--key, -k Khóa thay thế.
--data, -d Đối tượng JSON với các trường cần cập nhật.
--data-file Đường dẫn đến tệp JSON với dữ liệu cập nhật.
--return, -r Trả về bản ghi cập nhật đầy đủ.
--target Định tuyến đến dataverse (mặc định) hoặc môi trường được liên erp kết.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data update Ví dụ

dataverse data update --table accounts --id 00000000-0000-0000-0000-000000000001 --data '{"name":"Contoso (updated)"}'

data upload lệnh

Tải tệp cục bộ lên cột tệp Dataverse trên bản ghi hiện có. Lệnh này tự động chọn một yêu cầu đơn hoặc tải lên theo khúc dữ liệu dựa trên kích thước tệp, trừ khi bạn chỉ định --mode. Ở chế độ tự động, các tệp có dung lượng dưới 128 MB được tải lên trong một yêu cầu duy nhất và các tệp lớn hơn sử dụng tính năng tải lên theo khúc dữ liệu. Khi bạn bỏ qua --mime-type, lệnh sẽ suy ra kiểu MIME từ phần mở rộng tệp. Phần mở rộng không xác định mặc định là application/octet-stream.

data upload tham số

Tham số Mô tả
--table, -t Sơ đồ bảng hoặc tên lô-gic, chẳng hạn như account. Bắt buộc. Lệnh giải quyết tập hợp thực thể từ siêu dữ liệu.
--id, -i GUID bản ghi. Bắt buộc.
--column, -c Tên thuộc tính cột tệp. Bắt buộc.
--file, -f Đường dẫn đến tệp cục bộ. Bắt buộc.
--mode, -m Chiến lược tải lên: auto (mặc định), smallhoặc chunk.
--mime-type Kiểu MIME rõ ràng. Mặc định: suy ra từ phần mở rộng tệp.
--overwrite Ghi đè tệp hiện có. Theo mặc định, lệnh không thành công nếu cột không trống.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data upload Ví dụ

dataverse data upload --table account --id <guid> --column new_document --file report.pdf
dataverse data upload -t account -i <guid> -c new_document -f photo.jpg --overwrite
dataverse data upload -t account -i <guid> -c new_document -f big.bin --mode chunk

data upsert lệnh

Tạo bản ghi nếu không tồn tại hoặc cập nhật bản ghi nếu có. Bản ghi được xác định bằng khóa thay thế. Tìm hiểu cách sử dụng khóa thay thế để tham chiếu bản ghi

data upsert tham số

Tham số Mô tả
--table, -t Tên bộ thực thể. Bắt buộc.
--key, -k Khóa thay thế. Bắt buộc.
--data, -d Đối tượng JSON với các giá trị trường.
--data-file Đường dẫn đến tệp JSON.
--update-only Không thành công nếu bản ghi không tồn tại (If-Match: *).
--create-only Không thành công nếu bản ghi đã tồn tại (If-None-Match: *).
--return, -r Trả về bản ghi đầy đủ sau thao tác.
--target Định tuyến đến dataverse (mặc định) hoặc môi trường được liên erp kết.
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

data upsert Ví dụ

dataverse data upsert --table accounts --key "accountnumber='ACC-100'" --data '{"name":"Contoso"}'

erp batch cancel lệnh

Hủy bỏ công việc lô Tài chính và Vận hành của nó RecId. Sử erp batch list dụng để tìm RecId.

erp batch cancel Ví dụ

dataverse erp batch cancel <recid>

erp batch list lệnh

Liệt kê các công việc lô trên phiên bản Tài chính và Vận hành được liên kết với môi trường Dataverse của bạn. Lệnh yêu cầu hồ sơ xác thực được kết nối với môi trường Dataverse có phiên bản Tài chính và Vận hành được liên kết. URL Tài chính và Vận hành được lấy tự động từ kết nối Dataverse hiện tại.

erp batch list tham số

Tham số Mô tả
--company Lọc theo thực thể pháp lý (dataAreaId), chẳng hạn như USMF.
--status Lọc theo trạng thái: Waiting, Executing, Finished, Errorhoặc Cancelled.
--top Số lượng kết quả tối đa để trả về. Mặc định: 20.
--caption Lọc theo chú thích (khớp chuỗi con phân biệt chữ hoa chữ thường).
--json Xuất JSON thô.

erp batch list Ví dụ

dataverse erp batch list
dataverse erp batch list --status Waiting
dataverse erp batch list --status Executing --top 20

install lệnh

Cài đặt một phiên bản cụ thể của Dataverse CLI hoặc cập nhật lên phiên bản mới nhất. Lệnh này sẽ phát hiện xem bạn đã cài đặt CLI trên toàn cầu hay đang sử dụng npx và cài đặt tương ứng.

install Ví dụ

Cài đặt phiên bản mới nhất:

dataverse install latest

Cài đặt một phiên bản cụ thể:

dataverse install 1.0.0

mcp lệnh

Khởi động máy chủ Giao thức Ngữ cảnh Mô hình (MCP) kết nối với môi trường của bạn để các trợ lý AI như Claude Desktop có thể tương tác với dữ liệu của bạn. Đích được tự động phát hiện từ URL: URL Dataverse khởi động máy chủ MCP Dataverse và URL Tài chính và Thao tác, https://myorg.operations.dynamics.comchẳng hạn như , khởi động máy chủ MCP ERP.

mcp Cú pháp

dataverse mcp <orgUrl> [options]

Đối <orgUrl> số là URL tổ chức của bạn, ví dụ https://myorg.crm.dynamics.com.

mcp tham số

Tham số Mô tả
--validate Xác thực các điểm cuối MCP và thiết lập xác thực mà không cần khởi động máy chủ.
--log-level Đặt mức ghi nhật ký: Trace, Debug, Information, Warning, Error, hoặc Critical. Mặc định: Warning.
--log-file Đăng nhập vào tệp trong thư mục tạm thời.
--preview Sử dụng điểm cuối MCP xem trước (api/mcp_preview thay vì api/mcp). Không hỗ trợ cho ERP.

mcp Ví dụ

Xác thực thiết lập (bước đầu tiên được đề xuất):

dataverse mcp https://myorg.crm.dynamics.com --validate

Khởi động máy chủ bằng cách sử dụng vận chuyển stdio:

dataverse mcp https://myorg.crm.dynamics.com

Sử dụng điểm cuối xem trước hoặc bật tính năng ghi nhật ký tệp gỡ lỗi:

dataverse mcp https://myorg.crm.dynamics.com --preview
dataverse mcp https://myorg.crm.dynamics.com --log-level Debug --log-file

mcp allow lệnh

Đảm bảo rằng một Microsoft Entra dụng trong danh sách dataverse MCP cho phép máy khách cho phép môi trường của hồ sơ hiện tại. Lệnh này là giải pháp thay thế cho bước quản trị thủ công được mô tả trong điều kiện tiên quyết. Người dùng được xác thực phải có quyền quản trị Dataverse trên môi trường đích.

mcp allow Cú pháp

dataverse mcp allow <appId> [options]

Đối <appId> số là ID ứng dụng (máy khách) để cho phép, dưới dạng GUID.

mcp allow tham số

Tham số Mô tả
--erp Cho phép ứng dụng trên phiên bản Tài chính và Vận hành được liên kết thay vì Dataverse.

mcp allow Ví dụ

dataverse mcp allow 0c412cc3-0dd6-449b-987f-05b053db9457
dataverse mcp allow 0c412cc3-0dd6-449b-987f-05b053db9457 --erp

Lưu ý

Tài chính và Vận hành lưu danh sách cho phép vào bộ đệm ẩn trong AOS, vì vậy, ID ứng dụng mới được cho phép có thể mất đến khoảng năm phút để có hiệu lực.

org list lệnh

Liệt kê tất cả các môi trường mà bạn có thể truy nhập.

org list tham số

Tham số Mô tả
--filter Lọc danh sách môi trường theo thuật ngữ tìm kiếm.
--json Xuất JSON thô.

org list Ví dụ

dataverse org list
dataverse org list --filter contoso
dataverse org list --json

org who lệnh

Hiện thông tin về tổ chức và người dùng hiện tại, sử dụng hồ sơ xác thực hiện hoạt. Lệnh env này là một biệt danh cho org.

org who tham số

Tham số Mô tả
--environment, -env Ghi đè URL môi trường.
--json Xuất JSON thô.

org who Ví dụ

dataverse org who
dataverse org who --environment https://myorg.crm.dynamics.com
dataverse org who --json

skill Lệnh

Quản lý kỹ năng Dataverse —các bộ hướng dẫn có thể sử dụng lại ( SKILL.md tệp và các tệp tài nguyên của nó) mà các tác nhân AI sử dụng—được lưu trữ trong môi trường được kết nối. Các lệnh mức cao nhất skill cung cấp các thao tác tạo, đọc, cập nhật và xóa đối với môi trường. Cục bộ, các kỹ năng được lưu trữ trong .claude/skills/<name>/.

Lưu ý

Lệnh biên soạn và đánh giá kỹ năng, chẳng hạn makenhư update, get, evalvà , tách biệt với các lệnh này. Để biết thêm thông tin, hãy chạy dataverse workspace skill --help.

skill delete lệnh

Xóa kỹ năng và tất cả tài nguyên của nó khỏi môi trường Dataverse hiện hoạt. Sử dụng skill list để tìm tên kỹ năng duy nhất.

dataverse skill delete new_lead-qualification

skill download lệnh

Tải xuống một hoặc nhiều kỹ năng từ môi trường Dataverse hiện hoạt vào đĩa. Lệnh này tải xuống tệp và tất SKILL.md cả các tệp tài nguyên, bảo toàn cấu trúc thư mục. Sử dụng skill list để tìm tên kỹ năng duy nhất.

Tham số Mô tả
--all Tải xuống tất cả các kỹ năng hoạt động từ môi trường. Không thể kết hợp với một tên kỹ năng duy nhất.
--output, -o Thư mục cơ sở cho đầu ra. Mặc định: .claude/skills/. Với --all, mỗi kỹ năng được viết để <path>/<name>/.
--json Xuất nội dung kỹ năng dưới dạng JSON mà không cần viết tệp. Tùy chọn xác định đường dẫn tệp để ghi vào. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list lệnh

Liệt kê tất cả các kỹ năng hoạt động trong môi trường Dataverse được kết nối.

Tham số Mô tả
--resources, -r Ngoài ra, hãy liệt kê các tệp tài nguyên cho từng kỹ năng.
--json Xuất ra dưới dạng JSON. Tùy chọn xác định đường dẫn tệp để ghi vào. 
dataverse skill list
dataverse skill list --resources

skill upload lệnh

Tải lên một hoặc nhiều kỹ năng từ đĩa vào môi trường Dataverse hiện hoạt. Lệnh này hỗ trợ các thư mục,.zip , tệp .skill và tệp .md .

Bạn có thể vượt qua kỹ <name>năng , kỹ năng này giải quyết thành .claude/skills/<name>/, hoặc một cách rõ ràng <path> đến một thư mục hoặc tệp.

Tham số Mô tả
--all Tải lên tất cả các kỹ năng trong .claude/skills/. Không thể kết hợp với tên kỹ năng hoặc đường dẫn.
--json Xuất kết quả dưới dạng JSON. Tùy chọn xác định đường dẫn tệp để ghi vào. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Xem thêm

Làm việc với dữ liệu bằng cách sử dụng CLI Dataverse

  • Last updated on