15,091
edits
Changes
no edit summary
<div dir="rtl" lang="he" class="mw-content-rtl">
{{languages/he|Quick Views}}
[[File:QuickViewReport-EditPerson-context-menu-popup-50default-60.png|thumb|left|450px|תפריט הקשר מצג מהיר בעורך אדם]]
מצגים מהירים (בעבר נקראו ''דוחות מהירים'' אך עדין מופיעים ב"עדכוני תוספים זמינים" כ''דוח מהיר'') הם דוחות אליהם ניתן להגיע מתפריטי ההקשר של: אנשים, משפחות וכדומה'. קיימתקבוצה קיימת קבוצה של [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8/he#מצגים_מהירים|מצגים מהירים מובנים]] אותה ניתן להרחיב באמצעות תוספים מסוג QuickView.
ההנחה היא שגם משתמשים בעלי ידע מוגבל בקידוד יהיו מסוגלים ליצור אותם.
נלווה לכלי זה, נבנתה גם [[Simple Access API/he|גישה פשוטה למסד נתונים (API)]] וממשק מסמכים פשוט, כדי להסיר מורכבויות עד כמה שניתן.
==היכן לאחסן אחסון מצגים מהירים שיצרתישנוצרו באופן אישי==
מצגים מהירים מורכבים בדרך כלל משני קבצים בתת מחיצה יעודית עבורם, שממוקמים במחיצת התוספים של ה''[[Gramps_{{man version}}_Wiki_Manual_-_User_Directory/he|משתמש]]''. הנתיב למחיצה זו במערכות הפעלה דמויי לינוקס הוא '''/home/[user_name]/.gramps'''. במחיצה זו תמצא מחיצת משנה בשם '''plugins'''. על מנת שתוסף המצג המהיר המותאם אישית יופיע בגרמפס, יש לשמור את הקבצים במחיצה זו.
אל המחיצה ניתן להגיע ממסוף באופן הבא
פלט דוח מהיר יראה כך:
[[File:QuickViewReport-Siblings-quick-report-resultexample-3460.png|thumb|left|450px|פלט תוצאת מצג מהיר לדוגמה]]
{{-}}
<span id="siblings.gpr.py"></span>
להלן פירוט והסבר על שאר שורות קוד קובץ הרישום:
* {{man label|name}} = שם ייחודי: שם שבו יזהה גרמפס את המתקע (במקרה זה זהו דוח המצג המהיר), אין להשתמש ברווחים או בסמלים מוזרים. בדוגמה שלעיל נוספה לשם הסיפרה '2' כדי למנוע התנגשויות עם [[Gramps_{{man version}}_Wiki_Manual_-_Reports_-_part_8/he#צאצאים|מצג צאצאים מהיר]].
* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L159-L171 {{man label|סוג־אב}}] = ־קבוע קבוע מיוחד שמציין היכן יוצג הדוח. ניתן להשתמש בב־'''CATEGORY_QR_PERSON''' כדי לצפות בדוח בעורך מצג אדם, או '''CATEGORY_QR_FAMILY''' כדי לצפות בדוח בעורך מצג משפחה. (CATEGORY_QR_DATE מיועד לדוחות שניתן להטמיע בתוך דוחות אחרים מכיוון שלא קיים סוג־אב "תאריך").
* {{man label|run_func}} = היא הפונקציה אותה מייצרים בתוסף זה ואותה יבצע גרמפס כאשר משתמש יבחר את הדוח המהיר הזה מתפריט ההקשר.
* [https://github.com/gramps-project/gramps/blob/892fc270592095192947097d22a72834d5c70447/gramps/gen/plug/_pluginreg.py#L58-L69 {{man label|מצב}}] =מצב הדוח שנוצר ''', '''לא יציב''', ''יציב''', '''ניסוי''' או '''בטא'''
===ניתוח הקוד: פונקציית הריצה===
2. קובץ הריצה [[Quick_Views/he#siblings.py|siblings.py]].
כאשר משתמש מקיש על דוח מצג מהיר בתפרית בתפריט ההקשר, פונקציית הריצה תתבצע עם שלושת המשתנים הבאים:
<div dir="ltr">
<code>run(database, document, person)</code>
===ניתוח קטע קוד: גישה לנתונים===
לאחר השלמת פונקציית הקיצה של המצג המהיר, ניתן לטפל בפתיחת מסד הנתונים, הפעלת המסמך, גישה לנתונים וכתיבתם על המסמך. פעולות אלו מתבצעות באמצעות [[Simple Access API/he|מנשק API פשוט גישה פשוטה למסד הנתונים]].
קטע הקוד הבא מכין את כל שנדרש לפעולת הנמנשק:
</pre>
</div>
כאן נעשה שימוש במחלקות הגישה הקלה מ־[[Simple Access API/he|מנשק API גישה פשוטה למסד הנתונים]] כדי להשיג במהירות את המטרה ללא הצורך לכתוב שורות קוד רבות נוספות.
==דוגמה שניה==
אפשרויות העברת ושיתוף מידע ממסד הנתונים לפטים שונים הן רבות ומגוונות. מתכנת מנוסה, לא חייב להגביל את עצמו ל־API מסד הנתונים פשוט זה. כמו כן, כאשר יוצרים (בכתיבת קוד) דוח 'אמיתי', ניתן במקביל גם לרשום אותו כדוח מהיר עם הגדרות ברירת מחדל.
לקריאה נוספת: [https://github.com/gramps-project/gramps/tree/master/gramps/plugins/quickview מצגים מהיריםמצג מהיר]
=לקריאה נוספת=