org.hl7.rim

Interface ManufacturedMaterial

public interface ManufacturedMaterial extends RimObject, Material

Interface for RIM class ManufacturedMaterial.

A subtype of Material representing an Entity or combination of Entities transformed for a particular purpose by a non-natural or manufacturing process.

Examples: Processed food products, disposable syringes, chemistry analyzer, saline for infusion, etc.

Discussion: This class encompasses containers, devices, software modules and facilities.

Rationale: This class is used to further define the characteristics of Entities that are created out of other Entities. These entities are identified and tracked through associations and mechanisms unique to the class, such as lotName, stabilityTime and expirationTime.

Method Summary
IVL<TS>getExpirationTime()
Gets attribute expirationTime of type IVL and cardinality 0..1.
STgetLotNumberText()
Gets attribute lotNumberText of type ST and cardinality 0..1.
IVL<TS>getStabilityTime()
Gets attribute stabilityTime of type IVL and cardinality 0..1.
voidsetExpirationTime(IVL<TS> value)
Sets attribute expirationTime of type IVL and cardinality 0..1.
voidsetLotNumberText(ST value)
Sets attribute lotNumberText of type ST and cardinality 0..1.
voidsetStabilityTime(IVL<TS> value)
Sets attribute stabilityTime of type IVL and cardinality 0..1.

Method Detail

getExpirationTime

public IVL<TS> getExpirationTime()
Gets attribute expirationTime of type IVL and cardinality 0..1.

The date and time the manufacturer no longer ensures the safety, quality, and/or proper functioning of the material.

Rationale: There is a need in many situations that the materials used are of a specific quality or potency or functional status. The ending date for this guarantee is specified by the manufacturer. After that date, while the material may still provide the same characteristics, the manufacturer no longer takes responsibility that the product will perform as specified and denies responsibility for failure of the material after that date.

Returns: the attribute value

getLotNumberText

public ST getLotNumberText()
Gets attribute lotNumberText of type ST and cardinality 0..1.

An alphanumeric string used to identify a particular batch of manufactured material.

Discussion: The lot name is usually printed on the label attached to the container holding the substance and/or on the packaging which houses the container. Note that a lot number is not meant to be a unique identifier, but is meaningful only when the product kind and manufacturer are also identified.

Returns: the attribute value

getStabilityTime

public IVL<TS> getStabilityTime()
Gets attribute stabilityTime of type IVL and cardinality 0..1.

The time at which the material is considered useable after it is activated.

Examples: After opening a bottle of a liquid. The mixing of two chemicals for an analysis that must be mixed and used within two hours or their activity diminishes.

Discussion: If a kind of material is described (determinerCode = KIND) only the width of that interval can be known, i.e., the duration after opening the reagent container at which the reagent substance is considered useable for its normal testing purpose. For an actual instance of the reagent (e.g., a specific bottle), the stabilityTime.low TS marks the time at which the reagent bottle has been opened (or the reagent was otherwise activated). Together with the typical stability duration, this determines the stabilityTime.high TS beyond which the reagent is no longer considered useable for its normal testing purpose.

Returns: the attribute value

setExpirationTime

public void setExpirationTime(IVL<TS> value)
Sets attribute expirationTime of type IVL and cardinality 0..1.

The date and time the manufacturer no longer ensures the safety, quality, and/or proper functioning of the material.

Rationale: There is a need in many situations that the materials used are of a specific quality or potency or functional status. The ending date for this guarantee is specified by the manufacturer. After that date, while the material may still provide the same characteristics, the manufacturer no longer takes responsibility that the product will perform as specified and denies responsibility for failure of the material after that date.

Parameters: value the new attribute value

setLotNumberText

public void setLotNumberText(ST value)
Sets attribute lotNumberText of type ST and cardinality 0..1.

An alphanumeric string used to identify a particular batch of manufactured material.

Discussion: The lot name is usually printed on the label attached to the container holding the substance and/or on the packaging which houses the container. Note that a lot number is not meant to be a unique identifier, but is meaningful only when the product kind and manufacturer are also identified.

Parameters: value the new attribute value

setStabilityTime

public void setStabilityTime(IVL<TS> value)
Sets attribute stabilityTime of type IVL and cardinality 0..1.

The time at which the material is considered useable after it is activated.

Examples: After opening a bottle of a liquid. The mixing of two chemicals for an analysis that must be mixed and used within two hours or their activity diminishes.

Discussion: If a kind of material is described (determinerCode = KIND) only the width of that interval can be known, i.e., the duration after opening the reagent container at which the reagent substance is considered useable for its normal testing purpose. For an actual instance of the reagent (e.g., a specific bottle), the stabilityTime.low TS marks the time at which the reagent bottle has been opened (or the reagent was otherwise activated). Together with the typical stability duration, this determines the stabilityTime.high TS beyond which the reagent is no longer considered useable for its normal testing purpose.

Parameters: value the new attribute value