"Dataverse" CLI nuoroda (peržiūra)

Pastaba

  • Tai yra peržiūros versijos funkcija.
  • Peržiūros funkcijos nėra skirtos naudoti gamybai ir gali būti apribotas jų funkcionalumas. Šias funkcijas galima naudoti prieš oficialų išleidimą, kad klientai galėtų gauti ankstyvą prieigą ir pateikti atsiliepimų.

Šiame straipsnyje aprašomos " Dataverse" CLI galimos komandos. Kiekviena komanda palaiko --help parinktį, kurioje pateikiamas jos naudojimas, parinktys ir pavyzdžiai. Komandos, kurios pateikia duomenis, --json palaiko neapdorotos JSON išvesties parinktį, kuri naudinga scenarijuose.

Su bet kokia komanda galima naudoti šias visuotines parinktis:

Parinktis Aprašą
--log-level <level> Nustatyti registravimo lygį: , , , , arba ErrorCritical. WarningInformationDebugTrace Numatytoji reikšmė: Warning.
--log-file Prisijunkite prie failo laikinajame kataloge, o ne konsolėje.
--context <value> Operacijos kontekstas, pridėtas prie vartotojo agento. Taip pat galite nustatyti aplinkos kintamąjį DATAVERSE_OPERATION_CONTEXT .
Komanda Aprašą
api describe API aprašas
api invoke Iškviesti API pagal pavadinimą
api list Sąrašas aptinkamų API
api request Siųsti autentifikuotą HTTP užklausą
auth create Kurti naują autentifikavimo profilį
auth list Visų autentifikavimo profilių sąrašas
auth remove Autentifikavimo profilio šalinimas
auth select Pasirinkite aktyvų autentifikavimo profilį
auth who Rodyti dabartinį autentifikavimo profilį
data associate Dviejų įrašų susiejimas naudojant ryšį
data count Įrašų skaičiavimas lentelėje
data create Sukurti naują įrašą
data delete Įrašo naikinimas
data describe Apibūdinti objekto schemą
data disassociate Ryšio tarp dviejų įrašų šalinimas
data get Vieno įrašo gavimas pagal ID arba alternatyvų raktą
data query "OData", "FetchXML" arba SQL užklausos vykdymas
data update Naujinti esamą įrašą
data upload Failo nusiuntimas į esamo įrašo failo stulpelį
data upsert Įrašo kūrimas arba naujinimas alternatyviu raktu
erp batch cancel "Finance and Operations" paketinės užduoties atšaukimas
erp batch list Išvardyti finansų ir operacijų paketines užduotis
install Įdiekite konkrečią versiją arba atnaujinkite į naujausią versiją
mcp MCP serverio, skirto "Dataverse" arba ERP, paleidimas
mcp allow Leisti programą kaip MCP klientą
org list Visų neįgaliesiems pritaikytų aplinkų sąrašas
org who Rodyti dabartinę organizaciją ir vartotojo informaciją
skill delete Įgūdžių naikinimas iš "Dataverse"
skill download Atsisiųsti įgūdžius iš "Dataverse"
skill list Aktyvūs aplinkos įgūdžiai
skill upload Nusiųsti įgūdžius į "Dataverse"

Pastaba

Daugelis komandų palaiko --target <dataverse\|erp> parinktį, kuri nukreipia operaciją į "Dataverse" (numatytąją) arba į susietą finansų ir operacijų (ERP) aplinką. Komandos, kurios jungiasi prie aplinkos, palaiko --environment <url> (-env) parinktį nepaisyti dabartinio profilio aplinkos URL.

api describe komanda

Rodyti vienos API metaduomenis. Naudojant "Dataverse" pasirinktines API, išvestis apima užklausos parametrą ir atsakymo ypatybės aprašus, kai metaduomenys juos pateikia.

Pagal numatytuosius nustatymus "Dataverse" pavadinimai nėra prefiksuojami. Galite naudoti ERP apibrėžtus pavadinimus formoje erp:ServiceGroup/Service/Operation.

api describe Parametrus

Parametras Aprašą
--target Išspręskite nekvalifikuotą vardą pagal dataverse arba erp.
--service-group Tik ERP. Susiaurinti operacijos peržvalgą iki vienos tarnybos grupės.
--service Tik ERP. Susiaurinti operacijos peržvalgą iki vienos tarnybos.
--environment Perrašyti "Dataverse" aplinkos URL.
--json Išvesite neapdorotą JSON.

api describe Pavyzdžiai

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

api invoke komanda

Iškviesti aptiktą API pagal pavadinimą. Naudokite name=value sintaksę parametrams. Jei reikšmėje yra tarpų, citakite visą atpažinimo ženklą. Kai kurios "Dataverse" API priima eilutės parametrą, kurio turinys pats yra JSON. Tokiu atveju perduokite JSON tekstą kaip reikšmę naudodami įprastas apvalkalo citavimo ir išėmimo taisykles.

Pagal numatytuosius nustatymus JSON atsakymai generuojami draugišku teksto formatu, kuris išlaiko išvesties ypatybių pavadinimus. Naudojama --json išsaugoti neapdorotą JSON paketo turinį.

api invoke Parametrus

Parametras Aprašą
--target Išspręskite nekvalifikuotą vardą pagal dataverse arba erp.
--service-group Tik ERP. Susiaurinti operacijos peržvalgą iki vienos tarnybos grupės.
--service Tik ERP. Susiaurinti operacijos peržvalgą iki vienos tarnybos.
--param Įtraukite pavadintą parametrą į name=value formą. Kartojamas.
--bind Su subjektu susietų "Dataverse" API susiejimo kelias.
--method, -X Nepaisyti numanomo HTTP metodo.
--body Vietoj pavadintų parametrų naudokite neapdorotą JSON tekstą.
--body-file Skaityti neapdorotą JSON tekstą iš failo.
--header, -H Įtraukite HTTP antraštę į key:value formą.
--include, -i Įtraukite atsakymo būseną ir antraštes.
--environment Perrašyti "Dataverse" aplinkos URL.
--json Išveskite neapdorotą JSON, o ne draugišką tekstą.

api invoke Pavyzdžiai

Iškviesti funkciją Dataverse. Šiame pavyzdyje parodytas funkcijos Dynamics 365 Contact Center CCaaS_GetPresence naudojimas.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Iškviesti veiksmą Dataverse AISummarize su tarpais parametro reikšmėje:

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

Iškviesti ERP pasirinktinę tarnybą:

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

api list komanda

Išvardijamos aptinkamos API, pvz., "Dataverse" pasirinktinės API ir ERP iškvietimo tarnybos galiniai punktai. Rezultatai rodo API tapatybę, draugišką pavadinimą, tipą ir aprašą, kai yra. Galite perduoti pasirinktinį užklausos terminą rezultatams filtruoti.

api list Parametrus

Parametras Aprašą
--target Tikslinė sistema, kurios ieškoti: dataverse (numatytoji reikšmė) arba erp.
--service-group Tik ERP. Filtruoti į vieną paslaugų grupę.
--service Tik ERP. Filtruoti pagal vieną tarnybą.
--limit Maksimalus pateikiamų API skaičius. Numatytoji reikšmė: 50.
--page Puslapių kaitos rezultatuose 1 pagrįstas puslapio numeris. Numatytoji reikšmė: 1.
--environment Perrašyti "Dataverse" aplinkos URL.
--json Išvesite neapdorotą JSON.

api list Pavyzdžiai

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 komanda

Siųsti neapdorotą autentifikuotą HTTP užklausą Dataverse arba ERP. Naudokite šią komandą, kai reikia visiškai kontroliuoti kelią, metodą, antraštes ir tekstą.

api request Parametrus

Parametras Aprašą
--target Tikslinė sistema: dataverse arba erp. Būtinas.
--path Užklausos kelias. Būtinas.
--method, -X HTTP metodas. Numatytoji reikšmė: GETarba POST kai pateikiamas tekstas.
--body Įdėtasis JSON užklausos tekstas.
--body-file Failas, kuriame yra JSON objekto užklausos tekstas.
--header, -H Įtraukite HTTP antraštę į key:value formą.
--include, -i Įtraukite atsakymo būseną ir antraštes.
--environment Perrašyti "Dataverse" aplinkos URL.

api request Pavyzdžiai

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 komanda

Sukurkite naują autentifikavimo profilį.

auth create parametrai

Naudodami šiuos parametrus nurodykite komandos veikimą auth create .

Parametras Aprašą
--environment, -env "Dataverse" aplinkos, su kuria norite autentifikuoti, URL.
--name, -n Pasirinktinis profilio pavadinimas. Naudokite pavadinimą, kad pasirinktumėte profilį vėliau.
--cloud, -ci Tikslinis debesis: Public, UsGov, UsGovHigh, UsGovDodarba China.
--deviceCode, -dc Naudokite įrenginio kodo autentifikavimo srautą aplinkose be naršyklės.
--username, -un Vartotojo vardas vartotojo vardui ir slaptažodžio autentifikavimui.
--password, -p Vartotojo vardo ir slaptažodžio autentifikavimo slaptažodis.
--applicationId, -id Taikomosios programos (kliento) pagrindinio tarnybos nario (SPN) autentifikavimo ID.
--clientSecret, -cs Pagrindinio tarnybos autentifikavimo kliento paslaptis.
--certificateDiskPath, -cdp Sertifikatu pagrįsto autentifikavimo kelias į .pfx sertifikato failą.
--certificatePassword, -cp Sertifikato slaptažodis.
--tenant, -t Nuomotojo ID. Būtina pagrindiniam tarnybos autentifikavimui.
--managedIdentity, -mi Naudokite Azure valdomą tapatybę.
--githubFederated, -ghf Naudokite GitHub Actions išorinį autentifikavimą.
--azureDevOpsFederated, -adof Naudokite Azure DevOps išorinį autentifikavimą.
--clientid, -cid Pasirinktinis Microsoft Entra taikomosios programos kliento ID, naudojamas vietoj numatytosios "Dataverse" CLI programos.
--no-default-environment Nenustatykite aplinkos kaip numatytosios.
--accept-cleartext-caching Leisti paprastojo teksto atpažinimo ženklų talpyklą sistemoje "Linux".

auth create Pavyzdžiai

Tolesniuose pavyzdžiuose parodyta, kaip naudoti komandą auth create .

Interaktyvusis autentifikavimas

Ši komanda atidaro naršyklės arba sistemos dialogo langą, kuriame rasite papildomos informacijos.

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

Pavadintas profilis

Sukurkite profilį su konkrečiu pavadinimu.

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

Įrenginio kodo srautas

Aplinkose be naršyklės naudokite įrenginio kodo srautą.

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

Pagrindinis tarnybos pavadinimas su kliento slaptu

Naudokite pagrindinį tarnybos pavadinimą, kai jums reikia bendrai naudojamo autentifikavimo, pvz., CI / CD sraute arba kitame automatizuotame scenarijuje, kuriame negalimas interaktyvus prisijungimas. Pateikite taikomosios programos, kuri turi prieigą prie aplinkos, taikomosios programos ID, kliento slaptą ir nuomotojo ID.

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

Pasirinktinis "Entra" programos kliento ID

Vietoj numatytosios naudokite savo taikomosios programos registraciją.

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

auth list komanda

Išvardyti visus autentifikavimo profilius. Pridėti --json prie neapdorotos JSON išvesties.

auth list Pavyzdžiai

dataverse auth list
dataverse auth list --json

auth remove komanda

Pašalinkite vieną arba visus autentifikavimo profilius.

auth remove Parametrus

Parametras Aprašą
--index, -i Pašalinkite profilį naudodami nurodytą 1 pagrįstą indeksą, kaip parodyta auth list.
--name, -n Pašalinkite profilį nurodytu pavadinimu.
--all Pašalinti visus profilius.

auth remove Pavyzdžiai

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

auth select komanda

Pasirinkite aktyvų autentifikavimo profilį. Vykdykite komandą be parinkčių, kad būtų pateikti visi profiliai.

auth select Parametrus

Parametras Aprašą
--index, -i Pasirinkite profilį pagal jo 1 pagrįstą indeksą, kaip parodyta auth list.
--name, -n Pasirinkite profilį pagal pavadinimą.

auth select Pavyzdžiai

Atidaryti interaktyvų parinkiklį. Naudokite rodyklių klavišus arba įveskite, kad filtruotumėte:

dataverse auth select

Pasirinkite profilį pagal indeksą arba pavadinimą:

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

auth who komanda

Rodyti dabartinį, aktyvų autentifikavimo profilį. Pridėti --json prie neapdorotos JSON išvesties.

auth who Pavyzdžiai

dataverse auth who
dataverse auth who --json

data associate komanda

Susieti du įrašus naudojant naršymo ypatybę (ryšį). Ši komanda palaikoma tik "Dataverse".

data associate Parametrus

Parametras Aprašą
--table, -t Pirminio įrašo objektų rinkinio pavadinimas. Būtinas.
--id, -i Pirminio įrašo GUID. Būtinas.
--relationship, -rel Naršymo ypatybės pavadinimas. Būtinas.
--related Susijusios lentelės objekto rinkinio pavadinimas. Būtinas.
--related-id Susijusio įrašo GUID. Būtinas.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data associate Pavyzdžiai

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

data count komanda

Skaičiuoti lentelės įrašus,pasirinktinai filtruotus.

data count Parametrus

Parametras Aprašą
--table, -t Objektų rinkinio pavadinimas. Būtina, nebent naudojate --fetchxml.
--filter, -f "OData" $filter reiškinys.
--fetchxml "FetchXML" sudėtinių skaičių agregavimo užklausa.
--target Nukreipti į dataverse (numatytąją) arba susietą erp aplinką.
--cross-company Tik ERP. Skaičiuoti visose įmonėse. Numatytasis parametras: numatytoji vartotojo įmonė.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data count Pavyzdžiai

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

data create komanda

Kurti naują įrašą "Dataverse" lentelėje. Nustatykite peržvalgos stulpelius naudodami @odata.bind sintaksę.

data create parametrai

Parametras Aprašą
--table, -t Objektų rinkinio pavadinimas. Būtinas.
--data, -d JSON objektas su lauko reikšmėmis.
--data-file Kelias į JSON failą su įrašo duomenimis.
--return, -r Pateikti visą sukurtą įrašą.
--target Nukreipti į dataverse (numatytąją) arba susietą erp aplinką.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data create Pavyzdžiai

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

Patarimas

Naudojama --data-file sudėtingiems JSON. Naudokite --return --json norėdami gauti visą sukurtą įrašą.

data delete komanda

Panaikinkite vieną įrašą pagal pirminį raktą arba alternatyvų raktą.

data delete parametrai

Parametras Aprašą
--table, -t Objektų rinkinio pavadinimas. Būtinas.
--id, -i Įrašo GUID.
--key, -k Alternatyvusis klavišas.
--no-confirm Praleisti patvirtinimo raginimą.
--target Nukreipti į dataverse (numatytąją) arba susietą erp aplinką.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data delete Pavyzdžiai

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

data describe komanda

Apibūdinkite "OData" objekto schemą. Naudojant "Dataverse", komanda iškviečia EntityDefinitions(LogicalName='<table>')$expand valdomą --include"", taip pat antrą skambutį, customapis kai --include actions nustatytas. Įtaisytieji "Dataverse" veiksmai, pvz., Assign ir SetState nėra išvardyti. Naudojant ERP, vienas skambutis /Metadata/PublicEntities pateikia ypatybes, susietuosius veiksmus ir naršymą kartu.

data describe Parametrus

Parametras Aprašą
--target Paskirtis: dataverse (numatytoji reikšmė) arba erp.
--table, -t Būtinas. Jei naudojate "Dataverse", loginis pavadinimas, pvz account., . ERP objektų rinkinio pavadinimas, pvz BatchJobs., .
--include Kableliais atskirtų sekcijų sąrašas, kurias reikia įtraukti: entity, properties, relations, actionsarba all. Pseudonimai: attributes=properties, relationships=relations. Numatytoji ERP reikšmė: all. Numatytoji dataverse: entity,properties.
--json Išvesite neapdorotą JSON.

data describe Pavyzdžiai

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

data disassociate komanda

Pašalinkite dviejų įrašų ryšį. Ši komanda palaikoma tik "Dataverse".

data disassociate Parametrus

Parametras Aprašą
--table, -t Pirminio įrašo objektų rinkinio pavadinimas. Būtinas.
--id, -i Pirminio įrašo GUID. Būtinas.
--relationship, -rel Naršymo ypatybės pavadinimas. Būtinas.
--related-id Susijusio įrašo GUID, skirtas ryšiui "daugelis su daugeliu". Praleisti šį parametrą, kad būtų išvalyta peržvalga.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data disassociate Pavyzdžiai

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

data get komanda

Gaukite vieną įrašą pagal jo ID (pirminį raktą) arba alternatyvų raktą.

data get Parametrus

Parametras Aprašą
--table, -t Objektų rinkinio pavadinimas. Būtinas.
--id, -i Įrašo GUID (pirminis raktas).
--key, -k Alternatyvusis klavišas, pvz. "col='val'", .
--select, -s Kableliais atskirtų stulpelių sąrašas ($select).
--expand, -x Susijusių įrašų "OData $expand " išraiška.
--target Nukreipti į dataverse (numatytąją) arba susietą erp aplinką.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data get Pavyzdžiai

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 komanda

Vykdyti "OData", "FetchXML" arba SQL užklausą "Dataverse" lentelėje.

data query Parametrus

Parametras Aprašą
--table, -t Objekto rinkinio pavadinimas užklausai. Būtina "OData" užklausoms.
--select, -s Kableliais atskirtų stulpelių sąrašas ($select).
--filter, -f "OData" $filter reiškinys.
--orderby, -o "OData" $orderby reiškinys.
--top Maksimalus grąžintinų įrašų skaičius (1–5 000).
--expand, -x Susijusių įrašų "OData $expand " išraiška.
--fetchxml Įdėtoji "FetchXML" užklausa.
--fetchxml-file Failo, kuriame yra FetchXML užklausa, kelias.
--sql SQL SELECT užklausa (peržiūra).
--sql-file Failo, kuriame yra SQL užklausa, kelias.
--all, -a Sekite puslapių numeraciją, kad gautumėte visus įrašus.
--max-records Maksimalus įrašų, kuriuos reikia nuskaityti naudojant --all, skaičius. Numatytoji reikšmė: 100000.
--target Nukreipti į dataverse (numatytąją) arba susietą erp aplinką.
--cross-company Tik ERP. Užklausa visose įmonėse. Numatytasis parametras: numatytoji vartotojo įmonė.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data query Pavyzdžiai

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

Sužinokite daugiau

data update komanda

Atnaujinkite vieną ar daugiau esamo įrašo laukų, kurie identifikuojami pagal jo ID arba alternatyvų raktą. Nustatykite peržvalgos stulpelius naudodami @odata.bind sintaksę.

data update Parametrus

Parametras Aprašą
--table, -t Objektų rinkinio pavadinimas. Būtinas.
--id, -i Įrašo GUID.
--key, -k Alternatyvusis klavišas.
--data, -d JSON objektas su laukais, kuriuos reikia atnaujinti.
--data-file Kelias į JSON failą su naujinimo duomenimis.
--return, -r Pateikti visą atnaujintą įrašą.
--target Nukreipti į dataverse (numatytąją) arba susietą erp aplinką.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data update Pavyzdžiai

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

data upload komanda

Nusiųskite vietinį failą į esamo įrašo "Dataverse" failo stulpelį. Komanda automatiškai pasirenka vienos užklausos arba į segmentus nusiuntimą pagal failo dydį, nebent nurodysite --mode. Naudojant automatinį režimą, mažesni nei 128 MB failai nusiunčiami į vieną užklausą, o didesniems failams naudojamas į segmentą nusiuntimas. Kai praleidžiate --mime-type, komanda nustato MIME tipą iš failo plėtinio. Nežinomų plėtinių numatytoji reikšmė yra application/octet-stream.

data upload parametrai

Parametras Aprašą
--table, -t Lentelės schema arba loginis pavadinimas, pvz account., . Būtinas. Komanda išsprendžia objekto rinkinį iš metaduomenų.
--id, -i Įrašo GUID. Būtinas.
--column, -c Failo stulpelio atributo pavadinimas. Būtinas.
--file, -f Vietinio failo kelias. Būtinas.
--mode, -m Nusiuntimo strategija: auto (numatytoji), smallarba chunk.
--mime-type Aiškus MIME tipas. Numatytoji reikšmė: numanoma iš failo plėtinio.
--overwrite Perrašyti esamą failą. Pagal numatytuosius nustatymus komanda nepavyksta, jei stulpelis nėra tuščias.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data upload Pavyzdžiai

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 komanda

Sukurkite įrašą, jei jo nėra, arba atnaujinkite, jei jo nėra. Įrašas identifikuojamas alternatyviu raktu. Sužinokite, kaip naudoti alternatyvų klavišą norint nurodyti įrašą

data upsert Parametrus

Parametras Aprašą
--table, -t Objektų rinkinio pavadinimas. Būtinas.
--key, -k Alternatyvusis klavišas. Būtinas.
--data, -d JSON objektas su lauko reikšmėmis.
--data-file Kelias į JSON failą.
--update-only Nepavyko, jei įrašo nėra (If-Match: *).
--create-only Nepavyko, jei įrašas jau yra (If-None-Match: *).
--return, -r Po operacijos pateikti visą įrašą.
--target Nukreipti į dataverse (numatytąją) arba susietą erp aplinką.
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

data upsert Pavyzdžiai

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

erp batch cancel komanda

Atšaukti "Finance and Operations" paketinę užduotį pagal jos RecId. Naudokite erp batch list norėdami rasti RecId.

erp batch cancel Pavyzdžiai

dataverse erp batch cancel <recid>

erp batch list komanda

Išvardyti paketines užduotis "Finance and Operations" egzemplioriuje, susietame su jūsų "Dataverse" aplinka. Komandai reikia autentifikavimo profilio, prijungto prie "Dataverse" aplinkos, kurioje yra susietas "Finance and Operations" egzempliorius. Finansų ir operacijų URL automatiškai gaunamas iš dabartinio "Dataverse" ryšio.

erp batch list Parametrus

Parametras Aprašą
--company Filtruoti pagal juridinį subjektą (dataAreaId), pvz., USMF.
--status Filtruoti pagal būseną: Waiting, Executing, Finished, Errorarba Cancelled.
--top Maksimalus pateikiamų rezultatų skaičius. Numatytoji reikšmė: 20.
--caption Filtruoti pagal antraštę (neskiestinių raidžių dalinės eilutės atitikmuo).
--json Išvesite neapdorotą JSON.

erp batch list Pavyzdžiai

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

install komanda

Įdiekite konkrečią "Dataverse" CLI versiją arba atnaujinkite į naujausią versiją. Komanda aptinka, ar diegiate CLI visuotinai, ar naudojate npx ir atitinkamai įdiegiate.

install Pavyzdžiai

Įdiekite naujausią versiją:

dataverse install latest

Įdiekite konkrečią versiją:

dataverse install 1.0.0

mcp komanda

Paleidžia modelio konteksto protokolo (MCP) serverį, kuris prisijungia prie jūsų aplinkos, kad DI asistentai, pvz., "Claude Desktop", galėtų sąveikauti su jūsų duomenimis. Paskirties vieta automatiškai aptinkama iš URL: "Dataverse" URL paleidžia "Dataverse" MCP serverį, o finansų ir operacijų URL, pvz https://myorg.operations.dynamics.com., , paleidžia ERP MCP serverį.

mcp sintaksė

dataverse mcp <orgUrl> [options]

Argumentas <orgUrl> yra jūsų organizacijos URL, pvz. https://myorg.crm.dynamics.com, .

mcp Parametrus

Parametras Aprašą
--validate Patikrinkite MCP pabaigos taškus ir autentifikavimo sąranką nepaleidžiant serverio.
--log-level Nustatyti registravimo lygį: , , , , arba ErrorCritical. WarningInformationDebugTrace Numatytoji reikšmė: Warning.
--log-file Prisijunkite prie failo laikinajame kataloge.
--preview Naudokite peržiūros MCP galinį punktą (api/mcp_preview vietoj api/mcp). ERP nepalaikoma.

mcp Pavyzdžiai

Patikrinkite sąranką (rekomenduojamas pirmasis veiksmas):

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

Paleiskite serverį naudodami stdio transportavimo:

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

Naudokite peržiūros galinį punktą arba įgalinkite derinimo failų registravimą:

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

mcp allow komanda

Įsitikinkite, kad Microsoft Entra programa yra "Dataverse" MCP leidžiamų klientų sąraše esamo profilio aplinkoje. Ši komanda yra rankinio administratoriaus veiksmo, aprašyto būtinose sąlygose, alternatyva. Autentifikuotas vartotojas turi turėti "Dataverse" administratoriaus teises paskirties aplinkoje.

mcp allow Sintaksė

dataverse mcp allow <appId> [options]

Argumentas <appId> yra leistinas programos (kliento) ID kaip GUID.

mcp allow Parametrus

Parametras Aprašą
--erp Leisti programą susietame "Finance and Operations" egzemplioriuje, o ne "Dataverse".

mcp allow Pavyzdžiai

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

Pastaba

"Finance and Operations" saugo AOS leidžiamųjų sąrašą į talpyklą, todėl naujai leidžiamas taikomosios programos ID gali įsigalioti maždaug per penkias minutes.

org list komanda

Nurodykite visas aplinkas, kurias galite pasiekti.

org list parametrai

Parametras Aprašą
--filter Filtruoti aplinkų sąrašą pagal ieškos terminą.
--json Išvesite neapdorotą JSON.

org list Pavyzdžiai

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

org who komanda

Rodyti informaciją apie dabartinę organizaciją ir vartotoją, naudojant aktyvų autentifikavimo profilį. Komanda env yra pseudonimas, skirtas org.

org who parametrai

Parametras Aprašą
--environment, -env Perrašyti aplinkos URL.
--json Išvesite neapdorotą JSON.

org who Pavyzdžiai

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

skill Komandas

Valdyti "Dataverse" įgūdžius – pakartotinai naudojamus instrukcijų rinkinius ( SKILL.md failą ir jo išteklių failus), kuriuos naudoja DI agentai, kurie saugomi prijungtoje aplinkoje. Aukščiausio lygio skill komandos teikia kūrimo, skaitymo, naujinimo ir naikinimo operacijas aplinkoje. Vietoje įgūdžiai saugomi dalyje .claude/skills/<name>/.

Pastaba

Įgūdžių kūrimo ir vertinimo komandos, pvz make., , update, getir eval, yra atskirtos nuo šių komandų. Jei reikia daugiau informacijos, paleiskite dataverse workspace skill --help.

skill delete komanda

Panaikinkite įgūdžius ir visus jo išteklius iš aktyvios "Dataverse" aplinkos. Naudokite skill list norėdami rasti unikalius įgūdžių pavadinimus.

dataverse skill delete new_lead-qualification

skill download komanda

Atsisiųskite vieną ar daugiau įgūdžių iš aktyvios "Dataverse" aplinkos į diską. Komanda atsisiunčia SKILL.md failą ir visus išteklių failus, išsaugant katalogo struktūrą. Naudokite skill list norėdami rasti unikalius įgūdžių pavadinimus.

Parametras Aprašą
--all Atsisiųskite visus aktyvius įgūdžius iš aplinkos. Negalima derinti su unikaliu įgūdžių pavadinimu.
--output, -o Pagrindinis išvesties katalogas. Numatytoji reikšmė: .claude/skills/. Naudojant --allkiekvienas įgūdis įrašomas į <path>/<name>/.
--json Išveskite įgūdžių turinį kaip JSON nerašydami failų. Pasirinktinai nurodykite failo kelią, į kuriuo norite rašyti. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list komanda

Nurodykite visus aktyvius įgūdžius prijungtoje "Dataverse" aplinkoje.

Parametras Aprašą
--resources, -r Taip pat nurodykite kiekvieno įgūdžio išteklių failus.
--json Išvestis kaip JSON. Pasirinktinai nurodykite failo kelią, į kuriuo norite rašyti. 
dataverse skill list
dataverse skill list --resources

skill upload komanda

Nusiųskite vieną ar daugiau įgūdžių iš disko į aktyvią "Dataverse" aplinką. Komanda palaiko katalogus, .zip failus, .skill failus ir .md failus.

Galite perduoti įgūdžius <name>, kurie išsprendžia arba .claude/skills/<name>/yra aiškūs <path> katalogui ar failui.

Parametras Aprašą
--all Nusiųskite visus įgūdžius dalyje .claude/skills/. Negalima derinti su įgūdžių pavadinimu arba keliu.
--json Rezultatas pateikiamas kaip JSON. Pasirinktinai nurodykite failo kelią, į kuriuo norite rašyti. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Taip pat žr.

Darbas su duomenimis naudojant "Dataverse" CLI

  • Last updated on