---
name: "Catmandu::Fix::viaf_match"
section: "3pm"
platform: "linux"
package: "libcatmandu-viaf-perl"
version: "0.05-2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Catmandu::Fix::viaf_match"
---

# Catmandu::Fix::viaf\_match(3pm)

Perform a direct match between a name and a mainHeadingEl from VIAF

## NAME

Catmandu::Fix::viaf\_match - Perform a direct match between a name and a mainHeadingEl from VIAF

## SYNOPSIS

```
  viaf_match(authorName, -lang:'nl-NL', -fallback_lang:'en-US')
```

## DESCRIPTION

Perform a direct match between a name and a *mainHeadingEl* and the *local.personalNames* of a *Person* in VIAF. The fix will return the *prefLabel* in the provided `"lang"`, or `"fallback_lang"` if one in `"lang"` does not exist. If `"fallback_lang"` also doesn't exist, the *prefLabel* will be empty.

Returns the following data:

```
  {
    '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'
  }
```

### PARAMETERS

*Required parameters*

- "path"

  Path to the name.

*Optional parameters*

- "lang"

  Language of the returned `"skos:prefLabel"`. Falls back to `"fallback_lang"` if none was found. Use IETF language tags \<https://en.wikipedia.org/wiki/IETF\_language\_tag\>.

- "fallback\_lang"

  Fallback language.

## 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::Store::VIAF Catmandu::Fix::viaf\_search