Daily Archives: February 23, 2013

A CERIF-XML Person Record + Vocab

Leave a reply

The subsequent XML describes a valid person record in CERIF-XML embedding two federated identifier types – namely ORCID and an example HESA Staff Identifier. Furthermore, it gives two relationships to organisations, namely UKOLN via the role “Employee” and euroCRIS via the role “Board Member”. Whereas the role “Employee” is a term already defined in the CERIF Vocabulary, i.e. maintaining a UUID, the role “Board Member” is not a defined term in the CERIF Vocabulary and thus uses proprietary ID encoding.

<?xml version="1.0" encoding="UTF-8"?>
<CERIF xmlns="urn:xmlns:org:eurocris:cerif-1.5-1" xsi:schemaLocation="urn:xmlns:org:eurocris:cerif-1.5-1 http://www.eurocris.org/Uploads/Web%20pages/CERIF-1.5/CERIF_1.5_1.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" release="1.5" date="2013-02-23" sourceDatabase="Brigitte Jörg">
<!-- A person record embedding federated identifiers and links to organisation records -->
<cfPers>
  <cfPersId>internal-pers-id-brigitte-joerg</cfPersId>
  <cfGender>f</cfGender>
  <cfPersName_Pers>
    <cfPersNameId>internal-persname-id-brigitte-joerg</cfPersNameId>
    <cfClassId>64f0eb00-462d-4737-8033-7efac82decf3</cfClassId> <!-- Passport Name -->
    <cfClassSchemeId>7375609d-cfa6-45ce-a803-75de69abe21f</cfClassSchemeId> <!-- Person Names -->
    <cfFamilyNames>Jörg</cfFamilyNames>
    <cfFirstNames>Brigitte</cfFirstNames>
  </cfPersName_Pers>
  <cfFedId>
    <cfFedIdId>internal-fed-id1-brigitte-joerg</cfFedIdId>
    <cfFedId>http://orcid.org/0000-0001-7941-8108</cfFedId> <!-- Brigitte Jörg's ORCID -->
    <cfFedId_Class>
        <cfClassId>716bcc9a-c9dd-4b8b-b4ab-6c140e578ec3</cfClassId> <!-- the "ORCID" term's uuid in the CERIF Vocabulary -->
        <cfClassSchemeId>bccb3266-689d-4740-a039-c96594b4d916</cfClassSchemeId> <!-- Identifier Types Scheme -->
    </cfFedId_Class>
  </cfFedId>
  <cfFedId>
    <cfFedIdId>internal-fed-id2-brigitte-joerg</cfFedIdId>
    <cfFedId>012345678910111213</cfFedId> <!-- Brigitte Jörg's fictitious HESA staff identifier -->
    <cfFedId_Class>
        <cfClassId>716bcc9a-c9dd-4b8b-b4ab-6c140e578ec3</cfClassId> <!-- the HESA "STAFFID" term's uuid -->
        <cfClassSchemeId>bccb3266-689d-4740-a039-c96594b4d916</cfClassSchemeId>
    </cfFedId_Class>
  </cfFedId>
  <cfPers_OrgUnit>
    <cfOrgUnitId>internal-orgunit-id-ukoln</cfOrgUnitId>
    <cfClassId>c302c2f0-1cd7-11e1-8bc2-0800200c9a66</cfClassId> <!-- Employee -->
    <cfClassSchemeId>994069a0-1cd6-11e1-8bc2-0800200c9a66</cfClassSchemeId>
    <cfStartDate>2012-06-01T00:00:00</cfStartDate>
  </cfPers_OrgUnit>
  <cfPers_OrgUnit>
    <cfOrgUnitId>internal-orgunit-id-euroCRIS</cfOrgUnitId>
    <cfClassId>board-member-term-id</cfClassId> <!-- not yet a released CERIF term -->
    <cfClassSchemeId>possibly-person-organisation-roles-scheme-id</cfClassSchemeId>
    <cfStartDate>2005-01-01T00:00:00</cfStartDate>
  </cfPers_OrgUnit>
</cfPers>

<!-- The vocabulary defining the person record via CERIF Semantic Layer -->
<cfClassScheme>
  <cfClassSchemeId>7375609d-cfa6-45ce-a803-75de69abe21f</cfClassSchemeId>
  <cfName cfLangCode="en" cfTrans="o">Person Names</cfName>
  <cfClass>
    <cfClassId>64f0eb00-462d-4737-8033-7efac82decf3</cfClassId>
    <cfTerm cfLangCode="en" cfTrans="o">Passport Name</cfTerm>
    <cfDescr cfLangCode="en" cfTrans="o">The name of the person as printed in the passport.</cfDescr>
  </cfClass>
</cfClassScheme>
<cfClassScheme>
  <cfClassSchemeId>bccb3266-689d-4740-a039-c96594b4d916</cfClassSchemeId>
  <cfName cfLangCode="en" cfTrans="o">Identifier Types</cfName>
  <cfClass>
    <cfClassId>c0071785-549a-4379-a2af-d9a978ea3a1e</cfClassId>
    <cfTerm cfLangCode="en" cfTrans="o">STAFFID</cfTerm>
    <cfDescr cfLangCode="en" cfTrans="o">The Staff identifier is a unique code allocated to a staff member when they are first entered onto the staff record and, where a member of staff is contracted to work in jobs classified in SOC groups 1,2 or 3, it stays with them for the whole of their career within HE.</cfDescr>
    <cfDescrSrc cfLangCode="en" cfTrans="o">http://www.hesa.ac.uk/component/option,com_collns/task,show_manuals/Itemid,233/r,08025/f,003/</cfDescrSrc>
  </cfClass>
  <cfClass>
    <cfClassId>716bcc9a-c9dd-4b8b-b4ab-6c140e578ec3</cfClassId> 
    <cfTerm cfLangCode="en" cfTrans="o">ORCID</cfTerm>
    <cfDescr cfLangCode="en" cfTrans="o">ORCID provides a persistent digital identifier that distinguishes you from every other researcher and, through integration in key research workflows such as manuscript and grant submission, supports automated linkages between you and your professional activities ensuring that your work is recognized.</cfDescr>
    <cfDescrSrc cfLangCode="en" cfTrans="o">http://about.orcid.org</cfDescrSrc>
  </cfClass>
</cfClassScheme>
<cfClassScheme>
  <cfClassSchemeId>994069a0-1cd6-11e1-8bc2-0800200c9a66</cfClassSchemeId>
  <cfName cfLangCode="en" cfTrans="o">Person Organisation Roles</cfName>
  <cfClass>
    <cfClassId>c302c2f0-1cd7-11e1-8bc2-0800200c9a66</cfClassId>
    <cfTerm cfLangCode="en" cfTrans="o">Employee</cfTerm>
    <cfDescr  cfLangCode="en" cfTrans="o">A worker who is hired to perform a job.</cfDescr>
    <cfDescrSrc cfLangCode="en" cfTrans="o">http://wordnetweb.princeton.edu/perl/webwn?s=Employee</cfDescrSrc>
  </cfClass>
</cfClassScheme>
</CERIF>

It is not necessarily required for exchanging information, that the vocabulary as defined in CERIF Semantic Layer format is embedded in the .xml file, if it can be expected that the CERIF vocabulary (UUIDs) are known by the receiving or sending agent.

The file is valid according to the released CERIF 1.5 XML Scheme. This however does not consider checking of valid cfClassIds, i.e. the validity of the employed vocabulary. If that is a requirement, an application specific CERIF 1.5 XML Scheme can be generated via the CERIF-TG-Toolbox deployed at Sourceforge to ensure that only a pre-defined controlled vocabulary is valid.