2 Uploading a specification
In order to begin mapping a specification, different steps are involved.
The user can start by pressing the "Map a Specification" button at the top navigation bar (or the one that says "Start Mapping").
A few data is asked about the specification to be uploaded. First, a name, a version and use case (both not mandatory), and a domain.
The list of domains to be selected, depends on the skos file placed on the concepts directory with the name ending on ...abstractClasses.json. By default, the tool provides a file called desmAbstractClasses.json with the domains as listed in the image above.
The tool supports RDF, JSON, XML or JSONLD formats. The user can either upload a single file or multiple at once. Each time the browse button is clicked, the already attached files are replaced by the new ones.
Once the files are selected, the user can preview the details to validate these are the intended ones:
A rounded orange button with a right arrow appears to lead the user to process the file. Once the button is clicked, the tool will perform a few processes in order to find out if there are more than one only rdfs:Class in the selected file/s. If it's so, it will prompt to select one or more of these classes.
It may be the case only 1 domain was found in the file/s. In that case, the next step will be directly performed.
The tool then will perform the filtering of the original detected properties and classes found in the uploaded file/s to generate a preview with only those properties that are related to the classes the user selected.
Then a preview will appear to let the user approve or re-import if necessary. This is a previous step to actually store the specification to the tool's records.
In the image above there's a second tab with a Vocabulary. That's because a file may contain concepts alongside with the classes and properties of the graph, and the tool will also recognize it and put it in the correct concept scheme to organize it and let the user choice whether to keep or discard it.
If some vocabulary information is missing and it's necessary to upload a separated file, or fetch it by URL, it can be achieved by pressing the label Add Vocabulary.
Now the tool will process the file to create the specification. If the specification is the first to be linked to the selected domain (See The available domains) it will be marked as the spine for that domain, so forward specifications will map to it. This is how the recent uploaded spine specification would look like:
