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.