Linked Data Resources allow you to query API services or SPARQL endpoints. Linked Data Resources support reading JSON, XML, YAML, and raw text.
To add a Linked Data Resource, click 'Add Linked Data Resource'.
To edit an existing Linked Data Resource, click the blue 'edit' button at the relevant Linked Data Resource.
To delete an existing Linked Data Resource, click the red 'del' button at the relevant Linked Data Resource.
|Name||Specify the name of the Linked Data Resource. This name is used to identify the Linked Data Resource.|
|Description||Enter a short description of the Linked Data Resource for your own reference.|
|Protocol||Specify whether the Linked Data Resource will be using API requests, SPARQL queries, or if it is a static link.|
|URL||Enter a URL for the Linked Data Resource (e.g. https://query.wikidata.org/sparql?query=, or https://lobid.org/gnd/).|
|URL Options||Enter URL Options for the specified URL (e.g. '&format=json', or '.json').|
|URL Headers||Enter URL Headers for the request (e.g. 'Authorization' with 'Bearer MyAuthorizationKey').|
|Query||Enter a Query. Use a query you have tested with the API service or SPARQL endpoint. This query should return the identifiers and labels of the data you are interested in. To use this query in as a Linked Data Resource, you can use tags to specify which parts of the query will be changed by the input of the user who uses this Linked Data Resource. A simple SPARQL query like this example: |
Click the green 'test' button to test the Query and to generate a response.
|Response||If the query was successful, the query Response field will be populated with the response of the query.|
Click the green 'use' button to use the response to specify the URI, Label, and Values.
|URI Template||Enter a URI Template to be used to construct the URI in case the URI only returns an identifier (e.g. https://d-nb.info/gnd/[[identifier]]). This setting can be combined with a |
|URI||Select the field in the response that contains the URI. The field selector has to be formatted as a Resource Path and can optionally be processed by a Conversion.|
|Label||Select the field in the response that contains the Label. The field selector has to be formatted as a Resource Path and can optionally be processed by a Conversion.|
|Values||Select additional fields in the response that can be ingested in an Ingestion Process, or that will be shown as Values in the overview of returned External objects. Click the green 'add' button to add additional drop-down menus. Click the red 'del' button to remove empty drop-down menus. The field selector has to be formatted as a Resource Path and can optionally be processed by a Conversion.|