Skip to main content

OpenMetadata Integration Overview

This section describes how to integrate the Orthogramic Metamodel with OpenMetadata, enabling organizations to bridge business architecture with data platform governance.

Why Integrate?

The Gap Between Business and Data

Organizations often face a disconnect:

Business ArchitectureData Platform
Capabilities, value streams, stakeholdersTables, pipelines, dashboards
Strategic objectives and KPIsData quality metrics
Business policies and governanceTechnical governance rules
Organizational accountabilityData ownership and stewardship

This disconnect leads to:

  • Data assets without business context
  • Business decisions without data visibility
  • Governance policies that don't reach data platforms
  • Accountability gaps between business and technical teams

Integration Benefits

BenefitDescription
Business context for dataEvery data asset linked to business capabilities
Unified governanceBusiness policies enforced in data platforms
TraceabilityEnd-to-end lineage from strategy to data
AccountabilityClear ownership from business to technical layers
Impact analysisUnderstand business impact of data changes

Integration Architecture

OpenMetadata Concepts

For those new to OpenMetadata, here are the key concepts:

OpenMetadata ConceptDescriptionOrthogramic Equivalent
TableDatabase table or viewInformation component
TopicMessage queue or event streamInformation (messaging)
DashboardVisualization or reportPerformance indicator
PipelineData workflow or DAGValue stream (data flow)
ML ModelMachine learning modelTechnology component
Data ProductPackaged data offeringProducts domain
Glossary TermBusiness definitionDomain entity definitions
TagClassification labelDomain attributes
PolicyGovernance rulePolicy domain
OwnerAccountable personStakeholder
Domain (OM)Organizational groupingOrganization domain

Integration Approaches

Approach 1: Custom Properties

Add Orthogramic context to OpenMetadata entities using custom properties:

{
"customProperties": {
"businessCapability": "CAP-CRM-001",
"valueStream": "VS-CUSTOMER-ONBOARDING",
"businessOwner": "STK-RETAIL-HEAD",
"strategicAlignment": "Digital-first customer acquisition"
}
}

Pros: Non-invasive, works with existing OpenMetadata setup Cons: Requires manual or scheduled synchronization

Approach 2: Glossary Integration

Use OpenMetadata glossary to embed Orthogramic terminology:

{
"glossaryTerm": {
"name": "Customer Onboarding Capability",
"description": "Capability to register and verify new customers",
"relatedTerms": ["CAP-CRM-001"],
"tags": ["business-capability", "customer-domain"]
}
}

Pros: Native OpenMetadata feature, supports relationships Cons: Limited to terminology mapping

Approach 3: Full API Integration

Bi-directional synchronization via OpenMetadata and Orthogramic APIs:

Pros: Real-time, bi-directional, comprehensive Cons: Requires development effort

Getting Started

Prerequisites

  • OpenMetadata instance (v1.0+ recommended)
  • Orthogramic Metamodel data (JSON format)
  • API access to both platforms

Quick Start Path

  1. Map entities — Define how Orthogramic domains map to OpenMetadata entities
  2. Export glossary — Create OpenMetadata glossary from Orthogramic terminology
  3. Add custom properties — Define custom property schemas in OpenMetadata
  4. Populate context — Add business context to key data assets
  5. Automate sync — Build or configure synchronization process
PhaseActivitiesEffort
Phase 1Glossary import, manual custom properties1-2 weeks
Phase 2Automated custom property sync2-4 weeks
Phase 3Bi-directional integration4-8 weeks

Section Contents

This integration section includes:

PageDescription
Entity MappingDetailed mapping between Orthogramic and OpenMetadata entities
Use CasesFive practical integration scenarios
Terminology BridgeBusiness architecture to data platform vocabulary
API PatternsCode examples for integration implementation