updateContext (مرجع واجهة برمجة تطبيقات العميل) (معاينة)

Important

• هذه ميزة إصدار أولي.
• ميزات الإصدار الأولي ليست مخصصة للاستخدام الإنتاجي وقد تكون لها وظيفة مقيدة. تخضع هذه الميزات لشروط الاستخدام التكميلية، وهي تتوفر قبل الإصدار الرسمي حتى يتمكن العملاء من الوصول المبكر وتقديم الملاحظات.

(معاينة) إرسال سياق التطبيق المحدث إلى اللوحة الجانبية Microsoft 365 Copilot.

إعراب

Xrm.Copilot.updateContext(context).then(successCallback, errorCallback);

Parameters

اسم المعلمة	النوع	مطلوب	الوصف
context	PowerAppsContent	‏‏نعم‬	كائن يصف سياق التطبيق الحالي لإرساله إلى اللوحة الجانبية Microsoft 365 Copilot.
successCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند نجاح العملية.
errorCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند فشل العملية.

القيمة المرجعة

نوع: Promise<void>

الملاحظات

تدمج واجهة برمجة التطبيقات تلقائيا حقول السياق الأساسية (appId، appType، ، orgId، geo). schemaVersion لا تحتاج إلى توفير هذه الحقول. لا تفعل واجهة برمجة التطبيقات أي شيء إذا لم يتم تمكين Microsoft 365 Copilot. لا يمكن للوكلاء الذين تؤلفهم استخدام السياق لتحسين استجاباتهم.

مثال

await Xrm.Copilot.updateContext({
    entity: "account",
    filterXML: "<fetch><entity name='account'><filter><condition attribute='statecode' operator='eq' value='0'/></filter></entity></fetch>"
});

المقالات ذات الصلة

PowerAppsContent
Xrm.Copilot (مرجع واجهة برمجة تطبيقات العميل)