ייבוא וייצוא
פורמטי ייבוא וייצוא
הכנסת מפרטים, גיליונות אלקטרוניים, קובצי החלפת דרישות ומודלים לפרויקט Holarch, והוצאת המודל כמסמכים, טבלאות, תמונות, קובצי החלפה וקובצי פרויקט מלאים. העמוד הזה מפרט כל פורמט, באיזה כיוון הוא פועל, מה הוא נושא ואת המגבלות הידועות שלו.
איך ייבוא וייצוא עובדים
- ייצוא פתוח לכל חבר בפרויקט, כולל צופים. ייבוא מחייב את התפקיד בעלים או עורך, כי הוא משנה את הפרויקט.
- ייבוא מהעמוד ייבוא וייצוא מציג תצוגה מקדימה, נותן לפריטים המיובאים מזהים חדשים ומהווה צעד ביטול אחד. כדי לעדכן פריטים קיימים במקום להוסיף חדשים, מתאימים אותם לפי מזהה, שם או מספר.
- תוכן מיובא מנוקה: טקסט עשיר מאבד סקריפטים וקישורים לא בטוחים, תמונות SVG מאבדות סקריפטים והפניות חיצוניות, ו-XML עם הצהרות DOCTYPE או ENTITY נדחה.
- ייצואי CSV מנטרלים טקסט שגיליון אלקטרוני היה מריץ כנוסחה. שמות קבצים מנוקים לכל מערכת הפעלה.
- כל פרויקט הוא פרויקט LML או פרויקט SysML v2. ייבואי ה-Word, הגיליונות האלקטרוניים, הטקסט וה-ReqIF מיועדים לפרויקטים של LML. פרויקטים של SysML v2 מייבאים טקסט ו-JSON של SysML v2, ומודלים של SysML 1.x כ-XMI או כ-.mdzip, שמומרים ל-SysML v2. גם פרויקטים של LML מייבאים XMI. קובצי פרויקט, וייצואי ה-Word, ה-Excel וה-CSV של העמודים המשותפים, עובדים בשניהם.
מעבר אל: דרישות ומפרטים · מודלים · גיליונות אלקטרוניים וטבלאות · מסמכים ודוחות · תמונות · קובצי פרויקט · API ו-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. דרישות עם המזהים והטקסט שלהן, blocks, parts, ports, value properties, value types עם יחידות, הכללות, connectors ו-item flows, activities עם זרימת הבקרה שלהן, state machines עם מצבים מקבילים ומעברי choice, junction, fork ו-join, דיאגרמות רצף, מקרי בדיקה, packages, stereotypes ו-tagged values. Satisfy, verify, deriveReqt, refine, trace, copy ו-allocate הופכים לקשרים של Holarch. דיאגרמות block, internal block, state machine ו-action מצוירות מהמודל המיובא. ייצוא: SysML 1.6 XMI (XMI 2.5.1) ל-Cameo/MagicDraw, Enterprise Architect ו-Rhapsody, או Papyrus (Eclipse UML, .uml) ל-Papyrus, עם דרישות, blocks, parts, ports, value types עם יחידות, constraint blocks, connectors עם item flows, activities, use cases, מקרי בדיקה, state machines וקשרי העקיבות. פריטים מיובאים שומרים את מזהי ה-XMI שלהם והייצוא כותב אותם בחזרה, כך שייבוא של גרסה מאוחרת יותר של אותו מודל מעדכן פריטים במקום להוסיף עותקים. כשהמאפיינים והתוויות של Holarch מופעלים, הקובץ מיובא בחזרה ל-Holarch בלי אובדן. | פריסות דיאגרמות ו-operations אינן מיובאות; הסקירה מפרטת מה הושמט. הזרימה של activity מצוירת רק כשהיא מובנית היטב. Artifacts, tasks, risks, issues, decisions, פריטי time ו-cost אינם מיוצאים. |
| קוד מקור Java (.java) | ייבוא | בדיאגרמת מחלקות: מחלקות, ממשקים ו-enums הופכים ל-Assets, שדות הופכים ל-Characteristics, ומתודות הופכות ל-Actions עם הפרמטרים והתוצאות שלהן כ-Input/Outputs. | קובץ אחד או קוד מקור מודבק אחד בכל פעם. |
| טקסט SysML v2 (.sysml, או .zip של קובצי .sysml) | ייבוא וייצוא | ייבוא לפרויקט SysML v2 או לפרויקט חדש, עם תצוגה מקדימה לכל package: חדש, שונה, ללא שינוי או התנגשות. תיקיות בתוך zip הופכות ל-packages. ייצוא של המודל כולו או של package אחד; כמה packages יורדים כ-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. משיכת ה-commit האחרון וסקירת כל הבדל לפני החלתו; דחיפת השינויים שלכם כ-commit אחד. | כתובות https במארחים ציבוריים בלבד. דחיפה נדחית כל עוד בענף יש commits שלא נמשכו. 64 MB לכל משיכה, 120 שניות לכל פעולה ו-300 פעולות לכל חשבון בשעה. מחייב את התפקיד עורך. |
| Systems Modeling API ב-Holarch | קריאה ו-commit על ידי כלים אחרים | כלי SysML v2 אחרים קוראים את הרכיבים של פרויקט SysML v2 כ-SysML v2 JSON דרך REST, עם אסימון גישה אישי, ומבצעים commit של שינויים לענפי בקשות שינוי. | main הוא לקריאה בלבד; commits נכנסים לבקשות שינוי שמאשר מחיל ב-Holarch. ראשי ענפים בלבד; אין tags, מיזוגים או שאילתות שמורות. |
| 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, ports, Conduits, Input/Outputs, דרישות, קישורי satisfy, מקרי בדיקה, Actions עם הזרימה שלהן, מצבים ומשוואות. סיכונים, החלטות, משימות, מסמכים, לוחות ציור, סטטוס דרישות ותוצאות בדיקה עוברים איתם. דוח מפרט מה הומר ומה לא, ויורד כ-CSV. | פריסות דיאגרמות, היסטוריה, קווי בסיס ובקשות שינוי אינם מומרים. רכיבים שאין להם מקום בשפה אחת, כמו Measures ו-Resources של LML או calculations ו-analysis cases של SysML v2, מפורטים בדוח. |
נתוני Holarch שלצד מודל SysML v2, כמו סטטוס דרישות, סיכונים, תקציבים ופריסות views, אינם חלק מקובצי .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) | ייבוא וייצוא | אפשר לייצא כל קשר כמטריצה, לערוך את חוברת העבודה בגיליון אלקטרוני ולייבא אותה בחזרה: התצוגה המקדימה מפרטת את הקישורים שיתווספו, את הקישורים שיוסרו ואת התאים שדולגו. | הייבוא מוסיף ומסיר קישורים רק בין פריטים קיימים. תאים שהסכמה אינה מתירה מדולגים ומפורטים. |
מסמכים ודוחות
| פורמט | כיוון | מה הוא מכסה | מגבלות ידועות |
|---|---|---|---|
| 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 px מוקטנות. קבצים מוגבלים ל-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) | ייצוא | שורות הגאנט של הרצת סימולציה כלוח זמנים בפורמט MS Project XML. | מהרצות סימולטור בלבד. |
API ו-MCP
סקריפטים קוראים ומשנים פרויקטים דרך ה-REST API, עם אסימון גישה אישי ותיאור OpenAPI. כלי AI כגון Claude מתחברים דרך Model Context Protocol (MCP); השינויים שלהם מגיעים כהצעות שאתם סוקרים לפני שהן מוחלות. ראו API ו-MCP.