استخدام قاموس التنفيذ التلقائي لتمرير مفاتيح المعلمات

يحتفظ قاموس التنفيذ التلقائي بالبيانات السياقية لجلسات العمل. يمكنك استخدام المفاتيح من قاموس التنفيذ التلقائي لتمرير المعلمة في إجراء.

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

تمرير معلمة البيانات في القوالب

لنتعرف على سيناريو للقوالب مع الإعلامات.

يعرض الإعلام حقول وقيم معينة، والتي تسمى رأس الحقل والقيمة على التوالي.

بدأ كينني سميث، وهو عميل، محادثه وعندما يرى المندوب الإعلام، فإنه يعرض اسم العميل على أنه كينني سميث.

وهنا رأس الحقل هو اسم العميل والقيمة هي كينني سميث.

بالنسبة للقوالب لتحديد اسم العميل على أنه كيني سميث، يجب عليك (المسؤول) تمرير المعلمة كمفاتيح.

بالمثل، بالنسبة لعناوين جلسات العمل والإعلامات، يمكنك تمرير معلمات البيانات. لمعرفه المزيد من المعلومات، راجع تنسيقات قاموس التنفيذ التلقائي لمفاتيح معلمات البيانات.

يقوم النظام باستبدال مفاتيح المعلمات بالقيم الفعلية استنادا إلى سياق جلسة العمل، وموفر القنوات، وMicrosoft Dataverse، وإجراءات المستخدم. لمعرفه المزيد من المعلومات، راجع أنواع معلمات بيانات السياق.

تمرير معلمة البيانات في وحدات الماكرو والبرامج النصية للمندوبين

وحدات الماكرو هي مجموعة من الإجراءات المتسلسلة المكونة والتي يتم تشغيلها حسب الطلب من قبل المستخدم. وكمسؤول، يتعين عليك تكوين الإجراءات التي يجب أن ينفذها ماكرو. لتكوين الإجراءات، يتعين عليك تمرير معلمات البيانات. لمعرفة المزيد من المعلومات: راجع تنسيقات قاموس التنفيذ التلقائي لتمرير مفاتيح معلمات البيانات.

عندما يقوم المندوب بتشغيل الماكرو، يقوم النظام باستبدال مفاتيح المعلمات بالقيم الفعلية استنادا إلى سياق جلسة العمل، وموفر القنوات، وDataverse، وإجراءات المستخدم.

عندما يكون السياق من جلسة عمل، يتم تشغيل اجراء الماكرو بالاستناد إلى المعلومات الخاصة بجلسة العمل الحالية، حيث يتم الحصول على المعلومات من علامة تبويب الارتساء‬ أو علامة التبويب الحالية قيد التركيز. على سبيل المثال، لإنشاء حالة، تحتاج إلى تعريف الإجراءات التي تحتوي على نموذج كيان الحادث وGUID للنموذج (اختياري). لمعرفه المزيد من المعلومات، راجع أنواع معلمات بيانات السياق.

أنواع معلمات بيانات السياق

يستخدم قاموس التنفيذ التلقائي معلمات بيانات السياق المتوفرة من المصادر التالية:

• بيانات السياق من موفر القنوات
• بيانات السياق من إجراءات المستخدم
• بيانات السياق من Dataverse
• بيانات السياق من إجراءات الماكرو

بيانات السياق من موفر القنوات

وتكون بيانات السياق هذه من موفر القنوات التابعة للجهات الخارجية مثل القناة متعددة الاتجاهات لـ Customer Service أو موفر قنوات جهة خارجية يستخدم عنصر واجهة مستخدم معروض بواسطة إطار عمل تكامل قنوات Dynamics 365. بيانات السياق من القناة متعددة الاتجاهات لـ Customer Service هي استطلاع ما قبل المحادثة والتنقل في مدخل الزوار وهكذا.

بيانات السياق من إجراءات المستخدم

يتم ملء هذه البيانات وعندما يقوم المندوبون بتنفيذ بعض الانشطه في جلسة العمل. على سبيل المثال، فتح سجل عميل جديد والحالة وهكذا.

بيانات السياق من Dataverse

يتم تخزين البيانات التنظيمية في Dataverse، ويمكنك إحضار البيانات باستخدام استعلامات OData. لمزيد من المعلومات، راجع استعلامات OData.

بيانات السياق من إجراءات الماكرو

يُنشئ إجراء في ماكرو بيانات سياق تستخدمها إجراءات أخرى في هذا الماكرو.

على سبيل المثال، هناك خطوتان للإجراءات بالترتيب التالي:

1. فتح نموذج جديد لإنشاء سجل.
2. افتح نموذج بريد إلكتروني بقالب معرّف مسبقًا.

أثناء إنشاء إجراء فتح نموذج بريد إلكتروني بقالب معرّف مسبقًا‬، يمكنك الحصول علي مفاتيح معلمات بيانات السياق من خطوة إجراء ماكرو فتح نموذج جديد لإنشاء سجل‬.

فيما يلي معلمة بيانات السياق من إجراء الماكرو الأول:

• الاسم المنطقي للكيان
• نوع الصفحة
• معرّف علامة التبويب

‏‫ملاحظة‬

تكون معلمات بيانات السياق من إجراءات الماكرو الأخرى محددة لوحدات الماكرو، ولا يمكن تطبيقها على القوالب.

تنسيقات قاموس التنفيذ التلقائي لتمرير مفاتيح معلمات البيانات

يحتفظ قاموس التنفيذ التلقائي بالبيانات السياقية لجلسات العمل. يمكن تمرير المفاتيح الموجودة في قاموس التنفيذ التلقائي كمعلمات للإجراء في وحدات الماكرو. يستبدل النظام مفاتيح المعلمات هذه بالقيمة الفعلية بناءً على سياق الجلسة وموفر القناة وDataverse وإجراءات المستخدم.

يدعم قاموس التنفيذ التلقائي التنسيقات التالية:

• حقول احتياطي البريد الإلكتروني
• استعلامات OData
• قيم ثابتة

حقول احتياطي البريد الإلكتروني

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

حقول احتياطي البريد الإلكتروني للأدوات الإنتاجية (وحدات الماكرو والبرامج النصية للمندوبين)

تدعم وحدات الماكرو والبرامج النصية للمندوب احتياطات البريد الإلكتروني التالية:

حقل احتياطي البريد الإلكتروني	‏‏الوصف
${customerName}	اسم العميل الذي بدأ المحادثة.
${caseId}	المعرّف الفريد للحالة. يعرض النظام معرف الحالة فقط إذا كانت الحالة مرتبطة بالمحادثة.
${caseTitle}	عنوان الحالة. يعرض النظام عنوان الحالة فقط إذا كانت الحالة مرتبطة بالمحادثة.
${LiveWorkItemId}	المعرف الفريد للمحادثة.
${queueId}	المعرّف الفريد لقائمة الانتظار. يتم عرض هذه السلسلة الأبجدية الرقمية في عنوان URL لصفحة قائمة الانتظار.
${visitorLanguage}	لغة العميل الذي بدأ المحادثة.
${visitorDevice}	جهاز العميل الذي بدأ المحادثة.
${entityRoutingLogicalName}	اسم الكيان، في حالة ما إذا كان الإعلام لسجل كيان.
${customerEntityName}	اسم الكيان (جهة الاتصال أو العميل)، إذا تمت مصادقة العميل.
${customerRecordId}	المعرف الفريد للكيان (جهة الاتصال أو العميل)، إذا تمت مصادقة العميل.
${<name of the pre-conversation survey questions>}	ستحمل جميع أسئلة استطلاع ما قبل المحادثة التي تم تكوينها لمسار العمل اسم الارتباط التقريبي باعتباره اسم السؤال.

‏‫ملاحظة‬

وحده حقل احتياطي البريد الإلكتروني في ${anchor.<attribute_name>} مدعوم في وحدات الماكرو أو البرامج النصية في Customer Service workspace.

حقل احتياطي البريد الإلكتروني لارتباط إعادة الاتصال

يستخدم حقل احتياطي البريد الإلكتروني التالي في إنشاء ارتباط إعادة الاتصال الذي يمكن مشاركته مع العملاء للاتصال بنفس العميل والمحادثة. مزيد من المعلومات: تكوين إعادة الاتصال على محادثة سابقة

حقل احتياطي البريد الإلكتروني	‏‏الوصف
{ReconnectUrl{ReconnectID}}	يُستخدم في الردود السريعة لإنشاء ارتباط إعادة الاتصال.

تنسيق حقول احتياطي البريد الإلكتروني لأدوات الإنتاجية

تنسيق المعلمة ${Slug} الذي يسترد السياق من موفر القناة أو جلسة عمل المستخدم الحالية أو إخراج إجراءات الماكرو الأخرى أو Dataverse.

سياق التنفيذ التلقائي للإنتاجية

عندما تريد تنفيذ حقل احتياطي البريد الإلكتروني في سياق أتمتة الإنتاجية، والذي يستخدم لتنفيذ العمليات المتعلقة بالتطبيقات التي تستند إلى النموذج في Dynamics 365، استخدم التنسيق ${</slug/>} على سبيل المثال: ${customerName}

سياق موصل جلسة العمل

عندما تريد تنفيذ حقل احتياطي البريد الإلكتروني في سياق جلسة العمل، يجب أن تستخدم تنسيق ${$session.<slug>}. على سبيل المثال: ${$session.customerName}

تشمل ‏‫حقول احتياطي البريد الإلكتروني المتوفرة لسياق الجلسة ما يلي:

• ${$session.visitorDevice}
• ${$session.visitorDevice}
• ${$session.entityRoutingLogicalName}
• ${$session.entityRoutingRecordId}
• ${$session.<name of the pre-chat survey questions>

سياق موصل القناة متعددة الاتجاهات

عندما تريد تنفيذ حقل احتياطي بريد إلكتروني في سياق القناة متعددة الاتجاهات لـ Customer Service، يجب أن تستخدم تنسيق ${$oc.<slug>}. على سبيل المثال: ${$oc.customerName}

توفر معلمتا Session.CurrentTab.<Attribute> وSession.AnchorTab.<Attribute> بيانات سياق استنادًا إلى جلسة العمل الحالية وعلامة التبويب الخاصة بالإرساء أو علامة التبويب الحالية في التركيز البؤري. فيما يلي أنواع السمات المدعومة:

• EntityName
• EntityId

أمثلة:

• Session.CurrentTab.<EntityName>
• Session.CurrentTab.<EntityId>
• Session.AnchorTab.<EntityName>
• Session.AnchorTab.<EntityId>

‏‫ملاحظة‬

يمكن تطبيق معلمتي Session.CurrentTab.<Attribute> وSession.AnchorTab.<Attribute> فقط على وحدات الماكرو ولا يمكن تطبيقها على القوالب.

حقول احتياطي البريد الإلكتروني للقوالب

فيما يلي قائمة بحقول احتياطي البريد الإلكتروني المدعومة:

حقل احتياطي البريد الإلكتروني	الوصف
{anchor.<attribute_name>}	يتم استخدامه للوصول إلى سمات السجل الذي تم تحميله في علامة تبويب الارتساء.
{customerName}	اسم العميل الذي بدأ المحادثة.
{caseId}	المعرّف الفريد للحالة. يعرض النظام معرف الحالة فقط إذا كانت الحالة مرتبطة بالمحادثة.
{caseTitle}	عنوان الحالة. يعرض النظام عنوان الحالة فقط إذا كانت الحالة مرتبطة بالمحادثة.
{queueId}	المعرّف الفريد لقائمة الانتظار. يتم عرض هذه السلسلة الأبجدية الرقمية في عنوان URL لصفحة قائمة الانتظار.
{visitorLanguage}	لغة العميل الذي بدأ المحادثة.
{visitorDevice}	جهاز العميل الذي بدأ المحادثة.
{entityRoutingLogicalName}	اسم الكيان، في حالة ما إذا كان الإعلام لسجل كيان.
{entityRoutingRecordId}	المعرف الفريد لسجل الكيان، في حالة ما إذا كان الإعلام لسجل كيان.
{customerRecordId}	المعرف الفريد للكيان (جهة الاتصال أو العميل)، إذا تمت مصادقة العميل.
{<name of the pre-chat survey questions>}	سيكون لكافة أسئله استطلاع ما قبل الدردشة التي تم تكوينها لتدفق عمل اسم حقل احتياطي البريد الإلكتروني كاسم للسؤال.

تنسيق حقول احتياطي البريد الإلكتروني للقوالب

تنسيق المعلمة {Slug} الذي يسترد سياق القالب من موفر القناة أو جلسة عمل المستخدم الحالية أو Dataverse. على سبيل المثال: {caseId}

استعلامات OData

يمكنك استخدام استعلامات OData للحصول على السياقات المتوفرة من Dataverse.

يكون تنسيق استعلام OData كالتالي:

{$odata.<entityName>.<entityAttributeName>.<?options>}

أمثلة:

• {$odata.account.name.?$filter=accountid eq '{customerRecordId}'}
• {$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}
• {$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}

قيم ثابتة

هذه هي القيم ذات الترميز الثابت التي تقوم بتحديثها بناءً على متطلبات عملك. لكل سمة مضمنة في الترميز الثابت تختارها، اتبع نوع التنسيق للسمة المعينة.

مثال (الماكرو):

وترغب في إلحاق عنوان الحالة بشكل دائم بشركة Contoso -. يمكنك استخدام إجراء فتح نموذج جديد لإنشاء سجل مع الحقول التالية.

المعلمة‬	القيمة
الاسم المنطقي للكيان	الحادث
اسم السمة	عنوان الحالة
قيمة السمة	Contoso - {caseTitle}

هنا، Contoso - هي القيمة الثابتة التي تستند إلى البرمجة الثابتة.

مثال (القوالب):

بالنسبة لطلب المحادثة الوارد، فإنك ترغب في توفير العنوان الثابت لجلسة العمل وقالب الإعلام التي يظهر المندوبون فيها في وقت التشغيل.

عنوان الإعلام = New chat request

عنوان جلسة العمل = Chat conversation

راجع أيضًا

إدارة قوالب جلسات العمل
إدارة قوالب علامات تبويب التطبيق
إدارة قوالب الإعلامات
إقران القوالب بعمليات تدفق العمل