Mapping the Contributor object from DataCite to Schema.org

[rebeccaringuette]

This issue hosts the development of the mapping from DataCite to Schema.org for the Contributor object. Please ignore mappings to fields in Schema.org that are different than the contributor field. Those will be tackled by the contributor type issue.

First, post the correct DataCite xml where all relevant options have been exhausted. Next, post the mapped schema.org result that aligns with this group's format and validates. Also add any modifications needed to the mapping. Then, iterate with those interested towards a final result.

[rebeccaringuette]

Starting XML:

<contributors>
    <contributor contributorType="DataCollector">
        <contributorName nameType="Personal">Garcia, Sofia</contributorName>
        <givenName>Sofia</givenName>
        <familyName>Garcia</familyName>
        <nameIdentifier schemeURI="https://orcid.org/" nameIdentifierScheme="ORCID">0000-0001-5727-2427</nameIdentifier>
        <affiliation affiliationIdentifier="https://ror.org/03efmqc40" affiliationIdentifierScheme="ROR" schemeURI="https://ror.org">Arizona State University</affiliation>
    </contributor>
    <contributor contributorType="HostingInstitution">
        <contributorName xml:lang="en" nameType="Organizational">California Digital Library</contributorName>
        <nameIdentifier schemeURI="https://ror.org/" nameIdentifierScheme="ROR">https://ror.org/03yrm5c26</nameIdentifier>
    </contributor>
</contributors>

What would a contributorType of "Other" look like?

[rebeccaringuette]

DataCite requires a contributorType for each entry of Contributor, and requires that it be from their controlled list. So, there should never be a situation where there is no role for a Contributor. The potential complication is the structure of the "Other" contributorType, which (I think) allows free text in the field. Will need iteration on this through DataCite's validation services.

Proposed schema.org output:

{
   "@context": {
      "@vocab": "https://schema.org/"
   },
   "@type": "Dataset",
   "contributor": {
      "@list": [
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#datacollector",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@id": "https://orcid.org/0000-0001-5727-2427",
            	"@type": "Person",
            	"affiliation": {
               		"@id": "https://ror.org/03efmqc40",
               		"@type": "Organization",
               		"identifier": {
                  		"@id": "https://ror.org/03efmqc40",
                  		"@type": "PropertyValue",
                  		"propertyID": "https://registry.identifiers.org/registry/ror",
                  		"url": "https://ror.org/03efmqc40",
                  		"value": "ror:03efmqc40"
               		},
               		"name": "Arizona State University"
            	},
            	"familyName": "Garcia",
            	"givenName": "Sofia",
            	"identifier": {
               		"@id": "https://orcid.org/0000-0001-5727-2427",
               		"@type": "PropertyValue",
               		"propertyID": "https://registry.identifiers.org/registry/orcid",
               		"url": "https://orcid.org/0000-0001-5727-2427",
               		"value": "orcid:0000-0001-5727-2427"
            	},            
            	"name": "Garcia, Sofie"
         	},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "DataCollector",
            "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#datacollector"
         },
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#hostinginstitution",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@id": "https://ror.org/03yrm5c26",
            	"@type": "Organization",
            	"identifier": {
               		"@id": "https://ror.org/03yrm5c26",
               		"@type": "PropertyValue",
               		"propertyID": "https://registry.identifiers.org/registry/ror",
               		"url": "https://ror.org/03yrm5c26",
               		"value": "ror:03yrm5c26"
            	},
            	"name": "California Digital Library"
         	},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "HostingInstitution",
            "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#hostinginstitution"
         }
      ]
   }
}

[rebeccaringuette]

The discussion should include how to represent when a person or organization holds multiple roles. For mapping from DataCite, the roles will always have identifiers, but the people and organizations may not.
#260

Proposed schema.org output where the person / organization identifiers are included so that the contributor's identifier can simply be referenced in the new role object:

{
   "@context": {
      "@vocab": "https://schema.org/"
   },
   "@type": "Dataset",
   "contributor": {
      "@list": [
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#datacollector",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@id": "https://orcid.org/0000-0001-5727-2427",
            	"@type": "Person",
            	"affiliation": {
               		"@id": "https://ror.org/03efmqc40",
               		"@type": "Organization",
               		"identifier": {
                  		"@id": "https://ror.org/03efmqc40",
                  		"@type": "PropertyValue",
                  		"propertyID": "https://registry.identifiers.org/registry/ror",
                  		"url": "https://ror.org/03efmqc40",
                  		"value": "ror:03efmqc40"
               		},
               		"name": "Arizona State University"
            	},
            	"familyName": "Garcia",
            	"givenName": "Sofia",
            	"identifier": {
               		"@id": "https://orcid.org/0000-0001-5727-2427",
               		"@type": "PropertyValue",
               		"propertyID": "https://registry.identifiers.org/registry/orcid",
               		"url": "https://orcid.org/0000-0001-5727-2427",
               		"value": "orcid:0000-0001-5727-2427"
            	},            
            	"name": "Garcia, Sofie"
         	},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "DataCollector"
         },
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#projectleader",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {"@id": "https://orcid.org/0000-0001-5727-2427"},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "ProjectLeader"            
         },	
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#hostinginstitution",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@id": "https://ror.org/03yrm5c26",
            	"@type": "Organization",
            	"identifier": {
               		"@id": "https://ror.org/03yrm5c26",
               		"@type": "PropertyValue",
               		"propertyID": "https://registry.identifiers.org/registry/ror",
               		"url": "https://ror.org/03yrm5c26",
               		"value": "ror:03yrm5c26"
            	},
            	"name": "California Digital Library"
         	},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "HostingInstitution"
         },
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#distributor",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {"@id": "https://ror.org/03yrm5c26"},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "Distributor"            
         }         
      ]
   }
}

Proposed schema.org output where the person or organization identifiers are not known, taking the worst case scenario where only the names and types are known, meaning the contributor object must be repeated in subsequent role objects:

{
   "@context": {
      "@vocab": "https://schema.org/"
   },
   "@type": "Dataset",
   "contributor": {
      "@list": [
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#datacollector",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@type": "Person",
            	"name": "Garcia, Sofie"
         	},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "DataCollector",
            "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#datacollector"
         },
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#projectleader",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@type": "Person",
                "name": "Garcia, Sofie"
            },
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet"
            },
            "roleName": "ProjectLeader",
            "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#projectleader"
         },	
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#hostinginstitution",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@type": "Organization",
            	"name": "California Digital Library"
         	},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet",
               "name": "contributorType",
               "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/"
            },
            "roleName": "HostingInstitution",
            "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#hostinginstitution"
         },
         {
            "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#distributor",
            "@type": [
               "Role",
               "DefinedTerm"
            ],
            "contributor": {
            	"@type": "Organization",
            	"name": "California Digital Library"
         	},
            "inDefinedTermSet": {
               "@id": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/",
               "@type": "DefinedTermSet"
            },
            "roleName": "Distributor",
            "url": "https://datacite-metadata-schema.readthedocs.io/en/4.6/appendices/appendix-1/contributorType/#distributor"
         }         
      ]
   }
}