Changes between Version 43 and Version 59 of Help/Action/Search


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

Legend:

Unmodified
Added
Removed
Modified
  • Help/Action/Search

    v43 v59  
    11[[TranslatedPages]]
     2[[PageOutline(2-4,Table of Content)]]
    23
    34= Search =
    45
    5 [[Image(source:trunk/images/dialogs/search.png,middle)]] ''Keyboard shortcut'': '''{{{Ctrl+F}}}'''
     6[[JOSMImage(dialogs/search,link=,48,middle,margin-right=20)]] ''Keyboard shortcut'': **`Ctrl+F`**
    67
    7 '''Search [wiki:/Help/Concepts/Object objects] in the current data layer using query language'''. This tool have different look, depending on your expert setting:
     8**Search [wikitr:/Help/Concepts/Object objects] in the current data layer using query language**. \\
     9This windows has different looks, depending on your [[JOSMImage(expert)]] [wikitr:/Help/ExpertMode Expert Mode] setting, [#ExpertMode see below]:
    810
    9 Search action will respect current [Help/Dialog/Filter filters] meaning it wouldn't return any of filtered objects.
     11* The search action will respect the current [wikitr:/Help/Dialog/Filter filters] meaning it wouldn't return any of the filtered objects.
     12* Colons (`:`) within ''keys'' and ''values'' need to be wrapped with quotation marks (`"`).
     13* Hover over a keyword in the search hints section to get a explanation and special examples.
     14* Double click on a preset listed in the search window to add the query to search for objects that match this preset.
    1015
    11 Hover over keyword in search menu to get textual explanation with simple example!
     16[[Image(Search.png,link=,70%)]]
    1217
    13 || [Help/ExpertMode Expert mode off]: [[br]] [[Image(9229-search-expert-false-with-tooltip.png)]] || . ||
    14 || [Help/ExpertMode Expert mode on]: [[br]] [[Image(9229-search-expert-true.png)]] || - '''standard/regular expression/MapCSS selector''' radio button, see sections below for details        - '''add toolbar button''' covered in section [Help/Action/Search#SavesearchqueryinMaintoolbar] ||
     18== Expert mode ==#ExpertMode
     19In [wikitr:/Help/ExpertMode expert mode], the following options are added:
     20* more keywords are listed (they work also in non-expert mode, but are hidden in the dialog)
     21* **standard/regular expression/MapCSS selector** radio button, see sections below for details
     22* **all objects** check box to include **''deleted''** and **''incomplete''** objects in the search
     23* **add toolbar button** see [wikitr:/Help/Action/Search#SavesearchqueryinMaintoolbar save search query in main toolbar] below.
    1524
     25[[Image(Search_expert.png,link=,70%)]]
    1626
    17 == Keywords ==
    18 
    19 || Keyword || Supports ranges || Range separator || Description ||
    20 || id || yes || - || Search for objects with specific ids ([Help/Concepts/Object#Objectids]) ||
    21 || version || yes || - || Search for objects with specific version ([Help/Concepts/Object#Objectversions]). `version:0` is equivalent to keyword `new`. Note that `version:-1` will match `new` objects. ||
    22 || type || no || n/a || Only 3 possible values: `type:node`, `type:way`, `type:relation` ([Help/Concepts/Object#NodesWaysRelations]) ||
    23 || user || no || n/a || "anonymous" is a special word? i.e. `user:anonymous`
    24 || role ||  ||
    25 || changeset || yes || - ||  ||
    26 || nodes || yes || - || Search for objects with number of nodes within range. Note that `nodes:-2` query won't match single nodes! ||
    27 || ways ||  ||
    28 || tags || yes || - || Search for objects with tag count of tags within range, regardless of "discardable tags" and "uninteresting tags" ([Help/Concepts/Object#Tags]). Note that `tags:-1` will also match tagless objects! ||
    29 || areasize ||  ||
    30 || waylength ||  ||
    31 || modified || no || n/a || Confusing name: will select (old and modified objects) or (completely new objects). ||
    32 || selected ||  ||
    33 || incomplete ||  ||
    34 || untagged || no || n/a || This modifier differs from `tags:0` since it will ignore all "discardable" and "uninteresting tags" (description, attribution, source, source_ref, source:, comment, converted_by, watch, watch:,)! [https://josm.openstreetmap.de/browser/josm/trunk/src/org/openstreetmap/josm/data/osm/OsmPrimitive.java#L678 more info] ||
    35 || closed ||  ||
    36 || new ||  ||
    37 || indownloadedarea ||  ||
    38 || allindownloadedarea ||  ||
    39 || inview ||  ||
    40 || allinview ||  ||
    41 || timestamp || yes || / || min/max pair with two notes. If min timestap is empty: use lowest possible date (1980). If max timestamp is empty: use current time. ||
    42 || nth ||  ||
    43 || nth% ||  ||
    44 || hasRole ||  ||
    45 || parent ||  ||
    46 || child ||  ||
    47 
    48 == Examples ==
    49 
     27== Examples ==#Examples
    5028Some examples of queries:
    51 
    5229* `type:way` selects all ways
    5330* `name:Herrengasse` selects all elements with the given name
    5431* `name=Herrengasse` same as above, but case sensitive
    55 * `"name"="Baker Street"` same as above, but works also with special characters like white spaces in the value
     32* `"addr:street"="Baker Street"` if special characters (in this case `:` in the key and white space in the value) are used, the key resp. the value needs to be enclosed in `""`
    5633* `tag1=yes tag2=yes` is equivalent to `tag1=yes & tag2=yes`
    5734* `type:way name:-` selects all ways that do not have a name
    5835* `id:123465678` selects an object (way or node) with a particular id
    5936* `timestamp:2010-11-01/2010-12-01` selects object with last change in November 2010
    60 * See also [[Help/Dialog/Filter#Examples]]
     37* `preset:"Craft/Beekeeper"` selects objects that match the beekeeper preset
     38* See also [wikitr:/Help/Dialog/Filter#Examples Examples]
    6139
    62 == Save search query in [wiki:Help/MainToolbar Main toolbar] ==
     40== Save search query in [wikitr:/Help/MainToolbar main toolbar] ==#SavesearchqueryinMaintoolbar
     41To ''save search as a button'' if you check **add toolbar button** checkbox, as soon as you click on [[JOSMImage(dialogs/search)]] **Start Search**, a button will be added to the main toolbar. which will execute the defined search expression each time, you press the button.
    6342
    64 To ''save search as a button'' if you check '''add toolbar button''' checkbox, as soon as you click on [[Image(source:trunk/images/dialogs/search.png,middle)]] '''Start Search''', a button will be added to the Main Toolbar. which will execute the defined search expression each time, you press the button.
    65 
    66 [wiki:Help/Preferences/Toolbar#Previouslysavedsearchresults Toolbar Customization will let you modify icon, search query and an icon].
    67 
    68 As with any "button" [Help/Preferences/Shortcuts you can always assign shortcut to it].
     43* [[JOSMImage(preferences/toolbar,link=,24,middle)]] [wikitr:/Help/Preferences/Toolbar#Previouslysavedsearchresults Toolbar Customization] will let you modify icon, search query and tooltip.
     44* As with any button you can always assign a shortcut to it in [[JOSMImage(preferences/shortcuts,link=,24,middle)]] [wikitr:/Help/Preferences/Shortcuts Shortcut Preferences].
    6945
    7046== Regular expressions ==
    71 
    72 JOSM supports [http://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html Java regex syntax].
     47JOSM supports [https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html Java regex syntax].
    7348
    7449== MapCSS syntax ==
     50See [wikitr:/Help/Styles/MapCSSImplementation MapCSS implementation]
    7551
    76 See [wiki:Help/Styles/MapCSSImplementation].
    77 
    78 == Fetch external file and replace selection ==
    79 
     52== Fetch external file and replace selection ==#Fetchexternalfileandreplaceselection
    8053A very under-used feature that lets you enter a web URL (`file://`, `http://`, `https://`, `ftp://`) in the search field.
    8154
    82 JOSM will then attempt to load that URL, and select any objects that it finds referenced in that file.
    83 JOSM will look for XML tags "way", "node", and "relation" in the document (clarify? examples?), and use their id attribute .
    84 You can access another OSM file on your hard disk this way and have JOSM select all objects that are present in the file (provided they are present in JOSM's dataset too).
     55* JOSM will then attempt to load that URL, and select any objects that it finds referenced in that file.
     56* JOSM will look for XML tags "way", "node", and "relation" in the document (clarify? examples?), and use their id attribute .
     57* You can access another OSM file on your hard disk this way and have JOSM select all objects that are present in the file (provided they are present in JOSM's dataset too).
    8558
    86 Similar thing is possible [wiki:Help/CommandLineOptions via command line parameter during JOSM start-up].
    87 Similar thing is possible via Remote control command.
     59Similar thing is possible via:
     60* [wikitr:/Help/CommandLineOptions Command line parameter] during JOSM start-up
     61* [wikitr:/Help/Preferences/RemoteControl Remote control] command
    8862
    8963== See also ==
    90 * [Help/Dialog/Filter] allows you to save and combine multiple search patterns between your JOSM sessions
     64* [[JOSMImage(dialogs/filter)]] [wikitr:/Help/Dialog/Filter Filters] allow you to save and combine multiple search patterns between your JOSM sessions
     65
    9166----
    92 Back to [wiki:/Help/Menu/Edit Menu Edit][[Br]]
    93 Back to [wiki:/Help Main Help]
     67Back to [wikitr:/Help/Menu/Edit Menu Edit] \\
     68Back to [wikitr:/Help/Menu Main Menu] \\
     69Back to [wikitr:/Help Main Help]