Property 5: Resource Type

Classification of publication and document types in DOCiD™ system
5. Resource Type
Required Occurrences: 1-n

Definition: DOCiD™ uses a two-tier classification system - Publication Types (Step 2) and Document Types (Step 3) - to accurately categorize digital objects.

Two-Level Classification:

  • Publication Type: High-level categorization selected in Step 2
  • Document Type: Specific file type classification in Step 3
  • Resource Type: System-wide categorization for discovery and filtering

Database Implementation:

Resource Type Models
# Publication Types Table (Step 2 Selection)
class PublicationTypes(db.Model):
    __tablename__ = 'publication_types'
    id = Column(Integer, primary_key=True)
    name = Column(String(100), nullable=False, unique=True)
    description = Column(Text)
    is_active = Column(Boolean, default=True)

# Resource Types Table (System Categories)
class ResourceTypes(db.Model):
    __tablename__ = 'resource_types'
    id = Column(Integer, primary_key=True)
    name = Column(String(100), nullable=False, unique=True)
    description = Column(Text)
    color_code = Column(String(7))  # For UI display

# Publications Model Reference
class Publications(db.Model):
    resource_type_id = Column(Integer, ForeignKey('resource_types.id'))

# Publication Documents Model Reference
class PublicationDocuments(db.Model):
    publication_type_id = Column(Integer, ForeignKey('publication_types.id'))

Publication Types (Step 2)

Available Publication Types
Dropdown Selection 17 Types

Users select from these publication types during Step 2:

Publication Type Description Common Use Cases
Article Peer-reviewed journal article Research papers, scientific studies
Book Chapter Chapter in an edited book Academic books, collections
Proceeding Conference paper or proceedings Conference presentations, symposia
Monograph Standalone scholarly work Research reports, dissertations
Preprint Pre-publication manuscript ArXiv submissions, working papers
Edited Book Complete edited volume Multi-author collections
Seminar Seminar presentation materials Workshop materials, training
Research Chapter Research-focused book chapter Research methodology, findings
Review Article Literature or systematic review Meta-analyses, state-of-art reviews
Book Review Critical review of published work Academic book reviews
Conference Abstract Abstract for conference presentation Poster abstracts, oral presentations
Letter To Editor Editorial correspondence Journal correspondence, responses
Editorial Editorial or opinion piece Journal editorials, commentaries
Other Book Content Miscellaneous book materials Forewords, appendices, supplements
Correction Erratum Correction or erratum notice Published corrections, retractions

Document Types (Step 3)

Document Type Categories
File Upload Multiple Formats

Multimedia Content:

  • Video: .mp4, .mov, .avi, .mkv
  • Audio: .mp3, .wav, .ogg, .m4a
  • Image: .jpg, .jpeg, .png, .webp
  • Gif: .gif

Data & Research:

  • Datasets: .csv, .xlsx, .json, .xml

Publications (all support .pdf, .doc, .docx):

  • Article, Book Chapter, Chapter, Proceeding
  • Monograph, Preprint, Edited Book
  • Seminar, Research Chapter, Review Article
Document Upload Example
# Step 3: Document Upload Process
{
    "document_type": "Article",  # Selected from dropdown
    "files": [
        {
            "filename": "research_paper.pdf",
            "size": "2.5MB",
            "format": "application/pdf"
        }
    ],
    "title": "Traditional Medicine Knowledge Systems",
    "description": "Comprehensive study of healing practices",
    "identifier_type": "APA Handle ID",
    "generated_identifier": "20.500.14351/b1f26969fdec417b55c6"
}

Resource Type Categories

System-Wide Categories
Filtering & Discovery UI Display Tags

Resource types appear as hashtags in the DOCiD™ list view for filtering and discovery:

Resource Type Display Tag Color Code Typical Content
Indigenous Knowledge #Indigenous Knowledge #8B4513 Traditional practices, cultural heritage
Patent #Patent #4169E1 Patent documents, inventions
Research Data #Research Data #10B981 Datasets, statistical analyses
Publication #Publication #6366F1 Articles, papers, books
Multimedia #Multimedia #EC4899 Videos, audio, images
Software #Software #8B5CF6 Code repositories, applications
Educational #Educational #F59E0B Course materials, tutorials

API Implementation

Get Available Resource Types
GET /api/v1/resource-types
Authorization: Bearer {jwt_token}

Response:
{
    "status": "success",
    "data": [
        {
            "id": 1,
            "name": "Indigenous Knowledge",
            "description": "Traditional and cultural knowledge systems",
            "color_code": "#8B4513",
            "count": 45
        },
        {
            "id": 2,
            "name": "Patent",
            "description": "Patent documents and inventions",
            "color_code": "#4169E1",
            "count": 23
        }
    ]
}
Filter Publications by Resource Type
GET /api/v1/publications?resource_type=Indigenous%20Knowledge
Authorization: Bearer {jwt_token}

Response:
{
    "status": "success",
    "data": {
        "publications": [
            {
                "id": 1,
                "document_docid": "20.500.14351/b1f26969fdec417b55c6",
                "document_title": "Traditional Healing Practices",
                "resource_type": {
                    "name": "Indigenous Knowledge",
                    "color_code": "#8B4513"
                },
                "publication_type": "Article",
                "created_date": "2025-09-29T10:00:00Z"
            }
        ],
        "total": 45,
        "page": 1,
        "per_page": 20
    }
}

Workflow Integration

Resource Type Assignment Flow
7-Step Process
  1. Step 1 (DOCID): Initialize publication creation
  2. Step 2 (Publications): Select Publication Type from dropdown
  3. Step 3 (Documents): Choose Document Type and upload files
  4. Steps 4-7: Add metadata (Creators, Organizations, Funders, Projects)
  5. Assignment: System automatically assigns appropriate Resource Type based on Publication Type
  6. Display: Resource Type appears as hashtag in list view
  7. Filtering: Users can filter by Resource Type in DOCiD list
Complete Type Assignment Example
# User Journey
Step 2: Select "Article" as Publication Type
Step 3: Upload PDF with Document Type "Article"
System: Assigns Resource Type "#Publication"

# Database Storage
publications:
  - publication_type: "Article" (from Step 2)
  - resource_type_id: 4 (Publication)

publication_documents:
  - publication_type_id: 1 (Article)
  - file_path: "/uploads/2024/article.pdf"

# Display Result
DOCiD List shows:
  Title: "Traditional Medicine Knowledge Systems"
  Tag: #Publication (blue color #6366F1)
  Type: Article
  ID: 20.500.14351/b1f26969fdec417b55c6