Helpful tips:
Remember to turn on the xampp server by executing xampp_start.exe
Also, note that XAMPP uses Apache over port 80 so open that port if you are on your own
computer and behind a firewall. Additionally, the Apache portion of XAMPP only hosts the php
files; it does not extract any data nor does it work without the WoK-HD server running in the
background.
The Query tab is located under the Tabs menu in the Ontology Workbench and is the interface
used for the SPARQL query / RDF portion of the project.
The WoK-HD server uses local port 7585.
Only access the WoK-HD server through the HyKSS interface provided via the php files
included in WoK-HD packet.zip and access it through the address – http://127.0.0.1
Remember that the HyKSS interface is only an interface and requires that the WoK-HD server
be running in the background
In order for the WoK-HD server to run, all three fields must be filled correctly:
Document Collection
Ontology Library
Query Ontology Library
Output Folder
Also, you must either click on the Index + Run button or the Run button (having previously
indexed) in order for the WoK-HD to process queries. You do not need to run the WoK-HD to
process SPARQL queries using the Query tab.
The WoK-HD server creates a file called WoKHD.cfg that stores the paths to your document
collection, ontology library, and output folder. It is overwritten only when you press the Index +
Run button or the Run button.
The DataFrame Editor for object sets is accessible in the Ontology Editor under the Tools menu
item. This is where the value phrases and keyword phrases are found. Modify the value phrases
in order to extract data. Modify the keyword phrases to allow querying over the data using
keywords such as “born” or “died”
The Lexicon Editor is found as a tab within the DataFrame Editor for object sets and is used to
reference dictionaries. They are referenced by their Label such as {FirstName} where Label =
FirstName (without curly braces).
Be sure that there is an actual dictionary to reference or the program will break.
The php code was established to work on the BYU CS lab computers. If you are running on
your own computer and get an error related to resultsui.php you'll need to change this line:
$socket = fsockopen($_SERVER['REMOTE_ADDR'], PORT);
to this:
$socket = fsockopen("127.0.0.1", PORT);
If you've been having trouble with queries using the HyKSS interface and having the SPARQL
queries not show up in the WoK-HD interface, please check the following:
1. Make sure that your relationship sets don't have keyword phrases - they currently aren't
implemented.
2. Be sure that your Birthdate object set and Deathdate object set do have keyword phrases BUT
not under the value phrases.
3. Make sure that the Birthdate object set AND the Deathdate object set both have dataframes
with at least one value phrase before trying to query over the data. For some reason the
intermediate XML file doesn't turn out right if you don't.
4. The Name object set DOES NOT need keyword phrases.
5. The Person-Name relationship set does not need a dataframe.
See the picture below for keyword phrase placement.
One of the features not mentioned but may be useful is the left context field for value phrases.
Note: When using this feature, know that it will append the value phrase expression directly onto
the left context regex when identifying potential matches. So, don’t forget about word
boundaries and/or white space characters.