A field's position may be defined relative to the top left of the page (see To define a field, below) or in relation to another field - known as a "tag" - instead (see To set up tags, below).
Alternatively, it is possible to set up a field definition manually by selecting New... from the 'Fields' menu and keying in the details on the Definitions page of the 'Field' dialog. It is also possible to convert the field into a tag by filling in the Searching page of the 'Field' dialog as well: see Setting search tag options.
The field name definitions are saved in a file with extension .EE and the same stem name as the input file. You can rename this file in the File page: see Reusing data fields.
| 1. | Click and drag over a piece of text on one of the pages to mark it out. |
| 2. | Right-click and select New Field.... to show the 'Definitions' page of the 'Field' window. |
| 3. | The field information pane displays the coordinates and dimensions of the selected area on the page. To adjust these, type over the coordinates or drag the area on the page with the mouse when you have returned to the page - see Editing fields and tags. |
| 4. | Use the default Field name (FIELD1, FIELD2, etc.)
or type in a new name
or click DICOM name... and set up a DICOM tag - see DICOM Element Tags.
The field names are listed either on the right of the field information pane or below it. If the Tree option is selected, this list shows the hierarchy of fields and their related tags, otherwise it is an alphabetical list of fields: see Fields list/tree. |
| 5. | If you are a specialist outputting to XML you may select a field TYPE from the drop-down list. Otherwise, select Any content for the field "type". EscapeE is often able to detect when field values do not correspond to the selected type: if this happens the caption "Type" will be shown in red and an 'invalid data' warning given. |
| 6. | To make a field relative to a tag, select the appropriate field from the Reference Field drop down list.
Alternatively, you can drag the field name in the 'tree view' and place it under the name of its parent field. |
| 8. | The field is enabled by default, but you may "switch off" the field by de-selecting the Enabled checkbox: see To disable a field or tag. |
|
You may also use EscapeE to define composite fields: these can comprise a combination of the value of other fields, simple text or access pre-defined special fields.
A composite field is treated just like any other field, so may be included in a CSV or XML file or used as a file name. It can be manipulated by a plugin such as Barcode or displayed using AddText by leaving the added text field blank.
| 1. | Right-click on the piece of text or graphic or sweep out an area of a graphic to select just part of it. |
| 2. | Select New Tag... then choose from the following sub-options: |
| o | This graphic To search for this particular graphic (not applicable to lines or shades). |
| o | This size graphic To find a graphic, line or shade with matching width and height. |
| o | Any graphic To search for any kind of graphic, line or shade in this area. |
| o | This text The text under the mouse. |
| o | Any text Any text in the area of the field. |
| 3. | The Definitions page of the 'Field' dialog is displayed, showing details of the new tag. Use the default name (TAG1, TAG2, etc.) or type in a new name for the tag in the Field box. See also Editing fields and tags. |
| 5. | Click the OK when you have finished. |
|
Tips
| • | Click the 'back' and 'forward' buttons at the foot of the dialog to show the previous page and next page of the document. Click the left, up, down or right buttons in the  arrow set to scroll the page - without closing the dialog. |
| • | Fields can be reordered by dragging the names in the 'tree view' window, see Fields list/tree. |
Links
About fields and tags
About extracting data
Editing fields and tags
