Skip to main content

Terminology Bridge

Business architects and data engineers often use different terms for related concepts. This page provides a comprehensive terminology bridge to facilitate communication and integration between Orthogramic business architecture and OpenMetadata data platforms.

Core Terminology Mapping

Business Architecture → Data Platform

Business Architecture TermData Platform EquivalentUsage Context
CapabilityService /Function /FeatureWhat an organization can do
Value StreamData Pipeline /Workflow /DAGHow value flows through processes
StakeholderData Owner /Steward /ConsumerWho is accountable or interested
InformationData Asset /Entity /TableWhat data represents
Performance IndicatorMetric /Data Quality Score /KPIHow success is measured
InitiativeProject /Sprint /EpicHow change is delivered
Organization UnitData Domain /TeamWhere responsibility lies
PolicyData Governance Rule /Tag PolicyWhat constraints apply
ServiceAPI /Microservice /EndpointHow capabilities are exposed
TriggerEvent /Alert /NotificationWhat initiates action
RationaleImpact Assessment /Business CaseWhy action is taken
StrategyNorth Star Metric /OKRWhat we're trying to achieve

Data Platform → Business Architecture

Data Platform TermBusiness Architecture EquivalentNotes
TableInformation ComponentCore data asset
PipelineValue Stream (data aspect)Data flow automation
DashboardPerformance VisualizationKPI presentation
LineageDependency /Impact ChainData flow tracing
SchemaInformation StructureData definition
Glossary TermDomain Entity DefinitionBusiness definition
TagClassification /AttributeMetadata labeling
Test SuiteQuality CriteriaValidation rules
Data ProductProduct (data-centric)Packaged data offering
Domain (OM)Organization UnitOwnership boundary

Detailed Term Definitions

Capability vs. Service/Function

AspectCapability (BA)Service/Function (DP)
DefinitionWhat an organization can do, independent of howTechnical component that provides functionality
ScopeBusiness-level abstractionTechnical implementation
OwnershipBusiness unitTechnical team
MeasurementBusiness outcomesTechnical metrics (uptime, latency)
Example"Customer Onboarding""customer-onboarding-api"

Integration Tip: Link technical services to the business capabilities they enable using custom properties.

Value Stream vs. Pipeline

AspectValue Stream (BA)Pipeline (DP)
DefinitionEnd-to-end flow of value creationAutomated data transformation workflow
ScopeBusiness processTechnical process
StagesBusiness activitiesTasks/jobs
OutputBusiness valueTransformed data
Example"Order to Cash""order-to-cash-etl"

Integration Tip: Map value stream stages to corresponding pipeline tasks for business-technical traceability.

Stakeholder vs. Owner/Steward

AspectStakeholder (BA)Owner/Steward (DP)
DefinitionAnyone with interest in business outcomesPerson accountable for data asset
TypesInternal, external, individuals, groupsOwner, steward, consumer
ScopeBroad organizationalSpecific to data assets
AccountabilityBusiness outcomesData quality and availability
Example"CFO" (multiple accountabilities)"Finance Data Owner" (specific assets)

Integration Tip: Connect business stakeholders to their data stewardship roles for complete accountability chains.

Information vs. Data Asset

AspectInformation (BA)Data Asset (DP)
DefinitionBusiness information entityTechnical data container
AbstractionLogical business conceptPhysical implementation
AttributesBusiness meaning, classificationSchema, statistics, quality
RelationshipsBusiness dependenciesTechnical lineage
Example"Customer Information""warehouse.crm.customers"

Integration Tip: The Information domain provides business context that enriches technical data assets.

Policy vs. Governance Rule

AspectPolicy (BA)Governance Rule (DP)
DefinitionBusiness rule or constraintAutomated enforcement rule
FormatNatural languageCode/configuration
EnforcementManual or automatedAutomated
ScopeOrganization-widePlatform-specific
Example"Delete PII after 2 years"retentionDays <= 730

Integration Tip: Translate business policies into enforceable governance rules for automated compliance.

Domain-Specific Terminology

Finance Domain

BA TermData Platform TermContext
Revenue StreamRevenue Data PipelineFinancial flow
Cost CenterCost Allocation TagsBudget attribution
BudgetFinancial Data Quality RulesValidation
Financial ReportingFinance DashboardVisualization

Risk Management Domain

BA TermData Platform TermContext
RiskData Quality Issue /AlertNegative event
ControlData Quality TestMitigation
Risk AppetiteQuality ThresholdTolerance level
Risk OwnerIssue OwnerAccountability

Customer Domain

BA TermData Platform TermContext
Customer SegmentCustomer Cohort TableGrouping
Customer JourneyUser Event PipelineTracking
Customer ExperienceUser Analytics DashboardMeasurement
Customer DataPII-tagged TablesClassification

OpenMetadata-Specific Terminology

Entity Types

OM EntityOrthogramic MappingUsage
TableInformation ComponentPrimary data asset
TopicInformation (event/message)Streaming data
DashboardPerformance VisualizationMetrics display
PipelineValue Stream (data)Data workflow
MlModelTechnology ComponentAI/ML asset
ContainerInformation ContainerFile storage
QueryInformation QuerySaved analysis
StoredProcedureProcess ComponentBusiness logic
DataProductProduct (data)Packaged offering
SearchIndexInformation IndexSearch capability

Governance Constructs

OM ConstructOrthogramic MappingPurpose
GlossaryDomain DefinitionsTerminology
GlossaryTermDomain EntitySingle definition
TagAttribute /ClassificationLabeling
PolicyPolicy DomainGovernance
RoleStakeholder RolePermissions
TeamOrganization UnitGrouping
DomainOrganization UnitOwnership boundary

Quality Constructs

OM ConstructOrthogramic MappingPurpose
TestSuiteQuality CriteriaTest grouping
TestCaseQuality MeasureIndividual test
TestDefinitionQuality RuleTest type
IncidentTrigger (performance)Issue tracking

Communication Guidelines

When Speaking to Data Engineers

Use data platform terminology:

Instead of...Say...
"This capability needs data support""We need data assets that enable this function"
"The value stream is broken""The data pipeline supporting this workflow has issues"
"Stakeholder requirements""Data consumer requirements"
"Policy compliance""Governance rule validation"

When Speaking to Business Stakeholders

Use business architecture terminology:

Instead of...Say...
"The table has quality issues""Customer information has quality concerns"
"Pipeline failed""The value delivery process was interrupted"
"Data lineage shows...""The dependency chain shows..."
"We need to tag assets""We need to classify information"

In Documentation

Use both terms with clear mapping:

"The Customer Onboarding capability (implemented by the customer-onboarding-api service) depends on Customer Information (stored in warehouse.crm.customers) to deliver its value."

Glossary Export Template

Use this template to export Orthogramic terminology to OpenMetadata glossary:

{
"glossary": {
"name": "orthogramic-business-terms",
"displayName": "Orthogramic Business Architecture Terms",
"description": "Business architecture terminology from the Orthogramic Metamodel",
"terms": [
{
"name": "capability",
"displayName": "Capability",
"description": "What an organization can do, independent of how it is done",
"synonyms": ["business capability", "organizational capability"],
"relatedTerms": ["service", "function"],
"tags": ["business-architecture", "core-concept"]
},
{
"name": "value-stream",
"displayName": "Value Stream",
"description": "End-to-end flow of activities that deliver value to stakeholders",
"synonyms": ["value chain", "business process"],
"relatedTerms": ["pipeline", "workflow"],
"tags": ["business-architecture", "core-concept"]
}
]
}
}

Summary Reference Card

CategoryBA TermsDP Terms
What we doCapabilityService, Function
How value flowsValue StreamPipeline, Workflow
Who's responsibleStakeholderOwner, Steward
What we knowInformationData Asset, Table
How we measurePerformance IndicatorMetric, KPI
What rules applyPolicyGovernance Rule
Where ownership liesOrganization UnitDomain, Team
What we deliverProduct, ServiceData Product, API