Property 5: Resource Type
Classification of publication and document types in DOCiD™ system
5. Resource Type
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
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
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
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
- Step 1 (DOCID): Initialize publication creation
- Step 2 (Publications): Select Publication Type from dropdown
- Step 3 (Documents): Choose Document Type and upload files
- Steps 4-7: Add metadata (Creators, Organizations, Funders, Projects)
- Assignment: System automatically assigns appropriate Resource Type based on Publication Type
- Display: Resource Type appears as hashtag in list view
- 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