Changes between Version 93 and Version 103 of Help/Dialog/RelationEditor


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Help/Dialog/RelationEditor

    v93 v103  
    44= Relation Editor =
    55
    6 A Relation editor handles the members and tags of exactly one relation. \\
     6A Relation editor handles the members and [wikitr:/Help/Concepts/Object#Tags1 tags] of exactly one [[JOSMImage(data/relation)]] [wikitr:/Help/Concepts/Object#Relations relation]. \\
    77\\
    8 Don't confuse it with the [wikitr:/Help/Dialog/RelationList Relations list]. That [wikitr:/Help/ToggleDialogs Sidebar] panel lists all relations.
     8Don't confuse it with the [wikitr:/Help/Dialog/RelationList Relations list panel]. That [wikitr:/Help/ToggleDialogs Sidebar] panel lists all relations.
    99
    1010
    11 == The Window Layout ==
     11== The Dialog Layout ==
    1212=== Buttons on top ===#Buttonsontop
    13 ||= Icon =||= Description =||
    14 ||  [[JOSMImage(dialogs/refresh)]] || Refresh relation from data layer (see [#RelationChangedOutsideOfEditor below] for more explanation) ||
     13||= **Icon** =||= **Description** =||
     14||  [[JOSMImage(dialogs/refresh)]]  || Refresh relation from data layer (see [#RelationChangedOutsideOfEditor below] for more explanation) ||
    1515||  [[JOSMImage(save)]]  || Apply the current changes made within the relation editor to the data (see [#RelationChangedOutsideOfEditor below] for more explanation) ||
    1616||  [[JOSMImage(dialogs/select)]]  || Select the relation of the relation editor ||
     
    2323Its lower part has two separate lists. On the left the members of the relation are listed. The list on the right hand side shows the current selection of map objects.
    2424
     25In between the two parts the horizontal separator includes two buttons on the left side with a [[JOSMImage(svpUp,link=,middle,16)]] up and [[JOSMImage(svpDown,link=,middle,16)]] down arrow to move the separator to center, up or down and hide, respectively, display the upper or lower part.
     26
    2527==== Tags of Relation (upper part) ====#TagsRelation
    2628On top in the upper part are links to presets matching the current ''**tags of the relation**'' and below are the tags in a table.
     
    3133
    3234The three button one the left are:
    33 ||= Icon =||= Description =||
     35||= **Icon** =||= **Description** =||
    3436||  [[JOSMImage(dialogs/add)]]  || Add a new tag ||
    3537||  [[JOSMImage(dialogs/delete,24,link=,middle)]]  || Delete the current selected boxes of the tag table ||
    3638||  [[JOSMImage(pastetags)]]  || Paste tags from buffer ||
    3739
    38 **Note**: In general it is easier to modify tags with the [wikitr:/Help/Dialog/TagsMembership Tags/Memberships panel].
     40When a tag line is selected, the `F1` key links to the tag's OSM wiki page, like in the [[JOSMImage(dialogs/propertiesdialog)]] [wikitr:/Help/Dialog/TagsMembership Tags/Memberships panel]
     41
     42**Note**: In general, it is easier to modify tags with the Tags/Memberships panel.
    3943
    4044==== Members List (bottom half, left side) ====#MembersList
     
    4347===== Table =====#Table
    4448The table shows for each member:
    45 ||= Title =||= Description  =||
     49||= **Title** =||= **Description** =||
    4650||  Role  || its role || 
    47 ||  Refers to  ||   the object type as icon plus some identifier like name, ref or simply the id of the object ; Double-clicking on a line with ''complete relation'' there will open this ''Relationship editor'' for the relation in question ||
    48 || || on the right information about neighbor ways' connections useful for consistency checks like checking that the members of a [wikitr:/Help/Concepts/Object#typemultipolygon multipolygon] form closed ways or that a route is a complete line without missing some ways in the middle  ||
     51||  Refers to  || the object type as icon plus some identifier like name, ref or simply the id of the object ; Double-clicking on a line with ''complete relation'' there will open this ''Relationship editor'' for the relation in question ||
     52|| || on the right information about neighbor ways' connections useful for consistency checks like checking that the members of a [wikitr:/Help/Concepts/Object#typemultipolygon multipolygon] form closed ways or that a route is a complete line without missing some ways in the middle ||
    4953
    5054====== Context menu in table ======
    5155Gap is indicated as red dot.
    5256
    53 * Zoom to - will zoom to the topmost element of the [#Currentlyselectedmembers currently selected members]
    54 * Zoom to Gap (actionable only when gap is selected) - will zoom to gap
    55 * Select previous gap
    56 * Select next gap
     57||= **Icon** =||= **Name** =||= **Description** =||
     58||  || Zoom to || select the topmost element of the [#Currentlyselectedmembers currently selected members] in [[JOSMImage(dialogs/selectionlist)]] [wikitr:/Help/Dialog/SelectionList selection list panel] and zoom to it ||
     59||||
     60||  || Zoom to Gap || will zoom to gap (only available when gap is selected) ||
     61||||
     62||  || Select previous gap || select the previous member ahead without connection above ||
     63||  || Select next gap || select the next member behind without connection below ||
     64||  [[JOSMImage(dialogs/history)]]  || History || open a [wikitr:/Help/Action/ObjectHistory History browser] for each [#Currentlyselectedmembers currently selected member] ||
    5765
    5866===== Currently selected members =====#Currentlyselectedmembers
    59 Selecting members in the [#Table Table] works as usual: hold {{{Ctrl}}} to select multiple items. Left click on the item to add/remove it from the selection.
     67Selecting members in the [#Table members list table] works as usual: hold `Ctrl` to select multiple items. Left click on the item to add/remove it from the selection.
    6068
    61 On the right you can see example that only "K 8830" way was selected.
     69On the right you can see an example with only one member way selected.
    6270
    6371===== Buttons =====
    64 The buttons on the left offer the following actions if appropriate:
     72The buttons on the left offer the following actions if appropriate. (''Plugins may add additional buttons.)'':
    6573
    66 ||= Icon =||= Description =||
    67 ||  [[JOSMImage(dialogs/moveup)]]  || Move the [#Currentlyselectedmembers currently selected members] up (**`Alt+up`**) ||
    68 ||  [[JOSMImage(dialogs/movedown)]]  || Move ''the currently selected members'' down (**`Alt+down`**) ||
     74||= **Icon** =||= **Shortcut** =||= **Description** =||
     75||  [[JOSMImage(dialogs/up)]]  ||  **`Alt+up`**  || Move the [#Currentlyselectedmembers currently selected members] up ||
     76||  [[JOSMImage(dialogs/down)]]  ||  **`Alt+down`**  || Move ''the currently selected members'' down ||
    6977||||
    70 ||  [[JOSMImage(dialogs/edit)]]  || Open additional relation editors for ''the currently selected members'' of object type relation ||
    71 ||  [[JOSMImage(dialogs/delete,24,link=,middle)]]  || Remove ''the currently selected members'' from the relation (**`Alt+Delete`**) ||
     78||  [[JOSMImage(dialogs/edit)]]  ||  || Open additional relation editors for ''the currently selected members'' of object type relation ||
     79||  [[JOSMImage(dialogs/delete,24,link=,middle)]]  ||  **`Alt+Delete`**  || Remove ''the currently selected members'' from the relation ||
    7280||||
    73 ||  [[JOSMImage(dialogs/sort)]]  || Sort ''the currently selected members'' (**`Alt+End`**) ||
    74 ||  [[JOSMImage(dialogs/sort_below)]]  || Sort ''the currently selected members'' and all members below ([wikitr:/Help/ExpertMode expert mode] only) ||
    75 ||  [[JOSMImage(dialogs/reverse)]]  || Reverse the order of the currently selected members ||
     81||  [[JOSMImage(dialogs/sort)]]  ||  **`Alt+End`**  || Sort ''the currently selected members'' ||
     82||  [[JOSMImage(dialogs/sort_below)]]  ||  || Sort ''the currently selected members'' and all members below ([wikitr:/Help/ExpertMode expert mode] only) ||
     83||  [[JOSMImage(dialogs/reverse)]]  ||  || Reverse the order of the currently selected members ||
    7684||||
    77 ||  [[JOSMImage(dialogs/relation/downloadincomplete)]]  || Download all incomplete members (**`Alt+Home`**) ||
    78 ||  [[JOSMImage(dialogs/relation/downloadincompleteselected)]]  || Download selected incomplete members ||
     85||  [[JOSMImage(dialogs/relation/downloadincomplete)]]  ||  **`Alt+Home`**  || Download all incomplete members ||
     86||  [[JOSMImage(dialogs/relation/downloadincompleteselected)]]  ||  || Download selected incomplete members ||
    7987
    80 Text field below the table used to set role to [#Currentlyselectedmembers Currently selected members]
     88**Note**: Besides the listed buttons and shortcuts above, `Ctrl+C`, `Ctrl+V` and `Ctrl+X` work as common in the member list.
     89
     90Text field below the table can be used to set a role to all [#Currentlyselectedmembers Currently selected members]
    8191
    8292
     
    8696The buttons offer following actions:
    8797
    88 ||= Icon =||= Description =||
     98||= **Icon** =||= **Description** =||
    8999||  [[JOSMImage(dialogs/conflict/copystartright)]]  || Add all objects selected in the current data set before the first member ||
    90100||  [[JOSMImage(dialogs/conflict/copybeforecurrentright,)]]  || Add all objects selected in the current data set before the first selected member ||
     
    95105||  [[JOSMImage(dialogs/relation/selectprimitives)]]  || Select objects in the current data set for currently selected relation members in the member list ||
    96106||||
    97 ||  [[JOSMImage(dialogs/relation/deletemembers)]]  || Remove all members referring to one of the selected objects in the current data set
     107||  [[JOSMImage(dialogs/relation/deletemembers)]]  || Remove all members referring to one of the selected objects in the current data set ||
    98108
    99109
     
    105115Note: only one parent relation is shown for [osmwww:relation/51560 relation 51560]:
    106116
    107 [[Image(relation 51560.png,link=,50%)]]
     117[[Image(relation 51560.png,link=,600)]]
    108118
    109119
     
    111121This pane recursively shows all child relations, e.g., for a [osmwiki:Relation:network network] all of its [osmwiki:Relation:route_master route master] and [osmwiki:Relation:route route] relations. Incomplete relations are downloaded when expanding or double-clicking the tree node. A separate relation editor is opened when double-clicking one of the child relations.
    112122
    113 [[Image(children of 6016064.png,link=,50%)]]
     123[[Image(children of 6016064.png,link=,600)]]
    114124
    115125
     
    140150It appears when you made changes in the relation and in the data layer and then click on the refresh button.
    141151
    142 **So the workflow should always be like this (if you want to do changes in the relation editor ''and'' the data layer at the same time, i.e. while the relation editor stays open):**
    143 * **After doing changes in the relation editor and before doing changes in the data layer press the [[JOSMImage(save)]] apply button.**
    144 * **After doing changes in the data layer and before doing changes in the relation editor press the [[JOSMImage(dialogs/refresh)]] refresh button.**
     152**So the workflow should always be like this** (if you want to do changes in the relation editor **''and''** the data layer at the same time, i.e. while the relation editor stays open):
     153* **After doing changes in the relation editor** and **before doing changes in the data layer** press the [[JOSMImage(save)]] apply button.
     154* **After doing changes in the data layer** and **before doing changes in the relation editor** press the [[JOSMImage(dialogs/refresh)]] refresh button.
    145155
    146156Otherwise you will see the above warnings and end in a conflict.
     
    148158=== Unsaved changes ===
    149159The following warning appears when you make changes in the relation editor and do not press the Apply or OK button, but the Cancel button, the cross or `Escape` to close the relation editor.
    150 [[Image(relation_editor_unsaved_changes_warning.png,900,link=)]]
     160
     161[[Image(relation_editor_unsaved_changes_warning.png,link=)]]
    151162
    152163
     
    157168* [wikitr:/Help/Concepts/Conflict Concepts Conflict] - explanation of conflicts
    158169* Relations can be also edited using [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonaparentrelationinmembershipspart simple right click menu] in [wikitr:/Help/Dialog/TagsMembership Tags/Membership panel]
    159 * Some of [wikitr:/Plugins plugins] can simplify [wikitr:/Help/Relations editing of relations], namely [wikitr:/Help/Plugin/TurnRestrictions turnrestrictions] or [osmwiki:Relations/Proposed/turn_lanes#Plugin turnlanes]
     170* Some of [wikitr:/Plugins plugins] can simplify [wikitr:/Help/Relations editing of relations], namely [wikitr:/Help/Plugin/TurnRestrictions turnrestrictions], [osmwiki:Relations/Proposed/turn_lanes#Plugin turnlanes] or [osmwiki:JOSM/Plugins/PT_Assistant pt_assistant]
    160171
    161172----
     173Back to [wikitr:/Help/Dialog Dialog] \\
    162174Back to [wikitr:/Help Main Help]