Посилання на CLI для даних (підготовча версія)

Примітка

  • Це функція попереднього перегляду.
  • Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

У цій статті описано команди, доступні в CLI Dataverse. Кожна команда підтримує параметр, у якому --help перелічено її використання, параметри та приклади. Команди, які повертають дані, --json підтримують параметр для необробленого результату JSON, який зручно використовувати в сценаріях.

З будь-якою командою можна використовувати такі глобальні параметри:

Варіант Опис
--log-level <level> Установіть рівень журналювання: Trace, , InformationDebug, Warning, Errorабо Critical. За замовчуванням: Warning.
--log-file Увійдіть у файл у тимчасовому каталозі замість консолі.
--context <value> Контекст операції, доданий до агента користувача. Ви також можете встановити змінну DATAVERSE_OPERATION_CONTEXT середовища.
Команда Опис
api describe Опишіть API
api invoke Викликати API за іменем
api list API для виявлення списку
api request Надсилання автентифікованого запиту HTTP
auth create Створення нового профілю автентифікації
auth list Список усіх профілів автентифікації
auth remove Видалення профілю автентифікації
auth select Виберіть активний профіль автентифікації
auth who Показати поточний профіль автентифікації
data associate Зв'язування двох записів за допомогою зв'язку
data count Підрахунок записів у таблиці
data create Створити запис
data delete Видалення запису
data describe Опишіть схему сутності
data disassociate Видалення зв'язку між двома записами
data get Отримання одного запису за ідентифікатором або альтернативним ключем
data query Виконання запиту OData, FetchXML або SQL
data update Оновити наявний запис
data upload Передавання файлу до стовпця файлу в наявному записі
data upsert Створення або оновлення запису за допомогою альтернативного ключа
erp batch cancel Скасування завдання пакета "Фінанси та операції"
erp batch list Завдання пакета "Список фінансів і операцій"
install Інсталяція певної версії або оновлення до найновішої версії
mcp Запуск сервера MCP для Dataverse або ERP
mcp allow Дозволити програму як клієнт MCP
org list Список усіх середовищ зі спеціальними можливостями
org who Відображення відомостей про поточну організацію та користувача
skill delete Видалення навички з Dataverse
skill download Завантаження навички з Dataverse
skill list Перелічіть активні навички в середовищі
skill upload Передавання навички до Dataverse

Примітка

Багато команд підтримують --target <dataverse\|erp> параметр, який спрямовує операцію до Dataverse (за замовчуванням) або до пов'язаного середовища фінансів і операцій (ERP). Команди, які підключаються до середовища, --environment <url> підтримують параметр (-env) для змінення URL-адреси середовища поточного профілю.

api describe команда

Відображення метаданих для одного API. Для настроюваних API Dataverse результат містить описи властивостей параметра запиту та відповіді, коли метадані їх надають.

За замовчуванням не можна фіксувати імена на основі даних. У формі erp:ServiceGroup/Service/Operationможна використовувати імена, які відтворюють ERP.

api describe Параметри

Параметр. Опис
--target Усунення некваліфікованого імені або dataverseerp.
--service-group Лише ERP. Звузити підстановку операції до однієї групи служб.
--service Лише ERP. Звузити підстановку операції до однієї служби.
--environment Перевизначити URL-адресу середовища Dataverse.
--json Вихідний сирий JSON.

api describe Приклади

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

api invoke команда

Викликати виявлений API за іменем. Використовуйте name=value синтаксис для параметрів. Якщо значення містить пробіли, процитуй весь маркер. Деякі API Dataverse приймають параметр рядка, вміст якого є самим JSON. У такому разі передайте текст JSON як значення, використовуючи звичайні цитування оболонки та правила втечі.

За замовчуванням відповіді JSON відображаються в зручному текстовому форматі, який зберігає імена властивостей виводу. Використовується --json для збереження необробленого корисного навантаження JSON.

api invoke Параметри

Параметр. Опис
--target Усунення некваліфікованого імені або dataverseerp.
--service-group Лише ERP. Звузити підстановку операції до однієї групи служб.
--service Лише ERP. Звузити підстановку операції до однієї служби.
--param Додавання іменованого параметра у name=value формі. Повторюваний.
--bind Шлях прив'язування для API Dataverse, зв'язаного з сутності.
--method, -X Перевизначити вказаний метод HTTP.
--body Використовуйте необроблений текст JSON замість іменованих параметрів.
--body-file Читання необробленого тексту JSON із файлу.
--header, -H Додавання заголовка HTTP у key:value формі.
--include, -i Додайте стан відповіді та заголовки.
--environment Перевизначити URL-адресу середовища Dataverse.
--json Вивести необроблений JSON замість зрозумілого тексту.

api invoke Приклади

Викликати функцію Dataverse. У цьому прикладі показано використання функції Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Викликати дію AISummarize Dataverse із пробілами у значенні параметра:

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

Викликати настроювану службу ERP:

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

api list команда

Інтерфейси API для виявлення списку, наприклад настроювані API Dataverse і кінцеві точки служби, які можна проголосувати, ERP. Результати показують ідентичність API, зрозуміле ім'я, тип і опис, коли вони доступні. Щоб відфільтрувати результати, можна передати необов'язковий термін запиту.

api list Параметри

Параметр. Опис
--target Цільова система для пошуку: dataverse (за замовчуванням) або erp.
--service-group Лише ERP. Фільтрувати до однієї групи служб.
--service Лише ERP. Фільтрувати до однієї служби.
--limit Максимальна кількість API, які потрібно повернути. За замовчуванням: 50.
--page Номер сторінки на основі 1 під час довантаження результатів. За замовчуванням: 1.
--environment Перевизначити URL-адресу середовища Dataverse.
--json Вихідний сирий JSON.

api list Приклади

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 команда

Надсилання необробленого запиту HTTP до Dataverse або ERP. Ця команда використовується, коли потрібен повний контроль над шляхом, методом, заголовками та текстом.

api request Параметри

Параметр. Опис
--target Цільова система: dataverse або erp. — обов’язковий аргумент.
--path Шлях запиту. — обов’язковий аргумент.
--method, -X Метод HTTP. За замовчуванням: GET, або POST в разі додавання основного тексту.
--body Вбудований текст запиту JSON.
--body-file Файл, який містить текст запиту об'єкта JSON.
--header, -H Додавання заголовка HTTP у key:value формі.
--include, -i Додайте стан відповіді та заголовки.
--environment Перевизначити URL-адресу середовища Dataverse.

api request Приклади

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 команда

Створіть новий профіль автентифікації.

auth create Параметри

Використовуйте ці параметри, щоб указати поведінку auth create команди.

Параметр. Опис
--environment, -env URL-адреса для середовища Dataverse, для якого потрібно пройти автентифікацію.
--name, -n Необов'язкове ім'я профілю. Використайте ім'я, щоб вибрати профіль пізніше.
--cloud, -ci Цільова хмара: Public, UsGov, UsGovHigh, UsGovDodабо China.
--deviceCode, -dc Використовуйте потік автентифікації коду пристрою для середовищ без браузера.
--username, -un Ім'я користувача для автентифікації імені користувача та пароля.
--password, -p Пароль для автентифікації імені користувача та пароля.
--applicationId, -id Ідентифікатор застосунку (клієнта) для автентифікації принципала служби (SPN).
--clientSecret, -cs Секрет клієнта для автентифікації основної служби.
--certificateDiskPath, -cdp Шлях до файлу сертифіката PFX для автентифікації на основі сертифіката.
--certificatePassword, -cp Пароль сертифіката.
--tenant, -t Ідентифікатор клієнта. Обов'язковий для автентифікації основного клієнта служби.
--managedIdentity, -mi Використовуйте керовану ідентичність Azure.
--githubFederated, -ghf Використовуйте GitHub Actions федеративну автентифікацію.
--azureDevOpsFederated, -adof Використовуйте Azure DevOps федеративну автентифікацію.
--clientid, -cid Настроюваний ідентифікатор клієнта програми Microsoft Entra використовувати замість стандартної програми Dataverse CLI.
--no-default-environment Не встановлюйте середовище як стандартне.
--accept-cleartext-caching Дозволити кеш маркерів звичайного тексту в Linux.

auth create Приклади

У наведених нижче прикладах показано, як використовувати auth create команду.

Інтерактивна автентифікація

Ця команда відкриває діалогове вікно браузера або системи для отримання додаткових відомостей.

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

Іменований профіль

Створіть профіль із певним іменем.

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

Потік коду пристрою

Використовуйте потік коду пристрою для середовищ без браузера.

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

Принципал служби з секретом клієнта

Використовуйте принципал служби, коли потрібна автоматична автентифікація, наприклад у конвеєрі CI/CD або іншому автоматизованому сценарії, за якого неможливо виконати інтерактивний вхід. Укажіть ідентифікатор програми, секретний клієнт і ідентифікатор клієнта реєстрації програми, яка має доступ до середовища.

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

Ідентифікатор настроюваного клієнта програми Entra

Використовуйте власну реєстрацію програм замість стандартного.

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

auth list команда

Перелічіть усі профілі автентифікації. Додати --json для необробленого результату JSON.

auth list Приклади

dataverse auth list
dataverse auth list --json

auth remove команда

Видаліть один або всі профілі автентифікації.

auth remove Параметри

Параметр. Опис
--index, -i Видаліть профіль із вказаним індексом на основі 1, як показано в auth list.
--name, -n Видаліть профіль із вказаним іменем.
--all Видалити всі профілі.

auth remove Приклади

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

auth select команда

Виберіть активний профіль автентифікації. Виконайте команду без параметрів списку всіх профілів.

auth select Параметри

Параметр. Опис
--index, -i Виберіть профіль за індексом на основі 1, як показано в auth list.
--name, -n Виберіть профіль за іменем.

auth select Приклади

Відкрийте інтерактивний засіб вибору. Використовуйте клавіші зі стрілками або введіть для фільтрування:

dataverse auth select

Виберіть профіль за індексом або за іменем:

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

auth who команда

Показати поточний активний профіль автентифікації. Додати --json для необробленого результату JSON.

auth who Приклади

dataverse auth who
dataverse auth who --json

data associate команда

Зв'язування двох записів за допомогою властивості навігації (зв'язку). Ця команда підтримується лише для Dataverse.

data associate Параметри

Параметр. Опис
--table, -t Ім'я набору сутностей для основного запису. — обов’язковий аргумент.
--id, -i GUID основного запису. — обов’язковий аргумент.
--relationship, -rel Ім'я властивості навігації. — обов’язковий аргумент.
--related Ім'я набору сутностей пов'язаної таблиці. — обов’язковий аргумент.
--related-id GUID пов'язаного запису. — обов’язковий аргумент.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data associate Приклади

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

data count команда

Підрахунок записів у таблиці за потреби відфільтровано.

data count Параметри

Параметр. Опис
--table, -t Ім'я набору сутностей. Обов'язково, якщо ви не використовуєте --fetchxml.
--filter, -f Вираз OData $filter .
--fetchxml Агрегатний запит FetchXML для складних підрахунків.
--target Маршрут до dataverse (за замовчуванням) або зв'язаного erp середовища.
--cross-company Лише ERP. Розраховуйте на всі компанії. За замовчуванням– компанія користувача за замовчуванням.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data count Приклади

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

data create команда

Створення нового запису в таблиці Dataverse. Установлення стовпців підстановки за допомогою @odata.bind синтаксису.

data create Параметри

Параметр. Опис
--table, -t Ім'я набору сутностей. — обов’язковий аргумент.
--data, -d Об'єкт JSON зі значеннями полів.
--data-file Шлях до файлу JSON із даними запису.
--return, -r Повертає повний створений запис.
--target Маршрут до dataverse (за замовчуванням) або зв'язаного erp середовища.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data create Приклади

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

Порада

Використовується --data-file для складних JSON. Використовується --return --json для отримання повного створеного запису.

data delete команда

Видаліть один запис за первинним ключем або за допомогою альтернативного ключа.

data delete Параметри

Параметр. Опис
--table, -t Ім'я набору сутностей. — обов’язковий аргумент.
--id, -i GUID запису.
--key, -k Альтернативний ключ.
--no-confirm Пропустити запит на підтвердження.
--target Маршрут до dataverse (за замовчуванням) або зв'язаного erp середовища.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data delete Приклади

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

data describe команда

Опишіть схему сутності OData. Для Dataverse команда викликає EntityDefinitions(LogicalName='<table>') з приводом $expand--include, а також другий виклик, customapis коли --include actions встановлено. Вбудовані дії Dataverse, наприклад Assign і SetState не перелічені. Для ERP один виклик /Metadata/PublicEntities повертає властивості, зв'язані дії та переходи разом.

data describe Параметри

Параметр. Опис
--target Цільовий об'єкт: dataverse (за замовчуванням) або erp.
--table, -t — обов’язковий аргумент. Для Dataverse логічне ім'я, наприклад account. Для ERP – ім'я набору сутностей, наприклад BatchJobs.
--include Список розділів, розділених комамиentity: , , propertiesrelations, actionsабо all. Псевдоніми: attributes=properties, . relationships=relations За замовчуванням для ERP: all. За замовчуванням для Dataverse: entity,properties.
--json Вихідний сирий JSON.

data describe Приклади

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

data disassociate команда

Видалення зв'язку між двома записами. Ця команда підтримується лише для Dataverse.

data disassociate параметри

Параметр. Опис
--table, -t Ім'я набору сутностей для основного запису. — обов’язковий аргумент.
--id, -i GUID основного запису. — обов’язковий аргумент.
--relationship, -rel Ім'я властивості навігації. — обов’язковий аргумент.
--related-id GUID пов'язаного запису для зв'язку "багато-до-багатьох". Не вимикати цей параметр, щоб очистити підстановку.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data disassociate Приклади

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

data get команда

Отримати один запис за ідентифікатором (первинним ключем) або за допомогою альтернативного ключа.

data get Параметри

Параметр. Опис
--table, -t Ім'я набору сутностей. — обов’язковий аргумент.
--id, -i GUID запису (первинний ключ).
--key, -k Альтернативний ключ, наприклад "col='val'".
--select, -s Список стовпців, розділених комами ($select).
--expand, -x Вираз OData $expand для пов'язаних записів.
--target Маршрут до dataverse (за замовчуванням) або зв'язаного erp середовища.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data get Приклади

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 команда

Виконайте запит OData, FetchXML або SQL для таблиці Dataverse.

data query Параметри

Параметр. Опис
--table, -t Ім'я набору сутностей для запиту. Обов'язковий для запитів OData.
--select, -s Список стовпців, розділених комами ($select).
--filter, -f Вираз OData $filter .
--orderby, -o Вираз OData $orderby .
--top Максимальна кількість записів, які потрібно повернути (1–5000).
--expand, -x Вираз OData $expand для пов'язаних записів.
--fetchxml Вбудований запит FetchXML.
--fetchxml-file Шлях до файлу, який містить запит FetchXML.
--sql Запит SQL SELECT (підготовча версія).
--sql-file Шлях до файлу, який містить запит SQL.
--all, -a Стежте за поділом, щоб отримати всі записи.
--max-records Максимальна кількість записів, які потрібно отримати під час використання --all. За замовчуванням: 100000.
--target Маршрут до dataverse (за замовчуванням) або зв'язаного erp середовища.
--cross-company Лише ERP. Запит для всіх компаній. За замовчуванням– компанія користувача за замовчуванням.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data query Приклади

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

Дізнатися більше

data update команда

Оновіть одне або кілька полів наявного запису, визначеного його ідентифікатором або альтернативним ключем. Установлення стовпців підстановки за допомогою @odata.bind синтаксису.

data update Параметри

Параметр. Опис
--table, -t Ім'я набору сутностей. — обов’язковий аргумент.
--id, -i GUID запису.
--key, -k Альтернативний ключ.
--data, -d Об'єкт JSON із полями, які потрібно оновити.
--data-file Шлях до файлу JSON із даними про оновлення.
--return, -r Повертає повний оновлений запис.
--target Маршрут до dataverse (за замовчуванням) або зв'язаного erp середовища.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data update Приклади

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

data upload команда

Передавання локального файлу до стовпця Dataverse file у наявному записі. Команда автоматично вибирає один запит або завантажений фрагмент на основі розміру файлу, якщо не вказано --mode. В автоматичному режимі файли розміром до 128 МБ передаються за одним запитом, а великі файли використовують завантажені фрагменти. Коли ви не пропустите --mime-type, команда висуває тип MIME із розширення файлу. Невідомі розширення за замовчуванням для application/octet-stream.

data upload Параметри

Параметр. Опис
--table, -t Схема таблиці або логічне ім'я, наприклад account. — обов’язковий аргумент. Команда усуває набір сутностей із метаданих.
--id, -i GUID запису. — обов’язковий аргумент.
--column, -c Ім'я атрибута стовпця файлу. — обов’язковий аргумент.
--file, -f Шлях до локального файлу. — обов’язковий аргумент.
--mode, -m Стратегія передавання: auto (за замовчуванням) smallабо chunk.
--mime-type Явний тип MIME. За замовчуванням: висувається з розширення файлу.
--overwrite Перезаписати наявний файл. За замовчуванням команда завершується невдало, якщо стовпець не пустий.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data upload Приклади

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 команда

Створіть запис, якщо він не існує, або оновіть його, якщо він це робить. Запис ідентифікується за допомогою альтернативного ключа. Використання альтернативного ключа для посилання на запис

data upsert параметри

Параметр. Опис
--table, -t Ім'я набору сутностей. — обов’язковий аргумент.
--key, -k Альтернативний ключ. — обов’язковий аргумент.
--data, -d Об'єкт JSON зі значеннями полів.
--data-file Шлях до файлу JSON.
--update-only Помилка, якщо запис не існує (If-Match: *).
--create-only Помилка, якщо запис уже існує (If-None-Match: *).
--return, -r Повертає повний запис після операції.
--target Маршрут до dataverse (за замовчуванням) або зв'язаного erp середовища.
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

data upsert Приклади

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

erp batch cancel команда

Скасувати завдання пакета фінансів і операцій за його RecId. Використовується erp batch list для пошуку RecId.

erp batch cancel Приклади

dataverse erp batch cancel <recid>

erp batch list команда

Завдання пакетного списку в екземплярі "Фінанси та операції", пов'язаному з вашим середовищем Dataverse. Для цієї команди потрібен профіль автентифікації, підключений до середовища Dataverse, яке має зв'язаний екземпляр "Фінанси та операції". URL-адреса "Фінанси та операції" походить автоматично з поточного зв'язку Dataverse.

erp batch list Параметри

Параметр. Опис
--company Фільтрувати за юридичною особою (dataAreaId), наприклад USMF.
--status Фільтрувати за станом: Waiting, Executing, Finished, Errorабо Cancelled.
--top Максимальна кількість результатів для повернення. За замовчуванням: 20.
--caption Фільтрувати за підписом (збіг із підрядковим підрядковим виразом у регістрі).
--json Вихідний сирий JSON.

erp batch list Приклади

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

install команда

Інсталюйте певну версію CLI Dataverse або оновіть систему до останньої версії. Команда визначає, чи ви інсталювали CLI глобально або використовуєте npx та інсталюєте відповідним чином.

install Приклади

Інсталюйте найновішу версію:

dataverse install latest

Інсталюйте певну версію:

dataverse install 1.0.0

mcp команда

Запускає сервер mcp, який підключається до середовища, щоб помічники зі ШІ, як-от Claude Desktop, могли взаємодіяти з вашими даними. Цільовий об'єкт автоматично виявляється за URL-адресою: URL-адреса Dataverse запускає сервер Dataverse MCP, а URL-адреса фінансової та операційної системи, наприклад https://myorg.operations.dynamics.com, запускає сервер ERP MCP.

mcp Синтаксис

dataverse mcp <orgUrl> [options]

Аргумент <orgUrl> – це URL-адреса вашої організації, наприклад https://myorg.crm.dynamics.com.

mcp Параметри

Параметр. Опис
--validate Перевірте кінцеві точки MCP і налаштування автентифікації, не запускаючи сервер.
--log-level Установіть рівень журналювання: Trace, , InformationDebug, Warning, Errorабо Critical. За замовчуванням: Warning.
--log-file Увійдіть у файл у тимчасовому каталозі.
--preview Використовуйте кінцеву точку попереднього перегляду MCP (api/mcp_preview замість api/mcp). Не підтримується для ERP.

mcp Приклади

Перевірте налаштування (рекомендований перший крок):

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

Запустіть сервер, використовуючи транспорт stdio:

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

Використовуйте кінцеву точку попереднього перегляду або ввімкніть журналювання файлів налагодження:

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

mcp allow команда

Переконайтеся, що програму Microsoft Entra розташовано в списку дозволених клієнтів Dataverse MCP для середовища поточного профілю. Ця команда є альтернативою кроку адміністрування вручну, описаному в попередніх вимогах. Автентифікований користувач повинен мати дозволи адміністратора Dataverse в цільовому середовищі.

mcp allow Синтаксис

dataverse mcp allow <appId> [options]

Аргумент <appId> – це ідентифікатор програми (клієнта), який можна дозволити як GUID.

mcp allow Параметри

Параметр. Опис
--erp Дозволити застосунок у зв'язаному екземплярі "Фінанси та операції" замість Dataverse.

mcp allow Приклади

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

Примітка

Функція "Фінанси та операції" кешує список дозволених даних у AOS, тому для набрання чинності нещодавно дозволеного ідентифікатора програми може знадобитися до п'яти хвилин.

org list команда

Перелічіть усі середовища, до яких можна отримати доступ.

org list параметри

Параметр. Опис
--filter Фільтрувати список середовищ за пошуковим терміном.
--json Вихідний сирий JSON.

org list Приклади

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

org who команда

Відображення відомостей про поточну організацію та користувача за допомогою активного профілю автентифікації. Команда env – це псевдонім для org.

org who параметри

Параметр. Опис
--environment, -env Перевизначити URL-адресу середовища.
--json Вихідний сирий JSON.

org who Приклади

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

skill Команди

Керування навичками dataverse – наборами інструкцій для повторного використання (файлом SKILL.md і його файлами ресурсів), які використовують агенти ШІ, які зберігаються в підключеному середовищі. Команди верхнього рівня skill дають змогу створювати, читати, оновлювати та видаляти операції з середовищем. Локально навички зберігаються в розділі .claude/skills/<name>/.

Примітка

Команди для створення та оцінювання навичок, наприклад make, update, get, і eval, відокремлено від цих команд. Щоб отримати додаткові відомості, запустіть .dataverse workspace skill --help

skill delete команда

Видаліть навичку та всі її ресурси з активного середовища Dataverse. Використовується skill list для пошуку унікальних імен навичок.

dataverse skill delete new_lead-qualification

skill download команда

Завантажте один або кілька навичок з активного середовища Dataverse на диск. Команда завантажує SKILL.md файл і всі файли ресурсів, зберігаючи структуру каталогу. Використовується skill list для пошуку унікальних імен навичок.

Параметр. Опис
--all Завантажте всі активні навички з середовища. Не можна поєднати з унікальним ім'ям навички.
--output, -o Основний каталог для виводу. За замовчуванням: .claude/skills/. З --all, кожен навички записується до <path>/<name>/.
--json Виводьте вміст навички як JSON, не записуючи файли. За потреби вкажіть шлях до файлу для записування. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list команда

Перелічіть усі активні навички в підключеному середовищі Dataverse.

Параметр. Опис
--resources, -r Також перелічіть файли ресурсів для кожного навички.
--json Вивести як JSON. За потреби вкажіть шлях до файлу для записування. 
dataverse skill list
dataverse skill list --resources

skill upload команда

Передавання одного або кількох навичок із диска до активного середовища Dataverse. Ця команда підтримує каталоги, .zip файли, файли .skill і файли MD .

Ви можете передати навичку <name>, яка вирішує .claude/skills/<name>/, або явний <path> до каталогу чи файлу.

Параметр. Опис
--all Передати всі навички в розділі .claude/skills/. Не можна поєднати з іменем або шляхом навички.
--json Вивід результату як JSON. За потреби вкажіть шлях до файлу для записування. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Додаткові відомості

Робота з даними за допомогою CLI Dataverse

  • Last updated on