Interface#
For a more user-friendly interaction with the Custodian Ontology, we developed the Custodian Contract Creation Interface: a drag-and-drop playground to create, export and import contracts. Try the interface
In short, you can drag all the elements from the left column to the main canvas on the right. Elements have white dots on either side called “connectors”, which are used to connect elements. To do so, click on one connector and drag it to another one. On the top right you can find a toolbar where you can:
Minimize or maximize nodes
: use this option if your contract interface is getting crowded or you’d like to see more details about each nodeLoad
or save 
a diagram: in order to share progress with a collaborator or simply saving a template, this will turn a diagram into a JSON file and vice versaUse the delete button
to remove all elements and start a new clean canvasExport the contract in JSON-LD
to have an interoperable and machine readable format. This is the format in which the Swiss Data Custodian interacts with contracts.
The code for the Web UI interface can be found here. In case of bugs, feature requests or questions, don’t hesitate to open an issue.
How does the Custodian Contract Creation Interface interact with the Swiss Data Custodian?#
The Custodian Contract Creation Interface can interact with the Swiss Data Custodian as an external application to interactively create contracts. In such cases the drag and drop blocks available in the interface will reflect the content of the host Knowledge Base. Additionally, once contracts have been created, they are sent as requests to the Contract Management System, where they are stored.
In practice the Interface interacts with the Swiss Data Custodian via the Gateway and connects to the http API endpoint of the Contract Management System
What does a skeleton contract look like?#
