Changes between Version 91 and Version 92 of Help/Dialog/RelationEditor
- Timestamp:
- 2020-03-23T19:31:34+01:00 (4 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Dialog/RelationEditor
v91 v92 4 4 = Relation Editor = 5 5 6 A Relation Editor handles the members and tags of exactly one relation. 7 Don't confuse it with the [wikitr:/Help/Dialog/RelationList Relations window]. That ''JOSM window'' lists all relations. 6 A Relation editor handles the members and tags of exactly one relation. \\ 7 \\ 8 Don't confuse it with the [wikitr:/Help/Dialog/RelationList Relations list]. That [wikitr:/Help/ToggleDialogs Sidebar] panel lists all relations. 8 9 9 == The Window ==10 == The Window Layout == 10 11 === Buttons on top === 11 12 12 || [[JOSMImage(dialogs/refresh)]] || Refresh relation from data layer (see [#RelationChangedOutsideOfEditor below] for more explanation) || 13 || [[JOSMImage(save)]] || Apply the current changes made within the relation editor to the data (see [#RelationChangedOutsideOfEditor below] for more explanation) || 14 || [[JOSMImage(dialogs/select)]] || Select the relation of the relation editor window || 15 || [[JOSMImage(duplicate)]] || Clone e.g create a copy of the relation and open it in another relation editor window || 16 || [[JOSMImage(dialogs/delete,28)]] || Delete the currently edited relation || 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 || 17 19 18 20 === Tags and Members tab ===#TagMember … … 26 28 Presets 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. 27 29 28 [[Image(relation_editor.png,right,margin-left=15 )]]30 [[Image(relation_editor.png,right,margin-left=15,link=)]] 29 31 30 32 The three button one the left are: 33 ||= Icon =||= Description =|| 34 || [[JOSMImage(dialogs/add)]] || Add a new tag || 35 || [[JOSMImage(dialogs/delete,24,link=,middle)]] || Delete the current selected boxes of the tag table || 36 || [[JOSMImage(pastetags)]] || Paste tags from buffer || 31 37 32 || [[JOSMImage(dialogs/add)]] || Add a new tag || 33 || [[JOSMImage(dialogs/delete,28)]] || Delete the current selected boxes of the tag table || 34 || [[JOSMImage(pastetags)]] || Paste tags from buffer || 35 36 **Note**: In general it is easier to modify tags with the [wikitr:/Help/Dialog/TagsMembership Tags/Memberships window]. 38 **Note**: In general it is easier to modify tags with the [wikitr:/Help/Dialog/TagsMembership Tags/Memberships panel]. 37 39 38 40 ==== Members List (bottom half, left side) ====#MembersList … … 41 43 ===== Table =====#Table 42 44 The table shows for each member: 43 ||= title =||= description =||44 || Role|| its role ||45 || 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 ||45 ||= Title =||= Description =|| 46 || 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 || 46 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 || 47 49 … … 62 64 The buttons on the left offer the following actions if appropriate: 63 65 64 || [[JOSMImage(dialogs/moveup)]] || Move the [#Currentlyselectedmembers currently selected members] up (**`Alt+up`**) || 65 || [[JOSMImage(dialogs/movedown)]] || Move ''the currently selected members'' down (**`Alt+down`**) || 66 || || || 67 || [[JOSMImage(dialogs/edit)]] || Open additional relation editors for ''the currently selected members'' of object type relation || 68 || [[JOSMImage(dialogs/delete,28)]] || Remove ''the currently selected members'' from the relation (**`Alt+Delete`**) || 69 || || || 70 || [[JOSMImage(dialogs/sort)]] || Sort ''the currently selected members'' (**`Alt+End`**) || 71 || [[JOSMImage(dialogs/sort_below)]] || Sort ''the currently selected members'' and all members below ([wikitr:/Help/ExpertMode expert mode] only) || 72 || [[JOSMImage(dialogs/reverse)]] || Reverse the order of the currently selected members || 73 || || || 74 || [[JOSMImage(dialogs/relation/downloadincomplete)]] || Download all incomplete members (**`Alt+Home`**) || 75 || [[JOSMImage(dialogs/relation/downloadincompleteselected)]] || Download selected incomplete members || 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`**) || 69 |||| 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`**) || 72 |||| 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 || 76 |||| 77 || [[JOSMImage(dialogs/relation/downloadincomplete)]] || Download all incomplete members (**`Alt+Home`**) || 78 || [[JOSMImage(dialogs/relation/downloadincompleteselected)]] || Download selected incomplete members || 76 79 77 80 Text field below the table used to set role to [#Currentlyselectedmembers Currently selected members] … … 79 82 80 83 ==== Selection List (bottom half, right side) ====#SelectionList 81 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 [wikitr:/Help/Dialog/SelectionList Selection window]. Objects with yellow background color are already member of the relation.84 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 [wikitr:/Help/Dialog/SelectionList Selection list]. Objects with yellow background color are already member of the relation. 82 85 83 86 The buttons offer following actions: 84 87 85 || [[JOSMImage(dialogs/conflict/copystartright)]] || Add all objects selected in the current data set before the first member || 86 || [[JOSMImage(dialogs/conflict/copybeforecurrentright,)]] || Add all objects selected in the current data set before the first selected member || 87 || [[JOSMImage(dialogs/conflict/copyaftercurrentright)]] || Add all objects selected in the current data set after the last member selected member || 88 || [[JOSMImage(dialogs/conflict/copyendright)]] || Add all objects selected in the current data set after the last member || 89 || || || 90 || [[JOSMImage(dialogs/relation/selectmembers)]] || Select relation members in the member list which refer to objects in the current selection || 91 || [[JOSMImage(dialogs/relation/selectprimitives)]] || Select objects in the current data set for currently selected relation members in the member list || 92 || || || 93 || [[JOSMImage(dialogs/relation/deletemembers)]] || Remove all members referring to one of the selected objects in the current data set 88 ||= Icon =||= Description =|| 89 || [[JOSMImage(dialogs/conflict/copystartright)]] || Add all objects selected in the current data set before the first member || 90 || [[JOSMImage(dialogs/conflict/copybeforecurrentright,)]] || Add all objects selected in the current data set before the first selected member || 91 || [[JOSMImage(dialogs/conflict/copyaftercurrentright)]] || Add all objects selected in the current data set after the last member selected member || 92 || [[JOSMImage(dialogs/conflict/copyendright)]] || Add all objects selected in the current data set after the last member || 93 |||| 94 || [[JOSMImage(dialogs/relation/selectmembers)]] || Select relation members in the member list which refer to objects in the current selection || 95 || [[JOSMImage(dialogs/relation/selectprimitives)]] || Select objects in the current data set for currently selected relation members in the member list || 96 |||| 97 || [[JOSMImage(dialogs/relation/deletemembers)]] || Remove all members referring to one of the selected objects in the current data set 94 98 95 99 … … 101 105 Note: only one parent relation is shown for [osmwww:relation/51560 relation 51560]: 102 106 103 [[Image(relation 51560.png, nolink,50%)]]107 [[Image(relation 51560.png,link=,50%)]] 104 108 105 109 … … 107 111 This 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. 108 112 109 [[Image(children of 6016064.png, nolink,50%)]]113 [[Image(children of 6016064.png,link=,50%)]] 110 114 111 115 == Drag and Drop support == 112 The relation editor has an advanced drag and drop support. You can do the following actions:116 The Relation editor has an advanced drag and drop support. You can do the following actions: 113 117 * reorder the members in the members list 114 * move an object from the [wikitr:/Help/Dialog/SelectionList Selection window] to the members list in the relation editor (with automatic role suggestion)118 * move an object from the [wikitr:/Help/Dialog/SelectionList Selection list] to the members list in the relation editor (with automatic role suggestion) 115 119 * move an object from the members list of one relation editor instance to another relation editor instance 116 120 * move an object from the members list of one relation editor instance to another relation editor instance from another layer* 117 121 * move an object from the members list of one relation editor instance to another relation editor instance from another JOSM instance* 118 * move an object from the members list of the relation editor or from the Selection windowto an external text editor122 * move an object from the members list of the relation editor or from the Selection list to an external text editor 119 123 120 124 ^^* provided the objects are part of the dataset … … 122 126 == Error and Warning Messages == 123 127 === Conflict in data when saving or applying a relation ===#RelationChangedOutsideOfEditor 124 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 [[JOSMImage(dialogs/refresh,middle)]] refresh button to update the data in the relation editor. Anyhow JOSM keeps track of them and when you close the relation editor windowor apply changes, without pressing the refresh button before, the following warning message is displayed:128 A 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: 125 129 126 [[Image(warning-conflict-in-data.png )]]130 [[Image(warning-conflict-in-data.png,link=)]] 127 131 128 132 It 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]. … … 130 134 A similar warning is the following: 131 135 132 [[Image(relation_conflict.png )]]136 [[Image(relation_conflict.png,link=)]] 133 137 134 138 It appears when you made changes in the relation and in the data layer and then click on the refresh button. 135 139 136 140 '''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):''' 137 * '''After doing changes in the relation editor and before doing changes in the data layer press the [[JOSMImage(save ,middle)]] apply button.'''138 * '''After doing changes in the data layer and before doing changes in the relation editor press the [[JOSMImage(dialogs/refresh ,middle)]] refresh button.'''141 * '''After doing changes in the relation editor and before doing changes in the data layer press the [[JOSMImage(save)]] apply button.''' 142 * '''After doing changes in the data layer and before doing changes in the relation editor press the [[JOSMImage(dialogs/refresh)]] refresh button.''' 139 143 140 144 Otherwise you will see the above warnings and end in a conflict. 141 145 142 146 === Unsaved changes === 143 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.144 [[Image(relation_editor_unsaved_changes_warning.png,900 )]]147 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 relation editor. 148 [[Image(relation_editor_unsaved_changes_warning.png,900,link=)]] 145 149 146 150 147 151 == See also == 148 * [[JOSMImage(dialogs/relationlist ,20,middle)]] [wikitr:/Help/Dialog/RelationList Relations window] - all loaded relations are listed here152 * [[JOSMImage(dialogs/relationlist)]] [wikitr:/Help/Dialog/RelationList Relations list] - all loaded relations are listed here 149 153 * [wikitr:/Help/Concepts/Object#Relations Concepts Object] - detailed explanation what ''relation'' is 150 154 * [wikitr:/Help/Relations Relations] - steps how to create parent relations, edit parent/child relations and so on 151 155 * [wikitr:/Help/Concepts/Conflict Concepts Conflict] - explanation of conflicts 152 * Relations can be also edited using [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonitemsinmembershipspart simple right click menu] in [wikitr:/Help/Dialog/TagsMembership Tags/Membership window]156 * Relations can be also edited using [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonitemsinmembershipspart simple right click menu] in [wikitr:/Help/Dialog/TagsMembership Tags/Membership panel] 153 157 * 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] 154 158