استدعَاء إجرَاء لسَحب بيَانَات Dataverse for Teams

مكتمل

باستِخدَام عقدة استدعَاء إجرَاء، يمكن للمِندوبين التفَاعل مَع تدفقَات Power Automate. يمكنك استخدَام هذه التَدفُّقَات لتشغيل عمليَات تلقَائية أو الاتصَال ببيَانَات Dataverse for Teams، أو قوَائم Microsoft، أو مصَادر البيَانَات الأخرى.

عَلى سَبِيل المثَال، يمكن لمِندوبي Event Contacts توفِير أعضَاء فريق Sales Project مِن جدول Dataverse for Teams. بدلا مِن تحرير المِندوب عِند إجرَاء تغييرَات عَلى هذَا الفريق، يمكنك تَحدِيث الجدول.

الخطوة 1 - إنشَاء جدول Dataverse for Teams

لإنشَاء جدول Dataverse for Teams، اتبَع الخُطوَات التَالِية:

1. قم بإنشَاء جدول Dataverse for Teams جَديد فِي نفس الفريق مثل المِندوب. تذكر أنك ستحتَاج إلى إنشَائه باستِخدَام Power Apps ‏لـ Teams. فِي Power Apps for Teams، حدد علامة التبويب إنشَاء، ثم حدد فريقك.

2. لإظهَار قَائمة حلول الفريق، حدد رؤية الكل أسفل العنَاصر التي تم إنشَاؤهَا لـ [اسم فريقك]. تتضمِن قَائمة حلول الفريق جميع التَطبِيقَات وَالمِندوبين وَالتَدفُّقَات السحَابية وَالجدَاول ومَا إلى ذلك التي تم تضمينهَا فِي Dataverse for Teams للفريق المحدد. إذَا قمت بتَحديد نفس الفريق الذي أنشأت المِندوب Event Contacts فِيه، فسترَاه فِي قَائمة الحلول.

3. مِن شريط حل الفريق فِي الجزء العلوي، حدد جَديد>جدول.

قم بتسمية جدولك الجَديد باسم Sales Project Team، ثم حدد حفظ. الأعمدة وأنوَاع البيَانَات التي يجب استخدَامهَا هي عَلى النحو التَالِي:

العمود	نوع البيَانَات
الاسم	النَص
البريد الإلكتروني	البريد الإلكتروني

قبل المتَابعة إلى الخطوة التَالِية، ستحتَاج إلى ‏إضَافَة عمود البريد الإلكتروني إلى جدولك.

1. أضف صفوفًا جَديدة لكل جهة مِن جهَات الاتصَال الأربعة.

   الاسم	البريد الإلكتروني
   Joseph Price	JosephP@contoso.com
   Nathan Rigby	NathanR@contoso.com
   Amber Rodriguez	AmberR@contoso.com
   Monica Thomson	MonicaT@contoso.com

2. عِند الانتهَاء، ارجع إلى Microsoft Copilot Studio لـ Teams.

الخطوة 2 - إنشَاء موضوع المِندوب مَع خطوة الإجرَاء

لإضَافة إجرَاء، اتبع الخطوَات التَالِية:

1. فِي Microsoft Copilot Studio لـ Teams، حدد علامة تبويب برَامج المسَاعد مِن الشريط، ثم ابحث عن/حدد مِندوب Event Contacts لفتحه.

2. انتقِل إلى قَائمة الموَاضيع.

3. قم بإنشَاء موضوع جَديد عَن طريق تَحديد موضوع جَديد>مِن الفرَاغ مِن شريط الموَاضيع. حدد التفَاصيل مِن الشريط لتسمية الموضوع. أدخل "Sales Project Team" فِي الحقل الاسم.

4. حدد عبارَات التشغيل وأدخل كل ممَا يلي، ثم اضغط + بَعد كل إدخَال:

   sales project team

   sales project info

   sales team info

   sales project members

   sales project info

5. فِي لوحة التأليف دَاخل عقدة الرسَالة، أدخل:

   Let me look up the Sales Project Team!

6. الآن، حدد الزر حفظ مِن الشريط لحفظ الموضوع لديك. قد يتم فقدَان أي تغييرَات لم تقم بحفظهَا فِي هذه المرحلة عِند التبديل إلى Power Automate لإنشَاء التَدفُّق.

7. أضف عقدة جَديدة بَعد عقدة الرسَالة، ثم حدد استدعَاء إجرَاء > إنشَاء تدفق. قد يعرض Copilot Studio لك مربع خيَار لتذكيرك بحفظ موضوعك قبل التخلي. إذَا قمت بحفظه بالفعل، فحدد مغَادرة. يؤدي هذَا الإجرَاء إلى فتح استوديو Power Automate دَاخل Copilot Studio.

   هنَاك بعض القوَالب الشَائعة المتَاحة للاختيَار مِن بينهَا عَلى الفور. يسمح لك كل قَالب بتمرير المعلومَات إلى سير العَمَل عِند تشغيله. ويمكنه تمرير المعلومَات مرة أخرى إلى المِندوب مَع انتهَاء التَدفُّق. يمكنك تَحديد عرض المزيد مِن القوَالب إذَا كنت تريد الاطلاع عَلى المزيد مِن خيَارَات القوَالب. تشمل بعض الملاحظَات مَا يلي:

   قَالبُ سَير عَمَل Copilot Studio - يَحتَوي هَذَا القَالبُ عَلى خطوَات تلقي المَعلومَات ويرسلهَا إلى المِندوب وحسب.

   إرسَال رسَالةٍ إلى قَنَاةِ Teams - شَغِّل رَسَالةَ Teams مِن المِندوب.

   إرسَالُ بطَاقة موَائمة مفتوحة إلى قَنَاةِ Teams - شَغِّل بِطَاقةً قَابلةً للمُوَاءمةِ لتَوفِيرِ المَعلومَات فِي قَنَاةِ Teams.

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

9. أعد تسمية سير العَمَل إلى Get Sales Team Members.

10. قم بإنشَاء متغير للاحتفَاظ بالمعلومَات التي تريد تقديمهَا إلى المِندوب. بين المشغل وخطوة قيمة الإرجَاع، حرك المؤشر إلى السهم وحدد أيقونة إدرَاج خطوة جَديدة التي تظهر عِند التمرير فِي تلك المسَاحة وحدد ‏إضَافَة إجرَاء.

11. فِي مربع البحث، أدخل "متغير"، ثم ضمِن الإجرَاءَات، حدد تهيئة المتغير.

12. أدخل "varContactInfo" لـ الاسم ثم حدد السلسلة للنوع. اترك القيمة فَارغة.

13. نحتَاج الآن إلى خطوة للوصول إلى البيَانَات مِن Dataverse مِن Teams. ضمِن الخطوة تهيئة المتغير الجَديدة، حدد الأيقونة إدرَاج خطوة جَديدة وحدد ‏إضَافَة إجرَاء. ابحث عَن مُوصِّل Microsoft Dataverse ثم حدد صفوف القَائمة كمشغّل.

14. للحصول عَلى اسم الجدول، حدد Sales Project Team مِن القَائمة المِنسدلة. (يمكنك إدخَال "sales" فِي حقل الإدخَال لتصفِية القَائمة بسرعة).

    يسحب إجرَاء صفوف القَائمة جميع صفوف الجدول إلى مصفوفة. الصفِيف عبارة عَن جدول. لإضَافة بيَانَات إلى متغير السلسلة الخَاص بنَا، عليك مرَاجعة كل صف مِن الجدول و‏إضَافَة كل صف مِن البيَانَات إلى متغير varContactInfo الخَاص بك. هذه هي الطريقة التي سنمرر بهَا هذه البيَانَات مرة أخرى إلى Microsoft Copilot Studio.

15. حدد الأيقونة إدرَاج خطوة جَديدة بَعد صفوف القَائمة. حدد ‏إضَافَة إجرَاء.

16. فِي مربع البحث، أدخل Control، ثم ضمِن الإجرَاءَات، حدد تَطبِيق عَلى كل مِنهَا.

17. فِي الحقل تَحديد مخرجَات مِن الخطوَات السَابقة، حدده لإضَافة محتوى دينَاميكي. ثم حدد القيمة مِن ضمِن الإجرَاء صفوف قَائمة Dataverse.

18. حدد ‏إضَافَة إجرَاء ضمِن خطوة تَطبِيق عَلى كل للمتَابعة.

19. فِي مربع البحث اختيَار وتشغيل، أدخل متغيرًا، ثم ضمِن الإجرَاءَات، حدد إلحَاق بمتغير السلسلة.

20. فِي خطوة إلحَاق بمتغير الصفِيف، حدد varContactInfo لـ الاسم.

21. بالنسبة لـ القيمة، سنقوم بإنشَاء قَائمة ذَات تعدَاد نقطي متعدد الأسطر (كبيَانَات سلسلة) تحتوي عَلى الاسم وَالبريد الإلكتروني لكل شخص. يستخدم Power Automate سيَاق Markdown عِند تنسيق النَص. تحتَاج إلى استخدَام حرف النجمة * فِي بدَاية السطر، للإشَارة إلى قَائمة ذَات تعدَاد نقطي فِي Markdown. (رَاجع قسم "ملخص‬" فِي نهَاية هَذه الوحدَة، لبيَان المزيد حول Markdown).

    فِي المربع النَصي القيمة:

    1. أدخل علامة نجمية * ثم أضف مسَافة.

    2. ضمِن المحتوى الدينَاميكي صفوف القَائمة، حدد الاسم ثم أضف مسَافة.

    3. ضمِن المحتوى الدينَاميكي صفوف القَائمة، حدد البريد الإلكتروني.

    4. اضغط عَلى المفَاتيح Enter لبدء سطر جَديد.

       لقد انتهينَا مِن هذه الخطوة.

22. حدد الخطوة إرجَاع القيمة (القيم) Microsoft Copilot Studio فِي أسفل التَدفُّق، ثم حدد + ‏إضَافَة مخرجَات.

23. حدد نَص كنوع الإخرَاج.

24. فِي مربع النَص أدخل العنوَان، أدخل ContactData.

25. بالنسبة إلى الحقل إدخَال القيمة للاستجَابة، حدد حقل الإدخَال ثم حدد varContactInfo ضمِن قسم المتغيرَات.

    يجب أن يشبه تدفقك الآن الصورة التَالِية:

    

26. حدد حفظ مِن شريط Power Automate لإنهَاء تحرير التَدفُّق. يقوم Power Automate تلقَائيًا بتشغيل مدقق التَدفُّق للبحث عَن المشكلات. قد ترى تحذيرًا بشأن "... استعلامَات عَامل تصفِية OData..." ولكن يمكنك تجَاهل ذلك. يمكنك استخدَام عوَامل تصفِية OData للحد مِن البيَانَات التي تسحبهَا خطوة صفوف القَائمة الخَاصة بك، ولكن لدينَا عدد قليل مِن الصفوف فِي مصدر البيَانَات لدينَا لذَا فإن عَامل التصفِية غير ضروري. حدد إغلاق للخروج مِن Power Automate وَالرجوع إلى محرر المِندوب.

27. ارجع إلى محرر المِندوب الخَاص بك، وَانظر إلى خطوة الإجرَاء. يجب أن ترى سير العَمَل الذي أنشأته للتو: Get Sales Team Members كإجرَاءٍ، ومتغير سلسلة ContactData الذي قمت بإنشَائه مدرجًا كمخرجَاتٍ.

28. أضف خطوة إظهَار رسَالة بَعد عقدة الإجرَاء.

29. انقر دَاخل المربع النَصي لإظهَار القَائمة. حدد ContactData ضمِن إدرَاج المتغير {X}.

30. حدد حفظ مِن شريط تحرير الموضوع وَانتظر حتى يتم حفظ الموضوع. إذَا لم تكن لوحة روبوت الاختبار مرئيةً، فحدد خيَار القَائمة اختبار روبوت المحَادثة الخَاص بك.

31. فِي الجزء العلوي مِن لوحة اختبار روبوت المحَادثة، تأكد مِن تشغيل خيَار التتبع بين الموَاضيع.

32. أدخل إحدى عبارَات التَشغِيل لاختبار مِندوب Sales Project Team الخَاص بك. سيقدم لك مِندوب الاختبار قَائمةً نقطيةً تحتوي عَلى أربعة أسمَاء وعنَاوين بريدٍ إلكتروني لSales Project Team الخَاص بك.

تهَانينَا! قمت الآن بإنشَاء طريقة للمِندوب الخَاص بك للوصول إلى المعلومَات مِن جدَاول البيَانَات عبر سَير عَمل Power Automate المتكَامل.