Changes between Version 80 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

    v80 v103  
    22[[PageOutline(2-10,Table of Contents)]]
    33
    4 ''If you are looking for complete list of [Concepts/Object#Relations relations] loaded in your JOSM, see [Dialog/RelationList Relations window]''[[br]]
    5 ''Relations can be also edited using [Help/Menu/TagsMembershipMenu#Rightclickonitemsinmembershipspart simple right click menu] in [Help/Dialog/TagsMembership Tags/Membership window]''[[br]]
    6 ''Some of [wiki:Plugins plugins] can simplify [Help/Relations editing of relations], namely [Help/Plugin/TurnRestrictions turnrestrictions] or [osmwiki:Relations/Proposed/turn_lanes#Plugin turnlanes]''
     4= Relation Editor =
    75
    8 = Relation Editor window =
    9 
    10 The relation editor window is one of many options to create, modify, and delete relations; this is most comprehensive tool in core JOSM.
    11 
    12 == Activation steps ==
    13 
    14  * in [Help/Dialog/RelationEditor Relation editor]:
    15   * [#Buttonsontop Duplicate button] will open created relation in RE
    16   * [#Buttons Buttons in "Memberships" part] can open one or multiple RE
    17   * [#Table Double click complete relation in memberships table] to open RE
    18   * [#ParentRelationstab Selection relation(s), then press "Edit" button in "Parent Relations" tab] to open one or multiple RE
    19   * [#ParentRelationstab Double click on item in "Parent Relations" tab] to open RE
    20  * in [Help/Dialog/TagsMembership Tags/Membership window]:
    21   * If there "Member of" table, you can:
    22    * Use [Help/Dialog/TagsMembership#rightclickmembership right mouse click] and select "Edit" to open RE
    23    * [Help/Dialog/TagsMembership#doubleclickmembership Double click an item] to open RE
    24  * in [Help/Dialog/RelationList Relations window]:
    25   * Use "''Create a relation''" button to create a new relation and open it in RE
    26   * Select relations (in "Relations" window), use second button to open one or multiple RE
    27   * Duplicate relation button will open it in RE
    28  * in [Help/Dialog/SelectionList Selection window]:
    29   * Select relation(s) (but now in "Selection" window), use "Edit" context command to open RE
    30   * Double click a relation to open RE
    31 
    32 == Relation Editor ==
    33 
    34 === Buttons on top ===
    35 
    36 || [[Image(source:trunk/images/dialogs/refresh.png)]] || Refresh relation from data layer (see [#RelationChangedOutsideOfEditor below] for more explanation) ||
    37 || [[Image(source:trunk/images/save.png)]] || Apply the current changes made within the relation editor to the data TODO: clarify when to use it ||
    38 || [[Image(source:trunk/images/dialogs/select.png)]] || Select the relation of the relation editor window ||
    39 || [[Image(source:trunk/images/duplicate.png)]] || Clone e.g create a copy of the relation and open it in another relation editor window ||
    40 || [[Image(source:trunk/images/dialogs/delete.png)]] || Delete the currently edited 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]. \\
     7\\
     8Don't confuse it with the [wikitr:/Help/Dialog/RelationList Relations list panel]. That [wikitr:/Help/ToggleDialogs Sidebar] panel lists all relations.
    419
    4210
     11== The Dialog Layout ==
     12=== Buttons on top ===#Buttonsontop
     13||= **Icon** =||= **Description** =||
     14||  [[JOSMImage(dialogs/refresh)]]  || Refresh relation from data layer (see [#RelationChangedOutsideOfEditor below] for more explanation) ||
     15||  [[JOSMImage(save)]]  || Apply the current changes made within the relation editor to the data (see [#RelationChangedOutsideOfEditor below] for more explanation) ||
     16||  [[JOSMImage(dialogs/select)]]  || Select the relation of the relation editor ||
     17||  [[JOSMImage(duplicate)]]  || Clone e.g create a copy of the relation and open it in another relation editor ||
     18||  [[JOSMImage(dialogs/delete,24,link=,middle)]]  || Delete the currently edited relation ||
     19
    4320=== Tags and Members tab ===#TagMember
    44 The tags and members tab has an upper part similar to the [Dialog/TagsMembership Tags/Memberships window] where tags for the relation can be entered and a lower part that contains the list of members of the relation on the left side and a list of the current selection on the right.
     21The tags and members tab has an upper half where tags for the relation itself can be entered.
    4522
    46 [[Image(relation_editor.png,right,margin-left=15)]]
     23Its 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.
    4724
    48 ==== Upper half, tags of the relation itself ====
    49 On top in the upper part are links to presets matching the current '''''tags of the relation''''' and below are the tags in a table.
     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.
    5026
    51 Presets matching relation can be opened here (they are more suggestive than tags panel). [/wiki/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview Click respective link to open full preset], as usual.
     27==== Tags of Relation (upper part) ====#TagsRelation
     28On top in the upper part are links to presets matching the current ''**tags of the relation**'' and below are the tags in a table.
     29
     30Presets matching relation can be opened here (they are more suggestive than tags panel). [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview Click respective link to open full preset], as usual.
     31
     32[[Image(relation_editor.png,right,margin-left=15,link=)]]
    5233
    5334The three button one the left are:
     35||= **Icon** =||= **Description** =||
     36||  [[JOSMImage(dialogs/add)]]  || Add a new tag ||
     37||  [[JOSMImage(dialogs/delete,24,link=,middle)]]  || Delete the current selected boxes of the tag table ||
     38||  [[JOSMImage(pastetags)]]  || Paste tags from buffer ||
    5439
    55 || [[Image(source:trunk/images/dialogs/add.png)]] || Add a new tag ||
    56 || [[Image(source:trunk/images/dialogs/delete.png)]] || Delete the current selected boxes of the tag table ||
    57 || [[Image(source:trunk/images/pastetags.png)]] || Paste tags from buffer ||
     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]
    5841
    59 Note: In general it is easier to modify tags with the [Dialog/TagsMembership Tags/Memberships window].
     42**Note**: In general, it is easier to modify tags with the Tags/Memberships panel.
    6043
    61 ==== Bottom half, left side, members ====
     44==== Members List (bottom half, left side) ====#MembersList
    6245In the lower left part is the member table of the relation.
    6346
    64 ===== Table =====
     47===== Table =====#Table
    6548The table shows for each member:
    66  * its role on the left
    67  * in the middle the object type as icon plus some identifier like name, ref or simply the id of the object
    68   * Double-clicking on a line with ''complete relation'' there will open this ''Relationship editor'' for the relation in question
    69  * on the right information about neighbor ways' connections useful for consistency checks like checking that the members of a [Help/Concepts/Object#typemultipolygon multipolygon] form closed ways or that a route is a complete line without missing some ways in the middle.
     49||= **Title** =||= **Description** =||
     50||  Role  || its role || 
     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 ||
    7053
    7154====== Context menu in table ======
    72 
    7355Gap is indicated as red dot.
    7456
    75 * Zoom to - will zoom to the topmost element of the [#Currentlyselectedmembers currently selected members]
    76 * Zoom to Gap (actionable only when gap is selected) - will zoom to gap
    77 * Zoom to previous gap
    78 * Zoom to 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] ||
    7965
    80 ===== Currently selected members =====
    81 Selecting members in the [[#Table]] works as usual: hold {{{Ctrl}}} to select multiple items. Left click on the item to add/remove it from the selection.
     66===== Currently selected members =====#Currentlyselectedmembers
     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.
    8268
    83 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.
    8470
    8571===== Buttons =====
    86 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.)'':
    8773
    88 || [[Image(source:trunk/images/dialogs/moveup.png)]] || Move the [#Currentlyselectedmembers currently selected members] up (**`Alt+up`**) ||
    89 || [[Image(source:trunk/images/dialogs/movedown.png)]] || Move ''the currently selected members'' down (**`Alt+down`**) ||
    90 || || ||
    91 || [[Image(source:trunk/images/dialogs/edit.png)]] || Open additional relation editors for ''the currently selected members'' of object type relation ||
    92 || [[Image(source:trunk/images/dialogs/delete.png)]] || Remove ''the currently selected members'' from the relation (**`Alt+Delete`**) ||
    93 || || ||
    94 || [[Image(source:trunk/images/dialogs/sort.png)]] || Sort ''the currently selected members'' (**`Alt+End`**) ||
    95 || [[Image(source:trunk/images/dialogs/sort_below.png)]] || Sort ''the currently selected members'' and all members below ([ExpertMode expert mode] only) ||
    96 || [[Image(source:trunk/images/dialogs/relation/reverse.png)]] || Reverse the order of the currently selected members ||
    97 || || ||
    98 || [[Image(source:trunk/images/dialogs/relation/downloadincomplete.png)]] || Download all incomplete members (**`Alt+Home`**) ||
    99 || [[Image(source:trunk/images/dialogs/relation/downloadincompleteselected.png)]] || Download selected incomplete members ||
     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 ||
     77||||
     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 ||
     80||||
     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 ||
     84||||
     85||  [[JOSMImage(dialogs/relation/downloadincomplete)]]  ||  **`Alt+Home`**  || Download all incomplete members ||
     86||  [[JOSMImage(dialogs/relation/downloadincompleteselected)]]  ||  || Download selected incomplete members ||
    10087
    101 Text field below the table used to set role to [[#Currentlyselectedmembers]]
     88**Note**: Besides the listed buttons and shortcuts above, `Ctrl+C`, `Ctrl+V` and `Ctrl+X` work as common in the member list.
    10289
    103 ==== Bottom half, right side, selection ====
    104 In the lower right part is the selection list where currently selected objects in the current data set are shown. The list is basically a mirror of the [Dialog/SelectionList Selection window]. Objects with yellow background color are already member of the relation.
     90Text field below the table can be used to set a role to all [#Currentlyselectedmembers Currently selected members]
     91
     92
     93==== Selection List (bottom half, right side) ====#SelectionList
     94In the lower right part is the selection list where currently selected objects in the current data set are shown. The list is basically a mirror of the [wikitr:/Help/Dialog/SelectionList Selection list]. Objects with yellow background color are already member of the relation.
    10595
    10696The buttons offer following actions:
    10797
    108 || [[Image(source:trunk/images/dialogs/conflict/copystartright.svg)]] || Add all objects selected in the current data set before the first member ||
    109 || [[Image(source:trunk/images/dialogs/conflict/copybeforecurrentright.svg,)]] || Add all objects selected in the current data set before the first selected member ||
    110 || [[Image(source:trunk/images/dialogs/conflict/copyaftercurrentright.svg)]] || Add all objects selected in the current data set after the last member selected member ||
    111 || [[Image(source:trunk/images/dialogs/conflict/copyendright.svg)]] || Add all objects selected in the current data set after the last member ||
    112 || || ||
    113 || [[Image(source:trunk/images/dialogs/relation/selectmembers.svg)]] || Select relation members in the member list which refer to objects in the current selection ||
    114 || [[Image(source:trunk/images/dialogs/relation/selectprimitives.svg)]] || Select objects in the current data set for currently selected relation members in the member list ||
    115 || || ||
    116 || [[Image(source:trunk/images/dialogs/relation/deletemembers.svg)]] || Remove all members referring to one of the selected objects in the current data set
     98||= **Icon** =||= **Description** =||
     99||  [[JOSMImage(dialogs/conflict/copystartright)]]  || Add all objects selected in the current data set before the first member ||
     100||  [[JOSMImage(dialogs/conflict/copybeforecurrentright,)]]  || Add all objects selected in the current data set before the first selected member ||
     101||  [[JOSMImage(dialogs/conflict/copyaftercurrentright)]]  || Add all objects selected in the current data set after the last member selected member ||
     102||  [[JOSMImage(dialogs/conflict/copyendright)]]  || Add all objects selected in the current data set after the last member ||
     103||||
     104||  [[JOSMImage(dialogs/relation/selectmembers)]]  || Select relation members in the member list which refer to objects in the current selection ||
     105||  [[JOSMImage(dialogs/relation/selectprimitives)]]  || Select objects in the current data set for currently selected relation members in the member list ||
     106||||
     107||  [[JOSMImage(dialogs/relation/deletemembers)]]  || Remove all members referring to one of the selected objects in the current data set ||
    117108
    118 === Parent Relations tab ===
    119109
     110=== Parent Relations tab ===#ParentRelations
    120111Reload button - will fetch all parent relation from API (parent relations list will be empty if there no parent relations).
    121112
    … …  
    124115Note: only one parent relation is shown for [osmwww:relation/51560 relation 51560]:
    125116
    126 [[Image(relation 51560.png,nolink,50%)]]
     117[[Image(relation 51560.png,link=,600)]]
    127118
    128 === Child Relations tab ===
    129119
    130 TODO: any details?
     120=== Child Relations tab ===#ChildRelations
     121This 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.
    131122
    132 [[Image(child relations of 1152180.png,nolink,50%)]]
     123[[Image(children of 6016064.png,link=,600)]]
     124
    133125
    134126== Drag and Drop support ==
    135 The relation editor has an advanced drag and drop support. You can do the following actions:
     127The Relation editor has an advanced drag and drop support. You can do the following actions:
    136128* reorder the members in the members list
    137 * move an object from the [wiki:Help/Dialog/SelectionList Selection window] to the members list in the relation editor (with automatic role suggestion)
     129* move an object from the [wikitr:/Help/Dialog/SelectionList Selection list] to the members list in the relation editor (with automatic role suggestion)
    138130* move an object from the members list of one relation editor instance to another relation editor instance
    139131* move an object from the members list of one relation editor instance to another relation editor instance from another layer*
    140132* move an object from the members list of one relation editor instance to another relation editor instance from another JOSM instance*
    141 * move an object from the members list of the relation editor or from the Selection window to an external text editor
     133* move an object from the members list of the relation editor or from the Selection list to an external text editor
    142134
    143135^^* provided the objects are part of the dataset
    144136
     137
    145138== Error and Warning Messages ==
    146139=== Conflict in data when saving or applying a relation ===#RelationChangedOutsideOfEditor
    147 {{{
    148 #!html
    149 <a name="RelationChangedOutsideOfEditor">
    150 }}}
    151 A relation may be edited concurrently in the relation editor window ''and'' outside of the relation editor window. While the relation editor window for a relation is open you may for instance split a way the relation refers to. In this case, the relation is modified but the changes due to the way splitting are not immediately reflected in the relation editor window. You need to click on the [[Image(source:trunk/images/dialogs/refresh.png,middle)]] refresh button to update the data in the relation editor. Anyhow JOSM keeps track of them and when you close the relation editor window or apply changes, without pressing the refresh button before, the following warning message is displayed:
     140A relation may be edited concurrently in the relation editor ''and'' outside of the relation editor. While the relation editor for a relation is open you may for instance split a way the relation refers to. In this case, the relation is modified but the changes due to the way splitting are not immediately reflected in the relation editor. You need to click on the [[JOSMImage(dialogs/refresh)]] refresh button to update the data in the relation editor. Anyhow JOSM keeps track of them and when you close the relation editor or apply changes, without pressing the refresh button before, the following warning message is displayed:
    152141
    153 [[Image(warning-conflict-in-data.png)]]
     142[[Image(warning-conflict-in-data.png,link=)]]
    154143
    155 It indicates that JOSM is aware of two incompatible [Concepts/Object#Objectversions versions] of this relation. Since JOSM can't resolve the differences between these versions automatically, it proposes to create a [Concepts/Conflict conflict] which you can [Concepts/Conflict#Resolvingconflicts resolve] later using the [Dialog/Conflict Conflict Dialog].
     144It indicates that JOSM is aware of two incompatible [wikitr:/Help/Concepts/Object#Objectversionsandhistory versions] of this relation. Since JOSM can't resolve the differences between these versions automatically, it proposes to create a [wikitr:/Help/Concepts/Conflict conflict] which you can [wikitr:/Help/Concepts/Conflict#Resolvingconflicts resolve] later using the [wikitr:/Help/Dialog/Conflict Conflict Dialog].
    156145
    157146A similar warning is the following:
    158147
    159 [[Image(relation_conflict.png)]]
     148[[Image(relation_conflict.png,link=)]]
    160149
    161150It appears when you made changes in the relation and in the data layer and then click on the refresh button.
    162151
    163 '''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):'''
    164 * '''After doing changes in the relation editor and before doing changes in the data layer press the [[Image(source:trunk/images/save.png)]] apply button.'''
    165 * '''After doing changes in the data layer and before doing changes in the relation editor press the [[Image(source:trunk/images/dialogs/refresh.png)]] 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.
    166155
    167156Otherwise you will see the above warnings and end in a conflict.
    168157
    169158=== Unsaved changes ===
    170 The 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 window.
    171 [[Image(relation_editor_unsaved_changes_warning.png,900)]]
     159The 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.
     160
     161[[Image(relation_editor_unsaved_changes_warning.png,link=)]]
     162
    172163
    173164== See also ==
    174 * [[Image(source:trunk/images/dialogs/relationlist.png,20,middle)]] [Dialog/RelationList Relations window] - all loaded relations are listed here
    175 * [Concepts/Object Object] - detailed explanation what ''relation'' is
    176 * [[Help/Relations]] - steps how to create parent relations, edit parent/child relations and so on
    177 * [[Concepts/Conflict]]
     165* [[JOSMImage(dialogs/relationlist)]] [wikitr:/Help/Dialog/RelationList Relations list] - all loaded relations are listed here
     166* [wikitr:/Help/Concepts/Object#Relations Concepts Object] - detailed explanation what ''relation'' is
     167* [wikitr:/Help/Relations Relations] - steps how to create parent relations, edit parent/child relations and so on
     168* [wikitr:/Help/Concepts/Conflict Concepts Conflict] - explanation of conflicts
     169* Relations can be also edited using [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonaparentrelationinmembershipspart simple right click menu] in [wikitr:/Help/Dialog/TagsMembership Tags/Membership panel]
     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]
    178171
    179172----
    180 Back to [wiki:/Help Main Help]
     173Back to [wikitr:/Help/Dialog Dialog] \\
     174Back to [wikitr:/Help Main Help]