Changes between Initial Version and Version 44 of Help/Dialog/ChangesetManager

Timestamp:

(multiple changes)

Author:

(multiple changes)

Comment:

(multiple changes)

Help/Dialog/ChangesetManager

@@ +1 @@
+[[TranslatedPages(outdated=Tabs "Tags" and "Content" and "Discussion" need some more explanation)]]
+
+= Changeset Manager =
+
+[[JOSMImage(dialogs/changeset/changesetmanager,48,middle,link=,margin-right=20)]] ''Keyboard shortcut:'' **`Ctrl+Alt+C`** — one of the [wikitr:/Help/Menu/Windows JOSM Dialogs] **([wikitr:/Help/ExpertMode expert mode] only)**
+
+[[PageOutline(2-10,Table of Contents)]]
+
+== Launching Changeset Manager ==#Launch
+There are several ways to launch the Changeset Manager:
+
+1. Select the menu item ''Windows-> [[JOSMImage(dialogs/changeset/changesetmanager,24,middle,link=)]] Changeset Manager''
+1. Press **`Ctrl+Alt+C`**
+1. Select one or more changesets in the [wikitr:/Help/Dialog/ChangesetList Changeset List Dialog] and click there on [[JOSMImage(dialogs/changeset/changesetmanager,24,middle,link=)]].
+
+== The Changeset Manager window ==
+
+[[Image(changesetmanager-screenshot.png)]]
+
+== Querying changesets ==
+There are several ways to query and download changesets. The most common query and download operations can be invoked directly from the Changeset Manager. Other more advanced features are provided by the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog].
+
+=== Query and download a changeset by its unique ID ===
+If you want to download a specific changeset whose ID you know, you can download it directly in the Changeset Manager.
+
+[[Image(query-single-changeset.png)]]
+
+1. Enter the changeset ID or a changeset URL in the input field in the toolbar section of the Changeset Manager
+1. Press **`ENTER`** or click on [[JOSMImage(dialogs/changeset/downloadchangeset,24,middle)]].
+
+If you download a single changeset JOSM downloads both the changeset properties (for instance its id or the date it was created) and the changeset content (i.e. the list of objects created, updated, or deleted with this changeset).
+
+=== Query and download your open changesets === 
+Changesets can be [wikitr:/Help/Concepts/Changeset#Properties open or closed]. A mapper can always upload additional objects to an open changeset he or she owns. 
+
+If you want to download the list of open changesets you own
+1. Click on [[JOSMImage(dialogs/changeset/downloadchangeset,24,middle)]] **My open changesets** in the toolbar section of the Changeset Manager.
+
+Note that this download only the changeset properties without the changeset content. For downloading the content of changesets see [#UpdateContentMulti below]. 
+
+=== Advanced queries ===
+Advanced queries like
+* querying the changesets owned by another mapper 
+* querying the most recent changesets open or closed on the OSM server
+* querying changesets which modified object in a specific area (called a "bounding box")
+can be run using the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog].
+
+To launch the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog]:
+
+1. Click on [[JOSMImage(dialogs/search,middle)]] **Query** in the toolbar section of the Changeset Manager. 
+
+== Managing the cache of downloaded changesets ==
+JOSM locally maintains a cache of the changesets downloaded from the OSM server. The content of this cache is displayed in the upper half of the Changeset Manager.
+
+To sort the table of the changesets click on the table column header.
+
+=== Removing changesets from the cache ===
+Changesets can be removed from the local cache. Removing a changeset from the cache doesn't affect the OSM server. The changeset isn't deleted on the server. In fact, it is ''not possible'' to delete a changeset on the server.
+
+Removing changesets from the local cache can be useful because the local changeset cache consumes memory, though. You can remove changesets you don't need from the cache in order to free up the memory. 
+
+To remove one or more changesets from the local cache
+1. Select the changesets in the Changeset Manager
+1. Click on [[JOSMImage(dialogs/delete,24,middle,link=)]] or press **`DEL`**. Alternatively you may select  [[JOSMImage(dialogs/delete,24,middle,link=)]] **Remove from cache** from the popup menu.
+
+=== Updating the properties of changesets in the cache ===
+Properties of changesets can change over time. For instance, an open changeset can become closed or the tags of an open changeset can change because it is assigned a new set of tags in another upload.
+
+In order to update the properties of one or more changesets
+1. Select the changesets in the Changeset Manager
+1. Click on [[JOSMImage(dialogs/changeset/updatechangeset,24,middle,link=)]]. Alternatively you may select  [[JOSMImage(dialogs/changeset/updatechangeset,24,middle,link=)]] **Update changeset** from the popup menu.
+
+Note that this will update the changeset properties only. For updating the changeset content, see [#UpdateContentMulti below].
+
+=== Downloading/Updating the content of changesets in the cache === #UpdateContentMulti
+A changeset includes a collection of object which have been created, updateded, or  deleted by the changeset. These objects are called the ''changeset content''.
+The size of a changeset content varies, but in general it can become very large. Changesets can grow up to 50,000 objects. Changeset content is therefore not automatically downloaded from the OSM server. 
+
+In order to download the changeset content of one or more changesets
+1. Select the changesets in the Changeset Manager
+1. Click on [[JOSMImage(dialogs/changeset/downloadchangesetcontent)]]. Alternatively you may select  [[JOSMImage(dialogs/changeset/downloadchangesetcontent)]] **Download changeset content** from the popup menu.
+
+The content of a changeset may change over time too, provided the changeset is still open. The same steps will always retrieve the latest content for a given changeset. If the local cache already includes the content of a changeset, this operation will refresh it.
+
+=== Copying a list of changesets to clipboard === 
+Select several changeset (`Ctrl+Clic` to select several non-consecutive changesets or `Shift+Click` to select consecutive changesets) then the OS-specific keyboard shortcut (e.g. `Ctrl+C` with Windows) to paste them to the clipboard.
+
+
+== Managing a single changeset ==
+=== Browsing properties, tags, and content ===
+The detail view in the lower half of the Changeset Manager consists of four tabs:
+* **Properties** - displays the basic properties of the currently selected changeset, i.e. its ID or whether the changeset is open or closed
+* **Tags** - displays the tags assigned to the currently selected changeset
+* **Content** - displays the changeset content
+* **Discussion** - displays the changeset discussion, if available
+
+Click on either of these tabs to browse the respective information.
+
+=== External Changeset viewers ===
+Click on [[JOSMImage(help/internet)]] on the left in the Properties tab to get a list of external changeset viewers. Clicking on one of them will open the selected changeset at the website of the chosen service. External changeset viewers provide different visual illustrations of the contents of a changeset.
+
+=== Remove a changeset from the local cache ===
+
+1. Click on [[JOSMImage(dialogs/delete,24,middle,link=)]] to remove the currently selected changeset from the cache. 
+
+=== Editing changeset content  ===
+This is not possible in JOSM.
+
+=== Updating/Downloading changeset content  ===
+There are two commands available to either update the basic properties of the changeset or to update/download the changeset content:
+
+In order to update the changeset properties 
+1. Click on [[JOSMImage(dialogs/changeset/updatechangeset,24,middle,link=)]]
+
+In order to update/download the changeset content
+1. Click on [[JOSMImage(dialogs/changeset/updatechangesetcontent,24,middle,link=)]] or  [[JOSMImage(dialogs/changeset/downloadchangesetcontent,24,middle,link=)]] respectively. Depending on whether the changeset content has already been downloaded either of these two actions is available.
+
+=== Download the current version of objects in the changeset content ===
+Objects included in the changeset may be downloaded to the active data layer. If no data layer exists a new one is created.
+
+1. Click on the tab **Content**.
+1. Make sure the changeset content is downloaded. If not, download it first. 
+1. Select some objects in the changeset content.
+1. Click on [[JOSMImage(downloadprimitive)]]. Alternatively, you may select [[JOSMImage(downloadprimitive)]] **Download Objects** from the popup menu.
+
+**Note**: To download all objects of a changeset it is often faster to use the plugin [[Image(source:/osm/applications/editors/josm/plugins/reverter/images/revert-changeset.svg,link=,middle)]] [osmwiki:JOSM/Plugins/Reverter Reverter] and undo the last action.
+
+=== Download and display the history of objects in the changeset content ===
+For an object included in the content of a changeset, you may retrieve and display its history.
+
+1. Click on the tab **Content**.
+1. Make sure the changeset content is downloaded. If not, download it first. 
+1. Select some objects in the changeset content.
+1. Click on [[JOSMImage(dialogs/history)]]. Alternatively, you may select [[JOSMImage(dialogs/history)]] **Show history** from the popup menu.
+
+=== Selecting objects in the changeset content in the Map View ===
+If the [wikitr:/Help/MapView Map View] includes an active data layer you can select all objects in this layer which are also part of the current changeset in the Changeset Manager. 
+
+1. Click on [[JOSMImage(dialogs/select)]] in the detail view of the Changeset Manager
+
+You can also
+
+1. Select the tab **Content** in the detail view
+1. Select one or more objects in the content
+1. Click on [[JOSMImage(dialogs/select)]]. Alternatively, you may select [[JOSMImage(dialogs/select)]] **Select in layer** in the popup menu. 
+
+=== Zooming to objects in the changeset content  ===
+If the [wikitr:/Help/MapView Map View] includes an active data layer you can "zoom to the changeset". Actually, neither the changeset nor the entire changeset content is ever included in a data layer. With "zoom to the changeset" we mean that JOSM zooms to the largest subset of objects in the data layer which is also a subset in the changeset content. 
+
+In order to zoom to "zoom to the changeset" 
+1. Click on [[JOSMImage(dialogs/autoscale/selection)]] in the detail view of the Changeset Manager.
+
+Alternatively, you may zoom to a subset of the changeset content". In order to do so
+
+1. Click on the tab **Content**.
+1. Make sure the changeset content is downloaded. If not, download it first. 
+1. Select some objects in the changeset content.
+1. Click on [[JOSMImage(dialogs/autoscale/selection)]]. Alternatively, you may select [[JOSMImage(dialogs/autoscale/selection)]] **Zoom to layer** from the popup menu.
+
+== See also ==
+* [wikitr:/Help/Concepts/Changeset Concept of changesets]
+* [[JOSMImage(closechangeset,bottom,link=,24)]] [wikitr:/Help/Action/CloseChangeset Close changesets]
+* [[JOSMImage(dialogs/changesetdialog,24,middle,link=)]] [wikitr:/Help/Dialog/ChangesetList Changeset List panel]
+* [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog]
+
+----
+Back to [wikitr:/Help/Menu/Windows Menu Windows] \\
+Back to [wikitr:/Help Main Help]