Creating a Domain

With the theme.xslt file complete, we can use RAPPTOR's Administrator GUI to create a new domain.

  • Navigate to the domain management area and enter a suitable name in the "Create Domain" section. Once submitted a new folder will be created under the "domains" directory.
  • Go to the newly created folder and create a file called "fs.manifest". Here's the How To. This is an important file where one specifies the path form of the data source/content.
  • The new domain can be further configured e.g. setting the theme, configuring the fs.manifest and setting the root for your menu structure(option). It is also possible to enter all the domain names your application will respond to when asked by a server, this will be set to "localhost" as standard and can be viewed by typing "localhost:8080" into your browser.



The fs.manifest

This is a basic "fs.manifest" file structure. It describes the file system that will be used in your application. In this case, the real file system is being defined. Two things are needed:

  • The manifest directory, which holds the .manifest(domain configuration information) file.
  • The base directory. This holds the path to the content data for the given application.


<?xml version="1.0" encoding="utf-8" ?>
  <treeprovider-realfs xmlns="rapptor.treestore.treeprovider-realfs">
    <manifest-directory-name>.manifest</manifest-directory-name>
    <base-directory>..\..\..\applications\my_app</base-directory>
  </treeprovider-realfs>

The above path, points to a directory called "applications\my_app". The "applications" directory is used here to separate data relevant to its application. "my_app" is our test folder.


In this example, we show how an ontology could be defined. All the ontology files you need should be include3d between the <ontology-files> tags. The standard node is the location where all uri are organised, that do not fit under the pattern, "My_Schema". That means, all ontologies without the prefix "XXXXX.owl" will be organised under the standard node with the rest will be under "My_Schema".

<?xml version="1.0" encoding="utf-8" ?>
<treeprovider-ontologyfs xmlns="rapptor.treestore.treeprovider-ontologyfs">
  <ontology-files>
    <ontology-file filename="..\..\..\my_schema\ontology\TBC-Ontologies\XXXX.owl" standard-node="My_Standard_Node"/>
  </ontology-files>
  <pattern-directories>
    <pattern-directory pattern="http://www.owl-ontologies.com/XXXXX.owl#" name="My_Schema"/>
  </pattern-directories>
</treeprovider-ontologyfs>

Defining the link to a Database