Part I - Semantic Integration Engineering Methods
SIE.1 - Bound the Receiving Use and Semantic Contract
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
SemanticIntegrationUseContract@Usethat names one receiver and use, required answer claims, source cut, tolerated loss and uncertainty, currentness, latency, quality, authority, representative tests, stop conditions, and reopen conditions.
SIE.1:1 - Problem Frame
Use this when a request says “integrate the data”, “align the models”, “build the knowledge graph”, or “make one source of truth”, but the intended receiver and decision-changing answer are not yet explicit. The recognizable failure is an integration whose values cannot be interpreted, trusted, or used safely by the Work that requested it.
The subject is one semantic-integration use: a named receiver performing a named query, decision, operation, or engineering workflow under stated conditions. The first move is to state that use and the answer claims it needs. The first result is a bounded contract that lets later workers decide which semantic loss, source age, unresolved row, and test outcome are acceptable.
The practical gain is a testable stopping rule before source, ontology, mapping, or platform choices accumulate. Do not use this pattern to authorize the receiving decision, decide product configuration, choose master identity, operate a data pipeline, or define generic evidence law. Obtain those results from their owners. Do not reopen a current contract merely because another source exists; reopen it when the receiver, use, answer, conditions, authority, or acceptance boundary changes.
SIE.1:2 - Problem
Without a receiving-use contract, “semantic integration” expands toward every source and every possible reuse. Similar labels are merged without a loss budget, freshness is treated as an implementation detail, and a passing schema or sample query is reported as success. The project cannot distinguish an informative unmatched row from a defect, or a harmless delay from a stale answer that changes action.
Technology then supplies the hidden contract. A graph platform encourages graph-shaped outputs, a warehouse encourages copying, and an API encourages whichever fields are easiest to expose. None says which answer claims the receiver may rely on, who owns them, or when the correct result is to stop.
SIE.1:3 - Forces
| Force | Tension |
|---|---|
| Breadth | More sources may enable future reuse, while every added source creates meanings, authority, currentness, and validation obligations. |
| Speed | A quick join can demonstrate access, while early conflation makes later correction expensive and hard to trace. |
| Loss | A useful common view often coarsens detail, while silent loss can reverse a decision or erase incompatibility. |
| Freshness and latency | Query-time access can be current but slow or fragile; copied data can be fast but stale and harder to govern. |
| Authority | Source owners, integrators, and receivers contribute different decisions; having access to or custody of a source gives no additional decision rights by itself. |
| Assurance | A finite representative test is needed now, while no test establishes universal semantic correctness. |
| Reuse | A broad contract appears reusable, while a small contract is easier to validate and reopen. |
SIE.1:4 - Solution
Construct the smallest semantic contract that can change the named receiving action. Begin from the receiver and work backward to required answer claims, source contexts, meanings, losses, currentness, quality, authority, representative cases, and conditions for stopping. Treat the contract as an input to later SIE patterns, not as proof that any source, correspondence, identity, mapping, interface, or implementation exists.
SIE.1:4.1 - Pattern-Use Unfolding
- Name the receiver and receiving Work. Identify the System or role that will use the result, the query, decision, operation, or workflow, the horizon, and the first useful answer.
- State the answer claims. Write the fields or propositions the receiver needs, including scope, grain, interval or effectivity, and the action each claim can change. Keep a value, its provenance, its authority, and the receiver’s decision distinct.
- Select the source cut. Name only the governed contexts and candidate source assets that can change the answer. Mark sources whose inclusion is uncertain rather than adding them silently.
- State preserved distinctions and tolerated loss. Name identities, versions, units, codes, relations, claim scopes, and incompatibilities that must survive. For each permitted coarsening or omission, state why the receiver can tolerate it.
- State currentness, latency, availability, and quality conditions. Choose thresholds or explicit unresolved returns only where they change use.
- Recover authority, permission, and protection boundaries. Name who defines source meanings, who may grant access, who decides identities or authoritative values, who accepts semantic loss, and who owns the receiving action. Identify any missing authority or permission that blocks the use.
- Design representative tests before implementation. Include at least one expected positive case, one negative or unmatched case, and one unlike or changed-source case that could defeat the proposed integration. Name the expected branch rather than requiring every test to return a value.
- State pass, narrow, unresolved, and stop outcomes. A contract permits a bounded usable subset or explicit incompatibility when that is useful. Stop when a load-bearing meaning, source edition, identity authority, permission, or acceptance rule is unavailable.
- State reopen conditions and next result. Identify observations that change the contract and the smallest next result, often
SourceSemanticInventory@UsefromSIE.2.
SIE.1:4.2 - Record the Result
| Contract position | Required content |
|---|---|
| receiver and use | named receiver, Work, query/decision/operation/workflow, horizon, and first useful answer |
| answer claims | propositions or fields, grain, scope, interval/effectivity, and action changed |
| source cut | governed contexts, candidate assets, inclusion reason, and known access limits |
| semantic boundary | distinctions to preserve, permitted loss, uncertainty treatment, unmatched/incompatible behavior |
| service conditions | currentness, latency, availability, recovery, and quality thresholds that change use |
| authority and protection | meaning owner, identifier or value authority, access/permission, receiver authority, and protected conditions |
| validation | representative positive, negative, unlike/change cases and expected branches |
| disposition | pass, narrow, unresolved, or stop rules; next result and observable reopen conditions |
SIE.1:4.3 - What Changes in Practice
The team stops treating integration scope as the set of reachable sources. Every later correspondence, identity disposition, mapping rule, realization, interface field, and validation claim must answer to a named receiving use and loss boundary. When the receiving contract allows it, an explicit unmatched or incompatible result answers the question.
SIE.1:5 - Archetypal Grounding - AP242/QIF Configuration Query
A quality engineer asks which QIF inspection plan and result concern feature F in released AP242 product-definition revision/configuration R at effectivity E. The initial request is “connect PLM and quality data in a knowledge graph.” SIE.1 replaces the carrier proposal with this contract:
| Position | Constructed value |
|---|---|
| receiver/use | quality engineer preparing an evidence return for one configuration-bound review; query by revision/configuration, feature, and effectivity |
| answer claims | AP242 feature identifier and configuration/effectivity claim; QIF plan, characteristic, and result identifiers; relation disposition; source edition; timestamp; provenance; unmatched/incompatible status |
| preserved distinctions | product feature versus inspection characteristic; definition versus performed result; revision versus configuration; applicability/effectivity; source identifier and issuer; plan versus result |
| tolerated loss | display may coarsen source-local labels after exact identifiers and relations remain available; no unmatched feature or incompatible characteristic may become a positive relation. For this constructed evidence-return review, the receiver permits the qualified row set with unresolved local-extension and unknown-unit branches shown separately |
| currentness and latency | for this constructed review at time T, the receiver requires the released AP242 configuration applicable to the review, QIF observations from T minus 24 hours through T, and a query response within two seconds. |
| authority | Systems Engineering owns release, configuration, and effectivity; the quality authority owns acceptance; source owners define their models; SIE may qualify mappings but authorizes neither decision |
| tests | known match; unmatched feature; changed revision; incompatible characteristic; stale QIF result; missing provenance; source timeout |
| stop/reopen | stop on unresolved configuration/effectivity, source edition, feature identity, permission, or acceptance rule; reopen when a relied-on AP242/QIF edition, review use, or protected condition changes |
This result does not claim that the two source models correspond or that an interface works. It makes those later claims testable. AP242 edition 4 is recorded by SIE.2 with its current source status; SIE.1 only requires the edition and reopen rule to be explicit.
SIE.1:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | The integration team silently accepts loss or acts as source/value authority. | Name each decision subject and the direct authority relation; make absence a blocker. |
| Architecture | Platform boundaries define the semantic use. | Begin from the receiving result and keep realization alternatives open. |
| Ontology/Epistemology | A shared label or data field is treated as a shared meaning or true claim. | State answer claims, source contexts, preserved distinctions, and uncertainty separately. |
| Pragmatics | The contract becomes a complete requirements catalogue rather than a decision tool. | Keep only conditions that can change the receiving action or stop. |
| Didactics | Readers infer that SIE.1 must precede every other pattern. | Enter directly elsewhere when an equivalent current contract exists; verify compatibility instead of repeating it. |
SIE.1:7 - Conformance Checklist
- One named receiver and receiving Work are explicit.
- The first useful answer is expressed as claims or fields with grain, scope, and interval/effectivity.
- The source cut is justified by the use rather than by reachability.
- Preserved distinctions, permitted loss, uncertainty, and unmatched/incompatible behavior are explicit.
- Currentness, latency, availability, recovery, and quality are included only where action-changing.
- Meaning, identity/value, access, semantic-loss, and receiving-action authorities remain distinct.
- Positive, negative, and unlike or changed-source tests have expected branches.
- Pass, narrow, unresolved, stop, next-result, and reopen rules are stated.
- The contract claims no correspondence, implementation, validation, authorization, or outcome that has not been obtained.
SIE.1:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| “Integrate all enterprise data.” | Name one receiver and the smallest source cut that can change one use. |
| “The knowledge graph is the deliverable.” | State the receiving answer and treat graph materialization as one later realization option. |
| “No information loss.” | Name the distinctions and tests; unlimited preservation is not an operational contract. |
| “Real time.” | State a measurable currentness and latency condition for the use. |
| “Single source of truth.” | Name source, identity, and value authorities and the claims each may establish. |
| “Every test must return a row.” | Define legitimate unmatched, incompatible, unavailable, and stop branches. |
SIE.1:9 - Consequences
The contract limits source fan-out, makes semantic loss and authority visible, and gives implementation and validation a shared target. It can stop an integration before expensive model or platform work. It also makes conflicts and narrow usable subsets publishable outcomes.
The cost is early negotiation about the receiver, evidence, loss, and stop conditions. Some attractive future reuse remains outside the first package and must earn its own contract or compatible extension.
SIE.1:10 - Rationale
Semantic adequacy is relative to a use. A receiver, answer claim, source context, permitted loss, authority, and representative test together constrain what counts as a successful integration. Beginning there prevents a carrier choice from becoming an implicit ontology, authority model, and acceptance rule.
SIE.1:11 - SoTA-Echoing
The best-known line for this question combines use-bounded representation selection, situational Method criteria, quality-for-use, and explicit source/provenance practice. The serious default alternative is technology- or source-led integration. The difficulty arises when the choice of graph, warehouse or federation defines the answer and loss boundary. SIE.1 applies these contributions by making the whole semantic contract, including authorities and legitimate unresolved branches, the first domain result.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
Current FPF C.37 | adopt | Bounds representation selection and co-use to a named use; does not supply the SIE package or application authority. |
Current C.39.RQ | adapt | Situational criteria help state receiving Work and fit conditions; SIE adds semantic endpoints, loss, source, authority, and layered tests. |
| DQV and ISO/IEC 25012:2008 | adapt | Supply quality dimensions and vocabulary; the contract selects only dimensions that change this use. |
| Data on the Web Best Practices | adapt | Contributes provenance, version, access, and reuse questions; no Web publication form is mandatory. |
| platform-first “single source of truth” | reject as default | A carrier and custody arrangement cannot establish cross-source meaning, authority, or receiving-use adequacy. |
Reopen this pattern when representative uses cannot express action-changing loss, authority, or validation obligations through the contract positions, or when a source line supplies a materially better first result.
SIE.1:12 - Relations
SIE.2consumes the source cut, answer claims, distinctions, and currentness questions to produceSourceSemanticInventory@Use.SIE.4–SIE.10consume the compatible contract positions relevant to their results; none may silently widen the receiver or accepted loss.C.37governs generic use-bounded representation selection.A.10andA.10.1govern evidence/provenance and generic affected-use questions.- Applications, Systems Engineering, Operations, quality, safety, legal, and other direct owners supply their acceptance and authority results.
- A changed contract reopens the package branches that rely on the changed premise.
SIE.11supplies affected-use discovery and integration revalidation where the affected results still need to be established.
SIE.1:End
SIE.2 - Recover and Qualify Source Semantics and Authority
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
SourceSemanticInventory@Usethat records the load-bearing source assets, local meanings, schemes, editions and effectivity, identifiers, claims, owners and authority scope, provenance, access, currentness, gaps, and any question or result to return to the responsible owner for this integration use.
SIE.2:1 - Problem Frame
Use this when a bounded integration use exists, yet endpoint meanings are being inferred from labels, column names, class names, diagrams, sample values, or undocumented organizational knowledge. The recognizable failure is a mapping that runs while joining different concepts, editions, grains, or authority scopes.
Identify the source-local semantic premises on which the receiving use depends. The first move is to select one load-bearing source asset and recover its scheme, edition or effectivity, meaning, owner, authority, provenance, and access conditions. The first result is an inventory that identifies the usable premises and what is missing.
Distinguish what a source says, what an integrator infers and what another owner must decide. Do not use SIE.2 to construct an ontology, establish a cross-source correspondence, decide identity, fuse claims, or judge receiving-use adequacy. If model adequacy for a required distinction remains unsettled, request UseFitSemanticModel@Use from SIE.3 or another qualified direct provider. Adequate reuse can finish that question; a missing distinction may require extension or construction.
SIE.2:2 - Problem
Source inventories often list files and endpoints but omit the meanings that make their values usable. A table called feature, an API field called available, and an identifier called partNumber appear self-describing. Their meanings may depend on an edition, profile, configuration, interval, issuer, lifecycle state, organizational rule, or local extension.
When those dependencies are hidden, later workers can neither justify a correspondence nor trace a failure. A changed source looks like a schema defect even when the meaning changed; an access right is mistaken for authority; and a provenance record is mistaken for truth.
SIE.2:3 - Forces
| Force | Tension |
|---|---|
| Selectivity | Reading every source is infeasible, while skipping one load-bearing definition can invalidate the package. |
| Formal and operative meaning | Standards and schemas provide inspectable definitions, while actual profiles, extensions, and Work can narrow or alter use. |
| Edition and effectivity | A stable name aids reuse, while its meaning or applicability can change across revisions, profiles, configurations, and intervals. |
| Authority | Publishers and stewards define bounded schemes or values, while the receiver may need a decision outside their scope. |
| Access | A source may be meaningful but unavailable, restricted, delayed, or legally unusable for the proposed integration. |
| Adequacy | Existing models reduce construction work, while forcing an inadequate model hides a semantic gap. |
SIE.2:4 - Solution
Recover source semantics at the smallest grain that can change the receiving answer. Preserve term, concept, type, relation, schema, model, claim, data item, carrier, identifier, and world-side referent as different questions. Qualify each relied-on premise by source identity, edition/effectivity, authority scope, provenance, access, currentness, and known gaps.
SIE.2:4.1 - Pattern-Use Unfolding
- Take the source cut from the use contract. Add another source only when it can change an answer claim, test, loss, or stop condition.
- Identify the source asset and carrier. Record publisher or owning System, title or endpoint, profile/module, version or edition, publication and effectivity, retrieval location, and carrier kind. Keep the asset distinct from the concepts and claims it carries.
- Recover the local scheme and scope. State the domain, population, lifecycle state, configuration, jurisdiction, or Work context in which the source definitions apply.
- Recover exact meanings. For every load-bearing endpoint, record the designation, definition or operative rule, type/relation role, examples and counterexamples, units or codes, and unresolved ambiguity. Use source-local language before normalizing it.
- Resolve an identifier for this use. Identify the entry, the kind and grain of entity it can designate, and the restrictions on its use. For an issued identifier, recover the applicable assignment, its authority and its interval. For a designation resolved by a rule, establish that rule and the context in which it picks out an entity. If the sources form or resolve entries differently for this use, compare their languages of designations. When the rules agree, use that agreement and examine the particular bindings. State what remains unknown.
- Separate claims, data, and provenance. Record which claim a data item represents, its scope and time, how it was derived, who or what supplied it, and which uncertainty or status accompanies it. Provenance does not make the claim true.
- Recover authority and access. Identify who sets the source conventions, who can issue or reassign an identifier, who decides authoritative values and who may approve extensions, grant access or authorize receiving use. Mark unsupported assumptions.
- Assess currentness and use adequacy. Compare the source premise with the contract. State whether it is adequate, adequate only under conditions, unresolved, obsolete for this use, inaccessible, or missing.
- Request a model that supplies the missing distinction. If the required distinction cannot be expressed in the available source or supplied semantic model, request
UseFitSemanticModel@Use; do not hide the gap in a mapping rule. - Record dependencies and next results. Identify the exact definitions, editions, authority facts, and gaps consumed by
SIE.4–SIE.10, plus observations that reopen this inventory.
SIE.2:4.2 - Record the Result
| Inventory position | Required content |
|---|---|
| source identity | owning/publishing System, asset or endpoint, profile/module, carrier, location |
| edition and applicability | version/edition, publication, effectivity/configuration/interval, local extension status |
| local semantic endpoints | designation, definition or operative rule, type/relation role, scope, examples/counterexamples, units/codes |
| identifiers | entry and applicable syntax, resolution rule and context or assignment and its authority, use restrictions, entity grain, relevant interval and supported or unresolved referent |
| claims and data | source claim, represented data item, scope/time, uncertainty/status, derivation and provenance |
| authority and access | meaning, identifier, value, extension, access, and receiving-use authority scopes |
| qualification | adequate, conditional, unresolved, obsolete, inaccessible, missing, or model-gap return with reason |
| dependency and reopen | consuming package rows, known gaps, next result, and source/edition/meaning changes that reopen |
SIE.2:4.3 - What Changes in Practice
Mappings are grounded in the recovered source meanings. A later correspondence or transformation can point to exact source-local endpoints and editions, and a failure can return to the owner of the missing meaning, authority, access, or model. An inventory row can be useful even when its disposition is unresolved or inaccessible.
SIE.2:5 - Archetypal Grounding - AP242 and QIF Source Cut
For the AP242/QIF query in SIE.1, the team inventories only source premises that can change the configuration-bound answer.
| Source row | Qualification for the constructed use |
|---|---|
| AP242:2025 edition 4 | Product-definition, configuration/change, and effectivity source for the case. Record the official publication identity and current stage 90.92, “to be revised”. The source owner defines its model; Systems Engineering decides which released configuration applies locally. |
| local AP242 exchange/profile | Record the exact application protocol/profile, implementation conventions, export version, local extensions, identifiers, and configuration/effectivity fields supplied. The standard title alone does not establish those facts. |
| QIF source | Record the applicable ISO 23952:2020 carrier/profile, plan, characteristic, and result meanings, identifiers, measurement context, status, and local quality authority. A QIF result identifier does not establish AP242 feature identity. |
| local source records | Record export or API occurrence, timestamps, derivation, access, issuer, local configuration or inspection status, and gaps. A reachable file is not automatically current or authorized for review. |
The inventory marks an unresolved local AP242 extension used by one feature class. Because its meaning can change the correspondence, the package stops that row and returns to the extension owner. Other rows can continue. If neither AP242 nor QIF can express a required tolerance-state distinction, the inventory requests a qualified UseFitSemanticModel@Use; it does not invent the distinction in the transform.
SIE.2:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | Custody or access is mistaken for semantic or value authority. | Record each authority scope and the evidence for it separately. |
| Architecture | The inventory mirrors the integration platform rather than governed sources. | Identify source assets and meanings independently of the selected realization. |
| Ontology/Epistemology | Term, concept, type, relation, identifier, claim, data, and referent collapse into one “field”. | Use separate inventory positions and preserve unresolved senses. |
| Pragmatics | Exhaustive documentation delays the use without changing it. | Inspect only premises that can change an answer, loss, test, or stop. |
| Didactics | A standards citation is read as proof that the local export conforms or is current. | Record the local profile, occurrence, evidence, extension, and effectivity separately. |
SIE.2:7 - Conformance Checklist
- Every included source can change a named contract position.
- Source asset, carrier, local scheme, semantic endpoint, identifier, claim, data item, and referent remain distinguishable.
- Edition, profile/module, effectivity/configuration/interval, and local extensions are explicit where load-bearing.
- Definitions or operative rules include scope and at least one discriminating example or counterexample where ambiguity matters.
- The source entry, entity grain, relevant interval, restrictions and grounds for resolving it are explicit. For an issued identifier these include the applicable assignment and its authority.
- Claims retain provenance, scope, time, status, and uncertainty without treating provenance as truth.
- Meaning, identifier, authoritative-value, extension, access, and receiving-use authorities remain separate.
- Every row has an adequate, conditional, unresolved, obsolete, inaccessible, missing, or model-gap disposition.
- Consuming rows and reopen conditions are recoverable.
SIE.2:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Data dictionary by column name | Add source-local definition, scope, edition, units/codes, examples, and authority. |
| Standards title as implementation evidence | Inspect the local profile, export, extension, occurrence, and conformance evidence. |
| “Same ID format means same object.” | Recover each entry’s resolution rule and context or assignment and issuer, and state the supported entity, grain and interval. Use SIE.5 for cross-source identity. |
| Provenance equals truth | Keep derivation and source authority separate from domain truth and receiving acceptance. |
| Read every source | Start from the contract and add only action-changing premises. |
| Patch a model gap in code | Return the missing semantic-model result before relying on the rule. |
SIE.2:9 - Consequences
Mappings become reviewable against exact endpoints, and source changes can be traced to the rows that relied on them. Authority, access, and model gaps appear before implementation. The same inventory can support several direct pattern entries while each use retains its own qualification.
The cost is source-local reading and coordination with publishers, stewards, domain specialists, and access owners. Some attractive automation must wait because the source meaning or applicability is unresolved.
SIE.2:10 - Rationale
When constructing an integration, use the meanings recovered from the source to guide mappings that must preserve them. Source-local recovery also prevents a shared vocabulary from becoming a hidden replacement for source authority. Qualification by use keeps the inventory finite and prevents documentation breadth from substituting for a workable package.
SIE.2:11 - SoTA-Echoing
The best-known line combines terminology work, metadata-registry discipline, provenance, and source-local meaning recovery. The serious default is schema inspection plus organizational folklore. Its defect is not informality alone; it leaves no stable relation among the source claim, edition, authority, and mapping premise. SIE.2 adapts the line into a use-qualified manifest with an explicit inadequate-model return.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
Current FPF F.0.1 and F.0.2 | adopt | Recover source-local meaning and episteme identity; do not establish a cross-source correspondence or domain truth. |
| ISO 704:2022 | adapt | Distinguish objects, concepts, definitions and designations with ISO 704. Use the receiving contract to decide which distinctions the integration must preserve. |
| ISO/IEC 11179-3:2023 and its item-mapping amendment | adapt | Contribute registry-item identity, versions, definitions, and mapping metadata; no automatic cross-source identity or fitness follows. |
| PROV-O | adapt | Distinguishes entities, activities, agents, derivation, revision, invalidation, attribution, and primary source; provenance establishes neither truth nor permission. |
| schema-only discovery | reject as sufficient | Structure and samples can locate questions but cannot replace source-local meaning, edition, authority, and applicability. |
Reopen when a source change alters a relied-on meaning, scheme, edition, effectivity, authority, access condition, or provenance chain, or when repeated cases show that an inventory position cannot support the downstream decision.
SIE.2:12 - Relations
SIE.1supplies the receiving use, source cut, answer claims, preserved distinctions, and stop conditions.SIE.3qualifies an available model for the named use or develops a missing distinction. Request that result when the recovered source model leaves the integration’s model question unsettled.SIE.4,SIE.5, andSIE.6consume exact endpoint meanings, source claims, identifiers, editions, and authority limits.SIE.7–SIE.10consume the manifest, provenance, currentness, and gap dispositions relevant to implementation and validation.- Domain sources, MDM, access owners, Systems Engineering, Data Engineering, and applications retain their respective meanings, values, permissions, operational results, and decisions.
SIE.2:End
SIE.3 - Construct or Reuse a Semantic Model for a Named Use
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
UseFitSemanticModel@Use: a reused, extended, or constructed semantic model qualified for the questions and distinctions that its receiving use requires.
SIE.3:1 - Problem Frame
Use this when an integration needs to express a meaning or answer a question and the adequacy of its available models is unsettled. For example, a source describes an inspection requirement, while the receiving query needs to distinguish that requirement from an observation of a particular configured feature.
Start with one question the model must help answer and examples of answers that would count as different. Ask the domain participants to explain those distinctions before choosing an encoding. The first useful result can be confirmation that an existing model is sufficient, with its applicable edition and use conditions.
The object is the semantic model for that use: its concepts, relation meanings, constraints, and relevant commitments. The practical gain is a model whose distinctions can guide correspondence and mapping work. A stronger claim, such as adequacy for additional questions or valid inference in a formal language, needs evidence for those additional conditions.
If the supplied model is qualified for the unchanged use, reuse that result. If the only open question is a correspondence between adequately understood source meanings, use SIE.4. A new integration endpoint alone does not create a model-construction requirement.
SIE.3:2 - Problem
Available models often look adequate because their terms resemble the receiving question. A field named inspection may cover a plan, a requirement, an occurrence, or a result. Mapping every such field to one class can remove the distinction the receiver needs.
The opposite failure is to construct a larger ontology whenever a model question arises. That incurs design and maintenance work even when an existing model can answer the question. Both failures begin before formalization: the required meaning and its useful boundary have not been established.
SIE.3:3 - Forces
| Force | Tension |
|---|---|
| Reuse | Existing meanings and tools save work, while an unrecognized gap can invalidate the receiving answer. |
| Domain understanding | Participants know their practice, while familiar words can hide different concepts, grains, or temporal commitments. |
| Expressiveness | Richer formalization can support useful inference, while its cost and restrictions may exceed the use. |
| Modularity | An extension can preserve reusable content, while incompatible commitments may require a different model. |
| Maintenance | Consumers need a stable reference, while the domain and its required questions can change. |
SIE.3:4 - Solution
Select or develop only the semantic content needed for the named use. Qualify it through discriminating cases and make its maintained edition accessible to the consumers who will rely on it.
SIE.3:4.1 - Pattern-Use Unfolding
- State the questions and answer distinctions. Use competency questions or an equivalent plain description. Name the subject, grain, configuration or interval where relevant, expected answer, and a counterexample. Work with domain participants at a level where they can explain the distinction. Separate a useful model question from a request to choose a storage or diagramming tool.
- Recover the available meanings. Use the relevant SIE.2 results or directly supplied source meanings. Inspect candidate models’ definitions, relations, constraints, examples, edition, access, and maintenance conditions where those can affect the use. Source labels alone cannot settle suitability.
- Try sufficient reuse. Replay the required questions and counterexamples against an available model. When its content and applicable conditions suffice, return that model and the qualification. This completes the Method. Leave an uncovered question explicit if a permitted narrower use can continue.
- Locate the gap. Identify the missing distinction, relation, constraint, or incompatible commitment. Extend a module when the addition can preserve the existing commitments that consumers still use. Construct a different model when reuse or such an extension cannot supply the required content. Keep the reason tied to the gap.
- Develop the meaning before encoding it. Define the needed concepts and relations, their domains of application, and the grain or temporal interpretation required by the question. Show examples and counterexamples to domain participants. Preserve a source disagreement that affects use; SIE.4 can establish a qualified correspondence between different meanings.
- Choose sufficient formalization. A maintained vocabulary and relation description can be enough for some uses. Select a formal language or profile when exchange, constraints, or inference require its semantics. Check the properties claimed under that choice as well as the domain cases. Repair or qualify a model that passes an encoding check but answers the domain question incorrectly.
- Return a maintained, use-qualified model. Identify the edition or stable content, covered questions, material limits, and the access and maintenance arrangement its consumers need. Return its meanings to correspondence or mapping work and its cases and qualifications to validation. A missing authoritative definition can leave one question unresolved while independently supported questions finish.
A small model can express these obligations in one short maintained description. When formalizing the model, obtain the assurance the selected language and use require. Formalization does not change which domain question the model must answer.
SIE.3:4.2 - Record the Result
| Result position | Content needed by the receiver |
|---|---|
| Named use | Questions, expected answer distinctions, and applicable subject, grain, time, or configuration. |
| Selected model | Reused model or developed module, its edition, definitions, relation meanings, and required commitments. |
| Reuse or development decision | The adequacy evidence, or the gap that justified an extension or different model. |
| Qualification | Covered cases, counterexamples, limits, unresolved questions, and any selected formal checks. |
| Continued reliance | Access, maintenance responsibility, relied-on source conditions, and change conditions that can reopen the result. |
The result can refer to an existing qualified model instead of reproducing it. Record a reason only where it helps a consumer interpret or rely on the selection.
SIE.3:4.3 - What Changes in Practice
The integrator can explain why the model distinguishes two answers, or why an existing distinction is sufficient. A mapping author receives meanings and cases rather than an unexplained class list. Model construction becomes a response to a demonstrated gap.
SIE.3:5 - Archetypal Grounding
SIE.3:5.1 - Reuse for Provider Availability
The receiving interface returns separately attributed provider quantities. Its questions are “How much is on hand now?” and “How much can this provider promise under its reservation and time-horizon rules?”
An available model distinguishes both measures, their provider, unit, observation time, and relevant horizon. The integrator checks the following cases:
| Case | Required model interpretation |
|---|---|
| Provider A reports 12 on hand; provider B reports 9 available to promise. | Two qualified quantities with distinct measure meanings. |
| Both values equal 12. | Numerical equality does not remove the difference between the measures. |
| The provider changes the promise horizon. | The horizon remains part of the promise meaning used by the receiver. |
The model represents these cases and has suitable access and maintenance conditions. The completed result references that edition for the two questions. It supplies no common quantity formed by adding the values; that operation would require a separately justified receiving meaning.
SIE.3:5.2 - Extend an Inspection Model
A constructed product-definition and inspection integration asks: “What observation concerns requirement Q for feature F in configuration R?” The source model already describes the feature and its requirement, but represents no actual observation.
| Model content | Development and case |
|---|---|
| Existing feature and requirement | Reuse their qualified definitions and configuration applicability. |
| Observation | Add a way to represent an observation of the configured feature separately from its plan and the requirement being checked. |
| Observation relation | State which configured feature and applicable requirement it concerns. |
| Unit and time | Express the interpretation required for this observation and question. |
| Counterexamples | A planned inspection is not an observation; an observation of another configuration does not answer this question. |
The domain participants confirm those distinctions and identify any unresolved source-specific interpretation. The module can then supply SIE.4 and SIE.7 with the required meanings. In an AP242/QIF installation, its actual profiles, configuration relations, and inspection meanings must come from the qualified source results; the constructed model above is the working example, not a claim about a particular exchange’s conformance.
SIE.3:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | One participant’s preferred vocabulary silently becomes the shared meaning. | Obtain the meanings needed by the receiving use and preserve unresolved authority or source disagreement. |
| Architecture | A platform choice determines the model’s concepts. | State the questions and distinctions before selecting formalization or realization. |
| Ontology/Epistemology | Requirement, plan, observation, and result collapse because they share a label. | Use a counterexample that changes the receiving answer. |
| Pragmatics | A new ontology is built despite adequate reusable content. | Try the existing model and finish when the use is supported. |
| Didactics | A formal diagram appears sufficient without a working example. | Show how the model answers the question and excludes its counterexample. |
SIE.3:7 - Conformance Checklist
- The receiving questions and material answer distinctions are recoverable.
- Available model content is compared with those questions before development is selected.
- Sufficient reuse can complete the result.
- Developed content answers an identified gap and preserves relied-on commitments or qualifies the affected use.
- Domain examples and counterexamples support the claimed scope.
- Formal checks match the selected encoding and claimed inference or exchange use.
- The receiver can identify and access the maintained model and its limits.
SIE.3:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Model from familiar labels | Recover relation meanings and replay a discriminating question. |
| Construction as proof of progress | Return adequate existing content when it supports the use. |
| Hidden repair in a transformation rule | Develop the missing semantic distinction and give the rule a qualified premise. |
| Language validity used as domain adequacy | Check the domain answer as well as the selected formal properties. |
SIE.3:9 - Consequences
A qualified model makes correspondence and mapping decisions more explicit and reusable. Small integrations can finish with a small model. Extensions expose their commitments to later consumers.
The work costs domain conversation, example construction, and any formal checks the chosen use requires. Some questions remain unresolved until a source owner supplies a needed meaning. Larger scope creates additional content and maintenance obligations.
SIE.3:10 - Architectural Rationale
Questions and counterexamples locate the distinctions that an integration must preserve. Reuse is therefore judged by its contribution to the question; extension is justified by a specific gap. Keeping model content, its maintained edition, its formal encoding, and its instances distinct makes both adequacy and later change easier to assess.
SIE.3:11 - SoTA-Echoing
How can you determine whether an available model is adequate for the receiving questions? For the inspection question in §5.2, the selected starting line is requirements-led model qualification: recover the distinction between requirement, plan, and observation, try the available meanings, and develop only the gap that survives that trial. This adapts LOT and its maintained resources.
A serious alternative for that same unsettled question is to develop the model together with a small knowledge-graph prototype, adapting the ontology-and-graph work described by LOT4KG. The prototype can reveal a missing relation when the receiving query is executed. Compare a bounded prototype with bounded model qualification, rather than charging it for a complete production platform:
| Answer to the same inspection-model question | Comparable work and useful evidence | Choice and accepted trade-off |
|---|---|---|
| Qualify or extend the model before selecting its realization | Examine the required definitions with domain participants and replay the requirement/plan/observation, configuration, unit, and time cases. Keep the model and cases sufficient for that query. | Adapt LOT in §4.1.1–5 and §5.2. This settles the semantic distinction without choosing graph encoding or query machinery. It supplies no evidence that an executable mapping or query is correct; SIE.7 and SIE.10 still need that evidence for their own claims. |
| Qualify the model through a small graph and executable query | Examine the same definitions and cases, then encode representative instances and the query. This adds encoding and execution work but can expose errors that a prose-only model trial misses. | Adapt the LOT4KG route when execution can settle an uncertainty material to model adequacy, especially when graph realization is already selected. In §5.2, the first unresolved issue is what counts as an observation; executing a query over a class that also includes plans cannot settle that domain meaning. The model-first route is selected for that issue, accepting deferred execution evidence. |
The comparison is qualitative and scoped to the same questions and counterexamples. A prototype’s additional effort earns its place when it can change the qualification. Neither route can replace domain meaning with successful execution.
The remaining contributions constrain that choice:
| Source and comparison role | Operative move and limit |
|---|---|
| LOT supplies the selected requirements, development, publication, and maintenance line. | Adopt domain questions and participant validation; adapt §4.1.3 and §4.1.7 so sufficient reuse can finish and the receiver can rely on a maintained model. The source does not decide local meanings or establish this model’s adequacy. |
| LOT4KG supplies the coupled ontology/graph alternative. | Adapt its separation of ontology work and graph construction to the comparison above; reject treating graph construction as the only way to qualify a model. Its description explains how to try this alternative. A claim that it outperforms model-first qualification needs comparative evidence. |
| OWL 2 Overview supplies language and profile choices when formal semantics matter. | Adapt §4.1.6: check the properties claimed for the chosen language as well as the domain cases. Encoding validity cannot replace the model-adequacy question. |
| The public ISO/IEC 21838-1 scope supplies a possible top-level basis. | Adapt §4.1.2/6 only when that basis contributes needed coherence. It establishes neither a universal upper-ontology requirement nor local maintenance and versioning rules. |
Reopen the comparison if one required answer depends on a selected query or inference behavior that the model-only trial cannot settle, if a bounded prototype exposes a missed distinction, or if an available model can now answer the same cases with less qualification work. Return only to the affected question and §4.1.2–6. A qualified model for an unchanged use remains the sufficient direct result in §4.1.3.
SIE.3:12 - Relations
- SIE.1 supplies the receiving question, preserved distinctions, and permitted scope.
- SIE.2 supplies source meanings and identifies model gaps.
- SIE.4 uses model meanings to establish qualified correspondences; SIE.7 uses them in executable mappings.
- SIE.10 validates the integration’s claimed receiving result using the relevant model qualification.
- SIE.11 follows a changed model premise to affected uses. Use SIE.12 when independently governed participants depend on shared semantic modules and need arrangements for maintaining them.
- FPF terminology, kind, relation, and evidence guidance constrains the corresponding model claims; domain participants supply the problem-specific meanings.
SIE.3:End
SIE.4 - Judge Cross-Source Correspondences and Their Permitted Uses
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
QualifiedCorrespondenceSet@Usewhose rows identify exact source-local endpoints, relation or incompatibility, orientation, bounded use, permitted loss, justification and evidence, source versions, counterexamples, confidence where meaningful, and accepted, rejected, unresolved, or incompatible disposition.
SIE.4:1 - Problem Frame
Use this when two or more governed sources contain concepts, types, relations, fields, codes, model elements, or claims that appear to match and a receiving use needs their relation made explicit. Typical triggers are a shared label, a crosswalk, an automated matcher result, a spreadsheet of “equivalences”, or a model-to-model mapping whose semantic premise has never been judged.
For one cross-source correspondence row and its named use, recover both endpoint senses and ask which direct relation, difference, or incompatibility is supported. The first result is a set that preserves accepted, rejected, unresolved, and incompatible rows rather than forcing every candidate into an equivalence.
The payoff is a defensible semantic premise for identity work, claim composition, executable mappings, and validation. Do not use SIE.4 to construct a missing semantic model, decide cross-source identity, define transformation code, or choose the authoritative value. A local relation inside one governed source remains with its source owner unless the cross-source use makes it an integration premise.
SIE.4:2 - Problem
Correspondence candidates are cheap. Labels can be normalized, lexical similarity scored, hierarchies compared, and model structures aligned. Yet “similar”, “related”, “narrower”, “same field name”, and “safe to substitute here” answer different questions. A row can state a relation correctly even when using it would lose a distinction the receiver needs.
When candidate generation and qualification collapse, downstream mapping code inherits an unstated ontology and loss policy. Counterexamples are discarded as data-quality defects, source versions disappear, and a reviewer cannot tell whether the relation itself or only its use is unsupported.
SIE.4:3 - Forces
| Force | Tension |
|---|---|
| Automation | Matchers can surface many candidates, while their scores do not establish relation truth or permitted use. |
| Reuse | A general crosswalk is attractive, while relation adequacy can change with receiver, grain, interval, and accepted loss. |
| Precision | Naming the relation the evidence supports avoids claiming more, even when the sources do not fully characterize it. |
| Coverage | Pressure favors filling every row, while unresolved and incompatible rows can be the most decision-useful result. |
| Direction | Transformation needs an orientation, while many conceptual relations are not symmetric or safely reversible. |
| Versioning | Stable mapping identifiers aid reuse, while endpoint meaning can change across source editions and profiles. |
SIE.4:4 - Solution
Separate candidate discovery, direct relation judgment, and bounded-use qualification. For each row, identify exact source-local endpoints, state the relation or incompatibility and orientation, justify it with evidence and counterexamples, then decide whether that relation may support the named use under a stated loss boundary. Keep the direct relation and its use qualification independently inspectable.
SIE.4:4.1 - Pattern-Use Unfolding
- Take the question from the contract. State the receiving answer and why this endpoint relation can change it.
- Bind exact endpoints. Reference the
SIE.2source rows, schemes, definitions, editions, profiles, effectivity, units, codes, and local extensions. Do not map labels without their senses. - Generate candidates without promotion. Lexical, structural, instance, expert, historical, or matcher evidence may nominate a row. Record the candidate source and score where useful, but do not treat nomination as acceptance.
- State the direct relation or difference. Use the narrowest warranted relation vocabulary. State direction and whether the inverse, symmetry, or transitivity is supported. If no positive relation is established, choose rejected, unresolved, or incompatible with reason.
- Test examples and counterexamples. Include instances or cases that should satisfy the relation and cases that distinguish endpoints, including version, unit, code, granularity, lifecycle, and authority differences.
- Qualify the receiving use. State which substitution, comparison, join, navigation, or transformation the row permits, what semantic loss it introduces, and which uses remain forbidden.
- Preserve evidence and authority. Record justification, evidence source, reviewer or domain authority where required, uncertainty or confidence, and the owner of any unresolved domain judgment.
- Assign a row disposition. Use accepted-for-use, accepted-with-loss, rejected, unresolved, or incompatible. A row can state a true broader/narrower relation yet be rejected for this use.
- State dependencies and tests. Name whether
SIE.5,SIE.6, orSIE.7consumes the row, plus a test or observation that reopens it.
SIE.4:4.2 - Record the Result
| Correspondence position | Required content |
|---|---|
| row identity and use | stable row identifier, receiver/use, consuming result |
| source endpoint | source, scheme/model, exact sense, edition/profile/effectivity, identifier |
| target endpoint | source, scheme/model, exact sense, edition/profile/effectivity, identifier |
| direct relation | relation or explicit difference/incompatibility, orientation, inverse/symmetry/transitivity qualification |
| use qualification | permitted operation, accepted loss, forbidden reuse, conditions |
| warrant | candidate origin, justification, evidence, authority, uncertainty/confidence where meaningful |
| challenge | positive examples, counterexamples, negative/unlike cases |
| disposition and continuation | accepted-for-use, accepted-with-loss, rejected, unresolved, incompatible; downstream reference and reopen condition |
SIE.4:4.3 - What Changes in Practice
The team stops treating a mapping spreadsheet as a bag of equalities. A matcher result becomes a candidate; a domain judgment becomes a relation warrant; and a receiving-use decision states what the relation may safely support. Unresolved and incompatible rows remain visible to the interface and tests.
SIE.4:5 - Archetypal Grounding - Product Feature and Inspection Characteristic
In the AP242/QIF application, the lexical candidate feature ↔ characteristic is too broad. The source inventory distinguishes an AP242 product-definition feature, a QIF inspection characteristic, the plan relation that applies a characteristic to a feature, and a measured result concerning that characteristic.
| Candidate row | Direct relation judgment | Use qualification and disposition |
|---|---|---|
AP242 feature F-17 ↔ QIF characteristic C-17 | not identity and not class equivalence; the QIF plan asserts that C-17 concerns the identified product feature under configuration/effectivity R/E | accepted-for-use as a directed inspection-characteristic-concerns-feature relation only after SIE.5 qualifies the feature endpoint; no reverse substitution |
AP242 feature type hole ↔ QIF characteristic type diameter | a diameter characteristic can characterize some holes, but the types are neither equal nor simply broader/narrower | accepted-for-use for navigation from a selected plan row with a qualified feature endpoint to its linked hole feature and diameter characteristic. Return their separate source identifiers and types with the plan relation; forbidden as a global type crosswalk |
AP242 feature F-22 ↔ QIF characteristic C-99 | the candidate arose from a shared local label; effectivity and plan evidence do not support the relation | rejected; the interface returns unmatched rather than joining |
| legacy feature class ↔ current QIF characteristic class | one local extension lacks an authoritative definition | unresolved and stopped for dependent mapping; return to the extension owner |
The set records endpoint editions and counterexamples such as a non-dimensional inspection characteristic and a feature absent at effectivity E. It establishes semantic premises; it does not decide that identifiers denote the same entity or specify executable joins.
SIE.4:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | A matcher or integrator silently becomes the domain relation authority. | Record the warrant, decision scope, and required domain authority for each accepted row. |
| Architecture | Available mapping technology limits the relation vocabulary. | State the semantic relation first; choose its carrier later. |
| Ontology/Epistemology | Similarity, correlation, broader/narrower relation, and equivalence collapse. | Use the narrowest supported relation and preserve uncertainty and counterexamples. |
| Pragmatics | Every possible endpoint pair is reviewed. | Restrict rows to relations that can change the contract or a dependent result. |
| Didactics | Direction arrows are read as a mandatory processing order. | Explain orientation as relation or transformation meaning, not lifecycle sequence. |
SIE.4:7 - Conformance Checklist
- Every row serves a named receiving use and consuming result.
- Both endpoints reference exact source-local senses and applicable editions/profiles.
- Candidate generation is distinguishable from relation judgment.
- The direct relation, difference, or incompatibility uses the narrowest warranted kind and states orientation.
- Inverse, symmetry, and transitivity are not inferred without support.
- Positive examples and discriminating counterexamples are present where load-bearing.
- Permitted operation, semantic loss, conditions, and forbidden reuse are explicit.
- Evidence, uncertainty/confidence, and decision authority are inspectable.
- Rejected, unresolved, and incompatible rows remain available to downstream interfaces and tests.
- The set claims neither cross-source identity nor executable transformation by implication.
SIE.4:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Same label, therefore same meaning | Recover endpoint senses and test counterexamples. |
| Matcher score as truth | Treat the score as candidate evidence; obtain a relation warrant and use decision. |
Every relation is sameAs | Distinguish identity, equivalence, broader/narrower, related, concerns, transforms-to, difference, and incompatibility. |
| One global crosswalk | Qualify rows by use, source editions, loss, and forbidden reuse. |
| Symmetric spreadsheet mapping | State orientation and test whether the inverse is supported. |
| Delete failed rows | Retain rejected, unresolved, and incompatible dispositions for receiver and validation behavior. |
SIE.4:9 - Consequences
The correspondence set gives mapping and interface work explicit semantic premises and preserves negative results. It makes version and loss dependencies visible and allows a narrow use to proceed while other rows remain unresolved.
The cost is row-level judgment and counterexample work. Automated matchers remain useful for candidate discovery but cannot close the relation or its receiving-use qualification alone.
SIE.4:10 - Rationale
A direct relation and permission to use that relation answer different questions. Keeping them separate allows a true relation to be rejected for a loss-sensitive use and a qualified narrow relation to support one operation without being promoted globally.
SIE.4:11 - SoTA-Echoing
The best-known line combines explicit relation vocabularies, mapping metadata, alignment evaluation, and direct Bridge truth. The serious default is a two-column crosswalk plus confidence score. Its defect is that it hides endpoint senses, relation algebra, bounded-use loss, and counterexamples. SIE.4 adapts current mapping practice into a set that records negative dispositions and qualifies each relation for its receiving use.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
Current FPF F.9 | adopt | Governs each direct cross-context Bridge and separate bounded-use claim; a package row must not replace Bridge truth. |
| SKOS Reference | adapt | Supplies distinct mapping relation forms and cautions through their semantics; SKOS does not prove a candidate relation or authorize substitution. |
| SSSOM 1.0 | adapt | Contributes inspectable subjects, predicates, objects, provenance, justification, confidence, and source versions; metadata completeness is not relation truth. |
| OAEI 2025 results | adapt | Demonstrate task- and track-dependent alignment evaluation; benchmark performance does not decide a local row. |
| label-only or score-only crosswalk | reject as sufficient | It can nominate candidates but cannot establish endpoint senses, relation, permitted loss, or authority. |
Reopen when an endpoint meaning or edition changes, a counterexample defeats the relation or use qualification, the receiver’s loss boundary changes, or a better relation vocabulary materially changes action.
SIE.4:12 - Relations
SIE.2supplies exact endpoint senses, editions, profiles, authority limits, and model gaps.SIE.3is a conditional return when available models cannot express a required endpoint distinction.SIE.5consumes rows that expose a load-bearing cross-source identity question.SIE.6uses correspondences to decide which source claims are comparable or composable without erasing scope or conflict.SIE.7consumes only accepted rows under their stated use and loss conditions; it adds executable transformation semantics.SIE.10tests correspondence truth and use qualification independently from mapping execution.
SIE.4:End
SIE.5 - Resolve Cross-Source Identity without Erasing Identifier Authority
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
CrossSourceIdentityDisposition@Usethat states, for each load-bearing endpoint pair or set, the required entity grain and interval, identity-related disposition, the source entries, the rules and contexts or assignments and issuers that resolve them, evidence, authority boundary, unresolved cases, and the exact mappings, claim compositions, interfaces, and tests that may consume it.
SIE.5:1 - Problem Frame
Use this when an integration needs to decide whether records or identifiers from different sources concern the same entity, a part, a version, a variant, an alternate description, a family, or different or unresolved entities. The recognizable failure is a join, merged key, or sameAs assertion that makes identifiers appear unified while erasing their issuers, grains, intervals, and authority.
For one bounded cross-source identity question, state the entity grain and time or effectivity interval at which sameness matters for the named use. The first result is a disposition that downstream work can inspect and challenge without replacing source identifiers or master-data authority.
The payoff is that the integration can join only warranted cases, identify which branches remain unresolved, and preserve source trace. Do not use SIE.5 to create identifiers, choose enterprise master identity or survivorship, decide authoritative values, or prove a source claim true. Those decisions remain with identifier owners, MDM, or the direct domain authority.
SIE.5:2 - Problem
The same real-world item can carry manufacturer, supplier, enterprise, lot, serial, package, event, and temporary process identifiers. Conversely, the same character string can be reused by different issuers or at different times. Version, configuration, part-whole, and alternate-description relations can be mistaken for identity because they support some joins.
If an integration collapses those distinctions, the merged record no longer shows which source made each claim, the identifier it used, or the time and issuer rules that qualify that use. Contradictory events appear to concern one thing without evidence, and a master key silently becomes a domain decision.
SIE.5:3 - Forces
| Force | Tension |
|---|---|
| Joinability | A common key makes computation easy, while premature merging can create false identity and irreversible provenance loss. |
| Grain | Receivers want one “item”, while wafer, die, device, package, lot, feature, version, and event answer different questions. |
| Time and effectivity | Identity may be stable across one interval, while reuse, replacement, split, merge, and revision change the warranted claim. |
| Authority | Identifier issuers and master-data stewards govern different schemes and decisions; crosswalk custody transfers neither authority. |
| Incomplete evidence | A bounded decision is needed, while some pairs must remain unresolved without blocking independent rows. |
| Reuse | A disposition can help several mappings, while its grain, interval, and use boundary prevent blanket equivalence. |
SIE.5:4 - Solution
Frame identity as a source-qualified, grain- and interval-specific disposition for one receiving use. Preserve every source identifier and the applicable context or assignment, including its issuer when it was issued. Compare the entity criteria, relation evidence, version/effectivity, and authoritative decisions that matter. Return same, different, part, version, variant, alternate-description, family, or unresolved only at the precision supported; do not force every useful relation into identity.
SIE.5:4.1 - Pattern-Use Unfolding
- Name the receiving identity question. State which mapping, claim composition, query, or decision needs an identity premise and what a wrong merge or split would change.
- Fix entity grain and interval. Name the relevant individual or occurrence kind, part-whole level, version/configuration, lifecycle state, jurisdiction or organization, and time/effectivity interval.
- Resolve each source entry. Use SIE.2 to establish what each entry can designate. Recover its assignment and issuing authority when it was issued, or the rule and context used to interpret it. Retain the applicable syntax, restrictions, source edition and provenance. If the evidence leaves several candidates or fails to identify one, record that outcome.
- Separate candidate relation kinds. Consider same individual at the stated grain, different individuals, part/whole, earlier/later version or specialization, variant, alternate description, an individual satisfying a type criterion, or membership in a declared product family. Keep the relation unresolved if more than one reading still fits. Do not use one boolean until the use needs only that distinction.
- Collect discriminating evidence. Use issuer records, source assertions, configuration/effectivity, provenance, physical or domain characteristics, event histories, and counterexamples. A shared string or co-occurrence is only candidate evidence.
- Recover authority. Identify who may bind a source identifier, govern the master identity, decide authoritative values or establish the domain relation. SIE records the disposition for its stated use under those authorities.
- Assign the narrowest warranted disposition. State conditions, confidence or uncertainty where meaningful, rejected alternatives, and unresolved evidence. Preserve source IDs even for accepted same-entity rows.
- Link consumers to the identity disposition. Reference the disposition from every mapping, claim composition, interface row, and identity test that relies on it. Never copy only the merged key.
- Test difficult cases and reopen. Include identifier reuse, split/merge, version/configuration change, part-whole confusion, contradictory source events, and absent-link cases. State the source or observation change that reopens the row.
SIE.5:4.2 - Record the Result
| Identity position | Required content |
|---|---|
| identity question and use | receiver, dependent action, wrong-merge/wrong-split consequence |
| entity boundary | kind and grain, part-whole level, version/configuration, interval/effectivity, relevant context |
| source identifiers | each source entry, the supported referent, remaining candidates or unresolved designation, the relevant rules and context or the assignment and its issuer, restrictions, edition and provenance |
| candidate relations | same, different, part, version/specialization, variant, alternate description, family, unresolved alternatives |
| warrant | evidence, counterevidence, counterexamples, uncertainty/confidence, rejected alternatives |
| authority | scheme-local, master-data, domain, and receiving-decision scopes |
| disposition | narrowest warranted relation or unresolved result, conditions, source-ID preservation rule |
| downstream and reopen | mapping/composition/interface/test references and the change or observation that reopens the disposition |
SIE.5:4.3 - What Changes in Practice
The integration stops minting a common key as proof of identity. Every load-bearing join points to a disposition with grain, interval, source identifiers, evidence, and authority. Unresolved identity becomes an explicit interface and validation branch instead of a row silently dropped or merged.
SIE.5:5 - Archetypal Grounding - Semiconductor Recall Trace
A recall-triage query crosses a wafer identifier from a fabrication source, die coordinates, device serials, package identifiers, supplier lot identifiers, GS1 event identifiers, and an enterprise material master. The receiving question is whether a shipped device can be traced to an affected fabrication lot.
| Endpoint question | Constructed disposition |
|---|---|
wafer W-204 and supplier lot L-88 | not identity; the supplier record asserts that the wafer is a member/output associated with the lot under a bounded process interval. Preserve both identifiers and relation provenance. |
die coordinate (x17,y9) on wafer W-204 and device serial D-771 | same physical die/device at the selected post-singulation grain only when the packaging event and issuer records connect them; accepted with interval and event evidence. |
device serial D-771 and package code P-55 | unresolved because the package identifier is reused after rework and the event history lacks effectivity. Stop the dependent trace branch. |
enterprise material master M-12 and device serial D-771 | The master record describes a product class and carries the enterprise attributes it governs. To classify the particular device, establish that it meets the class criterion. Membership in a catalogue family would require the catalogue’s own grouping rule. The master and the device each retain their identity. |
GS1 event E-901 and device D-771 | event and object are different entities; the event may concern the device. Never merge their identifiers. |
Tests cover reused package identifiers, a die split/merge error, contradictory supplier events, a missing cross-enterprise link, and a later correction. The interface returns supported trace segments and the unresolved P-55 branch. MDM or the domain steward may later decide a master identity; SIE.5 has not done so.
SIE.5:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | The integration registry becomes the de facto master-data authority. | State the bounded disposition and retain MDM/domain decision ownership. |
| Architecture | One canonical key is required because the platform prefers it. | Carry a surrogate technical key only with source IDs and the identity disposition it indexes. |
| Ontology/Epistemology | Same individual, part, version, variant, alternate, and family relations collapse. | Fix grain and interval, then choose the narrowest warranted relation. |
| Pragmatics | Every identifier pair receives a costly adjudication. | Decide only pairs that are load-bearing for the receiving use; leave independent rows untouched. |
| Didactics | “Same” is read as timeless universal identity. | Display conditions, interval/effectivity, scheme, and forbidden reuse beside the disposition. |
SIE.5:7 - Conformance Checklist
- The receiving action and wrong-merge/wrong-split consequence are named.
- Entity kind, grain, part-whole level, version/configuration, and interval/effectivity are explicit.
- Each entry can be traced to its source and edition. The rule and context or the assignment and its issuer, the restrictions and the available evidence support the stated result, including an unresolved result.
- Useful non-identity relations are not compressed into a boolean same/different field.
- Shared strings, co-occurrence, and crosswalk membership are treated only as candidate evidence.
- Evidence, counterevidence, counterexamples, and uncertainty are inspectable.
- Scheme-local, master-data, domain, and receiving-decision authority scopes remain separate.
- Accepted same-entity rows do not delete source identifiers.
- Every dependent mapping, composition, interface, and test references the disposition.
- Reuse, split/merge, version/configuration, part-whole, contradiction, and absent-link cases are tested where applicable.
SIE.5:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Same string, same entity | Resolve each entry under its own assignment or contextual rule, then compare the entities at the required grain and interval using evidence for the claimed relation. |
Universal sameAs | Use the narrowest relation and record unresolved or different cases. |
| Master key by integration fiat | Return master-identity and survivorship decisions to their authority. |
| Version equals object | State whether the use concerns one continuing entity, a version-specific configuration, or a relation among them. |
| Part joined as whole | Fix the entity grain and preserve part-whole relations explicitly. |
| Drop unresolved rows | Expose them as interface and validation branches with dependent actions. |
SIE.5:9 - Consequences
The package can join warranted identities without losing source trace and can stop only the branches that depend on unresolved identity. Corrective source or steward decisions can be replayed against explicit consumers. The method also reveals when the useful relation is part, version, membership, or event participation rather than identity.
The cost is domain evidence and authority work. Some convenient global keys remain technical indexes rather than semantic truths, and some desired traces return incomplete.
SIE.5:10 - Rationale
A formation rule determines whether an identifier is well formed. For each entry, recover what its source establishes under the applicable rule, context or assignment. Then ask what the evidence establishes about the relation at the required grain and interval. A record of reassignment can link two entries to the same entity before its serial number is known. Where the evidence permits several identities, preserve those alternatives. Retaining the source entries allows the engineer to reconsider the result as new evidence appears. Master-data and domain decisions remain with their responsible authorities.
SIE.5:11 - SoTA-Echoing
The best-known line combines explicit identifier ownership and restrictions, provenance-qualified alternate/specialization relations, and domain traceability practice. The serious default is entity resolution that optimizes a match score or golden record. The problem arises when the score or merged record obscures grain, issuer, interval or decision authority. SIE.5 uses these contributions to return a bounded disposition for the work that relies on identity.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
| Current FPF identity and relation law | adopt | Keeps identity and direct relations as explicit claims; generic law does not decide a domain pair. |
| ISO 8000-115:2024 | adapt | Contributes identifier owner, use restriction, semantics, and resolution inputs; excludes identifier creation, query/response syntax, and resolution method and does not decide equivalence. |
| PROV-O | adapt | Supplies specialization, alternates, derivation, attribution, revision, and invalidation relations useful to evidence; provenance relations are not blanket identity. |
| SEMI traceability standards and GS1 EPCIS 2.0.1 | adapt | Supply semiconductor and event-based identity/traceability probes; scheme use does not create enterprise master identity or authorize recall. |
| golden-record or score-only merging | reject as sufficient | It may support candidate generation or a steward decision. Preserve source identifiers, relation kinds and authority. |
Reopen the affected dispositions when an issuer reassigns one code, or when a change to a formation or resolution rule alters which entries a query can accept or resolve. New event or configuration evidence, a changed grain or interval, and repeated failures to express an action-changing relation can also reopen the result.
SIE.5:12 - Relations
SIE.1supplies the receiving action, identity-sensitive answer claims, loss boundary, tests, and stop.SIE.2supplies the source entries with the contexts for their rules or the issuers of their assignments, restrictions, source claims, editions, provenance and authority gaps.SIE.4may expose an identity question but does not answer it merely by accepting a semantic correspondence.SIE.6consumes identity dispositions when composing claims about the same bounded entity; it preserves contradictory claims separately.SIE.7andSIE.9reference dispositions rather than copying only merged keys.SIE.10tests every load-bearing identity premise. MDM and domain authorities retain master identity, authoritative values, and action.
SIE.5:End
SIE.6 - Fuse Source-Qualified Claims without Erasing Conflict
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
SourceQualifiedClaimFusion@Usethat preserves each source claim, subject and any relied-on identity premise, scope, interval, authority, uncertainty, derivation, and relation to other claims, then returns a qualified view, explicit conflict, non-comparability, or unresolved result for one receiving use.
SIE.6:1 - Problem Frame
Use this when a receiving answer must combine claims from separately governed sources and a simple union, priority rule, average, overwrite, or “golden record” would hide differences in meaning, subject, time, authority, or uncertainty. The recognizable failure is one clean value whose provenance can be displayed but whose conflict or non-comparability can no longer be recovered.
For one receiving question, state the source claims and the subject relation it requires. The first result is either a qualified view with its derivation or a conflict, non-comparability or unresolved branch.
The receiver can interpret the answer and its grounds. Do not use SIE.6 to decide domain truth, authoritative value, survivorship, risk acceptance, or action. The authorized domain or receiving participant may use the composition to choose. Preserve the basis for that choice.
SIE.6:2 - Problem
Claims that share a field name can concern different concepts, entities, grains, intervals, or authority scopes. Claims that do concern the same entity can disagree without either being malformed. A timestamp does not settle whether one claim supersedes another; a source rank does not explain why the rank applies; and an average can be meaningless across different measurement definitions.
If composition silently collapses these differences, later validation can test only the fused value. It cannot test the losing claim, the identity premise, the conflict rule, or the receiver’s permitted use. Provenance survives as a list of sources but no longer constrains meaning.
SIE.6:3 - Forces
| Force | Tension |
|---|---|
| Simplicity | Receivers may prefer one view even when the source claims warrant several qualified rows or an explicit conflict. |
| Authority | Some sources are authoritative for bounded claims, while no source may own the whole receiving question. |
| Time | Newer claims may supersede older ones, while differing intervals, effectivity, or observation times can make them jointly informative. |
| Identity | Composition needs a subject relation, while an unresolved identity premise must stop only the dependent branch. |
| Uncertainty | Quantification can support comparison, while unlike confidence, status, or evidence forms should not be normalized without warrant. |
| Performance | Precomputed canonical values are convenient, while preserving source-qualified alternatives and derivation costs storage and query work. |
SIE.6:4 - Solution
Compose claims only after their meanings, subjects, scopes, intervals, authority, uncertainty, and provenance are explicit. Classify the relation among claims before applying a rule. Preserve the source claims and any relied-on identity premises in the result. Return a qualified view only under a stated rule and use boundary; otherwise return conflict, non-comparability, or unresolved.
SIE.6:4.1 - Pattern-Use Unfolding
- Name the receiving question and action. State what the composed answer may change and which outcomes are acceptable: one qualified row, several rows, conflict, non-comparability, unresolved, or stop.
- Identify the source claims. Reference
SIE.2rows andSIE.4correspondences. Record each proposition or data-derived claim, scope, interval/effectivity, units, status, uncertainty, derivation, source, and authority. - Bind the subject relation needed by the use. Reference
SIE.5when composition depends on claims concerning the same entity. For separately attributed claims about distinct subjects, preserve their subjects and attribution. Keep an explanation of unused identity only when it affects interpretation or later reliance. A correspondence alone does not establish subject identity. - Test comparability. Decide whether claims use compatible concepts, subjects, grains, units, intervals, and observation/decision roles. Preserve non-comparability as a result.
- Classify the claim relation. Distinguish compatible conjunction, refinement, overlap, duplication, supersession under a justified rule, contradiction, non-comparability, and unresolved relation.
- Choose a bounded composition rule. Examples include retaining all qualified claims, selecting one claim under an explicit domain authority/effectivity rule, deriving a new claim through a stated calculation, or returning conflict. State rejected alternatives and semantic loss.
- Construct the qualified output. Include the source claims or stable references, applied rule, any relied-on identity premise, derived value if any, provenance/trace, authority boundary, uncertainty, conflict/non-comparability status, and permitted receiving use.
- Expose failure and challenge. Define missing-source, stale-source, unresolved-identity, incompatible-unit, contradictory-authority, and unsupported-default branches. Do not convert them into null or a chosen value without the contract’s permission.
- State downstream and reopen conditions. Identify mappings and interfaces that consume the composition and the source, identity, rule, authority, or use change that reopens it.
SIE.6:4.2 - Record the Result
| Composition position | Required content |
|---|---|
| receiving use | question, action changed, acceptable output branches |
| source claims | propositions or data claims, meanings, subjects, scopes, intervals/effectivity, units, status, uncertainty, source and derivation |
| identity premise | referenced SIE.5 disposition when composition relies on identity; an explanation of unused identity only when it affects interpretation or later reliance |
| comparability | compatible dimensions and any difference that prevents comparison |
| claim relation | conjunction, refinement, overlap, duplicate, qualified supersession, contradiction, non-comparability, unresolved |
| composition rule | rule, authority/evidence basis, conditions, rejected alternatives, semantic loss |
| output | qualified view or explicit conflict/non-comparability/unresolved result, provenance/trace, permitted use |
| downstream and reopen | mapping/interface references, failure branches, changes that reopen the composition |
SIE.6:4.3 - What Changes in Practice
The team stops treating a canonical value as the natural output of integration. A receiver can see why claims were combined, retained separately, or stopped, and can return to the source, identity, authority, or rule that changes the answer.
SIE.6:5 - Archetypal Grounding - Provider Availability Claims
Two providers expose availability for the same buyer-recognized product family. Provider A returns onHand = 12 at 10:00; Provider B returns availableToPromise = 9 at 10:02. A purchasing integration initially proposes a single available = 21 value.
The source inventory shows that on hand is current physical stock before reservations, while available to promise is a provider-governed commitment quantity after its own reservation and horizon rules. The values are not additive and are not globally equivalent. A product-family correspondence exists, but individual inventory objects are not asserted identical.
| Claim relation question | Constructed result |
|---|---|
| Can the two values be summed? | non-comparable for summation because definitions, allocation rules, and authority scopes differ |
| Can both support a “which provider can satisfy quantity 8 now?” query? | conditionally comparable only after the contract accepts Provider A’s additional reservation check and Provider B’s promise horizon; retain separate rows |
| What if Provider A reports 12 and a later status reports 4? | classify by source occurrence, observation interval, and justified supersession rule; retain both claims and derivation rather than overwriting silently |
| What if product identity is unresolved? | stop that product branch and expose the unresolved SIE.5 premise |
| What if one API times out? | return available source-qualified rows plus an incomplete-result flag if the contract permits; never substitute zero |
The interface can return two qualified provider rows, explicit non-comparability for arithmetic aggregation, and a missing-source branch. Purchasing owns supplier choice and risk acceptance.
SIE.6:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | A source priority table silently decides truth or business action. | Name the authority and claim scope for every selection or supersession rule. |
| Architecture | The target schema requires one value and erases alternatives. | Change the output shape or expose conflict/non-comparability as first-class branches. |
| Ontology/Epistemology | Data values, claims, facts, and decisions collapse. | Record propositions, scope, uncertainty, derivation, and receiver decision separately. |
| Pragmatics | Every disagreement becomes an elaborate dispute. | Classify only relations that can change the receiving answer; retain independent claims without forced comparison. |
| Didactics | “Fusion” is read as merge or averaging. | Show examples where the correct fusion is a qualified set, conflict, or non-comparability. |
SIE.6:7 - Conformance Checklist
- The receiving question and every allowed output branch are explicit.
- Source claims retain meaning, subject, scope, interval/effectivity, units, status, uncertainty, source, and derivation.
- Every load-bearing subject identity premise is referenced and tested.
- Comparability is judged before aggregation or selection.
- Compatible, refining, overlapping, duplicate, superseding, contradictory, non-comparable, and unresolved relations are distinguishable.
- A composition rule states its authority/evidence basis, conditions, rejected alternatives, and loss.
- Source claims remain recoverable from the output.
- Missing, stale, unresolved-identity, incompatible-unit, contradictory-authority, and default branches are explicit where applicable.
- The result does not claim domain truth, authoritative value, preference, authorization, or action beyond its source and receiver boundaries.
SIE.6:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Last write wins | State why time establishes supersession for this claim and interval; otherwise retain both. |
| Trusted source always wins | Name the scope of the source’s authority and preserve losing claims and conflict. |
| Average the values | Establish compatible meaning, subject, unit, interval, and aggregation semantics first. |
| Null means zero or absent | Preserve missing, unavailable, unknown, not applicable, and zero as distinct branches. |
| Provenance after fusion | Keep source claims and derivation as inputs to the composition, not decoration on the result. |
| One canonical fact | Return a qualified view only when the use and authority rule warrant it; otherwise return plural claims or conflict. |
SIE.6:9 - Consequences
Receivers obtain explainable views and conflict branches. Corrections can target the source claim, identity premise, composition rule, or receiving use without reconstructing an opaque golden record. Different receiving uses can justify different bounded views of the same preserved claims.
The cost is richer output and explicit rule ownership. Some applications must handle plural, incomplete, or conflicting results instead of one scalar value.
SIE.6:10 - Rationale
A source claim asserts something about a subject within a stated scope. Composition is a new derivation whose premises and authority must remain inspectable. Preserving the inputs is what makes conflict, correction, and changed-use replay possible.
SIE.6:11 - SoTA-Echoing
The best-known line combines claim individuation, provenance, authority-aware data integration, and explicit uncertainty. The serious default is master-record survivorship or source ranking. Those Methods can be valid under an authorized MDM use, but they are defective as a universal semantic-integration default because they hide non-comparability and transfer authority. SIE.6 adapts the line by making the qualified composition or explicit conflict the domain result.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
Current FPF C.2.1 | adopt | Keeps claims as distinct representational objects; SIE supplies the cross-source use composition. |
Current FPF A.10 | adopt | Governs claim-bound evidence and provenance reliance; evidence law does not choose the domain truth or action. |
| PROV-O | adapt | Supports derivation, attribution, revision, and invalidation traces; provenance alone establishes no truth, priority, or comparability. |
| MDM survivorship and golden-record practice | adapt only under direct authority | May supply an authoritative-value result for a bounded domain; SIE preserves its source and scope rather than generalizing it. |
| last-write, average, or global source-rank defaults | reject as universal | Each may be a justified local rule, but none is semantically safe without compatible claims and authority. |
Reopen when a source claim, identity premise, authority rule, interval, uncertainty model, or receiving use changes, or when representative conflict cases cannot be expressed without hiding action-changing information.
SIE.6:12 - Relations
SIE.2supplies source claims, meanings, editions, authority, provenance, currentness, and gaps.SIE.4supplies the qualified correspondences needed to compare claim predicates or values.SIE.5supplies load-bearing subject identity dispositions; claim conflict does not alter those identities by itself.SIE.7may implement the qualified composition rule but must preserve its branches and trace.SIE.9exposes qualified views, plural claims, conflict, non-comparability, and incomplete-source states to the receiver.SIE.10tests the composition rule and negative branches. MDM, domain, and application owners retain truth, value, preference, authorization, and action.
SIE.6:End
SIE.7 - Specify Semantic Extraction and Transformation Mappings
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: an
ExecutableSemanticMappingSpecification@Usethat states source and target schemes, accepted correspondence premises and any relied-on identity or claim-composition premises, extraction and transformation rules, selection and cardinality, units and codes, conditions, defaults, errors, information loss, trace, examples, and tests.
SIE.7:1 - Problem Frame
Use this when accepted semantic correspondences must become repeatable extraction or transformation behavior, or existing code contains joins, conversions, defaults, and exclusions that cannot be traced to their semantic premises. The recognizable failure is a pipeline that runs successfully while changing meanings, merging unresolved identities, dropping conflicts, or inventing values through defaults.
For the named use, specify the executable semantic rules independently of the pipeline that may run them. First bind each output claim to accepted input senses and any relation, identity or composition results it relies on. The specification must be precise enough to implement and test without reopening its semantic choices in code.
Data Engineering or another implementer receives the mapping specification, and validation can trace its rules to their premises. Do not use SIE.7 to choose virtual versus materialized realization, build or operate the pipeline, or authorize access. A correspondence set is an input, not executable behavior; a running transform is evidence, not the specification itself.
SIE.7:2 - Problem
Mapping logic is often dispersed across SQL, ETL configuration, model transformations, lookup tables, API adapters, and undocumented operator knowledge. The same “mapping” word then refers to a semantic relation, an extraction query, a unit conversion, a data movement, and the Work that ran it.
When these objects collapse, semantic review happens after implementation and cannot identify what was intended. Defaults conceal missing inputs, many-to-one mappings drop distinctions, identifiers are normalized without issuer context, and error rows vanish. A code diff reveals mechanics but not the receiving-use claim it is allowed to produce.
SIE.7:3 - Forces
| Force | Tension |
|---|---|
| Executability | Rules must be precise enough to run, while binding them to one technology can hide their semantic intent. |
| Completeness | Every output branch needs behavior, while invented defaults make an incomplete rule appear total. |
| Performance | Efficient joins and precomputation matter, while optimization must preserve semantic premises and trace. |
| Cardinality | Source and target structures differ, while one-to-many and many-to-one choices can create loss or duplication. |
| Error handling | Operational systems prefer a value or null, while semantic failure needs distinct unresolved, incompatible, stale, and source-error branches. |
| Change | Stable rule identifiers aid maintenance, while source editions and accepted correspondences can invalidate a rule. |
SIE.7:4 - Solution
Specify semantic mapping rules separately from their implementation. Bind every rule to a receiving-use contract, the source and target schemes, accepted correspondence premises, and any identity or claim-composition premise on which that rule depends. Make selection, cardinality, conversions, defaults, errors, loss, trace, and tests explicit. Require implementations to preserve these behaviors or return a named discrepancy.
SIE.7:4.1 - Pattern-Use Unfolding
- Name the output claim and receiver. State the target field or proposition, its meaning, grain, interval/effectivity, and the action it supports.
- Bind source and target schemes. Reference the
SIE.2source rows and target interface/model definitions, editions, profiles, units, codes, identifiers, and access assumptions. - Bind semantic premises. Reference accepted
SIE.4correspondence rows and every load-bearingSIE.5identity disposition. Reference aSIE.6composition or conflict result when the rule depends on that result. Stop on an unresolved required premise; do not require identity or claim-composition work that cannot change the rule. - Specify selection and extraction. State source records, predicates, joins, windows, configuration/effectivity filters, ordering, and behavior for missing or duplicate inputs.
- Specify transformation. State direction, construction, decomposition, aggregation, unit/code conversion, normalization, derivation, and required external lookup. Name the authority for any conversion or code table.
- Specify cardinality and identity preservation. State one-to-one, one-to-many, many-to-one, or conditional behavior; keep source identifiers and disposition references when rows combine or split.
- Specify defaults and errors. Distinguish absent, unknown, not applicable, inaccessible, stale, incompatible, unresolved, source failure, and actual zero or empty value. Permit a default only when the contract and semantic warrant state its meaning and loss.
- State information loss and forbidden reuse. Name omitted distinctions, coarsening, precision, interval, provenance, or conflict and the use for which the loss is accepted.
- Provide trace and examples. Give stable rule identifiers, input-to-output trace positions, positive examples, boundary and counterexamples, and expected negative branches.
- Define implementation conformance and reopen. State observable behavior an implementation must match and source, premise, contract, or target changes that invalidate the rule.
SIE.7:4.2 - Record the Result
| Mapping position | Required content |
|---|---|
| rule and use | stable rule identifier, receiver, output claim, grain, interval/effectivity |
| schemes | source/target assets, models/schemas, editions/profiles, fields/types/relations, units/codes |
| semantic inputs | accepted correspondence rows and any relied-on identity dispositions or composition/conflict results, with their conditions |
| extraction | selection, joins, filters, windows, effectivity, duplicates, missing-input behavior |
| transformation | direction, construction/decomposition/aggregation, conversions, lookups, derivation |
| cardinality and identifiers | source-target multiplicity, split/merge behavior, source-ID and premise preservation |
| defaults and errors | distinguished states, permitted default and meaning, failure branches, quarantine or stop |
| loss and trace | accepted/forbidden loss, provenance, rule and premise references, input-output trace |
| examples and conformance | positive, boundary, negative/unlike examples, expected outputs, implementation predicate, reopen |
SIE.7:4.3 - What Changes in Practice
Semantic rules and their premises become independently reviewable. Data Engineering can optimize or replace an implementation while preserving the mapping behavior, and a failed output can be traced to a source premise, rule, implementation discrepancy, or receiving-use change.
SIE.7:5 - Archetypal Grounding - AP242/QIF Mapping Rules
The AP242/QIF package needs a row set for the configuration-bound inspection query. Its specification includes these constructed rules:
| Rule | Semantic and executable behavior |
|---|---|
MAP-SIE-APQ-01 | Select the released AP242 product-definition revision/configuration supplied by Systems Engineering and filter features by effectivity E. Do not select “latest” as a substitute. |
MAP-SIE-APQ-02 | For each accepted SIE.4 plan-characteristic-concerns-feature row, join exact source identifiers only under the referenced SIE.5 feature disposition. Preserve AP242 and QIF IDs and issuers. |
MAP-SIE-APQ-03 | Compose AP242 definition/effectivity and QIF plan/result claims through the referenced SIE.6 result. Emit compatible qualified claims, explicit contradiction, non-comparability, or unresolved branches; never overwrite. |
MAP-SIE-APQ-04 | Convert units only through the contract-approved code/unit table and retain original value, unit, conversion rule, precision, and loss. An unknown unit stops that result row. |
MAP-SIE-APQ-05 | Return unmatched AP242 feature, unmatched QIF characteristic, stale result, missing provenance, and source-error states distinctly. No state defaults to an accepted match. |
Positive examples cover one known configuration/feature/characteristic/result chain. Boundary cases cover one-to-many characteristics and repeated results. Negative cases cover an obsolete revision, incompatible feature, unresolved identity, unknown unit, contradictory result status, and absent QIF plan. A SQL view, R2RML mapping, QVT transformation, or application code may implement the rules; none changes the specification without reopening the affected rule.
SIE.7:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | Mapping code silently decides source priority, identity, or authoritative value. | Require references to accepted premises and the direct authority for conversions or defaults. |
| Architecture | A tool’s expressiveness defines the semantic rule. | State implementation-independent behavior and return an implementation gap when the tool cannot preserve it. |
| Ontology/Epistemology | Correspondence truth, transformation rule, performed transformation, and output claim collapse. | Keep the rule and its evidence separate from execution occurrences and resulting claims. |
| Pragmatics | The specification reproduces every implementation detail. | Include only behavior needed to preserve semantics, errors, trace, and conformance. |
| Didactics | Examples are copied as the complete rule. | State the general condition and use examples as tests, including counterexamples. |
SIE.7:7 - Conformance Checklist
- Every rule names a receiving output claim and use.
- The specification identifies the source and target schemes, editions/profiles, meanings, units, codes, and identifiers used by each rule.
- Accepted correspondence premises and any relied-on identity or composition premises are referenced rather than re-decided in code.
- Selection, joins, filters, windows, effectivity, duplicates, and missing inputs are explicit.
- Transformations, conversions, external lookups, and their authority are explicit.
- Cardinality, split/merge behavior, and source-identifier preservation are specified.
- Absent, unknown, not applicable, inaccessible, stale, incompatible, unresolved, source failure, zero, and empty values remain distinguishable where relevant.
- Defaults have a semantic warrant, accepted loss, and test.
- Information loss, forbidden reuse, provenance, and input-output trace are inspectable.
- Positive, boundary, negative, and unlike cases define observable implementation conformance.
- The specification claims no running pipeline, service level, or receiving-use validation.
SIE.7:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| SQL execution treated as semantic justification | Recover the semantic rule, premises, loss, errors, and tests; check the SQL implementation against them. |
| Crosswalk equals transformation | Add selection, direction, cardinality, conversions, defaults, errors, trace, and examples. |
| Null for every failure | Define distinct semantic and operational states and their receiver behavior. |
| Latest record wins | Use the direct configuration/effectivity or justified interval rule. |
| Normalize identifiers | Keep the original entries and how they were resolved. Preserve the context for a rule and the issuer for an assignment. Reference the identity disposition. |
| Hidden unit conversion | Record source/target units, authority, precision, loss, and counterexample tests. |
SIE.7:9 - Consequences
Implementers receive a bounded contract that can survive technology change, and reviewers can distinguish a semantic defect from an implementation defect. Negative branches and accepted loss become testable, and optimization can proceed under a preservation predicate.
The cost is explicit rule and example work before or alongside coding. Some tools cannot represent the required branches or trace and must be wrapped, changed, or rejected for this use.
SIE.7:10 - Rationale
A semantic correspondence states a relation; an executable mapping states how source occurrences produce target claims under conditions. Making that extra structure explicit prevents implementation convenience from becoming a semantic decision and lets Data Engineering own execution without inheriting unstated SIE authority.
SIE.7:11 - SoTA-Echoing
The best-known line combines declarative mapping languages, model transformation, traceability, and representation-preservation checks. The serious default is code-first ETL that leaves semantic premises and loss implicit. SIE.7 makes the receiving-use mapping contract independently recoverable, including its negative states. Code and its documentation can carry that contract when the semantic requirements and their grounds remain distinguishable from the implementation being tested.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
Current FPF A.6.3.RT | adopt | Governs preservation through representation transition; it does not specify this domain mapping. |
| R2RML | adapt | Demonstrates declarative relational-to-RDF mapping structures; RDF and relational sources are optional technology families. |
| OMG QVT 1.3 | adapt | Contributes model-query/view/transformation and trace forms; MOF/QVT is not mandatory. |
| PROV-O | adapt | Supports derivation and activity/agent/entity trace; provenance does not prove semantic preservation. |
| code-first ETL with implicit semantic premises | reject as sufficient | Execution must be checked against an independently recoverable rule, loss, and branch contract. |
Reopen when an input or target scheme changes, a correspondence/identity/composition premise changes, a counterexample defeats the rule, the receiver changes accepted loss, or implementations cannot satisfy the preservation predicate.
SIE.7:12 - Relations
SIE.1supplies the output claims, accepted loss, service conditions, tests, and stop.SIE.2supplies source and target semantics, editions, identifiers, units/codes, provenance, and gaps.SIE.4supplies accepted correspondence premises;SIE.5andSIE.6supply identity and composition results when a rule relies on them.SIE.8consumes rule behavior and implementation conditions to compare realization alternatives.SIE.9exposes the rule outputs and error branches to the receiver.SIE.10tests both specification semantics and implementation conformance. Data Engineering owns pipeline construction, operation, observability, reliability, and recovery.
SIE.7:End
SIE.8 - Choose Virtual, Materialized, or Hybrid Semantic Realization
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
SemanticRealizationDecision@Use: a supported choice, sufficient rejection, worthwhile probe, or missing-input result for a named semantic-integration use. A positive choice identifies the implementation results it still requires.
SIE.8:1 - Problem Frame
Use this when accepted semantic mappings exist and the current question is whether to evaluate them at query time, persist integrated results, or combine both. Enter also when a graph database, warehouse, federation, cache, search index, API composition, or “virtual knowledge graph” has already been proposed and its semantic consequences need comparison.
For the named integration use, derive the criteria for choosing a realization from the use contract and mapping specification. The result may be a bounded choice, probe, rejection or missing-input return. The responsible providers retain physical implementation and operation.
The payoff is a realization selected because it preserves the required meanings and service conditions, not because one carrier is fashionable or already available. Do not use SIE.8 to build, deploy, or operate a data service, select a whole enterprise platform, authorize access, or prove that the interface works. Data Engineering, platform, security, provider, finance, and other direct owners supply those results.
SIE.8:2 - Problem
Materialization can improve latency and independence from source availability but creates copied state, invalidation, custody, storage, and refresh obligations. Virtual access can preserve source currency and authority but inherits source latency, availability, access, and query-capability limits. A hybrid can isolate hot or stable subsets but adds coherence and branch complexity.
When the choice is made from technology labels, these consequences remain hidden until operation. A copied graph is described as semantic truth, a federation as automatically current, or a cache as harmless optimization. The same mapping semantics can yield different provenance, currentness, error, and recovery behavior in each realization.
SIE.8:3 - Forces
| Force | Tension |
|---|---|
| Freshness | Virtual reads can observe current source state, while network and source delays can still make answers stale or inconsistent. |
| Latency | Materialization and caching can respond quickly, while refresh and invalidation may violate the use’s time boundary. |
| Availability | Copies can survive source outages, while they can conceal that authority or access conditions changed. |
| Source authority | Querying the source keeps custody visible, while a receiver may need stable snapshots and reproducible answers. |
| Security and permission | Fewer copies reduce exposure, while live federation can broaden runtime credentials and cross-source disclosure. |
| Provenance and reproducibility | Materialized snapshots aid replay, while virtual results need captured queries, source versions, and occurrence metadata. |
| Operability and recovery | A simpler runtime can reduce failure modes, while hybrid arrangements add invalidation and coherence responsibilities. |
| Cost | Storage, compute, licenses, egress, support, and provider dependency trade differently across cases. |
SIE.8:4 - Solution
First use decisive conditions to exclude arrangements that cannot serve the contract. Describe and compare the serious remaining alternatives as complete arrangements, including source access, rule execution, state/copy behavior, provenance, currentness, failure branches, security, operation, recovery, exit, and joint resource demand. Return a supported choice, sufficient rejection, worthwhile probe, or missing-input result for the named use.
SIE.8:4.1 - Pattern-Use Unfolding
- Fix the receiving result. Reference the
SIE.1answer,SIE.7rules, required source/identity/claim branches, and validation conditions that a successful candidate must preserve. - Apply decisive exclusions. A known source prohibition or other sufficient condition can defeat an arrangement. Record the condition and evidence needed for that conclusion and stop developing the excluded alternative. If no serious candidate remains, return the bounded rejection or identify the missing result.
- Describe a serious virtual alternative. When query-time access remains a candidate, state source access, rule evaluation, pushdown or mediation, credentials, latency/availability behavior, provenance capture, and failure return.
- Describe a serious materialized alternative. When copying remains a candidate, state copied or derived state, snapshot identity, refresh/invalidation, storage and custody, source deletion/correction behavior, provenance, recovery, and exit.
- Describe a hybrid where warranted. Identify which permitted subset is materialized and which source-sensitive part remains virtual. State coherence, invalidation, and fallback behavior. Confirm permission for each subset selected for copying.
- Compare complete remaining arrangements. Use the conditions that can change the receiving result: freshness, latency, availability, access, protection, source authority, reproducibility, provenance, operability, recovery, cost, and semantic loss. Include concurrent source calls, shared credentials, trace, retries, support, and other demands within each applicable resource envelope. Every pair of contributions may fit a shared limit even when the demands of all the contributions together exceed it.
- Examine relevant failure and change cases. Use the source outages, corrections, access changes, mapping changes, stale or partial refresh, provenance loss, and recovery cases needed for the proposed conclusion. Earlier sufficient evidence can support a bounded rejection; a positive selection needs its load-bearing conditions.
- Choose or identify worthwhile further work. Select a supported arrangement, reject it, or return the missing result. Commission a discriminating probe only when its obtainable result can change the decision enough to justify its full burden and displaced work. Keep an unresolved comparison explicit when further inquiry is unavailable or not worthwhile. State the reasons for the disposition that its receiver needs.
- Name implementation returns for a selected choice. Identify the Data Engineering, platform, provider, security, legal, finance, or operating results required to realize that choice.
- Return the conditions needed by this result. For a selected realization or supplied receiving result, give
SIE.9its service, error, currentness, and fallback meanings. Retain observations that can reopen the conclusion where they change continued reliance.
SIE.8:4.2 - Record the Result
A sufficient rejection of one proposed arrangement is complete with the receiving use, named proposal, decisive grounds and evidence, scope, and material limits. It does not require a comparison with unrequested alternatives or an implementation and interface design.
| Decision content | When it is needed | Content supplied |
|---|---|---|
| Receiving use and disposition | Every result | The question and proposed arrangement or comparison scope, supported choice/rejection/probe/missing-input result, grounds, and material limits. |
| Decisive exclusion | A proposed arrangement is rejected on sufficient grounds | The condition that defeats it, the evidence and applicability needed for that condition, and the scope of the rejection. |
| Candidate arrangements and comparison | A comparison remains live or a positive choice is made | Serious remaining alternatives as complete arrangements: required semantic branches, access, state, execution, currentness, latency, provenance, protection, failure, operation, recovery, exit, and joint resource demand. |
| Failure/change evidence | The supplied conclusion depends on it | Evidence for its load-bearing conditions. One qualified prohibition can suffice for rejection; positive selection needs the relevant failure and change cases for the claimed arrangement. |
| Further inquiry | A probe is proposed | Obtainability, possible decision contribution, full burden, displaced work, and how its result can change the decision. |
| Implementation returns | A realization has been selected | Required results from the responsible providers, what is supplied or still missing, and the acceptance evidence needed to realize that choice. |
| Interface semantics | A selected realization or receiving result needs them | Currentness, source/error, incomplete-result and fallback meanings supplied to SIE.9. |
| Continued reliance | A condition can materially change the result’s use | The observation, source change, or receiving change that reopens the affected decision. |
A positive choice cannot use the rejection boundary to omit a condition on which that choice relies. The selected arrangement and its implementation returns remain qualified by all the semantic, service, access and resource conditions they depend on.
SIE.8:4.3 - What Changes in Practice
The team compares ways to supply the same semantic result rather than comparing product categories. A graph store may survive as a materialized candidate, a federation as a virtual candidate, or neither. The selected decision states what still has to be implemented and operated before any service claim is made.
SIE.8:5 - Archetypal Grounding - Provider Availability without Replication
Two providers expose current availability through governed APIs. Provider A means “on hand”; Provider B means “available to promise”. SIE.4 preserves the semantic difference and SIE.6 permits a qualified side-by-side answer but forbids arithmetic fusion. Neither provider permits replication of its availability state.
If the question is only whether a proposed copied availability store may serve that contract, the completed answer is: “Reject the proposed copied availability store for this purchasing use: the qualified provider conditions prohibit copying the required availability state.” The contract, proposal, and provider conditions identify its scope and grounds. This concludes that question without a latency study, credential design, recovery plan, or alternative selection.
When the receiving question also asks which remaining arrangement to use, continue with the following comparison:
| Candidate | Constructed comparison |
|---|---|
| materialized common graph | excluded by the providers’ prohibition on copying availability state; that condition is sufficient without developing its implementation, recovery, and exit |
| query-time virtual mapping | retained alternative: preserves source custody and timestamps and can return provider-specific qualified rows; depends on runtime credentials, latency, provider availability, query limits, and explicit timeout/incomplete branches |
| hybrid metadata plus virtual values | selected conditionally: materialize stable product-family correspondences, mapping rules, and source metadata where their copying and maintenance are permitted; retrieve volatile availability values at query time; invalidate metadata when source definitions or product relations change |
The decision selects the hybrid arrangement because stable semantic premises can be inspected and volatile restricted values remain at their sources. It requires Data Engineering and security results for credential handling, concurrent calls, timeout behavior, observability, and recovery. SIE.9 receives separately attributed quantities and timestamps, provider errors, and the permitted incomplete-result and fallback behavior. No running interface or provider reliability is claimed.
SIE.8:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | Materialization silently transfers custody, authority, or permission. | Record source rights, retention, correction, and use authority for every copied state. |
| Architecture | The incumbent platform determines the answer, or every conceivable alternative requires full design. | Use sufficient exclusions, then compare serious alternatives as complete arrangements on the receiving basis. |
| Ontology/Epistemology | A graph or warehouse is treated as the semantic arrangement itself. | Keep mapping premises, claims, provenance, and validation independent of carrier. |
| Pragmatics | Every unresolved comparison commissions a probe. | Compare obtainable decision benefit with the probe’s full burden and displaced work. |
| Didactics | “Virtual is fresh; materialized is fast” becomes a universal rule. | Show source latency, snapshot reproducibility, invalidation, and failure conditions that reverse the slogan. |
SIE.8:7 - Conformance Checklist
Apply the checks below to the conclusion you are returning.
For every result
- The receiving question, named proposal or comparison scope, disposition, grounds, and material limits are recoverable.
- The evidence supports that disposition at its stated scope; it creates no broader feasibility, running-service, or achieved-performance claim.
For a sufficient rejection
- The decisive condition and its qualified evidence defeat the named proposal for this use.
That rejection completes the Method when it answers the requested question. The following comparison and implementation checks do not become prerequisites for it.
For a live comparison or positive selection
- A successful candidate preserves the receiving result, mapping rules, and required semantic branches.
- Serious remaining candidates expose access, state, execution, provenance, failure, operation, recovery, exit, and joint resource demand.
- Freshness and latency are defined for the receiving use.
- Source authority, custody, permissions, correction/deletion, and retention consequences are explicit.
- Security/privacy and runtime credential differences are compared where they can change the result.
- Reproducibility and provenance behavior are specified for the candidate’s virtual occurrences and copied state.
- Relevant outage, access, mapping, correction, refresh, provenance-loss, and recovery cases support the proposed conclusion.
- For a selected realization, the required implementation and operating results remain with their direct owners, and SIE.9 receives the required currentness, error, incomplete-result, and fallback meanings.
For a proposed inquiry
- Its obtainable decision contribution justifies the full burden and displaced work.
SIE.8:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| “Knowledge graph” as the requirement | Restate the receiving result and compare graph and non-graph realizations. |
| Virtual means no state | Record the state the virtual arrangement needs. Depending on the use, this can include mappings, caches, credentials, query occurrences, source snapshots and provenance. |
| Materialized means reliable | Test refresh, invalidation, correction/deletion, recovery, and source-authority changes. |
| Hybrid means best of both | Expose coherence, invalidation, fallback, and doubled operating responsibilities. |
| Product feature checklist | Compare serious arrangements on use-sensitive criteria, joint resource demand, and relevant failure cases. |
| Decision equals implementation | Name the build, provider, security, and operating results still missing. |
SIE.8:9 - Consequences
The bounded realization decision exposes source, semantic, and operating trade-offs and the conditions for reconsidering it. Interface designers receive explicit currentness and error behavior, while implementers receive a clear invariant to preserve.
The cost is comparison beyond the preferred platform and coordination with operational owners. A selected candidate may still stop because access, security, service, provider, or cost evidence is missing.
SIE.8:10 - Rationale
Choosing virtual or materialized access changes when and where mappings execute, which state is copied, how provenance and currentness are established, and which failures reach the receiver. Those changes can alter semantic adequacy, so SIE owns the bounded comparison while direct practices own implementation and operation.
SIE.8:11 - SoTA-Echoing
The best-known line combines declarative mappings, virtual knowledge-graph systems, data federation, materialized integration, and operational data-product practice. The serious default alternatives are “materialize one canonical graph” and “federate everything live”. Each can be correct under conditions; each is defective as a universal answer because it hides a different set of currentness, access, provenance, and recovery obligations. SIE.8 uses these contributions to compare whole arrangements that supply the same semantic result.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
| Ontop virtual-KG line | adapt | Demonstrates query-time virtual realization over mappings; it does not make virtual RDF mandatory or supply source access and receiving acceptance. |
| R2RML | adapt | Supplies one declarative mapping form usable in virtual or materialized arrangements; relational/RDF technology is optional. |
| Data on the Web Best Practices | adapt | Contributes access, version, provenance, reuse, and persistence questions; Web publication is not required. |
| universal canonical graph | reject as default | Materialization is one candidate and cannot transfer source authority or erase incompatibility. |
| universal live federation | reject as default | Query-time access does not guarantee freshness, availability, permitted disclosure, or reproducibility. |
Reopen when source access or replication rights change, measured latency/availability defeats the use, refresh/invalidation fails, mapping or source semantics change, security/provenance conditions change, or a new candidate materially improves the comparison.
SIE.8:12 - Relations
SIE.1supplies the invariant result and use-sensitive service and protection conditions.SIE.7supplies executable semantic behavior and loss/error branches every candidate must preserve.SIE.2,SIE.5, andSIE.6supply source authority, identity, claim, provenance, and currentness conditions.SIE.9consumes the selected realization’s currentness, latency, availability, provenance, error, access, and fallback semantics.SIE.10tests the realized candidate and receiving workflow; it can narrow or fail the decision’s assumed conditions.- Data Engineering, platform, provider, security, legal, finance, and Operations owners supply implementation and operating results.
SIE.8:End
SIE.9 - Connect a Receiving Use through a Semantic Interface
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
ReceivingSemanticInterface@Usedefining the smallest query, view, API, message, schema, report, or other boundary that carries the required meanings and branches to the receiver with interpretation, source and provenance, currentness, accepted loss, access assumptions, errors, unresolved returns, and a path back to the owning source or decision.
SIE.9:1 - Problem Frame
Use this when semantic mappings or integrated state exist but the receiving Work still cannot obtain, interpret, challenge, or return the bounded result. Enter when a technically reachable endpoint hides source meanings, currentness, unmatched rows, conflicts, or the difference between “no value” and “source unavailable”.
For the named receiving use, start with the action the result is meant to support. Choose the smallest interaction and result form that connects the maintained integration arrangement to that use and carries every branch the receiver needs. Supply an interface contract and a candidate interface. Establish the receiver’s authorization and the service’s operating adequacy separately when the use requires them.
The payoff is a boundary at which semantic meaning, failure, and provenance are usable by ordinary Work. Do not use SIE.9 to design the application’s whole user experience, make its decision, operate the service, or accept engineering/quality results. Those owners consume the interface under their own Methods and authority. Stop rather than return a positive interface when a required semantic branch, interpretation, provenance/currentness condition, source-return path, or receiver-side use test cannot be represented or traced.
SIE.9:2 - Problem
Integrated data can remain unusable because the receiver cannot ask the relevant question or distinguish the answer’s conditions. An API may omit source edition and effectivity; a report may list a fused value without conflict; a schema may use one null for unknown, not applicable, stale, and timeout; a user may have no path to challenge an identity or mapping premise.
When the interface is treated as transport only, semantic obligations remain in internal documentation. The receiving Work either overtrusts the result or reconstructs meanings informally, creating a second uncontrolled integration at the boundary.
SIE.9:3 - Forces
| Force | Tension |
|---|---|
| Minimality | A small interface is easier to use and maintain, while hiding source, loss, or failure makes it unsafe. |
| Receiving the result | The receiver needs to interpret the result and be able to return a disputed premise for review. A programmatic interface needs a stable schema, stable branch codes and a return path the caller can follow. A human-readable interface needs to explain the branch and show where to raise the question. |
| Abstraction | Receiver-friendly names reduce burden, while source identifiers and meanings must remain recoverable. |
| Performance | Rich provenance and alternative claims cost bandwidth and attention, while omitted trace defeats challenge and validation. |
| Security | The receiver needs enough source information to rely, while disclosure can violate provider, privacy, or protection conditions. |
| Evolution | Stable interface promises aid use, while source or mapping changes must not be hidden behind unchanged field names. |
SIE.9:4 - Solution
Design the interface from receiving actions and semantic branches, not from the internal store. Expose the smallest result that preserves interpretation, source/version, currentness, accepted loss, identity and claim status, provenance, access assumptions, errors, unresolved returns, and source-return paths. Bind every field and branch to the use contract, mapping rules, and selected realization.
SIE.9:4.1 - Pattern-Use Unfolding
- Name the receiver interaction. State who or what asks, the query/message/report action, timing, input parameters, and the next Work or decision that consumes the answer.
- Select the interface form. Choose query, view, API, message, schema, report, file, or mixed human/machine form based on the receiving Work. Do not inherit the internal realization shape automatically.
- Define semantic inputs. State the identifiers a request accepts, how the interface validates their form and how it resolves them. Supply any required issuer, assignment context, configuration or effectivity, time window, units, locale or code context, and permissions.
- Define result claims and interpretation. For each output, state meaning, grain, scope, interval/effectivity, units/codes, source identifier behavior, accepted loss, and permitted use.
- Expose qualified branches. Represent matched/qualified, unmatched, incompatible, unresolved identity, source-qualified conflict, non-comparability, stale, inaccessible, timeout/source error, and partial result where applicable.
- Expose provenance and currentness. Provide source/edition or a stable reference, observation/retrieval time, mapping/composition rule version, derivation/trace reference, and freshness status needed by the receiver.
- State access, protection, and authority assumptions. Explain what the interface verifies, what the caller supplies, what may be disclosed, and which actions remain unauthorized by the semantic result.
- Provide challenge and return paths. A receiver must be able to identify which source, correspondence, identity disposition, composition, mapping or operational result needs examination and where to return the issue.
- Bind service behavior without claiming it. State latency, availability, pagination/volume, ordering, idempotence or snapshot expectations only where semantic use depends on them; obtain implementation/operation evidence separately.
- Define conformance and reopen. Give representative requests, responses, error branches, compatibility conditions, deprecation/change behavior, and observations that reopen the interface.
SIE.9:4.2 - Record the Result
| Interface position | Required content |
|---|---|
| receiver interaction | caller/reader, receiving Work, request, timing, next action |
| interface form | query/view/API/message/schema/report/file and why it fits the Work |
| request semantics | parameters, acceptable identifier forms and resolution context, configuration/effectivity, windows, units/codes, permissions |
| response semantics | claims, grain, scope, interval, units/codes, source IDs, accepted loss, permitted use |
| branch model | qualified, unmatched, incompatible, unresolved identity, conflict, non-comparable, stale, inaccessible, source error, partial |
| provenance/currentness | source/edition, times, rule versions, derivation/trace, freshness status |
| protection/authority | verified and assumed conditions, disclosure limits, action not authorized |
| challenge/return | stable path to source, semantic premise, mapping, implementation, or direct decision owner |
| service/conformance | action-sensitive service conditions, examples, errors, compatibility/deprecation, reopen |
SIE.9:4.3 - What Changes in Practice
The receiver no longer has to infer semantic meaning from field names or call the integration team to understand a missing row. Qualified, incompatible, conflicting, stale, and source-error states become part of the normal interface contract, and every challenge can be returned to a specific premise or owner.
SIE.9:5 - Archetypal Grounding - AP242/QIF Review Interface
The quality engineer uses a view or API with request parameters productDefinitionRevision, configuration, featureIdentifier, and effectivity. The candidate response preserves these positions:
| Response position | Constructed behavior |
|---|---|
feature | AP242 source identifier, issuer/profile, configuration/effectivity, source edition, and receiver-friendly label |
inspectionCharacteristic | QIF source identifier, plan and characteristic meanings, source edition, and the accepted correspondence-row reference |
inspectionResult | source-qualified QIF claim, observation time/status, unit and original value, provenance, and any conversion rule |
identityDisposition | referenced SIE.5 result and its grain/interval, not a copied boolean |
claimStatus | qualified, conflict, non-comparable, or unresolved with the SIE.6 composition reference |
freshness | released AP242 configuration/effectivity used, QIF observation window, retrieval time, and stale status |
rowDisposition | matched, unmatched-feature, unmatched-characteristic, incompatible, unresolved-identity, stale, source-error, or prohibited |
returnPath | source record and mapping/correspondence/identity/composition rule references plus the direct engineering or quality owner for the decision |
A known match returns a qualified row. A feature absent at effectivity E returns unmatched rather than the nearest label. An unresolved identity returns that branch without claiming no inspection exists. A source timeout returns partial/incomplete only if the contract permits it. The responsible participants decide whether to accept the result or release the configuration.
SIE.9:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | Interface access is mistaken for permission to act or disclose. | State verified/assumed permissions, disclosure limits, and the direct action authority. |
| Architecture | Internal graph or warehouse schema becomes the public contract. | Design from receiving actions and preserve realization independence where useful. |
| Ontology/Epistemology | Field name, status code, and claim meaning collapse. | Define every output and branch with scope, source, time, and permitted use. |
| Pragmatics | Full provenance overwhelms routine use. | Expose the action-changing summary and a stable trace path to detailed premises. |
| Didactics | Error branches look like exceptional implementation failures. | Teach unmatched, incompatible, conflict, and unresolved as normal semantic outcomes. |
SIE.9:7 - Conformance Checklist
- The interface is tied to one named receiver, Work, request, and next action.
- The form is chosen for receiving use rather than copied from internal realization.
- The request identifies the accepted entries, how to resolve them, required configuration or effectivity, windows, units or codes, and permissions.
- Response claims state meaning, grain, scope, interval, source identifiers, loss, and permitted use.
- Qualified, unmatched, incompatible, unresolved identity, conflict, non-comparability, stale, inaccessible, source-error, and partial branches remain distinguishable where applicable.
- Source/edition, observation/retrieval time, rule versions, derivation/trace, and freshness are recoverable.
- Protection, disclosure, and authority assumptions are explicit; the interface grants no unstated authorization.
- The receiver can return a defect or gap to a specific source, semantic premise, mapping, implementation, or decision owner.
- Action-sensitive latency, availability, snapshot, and volume behavior are stated without claiming unobserved performance.
- Representative requests, responses, errors, compatibility/deprecation behavior, and reopen conditions are present.
SIE.9:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Expose the integrated table | Start from the receiving action and design only the claims and branches it needs. |
| One null or HTTP error for every absence | Distinguish semantic absence/unresolved states from access, timeout, and implementation failure. |
| Provenance in internal logs only | Expose the action-changing provenance/currentness summary and stable trace reference. |
| Hide source IDs behind one key | Retain the source entries, the contexts or assignments used to interpret them and the disposition supporting any identity on which the interface relies. |
| Endpoint is available, therefore usable | Validate meanings, branches, currentness, service conditions, and representative Work through SIE.10. |
| Semantic result authorizes action | Name the application, engineering, quality, safety, legal, or other decision owner. |
SIE.9:9 - Consequences
The semantic arrangement becomes directly usable and challengeable. Receivers can distinguish a negative semantic result from an operational failure, and implementations can evolve behind a stable bounded contract while preserving source and rule trace.
The cost is a richer branch model and deliberate presentation of uncertainty and provenance. Some internal schemas or protocols must be wrapped rather than exposed directly.
SIE.9:10 - Rationale
An integration result has practical value only when it crosses into receiving Work without losing the conditions that make it meaningful. The interface carries interpretation, qualification and return paths. The receiving participant uses the result within its authority and refers other decisions to their designated owners.
SIE.9:11 - SoTA-Echoing
The best-known line combines explicit API/data-contract practice, data-on-the-Web provenance/version guidance, event interfaces, and standards-based engineering exchange. The serious default is transport-first interface design. Its defect is that success is reduced to reachability and schema conformance. SIE.9 uses these contributions to make semantic branches, currentness, provenance, and challenge paths part of the receiving contract.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
| Data on the Web Best Practices | adapt | Contributes metadata, provenance, version, access, and reuse questions; Web publication is optional. |
| GS1 EPCIS 2.0.1 | adapt | Supplies an event-oriented cross-enterprise interface case with identifiers and query semantics; it does not decide SIE identity or receiving action. |
| ISO 10303-242:2025 and ISO 23952:2020 | adapt | Supply unlike versioned engineering source/interface cases; their model scopes and direct authorities remain intact. |
| internal-schema or transport-first API | reject as sufficient | Reachability and schema shape cannot establish semantic interpretation, provenance, loss, branch behavior, or receiving-use fitness. |
Reopen when the receiver or action changes, a source/mapping/realization premise changes, observed service behavior violates a semantic condition, branch handling causes unsafe interpretation, or a protocol change defeats compatibility.
SIE.9:12 - Relations
SIE.1supplies the receiving action, answer claims, loss, service conditions, tests, and authority boundary.SIE.2supplies source meanings, identifiers, editions, access, provenance, and currentness.SIE.4–SIE.7supply correspondence, identity, composition, and executable mapping references and branches.SIE.8supplies selected realization, service assumptions, fallback, and missing implementation results.SIE.10validates the candidate interface and representative receiving workflow.- The relevant application or professional participants decide on authorization and risk acceptance. Establish any claimed outcome from the receiving work. Data Engineering and Operations remain responsible for running the service.
SIE.9:End
SIE.10 - Validate a Semantic Integration Result for Its Receiving Use
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
SemanticIntegrationValidationAccount@Usethat supports a bounded pass, narrow, unresolved, or stop conclusion with appropriate evidence and reopen conditions. A positive receiving-use claim covers all of its load-bearing obligations.
SIE.10:1 - Problem Frame
Use this when you need to judge whether a candidate semantic interface or mapping package is fit for a receiving use. Enter especially when one test family already passes and is being used as evidence for the whole: valid JSON, conforming RDF shapes, successful ETL, high matcher score, complete provenance, good data-quality metrics, or one successful demonstration.
Judge one semantic-integration result against one receiving-use contract for an identifiable package revision that you can inspect. The first move is to identify the receiving claim being judged and whether known evidence already settles a bounded failure or unresolved result. For a positive claim, identify its load-bearing obligations and the evidence that can test them. The first result can be a supported local failure, scoped uncertainty, or qualified positive use.
The receiver can see which result it may rely on, under which source editions and conditions, and which gaps remain. Do not use SIE.10 to authorize product release, accept a quality result, approve a recall, certify a service, or prove business effectiveness. Those with the relevant authority can use the validation account when making those decisions.
SIE.10:2 - Problem
Semantic integrations fail across several independent layers. A carrier can be well formed while meanings are wrong; correspondences can be defensible while transformation code violates them; identity rows can pass while claim conflicts are flattened; provenance can be complete while source claims are stale or false; quality dimensions can look good while the representative workflow receives the wrong answer.
One aggregate “quality” or “confidence” score hides which premise failed and what must reopen. It also encourages compensating a hard stop, such as unresolved identity or unauthorized source use, with strong results elsewhere.
SIE.10:3 - Forces
| Force | Tension |
|---|---|
| Layering | Separate tests localize defects, while the receiver needs a whole-use conclusion. |
| Positive evidence | Expected matches demonstrate a path, while negative and unlike cases reveal hidden compression and defaults. |
| Coverage | A positive use claim needs its load-bearing premises supported, while a bounded failure can be settled by sufficient defect evidence. |
| Automation | Schemas, shapes, queries, and metrics scale checks, while semantic and authority judgments often require input from participants with relevant domain knowledge or authority. |
| Change | Stable evidence is reusable, while source editions, rules, interfaces, and receiving conditions can invalidate only some results. |
| Decision pressure | Stakeholders want a pass or fail. The evidence may support only a narrower use or leave the result unresolved. |
SIE.10:4 - Solution
State the conclusion at the scope its evidence supports. A known decisive failure or bounded unresolved premise can finish with sufficient evidence for that result. For a positive whole-use or contract-permitted narrower result, obtain matching evidence for every load-bearing premise, including the receiver’s interpretation. Use earlier results when their conditions still match. Preserve hard stops and distinguish unexamined premises from passing ones.
SIE.10:4.1 - Pattern-Use Unfolding
Steps 3–10 locate evidence for a positive use conclusion. A sufficient bounded failure or unresolved result can finish at step 2. Reuse matching earlier results for the applicable layers; a changed receiving interpretation can reopen a claim even when its carrier is unchanged.
- Identify the validation subject. Name the mapping, interface, or package result and receiving use being judged. Record the revisions and conditions on which the conclusion depends.
- Choose the conclusion and inspect known evidence. Take the relevant answer claim and stop condition from
SIE.1. If a demonstrated defect already defeats it, return that bounded failure with sufficient evidence. If a necessary premise is unresolved and that settles the requested question, return the scoped gap. Further obligations remain unexamined. For a positive claim, derive all load-bearing distinctions, loss, currentness/service/quality, authority, protection, branch, and representative-use obligations. - Validate carrier and schema. Test parseability, declared schemas/shapes, required fields, datatypes, cardinalities, identifiers, and branch encodings. Treat a pass as structural only.
- Validate semantic-model and endpoint adequacy. Test whether source and target concepts, types, relations, constraints, units/codes, and any supplied model express the required distinctions and examples/counterexamples.
- Validate correspondences and mappings. Challenge accepted
SIE.4rows and executeSIE.7positive, boundary, negative, and unlike examples. Check selection, cardinality, conversion, defaults, errors, loss, and trace independently. - Validate identity and authority. Test every load-bearing
SIE.5disposition at its grain and interval, including issuer, version, part-whole, reuse, split/merge, and unresolved branches. Verify required authority and permission inputs rather than inferring them from data access. - Validate claim composition. Test
SIE.6comparability, conflict, non-comparability, supersession, incomplete-source, and uncertainty branches. Confirm that source claims and derivation remain recoverable. - Validate realization and interface behavior. Test currentness, latency, availability, snapshot/caching, invalidation, source failure, partial results, access/protection, provenance, error semantics, and challenge paths required by
SIE.8andSIE.9. - Validate provenance, currentness, and quality. Check that every relied-on output can recover its source and rule premises, that source/version/time status satisfies the use, and that selected quality measurements meet their action-changing thresholds. Do not treat provenance or process conformance as truth.
- Replay representative receiving Work. Run the named query, decision preparation, operation, or engineering workflow with expected positive, negative, and unlike cases. Observe whether the receiver obtains and interprets the required result and stops on forbidden branches.
- Assign dispositions at the supported scope. Use pass, narrow, unresolved, or stop for tested claims, and preserve any material unexamined reach. A positive narrow result states the contract-permitted subset and covers all of that subset’s load-bearing premises; excluded branches remain explicit. A hard stop cannot be offset by scores elsewhere.
- Record repairs, returns, and reopen. Send source, semantic, mapping, implementation, authority, or receiver defects to their direct owners; state which layer and consumers require retest after change.
SIE.10:4.2 - Record the Result
| Validation position | Required content |
|---|---|
| subject and use | package/interface revision, source/rule versions, realization/test state, receiver and use |
| obligations | premises relevant to the claimed conclusion; all load-bearing contract obligations for a positive use claim |
| layer result | layer, tested claim, method/case, evidence, expected/observed result, pass/narrow/unresolved/stop, defect owner |
| dependency | source, correspondence, identity, composition, mapping, realization or interface premise consumed |
| coverage | examined cases and matching earlier results; material unexamined or unresolved premises, distinguished from passing ones |
| use disposition | supported local failure or gap, or positive result with its conditions and full load-bearing coverage; excluded subset and hard stops |
| continuation | repairs or direct-owner returns, focused retest, affected consumers, reopen condition |
SIE.10:4.3 - What Changes in Practice
The team stops asking whether “the integration” passed one test. Each claim has an appropriate layer, evidence, and owner. A bounded subset can be used without hiding excluded rows, and a source or rule repair triggers focused revalidation instead of an automatic full rebuild or a silent continuation.
SIE.10:5 - Archetypal Grounding
SIE.10:5.1 - Positive AP242/QIF Subset Validation
The constructed AP242/QIF package is frozen with named AP242/QIF source occurrences, correspondence set, identity dispositions, claim-composition rules, mapping specification, hybrid realization, and review interface. It uses SIE.1:5’s stipulated receiving contract: the preceding 24-hour observation window, two-second response limit, and permission to return qualified evidence while showing unresolved local-extension and unknown-unit branches separately.
| Layer | Constructed probe and result |
|---|---|
| carrier/schema | Request and response validate against their declared forms; unmatched, incompatible, unresolved, stale, and source-error states are representable. Passes structurally. |
| semantic-model/endpoints | AP242 feature/configuration/effectivity and QIF plan/characteristic/result senses are recoverable. One local extension remains undefined; rows that consume it are unresolved. |
| correspondence | Known plan/feature relation passes; shared-label false match is rejected; non-dimensional characteristic defeats a global type equivalence. Passes for the accepted row set. |
| identity/authority | Known feature identifier relation passes at revision/configuration/effectivity grain; obsolete revision and unresolved local ID stop their dependent branches. Engineering and quality authority remain external. |
| claim composition | Compatible AP242 definition/effectivity and QIF plan/result claims retain sources; contradictory result status returns conflict; incompatible intervals remain non-comparable. Passes for qualified branches. |
| transformation | Known mapping, one-to-many characteristic, unit conversion, unmatched feature, unknown unit, stale result, missing provenance, and source-timeout cases return the specified branches. One unknown-unit row stops. |
| realization/interface | Stable semantic metadata is available; volatile source data is queried under captured occurrence times. The constructed one-second response meets the two-second limit. Timeout returns incomplete only under the contract; challenge paths resolve to premises. Conditional pass. |
| provenance/currentness/quality | Every accepted output row recovers sources, rules, and times. The configuration matches the released review basis; QIF observations six hours before T meet the 24-hour window, while a 25-hour control returns stale. Undefined-extension rows remain visibly unresolved outside the qualified set. |
| receiving workflow | The quality engineer retrieves a known result, recognizes unmatched/incompatible/conflict states, and stops on unresolved configuration or identity. Passes for the bounded subset. |
The whole-use disposition is narrow under the stated contract: the qualified row set is usable for the evidence-return workflow, while the undefined local-extension and unknown-unit branches remain separately visible and unresolved. The receiver’s permission covers this partial evidence answer. The account does not accept the inspection result or release the configuration. A definition or unit-table repair reopens only the affected rows and receiving tests.
SIE.10:5.2 - A Decisive Defect and a Changed Receiving Meaning
In a constructed mapping probe, an input of 1 metre produces an output labelled 1 millimetre; the receiving contract requires 1000 millimetres. The input, rule, expected value, and observed output are enough to establish this mapping failure. Return that defect to SIE.7. Other layers remain unexamined; their results are unnecessary for this bounded failure. If the source unit is unavailable instead, the conversion premise remains unresolved at that scope.
Now consider a previously qualified availability interface. Its JSON field and numeric type stay unchanged, but the source changes the value from present availability to a future promise horizon. The receiver still reads the displayed quantity as “available now”. A passing shape check cannot support the earlier use conclusion: the changed interpretation defeats a relied-on premise. SIE.11 identifies the affected mapping and interface uses.
After repair, a positive conclusion for that receiving use needs the corrected interpretation and every other load-bearing condition. Matching earlier evidence can supply unchanged conditions; the known failure or its repair alone cannot establish the whole result.
SIE.10:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | The validation team is treated as release, quality, safety, or business authority. | State the semantic conclusion and return the owning decision with its conditions. |
| Architecture | Available automated tests define all validation layers. | Add qualified semantic, identity, authority, and receiving-work evidence where automation cannot decide. |
| Ontology/Epistemology | Well-formed representation, true relation, supported claim, and usable decision collapse. | Test each claim at its layer and keep the whole-use composition explicit. |
| Pragmatics | A decisive failure still triggers every layer test. | Finish the bounded failure with sufficient evidence; require full load-bearing coverage for a positive whole-use or permitted subset claim. |
| Didactics | A score invites compensation across hard stops. | Use categorical layer dispositions with evidence and state that stops are non-compensatory. |
SIE.10:7 - Conformance Checklist
Apply the layer requirements below to the conclusion being claimed. A bounded failure or unresolved result needs sufficient evidence for that result; a positive use claim needs all of its load-bearing obligations covered.
- The subject, receiving use, and conditions required by the conclusion are identified.
- Known decisive evidence can finish a bounded failure or scoped gap; material unexamined premises remain distinct from passing ones.
- Carrier/schema pass is not reported as semantic or receiving-use pass.
- Endpoint/model adequacy includes examples and counterexamples for required distinctions.
- Correspondence judgment and mapping execution are tested separately.
- Every load-bearing identity disposition, issuer/authority condition, and unresolved branch is tested.
- Claim composition tests include conflict, non-comparability, incomplete source, and source-claim recoverability.
- Realization/interface tests cover currentness, failure, partial results, access/protection, provenance, and challenge paths as applicable.
- Quality dimensions and thresholds are selected by the use and do not replace representative Work.
- Positive, boundary, negative, unlike, and changed-source cases cover the material failure modes.
- Whole-use disposition is pass, narrow, unresolved, or stop with no score-based compensation of hard stops.
- Repairs, direct-owner returns, focused retests, affected consumers, and reopen conditions are explicit.
- No external release, acceptance, authorization, effect, or universal correctness claim is implied.
SIE.10:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Valid schema, therefore valid integration | Test meanings, relations, identity, composition, mappings, provenance, quality, and receiving Work separately. |
| One quality/confidence score | Record layer-specific evidence and categorical dispositions; preserve hard stops. |
| Happy-path demonstration | Add negative, boundary, unlike, changed-source, stale, conflict, and failure cases. |
| Provenance completeness means truth | Test the source claim and receiving adequacy; provenance only makes derivation inspectable. |
| High alignment benchmark score | Validate local endpoint relations and use loss against representative cases. |
| All-or-nothing readiness | A known defect can finish a bounded failure. A positive subset result requires the contract’s permission and all premises on which that subset relies. |
| Semantic validation authorizes release | Return the account to the engineering, quality, safety, legal, or application authority. |
SIE.10:9 - Consequences
Defects are localized to source, semantic, identity, composition, mapping, realization, interface, quality, or receiving-use layers. A bounded useful result can proceed without hiding excluded branches, and later changes can trigger focused replay through explicit dependencies.
The cost is several kinds of evidence and collaboration with domain and receiving practitioners. Some integrations that appear technically complete remain unresolved or stop because their identity, authority, or representative-use premises are missing.
SIE.10:10 - Rationale
Semantic integration is a claim chain. Different links require different evidence, and the receiver depends on their composition. Layered validation keeps the scope of each test result explicit. A positive conclusion requires support for every load-bearing premise of the claimed whole use or contract-permitted subset.
SIE.10:11 - SoTA-Echoing
The best-known line combines constraint validation, ontology-alignment evaluation, provenance, data-quality models, quality management, and user/task validation. The serious defaults are conformance-only testing and aggregate quality scoring. Conditions at different layers need their own evidence. Even when every condition is measured, a high score at one layer cannot offset failure of a required condition at another. SIE.10 combines these contributions in a dependency-aware account with categorical bounded dispositions and representative Work replay.
| Source line | Adopt, adapt, or reject | Role and limit |
|---|---|---|
| SHACL | adapt | Supplies declared RDF graph constraint validation; passing shapes do not establish all semantics, identity, truth, or use fitness. |
| DQV and ISO/IEC 25012:2008 | adapt | Supply quality vocabulary and a data-quality model; select dimensions and measurements by receiving action. |
| ISO 8000-61:2016 | adapt | Contributes data-quality management process questions; process conformance does not prove fitness of the answer for its receiving use. |
| OAEI 2025 results | adapt | Provide alignment-evaluation tasks and evidence; a local correspondence set still needs evidence for its intended use. |
| one conformance gate or aggregate score | reject as sufficient | Unlike layers and hard stops must remain separately visible before a whole-use conclusion. |
Reopen when a relied-on source, model, identifier, correspondence, composition, mapping, realization, interface, quality threshold, or receiving workflow changes; when new evidence defeats a layer; or when a representative case exposes an untested load-bearing obligation.
SIE.10:12 - Relations
SIE.1supplies the receiving obligations, accepted loss, authority, representative cases, and stop rules.SIE.2supplies source meanings, editions, authority, provenance, access, currentness, and gaps.SIE.4–SIE.9supply the correspondence, identity, claim-composition, mapping, realization, and interface subjects and their branch contracts.- Current FPF
A.10andA.10.1govern evidence/provenance reliance and generic affected-use discovery. SIE.11traces changed source, model, mapping, or interface premises to the receiving uses that rely on them. Matching earlier validation remains usable for unaffected results; material changes reopen the relevant premises and receiving interpretation.- Applications, Systems Engineering, quality, safety, legal, MDM, Data Engineering, and Operations owners consume the bounded account and retain their own acceptance, authorization, operation, and outcome decisions.
SIE.10:End
SIE.11 - Trace Semantic Change and Revalidate Affected Uses
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: qualified results for the semantic-integration uses affected by a changed premise; an
AffectedSemanticUseRevalidationAccount@Changeassembles them when a receiving use needs a common account.
SIE.11:1 - Problem Frame
Use this when a relied-on source definition, model commitment, identifier meaning, mapping premise, or interface interpretation changes and the integration’s continued use needs a decision. A familiar warning sign is an unchanged API field that now answers a different question.
Start by comparing the earlier and later meaning at the receiving question. A compatible documentation move can finish with a reference repair. A changed meaning can require repair or renewed validation of the integration results that relied on it.
The object is the affected semantic reliance and its consequences for receiving uses. The gain is a justified continuation, repair, narrowed use, or scoped unresolved result. To assert that all uses remain unaffected, establish adequate coverage of the relevant uses and their reliance.
Use the applicable domain Method directly for a known operational change that does not alter a relied-on source or semantic premise. If one already identified use is the whole question, resolve it with the relevant domain Method and retain the source, currentness and result-specific grounds that the use needs. Use A.10 when the source-to-use account is still implicit or needs to be made replayable. A.10.1 is needed when affected uses must be discovered across a scope.
SIE.11:2 - Problem
A source update can be treated as harmless because the schema still parses, or as universally disruptive because its version changed. Both responses miss which uses depend on the changed meaning. Some consumers use a definition that changed; others use a different proposition from the same source; still others are merely mentioned in nearby records.
Indiscriminate revalidation consumes work without settling those differences. An incomplete search can create the opposite error: one repaired mapping is reported as proof that the entire integration remains valid.
SIE.11:3 - Forces
| Force | Tension |
|---|---|
| Selectivity | Only affected reliance needs reopening, while hidden consumers can remain dependent on changed meaning. |
| Continuity | Matching earlier results save work, while changed assumptions can invalidate them. |
| Coverage | A local answer can finish promptly, while a wider no-impact claim needs wider support. |
| Authority | An integrator can repair its mappings and interfaces, while source and receiving decisions retain their owners. |
| Evidence effort | Additional inquiry can change a decision, while unavailable or low-value information can consume the work needed for repair. |
SIE.11:4 - Solution
Follow the changed proposition through semantic dependencies to the results and receiving uses it can alter. Complete supported branches at their proper scope. Assemble a wider account only for a receiver that needs it.
SIE.11:4.1 - Pattern-Use Unfolding
- Compare the relied-on meaning. Identify what the receiving question depended on in the earlier source or premise and what the later content says. Include changed applicability, subject grain, interval, assumptions, or limits where relevant. An inaccessible later definition leaves that comparison unresolved.
- Finish a compatible repair when sufficient. If content, applicability, and access remain compatible for the use, make the needed reference repair and retain matching results. A version or URL change alone does not require every downstream Method to run again.
- Find affected uses when their scope is unsettled. Apply A.10.1 to discover which uses rely on the changed premise within the question’s scope, using source-side and receiver-side evidence or an index that adequately covers both. Distinguish a material dependency from a mention. Retain coverage gaps that limit the intended conclusion.
- Select the integration result that the change can alter. Use the domain returns below. Follow a further consumer only when the changed result can alter its action or claim. The physical proximity of files is not a dependency rule.
- Repair or revalidate that result. Apply its defining Method to the changed premise. Reuse earlier evidence whose conditions still match. Return a supported continuation, repair, permitted narrower use, or scoped gap. Source truth, master identity, product release, and application decisions go to the owners of those decisions.
- Return the completed branch. Give the receiver the result it needs, with the changed premise and remaining limits where those affect reliance. A completed direct result is sufficient for its own receiving question.
- Combine results when a receiver needs the wider answer. State the covered uses, their relevant results, unresolved uses or discovery gaps, and the continuation that those results support. A broader no-impact conclusion requires the corresponding coverage; completed local branches cannot supply unexamined ones.
When additional evidence is being considered, apply C.11.DUA to compare its attainable contribution to the receiving decision with its cost, delay, downside, and displaced work. A gap can remain a qualified gap when further inquiry cannot support a worthwhile next action; that limitation does not warrant a stronger claim.
SIE.11:4.2 - Domain Returns
| Changed reliance | Integration result to revisit |
|---|---|
| A concept, relation, or model constraint | SIE.3 model adequacy and any affected SIE.4 correspondence. |
| Identifier assignment, formation or resolution rule, entity grain or interval | Follow the changed premise to its direct users. Reassignment may affect one entry. A general rule may change the entries SIE.2 can resolve or the requests SIE.9 accepts and the SIE.10 tests for those requests. Reopen a SIE.5 identity disposition and its dependent uses when the changed premise supported that disposition. |
| Source-claim scope or interpretation | SIE.6 composition, conflict, or non-comparability result. |
| A transformation premise | SIE.7 mapping and its affected outputs. |
| Availability, permissions, freshness, or service conditions | SIE.8 realization choice or SIE.9 receiving interface, according to the changed condition. |
| Receiving meaning or acceptance condition | SIE.9 interface contract and the corresponding SIE.10 validation. |
This table locates the defining result; the dependency determines which returns are needed and their useful order.
SIE.11:4.3 - Record the Result
For a direct repair, use the result already needed by its consumer. For a common account, retain the following content at the scope the receiver needs:
| Account position | Receiving content |
|---|---|
| Change and reliance | Earlier relied-on meaning, later meaning, and the affected question. |
| Covered uses | Dependencies and the basis for the stated discovery scope. |
| Direct results | Completed repairs, revalidation, permitted continuation, or narrowed uses under their defining Methods. |
| Unresolved reach | Unexamined or inaccessible reliance, discovery gaps, and their effect on the conclusion. |
| Continued use | What the receiver can now rely on and which changed conditions would reopen it. |
The account summarizes its constituent results.
SIE.11:4.4 - What Changes in Practice
The maintainer can say which interface meaning changed, which mapping or identity result was revisited, and what can continue. A corrected local reference can finish immediately. A broader claim remains bounded by the uses discovered and assessed.
SIE.11:5 - Archetypal Grounding
SIE.11:5.1 - Compatible Reference Repair
A publisher moves a vocabulary definition to a new documentation address. The integrator can access both the relied-on content and its new location. The definition, applicability, and access needed by the mapping remain compatible.
The integrator updates the reference used by that mapping. Its existing qualification still answers the unchanged question. That completes the reference-maintenance request.
If the later definition cannot be inspected, the same evidence cannot support this conclusion. The result then names the inaccessible comparison and the reliance it leaves unresolved.
SIE.11:5.2 - Changed Promise Horizon
A provider changes availableToPromise from the reservation meaning used for present availability to a promise for a future horizon. The API field and its numeric type stay the same. The semantic-integration maintainer compares the two meanings and inspects how the consumers use the quantity.
| Use | Reliance and result |
|---|---|
| Present-availability endpoint | Its mapping treated the quantity as answering “available now”. That premise changed. Repair the mapping and interface meaning, or withhold that answer until a qualified present-time source is supplied. SIE.10 checks the supported receiving result. |
| Future planning view | It can use the new quantity when it exposes the horizon and the receiving question agrees. Validate those conditions instead of assuming that every use must stop. |
| Descriptive product catalogue | Its definitions and product descriptions do not consume the changed quantity. Where that independence is established, retain its matching result. |
| A consumer with unavailable interpretation | The maintainer cannot determine how it uses the quantity. Return that scoped uncertainty; the other completed branches retain their own results. |
If the service owner needs an integration-wide continuation decision, the account combines those results and the remaining uncertainty. It does not state that all uses are unaffected. The provider controls its source definition; the integrator controls the supplied semantic interface; each application owner determines whether the qualified answer is adequate for its decision.
SIE.11:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | The integration maintainer appears to authorize the application’s decision. | Return the qualified integration result to the receiving decision owner. |
| Architecture | Every linked component is treated as an affected consumer. | Follow the changed proposition through dependencies that can alter results. |
| Ontology/Epistemology | An unchanged field name is read as unchanged meaning. | Compare the definition, applicability, and receiving interpretation. |
| Pragmatics | All validation restarts after every source version change. | Retain matching results and finish sufficient direct repairs. |
| Didactics | A list of completed checks looks like complete coverage. | State which uses the evidence covers and preserve unresolved reach. |
SIE.11:7 - Conformance Checklist
- The compared change concerns a premise used by an identified receiving question.
- Compatible reference repair can complete without a wider account.
- Discovery, where needed, supports the stated scope and distinguishes dependencies from mentions.
- Each affected integration result uses its defining Method.
- Each earlier result reused for this conclusion is valid under the conditions of the use under review.
- Independently supported branches finish at their own scope.
- A common account has a receiving use and preserves unresolved coverage.
- A wider no-impact claim has support for the uses it covers.
SIE.11:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Schema compatibility as semantic compatibility | Compare the question answered by the field, including its horizon and applicability. |
| Every reference occurrence requires revalidation | Establish whether the result relies on the changed proposition. |
| One repaired branch clears the whole integration | Bound the conclusion by discovered and assessed uses. |
SIE.11:9 - Consequences
Supported uses can continue while affected branches receive focused repair. Dependency evidence becomes useful because it points to a changed receiving result. Local completion no longer waits for an unnecessary integration-wide account.
Finding hidden reliance and interpreting source changes can require domain and receiver participation. A wider assurance claim may remain unavailable while an actual consumer or later definition is inaccessible. The result preserves that limitation without erasing completed branches.
SIE.11:10 - Architectural Rationale
The changed proposition, rather than the changed carrier, determines semantic impact. Use the relevant domain methods to resolve each affected result. Discovery identifies where those questions arise. Keeping those contributions distinct permits reuse, independent completion, and limits on wider conclusions.
SIE.11:11 - SoTA-Echoing
The practice question is which receiving uses must change when one semantic premise has changed and the affected scope is still unsettled. In §5.2, both the present-availability endpoint and other consumers exist; knowing the changed field alone does not settle their reliance. The selected line combines A.10/A.10.1’s premise comparison and scoped discovery with the integration-specific returns in §4.2.
The serious alternative is a bounded full regression: identify the same receiving scope, update the tests to the new source meaning, and revalidate every registered use in it. This can be preferable when the suite is small and inexpensive or a reliable dependency analysis would cost more. It is not merely rerunning old tests against an unchanged schema.
| Answer to the same multi-use horizon change | Work and evidence at the same scope | Selection and accepted trade-off |
|---|---|---|
| Discover changed reliance and revalidate affected results | Compare the two meanings, inspect source-side and receiver-side dependencies, qualify coverage, and retest results that rely on the changed horizon. Keep applicable evidence for the independent catalogue. | Adopt A.10/A.10.1 in §4.1.1–3/5–7; adapt §4.2 and §5.2 to semantic model, mapping, interface, and validation results. This avoids repeating the catalogue’s unrelated checks and lets supported branches finish. It spends effort establishing dependencies and leaves an inaccessible consumer unresolved. |
| Revalidate every identified use in the same receiving scope | Make the same meaning and coverage comparison, then execute the appropriate receiving-use checks for every member, including those ultimately found independent. | Retain this alternative when those checks are cheaper or more dependable than selective impact analysis. It may reduce reliance on a detailed dependency model, but can repeat unaffected checks and delay a common release. It still cannot clear an unknown consumer or infer meaning from schema compatibility. |
For the worked horizon case, the established catalogue independence and separable endpoint results justify selective revalidation. The accepted trade-off is the work needed to establish that independence and the explicit limit on the unknown consumer. §4.1.7 prevents local completions from being mistaken for a wider no-impact result. For one already known use, the direct domain result remains sufficient under §1.
LOT4KG supplies a current candidate line for changes that propagate between an ontology, mappings, graph content, constraints, and validation. Adapt those relationships in §4.1.4–5 and §4.2 when a KG realization is selected. They help locate which integration result needs work; they do not choose source truth, application action, or a universal regression policy. For other realizations, the same return question is answered from their semantic dependencies. Reject a changed version alone as evidence that every use failed, and an unchanged carrier alone as evidence that every use passed.
Reopen this comparison when an affected use was missed, when a dependency or coverage claim is defeated, or when the cost of qualifying selective impact exceeds the available full receiving-use regression. Reconsider only the affected discovery and checking choice in §4.1.3–5. Changed results still require their domain evidence whichever strategy is selected.
SIE.11:12 - Relations
- A.10.1 governs affected-use discovery when the scope of reliance needs to be found.
- SIE.2 supplies the source meaning, edition, authority, and access premises used in the comparison.
- SIE.3–SIE.9 supply the domain results located in §4.2; SIE.10 supplies validation for the affected receiving claim.
- SIE.12 supplies the module dependencies and material-change arrangements when participants depend on shared semantic modules.
- Domain source owners, MDM, SYSE, operational providers, and receiving applications retain their respective decisions.
SIE.11:End
SIE.12 - Govern Modular Semantic Commons without Universal Authority
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
ModularSemanticCommonsAccount@Communitydescribing how actual users maintain and rely on shared semantic modules, their dependencies, decisions, and releases.
SIE.12:1 - Problem Frame
Use this when independently governed participants depend on shared semantic modules and need an arrangement for maintaining them. A typical failure is a changed shared term whose consumers cannot determine who could approve the change, which meaning their interface uses, or how to migrate.
Start with one module and the uses that depend on it. Establish its scope, who can decide its content and release, and how its users can obtain an identifiable maintained edition. The first useful result is an agreement through which those participants can make and use a concrete module change.
The object is the shared maintenance and reliance arrangement for semantic modules. The gain is continued reuse with explicit local commitments, contribution rights, dependencies, and change consequences. A compatibility claim covering additional users needs support for those users’ relevant reliance.
A team or a pair maintaining one interface can use its ordinary model and interface agreement when that suffices. A repeated file or shared repository alone does not establish a commons that needs this Method.
SIE.12:2 - Problem
Reusable semantic assets acquire users outside their original project. A term, class, relation, or mapping then carries assumptions into interfaces maintained by other participants. Changes can break those assumptions even when the shared file remains available.
One response is to require every participant to adopt one centrally controlled model. Another is to allow local changes without a recoverable relation to the shared meaning. Both can defeat useful reuse: the first can suppress necessary domain distinctions, while the second makes compatibility impossible to assess.
SIE.12:3 - Forces
| Force | Tension |
|---|---|
| Shared meaning | Common modules reduce repeated work, while participants retain distinct purposes and source authority. |
| Local development | Extensions can answer local questions, while consumers need to know which shared commitments still hold. |
| Decision rights | Maintainers need power to release a module, while contact or repository access alone cannot establish that remit. |
| Stability | Identifiable meanings support reliance, while mistakes and changed requirements need correction. |
| Participation | Open contribution can improve coverage, while unresolved proposals still need a usable decision path. |
SIE.12:4 - Solution
Define the smallest shared module arrangement that serves the users who depend on the modules. Make its semantic scope, decisions, dependencies, and releases usable in their integration work. Preserve local modules and disagreement where convergence is unnecessary or unsupported.
SIE.12:4.1 - Pattern-Use Unfolding
- Identify the shared use. Name the users and questions that depend on the module. Locate the semantic content they share and the local distinctions they still need. If one interface agreement meets the need, complete that agreement through the relevant SIE Methods.
- Set module boundaries. State the module’s domain, concepts and relations, intended uses, material exclusions, and relation to local extensions. Use SIE.3 for content that needs model development and SIE.4 for qualified correspondences between different module meanings.
- Establish identification and dependencies. Choose namespaces or identification practices that let consumers recover the intended term or module meaning. Identify editions and the dependencies each supported use needs. A permitted version range must have a semantic compatibility basis for its claimed use.
- Assign the decisions and communication. State who may propose changes, decide module content, release an edition, resolve a disagreement under the community’s rules, and communicate with users. Record the scope of each responsibility. A source owner retains its source meaning and issuance authority.
- Make contribution workable. Give a proposer enough guidance to supply the changed meaning, rationale, examples, affected modules, and known consumer consequences. Route the proposal to whoever is authorized to decide it. Keep an unresolved disagreement explicit and permit a scoped local extension or alternative module when it can serve its users.
- Prepare the release for its consumers. Identify material semantic changes and use SIE.11 for affected reliance. Provide the edition, access, dependency conditions, and migration or deprecation information needed by those users. Distinguish a clarification from a changed meaning; preserve a way to identify the earlier meaning when consumers still rely on it.
- Notify and maintain at the agreed scope. Give affected users notice that permits the action required by their dependency and the community agreement. Maintain a responsive contact and a workable path for corrections. An urgent correction may require immediate qualified publication and notification; describe the resulting limits.
- Return the usable arrangement. Show how the named participants can obtain a module, propose a change, decide and release it, and interpret the effect on their supported uses. An unresolved decision right or dependency limits the part of the commons that can be claimed as governed.
These responsibilities can fit a small agreement for a small commons. Broader participation adds work only where additional semantic dependence or decision needs arise.
SIE.12:4.2 - Record the Result
| Arrangement position | Content used by participants |
|---|---|
| Shared module and users | Semantic scope, supported uses, and the participants who depend on it. |
| Local relationship | Extensions, maintained correspondences, disagreements, and the commitments claimed across module boundaries. |
| Identification and dependencies | Namespaces or equivalent identifiers, recoverable editions, access, and dependency or compatibility conditions. |
| Decisions and communication | Who may propose changes, decide content, release an edition, resolve disputes and communicate with users, and the scope of each responsibility. |
| Change and continued use | Material-change assessment, notices, correction, migration, deprecation, and maintained access needed by consumers. |
Refer to existing module definitions and working agreements when they supply this content. The account makes the arrangement recoverable; it need not reproduce every module or introduce a separate record for each responsibility.
SIE.12:4.3 - What Changes in Practice
A user can identify the meaning and edition its interface consumes and find the decision needed for a proposed change. Maintainers can release a scoped improvement while preserving the commitments they claim to retain. Participants can keep different local meanings through explicit module boundaries and correspondences.
SIE.12:5 - Archetypal Grounding
SIE.12:5.1 - Equipment Classes Shared by Three Organizations
Two manufacturers and a service partner exchange service observations using a shared equipment-classification module. Each manufacturer also has local classes needed for its own products.
| Arrangement | Concrete use |
|---|---|
| Shared core | Describes the equipment categories needed to interpret the service observations. |
| Local modules | Retain product-specific distinctions and identify their relation to the shared core. |
| Correspondences | State the qualified relations between local and shared classes; different meanings remain visible. |
| Content decision | The agreed maintainers decide changes to the shared module within its stated scope. |
| Release decision | The participant authorized to release the module publishes an identified edition and its dependency conditions. |
| Contact | A reachable participant receives questions, communicates decisions, and helps route disputes. |
| Source authority | Each manufacturer retains the authority for its product descriptions and issued source claims. |
A participant proposes changing a shared class from “equipment with a replaceable drive” to “equipment serviced through a replaceable drive module.” The second definition changes the classification criterion. Existing service queries can depend on the first meaning.
For this constructed agreement, the maintainers retain the earlier class and introduce a distinct class for the new criterion. The illustrative identifier equip:DriveReplaceable continues to mean “equipment with a replaceable drive”; equip:DriveModuleServiceable means “equipment serviced through a replaceable drive module.” The second module edition contains both definitions and leaves the earlier edition accessible. It asserts no equivalence between the classes.
The manufacturers’ qualified product descriptions supply these discriminating cases:
| Equipment | Earlier class | New class |
|---|---|---|
| X: its drive can be replaced as a separate part; it has no replaceable drive service module. | Included: the drive is replaceable. | Excluded: module replacement is not its service arrangement. |
| Y: its drive can be replaced separately, and the supported service arrangement also provides a replaceable drive module. | Included. | Included under the module-service criterion. |
SIE.11 follows the changed classification need to the queries that use the classification. Two consumer outcomes complete the illustrative transition:
- The service partner changes its receiving question to module-replacement planning. It adopts
equip:DriveModuleServiceable, updates the relevant correspondence and query, and verifies that Y is included and X excluded. The receiving owner accepts that scoped result; SIE.10 validates its integration premises. - Manufacturer A retains its spare-drive query against
equip:DriveReplaceable. Its required meaning and the qualified X/Y results remain unchanged, so it retains matching evidence for that use. Adopting the new class is not a prerequisite for continuing this query.
The participant authorized to release the module publishes the identified edition with those definitions, dependency conditions, and migration information. Contact supplies the notice; the content decision, product-source claims, and receiving decisions keep the separate remits shown above. The two completed consumer results do not establish migration by every other user. If the two manufacturers require incompatible local criteria, the commons can retain scoped local modules and their qualified correspondences.
SIE.12:5.2 - A Sufficient Interface Agreement
Two providers agree to expose separately attributed on hand and available to promise values. They have no additional users maintaining a shared module.
Their agreement identifies the meanings, source owners, interface responsibilities, and change conditions. SIE.3 and SIE.9 can supply the model and interface results. Those results complete the current need. A commons arrangement becomes useful if independently maintained shared modules and their users create a further maintenance problem.
SIE.12:5.3 - Urgent Semantic Correction
A shared mapping incorrectly interprets a quantity’s unit, and a supported interface can return a wrong answer. The authorized maintainer corrects or withdraws the affected mapping according to the community’s rules, identifies the affected edition, and notifies its consumers. The notice explains the correction and the supported continuation.
The completed action is an urgent qualified correction with notification. Earlier users’ unresolved reliance remains visible for SIE.11; the action cannot establish that every consumer has already migrated.
SIE.12:6 - Bias-Annotation
| Lens | Likely drift | Repair |
|---|---|---|
| Governance | A listed contact is treated as the owner of every semantic decision. | State content, release, dispute, communication, and source responsibilities and the remit of each. |
| Architecture | A single large model replaces useful local modules. | Start with the shared uses and retain local distinctions through scoped dependencies and correspondences. |
| Ontology/Epistemology | A stable label conceals a changed classification criterion. | Compare meanings and examples; keep earlier and replacement meaning identifiable. |
| Pragmatics | A small interface acquires unnecessary community machinery. | Complete the local agreement when it meets the shared need. |
| Didactics | A version number is read as a guarantee of compatibility. | State the semantic basis and receiving scope of compatibility. |
SIE.12:7 - Conformance Checklist
- The users’ reliance on the shared modules justifies the arrangement.
- The shared scope and local extensions preserve the commitments they claim to use.
- Consumers can identify the model meaning, edition, access, and applicable dependencies.
- Proposal, content, release, dispute, contact, and source responsibilities are distinguishable where they matter.
- A material change has a usable decision and affected-consumer path.
- Identification, notice, migration, and deprecation follow the chosen rules and the consequences for the uses that depend on the module.
- A local interface can finish without creating an unnecessary commons.
- Unresolved rights or reliance limit the corresponding claimed arrangement.
SIE.12:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Repair |
|---|---|
| Shared repository treated as governance | Establish who can make the decisions and which module dependencies the users need to maintain. |
| Contact metadata treated as decision authority | Identify who may decide content and releases and at what scope. |
| Silent meaning replacement | Expose the changed criterion, identification treatment, and consumer consequences. |
| Mandatory convergence of incompatible meanings | Retain scoped alternatives and the correspondences that have support. |
| Announcement treated as completed migration | Distinguish notification from each affected consumer’s result. |
SIE.12:9 - Consequences
Shared modules can evolve while their users retain identifiable meanings and workable returns. Local development remains possible, and a community can decide changes without claiming authority outside its remit.
The arrangement costs maintenance, communication, and change assessment. Those costs increase with real dependency and participation. Some proposals remain local or unresolved when shared convergence cannot be justified.
SIE.12:10 - Architectural Rationale
A commons is useful through the semantic commitments its users share and the decisions they have the authority and practical means to make. Module boundaries preserve the scope of those commitments. Identifiable meanings and dependencies let users determine how a change affects their work; assigned rights let the relevant participants act on that result.
SIE.12:11 - SoTA-Echoing
The practice question is how the three independently governed organizations in §5.1 can change their shared equipment classification while keeping supported service queries interpretable. The selected line is a scoped shared core with separately maintained local modules, explicit dependencies, identifiable meanings, and assigned content and release rights. It adapts the OBO Foundry principles to these users.
A serious alternative for these same users is a jointly qualified release bundle: publish the relevant shared core and local profiles as one identified, compatible combination. This also preserves source authority and can retain older supported editions. It offers one combination to qualify instead of asking every consumer to select compatible module editions; it need not impose a universal ontology.
| Arrangement for the same equipment-class change | Comparable effort and gain | Selection and accepted trade-off |
|---|---|---|
| Shared core with independently maintained local modules | Examine the same changed criterion, equipment counterexamples, mappings, and receiving queries. Qualify the affected module interfaces and state the editions each supported use can combine. An unchanged local module can remain on its supported basis. | Adapt §4.1.2–3/5–7 and §5.1. Separate module maintenance preserves the participants’ local distinctions and lets a scoped change proceed without constructing another joint bundle. It requires explicit dependency and compatibility evidence; independent version numbers alone are insufficient. |
| One jointly qualified bundle of the relevant core and profiles | Use the same meanings and cases and reuse unchanged component evidence, then qualify and identify the supported combination. Coordinate its release and continued support with the three participants. | Retain this alternative when consumers need a common deployment combination or the participants can qualify it more economically than separate compatibility claims. It simplifies edition selection but adds joint-release coordination, including when only one component changes. |
For §5.1’s independently owned local classifications, the modular arrangement is selected to preserve useful local change and scoped reuse. The accepted cost is maintaining compatibility and reliance evidence at the module interfaces. A joint bundle may be better when the shared receiving use requires it; fewer files or a central release number cannot decide the comparison. A pair needing only one interface remains the distinct sufficient-agreement case in §5.2, not the rival used to justify this commons.
| Source and role | Operative move and transfer limit |
|---|---|
| OBO Foundry principles supply the selected commons-practice line. | Adapt actual users, collaboration, modular reuse, and maintained access in §4.1.1–2/5/8. OBO participation criteria keep their community scope; they do not prescribe the release arrangement of these three organizations. |
| OBO term stability constrains either arrangement. | Adapt §4.1.3/6 and §5.1 so a materially changed criterion remains distinguishable from the earlier meaning under the chosen identification rules. Reject silent replacement behind a familiar label. |
| OBO contact responsibility supplies a communication contribution. | Adapt §4.1.4/7 to a reachable contact and mediation path. Assign content and release rights separately; contact alone establishes neither. |
| OBO change notice constrains continued reliance. | Adapt §4.1.6–7 to actual consumer action and the community agreement. A community-specific notice interval does not settle another commons’ timing, and notification does not prove migration. |
| The public ISO/IEC 21838-1 scope supplies a possible common top-level basis. | Adapt §4.1.2 only when that basis contributes needed coherence. It decides neither module maintenance nor the release and versioning arrangement compared above. |
Reopen the arrangement comparison when one supported use requires a joint edition that separate compatibility claims cannot economically supply, when a mistaken module-dependency claim breaks a receiving query, or when changed participant rights prevent the selected release path. Reconsider the affected module combination and §4.1.3–7. A new local distinction alone does not require replacing the entire commons.
SIE.12:12 - Relations
- SIE.3 develops or qualifies module content; SIE.4 establishes correspondences between different meanings.
- SIE.5 retains identifier authority and grain when the use depends on identity.
- SIE.9 supplies the receiving interfaces that consume shared modules.
- SIE.11 follows material semantic change to affected results and users; SIE.10 supplies their integration validation.
- Domain authorities retain source meanings and claims. A.3.1.MI contributes Method introduction or revision when the community is changing how it works.
SIE.12:End
SIE.13 - Construct a Semantic Integration for a Named Receiving Use
Type: Method pattern Status: Stable Normativity: Normative method guidance within SIE; examples are constructed and non-normative.
Primary working result: a
SemanticIntegrationPackage@Usewhose required semantic contributions, implementation and evidence support one receiving use together, or a bounded partial result, unresolved question or stop that states what the receiver can now do.
SIE.13:1 - Problem Frame
Use this when a query, decision or operation needs separately governed information to work together, but obtaining the individual meanings, correspondences or mappings still leaves the receiving answer unavailable. A team may already have good source inventories, a model, mapping rules and working endpoints. The remaining question is how to connect those results, obtain the missing contributions and make an answer usable under their joint conditions.
The working object is one semantic integration for a named receiving use. Its whole result is the connected package described in SIE.Reference:4: a use contract, source premises, warranted semantic relations and claim composition, mapping behavior, realization and interface, with validation of the claimed use. Identity premises and model development enter where the answer depends on them. The package can reference existing results; it need not be one document, database or graph.
Start with the action the receiver must be able to perform and the information that could change that action. Compare the available contributions with what that answer requires. This comparison helps you choose the next contribution and recognize when the connected result is sufficient.
Ordinary non-use. Use the individual Method when its result finishes the question: SIE.4 can settle one correspondence, SIE.8 can reject a prohibited realization, and SIE.10 can identify a decisive defect in a supplied interface. An already adequate package can be used without reconstructing it. SIE.13 is needed when those local results still have to be made usable together. It does not select product configuration, establish master-data authority, operate a pipeline, authorize a purchase or accept a physical inspection result.
SIE.13:2 - Problem
Local correctness does not compose automatically. A relation may be true but too lossy for the intended substitution. A mapping may preserve a meaning while consuming an identity disposition for another configuration. Two sources may be individually fresh yet concern different periods. Separately feasible retrievals may compete for one request allowance. A correct response can still be read as the wrong kind of claim.
The opposite failure is to treat the complete repertoire as a mandatory lifecycle. A practitioner repeats qualified source work, builds an ontology that already exists, or develops an excluded realization before answering a small question. This spends effort without supplying the missing connection.
Neither a list of completed tasks nor a collection of approved descriptions establishes a usable integration. Someone must determine which contributions the receiving answer depends on, whether their conditions match, what remains to obtain, and how the supplied result reaches the receiver.
SIE.13:3 - Forces
| Force | Working consequence |
|---|---|
| Sufficient answer and wider reuse | The present contract bounds construction; a useful local answer need not anticipate every future consumer. |
| Source autonomy and combined meaning | Preserve source meanings and authority while establishing the relations the receiving use needs. |
| Reuse and changed conditions | Reuse a qualified result where its premises still match; a familiar result under a different interval or permission can need reopening. |
| Local feasibility and joint performance | Include shared limits and dependencies that no component can settle alone. |
| Useful partial result and misleading omission | Narrow only under the receiving contract, keeping excluded or unresolved branches interpretable. |
| Assurance and acquisition cost | Obtain evidence that can settle the current claim; a decisive rejection can finish without completing unrelated positive checks. |
SIE.13:4 - Solution
Construct the integration by working backward from the receiving answer and forward through the contributions that can supply it. At each connection, establish what one result permits the next operation to do, under which conditions. Obtain or repair the missing contribution, bring its result back into the combination, and test the claimed receiving use. Revisit only dependencies affected by a changed premise.
The organization is conditional. Several contributions may be available already; one result can expose a different question; and construction can end with a warranted stop.
SIE.13:4.1 - Establish what would let the receiver continue
Name the receiver’s question and the next action or judgement that the answer must support. Recover the required answer claims and the circumstances in which a partial, conflicting or unavailable answer is still useful. If these are unsettled, use SIE.1:4 to obtain the receiving-use contract. Otherwise use the supplied contract and reopen only a condition that no longer fits.
Distinguish the answer from its downstream authority. “These inspection observations concern this configured feature” can be a needed integration result; “release this product” remains an engineering or quality decision. This distinction determines which premises the integration must supply and which judgement remains with the receiving decision owner.
Compare the available result with that continuation. If it already suffices, return it with its applicable limits. If only one correspondence or one failed conversion matters, obtain that result from its Method and finish the bounded question. When the receiver still lacks a usable combination, retain the whole receiving need while identifying a smaller next contribution.
SIE.13:4.2 - Derive the required contributions from the answer
Take each answer claim that can change the receiving action and ask how it would be obtained. Follow it to the source meanings, represented claims, relations and transformations it relies on. For a query row, for example, recover why the selected records belong together, what each value means, which rule produces the output, and how an unavailable or incompatible input is represented. For a semantic exchange between organizations, recover the corresponding interpretation and use of each supplied statement.
Use the following returns where that dependency occurs:
| The receiving answer depends on… | Contribution to obtain or reuse | What returns to the construction |
|---|---|---|
| A source’s meaning, applicability or authority | SIE.2:4 | Qualified source-local premises and the gaps that limit their use. |
| A distinction the available model may not express | SIE.3:4 | Sufficient model reuse, an extension or a different model, qualified for the required questions. |
| A relation between source meanings | SIE.4:4 | A warranted relation, difference or incompatibility, with its permitted operations and loss. |
| Records concerning the same entity | SIE.5:4 | An identity disposition at the required grain and interval, retaining source identifiers and authority. |
| Several source claims contributing to an answer | SIE.6:4 | A qualified composition, conflict, non-comparability or unresolved branch. |
| Executable extraction or transformation | SIE.7:4 | Rules tied to those premises, including selection, conversion, absence, errors, loss and trace. |
| Obtaining and presenting the result in practice | SIE.8:4, SIE.9:4 and the implementation supplier | A feasible realization choice, the implementation obtained from its supplier, and a receiving interface with defined interpretations. |
Use a row when the answer depends on its contribution. For example, two already distinguished subjects can retain separately attributed claims without a cross-source identity merge. A qualified existing model can supply the required distinction without new model construction. A supplied mapping may already carry the relevant source and correspondence references.
For each required contribution, determine whether it is available under the needed conditions, unavailable, or not yet qualified. An inaccessible definition, a missing distinction, a false correspondence, a missing implementation and an incompatible access condition are different obstacles. State which dependent answer each obstacle prevents; do not reduce them all to “more data needed”.
Keep the account in the working material the participants can use. A short annotated query or mapping specification can be sufficient. A larger integration may need linked descriptions. Their form matters only insofar as the dependencies and unresolved questions remain recoverable.
SIE.13:4.3 - Make the connections valid for this use
Before consuming a result, compare its subject and conditions with the operation that will use it. Match the relevant meaning, entity grain, configuration or time, source and rule versions, authority, permitted loss and failure behavior. A qualified result for one use is a candidate for reuse, not a universal permission.
Keep these three questions distinct:
- What relation or claim is supported? A characteristic can concern a feature without being that feature. Two descriptions can concern the same feature while their claims conflict.
- What does that result permit here? A broader relation may support navigation but not value substitution. An accepted loss for an overview may be unacceptable for an inspection calculation.
- Can the required contributions hold together? A mapping qualified for one effectivity interval cannot borrow an identity judgement from another interval merely because the labels match.
When a connection fails, identify the premise that would have to change. Obtain a narrower warranted relation, a different mapping, an applicable source edition or an authorized change to the receiving contract. Preserve useful alternatives separately while their conditions differ. Do not combine one alternative’s semantics with another’s permissions or performance evidence.
The connected explanation should make a resulting branch understandable. If a claim is non-comparable, show the distinction that prevents comparison. If an input is not retrieved, preserve that absence through the mapping and interface. A missing source becomes neither a zero value nor evidence against that source’s claim.
SIE.13:4.4 - Choose and obtain the next missing result
Choose the next contribution by what it can change in the receiving answer, using the dependencies just recovered. Start with a known decisive constraint when it can exclude an option without further construction. Otherwise prefer an obtainable result that resolves a consequential uncertainty or enables the next required operation at a justified cost.
For example, an existing prohibition on replication is enough to reject a copied store. It does not reject a permitted live query. An unknown definition that determines whether two quantities may be compared can matter before implementing either comparison. If the definition cannot be obtained, decide whether the contract permits separately attributed claims or whether the dependent answer must stop.
Perform or request the work that obtains the missing result. State its receiving purpose, required distinction or behavior, available inputs and acceptance condition. Use the relevant SIE Method for semantic work and the practice that supplies the other work. A platform owner can establish the request allowance; an implementer can supply and test a query; a domain owner can settle a source definition. The integration practitioner connects those results but does not acquire the suppliers’ authority by requesting them.
On return, inspect the supplied result and its conditions against the dependent operation. A selected realization is not its implementation, and a specification is not evidence of that implementation’s behavior. If the contribution is still absent, retain the precise blocker. If it supplies the needed result, reconnect it and determine what remains for the whole answer. When the recipient already has enough to continue, stop expanding the work.
Necessary coordination is part of obtaining the result: establish who can perform the required work, with which access and means, and how the result will reach its consumer. Existing skills in parsing and databases may still leave nobody able to resolve a temporal-identity question. Supply that contribution or leave the dependent answer unresolved.
SIE.13:4.5 - Compare the complete arrangement and its permitted branches
Use SIE.8:4 to compare the viable ways of realizing the accepted mapping behavior and supplying the result. Bring the semantic dependencies and the shared conditions into that comparison. Include required trace, failure and recovery behavior in the workload. Query permission, replication permission and disclosure permission remain separate inputs.
Test the combined demand against each applicable limit. Count the distinct requests in one allowance window, including the retry behavior on which the service promise depends. For time, follow the operations that must finish before the receiver can act; parallel operations and serial dependencies have different effects. For storage or access, apply the conditions that govern what the arrangement retains or makes accessible. A common resource limit concerns the combination even when every component fits alone.
Keep a common source or derivation visible when several contributions rely on it. Agreement among results that share a premise is not independent corroboration of that premise. Likewise, several pairwise comparisons do not establish a condition over all contributions together.
If the proposed whole fails, compare the continuations the contract permits. A narrower answer must retain the semantic premises, trace, access and interpretation required for that answer. An authorized contract change or a different realization can reopen the choice. Dropping a required provenance contribution or quietly redefining completeness cannot repair the same promise.
A decisive failure can finish the comparison for one alternative. Stop the whole requested use only when that failure defeats every continuation still allowed by the contract, or when the needed continuation remains unavailable. Distinguish a known impossibility under the stated conditions from an unresolved option that would need another contribution.
SIE.13:4.6 - Supply the interface and establish the bounded use result
Use SIE.9:4 to specify and supply the interface that carries the qualified meanings and branches into the receiver’s work. Obtain the implementation needed by that interface and the selected realization. Develop their specifications together where their dependencies require it; a changed semantic or service condition returns to the contribution that supplies it. Check that the actual input and output behavior preserves the rules and that the receiver can interpret the result as intended. Depending on the use, the interface can be a query, service, exchange file or a documented human-facing view.
Use SIE.10:4 to validate the claim now being made. For a positive whole-use or contract-permitted subset conclusion, every load-bearing premise and required joint condition needs matching evidence. Reuse evidence whose subjects, versions, use and conditions still fit. One decisive conversion error can establish a bounded failure without testing unrelated layers; correcting it alone does not establish the full positive claim.
Return the answer, its disposition and its consequences for the receiver together. A qualified partial answer states what is covered and what remains unavailable. An unresolved answer states the missing result and the use it prevents. A stop states the defeated obligation and the change that could make reconsideration useful. A semantic integration result supplies a premise to the receiving decision; its authorization and outcome remain with the receiving owner.
SIE.13:4.7 - Reopen changed reliance and reconnect the result
Retain the dependencies needed to recognize a change that can alter the answer: the source meaning or edition used, identity and composition premises, mapping rule, access or resource condition, and receiving interpretation. Preserve them where their consumers can retrieve them, rather than copying an unexplained final value.
When one changes, use SIE.11:4 to determine the affected uses and obtain the contributions that must be revised or revalidated. A changed promise horizon may affect a purchasing interpretation and its mapping while leaving product descriptions usable. A changed gateway allowance may reopen realization and validation while leaving correspondence evidence unchanged.
Bring each affected result back into the combination and repeat only the comparisons and use checks whose premises changed. Check the new whole’s joint conditions; a local repair can move demand to a shared limit. Where the set of consumers is unknown, keep that reach unresolved instead of treating the known consumers as exhaustive. Use SIE.12 only when participants that depend on shared modules need common maintenance and decision arrangements.
SIE.13:4.8 - Keep the result inspectable
The result must let the receiver recover the answer and its allowed use, the relied-on semantic contributions, their operative connections, the realization and interface supplied, and the evidence for the returned disposition. Keep material missing contributions and change conditions visible. The package anatomy locates the supplying results; it need not be duplicated in a new record.
For a small use, links from the returned query rows to a contract, mapping and qualified source material can carry this account. For a larger use, maintained specifications and implementation evidence may be necessary.
SIE.13:5 - Archetypal Grounding
SIE.13:5.1 - Connect configured product meaning to inspection evidence
A quality engineer needs the QIF inspection plan and observations concerning AP242 feature F17 in released configuration R at effectivity E. The constructed contract in SIE.1:5 permits qualified rows with separately visible unresolved local-extension and unknown-unit branches. It retains the 24-hour observation window and two-second response limit. These are stipulated receiving conditions, not properties guaranteed by either standard.
Suppose the source owners have supplied applicable product and inspection definitions, and an available model can distinguish a configured feature, an inspection characteristic, a plan and an observation. A proposed mapping equates characteristic C17 with product feature F17. Executing that mapping faster would not supply the requested meaning. The next useful contribution is the relation judgement, not another platform trial.
SIE.4 establishes that C17 concerns a feature; it is not itself that feature. The proposed connection also relies on a QIF feature description and the AP242 feature description concerning the same feature at R/E. SIE.5 supplies that separate identity premise from the applicable source evidence. If this required identity cannot be established, withhold the dependent inspection answer. A similar label or an observation for another configuration cannot fill the gap.
The claim composition can now retain the product-definition and plan-applicability claims with their owners, and attach the qualified observation to the configured feature. SIE.7 specifies the selection by R/E, the warranted characteristic relation, unit conversion, trace and error branches. The mapping may expose an observation in a requested unit; it does not thereby decide that the product conforms.
Assume SIE.8 has selected a permitted realization and the implementer supplies it. The supplied test evidence must show the requested query, the observation-age and response conditions, and the required negative branches. SIE.9’s receiving view keeps an unknown unit visibly unresolved instead of returning a converted value. SIE.10 checks those behaviors and the semantic premises against the contract. Under matching positive evidence, the result is the qualified row set and the stated unresolved branches, not an engineering release decision.
The complete construction changed two connected operations: it replaced an invalid equality with a warranted relation and required a distinct feature-identity contribution before the join. The realization and receiving tests then exercised that corrected meaning.
Now let the released configuration change to R2. SIE.11 follows the change to the feature identity, plan applicability, selection rule and dependent query evidence. An unchanged unit-conversion rule can retain its qualification. The new configured answer remains unavailable until its affected premises and receiving behavior are supplied; the earlier answer can remain a qualified answer about R.
SIE.13:5.2 - A permitted incomplete provider answer under a shared limit
A purchasing receiver needs attributed availability claims from providers A and B. A means “on hand”; B means “available to promise”. The receiving contract permits an explicitly incomplete answer and does not permit treating the quantities as one interchangeable measure. Assume their required meanings, models and composition rules are already qualified.
Replication is prohibited, so SIE.8 rejects a copied store without building one. Live retrieval and immediate presentation are permitted. For the constructed arrangement, A needs four requests, B needs four, and the source and rule trace needs three. All distinct requests consume one gateway allowance of ten in the same window. The trace is required even for a partial answer; no requests are shared or counted twice; the contract accepts neither a copied cache nor deferral to another window.
The full result needs at least 4 + 4 + 3 = 11 requests before retries. Each pair fits, but the combination does not. The semantic premises can remain correct while this realization fails to supply the complete answer. More correspondence checking cannot remove that resource conflict.
An A-only answer requires 4 + 3 = 7 requests before retries. It is a candidate permitted continuation, not yet a positive use conclusion. The implementation must preserve the required trace and the agreed response, freshness and failure behavior; retries consume the same allowance. The interface must say, for example, A: 12 on hand at T; B: not retrieved under the request limit, with the required attribution and trace. It must not say 21 available, B: 0, or “complete provider comparison”.
If matching implementation and use evidence establishes those remaining obligations, SIE.10 can qualify the A-only branch. The receiver then decides what action an incomplete answer permits. If both providers instead become mandatory, the same seven-request branch no longer answers the contract. Return the stop and the needed change: an access-owner decision altering the allowance, or a demonstrated implementation reduction that preserves the meanings and trace.
If the allowance changes from ten to twelve, the full arrangement becomes possible on the stated minimum request count, but its retry and other service conditions still need comparison. Reuse unchanged semantic premises; reopen the affected realization and receiving-use evidence. These numbers are construction assumptions, not measured provider performance.
SIE.13:5.3 - An unchanged field with a changed meaning
An existing interface has been qualified for a source definition in which provider B’s available field states a present commitment. B later changes its definition to include quantities promised within seven days while leaving the JSON field and numeric type unchanged. A parser test can still pass.
SIE.11 traces the relied-on meaning to the composition, mapping and receiving interpretation. A request about immediate availability can no longer use the old substitution. Obtain a supported present-availability contribution, return an explicitly permitted non-comparable or incomplete branch, or stop that answer. A future-planning receiver may use the changed meaning after its own conditions and interface interpretation are qualified. Source identifiers and unrelated product descriptions need not be reconstructed merely because this claim changed.
The whole Method reconnects the repaired semantic contribution to the receiving use; notification alone leaves that work unfinished. If all that was requested was whether the old present-availability substitution remains valid, the bounded incompatibility result can finish without rebuilding an interface.
SIE.13:6 - Bias-Annotation
A common schema, a merged key, a populated store or a completed query can look like completion while hiding a changed meaning or an unsupported use. Compare the resulting claim with the receiver’s question and include a case that separates the tempting interpretations.
The requested integration can reflect one consumer’s needs while other affected consumers have different conditions. Recover the source and receiving authorities, and keep other consumers’ conditions separate. A contract change can justify a narrower answer only through the applicable agreement; the integrator’s preference for an easier result does not change that agreement.
Retain a dependency or distinction because it changes construction, interpretation, reliance or return after change. Reuse adequate explanations and evidence.
SIE.13:7 - Conformance Checklist
Recognize this problem when the receiver still cannot obtain an answer from otherwise useful local contributions. Check the claimed answer under the conditions of its intended use. A claim about a deployed service or a change in user performance requires evidence of that service or change.
- The receiving continuation and its acceptable answer branches are explicit; an adequate supplied contract is reused.
- Each required answer claim can be followed to its semantic premises and the operations that produce it.
- For each operation, the input results warrant their use in that operation for the subjects and conditions in question. Correspondence, identity and claim composition have distinct roles.
- The next missing result is chosen for its effect on the receiving answer, with an obtainable supplier or an explicit blocker.
- The complete arrangement is compared under relevant shared limits, permissions, trace and failure conditions; local or pairwise feasibility is not substituted for that comparison.
- The supplied interface preserves the qualified meanings, material absence and conflict branches, and the receiver’s required interpretation.
- A positive use claim has evidence for every load-bearing premise and joint condition within its scope. A negative conclusion states the obligation it defeats and the reach left unexamined.
- A partial answer is permitted by the contract and retains its own required premises. A changed premise reopens its dependent contributions and uses while adequate unaffected results remain reusable.
- The result returns to the receiving owner without claiming that semantic integration grants downstream decision authority.
SIE.13:8 - Common Anti-Patterns and How to Avoid Them
| Anti-pattern | Why it changes the result | Repair |
|---|---|---|
| Twelve completed boxes | Independently completed contributions may use incompatible premises, while some boxes may be unnecessary. | Work from the answer’s dependencies and inspect the connections the answer uses. |
| One common field means one common quantity | The carrier hides different source meanings or horizons. | Retain source-qualified meanings and qualify the permitted composition. |
| A design stands in for its supplied result | A decision or specification can exist before the required behavior has been implemented. | Obtain the implementation and matching behavior evidence, or keep that gap explicit. |
| Every pair fits, so the whole fits | Pairs can each fit while the whole exceeds a shared limit or needs conditions that cannot all hold together. | Compare the required contributions together under the same use and resource conditions. |
| Quiet partial success | Omitted sources or provenance make the response look more complete or better supported than it is. | Return only a contract-permitted subset, with its excluded branches and required trace. |
| Start everything again after a change | Unaffected meanings and evidence are discarded while the use that depends on the changed premise may still be overlooked. | Trace changed reliance through SIE.11 and reconnect the affected results. |
SIE.13:9 - Consequences
The practitioner can explain why the available contributions do or do not supply the receiving answer, choose the next useful work and return a supported branch. Source owners and implementers receive a concrete missing result rather than an undifferentiated request to “finish integration”. A later change can return to the contribution that matters.
The cost is maintaining enough dependency and condition information to support those choices. The Method is excessive when a supplied local result already finishes the question. The work grows with the dependencies that can change the receiving result. It supplies a way to construct and qualify an integration; obtaining inaccessible meanings, rights, implementation capability or authoritative decisions remains contingent on their suppliers.
SIE.13:10 - Architectural Rationale
The whole is organized around the receiving claim because that claim determines which distinctions and contributions are necessary. A list of source fields cannot determine permissible loss; a storage choice cannot determine identity; and a passed local test cannot determine whether another result may consume the tested premise.
Working backward exposes required contributions. Working forward checks whether those contributions yield the promised answer. Comparing their connections and shared conditions closes the gap between individual adequacy and whole use. Selecting the next missing result keeps that construction practicable when only part of the answer is unsettled.
The distinct local Methods remain useful: SIE.1 bounds the use; SIE.2–SIE.7 supply semantic and executable premises; SIE.8 chooses realization; SIE.9 supplies the interface; SIE.10 qualifies its use; SIE.11 follows change; SIE.12 helps participants decide who may change or release the shared modules they depend on and how to maintain them. Their actions can constitute parts of this construction when needed. None must be performed anew merely because it has a PatternID.
A linear project plan may organize one implementation, but it cannot replace these dependency and qualification judgements. A small integration can make the same connections through a short contract, qualified mapping and receiving test.
SIE.13:11 - SoTA-Echoing
The selected practice combines the use-led semantic construction developed in SIE.2–SIE.7 with realization, receiver interpretation and affected-use qualification. SIE.3 supplies model reuse or development where a distinction is missing; SIE.13 adds no requirement to develop an ontology or materialize a knowledge graph. The domain sources and their transfer limits remain in those supplying Methods.
One practical alternative is to fix a shared model and source set, complete their mappings and service, then validate the receiving query. This can support reuse across several consumers and provide a workable project plan when the shared meanings, applicability and joint conditions are settled. Compare it with the present construction at the same receiving question and available resources. In §5.1 the model is already adequate, but the correspondence and identity connection is still missing. In §5.2 completing the two-source implementation cannot overcome the ten-request allowance; a permitted partial branch can supply a useful answer. If both sources are mandatory, neither arrangement delivers without another contribution or changed condition.
Adopt sufficient shared models, mappings and implementation plans. Reject making their complete construction a prerequisite for every local answer. When an already qualified service answers the present question under unchanged conditions, reuse it directly. When its meanings, permissions or receiving branches change, obtain and reconnect the affected contribution.
The W3C Data on the Web Best Practices supplies relevant established guidance: choose formalization for the application (BP16), retain provenance (BP5), and communicate interface changes (BP26). Adapt these contributions to the named receiving use. Their publication and interface guidance does not by itself establish cross-source identity, semantic comparability or joint feasibility. The construction in §§4.2–4.7 combines those separately needed judgements.
Compare a graph or copied-store realization with live or hybrid access at the same receiving claim, semantic obligations, trace and service conditions through SIE.8. A store may support repeated queries; a live arrangement may preserve access to rapidly changing source-owned claims or avoid prohibited copying. Reject choosing either by technical preference alone. In §5.2 the permission excludes copying and the joint request demand changes the permitted answer.
The trade-off is explicit connection work where local results do not yet support the receiving answer, in exchange for avoiding both silent composition assumptions and an obligatory full lifecycle. Reopen that choice when an adequate supplied arrangement makes the work redundant, a new dependency defeats the current construction, or actual use shows that its coordination burden exceeds what the receiving question warrants.
SIE.13:12 - Relations
- SIE.Reference:4–6 explains the whole result and combined arrangement; SIE.Reference:13–14 locates its supplying results and local entries.
- SIE.1–SIE.7 supply the contract and semantic contributions under the conditions in §4.2. They remain directly usable for their own questions.
- SIE.8 helps select the realization. Use SIE.9 to supply the receiving interface, obtaining the required implementations from their suppliers.
- SIE.10 supplies bounded use validation. SIE.11 supplies affected-use returns after change; use SIE.12 when participants depend on shared modules and need arrangements for maintaining them.
- FPF C.39 supplies general construction of a way to obtain a result; B.1.5 distinguishes Method composition, and B.1.5.EW distinguishes constituent performance in ongoing work. SIE.13 supplies the semantic-integration content of those connections.
- Systems Engineering, Data Engineering, domain and source owners, and receiving decision owners retain the non-SIE results and authorities identified in SIE.Reference:16.