Changes between Version 19 and Version 44 of Help/Dialog/ChangesetManager
- Timestamp:
- (multiple changes)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Dialog/ChangesetManager
v19 v44 1 [[TranslatedPages(outdated=changeset discussion feature is missing. see ticket #10701)]] 1 [[TranslatedPages(outdated=Tabs "Tags" and "Content" and "Discussion" need some more explanation)]] 2 2 3 = Changeset Manager = 3 4 4 [[Image(source:trunk/images/dialogs/changeset/changesetmanager.svg,24)]] ''Keyboard shortcut:'' **{{{Ctrl+Alt+C}}}** 5 [[TOC(inline)]] 5 [[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)** 6 6 7 == Launching Changeset Manager == 7 [[PageOutline(2-10,Table of Contents)]] 8 9 == Launching Changeset Manager ==#Launch 8 10 There are several ways to launch the Changeset Manager: 9 11 10 1. Select the menu item ''Windows-> [[ Image(source:trunk/images/dialogs/changeset/changesetmanager.svg,24)]] Changeset Manager''11 1. Press ** {{{Ctrl+Alt+C}}}**12 1. Select one or more changesets in the [ Dialog/ChangesetList Changeset List Dialog] and click there on [[Image(source:trunk/images/dialogs/changeset/changesetmanager.svg,24)]].12 1. Select the menu item ''Windows-> [[JOSMImage(dialogs/changeset/changesetmanager,24,middle,link=)]] Changeset Manager'' 13 1. Press **`Ctrl+Alt+C`** 14 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=)]]. 13 15 14 16 == The Changeset Manager window == … … 17 19 18 20 == Querying changesets == 19 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 [ Dialog/ChangesetQuery Changeset Query Dialog].21 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]. 20 22 21 23 === Query and download a changeset by its unique ID === … … 24 26 [[Image(query-single-changeset.png)]] 25 27 26 1. Enter the changeset ID in the input field in the toolbar section of the Changeset Manager27 1. Press ** {{{ENTER}}}** or click on [[Image(source:trunk/images/dialogs/changeset/downloadchangeset.svg,24)]].28 1. Enter the changeset ID or a changeset URL in the input field in the toolbar section of the Changeset Manager 29 1. Press **`ENTER`** or click on [[JOSMImage(dialogs/changeset/downloadchangeset,24,middle)]]. 28 30 29 31 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). 30 32 31 33 === Query and download your open changesets === 32 Changesets can be [ Help/Concepts/Changeset#Properties open or closed]. A mapper can always upload additional objects to an open changeset he or she owns.34 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. 33 35 34 36 If you want to download the list of open changesets you own 35 1. Click on [[ Image(source:trunk/images/dialogs/changeset/downloadchangeset.svg,24)]] **My open changesets** in the toolbar section of the Changeset Manager.37 1. Click on [[JOSMImage(dialogs/changeset/downloadchangeset,24,middle)]] **My open changesets** in the toolbar section of the Changeset Manager. 36 38 37 Note that this download only the changeset properties without the changeset content. For downloading the content of changesets see below.39 Note that this download only the changeset properties without the changeset content. For downloading the content of changesets see [#UpdateContentMulti below]. 38 40 39 41 === Advanced queries === … … 42 44 * querying the most recent changesets open or closed on the OSM server 43 45 * querying changesets which modified object in a specific area (called a "bounding box") 44 can be run using the [ Dialog/ChangesetQuery Changeset Query Dialog].46 can be run using the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog]. 45 47 46 To launch the [ Dialog/ChangesetQuery Changeset Query Dialog]:48 To launch the [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog]: 47 49 48 1. Click on [[ Image(source:/trunk/images/dialogs/search.png)]] **Query** in the toolbar section of the Changeset Manager.50 1. Click on [[JOSMImage(dialogs/search,middle)]] **Query** in the toolbar section of the Changeset Manager. 49 51 50 52 == Managing the cache of downloaded changesets == 51 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. 53 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. 54 55 To sort the table of the changesets click on the table column header. 52 56 53 57 === Removing changesets from the cache === … … 58 62 To remove one or more changesets from the local cache 59 63 1. Select the changesets in the Changeset Manager 60 1. Click on [[ Image(source:trunk/images/dialogs/delete.png)]] or press **{{{DEL}}}**. Alternatively you may select [[Image(source:trunk/images/dialogs/delete.png)]] **Remove from cache** from the popup menu.64 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. 61 65 62 66 === Updating the properties of changesets in the cache === 63 Properties of changesets can c ache 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.67 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. 64 68 65 69 In order to update the properties of one or more changesets 66 70 1. Select the changesets in the Changeset Manager 67 1. Click on [[ Image(source:trunk/images/dialogs/changeset/updatechangeset.svg,24)]]. Alternatively you may select [[Image(source:trunk/images/dialogs/changeset/updatechangeset.svg,24)]] **Update changeset** from the popup menu.71 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. 68 72 69 Note that this will update the changeset properties only. For updating the changeset content, see [ Dialog/ChangesetManager#UpdateContentMulti below].73 Note that this will update the changeset properties only. For updating the changeset content, see [#UpdateContentMulti below]. 70 74 71 75 === Downloading/Updating the content of changesets in the cache === #UpdateContentMulti … … 75 79 In order to download the changeset content of one or more changesets 76 80 1. Select the changesets in the Changeset Manager 77 1. Click on [[ Image(source:trunk/images/dialogs/changeset/downloadchangesetcontent.png)]]. Alternatively you may select [[Image(source:trunk/images/dialogs/changeset/downloadchangesetcontent.png)]] **Download changeset content** from the popup menu.81 1. Click on [[JOSMImage(dialogs/changeset/downloadchangesetcontent)]]. Alternatively you may select [[JOSMImage(dialogs/changeset/downloadchangesetcontent)]] **Download changeset content** from the popup menu. 78 82 79 The content of a changeset may change over time too, provided the changeset is still open. The same steps will always retrieve the lastest content for a given changeset. If the local cache already includes the content of a changeset, this operation will refresh it. 83 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. 84 85 === Copying a list of changesets to clipboard === 86 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. 87 80 88 81 89 == Managing a single changeset == 82 90 === Browsing properties, tags, and content === 83 The detail view in the lower half of the Changeset Manager consists of threetabs:91 The detail view in the lower half of the Changeset Manager consists of four tabs: 84 92 * **Properties** - displays the basic properties of the currently selected changeset, i.e. its ID or whether the changeset is open or closed 85 * **Tags** - displays the tags assigned to the currently selected changeset 86 * **Content** - displays the changeset content 93 * **Tags** - displays the tags assigned to the currently selected changeset 94 * **Content** - displays the changeset content 95 * **Discussion** - displays the changeset discussion, if available 87 96 88 97 Click on either of these tabs to browse the respective information. 89 98 99 === External Changeset viewers === 100 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. 101 90 102 === Remove a changeset from the local cache === 91 103 92 1. Click on [[Image(source:trunk/images/dialogs/delete.png)]] to remove the currently selected changeset from the cache. 104 1. Click on [[JOSMImage(dialogs/delete,24,middle,link=)]] to remove the currently selected changeset from the cache. 105 106 === Editing changeset content === 107 This is not possible in JOSM. 93 108 94 109 === Updating/Downloading changeset content === … … 96 111 97 112 In order to update the changeset properties 98 1. Click on [[ Image(source:trunk/images/dialogs/changeset/updatechangeset.svg,24)]]113 1. Click on [[JOSMImage(dialogs/changeset/updatechangeset,24,middle,link=)]] 99 114 100 115 In order to update/download the changeset content 101 1. Click on [[ Image(source:trunk/images/dialogs/changeset/updatechangesetcontent.svg,24)]] or [[Image(source:trunk/images/dialogs/changeset/downloadchangesetcontent.svg,24)]] respectively. Depending on whether the changeset content has already been downloaded either of these two actions is available.116 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. 102 117 103 === Selecting objects in the changeset content in the Map View === 104 If the [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. 105 106 1. Click on [[Image(source:trunk/images/dialogs/select.png)]] in the detail view of the Changeset Manager 107 108 You can also 109 110 1. Select the tab **Content** in the detail view 111 1. Select one or more objects in the content 112 1. Click on [[Image(source:trunk/images/dialogs/select.png)]]. Alternatively, you may select [[Image(source:/trunk/images/dialogs/select.png)]] **Select in layer** in the popup menu. 113 114 === Zooming to objects in the changeset content === 115 If the [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. 116 117 In order to zoom to "zoom to the changeset" 118 1. Click on [[Image(source:trunk/images/dialogs/autoscale/selection.png)]] in the detail view of the Changeset Manager. 119 120 Alternatively, you may zoom to a subset of the changeset content". In order to do so 118 === Download the current version of objects in the changeset content === 119 Objects included in the changeset may be downloaded to the active data layer. If no data layer exists a new one is created. 121 120 122 121 1. Click on the tab **Content**. 123 122 1. Make sure the changeset content is downloaded. If not, download it first. 124 123 1. Select some objects in the changeset content. 125 1. Click on [[Image(source:trunk/images/dialogs/autoscale/selection.png)]]. Alternatively, you may select [[Image(source:trunk/images/dialogs/autoscale/selection.png)]] **Zoom to layer** from the popup menu. 124 1. Click on [[JOSMImage(downloadprimitive)]]. Alternatively, you may select [[JOSMImage(downloadprimitive)]] **Download Objects** from the popup menu. 125 126 **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. 126 127 127 128 === Download and display the history of objects in the changeset content === … … 131 132 1. Make sure the changeset content is downloaded. If not, download it first. 132 133 1. Select some objects in the changeset content. 133 1. Click on [[ Image(source:trunk/images/dialogs/history.png)]]. Alternatively, you may select [[Image(source:trunk/images/dialogs/history.png)]] **Show history** from the popup menu.134 1. Click on [[JOSMImage(dialogs/history)]]. Alternatively, you may select [[JOSMImage(dialogs/history)]] **Show history** from the popup menu. 134 135 135 == See also == 136 * [[Image(source:trunk/images/closechangeset.png)]] [Action/CloseChangeset Close changesets] 137 * [Dialog/ChangesetList Changeset List Dialog] 138 * [Dialog/ChangesetQuery Changeset Query Dialog] 136 === Selecting objects in the changeset content in the Map View === 137 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. 138 139 1. Click on [[JOSMImage(dialogs/select)]] in the detail view of the Changeset Manager 140 141 You can also 142 143 1. Select the tab **Content** in the detail view 144 1. Select one or more objects in the content 145 1. Click on [[JOSMImage(dialogs/select)]]. Alternatively, you may select [[JOSMImage(dialogs/select)]] **Select in layer** in the popup menu. 146 147 === Zooming to objects in the changeset content === 148 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. 149 150 In order to zoom to "zoom to the changeset" 151 1. Click on [[JOSMImage(dialogs/autoscale/selection)]] in the detail view of the Changeset Manager. 152 153 Alternatively, you may zoom to a subset of the changeset content". In order to do so 154 155 1. Click on the tab **Content**. 156 1. Make sure the changeset content is downloaded. If not, download it first. 157 1. Select some objects in the changeset content. 158 1. Click on [[JOSMImage(dialogs/autoscale/selection)]]. Alternatively, you may select [[JOSMImage(dialogs/autoscale/selection)]] **Zoom to layer** from the popup menu. 159 160 == See also == 161 * [wikitr:/Help/Concepts/Changeset Concept of changesets] 162 * [[JOSMImage(closechangeset,bottom,link=,24)]] [wikitr:/Help/Action/CloseChangeset Close changesets] 163 * [[JOSMImage(dialogs/changesetdialog,24,middle,link=)]] [wikitr:/Help/Dialog/ChangesetList Changeset List panel] 164 * [wikitr:/Help/Dialog/ChangesetQuery Changeset Query Dialog] 139 165 140 166 ---- 141 Back to [wiki:/Help Main Help] 167 Back to [wikitr:/Help/Menu/Windows Menu Windows] \\ 168 Back to [wikitr:/Help Main Help]