/ 
Catmandu-LIDO-0.10
River stage one • 1 direct dependent • 6 total dependents
++
 / Catmandu::Fix::lido_actor

NAME

Catmandu::Fix::lido_actor - create a LIDO actorInRole node at a specified path

SYNOPSIS

    lido_actor(
        path,
        id,
        name,
        -name_lang:      name.lang,
        -name_pref:      name.pref,
        -id_label:       actorID.label,
        -id_source:      actorID.source,
        -id_type:        actorID.type,
        -nationality:    nationalityActor,
        -birthdate:      vitalDatesActor.earliestDate,
        -deathdate:      vitalDatesActor.latestDate,
        -role:           roleActor.term,
        -role_id:        roleActor.conceptID,
        -role_id_type:   roleActor.conceptID.type,
        -role_id_source: roleActor.conceptID.source,
        -qualifier:      attributionQualifierActor
    )

DESCRIPTION

lido_actor() will create an actorInRole node in the path specified by the path parameter.

PARAMETERS

Required parameters

It requires the parameters path, id and name to be present as paths.

path
id
name

Optional parameters

The following parameters are optional, but must be paths:

nationality
birthdate
deathdate
role
role_id
qualifier

All other optional parameters are strings:

id_label
id_source
id_type (Required if id is set.)
role_id_type
role_id_source

MULTIPLE INSTANCES

Multiple instances can be created by appending $append to the path. This will create a new actorInRole tag for every instance. While it is possible to create a single actorInRole for multiple actors, this is not permitted by the LIDO standard.

EXAMPLE

Fix

    lido_actor(
        descriptiveMetadata.eventWrap.eventSet.$last.event.eventActor,
        recordList.record.creator.id,
        recordList.record.creator.name,
        -id_label: 'priref',
        -id_type: 'local',
        -id_source: 'Adlib'
        -nationality: recordList.record.creator.nationality,
        -birthdate: recordList.record.creator.date_of_birth,
        -deathdate: recordList.record.creator.date_of_death,
        -role: recordList.record.role.name,
        -role_id: recordList.record.role.id,
        -role_id_type: 'global',
        -role_id_source: 'AAT',
        -qualifier: recordList.record.role.name
    )

Result

    <lido:descriptiveMetadata>
        <lido:eventWrap>
            <lido:eventSet>
                <lido:event>
                    <lido:eventActor>
                        <lido:actorInRole>
                            <lido:actor>
                                <lido:actorID lido:label="priref" lido:type="local" lido:source="Adlib">123</lido:actorID>
                                <lido:nameActorSet>
                                    <lido:appellationValue>Jonghe, Jan Baptiste De</lido:appellationValue>
                                </lido:nameActorSet>
                                <lido:nationalityActor>
                                    <lido:term>Belgisch</lido:term>
                                </lido:nationalityActor>
                                <lido:vitalDatesActor>
                                    <lido:earliestDate>1750</lido:earliestDate>
                                    <lido:latestDate>1821</lido:latestDate>
                                </lido:vitalDatesActor>
                            </lido:actor>
                            <lido:roleActor>
                                <lido:conceptID lido:type="global" lido:source="AAT">123</lido:conceptID>
                                <lido:term>Creator</lido:term>
                            </lido:roleActor>
                            <lido:attributionQualifierActor>Created</lido:attributionQualifierActor>
                        </lido:actorInRole>
                    </lido:eventActor>
                </lido:event>
            </lido:eventSet>
        </lido:eventWrap>
    </lido:descriptiveMetadata>

SEE ALSO

Catmandu::LIDO and Catmandu

AUTHORS

Pieter De Praetere, pieter at packed.be

CONTRIBUTORS

Pieter De Praetere, pieter at packed.be
Matthias Vandermaesen, matthias.vandermaesen at vlaamsekunstcollectie.be

COPYRIGHT AND LICENSE

The Perl software is copyright (c) 2016 by PACKED vzw and VKC vzw. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.