NAME

Catmandu::Store::VIAF - Retrieve items from VIAF

SYNOPSIS

    # From the command line
    $ catmandu export VIAF --id 102333412 to YAML
    ---
    dcterms:identifier: '102333412'
    guid: http://viaf.org/viaf/102333412
    schema:birthDate: 1775-12-16
    schema:deathDate: 1817-07-18
    schema:description: English novelist
    skos:prefLabel: Jane Austen
    ...

    # From a Catmandu Fix
    lookup_in_store(
        objectName,    # objectName is a field containing the VIAF identifier
        VIAF
    )

    # From Perl code
    use Catmandu;

    my $store = Catmandu->store('VIAF')->bag;

    my $item = $store->get('102333412');

    print $item->{'skos:prefLabel'} , "\n";  # Jane Austen

DESCRIPTION

A Catmandu::Store::VIAF is a Perl package that can query the <VIAF|http://viaf.org/> authority file.

This store supports only one method get to retrieve an AAT record by its identifier

CONFIGURATION

lang

The lang parameter is optional and defaults to nl-NL. It sets the language of the returned prefLabel. If no prefLabel for the viaf_id in provided lang exists, the prefLabel for the fallback_lang is used.

fallback_lang

Optional. Default en-US.

METHODS

new(%configuration)

Create a new Catmandu::Store::VIAF

get($id)

Retrieve a VIAF record given an identifier. Returns a record like:

  {
    'dcterms:identifier' => 'The identifier',
    'guid'               => 'The VIAF URL',
    'schema:birthDate'   => 'Birth date, if provided',
    'schema:deathDate'   => 'Death date, if provided',
    'schema:description' => 'Description, if provided',
    'skos:prefLabel'     => 'prefLabel, in lang or fallback_lang'
  }

add()

Not supported

delete()

Not supported

each()

Not supported

AUTHOR

Pieter De Praetere <pieter at packed.be >

COPYRIGHT

Copyright 2017- PACKED vzw

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

Catmandu Catmandu::VIAF Catmandu::Fix::viaf_search Catmandu::Fix::viaf_match

cpanm Catmandu::VIAF

perl -MCPAN -e shell
install Catmandu::VIAF