.. include:: /includes.rst.txt

.. comments - headings

   # with overline, for parts
   * with overline, for chapters
   = for sections
   - for subsections
   ^ for subsubsections
   " for paragraphs
   * for H5
   + for H6

.. _faqs:

****
FAQs
****

Ontologies
==========

.. raw:: html

   <details>
   <summary><a>Are all newly created classes also node shapes?</a></summary>

|

   **Yes, EDG will make every new class a node shape.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>What if I have a pre-existing class that is not a shape? How to make it a shape?</a></summary>

|

   **Click on Modify menu and select Enable SHACL constraints.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>How do I add properties to a class?</a></summary>

|

  **Select a class:**
   
   * **use the “+” icon in the class form – next to declared properties field OR**

   * **use Create icons in the Property Groups panel**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>Can I “base” a class on another class (or a node shape on another shape)?</a></summary>

|

   * **Yes, you can. You can clone a class or a node shape. 
     However, property shapes will not be cloned. Properties shapes associated with class 1 will be associated with class 2.**

   * **If you want to create new property shapes for your new class, use Modify menu, then Clone property shapes from …. You can even get some properties from Wikidata.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>Can I create OWL restrictions and other class axioms?</a></summary>

|

   **Yes, for certain fields on the classes form, you can switch to the OWL Manchester Syntax editor.**

   **You can also use the source code panel.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>Can I create node shapes that are not classes? Why would I do this?</a></summary>

|

   **Yes, you can. Use Create button on the Node Shapes panel. There are several reasons to do this. For example:**

   * **You may want to define a different alternative view on instances of a class. 
     You can create node shapes, explicitly target a class and associate these views with governance roles.**

   * **You may need to use a different target than members of a given class.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>What happens with instances if a class is deleted?</a></summary>

|

   **They remain. Delete instances before deleting classes.**
   **Instances are typically in another asset collection.** 
   **Use Explore menu Find Usages in Other Asset Collections…**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>How do I change the rdfs:subClassOf relationship?</a></summary>

|

   **You can use drag and drop to re-arrange class hierarchy.**

   **If you want to have multiple parent classes, then use the class form and edit superclasses field.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>What happens to the child classes when a parent is deleted?</a></summary>

|

   **To also delete subclasses, use Delete with subclasses.**

   **If a class has no parents, you will no see it in the Class Hierarchy panel.**
   **But you will see it in the Class List panel and will be able to navigate to it using navigation options.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>How do I see all properties associated with a class?</a></summary>

|

   **If they are associated via shapes, on the class form or in the Property Groups panel.**

   **If they are associated only using RDFS domain/range or OWL restrictions, use References panel.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>I have ontology in RDFS/OWL, how do I create shape declarations from it?</a></summary>

|

   **Go to Transform tab > Convert OWL Axioms to SHACL Constraints.**

.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>Can I annotate classes using properties that are not shown on the class form?</a></summary>

|

   **Yes, you can.** 
   **Source code is always an option.** 
   **You can also get new fields to show up on forms, if you tell EDG that you want to use additional properties to describe classes (or properties or other schema resources).** 
   **There are two ways of doing this:**

   **Option 1**

   **Create a new node shape, make Class its target.**

   **Add to it properties you want to use e.g., skos:definition.**

   **On the class forms, you will now have a drop down to switch from the regular view to a view that lets you see and edit your additional annotations.**

   **Option 2**

   **Modify the default system forms for classes that are defined in metash.ttl by injected extra fields into them.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>Can a SPARQL query reference a resource that is selected in the form panel?</a></summary>

|

   **Yes, by using $this in a SPARQL query, you can reference resources that you currently have selected in the form panel. For example:**

   .. code::

     SELECT *
     WHERE {
     $this ?p ?o
     }


.. raw:: html

   </details>

.. ---------------

|
|

Administration
==============

.. ---------------

.. raw:: html

   <details>
   <summary><a>Can I use MariaDB as a database type?</a></summary>

|

   **Yes, with a caveat that it requires a workaround.**  
   **You will need to set databaseMetaData.getDatabaseProductName to return true.** 
   **For example mysql://localhost:3306/edg?useMysqlMetadata=true.**


.. raw:: html

   </details>

.. ---------------

.. raw:: html

   <details>
   <summary><a>I'm getting errors about .lock files in my logs?</a></summary>

|

   **To clear this issue, you will need to shut down tomcat and remove the *.lock files.** 
   **Once tomcat is fully shut down, navigate to the root of your workspace in a terminal then issue the following.**

   **View all lock files:**

   .. code::

     $ find . -name tdb.lock -execdir ls – ‘{}’
     ;

   **Recursively remove all lock files:**

   .. code::

     $ find . -name tdb.lock -execdir rm – ‘{}’
     ;

   **Once all the lock files are removed, you should be able to safely start tomcat back up.**


.. raw:: html

   </details>

.. ---------------

|
|