tradacomsData | String or InputStream The TRADACOMS data you want to convert to an IData object. | ||
ediObject | Object (optional) An object that encapsulates and keeps track of the input data segments during processing. It is used only when the iterator parameter has been set to true. | ||
encoding | String (optional) The encoding of the data passed in to tradacomsData. | ||
TradacomsFFSchema | String The fully-qualified name of the flat file schema object used to parse the tradacomsData object. | ||
iterator | String (optional) Whether you want to process segments one at a time or process all input data at one time. Specify true or false. | ||
Value | Meaning | ||
true | The convertToValues service starts processing segment structures with a top-level record as defined by the flat file schema. The service returns to the caller when it encounters another top-level record in the input data. The next time the service is invoked, it begins processing the input data where it left off. | ||
false | The convertToValues service processes all input data at one time. This is the default. | ||
nullable | String (optional) Whether to create an IS document (IData object) if all fields are null. Specify true or false. | ||
Value | Meaning | ||
true | Do not create an IS document (IData object) if all the fields are null. This is the default. | ||
false | Always create an IS document even though all the fields are null. | ||
skipWhiteSpace | String (optional) Whether to ignore white space from the beginning of records. Specify true or false. | ||
Value | Meaning | ||
true | Ignore white spaces at the beginning of records. This is the default. | ||
false | Use the records as they are. Specify false when the data contains positional data records. | ||
keepResults | String (optional) Whether you want the convertToValues service to return an IData object or to just validate the structure of the data in tradacomsData. Specify true or false. | ||
Value | Meaning | ||
true | Return an IData object in the EDIValues output parameter. This is the default. | ||
false | Do not return an IData object in the EDIValues output parameter. Use this option when validating the structure of the tradacomsData against the specified flat file schema. | ||
validate | String (optional) Whether you want the convertToValues service to return error messages describing how tradacomsData differs from the specified flat file schema. Specify true or false. | ||
Value | Meaning | ||
true | Return errors describing how the given tradacomsData violates the constraints described in the flat file schema. | ||
false | Do not return error messages describing how the tradacomsData differs from the specified flat file schema. This is the default. | ||
returnErrors | String (optional) How you want the convertToValues service to return error messages when validate is set to true. Specify one of the following. | ||
Value | Meaning | ||
asArray | Return validation errors with the tradacomsData in an array called errors. This is the default. | ||
inResults | Return validation errors in the tradacomsValues object. | ||
both | Return validation errors in both errors and tradacomsValues. | ||
flags | Document (optional) Flags that you can set to govern convertToValues options. | ||
Key | Description | ||
addRecordCount | String Whether you want the service to add an additional field (@record-count) to each parsed record in the resulting IData object (EDIValues). The @record-count field is used to identify the record number of each parsed record. | ||
Value | Meaning | ||
true | The @record-count field is added to each parsed record. This field contains the number of the parsed record. The first parsed record is 1, the second is 2, etc. If there are records that are undefined data, the count of the next defined record will reflect the undefined data. For example, if the @record-count field for a record is 2 and that record contains 5 undefined records, the @record-count field for the next defined record will be 8. | ||
false | The @record-count field is not added to each parsed record. This is the default. | ||
detailedErrors | String Whether you want detailed conditional validation error information. This flag is only used when validate is true. | ||
Value | Meaning | ||
true | When a conditional validation error occurs, the output errors parameter will contain detail information about all the conditions that were violated. For more information, see information about validation errors in the Flat File Schema Developer’s Guide. | ||
false | When a conditional validation error occurs, the service does not provide detail error information. Conditional validators report only whether a condition failed validation with no additional information about the conditions that were violated. This is the default. | ||
maxErrors | String (optional) Maximum number of errors that you want returned when validate is set to true. When the flat file parser encounters more than the maximum number of errors within a record, the parser stops parsing and returns the parsed data and errors processed up until that point. |
tradacomsValues | Document The tradacomsData input data in IS document (IData object) format. | |
ediObject | Object (optional) An object that encapsulates and keeps track of the input data segments during processing. It is used only when the iterator parameter has been set to true. When all input data has been processed, the object becomes null. When the ediObject parameter is null, you should exit out of the LOOP to discontinue processing. For an example of using the section about processing a document segment by segment in the chapter on receiving and processing inbound EDI documents in the webMethods Module for EDI Installation and User’s Guide. | |
isValid | String Whether the data in tradacomsData is valid. | |
Value | Meaning | |
true | The validate input parameter was set to true and no errors were found. | |
false | The validate input parameter was set to true and errors were found, or the validate input parameter was set to false. | |
errors | Document List (optional) The validation errors, if any, that were found in tradacomsData. Validation errors are returned in errors only if validate is set to true -AND- returnErrors is set to asArray or both. The list includes the path of the errors. |