Difference between revisions of "He:מדרג מיקום"

From Gramps
(translate)
 
(Translation)
Line 4: Line 4:
  
 
== מבנה מיקומים חדש ==
 
== מבנה מיקומים חדש ==
 
 
=== אוביקט מקום ===
 
=== אוביקט מקום ===
  
במקום להכיל מיקום ראשי, אובייקטי מקום מסודרים כעת מדרג. הם כוללים ארבעה שדות חדשים:   
+
במקום להכיל מיקום ראשי, אובייקטי מקום מסודרים כעת במדרג. הם כוללים ארבעה שדות חדשים:   
  
 
* name
 
* name
Line 14: Line 13:
 
* code (מיקוד / מספר טלפון)
 
* code (מיקוד / מספר טלפון)
  
Places are linked to parent places via PlaceRef objectsThese contain a handle to a parent place and a Date. Places may have multiple parent places, or no parent place if they are top-level places. The first entry in the list is deemed to be the primary parent.
+
מקום מקושר למקום-הורה על ידי אובייקטי PlaceRef.  אלה מכילים קישור למקום-הורה ולתאריך. למקום מסויים יכולים להיות מספר מקומות-הורה, או, במידה והמקום הוא ברמה העליונה (הוא ההורה) ללא הורים כלל. הערך הראשון ברשימה נחשב כהורה העיקרי.
  
 
The type of a place is stored in a GrampsType called PlaceType.
 
The type of a place is stored in a GrampsType called PlaceType.
Line 20: Line 19:
 
The code field is provided to store a code associated with the place.  This could be a country code, state abbreviation, Chapman county code etc...  The database upgrade will assign the postal code and/or phone number to this field.
 
The code field is provided to store a code associated with the place.  This could be a country code, state abbreviation, Chapman county code etc...  The database upgrade will assign the postal code and/or phone number to this field.
  
=== Utility functions ===
+
=== פעולות כלים ===
  
 
To obtain a location description for a place, a path to a top-level place must be traversed.  There are a few utility functions in gen.utils.location for this purpose:
 
To obtain a location description for a place, a path to a top-level place must be traversed.  There are a few utility functions in gen.utils.location for this purpose:
Line 40: Line 39:
 
Determines each possible route up the place hierarchy, and returns a list containing dictionaries of place types and names.  Each list element represents a separate path up the hierarchy.
 
Determines each possible route up the place hierarchy, and returns a list containing dictionaries of place types and names.  Each list element represents a separate path up the hierarchy.
  
=== Database ===
+
=== מסד נתונים ===
  
 
The Place tree view displays the place hierarchy using primary parents.  A new tree cursor provides the view with place records in top-down order, which greatly simplifies the code.  Every node in the tree view represents a Gramps place.
 
The Place tree view displays the place hierarchy using primary parents.  A new tree cursor provides the view with place records in top-down order, which greatly simplifies the code.  Every node in the tree view represents a Gramps place.
Line 48: Line 47:
 
Both the place tree cursor and ''find_place_child_handles'' method use an index on the primary parent called place_parent.
 
Both the place tree cursor and ''find_place_child_handles'' method use an index on the primary parent called place_parent.
  
=== Unchanged ===
+
=== ללא שינוי ===
  
 
The place object still contains a title field.  This contains a full description of the place and is used in most reports.
 
The place object still contains a title field.  This contains a full description of the place and is used in most reports.
Line 54: Line 53:
 
Alternate locations have not been converted into new places in the hierarchy.
 
Alternate locations have not been converted into new places in the hierarchy.
  
=== What next? ===
+
=== מה הלאה? ===
  
 
* Do we want to use the new widgets demonstrated in the prototype?
 
* Do we want to use the new widgets demonstrated in the prototype?
 
* Should we support Gedcom 5.5EL? See Feature Request:{{bug|688}}
 
* Should we support Gedcom 5.5EL? See Feature Request:{{bug|688}}
  
== See also ==
+
== ראו גם ==
 
* [[GEPS 006: Better Place handling]]
 
* [[GEPS 006: Better Place handling]]
 
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Place_Format_Editor]]
 
* [[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Place_Format_Editor]]

Revision as of 16:36, 22 May 2021

Gramps-notes.png
תכונה שנוספה בגרמפס גרסת 4.1

אוביידטי מקום מאוגדים במדרג החל מגרסת גרמפס 4.1

מבנה מיקומים חדש

אוביקט מקום

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

  • name
  • type
  • placeref_list (רשימת מקומות אב)
  • code (מיקוד / מספר טלפון)

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

The type of a place is stored in a GrampsType called PlaceType.

The code field is provided to store a code associated with the place. This could be a country code, state abbreviation, Chapman county code etc... The database upgrade will assign the postal code and/or phone number to this field.

פעולות כלים

To obtain a location description for a place, a path to a top-level place must be traversed. There are a few utility functions in gen.utils.location for this purpose:

get_location_list(db, place)

Traverses the hierarchy following the primary parent and returns a list of place names. This can then be formatted using the join method.

', '.join(get_location_list(db, place))

get_main_location(db, place)

This also traverses the hierarchy following the primary parent, but returns a dictionary of place types and names. This can be used to extract a particular place type.

get_main_location(db, place).get(PlaceType.CITY)

get_locations(db, place)

Determines each possible route up the place hierarchy, and returns a list containing dictionaries of place types and names. Each list element represents a separate path up the hierarchy.

מסד נתונים

The Place tree view displays the place hierarchy using primary parents. A new tree cursor provides the view with place records in top-down order, which greatly simplifies the code. Every node in the tree view represents a Gramps place.

To find the children of a place, the existing find_backlink_handles database method can be used. If only primary parents should be followed a new find_place_child_handles method has been provided.

Both the place tree cursor and find_place_child_handles method use an index on the primary parent called place_parent.

ללא שינוי

The place object still contains a title field. This contains a full description of the place and is used in most reports.

Alternate locations have not been converted into new places in the hierarchy.

מה הלאה?

  • Do we want to use the new widgets demonstrated in the prototype?
  • Should we support Gedcom 5.5EL? See Feature Request:688

ראו גם