Dokumentacja interfejsu wiersza polecenia usługi Dataverse (wersja zapoznawcza)

Note

  • To jest funkcja w wersji zapoznawczej.
  • Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.

W tym artykule opisano polecenia dostępne w interfejsie wiersza polecenia usługi Dataverse. Każde polecenie obsługuje --help opcję, która wyświetla listę użycia, opcji i przykładów. Polecenia zwracające dane obsługują --json opcję nieprzetworzonych danych wyjściowych JSON, które są przydatne w skryptach.

Następujące opcje globalne mogą być używane z dowolnym poleceniem:

Option Opis
--log-level <level> Ustaw poziom rejestrowania: Trace, , DebugInformation, Warning, Errorlub Critical. Wartość domyślna: Warning.
--log-file Zaloguj się do pliku w katalogu tymczasowym zamiast konsoli programu .
--context <value> Kontekst operacji dołączony do agenta użytkownika. Można również ustawić zmienną DATAVERSE_OPERATION_CONTEXT środowiskową.
Command Opis
api describe Opisywanie interfejsu API
api invoke Wywoływanie interfejsu API według nazwy
api list Wyświetlanie listy możliwych do odnalezienia interfejsów API
api request Wysyłanie uwierzytelnionego żądania HTTP
auth create Tworzenie nowego profilu uwierzytelniania
auth list Wyświetlanie listy wszystkich profilów uwierzytelniania
auth remove Usuwanie profilu uwierzytelniania
auth select Wybierz aktywny profil uwierzytelniania
auth who Pokaż bieżący profil uwierzytelniania
data associate Łączenie dwóch rekordów za pośrednictwem relacji
data count Zlicz rekordy w tabeli
data create Utwórz nowy rekord
data delete Usuwanie rekordu
data describe Opisywanie schematu jednostki
data disassociate Usuwanie relacji między dwoma rekordami
data get Pobieranie pojedynczego rekordu według identyfikatora lub klucza alternatywnego
data query Wykonywanie zapytania OData, FetchXML lub SQL
data update Aktualizuj istniejący rekord
data upload Przekazywanie pliku do kolumny pliku w istniejącym rekordzie
data upsert Tworzenie lub aktualizowanie rekordu według klucza alternatywnego
erp batch cancel Anulowanie zadania wsadowego Finance and Operations
erp batch list Wyświetlanie listy zadań wsadowych Finance and Operations
install Instalowanie określonej wersji lub aktualizowanie do najnowszej wersji
mcp Uruchamianie serwera MCP dla usługi Dataverse lub ERP
mcp allow Zezwalanie aplikacji na klienta MCP
org list Wyświetlanie listy wszystkich dostępnych środowisk
org who Pokaż bieżącą organizację i informacje o użytkowniku
skill delete Usuwanie umiejętności z usługi Dataverse
skill download Pobieranie umiejętności z usługi Dataverse
skill list Wyświetlanie listy aktywnych umiejętności w środowisku
skill upload Przekazywanie umiejętności do usługi Dataverse

Note

Wiele poleceń obsługuje opcję, która kieruje operację --target <dataverse\|erp> do usługi Dataverse (ustawienie domyślne) lub do połączonego środowiska Finance and Operations (ERP). Polecenia łączące się ze środowiskiem obsługują --environment <url> opcję (-env), aby zastąpić adres URL środowiska bieżącego profilu.

api describe polecenie

Pokaż metadane dla pojedynczego interfejsu API. W przypadku niestandardowych interfejsów API usługi Dataverse dane wyjściowe zawierają opisy właściwości parametru żądania i odpowiedzi, gdy zawierają je metadane.

Nazwy usługi Dataverse są domyślnie nieprefiksowane. Nazwy kwalifikowane ERP można używać w postaci erp:ServiceGroup/Service/Operation.

api describe Parametry

Parameter Opis
--target Rozpoznawanie niekwalifikowanej nazwy względem dataverse elementu lub erp.
--service-group Tylko ERP. Zawęź wyszukiwanie operacji do jednej grupy usług.
--service Tylko ERP. Zawęź wyszukiwanie operacji do jednej usługi.
--environment Zastąpij adres URL środowiska Dataverse.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady api describe

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

api invoke polecenie

Wywołaj odnaleziony interfejs API według nazwy. Użyj name=value składni dla parametrów. Jeśli wartość zawiera spacje, podaj cały token. Niektóre interfejsy API usługi Dataverse akceptują parametr ciągu, którego zawartość jest sama w formacie JSON. W takim przypadku przekaż tekst JSON jako wartość przy użyciu normalnych reguł cudzysłowu i ucieczki powłoki.

Domyślnie odpowiedzi JSON są renderowane w przyjaznym formacie tekstowym, który przechowuje nazwy właściwości wyjściowych. Użyj polecenia --json , aby zachować nieprzetworzone ładunek JSON.

api invoke Parametry

Parameter Opis
--target Rozpoznawanie niekwalifikowanej nazwy względem dataverse elementu lub erp.
--service-group Tylko ERP. Zawęź wyszukiwanie operacji do jednej grupy usług.
--service Tylko ERP. Zawęź wyszukiwanie operacji do jednej usługi.
--param Dodaj nazwany parametr w name=value formularzu. Powtarzalne.
--bind Ścieżka powiązania dla interfejsów API usługi Dataverse powiązanych z jednostkami.
--method, -X Zastąp wnioskowaną metodę HTTP.
--body Użyj nieprzetworzonej treści JSON zamiast nazwanych parametrów.
--body-file Odczytywanie nieprzetworzonej treści JSON z pliku.
--header, -H Dodaj nagłówek HTTP w key:value formularzu.
--include, -i Uwzględnij stan odpowiedzi i nagłówki.
--environment Zastąpij adres URL środowiska Dataverse.
--json Wyprowadź nieprzetworzone dane JSON zamiast przyjaznego tekstu.

przykłady api invoke

Wywołaj funkcję Dataverse. W tym przykładzie pokazano użycie funkcji Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Wywołaj akcję Dataverse AISummarize z spacjami w wartości parametru:

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

Wywołaj usługę niestandardową ERP:

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

api list polecenie

Wyświetlanie listy możliwych do odnalezienia interfejsów API, takich jak niestandardowe interfejsy API usługi Dataverse i punkty końcowe usługi, które można wywołać ERP. Wyniki pokazują tożsamość interfejsu API, przyjazną nazwę, rodzaj i opis, jeśli są dostępne. Możesz przekazać opcjonalny termin zapytania, aby filtrować wyniki.

api list Parametry

Parameter Opis
--target System docelowy do wyszukiwania: dataverse (wartość domyślna) lub erp.
--service-group Tylko ERP. Filtruj do pojedynczej grupy usług.
--service Tylko ERP. Filtruj do jednej usługi.
--limit Maksymalna liczba interfejsów API do zwrócenia. Wartość domyślna: 50.
--page Numer strony oparty na 1 podczas stronicowania wyników. Wartość domyślna: 1.
--environment Zastąpij adres URL środowiska Dataverse.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady api list

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 polecenie

Wyślij nieprzetworzone uwierzytelnione żądanie HTTP do usługi Dataverse lub ERP. Użyj tego polecenia, jeśli potrzebujesz pełnej kontroli nad ścieżką, metodą, nagłówkami i treścią.

api request Parametry

Parameter Opis
--target System docelowy: dataverse lub erp. Required.
--path Ścieżka żądania. Required.
--method, -X Metoda HTTP. Wartość domyślna: GET, lub POST po podaniu treści.
--body Treść żądania JSON w tekście.
--body-file Plik zawierający treść żądania obiektu JSON.
--header, -H Dodaj nagłówek HTTP w key:value formularzu.
--include, -i Uwzględnij stan odpowiedzi i nagłówki.
--environment Zastąpij adres URL środowiska Dataverse.

przykłady api request

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 polecenie

Utwórz nowy profil uwierzytelniania.

auth create Parametry

Użyj tych parametrów, aby określić zachowanie auth create polecenia.

Parameter Opis
--environment, -env Adres URL środowiska Dataverse, za pomocą którego chcesz się uwierzytelnić.
--name, -n Opcjonalna nazwa profilu. Użyj nazwy, aby później wybrać profil.
--cloud, -ci Chmura docelowa: Public, , UsGovUsGovHigh, UsGovDodlub China.
--deviceCode, -dc Użyj przepływu uwierzytelniania kodu urządzenia dla środowisk bez przeglądarki.
--username, -un Nazwa użytkownika na potrzeby uwierzytelniania nazwy użytkownika i hasła.
--password, -p Hasło do uwierzytelniania nazwy użytkownika i hasła.
--applicationId, -id Identyfikator aplikacji (klienta) na potrzeby uwierzytelniania jednostki usługi (SPN).
--clientSecret, -cs Wpis tajny klienta na potrzeby uwierzytelniania jednostki usługi.
--certificateDiskPath, -cdp Ścieżka do pliku certyfikatu pfx na potrzeby uwierzytelniania opartego na certyfikatach.
--certificatePassword, -cp Hasło certyfikatu.
--tenant, -t Identyfikator dzierżawy. Wymagane do uwierzytelniania jednostki usługi.
--managedIdentity, -mi Użyj tożsamości zarządzanej Azure.
--githubFederated, -ghf Użyj GitHub Actions uwierzytelniania federacyjnego.
--azureDevOpsFederated, -adof Użyj Azure DevOps uwierzytelniania federacyjnego.
--clientid, -cid Niestandardowy identyfikator klienta aplikacji Microsoft Entra do użycia zamiast domyślnej aplikacji interfejsu wiersza polecenia usługi Dataverse.
--no-default-environment Nie ustawiaj środowiska jako domyślnego.
--accept-cleartext-caching Zezwalaj na pamięć podręczną tokenu w postaci zwykłego tekstu w systemie Linux.

przykłady auth create

W poniższych przykładach pokazano, jak używać auth create polecenia .

Uwierzytelnianie interakcyjne

To polecenie otwiera okno dialogowe przeglądarki lub systemu, aby uzyskać dodatkowe informacje.

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

Nazwany profil

Utwórz profil o określonej nazwie.

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

Przepływ kodu urządzenia

Użyj przepływu kodu urządzenia dla środowisk bez przeglądarki.

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

Podmiot usługi z kluczem tajnym klienta

Użyj jednostki usługi, jeśli potrzebujesz uwierzytelniania nienadzorowanego, takiego jak w potoku ciągłej integracji/ciągłego wdrażania lub innego zautomatyzowanego skryptu, w którym logowanie interakcyjne nie jest możliwe. Podaj identyfikator aplikacji, klucz tajny klienta i identyfikator dzierżawy rejestracji aplikacji, która ma dostęp do środowiska.

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

Identyfikator klienta niestandardowej aplikacji Entra

Użyj własnej rejestracji aplikacji zamiast domyślnej.

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

auth list polecenie

Wyświetl listę wszystkich profilów uwierzytelniania. Dodaj --json dla nieprzetworzonych danych wyjściowych JSON.

przykłady auth list

dataverse auth list
dataverse auth list --json

auth remove polecenie

Usuń jeden lub wszystkie profile uwierzytelniania.

auth remove Parametry

Parameter Opis
--index, -i Usuń profil z określonym indeksem opartym na 1, jak pokazano w pliku auth list.
--name, -n Usuń profil z określoną nazwą.
--all Usuń wszystkie profile.

przykłady auth remove

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

auth select polecenie

Wybierz aktywny profil uwierzytelniania. Uruchom polecenie bez opcji, aby wyświetlić listę wszystkich profilów.

auth select Parametry

Parameter Opis
--index, -i Wybierz profil według jego 1-opartego na indeksie, jak pokazano w pliku auth list.
--name, -n Wybierz profil według nazwy.

przykłady auth select

Otwórz interaktywny selektor. Użyj klawiszy strzałek lub wpisz, aby filtrować:

dataverse auth select

Wybierz profil według indeksu lub według nazwy:

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

auth who polecenie

Pokaż bieżący, aktywny profil uwierzytelniania. Dodaj --json dla nieprzetworzonych danych wyjściowych JSON.

przykłady auth who

dataverse auth who
dataverse auth who --json

data associate polecenie

Skojarz dwa rekordy za pomocą właściwości nawigacji (relacji). To polecenie jest obsługiwane tylko w przypadku usługi Dataverse.

data associate Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek rekordu podstawowego. Required.
--id, -i Identyfikator GUID rekordu podstawowego. Required.
--relationship, -rel Nazwa właściwości nawigacji. Required.
--related Nazwa zestawu jednostek powiązanej tabeli. Required.
--related-id Identyfikator GUID powiązanego rekordu. Required.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data associate

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

data count polecenie

Zlicz rekordy w tabeli, opcjonalnie filtrowane.

data count Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek. Wymagane, chyba że używasz polecenia --fetchxml.
--filter, -f Wyrażenie OData $filter .
--fetchxml Zapytanie agregacji FetchXML dla złożonych liczb.
--target Kierowanie do dataverse (domyślne) lub połączonego erp środowiska.
--cross-company Tylko ERP. Liczenie we wszystkich firmach. Ustawienie domyślne: domyślna firma użytkownika.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data count

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

data create polecenie

Utwórz nowy rekord w tabeli Dataverse. Ustaw kolumny odnośników przy użyciu @odata.bind składni.

data create Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek. Required.
--data, -d Obiekt JSON z wartościami pól.
--data-file Ścieżka do pliku JSON z danymi rekordu.
--return, -r Zwróć pełny utworzony rekord.
--target Kierowanie do dataverse (domyślne) lub połączonego erp środowiska.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data create

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

Wskazówka

Służy --data-file do tworzenia złożonych danych JSON. Użyj --return --json polecenia , aby uzyskać pełny utworzony rekord.

data delete polecenie

Usuń pojedynczy rekord przy użyciu klucza podstawowego lub alternatywnego klucza.

data delete Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek. Required.
--id, -i Identyfikator GUID rekordu.
--key, -k Alternatywny klucz.
--no-confirm Pomiń monit o potwierdzenie.
--target Kierowanie do dataverse (domyślne) lub połączonego erp środowiska.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data delete

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

data describe polecenie

Opis schematu jednostki OData. W przypadku usługi Dataverse polecenie wywołuje polecenie EntityDefinitions(LogicalName='<table>') sterowane $expand przez --includeelement , a także drugie wywołanie metody , gdy --include actionscustomapis jest ustawione. Wbudowane akcje usługi Dataverse, takie jak Assign i SetState nie są wyliczane. W przypadku systemu ERP pojedyncze wywołanie /Metadata/PublicEntities zwracające właściwości, powiązane akcje i nawigacje razem.

data describe Parametry

Parameter Opis
--target Element docelowy: dataverse (wartość domyślna) lub erp.
--table, -t Required. W przypadku usługi Dataverse nazwa logiczna, taka jak account. W przypadku systemu ERP nazwa zestawu jednostek, taka jak BatchJobs.
--include Rozdzielona przecinkami lista sekcji do uwzględnienia: entity, , propertiesrelations, actionslub all. Aliasy: attributes=properties, relationships=relations. Ustawienie domyślne dla erp: all. Wartość domyślna dla usługi Dataverse: entity,properties.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data describe

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

data disassociate polecenie

Usuń relację między dwoma rekordami. To polecenie jest obsługiwane tylko w przypadku usługi Dataverse.

data disassociate Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek rekordu podstawowego. Required.
--id, -i Identyfikator GUID rekordu podstawowego. Required.
--relationship, -rel Nazwa właściwości nawigacji. Required.
--related-id Identyfikator GUID powiązanego rekordu dla relacji wiele do wielu. Pomiń ten parametr, aby wyczyścić wyszukiwanie.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data disassociate

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

data get polecenie

Pobierz pojedynczy rekord według jego identyfikatora (klucza podstawowego) lub klucza alternatywnego.

data get Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek. Required.
--id, -i Identyfikator GUID rekordu (klucz podstawowy).
--key, -k Alternatywny klucz, na przykład "col='val'".
--select, -s Rozdzielona przecinkami lista kolumn ($select).
--expand, -x Wyrażenie OData $expand dla powiązanych rekordów.
--target Kierowanie do dataverse (domyślne) lub połączonego erp środowiska.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data get

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 polecenie

Wykonaj zapytanie OData, FetchXML lub SQL względem tabeli Dataverse.

data query Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek do kwerendy. Wymagane dla zapytań OData.
--select, -s Rozdzielona przecinkami lista kolumn ($select).
--filter, -f Wyrażenie OData $filter .
--orderby, -o Wyrażenie OData $orderby .
--top Maksymalna liczba rekordów do zwrócenia (1–5000).
--expand, -x Wyrażenie OData $expand dla powiązanych rekordów.
--fetchxml Wbudowane zapytanie FetchXML.
--fetchxml-file Ścieżka do pliku zawierającego zapytanie FetchXML.
--sql Zapytanie SQL SELECT (wersja zapoznawcza).
--sql-file Ścieżka do pliku zawierającego zapytanie SQL.
--all, -a Postępuj zgodnie z podziałem na strony, aby pobrać wszystkie rekordy.
--max-records Maksymalna liczba rekordów do pobrania podczas korzystania z programu --all. Wartość domyślna: 100000.
--target Kierowanie do dataverse (domyślne) lub połączonego erp środowiska.
--cross-company Tylko ERP. Wykonywanie zapytań we wszystkich firmach. Ustawienie domyślne: domyślna firma użytkownika.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data query

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

Learn more

data update polecenie

Zaktualizuj co najmniej jedno pole istniejącego rekordu, zidentyfikowane przez jego identyfikator lub klucz alternatywny. Ustaw kolumny odnośników przy użyciu @odata.bind składni.

data update Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek. Required.
--id, -i Identyfikator GUID rekordu.
--key, -k Alternatywny klucz.
--data, -d Obiekt JSON z polami do aktualizacji.
--data-file Ścieżka do pliku JSON z danymi aktualizacji.
--return, -r Zwróć pełny zaktualizowany rekord.
--target Kierowanie do dataverse (domyślne) lub połączonego erp środowiska.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data update

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

data upload polecenie

Przekaż plik lokalny do kolumny pliku Dataverse na istniejącym rekordzie. Polecenie automatycznie wybiera jedno żądanie lub fragmentowane przekazywanie na podstawie rozmiaru pliku, chyba że określono wartość --mode. W trybie automatycznym pliki poniżej 128 MB są przekazywane w jednym żądaniu, a większe pliki używają fragmentowanego przekazywania. W przypadku pominięcia --mime-typepolecenia polecenie wywnioskuje typ MIME z rozszerzenia pliku. Wartością domyślną nieznanych rozszerzeń jest application/octet-stream.

data upload Parametry

Parameter Opis
--table, -t Schemat tabeli lub nazwa logiczna, na przykład account. Required. Polecenie rozpoznaje zestaw jednostek z metadanych.
--id, -i Identyfikator GUID rekordu. Required.
--column, -c Nazwa atrybutu kolumny pliku. Required.
--file, -f Ścieżka do pliku lokalnego. Required.
--mode, -m Strategia przekazywania: auto (wartość domyślna), smalllub chunk.
--mime-type Jawny typ MIME. Ustawienie domyślne: wnioskowane z rozszerzenia pliku.
--overwrite Zastąp istniejący plik. Domyślnie polecenie kończy się niepowodzeniem, jeśli kolumna nie jest pusta.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data upload

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 polecenie

Utwórz rekord, jeśli nie istnieje, lub zaktualizuj go, jeśli tak. Rekord jest identyfikowany przez klucz alternatywny. Dowiedz się, jak używać klucza alternatywnego do odwołowania się do rekordu

data upsert Parametry

Parameter Opis
--table, -t Nazwa zestawu jednostek. Required.
--key, -k Alternatywny klucz. Required.
--data, -d Obiekt JSON z wartościami pól.
--data-file Ścieżka do pliku JSON.
--update-only Niepowodzenie, jeśli rekord nie istnieje (If-Match: *).
--create-only Niepowodzenie, jeśli rekord już istnieje (If-None-Match: *).
--return, -r Zwróć pełny rekord po operacji.
--target Kierowanie do dataverse (domyślne) lub połączonego erp środowiska.
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady data upsert

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

erp batch cancel polecenie

Anuluj zadanie wsadowe Finance and Operations według jego RecId. Użyj polecenia erp batch list , aby znaleźć element RecId.

przykłady erp batch cancel

dataverse erp batch cancel <recid>

erp batch list polecenie

Wyświetl listę zadań wsadowych w wystąpieniu Finance and Operations połączonym ze środowiskiem Usługi Dataverse. Polecenie wymaga profilu uwierzytelniania połączonego ze środowiskiem Usługi Dataverse, które ma połączone wystąpienie usługi Finance and Operations. Adres URL usługi Finance and Operations jest uzyskiwany automatycznie z bieżącego połączenia usługi Dataverse.

erp batch list Parametry

Parameter Opis
--company Filtruj według jednostek prawnych (dataAreaId), takich jak USMF.
--status Filtruj według stanu: Waiting, , ExecutingFinished, Errorlub Cancelled.
--top Maksymalna liczba wyników do zwrócenia. Wartość domyślna: 20.
--caption Filtruj według podpisów (dopasowanie podciągów bez uwzględniania wielkości liter).
--json Wyjściowy nieprzetworzone dane JSON.

przykłady erp batch list

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

install polecenie

Zainstaluj określoną wersję interfejsu wiersza polecenia usługi Dataverse lub zaktualizuj ją do najnowszej wersji. Polecenie wykrywa, czy interfejs wiersza polecenia został zainstalowany globalnie, czy też używa npx i instaluje odpowiednio.

przykłady install

Zainstaluj najnowszą wersję:

dataverse install latest

Zainstaluj określoną wersję:

dataverse install 1.0.0

mcp polecenie

Uruchamia serwer protokołu MCP (Model Context Protocol), który łączy się ze środowiskiem, dzięki czemu asystenci sztucznej inteligencji, tacy jak Claude Desktop, mogą wchodzić w interakcje z danymi. Element docelowy jest wykrywany automatycznie z adresu URL: adres URL usługi Dataverse uruchamia serwer MCP Usługi Dataverse, a adres URL finansowy i operacyjny, taki jak https://myorg.operations.dynamics.com, uruchamia serwer ERP MCP.

mcp składnia

dataverse mcp <orgUrl> [options]

Argumentem <orgUrl> jest adres URL organizacji, na przykład https://myorg.crm.dynamics.com.

mcp Parametry

Parameter Opis
--validate Zweryfikuj punkty końcowe MCP i konfigurację uwierzytelniania bez uruchamiania serwera.
--log-level Ustaw poziom rejestrowania: Trace, , DebugInformation, Warning, Errorlub Critical. Wartość domyślna: Warning.
--log-file Zaloguj się do pliku w katalogu tymczasowym.
--preview Użyj punktu końcowego MCP w wersji zapoznawczej (api/mcp_preview zamiast api/mcp). Nieobsługiwane w systemie ERP.

przykłady mcp

Zweryfikuj konfigurację (zalecany pierwszy krok):

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

Uruchom serwer przy użyciu transportu stdio:

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

Użyj punktu końcowego podglądu lub włącz rejestrowanie plików debugowania:

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

mcp allow polecenie

Upewnij się, że aplikacja Microsoft Entra znajduje się na liście dozwolonych klientów usługi Dataverse dla środowiska bieżącego profilu. To polecenie jest alternatywą dla kroku ręcznego administratora opisanego w wymaganiach wstępnych. Uwierzytelniony użytkownik musi mieć uprawnienia administratora usługi Dataverse w środowisku docelowym.

mcp allow składnia

dataverse mcp allow <appId> [options]

Argumentem <appId> jest identyfikator aplikacji (klienta), który ma być dozwolony jako identyfikator GUID.

mcp allow Parametry

Parameter Opis
--erp Zezwalaj aplikacji na połączone wystąpienie usługi Finance and Operations zamiast usługi Dataverse.

przykłady mcp allow

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

Note

Usługa Finance and Operations buforuje listę dozwolonych w systemie AOS, dzięki czemu zastosowanie nowo dozwolonego identyfikatora aplikacji może potrwać do około pięciu minut.

org list polecenie

Wyświetl listę wszystkich środowisk, do których możesz uzyskać dostęp.

org list Parametry

Parameter Opis
--filter Filtruj listę środowisk według terminu wyszukiwania.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady org list

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

org who polecenie

Pokaż informacje o bieżącej organizacji i użytkowniku przy użyciu aktywnego profilu uwierzytelniania. Polecenie env jest aliasem dla elementu org.

org who Parametry

Parameter Opis
--environment, -env Zastąpić adres URL środowiska.
--json Wyjściowy nieprzetworzone dane JSON.

przykłady org who

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

skill polecenia

Zarządzanie umiejętnościami usługi Dataverse — zestawami instrukcji wielokrotnego użytku ( SKILL.md plik i jego pliki zasobów), których używają agenci sztucznej inteligencji — które są przechowywane w połączonym środowisku. Polecenia najwyższego poziomu skill zapewniają operacje tworzenia, odczytu, aktualizacji i usuwania w środowisku. Lokalnie umiejętności są przechowywane w obszarze .claude/skills/<name>/.

Note

Polecenia tworzenia umiejętności i oceny, takie jak make, , updategeti eval, są oddzielone od tych poleceń. Aby uzyskać więcej informacji, użyj polecenia dataverse workspace skill --help.

skill delete polecenie

Usuń umiejętności i wszystkie jej zasoby z aktywnego środowiska Usługi Dataverse. Użyj polecenia skill list , aby znaleźć unikatowe nazwy umiejętności.

dataverse skill delete new_lead-qualification

skill download polecenie

Pobierz co najmniej jedno umiejętności z aktywnego środowiska Dataverse na dysk. Polecenie pobiera SKILL.md plik i wszystkie pliki zasobów, zachowując strukturę katalogu. Użyj polecenia skill list , aby znaleźć unikatowe nazwy umiejętności.

Parameter Opis
--all Pobierz wszystkie aktywne umiejętności ze środowiska. Nie można połączyć z unikatową nazwą umiejętności.
--output, -o Katalog podstawowy dla danych wyjściowych. Wartość domyślna: .claude/skills/. Przy użyciu programu każda --allumiejętność jest zapisywana w pliku <path>/<name>/.
--json Wyprowadź zawartość umiejętności jako kod JSON bez zapisywania plików. Opcjonalnie określ ścieżkę pliku do zapisu. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list polecenie

Wyświetl listę wszystkich aktywnych umiejętności w połączonym środowisku Dataverse.

Parameter Opis
--resources, -r Wyświetl również listę plików zasobów dla każdej umiejętności.
--json Dane wyjściowe jako dane JSON. Opcjonalnie określ ścieżkę pliku do zapisu. 
dataverse skill list
dataverse skill list --resources

skill upload polecenie

Przekaż co najmniej jeden umiejętności z dysku do aktywnego środowiska usługi Dataverse. Polecenie obsługuje katalogi, pliki .zip , pliki umiejętności i pliki md .

Możesz przekazać umiejętność <name>, która jest rozpoznawana jako .claude/skills/<name>/, lub jawna <path> dla katalogu lub pliku.

Parameter Opis
--all Przekaż wszystkie umiejętności w obszarze .claude/skills/. Nie można połączyć z nazwą ani ścieżką umiejętności.
--json Wyprowadź wynik w formacie JSON. Opcjonalnie określ ścieżkę pliku do zapisu. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Zobacz także

Praca z danymi przy użyciu interfejsu wiersza polecenia usługi Dataverse

  • Last updated on