דילוג לתוכן הראשי

תחילת העריכה

העריכה מתחילה בתפריט ההקשר, שנפתח בלחיצה ימנית.

לחיצה ימנית על בד הציור, פתיחת תפריט המשנה Relationship, הוספת טבלה, ולאחר מכן התפריט של הטבלה עצמה

לחיצה ימנית על טבלה, על פתק, על קבוצת טבלאות או על קשר פותחת במקום זאת את התפריט של הפריט עצמו.
לחיצה ימנית על טבלה, פתק או קבוצת טבלאות שכבר נבחרו שומרת על הבחירה כולה, ולכן שורות כגון Color ו-Delete selected פועלות על כולה – ראו בחירה מרובה.

מסך הפתיחה​

באפליקציית הרשת, ב-Google Drive, ב-VS Code, ב-Obsidian וב-IDE של JetBrains, תרשים ריק נפתח עם מסך פתיחה מעל בד הציור של ERD. בדף שמטמיע את העורך, האלמנט <erd-editor> מציג את המסך רק כשהדף מפעיל אותו באמצעות enableWelcomeScreen.
תרשים נחשב ריק כל עוד אין בו אף טבלה, אף פתק מוצג ואף קבוצת טבלאות מוצגת, ולכן פתקים וקבוצות שהוסתרו באמצעות אפשרויות התצוגה אינם נחשבים. המסך נעלם ברגע שיש בתרשים אחד מהם, וחוזר בכל פעם שהתרשים שוב ריק, לדוגמה אחרי מחיקת הטבלה האחרונה או אחרי ביטול ההוספה של הטבלה הראשונה.
הוא אינו מוצג בעורך לקריאה בלבד, במצב זן, כשחלון מאפייני הטבלה פתוח או כשמציג ההבדלים, התצוגה המקדימה של הפריסה האוטומטית או המסע בזמן משתלטים על בד הציור.

מסך הפתיחה בתרשים ריק: פתיחת הפורמטים של Import, חזרה באמצעות Esc, הוספת טבלה באמצעות New Table, ולאחר מכן החזרת המסך באמצעות ⌘ + Z

מתחת לכותרת Right-click the canvas for every action. יש תפריט:

  • הפריט New Table מוסיף טבלה, כמו Alt + N.
  • הפריט New Memo מוסיף פתק, כמו Alt + M. הוא מושמט כל עוד הפתקים מוסתרים.
  • הפריט Import מחליף את התפריט ב-Back ובפורמטים json, Schema SQL, GraphQL, DBML ו-AML. בחירה בפורמט מבקשת קובץ בפורמט הזה וטוענת אותו במקום התרשים הריק – ראו ייבוא וייצוא של קבצים. הפריט Back, או המקש Escape, מחזירים לתפריט הראשון.
  • הפריט Command Palette פותח את החיפוש המהיר, כמו Ctrl + K (Windows/Linux) או ⌘ + K (Mac).
  • הפריט Shortcuts פותח את ההגדרות בכרטיסייה Shortcuts שלהן.

כשבד הציור רחב מספיק, הפריטים New Table, New Memo ו-Command Palette מציגים את המקש שמשויך כעת לפקודה שלהם, כולל מקש שסביבה מארחת שייכה מחדש.
כשהפוקוס של המקלדת נמצא על שורה, ↑ ו-↓ עוברים בין השורות באופן מעגלי, Home ו-End קופצים לשורה הראשונה ולאחרונה, ו-Enter או Space לוחצים על השורה שבפוקוס. כל שאר קיצורי המקשים ממשיכים לפעול, ולכן Alt + N מוסיף טבלה גם משם.
רק התפריט מקבל לחיצות: לחיצה בכל מקום אחר במסך מגיעה לבד הציור, ולחיצה ימנית על בד הציור פותחת את תפריט ההקשר כרגיל.

כשיש מקום בבד הציור, חצים בסגנון ציור יד מצביעים על:

  • הלחצן Search בסרגל הכלים: Search commands and tables
  • הלחצנים Theme ו-Display Language: Pick a theme and a language, או Pick a theme או Pick a language כשסרגל הכלים מציג רק אחד מהם – ראו שפה וערכת נושא
  • סרגל הכלים של בד הציור בתחתית: Pan, zoom and draw relationships

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

יצירת טבלה​

ליצירת טבלה יש להשתמש בתפריט ההקשר, בלחצן New Table בסרגל הכלים של בד הציור או בקיצור המקשים Alt + N.

יצירת פתק​

ליצירת פתק יש להשתמש בתפריט ההקשר, בלחצן New Memo בסרגל הכלים של בד הציור או בקיצור המקשים Alt + M.
כל עוד View Option ← Memos כבוי, הפתקים מוסתרים, הפריט New Memo אינו מוצע בשום מקום ו-Alt + M אינו מוסיף פתק – ראו אפשרויות תצוגה של טבלאות.

פתק הוא קטע טקסט חופשי על בד הציור. יש ללחוץ בתוך גוף הפתק ולהקליד; הטקסט נשמר עם המסמך.
המקש Escape סוגר את עורך הפתק, שומר את מה שהוקלד ומשאיר את הפתק נבחר, והקשה שנייה על Escape מבטלת את הבחירה.
יש לגרור את המסגרת של הפתק כדי לשנות את גודלו. הלחצן x בכותרת הפתק, שמוצג כשסמן העכבר נמצא מעל הפתק, מוחק אותו.
לחיצה ימנית על פתק פותחת את התפריט שלו ולא את העורך: Color, Remove color כשלאחד הפריטים שנבחרו יש צבע, ו-Delete, שמוצג כ-Delete selected כל עוד הפתק הוא אחד מתוך שני פריטים נבחרים או יותר. פתק שנבחר נמחק גם באמצעות המקשים שמוחקים טבלאות – ראו מחיקת טבלאות ופתקים.

הוספת פתק באמצעות Alt + M, הקלדת טקסט וגרירת המסגרת שלו כדי לשנות את גודלו

יצירת קבוצת טבלאות​

קבוצת טבלאות היא מלבן שמכיל טבלאות, וניתן לתת לה שם וצבע. ליצירת קבוצה יש שתי דרכים:

  • יש לבחור ב-New Table Group בתפריט ההקשר או בחיפוש המהיר, ללחוץ על הלחצן New Table Group בסרגל הכלים של בד הציור או להקיש על Alt + G (Windows/Linux) או ⌥ + G (Mac), ולאחר מכן לגרור מלבן על בד הציור. כל טבלה שמרכזה נמצא בתוך המלבן מצטרפת לקבוצה החדשה, אלא אם היא כבר נמצאת בקבוצה אחרת – ראו שרטוט קבוצה.
  • אחרי בחירת טבלאות, יש לבחור ב-Group selected tables בתפריט ההקשר של טבלה או ב-Group Selected Tables בחיפוש המהיר, או להקיש על T ואז G – ראו קיבוץ הטבלאות שנבחרו.

מתן שם, צביעה, הזזה, שינוי גודל וכל השאר מתוארים בדף קבוצות טבלאות.

יצירת קשר​

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

  • Zero One: Ctrl + Alt + 1 (Windows/Linux) או ⌘ + ⌥ + 1 (Mac)
  • Zero N: Ctrl + Alt + 2 (Windows/Linux) או ⌘ + ⌥ + 2 (Mac)
  • One Only: Ctrl + Alt + 3 (Windows/Linux) או ⌘ + ⌥ + 3 (Mac)
  • One N: Ctrl + Alt + 4 (Windows/Linux) או ⌘ + ⌥ + 4 (Mac)

כשהשרטוט של סוג קשר פעיל, סמן העכבר משתנה. יש ללחוץ תחילה על טבלת האב, ולאחר מכן על טבלת הבן.
טבלת האב מקבלת מפתח ראשי אם אין לה כזה, ולכל אחת מעמודות המפתח הראשי של טבלת האב, טבלת הבן מקבלת עמודת מפתח זר Not Null עם אותו סוג נתונים, אותה ברירת מחדל ואותה הערה.
מפתח serial הוא החריג: המפתח הזר שלו מקבל את סוג המספר השלם שה-serial מאחסן, כגון integer עבור serial4 – ראו קשרים מזהים.
כל עמודת מפתח זר נקראת על שם המפתח שלה: לשם בן מילה אחת, כגון id, מתווסף בתחילתו השם של טבלת האב (user_id), שם בן כמה מילים, כגון member_id, נשמר כפי שהוא, ושם שכבר קיים בטבלת הבן מקבל מספר (user_id_2) – ראו שמות עמודות של מפתחות זרים.
לחיצה על אותה טבלה פעמיים משרטטת קשר עצמי.
קשר חדש מתחיל כשגם On Delete וגם On Update מוגדרים כ-Not set; ניתן לשנות אותם בתפריט ההקשר שלו – ראו ON DELETE ו-ON UPDATE.
לביטול, יש להקיש על Escape או להקיש שוב על אותו קיצור מקשים. הביטול משאיר את הבחירה כפי שהיא, וההקשה הבאה על Escape מבטלת אותה.

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

  • הלחצן Create new columns (+) משרטט את הקשר עם עמודות מפתח זר חדשות, כמו לחיצה על הטבלה.
  • הלחצן Map to existing columns (סמל קישור) מסיים את השרטוט ופותח את מיפוי עמודות עבור שתי הטבלאות, כך שהקשר יכול להשתמש בעמודות שכבר קיימות בטבלת הבן. דבר אינו נכתב עד שלוחצים על Map.

גם טבלת האב מציגה את הלחצנים ברגע שסמן העכבר התרחק מעט מהנקודה שבה היא נלחצה, כך שגם קשר עצמי ניתן למפות לעמודות קיימות.
לאצבע אין ריחוף, ולכן בשרטוט באצבע הלחצנים לעולם אינם מוצגים, ונגיעה בטבלת הבן משרטטת את הקשר מיד; עט מציג אותם כמו עכבר.
אם טבלת האב איבדה את המפתח הראשי שלה עד שמגיעים לטבלת הבן, לדוגמה בגלל ביטול פעולה או עריכה של שותף לעריכה, הלחצן Create new columns מעומעם עם תיאור הכלי <parent> has no primary key to copy, ולחיצה על טבלת הבן מסיימת את השרטוט בלי לשרטט דבר.

שרטוט קשר One N באמצעות ⌘ + ⌥ + 4, ואחר כך קשר Zero N מסרגל הכלים של בד הציור, כשטבלת הבן מוקפת במסגרת, עם הלחצנים Map to existing columns ו-Create new columns שלה

שכפול טבלאות ופתקים​

טבלאות ופתקים קיימים ניתנים לשכפול באמצעות העתקה והדבקה, וכן באמצעות גרירה עם Alt – ראו פעולות על טבלאות.