Dataverse CLI atsauce (priekšskatījums)

Piezīme

  • Šis ir priekšskatījuma līdzeklis.
  • Priekšskatījuma līdzekļi nav paredzēti komerciālai lietošanai, un to funkcionalitāte var būt ierobežota. Šie līdzekļi ir pieejami pirms oficiālā laidiena, lai klienti varētu priekšlaikus piekļūt līdzeklim un sniegt atsauksmes.

Šis raksts apraksta komandas, kas pieejamas Dataverse CLI. Katra komanda atbalsta opciju --help , kas norāda tās lietojumu, opcijas un piemērus. Komandas, kas atgriež datus, atbalsta --json iespēju neapstrādātai JSON izvadei, kas ir noderīga skriptos.

Ar jebkuru komandu var izmantot šādas globālās opcijas:

Iespēja Apraksts
--log-level <level> Iestatiet žurnāla līmeni: Trace, Debug, Information, Warning, Error, , vai Critical. Noklusējums: Warning.
--log-file Pieslēdzies failam pagaidu direktorijā, nevis konsolē.
--context <value> Operācijas konteksts pievienots lietotāja aģentam. Tu vari arī iestatīt DATAVERSE_OPERATION_CONTEXT vides mainīgo.
Komanda Apraksts
api describe API apraksts
api invoke Izsauciet API pēc nosaukuma
api list Uzskaitīt atklājamus API
api request Nosūtiet autentificētu HTTP pieprasījumu
auth create Izveidot jaunu autentifikācijas profilu
auth list Uzskaitiet visus autentifikācijas profilus
auth remove Autentifikācijas profila noņemšana
auth select Izvēlieties aktīvo autentifikācijas profilu
auth who Rādīt pašreizējo autentifikācijas profilu
data associate Sasaistiet divus ierakstus caur attiecībām
data count Skaitīšanas ieraksti tabulā
data create Izveidot jaunu ierakstu
data delete Ieraksta izdzēšana
data describe Aprakstiet entitātes shēmu
data disassociate Noņemiet attiecības starp diviem ierakstiem
data get Iegūt vienu ierakstu pēc ID vai alternatīvas atslēgas
data query Izpildi OData, FetchXML vai SQL vaicājumu
data update Atjaunināt esošu ierakstu
data upload Augšupielādējiet failu faila kolonnā esošā ierakstā
data upsert Izveidot vai atjaunināt ierakstu, izmantojot alternatīvu atslēgu
erp batch cancel Atcelt Finanšu un operāciju partijas darbu
erp batch list Saraksta finanšu un operāciju partiju darbi
install Instalējiet konkrētu versiju vai atjauniniet uz jaunāko versiju
mcp Palaist MCP serveri Dataverse vai ERP
mcp allow Atļaut lietotni kā MCP klientu
org list Uzskaitīt visas pieejamās vides
org who Rādīt pašreizējo organizāciju un lietotāju informāciju
skill delete Dzēst prasmi no Dataverse
skill download Lejupielādējiet prasmi no Dataverse
skill list Uzskaiti aktīvās prasmes vidē
skill upload Augšupielādē prasmi Dataverse

Piezīme

Daudzas komandas atbalsta --target <dataverse\|erp> opciju, kas novirza operāciju uz Dataverse (noklusējums) vai uz saistīto Finance and Operations (ERP) vidi. Komandas, kas savienojas ar vidi, atbalsta --environment <url> (-env) opciju, lai pārrakstītu pašreizējā profila vides URL.

api describe pavēlēt

Parādi metadatus vienam API. Dataverse pielāgotajiem API izvade ietver pieprasījuma parametru un atbildes īpašību aprakstus, kad metadati tos sniedz.

Dataverse nosaukumi pēc noklusējuma ir bez prefiksa. Jūs varat izmantot ERP kvalificētus vārdus formā erp:ServiceGroup/Service/Operation.

api describe Parametri

Parametrs Apraksts
--target Atrisināt nekvalificētu vārdu pret dataverse vai erp.
--service-group Tikai ERP. Sašauriniet operācijas meklēšanu līdz vienai servisa grupai.
--service Tikai ERP. Sašauriniet operācijas meklēšanu līdz vienam servisam.
--environment Pārrakstīt Dataverse vides URL.
--json Izvadi neapstrādātu JSON.

api describe Piemēri

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

api invoke pavēlēt

Izsauc atklātu API pēc nosaukuma. Izmantojiet name=value sintaksi parametriem. Ja vērtība satur atstarpes, citējiet visu tokenu. Daži Dataverse API pieņem virknes parametru, kura saturs pats par sevi ir JSON. Šādā gadījumā nodod JSON tekstu kā vērtību, izmantojot čaulas parastos citēšanas un izkļūšanas noteikumus.

Pēc noklusējuma JSON atbildes tiek attēlotas draudzīgā teksta formātā, kas saglabā izvades īpašību nosaukumus. Izmanto, --json lai saglabātu neapstrādāto JSON datu plūsmu.

api invoke Parametri

Parametrs Apraksts
--target Atrisināt nekvalificētu vārdu pret dataverse vai erp.
--service-group Tikai ERP. Sašauriniet operācijas meklēšanu līdz vienai servisa grupai.
--service Tikai ERP. Sašauriniet operācijas meklēšanu līdz vienam servisam.
--param Pievienojiet nosauktu parametru name=value formā. Atkārtojams.
--bind Saites ceļš entītiju ierobežotām Dataverse API.
--method, -X Pārrakstīt izsecināto HTTP metodi.
--body Izmantojiet neapstrādātu JSON ķermeni, nevis nosauktos parametrus.
--body-file Izlasi neapstrādātu JSON tekstu no faila.
--header, -H Pievienojiet HTTP galveni formā key:value .
--include, -i Iekļaujiet atbildes statusu un galvenes.
--environment Pārrakstīt Dataverse vides URL.
--json Izvadi neapstrādātu JSON, nevis draudzīgu tekstu.

api invoke Piemēri

Izsauciet Dataverse funkciju. Šis piemērs parāda Dynamics 365 Contact Center CCaaS_GetPresence funkcijas izmantošanu.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Izsauc Dataverse AISummarize darbību ar atstarpēm parametra vērtībā:

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

Izsauciet ERP pielāgotu pakalpojumu:

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

api list pavēlēt

Uzskaitiet atklājamos API, piemēram, Dataverse pielāgotos API un ERP atsaucamo pakalpojumu galapunktus. Rezultāti parāda API identitāti, draudzīgo nosaukumu, veidu un aprakstu, ja tas ir pieejams. Jūs varat nodot izvēles vaicājuma terminu, lai filtrētu rezultātus.

api list Parametri

Parametrs Apraksts
--target Mērķa sistēma, ko meklēt: dataverse (noklusējuma) vai erp.
--service-group Tikai ERP. Filtrējiet uz vienu pakalpojumu grupu.
--service Tikai ERP. Filtrējiet uz vienu pakalpojumu.
--limit Maksimālais API skaits, kas jāatgriež. Noklusējums: 50.
--page 1 bāzes lapas numurs, pārlapojot rezultātus. Noklusējums: 1.
--environment Pārrakstīt Dataverse vides URL.
--json Izvadi neapstrādātu JSON.

api list Piemēri

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 pavēlēt

Nosūtiet neapstrādātu autentificētu HTTP pieprasījumu uz Dataverse vai ERP. Izmantojiet šo komandu, kad nepieciešama pilnīga kontrole pār ceļu, metodi, headeriem un ķermeni.

api request Parametri

Parametrs Apraksts
--target Mērķa sistēma: dataverse vai erp. Obligāts arguments.
--path Pieprasījuma ceļš. Obligāts arguments.
--method, -X HTTP metode. Noklusējums: GET, vai POST kad ķermenis tiek piegādāts.
--body Iebūvēts JSON pieprasījuma materiāls.
--body-file Fails, kas satur JSON objekta pieprasījuma ķermeni.
--header, -H Pievienojiet HTTP galveni formā key:value .
--include, -i Iekļaujiet atbildes statusu un galvenes.
--environment Pārrakstīt Dataverse vides URL.

api request Piemēri

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 pavēlēt

Izveidojiet jaunu autentifikācijas profilu.

auth create Parametri

Izmantojiet šos parametrus, lai noteiktu komandas uzvedību auth create .

Parametrs Apraksts
--environment, -env URL uz Dataverse vidi, ar kuru vēlies autentificēties.
--name, -n Profilam ir izvēles nosaukums. Izmantojiet šo vārdu, lai vēlāk izvēlētos profilu.
--cloud, -ci Mērķa mākonis: Public, UsGov, UsGovHigh, UsGovDod, vai China.
--deviceCode, -dc Izmanto ierīces koda autentifikācijas plūsmu vidēm bez pārlūkprogrammas.
--username, -un Lietotājvārds lietotājvārda un paroles autentifikācijai.
--password, -p Parole lietotājvārdam un paroles autentifikācijai.
--applicationId, -id Lietojumprogrammas (klienta) ID pakalpojuma galvenā (SPN) autentifikācijai.
--clientSecret, -cs Klienta slepenā pakalpojuma galvenā autentifikācija.
--certificateDiskPath, -cdp Ceļš uz .pfx sertifikātu failu sertifikātu bāzētai autentifikācijai.
--certificatePassword, -cp Parole sertifikātam.
--tenant, -t Īrnieka ID. Nepieciešama servisa vadītāja autentifikācijai.
--managedIdentity, -mi Izmanto Azure pārvaldītu identitāti.
--githubFederated, -ghf Izmantojiet GitHub Actions federēto autentifikāciju.
--azureDevOpsFederated, -adof Izmantojiet Azure DevOps federatīvo autentifikāciju.
--clientid, -cid Pielāgots Microsoft Entra lietotnes klienta ID, ko izmantot noklusētās Dataverse CLI lietotnes vietā.
--no-default-environment Neiestati vidi kā noklusējumu.
--accept-cleartext-caching Atļaut atklātteksta tokenu kešatmiņu Linux vidē.

auth create Piemēri

Nākamie piemēri parāda, kā izmantot komandu auth create .

Interaktīvā autentifikācija

Šī komanda atver pārlūkprogrammas vai sistēmas dialogu papildu informācijai.

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

Nosauktais profils

Izveido profilu ar konkrētu vārdu.

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

Ierīces koda plūsma

Izmanto ierīces koda plūsmu vidēm bez pārlūkprogrammas.

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

Pakalpojuma vadītājs ar klienta noslēpumu

Izmantojiet pakalpojuma principu, kad nepieciešama autentifikācija bez uzraudzības, piemēram, CI/CD caurulē vai citā automatizētā skriptā, kur interaktīva pieteikšanās nav iespējama. Norādiet lietotnes ID, klienta noslēpumu un lietotāja ID lietotnes reģistrācijai, kurai ir piekļuve videi.

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

Custom Entra app client ID

Izmanto savu lietotnes reģistrāciju, nevis noklusēto.

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

auth list pavēlēt

Uzskaitiet visus autentifikācijas profilus. Pievieno --json neapstrādātu JSON izvadi.

auth list Piemēri

dataverse auth list
dataverse auth list --json

auth remove pavēlēt

Noņemiet vienu vai visus autentifikācijas profilus.

auth remove Parametri

Parametrs Apraksts
--index, -i Noņemiet profilu ar norādīto 1-bāzēto indeksu, kā parādīts .auth list
--name, -n Noņemiet profilu ar norādīto nosaukumu.
--all Noņemt visus profilus.

auth remove Piemēri

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

auth select pavēlēt

Izvēlieties aktīvo autentifikācijas profilu. Palaid komandu bez iespējām, lai uzskaitītu visus profilus.

auth select Parametri

Parametrs Apraksts
--index, -i Izvēlieties profilu pēc tā 1-bāzes indeksa, kā parādīts .auth list
--name, -n Izvēlieties profilu pēc vārda.

auth select Piemēri

Atver interaktīvu izvēlētāju. Izmantojiet bulttaustiņus vai ierakstiet filtrēšanu:

dataverse auth select

Izvēlieties profilu pēc indeksa vai pēc nosaukuma:

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

auth who pavēlēt

Parādi pašreizējo, aktīvo autentifikācijas profilu. Pievieno --json neapstrādātu JSON izvadi.

auth who Piemēri

dataverse auth who
dataverse auth who --json

data associate pavēlēt

Saistīt divus ierakstus caur navigācijas īpašību (attiecības). Šī komanda ir atbalstīta tikai Dataverse.

data associate Parametri

Parametrs Apraksts
--table, -t Entītija noteica primārā ieraksta nosaukumu. Obligāts arguments.
--id, -i Primārā ieraksta GUID. Obligāts arguments.
--relationship, -rel Navigācijas īpašuma nosaukums. Obligāts arguments.
--related Entītija iestatīja saistītās tabulas nosaukumu. Obligāts arguments.
--related-id GUID saistītajam ierakstam. Obligāts arguments.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data associate Piemēri

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

data count pavēlēt

Saskaitiet ierakstus tabulā, pēc izvēles filtrējot.

data count Parametri

Parametrs Apraksts
--table, -t Entītija iestatīja vārdu. Obligāti, ja vien neizmanto --fetchxml.
--filter, -f OData $filter izteiciens.
--fetchxml FetchXML agregāta vaicājums sarežģītiem skaitļiem.
--target Maršruts uz dataverse (noklusējums) vai saistītā erp vide.
--cross-company Tikai ERP. Skaiti visās kompānijās. Noklusējums: lietotāja noklusējuma uzņēmums.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data count Piemēri

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

data create pavēlēt

Izveidojiet jaunu ierakstu Dataverse tabulā. Iestatiet meklēšanas kolonnas, izmantojot @odata.bind sintaksi.

data create Parametri

Parametrs Apraksts
--table, -t Entītija iestatīja vārdu. Obligāts arguments.
--data, -d JSON objekts ar lauka vērtībām.
--data-file Ceļš uz JSON failu ar ieraksta datiem.
--return, -r Atgrieziet pilno izveidoto ierakstu.
--target Maršruts uz dataverse (noklusējums) vai saistītā erp vide.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data create Piemēri

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

Padoms

Lietojums --data-file sarežģītam JSON. Izmanto, --return --json lai iegūtu pilnu izveidoto ierakstu.

data delete pavēlēt

Dzēst vienu ierakstu pēc tā primārās atslēgas vai alternatīvas atslēgas.

data delete Parametri

Parametrs Apraksts
--table, -t Entītija iestatīja vārdu. Obligāts arguments.
--id, -i Rekords GUID.
--key, -k Alternatīva atslēga.
--no-confirm Izlaidiet apstiprinājuma uzvedni.
--target Maršruts uz dataverse (noklusējums) vai saistītā erp vide.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data delete Piemēri

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

data describe pavēlēt

Aprakstiet OData entītijas shēmu. Dataverse gadījumā komanda izsauc EntityDefinitions(LogicalName='<table>') , $expand ko vada , --includeplus otru izsaukumu līdz customapis , kad --include actions ir iestatīts. Iebūvētās Dataverse darbības, piemēram, Assign un SetState , nav uzskaitītas. ERP gadījumā viens izsaukums atgriež /Metadata/PublicEntities īpašības, saistītās darbības un navigāciju kopā.

data describe Parametri

Parametrs Apraksts
--target Mērķis: dataverse (pēc noklusējuma) vai erp.
--table, -t Obligāts arguments. Dataverse gadījumā loģiskais nosaukums, piemēram account, . ERP gadījumā entītijas kopas nosaukums, piemēram BatchJobs, .
--include Komatu atdalīts sadaļu saraksts, kas ietver: entity, properties, relations, actions, vai all. Segvārdi: attributes=properties, . relationships=relations ERP noklusējums: all. Dataverse noklusējums: entity,properties.
--json Izvadi neapstrādātu JSON.

data describe Piemēri

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

data disassociate pavēlēt

Noņemiet saistību starp diviem ierakstiem. Šī komanda ir atbalstīta tikai Dataverse.

data disassociate Parametri

Parametrs Apraksts
--table, -t Entītija noteica primārā ieraksta nosaukumu. Obligāts arguments.
--id, -i Primārā ieraksta GUID. Obligāts arguments.
--relationship, -rel Navigācijas īpašuma nosaukums. Obligāts arguments.
--related-id GUID saistītajam ierakstam, par daudzu pret daudziem attiecībām. Izlaidiet šo parametru, lai veiktu meklēšanu.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data disassociate Piemēri

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

data get pavēlēt

Iegūstiet vienu ierakstu pēc tā ID (primārās atslēgas) vai pēc alternatīvas atslēgas.

data get Parametri

Parametrs Apraksts
--table, -t Entītija iestatīja vārdu. Obligāts arguments.
--id, -i Ierakstu GUID (primārā atslēga).
--key, -k Alternatīva atslēga, piemēram "col='val'".
--select, -s Komatu atdalīts kolonnu saraksts ($select).
--expand, -x OData $expand izteiciens saistītiem ierakstiem.
--target Maršruts uz dataverse (noklusējums) vai saistītā erp vide.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data get Piemēri

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 pavēlēt

Izpildi OData, FetchXML vai SQL vaicājumu pret Dataverse tabulu.

data query Parametri

Parametrs Apraksts
--table, -t Entītija iestatīja nosaukumu vaicājumam. Nepieciešams OData vaicājumiem.
--select, -s Komatu atdalīts kolonnu saraksts ($select).
--filter, -f OData $filter izteiciens.
--orderby, -o OData $orderby izteiciens.
--top Maksimālais atgriežamo ierakstu skaits (1-5000).
--expand, -x OData $expand izteiciens saistītiem ierakstiem.
--fetchxml Iekšējais FetchXML vaicājums.
--fetchxml-file Ceļš uz failu, kas satur FetchXML vaicājumu.
--sql SQL SELECT vaicājums (priekšskatījums).
--sql-file Ceļš uz failu, kurā ir SQL vaicājums.
--all, -a Sekojiet lapu skaitīšanai, lai iegūtu visus ierakstus.
--max-records Maksimālais ierakstu skaits, kas jāizgūst, izmantojot --all. Noklusējums: 100000.
--target Maršruts uz dataverse (noklusējums) vai saistītā erp vide.
--cross-company Tikai ERP. Jautājiet visiem uzņēmumiem. Noklusējums: lietotāja noklusējuma uzņēmums.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data query Piemēri

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

Uzzināt vairāk

data update pavēlēt

Atjaunināt vienu vai vairākus laukus esošā ierakstā, kas identificēti pēc tā ID vai alternatīvas atslēgas. Iestatiet meklēšanas kolonnas, izmantojot @odata.bind sintaksi.

data update Parametri

Parametrs Apraksts
--table, -t Entītija iestatīja vārdu. Obligāts arguments.
--id, -i Rekords GUID.
--key, -k Alternatīva atslēga.
--data, -d JSON objekts ar laukiem, kurus var atjaunināt.
--data-file Ceļš uz JSON failu ar atjaunināšanas datiem.
--return, -r Atgriez pilnu atjaunināto ierakstu.
--target Maršruts uz dataverse (noklusējums) vai saistītā erp vide.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data update Piemēri

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

data upload pavēlēt

Augšupielādējiet lokālo failu Dataverse faila kolonnā esošā ierakstā. Komanda automātiski izvēlas vienreizēju pieprasījumu vai sadalītu augšupielādi, balstoties uz faila izmēru, ja vien nenorādāt --mode. Automātiskajā režīmā faili zem 128 MB tiek augšupielādēti vienā pieprasījumā, bet lielāki faili izmanto sadalītu augšupielādi. Ja izslēdzat --mime-type, komanda no faila paplašinājuma izsecina MIME tipu. Nezināmi paplašinājumi pēc noklusējuma ir .application/octet-stream

data upload Parametri

Parametrs Apraksts
--table, -t Tabulas shēma vai loģiskais nosaukums, piemēram account, . Obligāts arguments. Komanda atrisina entītiju kopu no metadatiem.
--id, -i Rekords GUID. Obligāts arguments.
--column, -c Faila kolonnas atribūta nosaukums. Obligāts arguments.
--file, -f Ceļš uz lokālo failu. Obligāts arguments.
--mode, -m Augšupielādes stratēģija: auto (pēc noklusējuma), small, vai chunk.
--mime-type Eksplicīts MIME tips. Noklusējums: secināts no faila paplašinājuma.
--overwrite Pārrakstiet esošu failu. Pēc noklusējuma komanda neizdodas, ja kolonna nav tukša.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data upload Piemēri

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 pavēlēt

Izveido ierakstu, ja tas neeksistē, vai atjaunini to, ja tas ir. Ieraksts tiek identificēts ar alternatīvu atslēgu. Iemācies izmantot alternatīvu atslēgu, lai atsauktos uz ierakstu

data upsert Parametri

Parametrs Apraksts
--table, -t Entītija iestatīja vārdu. Obligāts arguments.
--key, -k Alternatīva atslēga. Obligāts arguments.
--data, -d JSON objekts ar lauka vērtībām.
--data-file Ceļš uz JSON failu.
--update-only Neizdodas, ja ieraksts neeksistē (If-Match: *).
--create-only Neizdosies, ja ieraksts jau pastāv (If-None-Match: *).
--return, -r Pilnu ierakstu atgriez pēc operācijas.
--target Maršruts uz dataverse (noklusējums) vai saistītā erp vide.
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

data upsert Piemēri

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

erp batch cancel pavēlēt

Atceliet Finanšu un operāciju partijas darbu pēc tā RecId. Izmanto, erp batch list lai atrastu RecId.

erp batch cancel Piemēri

dataverse erp batch cancel <recid>

erp batch list pavēlēt

Uzskaiti partijas darbus Finanšu un operāciju instancē, kas ir saistīta ar tavu Dataverse vidi. Komandai nepieciešams autentifikācijas profils, kas savienots ar Dataverse vidi un kuram ir saistīta Finanšu un Operāciju instance. Finanšu un operāciju URL tiek automātiski iegūts no pašreizējā Dataverse savienojuma.

erp batch list Parametri

Parametrs Apraksts
--company Filtrēt pēc juridiskas personas (dataAreaId), piemēram, USMF.
--status Filtrē pēc statusa: Waiting, Executing, Finished, Error, vai Cancelled.
--top Maksimālais rezultātu skaits, kas jāatgriež. Noklusējums: 20.
--caption Filtrējiet pēc paraksta (reģistrjutīga apakšvirkņu saskaņošana).
--json Izvadi neapstrādātu JSON.

erp batch list Piemēri

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

install pavēlēt

Instalējiet konkrētu Dataverse CLI versiju vai atjauniniet uz jaunāko versiju. Komanda nosaka, vai CLI esi uzstādījis globāli vai to izmanto npx , un instalē atbilstoši.

install Piemēri

Instalējiet jaunāko versiju:

dataverse install latest

Instalējiet konkrētu versiju:

dataverse install 1.0.0

mcp pavēlēt

Palaiž Model Context Protocol (MCP) serveri, kas savienojas ar jūsu vidi, lai AI asistenti, piemēram, Claude Desktop, varētu mijiedarboties ar jūsu datiem. Mērķis tiek automātiski noteikts no URL: Dataverse URL sāk Dataverse MCP serveri, bet Finance and Operations URL, piemēram https://myorg.operations.dynamics.com, , , uzsāk ERP MCP serveri.

mcp Sintakse

dataverse mcp <orgUrl> [options]

Argumentācija <orgUrl> ir jūsu organizācijas URL, piemēram https://myorg.crm.dynamics.com.

mcp Parametri

Parametrs Apraksts
--validate Pārbaudiet MCP galapunktus un autentifikācijas iestatījumus, nesākot serveri.
--log-level Iestatiet žurnāla līmeni: Trace, Debug, Information, Warning, Error, , vai Critical. Noklusējums: Warning.
--log-file Ielogoties failā pagaidu direktorijā.
--preview Izmantojiet priekšskatījuma MCP galapunktu (api/mcp_preview vietā api/mcp). ERP nav atbalstīts.

mcp Piemēri

Pārbaudiet uzstādīšanu (ieteicams pirmais solis):

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

Sāciet serveri, izmantojot stdio transportu:

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

Izmantojiet priekšskatījuma galapunktu vai ieslēdziet atkļūdošanas failu žurnālu:

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

mcp allow pavēlēt

Pārliecinieties, ka Microsoft Entra lietotne ir Dataverse MCP atļauto klientu sarakstā pašreizējā profila vidē. Šī komanda ir alternatīva manuālajam administrēšanas solim, kas aprakstīts priekšnosacījumos. Autentificētajam lietotājam jābūt Dataverse administratora atļaujām mērķa vidē.

mcp allow Sintakse

dataverse mcp allow <appId> [options]

Galvenais <appId> arguments ir lietotnes (klienta) ID, ko atļaut kā GUID.

mcp allow Parametri

Parametrs Apraksts
--erp Atļaut lietotni saistītajā Finanšu un operāciju instancē, nevis Dataverse.

mcp allow Piemēri

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

Piezīme

Finanšu un operāciju nodaļa kešo atļauju sarakstu AOS, tāpēc jaunatļautā lietotnes ID var prasīt līdz pat piecām minūtēm, lai sāktu darboties.

org list pavēlēt

Uzskaiti visas vides, kurām vari piekļūt.

org list Parametri

Parametrs Apraksts
--filter Filtrējiet vidi sarakstu pēc meklēšanas termina.
--json Izvadi neapstrādātu JSON.

org list Piemēri

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

org who pavēlēt

Parādiet informāciju par pašreizējo organizāciju un lietotāju, izmantojot aktīvās autentifikācijas profilu. Komanda env ir aizstājvārds .org

org who Parametri

Parametrs Apraksts
--environment, -env Pārraksti vides URL.
--json Izvadi neapstrādātu JSON.

org who Piemēri

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

skill Komandas

Pārvaldīt Dataverse prasmes — atkārtoti izmantojamas instrukciju kopas ( SKILL.md failu un tā resursu failus), ko izmanto AI aģenti — kas tiek glabātas savienotajā vidē. Augstākā līmeņa skill komandas nodrošina izveides, lasīšanas, atjaunināšanas un dzēšanas operācijas pret vidi. Lokāli prasmes tiek glabātas zem .claude/skills/<name>/.

Piezīme

Prasmju izstrādes un novērtēšanas komandas, piemēram make, , update, get, un eval, ir atsevišķas no šīm komandām. Lai iegūtu vairāk informācijas, rakstiet .dataverse workspace skill --help

skill delete pavēlēt

Izdzēs prasmi un visus tās resursus no aktīvās Dataverse vides. Izmanto, skill list lai atrastu unikālus prasmju nosaukumus.

dataverse skill delete new_lead-qualification

skill download pavēlēt

Lejupielādējiet vienu vai vairākas prasmes no aktīvās Dataverse vides uz disku. Komanda lejupielādē SKILL.md failu un visus resursu failus, saglabājot direktoriju struktūru. Izmanto, skill list lai atrastu unikālus prasmju nosaukumus.

Parametrs Apraksts
--all Lejupielādējiet visas aktīvās prasmes no vides. To nevar apvienot ar unikālu prasmes nosaukumu.
--output, -o Bāzes direktorija izvadei. Noklusējums: .claude/skills/. Ar --all, katra prasme tiek rakstīta kā <path>/<name>/.
--json Izvadi prasmju saturu kā JSON, nerakstot failus. Pēc izvēles norādiet faila ceļu, uz kura rakstīt. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list pavēlēt

Uzskaitiet visas aktīvās prasmes savienotajā Dataverse vidē.

Parametrs Apraksts
--resources, -r Uzskaiti arī resursu failus katrai prasmei.
--json Izvade kā JSON. Pēc izvēles norādiet faila ceļu, uz kura rakstīt. 
dataverse skill list
dataverse skill list --resources

skill upload pavēlēt

Augšupielādējiet vienu vai vairākas prasmes no diska aktīvajā Dataverse vidē. Komanda atbalsta direktorijus, .zip failus, .skill failus un .md failus.

Tu vari nodot prasmi <name>, kas atrisinās uz .claude/skills/<name>/, vai eksplicītu <path> uz direktoriju vai failu.

Parametrs Apraksts
--all Augšupielādējiet visas prasmes sadaļā .claude/skills/. To nevar apvienot ar prasmes nosaukumu vai ceļu.
--json Rezultātu izvadi kā JSON. Pēc izvēles norādiet faila ceļu, uz kura rakstīt. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Skatiet arī

Darbs ar datiem, izmantojot Dataverse CLI

  • Last updated on