Changes between Version 3 and Version 4 of query_builder_doc

Timestamp:

Feb 3, 2016, 5:12:55 PM (8 years ago)

Author:

casties

Comment:

--

query_builder_doc

@@ -13 +13 @@
 
 For the first step you can select one of two query types in the select box:
- * "object type is" to select all objects of a type e.g. PERSON or WITNESS
- * "object ID is" to select one object with a certain ISMI_ID e.g. 47316 for Tusi
+ * "**object type is**" to select all objects of a type e.g. PERSON or WITNESS
+ * "**object ID is**" to select one object with a certain ISMI_ID e.g. 47316 for Tusi
 
 === Show all persons ===
 
-If we select "object type is" in the first select box we get a second select box with all the possible object types like ALIAS, CODEX, COLLECTION and more.
+If we select "**object type is**" in the first select box we get a second select box with all the possible object types like ALIAS, CODEX, COLLECTION and more.
 
-In the second box we select PERSON which automatically runs a query to select all PERSON objects:
+In the second box we select "**PERSON**" which automatically runs a query to select all PERSON objects:
 
 [[Image(qb-person.png)]]
 
-Under "Query result" we see that we have selected 2217 PERSON objects. Because this are very many objects the system will not show all of the objects automatically. If you really want to see all 2217 objects you can click on the "show results" button but your browser may take a while to display so many objects in a table.
+Under "Query result" we see that we have selected 2217 PERSON objects. 
 
+Because this are a lot of objects the system will not show all of the objects automatically. If you really want to see all 2217 objects you can click on the "**show results**" button but your browser may crash or take a while to display so many objects in a table.
+
+=== Select persons by name ===
+
+Now we want to narrow down the list of persons to only those that have "tusi" in their name.
+
+For this we click on the "**add step**" button.
+
+This gives us a second row of query steps with a query type select box.
+
+In the first select box we select "**Attribute (contains normalized)**" to do a search that ignores diacritical marks in arabic transliterations.
+
+Then we get a second select box with the names of all attributes we can search in and a text field for the text we want to search for.
+
+Here we select the attribute "**name_translit**" in the second select box and type "**tusi**" in the text field and click on the "**Submit**" button.
+
+This runs the query to narrow down the list of all persons to only those that have "tusi" in their transliterated name field: