Skip to content

Setting FCS Resources

Eliza Margaretha Illig edited this page Jun 4, 2025 · 2 revisions

** WARNING: The required format is unstable and can be changed at any time without a prior notice.

Resources and virtual corpora (VC) provided for CLARIN Federated Content Search (FCS) must be listed in a resources.json file. The file must be located at the data folder. By default, Kustvakt uses the resources.json file at /src/main/resources/data.

Required format

Property Required Description Example
id yes The resource or VC identifier must contain at least 3 characters. It will be stored in the query database table and is used as a reference to a VC, for instance when searching on a specific VC. WPD17
pid yes Ideally the persistent identifier link of a resource stored in a repository. It is required to describe a resource or a match in FCS. http://hdl.handle.net/10932/00-03B6-558F-4E10-6201-1
de_title no The resource or VC name in German. Deutsche Wikipedia Artikel 2017
en_title yes The resource or VC name in English. German Wikipedia Articles 2017
en_description no The description of the resource or VC in English. A collection of articles of German Wikipedia from July 1st, 2017.
layers yes The annotation layers available for the resource or VC in KorAP. ["corenlp/p","marmot/m","marmot/p", "opennlp/p","tt/l","tt/p"]
corpus_query yes The resource or VC definition by metadata filtering. corpusSigle=WPD17
required_access no The permission level required to access a resource or VC. Kustvakt can determine the required access using the corpus_query. FREE, PUB, or ALL
institution no The name of the institution that has built or owns the resource. IDS Mannheim

Example

[{
    "id": "WPD17",
    "pid": "http://hdl.handle.net/10932/00-03B6-558F-4E10-6201-1",
    "de_title" : "Deutsche Wikipedia Artikel 2017",
    "en_title" : "German Wikipedia Articles 2017",
    "en_description" : "A collection of articles of German Wikipedia from July 1st, 2017.",
    "layers": [
        "corenlp/p",
        "marmot/m",
        "marmot/p",
        "opennlp/p",
        "tt/l",
        "tt/p"
    ],
    "corpus_query":"corpusSigle=WPD17",
    "required_access" : "FREE",
    "institution" : "IDS Mannheim"
},
{
        "id": "Romane",
        "pid": "Romane",
        "en_title": "Roman",
        "layers": [
            "corenlp/p",
            "marmot/m",
            "marmot/p",
            "opennlp/p",
            "tt/l",
            "tt/p"
        ],
        "corpus_query": "textType = /.*[Rr]oman/",        
    }
]

Advanced Setting

Developer Setting

Search services

Metadata services

Authentication and Authorization services

Client services

Super client services

Plugin services

User services

User group services

Virtual corpus (VC) services

VC sharing services

Administrative services

Description services

Clone this wiki locally