Shuffler

Use the Shuffler activity to enhance detail results from Instream by “shuffling” STC records into 837 and 276 flat file documents to identify errors found in front-end validation.

Note: The Shuffler activity is for use by Centers for Medicare and Medicaid Services (CMS) customers utilizing data that has been validated by Instream to convert EDI to and from flat file format for compliance with the CMS-supplied Claims Edit Module (CEM) requirements for electronic processing of claims. Purchase of the TIBCO Foresight® Instream® MAC Adapter is required to use Shuffler.
Shuffler can be used with the following types of input and output:
  • EDI input and EDI output - utilizing EDI detail file output from Instream to generate EDI data
  • Flat file input and flat file output - utilizing flat file input from Translator to generate flat file data.

Shuffler should be placed after validation has occurred and before translation.

For more details on Shuffler, refer to the TIBCO Foresight® Instream® MAC Adapter Introduction PDF document.

Examples

Example uses of Shuffler are as follows.

EDI input and EDI output

  1. Instream validates good EDI and creates a Detail file (DTL).
  2. Shuffler inserts additional data into the EDI and Detail file received from Instream.
    • For each ISA, a CTRD record is added (optional).
    • After checking data against a user-specified STC Definition Table file, STC records are added after the segment in error for each error found in the original EDI file.
  3. Shuffler outputs data in EDI format.

Flat file input and flat file output

  1. Instream validates good EDI and creates a Detail file (DTL).
  2. Translator converts the EDI data received from Instream into flat file format.
  3. Shuffler inserts additional data into the flat file received from Translator:
    • For each ISA flat file, a CTRD record is added (optional).
    • After checking data against a user-specified STC Definition Table file, STC records are added after the flat file segment in error for each error found in the original EDI file.
  4. Shuffler outputs data in flat file format.

General

The General tab contains the following fields.

Field Literal Value/Module Property/Process Property? Description
Name No The name to be displayed as the label for the activity in the process.
Input Mode No Specifies where the input data is stored. There are two options: File and Memory. Memory is normally the most efficient way of connecting, but large documents should be stored as files.
Output Mode No Specifies where the output data is stored. There are two options: File and Memory. Memory is normally the most efficient way of connecting, but large documents should be stored as files.
Document Type No Select TEXT (if using flat-file data) or EDI (if using an Instream detail file).
Create CTR Record No Check this check box to create CTRD records.

Description

The Description tab is used to provide a short description for the activity.

Input

The Input tab contains the following fields.

Field Datatype Description
input string Input file path and name.
instream_result string Specifies the file path and name of the Instream detail file to be modified. (Required)
Note: This file is not changed by Shuffler.
STC_definition_table string Specifies the path to a comma-separated STC definition table describing whether or not an STC record should be included in the resulting file.

Refer to STC Definition Table for more information.

map_file string This field specifies the name and extension of a translation map file. TIBCO ActiveMatrix BusinessWorks™ Plug-in for EDI supports map files with the .map and .xml file name extensions.

A map file specifies the source and target guidelines for each translation map. The source guideline describes the data before translation. The target guideline describes the data after translation.

See Translator for more information about map files

config_file string Specifies the file path and name of the Shuffler configuration file. (Required)
outputfile_pathname string Specifies the file path and name for the output modified file. (Required)

It should not be the same as the Input file.

Output

The Output tab contains the following fields.

Field Datatype Description
output string File path and name for the output modified Instream detail file.
error_message string Error message description.
return_code string Specifies the Shuffler return code.

For example, 100 means the activity ran successfully, 0 means there was a parameter error, and so on.

Return codes are listed in Appendix A of TIBCO Foresight® Instream® MAC Adapter Introduction.

Fault

The Fault tab lists exceptions that are thrown by this activity.

Error Schema Element Datatype Description
msg string Error message description.
msgCode string The error code. It represents TIBCO ActiveMatrix BusinessWorks Plug-in for EDI and TIBCO Foresight errors.

See Error Codes for details.

Contents
Search Results