| 7 | | == Сообщения об ошибках и предупреждения == |
| 8 | | === Конфликты в данных === |
| | 8 | = Окно редактора отношений = |
| | 9 | |
| | 10 | Окно редактора отношений — это один из многих способов создания, редактирования и удаления отношений. Это самый мощный инструмент в ядре JOSM. |
| | 11 | |
| | 12 | == Способы активации == |
| | 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 || |
| | 41 | |
| | 42 | |
| | 43 | === 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. |
| | 45 | |
| | 46 | [[Image(relation_editor.png,right,margin-left=15)]] |
| | 47 | |
| | 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. |
| | 50 | |
| | 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. |
| | 52 | |
| | 53 | The three button one the left are: |
| | 54 | |
| | 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 || |
| | 58 | |
| | 59 | Note: In general it is easier to modify tags with the [Dialog/TagsMembership Tags/Memberships window]. |
| | 60 | |
| | 61 | ==== Bottom half, left side, members ==== |
| | 62 | In the lower left part is the member table of the relation. |
| | 63 | |
| | 64 | ===== Table ===== |
| | 65 | The 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. |
| | 70 | |
| | 71 | ====== Context menu in table ====== |
| | 72 | |
| | 73 | Gap is indicated as red dot. |
| | 74 | |
| | 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 |
| | 79 | |
| | 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. |
| | 82 | |
| | 83 | On the right you can see example that only "K 8830" way was selected. |
| | 84 | |
| | 85 | ===== Buttons ===== |
| | 86 | The buttons on the left offer the following actions if appropriate: |
| | 87 | |
| | 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 || |
| | 100 | |
| | 101 | Text field below the table used to set role to [[#Currentlyselectedmembers]] |
| | 102 | |
| | 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. |
| | 105 | |
| | 106 | The buttons offer following actions: |
| | 107 | |
| | 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 |
| | 117 | |
| | 118 | === Parent Relations tab === |
| | 119 | |
| | 120 | Reload button - will fetch all parent relation from API (parent relations list will be empty if there no parent relations). |
| | 121 | |
| | 122 | Double click at any parent relation will open ''Relation editor'' with respective relation. |
| | 123 | |
| | 124 | Note: only one parent relation is shown for [osmwww:relation/51560 relation 51560]: |
| | 125 | |
| | 126 | [[Image(relation 51560.png,nolink,50%)]] |
| | 127 | |
| | 128 | === Child Relations tab === |
| | 129 | |
| | 130 | TODO: any details? |
| | 131 | |
| | 132 | [[Image(child relations of 1152180.png,nolink,50%)]] |
| | 133 | |
| | 134 | == Drag and Drop support == |
| | 135 | The relation editor has an advanced drag and drop support. You can do the following actions: |
| | 136 | * 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) |
| | 138 | * move an object from the members list of one relation editor instance to another relation editor instance |
| | 139 | * move an object from the members list of one relation editor instance to another relation editor instance from another layer* |
| | 140 | * 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 |
| | 142 | |
| | 143 | ^^* provided the objects are part of the dataset |
| | 144 | |
| | 145 | == Error and Warning Messages == |
| | 146 | === Conflict in data when saving or applying a relation ===#RelationChangedOutsideOfEditor |
| 17 | | It indicates that JOSM is aware of two incompatible [wiki:/Help/Concepts/Object versions] of this relation. Since JOSM can't resolve the differences between these versions automatically, it proposes to create a [wiki:/Help/Concepts/Conflict conflict] which you can [wiki:/Help/Concepts/Conflict resolve] later using the [wiki:/Help/Dialog/Conflict Conflict Dialog]. |
| | 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]. |
| | 156 | |
| | 157 | A similar warning is the following: |
| | 158 | |
| | 159 | [[Image(relation_conflict.png)]] |
| | 160 | |
| | 161 | It appears when you made changes in the relation and in the data layer and then click on the refresh button. |
| | 162 | |
| | 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.''' |
| | 166 | |
| | 167 | Otherwise you will see the above warnings and end in a conflict. |
| | 168 | |
| | 169 | === 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)]] |
| | 172 | |
| | 173 | == 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]] |
| | 178 | |
| | 179 | ---- |
| | 180 | Back to [wiki:/Help Main Help] |
