ISO19115-3 / Formatter / Datacite (#9191)

* ISO19115-3 / Formatter / Datacite

* Update to version 4.6 and more complete mapping.

* ISO19115-3 / From Datacite conversion.

* ISO19115-3 / Formatter / Citation / Add withAffiliation parameter and add co-authors.

* ISO19115-3 / From Datacite conversion / Add more example of resource type and add some more mapping values.

* ISO19115-3 / Formatter / Citation / Improve affiliation output.

* ISO19115-3 / Formatter / Datacite / Comment datacite value having no ISO mapping.

Author: fxprunayre

docs/manual/docs/user-guide/associating-resources/cite.md

@@ -10,7 +10,14 @@ The citation can be use to cite a dataset in publications.
 
 The citation generated by default follows general conventions on how to cite a dataset but can be customized.
 
-The default is: * list of authors (and organisation) * publication year * title * list of publisher * DOI URL or landing page URL.
+The default is:
+
+* list of authors, co-author (and organisation) 
+* publication year 
+* title 
+* list of publisher 
+* DOI URL or landing page URL.
+
 
 These are the data needed to create DOI (see [Digital Object Identifier (DOI)](doi.md)).
 
@@ -43,4 +50,10 @@ The citation can be displayed in the default XSL formatter used for the full vie
 
 The formatter producing the citation can be accessed directly using: <http://localhost:8080/geonetwork/srv/api/records/31255efc-c5c1-7787-2ae6-b8fc4bcd6e55/formatters/citation?format=ris>
 
-To list available formats use: <http://localhost:8080/geonetwork/srv/api/records/31255efc-c5c1-7787-2ae6-b8fc4bcd6e55/formatters/citation?format=>?
+To list available formats use: <http://localhost:8080/geonetwork/srv/api/records/31255efc-c5c1-7787-2ae6-b8fc4bcd6e55/formatters/citation?format=?>
+
+Formatter parameters:
+
+* `citation?withAffiliation=true` to include affiliation in the list of authors
+* custom author roles (comma separated) eg. `citation?authorRoles=processor`
+* custom publisher roles (comma separated) eg. `citation?publisherRoles=owner,custodian`

schemas/iso19115-3.2018/src/main/plugin/iso19115-3.2018/convert/fromDatacite.xsl

@@ -22,6 +22,7 @@
   <xsl:function name="gn-fn-iso19115-3.2018:get-author-list">
     <xsl:param name="authors" as="node()*"/>
     <xsl:param name="langId" as="xs:string"/>
+    <xsl:param name="withAffiliation" as="xs:string"/>
 
     <xsl:variable name="authorsNameAndOrgListTmp"
                   as="node()*">
@@ -40,13 +41,25 @@
           </xsl:variable>
 
           <xsl:value-of select="$listOfNames"/>
-          <xsl:if test="normalize-space($listOfNames) != ''"> (</xsl:if>
-          <xsl:for-each select="cit:party/*/cit:name">
-            <xsl:call-template name="get-iso19115-3.2018-localised">
-              <xsl:with-param name="langId" select="$langId"/>
-            </xsl:call-template>
-          </xsl:for-each>
-          <xsl:if test="normalize-space($listOfNames) != ''">)</xsl:if>
+
+          <xsl:variable name="affiliation">
+            <xsl:for-each select="cit:party/*/cit:name">
+              <xsl:call-template name="get-iso19115-3.2018-localised">
+                <xsl:with-param name="langId" select="$langId"/>
+              </xsl:call-template>
+            </xsl:for-each>
+          </xsl:variable>
+
+          <xsl:choose>
+            <xsl:when test="normalize-space($listOfNames) != ''">
+              <xsl:if test="$withAffiliation = 'true' and normalize-space($affiliation) != ''">
+                (<xsl:value-of select="$affiliation"/>)
+              </xsl:if>
+            </xsl:when>
+            <xsl:otherwise>
+              <xsl:value-of select="$affiliation"/>
+            </xsl:otherwise>
+          </xsl:choose>
         </author>
       </xsl:for-each>
     </xsl:variable>
@@ -67,7 +80,7 @@
                   select="$metadata/mdb:identificationInfo/*/mri:pointOfContact/
                                 *[cit:role/*/@codeListValue = $authorRolesList]"/>
     <xsl:variable name="authorsNameAndOrgList"
-                  select="gn-fn-iso19115-3.2018:get-author-list($authors, $langId)"/>
+                  select="gn-fn-iso19115-3.2018:get-author-list($authors, $langId, $withAffiliation)"/>
 
 
     <!-- What name is the data set called? -->
@@ -110,7 +123,7 @@
                                 *[cit:role/*/@codeListValue = $publisherRolesList]"/>
 
     <xsl:variable name="publishersNameAndOrgList" as="node()*"
-                  select="gn-fn-iso19115-3.2018:get-author-list($publishers, $langId)"/>
+                  select="gn-fn-iso19115-3.2018:get-author-list($publishers, $langId, $withAffiliation)"/>
 
     <!-- Electronic Retrieval Location -->
     <xsl:variable name="doiInResourceIdentifier"

schemas/iso19115-3.2018/src/main/plugin/iso19115-3.2018/formatter/citation/base.xsl

@@ -17,17 +17,19 @@
 
   <!-- Who is the creator of the data set?  This can be an individual, a group of individuals, or an organization. -->
   <xsl:param name="authorRoles"
-                select="'custodian,author'"/>
+                select="'custodian,author,coAuthor'"/>
   <xsl:variable name="authorRolesList"
                 select="tokenize($authorRoles, ',')"/>
 
   <!-- What entity is responsible for producing and/or distributing the data set?  Also, is there a physical location associated with the publisher? -->
   <xsl:param name="publisherRoles"
                 select="'publisher'"/>
-
   <xsl:variable name="publisherRolesList"
                 select="tokenize($publisherRoles, ',')"/>
 
+  <xsl:param name="withAffiliation"
+                  select="'false'"/>
+
   <xsl:variable name="formats" as="node()*">
     <format key="html"/>
     <format key="text"/>

schemas/iso19115-3.2018/src/main/plugin/iso19115-3.2018/formatter/citation/common.xsl

@@ -0,0 +1,61 @@
+# Conversion from iso19115-3 to Datacite (version 4.6)
+
+See http://schema.datacite.org/meta/kernel-4.6/
+or https://datacite-metadata-schema.readthedocs.io/_/downloads/en/4.6/pdf/
+
+This conversion is used in the context of DOI creation.
+
+
+## DataCite Mandatory Properties
+
+| ID | Property | Obligation |
+|----|----------|-----------|
+| 1 | Identifier (with mandatory type sub-property) | M |
+| 2 | Creator (with optional given name, family name, name identifier and affiliation sub-properties) | M |
+| 3 | Title (with optional type sub-properties) | M |
+| 4 | Publisher | M |
+| 5 | PublicationYear | M |
+| 10 | ResourceType (with mandatory general type description subproperty) | M |
+
+The conversion does not check that those elements are present in the record.
+
+
+`datacite:creator` are any point of contact in identification section with role `author`.
+`datacite:publisher` is the first organization in identification or distribution section with role `publisher` or `distributor`.
+
+## DataCite Recommended and Optional Properties
+
+| ID | Property | Obligation |
+|----|----------|-----------|
+| 6 | Subject | R |
+| 7 | Contributor | R |
+| 8 | Date | R |
+| 9 | Language | O |
+| 11 | AlternateIdentifier | O |
+| 12 | RelatedIdentifier | R |
+| 13 | Size | O |
+| 14 | Format | O |
+| 15 | Version | O |
+| 16 | Rights | O |
+| 17 | Description | R |
+| 18 | GeoLocation | R |
+| 19 | FundingReference | O |
+| 20 | RelatedItem | O |
+
+
+## DataCite unsupported properties
+
+* givenName
+* familyName
+* schemeURI
+* rightsIdentifier
+* rightsIdentifierScheme
+* geoLocationBox and place only (no point or polygon)
+* awardNumber
+* awardTitle
+
+
+## Accessing the formatter
+
+To retrieve a record:
+* http://localhost:8080/geonetwork/srv/api/records/ff8d8cd6-c753-4581-99a3-af23fe4c996b/formatters/datacite?output=xml