The File Designer XFD tab lets you add XFD directives to your FD to design an extended file descriptor (XFD) for your data files. XFD files are commonly used to map fields in a record to columns in a table. If you are using AcuXDBC, for example, or reading or writing XML data with AcuXML, XFD files help map the data for translation between file formats. AcuBench can also make use of one XFD directive, the NAME directive, to make some of its Screen Designer and Report Composer interfaces more readable.
Regardless of whether or not you have made changes to this tab, you can create an XFD file for any data file described in an AcuBench data layout file.
General information about XFDs can be found in File Processing.
To add XFD directives to your FD, do the following:
The options available on the right side of the interface are enabled or disabled depending on your selection.
To view the FD (including the XFD directives that you have specified), you can right-click the icon for your DLT in the Data view and select View dlt-name.fd.
XFD NAME directives can be used to assign a name to a field in a file. This is often used to add a descriptive, formatted, or shortened name to a field, in order to create a more readable table. You can also elect to have alternate names specified with the NAME directive appear in the AcuBench Drag and Drop, Make Radio Button, and Autoload interfaces used to create screen and report controls. These names are then also used as the default title or label associated with the control.
To define a new name for a field, enter the name in the Name Directive field.
If you want the name specified by the NAME directive to appear in AcuBench interfaces:
By default, data items in the Drag and Drop interface are listed using the field names defined in the file description. For more information about the Drag and Drop interface, see Drawing Controls with Drag-and-Drop, which pertains to screen design, and Using Drag-and-Drop, which discusses report design.
The USE GROUP directive allows you to enter a group item into the XFD as a single field, instead of using the elements contained in the group. This field is only enabled if you have selected a group item.
You can use the USE GROUP directive in conjunction with the NAME directive to assign a single name for the entire group.
When you mark the Data Type Directive check box, you can specify a format for the data item other than that established by the PICTURE clause. This means that you can have a database treat a numeric data item as alphanumeric, for example, or have a date item stored as numeric appear in a formatted date format. Select one of the following formats:
The WHEN directive is used when you want to include multiple record definitions or REDEFINES in the XFD file. When you mark the corresponding check box, a field is enabled, allowing you to enter WHEN directive syntax. Click the ellipsis button to display the Expression Builder dialog, where you can also construct WHEN directive syntax.
You can use the Table Name field to add an optional tablename clause to the WHEN directive. If you assign a table name, the data that immediately follows the WHEN directive and meets the specified condition will be considered as a separate table.
You can use COMMENT directives to include comments in your XFD field. Mark the Comment Directive check box, then enter a comment in the associated entry field.