User Tools

Site Tools


pub:condtext

Differences

This shows you the differences between two versions of the page.


Previous revision
pub:condtext [2022/09/13 14:44] (current) – [Conditional Text and Overlays] kkramer
Line 1: Line 1:
 +<html>&#091;</html>[[start | Up To Index ]]<html>&#093;</html>
  
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +
 +====== Conditional Text and Overlays ======
 +
 +Selecting the form or check application with option 11=Conditional displays the following screen:
 +  
 +<html><pre>
 +  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                                                               
 +                                                                                
 +</pre></html>
 +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. 
 +
 +<html><pre>
 +  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:    To Column:     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                                           
 +                                                                                
 +</pre></html>
 +
 +  * **Text Block Name**: Enter a name for the block. Do not use embedded blanks. Enter also a description, which may contain embedded blanks.
 +<html><br/></html>
 +  * **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.       
 +<html><br/></html>
 +  * **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.
 +<html><br/></html>
 +  * **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.  
 +<html><br/></html>
 +  * **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.           
 +<html><br/></html>
 +  * **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.            
 +<html><br/></html>
 +  * **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.
 +<html><br/></html>
 +  * **F10=Update**: Save the new or changed block by pressing F10.
 +<html><br/></html>
 +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…
 +<html>
 + <ul>
 +  <li style="color:Black" > The condition is triggered true when the value of BILL appears on the spool file Row 13 between Column 2 and 5. </li>
 +  <li style="color:Black" > The configured text –What a wonderful place. in the Static Text Information field will be used as the text to be appended. </li>
 +  <li style="color:Black" > The Mapped Field BLOCK001 in the Appending text to Map Field will be the Mapped Field used to append the text. </li>
 + <li style="color:Black" > The Remove trailing space (Y/N) parameter will toggle the option to:</li> 
 +    <ul>
 +      <li style="color:Black" >  Y = Trim the blank spaces within the Mapped Field to append the text immediately after the last character as shown in Example 1 below.</li> 
 +      <li style="color:Black" >  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.</li>
 +     </ul>  
 + </ul> 
 +</html>
 +**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|}}
 +----
 +
 +<html>&#091;</html>[[start | Up To Index ]]<html>&#093;</html>