Changes between Version 29 and Version 94 of Help/Dialog/TagsMembership


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Dialog/TagsMembership

    v29 v94  
    1 [[TranslatedPages]]
     1[[TranslatedPages(outdated=This page might need some clean up and more internal links.)]]
    22
    3 = Tags/Membership Dialog =
     3= Tags/Membership panel =
     4[[PageOutline(2-10,Table of Contents)]]
    45
    5 [[Image(source:trunk/images/dialogs/propertiesdialog.png,30,middle,margin-right=20)]] ''Keyboard shortcut'': **`Alt+Shift+P`**
     6[[JOSMImage(dialogs/propertiesdialog,48,link=,middle,margin-right=20)]] ''Keyboard shortcut'': **`Alt+Shift+P`** — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM panels]
    67
    7 The tags & membership window (previously called properties window) is shown to the right of the main JOSM window. If it is not displayed then:
    8 * click the [[Image(source:trunk/images/dialogs/propertiesdialog.png,16,top)]] **tag for selected objects** icon (an image of a diagonally label) in the left panel,
    9 * use the window menu in the [wiki:/Help#MainMenu main menu],
    10 * or press the keyboard shortcut `Alt+Shift+P`.
    118
    12 == Dialog usage ==
     9== Usage ==#Usage
     10This panel shows the existing tags for the selected objects in [wikitr:/Help/MapView Map view], and allows you to add, edit, or delete tags.
    1311
    14 [[Image(Properties_dialog.png,right,margin-left=15,margin-top=20,margin-bottom=20)]]
     12The keys and values in use in OpenStreetMap can be found using [wikitr:/Help/Concepts/Object#Tags multiple ways].
    1513
    16 This dialog box shows you the existing tags for the selected objects, and allows you to add, edit, or delete tags.
     14Note: You can also add tags to selected object using presets, it is covered in [wikitr:/Introduction#Presets presets introduction].
    1715
    18 Tags are generally added to [Concepts/Object objects], and whatever objects you want to edit must be first selected before using any of the controls outlined below. The keys and values in use in OpenStreetMap can be found on the [osmwiki:Map_features map features] page and elsewhere in the [osmwiki: OSM wiki].\\
    19 **Note**: You can also add tags to selected object using presets from the [Menu/Presets Presets Menu].
    2016
    21 You can either select one object at a time, or select multiple objects, before using the control [#Buttons buttons] below. If you have selected multiple objects and they have different values for a particular key, then in the tags dialog box this will be shown as value ''`<different>`''.
     17== Try it yourself ==
     18Open this [attachment:TagsMembershipDemo.2.osm sample file] by using the menu item [wikitr:/Help/Menu/File "File > Open Location ..."] (`Ctrl+L`).
    2219
    23 === Structure ===
    24 In the header the total number of tags and memberships of selected objects is given, just below links to presets are displayed if already existing tags match.\\
    25 The list itself shows all [Concepts/Object#Tags tags] (Key/Value) in the upper part and in the bottom part lists the
    26 relations of which selected objects are members of with their roles and their position within the relation.
    2720
    28 == Buttons ==
    29 === [[Image(source:trunk/images/dialogs/add.png,bottom,margin-right=10)]] Add (''`Alt+A`'') === #Add
    30 Add key/value pairs to selected objects.
     21== Overview of this panel == #Structure
     22The three parts, Preset Links, Filter and Tags Table, are only shown if selection includes at least one object with tag.
    3123
    32 Double clicking in the empty space below the tags or clicking the **Add** button opens the [Dialog/AddValue add value dialog] which allows you to enter keys and values.
     24=== Counts ===
     25In the header, the counts for currently selected objects in [wikitr:/Help/MapView Map view] are shown - objects, tags and memberships, if selection includes at least one objects with tag or membership.
    3326
    34 === [[Image(source:trunk/images/dialogs/edit.png,bottom,margin-right=10)]] Edit (''`Alt+S`'') === #Edit
    35 Change selected key/value pair.
     27=== Presets Links ===
     28[[Image(josm_TagsMembership_ToggleDialog.png,right,link=,margin-left=10,margin-bottom=10)]]
     29Icons and the names of [wikitr:/Presets presets], namely:
     30 * All matching presets for single object, if only one object was selected
     31 * Common presets of selected objects (set intersection and result set may be empty because there no common preset(s) for all objects)
     32  * Annotations presets (notes or address) will be displayed if at least one object has such tag
    3633
    37 If you either double click on a key/value pair entry in the tags dialog or select one entry and then click the **Edit** button you can edit the value and/or key in the [Dialog/EditValue change value dialog].
     34**Possible activation**: Left mouse click on the preset will open the preset, as is shown in [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview  "Introduction"].
    3835
    39 Double clicking on a membership entry or selecting one membership entry and then clicking on **Edit** will open the [Dialog/RelationEditor relation editor]. If you just want to add and/or edit tags to relation you can simply select the relation using the [#ContextMenu context menu]
     36=== Filter Tags ===#FilterTags
     37Tag filter with same syntax as [wikitr:/Help/Action/Search Search]:
     38 * Simple string (such as `Rome` will searched both in values and in keys (i.e. if you add tag "Rome"=yes it will be matched against "Rome" search)
     39 * `"addr:city":ome` or `"addr:city":Rome` will match `addr:city=Rome` tag
     40All tags not matching the filter are omitted from Tags Table below.
    4041
    41 === [[Image(source:trunk/images/dialogs/delete.png,bottom,margin-right=10)]] Delete (''`Ctrl+Alt+Shift+D`'') === #Delete
    42 Delete selected key/value pairs.
     42=== Tags Table ===
     43The table shows the tags as key/value pairs and, additionally, some empty space below. Depending on Filter Tags above some or all tags may be omitted.
    4344
    44 If you select one or several key/value pair in the tags dialog, and then click the **Delete** button they will be immediately deleted. If you make a mistake then you can use [[Image(source:/trunk/images/undo.png,18,middle)]] **[Action/Undo undo]** (''`Ctrl+Z`'') on the [Menu/Edit Edit Menu] or the [Dialog/CommandStack command stack toggle dialog] to undo it.
     45 * key/value pairs for single [wikitr:/Help/Dialog/SelectionList#Selection selected] object
     46 * annotated summary for multiple selected objects where the values are:
     47  * **`value`**, if all objects have the tag
     48  * ''`<number 'value', number unset>`'', if a number of objects have the tag and the other number of object do not have the tag
     49  * ''`<number different>`'', if all objects have the tag but with the number of different values
     50  * ''`<number different, number unset>`'', if some objects have the tag but with the number of different values and the other number of object do not have the tag
     51
     52**Possible activation**:
     53 * double click on a tag will open [wikitr:/Help/Dialog/EditValue Change value dialog].
     54 * double click on empty space will open [wikitr:/Help/Dialog/AddValue Add tag dialog].
     55 * [=#rightclicktag right click on item from tag table] will show [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonatagintagspart respective context menu] ("Add" to [wikitr:/Help/Dialog/AddValue Add tag dialog]; "Edit" to [wikitr:/Help/Dialog/EditValue Change value dialog])
     56
     57=== Membership Table ===
     58The table shows information about memberships of selected objects in [wikitr:/Help/Concepts/Object#Relations relations]. The table is only shown if any object in selection is member of a relation.
     59 Member of::
     60 shows the type of relation, its name (value of `name=*` tag), the total number of members and its state - ''incomplete'' if the relation is not downloaded completely.
     61 Role::
     62 shows the roles as:
     63 * **''empty''** or **`role`**, if all object have no role or all have the same role
     64 * `<different>`, if objects have different roles or some objects have a role and some have not.
     65
     66**Note**: Objects without parent relations in local [wikitr:/Help/Dialog/LayerList#Layertypes data layer] can have parent relations on the server
     67
     68**Possible activation**:
     69 * [=#doubleclickmembership double click on item] or `Alt+S` will open [wikitr:/Help/Dialog/RelationEditor relation editor] (and selection will be preserved)
     70 * [=#rightclickmembership right click on item from parent relations] will show [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonaparentrelationinmembershipspart respective context menu] ("Edit" item will open [wikitr:/Help/Dialog/RelationEditor relation editor])
     71 * [=#DoubleclickMembershipRole double click on the field of the role column] opens the following dialog to edit the roles of selected members of the item (and selection will be preserved)
     72
     73[[Image(role_input_dialog.jpg,link=)]]
     74
     75=== Panel Buttons ===#Buttons
     76Basic usage is covered in [wikitr:/Introduction#AddingTags adding tags introduction]. \\
     77Panel buttons are visible by default, see ([[wikitr:/Help/JOSM interface customization|JOSM interface customization]])
     78
     79[[JOSMImage(dialogs/add,bottom,margin-right=10,inline,link=)]] **Add** (''`Alt+A`'') [=#Add]
     80
     81* Adds key/value pairs to selected objects using the [wikitr:/Help/Dialog/AddValue Add tag dialog].
     82
     83 Alternative activation steps covered in overview section above.
     84
     85[[JOSMImage(dialogs/edit,link=,bottom,margin-right=10,inline)]] **Edit** (''`Alt+S`'') [=#Edit]
     86* Change selected key/value pair using the [wikitr:/Help/Dialog/EditValue Change value dialog] - if tag was selected.
     87* Open relation editor - if relationship was selected.
     88
     89 Alternative activation steps covered in overview section above.
     90
     91[[JOSMImage(dialogs/delete,24,link=,bottom,margin-right=10,inline)]] Delete (''`Ctrl+Alt+Shift+D`'' or ''`Del`'') [=#Delete]
     92* Delete selected key/value pairs.
     93
     94 If you select one or several key/value pair in the tags table, and then click the **Delete** button they will be immediately deleted.
     95
     96
     97== Examples ==#Examples
     98Single object without parent relations (note: [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview you can click on headings to open complete presets]):
     99
     100[[Image(tagsmemberships-single-object.png,link=)]]
     101
     102Single object used in 3 [wikitr:/Help/Concepts/Object#Relations relations] at once:
     103
     104[[Image(tagsmemberships-single-object-multiple-parent-relations.png​,link=)]]
     105
     106When localized name tags are used, the language the abbreviation stands for is displayed behind the key:
     107
     108[[Image(name-xx.png,link=)]]
     109
    45110
    46111== Context Menu ==
    47 Right click on a entry opens the [Menu/TagsMembershipMenu Tags Context Menu]
     112See [wikitr:/Help/Menu/TagsMembershipMenu TagsMembership Context Menu]
    48113
    49 == Advanced Preferences ==
     114
     115== Advanced Preferences ==#AdvancedPreferences
    50116||= **Property** =||= **Default** =||= **Explanation** =||
    51 || {{{properties.presets.top}}} || {{{true}}} || If set to {{{true}}}, displays the list of presets matching the current tags.
    52 || {{{url.openstreetmap-wiki}}} || {{{https://wiki.openstreetmap.org/wiki/}}} || The address of the OSM wiki used to see the documentation of a tag.
     117|| **`properties.presets.visible`** ||  `true`  || If set to `true`, displays the list of presets matching the current tags.
     118|| **`properties.presets.top`** ||  `true`  || If set to `true`, displays the list of presets matching the current tags above the list of tags, else below.
     119|| **`url.openstreetmap-wiki`** ||  `https://wiki.openstreetmap.org/wiki/`  || The address of the OSM wiki used to see the documentation of a tag.
    53120
    54121----
    55 Back to [Help/ToggleDialogs Toggle Dialogs][[BR]]
    56 Back to [wiki:/Help Main Help]
     122Back to [wikitr:/Help/Menu/Windows Windows menu] \\
     123Back to [wikitr:/Help/ToggleDialogs Sidebar] \\
     124Back to [wikitr:/Help/Menu Main Menu] \\
     125Back to [wikitr:/Help Main Help]