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

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

إعراب

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

Parameters

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

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

نوع: Promise<void>

الملاحظات

تدمج واجهة برمجة التطبيقات تلقائيا حقول السياق الأساسية (appId، appType، ، orgId، geo). schemaVersion لا تحتاج إلى توفير هذه الحقول. لا تفعل واجهة برمجة التطبيقات أي شيء إذا لم يتم تمكين Microsoft 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 (مرجع واجهة برمجة تطبيقات العميل)