ANDS Vocab Service - AtlasOfLivingAustralia/ala-tern GitHub Wiki

How to publish your vocab on ANDS RVA

Adding vocabulary to the ANDS Research Vocabularies Australia (RVA) can be done through the website (RVA Portal): https://vocabs.ands.org.au/.

Here are the steps:

Create the vocabulary, which can be done either by:
- Using PoolParty (https://documentation.ands.org.au/display/DOC/Creating+a+PoolParty+Concept+Scheme)

Creating your own SKOS vocab file to be processed by SISSVoc which is the backend server of the Linked Data API (http://www.semantic-web-journal.net/system/files/swj880.pdf)

Publish you vocab through RVA Portal (https://documentation.ands.org.au/display/DOC/Publishing+a+non-PoolParty+vocabulary+to+the+RVA+portal) and filling out the form requiring these fields (https://documentation.ands.org.au/display/DOC/Populating+RVA+portal+metadata+fields)

Samples of ALA vocab published on RVA Demo

Here are two samples of the ALA vocabs published on ANDS RVA:

How to use published vocabs in your app

There are two options:

Using widgets: https://demo.ands.org.au/vocabs/vocabs/page/widget_explorer
Using web APIs: https://documentation.ands.org.au/display/DOC/Linked+Data+API

DwC Examples

Here are some API entries for the basisOfRecord vocab:

List of concepts: http://demo.ands.org.au/repository/api/lda/ala/dwc-basis-of-records/1-0/concept.json?_page=0&_pageSize=500
Searching for a concept: http://demo.ands.org.au/repository/api/lda/ala/dwc-basis-of-records/1-0/concept.json?labelcontains=fos&_page=0&_pageSize=500

This returns the terms containing "fos".
Gives the description about the term "FossilSpecimen": http://demo.ands.org.au/repository/api/lda/ala/dwc-basis-of-records/1-0/resource.json?uri=https://ala.org.au/dwc/basisOfRecord/FossilSpecimen

Comments

Sniffing out the JS widget that ANDS provides, the underlying web service being called is https://demo.ands.org.au/vocabs/vocabs/services/vocabs/132/tree with output:

{  
  "status":"OK",
  "message":[  
    {  
      "uri":"https:\/\/ala.org.au\/dwc\/typeStatus\/type",
      "value":"type",
      "child":[  

      ],
      "tip":"<p><b>type<br\/>IRI: <\/b>https:\/\/ala.org.au\/dwc\/typeStatus\/type<br\/><a class=\"pull-right\" target=\"_blank\" href=\"http:\/\/demo.ands.org.au\/repository\/api\/lda\/ala\/ala-typestatus\/1-0\/resource?uri=https:\/\/ala.org.au\/dwc\/typeStatus\/type\">View as linked data<\/a><\/p>",
      "num_child":0
    },
    {  
      "uri":"https:\/\/ala.org.au\/dwc\/typeStatus\/paratype",
      "value":"paratype",
      "child":[  

      ],
      "tip":"<p><b>paratype<br\/>IRI: <\/b>https:\/\/ala.org.au\/dwc\/typeStatus\/paratype<br\/><a class=\"pull-right\" target=\"_blank\" href=\"http:\/\/demo.ands.org.au\/repository\/api\/lda\/ala\/ala-typestatus\/1-0\/resource?uri=https:\/\/ala.org.au\/dwc\/typeStatus\/paratype\">View as linked data<\/a><\/p>",
      "num_child":0
    },
    {  
      "uri":"https:\/\/ala.org.au\/dwc\/typeStatus\/isoneotype",
      "value":"isoneotype",
      "child":[  

      ],
      "tip":"<p><b>isoneotype<br\/>IRI: <\/b>https:\/\/ala.org.au\/dwc\/typeStatus\/isoneotype<br\/><a class=\"pull-right\" target=\"_blank\" href=\"http:\/\/demo.ands.org.au\/repository\/api\/lda\/ala\/ala-typestatus\/1-0\/resource?uri=https:\/\/ala.org.au\/dwc\/typeStatus\/isoneotype\">View as linked data<\/a><\/p>",
      "num_child":0
    },
}