Changes between Version 77 and Version 95 of Help/Dialog/TagsMembership


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Dialog/TagsMembership

    v77 v95  
    1 [[TranslatedPages(outdated=This page needs a rework. It is not user friendly. It should be simplified.)]]
     1[[TranslatedPages(outdated=This page might need some clean up and more internal links.)]]
    22
    3 = Tags/Membership window =
     3= Tags/Membership panel =
     4[[PageOutline(2-10,Table of Contents)]]
    45
    5 [[Image(source:trunk/images/dialogs/propertiesdialog.svg,30,middle,margin-right=20)]] ''Keyboard shortcut'': **`Alt+Shift+P`** — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM windows]
     6[[JOSMImage(dialogs/propertiesdialog,48,link=,middle,margin-right=20)]] ''Keyboard shortcut'': **`Alt+Shift+P`** — one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM panels]
     7
     8
     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.
     11
     12The keys and values in use in OpenStreetMap can be found using [wikitr:/Help/Concepts/Object#Tags multiple ways].
     13
     14Note: You can also add tags to selected object using presets, it is covered in [wikitr:/Introduction#Presets presets introduction].
     15
    616
    717== 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`).
    819
    9 Open this [attachment:TagsMembershipDemo.2.osm sample file] by using the menu item [wikitr:/Help/Menu/File "File > Open Location ..." (Ctrl+L)].
    1020
    11 == Overview of this window == #Structure
     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.
    1223
    13 From the top:
    14 1. current counts for currently selected objects in the header: objects, tags, memberships
    15 2. [wikitr:/Help/Concepts/Object#presets presets], namely:
     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.
     26
     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:
    1630 * All matching presets for single object, if only one object was selected
    1731 * Common presets of selected objects (set intersection and result set may be empty because there no common preset(s) for all objects)
    18   * Annotations presets (notes or address) will be displayed if at least one object had such tag
     32  * Annotations presets (notes or address) will be displayed if at least one object has such tag
    1933
    20  Possible activation: left mouse click on the preset will open complete view of this preset, as [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview was shown in "Introduction"]
    21 3. Tag filter ([wikitr:/Help/Action/Search any search string])
    22  * 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)
    23  * {{{"addr:city":ome}}} or {{{"addr:city":Rome}}}) will match addr:city=Rome tag
    24 4. table of:
     34**Possible activation**: Left mouse click on the preset will open the preset, as is shown in [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview  "Introduction"].
     35
     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.
     41
     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.
     44
    2545 * key/value pairs for single [wikitr:/Help/Dialog/SelectionList#Selection selected] object
    26   * complete list of tags if ''filter'' was empty
    27   * empty if filter from 3 matches no tags
    28   * only matched tags if there matching tags
    29  * annotated summary for multiple selected objects (select shop=pet together with shop=computer to see what it means)
    30  * empty space (below all items).
     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
    3151
    32  Possible activation: double click on empty space will open [[wikitr:/Help/Dialog/AddValue|add value dialog]].[[br]]
    33  Possible activation: [=#rightclicktag right click on item from tag table] will show [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonitemsintagspart respective context menu] ("Add" to [wikitr:/Help/Dialog/AddValue add value window]; "Edit" to [wikitr:/Help/Dialog/EditValue change value dialog])
     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])
    3456
    35 5. membership information (is about [wikitr:/Help/Concepts/Object#Relations relations])
    36  * no matching applied for parent relations; this result in union of all involved parent relations for the selected objects
    37  * displayed only for objects that have parent relations in [wikitr:/Help/Dialog/LayerList#ActivateLayer the current data layer]
    38  * objects without parent relations in local [wikitr:/Help/Dialog/LayerList#Layertypes data layer] can have parent relations on the server
     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 at least one selected object is a member of a relation, and it includes every relation that contains at least one selected object, even if other selected objects do not belong to the 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 of the selected objects that belong to the relation 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.
    3965
    40  Possible activation: [=#rightclickmembership right click on item from parent relations] will show [wikitr:/Help/Menu/TagsMembershipMenu#Rightclickonitemsinmembershipspart respective context menu] ("Edit" item will open [wikitr:/Help/Dialog/RelationEditor relation editor])[[br]]
    41  Possible activation: [=#doubleclickmembership double click on item] will open [wikitr:/Help/Dialog/RelationEditor relation editor] (and selection will be preserved)
     66 This column ignores any selected objects that do not belong to the relation.
     67 Position::
     68 Shows the positions of the selected objects in the relation. Positions are shown in ascending order regardless of the order in which the objects were selected, so this column cannot be used to determine the relative order of selected objects in the relation. An "X" means that at least one selected object does not belong to the relation.
    4269
    43 6. [#Buttons 3 buttons]
     70**Note**: Objects without parent relations in local [wikitr:/Help/Dialog/LayerList#Layertypes data layer] can have parent relations on the server
    4471
    45 === Visibility notes ===
     72**Possible activation**:
     73 * [=#doubleclickmembership double click on item] or `Alt+S` will open [wikitr:/Help/Dialog/RelationEditor relation editor] (and selection will be preserved)
     74 * [=#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])
     75 * [=#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)
    4676
    47 * Items 1-4 are shown only if selection has at least one ''tagged'' object.
    48 * Item 5 requires parent relations
    49 * Item 6 (3 buttons) are visible by default ([[wikitr:/Help/JOSM interface customization|JOSM interface customization]])
     77[[Image(role_input_dialog.jpg,link=)]]
    5078
    51 === Examples ===
     79=== Panel Buttons ===#Buttons
     80Basic usage is covered in [wikitr:/Introduction#AddingTags adding tags introduction]. \\
     81Panel buttons are visible by default, see ([[wikitr:/Help/JOSM interface customization|JOSM interface customization]])
    5282
     83[[JOSMImage(dialogs/add,bottom,margin-right=10,inline,link=)]] **Add** (''`Alt+A`'') [=#Add]
     84
     85* Adds key/value pairs to selected objects using the [wikitr:/Help/Dialog/AddValue Add tag dialog].
     86
     87 Alternative activation steps covered in overview section above.
     88
     89[[JOSMImage(dialogs/edit,link=,bottom,margin-right=10,inline)]] **Edit** (''`Alt+S`'') [=#Edit]
     90* Change selected key/value pair using the [wikitr:/Help/Dialog/EditValue Change value dialog] - if tag was selected.
     91* Open relation editor - if relationship was selected.
     92
     93 Alternative activation steps covered in overview section above.
     94
     95[[JOSMImage(dialogs/delete,24,link=,bottom,margin-right=10,inline)]] Delete (''`Ctrl+Alt+Shift+D`'' or ''`Del`'') [=#Delete]
     96* Delete selected key/value pairs.
     97
     98 If you select one or several key/value pair in the tags table, and then click the **Delete** button they will be immediately deleted.
     99
     100
     101== Examples ==#Examples
    53102Single object without parent relations (note: [wikitr:/Introduction#Leftmouseclickonrespectivepresetheadingwillopencompletepresetview you can click on headings to open complete presets]):
    54103
    55 [[Image(tagsmemberships-single-object.png,nolink)]]
     104[[Image(tagsmemberships-single-object.png,link=)]]
    56105
    57106Single object used in 3 [wikitr:/Help/Concepts/Object#Relations relations] at once:
    58107
    59 [[Image(tagsmemberships-single-object-multiple-parent-relations.png​,nolink)]]
     108[[Image(tagsmemberships-single-object-multiple-parent-relations.png​,link=)]]
    60109
    61110When localized name tags are used, the language the abbreviation stands for is displayed behind the key:
    62111
    63 [[Image(name-xx.png)]]
     112[[Image(name-xx.png,link=)]]
    64113
    65 == Usage ==
    66114
    67 This window shows you the existing tags for the selected objects, and allows you to add, edit, or delete tags.
     115== Context Menu ==
     116See [wikitr:/Help/Menu/TagsMembershipMenu TagsMembership Context Menu]
    68117
    69 The keys and values in use in OpenStreetMap can be found using [wikitr:/Help/Concepts/Object#Tags multiple ways].\\
    70118
    71 Note: You can also add tags to selected object using presets, it was covered in [[wikitr:/Introduction#Presets|presets introduction]].
    72 
    73 == Buttons ==
    74 Basic usage was covered in [[wikitr:/Introduction#AddingTags|adding tags introduction]].
    75 
    76 === [[Image(source:trunk/images/dialogs/add.png,bottom,margin-right=10,inline)]] Add (''`Alt+A`'') === #Add
    77 
    78 Adds key/value pairs to selected objects using [wikitr:/Help/Dialog/AddValue add value window]
    79 
    80 Alternative activation steps covered in overview section above.
    81 
    82 === [[Image(source:trunk/images/dialogs/edit.png,bottom,margin-right=10,inline)]] Edit (''`Alt+S`'') === #Edit
    83 * Change selected key/value pair using [wikitr:/Help/Dialog/EditValue change value window] - if tag was selected
    84 * Open relation editor - if relationship was selected
    85 
    86 Alternative activation steps covered in overview section above.
    87 
    88 === [[Image(source:trunk/images/dialogs/delete.svg,24,bottom,margin-right=10,inline)]] Delete (''`Ctrl+Alt+Shift+D`'') === #Delete
    89 Delete selected key/value pairs.
    90 
    91 If you select one or several key/value pair in the tags window, and then click the **Delete** button they will be immediately deleted.
    92 
    93 == Advanced Preferences ==
     119== Advanced Preferences ==#AdvancedPreferences
    94120||= **Property** =||= **Default** =||= **Explanation** =||
    95 || {{{properties.presets.visible}}} || {{{true}}} || If set to {{{true}}}, displays the list of presets matching the current tags.
    96 || {{{properties.presets.top}}} || {{{true}}} || If set to {{{true}}}, displays the list of presets matching the current tags above the list of tags, else below.
    97 || {{{url.openstreetmap-wiki}}} || {{{https://wiki.openstreetmap.org/wiki/}}} || The address of the OSM wiki used to see the documentation of a tag.
     121|| **`properties.presets.visible`** ||  `true` || If set to `true`, displays the list of presets matching the current tags.
     122|| **`properties.presets.top`** ||  `true` || If set to `true`, displays the list of presets matching the current tags above the list of tags, else below.
     123|| **`url.openstreetmap-wiki`** ||  `https://wiki.openstreetmap.org/wiki/` || The address of the OSM wiki used to see the documentation of a tag.
    98124
    99125----
    100 Back to [wikitr:/Help/ToggleDialogs Windows][[BR]]
     126Back to [wikitr:/Help/Menu/Windows Windows menu] \\
     127Back to [wikitr:/Help/ToggleDialogs Sidebar] \\
     128Back to [wikitr:/Help/Menu Main Menu] \\
    101129Back to [wikitr:/Help Main Help]