2.4.1 Import — Bulk and Structured Ingestion
Praisma Hub provides a dedicated import framework designed for bulk and structured data ingestion. This functionality is used during initial onboarding, platform migrations, and recurring data synchronization scenarios. Imports are designed to be predictable, auditable, and safe, even when handling large datasets.
The import system aligns with Praisma Hub’s schema-driven CMS architecture, ensuring that imported data conforms to defined content types, relations, and localization rules.
Purpose of the Import System
The import system exists to:
Migrate content from legacy systems (such as Drupal or other CMS platforms)
Ingest large volumes of structured content efficiently
Reduce manual data entry and human error
Ensure consistent data quality during onboarding
Imports are treated as controlled system operations, not ad-hoc data injections.
Supported Import Structures
Imports operate on structured data formats that reflect Praisma Hub’s internal data model. Typical structures include:
Content entries mapped to content types
Field-level data aligned with schema definitions
Explicit relations between entries
Media references resolved through identifiers
Localization data grouped by locale
This structure-first approach ensures that imported content behaves identically to content created through the editor.
Bulk Import Processing
Bulk imports are processed asynchronously to ensure system stability. Key characteristics include:
Queue-based processing for large datasets
Chunked handling of records to limit memory usage
Progress tracking and status reporting
Graceful handling of partial failures
Users can monitor import progress and are informed of completion or errors.
Validation and Integrity Checks
Before data is persisted:
Schema validation is applied to all entries
Required fields and constraints are enforced
Relations are validated for existence and consistency
Localization rules are checked per locale
Invalid records are rejected or flagged without compromising the integrity of valid data.
Auditability and Traceability
Each import operation:
Is linked to a specific tenant and user
Is logged with timestamps and outcome status
Can be reviewed for compliance and troubleshooting
This supports governance and accountability requirements, particularly in public-sector environments.
Summary
The import functionality in Praisma Hub enables reliable, large-scale content ingestion while preserving schema integrity, localization, and auditability. It provides a safe bridge between external systems and the internal CMS model.