public:99_annexes:annex-b-terms-and-definitions:c:catalog_entry

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
public:99_annexes:annex-b-terms-and-definitions:c:catalog_entry [2026/09/12 17:42] – removed - external edit (Unknown date) 127.0.0.1public:99_annexes:annex-b-terms-and-definitions:c:catalog_entry [2026/09/12 17:43] (current) – ↷ Links adapted because of a move operation nick_dido
Line 1: Line 1:
 +====== Catalog Entry ======
  
 +[[public:99_annexes:annex-b-terms-and-definitions:start|Go up to Terms and Definitions]]
 +
 +===== Discussion =====
 +
 +A Catalog Entry is a managed description of and reference to one identified subject or a defined grouping of subjects within a [[public:99_annexes:annex-b-terms-and-definitions:c:catalog|Catalog]].
 +
 +A Catalog Entry can describe and reference:
 +
 +  * An [[public:99_annexes:annex-b-terms-and-definitions:o:organization|Organization]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:c:community_of_interest|Community of Interest]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:u:user|User]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:r:role|Role]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:n:node|Node]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:n:node_set|Node Set]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:d:deployment_target|Deployment Target]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:t:test_definition|Test Definition]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environment]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:t:test_result|Test Result]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:b:baseline|Baseline]]
 +  * An [[public:99_annexes:annex-b-terms-and-definitions:a:artifact|Artifact]]
 +  * An [[public:99_annexes:annex-b-terms-and-definitions:e:executable_artifact|Executable Artifact]]
 +  * A [[public:99_annexes:annex-b-terms-and-definitions:r:resource|Resource]]
 +  * An [[public:99_annexes:annex-b-terms-and-definitions:o:operational_resource|Operational Resource]]
 +  * Another identified subject
 +
 +A Catalog Entry can identify:
 +
 +  * Its identity
 +  * Its name
 +  * Its description
 +  * Its entry type
 +  * Its [[public:99_annexes:annex-b-terms-and-definitions:v:version|Version]]
 +  * The identity of the described subject
 +  * The type of the described subject
 +  * The applicable Version of the described subject
 +  * The location of the described subject
 +  * The owner of the described subject
 +  * The provider of the described subject
 +  * The status of the described subject
 +  * The availability of the described subject
 +  * The capabilities provided by the described subject
 +  * The requirements associated with the described subject
 +  * The dependencies of the described subject
 +  * The relationships of the described subject
 +  * The applicable classifications
 +  * The applicable search terms
 +  * The applicable access constraints
 +  * The applicable [[public:99_annexes:annex-b-terms-and-definitions:p:policy|Policies]]
 +  * The applicable [[public:99_annexes:annex-b-terms-and-definitions:g:governance_policy|Governance Policies]]
 +  * The applicable content digest
 +  * Its [[public:99_annexes:annex-b-terms-and-definitions:p:provenance|Provenance]]
 +  * Its [[public:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]]
 +
 +A Catalog Entry can contain descriptive information directly or reference descriptive information maintained by another system.
 +
 +A Catalog Entry can reference a subject stored in a [[public:99_annexes:annex-b-terms-and-definitions:r:repository|Repository]] without copying the subject into the Catalog.
 +
 +===== Definition =====
 +
 +//managed description of and reference to one identified subject or a defined grouping of subjects within a [[public:99_annexes:annex-b-terms-and-definitions:c:catalog|Catalog]]//
 +
 +===== Source =====
 +
 +Adapted from:
 +
 +  * [[public:99_annexes:annex-b-terms-and-definitions:c:catalog|Catalog]]
 +  * DIDO Reference Architecture
 +  * DIDO Reference Implementation Conceptual Model
 +  * DIDO-TE draft Requirements Register
 +
 +This definition establishes Catalog Entry as the unit of managed descriptive and discovery information contained within a Catalog.
 +
 +===== Note =====
 +
 +Use the singular glossary term Catalog Entry. Link plural usage to the same controlling page:
 +
 +<code dokuwiki>
 +[[dido:99_annexes:annex-b-terms-and-definitions:c:catalog_entry|Catalog Entries]]
 +</code>
 +
 +A Catalog Entry differs from a [[public:99_annexes:annex-b-terms-and-definitions:c:catalog|Catalog]]:
 +
 +  * A Catalog is the managed collection
 +  * A Catalog Entry describes and references one identified subject or a defined grouping of subjects
 +
 +A Catalog Entry differs from the subject it describes:
 +
 +  * A Catalog Entry contains descriptive and discovery information
 +  * The described subject is the entity, Artifact, Resource, or other item to which the entry refers
 +
 +Creating, changing, or removing a Catalog Entry does not necessarily create, change, or remove the described subject.
 +
 +Changing the described subject does not automatically update the Catalog Entry. The applicable Catalog-management process must maintain consistency between the Catalog Entry and the described subject.
 +
 +A Catalog Entry differs from an Artifact stored in a [[public:99_annexes:annex-b-terms-and-definitions:r:repository|Repository]]:
 +
 +  * A Catalog Entry describes and references the Artifact
 +  * A Repository stores and manages the Artifact
 +
 +A Catalog Entry can itself be represented as a [[public:99_annexes:annex-b-terms-and-definitions:d:data_object|Data Object]] or Artifact. That representation remains distinct from the subject described by the Catalog Entry.
 +
 +A Catalog Entry differs from a registry entry:
 +
 +  * A Catalog Entry supports description and discovery
 +  * A registry entry records a subject under an identified registration authority and registration process
 +
 +The same entry can satisfy both definitions when the Catalog also acts as a Registry.
 +
 +One subject can have multiple Catalog Entries when:
 +
 +  * Different Catalogs describe the subject
 +  * Different Communities of Interest apply different descriptions
 +  * Different Governance Domains apply different classifications
 +  * Different Versions require separate entries
 +  * Different access scopes expose different information
 +
 +Multiple Catalog Entries that describe the same subject should preserve a common subject identity or another explicit relationship.
 +
 +A Catalog Entry does not necessarily establish:
 +
 +  * Ownership
 +  * Approval
 +  * Availability
 +  * Authenticity
 +  * Authority
 +  * Conformance
 +  * Deployment
 +  * Endorsement
 +  * Registration
 +  * Validation
 +
 +The Catalog Entry must state these characteristics explicitly when they apply.
 +
 +A Catalog Entry should identify the exact Version of the described subject when the subject has multiple Versions.
 +
 +A Catalog Entry should preserve Traceability among:
 +
 +  * The Catalog
 +  * The Catalog Entry
 +  * The described subject
 +  * The applicable Version
 +  * The source of the descriptive information
 +  * The governing Authority
 +  * The applicable Policies
 +  * The applicable Provenance
 +
 +===== Example =====
 +
 +A DIDO-TE Test Definition Catalog contains a Catalog Entry for a Test Definition that evaluates distributed transaction consistency.
 +
 +The Catalog Entry identifies:
 +
 +  * The Test Definition identity
 +  * The Test Definition Version
 +  * The test purpose
 +  * The applicable Test Items
 +  * The applicable Test Environment requirements
 +  * The applicable Validation Criteria
 +  * The approving [[public:99_annexes:annex-b-terms-and-definitions:a:authority|Authority]]
 +  * The approval status
 +  * The applicable Governance Policies
 +  * The Repository location
 +  * The content digest
 +  * The applicable Provenance
 +  * The applicable Traceability
 +
 +A User discovers the Test Definition through the Catalog Entry. The User retrieves the referenced Test Definition from the Artifact Repository.
 +
 +The Catalog Entry describes and locates the Test Definition but remains distinct from the Test Definition itself.
 +
 +----
 +
 +<WRAP centeralign>
 +© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.
 +</WRAP>