إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
ملحوظة
- هذه ميزة إصدار أولي.
- لا تُستخدم ميزات الإصدار الأولي في بيئة التشغيل، وقد يتم تقييد بعض الوظائف بها. تتوفر هذه الميزات قبل إصدار رسمي حتى يتمكن العملاء من الوصول المبكر وتقديم الملاحظات.
توضح هذه المقالة الأوامر المتوفرة في Dataverse CLI. يدعم --help كل أمر خيارا يسرد استخدامه وخياراته وأمثلته. تدعم الأوامر التي ترجع البيانات خيارا --json لإخراج JSON الخام المفيد في البرامج النصية.
يمكن استخدام الخيارات العمومية التالية مع أي أمر:
| Option | Description |
|---|---|
--log-level <level> |
تعيين مستوى التسجيل: Traceأو Debugأو Informationأو WarningErrorأو أو .Critical افتراضي: Warning. |
--log-file |
سجل الدخول إلى ملف في الدليل المؤقت بدلا من وحدة التحكم. |
--context <value> |
سياق العملية الملحق ب User-Agent. يمكنك أيضا تعيين DATAVERSE_OPERATION_CONTEXT متغير البيئة. |
| Command | Description |
|---|---|
api describe |
وصف واجهة برمجة التطبيقات |
api invoke |
استدعاء واجهة برمجة التطبيقات بالاسم |
api list |
سرد واجهات برمجة التطبيقات القابلة للاكتشاف |
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 |
سرد مهام دفعة التمويل والعمليات |
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 أمر
إظهار بيانات التعريف لواجهة برمجة تطبيقات واحدة. بالنسبة لواجهات برمجة التطبيقات المخصصة Dataverse، يتضمن الإخراج وصفا لمعلمة الطلب وخصائص الاستجابة عندما توفرها بيانات التعريف.
أسماء Dataverse غير مسبوقة بشكل افتراضي. يمكنك استخدام الأسماء المؤهلة ل ERP في النموذج erp:ServiceGroup/Service/Operation.
api describe البارامترات
| المعلمه | Description |
|---|---|
--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 أمر
استدعاء واجهة برمجة تطبيقات مكتشفة بالاسم. استخدم name=value بناء الجملة للمعلمات. إذا كانت القيمة تحتوي على مسافات، فاقتبس الرمز المميز بأكمله. تقبل بعض واجهات برمجة تطبيقات Dataverse معلمة سلسلة محتوياتها هي نفسها JSON. في هذه الحالة، مرر نص JSON كقيمة باستخدام قواعد الاقتباس والهروب العادية ل shell.
بشكل افتراضي، يتم عرض استجابات JSON بتنسيق نصي مألوف يحتفظ بأسماء خصائص الإخراج. استخدم --json للحفاظ على حمولة JSON الأولية.
api invoke البارامترات
| المعلمه | Description |
|---|---|
--target |
حل اسم غير مؤهل مقابل dataverse أو erp. |
--service-group |
ERP فقط. تضييق نطاق البحث عن العملية إلى مجموعة خدمة واحدة. |
--service |
ERP فقط. تضييق نطاق البحث عن العملية إلى خدمة واحدة. |
--param |
إضافة معلمة مسماة في name=value النموذج. قابلة للتكرار. |
--bind |
مسار الربط لواجهات برمجة تطبيقات Dataverse المرتبطة بالوحدة. |
--method، -X |
تجاوز أسلوب HTTP المستنتج. |
--body |
استخدم نص JSON البسيط بدلا من المعلمات المسماة. |
--body-file |
اقرأ نص JSON البسيط من ملف. |
--header، -H |
إضافة رأس HTTP في key:value النموذج. |
--include، -i |
قم بتضمين حالة الاستجابة والعناوين. |
--environment |
تجاوز عنوان URL لبيئة Dataverse. |
--json |
إخراج JSON الخام بدلا من نص مألوف. |
api invoke امثله
استدعاء دالة Dataverse. يوضح هذا المثال استخدام الدالة CCaaS_GetPresence Dynamics 365 Contact Center.
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 أمر
سرد واجهات برمجة التطبيقات القابلة للاكتشاف، مثل واجهات برمجة التطبيقات المخصصة ل Dataverse ونقاط نهاية خدمة ERP القابلة للاكتشاف. تظهر النتائج هوية واجهة برمجة التطبيقات والاسم المألوف والنوع والوصف عند توفرها. يمكنك تمرير مصطلح استعلام اختياري لتصفية النتائج.
api list البارامترات
| المعلمه | Description |
|---|---|
--target |
النظام الهدف للبحث: dataverse (افتراضي) أو erp. |
--service-group |
ERP فقط. تصفية إلى مجموعة خدمة واحدة. |
--service |
ERP فقط. تصفية إلى خدمة واحدة. |
--limit |
الحد الأقصى لعدد واجهات برمجة التطبيقات التي يجب إرجاعها. افتراضي: 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 البارامترات
| المعلمه | Description |
|---|---|
--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 الأمر .
| المعلمه | Description |
|---|---|
--environment، -env |
عنوان URL لبيئة Dataverse التي تريد المصادقة معها. |
--name، -n |
اسم اختياري لملف التعريف. استخدم الاسم لتحديد ملف التعريف لاحقا. |
--cloud، -ci |
السحابة المستهدفة: Publicأو UsGovUsGovHighأو 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 مخصص لاستخدامه بدلا من تطبيق Dataverse CLI الافتراضي. |
--no-default-environment |
لا تقم بتعيين البيئة كإعداد افتراضي. |
--accept-cleartext-caching |
السماح بذاكرة التخزين المؤقت للرمز المميز للنص العادي على 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 البارامترات
| المعلمه | Description |
|---|---|
--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 البارامترات
| المعلمه | Description |
|---|---|
--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 البارامترات
| المعلمه | Description |
|---|---|
--table، -t |
اسم مجموعة الكيانات للسجل الأساسي. مطلوب. |
--id، -i |
GUID للسجل الأساسي. مطلوب. |
--relationship، -rel |
اسم خاصية التنقل. مطلوب. |
--related |
اسم مجموعة الكيان للجدول ذي الصلة. مطلوب. |
--related-id |
المعرف الفريد العمومي للسجل ذي الصلة. مطلوب. |
--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 البارامترات
| المعلمه | Description |
|---|---|
--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 البارامترات
| المعلمه | Description |
|---|---|
--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 البارامترات
| المعلمه | Description |
|---|---|
--table، -t |
اسم مجموعة الكيان. مطلوب. |
--id، -i |
المعرف الفريد العمومي للسجل. |
--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 البارامترات
| المعلمه | Description |
|---|---|
--target |
الهدف: dataverse (افتراضي) أو erp. |
--table، -t |
مطلوب. بالنسبة إلى Dataverse، الاسم المنطقي، مثل account. بالنسبة إلى ERP، اسم مجموعة الكيان، مثل BatchJobs. |
--include |
قائمة مقاطع مفصولة بفواصل لتضمين: entityأو propertiesrelationsactions.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 البارامترات
| المعلمه | Description |
|---|---|
--table، -t |
اسم مجموعة الكيانات للسجل الأساسي. مطلوب. |
--id، -i |
GUID للسجل الأساسي. مطلوب. |
--relationship، -rel |
اسم خاصية التنقل. مطلوب. |
--related-id |
المعرف الفريد العمومي للسجل ذي الصلة، لعلاقة متعدد إلى متعدد. حذف هذه المعلمة لمسح بحث. |
--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 البارامترات
| المعلمه | Description |
|---|---|
--table، -t |
اسم مجموعة الكيان. مطلوب. |
--id، -i |
المعرف الفريد العمومي للسجل (المفتاح الأساسي). |
--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 البارامترات
| المعلمه | Description |
|---|---|
--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
معرفة المزيد
- استخدام OData للاستعلام عن البيانات
- الاستعلام عن البيانات باستخدام FetchXML في Dataverse
- استخدام SQL للاستعلام عن البيانات باستخدام واجهة برمجة تطبيقات ويب Dataverse
data update أمر
تحديث حقل واحد أو أكثر في سجل موجود، تم تعريفه بواسطة معرفه أو بواسطة مفتاح بديل. تعيين أعمدة البحث باستخدام @odata.bind بناء الجملة.
data update البارامترات
| المعلمه | Description |
|---|---|
--table، -t |
اسم مجموعة الكيان. مطلوب. |
--id، -i |
المعرف الفريد العمومي للسجل. |
--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 ميغابايت في طلب واحد، وتستخدم الملفات الأكبر حجما تحميلا مقسما. عند حذف --mime-type، يستنتج الأمر نوع MIME من ملحق الملف. ملحقات غير معروفة افتراضيا إلى application/octet-stream.
data upload البارامترات
| المعلمه | Description |
|---|---|
--table، -t |
مخطط الجدول أو الاسم المنطقي، مثل account. مطلوب. يحل الأمر مجموعة الكيان من بيانات التعريف. |
--id، -i |
المعرف الفريد العمومي للسجل. مطلوب. |
--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 البارامترات
| المعلمه | Description |
|---|---|
--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 للتمويل والعمليات تلقائيا من اتصال Dataverse الحالي.
erp batch list البارامترات
| المعلمه | Description |
|---|---|
--company |
تصفية حسب الكيان القانوني (dataAreaId)، مثل USMF. |
--status |
التصفية حسب الحالة: Waitingأو FinishedExecutingأو 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 أمر
يبدأ تشغيل خادم بروتوكول سياق النموذج (MCP) الذي يتصل بالبيئة الخاصة بك، بحيث يمكن لمساعدي الذكاء الاصطناعي مثل Claude Desktop التفاعل مع بياناتك. يتم الكشف عن الهدف تلقائيا من عنوان URL: يبدأ عنوان URL Dataverse خادم Dataverse MCP، ويبدأ عنوان URL للتمويل والعمليات، مثل https://myorg.operations.dynamics.com، خادم ERP MCP.
mcp بناء الجمله
dataverse mcp <orgUrl> [options]
الوسيطة <orgUrl> هي عنوان URL لمؤسستك، على سبيل المثال https://myorg.crm.dynamics.com.
mcp البارامترات
| المعلمه | Description |
|---|---|
--validate |
تحقق من صحة نقاط نهاية MCP وإعداد المصادقة دون بدء تشغيل الخادم. |
--log-level |
تعيين مستوى التسجيل: Traceأو Debugأو Informationأو WarningErrorأو أو .Critical افتراضي: Warning. |
--log-file |
سجل الدخول إلى ملف في الدليل المؤقت. |
--preview |
استخدم معاينة نقطة نهاية MCP (api/mcp_preview بدلا من api/mcp). غير مدعوم ل 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 البارامترات
| المعلمه | Description |
|---|---|
--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 البارامترات
| المعلمه | Description |
|---|---|
--filter |
تصفية قائمة البيئات حسب مصطلح بحث. |
--json |
إخراج JSON الخام. |
org list امثله
dataverse org list
dataverse org list --filter contoso
dataverse org list --json
org who أمر
إظهار معلومات حول المؤسسة والمستخدم الحاليين، باستخدام ملف تعريف المصادقة النشط.
env الأمر هو اسم مستعار ل org.
org who البارامترات
| المعلمه | Description |
|---|---|
--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 ملف وملفات الموارد الخاصة به) التي يستخدمها وكلاء الذكاء الاصطناعي - المخزنة في البيئة المتصلة. توفر أوامر المستوى skill الأعلى عمليات إنشاء وقراءة وتحديث وحذف مقابل البيئة. محليا، يتم تخزين المهارات ضمن .claude/skills/<name>/.
ملحوظة
أوامر تأليف المهارة وتقييمها، مثل makeو updategetو و evalمنفصلة عن هذه الأوامر. لمزيد من المعلومات، قم بتشغيل dataverse workspace skill --help.
skill delete أمر
حذف مهارة وكافة مواردها من بيئة Dataverse النشطة. استخدم skill list للعثور على أسماء فريدة للمهارة.
dataverse skill delete new_lead-qualification
skill download أمر
قم بتنزيل مهارات واحدة أو أكثر من بيئة Dataverse النشطة إلى القرص. يقوم الأمر بتنزيل SKILL.md الملف وجميع ملفات الموارد، مع الحفاظ على بنية الدليل. استخدم skill list للعثور على أسماء فريدة للمهارة.
| المعلمه | Description |
|---|---|
--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 المتصلة.
| المعلمه | Description |
|---|---|
--resources، -r |
قم أيضا بإدراج ملفات الموارد لكل مهارة. |
--json |
الإخراج ك JSON. حدد مسار ملف للكتابة إليه اختياريا. |
dataverse skill list
dataverse skill list --resources
skill upload أمر
تحميل مهارات واحدة أو أكثر من القرص إلى بيئة Dataverse النشطة. يدعم الأمر الدلائل وملفات .zip وملفات .skill وملفات .md .
يمكنك تمرير مهارة <name>، والتي تحل إلى .claude/skills/<name>/، أو صريحة <path> إلى دليل أو ملف.
| المعلمه | Description |
|---|---|
--all |
تحميل جميع المهارات ضمن .claude/skills/. لا يمكن دمجها مع اسم مهارة أو مسار. |
--json |
إخراج النتيجة ك JSON. حدد مسار ملف للكتابة إليه اختياريا. |
dataverse skill upload lead-qualification
dataverse skill upload ./my-skill.zip
dataverse skill upload --all