Dataverse CLI -viittaus (esiversio)

Muistio

  • Tämä on esiversiotoiminto.
  • Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Tässä artikkelissa kuvataan Dataverse CLI:ssä käytettävissä olevat komennot. Jokainen komento tukee vaihtoehtoa, jossa --help luetellaan sen käyttö, vaihtoehdot ja esimerkit. Komennot, jotka palauttavat tietoja, tukevat raakaa --json JSON-tulostetta, josta on hyötyä komentosarjoissa.

Seuraavia yleisiä asetuksia voi käyttää minkä tahansa komennon kanssa:

Vaihtoehto Kuvaus
--log-level <level> Määritä kirjaustaso: Trace, , Debug, InformationWarning, , Errortai Critical. Oletus: Warning.
--log-file Kirjaudu tilapäishakemistossa olevaan tiedostoon konsolin sijaan.
--context <value> Käyttäjä-agenttiin liitetty toimintokonteksti. Voit myös määrittää ympäristömuuttujan DATAVERSE_OPERATION_CONTEXT .
Command Kuvaus
api describe Ohjelmointirajapinnan kuvaaminen
api invoke Ohjelmointirajapinnan käynnistäminen nimen mukaan
api list Luettelo löydettävissä olevat ohjelmointirajapinnat
api request Todennetun HTTP-pyynnön lähettäminen
auth create Uuden todennusprofiilin luominen
auth list Kaikkien todennusprofiilien luettelo
auth remove Todennusprofiilin poistaminen
auth select Aktiivisen todennusprofiilin valitseminen
auth who Näytä nykyinen todennusprofiili
data associate Kahden tietueen linkittäminen suhteen kautta
data count Laske tietueet taulukossa
data create Luo uusi tietue
data delete Tietueen poistaminen
data describe Entiteetin rakenteen kuvaus
data disassociate Kahden tietueen välisen suhteen poistaminen
data get Yksittäisen tietueen noutaminen tunnuksen tai vaihtoehtoisen avaimen perusteella
data query Suorita OData-, FetchXML- tai SQL-kysely
data update Päivitä olemassa oleva tietue
data upload Lataa tiedosto olemassa olevan tietueen tiedostosarakkeeseen
data upsert Luo tai päivitä tietue vaihtoehtoisella avaimella
erp batch cancel Finance and Operations -erätyön peruuttaminen
erp batch list Luettele Finance and Operations -erätyöt
install Asenna tietty versio tai päivitä uusimpaan versioon
mcp Käynnistä MCP-palvelin Dataversen tai ERP:n avulla
mcp allow Salli sovellus MCP-asiakkaana
org list Luettele kaikki käytettävissä olevat ympäristöt
org who Näytä nykyiset organisaation ja käyttäjän tiedot
skill delete Taidon poistaminen Dataversestä
skill download Lataa taito Dataversestä
skill list Luetteloi aktiiviset taidot ympäristössä
skill upload Taidon lataaminen Dataverseen

Muistio

Monet komennot tukevat --target <dataverse\|erp> vaihtoehtoa, joka reitittää toiminnon Dataverseen (oletus) tai linkitettyyn Finance and Operations (ERP) -ympäristöön. Komentoja, jotka yhdistävät ympäristöön, tukevat --environment <url> (-env)-asetusta, joka ohittaa nykyisen profiilin ympäristön URL-osoitteen.

api describe komento

Näytä yksittäisen ohjelmointirajapinnan metatiedot. Dataversen mukautettujen ohjelmointirajapintojen tulos sisältää pyyntöparametrin ja vastausominaisuuden kuvaukset, kun metatiedot antavat ne.

Dataverse-nimiä ei ole oletusarvoisesti määritetty. Voit käyttää ERP-hyväksyttyjä nimiä lomakkeessa erp:ServiceGroup/Service/Operation.

api describe Parametrit

Parametri Kuvaus
--target Ratkaise tarkentamaton nimi suhteessa dataverse kohteeseen tai erp.
--service-group Tämä on vain ERP. Rajaa toiminnon haun yhteen palveluryhmään.
--service Tämä on vain ERP. Rajaa toimintohakua yhteen palveluun.
--environment Ohita Dataverse-ympäristön URL-osoite.
--json Tulosta raaka JSON.

api describe Esimerkkejä

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

api invoke komento

Käynnistä löydetty ohjelmointirajapinta nimen mukaan. Käytä name=value parametreille syntaksia. Jos arvo sisältää välilyöntejä, lainausmerkeissä koko tunnus. Jotkin Dataverse-ohjelmointirajapinnat hyväksyvät merkkijonoparametrin, jonka sisältö on itse JSON. Tässä tapauksessa voit välittää JSON-tekstin arvona käyttämällä liittymän normaaleja lainaus- ja ohjaussääntöjä.

Oletusarvon mukaan JSON-vastaukset hahmonnetaan ystävällisessä tekstimuodossa, joka säilyttää tulosteen ominaisuuksien nimet. Käytä tätä --json JSON-raakakuorman säilyttämiseen.

api invoke Parametrit

Parametri Kuvaus
--target Ratkaise tarkentamaton nimi suhteessa dataverse kohteeseen tai erp.
--service-group Tämä on vain ERP. Rajaa toiminnon haun yhteen palveluryhmään.
--service Tämä on vain ERP. Rajaa toimintohakua yhteen palveluun.
--param Lisää nimetty parametri name=value lomakkeessa. Toistettavissa.
--bind Entiteettiin sidottujen Dataverse-ohjelmointirajapintojen sidontapolku.
--method, -X Ohita johdettu HTTP-menetelmä.
--body Käytä JSON-raakaa runkoa nimettyjen parametrien sijaan.
--body-file Lue raaka JSON-leipäteksti tiedostosta.
--header, -H Lisää HTTP-otsikko key:value lomakkeessa.
--include, -i Sisällytä vastauksen tila ja otsikot.
--environment Ohita Dataverse-ympäristön URL-osoite.
--json Tulosta raaka JSON tekstiystävällisen tekstin sijaan.

api invoke Esimerkkejä

Käynnistä Dataverse-funktio. Tässä esimerkissä näytetään Dynamics 365 Contact Center CCaaS_GetPresence -funktion käyttö.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Käynnistä Dataverse AISummarize -toiminto , jossa parametriarvossa on välilyöntejä:

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

Käynnistä mukautettu ERP-palvelu:

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

api list komento

Listaa löydettävät ohjelmointirajapinnat, kuten Dataversen mukautetut ohjelmointirajapinnat ja ERP-kutsuttavat palvelun päätepisteet. Tulokset näyttävät ohjelmointirajapinnan käyttäjätiedot, kutsumanimen, lajin ja kuvauksen, kun ne ovat käytettävissä. Voit suodattaa tulokset välittämällä valinnaisen kyselytermin.

api list Parametrit

Parametri Kuvaus
--target Haettava kohdejärjestelmä: dataverse (oletus) tai erp.
--service-group Tämä on vain ERP. Suodata yhteen palveluryhmään.
--service Tämä on vain ERP. Yhden palvelun mukaan suodattaminen.
--limit Palautettavien ohjelmointirajapintojen enimmäismäärä. Oletus: 50.
--page Yksipohjainen sivunumero, kun sivutat tuloksia. Oletus: 1.
--environment Ohita Dataverse-ympäristön URL-osoite.
--json Tulosta raaka JSON.

api list Esimerkkejä

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 komento

Lähetä raaka todennettu HTTP-pyyntö Dataverseen tai ERP:hen. Käytä tätä komentoa, kun haluat hallita polkua, menetelmää, otsikoita ja leipätekstiä täysin.

api request Parametrit

Parametri Kuvaus
--target Kohdejärjestelmä: dataverse tai erp. Pakollinen.
--path Pyyntöpolku. Pakollinen.
--method, -X HTTP-menetelmä. Oletusarvo: GETtai POST kun leipäteksti on annettu.
--body Sisäinen JSON-pyynnön leipäteksti.
--body-file Tiedosto, joka sisältää JSON-objektipyynnön leipätekstin.
--header, -H Lisää HTTP-otsikko key:value lomakkeessa.
--include, -i Sisällytä vastauksen tila ja otsikot.
--environment Ohita Dataverse-ympäristön URL-osoite.

api request Esimerkkejä

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 komento

Luo uusi todennusprofiili.

auth create Parametrit

Näiden parametrien avulla voit määrittää komennon auth create toiminnan.

Parametri Kuvaus
--environment, -env Sen Dataverse-ympäristön URL-osoite, jossa haluat todentaa.
--name, -n Profiilin valinnainen nimi. Valitse profiili myöhemmin nimen avulla.
--cloud, -ci Kohdepilvi: Public, , UsGovHighUsGov, UsGovDodtai China.
--deviceCode, -dc Käytä laitekoodin todennustyönkulkua ympäristöissä, joita ei ole selaimessa.
--username, -un Käyttäjänimen ja salasanan todentamisen käyttäjänimi.
--password, -p Käyttäjänimen ja salasanan todentamisen salasana.
--applicationId, -id Sovelluksen (asiakas) tunnus palvelun päänimen (SPN) todennukselle.
--clientSecret, -cs Palvelun päänimen todentamisen asiakassalaisuus.
--certificateDiskPath, -cdp Varmennepohjaisen todennuksen .pfx-varmennetiedoston polku.
--certificatePassword, -cp Varmenteen salasana.
--tenant, -t Vuokraajan tunnus. Pakollinen palvelun päänimen todentamiseen.
--managedIdentity, -mi Käytä Azure hallittuja käyttäjätietoja.
--githubFederated, -ghf Käytä GitHub Actions yhdistettyä todentamista.
--azureDevOpsFederated, -adof Käytä Azure DevOps yhdistettyä todentamista.
--clientid, -cid Mukautettu Microsoft Entra sovelluksen asiakastunnuksen käytettäväksi Dataverse CLI -oletussovelluksen sijaan.
--no-default-environment Älä aseta ympäristöä oletuksena.
--accept-cleartext-caching Salli salaamattoman tekstin tunnus -välimuisti Linuxissa.

auth create Esimerkkejä

Seuraavissa esimerkeissä esitellään komennon auth create käyttö.

Vuorovaikutteinen todentaminen

Tämä komento avaa selaimen tai järjestelmän valintaikkunan, jossa on lisätietoja.

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

Nimetty profiili

Luo profiili tietyllä nimellä.

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

Laitekoodin työnkulku

Käytä laitekoodin työnkulkua ympäristöissä, jotka eivät käytä selainta.

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

Palvelupäähenkilö asiakassalaisuudella

Käytä palvelun päänimeä, kun tarvitset valvomattoman todennuksen, esimerkiksi CI/CD-jaksossa tai toisessa automatisoidussa komentosarjassa, jossa vuorovaikutteinen kirjautuminen ei ole mahdollista. Anna sovelluksen rekisteröinnin sovellustunnus, asiakassalaisuus ja vuokraajatunnus, jolla on ympäristön käyttöoikeus.

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

Mukautetun Entra-sovelluksen asiakastunnus

Käytä oman sovelluksen rekisteröintiä oletusarvon sijaan.

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

auth list komento

Luettele kaikki todennusprofiilit. Lisää --json JSON-raakatuloste.

auth list Esimerkkejä

dataverse auth list
dataverse auth list --json

auth remove komento

Poista yksi tai kaikki todennusprofiilit.

auth remove Parametrit

Parametri Kuvaus
--index, -i Poista profiili käyttäen määritettyä 1-pohjaista indeksiä kohdan auth listmukaisesti.
--name, -n Poista profiili määritetyllä nimellä.
--all Poista kaikki profiilit.

auth remove Esimerkkejä

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

auth select komento

Valitse aktiivinen todennusprofiili. Suorita komento ilman asetuksia kaikkien profiilien luettelemiseksi.

auth select Parametrit

Parametri Kuvaus
--index, -i Valitse profiili sen 1-pohjaisen indeksin mukaan kohdassa esitetyllä auth listtavalla.
--name, -n Valitse profiili nimen mukaan.

auth select Esimerkkejä

Avaa vuorovaikutteinen valitsin. Käytä nuolinäppäimiä tai suodata kirjoittamalla:

dataverse auth select

Valitse profiili indeksin tai nimen mukaan:

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

auth who komento

Näytä nykyinen aktiivinen todennusprofiili. Lisää --json JSON-raakatuloste.

auth who Esimerkkejä

dataverse auth who
dataverse auth who --json

data associate komento

Liitä kaksi tietuetta siirtymisominaisuuden (suhteen) kautta. Tätä komentoa tuetaan vain Dataverselle.

data associate Parametrit

Parametri Kuvaus
--table, -t Ensisijaisen tietueen entiteettijoukon nimi. Pakollinen.
--id, -i Ensisijaisen tietueen GUID-tunnus. Pakollinen.
--relationship, -rel Siirtymisominaisuuden nimi. Pakollinen.
--related Liittyvän taulukon entiteettijoukon nimi. Pakollinen.
--related-id Liittyvän tietueen GUID-tunnus. Pakollinen.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data associate Esimerkkejä

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

data count komento

Laske taulukon tietueet, jotka on valinnaisesti suodatettu.

data count Parametrit

Parametri Kuvaus
--table, -t Entiteettijoukon nimi. Pakollinen, ellei käytössä --fetchxmlole .
--filter, -f OData-lauseke $filter .
--fetchxml FetchXML-koostekysely monimutkaisia määriä varten.
--target Reitti ( dataverse oletus) tai linkitettyyn erp ympäristöön.
--cross-company Tämä on vain ERP. Laske kaikissa yrityksissä. Oletusarvo: käyttäjän oletusyritys.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data count Esimerkkejä

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

data create komento

Luo uusi tietue Dataverse-taulukkoon. Määritä hakusarakkeita syntaksin avulla @odata.bind .

data create Parametrit

Parametri Kuvaus
--table, -t Entiteettijoukon nimi. Pakollinen.
--data, -d JSON-objekti, jolla on kenttien arvot.
--data-file Polku JSON-tiedostoon, jossa on tietuetietoja.
--return, -r Palauta koko luotu tietue.
--target Reitti ( dataverse oletus) tai linkitettyyn erp ympäristöön.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data create Esimerkkejä

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

Vinkki

Käytä --data-file monimutkaisessa JSON-muodossa. --return --json Käytä tätä koko luodun tietueen noutamiseen.

data delete komento

Poista yksittäinen tietue sen perusavaimella tai vaihtoehtoisella avaimella.

data delete Parametrit

Parametri Kuvaus
--table, -t Entiteettijoukon nimi. Pakollinen.
--id, -i Tietueen GUID-tunnus.
--key, -k Vaihtoehtoinen avain.
--no-confirm Ohita vahvistuskehote.
--target Reitti ( dataverse oletus) tai linkitettyyn erp ympäristöön.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data delete Esimerkkejä

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

data describe komento

OData-entiteetin rakenteen kuvaus. Dataversen tapauksessa komento kutsuu EntityDefinitions(LogicalName='<table>')$expand kutsuja, joiden vetäjänä --includeon , sekä toinen kutsu customapis , kun --include actions arvo on määritetty. Sisäisiä Dataverse-toimintoja, kuten Assign ja SetState , ei luetteloida. ERP:ssä yksittäinen kutsu /Metadata/PublicEntities palauttaa ominaisuudet, sidotut toiminnot ja siirtymistoiminnot yhdessä.

data describe Parametrit

Parametri Kuvaus
--target Kohde: dataverse (oletus) tai erp.
--table, -t Pakollinen. Dataversen looginen nimi, kuten account. ERP:ssä entiteettijoukon nimi, kuten BatchJobs.
--include Pilkuin eroteltu osioiden luettelo, joka sisältää seuraavat osat: entity, properties, relations, actions, tai all. Aliakset: attributes=properties, relationships=relations. ERP:n oletusasetus: all. Dataversen oletusasetus: entity,properties.
--json Tulosta raaka JSON.

data describe Esimerkkejä

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

data disassociate komento

Poista kahden tietueen välinen suhde. Tätä komentoa tuetaan vain Dataverselle.

data disassociate parametrit

Parametri Kuvaus
--table, -t Ensisijaisen tietueen entiteettijoukon nimi. Pakollinen.
--id, -i Ensisijaisen tietueen GUID-tunnus. Pakollinen.
--relationship, -rel Siirtymisominaisuuden nimi. Pakollinen.
--related-id Liittyvän tietueen GUID-tunnus monta moneen -suhteessa. Poista tämä parametri valinnan tyhjentämiseksi.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data disassociate Esimerkkejä

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

data get komento

Nouda yksittäinen tietue sen tunnuksen (perusavaimen) tai vaihtoehtoisen avaimen avulla.

data get Parametrit

Parametri Kuvaus
--table, -t Entiteettijoukon nimi. Pakollinen.
--id, -i Tietueen GUID-tunnus (perusavain).
--key, -k Vaihtoehtoinen avain, esimerkiksi "col='val'".
--select, -s Pilkuin eroteltu sarakeluettelo ($select).
--expand, -x OData-lauseke $expand liittyviä tietueita varten.
--target Reitti ( dataverse oletus) tai linkitettyyn erp ympäristöön.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data get Esimerkkejä

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 komento

Suorita OData-, FetchXML- tai SQL-kysely Dataverse-taulukkoa vasten.

data query Parametrit

Parametri Kuvaus
--table, -t Entiteetti määrittää kyselyn nimeksi . Pakollinen OData-kyselyille.
--select, -s Pilkuin eroteltu sarakeluettelo ($select).
--filter, -f OData-lauseke $filter .
--orderby, -o OData-lauseke $orderby .
--top Palautettavien tietueiden enimmäismäärä (1-5 000).
--expand, -x OData-lauseke $expand liittyviä tietueita varten.
--fetchxml Sisäinen FetchXML-kysely.
--fetchxml-file Polku tiedostoon, joka sisältää FetchXML-kyselyn.
--sql SQL-kysely SELECT (esikatselu).
--sql-file SQL-kyselyn sisältävän tiedoston polku.
--all, -a Nouda kaikki tietueet seuraamalla sivutusta.
--max-records :n käytön --allaikana noudettavien tietueiden enimmäismäärä. Oletus: 100000.
--target Reitti ( dataverse oletus) tai linkitettyyn erp ympäristöön.
--cross-company Tämä on vain ERP. Kyselyjä kaikissa yrityksissä. Oletusarvo: käyttäjän oletusyritys.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data query Esimerkkejä

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

Opi lisää

data update komento

Päivitä yksi tai useampi kenttä olemassa olevasta tietueesta, joka tunnistetaan sen tunnuksen tai vaihtoehtoisen avaimen perusteella. Määritä hakusarakkeita syntaksin avulla @odata.bind .

data update Parametrit

Parametri Kuvaus
--table, -t Entiteettijoukon nimi. Pakollinen.
--id, -i Tietueen GUID-tunnus.
--key, -k Vaihtoehtoinen avain.
--data, -d JSON-objekti, joka sisältää päivitettävät kentät.
--data-file Polku JSON-tiedostoon, jossa on päivitystiedot.
--return, -r Palauta koko päivitetty tietue.
--target Reitti ( dataverse oletus) tai linkitettyyn erp ympäristöön.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data update Esimerkkejä

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

data upload komento

Lataa paikallinen tiedosto olemassa olevan tietueen Dataverse-tiedostosarakkeeseen. Komento valitsee automaattisesti yksittäisen pyynnön tai latauksen lohkona tiedoston koon perusteella, ellet määritä --mode. Automaattisessa tilassa alle 128 Mt:n tiedostot ladataan yhteen pyyntöön, ja suuremmissa tiedostoissa käytetään lohkomuotoista latausta. Kun poistat --mime-type-komennon, komento johtaa MIME-tyypin tiedostotunnisteesta. Tuntemattomien laajennusten oletusarvo on application/octet-stream.

data upload Parametrit

Parametri Kuvaus
--table, -t Taulukon rakenne tai looginen nimi, kuten account. Pakollinen. Komento ratkaisee entiteetin arvon metatiedoista.
--id, -i Tietueen GUID-tunnus. Pakollinen.
--column, -c Tiedostosarakkeen määritteen nimi. Pakollinen.
--file, -f Paikallisen tiedoston polku. Pakollinen.
--mode, -m Latausstrategia: auto (oletus), small, tai chunk.
--mime-type Eksplisiittinen MIME-tyyppi. Oletusarvo: päätelty tiedostotunnisteesta.
--overwrite Korvaa olemassa oleva tiedosto. Oletusarvoisesti komento epäonnistuu, jos sarake ei ole tyhjä.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data upload Esimerkkejä

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 komento

Luo tietue, jos sitä ei ole olemassa, tai päivitä se, jos sitä ei ole. Tietue tunnistetaan vaihtoehtoisella avaimella. Opi käyttämään vaihtoehtoista avainta tietueeseen viittaamiseksi

data upsert Parametrit

Parametri Kuvaus
--table, -t Entiteettijoukon nimi. Pakollinen.
--key, -k Vaihtoehtoinen avain. Pakollinen.
--data, -d JSON-objekti, jolla on kenttien arvot.
--data-file JSON-tiedoston polku.
--update-only Epäonnistuu, jos tietuetta ei ole (If-Match: *).
--create-only Epäonnistuu, jos tietue on jo olemassa (If-None-Match: *).
--return, -r Palauta koko tietue toiminnon jälkeen.
--target Reitti ( dataverse oletus) tai linkitettyyn erp ympäristöön.
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

data upsert Esimerkkejä

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

erp batch cancel komento

Peruuta Finance and Operations -erätyö sen RecIdmukaan. Etsi kohteen RecIdavulla erp batch list .

erp batch cancel Esimerkkejä

dataverse erp batch cancel <recid>

erp batch list komento

Luettele Erätyöt Finance and Operations -esiintymässä, joka on linkitetty Dataverse-ympäristöösi. Komento edellyttää todennusprofiilia, joka on yhdistetty Dataverse-ympäristöön, jossa on linkitetty Finance and Operations -esiintymä. Finance and Operationsin URL-osoite johdetaan automaattisesti nykyisestä Dataverse-yhteydestä.

erp batch list parametrit

Parametri Kuvaus
--company Suodata juridisen entiteetin (dataAreaId) mukaan, kuten USMF.
--status Suodata tilan mukaan: Waiting, Executing, Finished, Errortai Cancelled.
--top Palautettavien tulosten enimmäismäärä. Oletus: 20.
--caption Suodata kuvatekstin mukaan (kirjainkoko ei ole merkitsevä alimerkkijonon vastaavuus).
--json Tulosta raaka JSON.

erp batch list Esimerkkejä

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

install komento

Asenna DataverseN komentorivikäyttöliittymän tietty versio tai päivitä uusimpaan versioon. Komento tunnistaa, oletko asentanut komentorivikäyttöliittymän yleisesti vai käytätkö npx sitä ja asennatko sen vastaavasti.

install Esimerkkejä

Asenna uusin versio:

dataverse install latest

Asenna tietty versio:

dataverse install 1.0.0

mcp komento

Käynnistää MCP-palvelimen, joka on yhteydessä ympäristöösi, jotta tekoälyavustajat, kuten Claude Desktop, voivat käsitellä tietojasi. Kohde tunnistetaan automaattisesti URL-osoitteesta: Dataversen URL-osoite käynnistää Dataverse MCP -palvelimen ja Finance and Operations -URL-osoite, kuten https://myorg.operations.dynamics.com, käynnistää ERP MCP -palvelimen.

mcp-syntaksi

dataverse mcp <orgUrl> [options]

Argumentti <orgUrl> on organisaatiosi URL-osoite, esimerkiksi https://myorg.crm.dynamics.com.

mcp Parametrit

Parametri Kuvaus
--validate Vahvista MCP-päätepisteet ja todentamisen asetukset käynnistämättä palvelinta.
--log-level Määritä kirjaustaso: Trace, , Debug, InformationWarning, , Errortai Critical. Oletus: Warning.
--log-file Kirjaudu väliaikaisen hakemiston tiedostoon.
--preview Käytä esikatselun MCP-päätepistettä (api/mcp_previewapi/mcp). Ei tueta ERP:ssa.

mcp Esimerkkejä

Määrityksen vahvistaminen (suositeltu ensimmäinen vaihe):

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

Käynnistä palvelin stdio-kuljetuksen avulla:

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

Käytä esikatselun päätepistettä tai ota tiedoston virheenkorjaus käyttöön:

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

mcp allow komento

Varmista, että Microsoft Entra sovellus on nykyisen profiilin ympäristön Dataverse MCP -sallittujen asiakkaiden luettelossa. Tämä komento on vaihtoehto edellytyksille kuvatulle manuaalisille järjestelmänvalvojan vaiheille. Todennetulla käyttäjällä on oltava Dataverse-järjestelmänvalvojan oikeudet kohdeympäristöön.

mcp allow-syntaksi

dataverse mcp allow <appId> [options]

Argumentti <appId> on sovelluksen (asiakkaan) tunnus, joka sallitaan GUID-tunnuksena.

mcp allow parametrit

Parametri Kuvaus
--erp Salli sovellus linkitetyssä Finance and Operations -esiintymässä Dataversen sijaan.

mcp allow Esimerkkejä

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

Muistio

Finance and Operations tallentaa sallittujen luettelon välimuistiin AOS:ssä, joten äskettäin sallitun sovellustunnuksen voimaantulo voi kestää jopa viisi minuuttia.

org list komento

Luettele kaikki ympäristöt, joihin sinulla on käyttöoikeus.

org list Parametrit

Parametri Kuvaus
--filter Suodata ympäristöluettelo hakutermin mukaan.
--json Tulosta raaka JSON.

org list Esimerkkejä

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

org who komento

Näytä nykyisen organisaation ja käyttäjän tietoja aktiivisen todennusprofiilin avulla. Komento env on -alias.org

org who Parametrit

Parametri Kuvaus
--environment, -env Ohita ympäristön URL-osoite.
--json Tulosta raaka JSON.

org who Esimerkkejä

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

skill-komennot

Hallitse Dataverse-taitoja – uudelleenkäytettäviä ohjejoukkoja ( SKILL.md tiedostoa ja sen resurssitiedostoja), joita tekoälyagentit käyttävät ja jotka on tallennettu yhdistettyyn ympäristöön. Ylimmän tason skill komennot tarjoavat ympäristökohtaisia luonti-, luku-, päivitys- ja poistotoimintoja. Paikallisesti taidot tallennetaan kohteeseen .claude/skills/<name>/.

Muistio

Taitojen tuottamisen ja arvioinnin komennot, kuten make, update, getja eval, ovat erillään näistä komennoista. Saat lisätietoja suorittamalla komennon dataverse workspace skill --help.

skill delete komento

Poista taito ja kaikki sen resurssit aktiivisesta Dataverse-ympäristöstä. Etsi -parametrilla skill list yksilöivät taidot.

dataverse skill delete new_lead-qualification

skill download komento

Lataa yksi tai useampia taitoja aktiivisesta Dataverse-ympäristöstä levylle. Komento lataa tiedoston ja kaikki resurssitiedostot SKILL.md , säilyttäen hakemistorakenteen. Etsi -parametrilla skill list yksilöivät taidot.

Parametri Kuvaus
--all Lataa kaikki aktiiviset taidot ympäristöstä. Sitä ei voi yhdistää taito-yksilölliseen nimeen.
--output, -o Tuloksen perushakemisto. Oletus: .claude/skills/. Kun --all,, jokainen taito kirjoitetaan kohteeseen <path>/<name>/.
--json Tulosta taitosisältö JSON-muodossa kirjoittamatta tiedostoja. Määritä halutessasi tiedostopolku, jolle kirjoitat. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list komento

Luettele kaikki aktiiviset taidot yhdistetyssä Dataverse-ympäristössä.

Parametri Kuvaus
--resources, -r Luettele myös kunkin taidon resurssitiedostot.
--json Tuloste muodossa JSON. Määritä halutessasi tiedostopolku, jolle kirjoitat. 
dataverse skill list
dataverse skill list --resources

skill upload komento

Lataa yksi tai useampi taito levyltä aktiiviseen Dataverse-ympäristöön. Komento tukee hakemistoja, .zip-tiedostoja , .skill-tiedostoja ja .md-tiedostoja .

Voit välittää taidon <name>, jonka ratkaisu on .claude/skills/<name>/, tai eksplisiittisen <path> hakemiston tai tiedoston.

Parametri Kuvaus
--all Lataa kaikki taidot kohdasta .claude/skills/. Taitonimeen tai polkuun ei voi yhdistää.
--json Tulosta tulos JSON-muodossa. Määritä halutessasi tiedostopolku, jolle kirjoitat. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Katso myös

Tietojen käsitteleminen Dataversen komentorivikäyttöliittymän avulla

  • Last updated on