تعيين بيانات تتبع الاستخدام عند الدخول إلى IoT Central

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

  • إنشاء قوالب الأجهزة وتجارب إدارة الأجهزة في IoT Central.
  • قم بتسوية بيانات تتبع الاستخدام من أجهزة مختلفة عن طريق تعيين مسارات JSON على أجهزة متعددة إلى اسم مستعار شائع.
  • التصدير إلى وجهات خارج IoT Central.

رسم تخطيطي يلخص عملية التعيين في IoT Central.

يرشدك الفيديو التالي خلال عملية تعيين البيانات:

تعيين بيانات تتبع الاستخدام لجهازك

يستخدم التعيين تعبير JSONPath لتحديد القيمة في رسالة بيانات تتبع الاستخدام الواردة لتعيينها إلى اسم مستعار.

يبدأ تعبير JSONPath بالحرف $ الذي يشير إلى العنصر الجذر للرسالة. $ يتبعه تسلسل من العناصر التابعة مفصولة باستخدام أقواس مربعة. على سبيل المثال:

$["messages"]["tmp"]

$["opcua"]["payload"][0]["value"]

$["Messages"]["Payload"]["nsu=http://microsoft.com/Opc/OpcPlc/;s=FastUInt1"]["Value"]

يستخدم IoT Central مجموعة فرعية من بناء جملة تعبير JSONPath:

  • يمكن أن يكون كل مقطع رقما غير سالب أو سلسلة محاطة بعلامات اقتباس مزدوجة.
  • لا يمكن أن يحتوي المقطع على شرطة مائلة عكسية أو قوس مربع أو علامات اقتباس مزدوجة.
  • لا يمكن أن يتجاوز مسار JSON 1000 حرف.

لإنشاء تعيين في تطبيق IoT Central، اختر أحد الخيارات التالية للانتقال إلى لوحة بيانات الخريطة :

  • من أي صفحة جهاز، حدد إدارة بيانات خريطة الجهاز>:

    لقطة شاشة تعرض عنصر القائمة **Map data**.

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

    لقطة شاشة تعرض خيار **Add alias** في طريقة العرض **Raw data**.

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

أضف العديد من التعيينات كما تحتاج ثم حدد حفظ:

لقطة شاشة لطريقة عرض **Map data** تعرض مسار Json والاسم المستعار.

لجهاز معين:

  • لا يمكن أن يكون لاثنين من التعيينات نفس مسار JSON.
  • لا يمكن أن يكون لتعيينين نفس الاسم المستعار.

تلميح

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

للتحقق من أن IoT Central يقوم بتعيين بيانات تتبع الاستخدام، انتقل إلى طريقة عرض البيانات الأولية لجهازك وتحقق من _mappeddata القسم:

لقطة شاشة تعرض قسم البيانات المعينة في رسالة في طريقة العرض **Raw data**.

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

بالنسبة لأجهزة IoT Edge، ينطبق تعيين البيانات على بيانات تتبع الاستخدام من جميع وحدات IoT Edge ومركزها. لا يمكنك تطبيق التعيينات على وحدة Azure IoT Edge معينة.

بالنسبة للأجهزة المعينة لقالب جهاز، لا يمكنك تعيين البيانات للمكونات أو الواجهات الموروثة. ومع ذلك، يمكنك تعيين أي بيانات من جهازك قبل تعيينها إلى قالب جهاز.

إدارة التعيينات

لعرض التعيينات أو تحريرها أو حذفها، انتقل إلى صفحة الأسماء المستعارة المعينة . حدد تعيينا لتحريره أو حذفه. يمكنك تحديد تعيينات متعددة وحذفها في نفس الوقت:

لقطة شاشة تعرض طريقة العرض **تعيين الأسماء المستعارة** مع زري التحرير والحذف.

بشكل افتراضي، تتضمن عمليات تصدير البيانات من IoT Central بيانات معينة. لاستبعاد البيانات المعينة، استخدم تحويل البيانات في تصدير البيانات.

تعيين بيانات تتبع الاستخدام غير المرسمة

يمكنك تعيين بيانات تتبع الاستخدام غير المضمنة، بما في ذلك بيانات تتبع الاستخدام من المكونات غير المضمنة. على سبيل المثال، نظرا لبيانات workingSet تتبع الاستخدام المحددة في المكون الجذر وبيانات temperature تتبع الاستخدام المحددة في مكون منظم الحرارة الموضح في المثال التالي:

{
  "_unmodeleddata": {
    "workingSet": 74
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:22:40.257Z"
}

{
  "_unmodeleddata": {
    "thermostat2": {
      "__t": "c",
      "temperature": 44
    }
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:21:48.69Z"
}

يمكنك تعيين بيانات تتبع الاستخدام هذه باستخدام تعريفات التعيين التالية:

  • $["workingSet"] ws
  • $["temperature"] temp

ملاحظة

لا تقم بتضمين اسم المكون في تعريف التعيين.

تبدو نتائج قواعد التعيين هذه مثل الأمثلة التالية:

{
  "telemetries": {
    "workingSet": 84,
    "_mappeddata": {
      "ws": 84
    }
  }
}

{
  "_unmodeleddata": {
    "thermostat2": {
      "__t": "c",
      "temperature": 12
    },
    "_mappeddata": {
      "thermostat2": {
        "__t": "c",
        "temp": 12
      }
    }
  },
  "_eventtype": "Telemetry",
  "_timestamp": "2022-07-18T09:31:21.088Z"
}

يمكنك الآن استخدام الأسماء المستعارة المعينة لعرض بيانات تتبع الاستخدام على مخطط أو لوحة معلومات. يمكنك أيضا استخدام الأسماء المستعارة المعينة عند تصدير بيانات تتبع الاستخدام.

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

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