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
pub:preprocessor [2018/10/03 21:22] – [Conditions] kkramerpub:preprocessor [2025/09/09 19:38] (current) – [Insert Text] kkramer
Line 75: Line 75:
  
 <html><pre> <html><pre>
-  9/14/18                     iDocs SmartRouter                     PR0010R4    +  2/26/22                     iDocs SmartRouter                     PR0010R4    
  20:01:06              SR Engine Definition Maintenance             KKRAMER       20:01:06              SR Engine Definition Maintenance             KKRAMER     
                                                                                                                                                                  
   SR Engine Name/Desc: OFACKTEST  Test Ack for Adel W                              SR Engine Name/Desc: OFACKTEST  Test Ack for Adel W                           
   Data Queue Name/Lib: OFACKDTQ   OFERRER                                          Data Queue Name/Lib: OFACKDTQ   OFERRER                                       
-  Archive Outque/Lib.: ARCHIVE2   OFERRER                                       +  Archive Outque/Lib.: ARCHIVE2   OFERRER       Archive/Delete/Hold: <u>D</u> A/D/H                                      
                                                                                                                                                                  
   Process Spool File.: *JOBQ      *CALL, *JOBQ                                     Process Spool File.: *JOBQ      *CALL, *JOBQ                                  
Line 105: Line 105:
  
   * **DataQueue** name and library:  the name of the dataqueue to which the SmartRouter engine will listen for spool files. This dataqueue can not be in use by other dataqueue engines such as those of iDocs, iMail, or iView. The SmartRouting engine will create the dataqueue for you and connect it to the outqueues when you start the engine.   * **DataQueue** name and library:  the name of the dataqueue to which the SmartRouter engine will listen for spool files. This dataqueue can not be in use by other dataqueue engines such as those of iDocs, iMail, or iView. The SmartRouting engine will create the dataqueue for you and connect it to the outqueues when you start the engine.
-  * **Archive** outqueue and library:  endpoint for the original spool file.+  * **Archive** outqueue and library:  endpoint for the original spool file. \\ 
 +Archive/Delete/Hold: A/D/H - SR 6.89 2/26/22 \\  
 +A: Original spool file will be moved to archive queue after processed\\ 
 +D: Original spool file will be deleted after processed\\ 
 +H: Original spool file will be held in current queue after processed\\ 
 +Blank: do nothing with original spool file\\ 
   * **Process Spool File**: Specify *JOBQ to process a spool file in a separate job via SBMJOB. The parameters of the SBMJOB call are provided in the next three parameters. Use *CALL to process a spool file via a CALL, resulting in processing in the same job as the engine.   * **Process Spool File**: Specify *JOBQ to process a spool file in a separate job via SBMJOB. The parameters of the SBMJOB call are provided in the next three parameters. Use *CALL to process a spool file via a CALL, resulting in processing in the same job as the engine.
   * **Job Queue Name**: Provide the name of a job queue if processing with the *JOBQ option. Single threaded job queues will process Smart Routing jobs serially. Multi threaded jobqueues will process them concurrently.    * **Job Queue Name**: Provide the name of a job queue if processing with the *JOBQ option. Single threaded job queues will process Smart Routing jobs serially. Multi threaded jobqueues will process them concurrently. 
Line 237: Line 242:
  
 ==== 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 402: Line 407:
 ^ Comparand keyword ^ Meaning ^ ^ Comparand keyword ^ Meaning ^
 | ***BLANKS**  | The compared field is blank |  | ***BLANKS**  | The compared field is blank | 
-| ***USRPRF**  | User profile owning the spool file | +| ***FORM** | Spool file form type |  
-| ***USRDTA** | Spool file user data | +| ***JOBNAME** | Spool file job name | 
 | ***OUTQUE** | Spool file outqueue |  | ***OUTQUE** | Spool file outqueue | 
 | ***OUTLIB** | Spool file outqueue library |  | ***OUTLIB** | Spool file outqueue library | 
 | ***SPLFILE** | Spool file name  |  | ***SPLFILE** | Spool file name  | 
-| ***FORM** | Spool file form type |  
-| ***JOBNAME** | Spool file job name |  
 | ***TOTALPG** | Spool file total pages |  | ***TOTALPG** | Spool file total pages | 
 +| ***USRPRF**  | User profile owning the spool file |
 +| ***USRDTA** | Spool file user data | 
  
 1. The processing priority: 1. The processing priority:
Line 486: Line 491:
 1 3 5                       1 3 5                      
 </pre></html> </pre></html>
 +
 +==== Insert Text ====
 +Spool file text and/or attribute value is entered via **option 8** = Insert Text. 
 +
 +<html><pre>
 +                               iDocs SmartRouter                      PR0032R1  
 +                          Insert Text into Spool File                 KKRAMER   
 +                                                                                
 +  SR Engine Name/Desc. : SRSAMPLEENG  Sample SR Engine                          
 +  Application Name/Desc: SRAPP        Copy Data                           
 +  Form App Reference . : SAMPLESORT   SR Sorting Form App                   
 +  Target Name/Desc . . : COPYTARGET   Coping Data to Page 1                            
 +                                                                                
 +  Source Spool Text:                                                            
 +   Map Field : DATAMOVE   Or Constant                                           
 +   From Page : *LAST      Output Text To: Row  47 Column   1 Page: *FIRST             
 +   Map Field : DATAMOVE2  Or Constant                                           
 +   From Page : *LAST      Output Text To: Row   7 Column 188 Page: *FIRST            
 +   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>
 +
 +In lieu of text, you can also insert the spool file date attribute value in the **Text** field. This attribute can be scrapped from the spool file and included in the output. In  the “Text” field of the Smart Router Target, add *SPLFDATE into Mapped field name and it will insert spool file create date in US format MM/DD/YY (iDOCS 8.0 04/22/2024)  
 +
 +In addition to the spool file date (iDOCS 8.0 10/01/2024) you can add *SPLFTIME into Mapped field name and it will insert spool file create time in US format HH:MM:SS.   
 +
 +(iDOCS 8.1 06/26/2025) An enhancement added the option to copy the spool file text from a Mapped Field on a page and paste to another location on the spool file. In the example above we are using the DATAMOVE Mapped Field configured in the SAMPLESORT Form Application associated with this Smart Router Engine to copy the spool file data from the Last Page of the spool file. 
 +
 +The ‘From Page’ field can be configured to specify:
 +  * *FIRST First page of the spool file
 +  * *LAST Last page of the spool file
 +  * Or a specific page number where the text is extracted
 +  * Or Leave blank to extract the text from each spool file page
 +
 +
 +== 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, *ODD, *EVEN, *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)
 +  * ** *EVEN** = Even spool file pages
 +  * ** *ODD**  = Odd spool file pages
 +  * ** *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.1538626931.txt.gz · Last modified: 2022/06/25 17:02 (external edit)