inFORM Decisions Information Portal

User Tools

Site Tools

Trace:
pub:preprocessor

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
pub:preprocessor [2018/09/25 13:43] – [Conditions] kkramerpub:preprocessor [2021/05/04 11:55] – [Insert Text] kkramer
Line 237: Line 237:
  
 ==== Conditions ==== ==== Conditions ====
-Conditions are entered via option 6, and are attached to applications and/or targets. +Conditions are entered via **option 6**, and are attached to applications and/or targets. 
  
   * When attached to the **application**, the conditions are evaluated once at the beginning of the processing of a spool file. If the tests fail, the application and all its targets are not considered further for the spool file.   * When attached to the **application**, the conditions are evaluated once at the beginning of the processing of a spool file. If the tests fail, the application and all its targets are not considered further for the spool file.
Line 361: Line 361:
                                                                                                                                                                  
 </pre></html> </pre></html>
-Value:                                                      + 
 +Enter a Value i.e.:                                                      
  
   Webmaster@INFORMDECISIONS.COM                                    Webmaster@INFORMDECISIONS.COM                                 
Line 369: Line 370:
 Then we can use field EMAILADD to replace long name ‘Webmaster@INFORMDECISIONS’ Then we can use field EMAILADD to replace long name ‘Webmaster@INFORMDECISIONS’
 The Smart Router will check test value as conditional list, if found will replace test value by values which we have defined. The Smart Router will check test value as conditional list, if found will replace test value by values which we have defined.
-                                                       PR0035W3 + 
-<html><pre>+**Tests and Keyword descriptions:** 
 +<html><pre>                                                       
                                                                                                                                                                  
   Line      and  Attribute or           Attribute or                               Line      and  Attribute or           Attribute or                            
Line 381: Line 383:
                                                                                                                                                                  
 </pre></html> </pre></html>
-**General definitions:** 
  
   * **And/Or**:  As implied.   * **And/Or**:  As implied.
Line 400: Line 401:
  
 ^ Comparand keyword ^ Meaning ^ ^ Comparand keyword ^ Meaning ^
-| ***USRPRF**  | User profile owning the spool file | +| ***BLANKS**  | The compared field is blank |  
 +| ***USRPRF**  | User profile owning the spool file |
 | ***USRDTA** | Spool file user data |  | ***USRDTA** | Spool file user data | 
 | ***OUTQUE** | Spool file outqueue |  | ***OUTQUE** | Spool file outqueue | 
Line 408: Line 410:
 | ***JOBNAME** | Spool file job name |  | ***JOBNAME** | Spool file job name | 
 | ***TOTALPG** | Spool file total pages |  | ***TOTALPG** | Spool file total pages | 
 +
 +1. The processing priority:
 +
 +  * Map fields (with prefix ‘&’)
 +  * Attributes of spool file (with prefix ‘*’) attributes:
 + *SPLFILE
 + *USRPRF
 + *JOBNAME
 + *USRDTA
 + *FORM
 + *PGM
 + *TOTALPG
 + *OUTQUE
 + *OUTLIB
 +  * Name object: The first ten characters will be look up in list name objects
 +  * Constant value       
 +
 +2. Program will deal values above for both 2 fields: ‘Field’ and ‘Test value’. For example, we can define as below:
 +<html><pre> 
 +Field . . : ORLANDO@INFORMDECISIONS.COM                                
 +
 +Test  . . : *EQ *EQ, *LT, *LE, *GT, *GE, *NE, *IN          
 +
 +                                                            
 +
 +Test value (&MapField, *Attribute,Value, Value1 Value2..)  
 +
 +&EMAIL                                         
 +</pre></html>
 +
 +3. Regarding test values: ‘Value, Value1 Value2…’ the program compare values as Constants
 +<html><pre>                                                 
 +
 +                 Maintain Conditional List      
 +
 +                                                 
 +
 +  Name: ODD1-5     Description: Odd Pages 1 - 5 
 +
 +                                                 
 +
 +  Value:                                        
 +
 +  1 3 5       
 + 
 +
 +                  Testing Values                        
 +
 +Field . . : &EMAIL                                      
 +
 +Test  . . : *EQ *EQ, *LT, *LE, *GT, *GE, *NE, *IN       
 +
 +                                                         
 +
 +Test value (&MapField, *Attribute,Value, Value1 Value2..)
 +
 +ODD1-5                                                  
 +</pre></html>
 + 
 +
 +It similar to this case below:
 +<html><pre> 
 +                  Testing Values                        
 +
 +                                                         
 +
 +Field . . : &EMAIL                                      
 +
 +Test  . . : *EQ *EQ, *LT, *LE, *GT, *GE, *NE, *IN       
 +
 +                                                         
 +
 +Test value (&MapField, *Attribute,Value, Value1 Value2..)
 +
 +1 3 5                      
 +</pre></html>
 +
 +==== Insert Text ====
 +Spool file text is entered via **option 8**. 
 +
 +<html><pre>
 +                               iDocs SmartRouter                      PR0032R1  
 +                          Insert Text into Spool File                 KKRAMER   
 +                                                                                
 +  SR Engine Name/Desc. : EARNINGS1  Example Earning No.1                          
 +  Application Name/Desc: EARNSRENG  Earning SR Engine                           
 +  Form App Reference . : EARNADD    Used for Emp.number add                     
 +  Target Name/Desc . . : HANDOFF    To Handdoff OutQ                            
 +                                                                                
 +  Source Spool Text:                                                            
 +   Map Field : EMPLOYNO1  Or Constant                                           
 +   From Page :            Output Text To: Row   1 Column  50 Page:              
 +   Map Field : EMPLOYNO2  Or Constant                                           
 +   From Page :            Output Text To: Row   1 Column  50 Page:              
 +   Map Field :            Or Constant                                           
 +   From Page :            Output Text To: Row     Column     Page:              
 +   Map Field :            Or Constant                                           
 +   From Page :            Output Text To: Row     Column     Page:              
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 +                                                                                
 + F3=Exit  F2=Conditionally Map F4=Prompt F5=Refresh  F12=Cancel F14=Remove Text
 +                                                                                
 +</pre></html>
 +
 +== F2=Conditionally Map ==
 +
 +**On iDocs 6.96 and older...**
 +Under the Insert Text function of a Smart Router Application, Conditions were universally applicable to all Mapped Fields listed under the Source Spool Text parameters.
 +
 +**On IDocs 6.97 and newer...**
 +Under the Insert Text function of a Smart Router Application, Conditions are now independently applicable to each of the Mapped Fields listed under the Source Spool Text parameters.\\
 +When you put the cursor on each of the Mapped Fields and select the **F2=Conditionally Map option**, you will see a window to apply your condition to the specific Mapped Field.
 +For example, for Mapped Field MAPONE, we can have a condition in which the Mapped Field is not equal (*NE) to - - - 
 + - - - (five dashes) \\
 +
 +F2=Conditionally Map option on Mapped Field MAPONE displays the screen below:
 +<html><pre>
 +                               iDocs SmartRouter                      PR0032R1  
 +                          Insert Text into Spool File                 KKRAMER   
 +                                                                                
 +  SR Engine Name/Desc. : EARNINGS1  Example Earning No.1                          
 +  Application Name/Desc: EARNSRENG  Earning SR Engine                           
 +  Form App Reference . : EARNADD    Used for Emp.number add                     
 +............................................................................... 
 +:  Conditionally Map Field:    &EMPLOYNO1                                     : 
 +:                                                                             : 
 +:    Line#   AND/OR Mapped Field    Test  Value                               : 
 +:                                                                             : 
 +:    0001             *NE   -----                                             : 
 +:    0002                                                                     : 
 +:    0003                                                                     : 
 +:                                                                     More... : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:.............................................................................: 
 +                                                                                
 +</pre></html>
 +For the second Mapped Field MAPTWO, we can have a condition in which the Mapped Field is not equal (*NE) to *BLANK
 +<html><pre>
 +                               iDocs SmartRouter                      PR0032R1  
 +                          Insert Text into Spool File                 KKRAMER   
 +                                                                                
 +  SR Engine Name/Desc. : EARNINGS1  Example Earning No.1                          
 +  Application Name/Desc: EARNSRENG  Earning SR Engine                           
 +  Form App Reference . : EARNADD    Used for Emp.number add                     
 +............................................................................... 
 +:  Conditionally Map Field:    &EMPLOYNO2                                     : 
 +:                                                                             : 
 +:    Line#   AND/OR Mapped Field    Test  Value                               : 
 +:                                                                             : 
 +:    0001             *NE   *BLANK                                            : 
 +:    0002                                                                     : 
 +:    0003                                                                     : 
 +:                                                                     More... : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:                                                                             : 
 +:.............................................................................: 
 +                                                                                
 +</pre></html>
 +
 +**On IDocs 6.97 and newer continued** \\
 +**F4 Prompt** in the **Page**: field will specify where the inserted text will appear.  Enter *FIRST, *LAST, *EXTB, *EXTE, *2NDLS or certain page number where text will be displayed. \\ 
 +**Page:** field parameters on the Insert Text into Spool File screen are as follows:
 +
 +  * ** *FIRST** = Insert text on first page
 +  * ** *LAST** = Insert text on last page
 +  * ** *EXTB** = Spool page extra first page (at the beginning of spool page)
 +  * ** *EXTE** = Spool page extra last page (at the end of spool page)
 +  * ** *2NDLS** = Insert text on second to last page
 +  * **(Blank)** = Leave blank to insert text into every spool page
 +  * **(Specific page)** = Specify the page number to insert text
  
 ===== Starting and Ending a SmartRouter™ Engine ===== ===== Starting and Ending a SmartRouter™ Engine =====
pub/preprocessor.txt · Last modified: 2024/04/25 09:26 by kkramer