Add How to section to Readme

furti · Jan 19, 2019 · f42915b · f42915b
1 parent bba4abe
commit f42915b
Show file tree

Hide file tree

Showing 3 changed files with 36 additions and 0 deletions.
diff --git a/Documentation/Howto/Arch/get_number_of_objects_by_role.md b/Documentation/Howto/Arch/get_number_of_objects_by_role.md
@@ -0,0 +1,22 @@
+# How to get a list of arch objects by role
+
+Add the following statement to the Report
+
+```sql
+Select IfcRole, Count(*)
+From document 
+Group by IfcRole;
+```
+
+And you will get a Result like this
+
+![Result](./get_number_of_objects_by_role_result.png)
+
+There is a empty entry in the list. This is because some objects like Sketches or Groups don't have a IfcRole attribute. We can filter them out easily by changing the query to this
+
+```sql
+Select IfcRole, Count(*)
+From document 
+Where IfcRole IS NOT NULL
+Group by IfcRole;
+```
diff --git a/Documentation/Howto/Arch/get_number_of_objects_by_role_result.png b/Documentation/Howto/Arch/get_number_of_objects_by_role_result.png
diff --git a/README.md b/README.md
@@ -99,6 +99,20 @@ more...
     comming soon...
 </details>
 
+## How To...
+
+<details>
+<summary>
+Check this section for a list of common sql queries.
+
+more...
+</summary>
+
+### Architecture
+[... get a list of arch objects by role](./Documentation/Howto/Arch/get_number_of_objects_by_role.md)
+
+</details>
+
 ## SQL Reference
 
 <details>