dhis2-devs team mailing list archive
-
dhis2-devs team
-
Mailing list archive
-
Message #30838
[Branch ~dhis2-documenters/dhis2/dhis2-docbook-docs] Rev 1103: TEI query
------------------------------------------------------------
revno: 1103
committer: Lars Helge Overland <larshelge@xxxxxxxxx>
branch nick: dhis2-docbook-docs
timestamp: Sat 2014-06-14 20:06:52 +0200
message:
TEI query
modified:
src/docbkx/en/dhis2_user_man_web_api.xml
--
lp:~dhis2-documenters/dhis2/dhis2-docbook-docs
https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs
Your team DHIS 2 developers is subscribed to branch lp:~dhis2-documenters/dhis2/dhis2-docbook-docs.
To unsubscribe from this branch go to https://code.launchpad.net/~dhis2-documenters/dhis2/dhis2-docbook-docs/+edit-subscription
=== modified file 'src/docbkx/en/dhis2_user_man_web_api.xml'
--- src/docbkx/en/dhis2_user_man_web_api.xml 2014-06-11 06:44:51 +0000
+++ src/docbkx/en/dhis2_user_man_web_api.xml 2014-06-14 18:06:52 +0000
@@ -4595,9 +4595,12 @@
<row>
<entry>query</entry>
<entry>Query string. Attribute query parameter can be used to define which attributes to
- include in the response. If no attributes but a program is defined, the attributes
- from the program will be used. If no program is defined, all attributes will be
- used.</entry>
+ include in the response. If no attributes but a program is defined, the attributes
+ from the program will be used. If no program is defined, all attributes will be
+ used. There are two formats. The first is a plan query string. The second is on the
+ format <operator>:<query>. Operators can be EQ | LIKE. EQ implies exact
+ matches on words, LIKE implies partial matches on words. The query will be split on
+ space, where each word will form a logical AND query.</entry>
</row>
<row>
<entry>attribute</entry>
@@ -4747,10 +4750,13 @@
<para>A query for all instances associated with a specific organisation unit can look like
this:</para>
<screen>api/trackedEntityInstances.json?ou=DiszpKrYNg8</screen>
- <para>A query on all attributes for a specific value and organisation unit:</para>
+ <para>A query on all attributes for a specific value and organisation unit, using an exact word
+ match:</para>
<screen>api/trackedEntityInstances.json?query=scott&ou=DiszpKrYNg8</screen>
+ <para>A query on all attributes for a specif value, using a partial word match:</para>
+ <screen>api/trackedEntityInstances.json?query=LIKE:scott&ou=DiszpKrYNg8</screen>
<para>You can query on multiple words separated by the the URL character for space which is
- %20:</para>
+ %20, will use a logical AND query for each word:</para>
<screen>api/trackedEntityInstances.json?query=isabel%20may&ou=DiszpKrYNg8</screen>
<para>A query where the attributes to include in th response are specified looks like
this:</para>