Changes between Version 20 and Version 31 of Help/Dialog/Conflict


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Dialog/Conflict

    v20 v31  
    1 [[TranslatedPages(outdated=This page needs a review as the conflict dialog changed a bit and the properties tab plus the buttons in the nodes and members tabs are not documented. Most screenshots are outdated)]]
     1[[TranslatedPages]]
    22
    33= Conflict Dialog =
     
    66**The Conflict Dialog is used to resolve [wikitr:/Help/Concepts/Conflict conflicts] between two [wikitr:/Help/Concepts/Object#Objectversionsandhistory versions] of an OSM object.**
    77
    8 [[Image(conflict-dialog_v19207.png)]]
     8[[Image(conflict-dialog_v19207.png,55%)]]
    99
    1010The dialog has four tabs but depending on the [wikitr:/Help/Concepts/Object#NodesWaysRelations object type] only some are active, though, the ''Properties'' and the ''Tags'' tab are always active. The tabs from left to right are:
    11  [#ResolvingConflictsProperties Properties]:: Conflicts in main properties of the object
     11
     12 [#ResolvingConflictsProperties Properties]:: Basic information of the object and conflicts in main properties of the object
    1213 [#Resolvingdifferencesbetweentags Tags]:: Conflicts in [wikitr:/Help/Concepts/Object#Tags1 tags]
    1314 [#ResolvingConflictsNodeMemberList Nodes]:: Conflicts in the node list (only relevant for [[JOSMImage(data/way)]] [wikitr:/Help/Concepts/Object#Ways ways])
    1415 [#ResolvingConflictsNodeMemberList Members]:: Conflicts in members (only relevant for [[JOSMImage(data/relation)]] [wikitr:/Help/Concepts/Object#Relation relations])
     16
     17[[Image(tabs_v19207.png)]]
    1518
    1619If there are conflicts in a tab it is indicated with a red square ([[JOSMImage(dialogs/conflict/mergeincomplete,link=,top)]]) in front of the name and in case of tag conflicts the number of conflicting tags is display in brackets behind the name. All conflicts in these tabs need to be solved. \\
     
    2528 * In case of a conflict between the [wikitr:/Help/Dialog/RelationEditor Relation Editor] and the data layer this is the version of the relation editor.
    2629
     30[[Image(conflict-dialog-versions_v19207.png,60%,center)]]
     31
    2732
    2833== Resolving differences between properties ==#ResolvingConflictsProperties
    29 If the properties (`Coordinates` or `Deleted State`) of one version of an object are different from the properties of another version, the Conflict dialog shows a red square ([[JOSMImage(dialogs/conflict/mergeincomplete,link=,top)]]) in the tab **''Properties''**. Click on the tab to display the window for resolving property conflicts.
    30 
    31 In the example below "`Coordinates`" and "`Deleted State`" values in the two object versions are different, though, and JOSM therefore displays the row with a red background. In the first version the object is "`not deleted`", the opposite version is "`deleted`". You now have to decide which of these values you want to keep and which you want to discard.
    32 
    33 [[Image(propertie-resolve-1_v19207.png)]]
     34If the properties (`Coordinates` or `Deleted State`) of one version of an object are different from the properties of another version, the Conflict dialog shows a red square ([[JOSMImage(dialogs/conflict/mergeincomplete,link=,top)]]) in the tab **''Properties''**. Click on the tab to display a dialog for resolving properties conflicts.
     35
     36The first three rows display basic information of the object, for ''My version'' and for ''Their version'', similar to the [[JOSMImage(dialogs/history)]] [wikitr:/Help/Action/ObjectHistory History Dialog], see [wikitr:/Help/Action/ObjectHistory#Basicinformationaboutaversion Basic information about version].
     37
     38 Coordinates:: The coordinates of the node. Only relevant for nodes and if the node was moved or deleted.
     39 Deleted State:: The state of the object, e.g. if it is still present or if it was deleted.
     40 Referenced by:: List of parents, e.g. ways with the node in their node list or relations which the object is a member of. ''This row just displays information''.
     41
     42As, in the example below, the values for "`Coordinates`" and "`Deleted State`" of the two object versions are different and the rows have a red background. On the left side the object has coordinates and is present (e.g. **`not deleted`**) while on the right side the object is **`deleted`** and therefore has no coordinates. You now have to decide which of these values you want to keep and which you want to discard.
     43
     44[[Image(propertie-resolve-1_v19207.png,60%,center)]]
    3445
    3546Select the values you want to keep, in the example for instance the value on the left. If you click on one of the buttons between the tables, [[JOSMImage(dialogs/conflict/tagkeepmine)]] or [[JOSMImage(dialogs/conflict/tagkeeptheir)]], you decide to keep the values and to discard the opposite values.
    3647
    37 [[Image(propertie-resolve-2_v19207.png)]]
    38 
    39 The table in the middle now displays the values to keep and the background color turns to green. Selected values in the middle table can be cleared again with the button below the table ([[JOSMImage(dialogs/conflict/tagundecide)]]).\\
    40 Once all tag conflicts are solved the green check mark ([[JOSMImage(misc/green_check,link=,top)]]) is displayed in front of the name of the tab and if there are no further conflicts in other tabs the button [[JOSMImage(dialogs/conflict)]] **Apply Resolution** is enabled you can apply your decision. The values you've chosen will be applied and the dialog will be closed.
    41 
    42 [[Image(propertie-resolve-3_v19207.png)]]
     48[[Image(propertie-resolve-2_v19207.png,60%,center)]]
     49
     50The table in the middle now displays the values to keep and the background color turns green. Selected values in the middle table can be cleared again with the button below the table ([[JOSMImage(dialogs/conflict/tagundecide)]]).\\
     51Once all property conflicts are solved the green check mark ([[JOSMImage(misc/green_check,link=,top)]]) is displayed in front of the name of the tab and if there are no further conflicts in other tabs the button [[JOSMImage(dialogs/conflict)]] **Apply Resolution** is enabled you can apply your decision. The values you've chosen will be applied and the dialog will be closed.
     52
     53[[Image(propertie-resolve-3_v19207.png,60%,center)]]
     54
    4355
    4456== Resolving differences between tags ==#Resolvingdifferencesbetweentags
     
    5365**Note**: To quickly solve single tag conflicts, the tags in the first tag of both outside tables are by default selected and therefore their background is blue and only the middle table has a red background.
    5466
    55 [[Image(tag-resolve-1-commented.png)]]
    56 
    57 Select the values you want to keep, in the example for instance the value on the left. If you either double-click on the value or click on one of the buttons between the tables, [[JOSMImage(dialogs/conflict/tagkeepmine)]] or [[JOSMImage(dialogs/conflict/tagkeeptheir)]], you decide to keep the values and to discard the opposite values. The table in the middle now displays the values to keep and the background color turns to green. Selected values in the middle table can be cleared again with the button below the table ([[JOSMImage(dialogs/conflict/tagundecide)]]).
    58 
    59 [[Image(tag-resolve-2-commented.png)]]
    60 
    61 Once all tag conflicts are solved the green check mark ([[JOSMImage(misc/green_check,link=,top)]]) is displayed in front of the name of the tab and if there are no further conflicts in other tabs the button [[JOSMImage(dialogs/conflict)]] **Apply Resolution** is enabled you can apply your decision. The values you've chosen will be applied and the dialog will be closed.
    62 
    63 [[Image(tag-resolve-3-commented.png)]]
    64 
    65 == Resolving differences in the node/member list of two versions of a way/relation ==#ResolvingConflictsNodeMemberList
    66 If you see a red square ([[JOSMImage(dialogs/conflict/mergeincomplete,top,link=)]]) in the tab **''Nodes''** respectively **''Members''** then you have to resolve differences in the list of [[JOSMImage(data/node,top,link=)]] [wikitr:/Help/Concepts/Object#Nodes nodes] of two [[JOSMImage(data/way)]] [wikitr:/Help/Concepts/Object#Ways ways] respectively the list of members of two [[JOSMImage(data/relation)]] [wikitr:/Help/Concepts/Object#Relations relations]. There are three columns of tables in the respective panel (see screen shot below):
    67 * the leftmost table displays the list of nodes/members of the the local object version
    68 * the rightmost table displays the list of nodes/members of the the server object version
    69 * the table in the middle shows the list of nodes/members of the merged way/relation
     67=== Single tag conflicts ===
     68[[Image(one-tag-resolve-1_v19207.png,60%,center)]]
     69
     70Select the value you want to keep: \\
     71In the example for instance the value on the left. If you either double-click on the value or click on one of the buttons between the tables, [[JOSMImage(dialogs/conflict/tagkeepmine)]] or [[JOSMImage(dialogs/conflict/tagkeeptheir)]], you decide to keep the value and to discard the opposite value. The table in the middle now displays the value to keep and the background color turns to green. Selected value in the middle table can be cleared again with the button below the table ([[JOSMImage(dialogs/conflict/tagundecide)]]).
     72
     73[[Image(one-tag-resolve-2_v19207.png,60%,center​)]]
     74
     75Once all tag conflicts are solved the green check mark ([[JOSMImage(misc/green_check,link=,top)]]) is displayed in front of the name of the tab and if there are no further conflicts in other tabs, the button [[JOSMImage(dialogs/conflict)]] **Apply Resolution** is enabled and you can apply your decision. The values you've chosen will be applied and the dialog will be closed.
     76
     77[[Image(one-tag-resolve-3-commented_v19207.png,60%,center)]]
     78
     79=== Multiple tags conflicts ===
     80[[Image(tags-resolve-1_v19207.png,60%,center)]]
     81
     82Select the values you want to keep: \\
     83In the example: If you double-click on a value, or you select more values by holding `Ctrl` or `Shift` and then click on the buttons between the tables, [[JOSMImage(dialogs/conflict/tagkeepmine)]] or [[JOSMImage(dialogs/conflict/tagkeeptheir)]], you decide to keep the values and discard the opposite values. The table in the middle now displays the values to keep and the background color turns to green. Selected values in the middle table can be cleared again with the button below the table ([[JOSMImage(dialogs/conflict/tagundecide)]]).
     84
     85[[Image(tags-resolve-2-commented_v19207.png,60%,center)]]
     86
     87Once all tag conflicts are solved the green check mark ([[JOSMImage(misc/green_check,link=,top)]]) is displayed in front of the name of the tab and if there are no further conflicts in other tabs, the button [[JOSMImage(dialogs/conflict)]] **Apply Resolution** is enabled and you can apply your decision. The values you've chosen will be applied and the dialog will be closed.
     88
     89[[Image(tags-resolve-3-commented_v19207.png,60%,center)]]
     90
     91
     92== Resolving differences in the node/member list of two versions of a way/relation ==
     93Resolution methods are similar for both nodes and members.
     94
     95If you see a red square ([[JOSMImage(dialogs/conflict/mergeincomplete,top,link=)]]) in the tab ''**Nodes** respectively **Members**'' then you have to resolve differences in the list of [[JOSMImage(data/node,top,link=)]] [wikitr:/Help/Concepts/Object#Nodes nodes] of two [[JOSMImage(data/way)]] [wikitr:/Help/Concepts/Object#Ways ways] respectively the list of members of two [[JOSMImage(data/relation)]] [wikitr:/Help/Concepts/Object#relations relations]. There are three columns of tables in the respective panel (see screen shot below):
     96* the leftmost table displays the list of nodes/members of the local object version
     97* the rightmost table displays the list of nodes/members of the server object version
     98* the table in the middle shows the list of nodes/member of the merged way
    7099
    71100Initially, the middle table is empty. You should now decide which nodes/members to keep from the local dataset (the leftmost table) and which from the server dataset (the rightmost table) and in which order.
    72101
    73 [[Image(node-resolve-main-commented.png)]]
     102* **Screen with nodes**
     103[[Image(node-resolve-main-commented_v19207.png,85%,center)]]
     104
     105* **Screen with members**
     106[[Image(member-resolve-main-commented_v19207.png,85%,center)]]
    74107
    75108=== The standard workflow ===
    76 The standard workflow to resolve conflicts in the node lists of two object versions consists of three steps:
    77 
    78 1. Pick nodes from either object version and reorder the resulting node list if necessary
    79 1. Freeze the resulting merged node list by clicking on the **Freeze** button ([[Image(button-freeze.png,link=,middle)]]). When you freeze the merged node list you tell JOSM that all conflicts in the node list are resolved.
     109The standard workflow to resolve conflicts in the node/member lists of two object versions consists of three steps:
     110
     1111. Pick nodes/members from either object version and reorder the resulting node/member list if necessary
     1121. Freeze the resulting merged node/member list by clicking on the **Freeze** button ([[Image(button-freeze.png,link=,middle)]]). When you freeze the merged node/member list you tell JOSM that all conflicts in the node/member list are resolved.
    801131. [[JOSMImage(dialogs/conflict)]] **Apply Resolution**
    81114
    82 === A simple workflow: Keep the node list from your local object version ===
    83 The following example shows the workflow when you decide to keep all nodes in the same order from your local object version. \\
    84 ''(Example is out of date (new buttons), but still works.)''
     115Depending on the position of a member/node in the list different background colors are used:
     116* [[Image(compare-in-one-list-only.png,link=,middle)]] - red - the member/node is in this list **only**. It isn't present in the opposite list.
     117* [[Image(compare-different-positions.png,link=,middle)]] - yellow - the member/node is in both lists, but it is on different positions
     118* [[Image(compare-in-both-lists.png,link=,middle)]] - green - a member/node is in both lists at the same position
     119* [[Image(selected.png,link=,middle)]] - blue - a member/node is selected
     120* [[Image(not-selected.png,link=,middle)]] - white - in the list (Merged version) a member/node is not selected
     121
     122=== A simple workflow: Keep the node/member list from your local object version ===
     123The following example shows the workflow when you decide to keep all nodes/members in the same order from your local object version. \\
     124**Note**: screenshots are for nodes, but the method is the same for members.
    85125
    86126First, select all elements in the leftmost table (either using the mouse or by pressing `Ctrl+A` in the table) (see next screen shot):
    87127
    88 [[Image(simple1-step-1.png)]]
    89 
    90 Then, click on the top button right of the table ([[JOSMImage(dialogs/conflict/copystartleft)]]) to copy the selected nodes to the middle table with the merged nodes:
    91 
    92 [[Image(simple1-step-2.png)]]
    93 
    94 Finally, click **Freeze** ([[Image(button-freeze.png,link=,middle)]]) to freeze the resulting merged node list:
    95 
    96 [[Image(simple1-step-3.png)]]
    97 
    98 The symbol in the nodes tab now switched to a green check mark ([[JOSMImage(misc/green_check,middle,link=)]]) and you can apply the merge decisions.
     128[[Image(nodes-simple1-step-1_v19207.png,85%,center)]]
     129
     130Then, click on the top button right of the table ([[JOSMImage(dialogs/conflict/copystartleft)]]) to copy the selected nodes/members to the middle table with the merged nodes/members; You can reach the same result without selecting the nodes/members by clicking on the button on the back button right of the table ([[JOSMImage(dialogs/conflict/useallleft)]]).
     131
     132[[Image(nodes-simple1-step-2_v19207.png,85%,center)]]
     133
     134Finally, click **Freeze** ([[Image(button-freeze.png,link=,middle)]]) to freeze the resulting merged node/member list:
     135
     136[[Image(nodes-simple1-step-3_v19207.png,85%,center)]]
     137
     138The symbol in the nodes/members tab now switched to a green check mark ([[JOSMImage(misc/green_check,middle,link=)]]) and you can apply the merge decisions.
     139
     140=== A less simple workflow: Mix and Reorganise the list of nodes/members of the local version of the object and their version ===
     141**Note**: screenshots are for members, but the method is the same for nodes.
     142
     143==== Member/Node selection ====
     144Selecting members/nodes in the list ("My version" and "Their version") works as usual: `Shift+`click to select a range of members/nodes, hold `Ctrl+`click to select and unselect multiple members/nodes.
     145
     146[[Image(members-complex1-step-1_v19207.png,85%,center)]]
     147
     148When members/nodes are selected use the buttons to the right of the ‘My version’ list and to the left of the ‘Their version’ list to put them in the ‘Merged version’ list. The buttons on the two lists are symmetrical
     149
     150The buttons offer following actions:
     151
     152||= **Icon** =||= **Description** =||
     153||  [[JOSMImage(dialogs/conflict/copystartleft)]]  || Copy "my" selected elements to the start of the merged member/node list ||
     154||  [[JOSMImage(dialogs/conflict/copybeforecurrentleft)]]  || Copy "my" selected elements before the first selected elements in the merged member/node list ||
     155||  [[JOSMImage(dialogs/conflict/copyaftercurrentleft)]]  || Copy "my" selected elements after the first selected elements in the merged member/node list ||
     156||  [[JOSMImage(dialogs/conflict/copyendleft)]]  || Copy "my" selected elements to the end of the list of merged elements ||
     157||||
     158||  [[JOSMImage(dialogs/conflict/useallleft)]]  || Copy all "my" selected elements to the target ||
     159
     160Depending on the position of a member/node in the list "Merged version" different background colors are used:
     161* blue - a member/node is selected
     162* white - a member/node is not selected
     163
     164[[Image(members-complex1-step-2_v19207.png,90%,center)]]
     165
     166[[Image(members-complex1-step-3_v19207.png,90%,center)]]
     167
     168==== Reorder the resulting node/member list if necessary, in "Merged version" ====
     169When the members/nodes are in the "Merged version" you can move them using the buttons at the bottom of the list
     170
     171[[Image(members-complex1-step-4_v19207.png,90%,center)]]
     172
     173The buttons offer following actions:
     174
     175||= **Icon** =||= **Description** =||
     176||  [[JOSMImage(dialogs/conflict/moveup)]]  || Move up the selected entries by one position ||
     177||  [[JOSMImage(dialogs/conflict/movedown)]]  || Move down the selected entries by one position ||
     178||  [[JOSMImage(dialogs/conflict/remove)]]  || Remove the selected entries from the list of merged elements ||
     179
     180Finally, click **Freeze** ([[Image(button-freeze.png,link=,middle)]]) to freeze the resulting merged node/member list:
     181
     182[[Image(members-complex1-step-5_v19207.png,90%,center)]]
     183
     184The symbol in the nodes/members tab now switched to a green check mark ([[JOSMImage(misc/green_check,middle,link=)]]) and you can apply the merge decisions.
    99185
    100186=== Support for comparing node/member lists ===
    101 It can be difficult to find the differences between the node/member list of of two object versions, in particular for ways/relations with many nodes/members.
     187It can be difficult to find the differences between the node/member list of two object versions, in particular for ways with many nodes respectively relations with many members.
    102188
    103189The Conflict Dialog supports you in finding the differences. It can compare two of the lists displayed ("''my''" list, the "''merged''" list, and "''their''" list) and it can render the differences between them with specific background colors.
     
    110196* **My with Merged**: compares the leftmost table with the middle table in the Conflict Dialog
    111197* **Their with Merge**: compares the middle table with the rightmost table in the Conflict Dialog
    112 
    113 Depending on the position of a node/member in the list different background colors are used:
    114 * [[Image(compare-in-one-list-only.png,link=,middle)]] - red - the node/member is in this list **only**. It isn't present in the opposite list.
    115 * [[Image(compare-different-positions.png,link=,middle)]] - rose - the node/member is in both lists, but it is on different positions
    116 * white background means that a node/member is in both lists at the same position
    117198
    118199