Changes

{{man note|The ה{{man label|Simple Access API}} was introduced in Gramps version הוצג לראשונה בגרסת גרמפס ‎3.0.x|It is a database זהו ממשק APIלמסד נתונים ([https://en.wikipedia.org/wiki/Application_programming_interface Application programming interfaceממשק תכנות יישומים]) made for Gramps plugin/addon writersשמיועד בעקרון למפתחי תוספים עבור גרמפס}}

The Simple ה־Simple Access API, accompanied by the בליווי [[Report_API|Simple Document API interfaceממשק ה־API של מסמך פשוט]] for easy presentation of the data have been constructedלהנגשת נתונים קלה, so as to hide as much complexity as possibleנבנו במטרה להסיר מורכבויות ככל שניתן.

==Introductionמבוא==

The normal database routines are optimized for low memory usageשגרות מסד הנתונים הרגילות מותאמות לשימוש נמוך בזיכרון, and if used properlyואם נעשה בהן שימוש נכון, will take up almost no memoryכמעט ולא יתפסו זיכרון. This is key when using large databasesזה המפתח בעת שימוש במסדי נתונים גדולים. Typicallyבדרך כלל, instead of maintaining dictionaries or lists of objectsבמקום לשמור על מילונים או רשימות של אובייקטים, we can use the database אנו יכולים להשתמש במסד הנתונים "[https://en.wikipedia.org/wiki/Handle_(computing) handles]", and access the data only when explicitly neededולגשת לנתונים רק כאשר יש צורך במפורש. This memory efficiency comes at the cost of being fairly complicated to useיעילות הזיכרון הזו באה במחיר של היותה מסובכת למדי לשימוש.

The simplified ה-API hides most of the complexityהפשוט מסתיר את רוב המורכבות. Full objects are returnedאובייקטים מלאים מוחזרים, so you can easily consume a lot of memory with large databasesכך שאתה יכול בקלות לצרוך הרבה זיכרון עם מסדי נתונים גדולים. The routines themselves do not consume a significant amount of memoryהשגרות עצמן אינן צורכות כמות משמעותית של זיכרון, but if you decided to keep your own lists or dictionaries of dataאך אם החלטתם לשמור רשימות או מילוני נתונים משלכם, you will consume memory quicklyתצרכו זיכרון במהירות.

These Simple Classes are specifically constructed for use in pluginsמחלקות פשוטות אלו בנויות במיוחד לשימוש בתוספים/addonsתוספות, or to make או כדי ליצור [[Quick Viewsצפיות מהירות]] (available in the context menu'sזמינות בתפריט ההקשר).

==What is availableמה זמין?==

You can view the API in ניתן להציג את ה־API ב־[https://github.com/gramps-project/gramps/blob/master/gramps/gen/simple/_simpleaccess.py _simpleaccess.py].

{{stub/he}}<!-- expand to talk about the simple api code and update example for הרחב כדי לדבר על קוד ה-API הפשוט ודוגמה לעדכון עבור gramps 5.1.x -->