You are here: Section Rules Reference > Section Rules Summary > RemoveWhiteSpace

RemoveWhiteSpace

Use this section level rule to remove the white space from between fields. This rule works similarly to the SetAddr rules, but is not address specific.

Syntax

RemoveWhiteSpace (Field1,Field2,Field3;/NoWarning)

The parameters to this rule should include a list of fields that should exist on the section. Because fields are typically not created when no data maps, you must load the section to make sure the empty fields exist.

Separate the fields in the list with commas. Each subsequent field with data will be mapped into the earliest named prior field that did not contain data.

This rule moves field data from one field to a prior named field to compress out the space between the fields. Typically, you would use this rule to compress the vertical space, as in address lines, but the rule does not really care whether the space is vertical or horizontal.

Unlike the SetAddr type rules, this rule does not actually map the original data. You must use field mapping rules, like Move_It, to do that. Also note that only the data moves between the fields. The location of each physical field remains the same.

Also, unlike the SetAddr rules, you do not have to compress the space up. If you specify the fields in the reverse vertical order, you can compress the space down.

Using the NoWarning parameter

If the system cannot locate the field, you get a warning. If you include the NoWarning parameter, however, you can suppress the warning. Add this parameter after the last field in the list. Use a forward slash (/) to separate it from the previous parameter and end it with a semicolon (;). This parameter is optional. Here is an example:

RemoveWhiteSpace PAGE1_FIELD1,PAGE1_FIELD2,PAGE1_FIELD3, PAGE1_FIELD4/NoWarning

The warning message includes addition information to help you resolve the problem:

DM10190: Warning in <REMOVEWHITESPACE>: Unable to locate field <FieldName> in image <ImageName>.

This rule does not work with bar code fields or multiline text fields.

If the system cannot locate the listed field and the section is a multipage section and you omitted the NoWarning parameter, you get message DM10189. If you included the NoWarning parameter, you get message DM10190. Here are some examples:

DM10189: Warning in <REMOVEWHITESPACE>: Unable to locate field <FieldName> on page <PageNo> of a multi-page image <ImageName>.

DM10190: Warning in <REMOVEWHITESPACE>: Unable to locate field <FieldName> in image <ImageName>.

Note

Naming the same field to move more than once in the parameters may cause unreliable results. The final location of a field's data is determined by the last movement of that field.
This rule does not work with bar code type fields or multiline text fields.