IMPAX 6.5.1 Server Knowledge Base home > Configuring IMPAX Server with Administration Tools > Source Manager > Customizing field mappings to extract information from images > List of field mapping grammar functions

getdicomstring


This function takes as input an unsigned integer or the hexadecimal string representation of an unsigned integer that corresponds to the DICOM element to be extracted from the Image IOD header. This function returns the contents of the extracted DICOM Data Element as a string.

Syntax

getdicomstring (unsigned)

Parameters

Remarks

Typically the hex() function is used as the input parameter to getdicomstring() to provide the required unsigned integer value.

Tip

Tip:

The hexadecimal input values do not have quotation marks (because they are being treated as integers) while the inputs to the hex() function are delimited by single quotation marks (because they are strings).

To find the DICOM element tag values, refer to the DICOM standard (available from the http://dicom.nema.org/ website) or the values in the DICOM Fields table in the Demographic Layout dialog (accessible through Source Manager, Other tab, Demographic Layout Manager button).

Example

These four getdicomstring() expressions extract the patient ID element, which has a DICOM Data Element Tag value of (0010,0020).

Expression
getdicomstring( 0x00100020 )
getdicomstring( 0x100020 )
getdicomstring( hex( '0x00100020') )
getdicomstring( hex( '1048608' ) )
Note:

Note:

1048608 is the decimal equivalent of 0x100020.


See also


Topic number: 9032

Applies to: IMPAX 6.5.1 Server Knowledge Base