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.
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...
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.
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.
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: ...
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 ...
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.
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.
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.
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.
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 ...
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 ...
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...
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.
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...
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 …...
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.
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...
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...
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.
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.
Need help?
Do you have a question about the EDISIM and is the answer not in the manual?
Questions and answers
Does this tool offer any encryption for data storage or during transmission?