Advertisement

Quick Links

TIBCO Foresight® EDISIM®
Validator User's Guide
Software Release 6.19
December 2019

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the EDISIM and is the answer not in the manual?

Questions and answers

Lisa Sippel
May 20, 2025

Does this tool offer any encryption for data storage or during transmission?

Summary of Contents for TIBCO EDISIM

  • Page 1 TIBCO Foresight® EDISIM® Validator User’s Guide Software Release 6.19 December 2019...
  • Page 2 TIBCO Software Inc. TIBCO, the TIBCO logo, TIBCO Foresight Community Manager, TIBCO Foresight Instream, and TIBCO Foresight EDISIM are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries.
  • Page 3: Table Of Contents

    Contents Introducing TIBCO Foresight® EDISIM® Validator Intended audience....................1 Capabilities ......................1 Basics Starting EDISIM Validator ..................3 Tutorial ........................3 Toolbar ........................4 Sizing a pane ......................4 Validating data Selecting a data file to validate ................5 Selecting a guideline ....................5 Running the validation ...................
  • Page 4 Saving a validation ....................25 Creating your own Guideline Overview ......................27 Technical appendices Data types ......................29 Diagnostic messages ................... 31 Index Contents  ii Validator User’s Guide...
  • Page 5: Introducing Tibco Foresight® Edisim® Validator

    This document is written for business analysts and technical staff members who need to check the validity of data against a standard or guideline. Capabilities EDISIM® Validator checks the validity of data against Foresight-supplied standards and guidelines you have imported or created in Standards Editor. You can optionally correct the data.
  • Page 6 Introducing TIBCO Foresight® EDISIM® Validator  2 Validator User’s Guide...
  • Page 7: Basics

    Select Start | Programs | <TIBCO_HOME> | EDISIM | Validator. Go to EDISIM’s Bin folder and double-click on FSValidator.exe. From EDISIM programs other than Standards Editor, use the toolbar button: From the EDISIM program Standards Editor, use the toolbar button: Tutorial See FlatFilesAtForesight.pdf for a tutorial.
  • Page 8: Toolbar

    Toolbar Rest your cursor over a toolbar button to see a tooltip. Sizing a pane To size the panes, drag the splitter bar between the top and bottom panes. To “zoom” or fill the entire window with the active pane, do one of these: ...
  • Page 9: Validating Data

    Validating data Selecting a data file to validate Open a data file for validation in any of these ways:  Select File | Open.  Use Validator’s first toolbar button.  Use Ctrl-o.  Drag a data file from an Explorer folder and drop it into either Validator pane ...
  • Page 10: Running The Validation

    Running the validation After selecting your data file and guideline, Validator checks the file. To speed up processing by 20-30%, click on any segment or diagnostic to stop the scrolling. When it finishes, click OK to dismiss the Analysis Completed box. Navigating through the results The top pane displays diagnostics, and the bottom shows each line in your data file.
  • Page 11: Diagnostic Messages

    Diagnostic Messages Finding the diagnostic message number, severity, and HIPAA type To determine a message’s diagnostic number, severity level, and HIPAA type, right-click on it in the top pane. This example shows the pop up menu that appears. We can see this is diagnostic message #10626.
  • Page 12: Copying Individual Results

    For example, clicking on More info -> for Diagnostic Message #10213 will result in a pop-up box with additional information about the error. Click the OK button to dismiss the message. Copying Individual results After validation is complete, you can copy one selected line from the active pane to the clipboard with Edit | Copy, by clicking the Copy toolbar button , or by using your right mouse button.
  • Page 13: Printing

    Printing After validation, you can print your results to a printer or to a file. Printing to a printer To print validation results to a printer: 1. Choose File | Print. 2. Choose the Report Type: Diagnostics only Information displayed in Validator's top pane Segments only Information displayed in Validator's bottom pane (the data file)
  • Page 14 Here you can set the page width and height and the margins. Eject last page inserts line feeds, which fill up a page. Use Formfeeds inserts a formfeed command at the end of the file. 5. Click OK to see a file save box where you can name and save the report file: Counts, Depth and Position This option gives the report these additional columns: ...
  • Page 15 Prev The Prev (or Previous) column in the Counts, Depth, and Position report shows:  The line number of the previous iteration of the loop.  The line number of the first record of the enclosing loop if there is no previous iteration of the loop.
  • Page 16: Debug

    The green debug messages show the steps Validator takes to enforce your business rules: To prevent some business rules from displaying debug messages, use a text editor to edit BusinessRules.properties in EDISIM’s Bin directory. Set rules to 0 if you don’t want them to show debug messages: Validating data ...
  • Page 17: Correcting Validated Data

    Correcting validated data To correct data that has been validated: 1. Unlock the file: The bottom pane turns yellow and the bottom pane’s title bar shows Segments - UNLOCKED! to show that you are in edit mode. 2. Right-click on a segment that you want to change and select Edit Segment, Delete Segment, or Insert Segment: Edit Segment Make the change in the edit box and click OK.
  • Page 18 3. Choose File | Save Data File or File | Save Data File As and choose the filename and location for the saved file: 4. Choose File | Open and revalidate the new file. 5. When finished making changes, lock the bottom pane to prevent accidental editing: Validating data ...
  • Page 19: Customizing Your Validation

    Customizing your validation Options overview The Options menu lets you customize the way your files are validated. Customization Use … See… Select which Options | Validator General options on page conditions to check Profile | Analysis tab Suppress the display of Options | Validator Filtering diagnostic messages certain diagnostics...
  • Page 20: General Options

    General options To modify how Validator processes your data file, use the Options | Validator Profile menu or the Options button on your toolbar: The Analysis tab has general options, segment-related options, and element-related options: General Options Ignore standard specific profiles You can set up profiles that automatically activate when you use specific standards or guidelines (see Standard-specific profiles...
  • Page 21 MIG can be used whenever a new functional group is encountered. Default: off. Ask for Standard Name This option controls whether EDISIM Validator will ask you to choose a standard each time a new functional group is encountered. If this option is selected, you will be asked each time;...
  • Page 22 Padding between Interchanges Sometimes a translator places padding characters (blanks, etc.) after the IEA or UNZ to fill it out to a certain length. If so, type it here. This can be a keyboard character or hex. If you use hex, type a lowercase x before the value as in x0D. Default: empty. Segment Terminator If Validator is having trouble detecting the end of record, type the terminator here.
  • Page 23 Continue validating after SQL errors Communication issues between DBExecute and DBQuery business rules and the SQL database may cause validation to stop or fail. If selected, validation continues if a communication issue is encountered. Validate binary segment contents If selected, Validator stops when it encounters a binary segment (BIN or BDS) and requests a guideline to use to validate the contents of the binary segment.
  • Page 24 Check Code Values If selected, Validator checks the data's code values to be sure they are on the list of allowed values. Check App. Data Values If selected, Validator enforces application values, if they are used in the guideline. Application values are case sensitive. Check Leading Zeroes If selected, Validator flags leading zeros in numeric fields.
  • Page 25 Allow Delimiters within data This setting applies only to HL7 data. If selected, validation will not present errors when delimiters are present in data fields. X12 R Type Strict This setting determines if insignificant leading and trailing zeroes should be allowed in X12 data.
  • Page 26: Diagnostic Colors

    Diagnostic colors Choose Options | Validator Profile | Colors to see or change the colors for each type of diagnostic. Default Colors for Diagnostic Types Type Color Meaning Ignore Light gray Messages you consider unimportant Informational Dark gray Informative messages. Warning Olive Minor errors, such as leading zeros in numerics...
  • Page 27: Messages Tab

    Messages Tab To see a list of all diagnostic messages, choose Options | Validator Profile | Messages. You will see a list of all messages created by Foresight or by your own business rules. You can change individual messages as follows. To do this …...
  • Page 28: Loading A Saved Profile

    It will be used for all validations until you load another profile or close Validator. Default profiles Loading the default profile 1. Choose Options | Validator Profile | Load. 2. Select $fsdeflt.apf in EDISIM’s Bin directory. Saving a default profile 1. Choose Options | Validator Profile. 2. Make your selections on the four tabs.
  • Page 29: Standard-Specific Profiles

    3. Choose $fsdeflt.apf in EDISIM’s Bin directory. 4. Click Save As. 5. Save it with Save as the Default Profile selected. Standard-specific profiles You can save a profile to be automatically used only with a specific guideline. To do so: 1.
  • Page 30 To load a saved validation: 1. Choose File | Open Saved Analysis. 2. Open the SAF file you previously saved. Customizing your validation  26 Validator User’s Guide...
  • Page 31: Creating Your Own Guideline

    EDISIM’s Standards Editor. However, you can also use EDI data and Validator to create a new guideline for X12, EDIFACT, and HL7 data. You can then use the guideline with any EDISIM® module, just as if you created it in Standards Editor. Briefly, to create your own guideline, 1.
  • Page 32 3. Use Standards Editor to fine-tune the new guideline, if desired. See Docstarter.pdf in EDISM’s Doc directory for more details. Creating your own Guideline  28 Validator User’s Guide...
  • Page 33: Technical Appendices

    Technical appendices Data types Alphanumeric, a sequence of any printable characters. Significant characters should be left justified. Leading spaces, when they occur, are assumed to be significant. Trailing spaces should not be included unless needed to meet the minimum length. Date, in YYMMDD or CCYYMMDD format.
  • Page 34 The field contains the value 12345 and the type is N9. This is to be interpreted as 0.000012345. If the value to be represented is 100.25, and the type is N2, the transmitted data is 10025. If the value is -100.25, and the type is N2, the transmitted data would be -10025.
  • Page 35: Diagnostic Messages

    Diagnostic messages Error Purpose Listed in … Number 10000 - 29000 Basic error messages. FSAnErrs.txt and Options | Validator Profile | Messages tab. 32000-32999 Error messages Filename of your choice. See BusinessRules.pdf in Validator’s Doc generated by user-created directory. Also listed in Options | Validator business rules.
  • Page 36 Technical appendices  32 Validator User’s Guide...
  • Page 37: Index

    filtering 15, 22 Index guideline - choosing 5 guideline - selecting 16 leading zeroes 20 Library Link 6 message numbers 7, 22, 31 $fsdeflt.apf 24 opening Validator 3 Options menu 15 options overview 15 Analysis tab 16 application values 20 Ask for Standard Name 17 padding or control characters 18 pane - sizing 4...
  • Page 38 unused fields 20 unused segments 19 Use One Standard 17 zoom 4 Index  34 Validator User’s Guide...

Table of Contents