Dataverse CLI анықтамасы (алдын ала қарау)

Ескертпе

  • Бұл алдын ала қарау мүмкіндігі болып табылады.
  • Алдын ала қарау мүмкіндіктері өндірісті пайдалану үшін арналмаған және функционалдық шектеулі болуы мүмкін. Бұл мүмкіндіктер ресми жарияланудан бұрын қолжетімді, сондықтан тұтынушылар ерте қатынаса алады және кері байланыс бере алады.

Бұл мақалада Dataverse CLI-де қолжетімді командалар сипатталған. Әр команда оның қолданылуы, параметрлері және мысалдары көрсетілген опцияны қолдайды --help . Деректерді қайтару командалары скрипттерде пайдалы шикі JSON шығару опциясын қолдайды --json .

Кез келген командамен келесі жаһандық опцияларды қолдануға болады:

Параметр Сипаттама
--log-level <level> Логинг деңгейін орнатыңыз: Trace, Debug, WarningInformation, Error, , немесе Critical. Әдепкі: Warning.
--log-file Консольдің орнына уақытша каталогтағы файлға кіріңіз.
--context <value> Операция контексті User-Agent-ке қосылған. Сондай-ақ қоршаған орта айнымалыны орнатуға 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 ID немесе балама кілт арқылы бір жазбаны алу
data query OData, FetchXML немесе SQL сұрауын орындаңыз
data update Бар жазбаны жаңарту
data upload Бар жазбадағы файл бағанына файлды жүктеу
data upsert Жазбаны балама кілт арқылы жасау немесе жаңарту
erp batch cancel Қаржы және операциялар бөліміндегі топтық жұмысты тоқтату
erp batch list Қаржы және операциялық топтық жұмыстар тізімі
install Белгілі бір нұсқаны орнатыңыз немесе соңғы нұсқаға жаңартыңыз
mcp Dataverse немесе ERP үшін MCP серверін іске қосыңыз
mcp allow Қосымшаны MCP клиенті ретінде рұқсат ету
org list Барлық қолжетімді орталардың тізімі
org who Ағымдағы ұйым мен пайдаланушы ақпаратын көрсету
skill delete Dataverse-тен дағдыны өшіру
skill download Dataverse-тен дағдыны жүктеп алу
skill list Қоршаған ортадағы белсенді дағдыларды тізімдеу
skill upload Дағдыны Dataverse-ке жүктеу

Ескертпе

Көптеген командалар операцияны Dataverse-ке (әдепкі) немесе байланыстырылған Finance and Operations (ERP) ортасына бағыттайтын опцияны қолдайды --target <dataverse\|erp> . Ортаға қосылатын командалар ағымдағы профильдің орта URL-ін өзгерту үшін (-env) опциясын қолдайды --environment <url> .

api describe Басқару

Бір API үшін метадеректерді көрсетіңіз. Dataverse-тің арнайы API-лары үшін шығыс сұраныс параметрлері мен жауап қасиеттерінің сипаттамаларын метадеректер ұсынғанда қамтиды.

Dataverse атаулары әдепкі бойынша префикссіз. ERP-ге сай есімдерді формада erp:ServiceGroup/Service/Operationқолдануға болады.

api describe параметрлер

Параметр Сипаттама
--target Шартсыз атауды немесе dataverseerp.
--service-group Тек ERP. Операция іздеуін бір қызмет тобына тарылтыңыз.
--service Тек ERP. Операциялық іздеуді бір қызметке тарылтыңыз.
--environment Dataverse ортасының URL мекенжайын өзгертіңіз.
--json Шығару raw 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 . Егер мәнде бос орындар болса, бүкіл токенге дәйексөз келтіріңіз. Кейбір Dataverse API-лері өз құрамында JSON болып табылатын жол параметрін қабылдайды. Ондай жағдайда, shell-дің қалыпты дәйексөз және қашу ережелерін пайдаланып, JSON мәтінін мән ретінде беріңіз.

Әдепкі бойынша, JSON жауаптары шығару қасиеттерінің атауларын сақтайтын ыңғайлы мәтіндік форматта көрсетіледі. Шикі JSON жүктемесін сақтау үшін қолданыңыз --json .

api invoke параметрлер

Параметр Сипаттама
--target Шартсыз атауды немесе dataverseerp.
--service-group Тек ERP. Операция іздеуін бір қызмет тобына тарылтыңыз.
--service Тек ERP. Операциялық іздеуді бір қызметке тарылтыңыз.
--param Атаулы параметрді формаға name=value қосыңыз. Қайталанады.
--bind Entity-ге байланған Dataverse API-ларының байланыс жолы.
--method, -X Болжамды HTTP әдісін басып шығарыңыз.
--body Атаулы параметрлердің орнына шикі JSON денесін қолданыңыз.
--body-file Файлдан шикі JSON денесін оқыңыз.
--header, -H HTTP тақырыбын формаға key:value қосыңыз.
--include, -i Жауап күйі мен тақырыптарды қосыңыз.
--environment Dataverse ортасының URL мекенжайын өзгертіңіз.
--json Friendly text емес, raw JSON шығарыңыз.

api invoke Мысалдар

Dataverse функциясын іске қосыңыз. Бұл мысал Dynamics 365 Contact Center CCaaS_GetPresence функциясының қолданылуын көрсетеді.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Dataverse AISummarize әрекетін параметрлік мәндегі бос орындармен шақырыңыз:

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 Басқару

Dataverse-тің арнайы API-лері және ERP шақырылатын қызмет нүктелері сияқты табылатын API-лерді тізімдеңіз. Нәтижелер API сәйкестігін, достық атауын, түрін және сипаттамасын көрсетеді. Нәтижелерді сүзгіден өткізу үшін қосымша сұраныс терминін бере аласыз.

api list параметрлер

Параметр Сипаттама
--target Іздеу үшін мақсатты жүйе: dataverse (әдепкі) немесе erp.
--service-group Тек ERP. Бір қызмет тобына сүзгіден өтіңіз.
--service Тек ERP. Бір қызметке сүзгіден өтіңіз.
--limit Қайтарылатын ең көп API-лер саны. Әдепкі: 50.
--page Нәтижелерді бетке қарағанда 1-ге негізделген бет нөмірі. Әдепкі: 1.
--environment Dataverse ортасының URL мекенжайын өзгертіңіз.
--json Шығару raw 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 Басқару

Dataverse немесе ERP-ге шикі аутентификацияланған HTTP сұранысын жіберіңіз. Бұл команданы жол, әдіс, тақырыптар және дененің толық бақылауы қажет болғанда қолданыңыз.

api request параметрлер

Параметр Сипаттама
--target Мақсатты жүйе: dataverse немесе erp. Міндетті.
--path Сұраныс жолы. Міндетті.
--method, -X HTTP әдісі. Әдепкі: GET, яғни POST дене жеткізілгенде.
--body Ішкі JSON сұраныс денесі.
--body-file JSON объектісін сұрау денесін қамтитын файл.
--header, -H HTTP тақырыбын формаға key:value қосыңыз.
--include, -i Жауап күйі мен тақырыптарды қосыңыз.
--environment Dataverse ортасының URL мекенжайын өзгертіңіз.

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 Сіз аутентификациялағыңыз келетін Dataverse ортасының URL-сі.
--name, -n Профильге қосымша атау. Кейін профилді таңдау үшін атауды пайдаланыңыз.
--cloud, -ci Мақсатты бұлт: Public, UsGov, UsGovHighUsGovDod, , немесе China.
--deviceCode, -dc Браузері жоқ орталар үшін құрылғы кодының аутентификация ағынын қолданыңыз.
--username, -un Пайдаланушы аты мен құпиясөзді аутентификациялау үшін қолданушы атауы.
--password, -p Пайдаланушы аты мен құпиясөзді аутентификациялау үшін құпиясөз.
--applicationId, -id Қызмет негізгі аутентификациясы (SPN) аутентификациясы үшін қосымша (клиент) идентификаторы.
--clientSecret, -cs Клиенттің құпиясы қызмет басшысының аутентификациясы.
--certificateDiskPath, -cdp Сертификатқа негізделген аутентификация үшін .pfx сертификат файлына апаратын жол.
--certificatePassword, -cp Сертификаттың құпия сөзі.
--tenant, -t Жалға алушы ID. Қызмет негізін аутентификациялау үшін қажет.
--managedIdentity, -mi Azure басқарылатын идентификаторды қолданыңыз.
--githubFederated, -ghf GitHub Actions федеративті аутентификациясын қолданыңыз.
--azureDevOpsFederated, -adof Use Azure DevOps federated authentication.
--clientid, -cid Dataverse CLI қосымшасының орнына қолдануға арналған арнайы Microsoft Entra қосымшасының клиент идентификаторы.
--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 құбырында немесе интерактивті кіру мүмкін емес басқа автоматтандырылған скриптте қолданыңыз. Қосымша тіркеуінің ортаға қолжетімділігі бар тіркеу ID-сін, клиент құпиясын және жалға алушы идентификаторын беріңіз.

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

Custom 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 Шығару raw 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 (әдепкі) немесе байланысқан erp ортаға бағыттаңыз dataverse .
--cross-company Тек ERP. Барлық компаниялар бойынша санаңыз. Әдепкі: пайдаланушының әдепкі компаниясы.
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw 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 (әдепкі) немесе байланысқан erp ортаға бағыттаңыз dataverse .
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw 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>)"}'

Кеңес

Күрделі JSON үшін қолдану --data-file . Толық жасалған жазбаны алу үшін қолданамын --return --json .

data delete Басқару

Бір жазбаны бастапқы кілтпен немесе балама кілтпен өшіріңіз.

data delete параметрлер

Параметр Сипаттама
--table, -t Субъектілер жиынының атауы. Міндетті.
--id, -i GUID жазбасы.
--key, -k Басқа кілт.
--no-confirm Растау сұрауын өткізіп жіберіңіз.
--target (әдепкі) немесе байланысқан erp ортаға бағыттаңыз dataverse .
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw JSON.

data delete Мысалдар

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

data describe Басқару

OData субъектісінің схемасын сипаттаңыз. Dataverse үшін команданы EntityDefinitions(LogicalName='<table>')$expand шақыру drived --includeby арқылы және екінші шақыру to customapis to to --include actions орнатылады. Кіріктірілген Dataverse әрекеттері, мысалы Assign , және SetState саналмай. ERP үшін бір шақыру /Metadata/PublicEntities қасиеттерді, байланған әрекеттерді және навигацияны бірге қайтарады.

data describe параметрлер

Параметр Сипаттама
--target Мақсат: dataverse (әдепкі) немесе erp.
--table, -t Міндетті. Dataverse үшін логикалық атау, мысалы account. ERP үшін объектілер жиынының атауы, мысалы BatchJobs.
--include Үтірмен бөлінген бөлімдер тізімі: entity, properties, actionsrelations, , немесе all. Лақап аттар: attributes=properties, relationships=relations. ERP үшін әдепкі: all. Dataverse үшін әдепкі: entity,properties.
--json Шығару raw 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 Шығару raw JSON.

data disassociate Мысалдар

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

data get Басқару

Бір жазбаны оның ID (негізгі кілті) немесе балама кілт арқылы алу.

data get параметрлер

Параметр Сипаттама
--table, -t Субъектілер жиынының атауы. Міндетті.
--id, -i GUID (негізгі кілт) жазбасы.
--key, -k Мысалы "col='val'", балама кілт .
--select, -s Үтірмен бөлінген бағандар тізімі ($select).
--expand, -x Қатысты жазбаларға арналған OData $expand өрнегі.
--target (әдепкі) немесе байланысқан erp ортаға бағыттаңыз dataverse .
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw 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 Басқару

Dataverse кестесіне OData, FetchXML немесе SQL сұрауын орындаңыз.

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 (әдепкі) немесе байланысқан erp ортаға бағыттаңыз dataverse .
--cross-company Тек ERP. Барлық компаниялар бойынша сұрау жүргізіңіз. Әдепкі: пайдаланушының әдепкі компаниясы.
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw 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 Басқару

Бар жазбадағы бір немесе бірнеше өрістерді жаңартыңыз, ID немесе балама кілт арқылы анықталады. Синтаксисті пайдаланып @odata.bind іздеу бағандарын орнатыңыз.

data update параметрлер

Параметр Сипаттама
--table, -t Субъектілер жиынының атауы. Міндетті.
--id, -i GUID жазбасы.
--key, -k Басқа кілт.
--data, -d JSON объектісі, өрістері жаңартылады.
--data-file JSON файлына жаңарту деректері бар жол.
--return, -r Толық жаңартылған жазбаны қайтарыңыз.
--target (әдепкі) немесе байланысқан erp ортаға бағыттаңыз dataverse .
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw JSON.

data update Мысалдар

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

data upload Басқару

Жергілікті файлды бар жазбадағы Dataverse файл бағанына жүктеңіз. Команда файл өлшеміне қарай бір сұраныс немесе бөлікке бөлінген жүктеуді автоматты түрде таңдайды, егер сіз көрсетпесеңіз --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 Шығару raw 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 (әдепкі) немесе байланысқан erp ортаға бағыттаңыз dataverse .
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw JSON.

data upsert Мысалдар

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

erp batch cancel Басқару

Қаржы және операциялар бөлімшесіндегі топтық жұмысты RecIdтоқтату. Пайдалану erp batch listRecIdүшін .

erp batch cancel Мысалдар

dataverse erp batch cancel <recid>

erp batch list Басқару

Dataverse ортаңызға байланысты Finance and Operations инстанциясында пакеттік жұмыстарды тізімдеңіз. Бұл команда Dataverse ортасына қосылған аутентификация профилін талап етеді, онда Finance және Operations инстанциялары қосылған. Қаржы және операциялар URL-і ағымдағы Dataverse қосылымынан автоматты түрде алынады.

erp batch list параметрлер

Параметр Сипаттама
--company Заңды тұлға бойынша сүзгіден (dataAreaId), мысалы USMF.
--status Күйі бойынша сүзгі: Waiting, Executing, FinishedError, , немесе Cancelled.
--top Нәтижелердің ең көп саны. Әдепкі: 20.
--caption Жазу бойынша сүзу (регистрге сезімтал емес қосалқы жолдардың сәйкестігі).
--json Шығару raw JSON.

erp batch list Мысалдар

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

install Басқару

Dataverse CLI-дің нақты нұсқасын орнатыңыз немесе соңғы нұсқасына жаңартыңыз. Бұл команда CLI-ді жаһандық түрде орнатқаныңызды немесе қолданып npx жатқаныңызды анықтап, сәйкес орнатады.

install Мысалдар

Соңғы нұсқасын орнатыңыз:

dataverse install latest

Нақты нұсқасын орнатыңыз:

dataverse install 1.0.0

mcp Басқару

Сіздің ортаңызға қосылатын Model Context Protocol (MCP) серверін іске қосады, осылайша Claude Desktop сияқты AI көмекшілері деректеріңізбен өзара әрекеттесе алады. Мақсатты URL арқылы автоматты түрде анықталады: Dataverse URL Dataverse MCP серверін, ал Finance and Operations 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, Debug, WarningInformation, 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

Алдын ала қарау нүктесін қолданыңыз немесе debug файлдарын журналдауды қосыңыз:

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> — GID ретінде рұқсат беретін қосымша (клиент) идентификаторы.

mcp allow параметрлер

Параметр Сипаттама
--erp Қосымшаны Dataverse орнына байланыстырылған Finance and Operations инстанциясында қолдануға рұқсат беріңіз.

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 Шығару raw JSON.

org list Мысалдар

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

org who Басқару

Ағымдағы ұйым мен пайдаланушы туралы ақпаратты белсенді аутентификация профилі арқылы көрсетіңіз. Бұл команда . үшін лақап orgат болып табылады.env

org who параметрлер

Параметр Сипаттама
--environment, -env Орта URL-ін өзгертіңіз.
--json Шығару raw JSON.

org who Мысалдар

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

skill Командалар

Dataverse дағдыларын басқару — AI агенттері қолданатын қайта пайдаланылатын нұсқаулар жиынтықтарын ( SKILL.md файл және оның ресурс файлдары) — қосылған ортада сақталады. Жоғарғы деңгейдегі skill командалар қоршаған ортаға қарсы жасау, оқу, жаңарту және жою операцияларын қамтамасыз етеді. Жергілікті деңгейде дағдылар . астында .claude/skills/<name>/сақталады.

Ескертпе

Дағдыларды құру және бағалау командалары, мысалыmake, updategetжәне 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/. Әр қабілет <path>/<name>/.--all
--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

Тағы қараңыз

Dataverse CLI арқылы деректермен жұмыс істеу

  • Last updated on