Αναφορά CLI του dataverse (προεπισκόπηση)

Σημείωση

  • Αυτή είναι μια δυνατότητα προεπισκόπησης.
  • Οι λειτουργίες προεπισκόπησης δεν προορίζονται για παραγωγική χρήση και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες είναι διαθέσιμες πριν από μια επίσημη κυκλοφορία έτσι ώστε οι πελάτες να έχουν πρόσβαση από νωρίς και να κάνουν σχόλια.

Αυτό το άρθρο περιγράφει τις εντολές που είναι διαθέσιμες στο Dataverse CLI. Κάθε εντολή υποστηρίζει μια --help επιλογή που παραθέτει τη χρήση, τις επιλογές και τα παραδείγματά της. Οι εντολές που επιστρέφουν δεδομένα υποστηρίζουν μια --json επιλογή για μη επεξεργασμένη έξοδο JSON που είναι χρήσιμη σε δέσμες ενεργειών.

Οι ακόλουθες καθολικές επιλογές μπορούν να χρησιμοποιηθούν με οποιαδήποτε εντολή:

Επιλογή Περιγραφή
--log-level <level> Ορίστε το επίπεδο καταγραφής: Trace, , InformationDebug, , Warning, Errorή Critical. Προεπιλογή: Warning.
--log-file Συνδεθείτε σε ένα αρχείο στον προσωρινό κατάλογο αντί στην κονσόλα.
--context <value> Περιβάλλον λειτουργίας προσαρτημένο στον Παράγοντα-Χρήστη. Μπορείτε επίσης να ορίσετε τη DATAVERSE_OPERATION_CONTEXT μεταβλητή περιβάλλοντος.
Εντολή Περιγραφή
api describe Περιγραφή API
api invoke Κλήση API με βάση το όνομα
api list API εντοπισμού λίστας
api request Αποστολή αίτησης HTTP με έλεγχο ταυτότητας
auth create Δημιουργία νέου προφίλ ελέγχου ταυτότητας
auth list Λίστα όλων των προφίλ ελέγχου ταυτότητας
auth remove Κατάργηση προφίλ ελέγχου ταυτότητας
auth select Επιλογή του προφίλ ενεργού ελέγχου ταυτότητας
auth who Εμφάνιση του τρέχοντος προφίλ ελέγχου ταυτότητας
data associate Σύνδεση δύο εγγραφών μέσω μιας σχέσης
data count Πλήθος εγγραφών σε έναν πίνακα
data create Δημιουργία νέας εγγραφής
data delete Διαγραφή εγγραφής
data describe Περιγραφή σχήματος οντότητας
data disassociate Κατάργηση σχέσης μεταξύ δύο εγγραφών
data get Ανάκτηση μίας μόνο εγγραφής κατά αναγνωριστικό ή εναλλακτικό κλειδί
data query Εκτέλεση ερωτήματος OData, FetchXML ή SQL
data update Ενημέρωση υπάρχουσας καρτέλας
data upload Αποστολή αρχείου σε στήλη αρχείου σε μια υπάρχουσα εγγραφή
data upsert Δημιουργία ή ενημέρωση μιας εγγραφής με εναλλακτικό κλειδί
erp batch cancel Ακύρωση μιας μαζικής εργασίας Finance and Operations
erp batch list Λίστα εργασιών δέσμης εργασιών Finance and Operations
install Εγκατάσταση μιας συγκεκριμένης έκδοσης ή ενημέρωση στην πιο πρόσφατη έκδοση
mcp Εκκίνηση του διακομιστή MCP για Dataverse ή ERP
mcp allow Να επιτρέπεται μια εφαρμογή ως πρόγραμμα-πελάτης MCP
org list Λίστα όλων των προσβάσιμων περιβαλλόντων
org who Εμφάνιση τρεχουσών πληροφοριών οργανισμού και χρήστη
skill delete Διαγραφή δεξιότητας από το Dataverse
skill download Λήψη δεξιότητας από το Dataverse
skill list Λίστα ενεργών δεξιοτήτων στο περιβάλλον
skill upload Αποστολή δεξιότητας στο Dataverse

Σημείωση

Πολλές εντολές υποστηρίζουν μια --target <dataverse\|erp> επιλογή που δρομολογεί τη λειτουργία στο Dataverse (προεπιλογή) ή στο συνδεδεμένο περιβάλλον Finance and Operations (ERP). Οι εντολές που συνδέονται σε ένα περιβάλλον υποστηρίζουν μια --environment <url> επιλογή (-env) για την παράκαμψη της διεύθυνσης URL περιβάλλοντος του τρέχοντος προφίλ.

api describe εντολή

Εμφανίστε τα μετα-δεδομένα για ένα μεμονωμένο API. Για τα προσαρμοσμένα API του Dataverse, το αποτέλεσμα περιλαμβάνει περιγραφές παραμέτρων αίτησης και ιδιότητας απόκρισης όταν τα παρέχουν τα μετα-δεδομένα.

Τα ονόματα των αντίστροφων δεδομένων δεν έχουν πρόθημα από προεπιλογή. Μπορείτε να χρησιμοποιήσετε ονόματα προσδιορισμένων με ERP στη φόρμα erp:ServiceGroup/Service/Operation.

api describe Παραμέτρους

Παράμετρος Περιγραφή
--target Επίλυση μη προσδιορισμένου ονόματος σε σχέση με dataverse το ή erpτο .
--service-group Μόνο ERP. Περιορίστε την αναζήτηση λειτουργίας σε μία ομάδα υπηρεσίας.
--service Μόνο ERP. Περιορίστε την αναζήτηση λειτουργίας σε μία υπηρεσία.
--environment Παράκαμψη της διεύθυνσης URL περιβάλλοντος Dataverse.
--json Εξάγει ακατέργαστο JSON.

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 εντολή

Καλέστε ένα API που έχει εντοπιστεί με το όνομά του. Χρησιμοποιήστε name=value σύνταξη για τις παραμέτρους. Εάν μια τιμή περιέχει κενά διαστήματα, αναφέρετε ολόκληρο το διακριτικό. Ορισμένα API του Dataverse αποδέχονται μια παράμετρο συμβολοσειράς της οποίας τα περιεχόμενα είναι τα ίδια JSON. Σε αυτή την περίπτωση, διαβιβάστε το κείμενο JSON ως τιμή, χρησιμοποιώντας τους κανονικούς κανόνες παράθεσης και διαφυγής του κελύφους σας.

Από προεπιλογή, οι αποκρίσεις JSON αποδίδονται σε μια φιλική μορφή κειμένου που διατηρεί τα ονόματα των ιδιοτήτων εξόδου. Χρησιμοποιήστε το για να διατηρήσετε --json το ακατέργαστο ωφέλιμο φορτίο JSON.

api invoke Παραμέτρους

Παράμετρος Περιγραφή
--target Επίλυση μη προσδιορισμένου ονόματος σε σχέση με dataverse το ή erpτο .
--service-group Μόνο ERP. Περιορίστε την αναζήτηση λειτουργίας σε μία ομάδα υπηρεσίας.
--service Μόνο ERP. Περιορίστε την αναζήτηση λειτουργίας σε μία υπηρεσία.
--param Προσθέστε μια επώνυμη παράμετρο στη name=value φόρμα. Επαναλαμβανόμενη.
--bind Η διαδρομή σύνδεσης για API Dataverse που συνδέονται με οντότητα.
--method, -X Παρακάμψετε την συνάγεται μέθοδος HTTP.
--body Χρησιμοποιήστε ένα μη επεξεργασμένο σώμα JSON αντί για επώνυμες παραμέτρους.
--body-file Διαβάστε ένα ανεπεξέργαστα σώμα JSON από ένα αρχείο.
--header, -H Προσθέστε μια κεφαλίδα HTTP σε key:value φόρμα.
--include, -i Συμπεριλάβετε την κατάσταση απόκρισης και τις κεφαλίδες.
--environment Παράκαμψη της διεύθυνσης URL περιβάλλοντος Dataverse.
--json Εξαγάγετε μη επεξεργασμένο JSON αντί για φιλικό κείμενο.

api invoke Παραδείγματα

Καλέστε μια συνάρτηση Dataverse. Αυτό το παράδειγμα εμφανίζει τη χρήση της συνάρτησης Dynamics 365 Contact Center CCaaS_GetPresence.

dataverse api invoke CCaaS_GetPresence ApiVersion=1.0

Καλέστε την ενέργεια Dataverse AISummarize με διαστήματα σε μια τιμή παραμέτρου:

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

Κλήση προσαρμοσμένης υπηρεσίας ERP:

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

api list εντολή

Λίστα API με δυνατότητα εντοπισμού, όπως προσαρμοσμένα API dataverse και τελικά σημεία υπηρεσίας με δυνατότητα κλήσης ERP. Τα αποτελέσματα εμφανίζουν την ταυτότητα API, το φιλικό όνομα, το είδος και την περιγραφή, όταν είναι διαθέσιμα. Μπορείτε να διαβιβάσετε έναν προαιρετικό όρο ερωτήματος για να φιλτράρετε τα αποτελέσματα.

api list παράμετροι

Παράμετρος Περιγραφή
--target Το σύστημα προορισμού για αναζήτηση: dataverse (προεπιλογή) ή erp.
--service-group Μόνο ERP. Φιλτράρετε σε μία μόνο ομάδα υπηρεσίας.
--service Μόνο ERP. Φιλτράρετε σε μία μόνο υπηρεσία.
--limit Ο μέγιστος αριθμός API που θα επιστραφούν. Προεπιλογή: 50.
--page Ο αριθμός σελίδας 1 που βασίζεται σελιδοποίησης στα αποτελέσματα. Προεπιλογή: 1.
--environment Παράκαμψη της διεύθυνσης URL περιβάλλοντος Dataverse.
--json Εξάγει ακατέργαστο JSON.

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 εντολή

Στείλτε μια μη επεξεργασμένη αίτηση HTTP με έλεγχο ταυτότητας στο Dataverse ή στο ERP. Χρησιμοποιήστε αυτήν την εντολή όταν χρειάζεστε πλήρη έλεγχο της διαδρομής, της μεθόδου, των κεφαλίδων και του σώματος.

api request Παραμέτρους

Παράμετρος Περιγραφή
--target Το σύστημα προορισμού: dataverse ή erp. Υποχρεωτικό.
--path Η διαδρομή αίτησης. Υποχρεωτικό.
--method, -X Η μέθοδος HTTP. Προεπιλογή: GETή POST όταν παρέχεται ένα σώμα.
--body Ένα σώμα ενσωματωμένης αίτησης JSON.
--body-file Ένα αρχείο που περιέχει ένα σώμα αίτησης αντικειμένου JSON.
--header, -H Προσθέστε μια κεφαλίδα HTTP σε key:value φόρμα.
--include, -i Συμπεριλάβετε την κατάσταση απόκρισης και τις κεφαλίδες.
--environment Παράκαμψη της διεύθυνσης URL περιβάλλοντος Dataverse.

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 εντολή

Δημιουργήστε ένα νέο προφίλ ελέγχου ταυτότητας.

auth create παράμετροι

Χρησιμοποιήστε αυτές τις παραμέτρους για να καθορίσετε τη συμπεριφορά της εντολής auth create .

Παράμετρος Περιγραφή
--environment, -env Η διεύθυνση URL για το περιβάλλον Dataverse με το οποίο θέλετε να γίνει έλεγχος ταυτότητας.
--name, -n Ένα προαιρετικό όνομα για το προφίλ. Χρησιμοποιήστε το όνομα για να επιλέξετε το προφίλ αργότερα.
--cloud, -ci Το cloud προορισμού: Public, UsGov, UsGovHigh, UsGovDodή China.
--deviceCode, -dc Χρησιμοποιήστε τη ροή ελέγχου ταυτότητας κώδικα συσκευής, για περιβάλλοντα χωρίς πρόγραμμα περιήγησης.
--username, -un Το όνομα χρήστη για το όνομα χρήστη και τον έλεγχο ταυτότητας κωδικού πρόσβασης.
--password, -p Ο κωδικός πρόσβασης για το όνομα χρήστη και τον έλεγχο ταυτότητας με κωδικό πρόσβασης.
--applicationId, -id Το αναγνωριστικό εφαρμογής (πρόγραμμα-πελάτης) για τον έλεγχο ταυτότητας κύριας υπηρεσίας (SPN).
--clientSecret, -cs Ο μυστικός κωδικός προγράμματος-πελάτη για τον έλεγχο ταυτότητας κύριας υπηρεσίας.
--certificateDiskPath, -cdp Η διαδρομή προς ένα αρχείο πιστοποιητικού .pfx για έλεγχο ταυτότητας βάσει πιστοποιητικού.
--certificatePassword, -cp Ο κωδικός πρόσβασης για το πιστοποιητικό.
--tenant, -t Το αναγνωριστικό μισθωτή. Απαιτείται για έλεγχο ταυτότητας κύριας υπηρεσίας.
--managedIdentity, -mi Χρησιμοποιήστε μια Azure διαχειριζόμενη ταυτότητα.
--githubFederated, -ghf Χρησιμοποιήστε GitHub Actions ομόσπονδο έλεγχο ταυτότητας.
--azureDevOpsFederated, -adof Χρησιμοποιήστε Azure DevOps ομόσπονδο έλεγχο ταυτότητας.
--clientid, -cid Ένα προσαρμοσμένο Microsoft Entra αναγνωριστικό προγράμματος-πελάτη εφαρμογής που θα χρησιμοποιηθεί αντί για την προεπιλεγμένη εφαρμογή CLI Dataverse.
--no-default-environment Μην ορίσετε το περιβάλλον ως προεπιλογή.
--accept-cleartext-caching Να επιτρέπεται η cache διακριτικών απλού κειμένου σε Linux.

auth create Παραδείγματα

Τα παρακάτω παραδείγματα δείχνουν πώς μπορείτε να χρησιμοποιήσετε την auth create εντολή.

Αλληλεπιδραστικός έλεγχος

Αυτή η εντολή ανοίγει ένα παράθυρο διαλόγου προγράμματος περιήγησης ή συστήματος για πρόσθετες πληροφορίες.

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

Επώνυμο προφίλ

Δημιουργήστε ένα προφίλ με ένα συγκεκριμένο όνομα.

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

Ροή κώδικα συσκευής

Χρησιμοποιήστε τη ροή κώδικα συσκευής για περιβάλλοντα χωρίς πρόγραμμα περιήγησης.

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

Κύρια υπηρεσία με μυστικό πελάτη

Χρησιμοποιήστε μια κύρια υπηρεσία όταν χρειάζεστε έλεγχο ταυτότητας χωρίς επίβλεψη, όπως σε μια διοχέτευση CI/CD ή σε μια άλλη αυτοματοποιημένη δέσμη ενεργειών όπου δεν είναι δυνατή η αλληλεπιδραστική είσοδος. Καταχωρήστε το αναγνωριστικό εφαρμογής, τον μυστικό κωδικό προγράμματος-πελάτη και το αναγνωριστικό μισθωτή μιας καταχώρησης εφαρμογής που έχει πρόσβαση στο περιβάλλον.

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

Αναγνωριστικό προγράμματος-πελάτη προσαρμοσμένης εφαρμογής Entra

Χρησιμοποιήστε τη δική σας καταχώρηση εφαρμογής αντί για την προεπιλογή.

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

auth list εντολή

Παράθεση όλων των προφίλ ελέγχου ταυτότητας. Προσθέστε --json το για μη επεξεργασμένη έξοδο JSON.

auth list Παραδείγματα

dataverse auth list
dataverse auth list --json

auth remove εντολή

Καταργήστε ένα ή όλα τα προφίλ ελέγχου ταυτότητας.

auth remove Παραμέτρους

Παράμετρος Περιγραφή
--index, -i Καταργήστε το προφίλ με το καθορισμένο ευρετήριο 1 που βασίζεται, όπως φαίνεται στο auth list.
--name, -n Καταργήστε το προφίλ με το καθορισμένο όνομα.
--all Καταργήστε όλα τα προφίλ.

auth remove Παραδείγματα

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

auth select εντολή

Επιλέξτε το προφίλ ενεργού ελέγχου ταυτότητας. Εκτελέστε την εντολή χωρίς επιλογές για να παρατίθενται όλα τα προφίλ.

auth select Παραμέτρους

Παράμετρος Περιγραφή
--index, -i Επιλέξτε το προφίλ βάσει του ευρετηρίου του που βασίζεται σε 1, όπως φαίνεται στο auth list.
--name, -n Επιλέξτε το προφίλ βάσει ονόματος.

auth select Παραδείγματα

Ανοίξτε έναν αλληλεπιδραστικό επιλογέα. Χρησιμοποιήστε τα πλήκτρα βέλους ή πληκτρολογήστε για να φιλτράρετε:

dataverse auth select

Επιλέξτε ένα προφίλ βάσει ευρετηρίου ή όνομα:

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

auth who εντολή

Εμφανίστε το τρέχον, ενεργό προφίλ ελέγχου ταυτότητας. Προσθέστε --json το για μη επεξεργασμένη έξοδο JSON.

auth who Παραδείγματα

dataverse auth who
dataverse auth who --json

data associate εντολή

Συσχετίστε δύο εγγραφές μέσω μιας ιδιότητας περιήγησης (σχέση). Αυτή η εντολή υποστηρίζεται μόνο για το Dataverse.

data associate Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το όνομα συνόλου οντοτήτων της κύριας εγγραφής. Υποχρεωτικό.
--id, -i Το GUID της κύριας εγγραφής. Υποχρεωτικό.
--relationship, -rel Το όνομα ιδιότητας περιήγησης. Υποχρεωτικό.
--related Το όνομα συνόλου οντοτήτων του σχετικού πίνακα. Υποχρεωτικό.
--related-id Το GUID της σχετικής εγγραφής. Υποχρεωτικό.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

data associate Παραδείγματα

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

data count εντολή

Μετρήστε τις εγγραφές σε έναν πίνακα, προαιρετικά φιλτραρισμένες.

data count Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το όνομα του συνόλου οντοτήτων. Απαιτείται εκτός και αν χρησιμοποιείτε το --fetchxml.
--filter, -f Μια παράσταση OData $filter .
--fetchxml Ένα ερώτημα συνάθροισης FetchXML για σύνθετες μετρήσεις.
--target Δρομολογεί το dataverse (προεπιλογή) ή το συνδεδεμένο erp περιβάλλον.
--cross-company Μόνο ERP. Πλήθος σε όλες τις εταιρείες. Προεπιλογή: η προεπιλεγμένη εταιρεία του χρήστη.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

data count Παραδείγματα

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

data create εντολή

Δημιουργήστε μια νέα εγγραφή σε έναν πίνακα Dataverse. Ορίστε στήλες αναζήτησης χρησιμοποιώντας @odata.bind σύνταξη.

data create Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το όνομα του συνόλου οντοτήτων. Υποχρεωτικό.
--data, -d Ένα αντικείμενο JSON με τις τιμές πεδίου.
--data-file Η διαδρομή σε ένα αρχείο JSON με τα δεδομένα εγγραφής.
--return, -r Επιστρέψτε την πλήρη εγγραφή που δημιουργήθηκε.
--target Δρομολογεί το dataverse (προεπιλογή) ή το συνδεδεμένο erp περιβάλλον.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

data create Παραδείγματα

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

Συμβουλή

Χρησιμοποιήστε το --data-file για σύνθετη JSON. Χρησιμοποιήστε --return --json την για να λάβετε την πλήρη εγγραφή που δημιουργήθηκε.

data delete εντολή

Διαγράψτε μια μοναδική εγγραφή από το πρωτεύον κλειδί της ή με ένα εναλλακτικό κλειδί.

data delete Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το όνομα του συνόλου οντοτήτων. Υποχρεωτικό.
--id, -i Η εγγραφή GUID.
--key, -k Ένα εναλλακτικό κλειδί.
--no-confirm Παραλείπει τη γραμμή εντολών επιβεβαίωσης.
--target Δρομολογεί το dataverse (προεπιλογή) ή το συνδεδεμένο erp περιβάλλον.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

data delete Παραδείγματα

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

data describe εντολή

Περιγράψτε το σχήμα μιας οντότητας OData. Για το Dataverse, η εντολή καλεί EntityDefinitions(LogicalName='<table>') το με $expand χρήση του --include, καθώς και μια δεύτερη κλήση στο customapis όταν --include actions οριστεί. Ενσωματωμένες ενέργειες του Dataverse όπως Assign οι και SetState δεν απαριθμώνται. Για την ERP, μία μόνο κλήση για την /Metadata/PublicEntities επιστροφή ιδιοτήτων, δεσμευμένων ενεργειών και περιήγησης μαζί.

data describe Παραμέτρους

Παράμετρος Περιγραφή
--target Ο προορισμός: dataverse (προεπιλογή) ή erp.
--table, -t Υποχρεωτικό. Για το Dataverse, το λογικό όνομα, όπως account. Για την ERP, το όνομα συνόλου οντοτήτων, όπως BatchJobs.
--include Μια λίστα διαχωρισμένων με κόμματα ενοτήτων για συμπερίληψη: entity, properties, relations, actionsή all. Ψευδώνυμα: attributes=properties, . relationships=relations Προεπιλογή για ERP: all. Προεπιλογή για Dataverse: entity,properties.
--json Εξάγει ακατέργαστο JSON.

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 εντολή

Καταργήστε μια σχέση μεταξύ δύο εγγραφών. Αυτή η εντολή υποστηρίζεται μόνο για το Dataverse.

data disassociate Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το όνομα συνόλου οντοτήτων της κύριας εγγραφής. Υποχρεωτικό.
--id, -i Το GUID της κύριας εγγραφής. Υποχρεωτικό.
--relationship, -rel Το όνομα ιδιότητας περιήγησης. Υποχρεωτικό.
--related-id Το GUID της σχετικής εγγραφής, για μια σχέση πολλά προς πολλά. Παραλείψτε αυτήν την παράμετρο για να καταργήσετε μια αναζήτηση.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

data disassociate Παραδείγματα

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

data get εντολή

Ανακτήστε μια μοναδική εγγραφή από το αναγνωριστικό της (πρωτεύον κλειδί) ή ένα εναλλακτικό κλειδί.

data get Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το όνομα του συνόλου οντοτήτων. Υποχρεωτικό.
--id, -i Η εγγραφή GUID (πρωτεύον κλειδί).
--key, -k Ένα εναλλακτικό κλειδί, για παράδειγμα "col='val'".
--select, -s Μια λίστα στηλών διαχωρισμένων με κόμματα ($select).
--expand, -x Μια παράσταση OData $expand για σχετικές εγγραφές.
--target Δρομολογεί το dataverse (προεπιλογή) ή το συνδεδεμένο erp περιβάλλον.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

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 εντολή

Εκτελέστε ένα ερώτημα OData, FetchXML ή SQL σε έναν πίνακα Dataverse.

data query παράμετροι

Παράμετρος Περιγραφή
--table, -t Το όνομα συνόλου οντοτήτων σε ερώτημα. Απαιτείται για ερωτήματα OData.
--select, -s Μια λίστα στηλών διαχωρισμένων με κόμματα ($select).
--filter, -f Μια παράσταση OData $filter .
--orderby, -o Μια παράσταση OData $orderby .
--top Ο μέγιστος αριθμός εγγραφών προς επιστροφή (1-5000).
--expand, -x Μια παράσταση OData $expand για σχετικές εγγραφές.
--fetchxml Ένα ενσωματωμένο ερώτημα FetchXML.
--fetchxml-file Η διαδρομή σε ένα αρχείο που περιέχει ένα ερώτημα FetchXML.
--sql Ένα ερώτημα SQL SELECT (προεπισκόπηση).
--sql-file Η διαδρομή προς ένα αρχείο που περιέχει ένα ερώτημα SQL.
--all, -a Ακολουθήστε τη σελιδοποίηση για να ανακτήσετε όλες τις εγγραφές.
--max-records Ο μέγιστος αριθμός εγγραφών για ανάκτηση κατά τη χρήση --allτης . Προεπιλογή: 100000.
--target Δρομολογεί το dataverse (προεπιλογή) ή το συνδεδεμένο erp περιβάλλον.
--cross-company Μόνο ERP. Υποβάλετε ερωτήματα σε όλες τις εταιρείες. Προεπιλογή: η προεπιλεγμένη εταιρεία του χρήστη.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

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

Μάθετε περισσότερα

data update εντολή

Ενημερώστε ένα ή περισσότερα πεδία σε μια υπάρχουσα εγγραφή, που αναγνωρίζεται από το αναγνωριστικό της ή από ένα εναλλακτικό κλειδί. Ορίστε στήλες αναζήτησης χρησιμοποιώντας @odata.bind σύνταξη.

data update Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το όνομα του συνόλου οντοτήτων. Υποχρεωτικό.
--id, -i Η εγγραφή GUID.
--key, -k Ένα εναλλακτικό κλειδί.
--data, -d Ένα αντικείμενο JSON με τα πεδία προς ενημέρωση.
--data-file Η διαδρομή σε ένα αρχείο JSON με τα δεδομένα ενημέρωσης.
--return, -r Επιστρέψτε την πλήρη ενημερωμένη εγγραφή.
--target Δρομολογεί το dataverse (προεπιλογή) ή το συνδεδεμένο erp περιβάλλον.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

data update Παραδείγματα

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

data upload εντολή

Αποστείλετε ένα τοπικό αρχείο σε μια στήλη αρχείου Dataverse σε μια υπάρχουσα εγγραφή. Η εντολή επιλέγει αυτόματα μια αποστολή μίας αίτησης ή τμήματος με βάση το μέγεθος του αρχείου, εκτός εάν καθορίσετε --mode. Στην αυτόματη λειτουργία, τα αρχεία κάτω των 128 MB αποστέλλονται με μία μόνο αίτηση και μεγαλύτερα αρχεία χρησιμοποιούν μια χοντρή αποστολή. Όταν παραλείψετε --mime-typeτο , η εντολή συνάγει τον τύπο MIME από την επέκταση αρχείου. Οι άγνωστες επεκτάσεις είναι από προεπιλογή application/octet-stream.

data upload Παραμέτρους

Παράμετρος Περιγραφή
--table, -t Το σχήμα πίνακα ή το λογικό όνομα, όπως account. Υποχρεωτικό. Η εντολή επιλύει το σύνολο οντοτήτων από μετα-δεδομένα.
--id, -i Η εγγραφή GUID. Υποχρεωτικό.
--column, -c Το όνομα χαρακτηριστικού στήλης αρχείου. Υποχρεωτικό.
--file, -f Η διαδρομή προς το τοπικό αρχείο. Υποχρεωτικό.
--mode, -m Η στρατηγική αποστολής: auto (προεπιλογή), smallή chunk.
--mime-type Ένας ρητός τύπος MIME. Προεπιλογή: προκύπτουν από την επέκταση αρχείου.
--overwrite Αντικαταστήστε ένα υπάρχον αρχείο. Από προεπιλογή, η εντολή αποτυγχάνει εάν η στήλη δεν είναι κενή.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

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 εντολή

Δημιουργήστε μια εγγραφή εάν δεν υπάρχει ή ενημερώστε την εάν υπάρχει. Η εγγραφή αναγνωρίζεται από ένα εναλλακτικό κλειδί. Μάθετε πώς μπορείτε να χρησιμοποιήσετε ένα εναλλακτικό κλειδί για αναφορά σε μια εγγραφή

data upsert παράμετροι

Παράμετρος Περιγραφή
--table, -t Το όνομα του συνόλου οντοτήτων. Υποχρεωτικό.
--key, -k Ένα εναλλακτικό κλειδί. Υποχρεωτικό.
--data, -d Ένα αντικείμενο JSON με τις τιμές πεδίου.
--data-file Η διαδρομή προς ένα αρχείο JSON.
--update-only Αποτυχία εάν η εγγραφή δεν υπάρχει (If-Match: *).
--create-only Αποτυχία εάν η εγγραφή υπάρχει ήδη (If-None-Match: *).
--return, -r Επιστρέψτε την πλήρη εγγραφή μετά τη λειτουργία.
--target Δρομολογεί το dataverse (προεπιλογή) ή το συνδεδεμένο erp περιβάλλον.
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

data upsert Παραδείγματα

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

erp batch cancel εντολή

Ακύρωση μιας μαζικής εργασίας Finance and Operations με την .RecId Χρησιμοποιήστε erp batch list το για να βρείτε το RecId.

erp batch cancel Παραδείγματα

dataverse erp batch cancel <recid>

erp batch list εντολή

Παρατίθενται οι εργασίες δέσμης στην παρουσία Finance and Operations που είναι συνδεδεμένη με το περιβάλλον σας Dataverse. Η εντολή απαιτεί ένα προφίλ ελέγχου ταυτότητας συνδεδεμένο σε ένα περιβάλλον Dataverse που έχει μια συνδεδεμένη παρουσία Finance and Operations. Η διεύθυνση URL Finance and Operations προκύπτει αυτόματα από την τρέχουσα σύνδεση Dataverse.

erp batch list Παραμέτρους

Παράμετρος Περιγραφή
--company Φιλτράρισμα κατά νομική οντότητα (dataAreaId), όπως USMF.
--status Φιλτράρισμα κατά κατάσταση: Waiting, Executing, Finished, Errorή Cancelled.
--top Ο μέγιστος αριθμός αποτελεσμάτων προς επιστροφή. Προεπιλογή: 20.
--caption Φιλτράρισμα κατά λεζάντα (συμφωνία δευτερεύουσας συμβολοσειράς χωρίς διάκριση πεζών-κεφαλαίων).
--json Εξάγει ακατέργαστο JSON.

erp batch list Παραδείγματα

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

install εντολή

Εγκαταστήστε μια συγκεκριμένη έκδοση του Dataverse CLI ή ενημερώστε την πιο πρόσφατη έκδοση. Η εντολή εντοπίζει εάν έχετε εγκαταστήσει το CLI καθολικά ή χρησιμοποιείτε npx και εγκαθιστά ανάλογα.

install Παραδείγματα

Εγκαταστήστε την πιο πρόσφατη έκδοση:

dataverse install latest

Εγκατάσταση συγκεκριμένης έκδοσης:

dataverse install 1.0.0

mcp εντολή

Ξεκινά έναν διακομιστή Model Context Protocol (MCP) που συνδέεται με το περιβάλλον σας, έτσι ώστε βοηθοί AI όπως ο Claude Desktop να μπορούν να αλληλεπιδρούν με τα δεδομένα σας. Ο προορισμός εντοπίζεται αυτόματα από τη διεύθυνση URL: μια διεύθυνση URL dataverse ξεκινά τον διακομιστή Dataverse MCP και μια διεύθυνση URL finance and operations, όπως https://myorg.operations.dynamics.com, ξεκινά το διακομιστή ERP MCP.

σύνταξη mcp

dataverse mcp <orgUrl> [options]

Το <orgUrl> όρισμα είναι η διεύθυνση URL οργανισμού σας, για παράδειγμα https://myorg.crm.dynamics.com.

mcp Παραμέτρους

Παράμετρος Περιγραφή
--validate Επικυρώστε τα τελικά σημεία MCP και τη ρύθμιση ελέγχου ταυτότητας χωρίς να εκκινήσετε το διακομιστή.
--log-level Ορίστε το επίπεδο καταγραφής: Trace, , InformationDebug, , Warning, Errorή Critical. Προεπιλογή: Warning.
--log-file Συνδεθείτε σε ένα αρχείο στον προσωρινό κατάλογο.
--preview Χρησιμοποιήστε το τελικό σημείο MCP προεπισκόπησης api/mcp(api/mcp_preview αντί για ). Δεν υποστηρίζεται για ERP.

mcp Παραδείγματα

Επικύρωση της ρύθμισης (ένα συνιστώμενο πρώτο βήμα):

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

Ξεκινήστε τον διακομιστή χρησιμοποιώντας τη μεταφορά stdio:

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

Χρησιμοποιήστε το τελικό σημείο προεπισκόπησης ή ενεργοποιήστε την καταγραφή αρχείων εντοπισμού σφαλμάτων:

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

mcp allow εντολή

Βεβαιωθείτε ότι μια Microsoft Entra εφαρμογή βρίσκεται στη λίστα επιτρεπόμενων πελατών Dataverse MCP για το τρέχον περιβάλλον προφίλ. Αυτή η εντολή είναι μια εναλλακτική του μη αυτόματου βήματος διαχείρισης που περιγράφεται στις προϋποθέσεις. Ο εξουσιοδοτημένος χρήστης πρέπει να έχει δικαιώματα διαχειριστή του Dataverse στο περιβάλλον προορισμού.

σύνταξη mcp allow

dataverse mcp allow <appId> [options]

Το <appId> όρισμα είναι το αναγνωριστικό εφαρμογής (πρόγραμμα-πελάτης) που επιτρέπεται, ως GUID.

mcp allow Παραμέτρους

Παράμετρος Περιγραφή
--erp Να επιτρέπεται η εφαρμογή στη συνδεδεμένη παρουσία Finance and Operations αντί για το Dataverse.

mcp allow Παραδείγματα

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

Σημείωση

Το Finance and Operations αποθηκεύει προσωρινά τη λίστα επιτρεπόμενων στο AOS, επομένως ένα πρόσφατα επιτρεπόμενο αναγνωριστικό εφαρμογής μπορεί να χρειαστεί έως και πέντε λεπτά για να τεθεί σε ισχύ.

org list εντολή

Παράθεση όλων των περιβαλλόντων στα οποία μπορείτε να αποκτήσετε πρόσβαση.

org list παράμετροι

Παράμετρος Περιγραφή
--filter Φιλτράρετε τη λίστα των περιβαλλόντων κατά έναν όρο αναζήτησης.
--json Εξάγει ακατέργαστο JSON.

org list Παραδείγματα

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

org who εντολή

Εμφανίστε πληροφορίες σχετικά με τον τρέχοντα οργανισμό και χρήστη, χρησιμοποιώντας το ενεργό προφίλ ελέγχου ταυτότητας. Η env εντολή είναι ένα ψευδώνυμο για orgτο .

org who παράμετροι

Παράμετρος Περιγραφή
--environment, -env Παράκαμψη της διεύθυνσης URL περιβάλλοντος.
--json Εξάγει ακατέργαστο JSON.

org who Παραδείγματα

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

εντολές skill

Διαχείριση δεξιοτήτων Dataverse - επαναχρησιμοποιήσιμα σύνολα οδηγιών (ένα SKILL.md αρχείο και τα αρχεία πόρων του) που χρησιμοποιούν οι παράγοντες AI, τα οποία αποθηκεύονται στο συνδεδεμένο περιβάλλον. Οι εντολές ανώτατου επιπέδου skill παρέχουν λειτουργίες δημιουργίας, ανάγνωσης, ενημέρωσης και διαγραφής σε σχέση με το περιβάλλον. Τοπικά, οι δεξιότητες αποθηκεύονται στο ..claude/skills/<name>/

Σημείωση

Οι εντολές σύνταξης δεξιοτήτων και αξιολόγησης, όπως make, update, getκαι eval, είναι ξεχωριστές από αυτές τις εντολές. Για περισσότερες πληροφορίες, εκτελέστε dataverse workspace skill --help.

skill delete εντολή

Διαγράψτε μια δεξιότητα και όλους τους πόρους της από το ενεργό περιβάλλον Dataverse. Χρησιμοποιήστε skill list το για να βρείτε μοναδικά ονόματα δεξιοτήτων.

dataverse skill delete new_lead-qualification

skill download εντολή

Κάντε λήψη μίας ή περισσότερων δεξιοτήτων από το ενεργό περιβάλλον Dataverse στον δίσκο. Η εντολή κάνει λήψη του SKILL.md αρχείου και όλων των αρχείων πόρων, διατηρώντας τη δομή του καταλόγου. Χρησιμοποιήστε skill list το για να βρείτε μοναδικά ονόματα δεξιοτήτων.

Παράμετρος Περιγραφή
--all Κάντε λήψη όλων των ενεργών δεξιοτήτων από το περιβάλλον. Δεν μπορεί να συνδυαστεί με ένα μοναδικό όνομα δεξιοτήτων.
--output, -o Ο βασικός κατάλογος για έξοδο. Προεπιλογή: .claude/skills/. Με --allτο , κάθε δεξιότητα είναι γραμμένη στον <path>/<name>/.
--json Εξαγάγετε το περιεχόμενο δεξιοτήτων ως JSON χωρίς τη σύνταξη αρχείων. Προαιρετικά, καθορίστε μια διαδρομή αρχείου στην οποία θα γίνει εγγραφή. 
dataverse skill download new_lead-qualification
dataverse skill download --all --output ./skills

skill list εντολή

Παράθεση όλων των ενεργών δεξιοτήτων στο συνδεδεμένο περιβάλλον Dataverse.

Παράμετρος Περιγραφή
--resources, -r Παρατίθενται επίσης τα αρχεία πόρων για κάθε δεξιότητα.
--json Έξοδος ως JSON. Προαιρετικά, καθορίστε μια διαδρομή αρχείου στην οποία θα γίνει εγγραφή. 
dataverse skill list
dataverse skill list --resources

skill upload εντολή

Αποστείλετε μία ή περισσότερες δεξιότητες από τον δίσκο στο ενεργό περιβάλλον Dataverse. Η εντολή υποστηρίζει καταλόγους, .zip αρχεία, αρχεία .skill και αρχεία .md .

Μπορείτε να μεταβιβάσετε μια δεξιότητα <name>, η οποία επιλύει .claude/skills/<name>/το ή ένα ρητό <path> σε έναν κατάλογο ή αρχείο.

Παράμετρος Περιγραφή
--all Κάντε αποστολή όλων των δεξιοτήτων στην ενότητα .claude/skills/. Δεν μπορεί να συνδυαστεί με ένα όνομα ή διαδρομή δεξιοτήτων.
--json Εξάγει το αποτέλεσμα ως JSON. Προαιρετικά, καθορίστε μια διαδρομή αρχείου στην οποία θα γίνει εγγραφή. 
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all

Δείτε επίσης

Εργασία με δεδομένα χρησιμοποιώντας το Dataverse CLI

  • Last updated on