معالجة البيانات والوظائف المعرفة من قبل المستخدم
هام
تم إصدار إصدار جديد من خدمة Azure Digital Twins. في ضوء قدرات الخدمة الجديدة الموسعة، تم إيقاف خدمة Azure Digital Twins الأصلية (الموضحة في مجموعة الوثائق هذه).
لعرض وثائق الخدمة الجديدة، قم بزيارة وثائق Azure Digital Twins النشطة.
يوفر Azure Digital Twins قدرات حوسبة متقدمة. يمكن للمطورين تحديد وتشغيل وظائف مخصصة مقابل رسائل القياس عن بعد الواردة لإرسال الأحداث إلى نقاط النهاية المحددة مسبقا.
تدفق معالجة البيانات
بعد أن ترسل الأجهزة بيانات القياس عن بعد إلى Azure Digital Twins، يمكن للمطورين معالجة البيانات على أربع مراحل: التحقق من الصحة والمطابقة والحوسبة والإرسال.
- تحول مرحلة التحقق من الصحة رسالة بيانات تتبع الاستخدام الواردة إلى تنسيق كائن نقل البيانات الشائع الفهم. تنفذ هذه المرحلة أيضا التحقق من صحة الجهاز والمستشعر.
- تعثر مرحلة المطابقة على الوظائف المناسبة المعرفة من قبل المستخدم لتشغيلها. تعثر المطابقات المعرفة مسبقا على الوظائف المعرفة من قبل المستخدم استنادا إلى معلومات الجهاز والمستشعر والمساحة من رسالة بيانات تتبع الاستخدام الواردة.
- تقوم مرحلة الحوسبة بتشغيل الوظائف المعرفة من قبل المستخدم المتطابقة في المرحلة السابقة. قد تقرأ هذه الدالات القيم المحسوبة وتحدثها على عقد الرسم البياني المكاني ويمكن أن تصدر إعلامات مخصصة.
- توجه مرحلة الإرسال أي إعلامات مخصصة من مرحلة الحوسبة إلى نقاط النهاية المحددة في الرسم البياني.
كائنات معالجة البيانات
تتكون معالجة البيانات في Azure Digital Twins من تحديد ثلاثة عناصر: المطابقات والوظائف المعرفة من قبل المستخدم وتعيينات الأدوار.
المطابقات
تحدد المطابقات مجموعة من الشروط التي تقيم الإجراءات التي تحدث استنادا إلى بيانات تتبع استخدام أداة الاستشعار الواردة. قد تتضمن شروط تحديد المطابقة خصائص من أداة الاستشعار والجهاز الأصل للمستشعر والمساحة الأصل لجهاز الاستشعار. يتم التعبير عن الشروط كمقارنات مقابل مسار JSON كما هو موضح في هذا المثال:
- جميع أجهزة استشعار datatype Temperature ممثلة بقيمة String التي تم الهروب منها
\"Temperature\" - وجودها
01في منفذها - التي تنتمي إلى الأجهزة التي تم تعيين مفتاح الخاصية الموسعة "الشركة المصنعة " إلى قيمة "سلسلة" التي تم الهروب منها
\"Contoso\" - التي تنتمي إلى مسافات من النوع المحدد بواسطة سلسلة الإلغاء
\"Venue\" - وهي توابع SpaceId الأصل
DE8F06CA-1138-4AD7-89F4-F782CC6F69FD
{
"id": "23535afafd-f39b-46c0-9b0c-0dd3892a1c30",
"name": "My custom matcher",
"spaceId": "DE8F06CA-1138-4AD7-89F4-F782CC6F69FD",
"description": "All sensors of datatype Temperature with 01 in their port that belong to devices with the extended property key Manufacturer set to the value Contoso and that belong to spaces of type Venue that are somewhere below space Id DE8F06CA-1138-4AD7-89F4-F782CC6F69FD",
"conditions": [
{
"id": "43898sg43-e15a-4e9c-abb8-2gw464364",
"target": "Sensor",
"path": "$.dataType",
"value": "\"Temperature\"",
"comparison": "Equals"
},
{
"id": "wt3th44-e15a-35sg-seg3-235wf3ga463",
"target": "Sensor",
"path": "$.port",
"value": "01",
"comparison": "Contains"
},
{
"id": "735hs33-e15a-37jj-23532-db901d550af5",
"target": "SensorDevice",
"path": "$.properties[?(@.name == 'Manufacturer')].value",
"value": "\"Contoso\"",
"comparison": "Equals"
},
{
"id": "222325-e15a-49fg-5744-463643644",
"target": "SensorSpace",
"path": "$.type",
"value": "\"Venue\"",
"comparison": "Equals"
}
]
}
هام
- مسارات JSON حساسة لحالة الأحرف.
- حمولة JSON هي نفس الحمولة التي يتم إرجاعها بواسطة:
/sensors/{id}?includes=properties,typesلجهاز الاستشعار./devices/{id}?includes=properties,types,sensors,sensorsproperties,sensorstypesللجهاز الأصل لجهاز الاستشعار./spaces/{id}?includes=properties,types,location,timezoneللمساحة الأصل لجهاز الاستشعار.
- المقارنات غير حساسة لحالة الأحرف.
الوظائف المعرفة بواسطة المستخدم
الدالة المعرفة من قبل المستخدم هي دالة مخصصة يتم تنفيذها داخل بيئة Azure Digital Twins معزولة. الوظائف المعرفة من قبل المستخدم لها حق الوصول إلى رسالة القياس عن بعد للمستشعر الخام عند تلقيها. الوظائف المعرفة من قبل المستخدم لديها أيضا حق الوصول إلى الرسم البياني المكاني وخدمة المرسل. بعد تسجيل الدالة المعرفة من قبل المستخدم داخل رسم بياني، يجب إنشاء مطابق (مفصل أعلاه) لتحديد وقت تنفيذ الدالة. على سبيل المثال، عندما يتلقى Azure Digital Twins بيانات تتبع الاستخدام الجديدة من أداة استشعار معينة، يمكن للوظيفة المتطابقة المعرفة من قبل المستخدم حساب المتوسط المتحرك لقراءات المستشعر القليلة الأخيرة.
يمكن كتابة الوظائف المعرفة من قبل المستخدم بلغة JavaScript. تتفاعل أساليب المساعد مع الرسم البياني في بيئة التنفيذ المعرفة من قبل المستخدم. يمكن للمطورين تنفيذ أجزاء مخصصة من التعليمات البرمجية مقابل رسائل بيانات تتبع استخدام أداة الاستشعار. تتضمن الأمثلة ما يلي:
- قم بتعيين قراءة المستشعر مباشرة على كائن الاستشعار داخل الرسم البياني.
- تنفيذ إجراء استنادا إلى قراءات استشعار مختلفة داخل مساحة في الرسم البياني.
- إنشاء إعلام عند استيفاء شروط معينة لقراءة أداة استشعار واردة.
- إرفاق بيانات تعريف الرسم البياني بقراءة المستشعر قبل إرسال إشعار.
لمزيد من المعلومات، اقرأ كيفية استخدام الوظائف المعرفة من قبل المستخدم.
الأمثلة
يحتوي مستودع GitHub لعينة Digital Twins C# على بعض الأمثلة على الوظائف المعرفة من قبل المستخدم:
- تبحث هذه الدالة عن قيم ثاني أكسيد الكربون والحركة ودرجة الحرارة لتحديد ما إذا كانت الغرفة متوفرة بهذه القيم في النطاق. تستكشف البرامج التعليمية ل Digital Twins هذه الوظيفة بمزيد من التفاصيل.
- تبحث هذه الدالة عن بيانات من مستشعرات حركة متعددة، وتحدد أن المساحة متوفرة إذا لم يكتشف أي منها أي حركة. يمكنك بسهولة استبدال الدالة المعرفة من قبل المستخدم المستخدمة في التشغيل السريع، أو البرامج التعليمية، عن طريق إجراء التغييرات المذكورة في قسم التعليقات من الملف.
تعيين الدور
تخضع إجراءات الوظيفة المعرفة من قبل المستخدم للتحكم في الوصول المستند إلى دور Azure Digital Twins لتأمين البيانات داخل الخدمة. تحدد تعيينات الأدوار الوظائف المعرفة من قبل المستخدم التي لديها الأذونات المناسبة للتفاعل مع الرسم البياني المكاني وكياناته. على سبيل المثال، قد يكون للدالة المعرفة من قبل المستخدم القدرة على إنشاء بيانات الرسم البياني أو قراءتها أو تحديثها أو حذفها ضمن مساحة معينة. يتم التحقق من مستوى وصول الدالة المعرفة من قبل المستخدم عندما تطلب الدالة المعرفة من قبل المستخدم الرسم البياني للبيانات أو تحاول إجراء. لمزيد من المعلومات، اقرأ التحكم في الوصول المستند إلى الدور.
من الممكن أن يقوم المطابق بتشغيل دالة معرفة من قبل المستخدم لا تحتوي على تعيينات دور. في هذه الحالة، تفشل الدالة المعرفة من قبل المستخدم في قراءة أي بيانات من الرسم البياني.
الخطوات التالية
لمعرفة المزيد حول كيفية توجيه الأحداث ورسائل بيانات تتبع الاستخدام إلى خدمات Azure الأخرى، اقرأ أحداث التوجيه والرسائل.
لمعرفة المزيد حول كيفية إنشاء المطابقات والوظائف المعرفة من قبل المستخدم وتعيينات الأدوار، اقرأ دليل لاستخدام الدالات المعرفة من قبل المستخدم.
راجع الوثائق المرجعية لمكتبة عميل الوظيفة المعرفة من قبل المستخدم.