Changes between Version 5 and Version 6 of query_builder_doc

Timestamp:

Feb 3, 2016, 6:14:57 PM (8 years ago)

Author:

casties

Comment:

--

query_builder_doc

@@ -1 @@
-
-== Query Builder tool ==
+= Query Builder tool =
 
 You can find the Query Builder tool online at 
@@ -6 +5 @@
 https://ismi-dev.mpiwg-berlin.mpg.de/static-ismi/ng2-query-builder/index.html
 
-== Example query ==
+= Example query =
 
 In this simple example we will find all witnesses of titles by Nasir al-Din al-Tusi.
 
-=== Start ===
+== Start ==
 
 The tool starts with an option to select the first query step:
@@ -20 +19 @@
  * "**object ID is**" to select one object with a certain ISMI_ID e.g. 47316 for Tusi
 
-=== Show all persons ===
+== 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.
@@ -32 +31 @@
 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 ===
+== Select persons by name ==
 
 Now we want to narrow down the list of persons to only those that have "tusi" in their name.
@@ -60 +59 @@
 In the table we find the row containing Abū Jaʿfar Naṣīr al-Dīn Muḥammad ibn Muḥammad ibn al-Ḥasan al-Ṭūsī and we note that the corresponding ismi_id is 47316.
 
-=== Select objects by ID ===
+== Select objects by ID ==
 
 Now we click "**add step**" again to add another step to select only Nasir al-Din al-Tusi to find only his works.
@@ -69 +68 @@
 
 [[Image(qb-person-tusi-id.png)]]
+
+Under "Query result" we see that now only 1 PERSON object is selected.
+
+== Select texts written by a person ==
+
+Now we click "**add step**" again to add another step to select all texts written by Tusi.
+
+In the first select box we select "**Relation type is**".
+
+In the second select box we get a list of all relations of the Tusi object in the database like "is_alias_name_of" or "was_born_in".
+
+You will note that all relation types show up in the list a second time prefixed with "<-". These are the reverse relations. These are needed because the relations are directed and you have to select the direction of the relation. 
+
+The "normal" relation is read from the last selected object, in this case a PERSON to the next possible objects. To find the birthplace of the PERSON you would select "**was_born_in**" and you would get the relation `PERSON-[was_born_in]->PLACE` going from a PERSON to a PLACE.
+
+To get the texts written by Tusi we need the relation `TEXT-[was_created_by]->PERSON` which goes from a TEXT to a PERSON. But in our case we want to start at the PERSON not the TEXT so we have to select the reverse relation "**<- was_created_by**".
+
+When we select "**<- was_created_by**" in the second select box the system runs the query to find all texts that were created by Tusi:
+
+[[Image(qb-person-tusi-id-created.png)]]
+