Professional Documents
Culture Documents
WhatsNew BankFeed CSVFileSupport
WhatsNew BankFeed CSVFileSupport
CSV-type bank file formats are used by a number of international banks and o en in
geographical regions. To support our business partners who work with banks that require CSV
files for payment remi ance, we enhanced the bank file definition function (GESTFB) to make
it easier to set up and use CSV-type bank file definitions.
In this course, you'll see the setup and requirements for defining a CSV bank file to use when
you generate payment files. You'll also see how to create a CSV bank file definition.
Duration: 15 minutes
Disclaimer
LESSON S
Set up
Knowledge challenge
R ESOUR CES
Resources
ACKN OWLEDGEMEN TS
Acknowledgements
CLOSIN G
Sage University
Lesson 1 of 9
Disclaimer
Disclaimer
The course materials provided are the property of The Sage Group plc or its licensors (“Sage”). Please
do not copy, reproduce, modify, distribute or disburse without express consent from Sage.
This material is provided as a general guidance for informational purposes only. Accordingly, Sage does
not provide advice per the information included. The use of this material is not a substitute for the
guidance of a lawyer, tax, or compliance professional. When in doubt, please consult your lawyer, tax, or
compliance professional for counsel. This material is provided on an ”as is” basis. Sage makes no
representations or warranties of any kind, express or implied, about the completeness or accuracy of
this training materials. Whilst Sage may make changes to this training materials at any time without
notice, Sage makes no commitment to update the training materials every time Sage’s products are
updated.
The Sage product(s) described herein is/are governed by the terms and conditions per the Sage End
User License Agreement ("EULA") or other agreement that is provided with or included in the Sage
product(s). Nothing in this document supplements, modifies, or amends those terms and conditions.
© 2021 The Sage Group plc or its licensors. All rights reserved. Sage, Sage logos, and Sage product and
service names mentioned herein are the trademarks of The Sage Group plc or its licensors. All other
trademarks are the property of their respective owners.
C O NT I NU E
Lesson 2 of 9
Overview
AP/AR account managers need an easy-to-use function to prepare outbound bank files in CSV format.
In previous versions of the application, if you needed to use a CSV bank file format, you had to create it
manually. The process was complex and time consuming.
The Bank file definitions function now includes the "CSV" format type, in addition to the existing
"Fixed" and "Variable" formats. The new "CSV" Format type allows you to create, adjust, and maintain
CSV-type bank file definitions more easily. The CSV format functionality increases usability and
acceptance for banks that require CSV files for payment remi ance.
Benefits
With the new CSV option in the Format type field, creating and using CSV files is simpler for all users.
Now, when you define a CSV file type, you can:
Define a field delimiter (usually double-quotes, " ) that is added in the first and last position for
alphanumeric fields.
C O NT I NU E
Lesson 3 of 9
Set up
The Bank file definition function includes a new Format type option, CSV. When you select the format
type CSV, new fields that support the format become active.
Select the "i" icons on the image below to learn more about the enhanced function.
Character encoding
Format type
The format type defines the structure you use to manage the data in the bank file you export.
These other new fields are active only when you select the CSV format type:
- Field separator
- Field delimiter
- Character coding
Field separator
Use this field to enter the character that separates two fields of a line.
To enter a non-printable character, enter a backslash ( \ ) followed by the 3 numbers and the decimal base
representing the ASCII code of the character.
Field delimiter
The field delimiter indicates where the alphanumeric characters in the field start and end.
Use this field to enter the character that is in the first and last position for alphanumeric fields. It
encapsulates the contents in the field. Typically the field delimiter is a double-quote ( " ) or a single-quote ( '
).
Setup notes
For example, it is not possible to define different field separators for header and detail records.
The system applies all other general bank file definition se ings in the same manner for a CSV file
as for other format types.
For example, you might use a comma as a field separator. If there is text in a field that includes a
comma, such as " Miller, Meyer, Johnson & Partners," when you generate the file, the text will
appear as, "Miller Meyer Johnson & Partners." The commas are removed.
C O NT I NU E
Lesson 4 of 9
Note: This process shows only the new elements for creating a bank file with the CSV format type. For
detailed learning about working with bank file definitions, try these Sage University courses: "X3 - Sage
X3 - AP Specialist: AP Setup;" "X3 - Sage X3 - AP Specialist: AP Setup."
Bank file definition - CSV format type
Enter the general se ings, as with any other bank file definition, such as bank file name and
code, record type, and so on.
Step 2
Enter values for the CSV specific se ings. This example shows the Field separator as ( ; ), the
Field delimiter as ( " ), and the Character coding as UTF-8.
Step 4
In the Records section, enter a definition for each field of the CSV file. Each line in the grid
represents one field.
Grid columns:
Field type: controls the data type of the field
Formula: defines the content (data) of the field. The options are the same as for other format
types, for example, reference to a database field, a function, fixed text. See the online help for
information about the supported definitions.
Description: Internal notes, optional
Step 5
It is important that you enter the end of line delimiter character as a binary field and as the last
record. EOL characters are not added automatically.
C O NT I NU E
Lesson 5 of 9
L I NE 1 L I NE 2 L I NE 3 L I NE 4
The first line represents the first field. It is fixed text as indicated by the qupote marks.
L I NE 1 L I NE 2 L I NE 3 L I NE 4
The second line represents the second field. This is a function that generates the date in the specified
format.
L I NE 1 L I NE 2 L I NE 3 L I NE 4
The third line represents the third field. This filed is populated directly from a database filed. In this
instance, the customer ID is "234AB3222XYZ945."
L I NE 1 L I NE 2 L I NE 3 L I NE 4
The last line, in this case line 4, is the end of line character. It must be in binary format. In this instance,
the the result is carriage return + line feed.
Header records
When you create a bank file definition, you must include a header record.
If no header record is required for the output file, a "dummy header" record must be included in
the bank file definition.
To create the "dummy header," enter a condition that will not be met during the creation of the
output file.
For example, you could enter [F:TFB]BAN = 'DUMMY,' or even more simply 1=2, in the condition
field. In addition, create at least a single record line.
If your header or footer consists of several lines, you can define the multiple lines structure within
the single header/footer bank file definition requirements.
C O NT I NU E
Lesson 6 of 9
Knowledge challenge
Challenge yourself!
Use the flashcards below to review the key concepts for creating CSV bank file definitions. See if you
can answer the questions before turning over the cards. There are nine questions.
1 of 9
2 of 9
3 of 9
5 of 9
6 of 9
What does each line in the Each line in the grid
records grid represent? represents one field.
7 of 9
8 of 9
To enter a non-printable
character for a field
separator, enter a the
How do you define a non-
printable character to use as
backslash ( \ ) followed by
a field separator? the 3 numbers and the
decimal base
representing the ASCII
9 of 9
C O NT I NU E
Lesson 7 of 9
Resources
C O NT I NU E
Lesson 8 of 9
Acknowledgements
Sage University