Changes between Version 60 and Version 73 of Help/Action/Upload


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Action/Upload

    v60 v73  
    1 [[TranslatedPages]]
     1[[TranslatedPages(outdated=This page covers too much context. The concept of changeset and upload might be better placed on an own page. Screenshots are outdated and obtain sources is not explained.)]]
    22[[PageOutline(1-10,Table of Contents)]]
    33
    4 = File > Upload to OSM =
    5 
    6 [[Image(source:trunk/images/upload.png,middle)]] ''Keyboard shortcut:'' **{{{Ctrl+Shift+↑}}}**
     4= File > Upload data =
     5
     6[[JOSMImage(upload,48,link=,middle,margin-right=20)]] ''Keyboard shortcut:'' **{{{Ctrl+Shift+↑}}}**
    77
    88**Upload new, modified, and deleted objects in the current data layer to the server.**
     
    1313
    1414* (like online editors like iD or Potlatch) you need to upload your changes to OSM server. Make sure you connected to server :-)
    15 * you may encounter [wiki:Help/Concepts/Conflict conflicts] after you upload changes (in most cases this means you will have to [wiki:Dialog/Conflict#Resolvingdifferencesbetweentags choose what tags to leave on your objects])
     15* you may encounter [wikitr:/Help/Concepts/Conflict conflicts] after you upload changes (in most cases this means you will have to [wikitr:/Help/Dialog/Conflict#Resolvingdifferencesbetweentags choose what tags to leave on your objects])
    1616* to reduce chance of conflict:
    1717 * don't edit data other mappers edit in same time window
    1818 * make your downloads-uploads quicker, so there no overlap between your time-window and theirs
    1919* (rough idea) to entirely avoid conflict, don't edit objects with same id and don't alter their parent relations (node-way and way-relation and relation-relation). If you (and other editor) are editing disjoint datasets (https://en.wikipedia.org/wiki/Disjoint_sets), then there won't be conflict at all. Please note that it also means that all parent ways and all parent relations should be respected (which is likely to change).
    20 * (unlike online editors like iD or Potlatch) you don't have to upload immediately (you may [[Help/Action/Save]] file manually but [[Help/Action/AutoSave]] will further assist you)
    21 * (unlike every other editor?) JOSM will let you upload changes to already opened (but not a closed) changeset (see [[#Multipleuploadsintoonechangeset]]). Every open changeset will "close" automatically by http://openstreetmap.org server after 1 hour.
     20* (unlike online editors like iD or Potlatch) you don't have to upload immediately (you may [wikitr:/Help/Action/Save save] file manually but [wikitr:/Help/Action/AutoSave auto save] will further assist you)
     21* (unlike every other editor?) JOSM will let you upload changes to already opened (but not a closed) changeset (see [#Multipleuploadsintoonechangeset Multiple uploads into one changeset]). Every open changeset will "close" automatically by [osmwww: OSM server] after 1 hour.
    2222
    2323== Changesets, upload requests, and upload strategies ==
    24 Geo data contributed to the OSM server consists of [Concepts/Object nodes, ways, and relations]. Because there are hundreds of mappers publishing their geo data on the OSM server it is important to track who published what data in which context. It would be tedious for mappers to describe why every single node and every single way is published. A more convenient approach is to package a group of related objects and assign the package itself a comment, instead of the individual objects.
    25 
    26 The OSM project calls such a package a **[Concepts/Changeset changeset]**. A **changeset** is a collection of related changes (new objects, object modifications, or object deletions) applied to OSM data.
    27 
    28 Changesets are different from **upload requests**. A changeset is a **logical** grouping of [Concepts/Object objects], whereas an upload request is a **technical grouping** for transferring geo data to the central OSM server only. In JOSM we say, that objects are uploaded **using** upload requests **to** a changeset. The JOSM Upload Dialog allows aspects of the upload requests and changeset objects to be configured. Some of the settings are compulsory (i.e. the user has to configure them before geo data can be uploaded) but most of them are optional and JOSM works with reasonable default values.
     24Geo data contributed to the OSM server consists of [wikitr:/Help/Concepts/Object nodes, ways, and relations]. Because there are hundreds of mappers publishing their geo data on the OSM server it is important to track who published what data in which context. It would be tedious for mappers to describe why every single node and every single way is published. A more convenient approach is to package a group of related objects and assign the package itself a comment, instead of the individual objects.
     25
     26The OSM project calls such a package a **[wikitr:/Help/Concepts/Changeset changeset]**. A **changeset** is a collection of related changes (new objects, object modifications, or object deletions) applied to OSM data.
     27
     28Changesets are different from **upload requests**. A changeset is a **logical** grouping of [wikitr:/Help/Concepts/Object objects], whereas an upload request is a **technical grouping** for transferring geo data to the central OSM server only. In JOSM we say, that objects are uploaded **using** upload requests **to** a changeset. The JOSM Upload Dialog allows aspects of the upload requests and changeset objects to be configured. Some of the settings are compulsory (i.e. the user has to configure them before geo data can be uploaded) but most of them are optional and JOSM works with reasonable default values.
    2929
    3030Geo data can be retrieved later via the changeset it was uploaded to, though it can't be retrieved by the upload request used. Changesets have a unique identifier, upload requests have not. For instance, [osmwww:browse/changeset/3274448 this changeset] includes geo data from tracing over orthofotos of the city of Bern, Switzerland. It isn't possible, though, to see the upload requests that were used to fill it.
     
    3333In the most simple case there is only one upload request into a changeset:
    3434
    35 [[Image(one-changeset-one-upload-request.png)]]
     35[[Image(one-changeset-one-upload-request.png,link=)]]
    3636
    3737This is the standard configuration used by JOSM. It is the preferred configuration
     
    4040* for users uploading the result of entering local knowledge about street names, points of interests, etc.
    4141
    42 === Multiple uploads into one changeset ===
    43 
    44 [[Image(one-changeset-multiple-upload-request.png)]]
     42=== Multiple uploads into one changeset ===#Multipleuploadsintoonechangeset
     43
     44[[Image(one-changeset-multiple-upload-request.png,link=)]]
    4545
    4646This is an advanced configuration option which most users don't have to enable. It can be useful:
     
    5050JOSM still supports to upload each object individually.
    5151
    52 [[Image(one-changeset-individual-object-upload-request.png)]]
     52[[Image(one-changeset-individual-object-upload-request.png,link=)]]
    5353
    5454Please note that this is a legacy feature. Until recently, this was the only upload option in OSM.  Technically, it uses a slightly different approach to communicate with the OSM server. It is still available in JOSM although the OSM server now supports upload requests with up to 10,000 objects. For the casual and normal user it is almost obsolete. In rare cases, it could be useful for power users.
     
    5757JOSM also supports uploading large datasets that don't fit into a single changeset.
    5858
    59 [[Image(multiple-changesets.png)]]
     59[[Image(multiple-changesets.png,link=)]]
    6060
    6161This is an advanced option which is only useful for power users. They can select this configuration if they have to upload a dataset with more than 10,000 new, modified, or deleted objects.
     
    6868* **Time required to upload**: the smaller the upload requests you choose the longer it takes to upload. It takes more time to upload 100 objects using 100 individual upload requests than to upload them in one request containing 100 objects.
    6969
    70 * **Collisions with other mappers**: if you upload 10,000 objects in one request and if the server encounters a problem on the 9,999th object the whole upload is rolled back. The problem has to be fixed first (i.e. by resolving a [wiki:/Help/Concepts/Conflict conflict]). The whole 10,000 objects will then have to be uploaded again. On the other hand, if you upload 10,000 objects with 10 requests containing 1,000 objects each and the server encounters a problem on the 9,999th object then you only have to repeat the last upload request for the 9,001th to 10,000th objects. Objects 1-9,000 are already successfully uploaded. If you're mapping in areas where other mappers are active too you should therefore prefer smaller sizes for upload requests.
    71 
    72 == Uploading data  ==
     70* **Collisions with other mappers**: if you upload 10,000 objects in one request and if the server encounters a problem on the 9,999th object the whole upload is rolled back. The problem has to be fixed first (i.e. by resolving a [wikitr:/Help/Concepts/Conflict conflict]). The whole 10,000 objects will then have to be uploaded again. On the other hand, if you upload 10,000 objects with 10 requests containing 1,000 objects each and the server encounters a problem on the 9,999th object then you only have to repeat the last upload request for the 9,001th to 10,000th objects. Objects 1-9,000 are already successfully uploaded. If you're mapping in areas where other mappers are active too you should therefore prefer smaller sizes for upload requests.
     71
     72== Uploading data  ==#UploadData
    7373
    7474=== Launching the Upload Dialog ===#LaunchUploadDialog
    7575
    7676* ''Keyboard shortcut:'' **{{{Ctrl+Shift+↑}}}**
    77 * Menu item ''File->[[Image(source:trunk/images/upload.png,middle)]] Upload''
    78 * Toolbar button [[Image(source:trunk/images/upload.png,middle)]]
     77* Menu item ''File->[[JOSMImage(upload)]] Upload''
     78* Toolbar button [[JOSMImage(upload)]]
    7979
    8080=== Checks before the Upload Dialog is displayed ===
    81 Before the Upload Dialog is displayed, [Dialog/Validator validator] is run on all modified [Concepts/Objects objects]. If it finds warnings or errors you'll be presented with a list of them and get the chance to correct the problems and try again or upload anyway. It's not necessary to fix all of that, but please don't go over it easily, especially not the errors.
     81Before the Upload Dialog is displayed, [wikitr:/Help/Dialog/Validator validator] is run on all modified [wikitr:/Help/Concepts/Object objects]. If it finds warnings or errors you'll be presented with a list of them and get the chance to correct the problems and try again or upload anyway. It's not necessary to fix all of that, but please don't go over it easily, especially not the errors.
    8282
    8383JOSM also checks for limitations imposed by the OSM server:
     
    8989**Note**: On large datasets these checks can take some time and for the time being they don't provide user feedback. Please be patient if it takes a couple of seconds to launch the Upload Dialog on large datasets. This will be fixed soon.
    9090
    91 === The Upload Dialog ===
    92 
    93 [[Image(upload-dialog-screenshot.png)]]
    94 
    95 The upload dialog consists of two sections:
    96 * the upper half displays a summary of the objects to be added, to be modified, and to be deleted on the server
    97 * the lower part provides panels for configuring various aspects of the upload process
    98 
    99 When the Upload Dialog is launched it always displays the basic configuration panel which includes a text box for entering an upload comment and a summary of the other upload parameters for this upload.
     91=== The Upload Dialog ===#UploadDialog
     92
     93[[Image(upload-dialog-screenshot.png,link=)]]
     94
     95The Upload Dialog consists of two sections:
     96* the upper part displays a summary of the objects to be added, to be modified, and to be deleted on the server
     97* the lower part provides tabs for configuring various aspects of the upload process
     98
     99When the Upload Dialog is launched it always displays the Settings tab which allows you to enter the most important information about your [wikitr:/Help/Concepts/Changeset changeset]:
     100 the changeset comment::
     101  It's important to provide a brief comment describing the changes you are uploading. This makes it easier for other contributors and for yourself to know what your changes are about and why you made the changes.
     102  * if the comment is empty or too short: the text below the comment box warns you
     103[[Image(comment_empty.png,link=)]]
     104  * if the comment is provided: the text below the comment thanks you
     105[[Image(comment_present.png,link=)]]
     106 the changeset source::
     107  Specify the date source for the changes, to allow other contributors to check them if needed.
     108  * if the data source is not specified: the text below the comment box warns you
     109[[Image(source_not_specified.png,link=)]]
     110  * if the data source is provided: the text below the comment thanks you
     111[[Image(source_provided.png,link=)]]
     112
     113Below there is a summary of the other upload parameters for this upload. And a checkbox which sets the `review_requested=yes` changeset tag.
    100114
    101115=== Running a simple upload ===
    102116
    103 Covered in [wiki:Introduction#UploadingtoOSM "Uploading to OSM"].
    104 
    105 === Running an upload with advanced options ===
     117See [wikitr:/Introduction#UploadingtoOSM "Uploading to OSM"].
     118
     119=== Running an upload with advanced options ===#AdvancedOptions
    106120
    107121==== Adding tags to the changeset ====
    108 Geo data uploaded to the OSM server is always uploaded to a [Concepts/Changeset changeset]. Similar to [Concepts/Object nodes, ways, and relations] one can assign [Concepts/Object tags] to a changeset.
     122Geo data uploaded to the OSM server is always uploaded to a [wikitr:/Help/Concepts/Changeset changeset]. Similar to [wikitr:/Help/Concepts/Object nodes, ways, and relations] one can assign [wikitr:/Help/Concepts/Object tags] to a changeset.
    109123
    110124In the Upload Dialog one can enter tags in the Tag Configuration Panel, see screenshot below:
    111125
    112 [[Image(tags-config-panel-screenshot.png)]]
    113 
    114 Hashtags within the changeset comment tag are recognized and are additionally added to the hashtags changeset tag. This behavior can be disabled by setting the key `upload.changeset.hashtags` in the [wiki:Help/Preferences/Advanced Advanced preferences] to `false`.
     126[[Image(tags-config-panel-screenshot.png,link=)]]
     127
     128Hashtags within the changeset comment tag are recognized and are additionally added to the hashtags changeset tag. This behavior can be disabled by setting the key `upload.changeset.hashtags` in the [wikitr:/Help/Preferences/Advanced Advanced preferences] to `false`.
    115129
    116130**Do's and Don'ts**
     
    122136
    123137==== Choosing the changeset to upload to ====
    124 In the Changeset Configuration Panel you can select what [wiki:/Help/Concepts/Changeset changeset] the data is uploaded to, see the screenshot below:
    125 
    126 [[Image(changeset-config-panel.png)]]
     138In the Changeset Configuration Panel you can select what [wikitr:/Help/Concepts/Changeset changeset] the data is uploaded to, see the screenshot below:
     139
     140[[Image(changeset-config-panel.png,link=)]]
    127141
    128142JOSM uploads to a new changeset if **Upload to a new changeset** is selected. This is the standard setting.
    129143
    130 If you want to upload to an existing changeset you have to select one of the available changesets from the drop down list. This list is only enabled if there are open changesets which you can upload data to because you own them. Click on [[Image(source:trunk/images/dialogs/refresh.png,middle)]] ''Refresh'' to load the list of available open changesets from the server. If there is at least one open changeset available you can select the radio button **Upload to an existing changeset** and select a changeset.
    131 
    132 Click on [[Image(source:trunk/images/closechangeset.png,bottom)]] **Close Changeset** to close the currently selected open changeset. This is for convenience only. You don't have to close a changeset here in order to run a successful upload.
     144If you want to upload to an existing changeset you have to select one of the available changesets from the drop down list. This list is only enabled if there are open changesets which you can upload data to because you own them. Click on [[JOSMImage(dialogs/refresh)]] ''Refresh'' to load the list of available open changesets from the server. If there is at least one open changeset available you can select the radio button **Upload to an existing changeset** and select a changeset.
     145
     146Click on [[JOSMImage(closechangeset,24,link=,bottom)]] **Close Changeset** to close the currently selected open changeset. This is for convenience only. You don't have to close a changeset here in order to run a successful upload.
    133147
    134148After a successful upload JOSM can either close the changeset used or leave it open for another upload. The default setting is to close it. You can configure whether JOSM should leave it open by unselecting the checkbox **Close changeset after upload**.
     
    136150
    137151==== Configuring the number and size of upload requests ====
    138 JOSM uploads geo data with one or more **upload requests** to a [Concepts/Changeset changeset] on the OSM server. In the Advanced Configuration Panel you can decide about the number and the size of upload requests, see screenshot:
    139 
    140 [[Image(advanced-config-panel.png)]]
     152JOSM uploads geo data with one or more **upload requests** to a [wikitr:/Help/Concepts/Changeset changeset] on the OSM server. In the Advanced Configuration Panel you can decide about the number and the size of upload requests, see screenshot:
     153
     154[[Image(advanced-config-panel.png,link=)]]
    141155
    142156Select **Upload data in one request** to upload all object in one request. If you're uploading a medium to large number of objects this might take some time and JOSM will not be able to inform you about the progress. There are only two outcomes of such an upload: the upload either succeeded or it didn't. In the former case everything is fine, in the later no objects at all have been uploaded. This kind of upload will never lead to a partial upload which is both its strength and its weakness. It can be its weakness if the entire upload fails because there is a problem in the very last object in the upload request.
     
    154168An upload is considered to be very large if its size exceeds the maximum size of a changeset on the OSM server. Currently, the upper limit for the size of a changeset is 10,000 objects and if JOSM detects that your upload is bigger it displays the following information in the Upload Dialog:
    155169
    156 [[Image(large-upload-basic-settings.png)]]
     170[[Image(large-upload-basic-settings.png,link=)]]
    157171
    158172The warning message indicates that JOSM can't upload the data unless you configure some advanced settings. Either switch to the tab **Advanced** or click on the link in the message. The following configuration panel will be displayed:
    159173
    160 [[Image(large-upload-advanced-settings.png)]]
     174[[Image(large-upload-advanced-settings.png,link=)]]
    161175
    162176For very large uploads, uploading in one request isn't possible and the respective option is therefore disabled. Please select a chunk size to be used in the upload. It has to be smaller than 10,000, too, because the upper limit for the size of a changeset also applies to the chunk size. You can upload a very large dataset with an individual request per object but you're not recommended to do so.
    163177
    164 A very large upload doesn't fit within a single changeset. Please select 
     178A very large upload doesn't fit within a single changeset. Please select:
    165179
    166180* whether JOSM should automatically open as many new changesets as required to upload the data. Select this option if you want to run a very large upload without user intervention.
     
    175189JOSM displays the following error message:
    176190
    177 [[Image(error-dialog-changeset-closed.png)]]
     191[[Image(error-dialog-changeset-closed.png,link=)]]
    178192
    179193**How to resolve**
     
    187201If JOSM detects that a changeset became full it displays the following warning message:
    188202
    189 [[Image(error-dialog-changeset-full.png)]]
     203[[Image(error-dialog-changeset-full.png,link=)]]
    190204
    191205**How to resolve**
    192206* Click on **Continue Uploading** to continue the upload with as many new changesets as necessary.
    193 * Click on **Go back to Upload Dialog** to go back to the upload dialog. There you can select another changeset to upload the remaining objects to.
     207* Click on **Go back to Upload Dialog** to go back to the Upload Dialog. There you can select another changeset to upload the remaining objects to.
    194208* Click on **Abort** to abort uploading and return to the main map editing interface.
    195209
     
    200214<a name="NodeStillInUseInWay">
    201215}}}
    202 If your upload includes a deleted [Concepts/Object node] the OSM server checks if the node is still used in one of the ways known to the server. You have to make sure that the node is ''isolated'' (not part of any way and not referred to by any relation) before it can be deleted.
     216If your upload includes a deleted [wikitr:/Help/Concepts/Object#Nodes node] the OSM server checks if the node is still used in one of the ways known to the server. You have to make sure that the node is ''isolated'' (not part of any way and not referred to by any relation) before it can be deleted.
    203217
    204218If the OSM server detects that the node is still in use it replies an error message which JOSM displays as follows:
    205219
    206 [[Image(upload-412-node-still-in-use.png)]]
    207 
    208 If you click on **Prepare conflict resolution** JOSM supports you in resolving the issue. First it downloads all ways in which the node is still used and merges them with your current dataset. In most cases, JOSM removes the deleted node from all parent ways automatically. If for some reason this isn't possible, JOSM creates a [Concepts/Conflict conflict] which you have to [Concepts/Conflict resolve] manually.
     220[[Image(upload-412-node-still-in-use.png,link=)]]
     221
     222If you click on **Prepare conflict resolution** JOSM supports you in resolving the issue. First it downloads all ways in which the node is still used and merges them with your current dataset. In most cases, JOSM removes the deleted node from all parent ways automatically. If for some reason this isn't possible, JOSM creates a [wikitr:/Help/Concepts/Conflict conflict] which you have to [wikitr:/Help/Concepts/Conflict resolve] manually.
    209223
    210224After that, just upload again. Your upload now includes all parent ways of the deleted node and the deleted node is removed from all of them. The upload should therefore succeed.
    211225
     226=== bounding box very large ===
     227If the bounding box of the changeset is very large: JOSM displays an a warning: you can continue by clicking on "Upload Changes" or stop by clicking on "Cancel" and split your changes.
     228
     229[[Image(error-dialog-large-bounding-box.png,link=)]]
     230
    212231== See also ==
    213 * [[Image(source:trunk/images/uploadselection.png,20,middle)]] [Action/UploadSelection Upload Selection to OSM]
    214 * [Concepts/Conflict What is a conflict?]
     232* [[JOSMImage(uploadselection)]] [wikitr:/Help/Action/UploadSelection Upload Selection to OSM]
     233* [wikitr:/Help/Concepts/Conflict What is a conflict?]
    215234
    216235----
    217 Back to [Menu/File Menu File][[Br]]
    218 Back to [wiki:/Help Main Help]
     236Back to [wikitr:/Help/Menu/File Menu File] \\
     237Back to [wikitr:/Help Main Help]