You can configure the File Adapter in your process by performing the following procedures.
1. Click the Assign Participants link in the Tasks pane. From Adapters > Managed > FileAdapters, drag the File Adapter to the Content pane.
2. Double-click the File Adapter workstep to open its Properties view.
3. From the Properties view for the workstep, click the Configuration tab. This tab includes the Configure, Change mapping, and Advanced properties buttons for defining the adapter configuration and mapping.
4. Click Configure to open the File Adapter Configurator dialog box.
Note: You can also open the File Adapter Configurator using the new Managed Adapter Browser (available only from Progress Developer Studio for OpenEdge) functionality. In addition to configuring, you can use the Managed Adapter Browser to perform functions like creating a copy, renaming, deleting, as well as importing and exporting the configuration information. For more information, refer to the "Using the Managed Adapter Browser" section of the Progress Developer Studio for OpenEdge User’s Guide.
You can enter the basic configuration for the File Adapter:
Mode. Defines the File Adapter behavior - whether it should Read a file, Write a file (overwriting the previous data, if any), or Append to an already existing file.
File Name and Path Prefix. These fields allow you to specify the full path to the file you are going to process. You can enter values for either of them, or you can leave the fields empty. If these fields are empty, you are allowed to map any of them to a dataslot later.
Generally, the File Name field stores just the name of the file, while the directory path is given in the Path Prefix field. This method allows you to dynamically map the file name from a process dataslot, while the directory path remains constant.
Data Format. Specifies the format of the file. Options include Text (a simple text file), Velocity Template (complex text using the Velocity Template engine syntax), Delimited (a comma-separated list of values), or XML (an XML file). You can select one of the available plug-ins, including any custom Format Plug-ins you may have developed.
For more information on data types supported by the Managed Adapter Framework, see the Supported data types section in the Progress OpenEdge Business Process Server: Managed Adapters Guide.
Once you select the plug-in, the File Format tab is enabled to display the corresponding plug-in GUI configurator.
Note that all plug-ins may not support all three modes - Read, Write, and Append. If you select a mode that is not acceptable for the given plug-in, you get a warning message and the mode is switched to the default plug-in mode.
The next sections deal with the configuration of each of the default plug-ins.
Mode. Defines the File Adapter behavior - whether it should Read a file, Write a file (overwriting the previous data, if any), or Append to an already existing file.
