schimatos / schimatos.org

A SHACL-based Web-Form Generator for Knowledge Graph Editing

Schímatos

A SHACL-based Web-Form Generator for Knowledge Graph Editing

Knowledge graph creation and maintenance is typically inaccessible to naïve users. One barrier is the paucity of user-friendly publishing tools that separate schema modeling from the data creation.

The Shapes Constraint Language (SHACL) is a W3C standard for validating RDF-based knowledge graphs against a set of conditions provided as shapes. This enables structure, i.e. domain-relevant patterns, to be enforced on data graphs built against pre-defined shapes.

Schímatos is a form-based Web application with which users can create and edit data against such shapes graphs. Forms are generated from and stored as shapes graphs. These graphs may either be handcrafted within the tool (using a form building GUI), assembled by aggregating existing shapes graphs (also available as a GUI), or automatically generated with machine learning techniques.

During data-entry, the tool uses entity relationships and attribute requirements to generate a Web-form for end-users. Attribute constraints are then used to perform client-side validation. Thus, this tool enables end-users to create and edit complex data graphs abstracted in an easy-to-use GUI. Additionally, validation procedures reduce the introduction of erroneous data.

Demo

The demo is currently running at schimatos.github.io. The downloadable distribution is also preconfigured for the demo; it can be run by downloading the distribution and then opening the index.html.

Data entry

To perform data entry on the entity open the sidebar and use the dropdown in the sidebar header to navigate to Target Selections. In this demo, the entity of interest is Sergio José Rodríguez Méndez and so can be found by searching for 'Sergio'. In the dropdown, select wd:Q88056610, this is the identifier for Sergio José Rodríguez Méndez. Once selected, you will see that the value has been automatically entered as the focus of the form. Details about the entity are provided in the sidebar. This can be used to confirm that one is working with the correct entity.

Now use the dropdown in the sidebar header to navigate to SHACL Selections and search for the 'wikidataHumanShapeDemo'; as the label is "Wikidata human shape demo" simply searching for 'human' will return it as a result. Select the shape and click the Apply button to generate the form.

Any values that are already submitted will be prefilled into the form. Note that since multiple users can access the demo; this may either be empty, partially or fully complete depending on what others have submitted. If this is the case you can remove these entries from the database by selecting the x next to the entry. To create more fields in any section click the + button at the top right of the section. To ensure that values are validated and ready for submission, press ENTER after completing a field.

To submit entries, click the Submit button at the bottom of the form. This will submit all entries that have passed validation.

SHACL Creation

Open the SHACL selection panel and search 'human' and select the humanWikidataShape. Repeat this process with 'university' an and select the shape wikidataUniversityTeacher. You should see a screen similar to Select apply to create a form with the merged SHACL constraints. To add the ORCID property, select the add new property path button Then fill out the settings as shown to give it a name and datatype. Press submit to add it to the form. Click the save button at the bottom of the screen to see a screen like From here you can download the shape and add additional annotation such as an rdfs:label and correct naming. The SHACL can then be uploaded to the SHACL store as shown

License

Content submitted to schimatos.org is MIT licensed, as found in the LICENSE.md file.

schimatos.org's Issues

Documentation for local files

Can you provide a documentation or short example of how to use local files in schimatos?

Demo link broken

The link to http://schimatos.github.io/ in the readme file redirects to http://rsmsrv01.nci.org.au:8080/schimatos/, which results in an "unable to connect" error. I am not using a VPN.

Fix VPN connection issues

When we try to connect to triplestores via a VPN we get an ERR_CONNECTION_RESET error

schimatos.org redirects to other sites

Tryied to visit http://schimatos.org/ randomly redirects me to booking.com brandible.de, otto.de and other advertising sites...

does the tool provide functionality to create SHACL shapes from ontology axioms

does the tool provide functionality to create SHACL shapes from ontology axioms

Input type for nested shape subject needs to be IRI

If a nested shape is defined the input type of the form textbox needs to change to a IRI input if properties for that nested entity are defined.

Show handling of unspecified classes and datatypes

When a SHACL constraint does not specify a class or datatype we can infer this from domain/range properties. Currently we are doing this silently. Add a popup to ask users if they want the instance/value to be set with the inferred class/datatype or not.

connecting to local SPARQL endpoint

Could you, if possible, provide documentation for connecting Schimatos with a local triplestore? I would be interested in loading and updating type and SHACL shape stores from the same endpoint via their corresponding named graphs. I have tried adding a new triplestore, filling only the field 'sparql endpoint' with http://localhost:7200/repositories/<repo_name> pointing to the GraphDB sparql endpoint, but no individuals from my repo can be retrieved.

navigation bar: multiple open entities in different tabs

Similar like in a Web browser.

Each tab will have a Web-form based on applied SHACLs for the active entity.

Fix firefox display bug

In Firefox the text describing an entity in the sidebar is overlapped - I think this issue is related to how the browser handles flex-boxes.

I'll resolve this ASAP after my exams (~15 Nov).

File not found error while recompiling

I am able to start the application using npm run client. However, after making any change in the code (e.g. removing a newline), the following error is thrown while recompiling:

ℹ ｢wdm｣: Compiling...
fs.js:646
  return binding.open(pathModule._makeLong(path), stringToFlags(flags), mode);
                 ^

Error: ENOENT: no such file or directory, open 'path_to_schimatos/dist/e6359d3bb586980af860.hot-update.json'
    at Object.fs.openSync (fs.js:646:18)
    at Object.fs.readFileSync (fs.js:551:33)
    at Object.getOwnPropertyNames.forEach.asset (path_to_schimatos/source/node_modules/webpack-war-plugin/dist/WebpackWarPlugin.js:30:37)
    at Array.forEach (<anonymous>)
    at compiler.plugin (path_to_schimatos/source/node_modules/webpack-war-plugin/dist/WebpackWarPlugin.js:28:60)
    at AsyncSeriesHook.eval [as callAsync] (eval at create (path_to_schimatos/source/node_modules/tapable/lib/HookCodeFactory.js:33:10), <anonymous>:7:1)
    at asyncLib.forEachLimit.err (path_to_schimatos/source/node_modules/webpack/lib/Compiler.js:482:27)
    at path_to_schimatos/source/node_modules/neo-async/async.js:2818:7
    at done (path_to_schimatos/source/node_modules/neo-async/async.js:3522:9)
    at AsyncSeriesHook.eval [as callAsync] (eval at create (path_to_schimatos/source/node_modules/tapable/lib/HookCodeFactory.js:33:10), <anonymous>:6:1)

It seems quite unexpected to need a file from dist/ while trying to recompile the code, especially since compilation works in the first place.

Colour bars for violation

Colour bars for violation can be removed and the colours green/yellow/red can be used on the triangle that indicates the violation degree. A tool tip can be included that indicates the level of severity for the property.

Fix Live Version

The live version, which should be available at http://schimatos.github.io/, redirects to http://rsmsrv01.nci.org.au:8080/schimatos/ and returns an error ERR_EMPTY_RESPONSE.

Could you please fix this, thank you!

Simplify the dropdown box for entity/shacl selection

The navigation option and the upload/edit.ttl options could be put in other parts of the user interface to make this dropdown box simpler. The upload SHACL functionality can be added to the form where one can edit SHACL (as accessible from the path symbol) and the navigation can become part of the menu on the left top corner.

SHACL Selection and Target Selection could be renamed to SHACL Search and Entity Search

Default values for regular expressions

Although not supported in SHACL directly, regular expressions should be qualified and one should be able to add a default value and/or suggested value to the SHACL file that is then represented as a greyed out value in the regular expression and/or a tool tip.

Submit selector

Is the submit function working properly? I have configured an item, all configuration areas have a green border, but cannot generate the SHACL code. I toggle the submit button, the button blinks, but no result. What am i doing wrong?