To each document record, add the data fields which values must be exchanged. For external file-based documents, set up the fields in line with naming in the file.
For Fixed text documents, fields are always of type string, to enable type conversions.
This topic explains how to add record fields to a Fixed text document.

If fields are already selected for or copied to the record, you can review and complete the setup for these fields. To do so, skip step 6.


Standard procedure

1. Click Connectivity studio Integration Design.
2. Click the Documents tab.
3. In the list, find and select the desired Fixed text document.
4. Click Edit.
5. In the Records section, in the Record list, find and select the desired record.
6. On the Fields tab, click New.
7. As a field name, enter a free-definable name. Usually, this is the name used in the external file.
  In the Field name field, type a value.
 

Note: The value of this field cannot have spaces.

8. As a record table, enter a free-definable name. Usually, this is the name used in the external file.
The value, as entered in the Field name field, is the default value. You can change this value.
  In the Record table field field, type a value.
 

Note: The value of this field cannot have spaces.

9. Indicate if the field is a key field for the record.
  Select the Key field check box.
10. Indicate if the field is mandatory to be filled. If on processing the document, the field has no value and Mandatory is set to:
- Yes, an error is given, and the document is not processed.
- Warning, a warning message is given, but the document is processed.
- No, the document is processed.
  In the Mandatory field, select an option.
11. Set the field length carefully. Make sure, the number of characters is sufficient to contain the value. If you set the length too short, you will use value characters.
  In the Length field, enter a number.
12. Define how the field value is aligned within the defined length.
  In the Alignment field, select an option.
13. Define at which position in the line the field starts. When you add a field, automatically the start position is defined based on the start positions and lengths of the previous fields. If on the header, the Record identification is set to Yes, the related start position and length are also taken into account.
  In the Start position field, enter a number.
 

Note: If you changed the field sequence or (de)activated the record identification, click Calculate start positions to recalculate the applicable start positions.

14. Often the field value doesn't consume the full length as defined for the field. The remaining positions must be filled. Define if the remaining positions must be filled with spaces or with zeros.
  In the Padding field, select an option.
15. To indicate a negative number the negative sign is used. Define where to position the negative sign, in front of or at the back of the value. Note: The negative sign consumes one position of the length as defined for the field.
  In the Sign position field, select an option.
16. Sub-task: Set external references for record.
  16.1 In the Line details section, set the external references for the record.
You can indicate which of the records fields contains the unique ID of the record in the external database. In this way, you link the external ID to the record ID.
  In the External reference field, enter or select a value.
 

Note: Usually, you only use this for an ODBC connection with CRM or if you use web services.

  16.2 You can indicate which of the records fields contains the revision of the record in the external database. In this way, you find and link the latest revision to the record ID.
  In the Revision field field, enter or select a value.
 

Note: You can only use this field in combination with the External reference field.

17. Close the page.
Related to Notes

Set up Fixed text document

 

Provide feedback