Addon:Forms Gramplet/he

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

מפקד אוכלוסין או טופס? לתשומת לב: תוסף טפסים הוא שדרוג ששוחרר ב־2015 במטרה להרחיב יכולות התוסף המקורי, היעודי למפקדי־אוכלוסין. תוסף הטופס מחליף את תוסף מפקד־אוכלוסין מגרסת גרמפס 4.2.X

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

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

גרמפלט טפסים

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

הוספת גרמפלט טפסים לסרגל בתחתית מצג 'אנשים' (בתצוגת־עץ).

השימוש בתוסף 'טפסים' לא בהכרך מגביל את הגישה לנתונים שנוצרו באמצאותו מתוך מצגים אחרים. במילים אחרות, הנתונים שנוצרו באמצעות תוסף זה זמינים לכלל רכיבי גרמפס, כך שניתן לוותר על השימוש בגרמפלט טפסים בכל עת, ועדיין לצפות ולערוך את הנתונים שהוזנו באמצעותו. מטרת הטפסים היא לייעל את תהליך יצירת האירועים עם [[Gramps_Template:Version manual_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_3/he#תכונות|תכונות]] שיאוחסנו בנפרד מרכיבי נתונים ממקור מובנה. אפשר לבצע את אותו תהליך בדיוק באמצעות עורכי גרמפס התקניים... אבל בהרבה יותר שלבים, לכל אדם, ו/או אירוע.

מבנה חלון גרמפלט טפסים

עורך טפסים - מוצג צף (לא עגון) במנותק מהסרגל התחתון במצג אנשים

החלון הראשי של גרמפלט הטפסים נחלק לשני אזורים עיקריים: אזור "כותרות" ואיזור "מידע":

• כותרות – ארבעה שדות בחלקו העליון של החלון:

1. מקור – כותרת הטופס שמציינת את מסמך/תעודת המקור אותו הטופס אמור ללכוד
2. תאריך – שדה תאריך תיקני של גרמפס, ניתן לבחירה או הזנה בתסדיר תאריך תיקני. התאריך משותף לכלל רכיבי הרשומה ואינו שדה חובה.
3. הפניה – נדרשת רשומת הפניה אחת לפחות (אפשר כמובן יותר) שמזוהה באופן ייחודי עם המובאה
4. מקום – מקום האירוע

• מידע – שלוש לשוניות ללכידת המידע בגוף ההמקור:

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

הוספת תוסף הטפסים לגרמפס

גרמפלט טפסים ריק – מעוגן בסרגל התחתון במצג אנשים

את תוסף הטפסים ניתן להתקין ממנהל התוספים. גרמפלט טפסים עוצב כך שיתווסף לסרגל התחתון [[Gramps_Template:Version manual_Wiki_Manual_-_Categories/he#סוג־אב_אנשים|סוג־אב אנשים]] במצבי תצוגה (מצג־עץ או רשימה) של גרמפס.
(לאחר ההתקנה, את התוסף ניתן לשלב (לעגן) בכל אחד מהמיקומים הבאים: סרגל הצד למצגים הבאים: אנשים, קירבת־משפחה, תרשימים וגיאוגרפיה).

בחירה באפשרות תפריט טפסים מתפריט המשנה הוספת גרמפלט של תפריט בחירת גרמפלט. נגיש על־ידי הקשה על הלחצן ∨ (לחצן ראש חץ מורה מטה) בסרגל הצד או בסרגל התחתון במצג.

גרמפלט טפסים מועגן 'ריק' יראה כמתואר בצילום המסך תצור טופס ראשוני למקור.

תצור ראשוני של מקור

גרמפלט טפסים - מוצג לא מעוגן בסרגל תחתון במצג אנשים

על מנת שהשימוש בגרמפלט טפסים יתאפשר, נדרש לתצר את התוסף בהגדרות הבאות:

• עריכת קובץ forms.py
• הוספת ערך forms_XX.xmlשמציין את שם הקובץ שמכיל את הגדרות הטופס לשפה XX. בשורה

definition_files = ['form_be.xml', 'form_ca.xml', ...,'form_il.xml',form_us.xml','test.xml', 'custom.xml']

• הוספת ערך טופס שמציין את תרגום המילה Form לשפה הרצויה, בשורה

INTL_FORM = {"Form", "Formular", "Formulaire", "Obrazac", "Форма","טופס"}

• כמו כן יש להגדיר 'טופס' שמתאר את המידע הכלול במקור כפי שמתואר במקטע: תצור

אופן השימוש

גרמפלט הטפסים מפרט את כל אירועי 'האדם הפעיל' אותם ניתן לערוך באמצעות עורך ה'טפסים'.
חלון דו־השיח גרמפלט טפסים מעוגן כולל את העמודות הבאות:

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

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

ברר טפסים

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

ערית נתונים בטופס

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

• תחילה יש להזין הפניה למבואה. 'הפניה' חייבת לכלול רשומת הפניה אחת לפחות (אפשר כמובן יותר) שמזוהה באופן ייחודי עם המובאה. לדוגמה, למפקד אוכלוסין שנערך בריטניה יידרש להזין את: PRO reference, Piece, Folio ו־Page.
• תאריך האירוע מפקד אוכלוסין, מאוכלס באופן אוטומטי.
• מקום ניתן לבחור בשיטת גרמפס הרגילות.

מקטע 'אדם'

דו־שיח עורך טפסים – מקטע 'אדם'

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

• לרשומה חדשה, באמצעות הקשה על לחצן +.
• לבחירת אדם קיים ממסד־הנתונים, באמצעות הקשה על הלחצן שליד (שיתוף)

הזנת נתונים לא תתאפשר עד לבחירת 'אדם פעיל'.

מקטע 'משפחה'

גרמפלט טפסים – מקטע משפחה

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

בחירת אנשים מרובה

גרמפלט טפסים – בחירת אנשים מרובה

מקטע 'ריבוי אנשים' מאפשר הזנת מידע על מספר אנשים בו זמנית.

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

תצור

לפני תחילת השימוש בתוסף הטפסים, יש להגדיר 'טופס' שיקלוט את המידע שמופיע בתעודת המקור.

בשלב ראשון, נדרש לערוך רשומת [[Gramps_Template:Version manual_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_2/he#Editing_information_about_sources|מקור]] או ליצור חדשה. עריכת או יצירת רשומת מקור אפשרית ממצג 'מקורות' , בסרגל־הצד שמימין:

• להוספה – הקשה על לחצן שבסרגל־הכלים בחלון הראשי.

1. מלשונית 'תכונות' בתחית חלון דו־שיח 'מקורות' הקשה על ליצירת תכונה.
2. בחלון דו־שיח 'עריכת תכונה'. הרשומה 'תכונה' חייבת להכיל מפתח "טופס" והרשומה 'ערך' להכיל קוד לזהיוי הטופס באופן חד־חד־ערכי, לדוגמה: UK1841

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

הגדרות טופסים נתמכות

לצפיה ברשימת הקוד המלאה להגדרות נתמכות שכלולות בתוסף בקישור הבא: Addon:Form Definitions/he

כתיבת הגדרות טופסים מותאם אישית

הערה חשוב לוודא שקובץ ההגדרות נשמר בקידוד UTF-8.

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

הגדרות הטופס מאוחסנות בקובצי XML. אלה ממוקמים במחיצה בה שוכן קוד הטופס בנתיב [[Gramps_Template:Version manual_Wiki_Manual_-_User_Directory|מחיצת מתקעי משתמש]]. הקובץ שנקרא form_xx.xml(כאשר xx הוא קוד מדינה), נכלל בהורדה ומכיל מספר הגדרות נפוצות. בנוסף יתבצע גם חיפוש בקבצים נוספים, custom.xml ו-test.xml. שמות אלו שמורים לשימוש בתהליך יצירת קוד באופן אצמעי.

קבצי הגדרה מורכבים מהצהרת XML ובעקבותיה הרכיב forms.

<?xml version="1.0" encoding="UTF-8" ?>
<forms>
   ...
</forms>

הרכיב forms מכיל בתוכו מספר רכיבי form נוספים, כל אחד מייצג הגדרת טופס. תג הפתיחה בטופס מכיל ארבע תכונות:

1. id : קוד ייחודי לזיהוי הגדרת הטופס. קוד הזיהוי הזה ישמש בהמשך לעת יצירת או עדכון בתכונת "טופס" המקור.
2. type: סוג האירוע שנוצר על ידי עורך הטפסים. ערך זה יופיע בעמודת האירועים "Type" ("EventType"). יהיה חכם להימנע מסוגים תקניים ושכיחים , לדוגמה, להוספת מידע על פטירה ניתן לציין סוג "Death.Info" (ולא Death) או כל שם סוג שעולה על הדעת. אחרת לא מן הנמנע שנתונים יאבדו.
3. title : כותרת הטופס שמשמש לתיאור קצר. אפשר להזין לשדה זה כל דבר.
4. date : תאריך (לא חובה) בתסדיר תאריך גרמפס תיקני. תג התאריך שימושי בעיקר באירועים תלויי זמן כמו לדוגמה מפקדי אוכלוסין ואירועים דומים שהתרחשו בתאריך (נקוב) מסוים.

<form id='UK1841' type='Census' title='1841 UK Census' date='6 Jun 1841'>

הטופס מחולק למקטעים שמתארים את המידע אותו אמור הטופס ללכוד לאנשים שממלאים 'תפקיד' נתון באירוע. כל רכיב טופס אמור להכיל לפחות רכיב 'מקטע' אחד. תג הפתיחה section יכול לציין את שלוש התכונות הבאות:

1. role : התפקיד אותו ממלאים אנשים במקטע זה, באירוע. הערך יופיע בעמודת האירועים 'תפקיד' "Role" ("EventRoleType").
2. type : סוג המקטע. מגדיר כיצד המקטע יוצג ואופן בחירת אנשים. ערכים מותרים הם: 'person' לאדם יחיד, 'multi' לאדם אחד או יותר, או 'family' לשני אנשים שנבחרו על ידי בחירת משפחה.
3. title : כותרת שמשמשת בעת הצגת מקטע טופס ולמעשה הדרך היחידה בה ניתן להבדיל חזותית בין מקטעים מרובים. בנישואין לדוגמה נקבל תפקיד "בעל", "אישה" ואולי מספר תפקידים אחרים כמו "עדים", "רב" או "כומר", "שושבינים".

<section role='Primary' type='person' title='Child'>

Each section element should contain a column element for each column in the section. Column elements describe information that may be recorded for each person in the section.

A column element contains:

• An _attribute element. This contains the key used to store column information in the attributes of event reference objects within the Gramps database (The "Type" Attribute of the reference information for the event. If you use "Name" then the selected person's name will be prefilled. Once defined this text must not be changed.
• An optional _longname element. This contains a fuller description of the column and is only used for tooltips (when you hover the mouse over the field in the form).
• A size element. This contains the size of the column in the census report. It is a percentage of the page width. The sum of all size elements in a definition should total 100%.

<column>
    <_attribute>At Home</_attribute>
    <_longname>Working at Home</_longname>
    <size>6</size>
</column>

Note The underscore is important and indicates that the text should be translated by translators.

Each form element may optionally contain heading elements. Heading elements describe information that is recorded once for each form.

A heading element contains:

• An _attribute element. This contains the key used to store information in the attributes of the event objects within the Gramps database.

<heading>
    <_attribute>City or Borough</_attribute>
</heading>

Although you can add your definitions to the pre-defined entries in form_xx.xml, it is recommended you create a separate file called custom.xml or test.xml for this purpose.

עצות לניפוי־תקלים

לאחר יצירה או עדכון טופס (ב-custom.xml או test.xml) חשוב לוודא שהטופס עוצב נכון, לשם כך יש להשתמש בעורך מלל שתומך במצב XML ובדיקת תחביר , (כמו NotePad++ ולהתקין את תוסף "כלי XML", העורך יתריע אם קוד ה־XML בטופס עוצב כראוי.

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

 
Traceback (most recent call last):
  File "C:\Program Files\GrampsAIO64-5.1.2\gramps\gen\plug\_manager.py", line 252, in load_plugin
    _module = self.import_plugin(pdata)
  ...
  File "C:\Users\<~username>\AppData\Roaming\gramps\gramps51\plugins\Form\form.py", line 114, in __load_definitions
    dom = xml.dom.minidom.parse(definition_file)
  File "AIO/xml/dom/minidom.py", line 1958, in parse
  File "AIO/xml/dom/expatbuilder.py", line 911, in parse
  File "AIO/xml/dom/expatbuilder.py", line 207, in parseFile xml.parsers.expat.ExpatError: mismatched tag: line 12, column 10

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

  25285: ERROR: grampsapp.py: line 157: Unhandled exception 
  ...
  File "C:\Users\<~username>\AppData\Roaming\gramps\gramps51\plugins\Form\editform.py", line 995, in __init__
    title1, title2 = title.split('/')
ValueError: not enough values to unpack (expected 2, got 1)

For the example error above, the title was fine, the Forms Gramplet was reporting that one of the entries in the custom form was incorrectly typed and should be exactly like the supported form elements.

שיתוף הגדרות טופס שיצרת עם הקהילה

Once you have written some custom form definitions, you may wish to share them with the Gramps community.

A Addon:Form Testing area is available for this purpose.

See existing Addon:Form Definitions for a current list.

סוגיות

See issues attached to the Forms tag.

לקריאה נוספת

• Civil registration From Wikipedia, the free encyclopedia
• Vital records From Wikipedia, the free encyclopedia
• Census From Wikipedia, the free encyclopedia

• Data Entry Gramplet addon that allows an easy method of editing previously added people, and adding new and related people in your family tree.

מדריך למשתמש

• Using the Form Gramplet, By Tim Graham, Photo Restorations by Tim G.
  • Using the Form Gramplet - Shows an older version of the Form addon (Published on Aug 4, 2016) Note: Video says it can be installed on the Dashboard and or the Charts page but current version cannot.
  • Defining Custom Forms for the Form Gramplet - Shows an older version of the Form addon (Published on Aug 1, 2016)

ערוץ תמיכת הפורום

• 1950 US Federal Census : Includes an importable sample of using the Forms Gramplet