بدء التشغيل السريع - ابدأ مع سيناريو عينة في Azure Digital Twins Explorer

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

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

فيما يلي الخطوات التي ستستخدمها لاستكشاف الرسم البياني في هذه المقالة:

1. إنشاء مثيل Azure Digital Twins، وفتحه في Azure Digital Twins Explorer.
2. تحميل النماذج التي تم إنشاؤها مسبقا وبيانات الرسم البياني لإنشاء سيناريو العينة. أضف توأما آخر يدويا.
3. محاكاة تغيير بيانات IoT، والاستعلام عن الرسم البياني لمشاهدة النتائج.
4. راجع ما تتعلمه من التجربة.

إشعار

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

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

ستحتاج إلى اشتراك Azure لإكمال بدء التشغيل السريع هذا. في حالة عدم امتلاك حساب، إنشاء حساب مجاني.

ستحتاج أيضًا إلى تنزيل المواد الخاصة بالرسم البياني للعينة المستخدمة في بدء التشغيل السريع. استخدم الإرشادات أدناه لتنزيل الملفات المطلوبة. لاحقا، ستتبع المزيد من التعليمات لتحميلها إلى Azure Digital Twins.

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

  • Building.json: هذا ملف نموذج يعرف المبنى رقميا. وهو يحدد أن المباني يمكن أن تحتوي على طوابق.
  • Floor.json: هذا ملف نموذج يعرف الكلمة رقميا. وهو يحدد أن الطوابق يمكن أن تحتوي على غرف.
  • Room.json: هذا ملف نموذج يعرف غرفة رقميا. لديها خاصية درجة الحرارة.

• buildingScenario.xlsx: يحتوي جدول البيانات هذا على بيانات نموذج رسم بياني مزدوج، بما في ذلك خمسة توائم رقمية تمثل مبنى معينا به أرضيات وغرف. تستند التوائم إلى النماذج العامة، وترتبط بالعلاقات التي تشير إلى العناصر التي تحتوي على بعضها البعض. استنادا إلى إعدادات المستعرض، قد يؤدي تحديد هذا الارتباط إلى تنزيل ملف buildingScenario.xlsx تلقائيا إلى موقع التنزيل الافتراضي، أو قد يفتح الملف في المستعرض مع خيار التنزيل. إليك ما يبدو عليه خيار التنزيل هذا في Microsoft Edge:

  

تلميح

هذه الملفات من مستودع Azure Digital Twins Explorer في GitHub. يمكنك زيارة المستودع للحصول على نماذج أخرى من الملفات ورمز المستكشف والمزيد.

إعداد Azure Digital Twins

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

إنشاء مثيل Azure Digital Twins

في هذا القسم، سوف تقوم بإنشاء مثيل Azure Digital Twins باستخدام مدخل Azure. انتقل إلى المدخل وسجل الدخول باستخدام بيانات اعتمادك.

1. بمجرد وجودك في المدخل، ابدأ بتحديد إنشاء مورد في قائمة الصفحة الرئيسية لخدمات Azure.

   

2. قم بالبحث عن Azure Digital Twins في مربع البحث، واختر خدمة Azure Digital Twins من النتائج.

   اترك حقل Plan معينًا إلى Azure Digital Twins وحدد الزر Create لبدء إنشاء مثيل جديد للخدمة.

   

3. املأ الحقول في علامة التبويب Basics للإعداد، بما في ذلك الاشتراك ومجموعة الموارد والموقع واسم المورد للمثيل الجديد. حدد المربع تعيين دور مالك بيانات توائم Azure الرقمية لإعطاء نفسك أذونات لإدارة البيانات في المثيل.

   

   إشعار

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

   الأدوار الشائعة التي تفي بهذا المطلب هي المالكأو مسؤول الحسابأو مجموعة من مدير وصول المستخدمو المساهم.

4. حدد مراجعة + إنشاء لإنهاء إنشاء المثيل الخاص بك.

5. سترى صفحة ملخص تعرض التفاصيل التي أدخلتها. تأكيد وإنشاء المثيل عن طريق تحديد إنشاء.

سوف ينقلك هذا إلى صفحة «Overview» لتتبع حالة نشر المثيل.

انتظر حتى تعرض الصفحة أنّ عملية النشر قد اكتملت.

فتح مثيل في Azure Digital Twins Explorer

عند الانتهاء من نشر المثيل، استخدم الزر Go to resource للانتقال إلى صفحة «Overview» الخاصة بالمثيل في المدخل.

بعد ذلك، حدد الزر فتح Azure Digital Twins Explorer (معاينة).

يؤدي ذلك إلى فتح Azure Digital Twins Explorer في علامة تبويب جديدة. إن كانت هذه هي المرة الأولى التي تستخدم فيها «المستكشف»، سوف ترى نموذج ترحيب يلخص ميزاته الرئيسية.

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

إذا رأيت هذا المربع، أدخل https:// في الحقل، متبوعا باسم مضيف المثيل الخاص بك (يمكن العثور على هذا مرة أخرى في صفحة نظرة عامة على المثيل في المدخل). تشكل هذه القيم معا عنوان موقع ويب للمثيل. حدد Save للاتصال بالمثيل الخاص بك.

هام

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

إنشاء سيناريو العينة

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

النماذج

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

تتم كتابة نماذج Azure Digital Twins بلغة تعريف التوأم الرقمي (DTDL)، وهي لغة كائن بيانات مشابهة ل JSON-LD. يصف كل نموذج نوعا واحدا من الكيان من حيث خصائصه وعلاقاته ومكوناته.

لهذا التشغيل السريع، تمت كتابة ملفات النموذج بالفعل لك. قمت بتنزيل Building.json Floor.json Room.json في قسم المتطلبات الأساسية، والآن ستقوم بتحميلها إلى مثيل Azure Digital Twins باستخدام Azure Digital Twins Explorer.

Upload النماذج (ملفات.json)

في Azure Digital Twins Explorer، اتبع هذه الخطوات لتحميل نماذج المبنى والطابق والغرفة (ملفات .json التي قمت بتنزيلها سابقا).

1. في لوحة Models ، حدد أيقونة Upload a Model التي تعرض سهما يشير لأعلى.

   

2. في النافذة فتح التي تظهر، انتقل إلى المجلد الذي يحتوي على ملفات .json التي تم تنزيلها على جهازك.

3. حدد Building.json Floor.json Room.json، وحدد فتح لتحميلها جميعا مرة واحدة.

سوف يحمّل Azure Digital Twins Explorer ملفات النموذج هذه إلى مثيل توائم Azure الرقمية الخاص بك. يجب أن تظهر في لوحة النماذج وتعرض أسماءها الصديقة ومعرفات النموذج الكامل.

يمكنك تحديد عرض النموذج من أي من خيارات النماذج لمشاهدة التعليمات البرمجية DTDL التي تحدد كل نوع نموذج.

التوائم والرسم البياني التوأم

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

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

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

استيراد الرسم البياني (ملف .xlsx)

في Azure Digital Twins Explorer، اتبع هذه الخطوات لاستيراد نموذج الرسم البياني ( ملف .xlsx الذي قمت بتنزيله سابقا).

1. في لوحة الرسم البياني للتوأم، حدد أيقونة استيراد الرسم البيانيالتي تظهر سهمًا يشير إلى سحابة.

   

2. في نافذة «فتح»، انتقل إلى ملف buildingScenario.xlsx الذي قمت بتنزيله مسبقًا. يحتوي هذا الملف على بيانات التوأم والعلاقة لنموذج الرسم البياني. حدد فتح.

   بعد بضع ثوان، يفتح Azure Digital Twins Explorer طريقة عرض استيراد تعرض معاينة الرسم البياني الذي يجب تحميله.

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

   

4. سيستخدم Azure Digital Twins Explorer الملف الذي تم تحميله لإنشاء التوائم المطلوبة والعلاقات بينها. تأكد من رؤية مربع الحوار التالي الذي يشير إلى نجاح الاستيراد قبل الانتقال.

   

   حدد إغلاق.

   تم الآن تحميل الرسم البياني إلى Azure Digital Twins Explorer، وستعاد تحميل لوحة Twin Graph . سيظهر فارغا.

5. لمشاهدة الرسم البياني، حدد الزر تشغيل الاستعلام في لوحة مستكشف الاستعلام، بالقرب من أعلى نافذةAzure Digital Twins Explorer.

   

يقوم هذا الإجراء بتشغيل الاستعلام الافتراضي لتحديد وعرض كافة التوائم الرقمية. يسترد Azure Digital Twins Explorer جميع التوائم والعلاقات من الخدمة. يرسم الرسم البياني الذي يحدده في لوحة Twin Graph. الآن يمكنك أن ترى الرسم البياني الذي تم تحميله من سيناريو العينة.

تمثل الدوائر (الرسم البياني "العقد") التوائم الرقمية. تمثل الخطوط العلاقات. التوأم BuildingA "يحتوي" على توائم Floor0 و Floor1، و Floor0 twin "contains" Room0، و Floor1 twin "contains" Room1. إذا كنت تستخدم الماوس، يمكنك النقر والسحب في الرسم البياني للتنقل بين العناصر.

إضافة توأم آخر

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

ابدأ بتحديد النموذج الذي يحدد نوع التوأم الذي تريد إنشاؤه. في لوحة Models على اليسار، افتح قائمة الخيارات لنموذج Room . حدد Create a Twin لإنشاء مثيل جديد من نوع النموذج هذا.

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

بعد ذلك، ستضيف علاقة لإظهار أن Floor1 يحتوي على Room2. استخدم المفتاحين CTRL/CMD أو SHIFT لتحديد Floor1 و Room2 في الرسم البياني في نفس الوقت. عند تحديد كلا التوأمين، انقر بزر الماوس الأيمن فوق Room2 واختر Add relationships.

سيؤدي ذلك إلى فتح مربع حوار إنشاء علاقة مملوء مسبقا بتفاصيل علاقة "يحتوي" من Floor1 إلى Room2. حدد حفظ.

الآن الغرفة 2 متصلة في الرسم البياني. إذا كنت تستخدم الماوس، يمكنك النقر فوق التوائم وسحبها في الرسم البياني لترتيبها في تكوين تريده.

عرض خصائص التوأم

يمكنك تحديد توأم لمشاهدة قائمة بخصائصه وقيمه في لوحة Twin Properties .

فيما يلي خصائص Room0. لاحظ أن Room0 به درجة حرارة 70.

فيما يلي خصائص Room1. لاحظ أن Room1 به درجة حرارة 80.

لا تحتوي Room2 على قيم تم تعيينها لخصائصها حتى الآن، حيث تم إنشاء هذا التوأم يدويا. لتعيين قيم الخصائص الخاصة به، قم بتحرير الحقول بحيث تكون الرطوبة 50 ودرجة الحرارة 72. حدد الأيقونة حفظ.

الاستعلام عن تغيير بيانات IoT

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

ابدأ بتشغيل استعلام لمعرفة عدد التوائم في بيئتك التي تحتوي على درجة حرارة أعلى من 75. قم بتشغيل الاستعلام التالي في لوحة Query Explorer .

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

تذكر من عرض خصائص التوأم في وقت سابق أن Room0 لديه قراءة درجة حرارة 70، Room1 لديه قراءة درجة حرارة 80، وRoom2 لديه قراءة درجة حرارة 72. المبنى والطابق المزدوج ليس لديه خاصية درجة الحرارة على الإطلاق. لهذه الأسباب، يظهر Room1 فقط في النتائج هنا.

تلميح

يتم أيضا دعم عوامل المقارنة الأخرى (<أو> =أو !=) في الاستعلامات. يمكنك محاولة توصيل هذه المشغلات أو القيم المختلفة أو الخصائص المزدوجة المختلفة في الاستعلام لمحاولة الإجابة عن أسئلتك الخاصة.

تحرير بيانات درجة الحرارة

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

أولا، أعد تشغيل الاستعلام التالي لتحديد جميع التوائم الرقمية. سيؤدي ذلك إلى عرض الرسم البياني الكامل مرة أخرى في لوحة Twin Graph .

SELECT * FROM DIGITALTWINS

حدد Room0 لإظهار قائمة خصائصها في لوحة Twin Properties .

قم بتغيير قيمة درجة الحرارة من 70 إلى 76، وحدد أيقونة حفظ لتحديث درجة الحرارة.

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

أغلق معلومات التصحيح.

الاستعلام للاطلاع على النتيجة الجديدة

لمشاهدة درجة الحرارة الجديدة ل Room0 المنعكسة في الرسم البياني، أعد تشغيل الاستعلام من وقت سابق للحصول على جميع التوائم في البيئة مع درجة حرارة أعلى من 75.

SELECT * FROM DIGITALTWINS T WHERE T.Temperature > 75

الآن بعد أن تم تغيير درجة حرارة Room0 من 70 إلى 76، يجب أن يظهر كل من Room0 و Room1 في النتيجة.

مراجعة الدروس ووضعها في سياقها الصحيح

في بدء التشغيل السريع هذا، قمت بإنشاء مثيل توائم Azure الرقمية واستخدام Azure Digital Twins Explorer لملء مع سيناريو عينة. أضفت أيضا توأما رقميا يدويا.

ثم استكشفت الرسم البياني، بما في ذلك...

• استخدام استعلام للإجابة عن سؤال حول السيناريو.
• تحرير خاصية على توأم رقمي.
• تشغيل الاستعلام مرة أخرى لمعرفة كيفية تغيير الإجابة نتيجة لتحديثك.

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

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

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

تنظيف الموارد

وللتنظيف بعد بدء التشغيل السريع هذا، اختر الموارد التي تريد إزالتها استنادًا إلى ما تريد القيام به بعد ذلك.

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

• إذا كنت ترغب في متابعة استخدام مثيل Azure Digital Twins من هذه المقالة، ولكن مسح جميع نماذجه وتوائمه وعلاقاته، فقم بتشغيل الأمر az dt job deletion CLI التالي:

  az dt job deletion create -n <name-of-Azure-Digital-Twins-instance> -y
  

  إذا كنت تريد حذف بعض هذه العناصر فقط، يمكنك استخدام أوامر حذف العلاقة المزدوجة az dt وaz dt twin delete وaz dt model delete لحذف العناصر التي تريد إزالتها بشكل انتقائي فقط.

• إما إن لم تعد بحاجة إلى مثيل Azure Digital Twins، يمكنك حذفه باستخدام مدخل Microsoft Azure.

  انتقل مرة أخرى إلى صفحة Overview للمثيل في المدخل. (إذا كنت قد أغلقت علامة التبويب هذه بالفعل، بإمكانك العثور على المثيل مرة أخرى عن طريق البحث عن اسمه في شريط البحث في مدخل Microsoft Azure وتحديده من نتائج البحث.)

  حدد حذف لحذف المثيل، بما في ذلك كافة نماذجه وتوائمه.

  

قد تحتاج أيضا إلى حذف نموذج ملفات المشروع من جهازك المحلي.

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

انتقل إلى التشغيل السريع التالي لتصور سيناريو Azure Digital Twins في بيئة ثلاثية الأبعاد.

بدء استخدام 3D Scenes Studio

أو انتقل إلى البرامج التعليمية للتعمق أكثر في SDKs وإنشاء الرسم البياني المزدوج وإعداد تدفق الحدث.

• ترميز تطبيق العميل
• إنشاء رسم بياني في Azure Digital Twins
• قم بتوصيل حل شامل