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

  • 9 دقائق

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

على سبيل المثال، يمكن لبرنامج المساعد جهات اتصال الحدث توفير أعضاء فريق مشروع المبيعات من جدول Dataverse for Teams. بدلاً من تحرير المساعد عند إجراء تغييرات على هذا الفريق، يمكنك تحديث الجدول.

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

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

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

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

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

    لقطة شاشة لعلامة تبويب الإنشاء مع تحديد قائمة وجدول جديدين.

    قم بتسمية جدولك الجديد باسم فريق مشروع المبيعات، ثم حدّد حفظ. الأعمدة وأنواع البيانات التي يجب استخدامها هي على النحو التالي:

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

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

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

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

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

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

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

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

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

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

  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.

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

    قالب تدفق Power Virtual Agents - يحتوي هذا القالب فقط على خطوات تلقي المعلومات وإرسالها إلى المساعد.

    إرسال رسالة إلى قناة Teams - قم بتشغيل رسالة Teams من المساعد.

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

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

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

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

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

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

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

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

    يسحب إجراء صفوف القائمة جميع صفوف الجدول إلى مصفوفة. الصفيف عبارة عن جدول. لإضافة بيانات إلى متغير السلسلة الخاص بنا، عليك مراجعة كل صف من الجدول وإضافة كل صف من البيانات إلى متغير varContactInfo الخاص بك. هذه هي الطريقة التي سنمرر بها هذه البيانات مرة أخرى إلى Power Virtual Agents.

  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 ضمن قسم المتغيرات.

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

    لقطة شاشة لتدفق Get Sales Team Members.

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

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

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

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

  30. حدّد حفظ من شريط تحرير الموضوع وانتظر حتى يتم حفظ الموضوع. إذا لم يكن جزء روبوت الاختبار مرئياً، فحدّد خيار قائمة روبوت الاختبار.

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

  32. أدخل إحدى عبارات التشغيل لاختبار Sales Project Team. سيوفر برنامج الدردشة الآلي الخاص بك قائمة ذات تعداد نقطي بالأسماء الأربعة وعناوين البريد الإلكتروني لـ Sales Project Team الخاص بك.

    لقطة شاشة لموضوع Sales Project Team.

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