التوثيق الآلي و
تقارير الامتثال لـ TIA Portal
أنشئ تقارير مشروع كاملة، ومستندات اختبار قبول FAT/SAT، وحزم تسليم المشروع بأمر واحد - دون جمع بيانات يدويًا، ودون عمل تنسيق.
أربعة أنواع من التقارير، أمر واحد
من نظرة فنية سريعة إلى حزمة امتثال موقعة
تقرير المشروع
توثيق فني كامل لمشروع TIA Portal. يغطي تكوين الأجهزة، وطوبولوجيا الشبكة، وقائمة الإدخال/الإخراج (I/O)، وكتل البرامج، والعلامات (tags)، و UDTs، وشاشات HMI، والمراجع التبادلية، وحالة التجميع. المستند الأساسي لأي تسليم للمشروع.
تقرير FAT
تقرير اختبار قبول المصنع (Factory Acceptance Test) يجمع بين تقرير المشروع الكامل ونتائج الاختبارات الآلية، ولقطة VCS لحالة المشروع وقت الاختبار، وصفحة التوقيع. يتم إنتاجه في نهاية اختبار المصنع قبل الشحن.
تقرير SAT
تقرير اختبار قبول الموقع (Site Acceptance Test) بنفس هيكل تقرير FAT، مصمم للتكليف في الموقع. يوثق الحالة النهائية للنظام المثبت والمكلف.
تسليمات المشروع
أرشيف ZIP كامل يجمع بين تقرير PDF، وتصدير بيانات XLSX، وأرشيف TIA Portal .zap20، ولقطة VCS. كل ما يحتاجه العميل أو نظام الأرشفة في ملف واحد.
ماذا يحتوي تقرير المشروع
يتم استخراجه تلقائيًا من مشروع TIA Portal المباشر - دون إدخال بيانات يدويًا
- تكوين الأجهزة: الرفوف، الوحدات، إصدارات البرامج الثابتة، تعيينات الفتحات
- طوبولوجيا الشبكة: حلقات PROFINET، والشبكات الفرعية، وعناوين IP، واتصالات الأجهزة
- قائمة I/O كاملة: العناوين الفعلية، والأسماء الرمزية، وأنواع البيانات، والأوصاف
- جرد كتل البرامج: OBs و FBs و FCs و DBs مع الأحجام وتواريخ التعديل
- جداول العلامات: جميع علامات PLC مع العناوين والأنواع والتعليقات
- أنواع البيانات المحددة من قبل المستخدم (UDTs): تعريفات الهيكل وتفاصيل الأعضاء
- شاشات HMI: قائمة الشاشات، وعدد العناصر، ونظرة عامة على روابط العلامات
- تحليل المراجع التبادلية: أين يتم استخدام كل علامة وكتلة في جميع أنحاء المشروع
- حالة التجميع: آخر نتيجة بناء، والأخطاء، والتحذيرات لكل جهاز
تنسيقات الإخراج
يخدم كل تنسيق جمهورًا وسير عمل مختلفًا
تقرير PDF
مستند قابل للقراءة البشرية للعملاء والمدققين وأرشيفات المشاريع. أقسام وجداول منظمة وصفحة غلاف. جاهز للطباعة أو التوقيع الرقمي.
تصدير بيانات XLSX
جدول بيانات قابل للقراءة آليًا لمزيد من التحليل، أو الاستيراد إلى أنظمة ERP/MES أو مسارات التقارير المخصصة. كل قسم في ورقة مخصصة.
تسليم ZIP
حزمة مشروع كاملة: تقرير PDF + بيانات XLSX + أرشيف TIA Portal .zap20 + لقطة VCS. ملف واحد لتسليمه للعميل أو تخزينه في نظام إدارة المستندات.
خيارات التقارير
ضبط دقيق لما يتضمنه كل تقرير
تصفية الأجهزة
قصر التقرير على جهاز PLC أو HMI محدد باستخدام خيار deviceName. مفيد للمشاريع متعددة الأجهزة حيث يكون لكل جهاز اختبار قبول خاص به.
تضمين الكود المصدري
يقوم خيار includeSourceCode بإلحاق مصدر SCL الكامل لجميع كتل البرامج. مفيد لعمليات التدقيق أو مراجعات الكود أو متطلبات تسليم المصدر التعاقدية.
نتائج الاختبار
يقوم includeTestResults بإرفاق مخرجات اختبارات PLC الآلية من T-IA Connect التي تم تشغيلها قبل إنشاء التقرير. يثبت أن النظام اجتاز مجموعة الاختبارات الخاصة به في لحظة التوقيع.
لقطة VCS
يسجل includeVcsSnapshot هاش Git commit والفرع وقت إنشاء التقرير. يوفر رابطًا غير قابل للتلاعب بين التقرير ونسخة الكود الدقيقة التي تم اختبارها.
التقارير كجزء من مسار DevOps الخاص بك
تشغيل إنشاء التقارير تلقائيًا في نهاية مراحل CI/CD
يوفر T-IA Connect نقاط نهاية REST متزامنة وغير متزامنة لإنشاء التقارير. يمكن لمسار CI تشغيل تقرير FAT في نهاية تشغيل اختبار PLCSim ناجح، وإرفاق ملف PDF كقطعة بناء أثرية، وإخطار المهندس المسؤول - كل ذلك دون تدخل بشري.
يوصى بنقطة النهاية غير المتزامنة للمشاريع الكبيرة: يتم وضع الوظيفة في قائمة الانتظار، ويقوم المسار بالاستعلام عن الاكتمال، ويتم تنزيل التقرير النهائي عندما يكون جاهزًا. بالنسبة للمشاريع الأصغر، تعيد نقطة النهاية المتزامنة الملف مباشرة.
بالاقتران مع إصدارات Git واختبار PLC الآلي، تغلق التقارير الآلية حلقة DevOps: ينتج عن كل دمج في main تقرير مصنف بإصدار، وحالة نظام مختبرة، وتسليم مشروع كامل.
مرجع أدوات MCP
ست أدوات تغطي جميع أنواع التقارير وتنسيقات الإخراج
generate_project_report
ينشئ تقرير المشروع الفني الكامل. الخيارات: deviceName، includeSourceCode، outputPath. يعيد ملف تقرير PDF.
generate_project_deliverable
ينتج حزمة تسليم ZIP الكاملة: PDF + XLSX + أرشيف .zap20 + لقطة VCS. حزمة التسليم القياسية عند اكتمال المشروع.
fat_generate_report
ينشئ تقرير اختبار قبول المصنع. يجمع بين تقرير المشروع ونتائج الاختبارات ولقطة VCS وصفحة التوقيع.
sat_generate_report
ينشئ تقرير اختبار قبول الموقع. نفس هيكل FAT، معد لتوثيق التكليف في الموقع.
نقطة نهاية REST غير متزامنة
POST /api/reports/generate - يضع وظيفة إنشاء تقرير في قائمة الانتظار ويعيد معرف الوظيفة. استعلم عن GET /api/reports/job/{id} لمعرفة الحالة، ثم قم بالتنزيل عند الاكتمال.
نقطة نهاية REST متزامنة
POST /api/reports/generate/sync - ينشئ التقرير بشكل متزامن ويعيد الملف مباشرة. مناسب للمشاريع الأصغر أو الاستخدام التفاعلي.