مشاركة عبر

التكامل مع Power Platform وLogic Apps باستخدام موصل Azure Digital Twins

  • مقالة

يمكنك دمج Azure Digital Twins في تدفق Microsoft Power Platform أو Azure Logic Apps ، باستخدام موصل Azure Digital Twins Power Platform.

الموصل عبارة عن برنامج تضمين حول واجهات برمجة تطبيقات مستوى بيانات Azure Digital Twins لعمليات التوأم والنموذج والاستعلام، مما يسمح للخدمة الأساسية بالتحدث إلى Microsoft Power AutomateوMicrosoft Power AppsوAzure Logic Apps. يوفر الموصل طريقة للمستخدمين لتوصيل حساباتهم والاستفادة من مجموعة من الإجراءات التي تم إنشاؤها مسبقا لإنشاء تطبيقاتهم ومهام سير العمل الخاصة بهم.

للحصول على مقدمة إلى الموصل، بما في ذلك عرض توضيحي سريع، شاهد فيديو عرض IoT التالي:

يمكنك أيضا إكمال معاينة أساسية في منشور المدونة تبسيط إنشاء مهام سير عمل وتطبيقات تلقائية مدعومة من Azure Digital Twins. لمزيد من المعلومات حول الموصل، بما في ذلك قائمة كاملة بإجراءات الموصل ومعلماته، راجع الوثائق المرجعية لموصل Azure Digital Twins.

المتطلبات الأساسية

إذا لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانياً قبل أن تبدأ. سجل الدخول إلى مدخل Microsoft Azure باستخدام حسابك.

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

بعد إعداد المثيل الخاص بك، قم بتدوين اسم مضيف المثيل. يمكنك العثور على اسم المضيف في بوابة Azure.

وأخيرا، ستحتاج إلى إعداد أي خدمات Power Platform حيث تريد استخدام الموصل.

إعداد الموصل

بالنسبة إلى Power Automate وPower Apps، قم بإعداد الاتصال أولا قبل إنشاء تدفق. اتبع الخطوات أدناه لإضافة الاتصال في Power Automate وPower Apps.

  1. حدد Connections من قائمة التنقل اليسرى (في Power Automate، إنه ضمن عنوان البيانات ). في صفحة Connections، حدد + New connection.
  2. ابحث عن Azure Digital Twins، وحدد موصل Azure Digital Twins (إصدار أولي).
  3. حيث يطلب الموصل اسم مثيل ADT، أدخل اسم المضيف للمثيل الخاص بك.
  4. أدخل تفاصيل المصادقة عند الطلب لإنهاء إعداد الاتصال.
  5. للتحقق من إنشاء الاتصال، ابحث عنه في صفحة الاتصالات. لقطة شاشة ل Power Automate، تعرض اتصال Azure Digital Twins في صفحة الاتصالات.

بالنسبة إلى Logic Apps، يمكنك استخدام الاتصال المضمن في Azure Digital Twins عند إنشاء تدفق في القسم التالي. لمزيد من المعلومات حول الموصلات المضمنة، راجع الموصلات المضمنة في Azure Logic Apps.

إنشاء تدفق

يمكنك دمج Azure Digital Twins في تدفقات Power Automate أو تدفقات Logic Apps أو تطبيقات Power Apps. باستخدام موصل Azure Digital Twins وأكثر من 700 موصل Power Platform آخر، يمكنك استيعاب البيانات من أنظمة أخرى في التوائم الخاصة بك، أو الاستجابة لأحداث النظام.

اتبع الخطوات أدناه لإنشاء تدفق عينة باستخدام الموصل في Power Automate.

  1. في Power Automate، حدد تدفقاتي من قائمة التنقل اليسرى. حدد + تدفق جديدوتدفق سحابة فوري.
  2. أدخل اسم التدفق وحدد تشغيل تدفق يدويا من قائمة المشغلات. إنشاء التدفق.
  3. أضف خطوة إلى التدفق، وابحث عن Azure Digital Twins للعثور على الاتصال. حدد اتصال Azure Digital Twins. لقطة شاشة ل Power Automate، تعرض موصل Azure Digital Twins في تدفق جديد.
  4. سترى قائمة بجميع الإجراءات المتوفرة مع الموصل. اختر أحدها للتفاعل مع واجهات برمجة تطبيقات Azure Digital Twins. لقطة شاشة ل Power Automate، تعرض جميع الإجراءات لموصل Azure Digital Twins.
  5. يمكنك الاستمرار في تحرير أو إضافة المزيد من الخطوات إلى سير العمل الخاص بك، باستخدام موصلات أخرى لإنشاء سيناريو التكامل الخاص بك. لقطة شاشة ل Power Automate، تعرض إجراء Get twin by ID من موصل Azure Digital Twins في التدفق.

اتبع الخطوات أدناه لإنشاء تدفق عينة باستخدام الموصل في Power Apps.

  1. في Power Apps، حدد + Create من قائمة التنقل اليسرى. حدد Blank app واتبع المطالبات لإنشاء تطبيق جديد.
  2. في منشئ التطبيق، حدد البيانات من قائمة التنقل اليسرى. حدد Add data وابحث عن Azure Digital Twins للعثور على اتصال البيانات. حدد اتصال Azure Digital Twins. لقطة شاشة ل Power Apps، تعرض موصل Azure Digital Twins كمصدر بيانات.
  3. الآن، ستكون الإجراءات من موصل Azure Digital Twins متاحة كوظائف لاستخدامها في تطبيقك. لقطة شاشة ل Power Apps، تعرض إجراء Get twin by ID المستخدم في وظيفة.
  4. يمكنك الاستمرار في إنشاء التطبيق الخاص بك مع الوصول إلى بيانات Azure Digital Twins. لمزيد من المعلومات حول إنشاء Power Apps، راجع نظرة عامة حول إنشاء التطبيقات في Power Apps.

اتبع الخطوات أدناه لإنشاء تدفق عينة مع الموصل في Logic Apps.

  1. انتقل إلى تطبيق المنطق الخاص بك في مدخل Microsoft Azure. حدد Workflows من قائمة التنقل اليسرى، و + Add. اتبع المطالبات لإنشاء سير عمل جديد.
  2. حدد التدفق الجديد وأدخل في Designer.
  3. أضف مشغلا إلى تطبيقك.
  4. حدد اختيار عملية لإضافة إجراء من موصل Azure Digital Twins. ابحث عن Azure Digital Twins في علامة التبويب Azure للعثور على اتصال البيانات. حدد اتصال Azure Digital Twins. لقطة شاشة ل Logic Apps، تعرض موصل Azure Digital Twins.
  5. سترى قائمة بجميع الإجراءات المتوفرة مع الموصل. اختر أحدها للتفاعل مع واجهات برمجة تطبيقات Azure Digital Twins.
  6. بعد تحديد إجراء من موصل Azure Digital Twins، سيطلب منك إدخال تفاصيل المصادقة لإنشاء الاتصال.
  7. يمكنك الاستمرار في تحرير أو إضافة المزيد من الخطوات إلى سير العمل الخاص بك، باستخدام موصلات أخرى لإنشاء سيناريو التكامل الخاص بك.

القيود والاقتراحات

فيما يلي بعض قيود الموصل واقتراحات العمل معها.

  • تتطلب بعض إجراءات الموصل (مثل إضافة نموذج) إدخالا في شكل سلسلة حرفية تبدأ ب @. في هذه الحالات، قم بإلغاء @ الحرف باستخدام @@ بدلا من ذلك. سيؤدي ذلك إلى منع تفسير القيمة الحرفية على أنها تعبير JSON.
  • نظرا لأن Azure Digital Twins يتعامل مع استجابات المخطط الديناميكي، يجب تحليل JSON المستلم من واجهات برمجة التطبيقات قبل استهلاكه في التطبيق الخاص بك. على سبيل المثال، إليك مجموعة من الاستدعاءات التي تحلل البيانات قبل استخراج dtId القيمة: Set(jsonVal, AzureDigitalTwins.GetTwinById("your_twin_id").result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));.

الخطوات التالية

لمزيد من المعلومات حول موصلات Power Platform، بما في ذلك كيفية استخدامها في مهام سير العمل عبر منتجات متعددة، راجع وثائق موصلات Power Platform وAzure Logic Apps.