REST Resource: projects.locations.datasets.hl7V2Stores.messages

Resource: Message

A complete HL7v2 message. See Introduction to HL7 Standards for details on the standard.

JSON representation
{
  "name": string,
  "data": string,
  "createTime": string,
  "sendFacility": string,
  "sendTime": string,
  "messageType": string,
  "patientIds": [
    {
      object(PatientId)
    }
  ],
  "labels": {
    string: string,
    ...
  },
  "parsedData": {
    object(ParsedData)
  },
  "schematizedData": {
    object(SchematizedData)
  }
}
Fields
name

string

Output only. Resource name of the Message, of the form projects/{projectId}/locations/{locationId}/datasets/{datasetId}/hl7V2Stores/{hl7V2StoreId}/messages/{message_id}. Assigned by the server.

data

string (bytes format)

Required. Raw message bytes.

A base64-encoded string.

createTime

string(Timestamp format)

Output only. The datetime when the message was created. Set by the server.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

sendFacility

string

The hospital that this message came from. MSH-4.

sendTime

string(Timestamp format)

The datetime the sending application sent this message. MSH-7.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

messageType

string

The message type for this message. MSH-9.1.

patientIds[]

object(PatientId)

All patient IDs listed in the PID-2, PID-3, and PID-4 segments of this message.

labels

map (key: string, value: string)

User-supplied key-value pairs used to organize HL7v2 stores.

Label keys must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}][\p{Ll}\p{Lo}\p{N}_-]{0,62}

Label values are optional, must be between 1 and 63 characters long, have a UTF-8 encoding of maximum 128 bytes, and must conform to the following PCRE regular expression: [\p{Ll}\p{Lo}\p{N}_-]{0,63}

No more than 64 labels can be associated with a given store.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

parsedData

object(ParsedData)

Output only. The parsed version of the raw message data.

schematizedData

object(SchematizedData)

The parsed version of the raw message data schematized according to this store's schemas and type definitions.

PatientId

A patient identifier and associated type.

JSON representation
{
  "value": string,
  "type": string
}
Fields
value

string

The patient's unique identifier.

type

string

ID type. For example, MRN or NHS.

ParsedData

The content of a HL7v2 message in a structured format.

JSON representation
{
  "segments": [
    {
      object(Segment)
    }
  ]
}
Fields
segments[]

object(Segment)

Segment

A segment in a structured format.

JSON representation
{
  "segmentId": string,
  "setId": string,
  "fields": {
    string: string,
    ...
  }
}
Fields
segmentId

string

A string that indicates the type of segment. For example, EVN or PID.

setId

string

Set ID for segments that can be in a set. This can be empty if it's missing or isn't applicable.

fields

map (key: string, value: string)

A mapping from the positional location to the value. The key string uses zero-based indexes separated by dots to identify Fields, components and sub-components. A bracket notation is also used to identify different instances of a repeated field. Regex for key: (\d+)([\d+])?(.\d+)?(.\d+)?

Examples of (key, value) pairs:

  • (0.1, "hemoglobin") denotes that the first component of Field 0 has the value "hemoglobin".

  • (1.1.2, "CBC") denotes that the second sub-component of the first component of Field 1 has the value "CBC".

  • (1[0].1, "HbA1c") denotes that the first component of the first Instance of Field 1, which is repeated, has the value "HbA1c".

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

SchematizedData

The content of an HL7v2 message in a structured format as specified by a schema.

JSON representation
{

  // Union field result can be only one of the following:
  "data": string,
  "error": string
  // End of list of possible types for union field result.
}
Fields

Union field result.

result can be only one of the following:

data

string

JSON output of the parser.

error

string

The error output of the parser.

Methods

create

Parses and stores an HL7v2 message.

delete

Deletes an HL7v2 message.

get

Gets an HL7v2 message.

ingest

Parses and stores an HL7v2 message.

list

Lists all the messages in the given HL7v2 store with support for filtering.

patch

Update the message.