Dataverse CLI erreferentzia (aurrebista)

Oharra

  • Hau aurreikuspen-eginbidea da.
  • Aurrebista-eginbideak ez daude ekoizpenerako diseinatuta, eta funtzionalitate murriztua izan dezakete. Eginbide horiek kaleratze ofiziala baino lehen dauden erabilgarri, bezeroek atzitu eta beren oharrak eman ditzaten.

Artikulu honek Dataverse CLIn eskuragarri dauden komandoak deskribatzen ditu. Komando bakoitzak bere erabilera, aukerak eta adibideak zerrendatzen dituen aukera bat onartzen --help du. Datuak itzultzen dituzten komandoek script batzuetan erabilgarria den JSON gordineko irteera aukera bat onartzen --json dute.

Hurrengo aukera global hauek edozein komandorekin erabil daitezke:

Aukera Deskribapenak
--log-level <level> Ezarri log maila: Trace, Debug, Information, Warning, Error, edo Critical. Lehenetsia: Warning.
--log-file Sartu saioa aldi baterako direktorio batean kontsolaren ordez.
--context <value> Eragiketa testuingurua User-Agent-ari gehituta. Ingurune aldagaia ere ezar DATAVERSE_OPERATION_CONTEXT dezakezu.
Komandoa Deskribapenak
api describe Deskribatu API bat
api invoke API bat izenez deitu
api list Zerrendatu aurkigarri diren APIak
api request HTTP eskaera autentifikatua bidali
auth create Sortu autentifikazio profil berri bat
auth list Zerrendatu autentifikazio profil guztiak
auth remove Autentifikazio profila kendu
auth select Hautatu aktibo autentifikazio profila
auth who Erakutsi egungo autentifikazio profila
data associate Bi disko lotura harreman baten bidez
data count Taula batean dauden zenbaketa erregistroak
data create Sortu erregistro bat
data delete Ezabatu erregistro bat
data describe Deskribatu entitate baten eskema
data disassociate Bi erregistroen arteko harremana kentzea
data get ID edo giltza alternatibo baten bidez erregistro bakarra berreskuratu
data query OData, FetchXML edo SQL kontsulta bat exekutatu
data update Eguneratu lehendik dagoen erregistro bat
data upload Fitxategi bat fitxategi zutabe batera igo erregistro existente batean
data upsert Sortu edo eguneratu erregistro bat gako alternatibo baten bidez
erp batch cancel Finantza eta Operazioetako batch lan bat bertan behera utzi
erp batch list Finantza eta Operazioetako lanpostuak zerrendatu
install Bertsio zehatz bat instalatu, edo azken bertsiora eguneratu
mcp Hasi MCP zerbitzaria Dataverse edo ERPrako
mcp allow Aplikazio bat MCP bezero gisa onartu
org list Zerrendatu eskuragarri dauden ingurune guztiak
org who Erakutsi egungo antolaketa eta erabiltzaileen informazioa
skill delete Dataverse-tik trebetasun bat ezabatu
skill download Dataverse-tik gaitasun bat deskargatu
skill list Zerrendatu ingurunean trebetasun aktiboak
skill upload Trebetasun bat Dataverse-ra igo

Oharra

Komando askok aukera bat onartzen --target <dataverse\|erp> dute, operazioa Dataverse-ra (lehenetsita) edo Finance and Operations (ERP) ingurune lotuan bideratzen duena. Ingurune batera konektatzen diren komandoek (-env) aukera bat onartzen --environment <url> dute profilaren ingurune URLa gainditzeko.

api describe Agintea

API bakar baten metadatuak erakutsi. Dataverse API pertsonalizatuetan, irteerak eskaera parametroak eta erantzun propietateen deskribapenak barne hartzen ditu metadatuek ematen dituztenean.

Dataverseko izenak lehenetsita ez daude aurrizkirik gabe. ERP kualifikatutako izenak erabil ditzakezu inprimakian erp:ServiceGroup/Service/Operation.

api describe Parametroak

Parametroa Deskribapenak
--target Izen baldintzarik gabeko bat konpondu edo dataverseerp.
--service-group ERP bakarrik. Operazio bilaketa zerbitzu talde bakar batera murriztu.
--service ERP bakarrik. Murriztu operazio bilaketa zerbitzu bakar batera.
--environment Dataverse ingurunearen URLa gainidatzi.
--json Atera JSON gordina.

api describe adibideak

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

api invoke Agintea

Izenez deitu aurkitutako API bat. Parametroetarako sintaxia erabili name=value . Balio batek espazioak baditu, token osoa aipatu. Dataverse API batzuek kate-parametro bat onartzen dute, eta haren edukia JSON da. Kasuan horretan, JSON testua balio gisa pasatu zure shellaren ohiko aipuak eta ihes egiteko arauak erabiliz.

Lehenetsita, JSON erantzunak testu formatu atsegin batean agertzen dira, irteerako propietateen izenak mantenduz. JSON karga gordina gordetzeko erabili --json behar da.

api invoke Parametroak

Parametroa Deskribapenak
--target Izen baldintzarik gabeko bat konpondu edo dataverseerp.
--service-group ERP bakarrik. Operazio bilaketa zerbitzu talde bakar batera murriztu.
--service ERP bakarrik. Murriztu operazio bilaketa zerbitzu bakar batera.
--param Gehitu parametro izendapen bat formatuan name=value . Errepikakorra.
--bind Dataverse APIentzako lotura bidea.
--method, -X HTTP metodoa gainidatzi.
--body Erabili JSON gorputz gordina parametro izendatuen ordez.
--body-file Fitxategi batetik JSON gorputz gordina irakurri.
--header, -H HTTP goiburu bat gehitu formulario batean key:value .
--include, -i Sartu erantzunaren egoera eta goiburuak.
--environment Dataverse ingurunearen URLa gainidatzi.
--json Atera JSON gordina testu atseginaren ordez.

api invoke adibideak

Deitu Dataverse funtzio bat. Adibide honek Dynamics 365 Contact Center CCaaS_GetPresence funtzioaren erabilera erakusten du.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Deitu Dataverse AISummarize ekintza parametro balio batean espazioekin:

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

Deitu ERP zerbitzu pertsonalizatu bat:

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

api list Agintea

Zerrendatu aurkigarri diren APIak, hala nola Dataverse API pertsonalizatuak eta ERP zerbitzu deigarriak. Emaitzek API identitatea, izen lagunkoia, mota eta deskribapena erakusten dituzte eskuragarri daudenean. Emaitzak iragazteko kontsulta termino bat pasa dezakezu.

api list Parametroak

Parametroa Deskribapenak
--target Bilaketa helburu sistema: dataverse (lehenetsia) edo erp.
--service-group ERP bakarrik. Iragazi zerbitzu talde bakarrean.
--service ERP bakarrik. Iragazi zerbitzu bakar batera.
--limit API kopuru maximoa itzultzeko. Lehenetsia: 50.
--page 1 oinarritutako orrialde zenbakia emaitzak orrialdean sartzean. Lehenetsia: 1.
--environment Dataverse ingurunearen URLa gainidatzi.
--json Atera JSON gordina.

api list adibideak

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 Agintea

Bidali HTTP eskaera gordina eta autentifikatu bat Dataverse edo ERP-ra. Erabili komando hau bidea, metodoa, goiburuak eta gorputza kontrol osoa behar duzunean.

api request Parametroak

Parametroa Deskribapenak
--target Helburu sistema: dataverse edo erp. Beharrezkoa.
--path Eskaera bidea. Beharrezkoa.
--method, -X HTTP metodoa. Lehenetsia: GET, edo POST gorputz bat hornitzen denean.
--body JSON eskaera lerroko gorputz bat.
--body-file JSON objektu eskaera baten gorputza duen fitxategi bat.
--header, -H HTTP goiburu bat gehitu formulario batean key:value .
--include, -i Sartu erantzunaren egoera eta goiburuak.
--environment Dataverse ingurunearen URLa gainidatzi.

api request adibideak

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 Agintea

Autentifikazio profil berri bat sortu.

auth create Parametroak

Erabili parametro hauek komandoaren portaera auth create zehazteko.

Parametroa Deskribapenak
--environment, -env Autenticatu nahi duzun Dataverse ingurunearen URL-a.
--name, -n Profilaren izen aukerakoa. Izena erabili profila geroago aukeratzeko.
--cloud, -ci Helburu hodeia: Public, UsGov, UsGovHigh, UsGovDod, edo China.
--deviceCode, -dc Erabili gailuaren kodearen autentifikazio fluxua, nabigatzailerik gabeko inguruneetarako.
--username, -un Erabiltzaile izen eta pasahitz autentifikaziorako erabiltzaile izena.
--password, -p Erabiltzaile izenaren eta pasahitzaren autentifikazioaren pasahitza.
--applicationId, -id Aplikazioaren (bezeroaren) ID zerbitzu nagusiaren (SPN) autentifikaziorako.
--clientSecret, -cs Bezeroaren sekretua zerbitzu nagusiaren autentifikaziorako.
--certificateDiskPath, -cdp .pfx ziurtagiri fitxategi baterako bidea, ziurtagirietan oinarritutako autentifikaziorako.
--certificatePassword, -cp Ziurtagiriaren pasahitza.
--tenant, -t Alokairu IDa. Zerbitzu nagusiaren autentifikaziorako beharrezkoa.
--managedIdentity, -mi Erabili Azure kudeatutako identitate bat.
--githubFederated, -ghf Erabili GitHub Actions federatutako autentifikazioa.
--azureDevOpsFederated, -adof Erabili Azure DevOps federated authentication.
--clientid, -cid Microsoft Entra aplikazio bezero ID pertsonalizatu bat erabiltzeko, Dataverse CLI aplikazio lehenetsiaren ordez.
--no-default-environment Ez ezarri ingurunea lehenetsita.
--accept-cleartext-caching Linuxen token cache testu argia onartu.

auth create adibideak

Ondorengo adibideek erakusten dute nola erabili komandoa auth create .

Autentifikazio interaktiboa

Komando honek nabigatzaile edo sistema elkarrizketa bat irekitzen du informazio gehigarria lortzeko.

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

Izendatutako profila

Sortu profil bat izen zehatz batekin.

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

Gailuaren kodeen fluxua

Erabili gailuaren kode-fluxua nabigatzailerik gabeko inguruneetarako.

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

Zerbitzu nagusia bezeroaren sekretuarekin

Erabili zerbitzu nagusi bat autentifikazio zaindu gabe behar duzunean, adibidez CI/CD pipeline batean edo beste script automatizatu batean, non saioa hasi ezin den interaktiboki. Eman aplikazio ID-a, bezeroaren sekretua eta ingurunerako sarbidea duen aplikazio erregistroaren ID-a.

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

Entra aplikazio pertsonalizatuaren bezero IDa

Erabili zure aplikazioaren erregistro propioa lehenetsitako erregistroaren ordez.

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

auth list Agintea

Zerrendatu autentifikazio profil guztiak. Gehitu --json JSON gordina lortzeko.

auth list adibideak

dataverse auth list
dataverse auth list --json

auth remove Agintea

Kendu autentifikazio profil bat edo guztiak.

auth remove Parametroak

Parametroa Deskribapenak
--index, -i Kendu 1 oinarritutako indizea duen profila, auth list.
--name, -n Kendu zehaztutako izena duen profila.
--all Profil guztiak kendu.

auth remove adibideak

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

auth select Agintea

Hautatu autentifikazio aktiboaren profila. Exekutatu komandoa profil guztiak zerrendatzeko aukerarik gabe.

auth select Parametroak

Parametroa Deskribapenak
--index, -i Hautatu profila bere 1 oinarritutako indizearen arabera, auth list.
--name, -n Hautatu profila izenaren arabera.

auth select adibideak

Ireki hautatzaile interaktibo bat. Erabili gezi teklak, edo idatzi iragazkia:

dataverse auth select

Hautatu profila indizearen arabera edo izenaren arabera:

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

auth who Agintea

Erakutsi uneko autentifikazio profila aktiboa. Gehitu --json JSON gordina lortzeko.

auth who adibideak

dataverse auth who
dataverse auth who --json

data associate Agintea

Bi erregistro nabigazio propietate baten bidez (erlazioa) lotu. Komando hau Dataverse-rako bakarrik onartzen da.

data associate Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen ezarpen izena erregistro nagusiaren izena. Beharrezkoa.
--id, -i Lehen mailako erregistroaren GUID-a. Beharrezkoa.
--relationship, -rel Nabigazio jabetzaren izena. Beharrezkoa.
--related Erlazionatutako taularen entitate multzoaren izena. Beharrezkoa.
--related-id Lotutako erregistroaren GUID-a. Beharrezkoa.
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data associate adibideak

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

data count Agintea

Zenbatu erregistroak taula batean, aukeraz iragaziz.

data count Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen multzoaren izena. Derrigorrezkoa da, baldin eta ez baduzu --fetchxml.
--filter, -f OData $filter adierazpen bat.
--fetchxml FetchXML agregatu kontsulta konplexuetarako.
--target Bidea dataverse (lehenetsia) edo lotutako ingurunea erp .
--cross-company ERP bakarrik. Enpresa guztietan zenbatu. Lehenetsia: erabiltzailearen enpresa lehenetsia.
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data count adibideak

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

data create Agintea

Dataverse taula batean erregistro berri bat sortu. Bilaketa zutabeak ezarri sintaxia erabiliz @odata.bind .

data create Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen multzoaren izena. Beharrezkoa.
--data, -d JSON objektu bat eremu balioekin.
--data-file JSON fitxategi batera doan bidea, erregistro datuekin.
--return, -r Sortutako erregistro osoa itzuli.
--target Bidea dataverse (lehenetsia) edo lotutako ingurunea erp .
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data create adibideak

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

Argibidea

JSON konplexuetarako erabili.--data-file Erabili --return --json sortutako erregistro osoa lortzeko.

data delete Agintea

Ezabatu erregistro bakar bat bere gako nagusiarekin edo beste giltza batekin.

data delete Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen multzoaren izena. Beharrezkoa.
--id, -i Erregistroaren GUID-a.
--key, -k Giltza alternatibo bat.
--no-confirm Saihestu baieztapen eskaera.
--target Bidea dataverse (lehenetsia) edo lotutako ingurunea erp .
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data delete adibideak

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

data describe Agintea

Deskribatu OData entitate baten eskema. Dataverse-n, komandoak EntityDefinitions(LogicalName='<table>') gidatutako --include$expand , gehi bigarren dei bat customapis deitzen du noiz --include actions ezarri den. Dataverse-n barneko ekintzak, hala Assign nola eta SetState ez dira zerrendatzen. ERPrako, dei bakar batek /Metadata/PublicEntities propietateak, ekintza mugatuak eta nabigazioak batera itzultzen ditu.

data describe Parametroak

Parametroa Deskribapenak
--target Helburua: dataverse (lehenetsia) edo erp.
--table, -t Beharrezkoa. Dataverse-rako, izen logikoa, adibidez account. ERPrako, entitate multzoaren izena, hala BatchJobsnola .
--include Atalen zerrenda bat koma bereizita, honako hauek barne: entity, properties, relations, actions, edo all. Ezizenak: attributes=properties, . relationships=relations ERPren lehenetsia: all. Dataverse-ren lehenetsia: entity,properties.
--json Atera JSON gordina.

data describe adibideak

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

data disassociate Agintea

Ezabatu bi diskoen arteko harremana. Komando hau Dataverse-rako bakarrik onartzen da.

data disassociate Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen ezarpen izena erregistro nagusiaren izena. Beharrezkoa.
--id, -i Lehen mailako erregistroaren GUID-a. Beharrezkoa.
--relationship, -rel Nabigazio jabetzaren izena. Beharrezkoa.
--related-id Erlazionatutako erregistroaren GUID-a, harreman askotariko baterako. Parametro hau kendu bilaketa bat garbitzeko.
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data disassociate adibideak

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

data get Agintea

Erregistro bakar bat bere IDaren (giltza primarioa) edo beste giltza baten bidez berreskuratu.

data get Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen multzoaren izena. Beharrezkoa.
--id, -i Grabazio GUID (giltza primarioa).
--key, -k Adibidez, gako "col='val'"alternatibo bat.
--select, -s Koma bidez bereiztutako zutabeen zerrenda bat ($select).
--expand, -x OData $expand adierazpen bat erregistro erlazionatuentzat.
--target Bidea dataverse (lehenetsia) edo lotutako ingurunea erp .
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data get adibideak

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 Agintea

OData, FetchXML edo SQL kontsulta bat exekutatu Dataverse taula batean.

data query Parametroak

Parametroa Deskribapenak
--table, -t Entitateak kontsulta egiteko izena ezartzen du. OData kontsultetarako beharrezkoa.
--select, -s Koma bidez bereiztutako zutabeen zerrenda bat ($select).
--filter, -f OData $filter adierazpen bat.
--orderby, -o OData $orderby adierazpen bat.
--top Itzultzeko gehienezko erregistro kopurua (1-5000).
--expand, -x OData $expand adierazpen bat erregistro erlazionatuentzat.
--fetchxml FetchXML kontsulta inlinea.
--fetchxml-file FetchXML kontsulta bat duen fitxategi batera doan bidea.
--sql SQL SELECT kontsulta bat (aurrebista).
--sql-file SQL kontsulta bat duen fitxategi batera doan bidea.
--all, -a Jarraitu orrialdea erregistro guztiak berreskuratzeko.
--max-records Erregistro gehienak berreskuratu --allbehar dira . Lehenetsia: 100000.
--target Bidea dataverse (lehenetsia) edo lotutako ingurunea erp .
--cross-company ERP bakarrik. Enpresa guztietan kontsulta egin. Lehenetsia: erabiltzailearen enpresa lehenetsia.
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data query adibideak

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

Informazio gehiago

data update Agintea

Eguneratu eremu bat edo gehiago dagoeneko dagoen erregistro batean, bere IDaren edo gako alternatibo baten bidez identifikatuta. Bilaketa zutabeak ezarri sintaxia erabiliz @odata.bind .

data update Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen multzoaren izena. Beharrezkoa.
--id, -i Erregistroaren GUID-a.
--key, -k Giltza alternatibo bat.
--data, -d JSON objektu bat eguneratu beharreko eremuekin.
--data-file Eguneratze datuekin JSON fitxategi batera doan bidea.
--return, -r Itzuli eguneratutako erregistro osoa.
--target Bidea dataverse (lehenetsia) edo lotutako ingurunea erp .
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data update adibideak

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

data upload Agintea

Igo fitxategi lokal bat Dataverse fitxategi zutabe batean dagoeneko dagoen erregistro batean. Komandoak automatikoki hautatzen du fitxategiaren tamainaren arabera eskaera bakarreko edo igoera zatikatua, ez baduzu zehaztu --mode. Auto moduan, 128 MB-tik beherako fitxategiak eskaera bakar batean igotzen dira, eta fitxategi handiagoek zatitan igotzen dute. Kanpoan --mime-typeutzita, komandoak MIME mota fitxategi luzapenetik ondorioztatzen du. Ezezagunak diren luzapenek lehenetsita.application/octet-stream

data upload Parametroak

Parametroa Deskribapenak
--table, -t Taula eskema edo izen logikoa, hala nola account. Beharrezkoa. Komandoak metadatuetatik entitate multzoa konpontzen du.
--id, -i Erregistroaren GUID-a. Beharrezkoa.
--column, -c Fitxategiaren zutabearen atributu izena. Beharrezkoa.
--file, -f Tokiko fitxategira doan bidea. Beharrezkoa.
--mode, -m Igoera estrategia: auto (lehenetsia), small, edo chunk.
--mime-type MIME mota esplizitua. Lehenetsia: fitxategi luzapenetik ondorioztatua.
--overwrite Fitxategi bat gainidatzi. Lehenetsita, komandoa huts egiten du zutabea hutsik ez badago.
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data upload adibideak

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 Agintea

Sortu erregistro bat existitzen ez bada, edo eguneratu badago. Erregistroa giltza alternatibo batek identifikatzen du. Ikasi giltza alternatibo bat erabiltzen erregistro bat erreferentzia egiteko

data upsert Parametroak

Parametroa Deskribapenak
--table, -t Entitatearen multzoaren izena. Beharrezkoa.
--key, -k Giltza alternatibo bat. Beharrezkoa.
--data, -d JSON objektu bat eremu balioekin.
--data-file JSON fitxategi baterako bidea.
--update-only Huts egiten du erregistroa ez badago (If-Match: *).
--create-only Huts egiten du erregistroa dagoeneko badago (If-None-Match: *).
--return, -r Itzuli erregistro osoa ebakuntzaren ondoren.
--target Bidea dataverse (lehenetsia) edo lotutako ingurunea erp .
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

data upsert adibideak

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

erp batch cancel Agintea

Finantza eta Operazioetako batch lan bat bertan behera utzi bere RecId. Erabili erp batch listRecId.

erp batch cancel adibideak

dataverse erp batch cancel <recid>

erp batch list Agintea

Zerrendatu zure Dataverse ingurunearekin lotutako Finantza eta Operazio instantzian batch lanak. Aginduak autentifikazio profil bat behar du, Dataverse ingurune batera konektatuta, Finantza eta Operazio instantzia lotua duena. Finantza eta Operazio URLa automatikoki Dataverse konexiotik dator.

erp batch list Parametroak

Parametroa Deskribapenak
--company Iragazi entitate juridikoaren arabera (dataAreaId), adibidez USMF.
--status Iragazi egoeraren arabera: Waiting, Executing, Finished, Error, edo Cancelled.
--top Emaitza gehienak itzultzeko. Lehenetsia: 20.
--caption Azpitituluaren arabera iragazi (azpikate-kate kontra-sentikorra).
--json Atera JSON gordina.

erp batch list adibideak

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

install Agintea

Dataverse CLI-ren bertsio zehatz bat instalatu, edo azken bertsiora eguneratu. Komandoak detektatzen du CLI globalki instalatu duzun ala erabiltzen npx ari zaren eta horren arabera instalatzen du.

install adibideak

Instalatu azken bertsioa:

dataverse install latest

Instalatu bertsio zehatz bat:

dataverse install 1.0.0

mcp Agintea

Model Context Protocol (MCP) zerbitzari bat abiarazten du, zure ingurunearekin konektatzen dena, Claude Desktop bezalako AI laguntzaileek zure datuekin elkarreragin dezaten. Helburua automatikoki detektatzen da URLetik: Dataverse URL batek Dataverse MCP zerbitzaria abiarazten du, eta Finantza eta Operazio URL batek, adibidez https://myorg.operations.dynamics.com, ERP MCP zerbitzaria abiarazten du.

mcp Sintaxia

dataverse mcp <orgUrl> [options]

Argudioa <orgUrl> zure erakundearen URL-a da, adibidez https://myorg.crm.dynamics.com.

mcp Parametroak

Parametroa Deskribapenak
--validate MCP puntuak eta autentifikazio konfigurazioa balioztatu zerbitzaria abiarazi gabe.
--log-level Ezarri log maila: Trace, Debug, Information, Warning, Error, edo Critical. Lehenetsia: Warning.
--log-file Saioa hasi fitxategi batera aldi baterako direktorioan.
--preview Erabili aurreikuspen MCP amaiera (api/mcp_previewapi/mcpordez ). ERPrako ez da onartzen.

mcp adibideak

Egiaztatu konfigurazioa (gomendatutako lehen pausoa):

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

Hasi zerbitzaria stdio garraioa erabiliz:

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

Erabili aurrebista amaiera, edo gaitu debug fitxategien loging-a:

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

mcp allow Agintea

Ziurtatu Microsoft Entra aplikazio bat Dataverse MCP onartutako bezeroen zerrendan dagoela profilaren ingurunerako. Agindu hau eskuzko administrazio urratsaren alternatiba da, aurre-baldintzetan deskribatzen dena. Erabiltzaile autentifikatuak Dataverse administratzaile baimenak izan behar ditu helburu ingurunean.

mcp allow Sintaxia

dataverse mcp allow <appId> [options]

Argudioa <appId> da aplikazioaren (bezeroaren) IDa baimentzea, GUID gisa.

mcp allow Parametroak

Parametroa Deskribapenak
--erp Aplikazioa Finantza eta Operazio instantzia lotuan onartu Dataverse-ren ordez.

mcp allow adibideak

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

Oharra

Finantza eta Operazioek baimenen zerrenda AOSen cacheatzen dute, beraz, aplikazio ID berriak bost minutu inguru behar izan ditzake eragina izateko.

org list Agintea

Sartu ditzakezun ingurune guztiak zerrendatu.

org list Parametroak

Parametroa Deskribapenak
--filter Inguruneen zerrenda bilaketa termino baten arabera iragazi.
--json Atera JSON gordina.

org list adibideak

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

org who Agintea

Erakutsi egungo erakundeari eta erabiltzaileari buruzko informazioa, autentifikazio aktiboaren profila erabiliz. Agindua env alias bat da org.

org who Parametroak

Parametroa Deskribapenak
--environment, -env Ingurumen URLa gainidatzi.
--json Atera JSON gordina.

org who adibideak

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

skill Aginduak

Kudeatu Dataverseko trebetasunak—AI agenteek erabiltzen dituzten instrukzio berrerabilgarriak ( SKILL.md fitxategi bat eta bere baliabide fitxategiak)—ingurune konektatuan gordetzen direnak. Maila skill goreneko komandoek sortu, irakurri, eguneratu eta ezabatu eragiketak eskaintzen dituzte ingurunearen aurka. Tokian tokiko, trebetasunak .claude/skills/<name>/.

Oharra

Trebetasunen egile eta ebaluazio aginduak, hala nola make, update, get, eta eval, agindu horietatik bereizita daude. Informazio gehiago nahi izanez gero, exekutatu dataverse workspace skill --help.

skill delete Agintea

Ezabatu trebetasun bat eta bere baliabide guztiak Dataverse aktiboko ingurunetik. Erabili skill list trebetasun izen bereziak aurkitzeko.

dataverse skill delete new_lead-qualification

skill download Agintea

Deskargatu Dataverse aktibo den ingurunetik trebetasun bat edo gehiago diskoan. Komandoak fitxategia SKILL.md eta baliabide fitxategi guztiak deskargatzen ditu, direktorioaren egitura mantenduz. Erabili skill list trebetasun izen bereziak aurkitzeko.

Parametroa Deskribapenak
--all Deskargatu inguruneko trebetasun aktibo guztiak. Ezinezkoa da gaitasun izen bakarra batekin konbinatu.
--output, -o Irteerarako oinarrizko direktorioa. Lehenetsia: .claude/skills/. , --alltrebetasun bakoitza honela <path>/<name>/idazten da.
--json Trebetasun edukia JSON moduan atera, fitxategiak idatzi gabe. Aukeran, idazteko fitxategi bide bat zehaztu. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list Agintea

Dataverse ingurune konektatuan dauden trebetasun aktibo guztiak zerrendatu.

Parametroa Deskribapenak
--resources, -r Era berean, trebetasun bakoitzeko baliabide fitxategiak zerrendatu.
--json JSON moduan irtetea. Aukeran, idazteko fitxategi bide bat zehaztu. 
dataverse skill list
dataverse skill list --resources

skill upload Agintea

Igo gaitasun bat edo gehiago diskotik Dataverse ingurune aktiborera. Komandoak direktorioak, .zip fitxategiak, .skill fitxategiak eta .md fitxategiak onartzen ditu.

Trebetasun <name>bat pasa dezakezu , zeina konpontzen .claude/skills/<name>/den , edo esplizitu <path> bat direktorio edo fitxategi batera.

Parametroa Deskribapenak
--all Igo gaitasun .claude/skills/guztiak . Ez da gaitasun izen edo bide batekin konbinatu daitekeena.
--json Emaitza JSON moduan atera. Aukeran, idazteko fitxategi bide bat zehaztu. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Ikus ere

Dataverse CLI erabiliz datuekin lan egin

  • Last updated on