Context Navigation

Editing Help/Concepts/Changeset

Adjust edit area height: Edit side-by-side

[[TranslatedPages]]
= Changeset =

[[TOC(inline)]]

[wiki:/Help/Concepts/Object Nodes, ways, and relations] created or modified in JOSM are only available locally unless they are ''published'' on a server to make them useful for other mappers. The process of publishing data is called '''uploading'''.

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 for every singe node and every single way why it is published. A more convenient approach is to package a group of related objects and assign the package a comment,  not the individual objects. This way, if a mapper maps his or her neighborhood, he or she can upload a package of nodes and ways and assign it a comment "`mapped and reviewed some ways in foo city`".

In JOSM such a package is called a '''changeset'''. A '''changeset''' is a collection of related changes (new objects, object modifications, or object deletings) applied to OSM data.

== Changesets and upload operations  ==
A changeset is independent from an individual upload operation.

You can run multiple [[Image(source:/trunk/images/upload.png)]] [wiki:Help/Action/Upload uploads] with the same changeset. The changeset will then package the changes published in all uploads. A mapper can even stop JOSM, start it a day later and continue to publish to the changeset he or she has been using a day before, provided he or she didn't close the changeset.

== Properties of changesets == #Properties

A changeset is initially opened and it stays '''open''' until it is closed. A JOSM user can explicitly close one or more of his open changesets. If he doesn't close them, the JOSM server will close open changeset automatically after a timeout. A changeset which isn't open is called '''closed'''. It stays closed forever and can't be reopened.

A changeset you open is ''owned'' by you. No other mapper can publish data in this changset and you can't upload your data in other users changesets.

== Upload comment and other changeset tags ==
Similar to nodes, ways, and relations, it is possible to decorate changesets with [wiki:/Help/Concepts/Object tags]. The most important and only compulsory tag is the so called '''upload comment'''. When you publish data in JOSM you are required to enter an upload comment with at least three characters. It's this comment which describes the published data for other mappers.

== Opening a changeset ==
tbd

== Closing a changeset ==
tbd

== Listing the changes packaged in a changeset ==
tbd

== See also ==
 * [[Image(source:/trunk/images/closechangeset.png)]] [wiki:Help/Action/CloseChangeset Close Changeset]

----
Back to [wiki:Help Main Help]

Note: See WikiFormatting and TracWiki for help on editing wiki content.

Change information

Your email or username:

E-mail address and name can be saved in the Preferences

Comment about this change (optional):

Note: See TracWiki for help on using the wiki.