برنامج SARTORIUS Sim Api

تحديد

• اسم المنتج: دليل SimApi
• تاريخ الإصدار: 5 سبتمبر 2024
• الغرض: توفير البيانات لمنتجات Umetrics Suite

تعليمات استخدام المنتج

مقدمة عن SimApis

• يتم استخدام SimApis لاسترداد البيانات لإنشاء المشروع وبناء النموذج في منتجات Umetrics Suite.

الحصول على SimApis

• للحصول على SimApis، راجع الوثائق الرسمية أو اتصل بدعم العملاء للحصول على المساعدة.

مميزات SimApi

• توفر SimApis بيانات في الوقت الفعلي للمراقبة والتحكم وبناء النماذج في SIMCA و SIMCA-online.

استخدام البيانات الحالية فقط

• من المستحسن استخدام البيانات الحالية فقط وتجنب البيانات التاريخية للحصول على الأداء الأمثل.

التحضير لتثبيت SimApi

• قبل التثبيت، تأكد من أن نظامك يلبي الحد الأدنى من المتطلبات المحددة في دليل المستخدم.

تثبيت SimApi

• اتبع التعليمات خطوة بخطوة المقدمة في دليل المستخدم لتثبيت SimApi على نظامك.

إعداد SimApi لـ SIMCA

• قم بتكوين إعدادات SimApi في SIMCA وفقًا للإرشادات المقدمة.

إعداد SimApi لـ SIMCA-online

• إعداد SimApi لعمليات استرجاع البيانات وكتابتها في الوقت الفعلي في SIMCA-online.

الاختبار واستكشاف الأخطاء وإصلاحها

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

الاختبار من SIMCA-online

• اختبر تكامل SimApi من SIMCA-online للتحقق من استرجاع البيانات.

استكشاف الأخطاء وإصلاحها باستخدام السجل Files

• استخدم سجل SimApi file لتحديد وحل أي مشاكل في التثبيت أو التشغيل.

تكوين حساب الخدمة

• تأكد من التكوين الصحيح لحساب خدمة SIMCA عبر الإنترنت لضمان التشغيل السلس.

التفاصيل الفنية

• يرجى الرجوع إلى القسم 7 من دليل المستخدم للحصول على معلومات تقنية متعمقة حول SimApis.

مقدمة عن SimApis

• SimApi عبارة عن واجهة برمجية بين برنامج Umetrics® Suite ومصدر البيانات. الغرض الأساسي من SimApi هو توفير البيانات إلى SIMCA®-online أو SIMCA®.
• تقوم شركة Sartorius Stedim Data Analytics AB بتطوير SimApis للعديد من مصادر البيانات المختلفة، مثل مؤرخي العمليات وقواعد البيانات للأغراض العامة.
• يوضح هذا المستند ماهية SimApi، وكيفية استخدامه في منتجات Umetrics Suite. ستتعلم كيفية التخطيط لتثبيت SimApi، وكيفية استكشاف الأخطاء وإصلاحها وكيفية اختبار التثبيت. يحتوي الفصل الأخير على تفاصيل تقنية حول SimApis موجهة للمطورين.

غرض SimApi: توفير البيانات لمنتجات Umetrics Suite

• الغرض الأساسي من واجهة SimApi هو توفير البيانات إلى SIMCA-online أو SIMCA من مصدر بيانات. لا يعد مصدر البيانات جزءًا من SIMCA-online ولكنه قد يكون مؤرخًا للعملية أو نظامًا آخر يحتفظ بالبيانات ويديرها.
• يعرض SimApi تسلسلًا هرميًا من العقد، يتوافق مع المجلدات الموجودة في file النظام. يمكن أن تحتوي كل عقدة على عقد أخرى، أو tags.أ tag يتوافق مع متغير. لهذه tagsيمكن الحصول على البيانات. تظهر الصورة tag, درجة الحرارة، المحددة في العقدة
• BakersYeastControlGood في مصدر بيانات في SIMCA-online. كما يعرض أيضًا أحدث القيم المأخوذة من مصدر البيانات.

استخدام SimApi في مجموعة Umetrics

• يمكن لبرنامج سطح المكتب SIMCA استخدام SimApi لاسترداد البيانات لإنشاء المشروع وبناء النموذج كما يوضح الصورة التالية.
• يستخدم SIMCA-online واجهة SimApis للحصول على البيانات في الوقت الفعلي للمراقبة والتحكم، فضلاً عن إعادة كتابة البيانات إلى مصدر البيانات. توضح الصورة التالية مكان واجهة SimApi في نظام يتكون من مصدر بيانات وخادم SIMCA-online وعملاء.

SimApis المستخدمة بشكل شائع

• أكثر واجهات SimApis استخدامًا هي:
• PI AF SimApi للاتصال بأنظمة Aveva (OSIsoft سابقًا) PI.
• OPC UA SimApi
• ODBC SimApi – للوصول العام إلى قواعد البيانات مثل SQL Server أو Oracle
• يتم إدراج جميع واجهات SimApi المتاحة مع ميزاتها في الفقرة 3.

DBMaker SimApi لمحاكاة البيانات

• DBMaker هو تطبيق يتم توفيره مع تثبيت خادم SIMCA-online. وهو يحاكي مصدر بيانات، مثل مؤرخ العمليات، باستخدام جدول بيانات مُحمَّل مسبقًا حيث يتم توفير الملاحظات واحدة تلو الأخرى إلى SIMCA-online من خلال DBMaker SimApi.
• يُستخدم DBMaker لأغراض العرض التوضيحي فقط ولا يمكن استخدامه في الإنتاج مع البيانات المباشرة من مصدر البيانات. راجع التعليمات المضمنة لمعرفة المزيد حول DBMaker.

وثائق إضافية

• تعتبر هذه الوثيقة واحدة من مجموعة من الوثائق ذات الصلة، ولكل منها تركيز مختلف وجمهور مستهدف مختلف:

مصدر	ماذا	أين
SIMCA-أون لاين web صفحة	معلومات تمهيدية وتنزيلات	سارتوريوس.كوم/umetrics-simca- متصل

ملف ReadMe والتثبيت عبر الإنترنت لبرنامج SIMCA.pdf	التثبيت وكيفية البدء في استخدام SIMCA- بيانات العرض التوضيحي عبر الإنترنت	في ملف التثبيت zip file
دليل تنفيذ SIMCA عبر الإنترنت	يتناول هذا التقرير وظائف SIMCA-online، ويضعها في سياق برامج Umetrics Suite الأخرى، ويصف المتطلبات وأفضل الممارسات للنشر الناجح، وتعليمات التثبيت خطوة بخطوة.	سارتوريوس.كوم/umetrics-simca- متصل
دليل SimApi	التحضير لتثبيت SimApi وتنفيذه، بما في ذلك استكشاف الأخطاء وإصلاحها. كما يحتوي على تفاصيل فنية حول SimApis للمطورين.	سارتوريوس.كوم/umetrics-simapi
دليل مستخدم SimApi	توثيق كل SimApi منشور مع الميزات وتعليمات التثبيت وتفاصيل التكوين.	سارتوريوس.كوم/umetrics-simapi
دليل SIMCA الفني عبر الإنترنت	مرجع فني لتخطيط تثبيت خادم SIMCA-online، واستكشاف الأخطاء وإصلاحها، وكيفية عمل SIMCA-online بالتفصيل.	سارتوريوس.كوم/umetrics-simca-متصل
المساعدة عبر الإنترنت من SIMCA	Web- المساعدة المستندة إلى كيفية استخدام SIMCA-online وكيفية عمل SIMCA-online.	في البرنامج نفسه، وعلى سارتوريوس.كوم/umetrics-simca
SIMCA-أون لاين Web دليل تثبيت العميل	يصف تثبيت SIMCA-online Web زبون.	سارتوريوس.كوم/umetrics-simca-متصل
قاعدة المعرفة Umetrics	قاعدة بيانات قابلة للبحث تحتوي على مقالات حول كل إصدار تم إصداره من البرامج، والمقالات الفنية، والمشكلات المعروفة في منتجات Umetrics Suite.	سارتوريوس.كوم/umetrics-kb
دليل المساعدة/المستخدم لـ SIMCA	كيفية استخدام SIMCA لسطح المكتب لإنشاء المشاريع ونمذجة البيانات.	في SIMCA وما بعدها سارتوريوس.كوم/umetrics-simca
يدعم web صفحة	كيفية الحصول على الدعم الفني.	sartorius.com/umetrics-support

الدعم الفني

• يجيب فريق الدعم عبر الإنترنت لشركة Sartorius على الأسئلة الفنية المتعلقة بـ SimApis ويمكنه أيضًا توجيه طلبات تحسين SimApis إلى الأشخاص المناسبين. تعرف على المزيد على sartorius.com/umetrics-support.

الحصول على SimApis

• نحن نقدم الوثائق الخاصة بـ SimApis المتاحة وروابط لبرامج التثبيت على سارتوريوس.كوم/umetrics-simapi.
• يتم توثيق كل SimApi في دليل المستخدم الخاص به.
• دليل SimApi، الذي تقرأه الآن، يكمل هذه المعلومات بمعلومات مكملة لـ SimApi عندما يتعلق الأمر بتخطيط SimApi وتثبيته واستكشاف الأخطاء وإصلاحها.

مميزات SimApi

• لا تتشابه جميع مصادر البيانات. لا يلزم أن تنفذ واجهة SimApi جميع الوظائف في المواصفات. ولهذه الأسباب، تقدم واجهات SimApi المختلفة وظائف مختلفة. تسرد المصفوفة التالية واجهات SimApi المتاحة وميزاتها.
• يتم شرح الميزات أدناه. لاحظ أن الجدول يحتوي على أعمدة منفصلة لإظهار الميزات المتوفرة في SIMCA-online وSIMCA على التوالي.

ميزة	غاية	استخدام SIMCA عبر الإنترنت	استخدام SIMCA
البيانات الحالية	قراءة ملاحظة واحدة بالقيمة الأحدث من مصدر البيانات.	التنفيذ الطبيعي في الوقت الحقيقي	-
البيانات التاريخية	قراءة العديد من الملاحظات مرة واحدة باستخدام البيانات التاريخية من مصدر البيانات.	اللحاق بالبيانات السابقة والتنبؤ بها وإنشاء المشاريع باستخدام File > جديد	معالج استيراد قاعدة البيانات لاستيراد بيانات العملية لإنشاء النموذج.
البيانات المنفصلة	قراءة بيانات المختبر/التقييم المرحلي المتكامل من مصدر البيانات. العديد من الملاحظات لكل دفعة.	للمشروعات الدفعية ذات المراحل أو شروط الدفعة المهيأة لاسترجاع البيانات المنفصلة.	-
بيانات الدفعة	قراءة شروط الدفعة وسمات الجودة النهائية (أو	شروط الدفعة أو التمركز المحلي.	معالج استيراد قاعدة البيانات لقراءة شروط الدفعة

ميزة	غاية	استخدام SIMCA عبر الإنترنت	استخدام SIMCA
	بيانات أخرى من نوع MES). ملاحظة واحدة لكل دفعة.		إنشاء نموذج على مستوى الدفعة.
عقدة الدفعة	حدد وقت البدء ووقت الانتهاء (فارغًا للدفعة النشطة) لدفعة معينة. إحصاء جميع الدفعات الموجودة في نطاق زمني محدد.	مطلوب لتنفيذ تكوينات الدفعة.	معالج استيراد قاعدة البيانات لتحديد الدفعات التي سيتم استيرادها.
الكتابة مرة أخرى – البيانات المستمرة	اكتب البيانات المستمرة، مثل التوقعات، مرة أخرى إلى مصدر البيانات.	كتابة البيانات مرة أخرى من مستوى تطور الدفعة، لمستشار التحكم أو للتكوينات المستمرة	-
الكتابة مرة أخرى – منفصلة	اكتب بيانات منفصلة، ​​مثل التوقعات، مرة أخرى إلى مصدر البيانات.	الكتابة مرة أخرى لتكوينات الدفعة على مستوى تطور الدفعة للمراحل التي تم تكوينها لاسترجاع البيانات المنفصلة	-
الكتابة مرة أخرى – بيانات الدفعة	اكتب بيانات مستوى الدفعة مرة أخرى، مثل التوقعات أو سمات الجودة النهائية، إلى مصدر البيانات.	الكتابة مرة أخرى لتكوين الدفعة على مستوى الدفعة	-
تسلسل العقدة	يدعم SimApi تسلسلًا هرميًا من العقد، على نحو مماثل لـ file النظام. يمكن أن تحتوي كل عقدة على tags والعقد الأخرى. التسلسل الهرمي يجعل من السهل إدارة عدد كبير من العقد و tags.	مدعوم في جميع الأماكن حيث tags يتم استخدامها.
مصفوفة tag توسع	مجموعة tag يخزن قيمًا متعددة. يقوم SimApi بتوسيع المصفوفة tag إلى العديد من الأفراد tagsواحد لكل عنصر في المصفوفة.	مدعومة حيث tags تُستخدم للبيانات المستمرة. كل توسعة tag يجب تعيينه إلى متغير في مشروع SIMCA.
مصادر بيانات متعددة	يمكن لـ SimApi الاتصال بأكثر من مصدر بيانات واحد أو دعم مثيلات متعددة لنفسه بإعدادات وسجلات فردية files لكل حالة.	الاتصال بالعديد من مصادر البيانات المختلفة من نفس النوع.	-
مرونة الاتصال	إذا انقطع اتصال SimApi بمصدر البيانات، فسوف يحاول إعادة إنشاء الاتصال تلقائيًا.	لا يلزم إعادة تشغيل SimApi لإعادة إنشاء الاتصالات بمصدر البيانات.	-
تم تطويره داخليا	تم تطوير SimApi وتوفيره ودعمه بواسطة

لا ينصح باستخدام البيانات الحالية فقط، دون البيانات التاريخية

• بعض SimApis، وخاصة OPC DA، تدعم فقط قراءة البيانات الحالية، وليس البيانات التاريخية.
• لا يمكن استخدام SimApi الذي يدعم البيانات الحالية فقط في SIMCA لسطح المكتب، لأنه لن يكون قادرًا على قراءة البيانات التاريخية التي سيتم بناء النماذج عليها.
• بالنسبة إلى SIMCA-online، نوصي بشدة بمصدر بيانات وSimApi لا يوفران البيانات الحالية للتنفيذ في الوقت الفعلي فحسب، بل يوفران أيضًا البيانات التاريخية للتمكن من التنبؤ بالبيانات السابقة وتعويضها. يقوم SIMCA-online بالتبديل تلقائيًا بين البيانات في الوقت الفعلي والبيانات التاريخية حسب الحاجة ولا يمكن إيقاف تشغيل ذلك.
• يمكن لمصدر البيانات الذي يوفر البيانات الحالية فقط، ولكن ليس البيانات التاريخية، أن يعمل في المشاريع المستمرة في SIMCA-online، ولكن بالنسبة لمشاريع الدفعات، تكون البيانات التاريخية مطلوبة.

التحضير لتثبيت SimApi

• يصف هذا القسم معلومات مهمة لتثبيت SimApi بنجاح.

SimApis 64 بت أو 32 بت

• هناك إصدارات 32 بت و 64 بت من كل SimApi.
• إن SIMCA-online وSIMCA هما 64 بت وتتطلبان إصدارات SimApis ذات 64 بت. لا تزال إصدارات SimApis ذات 32 بت القديمة متاحة للتثبيتات الأقدم.

موقع السجل file والإعدادات

• يقوم SimApi بتخزين سجله files في مجلد بيانات البرنامج المخفي1:
  %programdata%\Umetrics\SimApi، حيث يتم تعيين %programdata% إلى المجلد الفعلي على جهاز الكمبيوتر الخاص بك. ويكون افتراضيًا هو C:\ProgramData.
• يستخدم كل SimApi عادةً سجله الخاص file، والذي يشبه سجل خادم SIMCA عبر الإنترنت file سيحتوي على بيانات أكثر أو أقل اعتمادًا على إعداد مستوى السجل. هذا file مفيد لاستكشاف الأخطاء وإصلاحها. السجل file تم تسميته
  .سجل حيث هو SimApi الذي تقوم بتثبيته، على سبيل المثالampراجع أيضًا القسم التالي لمعرفة أسماء مثيلات SimApi على الإنترنت من SIMCA.
• يحتوي هذا المجلد أيضًا على إعدادات SimApi بتنسيق XML file اسمه .xml.
• تحتوي معظم واجهات SimApis على واجهات مستخدم رسومية تعمل على تغيير الإعدادات في ملف XML fileولكن بالنسبة لبعض الأشخاص، يمكنك إدخال التغييرات مباشرة في XML file باستخدام محرر نصوص، مثل Notepad. راجع دليل المستخدم لكل SimApi.

File الأسماء عند استخدام الحالات المسماة مع SIMCA-online

• في SIMCA-online، يحصل كل مثيل SimApi على تكوينه الخاص file وسجل file للعمل مع مثيلات متعددة لكل SimApi. أسماء هذه fileيتم إضافة s إلى اسم المثيل كما هو موضح في علامة التبويب SimApi في مربع الحوار خيارات خادم SIMCA-online.
• المثال التاليampيظهر هنا أسماء هؤلاء fileس، أين يجب استبداله باسم SimApi.
• اسم التكوين المقدم عند إضافة المثيل: OmegaServer
• إعدادات file اسم: أوميجا سيرفر.xml
• سجل file اسم: سجل OmegaServer
• لاحظ أن العام file .سجل file لا يزال يتم إنشاء هذا السجل file يحتوي على إدخالات لا يمكن توجيهها إلى السجل لأسباب فنية file من الحالات..
• هذا المجلد مخفي افتراضيًا في نظام التشغيل Windows. لرؤيته في File المستكشف الذي قمت بتكوينه يظهر مخفيًا fileس. لاحظ أنه يمكنك الانتقال إلى مجلد مخفي عن طريق كتابة عنوان في File شريط عنوان المستكشف.
• لاحظ أن SIMCA لا يدعم مثيلات متعددة من SimApi، وبالتالي يستخدم الأسماء بدون اسم المثيل كما هو موضح أعلاه.

تخطيط الشبكة

• يجب أن يكون موقع خادم SIMCA-online قريبًا من مصدر البيانات في الشبكة. وهذا يضمن اتصالاً سريعًا بين SIMCA-online ومصدر البيانات الخاص به.
• قد تتداخل معدات الشبكات مع الاتصال بين SIMCA-online ومصدر البيانات.

حسابات المستخدم وأذونات مصدر البيانات

• تتحكم مصادر البيانات عادةً في الوصول إلى بياناتها. ويتم ذلك عادةً باستخدام أسماء المستخدمين وكلمات المرور، ولكن يمكن أيضًا استخدام القيود القائمة على عنوان IP أو DNS (على سبيل المثالampتثق PI في نظام Aveva PI).
• يمكن توفير اسم المستخدم وكلمة المرور لمصدر البيانات بطرق مختلفة:
• يتم تشغيل SimApi كمستخدم Windows للمستخدم الذي يقوم بتشغيل SIMCA على سطح المكتب أو حساب خدمة SIMCA عبر الإنترنت على كمبيوتر الخادم. يمكن لـ SimApi الاتصال بمصدر البيانات باستخدام هذا الحساب. هذه هي الطريقة التي يعمل بها OPC I وPI SimApi وODBC إذا لم تقدم بيانات اعتماد عند تكوينه.
• بالنسبة لـ ODBC العام، يمكنك استخدام تطبيق ODBC Data Sources Administrator الموجود في قائمة ابدأ في Windows.
• يوفر بعض موفري قواعد البيانات برامج التشغيل والأدوات الخاصة بهم لقواعد البيانات الخاصة بهم. قواعد بيانات Oracle، على سبيل المثالampاستخدم مكونات Oracle Data Access (ODAC).
• تحتوي بعض واجهات SimApi، مثل PI AF وODBC، على مربعات حوار تكوين تخزن بيانات الاعتماد المشفرة في تكوين SimApi XML file.
• تتوفر أيضًا خيارات أمان متنوعة في أدوات إدارة نظام PI على كمبيوتر خادم PI. اقرأ المزيد في دليل مستخدم PI AF SimApi. هذا الدليل مفيد حتى إذا كنت تستخدم OSIsoft PI SimApi الأقدم.
• يستخدم OPC DA وHDA DCOM كوسيلة نقل بين مصدر البيانات وSimApi. يتم تكوين DCOM باستخدام أداة خدمات المكونات (DCOMCNFG.EXE) في Windows ويستخدم مصادقة Windows.
• بالنسبة لإصدار OSIsoft PI SimApi الأقدم (وليس AF SimApi الأحدث)، يتم استخدام تطبيق OSIsoft AboutPI-SDK (PISDKUtility.exe) لإعداد الاتصال بخادم PI.

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

• تُستخدم مصادر بيانات ODBC في Windows لتكوين واختبار ODBC العامة. لاحظ أن هناك نسختين من هذه الأداة على Windows 64 بت: واحدة للتطبيقات 32 بت وأخرى للتطبيقات 64 بت. استخدم زر اختبار مصدر البيانات في نهاية معالج تكوين ODBC للتحقق من الاتصال بقاعدة البيانات. نوصي بتكوين مصادر البيانات الخاصة بك كـ DSNs للنظام.
• أداة اتصال خاصة بقاعدة البيانات من موفر قاعدة البيانات، مثل مكونات Oracle Data Access.
• يمكن استخدام PI System Explorer لاختبار الاتصال بخادم PI AF. وهو جزء من PI AF Client وهو شرط أساسي لـ PI AF SimApi.
• OPC UA Expert من Unified Automation – UaExpert هو عميل اختبار متعدد الأنظمة الأساسية لخوادم OPC UA.
• يمكن استخدام تطبيق PI-SDK (PISDKUtility.exe) لاختبار الاتصال و view أي رسائل خطأ ربما تم تسجيلها عند محاولة SIMCA-online الاتصال بخادم PI. يتم استخدام هذا فقط لـ OSIsoft SimApi الأقدم، وليس PIAF.
• يتم استخدام أدوات إدارة نظام PI على كمبيوتر خادم PI لاستكشاف الأخطاء وإصلاحها من هذا الجانب. على سبيل المثالampللبحث عن مشكلات الأمان التي تمنع الوصول من خادم SIMCA-online. تعرف على المزيد حول استكشاف أخطاء نظام PI وإصلاحها في مقطع الفيديو هذا على YouTube.
• يمكن استخدام Excel للحصول على البيانات من اتصال ODBC ومعظم الأنظمة الأخرى عند تثبيت البرنامج الإضافي المناسب.
• يمكن استخدام Matrikon OPC Explorer لـ Ior HDA (وهما أداتان منفصلتان) لاختبار اتصال OPC، ويمكن استخدام Matrikon OPC Analyzer لتشخيص مشكلات اتصال OPC. قم بتنزيل هذه الأدوات المجانية من https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• إنقاذ OPC (لـ DInd HDA) من معهد تدريب OPC web يتيح الموقع للمستخدمين تشخيص مشكلات الاتصال والأمان بسهولة وإصلاحها على الفور بضغطة زر. ويمكن القيام بكل هذا دون الحاجة إلى تعلم تكوين DCOM على الإطلاق

تثبيت SimApi

إليك كيفية تثبيت SimApi على جهاز الكمبيوتر:

1. اقرأ دليل المستخدم الخاص بـ SimApi الذي تقوم بتثبيته. فهو يحتوي على تفاصيل خاصة بـ SimApi والتي تكمل الإرشادات العامة التي تقرأها الآن.
2. قم بتثبيت وتكوين أي متطلبات أساسية مذكورة في دليل مستخدم SimApi (على سبيل المثالampبرامج تشغيل قاعدة البيانات أو حزم SDK)
3. قم بتشغيل برنامج الإعداد لتثبيت SimApi. قم بتثبيت الإصدار 64 بت (x64) أو الإصدار 32 بت (x86) الذي يتوافق مع البرنامج الذي ستشغله فيه.
4. قم بتكوين SimApi في SIMCA-online أو SIMCA كما هو موضح في الأقسام التالية وراجع دليل المستخدم الخاص بـ SimApi للحصول على أوصاف للإعدادات المتاحة.
5. ابدأ تشغيل خادم SIMCA-online. لاحظ أن هذا قد يستغرق بعض الوقت، لأنه عند تهيئة SimApi، سيتم تعداد جميع tags في مصدر البيانات.
6. اختبر SimApi من خلال الحصول على بعض البيانات. بالنسبة إلى SIMCA-online، يمكنك استخدام File > استخرج كما هو موضح في 6.1.
7. إذا فشل SimApi في العمل كما هو متوقع، راجع سجل SimApi fileلمزيد من المعلومات حول استكشاف الأخطاء وإصلاحها، وللاطلاع على دليل مستخدم SimApi.

إعداد SimApi للاستخدام في SIMCA

إليك كيفية استخدام SimApi في SIMCA:

1.  ابدأ استيراد قاعدة البيانات بإحدى الطرق التالية:
   • a. لإنشاء مشروع جديد في SIMCA: File > مشروع عادي جديد أو مشروع دفعة جديد. حدد "من قاعدة البيانات" في علامة التبويب "الصفحة الرئيسية".
   • b. لاستيراد مجموعة بيانات في مشروع موجود في SIMCA: من مجموعة البيانات في علامة التبويب "البيانات" لمشروع SIMCA مفتوح.
2. انقر فوق إضافة مصدر بيانات جديد
3. حدد SimApi كنوع الاتصال، وانقر فوق الزر ... وحدد موقع .dll في مجلد التثبيت، ثم انقر فوق فتح.
4. انقر فوق تكوين وراجع دليل مستخدم SimApi الفردي لمعرفة كيفية إجراء الإعدادات.
5. انقر فوق اختبار اتصال مصدر البيانات للتحقق من إمكانية الاتصال بقاعدة البيانات. قد يستغرق هذا وقتًا طويلاً إذا كان هناك العديد من tags في مصدر البيانات.
6. انقر فوق موافق لإكمال التكوين.
7. راجع تعليمات SIMCA لمعرفة كيفية العمل مع البيانات المستوردة.

إعداد SimApi للاستخدام في SIMCA-online

• هام: لكي تتمكن من استخدام SimApi، يلزم الحصول على ترخيص خادم SIMCA-online. لا يسمح التثبيت التجريبي لـ SIMCA-online باستخدام SimApis.
• لإضافة SimApi إلى النظام، قم بتشغيل خيارات خادم SIMCA-online على جهاز الكمبيوتر الخاص بالخادم. تعرف على الخطوات التفصيلية في موضوع تعليمات SICMA-online إضافة وتكوين SimApi على الخادم.
• نصيحة: إذا قمت بإجراء تغييرات على SimApi، فيمكنك إعادة تشغيل SimApi هذا بشكل منفصل من خيارات الخادم دون الحاجة إلى إعادة تشغيل الخادم بأكمله.
• لتكوين مثيلات متعددة من SimApi هذه، كرر الخطوات المذكورة أعلاه واستخدم أسماء فريدة لكل مثيل. اقرأ المزيد حول السجل والتكوين المختلفين files للحالات الموجودة في 4.2.

اختبار SimApi واستكشاف الأخطاء وإصلاحها

• يتناول هذا الفصل اختبار تثبيت SimApi واستكشاف الأخطاء وإصلاحها.

اختبار SimApi من SIMCA-online

• بمجرد بدء تشغيل خادم SIMCA-online بنجاح، يمكنك اختبار SimApi الخاص بك في SIMCA-online (إذا لم يبدأ الخادم، راجع 6.2):
• قم بتسجيل الدخول إلى الخادم في عميل SIMCA-online، وانتقل إلى Extract (استخراج) على File يساعدك استخراج البيانات على اختبار SimApi من خلال الحصول على البيانات من خلاله:
• يتم عرض العقد ("المجلدات") الخاصة بـ SimApi في المربع الأيسر. Tags بالنسبة للعقدة المحددة، يتم عرضها في أعلى اليمين.
• يمكن اختبار البيانات الحالية بسرعة بمجرد النقر فوق view> على tags التي توفر بيانات عملية مستمرة (انظر لقطة الشاشة)
• انقر بزر الماوس الأيمن على عقدة للعثور على الدفعات ضمن نطاق زمني. يجب أن تكون العقدة عقدة دفعات تعرف الدفعات.
• يختار tags في استخراج وانقر فوق التالي وأكمل المعالج للحصول على البيانات باستخدام أوضاع مختلفة لاسترجاع البيانات: البيانات الحالية والتاريخية والدفعية والمنفصلة.
• قارن البيانات المستخرجة بما تراه في مصدر البيانات باستخدام أدواته. تعرف على المزيد حول اختبار وإثبات صحة جميع ميزات SimApi في 7.13.

استكشاف مشكلات SimApi وإصلاحها باستخدام سجل SimApi file

• إذا لم يبدأ الخادم، أو لم يعمل SimApi كما هو متوقع أو فشل الاستخراج، فستحتاج إلى استشارة سجل SimApi file الذي يخبرك بماهية المشكلة. قم بتمكين تسجيل مستوى التصحيح في سجل SimApi للحصول على التفاصيل الكاملة. راجع 4.2.
• ملاحظة: سجلات خادم SIMCA-online ليست مفيدة هنا. ستوضح كيف تم تحميل SimApi وتهيئته بواسطة الخادم، ولكن التفاصيل الخاصة بـ SimApi موجودة في سجله file.

استخدم حساب خدمة SIMCA-online الصحيح

• عند اختبار الوصول إلى مصدر البيانات، تذكر أنك قمت بتسجيل الدخول كمستخدم محدد على كمبيوتر الخادم (عادةً حساب المستخدم الخاص بك في مجال Windows)، ولكن حساب خدمة خادم SIMCA-online هو حساب مختلف، افتراضيًا LocalSystem، والذي لديه حقوق وصول مختلفة مقارنة بحساب المستخدم الخاص بك.
• لهذا السبب، ليس من غير المألوف أن تعمل الاختبارات عند تشغيلها كحسابك، ولكن يفشل SIMCA-online في الاتصال بمصدر البيانات.
• لحل هذه المشكلة، يجب منح الوصول للحساب الذي تستخدمه خدمة خادم SIMCA-online. عادةً، تقوم بتغيير LocalSystem إلى حساب خدمة مجال معين، ومنح الحقوق لهذا الحساب. لاحظ أن هذا لا ينطبق إذا كان SimApi يستخدم بيانات اعتماد تم تعيينها في تكوين SimApi لأن هذه البيانات لها الأولوية.

التفاصيل الفنية حول SimApis

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

متى يجب أن نفكر في تطوير SimApi ومتى لا نفعل ذلك؟

قبل التفكير في تطوير SimApi لمصدر البيانات:

1. تحقق مما إذا كان هناك بالفعل واجهة SimApi يمكنك استخدامها. ربما يمكنك تمكين بعض الميزات في مصدر البيانات لديك لاستخدام إحدى واجهات SimApi الموجودة، مثل OPC UA.
2. قم بمراجعة هذه الوثيقة ومراجعها بعناية وتحقق مما إذا كان مصدر البيانات الخاص بك يفي بالمتطلبات: على سبيل المثالampنعم، يجب أن يكون سريعًا بدرجة كافية، ولا يوفر البيانات الحالية فحسب، بل أيضًا البيانات التاريخية.

• ولهذه الأسباب، لا نوصي بتطوير واجهة SimApi التي تتصل بأجهزة أو أدوات منخفضة المستوى. ومن الأفضل توصيل هذه الأدوات بمؤرخ العمليات مثل Aveva PI System، والسماح له بالحصول على البيانات من الأداة، وحفظها في سجل تاريخي. ومن ثم يمكن استخدام واجهة SimApi PIAF للحصول على البيانات من PI إلى منتج Umetrics.

تطوير SimApi ومواصفات SimApi

• تحتوي مواصفات SimApi، SimApi-v2، على توثيق لجميع وظائف C في SimApi التي يحتاج SimApi DLL إلى تنفيذها بالإضافة إلى بعض الإرشادات حول كيفية تطوير SimApi.
• في معظم الحالات، يكون تنفيذ SimApi باستخدام C أو C++ على مستوى منخفض بشكل غير ضروري.
• الطريقة الموصى بها والأسهل لتنفيذ SimApi هي أن تستند إلى Exampكود مصدر leSimApi الذي نقدمه. إنه عبارة عن نسخة سابقةampتطبيق SimApi الذي يتعامل مع واجهة C ويترجمها إلى إطار عمل .NET حيث يتم التنفيذ الفعلي. كما يحتوي على كود إطار عمل لتسجيل الدخول والإعدادات وواجهة المستخدم الرسومية للتكوين وكود إطار عمل آخر.
• لتطوير SimApi، يحتاج فريق المطورين إلى خبرة في تطوير Windows أو .NET Framework أو C أو C++. كما يلزم معرفة جيدة بمصدر البيانات الذي يجب أن يتصل به SimApi، لأن الغرض من SimApi هو ترجمة طلبات البيانات من SIMCA-online أو SIMCA إلى واجهة برمجة التطبيقات لمصدر البيانات. إن تنفيذ SimApi ليس مشروعًا لمرة واحدة، ولكنه يحتاج عادةً إلى دعم مستمر وصيانة عرضية.

قراءة أو كتابة البيانات

• تتمثل المهمة الرئيسية لـ SimApi في توفير البيانات من مصدر البيانات. ويشار إلى ذلك باسم قراءة البيانات.
• تدعم معظم تطبيقات SimApi أيضًا كتابة البيانات. وهذا يعني إعادة كتابة البيانات عبر SimApi إلى مصدر البيانات. وتعد كتابة البيانات ميزة اختيارية في SIMCA-online.

Tags والعقد

• A tag هو معرف لعمود أو "متغير" في مصدر البيانات. tagيتم استخدام اسم "" للتعريف "" tagيجب أن تكون الأسماء داخل العقدة فريدة. SIMCA-online 18 هو الإصدار الأول الذي يدعم العقدة التي تحتوي على عقدة فرعية و tag بنفس الاسم. على سبيل المثالample: قد يكون للعقدة الأساسية عقدة فرعية تسمى Batch و tag تسمى الدفعة.
• العقدة هي حاوية لـ tagsيمكن أن تحتوي العقدة أيضًا على عقد أخرى، على نحو مماثل لكيفية file يحتوي النظام على مجلدات داخل مجلدات.
• مثل في file النظام والعقدة و tag يمكن دمج الأسماء في مسار كامل يحدد بشكل فريد tag. ال tag يتم استخدام المسارات في SIMCA-online أو SIMCA عند التحديد tags للإستخدام. أ tag يبدأ المسار باسم مثيل SimApi متبوعًا بهيكل العقدة، وينتهي بـ tag الاسم، كل عنصر مفصول بعلامة النقطتين (:). على سبيل المثالample “:ODBCSQLServer:Node:SensorTag1”.

يقوم SimApi بحصر tags والعقد عند بدء التشغيل

• يقوم تنفيذ SimApi بتصفح الخادم بحثًا عن العقد و tags في مصدر البيانات عند تهيئة SimApi ويتابعها حتى يتم تحديد وظائف SimApi المختلفة المستخدمة في الترقيم tags ويمكن تنفيذ العقدة.
• لا تتم عملية تهيئة SimApi عند بدء تشغيل الخادم فحسب، بل يمكن أيضًا إعادة تشغيلها بواسطة مستخدم في SIMCA-online باستخدام وظيفة Refresh SimApi.

حساسية الحالة لـ tag- وأسماء العقد

• Tag الأسماء وأسماء العقد حساسة لحالة الأحرف.
• وهكذا، أ tag مُسَمًّى "tag1" ليس هو نفسه "Tag1" بسبب اختلاف حالة الحرف "T". نوصي بعدم استخدام tags أو أسماء العقد التي تختلف فقط في الحالة.

عقدة عملية مستمرة 

• عندما تحتوي العقدة على tags مع بيانات العملية المستمرة، يمكن الإشارة إليها باسم عقدة العملية. تُظهر لقطتا الشاشة التاليتان تمثيلًا جدوليًا لعقدة عملية مع البيانات متبوعة بصورة توضح كيف تبدو العقدة عند التحديد tags في SIMCA-online.

يجب أن تكون عقد العمليات المستمرة مستقلة عن الدفعات أو التشغيلات أو الوقت

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

معرف الدفعة tag مطلوب في عقد العمليات المستمرة لتنفيذ المشروع الدفعي

• يجب أن يكون لكل عملية مستمرة tag (متغير) يحمل معرف الدفعة لكل ملاحظة. يستخدم SIMCA أو SIMCA-online معرف الدفعة هذا لمعرفة الدفعة التي تنتمي إليها كل ملاحظة.
• معرف الدفعة $BatchID tag في لقطات الشاشة في الإصدار 7.4.3 يوجد مثل هذا المثالampليه.
  على الرغم من عدم الحاجة إلى ذلك، فمن المستحسن أن يكون لديك tag في عقدة العملية التي تعرض المرحلة أو الخطوة الحالية من العملية. هذا tag يمكن بعد ذلك استخدامها في ظروف تنفيذ الطور في SIMCA-online أو في SIMCA عند استيراد البيانات. القيم الخاصة بهذا tag يمكن أن يكون على سبيل المثالamp"المرحلة 1"، "التنظيف"، "المرحلة 2".

عقدة سياق الدفعة

• عقدة الدفعة هي عقدة تتعقب الدفعات؛ ومعرفات الدفعات الخاصة بها، وأوقات البدء، وأوقات الانتهاء. وهي شرط لتنفيذ مشروع الدفعات في SIMCA-online. يمكن أن يحتوي مصدر البيانات على أكثر من عقدة دفعة تعرض الدفعات بطرق مختلفة. يختار المستخدم عقدة الدفعة التي تنطبق على تطبيقه. هذا على سبيل المثالampيعرض الدفعات التي تمتد على وحدتين مختلفتين:
• /Factory1 – دفعات ذات أعمار مجمعة على كل من الوحدة 1 والوحدة 2.
• /Factory1/Unit1 – دفعات ذات أعمار في Unit1 فقط
• /Factory1/Unit2 – دفعات ذات أعمار في Unit2 فقط
• إذا لم يكن لديك عقدة دفعة في مصدر البيانات الخاص بك، فيمكنك استخدام Batch Context Generator في SIMCA-online. راجع التعليمات المضمنة.
• بيانات الدفعة الاختيارية
• يمكن أن تحتوي عقدة الدفعة أيضًا على بيانات الدفعة؛ البيانات التي لا يوجد لها سوى ملاحظة واحدة للدفعة بأكملها. لاحظ أن tags لا يلزم أن تكون البيانات المجمعة في عقدة تتمتع بالوظائف الكاملة لعقدة الدفعة. يكفي أن يدعم SimApi قراءة البيانات المجمعة لـ tags. تعرف على المزيد حول بيانات الدفعة في 7.6.
• هنا مثال سابقampجزء من عقدة الدفعة:
• ملاحظة: تم التقاط لقطة الشاشة أعلاه من DBMaker، المرفقة مع SIMCA-online. لرؤية ذلك بنفسك في DBMaker، انقر فوق View زر البيانات في قاعدة بيانات الخميرة الخبازية لعرض نافذتين، واحدة منها هي عقدة الدفعة، والأخرى هي بيانات العملية.

أنواع البيانات: البيانات الرقمية، والبيانات النصية، والبيانات المفقودة

• لكل واحد tagيمكن لـ SimApi دعم ثلاثة أنواع من البيانات: رقمية، ونصية، ورقمية، ومفقودة:
• البيانات الرقمية هي في العادة قيم حقيقية لمعلمات العملية، على سبيل المثالamp6.5123. لا يمكن لـ SimApi التعامل إلا مع قيم الفاصلة العائمة ذات الدقة المفردة 32 بت. تنسيق الفاصلة العائمة ذات الدقة المفردة - ويكيبيديا. يجب تحويل جميع أنواع البيانات الرقمية الأخرى في مصدر البيانات إلى قيم عائمة. وبالتالي، يمكنها التعامل مع القيم الكبيرة والصغيرة ولكن مع حوالي 6 أو 7 أرقام مهمة فقط. تعرف على المزيد في الدليل الفني.
• قد يؤدي هذا إلى فقدان الدقة للأعداد الصحيحة الكبيرة أو للأعداد الحقيقية الكبيرة والتي تحتوي على أرقام عشرية. لمزيد من المعلومات، راجع الدليل الفني.
• تُستخدم بيانات النص/السلسلة لمعرفات الدفعة أو شروط تنفيذ المرحلة أو للمتغيرات النوعية. القيم الخاصة بالنص tag البيانات حساسة لحالة الأحرف. وهذا يعني أن القيمة "running" ليست هي نفسها
  "RUNNING". لا يتم دعم متغيرات التاريخ والوقت بشكل مباشر بواسطة SimApi، ولكن يمكن إرجاعها كسلسلة بتنسيق YY-MM-DD HH:MM (على سبيل المثالample “2020-09-07 13:45”).
• القيم المفقودة تعني عدم وجود قيمة يمكن إرجاعها، أي عدم وجود بيانات.
• يعتمد نوع البيانات التي يتم إرجاعها على تنفيذ SimApi. يعرف SimApi البيانات الموجودة في مصدر البيانات ويجب أن يعيد نوع البيانات الذي يناسبه بشكل أفضل.

ثلاثة طرق لاسترجاع البيانات: مستمر، دفعة واحدة، ومنفصل

• تحدد مواصفات SimApi ثلاثة أوضاع لاسترجاع البيانات، أي ثلاث طرق مختلفة يمكن لـ SimApi من خلالها توفير البيانات من tags في مصدر البيانات (أو في الاتجاه الآخر: اكتب البيانات إلى tags في مصدر البيانات).
• الاسترجاع المستمر للبيانات – يشير هذا إلى قراءة البيانات بشكل مستمر، وبشكل متسلسل، ملاحظة لكل ملاحظة مع تطور الدفعة أو العملية. تتم قراءة البيانات للوقت الحالي، أو لنطاق محدد، على فترات منتظمة بين الملاحظات. على سبيل المثالampنعم، جميع البيانات بين 09:00:00 و10:00:00 ثانيةampيتم إجراء هذه القياسات كل 60 ثانية، مما يؤدي إلى 61 ملاحظة عندما تكون النقاط النهائية شاملة.
• استرجاع البيانات دفعة واحدة – يشير هذا إلى ملاحظة واحدة تحتوي على بيانات دفعة كاملة (غير مرتبطة بنقطة نضج أو وقت محددة). تتم قراءة سمات الدفعة وبيانات التمركز المحلية كبيانات دفعة في SIMCA-online. تتم قراءة شروط الدفعة عادةً كبيانات دفعة أيضًا (ما لم يتم تكوينها لاسترجاع البيانات المنفصلة).
• استرجاع البيانات المنفصلة - يمكن أن تتكون البيانات المنفصلة من عدة ملاحظات لعدة فترات استحقاق. ولكن على عكس البيانات المستمرة، لا تتم قراءة البيانات المنفصلة بشكل متسلسل بل تتم قراءة جميع البيانات دفعة واحدة لمرحلة معينة من الدفعة. لا يلزم تباعد البيانات بفواصل زمنية منتظمة لمتغير الاستحقاق. تتم إعادة قراءة جميع البيانات في كل مرة يتم فيها طلب البيانات، عند الفاصل الزمني المحدد.
• لأي شيء معين tag يمكن طلب البيانات في أي من الأوضاع الثلاثة، ولكن عادةً ما يدعم SimApi أحد هذه الأوضاع فقط لشخص واحد tag. كما يجوز خلط tags داخل العقدة، ولكن عادةً ما تكون جميعها tags ضمن عقدة محددة تدعم نفس طريقة استرجاع البيانات.
• بالنسبة للبيانات المستمرة (ولكن ليس للبيانات الدفعية أو المنفصلة2)، يمكن تقديم طلبات للحصول على البيانات الحالية أو البيانات التاريخية وهو موضوع القسم التالي.
• لا تدعم جميع واجهات SimApi جميع الأوضاع. راجع مصفوفة الميزات أعلاه وواجهة SimApi web الصفحة للتفاصيل.

البيانات المستمرة الحالية والتاريخية من خلال SimApi

• تشير البيانات المستمرة إلى بيانات العملية التي تتغير بمرور الوقت.

البيانات الحالية

• قراءة البيانات الحالية تعني سؤال مصدر البيانات عن أحدث قيم tags في وقت السؤال. لاحظ أنه لا يتم استخدام وقت مصدر البيانات الخارجي هنا.
• البيانات التي تقرأ كبيانات حالية هي ما سيعرضه SIMCA-online كبيانات حية. ولهذا السبب، من المهم عدم وجود تأخيرات غير ضرورية في مصدر البيانات. يجب أن تكون البيانات الحالية حديثة قدر الإمكان للعمل بشكل جيد في SIMCA-online.
• قد يستخدم مصدر البيانات معرفته بالبيانات ومدة صلاحية القيم ويقرر إرجاع البيانات المفقودة عندما تكون البيانات الخام لنقطة زمنية قديمة للغاية. على سبيل المثالample: يتم طلب البيانات في الساعة 15:00:00 ولكن أحدث نقطة بيانات في مصدر البيانات هي من الساعة 03:00:00. في هذه الحالة، يبلغ عمر البيانات 12 ساعة، لذا قد يقرر SimApi إرجاع قيمة مفقودة (لا توجد بيانات).

البيانات التاريخية

• قراءة البيانات التاريخية تعني سؤال مصدر البيانات عن قيم واحدة أو أكثر tags لفترة زمنية محددة بفاصل زمني محدد بين الملاحظات. لاحظ هنا أن الوقت المحلي لمصدر البيانات هو الذي يتم استخدامه للعثور على البيانات. لذلك، فإن مزامنة الوقت بين مصدر البيانات والخوادم أمر مهم.
• تتكون البيانات التاريخية من مصفوفة من البيانات. الأمر متروك لتطبيق SimApi لطلب البيانات من مصدر البيانات،ampاتركه عند الفاصل الزمني المحدد وقم بإنشاء مصفوفة البيانات التي سيتم إرجاعها:
• في بعض الأحيان، يحتوي مصدر البيانات نفسه على وظائف تجميع لإرجاع البيانات المعالجة، أوampوظائف ling، التي يمكن استخدامها لإرجاع البيانات الصحيحة.
• بالنسبة لمصادر البيانات الأخرى، يجب على SimApi طلب جميع البيانات في النطاق الزمني ثمampاتخذ الملاحظات الصحيحة لبناء المصفوفة.
• يجب إرجاع البيانات لنطاق زمني، حتى وإن لم تكن هناك بيانات خام في النطاق الزمني، ولكن فقط قبل وقت البدء. على سبيل المثالample: توجد بيانات في مصدر البيانات عند نقطتي الوقت 10 و20. يطلب SimApi بيانات للوقتين 15 و17. في هذه الحالة، يجب إرجاع قيم نقطة الوقت 10 بواسطة SimApi ولكن الوقتampتم تعديلها على أنها الوقت 15 و17 حيث كانت هذه أحدث نقاط البيانات في تلك الأوقات. القيم لـ tags في الوقت 10 يشار إليها بقيم الحدود للنطاق المطلوب. للحصول على شرح أعمق لقيم الحدود، راجع على سبيل المثالampاطلع على الوثائق الخاصة بـ returnBounds في UA الجزء 11: الوصول التاريخي – 6.4.3 بنية ReadRawModifiedDetails
  (opcfoundation.org)
• لا ينبغي أبدًا استخدام الاستيفاء لحساب قيم نقاط زمنية مستقبلية، لأن البيانات لن تتطابق مع ما يتم قراءته في الوقت الفعلي مثل البيانات الحالية. بالنسبة للمثال السابقampمن النقطة السابقة: إذا تم استيفاء البيانات الخاصة بالرقمين 15 و17 باستخدام القيم الخاصة بالعنصرين 10 و20، فسوف يستخدمون فعليًا القيم من المستقبل، وهو أمر غير مسموح به.
• قد يستخدم مصدر البيانات معرفته بالبيانات ومدة صلاحية القيم ويقرر إرجاع البيانات المفقودة عندما تكون البيانات الخام لنقطة زمنية قديمة جدًا. على سبيل المثالample: يتم طلب البيانات للساعة 15:00:00 ولكن أحدث نقطة بيانات في مصدر البيانات هي من الساعة 03:00:00. في هذه الحالة، تكون البيانات قديمة منذ 12 ساعة، لذا قد يقرر SimApi إرجاع قيمة مفقودة (لا توجد بيانات).

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

يجب أن تتطابق البيانات الحالية مع البيانات التاريخية

• في بعض الأحيان قد تكون هناك اختلافات عند قراءة البيانات كبيانات حالية في الوقت الفعلي أو بيانات تاريخية. ويتسبب هذا في حدوث مشكلات في SIMCA-online لأن الخادم يقوم بالتبديل تلقائيًا بين البيانات الحالية والتاريخية حسب الحاجة.

اكتساب البيانات ذات زمن الوصول المنخفض

• عند استخدام مصدر بيانات بواسطة SIMCA-online في الوقت الفعلي، من المهم أن تكون البيانات الموجودة في مصدر البيانات محدثة. لا ينبغي أن يكون هناك تأخيرات غير ضرورية في الحصول على البيانات في مصدر البيانات. يجب أن تكون بيانات العملية المستمرة لجميع المتغيرات متاحة في نفس الوقت لكل ملاحظة. لن يتم التقاط البيانات التي تصل متأخرة لبعض المتغيرات بواسطة SIMCA-online.

يمكن قراءة البيانات في أي وقت 

• عندما يطلب موقع SIMCA-online قيمة tag بالنسبة للوقت t، سيستقبل القيمة من مصدر البيانات من الوقت t، أو أحدث ملاحظة في مصدر البيانات قبل الوقت t، أو قيمة مُقحَمة للوقت t. وبالتالي، سيحصل الخادم دائمًا على قيمة في كل مرة يطلبها، حتى لو لم تكن ملاحظة لهذه النقطة الزمنية الدقيقة موجودة في مصدر البيانات.
• توقيتampتكون الأوقات في SimApi دائمًا بتوقيت UTC. يعرض عملاء SIMCA-online وSIMCA الوقت بالتوقيت المحلي.

الخيط 

• يتم استدعاء SimApi افتراضيًا بواسطة خيط واحد بواسطة مستخدم SimApi. ينطبق هذا على جميع إصدارات SIMCA وSIMCA-online حتى الإصدار 17.
• يدعم SIMCA-online 18 علامة ميزة لتشغيل الوصول متعدد الخيوط عبر SimApi. اقرأ المزيد في موضوع المساعدة الوصول المتزامن إلى SimApi.
• يعني هذا أن SimApis يجب أن يستعد للتعدد في العمليات، إذا كان ذلك ممكنًا، من خلال جعل تنفيذ SimApi آمنًا، وتوثيق هذا وأي اعتبارات لمستخدمي SimApi.

سجل file

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

معالجة الأخطاء

• عندما لا يتمكن SimApi من تلبية طلب من مصدر البيانات، فإنه يمكنه التعامل مع هذه المشكلة بإحدى طريقتين؛ عن طريق إرجاع القيم المفقودة (لا توجد بيانات) أو عن طريق الإشارة إلى خطأ SimApi:
• إن إرجاع القيم المفقودة إلى المتصل والإشارة إلى النجاح يسمح للمتصل بالاستمرار بشكل طبيعي (ولكن بالطبع بدون أي بيانات). هذه ممارسة موصى بها للأخطاء الجزئية مثل عندما يمكن الحصول على البيانات لبعض، ولكن ليس كلها، tags في طلب.
• يتيح الإشارة إلى خطأ SimApi للمتصل (على سبيل المثالamp(قم بزيارة خادم SIMCA-online) لرؤية ذلك على الفور والتصرف. هذه ممارسة موصى بها للطلبات التي تفشل تمامًا ولا يمكنها إرجاع أي بيانات على الإطلاق.
• تتعامل SIMCA-online مع القيم المفقودة أو رموز الخطأ بشكل مختلف، كما هو موضح في الدليل الفني لـ SIMCA-online.

متطلبات أداء SimApi

• يتم استخدام الوظائف في SimApi للحصول على البيانات.
• إذا كان الوصول إلى البيانات بطيئًا، فلن يعمل SimApi بشكل جيد، وهذا هو السبب وراء ذلك.ampيظهر ما يلي: إذا طلب SIMCA-online بيانات كل ثانية، ولكن يستغرق الحصول عليها ثانيتين، فلن يتمكن خادم SIMCA-online أبدًا من مواكبة الطلب في الوقت الفعلي، بل سيتراجع تدريجيًا أكثر فأكثر.
• في الأقسام الفرعية، سنوضح كيف يستخدم SIMCA وSIMCA-online وظائف SimApi للوصول إلى البيانات ومدى تكرار استدعاء وظائف SimApi. يمكن أن يساعد هذا في تحديد متطلبات الأداء لتطبيق SimApi.

استخدام SIMCA لوظائف SimApi

• عندما يستخدم SIMCA سطح المكتب أو المنتجات الأخرى غير المتصلة بالإنترنت SimApi للحصول على البيانات، ستكون هذه الطلبات للدفعات ومعالجة البيانات لمجموعة من المتغيرات في نطاق زمني معين.
• نظرًا لأن هذه الطلبات يتم بدؤها يدويًا بواسطة المستخدم، فهي لا تحدث بشكل متكرر ولا تتسبب في تحميل كبير لمصدر البيانات.
• يتم استخدام وظائف SimApi هذه للحصول على البيانات:
• simapi2_nodeاحصل على دفعات نشطة
• simapi2_nodeالحصول على أوقات الدفعة
• simapi2_connectionReadHistoricalDataEx

استخدام SIMCA-online لوظائف SimApi

• يتم استخدام SIMCA-online لمراقبة عملية في الوقت الفعلي، وبالتالي يطلب البيانات من خلال SimApi على فترات منتظمة. أقصر فترة تنفيذ يمكن استخدامها هي ثانية واحدة. بعض التجارب في العالم الحقيقيampفترات التنفيذ القصيرة هي 10 ثوانٍ، أو دقيقة واحدة، أو 1 دقائق.
• يمكن أن يحتوي الخادم على العديد من المشاريع قيد التشغيل في نفس الوقت.
• لتقليل عدد مكالمات API من خلال SimApi، يقوم الخادم بتحسين طلبات البيانات من خلال تجميع العديد من الطلبات الأصغر حجمًا المتزامنة في طلب واحد أكبر لجميع المتغيرات في نفس الوقت (تعرف على المزيد في موضوع المساعدة "القراءة المحسّنة من مصادر البيانات تعمل على تحسين الأداء").
• تعمل خوارزمية تنفيذ الخادم على النحو التالي عندما يطلب البيانات باستخدام وظائف SimApi المدرجة أدناه:
• يتم تجميع جميع المراحل التي يتم تنفيذها في نفس الفترة الزمنية في مكالمة SimApi واحدة لتقليل عدد المكالمات. يقرأ الخادم أحدث البيانات لجميع المتغيرات المستخدمة بواسطة جميع النماذج التي تشترك في الفترة الزمنية، أي أن هذه المكالمة ستؤدي إلى صف بيانات واسع يتم استخدامه بعد ذلك بواسطة جميع المشاريع.
  • simapi2_connectionقراءة البيانات الحالية
• بالنسبة لكل مشروع دفعة، يحتاج الخادم أيضًا إلى معرفة الدفعات النشطة. يجب أن يحدث هذا أيضًا في كل مرة يتم فيها تنفيذ مشروع:
  • simapi2_nodeاحصل على دفعات نشطة
  • يتم استدعاء simapi2_nodeGetBatchTimes بشكل أقل.
• بالإضافة إلى ذلك، يتطلب SIMCA-online أيضًا بيانات تاريخية. تحدث هذه الطلبات فقط عند الحاجة إليها، مثل اللحاق ببداية الدفعة التي بدأت قبل بدء SIMCA-online، أو عندما يتأخر الخادم ويحتاج إلى قراءة كتلة من البيانات:
  • simapi2_connectionReadHistoricalDataEx
• اختياريًا، تستخدم بعض تكوينات المشروع ميزات تستخدم بيانات الدفعة أو البيانات المنفصلة مما يؤدي إلى استدعاءات SimApi إلى:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• اختياريًا، تستخدم بعض تكوينات المشروع الكتابة العكسية لدفع البيانات مرة أخرى إلى مصدر البيانات:
  • simapi2_connectionWriteHistoricalDataEx (والوظائف المقابلة لبيانات الدفعة والبيانات المنفصلة)
• من المهم أن تكون كل مكالمة إلى الوظائف الأساسية للحصول على البيانات، readCurrentData، getActiveBatches/getBatchTimes، سريعة وألا يكون ذلك صعبًا حسابيًا بالنسبة لمصدر البيانات نفسه، نظرًا لتكرار استدعاء SIMCA-online لهذه الوظائف.

اختبار بيانات SimApi والتحقق من صحتها

• يتناول هذا القسم اختبار SimApi للتحقق من أن البيانات المسترجعة منه تتطابق مع البيانات الموجودة في مصدر البيانات نفسه. يعد إجراء اختبارات مثل هذه أمرًا مهمًا بعد إنشاء أو تغيير تنفيذ SimApi، أو عند تغيير واجهة برمجة التطبيقات لمصدر البيانات.
• في الممارسة العملية، يتم التحقق من صحة البيانات باستخدام SIMCA-online ووظيفة Extract الخاصة به لسحب البيانات من مصدر البيانات عبر SimApi ثم مقارنتها بالبيانات الخام في مصدر البيانات. لا يمكن استخدام Desktop SIMCA لاختبار الجوانب في الوقت الفعلي لـ SimApi.

الإستعدادات والمتطلبات

• بعض العناصر اختيارية ولكن يمكن تنفيذها إذا كان نطاق الاختبار الخاص بك يشمل ذلك:

1. قم بتثبيت SIMCA-online كما هو موضح في ملف ReadMe ودليل التثبيت.pdf الذي يأتي مع ملف zip للمنتج.
2. احصل على ترخيص لخادم SIMCA-online وقم بتثبيته. لن تعمل واجهة SimApi بدون ترخيص. توضح مقالة قاعدة المعرفة الخاصة بـ SIMCA-online كيفية ترخيص المنتج. على سبيل المثالampلو: SIMCA-online 18 (sartorius.com)
3. قم بتثبيت وتكوين SimApi الذي تريد اختباره. راجع الفصول 4 و5 في هذه الوثيقة ودليل المستخدم الخاص بـ SimApi المحدد.
   • a. اختياري: تأكد من أن دليل المستخدم محدث وصحيح.
4. تأكد من أن لديك أداة لمصدر البيانات الخاص بك والتي يمكنك استخدامها لمقارنة بيانات SimApi بها.
5. في عميل سطح المكتب SIMCA-online، قم بتسجيل الدخول إلى خادم SIMCA-online الخاص بك واستخدم File > استخراج للحصول على البيانات من خلال SimApi.
6. اختياري إذا كان نطاق الاختبار الخاص بك يتضمن ذلك: بعد الانتهاء من الاختبار، قم بإلغاء تثبيت SimApi والتحقق منه fileتتم إزالة الصورة.

ماذا يجب اختباره

• تسرد مصفوفة الميزات في الفصل 3 جميع الميزات المحتملة، ولكن قد يدعم تنفيذ SimApi معين مجموعة فرعية فقط. يجب عليك اختبار جميع الميزات التي يتم تنفيذها بواسطة SimApi المحدد.
• الاختبارات التالية مشتركة بين معظم تنفيذات SimApi:
• المصادقة باستخدام أسماء المستخدمين وكلمات المرور
• اختبار الإعدادات المختلفة في تكوين SimApi
• التسلسل الهرمي للعقد: العقد و tags المعلومات التي تم الكشف عنها بواسطة SimApi صحيحة.
  • يجب أن يكون هناك tag تم عرض جميع "المتغيرات" التي يجب أن تكون متاحة من خلال SimApi.ampالمفاهيم: قياسات العملية، والقيم المحسوبة، والثوابت.
• مرونة الاتصال: إذا كان مصدر البيانات غير متاح، فسيؤدي هذا إلى ظهور تحذيرات أو أخطاء في السجل file، ولكن يتم إعادة الاتصال بمصدر البيانات تلقائيًا عند توفر مصدر البيانات.
• حالات متعددة: يمكن تكوين حالتين واستخدامهما بشكل مستقل وفي نفس الوقت، مع سجلات منفصلة files.
• البيانات الحالية: استخراج البيانات الحالية لـ tagsتأكد من أن البيانات هي آخر القيم المعروفة من مصدر البيانات، أو أنها مفقودة بسبب الجودة الرديئة أو عندما تكون البيانات قديمة للغاية.
  • استخرج البيانات كل 10 ثوانٍ (أو نحو ذلك) لمدة دقيقة.
• البيانات التاريخية المستمرة: استخراج البيانات التاريخية لـ tags.
  • استخدم نطاق الوقت الذي يتطابق مع وقت استخراج البيانات الحالية. تأكد من أن البيانات الحالية تتطابق مع البيانات التاريخية والبيانات الخام في مصدر البيانات.
  • حاول تجربة نطاقات زمنية مختلفةampفترات زمنية محددة، للتحقق من تطابق البيانات مع مصدر البيانات.
  • حاول استخراج البيانات كل ثانية واحدة، وهي أقصر مدة ممكنةampالفاصل الزمني لينغ.
  • جرب أنواعًا مختلفة من tags في مصدر البيانات (متغيرات العملية، وما إلى ذلك)، والتأكد من تطابق البيانات.
  • ملاحظة: قد يقوم SIMCA-online بتقسيم طلب بيانات تاريخية كبير واحد إلى عدة أجزاء أصغر. سيكون هذا واضحًا في سجل SimApi.
• تأكد من أن SimApi يعمل مع البيانات النصية والبيانات الرقمية والبيانات المفقودة.
• سجل SimApi file. تأكد من أن السجل يحتوي على إدخالات معقولة.
• عقدة الدفعة: انقر بزر الماوس الأيمن فوق العقدة ثم قم بالبحث عن الدفعات.
  • التحقق من أسماء الدفعات، وأوقات البدء، وأوقات الانتهاء للدفعات.
  • جرِّب دفعة نشطة قيد التشغيل في مصدر البيانات. لا ينبغي أن يكون لها وقت انتهاء من خلال SimApi.
• معرف دفعة عقدة العملية tagإذا كان لدى SimApi وظيفة عقدة الدفعة (انظر النقطة السابقة)، فيجب أن يكون لديه أيضًا معرف دفعة tag في عقدة بيانات عملية المطابقة. البيانات الخاصة بهذا tag يجب أن يكون معرف الدفعة (اسم الدفعة). هذه البيانات مطلوبة لمشاريع الدفعات لتحديد الدفعة التي ينتمي إليها صف من البيانات.

اعتمادًا على ما إذا كان SimApi يدعم ذلك، فقد ترغب أيضًا في اختبار:

• بيانات الدفعة باستخدام File > استخراج.
• البيانات المنفصلة باستخدام File > استخراج. ملاحظة: لاختبار البيانات المنفصلة باستخدام File > قم باستخراج العقدة، ويجب أن تكون عقدة الدفعة وعقدة البيانات المنفصلة في نفس SimApi (عندما ينفذ SIMCA-online المشاريع، يمكن أن تكون من SimApis مختلفة).
• الكتابة مرة أخرى – دفع دفعة البيانات إلى مصدر البيانات. لاختبار ذلك، يجب عليك تكوين تكوين مشروع في SIMCA-online لكتابة متجهات البيانات مرة أخرى إلى مصدر البيانات. ثم قم بتنفيذ المشروع في SIMCA-online وتحقق من البيانات التي تمت كتابتها مرة أخرى في مصدر البيانات.
• يتم تكوين البيانات المستمرة على صفحة Evolution Write Back في تكوين المشروع.
• يتم تكوين البيانات المنفصلة على نفس الصفحة، ولكن فقط لمرحلة تم تكوينها لاسترجاع البيانات المنفصلة.
• بيانات الدفعة من Batch Write back

المزيد من المعلومات

• Sartorius Stedim تحليلات البيانات AB Östra Strandgatan 24 903 33 أوميو السويد
• هاتف: + 46 90-18 48 00
• www.sartorius.com
• المعلومات والأرقام الواردة في هذه التعليمات تتوافق مع تاريخ الإصدار المحدد أدناه.
• تحتفظ سارتوريوس بالحق في إجراء تغييرات على التكنولوجيا والميزات والمواصفات وتصميم المعدات دون إشعار مسبق. يتم استخدام صيغ المذكر أو المؤنث لتسهيل وضوح هذه التعليمات وتشير دائمًا في نفس الوقت إلى جميع الأجناس.
  حقوق التأليف:
• هذه التعليمات، بما في ذلك جميع المكونات، محمية بموجب حقوق الطبع والنشر.
• أي استخدام خارج حدود قانون حقوق النشر غير مسموح به دون موافقتنا.
• وينطبق هذا بشكل خاص على إعادة الطباعة والترجمة والتحرير بغض النظر عن نوع الوسائط المستخدمة.

التعليمات

• س: ما هو الغرض من SimApis؟
  • ج: الغرض الرئيسي من SimApis هو توفير البيانات لمنتجات Umetrics Suite لإنشاء المشاريع وبناء النماذج.
• س: كيف يمكنني استكشاف الأخطاء وإصلاحها مع تثبيت SimApi؟
  • ج: يمكنك استكشاف الأخطاء وإصلاحها عن طريق الاختبار من SIMCA-online، والتحقق من سجل SimApi file، والتأكد من تكوين حساب الخدمة الصحيح.

المستندات / الموارد

برنامج SARTORIUS Sim Api [بي دي اف] دليل المستخدم برنامج Sim Api، برنامج Api، برنامج

مراجع

• دليل المستخدم