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:saveXMLAsFFSchema
 
pub.flatFile.generate:saveXMLAsFFSchema
WmFlatFile. Creates a flat file schema in the Integration Server namespace by converting the specified flat file schema that is in XML format into a namespace flat file schema.
If a flat file schema with the same name already exists in the Integration Server namespace, use the pub.flatFile.generate:deleteFFSchema service to delete the flat file schema before invoking this service. This service throws an exception is if a flat file schema with the same name already exists when it is invoked.
Input Variables
FFSchemaName
String. The fully–qualified name of the flat file schema that you want to create in the Integration Server namespace.
PackageName
String. The name of the Integration Server package in which to save the flat file schema.
FFXML
String. The flat file schema (as an XML string) that you want to create in the Integration Server namespace. The XML string 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 it in the Integration Server namespace. 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 flat file schema was saved successfully. It will have one of the following values.
Value
Description
true
The flat file schema was successfully saved.
false
The flat file schema was not successfully saved.
Errors
String List. Optional. Errors that occurred while attempting to save the flat file schema to the Integration Server namespace.
Warnings
String List. Optional. Warnings about the flat file schema that was created.
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