Property 2: Creator

Definition: The surname or last name of the creator.

family_name = Column(String(255), nullable=False)

Allowed values, examples, other constraints:

• Data Type: UTF-8 text string
• Maximum Length: 255 characters
• Character Set: Unicode support for international characters including African scripts
• Required: Must be provided for all creators

Examples:

• Okonkwo
• Al-Zahra
• Mthembu
• van der Merwe
• Diallo
• Ogundipe
• Kimani
• Asante

Definition: The personal or first name of the creator, including middle names.

given_name = Column(String(255))

Allowed values, examples, other constraints:

• Data Type: UTF-8 text string
• Maximum Length: 255 characters
• Character Set: Unicode support for international characters
• Optional: May be omitted for creators known primarily by family name
• Multiple Names: Can include multiple given names separated by spaces

Examples based on the 2.1 family names:

• Amara (for Okonkwo, Amara)
• Fatima (for Al-Zahra, Fatima)
• Themba (for Mthembu, Themba)
• Sarah Nomsa (for van der Merwe, Sarah Nomsa)
• Mariama (for Diallo, Mariama)
• Adebayo (for Ogundipe, Adebayo)
• Michael Mwangi (for Kimani, Michael Mwangi)
• Kwame (for Asante, Kwame)

Definition: Uniquely identifies an individual or legal entity, according to various identifier schemes. The format is dependent upon the identifier scheme.

identifier = Column(String(500))  # Stores the full resolvable URL
identifier_type = Column(String(50))  # Stores the type (e.g., 'orcid', 'isni', 'viaf')

Allowed values, examples, other constraints:

• Data Type: UTF-8 text string (full resolvable URL)
• Maximum Length: 500 characters
• Format: Complete HTTP/HTTPS URL to the identifier resource
• Validation: Must be a valid URL format
• Uniqueness: Should uniquely identify the individual globally
• Persistence: Should be persistent and resolvable over time

Examples by identifier type:

Format Requirements:

• ORCID: Must follow pattern https://orcid.org/0000-0000-0000-000X (where X is 0-9 or X)
• ISNI: Must be 16 digits with optional spaces or hyphens in display format
• VIAF: Numeric identifier appended to base URL
• HTTP/HTTPS: All identifiers must use secure protocols where available
• Case Sensitivity: URLs are case-sensitive and must match exactly

Definition: The name of the name identifier scheme. This is automatically determined based on the identifier URL format and stored in the identifier_type field.

Allowed values, examples, other constraints:

• Data Type: Controlled vocabulary from predefined list
• Case Sensitivity: Lowercase preferred
• Validation: Must correspond to supported identifier schemes
• Auto-Detection: DOCiD™ can auto-detect scheme from URL pattern

Supported Schemes:

Examples:

• For identifier "https://orcid.org/0000-0002-1825-0097" → scheme: "orcid"
• For identifier "https://isni.org/isni/0000000121032683" → scheme: "isni"
• For identifier "http://viaf.org/viaf/102333412" → scheme: "viaf"
• For identifier "http://www.researcherid.com/rid/A-5678-2012" → scheme: "researcherid"

Definition: The organizational or institutional affiliation of the creator. In DOCiD™, affiliations are managed through the PublicationOrganization model with comprehensive organization metadata.

Allowed values, examples, other constraints:

• Implementation: Separate PublicationOrganization model
• Multiple Affiliations: Supports multiple institutional affiliations per creator
• Organization Identifiers: Integrated with ROR (Research Organization Registry)
• Geographic Information: Includes country and regional data
• Organization Types: Academic, government, commercial, NGO classifications

Affiliation Structure (PublicationOrganization model):

class PublicationOrganization(db.Model):
    id = Column(Integer, primary_key=True, autoincrement=True)
    publication_id = Column(Integer, ForeignKey('publications.id'), nullable=False)
    name = Column(String(255), nullable=False)  # Organization name
    type = Column(String(255), nullable=False)  # Organization type
    other_name = Column(String(255))  # Alternative names
    country = Column(String(255))  # Country location
    identifier = Column(String(500))  # ROR ID or other identifier
    identifier_type = Column(String(50))  # Type of identifier (ror, grid, isni)

Examples of organization affiliations:

• University of Cape Town (ROR: https://ror.org/01ggx4157) - South Africa
• University of Ghana (ROR: https://ror.org/05591te55) - Ghana
• American University in Cairo (ROR: https://ror.org/03gc78e51) - Egypt
• University of the Witwatersrand (ROR: https://ror.org/03rp50963) - South Africa
• Council for Scientific and Industrial Research (ROR: https://ror.org/0145zh013) - South Africa
• University of Ibadan (ROR: https://ror.org/01za5dv85) - Nigeria
• Université Cheikh Anta Diop (ROR: https://ror.org/03qx6w235) - Senegal
• Kenya Education Network (KENET) (ROR: https://ror.org/04b4z2r68) - Kenya

Organization Types:

• Education: Universities, colleges, schools
• Government: Government agencies and departments
• Company: Commercial and industry organizations
• Healthcare: Hospitals, medical centers, health organizations
• Nonprofit: NGOs, foundations, civil society organizations
• Other: Research institutes, international organizations

API Integration Example:

{
  "creators": [
    {
      "family_name": "Okonkwo",
      "given_name": "Amara",
      "identifier": "https://orcid.org/0000-0002-1234-5678",
      "identifier_type": "orcid",
      "role_id": "author"
    }
  ],
  "organizations": [
    {
      "name": "University of Cape Town",
      "type": "Education",
      "country": "South Africa",
      "identifier": "https://ror.org/01ggx4157",
      "identifier_type": "ror"
    }
  ]
}