Harmonization: Add ManifestItem class to Transmission

Editing of harmonisation proposals prior to a harmonization meeting is restricted to the proposal submitter and the co-chairs of the steward comittee. Other changes will be undone. Please add comments to the "discussion" page associated with this proposal.

Recommendation for HL7 RIM Change	RECOMMENDATION ID:
Submitted by: INM	Revision (# and date): 20060509
Date submitted:	Committee status: Approved - 20060509
Submitted by: Rene Spronk
NAME: Add ManifestItem class to Batch

Stewards Position

REQUIRED - This table should contain one row for each Steward Committee affected by the recommendation.

TC	RECOMMENDATION APPROVAL STATUS	AFFECTED ENTITIES OF INTEREST TO TC (responsibility level: S=Steward; I=Interested)
INM	Under review	S

Issue

The English NHS has defined a requirement to add a ManifestItem class for each payload contained in a Transmission: a structure for carrying a set of values relating to a specific payload item (Message, or controlAct, or domain payload). Typically this class will be repeated for each payload instance in the batch.

Example values conveyed in the ManifestItem class: Artefact Id (e.g. Message.interactionId, controlAct.id), Patient Id.

The ManifestItem class allows the receiver of a batch to quickly filter the batch to find any content that is of interest.

Recommendation(s)

• Add a new (blue) RIM class ManifestItem, with the following description: "Identifies the payload item contained within the Transmission to which the Manifest applies. A Transmission may contain a ManifestItem class for a subset of payload items, or none at all. The usage of the ManifestItem class is subject to site specific agreement."
• Add a new (blue) RIM class ManifestValue, with the the following description: "Contains information about the payload item identified by the ManifestItem class. The contents of the ManifestValue classes shall be used for the purpose of filtering the contents of the batch for reasons of efficient processing of batch contents and not have any impact on the semantic interpretation of the contents of the Transmission. The usage of the ManifestValue class is subject to site specific agreement."
• create a 1..* association between ManifestItem and ManifestValue.
• create a 0..1 association between Batch and ManifestItem.

• Add the following attributes to the ManifestItem class:
  • payloadId II [1..1] (mandatory attribute) - Description: "The identification of the Batch payload item being described by this ManifestItem, e.g. Message.id or Batch.id"
  • payloadSequenceNumber INT [0..1] - Description: "The position/index of payload item (e.g. Message) being described by this ManifestItem within the Batch. Within a Batch Transmission the first payload item shall have an index equal to 1."

• Add the following attributes to the ManifestValue class:
  • manifestItemKey CV CWE [0..1] <=ManifestItemType - Description: "manifestItemKey and manifestItemValue are used to convey charateristics of the payload item identified by payloadId (and payloadSequenceNumber). Examples of manifestItemKey include patientID, or interactionID."
  • manifestItemValue attribute ANY [0..1] - Description: "manifestItemKey and manifestItemValue are used to convey characteristics of the payload item identified by payloadId (and payloadSequenceNumber). If the manifestItemValue attribute has a value the manifestItemKey attribute must also have a value."
    • The value is meant to be machine processable. The data type of the attribute will be constrained to one of the following data types: BL, CV, II, URL, INT, REAL, TS, PQ, MO, IVL<PQ>, IVL<TS>.

• Create a new ManifestItemType vocabulary domain (Description: Identifies the type of characteristic conveyed in the Manifest of a Batch) with the following predefined concepts:
  • (mnemonic) IID (description) InteractionID of the payload item
  • (mnemonic) PID (description) Id of the Patient role that partcipates in the payload item

Rationale

1. The current RIM classes don't support sending this information.
2. The AttentionLine class (see related Harmonization proposal entitled Harmonization: Description of AttentionLine contains information that applies to a Batch as a whole, whereas a ManifestItem contains information about one of the payload items contained in the Transmission (Batch).

Recommended Action Items

• Implement the proposed solution

Resolution

20060718 Harmonization meeting:

Lloyd thinks it could be done by having attentionLines at message level. Diferences with attentionLine.

Charlie: add key value examples.