Referenčné informácie o formáte Dataverse CLI (Preview)

Poznámka

  • Toto je ukážková funkcia.
  • Funkcie ukážky nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.

Tento článok popisuje príkazy dostupné v rozhraní Dataverse CLI. Každý príkaz podporuje --help možnosť, ktorá uvádza jej použitie, možnosti a príklady. Príkazy, ktoré vracajú údaje podporujú --json možnosť nespracovaných výstupov JSON, ktorá je užitočná v skriptoch.

S ľubovoľným príkazom možno použiť nasledujúce globálne možnosti:

Možnosť Opis
--log-level <level> Nastavte úroveň zapisovania do denníka: Trace, Debug, Information, Warning, Erroralebo Critical. Predvolená hodnota: Warning.
--log-file Prihláste sa do súboru v dočasnom adresári namiesto konzoly.
--context <value> Kontext operácie pripojený k používateľovi – agentovi. Môžete tiež nastaviť premennú DATAVERSE_OPERATION_CONTEXT prostredia.
Príkaz Opis
api describe Popis rozhrania API
api invoke Vyvolanie rozhrania API podľa názvu
api list Rozhranie API na zistenie zoznamu
api request Odoslanie overenej požiadavky HTTP
auth create Vytvorenie nového profilu na overovanie
auth list Zobrazenie zoznamu všetkých overovacích profilov
auth remove Odstránenie overovacieho profilu
auth select Vyberte profil aktívneho overovania
auth who Zobrazenie aktuálneho profilu overovania
data associate Prepojenie dvoch záznamov prostredníctvom vzťahu
data count Počet záznamov v tabuľke
data create Vytvoriť nový záznam
data delete Odstránenie záznamu
data describe Popísanie schémy entity
data disassociate Odstránenie vzťahu medzi dvomi záznamami
data get Načítanie jedného záznamu podľa ID alebo alternatívneho kľúča
data query Vykonanie dotazu OData, FetchXML alebo SQL
data update Aktualizovať existujúci záznam
data upload Nahratie súboru do stĺpca súboru v existujúcom zázname
data upsert Vytvorenie alebo aktualizácia záznamu podľa alternatívneho kľúča
erp batch cancel Zrušenie dávkovej úlohy Finance and Operations
erp batch list List Finance and Operations batch jobs (Zoznam úloh v službe Finance and Operations)
install Nainštalujte si konkrétnu verziu alebo aktualizujte na najnovšiu verziu
mcp Spustenie MCP servera pre Dataverse alebo ERP
mcp allow Povolenie aplikácie ako klienta MCP
org list Zobrazenie zoznamu všetkých prístupných prostredí
org who Zobrazenie aktuálnych informácií o organizácii a používateľovi
skill delete Odstránenie zručností z dataverse
skill download Stiahnutie zručností z Dataverse
skill list Zobrazenie zoznamu aktívnych zručností v prostredí
skill upload Nahratie zručností do služby Dataverse

Poznámka

Mnohé príkazy podporujú --target <dataverse\|erp> možnosť, ktorá smeruje operáciu k službe Dataverse (predvolené) alebo do prepojeného prostredia služby Finance and Operations (ERP). Príkazy, ktoré sa pripájajú k prostrediu --environment <url> podporujú možnosť (-env) na prepísanie URL adresy prostredia aktuálneho profilu.

api describe príkaz

Zobrazenie metaúdajov pre jedno rozhranie API. V prípade vlastných rozhraní API Dataverse je výstupom parameter požiadavky a popisy vlastností odpovede, keď im poskytujú metaúdaje.

Predvolene nie sú predpony názvov dataverse. Kvalifikované názvy ERP môžete použiť vo formulári erp:ServiceGroup/Service/Operation.

api describe Parametre

Parameter Opis
--target Riešenie nekvalifikovaného názvu vo vzťahu dataverse k alebo erp.
--service-group Len ERP. Zúžite vyhľadávanie operácie na jednu skupinu služieb.
--service Len ERP. Zúžite vyhľadávanie operácie na jednu službu.
--environment Prepíšte URL adresu prostredia Dataverse.
--json Výstup nespracovaný kód JSON.

api describe Príklady

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

api invoke príkaz

Vyvolanie zisteného rozhrania API podľa názvu. Použite name=value syntax pre parametre. Ak hodnota obsahuje medzery, zadajte úvodzovku celého tokenu. Niektoré rozhrania Dataverse API akceptujú parameter reťazca, ktorého obsahom je samotný formát JSON. V takom prípade odovzdajte text JSON ako hodnotu pomocou bežných pravidiel úvodzovky a úteku z prostredia shellu.

Predvolene sa odpovede JSON vykresľujú vo formáte popisného textu, ktorý ponechá názvy výstupných vlastností. Použite --json na zachovanie nespracovej údajovej časti JSON.

api invoke Parametre

Parameter Opis
--target Riešenie nekvalifikovaného názvu vo vzťahu dataverse k alebo erp.
--service-group Len ERP. Zúžite vyhľadávanie operácie na jednu skupinu služieb.
--service Len ERP. Zúžite vyhľadávanie operácie na jednu službu.
--param Pridanie pomenovaného parametra do name=value formulára. Opakovateľné.
--bind Cesta väzby pre rozhrania Dataverse API viazané na entitu.
--method -X Prepíšte odvodenou metódou HTTP.
--body Namiesto pomenovaných parametrov použite nespracované telo JSON.
--body-file Prečítajte si nespracované telo JSON zo súboru.
--header -H Pridajte do formulára hlavičku key:value HTTP.
--include -i Uveďte stav odpovede a hlavičky.
--environment Prepíšte URL adresu prostredia Dataverse.
--json Výstup nespracovaný kód JSON namiesto popisného textu.

api invoke Príklady

Vyvolať funkciu Dataverse. V tomto príklade je znázornené použitie funkcie Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Vyvolanie akcie Dataverse AISummarize s medzerami v hodnote parametra:

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

Vyvolanie vlastnej služby ERP:

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

api list príkaz

Zoznam zisťovateľných rozhraní API, ako sú napríklad vlastné rozhrania API dataverse a vyvolávateľné koncové body služby ERP. Výsledky zobrazujú identitu rozhrania API, popisný názov, druh a popis, ak sú k dispozícii. Ak chcete filtrovať výsledky, môžete odovzdať voliteľný výraz dotazu.

api list Parametre

Parameter Opis
--target Cieľový systém na vyhľadávanie: dataverse (predvolené) alebo erp.
--service-group Len ERP. Vykonajte filtrovanie do jednej skupiny služieb.
--service Len ERP. Vykonajte filtrovanie jednej služby.
--limit Maximálny počet rozhraní API, ktoré sa majú vrátiť. Predvolená hodnota: 50.
--page Číslo strany založené na formáte 1 pri stránkovaní výsledkov. Predvolená hodnota: 1.
--environment Prepíšte URL adresu prostredia Dataverse.
--json Výstup nespracovaný kód JSON.

api list Príklady

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 príkaz

Odoslanie nespracovanej overenej požiadavky HTTP do služby Dataverse alebo ERP. Tento príkaz použite, keď potrebujete úplnú kontrolu nad cestou, metódou, hlavičkami a telom.

api request Parametre

Parameter Opis
--target Cieľový systém: dataverse alebo erp. Povinný argument.
--path Cesta k žiadosti. Povinný argument.
--method -X Metóda HTTP. Predvolená hodnota: GET, alebo POST po zadaní tela.
--body Text vnorenej požiadavky JSON.
--body-file Súbor, ktorý obsahuje telo žiadosti o objekt JSON.
--header -H Pridajte do formulára hlavičku key:value HTTP.
--include -i Uveďte stav odpovede a hlavičky.
--environment Prepíšte URL adresu prostredia Dataverse.

api request Príklady

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 príkaz

Vytvorte si nový profil overenia.

auth create Parametre

Pomocou týchto parametrov špecifikujte správanie auth create príkazu.

Parameter Opis
--environment -env URL adresa pre prostredie Dataverse, v prípade ktoré chcete overiť.
--name -n Voliteľný názov profilu. Neskôr vyberte profil pomocou názvu.
--cloud -ci Cieľový cloud: Public, , UsGovHighUsGov, UsGovDod, alebo China.
--deviceCode -dc Postup overenia kódu zariadenia použite pre prostredia bez prehliadača.
--username -un Meno používateľa pre overenie mena používateľa a hesla.
--password -p Heslo pre meno používateľa a overenie hesla.
--applicationId -id ID aplikácie (klienta) pre overovanie objektu služby (SPN).
--clientSecret -cs Tajný kľúč klienta na overenie objektu služby.
--certificateDiskPath -cdp Cesta k súboru certifikátu .pfx na overenie na základe certifikátu.
--certificatePassword -cp Heslo certifikátu.
--tenant -t ID nájomníka. Vyžaduje sa na overenie objektom služby.
--managedIdentity -mi Použiť Azure spravovanú identitu.
--githubFederated -ghf Použite GitHub Actions federované overovanie.
--azureDevOpsFederated -adof Použite Azure DevOps federované overovanie.
--clientid -cid Vlastné ID klienta aplikácie Microsoft Entra na použitie namiesto predvolenej aplikácie Dataverse CLI.
--no-default-environment Nenastavujte prostredie ako predvolené.
--accept-cleartext-caching Povoliť vyrovnávaciu pamäť tokenu vo formáte obyčajného textu v Linuxe.

auth create Príklady

Nasledujúce príklady ukazujú, ako používať auth create príkaz.

Interaktívne overovanie

Tento príkaz otvorí prehliadač alebo dialógové okno systému, kde nájdete ďalšie informácie.

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

Pomenovaný profil

Vytvorte si profil s konkrétnym názvom.

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

Postup kódu zariadenia

Tok kódu zariadenia použite pre prostredia bez prehliadača.

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

Servisný princíp s klientským tajomstvom

Objekt služby použite vtedy, keď potrebujete automatické overovanie, napríklad v kanáli CI/CD alebo inom automatizovanom skripte, kde interaktívne prihlásenie nie je možné. Zadajte ID aplikácie, tajný kľúč klienta a ID nájomníka registrácie aplikácie, ktorá má prístup k prostrediu.

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

ID klienta vlastnej aplikácie Entra

Namiesto predvoleného použite vlastnú registráciu aplikácie.

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

auth list príkaz

Uviesť zoznam všetkých profilov overovania. Pridajte --json nespracovaný výstup JSON.

auth list Príklady

dataverse auth list
dataverse auth list --json

auth remove príkaz

Odstráňte aspoň jeden profil overenia.

auth remove Parametre

Parameter Opis
--index -i Odstráňte profil so zadaným indexom založeným na hodnote 1, ako je to znázornené v auth list.
--name -n Odstráňte profil so zadaným názvom.
--all Odstráňte všetky profily.

auth remove Príklady

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

auth select príkaz

Vyberte profil aktívneho overovania. Spustite príkaz bez možností na zobrazenie zoznamu všetkých profilov.

auth select Parametre

Parameter Opis
--index -i Vyberte profil podľa indexu založeného na 1, ako je to znázornené v auth list.
--name -n Vyberte profil podľa názvu.

auth select Príklady

Otvorte interaktívny výber. Pomocou klávesov so šípkami alebo zadaním vykonajte filtrovanie:

dataverse auth select

Vyberte profil podľa indexu alebo podľa názvu:

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

auth who príkaz

Zobraziť aktuálny a aktívny profil overovania. Pridajte --json nespracovaný výstup JSON.

auth who Príklady

dataverse auth who
dataverse auth who --json

data associate príkaz

Priradenie dvoch záznamov prostredníctvom vlastnosti navigácie (vzťahu). Tento príkaz je podporovaný len pre Funkciu Dataverse.

data associate Parametre

Parameter Opis
--table -t Názov množiny entít primárneho záznamu. Povinný argument.
--id -i Identifikátor GUID primárneho záznamu. Povinný argument.
--relationship -rel Názov vlastnosti navigácie. Povinný argument.
--related Názov množiny entít súvisiacej tabuľky. Povinný argument.
--related-id Identifikátor GUID súvisiaceho záznamu. Povinný argument.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data associate Príklady

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

data count príkaz

Spočítať záznamy v tabuľke, voliteľne filtrované.

data count Parametre

Parameter Opis
--table -t Názov množiny entít. Vyžaduje sa, pokiaľ nepoužívate .--fetchxml
--filter -f Výraz OData $filter .
--fetchxml Agregovaný dotaz FetchXML pre zložité počty.
--target Smerovať do dataverse (predvolené) alebo prepojené erp prostredie.
--cross-company Len ERP. Count across all companies. Predvolená hodnota: predvolená spoločnosť používateľa.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data count Príklady

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

data create príkaz

Vytvorenie nového záznamu v tabuľke Dataverse. Nastavte vyhľadávacie stĺpce pomocou @odata.bind syntaxe.

data create Parametre

Parameter Opis
--table -t Názov množiny entít. Povinný argument.
--data -d Objekt JSON s hodnotami polí.
--data-file Cesta k súboru JSON s údajmi záznamu.
--return -r Vráťte celý vytvorený záznam.
--target Smerovať do dataverse (predvolené) alebo prepojené erp prostredie.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data create Príklady

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

Tip

Použite --data-file pre komplexné JSON. Ak chcete získať úplný vytvorený záznam, použite možnosť --return --json .

data delete príkaz

Odstráňte jeden záznam jeho primárnym kľúčom alebo alternatívnym kľúčom.

data delete Parametre

Parameter Opis
--table -t Názov množiny entít. Povinný argument.
--id -i Identifikátor GUID záznamu.
--key -k Alternatívny kľúč.
--no-confirm Vynechajte výzvu na potvrdenie.
--target Smerovať do dataverse (predvolené) alebo prepojené erp prostredie.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data delete Príklady

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

data describe príkaz

Popíšte schému entity OData. V prípade funkcie Dataverse sa príkaz zavolá EntityDefinitions(LogicalName='<table>') pomocou $expand funkcie riadenej , --includeplus druhé volanie na customapis hodnotu , kedy --include actions je nastavená. Vstavané akcie Dataverse, ako Assign sú napríklad a SetState nie sú vyčíslené. Pre server ERP jedno volanie, ktoré /Metadata/PublicEntities vráti vlastnosti, viazané akcie a navigácie spolu.

data describe Parametre

Parameter Opis
--target Cieľ: dataverse (predvolené) alebo erp.
--table -t Povinný argument. V prípade parametra Dataverse je to logický názov, napríklad account. Pri ERP názov množiny entít, napríklad BatchJobs.
--include Zoznam sekcií oddelených čiarkou, ktorý obsahuje položky: entity, properties, relations, actions, alebo all. Aliasy: attributes=properties, relationships=relations. Predvolená hodnota pre ERP: all. Predvolená hodnota pre Dataverse: entity,properties.
--json Výstup nespracovaný kód JSON.

data describe Príklady

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

data disassociate príkaz

Odstráňte vzťah medzi dvomi záznamami. Tento príkaz je podporovaný len pre Funkciu Dataverse.

data disassociate parametre

Parameter Opis
--table -t Názov množiny entít primárneho záznamu. Povinný argument.
--id -i Identifikátor GUID primárneho záznamu. Povinný argument.
--relationship -rel Názov vlastnosti navigácie. Povinný argument.
--related-id Identifikátor GUID súvisiaceho záznamu pre vzťah typu many-to-many. Ak chcete vymazať vyhľadávanie, vynecháme tento parameter.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data disassociate Príklady

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

data get príkaz

Načítajte jeden záznam pomocou jeho ID (primárny kľúč) alebo alternatívnym kľúčom.

data get Parametre

Parameter Opis
--table -t Názov množiny entít. Povinný argument.
--id -i Identifikátor GUID záznamu (primárny kľúč).
--key -k Alternatívny kľúč, napríklad "col='val'".
--select -s Zoznam stĺpcov oddelených čiarkou ($select).
--expand -x Výraz OData $expand pre súvisiace záznamy.
--target Smerovať do dataverse (predvolené) alebo na prepojené erp prostredie.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data get Príklady

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 príkaz

Spustite dotaz OData, FetchXML alebo SQL na tabuľke Dataverse.

data query Parametre

Parameter Opis
--table -t Nastavte názov entity na dotaz. Vyžaduje sa pre dotazy OData.
--select -s Zoznam stĺpcov oddelených čiarkou ($select).
--filter -f Výraz OData $filter .
--orderby -o Výraz OData $orderby .
--top Maximálny počet záznamov, ktoré sa majú vrátiť (1 – 5 000).
--expand -x Výraz OData $expand pre súvisiace záznamy.
--fetchxml Vnorný dotaz FetchXML.
--fetchxml-file Cesta k súboru, ktorý obsahuje dotaz jazyka FetchXML.
--sql Dotaz SQL SELECT (Preview).
--sql-file Cesta k súboru, ktorý obsahuje dotaz SQL.
--all -a Ak chcete načítať všetky záznamy, postupujte podľa stránkovania.
--max-records Maximálny počet záznamov, ktoré sa majú načítať pri použití funkcie --all. Predvolená hodnota: 100000.
--target Smerovať do dataverse (predvolené) alebo prepojené erp prostredie.
--cross-company Len ERP. Dotazovanie vo všetkých spoločnostiach. Predvolená hodnota: predvolená spoločnosť používateľa.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data query Príklady

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

Zistite viac

data update príkaz

V existujúcom zázname aktualizujte jedno alebo viacero polí, identifikovaných jeho ID alebo alternatívnym kľúčom. Nastavte vyhľadávacie stĺpce pomocou @odata.bind syntaxe.

data update Parametre

Parameter Opis
--table -t Názov množiny entít. Povinný argument.
--id -i Identifikátor GUID záznamu.
--key -k Alternatívny kľúč.
--data -d Objekt JSON s poľami, ktoré sa majú aktualizovať.
--data-file Cesta k súboru JSON s aktualizáciou údajov.
--return -r Vráťte úplný aktualizovaný záznam.
--target Smerovať do dataverse (predvolené) alebo prepojené erp prostredie.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data update Príklady

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

data upload príkaz

Nahrajte lokálny súbor do stĺpca súboru Dataverse v existujúcom zázname. Príkaz automaticky vyberie na základe veľkosti súboru jednu požiadavku alebo blokovaný súbor, pokiaľ nešpecifikujete --mode. V automatickom režime sa súbory s veľkosťou do 128 MB nahrávajú v jednej požiadavke a väčšie súbory používajú nahrávanie s rozdeľovaným súborom. Keď vynecháte --mime-typepríkaz odvodí typ MIME z prípony súboru. Neznáme rozšírenia predvolene na application/octet-stream.

data upload Parametre

Parameter Opis
--table -t Schéma tabuľky alebo logický názov, ako accountnapríklad . Povinný argument. Príkaz vyrieši množinu entít z metaúdajov.
--id -i Identifikátor GUID záznamu. Povinný argument.
--column -c Názov atribútu stĺpca súboru. Povinný argument.
--file -f Cesta k lokálnemu súboru. Povinný argument.
--mode -m Stratégia nahrávania: auto (predvolené), smallalebo chunk.
--mime-type Explicitný typ MIME. Predvolená hodnota: odvodená od prípony súboru.
--overwrite Prepíšte existujúci súbor. V predvolenom nastavení zlyhá príkaz, ak stĺpec nie je prázdny.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data upload Príklady

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 príkaz

Ak záznam neexistuje, vytvorte ho, alebo ho v jeho prípade aktualizujte. Záznam sa identifikuje alternatívnym kľúčom. Naučte sa používať alternatívny kľúč na odkazovanie na záznam

data upsert parametre

Parameter Opis
--table -t Názov množiny entít. Povinný argument.
--key -k Alternatívny kľúč. Povinný argument.
--data -d Objekt JSON s hodnotami polí.
--data-file Cesta k súboru JSON.
--update-only Zlyhanie v prípade, že záznam neexistuje (If-Match: *).
--create-only Zlyhanie, ak už záznam existuje (If-None-Match: *).
--return -r Po operácii vráťte celý záznam.
--target Smerovať do dataverse (predvolené) alebo prepojené erp prostredie.
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

data upsert Príklady

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

erp batch cancel príkaz

Zrušiť dávkovú úlohu Finance and Operations jej RecId. Použite erp batch list na vyhľadanie danej možnosti RecId.

erp batch cancel Príklady

dataverse erp batch cancel <recid>

erp batch list príkaz

Zadajte zoznam dávkových úloh v inštancii finance and operations, ktorá je prepojená s vaším prostredím Dataverse. Príkaz vyžaduje profil overenia pripojený k prostrediu Dataverse, ktoré má prepojenú inštanciu služieb Finance and Operations. URL adresa služby Finance and Operations sa automaticky odvodzuje od aktuálneho pripojenia Dataverse.

erp batch list Parametre

Parameter Opis
--company Filtrovanie podľa právnickej osoby (dataAreaId), ako USMFnapríklad .
--status Filtrovať podľa stavu: Waiting, Executing, Finished, Error, alebo Cancelled.
--top Maximálny počet výsledkov, ktoré sa majú vrátiť. Predvolená hodnota: 20.
--caption Filtrovať podľa titulkov (zhoda podreťazcov bez rozlišovania veľkých a malých písmen).
--json Výstup nespracovaný kód JSON.

erp batch list Príklady

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

install príkaz

Nainštalujte si konkrétnu verziu rozhrania Dataverse CLI alebo aktualizujte na najnovšiu verziu. Príkaz rozpozná, či ste nainštalovali cli globálne, alebo ho podľa toho používate npx a inštalujete.

install Príklady

Nainštalujte najnovšiu verziu:

dataverse install latest

Inštalácia konkrétnej verzie:

dataverse install 1.0.0

mcp príkaz

Spustenie servera modelového kontextového protokolu (MCP), ktorý sa pripojí k vášmu prostrediu, aby asistenti umelej inteligencie, ako napríklad Claude Desktop, mohli pracovať s vašimi údajmi. Cieľ sa automaticky zistí z URL adresy: URL adresa Dataverse spustí server MCP Dataverse a URL adresa služby Finance and Operations, ako https://myorg.operations.dynamics.comnapríklad , spustí server ERP MCP.

syntax mcp

dataverse mcp <orgUrl> [options]

Argument <orgUrl> je URL adresou vašej organizácie, napríklad https://myorg.crm.dynamics.com.

mcp Parametre

Parameter Opis
--validate Overte koncové body MCP a nastavenie overenia bez spustenia servera.
--log-level Nastavte úroveň zapisovania do denníka: Trace, Debug, Information, Warning, Erroralebo Critical. Predvolená hodnota: Warning.
--log-file Prihláste sa do súboru v dočasnom adresári.
--preview Namiesto funkcie použite ukážku koncového bodu MCP vo verzii api/mcpPreview .api/mcp_preview Pre ERP nie je podporovaná.

mcp Príklady

Overenie nastavenia (odporúčaný prvý krok):

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

Spustite server pomocou stdio transportu:

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

Použite koncový bod ukážky alebo povoľte zapisovanie súborov do denníka:

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

mcp allow príkaz

Skontrolujte, či sa aplikácia Microsoft Entra nachádza v zozname povolených klientov Dataverse MCP pre aktuálne prostredie profilu. Tento príkaz je alternatívou k manuálnemu kroku správcu popísanému v danej požiadavky. Overený používateľ musí mať v cieľovom prostredí povolenia správcu Dataverse.

syntax mcp allow

dataverse mcp allow <appId> [options]

Argument <appId> je ID aplikácie (klienta), ktoré ako identifikátor GUID povolíte.

mcp allow Parametre

Parameter Opis
--erp Povoľte aplikácii prepojenú inštanciu Finance and Operations namiesto dataverse.

mcp allow Príklady

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

Poznámka

Služby Finance a Operations sú uložené vo vyrovnávacej pamäti zoznamu povolených položiek v systéme AOS, takže novoprijaté ID aplikácie môže trvať približne päť minút, kým sa prejaví.

org list príkaz

Zobrazte zoznam všetkých prostredí, ku ktorým máte prístup.

org list parametre

Parameter Opis
--filter Zoznam prostredí môžete filtrovať podľa hľadaného výrazu.
--json Výstup nespracovaný kód JSON.

org list Príklady

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

org who príkaz

Zobraziť informácie o aktuálnej organizácii a používateľovi pomocou aktívneho profilu overovania. Príkaz env je alias pre org.

org who parametre

Parameter Opis
--environment -env Prepíšte URL adresu prostredia.
--json Výstup nespracovaný kód JSON.

org who Príklady

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

príkazy skill

Spravovať zručnosti služby Dataverse – opakovane použiteľné množiny inštrukcií ( SKILL.md súbor a súbory prostriedkov), ktoré používajú agenti umelej inteligencie – uložené v pripojenom prostredí. Príkazy najvyššej úrovne skill poskytujú operácie vytvárania, čítania, aktualizovania a odstraňovania v prostredí. Zručnosti sú uložené lokálne v časti .claude/skills/<name>/.

Poznámka

Príkazy na vytváranie a vyhodnocovanie zručností, ako makenapríklad , update, geta eval, sú oddelené od týchto príkazov. Ďalšie informácie získate po spustení .dataverse workspace skill --help

skill delete príkaz

Odstráňte zručnosti a všetky jej zdroje z aktívneho prostredia Dataverse. Použite skill list na vyhľadanie jedinečných názvov zručností.

dataverse skill delete new_lead-qualification

skill download príkaz

Stiahnite si jednu alebo viac zručností z aktívneho prostredia Dataverse na disk. Príkaz stiahne SKILL.md súbor a všetky súbory prostriedkov, pričom zachová štruktúru adresára. Použite skill list na vyhľadanie jedinečných názvov zručností.

Parameter Opis
--all Stiahnite si všetky aktívne zručnosti z prostredia. Nie je možné kombinovať s jedinečným názvom zručností.
--output -o Základný adresár na výstup. Predvolená hodnota: .claude/skills/. S --all, je každá zručnosť napísaná na <path>/<name>/.
--json Výstup obsah zručností ako JSON bez písania súborov. Môžete tiež zadať cestu k súboru, do ktorom chcete zapisovať. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list príkaz

Zoznam všetkých aktívnych zručností v pripojenom prostredí Dataverse.

Parameter Opis
--resources -r Zadajte aj zoznam súborov prostriedkov pre jednotlivé zručnosti.
--json Výstup vo formáte JSON. Môžete tiež zadať cestu k súboru, do ktorom chcete zapisovať. 
dataverse skill list
dataverse skill list --resources

skill upload príkaz

Nahrajte jednu alebo viac zručností z disku do aktívneho prostredia Dataverse. Príkaz podporuje adresáre, .zip súbory, súbory .skill a súbory .md .

Môžete odovzdať odbornosť <name>, ktorá sa vyrieši ako .claude/skills/<name>/, alebo explicitne <path> do adresára či súboru.

Parameter Opis
--all Nahrajte všetky zručnosti v časti .claude/skills/. Nie je možné kombinovať s názvom alebo cestou zručností.
--json Výstupom je výsledok JSON. Môžete tiež zadať cestu k súboru, do ktorom chcete zapisovať. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Pozrite tiež

Práca s údajmi pomocou rozhrania Dataverse CLI

  • Last updated on