Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Integration Server Built-In Services | Flat File Folder | Summary of Elements in the Flat File Folder | pub.flatFile.generate:updateFFDictionaryEntryFromXML
 
pub.flatFile.generate:updateFFDictionaryEntryFromXML
WmFlatFile. Updates one or more entries in a flat file dictionary in the Integration Server namespace.
This service goes through all entries that you specify in the FFXML variable. If an entry with the same name and type already exists in the flat file dictionary, this service overwrites the existing entry. If the entry does not already exist, this service creates the entry in the specified flat file dictionary.
Input Variables
FFDictionaryName
String. The fully–qualified name of the flat file dictionary that contains the entries that you are replacing, adding, or both.
FFXML
String. The dictionary entries (as an XML string) that you want to use to replace an existing entry or that you want to add to the flat file dictionary. The XML string in FFXML must conform to the pub.flatFile.generate:FFDictionary IS document type.
Merk:
To see examples of how to supply the XML string in FFXML by mapping data from another file, see the samples provided in the WmFlatFileSamples package. For sample code that shows how to retrieve the data for FFXML from an XML file in the local file system, see Flat File Schema Developer’s Guide.
maxNumOfErrors
String. Optional. The maximum number of errors that you want returned. The default is 100.
The service ensures the flat file schema is valid before saving them in the flat file dictionary. The validation occurs in two stages.
1. Structural validation of the XML.
2. Logical validation of the XML contents.
If structural validation errors occur, the service reports the structural validation errors, but does not proceed with logical validation. When the XML string contains no structural validation errors, the service proceeds with logical validation and reports any logical validation errors.
Output Variables
saved
String. Whether the dictionary entry was saved successfully. It will have one of the following values.
Value
Description
true
The dictionary entry was successfully saved.
false
The dictionary entry was not successfully saved.
Errors
String List. Optional. Errors that occurred while attempting to save the entry to the flat file dictionary.
Warnings
String List. Optional. Warnings about the dictionary entry that was updated or added.
Examples
For examples of how to use this service, see the following services in the certified samples area of the Knowledge Center on the Empower Product Support website at https://empower.softwareag.com.
sample.flatFile.generateFFSchema:delimited
sample.flatFile.generateFFSchema:fixedLength