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

إرسال سياق التطبيق المحدث إلى اللوحة الجانبية 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 (مرجع واجهة برمجة تطبيقات العميل)