الاستيراد والتصدير
صيغ الاستيراد والتصدير
أدخل المواصفات وجداول البيانات وملفات تبادل المتطلبات والنماذج إلى مشروع Holarch، وأخرج النموذج في هيئة مستندات وجداول وصور وملفات تبادل وملفات مشاريع كاملة. وتسرد هذه الصفحة كل صيغة، واتجاهها، وما تحمله، وحدودها المعروفة.
كيف يعمل الاستيراد والتصدير
- التصدير متاح لكل أعضاء المشروع، بمن فيهم المشاهدون. أما الاستيراد فيحتاج إلى دور المالك أو المحرر، لأنه يغيّر المشروع.
- يعرض الاستيراد من صفحة الاستيراد والتصدير معاينة، ويعطي العناصر المستوردة معرّفات جديدة، ويمثل خطوة تراجع واحدة. ولتحديث العناصر الموجودة بدلًا من إضافة عناصر جديدة، طابقها بالمعرّف أو الاسم أو الرقم.
- يُنظَّف المحتوى المستورد: يفقد النص المنسَّق البرامج النصية والروابط غير الآمنة، وتفقد صور SVG البرامج النصية والمراجع الخارجية، ويُرفض XML الذي يحتوي على إعلانات DOCTYPE أو ENTITY.
- تحيّد تصديرات CSV النص الذي قد يشغّله جدول البيانات بوصفه صيغة. وتُنظَّف أسماء الملفات لكل نظام تشغيل.
- كل مشروع إما مشروع LML وإما مشروع SysML v2. وعمليات استيراد Word وجداول البيانات والنصوص وReqIF لمشاريع LML. أما مشاريع SysML v2 فتستورد نص SysML v2 وJSON، ونماذج SysML 1.x بصيغة XMI أو .mdzip، محوَّلة إلى SysML v2. وتستورد مشاريع LML صيغة XMI أيضًا. وملفات المشاريع، وتصديرات Word وExcel وCSV للصفحات المشتركة، تعمل في النوعين كليهما.
انتقل إلى: المتطلبات والمواصفات · النماذج · جداول البيانات والجداول · المستندات والتقارير · الصور · ملفات المشاريع · الواجهة البرمجية وMCP
المتطلبات والمواصفات
| الصيغة | الاتجاه | ما تغطيه | الحدود المعروفة |
|---|---|---|---|
| Word (.docx) | استيراد | تصبح المواصفة مستندًا مرقّمًا. فتصبح العناوين Statements متداخلة حسب المستوى؛ وتصبح الفقرات التي تحتوي على «shall» أو «must» أو «will» أو «should» وبنود القوائم المرقّمة Requirements. وتصبح الجداول عنصرًا لكل صف، أو تبقى جداول في وصف. ويُحتفظ بالخط العريض والمائل والقوائم والصور، وتُقرأ التغييرات المتعقَّبة المُدرجة، ويُرفق الملف الأصلي. | تُتخطى الصور بصيغ EMF وWMF وغيرها من الصيغ عدا PNG وJPEG وGIF وWebP وSVG. ولا يُستورد النص المتعقَّب المحذوف. |
| نص عادي (.txt أو ملصق) | استيراد | تصبح الأسطر المرقّمة والجمل التي فيها «shall» مستندًا مرقّمًا من Statements وRequirements. ويُكتشف ترقيم المخطط التفصيلي أو يُختار: عشري، أو روماني، أو حروف، أو مستويات مختلطة، أو نمط DoD، أو نمط مخصص. | تأتي البنية من الترقيم والصياغة فقط. |
| ReqIF (.reqif، .reqifz) | الاستيراد والتصدير | الاستيراد: يصبح كل SPEC-OBJECT عنصرًا، مع التسلسل الهرمي للمواصفة، ونوعه صنفًا، وسمات النص وXHTML والقيم المنطقية والتواريخ والتعدادات والأعداد الصحيحة والحقيقية. وتصبح SPEC-RELATIONs علاقات؛ فتصبح satisfy وverify وderiveReqt على التوالي satisfies وverifies وtraced from؛ وتصبح trace وrefine traced to. التصدير من قاعدة البيانات أو من مستند: نوع واحد لكل صنف مع الرقم والاسم والوصف وكل سمة، والعلاقات في هيئة SPEC-RELATIONs، والتفكيك بوصفه التسلسل الهرمي. | أنواع العلاقات التي لا مطابق لها تصبح traced to؛ والروابط التي لا يسمح بها المخطط الهيكلي تُتخطى مع تحذير. |
النماذج
| الصيغة | الاتجاه | ما تغطيه | الحدود المعروفة |
|---|---|---|---|
| XMI لـ UML وSysML 1.x (.xmi، .uml، .xml، .mdzip) | الاستيراد والتصدير | الاستيراد: XMI 2.x مع UML 2.5 وملف تعريف SysML من 1.3 إلى 1.7، وأرشيفات مشاريع .mdzip. المتطلبات بمعرّفاتها ونصوصها، والكتل، والأجزاء، والمنافذ، وخصائص القيم، وأنواع القيم بالوحدات، والتعميمات، والموصلات وتدفقات العناصر، والأنشطة بتدفق التحكم فيها، وآلات الحالة بالحالات المتوازية وانتقالات الاختيار والتقاطع والتفرع والدمج، ومخططات التسلسل، وحالات الاختبار، والحزم، والنماذج النمطية، والقيم الموسومة. وتصبح satisfy وverify وderiveReqt وrefine وtrace وcopy وallocate علاقات في Holarch. وتُرسم المخططات الكتلية والكتلية الداخلية ومخططات آلات الحالة ومخططات الأفعال من النموذج المستورد. التصدير: SysML 1.6 XMI (XMI 2.5.1) لـ Cameo/MagicDraw وEnterprise Architect وRhapsody، أو Papyrus (Eclipse UML، .uml) لـ Papyrus، مع المتطلبات، والكتل، والأجزاء، والمنافذ، وأنواع القيم بالوحدات، وكتل القيود، والموصلات بتدفقات العناصر، والأنشطة، وحالات الاستخدام، وحالات الاختبار، وآلات الحالة، وعلاقات التتبع. وتحتفظ العناصر المستوردة بمعرّفات XMI ويكتبها التصدير مرة أخرى، فيحدّث استيراد إصدار لاحق من النموذج نفسه العناصر بدلًا من إضافة نسخ. ومع تفعيل سمات Holarch وتسمياته، يُستورد الملف رجوعًا إلى Holarch دون فقد. | لا تُستورد تخطيطات المخططات والعمليات؛ وتسرد المراجعة ما تُرك. ولا يُرسم تدفق النشاط إلا حين يكون جيد البنية. ولا تُصدَّر Artifacts وTasks وRisks وIssues وDecisions وعناصر Time وCost. |
| مصدر Java (.java) | استيراد | في مخطط أصناف: تصبح الأصناف والواجهات والتعدادات Assets، وتصبح الحقول Characteristics، وتصبح الدوال Actions مع معاملاتها ونتائجها في هيئة Input/Outputs. | ملف واحد أو مصدر ملصق واحد في كل مرة. |
| نص SysML v2 (.sysml، أو .zip من ملفات .sysml) | الاستيراد والتصدير | الاستيراد إلى مشروع SysML v2 أو إلى مشروع جديد، مع معاينة لكل حزمة: جديدة، أو متغيرة، أو دون تغيير، أو متعارضة. وتصبح المجلدات في ملف zip حزمًا. صدّر النموذج كله أو حزمة واحدة؛ وتُنزَّل الحزم المتعددة في ملف zip. | لا يحمل النص معرّفات العناصر، لذا تطابق إعادة الاستيراد العناصر بالاسم. ولا تُستورد ملفات KerML (.kerml). وحتى 2,000 ملف، و8 MB من النص، وملف zip بحجم 16 MB لكل عملية استيراد؛ ويجب أن يكون النص بترميز UTF-8. |
| SysML v2 JSON (.json) | الاستيراد والتصدير | قائمة العناصر المسطحة مع @id و@type التي تستخدمها Systems Modeling API. ويُحتفظ بمعرّفات العناصر، لذا تطابق إعادة الاستيراد بالمعرّف. | حتى 24 MB و100,000 عنصر. وأنواع العناصر التي لا يفسّرها Holarch تُحفظ كما استُوردت، وتُعلَّم بـ «غير مفسَّر»، وتُكتب مرة أخرى دون تغيير. |
| مستودع نماذج SysML v2 | السحب والدفع | صِل مشروع SysML v2 بفرع واحد في مستودع يوفر Systems Modeling API. اسحب أحدث إيداع وراجع كل اختلاف قبل تطبيقه؛ وادفع تغييراتك إيداعًا واحدًا. | عناوين https على مضيفات عامة فقط. ويُرفض الدفع ما دام في الفرع إيداعات لم تُسحب. و64 MB لكل عملية سحب، و120 ثانية لكل عملية، و300 عملية لكل حساب في الساعة. ويحتاج إلى دور المحرر. |
| Systems Modeling API في Holarch | القراءة والإيداع بواسطة أدوات أخرى | تقرأ أدوات SysML v2 الأخرى عناصر مشروع SysML v2 بصيغة SysML v2 JSON عبر REST، برمز وصول شخصي، وتودع التغييرات في فروع طلبات التغيير. | الفرع main للقراءة فقط؛ والإيداعات تذهب إلى طلبات تغيير يطبّقها معتمِد في Holarch. رؤوس الفروع فقط؛ بلا وسوم أو عمليات دمج أو استعلامات محفوظة. |
| من SysML v1 إلى SysML v2 (.xmi، .uml، .xml، .mdzip) | استيراد | يُحوَّل نموذج SysML 1.x من Cameo أو MagicDraw أو Enterprise Architect أو Rhapsody أو Papyrus إلى نص SysML v2، ويُفحص، ويُستورد إلى مشروع SysML v2 أو إلى مشروع جديد في خطوة تراجع واحدة. ويسرد تقرير التحويل كل عنصر بأنه محوَّل، أو مقرَّب، أو متروك، مع السبب، ويُنزَّل بصيغة CSV. | لا تُحوَّل المخططات وتخطيطها. وتُترك العلاقات بالعناصر غير المسمّاة. |
| من LML إلى SysML v2 والعكس | نسخة محوَّلة، في الاتجاهين | مشروع جديد باللغة الأخرى: Assets، والمنافذ، وConduits، وInput/Outputs، والمتطلبات، وروابط satisfy، وحالات الاختبار، وActions بتدفقها، والحالات، والمعادلات. وتنتقل معها المخاطر، والقرارات، والمهام، والمستندات، واللوحات البيضاء، وحالة المتطلبات، ونتائج الاختبار. ويسرد تقرير ما حُوِّل وما لم يُحوَّل، ويُنزَّل بصيغة CSV. | لا تُحوَّل تخطيطات المخططات، والسجل، وخطوط الأساس، وطلبات التغيير. والعناصر التي لا مكان لها في إحدى اللغتين، مثل Measures وResources في LML أو الحسابات وحالات التحليل في SysML v2، تُسرد في التقرير. |
بيانات Holarch المرافقة لنموذج SysML v2، مثل حالة المتطلبات والمخاطر والميزانيات وتخطيطات العروض، ليست جزءًا من ملفات .sysml أو SysML v2 JSON. ويحتفظ بها تصدير المشروع.
جداول البيانات والجداول
| الصيغة | الاتجاه | ما تغطيه | الحدود المعروفة |
|---|---|---|---|
| Excel (.xlsx، .xlsm) وCSV | استيراد | عناصر جديدة أو محدَّثة من أي صنف، مع تعيين للأعمدة يُقترح من العناوين. السمات، والتسميات، والعلاقات، والتسلسل الهرمي من عمود أب أو من الأرقام، وسمات جديدة تُنشأ من البيانات. طابق العناصر الموجودة بالمعرّف أو الاسم أو الرقم لتحديثها. | لا تُقرأ ملفات Excel 97-2003 (.xls) ولا ملفات CSV المفصولة بفواصل منقوطة. وتُقص الأسماء والأرقام إلى 255 حرفًا. |
| Excel وCSV من قاعدة البيانات | تصدير | أي مجموعة من العناصر في هيئة جدول بسمات وعلاقات مختارة، مع التسلسل الهرمي والتجميعات، أو في هيئة تعريفات، أو مصفوفة علاقات، أو سجل تغييرات، أو تعليقات. | تتسع خلايا Excel لما يصل إلى 32,000 حرف؛ ويُقتطع النص الأطول. |
| Excel وCSV من صفحات أخرى | تصدير | RVTM وVCRM وRVM وRTM وRSM وTVM؛ ونتائج جودة المتطلبات؛ وسجل TBD/TBR؛ وسجل الواجهات؛ ومصفوفات N² وI²؛ والميزانيات ومقاييس الأداء التقني (TPM)؛ وسجل المخاطر؛ ودراسات المفاضلة؛ وجداول التحليل الوظيفي؛ ومقارنات خطوط الأساس؛ وبيانات المخططات البيانية؛ والخطوط الزمنية للمحاكي وسجلات أحداثه وتشغيلاته. | تصدّر كل صفحة أعمدتها الخاصة. |
| مصفوفة التتبع (.xlsx، .csv) | الاستيراد والتصدير | صدّر أي علاقة في صورة مصفوفة. عدّل المصنف في برنامج جداول بيانات ثم استورده مجددًا: تعرض المعاينة الروابط المراد إضافتها والروابط المراد إزالتها والخلايا المتخطاة. | يضيف الاستيراد الروابط بين العناصر الموجودة فقط ويزيلها. وتُتخطى الخلايا التي لا يسمح بها المخطط الهيكلي (schema) وتُدرج في قائمة. |
المستندات والتقارير
| الصيغة | الاتجاه | ما تغطيه | الحدود المعروفة |
|---|---|---|---|
| Word (.docx) | تصدير | مستندات ومخططات تفصيلية بأنماط عناوين Word، والعلامات التصنيفية، وصفحات الغلاف، وأرقام الصفحات؛ ونسخ مقارنة بتتبع التغييرات بين خطوط الأساس؛ وتفصيلات الكيانات؛ وتقارير المخططات؛ ووثائق التحكم في الواجهات (ICD)؛ وحالات الاختبار؛ وRVTM ومصفوفات التتبع؛ وملخصات دراسات المفاضلة؛ وتقارير التحليل الوظيفي؛ وحزمة معمارية DoDAF. | الصفحات بمقاس US Letter. |
| PowerPoint (.pptx) | تصدير | عروض تقديمية، شريحة لكل صفحة، مع مربعات نص وأشكال وملاحظات المتحدث. وتُصدَّر العروض التقديمية أيضًا بصيغة HTML وWord. | لا شيء مدرج. |
| Markdown (.md) | تصدير | مستند في صورة عناوين ونص بصيغة Markdown. | لا شيء مدرج. |
| HTML | تصدير | صفحات ويب للمخططات وتقارير المخططات والمخططات البيانية والعروض التقديمية ومصفوفات التتبع. | لا شيء مدرج. |
| الطباعة وPDF | تصدير | المستندات والجداول والمخططات عبر نافذة الطباعة في المتصفح، التي تحفظ بصيغة PDF. وتُصدّر اللوحات البيضاء ملفات PDF مباشرة. | صفحات PDF للوحات البيضاء صور. |
الصور
| الصيغة | الاتجاه | ما تغطيه | الحدود المعروفة |
|---|---|---|---|
| PNG وSVG | تصدير | المخططات والمخططات البيانية والشرائح ولوحات المحاكي وبطاقات المعرض. PNG بمقياس تختاره، بخلفية أو بدونها؛ وSVG صورةً متجهية قابلة للتحجيم. | لا شيء مدرج. |
| اللوحات البيضاء: PNG وJPG وSVG وPDF | تصدير | لوحة واحدة أو تحديد أو العرض الحالي أو إطار أو كل اللوحات. وتبقي صيغة SVG الأشكال والنصوص قابلة للتحرير في أدوات الرسم المتجهي. | صفحات PDF صور. |
| الصور والملفات المرفقة | استيراد | الصور في النص المنسق، وصور الكيانات، وسمات الملفات، واللوحات البيضاء، والشرائح. ورسومات PNG أو JPEG أو SVG لمنتجات DoDAF، مثل OV-1 بمناطق تفاعلية. | تُصغَّر الصور التي يزيد ضلعها الأطول على 4,000 بكسل. وحد الملفات 10 MB في خطة Free، و25 MB في Individual، و100 MB في Team، وحد المشاريع 100 MB في خطة Free. |
ملفات المشاريع
| الصيغة | الاتجاه | ما تغطيه | الحدود المعروفة |
|---|---|---|---|
| نسخة Holarch الاحتياطية (.holarch) وملف المشروع (.json) | الاستيراد والتصدير | مشروع كامل للنسخ الاحتياطي أو لنقله إلى خادم Holarch آخر: العناصر والعلاقات والمخططات وخطوط الأساس والتعليقات والسجل وتفضيلات الصفحة الرئيسية، مع المرفقات والصور. وتحمل النسخة الاحتياطية .holarch مجموع تحقق لكل جزء، وتُفحص قبل استيرادها. وتُستورد مشروعًا جديدًا تملكه. وصيغتا النسخة الاحتياطية وJSON موثقتان. | مشروع جديد دائمًا؛ وللدمج في مشروع مفتوح، استخدم استيراد الدمج أدناه. |
| الدمج في مشروع (.holarch، .json) | استيراد | نسخ Holarch الاحتياطية وحزمه مع ملفاتها المرفقة، وصادرات مشاريع Holarch وقاعدة البيانات والمستندات، تُدمج في المشروع المفتوح. وتُطابَق الفئات والسمات والتسميات والعلاقات بالاسم، ويمكن إضافة عناصر المخطط الهيكلي الناقصة أولًا. وتنتقل التعليقات والسجل وتخطيطات المخططات معها عند اختيارها. | تُعلَّم نصوص المحاكاة البرمجية القادمة من ملف بأنها مستوردة، ويطلب المحاكي التأكيد قبل تشغيلها. |
| حزمة المشروع (.holarch) | تصدير | العناصر المختارة مع علاقاتها ومخططاتها وتعليقاتها ومخططها الهيكلي، وكل ملف مرفق، مع فحصها بحثًا عن التلف عند الاستيراد. | تحتوي على العناصر المختارة؛ ولا تشمل خطوط الأساس والسجل. |
| المخطط الهيكلي (.json) | الاستيراد والتصدير | فئات المشروع وعلاقاته وسماته وتسمياته. ويدمج الاستيراد ما ينقص المشروع، أو يستبدل المخطط الهيكلي. | لا شيء مدرج. |
| خطوط الأساس وبيانات المستندات (.json) | تصدير؛ وبيانات المستندات تُستورد أيضًا | خط أساس بتاريخه ومستنده واعتماداته ولقطته. وعناصر المستند وعلاقاته وحالته، التي يمكن دمجها في مشروع آخر. | لا شيء مدرج. |
| منتجات DoDAF (JSON) ومجموعة DM2 PES الجزئية (XML) | تصدير | وصف المعمارية، وكل منتج ببياناته، والقاموس. ويكتب ملف XML القاموس بمصطلحات DoDAF Meta Model. | يستخدم ملف XML نطاق أسماء Holarch الخاص، ولا يُتحقق من صحته مقابل مخطط DM2 PES. |
| جدول MS Project الزمني (.xml) | تصدير | صفوف Gantt لتشغيل محاكاة في صورة جدول زمني بصيغة MS Project XML. | من تشغيلات المحاكي فقط. |
API وMCP
تقرأ النصوص البرمجية المشاريع وتغيّرها عبر REST API، برمز وصول شخصي ووصف OpenAPI. وتتصل أدوات الذكاء الاصطناعي مثل Claude عبر Model Context Protocol (MCP)؛ وتصل تغييراتها في صورة مقترحات تراجعها قبل تطبيقها. راجع API وMCP.