[[[start | Up To Index ]]] ====== Conditional Text and Overlays ====== Selecting the form or check application with option 11=Conditional displays the following screen:

  9/13/22                     iDocs Form Suite                        FM0466C1  
 12:26:29              Conditional Text and Overlays                  KKRAMER   
                                                                                
  Form: MACMCOND02 Conditional POC                                              
                                                                                
  Type option, press Enter.                                                     
   1=Select   4=Delete                                                          
                                                                                
              Sel  Block Name   Description                                     
                   COND01       Condition 01                                    
                   COND02       Condition 02                                    
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                         Bottom 
 F3=Exit   F6=Add

Use F6 to add conditions or option 1 to edit an existing condition. You may specify up to 9,999 blocks of text or macros that are included in the output stream. Optionally, you may specify conditions in the input spool text that if true enable the output.

  9/13/22                     iDocs Form Suite                        FM0466S2  
 12:33:21              Conditional Text and Overlays                  KKRAMER   
                                                                                
 Form: MACMCOND02         Text Block Name: COND01      Condition 01             
 Conditions                                                                     
               Row:  13   From Column:   2  To Column:   5   OP: =  BILL        
 Macro Name . :           F4=List      Font:   F4=List Arial 9pt Regular        
 Macro  Xloc. :                        Text Xloc:       Yloc:       RelY:       
 Form Side. . : *NONE  F4=List         Appending text to Map Field: BLOCK001    
                                       Remove trailing space (Y/N): Y           
                                  Static Text Information                       
 -What a wonderful place.                                                       
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
                                                                                
  F3=Exit   F10=Update   F12=Previous

* **Text Block Name**: Enter a name for the block. Do not use embedded blanks. Enter also a description, which may contain embedded blanks.
* **Conditions Row**: Row in the input spool file to test for the conditional value. You need not specify a test, in which case the text or macro will be included in the output stream for each page. * **From Column**: Starting column in the input spool file to look for text to test. * **To Column**: Ending column in the input spool file. * **OP**: Text to test for in the input spool file. This can include blanks. So for example to test row 1, columns 1 through 5 for blanks is a valid test.
* **Macro Name**: If you prompt and specify a macro name, this macro will be included if the conditional test is true or there is no conditional test. * **Font**: Select a font by prompting with a ?. This font is used for any specified text. If you do not specify a font any text in this block uses the default font.
* **Macro Name**: If you prompt and specify a macro name, this macro will be included if the conditional test is true or there is no conditional test. * **Macro Xloc**: Starting X value of the pcl cursor, 300 pixels / inch, before the macro is started. * **Macro Yloc**: Starting Y value of the pcl cursor, 300 pixels / inch, before the macro is started. * **Text Xloc**: X location in pixels, 300 pixels / inch, of the starting position of the pcl cursor before the text is included. * **Text Yloc**: Y location in pixels, 300 pixels / inch, of the starting position of the pcl cursor. * **RelY**: For text with more than 1 line, number of pixels, 300 pixels / inch, to advance the Y value of the pcl cursor when starting a new text line. 50 is a frequently used value.
* **Form Side**: *NONE Non Duplex field; *FRONT Front side duplex; *BACK Back side duplex. * **Appending text to Map Field:**: Spool file Map field to be appended.
* **Remove trailing space (Y/N)**: Y = Trim the blank spaces within the Mapped Field to append the text immediately after the last character. N = Does not trim the blank spaces within the Mapped Field. The text will be appended at the end of the Mapped Field spacing.
* **Static Text Information**: Type any text to be include at the above specified location in the above specified font if the above specified test is true.
* **F10=Update**: Save the new or changed block by pressing F10.
New Functionality within Conditional Text and Overlay option 11 added V6.99 (08/23/22) to dynamically append constant text to the end of a mapped field. Trigger a condition to insert constant text at the end of a Mapped Field with the options to insert the configured text at the end of the Mapped Field or at the end of the last character of the Mapped Field. Option 11 Fields and Parameters to Append Text to a Mapped Field: In the example below…

The condition is triggered true when the value of BILL appears on the spool file Row 13 between Column 2 and 5.
The configured text –What a wonderful place. in the Static Text Information field will be used as the text to be appended.
The Mapped Field BLOCK001 in the Appending text to Map Field will be the Mapped Field used to append the text.
The Remove trailing space (Y/N) parameter will toggle the option to:

Y = Trim the blank spaces within the Mapped Field to append the text immediately after the last character as shown in Example 1 below.
N = Does not trim the blank spaces within the Mapped Field. The text will be appended at the end of the Mapped Field spacing as shown in Example 2 below.

**Examples:** Insert text at the end of the Mapped Field:\\ {{:pub:idocs:thumbnail_image_2.png?direct&600|}} Insert text at the end of the last character of the Mapped Field:\\ {{:pub:idocs:thumbnail_image_1.png?direct&600|}} ---- [[[start | Up To Index ]]]