Referenca za Dataverse CLI (pretpregled)

Napomena

  • To je značajka pretpregleda.
  • Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija.

U ovom se članku opisuju naredbe dostupne u alatu Dataverse CLI. Svaka naredba podržava mogućnost s --help popisom njezina korištenja, mogućnosti i primjera. Naredbe koje vraćaju podatke podržavaju mogućnost za --json neobrađeni JSON izlaz koji je koristan u skriptama.

Sljedeće globalne mogućnosti mogu se koristiti uz bilo koju naredbu:

Mogućnost Opis
--log-level <level> Postavite razinu zapisivanja: Trace, Debug, Information, Warning, Error, ili Critical. Zadano: Warning.
--log-file Prijavite se u datoteku u privremeni direktorij, a ne u konzolu.
--context <value> Kontekst operacije dodan korisniku-agentu. Možete postaviti i varijablu DATAVERSE_OPERATION_CONTEXT okruženja.
Command Opis
api describe Opišite API
api invoke Pozivanje API-ja prema nazivu
api list Popis vidljivih API-ja
api request Slanje provjerenog HTTP zahtjeva
auth create Stvaranje novog profila za provjeru autentičnosti
auth list Popis svih profila za provjeru autentičnosti
auth remove Uklanjanje profila za provjeru autentičnosti
auth select Odabir aktivnog profila za provjeru autentičnosti
auth who Prikaz trenutnog profila za provjeru autentičnosti
data associate Povezivanje dva zapisa putem odnosa
data count Brojanje zapisa u tablici
data create Stvori novi zapis
data delete Brisanje zapisa
data describe Opišite shemu entiteta
data disassociate Uklanjanje odnosa između dva zapisa
data get Dohvaćanje jednog zapisa prema ID-u ili alternativnom ključu
data query Izvršavanje OData, FetchXML ili SQL upita
data update Ažurirajte postojeći zapis
data upload Prijenos datoteke u stupac datoteke u postojećem zapisu
data upsert Stvaranje ili ažuriranje zapisa alternativnim ključem
erp batch cancel Otkazivanje obrade Financije i operacije
erp batch list Popis radnih zadataka grupa Financije i operacije
install Instalacija određene verzije ili ažuriranje na najnoviju verziju
mcp Pokretanje MCP poslužitelja za Dataverse ili ERP
mcp allow Dopusti aplikaciju kao MCP klijent
org list Popis svih pristupačnih okruženja
org who Prikaz trenutnih informacija o tvrtki ili ustanovi i korisniku
skill delete Brisanje vještine iz aplikacije Dataverse
skill download Preuzimanje vještine s web-mjesta Dataverse
skill list Popis aktivnih vještina u okruženju
skill upload Prijenos vještine na Dataverse

Napomena

Mnoge naredbe podržavaju mogućnost koja --target <dataverse\|erp> usmjerava operaciju na Dataverse (zadano) ili u povezano okruženje financije i operacije (ERP). Naredbe koje se povezuju s okruženjem podržavaju --environment <url> mogućnost (-env) za nadjačavanje URL-a okruženja trenutnog profila.

api describe naredba

Prikaz metapodataka za jedan API. Za Dataverse prilagođene API-je, izlaz obuhvaća parametre zahtjeva i opise svojstava odgovora kada ih metapodaci pribave.

Nazivi dataverse po zadanom se ne mogu ispremiješati. U obrascu možete koristiti nazive kvalificirane erp:ServiceGroup/Service/Operationza ERP.

api describe parametri

Parametar Opis
--target Razriješite nekvalificirani naziv protiv ili dataverseerp.
--service-group Samo ERP. Suzite pretraživanje operacije na jednu grupu servisa.
--service Samo ERP. Suzite pretraživanje operacije na jedan servis.
--environment Nadjačavanje URL-a okruženja Dataverse.
--json Izlazni neobrađeni JSON.

api describe primjerima

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

api invoke naredba

Pozovite otkriveni API prema nazivu. Koristite name=value sintaksu za parametre. Ako vrijednost sadrži razmake, navodi cijeli token. Neki API-ji za Dataverse prihvaćaju parametar niza čiji su sadržaji sami JSON. U tom slučaju proslijedite JSON tekst kao vrijednost pomoću normalnog kvocijentnog i neizbježenog pravila ljuske.

JSON odgovori po zadanom se prikazuju u neslužbenom tekstnom obliku koji zadržava nazive izlaznih svojstava. Koristi --json se za očuvanje neobrađenog JSON opterećenja.

api invoke parametri

Parametar Opis
--target Razriješite nekvalificirani naziv protiv ili dataverseerp.
--service-group Samo ERP. Suzite pretraživanje operacije na jednu grupu servisa.
--service Samo ERP. Suzite pretraživanje operacije na jedan servis.
--param Dodajte imenovani parametar u name=value obrazac. Neponovljivom.
--bind Put povezivanja za Dataverse API-je povezane s entitetom.
--method, -X Nadjačajte odgođenu HTTP metodu.
--body Umjesto imenovanih parametara koristite neobrađeno JSON tijelo.
--body-file Čitanje neobrađenog JSON tijela iz datoteke.
--header, -H Dodajte HTTP zaglavlje u key:value obrazac.
--include, -i Uvrstite status i zaglavlja odgovora.
--environment Nadjačavanje URL-a okruženja Dataverse.
--json Izlazni neobrađeni JSON umjesto neslužbenog teksta.

api invoke primjerima

Pozovite funkciju Dataverse. U ovom se primjeru prikazuje korištenje Dynamics 365 Contact Center CCaaS_GetPresence funkcije.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Pozovite akciju Dataverse AISummarize s razmacima u vrijednosti parametra:

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

Pozovite ERP prilagođeni servis:

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

api list naredba

Popis vidljivih API-ja, kao što su prilagođeni API-ji za Dataverse i krajnje točke servisa ERP koje se mogu podržati. Rezultati pokazuju identitet API-ja, neslužbeni naziv, vrstu i opis kada su dostupni. Da biste filtrirali rezultate, proslijedite neobavezni izraz upita.

api list Parametara

Parametar Opis
--target Ciljni sustav za pretraživanje: dataverse (zadano) ili erp.
--service-group Samo ERP. Filtrirajte prema jednoj grupi servisa.
--service Samo ERP. Filtrirajte prema jednom servisu.
--limit Maksimalan broj API-ja koji će se vratiti. Zadano: 50.
--page Broj stranice s 1 arhitekturom prilikom označavanja stranica po rezultatima. Zadano: 1.
--environment Nadjačavanje URL-a okruženja Dataverse.
--json Izlazni neobrađeni JSON.

api list primjerima

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 naredba

Pošaljite neobrađeni HTTP zahtjev Dataverseu ili ERP-u. Tu naredbu koristite kada vam je potrebna potpuna kontrola nad putom, metodom, zaglavljima i tijelom.

api request Parametara

Parametar Opis
--target Ciljni sustav: dataverse ili erp. Obavezno.
--path Put zahtjeva. Obavezno.
--method, -X HTTP metoda. Zadano: GETili POST kada se isporučuje tijelo.
--body Umetnuto tijelo zahtjeva za JSON.
--body-file Datoteka koja sadrži tijelo zahtjeva JSON objekta.
--header, -H Dodajte HTTP zaglavlje u key:value obrazac.
--include, -i Uvrstite status i zaglavlja odgovora.
--environment Nadjačavanje URL-a okruženja Dataverse.

api request primjerima

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 naredba

Stvorite novi profil za provjeru autentičnosti.

auth create Parametara

Koristite te parametre da biste odredili ponašanje auth create naredbe.

Parametar Opis
--environment, -env URL okruženja Dataverse u kojem želite provjeriti autentičnost.
--name, -n Neobavezan naziv profila. Upotrijebite naziv da biste kasnije odabrali profil.
--cloud, -ci Ciljni oblak: Public, UsGov, UsGovHigh, UsGovDod, ili China.
--deviceCode, -dc Koristite tijek provjere autentičnosti koda uređaja za okruženja bez preglednika.
--username, -un Korisničko ime za provjeru autentičnosti korisničkim imenom i lozinkom.
--password, -p Lozinka za provjeru autentičnosti korisničkim imenom i lozinkom.
--applicationId, -id ID aplikacije (klijenta) za provjeru autentičnosti upravitelja servisa (SPN).
--clientSecret, -cs Tajna klijenta za provjeru autentičnosti upravitelja servisa.
--certificateDiskPath, -cdp Put do . pfx datoteke certifikata za provjeru autentičnosti utemeljenu na certifikatu.
--certificatePassword, -cp Lozinka za certifikat.
--tenant, -t ID klijenta. Potrebno za provjeru autentičnosti upravitelja servisa.
--managedIdentity, -mi Korištenje Azure upravljanog identiteta.
--githubFederated, -ghf Koristi GitHub Actions vanjsku provjeru autentičnosti.
--azureDevOpsFederated, -adof Koristite Azure DevOps vanjsku provjeru autentičnosti.
--clientid, -cid Prilagođeni ID Microsoft Entra aplikacije za korištenje umjesto zadane aplikacije Dataverse CLI.
--no-default-environment Nemojte postaviti okruženje kao zadano.
--accept-cleartext-caching Dopustite predmemoriju tokena običnog teksta u sustavu Linux.

auth create primjerima

Sljedeći primjeri pokazuju kako koristiti naredbu auth create .

Interaktivna provjera autentičnosti

Tom se naredbom otvara dijaloški okvir preglednika ili sustava radi dodatnih informacija.

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

Imenovani profil

Stvorite profil s određenim nazivom.

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

Tijek koda uređaja

Koristite tijek koda uređaja za okruženja bez preglednika.

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

Upravitelj servisa s tajnom klijenta

Upravitelj servisa koristite kada vam je potrebna nenadzirana provjera autentičnosti, npr. u CI/CD kanalu ili neka druga automatizirana skripta u kojoj interaktivna prijava nije moguća. Navedite ID aplikacije, klijentsku tajnu i ID klijenta za registraciju aplikacije koja ima pristup okruženju.

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

ID klijenta prilagođenog sudionika aplikacije

Umjesto zadane postavke koristite vlastitu registraciju aplikacije.

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

auth list naredba

Na popis svih profila za provjeru autentičnosti. Dodaj za --json neobrađeni JSON izlaz.

auth list primjerima

dataverse auth list
dataverse auth list --json

auth remove naredba

Uklonite jedan ili sve profile za provjeru autentičnosti.

auth remove Parametara

Parametar Opis
--index, -i Uklonite profil s navedenim indeksom utemeljenim na 1, kao što je prikazano u odjeljku auth list.
--name, -n Uklonite profil s navedenim nazivom.
--all Uklonite sve profile.

auth remove primjerima

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

auth select naredba

Odaberite aktivni profil za provjeru autentičnosti. Pokrenite naredbu bez mogućnosti za popis svih profila.

auth select Parametara

Parametar Opis
--index, -i Odaberite profil prema indeksu koji se temelji na 1, kao što je prikazano u odjeljku auth list.
--name, -n Odaberite profil prema nazivu.

auth select primjerima

Otvaranje interaktivnog birača. Upotrijebite tipke sa strelicama ili pišite da biste filtrirali:

dataverse auth select

Odaberite profil prema indeksu ili nazivu:

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

auth who naredba

Prikaz trenutnog, aktivnog profila za provjeru autentičnosti. Dodaj za --json neobrađeni JSON izlaz.

auth who primjerima

dataverse auth who
dataverse auth who --json

data associate naredba

Povežite dva zapisa putem navigacijskog svojstva (odnosa). Ova je naredba podržana samo za Dataverse.

data associate Parametara

Parametar Opis
--table, -t Naziv skupa entiteta primarnog zapisa. Obavezno.
--id, -i GUID primarnog zapisa. Obavezno.
--relationship, -rel Naziv svojstva navigacije. Obavezno.
--related Naziv skupa entiteta povezane tablice. Obavezno.
--related-id GUID povezanog zapisa. Obavezno.
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data associate primjerima

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

data count naredba

Brojanje zapisa u tablici, po želji filtriranih.

data count Parametara

Parametar Opis
--table, -t Naziv skupa entiteta. Obavezno ako ne koristite --fetchxml.
--filter, -f OData $filter izraz.
--fetchxml Upit sa zbrajanja FetchXML za složene zbroje.
--target Usmjeravanje prema dataverse (zadano) ili povezanom okruženju erp .
--cross-company Samo ERP. Brojanje u svim tvrtkama. Zadano: zadana korisnička tvrtka.
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data count primjerima

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

data create naredba

Stvorite novi zapis u tablici Dataverse. Stupce pretraživanja postavite pomoću sintakse @odata.bind .

data create Parametara

Parametar Opis
--table, -t Naziv skupa entiteta. Obavezno.
--data, -d JSON objekt s vrijednostima polja.
--data-file Put do JSON datoteke s podacima zapisa.
--return, -r Vratite potpuni stvoreni zapis.
--target Usmjeravanje prema dataverse (zadano) ili povezanom okruženju erp .
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data create primjerima

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

Savjet

Koristi se --data-file za složeni JSON. Koristi --return --json se za dohvaćanje potpuno stvorenog zapisa.

data delete naredba

Izbrišite jedan zapis pomoću primarnog ključa ili alternativnim ključem.

data delete Parametara

Parametar Opis
--table, -t Naziv skupa entiteta. Obavezno.
--id, -i GUID zapisa.
--key, -k Zamjenski ključ.
--no-confirm Preskočite potvrdni upit.
--target Usmjeravanje prema dataverse (zadano) ili povezanom okruženju erp .
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data delete primjerima

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

data describe naredba

Opišite shemu OData entiteta. U odjeljku Dataverse naredbe se pozivaju EntityDefinitions(LogicalName='<table>') s $expand pogonom --include, plus drugi poziv kada customapis je --include actions postavljen. Ugrađene akcije za Dataverse, AssignSetState kao što su enumerirane i nisu numerirane. Za ERP, jedan poziv za vraćanje /Metadata/PublicEntities svojstava, vezane akcije i navigacije zajedno.

data describe Parametara

Parametar Opis
--target Cilj: dataverse (zadano) ili erp.
--table, -t Obavezno. Za Dataverse logički naziv, kao što je account. Za ERP, naziv skupa entiteta, kao što je BatchJobs.
--include Popis sekcija razdvojenih zarezom za uključivanje: entity, properties, relations, actionsili all. Pseudonimi: attributes=properties, . relationships=relations Zadano za ERP: all. Zadano za Dataverse: entity,properties.
--json Izlazni neobrađeni JSON.

data describe primjerima

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

data disassociate naredba

Uklanjanje odnosa između dva zapisa. Ova je naredba podržana samo za Dataverse.

data disassociate parametri

Parametar Opis
--table, -t Naziv skupa entiteta primarnog zapisa. Obavezno.
--id, -i GUID primarnog zapisa. Obavezno.
--relationship, -rel Naziv svojstva navigacije. Obavezno.
--related-id GUID povezanog zapisa za odnos više-prema-više. Izostavi taj parametar radi čišćenja pretraživanja.
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data disassociate primjerima

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

data get naredba

Dohvatiti jedan zapis prema ID-u (primarnom ključu) ili alternativnim ključem.

data get Parametara

Parametar Opis
--table, -t Naziv skupa entiteta. Obavezno.
--id, -i GUID zapisa (primarni ključ).
--key, -k Zamjenska tipka, na primjer "col='val'".
--select, -s Popis stupaca razdvojenih zarezom ($select).
--expand, -x OData izraz $expand za povezane zapise.
--target Usmjeravanje prema dataverse (zadano) ili povezanom okruženju erp .
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data get primjerima

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 naredba

Izvršavanje OData, FetchXML ili SQL upita u tablici Dataverse.

data query Parametara

Parametar Opis
--table, -t Naziv skupa entiteta za upit. Obavezno za OData upite.
--select, -s Popis stupaca razdvojenih zarezom ($select).
--filter, -f OData $filter izraz.
--orderby, -o OData $orderby izraz.
--top Maksimalan broj zapisa koji će se vratiti (od 1 do 5000).
--expand, -x OData izraz $expand za povezane zapise.
--fetchxml Umetnuti FetchXML upit.
--fetchxml-file Put do datoteke koja sadrži FetchXML upit.
--sql SQL upit SELECT (pretpregled).
--sql-file Put do datoteke koja sadrži SQL upit.
--all, -a Slijedite numeriranje da biste dohvatili sve zapise.
--max-records Maksimalan broj zapisa koji će se dohvatiti pri korištenju --all. Zadano: 100000.
--target Usmjeravanje prema dataverse (zadano) ili povezanom okruženju erp .
--cross-company Samo ERP. Upit za sve tvrtke. Zadano: zadana korisnička tvrtka.
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data query primjerima

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

Saznajte više

data update naredba

Ažurirajte jedno ili više polja na postojećem zapisu koji je označen njegovim ID-om ili alternativnim ključem. Stupce pretraživanja postavite pomoću sintakse @odata.bind .

data update Parametara

Parametar Opis
--table, -t Naziv skupa entiteta. Obavezno.
--id, -i GUID zapisa.
--key, -k Zamjenski ključ.
--data, -d JSON objekt s poljima za ažuriranje.
--data-file Put do JSON datoteke s podacima o ažuriranju.
--return, -r Vratite puni ažurirani zapis.
--target Usmjeravanje prema dataverse (zadano) ili povezanom okruženju erp .
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data update primjerima

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

data upload naredba

Prenesite lokalnu datoteku u stupac datoteke Dataverse na postojećem zapisu. Naredba automatski odabire prijenos od jednog zahtjeva ili bloka na temelju veličine datoteke, osim ako ne navedete --mode. U automatskom načinu rada datoteke manje od 128 MB prenose se u jednom zahtjevu, a veće datoteke koriste prijenos u bloku. Kada izostavite --mime-type, naredba pretpostavlja mime vrstu iz datotečnog nastavka. Nepoznata proširenja zadana za application/octet-stream.

data upload Parametara

Parametar Opis
--table, -t Shema tablice ili logički naziv, npr account. . Obavezno. Naredba razrješa skup entiteta iz metapodataka.
--id, -i GUID zapisa. Obavezno.
--column, -c Naziv atributa stupca datoteke. Obavezno.
--file, -f Put do lokalne datoteke. Obavezno.
--mode, -m Strategija prijenosa: auto (zadano) smallili chunk.
--mime-type Eksplicitno MIME vrsta. Zadano: odgođeno iz datotečnog nastavka.
--overwrite Prebriši postojeću datoteku. Naredba po zadanom ne uspijeva ako stupac nije prazan.
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data upload primjerima

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 naredba

Stvorite zapis ako ne postoji ili ga ažurirajte ako postoji. Zapis se identificira alternativnim ključem. Korištenje zamjenskog ključa za referencu na zapis

data upsert Parametara

Parametar Opis
--table, -t Naziv skupa entiteta. Obavezno.
--key, -k Zamjenski ključ. Obavezno.
--data, -d JSON objekt s vrijednostima polja.
--data-file Put do JSON datoteke.
--update-only Neuspjeh ako zapis ne postoji (If-Match: *).
--create-only Neuspjeh ako zapis već postoji (If-None-Match: *).
--return, -r Vratite puni zapis nakon operacije.
--target Usmjeravanje prema dataverse (zadano) ili povezanom okruženju erp .
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

data upsert primjerima

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

erp batch cancel naredba

Otkažite obradu tere ćenje i operacije prema njezinu RecId. Koristi erp batch list se za pronalaženje .RecId

erp batch cancel primjerima

dataverse erp batch cancel <recid>

erp batch list naredba

Napišite skupne zadatke u instanci financije i operacije koja je povezana s vašim okruženjem Dataverse. Za naredbu je potreban profil za provjeru autentičnosti povezan s okruženjem Dataverse koje ima povezanu instancu financije i operacije. URL financije i operacije izvodi se automatski iz trenutne podatkovne veze.

erp batch list parametri

Parametar Opis
--company Filtrirajte prema pravnoj osobi (dataAreaId), npr USMF. .
--status Filtriranje prema statusuExecuting: Waiting, , Finished, Error, ili Cancelled.
--top Maksimalan broj rezultata koji će se vratiti. Zadano: 20.
--caption Filtrirajte prema opisu (podudaranje podniza ne razlikuju velika i mala slova).
--json Izlazni neobrađeni JSON.

erp batch list primjerima

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

install naredba

Instalirajte određenu verziju dataverse CLI-ja ili ažurirajte na najnoviju verziju. Naredba otkriva jeste li globalno instalirali CLI ili ga koristite i npx instalira u skladu s tim.

install primjerima

Instalirajte najnoviju verziju:

dataverse install latest

Instalirajte određenu verziju:

dataverse install 1.0.0

mcp naredba

Pokreće poslužitelj kontekstnog protokola modela (MCP) koji se povezuje s vašim okruženjem da bi AI pomoćnici kao što je Claude Desktop mogli stupati u interakciju s vašim podacima. Cilj se automatski otkriva iz URL-a: URL za Dataverse pokreće MCP poslužitelj za Dataverse, a URL financije i operacije, https://myorg.operations.dynamics.comkao što je , pokreće ERP MCP poslužitelj.

mcp Sintaksa

dataverse mcp <orgUrl> [options]

Argument <orgUrl> je URL vaše tvrtke ili ustanove, na primjer https://myorg.crm.dynamics.com.

mcp Parametara

Parametar Opis
--validate Provjerite valjanost krajnjih točaka MCP-a i postavljanje provjere autentičnosti bez pokretanja poslužitelja.
--log-level Postavite razinu zapisivanja: Trace, Debug, Information, Warning, Error, ili Critical. Zadano: Warning.
--log-file Prijavite se u datoteku u privremenom direktoriju.
--preview Koristite krajnju točku ZA PRETPREGLED MCP-a (api/mcp_preview umjesto api/mcp). Nije podržano za ERP.

mcp primjerima

Provjera valjanosti postavljanja (preporučeni prvi korak):

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

Pokrenite poslužitelj pomoću stdio prijenosa:

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

Koristite krajnju točku pretpregleda ili omogućite zapisivanje pogrešaka u datoteci:

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

mcp allow naredba

Provjerite nalazi li Microsoft Entra aplikacija za pohranu na popisu klijenata dopuštenih mcP-om za Dataverse za okruženje trenutnog profila. Ta je naredba alternativa ručnom administratoru opisanom u preduvjetima. Autorizirani korisnik mora imati administratorske dozvole za Dataverse u ciljnom okruženju.

mcp allow Sintaksa

dataverse mcp allow <appId> [options]

Argument <appId> je ID aplikacije (klijenta) koji se dopušta kao GUID.

mcp allow Parametara

Parametar Opis
--erp Dopustite aplikaciju na povezanoj instanci financije i operacije umjesto na Dataverse.

mcp allow primjerima

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

Napomena

Financije i operacije predmemoriranje popisa dopuštenih e-pošte u sustavu AOS, tako da novi dopušteni ID aplikacije može potrajati do pet minuta.

org list naredba

Na popis svih okruženja možete pristupiti.

org list Parametara

Parametar Opis
--filter Filtriranje popisa okruženja prema terminu za pretraživanje.
--json Izlazni neobrađeni JSON.

org list primjerima

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

org who naredba

Prikaz informacija o trenutnoj tvrtki ili ustanovi i korisniku pomoću aktivnog profila za provjeru autentičnosti. Naredba env je pseudonim za org.

org who Parametara

Parametar Opis
--environment, -env Nadjačaj URL okruženja.
--json Izlazni neobrađeni JSON.

org who primjerima

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

skill Naredbe

Upravljajte vještinama za prijenos podataka – skupovima uputa koje je moguće ponovno koristiti ( SKILL.md datoteci i datotekama resursa) koje koriste agenti za AI– pohranjeni u povezanom okruženju. Naredbe najviše razine skill pružaju operacije stvaranja, čitanja, ažuriranja i brisanja u odnosu na okruženje. Vještine se lokalno pohranjuju u odjeljku .claude/skills/<name>/.

Napomena

Naredbe za stvaranje i procjenu vještina, kao što makesu , update, i geteval, razlikuju se od tih naredbi. Da biste saznali više, pokrenite dataverse workspace skill --help.

skill delete naredba

Izbrišite vještinu i sve njegove resurse iz aktivnog okruženja Dataverse. Koristi se skill list za pronalaženje jedinstvenih naziva vještina.

dataverse skill delete new_lead-qualification

skill download naredba

Preuzmite jednu ili više vještina iz aktivnog okruženja Dataverse na disk. Naredba preuzima datoteku i sve SKILL.md datoteke resursa uz očuvanje strukture direktorija. Koristi se skill list za pronalaženje jedinstvenih naziva vještina.

Parametar Opis
--all Preuzmite sve aktivne vještine iz okruženja. Nije moguće kombinirati s jedinstvenim nazivom vještine.
--output, -o Osnovni direktorij za izlaz. Zadano: .claude/skills/. Sa --all, svaka vještina je napisana .<path>/<name>/
--json Sadržaj vještine možete poslati kao JSON bez pisanja datoteka. Ako želite, navedite put datoteke u koji želite pisati. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list naredba

Napišite sve aktivne vještine u povezanom okruženju Dataverse.

Parametar Opis
--resources, -r Na popisu su i datoteke resursa za svaku vještinu.
--json Izlaz u obliku JSON. Ako želite, navedite put datoteke u koji želite pisati. 
dataverse skill list
dataverse skill list --resources

skill upload naredba

Prenesite jednu ili više vještina s diska u aktivno okruženje Dataverse. Naredba podržava direktorije ,.zip datoteke, datoteke .skill i .md datoteke.

Možete proći vještinu <name>, koja se razrješa u .claude/skills/<name>/, ili eksplicitno <path> u direktorij ili datoteku.

Parametar Opis
--all Prenesite sve vještine u odjeljku .claude/skills/. Nije moguće kombinirati s nazivom vještine ili putom.
--json Rezultat izlaza u obliku JSON. Ako želite, navedite put datoteke u koji želite pisati. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Vidi također

Rad s podacima pomoću alata Dataverse CLI

  • Last updated on