Use Azure Digital Twins Explorer (preview)

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

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

ملاحظة

هذه الأداة حاليا في المعاينة العامة.

كيفية الوصول

الطريقة الرئيسية للوصول إلى Azure Digital Twins Explorer هي من خلال مدخل Azure.

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

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

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

ملاحظة

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

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

تبديل السياقات داخل التطبيق

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

سيؤدي القيام بذلك إلى إظهار نموذج عنوان URL ل Azure Digital Twins، حيث يمكنك إدخال اسم المضيف لمثيل Azure Digital Twins آخر بعد البادئة https:// للاتصال بهذا المثيل.

ملاحظة

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

الاستعلام عن الرسم البياني المزدوج الرقمي الخاص بك

يمكنك استخدام لوحة مستكشف الاستعلام لتشغيل الاستعلامات على الرسم البياني.

أدخل الاستعلام الذي تريد تشغيله. إذا كنت تريد إدخال استعلام في أسطر متعددة، فيمكنك استخدام SHIFT + ENTER لإضافة سطر جديد إلى مربع الاستعلام.

حدد الزر تشغيل الاستعلام لعرض نتائج الاستعلام في لوحة Graph المزدوج.

ملاحظة

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

نتائج استعلام التراكب

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

إذا كانت نتيجة الاستعلام تتضمن شيئا لا يتم عرضه حاليا في لوحة Twin Graph، إضافة العنصر إلى طريقة العرض الموجودة.

حفظ الاستعلامات وإعادة تشغيلها

يمكن حفظ الاستعلامات في وحدة التخزين المحلية في متصفحك، مما يسهل تحديدها وإعادة تشغيلها.

ملاحظة

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

لحفظ استعلام، أدخله في مربع الاستعلام وحدد أيقونة حفظ على يمين اللوحة. أدخل اسما للاستعلام المحفوظ عند مطالبتك بذلك.

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

لحذف استعلام محفوظ، حدد أيقونة X بجوار اسم الاستعلام عند فتح القائمة المنسدلة الاستعلامات المحفوظة .

تلميح

بالنسبة للرسوم البيانية الكبيرة، يقترح الاستعلام عن مجموعة فرعية محدودة فقط ثم تحميل ما تبقى من الرسم البياني كما هو مطلوب. يمكنك النقر نقرا مزدوجا فوق توأم في لوحة Twin Graph لاسترداد عقد إضافية ذات صلة.

استكشف Graph التوأم

تتيح لك لوحة Twin Graph استكشاف التوائم والعلاقات في حالتك.

يمكنك استخدام هذه اللوحة لعرض توأمك وعلاقاتك.

توفر لوحة Twin Graph أيضا العديد من القدرات لتخصيص تجربة مشاهدة الرسم البياني الخاص بك:

• تغيير خاصية العرض المزدوج
• تحرير تخطيط الرسم البياني المزدوج
• التحكم في توسيع الرسم البياني المزدوج
• إظهار عناصر الرسم البياني المزدوج وإخفاؤها
• تصفية عناصر الرسم البياني المزدوج وتمييزها

عرض التوائم والعلاقات

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

تلميح

الاستعلام لعرض جميع التوائم والعلاقات هو SELECT * FROM digitaltwins.

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

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

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

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

يوضح الجدول أدناه أنواع البيانات المحتملة والأيقونات المقابلة لها. يحتوي الجدول أيضا على ارتباطات من كل نوع بيانات إلى وصف المخطط الخاص به في مواصفات DTDL.

الرمز	نوع البيانات
	منطقيه
	مكون
	تاريخ
	dateTime
	المدة
	التعداد
	map
	الأنواع الرقمية، بما في ذلك الأنواع المزدوجة والعائمة والصحيحة والطويلة
	كائن
	string
	وقت

أخطاء

ستعرض لوحة خصائص التوأم رسائل خطأ إذا لم يعد التوأم أو بعض خصائصه يتطابق مع نموذجه.

هناك سيناريوهان محتملان للخطأ يعطي كل منهما رسالة خطأ خاصة به:

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

يتم عرض كل من رسالتي الخطأ هذه في لقطة الشاشة أدناه:

عرض علاقات التوأم

يمكنك أيضا عرض رمز جميع العلاقات التي تتضمن توأما معينا بسرعة (بما في ذلك العلاقات الواردة والصادرة).

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

تغيير خاصية العرض المزدوج

يمكنك تكوين الخاصية التي ترغب في عرضها لتحديد التوائم في الرسم البياني للتوأم. الافتراضي هو القيمة $dtId ، ولكن يمكنك الاختيار من بين أي خصائص موجودة في مجموعة النماذج الخاصة بك (حتى تلك التي لا توجد في كل توأم).

لتغيير خاصية العرض، استخدم القائمة المنسدلة تحديد خاصية اسم العرض التوأم . يتم ترتيب القائمة المنسدلة حسب عدد الطرز التي تحتوي على الخاصية.

إذا اخترت خاصية غير موجودة على كل توأم، عرض أي توائم في الرسم البياني لا تحتوي على هذه الخاصية بعلامة نجمية (*) متبوعة بقيمتها $dtId .

تحرير تخطيط الرسم البياني المزدوج

يمكنك إعادة ترتيب التوائم في تكوينات مختلفة عن طريق النقر عليها وسحبها حول شاشة Twin Graph.

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

التحكم في توسيع الرسم البياني المزدوج

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

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

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

إظهار عناصر الرسم البياني المزدوج وإخفاؤها

يمكنك تبديل خيار إخفاء التوائم أو العلاقات من طريقة عرض الرسم البياني.

لإخفاء توأم أو علاقة، انقر بزر الماوس الأيمن فوقها في نافذة Twin Graph. سيؤدي القيام بذلك إلى إظهار قائمة بها خيارات لإخفاء العنصر أو العناصر الأخرى ذات الصلة.

يمكنك أيضا إخفاء توائم أو علاقات متعددة في وقت واحد باستخدام مفاتيح CTRL/CMD أو SHIFT لتحديد عدة عناصر من نفس النوع في الرسم البياني. من هنا ، اتبع نفس عملية النقر بزر الماوس الأيمن لرؤية خيارات الإخفاء.

للعودة إلى إظهار جميع التوائم بعد إخفاء بعضها، استخدم الزر إظهار الكل . للعودة إلى إظهار جميع العلاقات، استخدم الزر إظهار كافة العلاقات .

تصفية عناصر الرسم البياني المزدوج وتمييزها

يمكنك تصفية التوائم والعلاقات التي تظهر في الرسم البياني حسب النص، عن طريق تحديد أيقونة التصفية هذه:

يمكنك أيضا تمييز التوائم والعلاقات التي تظهر في الرسم البياني بالنص، عن طريق تحديد أيقونة التمييز هذه:

إدارة التوائم والرسم البياني

يوفر Azure Digital Twins Explorer عدة طرق لإدارة التوائموالعلاقات في مثيلك.

يوضح هذا القسم كيفية تنفيذ أنشطة الإدارة التالية:

• عرض قائمة مسطحة من التوائم والعلاقات
• إنشاء توائم ، مع أو بدون خصائص أولية
• إنشاء علاقات بين التوائم
• تحرير خصائص التوأم والعلاقة
• حذف التوائم والعلاقات

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

عرض قائمة مسطحة من التوائم والعلاقات

تعرض لوحة التوائم قائمة مسطحة بتوأمك والعلاقات المرتبطة بهما. يمكنك البحث عن التوائم بالاسم ، وتوسيعها للحصول على تفاصيل حول علاقاتهم الواردة والصادرة.

إنشاء التوائم

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

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

لإضافة قيم خصائص إلى التوأم، راجع تحرير خصائص التوأم والعلاقة.

إنشاء علاقات

لإنشاء علاقة بين توأمين، ابدأ بتحديد التوأم المصدر للعلاقة في نافذة Graph التوأم. بعد ذلك، اضغط باستمرار على مفتاح CTRL/CMD أو SHIFT أثناء تحديد التوأم الثاني ليكون هدف العلاقة.

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

سيؤدي القيام بذلك إلى إظهار مربع الحوار " إنشاء علاقة" ، الذي يتم تعبئته بالتوأم المصدر والتوأم المستهدف للعلاقة (يمكنك أيضا استخدام أيقونة تبديل العلاقة لتبديلها). هناك قائمة منسدلة العلاقة التي تحتوي على أنواع العلاقة التي يمكن أن يكون لدى التوأم المصدر ، وفقا لنموذج DTDL الخاص به. حدد خيارا لنوع العلاقة، واحفظ العلاقة الجديدة.

تحرير خصائص التوأم والعلاقة

لعرض قيم خصائص توأم أو علاقة، حدد العنصر الموجود في Graph التوأم واستخدم زر تبديل عارض الخصائص لتوسيع لوحة خصائص التوأم أو خصائص العلاقة، على التوالي.

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

تلميح

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

حذف التوائم والعلاقات

لحذف توأم أو علاقة، انقر بزر الماوس الأيمن فوقها في نافذة Graph التوأم. سيؤدي القيام بذلك إلى إظهار قائمة بها خيار لحذف العنصر.

يمكنك حذف عدة توائم أو علاقات متعددة مرة واحدة، باستخدام مفتاحي CTRL/CMD أو SHIFT لتحديد عدة عناصر من نفس النوع في الرسم البياني. من هنا، اتبع نفس عملية النقر بزر الماوس الأيمن لحذف العناصر.

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

استكشاف النماذج والرسم البياني النموذجي

يمكن عرض الطرز في لوحة النماذج على الجانب الأيسر من شاشة Azure Digital Twins Explorer وفي لوحة Graph النموذجي في منتصف الشاشة.

لوحة النماذج :

لوحة Graph النموذجية:

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

توفر لوحة Graph النموذجي أيضا العديد من القدرات لتخصيص تجربة مشاهدة الرسم البياني:

• تحرير تخطيط الرسم البياني للنموذج
• تصفية عناصر الرسم البياني للنموذج وتمييزها
• Upload صور النماذج لتمثيل النماذج في الرسوم البيانية

عرض النماذج

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

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

عرض تعريف النموذج

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

يمكنك أيضا عرض التعريف الكامل للنموذج عن طريق تحديده في Graph النموذج، واستخدام زر تبديل تفاصيل النموذج لتوسيع لوحة تفاصيل النموذج. ستعرض هذه اللوحة أيضا رمز DTDL الكامل للنموذج.

تحرير تخطيط الرسم البياني للنموذج

يمكنك إعادة ترتيب النماذج في تكوينات مختلفة عن طريق النقر فوقها وسحبها حول شاشة Graph النموذج.

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

تصفية عناصر الرسم البياني للنموذج وتمييزها

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

يمكنك أيضا تصفية النماذج والاتصالات التي تظهر في الرسم البياني حسب النص، عن طريق تحديد أيقونة التصفية هذه:

يمكنك تمييز النماذج والاتصالات التي تظهر في الرسم البياني بالنص، عن طريق تحديد أيقونة التمييز هذه:

صور نماذج Upload

يمكنك تحميل صور مخصصة لتمثيل نماذج مختلفة في طرق عرض Graph النموذجية و Twin Graph. يمكنك تحميل الصور للطرز الفردية، أو لعدة طرز في وقت واحد.

ملاحظة

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

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

يمكنك أيضا تحميل صور النماذج بكميات كبيرة.

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

1. ابدأ بقيمة معرف النموذج (على سبيل المثال، dtmi:example:Floor;1)
2. استبدل مثيلات ":" ب "_" (يصبح dtmi_example_Floor;1المثال )
3. يستعاض عن مثيلات ";" ب "-" (يصبح dtmi_example_Floor-1المثال )
4. تأكد من أن الملف يحتوي على امتداد صورة (يصبح المثال شيئا مثل dtmi_example_Floor-1.png)

ملاحظة

إذا حاولت تحميل صورة لا يتم تعيينها إلى أي نموذج موجود باستخدام المعايير المذكورة أعلاه، فلن يتم تحميل الصورة أو تخزينها.

بعد ذلك، لتحميل الصور في نفس الوقت، استخدم أيقونة Upload صور النماذج في أعلى لوحة النماذج. في المربع محدد الملفات، اختر ملفات الصور التي تريد تحميلها.

إدارة النماذج

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

باستخدام هذه اللوحة، يمكنك إكمال أنشطة إدارة النماذج التالية:

• Upload النماذج في مثيل Azure Digital Twins
• حذف النماذج من المثيل الخاص بك
• تحديث النماذج لإعادة تحميل قائمة جميع الطرز في هذه اللوحة

للحصول على معلومات حول تجربة المشاهدة للطرازات، راجع استكشاف الطرز Graph النموذج.

نماذج التحميل

يمكنك تحميل النماذج من جهازك عن طريق تحديدها بشكل فردي، أو عن طريق تحميل مجلد كامل من النماذج في وقت واحد.

لتحميل نموذج واحد أو أكثر محدد بشكل فردي، حدد Upload رمز نموذج يعرض سهما لأعلى.

في مربع محدد الملفات الذي يظهر، انتقل على جهازك إلى الطراز (الطرازات) الذي تريد تحميله. يمكنك تحديد ملف طراز JSON واحد أو أكثر وتحديد فتح لتحميلها.

لتحميل مجلد من النماذج، بما في ذلك كل ما بداخله، حدد Upload رمز دليل النماذج الذي يعرض مجلد ملف.

في مربع محدد الملفات الذي يظهر، انتقل على جهازك إلى مجلد يحتوي على ملفات طراز JSON. حدد فتح لتحميل مجلد المستوى الأعلى وجميع محتوياته.

هام

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

حذف النماذج

يمكنك استخدام لوحة النماذج لحذف نماذج فردية، أو كل النماذج في المثيل الخاص بك في وقت واحد.

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

لحذف كل النماذج في المثيل الخاص بك مرة واحدة، اختر أيقونة حذف جميع النماذج في أعلى لوحة النماذج.

تحديث النماذج

عند فتح Azure Digital Twins Explorer، يجب أن تعرض لوحة النماذج تلقائيا جميع الطرز المتوفرة في بيئتك.

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

الرسم البياني للاستيراد/التصدير

من لوحة Twin Graph، لديك خيارات استيرادوتصدير ميزات الرسم البياني.

استيراد الرسم البياني

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

إنشاء ملف استيراد

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

يمكن أن يكون ملف الاستيراد بأي من هذين التنسيقين:

• التنسيق المخصص المستند إلى Excel الموضح في بقية هذا القسم. يتيح لك هذا التنسيق تحميل التوائم والعلاقات.
• التنسيق المستند إلى JSON الذي تم إنشاؤه عند تصدير الرسم البياني. يمكن أن يحتوي هذا التنسيق على توائم و/أو علاقات و/أو نماذج.

لإنشاء رسم بياني مخصص في Excel، استخدم التنسيق التالي.

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

ModelID	المعرف	العلاقة (مصدر)	اسم العلاقة	بيانات Init
(اختياري) معرف نموذج DTMI لتوأم يجب إنشاؤه. يمكنك ترك هذا العمود فارغا لصف إذا كنت تريد أن ينشئ هذا الصف علاقة فقط (بدون توائم).	(مطلوب) الهوية الفريدة للتوأم. إذا تم إنشاء توأم جديد في هذا الصف، فستكون هذه القيمة هي معرف التوأم الجديد. إذا كانت هناك معلومات علاقة في الصف، استخدام هذا المعرف كهدف للعلاقة.	(اختياري) معرف التوأم الذي يجب أن يكون التوأم المصدر لعلاقة جديدة. يمكنك ترك هذا العمود فارغا لصف إذا كنت تريد أن ينشئ هذا الصف توأما فقط (بدون علاقات).	(اختياري) اسم العلاقة الجديدة المراد إنشاؤها. سيكون اتجاه العلاقة من التوأم في العمود C إلى التوأم في العمود B.	(اختياري) سلسلة JSON تحتوي على إعدادات خاصية للتوأم المراد إنشاؤه. يجب أن تتطابق الخصائص مع الخصائص المحددة في النموذج من العمود A.

فيما يلي مثال على ملف .xlsx إنشاء رسم بياني صغير من طابقين وغرفتين.

يمكنك عرض هذا الملف وأمثلة الرسم البياني .xlsx الأخرى في مستودع Azure Digital Twins Explorer على GitHub.

ملاحظة

يجب أن تتطابق الخصائص والعلاقات الموضحة في .xlsx مع ما هو محدد في تعريفات النموذج للتوائم ذات الصلة.

استيراد ملف إلى Azure Digital Twins Explorer

بمجرد أن يكون لديك ملف على جهازك جاهز للاستيراد، حدد أيقونة استيراد Graph في لوحة Twin Graph.

في مربع محدد الملفات الذي يظهر، انتقل على جهازك إلى ملف الرسم البياني (.xlsx أو .json) الذي تريد تحميله واختر فتح لتحميله.

سيفتح Azure Digital Twins لوحة استيراد تعرض معاينة للرسم البياني المراد استيراده. للتأكيد، حدد أيقونة حفظ في الزاوية العلوية اليسرى من اللوحة.

في حالة نجاح الاستيراد، ستعرض نافذة مشروطة عدد النماذج والتوائم والعلاقات التي تم تحميلها.

تصدير الرسم البياني والنماذج

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

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

تلميح

الاستعلام لعرض جميع التوائم والعلاقات هو SELECT * FROM digitaltwins.

بمجرد أن تعرض لوحة Twin Graph جزء الرسم البياني الذي تريد تنزيله، حدد أيقونة تصدير Graph.

يتيح هذا الإجراء ارتباط تنزيل في المربع Twin Graph. حدده لتنزيل تمثيل يستند إلى JSON لنتيجة الاستعلام، وجميع النماذج الموجودة في المثيل الخاص بك، على جهازك.

تلميح

يمكن تحرير هذا الملف و/أو إعادة تحميله إلى Azure Digital Twins من خلال ميزة الاستيراد .

الارتباط ببيئتك

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

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

https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-host-name>

ملاحظة

لا تسبق قيمة العنصر النائب لاسم المضيف البادئة https:// هنا.

في ما يلي مثال على عنوان URL مع ملء قيم العنصر النائب:

https://explorer.digitaltwins.azure.net/?tid=00a000aa-00a0-00aa-0a0aa000aa00&eid=ADT-instance.api.wcus.digitaltwins.azure.net

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

الارتباط باستعلام

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

https://explorer.digitaltwins.azure.net/?tid=<tenant-ID>&eid=<Azure-Digital-Twins-host-name>&query=<query-text>

يجب أن يكون نص الاستعلام مشفرا بعنوان URL.

تلميح

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

يمكنك أيضا استخدام برنامج ترميز URL مستقل لتحويل نص الاستعلام.

في ما يلي مثال على المعلمة الخاصة باستعلام إلى SELECT * FROM digitaltwins:

...&query=SELECT%20*%20FROM%20digitaltwins

يمكنك بعد ذلك مشاركة عنوان URL المكتمل.

إمكانية الوصول والإعدادات المتقدمة

يمكنك تمكين العديد من الإعدادات المتقدمة ل Azure Digital Twins Explorer لتخصيص تجربتك أو جعلها أكثر سهولة.

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

هناك العديد من الميزات المتقدمة التي يمكن الوصول إليها تحت ترس الإعدادات في شريط الأدوات العلوي الأيمن:

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

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

ستتم إعادة تعيين مواضع اللوحة عند تحديث نافذة المتصفح.

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

تعرف على كيفية كتابة الاستعلامات الخاصة بالرسم البياني التوأم ل Azure Digital Twins:

• لغة الاستعلام
• الاستعلام عن الرسم البياني المزدوج