message.getDICOMUnsignedShorts

Use when: You want to read values from the modified message during mapping. If you need the original incoming message, use source.getDICOMUnsignedShorts.

Signature: message.getDICOMUnsignedShorts(nodePath, instance*)

Returns: String result - the first node that matches the nodePath and instance

Get the result as a \\ delimited string of unsigned shorts of the first node that matches the nodePath.

Note

When the optional instance value is specified, the nodePath should not include an instance identifier.

Parameters

Type	Name	Description	Default
String	nodePath	the DICOM node path
Integer	instance*	(optional) the match instance to return. Use 1 for the first instance.	1

Example

// assumes `message` is a DICOM message model object

// Retrieve a backslash-delimited string of unsigned shorts
// for the specified DICOM tag
var unsignedShortsString = message.getDICOMUnsignedShorts(
    "0010,0010" // Example node path
);

// Optionally retrieve a specific instance
var unsignedShortsStringInstance = message.getDICOMUnsignedShorts(
    "0010,0010",    // node path
    2               // instance (1 = first instance)
);

// Result:
// - unsignedShortsString contains a backslash-delimited string of unsigned shorts
// - unsignedShortsStringInstance contains values for the specified instance