Entity Mapping

This page provides detailed mappings between Orthogramic Metamodel domains and OpenMetadata entities. Use these mappings to design your integration strategy.

Primary Entity Mappings

Orthogramic → OpenMetadata

Orthogramic Domain	OpenMetadata Entity	Mapping Type	Notes
Information	Table, Topic	Direct	Data assets map to information components
Value Stream	Pipeline	Conceptual	Value stages map to pipeline tasks
Performance	Dashboard, Metric	Direct	KPIs map to dashboard metrics
Products	Data Product	Direct	Data products align directly
Stakeholder	User, Team	Direct	Business owners to OM owners
Organization	Domain (OM)	Direct	Org units to OM domains
Policy	Policy	Direct	Business rules to governance policies
Capabilities	Custom Property	Extension	Add capability context to assets
Technology	Service	Conceptual	Tech components to OM services
Strategy	Glossary Term	Extension	Strategic objectives as terms

Detailed Mappings by Domain

Information Domain → OpenMetadata Data Assets

The Information domain maps most directly to OpenMetadata's core data assets.

Orthogramic Attribute	OpenMetadata Property	Mapping Logic
title	displayName	Direct
description	description	Direct
owner	owner	Resolve to OM User/Team
informationType	tableType	Enum mapping
dataClassification	tags	Map to classification tags
dataQuality	testSuites	Link to quality tests
custodian	domain.experts	Add as domain expert
dependencies	lineage	Create lineage edges

Information Type Mapping:

Orthogramic Type	OpenMetadata Type
master-data	Regular + "master-data" tag
transactional	Regular + "transactional" tag
reference	Regular + "reference-data" tag
analytical	View or Materialized View
event	Topic

Example Mapping:

{
  "orthogramic": {
    "title": "Customer Master",
    "description": "Core customer information",
    "informationType": "master-data",
    "owner": "Data Governance Team",
    "dataClassification": "confidential",
    "custodian": "Customer Data Steward"
  },
  "openMetadata": {
    "displayName": "Customer Master",
    "description": "Core customer information",
    "tableType": "Regular",
    "tags": [
      {"tagFQN": "DataClassification.Confidential"},
      {"tagFQN": "DataType.MasterData"}
    ],
    "owner": {
      "type": "team",
      "name": "data-governance"
    },
    "domain": {
      "type": "domain",
      "name": "customer-domain"
    }
  }
}

Value Stream Domain → OpenMetadata Pipeline

Value streams conceptually map to data pipelines, representing the flow of value/data through stages.

Orthogramic Attribute	OpenMetadata Property	Mapping Logic
title	displayName	Direct
description	description	Direct
stages	tasks	Map stages to pipeline tasks
inputs	sourceUrl	Reference source tables
outputs	sink	Reference target tables
owner	owner	Resolve to OM User/Team
performanceIndicators	Custom properties	Add KPI references

Stage to Task Mapping:

{
  "orthogramic": {
    "valueStreamID": "vs-order-to-cash",
    "title": "Order to Cash",
    "stages": [
      {"name": "Order Capture", "capabilities": ["cap-order-entry"]},
      {"name": "Fulfillment", "capabilities": ["cap-inventory", "cap-shipping"]},
      {"name": "Invoicing", "capabilities": ["cap-billing"]},
      {"name": "Collection", "capabilities": ["cap-accounts-receivable"]}
    ]
  },
  "openMetadata": {
    "displayName": "Order to Cash",
    "pipelineType": "metadata",
    "tasks": [
      {"name": "order_capture", "displayName": "Order Capture"},
      {"name": "fulfillment", "displayName": "Fulfillment"},
      {"name": "invoicing", "displayName": "Invoicing"},
      {"name": "collection", "displayName": "Collection"}
    ],
    "customProperties": {
      "businessValueStream": "vs-order-to-cash",
      "businessValue": "Revenue realization"
    }
  }
}

Stakeholder Domain → OpenMetadata Users/Teams

Stakeholders map to OpenMetadata's ownership model.

Orthogramic Attribute	OpenMetadata Property	Mapping Logic
title	displayName	Direct
description	description	Direct
stakeholderType	userType /Team	Individual or team
email	email	Direct
responsibilities	Custom properties	Accountability areas
influence	Custom properties	Engagement level

Stakeholder Type Mapping:

Orthogramic Type	OpenMetadata Mapping
individual	User
group	Team
role	Team (role-based)
organization	Team (org-based)

Example:

{
  "orthogramic": {
    "stakeholderID": "stk-cfo",
    "title": "Chief Financial Officer",
    "stakeholderType": "individual",
    "email": "cfo@company.com",
    "responsibilities": ["Financial Reporting", "Budget Management"]
  },
  "openMetadata": {
    "entityType": "user",
    "name": "cfo",
    "displayName": "Chief Financial Officer",
    "email": "cfo@company.com",
    "teams": ["finance-leadership"],
    "customProperties": {
      "businessStakeholder": "stk-cfo",
      "accountabilities": ["Financial Reporting", "Budget Management"]
    }
  }
}

Organization Domain → OpenMetadata Domains

Organizational units map to OpenMetadata's domain construct.

Orthogramic Attribute	OpenMetadata Property	Mapping Logic
title	displayName	Direct
description	description	Direct
orgType	domainType	Conceptual mapping
parent	parent	Hierarchy preservation
owner	owner	Domain owner

Example:

{
  "orthogramic": {
    "orgUnitID": "org-retail-banking",
    "title": "Retail Banking Division",
    "orgType": "division",
    "parent": "org-banking-group",
    "owner": "Head of Retail Banking"
  },
  "openMetadata": {
    "entityType": "domain",
    "name": "retail-banking",
    "displayName": "Retail Banking Division",
    "domainType": "Source-aligned",
    "parent": "banking-group",
    "owner": {
      "type": "user",
      "name": "head-retail-banking"
    }
  }
}

Policy Domain → OpenMetadata Policies

Business policies map to OpenMetadata governance policies.

Orthogramic Attribute	OpenMetadata Property	Mapping Logic
title	name	Direct
description	description	Direct
policyType	Policy rules	Translate to rule logic
scope	resources	Assets covered
requirements	rules	Specific conditions
owner	owner	Policy owner

Example:

{
  "orthogramic": {
    "policyID": "pol-data-retention",
    "title": "Customer Data Retention Policy",
    "policyType": "data-governance",
    "scope": "All customer PII",
    "requirements": [
      {"rule": "Delete after 730 days", "enforcement": "mandatory"}
    ]
  },
  "openMetadata": {
    "entityType": "policy",
    "name": "customer-data-retention",
    "fullyQualifiedName": "governance.customer-data-retention",
    "policyType": "Lifecycle",
    "rules": [
      {
        "name": "PII Retention Limit",
        "effect": "deny",
        "operations": ["Delete"],
        "condition": "matchAnyTag('PII') && retentionDays > 730"
      }
    ],
    "customProperties": {
      "businessPolicy": "pol-data-retention"
    }
  }
}

Performance Domain → OpenMetadata Metrics/Dashboards

Performance indicators map to OpenMetadata metrics and can be linked to dashboards.

Orthogramic Attribute	OpenMetadata Property	Mapping Logic
title	displayName	Direct
description	description	Direct
measurementType	Custom property	Classification
targetValue	Custom property	Target
currentValue	Metric value	Current measurement
unit	Custom property	Unit of measure

Example:

{
  "orthogramic": {
    "kpiID": "kpi-customer-satisfaction",
    "title": "Customer Satisfaction Score",
    "measurementType": "outcome",
    "targetValue": 4.5,
    "currentValue": 4.2,
    "unit": "score (1-5)"
  },
  "openMetadata": {
    "entityType": "metric",
    "name": "customer-satisfaction-score",
    "displayName": "Customer Satisfaction Score",
    "metricType": "Number",
    "customProperties": {
      "businessKPI": "kpi-customer-satisfaction",
      "measurementType": "outcome",
      "target": 4.5,
      "unit": "score (1-5)"
    }
  }
}

Capabilities → OpenMetadata Custom Properties

Capabilities don't have a direct OpenMetadata equivalent but enrich data assets via custom properties.

Custom Property Schema:

{
  "customPropertyConfig": {
    "businessCapability": {
      "propertyType": "string",
      "description": "Orthogramic capability ID this asset supports"
    },
    "capabilityLevel": {
      "propertyType": "integer",
      "description": "Capability hierarchy level (L1, L2, L3)"
    },
    "capabilityOwner": {
      "propertyType": "string",
      "description": "Business owner of the capability"
    },
    "strategicAlignment": {
      "propertyType": "string",
      "description": "Strategic objective this capability supports"
    }
  }
}

Application to Table:

{
  "table": {
    "fullyQualifiedName": "warehouse.crm.customers",
    "customProperties": {
      "businessCapability": "CAP-CRM-001",
      "capabilityLevel": 2,
      "capabilityOwner": "Head of Customer Operations",
      "strategicAlignment": "Digital-first customer experience"
    }
  }
}

Mapping Summary Table

Orthogramic Domain	Primary OM Entity	Secondary OM Entities	Custom Properties
Information	Table, Topic	Glossary Term	-
Value Stream	Pipeline	-	businessValueStream
Performance	Dashboard, Metric	-	businessKPI
Products	Data Product	-	businessProduct
Stakeholder	User, Team	-	businessStakeholder
Organization	Domain	-	orgUnit
Policy	Policy	Tag	businessPolicy
Capabilities	-	Glossary Term	businessCapability
Technology	Service	-	technologyComponent
Strategy	Glossary Term	-	strategicObjective
Initiatives	-	-	businessInitiative
Risk Management	Tag, Policy	-	riskAssessment

Related Documentation

• Use Cases — Practical integration scenarios
• Terminology Bridge — Vocabulary mapping
• API Patterns — Implementation code examples