Changes between Version 3 and Version 17 of Help/Dialog/Conflict


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Dialog/Conflict

    v3 v17  
    1 [[TranslatedPages]]
    2 Back to [wiki:Help Main Help]
     1[[TranslatedPages(outdated=This page needs a review as the conflict dialog changed a bit and the member tab is not documented.)]]
    32
    4 = Conflicts Dialog =
     3= Conflict Dialog =
     4[[PageOutline(1-10,Table of Contents)]]
     5 
     6'''The Conflict Dialog is used to resolve [wikitr:/Help/Concepts/Conflict conflicts] between two [wikitr:/Help/Concepts/Object#Objectversionsandhistory versions] of an OSM object.''' Depending on the object type the dialog may have different tabs, though, the "Properties" and the "Tags" tab are always present.
    57
    6 Make sure you don't edit outside of the area you have downloaded in order to reduce the problem of conflicts
     8[[Image(conflict-dialog.png)]]
    79
    8 Resolve conflicts by opening the 'conflicts' panel, selecting the one of the listed conflicts and choosing whether to accept 'theirs' or 'mine'.
     10== Resolving differences between tags ==#Resolvingdifferencesbetweentags
     11If the tags of one version of an objects are different from the tags of another version, the Conflict dialog shows a [[JOSMImage(dialogs/conflict/mergeincomplete,middle)]] in the tab '''Tags'''. Click on the tab to display a dialog for resolving tag conflicts.
    912
    10 TODO expand on this explanation.
     13There are three tables displayed in this dialog, from left to right:
     14* '''My version''':  shows the tags of the first object version participating in this conflict. These are usually the tags of the object version in your local data set.
     15* '''Merged version''': shows  the merged tags. This table is initially empty. The more tag conflicts you resolve, the more tag values will we be displayed in this table.
     16* '''Their version''': shows the tags of the second object version participating in this conflict. These are usually the tags of the object version currently stored on the server.
     17 * In case of a conflict after [[JOSMImage(dialogs/mergedown)]] [wikitr:/Help/Action/MergeLayer Merge layer] or [[JOSMImage(dialogs/mergedown)]] [wikitr:/Help/Action/MergeSelection Merge selection] this is the version of the origin.
     18 * 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.
    1119
    12 Back to [wiki:Help Main Help]
     20In the example below both versions have a tag "`name`". The values in the two object versions are different, though, and JOSM therefore displays the row with a red background. The value of the first version is "`Secondary School`", the opposite version has a value "`Elementary School`". You now have to decide which of these values you want to keep and which you want to discard.
     21
     22[[Image(tag-resolve-1-commented.png)]]
     23
     24Select 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 [[JOSMImage(dialogs/conflict/tagkeepmine,middle)]], 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.
     25
     26
     27[[Image(tag-resolve-2-commented.png)]]
     28
     29When the button '''Apply Resolution''' is enabled you can apply your decision. The values you've chosen will be applied and the dialog will be closed.
     30
     31[[Image(tag-resolve-3-commented.png)]]
     32
     33== Resolving differences in the node/member list of two versions of a way/relation ==
     34If you see the symbol [[JOSMImage(dialogs/conflict/mergeincomplete,middle)]] in the tab '''Nodes''' respectively '''Members''' then you have to resolve differences in the list of [wikitr:/Help/Concepts/Object#Nodes nodes] of two [wikitr:/Help/Concepts/Object#Ways ways] respectively the list of members of two [wikitr:/Help/Concepts/Object#Relations relations]. There are three columns in the respective panel (see screen shot below):
     35* the leftmost table displays the list of nodes/members of the the local object version
     36* the rightmost table displays the list of nodes/members of the the server object version
     37* the table in the middle shows the list of nodes/members of the merged ways
     38
     39Initially, the middle table is empty. You should now decide which nodes to keep from the local dataset (the leftmost table) and which from the server dataset (the rightmost table).
     40
     41[[Image(node-resolve-main-commented.png)]]
     42
     43=== The standard workflow ===
     44The standard workflow to resolve conflicts in the node lists of two object versions consists of three steps:
     45
     461. Pick nodes from either object version and reorder the resulting node list if necessary
     471. '''Freeze''' the resulting merged node list by clicking on the button [[Image(button-freeze.png,middle)]]. When you freeze the merged node list you tell JOSM that all conflicts in the node list are resolved.
     481. '''Apply the resolution'''
     49
     50
     51=== A simple workflow: Keep the node list from your local object version ===
     52The following example shows the workflow when you decide to keep all nodes in the same order from your local object version.[[BR]]
     53''(Example is out of date (new buttons), but still works.)''
     54
     55First, select all elements in the leftmost table (either using the mouse or by pressing Ctrl+A in the table) (see next screen shot):
     56
     57[[Image(simple1-step-1.png)]]
     58
     59Then, click [[JOSMImage(dialogs/conflict/copystartleft,middle)]] to copy the selected nodes to the middle table with the merged nodes:
     60
     61[[Image(simple1-step-2.png)]]
     62
     63Finally, click [[Image(button-freeze.png,middle)]] to freeze the resulting merged node list:
     64
     65[[Image(simple1-step-3.png)]]
     66
     67The symbol in the nodes tab now switched to [[JOSMImage(misc/green_check,middle)]] and you can apply the merge decisions.
     68
     69=== Support for comparing node/member lists ===
     70It 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.
     71
     72The 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.
     73
     74From the following combo box you can select which pair of lists to compare:
     75
     76[[Image(compare-options.png)]]
     77
     78* '''My with Their''': compares the leftmost table with the rightmost table in the Conflict Dialog
     79* '''My with Merged''': compares the leftmost table with the middle table in the Conflict Dialog
     80* '''Their with Merge''': compares the middle table with the rightmost table in the Conflict Dialog
     81
     82Depending on the position of a node/member in the list different background colors are used:
     83* [[Image(compare-in-one-list-only.png,middle)]] - the node/member is in this list '''only'''. It isn't present in the opposite list.
     84* [[Image(compare-different-positions.png,middle)]] - the node/member is in both lists, but it is on different positions
     85* White background means that a node/member is in both lists at the same position.
     86
     87== Hints ==
     88
     89* Make sure you don't edit outside of the area you have downloaded in order to reduce the problem of conflicts
     90* Resolve conflicts by opening the 'conflicts' panel, selecting the one of the listed conflicts and choosing whether to accept 'theirs' or 'mine'.
     91
     92----
     93Back to [wikitr:/Help/Dialog/ConflictList Conflict List Dialog][[BR]]
     94Back to [wikitr:/Help/Concepts/Conflict Conflict][[BR]]
     95Back to [wikitr:/Help Main Help]