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
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.
Parameters
unsigned—The least significant four hexadecimal digits of the integer correspond to the Element Number of the DICOM Data Element Tag, and the remaining hexadecimal digits correspond to the Group Number of the DICOM Data Element Tag.
Remarks
Typically the hex() function is used as the input parameter to getdicomstring() to provide the required unsigned integer value.
![]() | 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: 1048608 is the decimal equivalent of 0x100020. |
See also
Adding text to construct an identifier
Customizing mammography hanging_protocol mappings
List of field mapping attributes
Parsing out multiple values stored in one element without separators
Topic number: 9032 Applies to: IMPAX 6.5.1 Server Knowledge Base |