Variable-Length Write Wizard

Variable-Length Write Wizard is a wizard to use the drag operations to create the format definition that is required in order to generate variable-length data from input data.

= Remarks =

Refer to Variable-length text files for details about variable-length files.

Launching Variable-Length Write Wizard

You can click Variable-Length Write Wizard in the properties for the Write Variable-Length File operation to launch Variable-Length Write Wizard.

Screen elements of Variable-Length Write Wizard

Numbering in the figure	Name	Description	Remarks
(1)	Column list	Defines the structure of input data. You can add fields which have the same number of columns as the input data and define a structure (such as names, types, length, alignment, and padding) for each of the fields.	The column list has the same structure as the table model type. Refer to Table model type for details about the table model type.
(2)	Structure definition	Defines the structure of output data. You can define groups and records in Structure definition and add fields defined in the column list to the groups and records using the drag operations.	The structure definition is a tree structure which has the Root icon as a root element.
(3)	Column list/Fields		Fields are shown as yellow icons.
(4)	Group		Groups are shown as blue icons.
(5)	Record		Records are shown as green icons.
(6)	Fixed Value Field		Fixed value fields are shown as yellow icons with a check mark.
(7)	Field		Fields are shown as yellow icons.

Right-click menu

Name	Description	Remarks
Add Group	Adds a group.	Right-click on Root to display this.
Add Record	Adds a record.	Right-click on Root or Group to display this.
Add Field	Adds a field.	Right-click on Record to display this.
Copy	Copies the selected element.	Right-click on Group, Record, or Field to display this.
Cut	Cuts the selected element.	Right-click on Group, Record, or Field to display this.
Paste	Pastes the selected element.	Right-click on Root, Group, or Record to display this.
Properties	Shows the definition dialog of the selected element.	Right-click on Group, Record, Field under the structure definition, or on Field under the column list to display this.
Delete	Deletes the selected element.	Right-click on Group, Record, Field under the structure definition, or on Field under the column list to display this.

Column list configuration

In the column list, you can define a record of the variable-length data by defining the structure with columns of input data as fields.

Field configuration

To configure a field, follow the steps below.

Select Add Field in the right-click menu for the column icon.

Configure properties in the Field definition dialog.

Item name	Required/Optional	Description	Remarks
Field name	Required	Enter a name of the field.
Field type	Required	Specify a type of the field. Available types are as follows: String (Default) Numeric Date Tag

Item name

Required/Optional

Description

Remarks

Field name

Required

Enter a name of the field.

Field type

Required

Specify a type of the field. Available types are as follows:

String

(Default)
Numeric
Date
Tag

Click the Finish button to add the field to the column list.

Structure definition configuration

The structure definition defines a structure of output data.

Group configuration

To configure a group, follow the steps below.

Select Add Group in the right-click menu for the structure definition icon.

Configure properties in the Group definition dialog.

Item name	Required/Optional	Description
Group name	Required	Enter a name of the group.
Occurrence	Optional	This item isn't used in the write operation.
Omittable	Optional	This item isn't used in the write operation.
Unlimited	Optional	This item isn't used in the write operation.

Click the Finish button to add the group to the structure definition.

Record configuration

To configure a record, follow the steps below.

Select Add Record in the right-click menu of the structure definition icon or the group icon.

Configure properties in the "Record definition" dialog.

Item name	Required/Optional	Description
Record name	Required	Enter a name of the record.
Occurrence	Optional	This item isn't used in the write operation.
Omittable	Optional	Select whether to always write to each row the input data corresponding to each record. Selected If the input data corresponding to the record is the same as that of the previous row, output data could be omitted. The output data is omitted when all the following conditions are matched. In the subsequent records, there are no records for which Omittable isn't selected. In the subsequent records, there are records for which Omittable is selected, and the input data corresponding to the record is the same as that of the previous row. The first field of the subsequent record is a record is a tag field, and the input data corresponding to the record is the same as that of the previous row. It isn't the end row of the input data. Not selected (Default) Records are always written to each row.
Unlimited	Optional	This item isn't used in the write operation.

Click the Finish button to add the record to the structure definition.

Field configuration

To configure a field, follow the steps below.

Select a field defined in Column list and drag it to the record defined in Structure definition.
A field is added to the structure definition and the fields are linked.

Fixed value field configuration

To configure a fixed value field, follow the steps below.

Select Add Field in the right-click menu for record icons and show the "Field definition" dialog.
Configure properties in the Field definition dialog.
= Remarks =
- Refer to Field configuration for details about properties.
- The value entered in Field name is output.
Click the Finish button to add the fixed value field to the structure definition.