Holarch

דרישות

מפת התוכנית

הצגת האופן שבו הפרויקטים שלך מקושרים זה לזה, עם מספר הקישורים לכל זוג פרויקטים, ומעקב אחר שרשרת הקישורים של פריט אחד דרך פרויקטים אחרים.

אופן השימוש ←

בדף זה
  1. סקירה כללית
  2. מושגים
    1. מה המפה מציגה
    2. מי רואה מה
    3. צבעים
  3. איך להשתמש בה
    1. צפייה באופן שבו הפרויקטים שלך מקושרים
    2. התחלה מפרויקט אחד
    3. מעקב אחרי פריט אחד דרך התוכנית
    4. דוגמה מעשית: הדגמת CubeSat EO-1 ופרויקט מטען
    5. דוגמה מעשית: Hybrid Car וחבילת הסוללות שלו
    6. עצות ושיטות עבודה טובות
    7. טעויות נפוצות
    8. כיצד זה מתחבר לתכונות אחרות
  4. הדף מפת התוכנית
    1. סרגל
    2. גרף
    3. טבלה
    4. חלונית המאפיינים
  5. API ו-MCP
  6. הודעות
  7. מגבלות
  8. קשור

סקירה כללית

תוכנית שמשתרעת על כמה פרויקטים (פרויקט מערכת, פרויקטים של תתי-מערכות, פרויקט בדיקות, ספריות) נקשרת יחד בקישורים לפרויקטים אחרים. כל קישור נשמר בפרויקט שיוצר אותו, כך שאף פרויקט בודד לא מציג את התמונה המלאה. מפת התוכנית כן: היא מציירת תיבה אחת לכל פרויקט שיש לך גישה לפתוח וחץ אחד לכל זוג פרויקטים, עם תווית של הקשר ומספר הקישורים.

בדף יש שתי תצוגות:

  • פרויקטים: כל פרויקט שיש לך גישה לפתוח והקישורים ביניהם, כגרף או כטבלה.
  • מעקב פריט: פריט אחד במרכז והפריטים שמקושרים אליו בפרויקטים אחרים, טבעת אחר טבעת, עד שישה צעדים החוצה.

מפת התוכנית פתוחה לכל מי שמחובר. הקישורים עצמם נוצרים בתוכנית Team; קישורים שנשמרים בפרויקט שהתוכנית של הבעלים שלו לא כוללת אותם מצוירים באפור. הקישורים בין פרויקטי ההדגמה Hybrid Car ו-Hybrid Car Battery Pack עובדים בכל תוכנית.

מושגים

מה המפה מציגה

רכיבמשמעות
תיבהפרויקט שיש לך גישה לפתוח: השם שלו, סוג הפרויקט ומספר הפריטים; השם הנגיש שלו מוסיף את הקישורים שהוא מחזיק ומקבל
חץקישורים שנשמרים בפרויקט שבזנב החץ ומצביעים על פריטים בפרויקט שבראשו
תווית חץקשר · קישורים · נמחקו, למשל traced from · 12 · 1 נמחק
פרויקטים שאין לך גישה לפתוח (N קישורים)תיבה מקווקוות אחת שסופרת כל קישור לפרויקט שאין לך גישה לפתוח
תיבת גרסה משוחררת של ספרייהגרסה משוחררת של ספרייה שיש לך גישה לקרוא, שהפרויקטים שלך מקשרים אליה

החיצים מצביעים בדרך כלל למעלה: פרויקטים של תתי-מערכות שומרים קישורי traced from ו-satisfies לפרויקט המערכת, ופרויקטי בדיקות שומרים קישורי verifies. המפה ממקמת את הפרויקטים שמחזיקים קישורים מתחת לפרויקטים שהם מצביעים עליהם.

מי רואה מה

המפה נבנית רק מהפרויקטים שיש לך גישה לפתוח: פרויקט שאתה חבר בו בכל תפקיד, שאינו בסל המחזור, ושאתה עומד בכלל הכניסה הדו-שלבית של הארגון שלו.

  • קישור לפרויקט שאין לך גישה לפתוח נספר ב-פרויקטים שאין לך גישה לפתוח (N קישורים). התיבה הזו אף פעם לא נותנת את שם הפרויקט או הפריט, והיא נראית אותו דבר אם הפרויקט קיים, נמצא בסל המחזור או מעולם לא היה קיים.
  • קישורים שנשמרים בפרויקט שאין לך גישה לפתוח לא נספרים בשום מקום, גם כשהם מצביעים על הפרויקטים שלך.
  • להיות מנהל ארגון לא מוסיף דבר: המפה משתמשת בחברות בפרויקט.
  • ייצואים (CSV, SVG, PNG) מכילים בדיוק את מה שהדף מציג.

צבעים

צבעמשמעות
חץ כחולקישורים בין פרויקטים שיש לך גישה לפתוח
חץ כתוםחלק מהיעדים נמחקו (בסל המחזור או נעלמו)
חץ אפורקישורים לפרויקטים שאין לך גישה לפתוח, לגרסה משוחררת של ספרייה, או שנשמרים בפרויקט שהתוכנית של הבעלים שלו לא כוללת קישורים לפרויקטים אחרים

איך להשתמש בה

  1. יש ללחוץ על ניהול פרויקטים, ואז על מפת התוכנית. התצוגה פרויקטים נפתחת עם כל פרויקט שמחזיק או מקבל קישורים.
  2. יש לקרוא את החיצים. הצבעה על תיבה מעמעמת את כל מה שלא מחובר אליה.
  3. יש ללחוץ על חץ. חלונית המאפיינים מציגה את הקישורים שלו, 100 בכל פעם: הפריט שמחזיק כל קישור, הקשר ופריט היעד. לחיצה על אחד מהפריטים פותחת אותו בפרויקט שלו, או הצגת עוד ל-100 הבאים.
  4. יש ללחוץ על ייצוא CSV בחלונית המאפיינים כדי לשמור את הקישורים של החץ הזה, או על ייצוא ▾ בסרגל כדי לשמור את כל המפה כ-CSV, SVG או PNG.

התחלה מפרויקט אחד

  1. יש לפתוח את הפרויקט, ואז את אימות → כיסוי התוכנית, וללחוץ על פתיחת מפת התוכנית.
  2. המפה מציגה רק את הפרויקט הזה ואת הפרויקטים שמקושרים אליו, ישירות או דרך אחרים.
  3. יש ללחוץ על הצגת כל הפרויקטים כדי לראות את כל מה שיש לך גישה לפתוח.

אפשר גם ללחוץ על תיבה ולבחור הצגת פרויקטים מקושרים בלבד.

מעקב אחרי פריט אחד דרך התוכנית

  1. יש לבחור את הפריט. במקטע עקיבות בחלונית המאפיינים יש לפתוח את פרויקטים אחרים ⋯ ולבחור הצגה ב-Program Map. מרשימת הקישורים של חץ לוחצים במקום זאת על מעקב אחרי הפריט הזה.
  2. התצוגה מעקב פריט מציגה את הפריט במרכז ואת הפריטים שמקושרים אליו בטבעות: הטבעת הראשונה צעד אחד החוצה, השנייה שני צעדים החוצה. הקישורים נעקבים בשני הכיוונים.
  3. יש לבחור צעדים (1 עד 6, ברירת מחדל 3) כדי להתרחק יותר או להישאר קרוב.
  4. הפריטים צבועים לפי פרויקט, עם תיבה מקווקוות סביב הפריטים של כל פרויקט. ביטול הסימון של קיבוץ לפי פרויקט מסיר את התיבות.
  5. לחיצה על פריט מציגה פתיחת הפריט ו-מעקב מכאן, שמציב אותו במרכז.

דוגמה מעשית: הדגמת CubeSat EO-1 ופרויקט מטען

  1. יש ליצור את הדגמת CubeSat EO-1, ואז פרויקט שני EO-1 Payload עם הדרישה PL.1 Imager resolution.
  2. ב-EO-1 Payload יש לבחור את PL.1. ב-עקיבות → פרויקטים אחרים יש ללחוץ על +, לבחור traced from, את פרויקט ה-CubeSat ואת דרישת ההדמיה שלו, וללחוץ על הוספת קישור.
  3. יש ליצור פרויקט שלישי EO-1 Test Campaign עם מקרה הבדיקה TC.4 Resolution test, ולקשר אותו ב-verifies ל-PL.1 ב-EO-1 Payload.
  4. יש לפתוח את ניהול פרויקטים → מפת התוכנית. המפה מציגה את EO-1 Test Campaign למטה, את EO-1 Payload מעליו ואת פרויקט ה-CubeSat למעלה, עם החיצים verifies · 1 ו-traced from · 1.
  5. יש ללחוץ על PL.1 → עקיבות ⋯ → הצגה ב-Program Map: מקרה הבדיקה ודרישת ה-CubeSat נמצאים צעד אחד החוצה, משני הצדדים.

דוגמה מעשית: Hybrid Car וחבילת הסוללות שלו

  1. ב-ניהול פרויקטים יש ללחוץ על קובצי פרויקט ▾ → פרויקט הדגמה חדש → Hybrid Car (SysML v2).
  2. אחר כך יש ליצור קובצי פרויקט ▾ → פרויקט הדגמה חדש → Hybrid Car Battery Pack (SysML v2). דרישות החבילה של ספק הסוללות PackCapacity, PackMass ו-ChargeAcceptance מקושרות ב-traced from לדרישות הרכב VR-3, VR-6 ו-VR-5 בהדגמת Hybrid Car החדשה ביותר שלך, בלי קשר לאיזו משתיהן יוצרים קודם; יצירה חוזרת של הדגמת Hybrid Car מעבירה את הקישורים לחדשה. קישורי ההדגמה האלה עובדים בכל תוכנית. בלי פרויקט Hybrid Car, להדגמת החבילה אין קישורים.
  3. יש לפתוח את ניהול פרויקטים → מפת התוכנית. המפה מציגה את שני פרויקטי SysML v2 עם החץ traced from · 3.

עצות ושיטות עבודה טובות

  • מסכימים על הקשרים שתתי-הפרויקטים משתמשים בהם (traced from או satisfies לדרישות, verifies לבדיקות), כך שהחיצים נקראים אותו דבר בכל מקום.
  • מכבים את קיבוץ קשרים כדי לראות חץ אחד לכל קשר, למשל כדי להבחין בין קישורי דרישות לקישורי בדיקות בין אותם שני פרויקטים.
  • גוררים תיבות כדי לסדר את המפה. המיקומים נשמרים בדפדפן הזה לכל היקף.
  • משתמשים בתצוגה טבלה כדי למיין זוגות פרויקטים לפי מספר הקישורים או היעדים שנמחקו.
  • חץ כתום פירושו קישורים שצריכים תיקון: פותחים את רשימת הקישורים שלו, ואז מתקנים או מסירים את הקישורים ב-עקיבות → פרויקטים אחרים של הפריט.

טעויות נפוצות

בעיהסיבהתיקון
פרויקט חסראינך חבר בו, הוא בסל המחזור, או שאין לו קישוריםיש לבקש גישה מהבעלים שלו; סימון הצגת פרויקטים לא מקושרים מציג פרויקטים בלי קישורים
הכול הולך ל-פרויקטים שאין לך גישה לפתוחהקישורים מצביעים על פרויקטים שאינך חבר בהםיש לבקש גישה מהבעלים של פרויקט
חיצים אפורים באמצע המפהלבעלים של הפרויקט שמחזיק את הקישורים אין תוכנית Teamהבעלים משדרג ב-הגדרות החשבון → תוכנית וחיוב
קישור חדש עוד לא מוצגהמפה עדיין קוראת שינויים אחרוניםיש ללחוץ על רענון אחרי דקה

כיצד זה מתחבר לתכונות אחרות

  • קישורים לפרויקטים אחרים: המפה קוראת אותם; היא לא מוסיפה ולא משנה דבר. יוצרים קישורים ב-עקיבות → פרויקטים אחרים של פריט (ראו קישורים לפרויקטים אחרים).
  • כיסוי התוכנית: התצוגה לפי פריט של הקישורים לפרויקט אחד, עם פערים (ראו כיסוי התוכנית). פתיחת מפת התוכנית שם מתחיל את המפה מהפרויקט הזה.
  • ספריות: קישורים לפריט בגרסה משוחררת של ספרייה מופיעים כחיצים לתיבה של הגרסה (ראו ספריות).
  • דיאגרמת Spider: העקיבה בתוך פרויקט, עם תיבות מקווקוות לפריטים מקושרים במקום אחר. מעקב הפריט משתמש באותה פריסת טבעות.
  • API ו-MCP: אותה מפה ואותה עקיבה לכלים (ראו API ו-MCP).

הדף מפת התוכנית

סרגל

פקדמה הוא עושה
פרויקטים / מעקב פריטמחליף את התצוגה
טווחכל הפרויקטים שלי, ארגון אחד (כשאתה שייך לארגון), או תיקייה אחת עם תתי-התיקיות שלה (כשיש לך תיקיות; ראו תיקיות פרויקטים)
הצגת כל הפרויקטיםמוצג אחרי פתיחת המפה מפרויקט; יוצא מהקבוצה המקושרת של הפרויקט הזה
הצגת פרויקטים לא מקושריםמציג גם פרויקטים בלי קישורים
קיבוץ קשריםחץ אחד לכל זוג פרויקטים (התוויות מפרטות כל קשר), או חץ אחד לכל קשר
שלביםמעקב פריט: 1 עד 6 צעדים החוצה
קיבוץ לפי פרויקטמעקב פריט: תיבות מקווקוות סביב הפריטים של כל פרויקט
גרף / טבלההדיאגרמה או טבלה שאפשר למיין; במסך צר הטבלה נפתחת ראשונה
רענוןקורא שוב את הקישורים
ייצוא ▾ייצוא CSV, ייצוא SVG, ייצוא PNG

גרף

  • לחיצה על תיבה מציגה את הפרויקט שלה בחלונית המאפיינים: פתיחת הפרויקט ו-הצגת פרויקטים מקושרים בלבד. לחיצה כפולה על תיבה, או Shift+Enter עליה, פותחת את הפרויקט.
  • לחיצה על חץ מציגה את הקישורים שלו בחלונית המאפיינים.
  • גוררים תיבות כדי להזיז אותן; גוללים או צובטים כדי להגדיל ולהקטין; גוררים את הרקע כדי להזיז את התצוגה.
  • מקישים Tab כדי להגיע למפה, ואז את מקשי החיצים כדי לעבור בין תיבות לחיצים; Enter עובר לחלונית המאפיינים. לכל תיבה וחץ יש שם שקורא מסך מקריא, כמו "EO-1 Payload, פרויקט LML, קישור אחד יוצא, 1 נכנס".

טבלה

Viewעמודות
פרויקטיםפרויקט המקור, קשר, פרויקט היעד, קישורים, נמחק
מעקב פריטפרויקט, מספר, שם, מחלקה, צעדים מהפריט, מצב

לחיצה על כותרת עמודה ממיינת.

חלונית המאפיינים

בחירהתוכן
תיבת פרויקטשם, סוג, מספר פריטים, קישורים יוצאים ונכנסים; פתיחת הפרויקט, הצגת פרויקטים מקושרים בלבד
חץפרויקט המקור ופרויקט היעד, קישורים לכל קשר, רשימת הקישורים (100 בכל פעם, הצגת עוד), ייצוא CSV, מעקב אחרי הפריט הזה בכל שורה
פריט (מעקב פריט)מספר ושם, מחלקה, פרויקט, צעדים מהפריט שנעקב, מצב; פתיחת הפריט, מעקב מכאן
פרויקטים שאין לך גישה לפתוח"קישורים לפרויקטים שאין לך גישה לפתוח. יש לבקש גישה מהבעלים של הפרויקט."

API ו-MCP

ה-REST API וה-MCP נותנים את אותן תשובות עם הגישה ורשימת הפרויקטים של האסימון עצמו. פרויקטים של ארגון שכיבה את הגישה ל-API לא נכללים, כמו פרויקטים שאין לך גישה לפתוח.

קריאהמחזירה
GET /api/v1/program-mapפרויקטים, גרסאות משוחררות, חיצים (from, to, relation, links, deleted, plan) והספירה המוסתרת; from, unlinked, org כמו בדף
GET /api/v1/projects/<project>/items/<item>/traceמעקב הפריט: צמתים עם פרויקט, מספר, שם, מחלקה וצעדים, הקישורים ביניהם, והספירה המוסתרת; steps 1–6 (ברירת מחדל 3)
MCP program_mapאותו דבר כמו GET /program-map
MCP trace_chainאותו דבר כמו קריאת ה-trace; פריטים בפרויקטים עם סימוני מידע מפוקח עונים withheld

ראו API ו-MCP.

הודעות

הודעהמשמעות
אין קישורים בין הפרויקטים שלך. אפשר להוסיף קישור מהמקטע עקיבות של פריט.אף אחד מהפרויקטים שלך לא מחזיק או מקבל קישור שאתה יכול לראות
לפרויקט הזה אין קישורים לפרויקטים אחרים. אפשר להוסיף קישור מהמקטע עקיבות של פריט.המפה נפתחה מפרויקט בלי קישורים
לפריט הזה אין קישורים לפרויקטים אחרים. אפשר להוסיף קישור מהמקטע עקיבות שלו.לפריט שנעקב אין קישורים
חלק מהפרויקטים עדיין נקראים. יש לרענן בעוד דקה.שינויים אחרונים בפרויקטים גדולים עדיין נקראים; המפה מציגה את מה שמוכן
מוצגים 500 הפריטים הראשונים. יש להקטין את מספר הצעדים.מעקב הפריט הגיע למגבלה שלו
N קישורים מפרויקטים שהתוכנית של הבעלים שלהם לא כוללת קישורים לפרויקטים אחרים לא נעקבים.מעקב הפריט דילג על קישורים שנשמרו בתוכנית שאין בה קישורים כאלה
לא ניתן לקרוא את מפת התוכנית. יש לטעון מחדש את הדף.הבקשה נכשלה

מגבלות

מגבלהערך
צעדים במעקב פריט1 עד 6
פריטים במעקב פריט500
קישורים שמוצגים בכל עמוד ברשימה של חץ100
קישורים לכל פרויקט20,000 (ראו קישורים לפרויקטים אחרים)