Configuration CSV

Vous pouvez configurer le format CSV du transcodeur Mainframe Connector en ajoutant la configuration requise dans un fichier JSON et en spécifiant ce fichier à l'aide de l'option --input-parameter csv-dialect=DataPath avec les commandes qsam encode ou qsam decode. Vous devez définir la configuration CSV comme indiqué dans la section CsvConfiguration.

Cette page décrit les différents paramètres CSV que vous pouvez configurer en tant que paramètres d'entrée pour le transcodage. L'objet CsvConfiguration contient toutes les options de configuration de l'encodeur et du décodeur CSV.

CsvConfiguration

L'objet CsvConfiguration vous permet de configurer le décodeur et l'encodeur CSV.

Représentation JSON
{
    "null_representation": string,
    "header": enum (WriteHeaderMode),
    "quote_escaping": string,
    "quote": string,
    "delimiter": string,
    "line_terminator": string,
    "support_list": boolean,
    "list_start_delimiter": string,
    "list_end_delimiter": string,
    "support_struct": boolean,
    "struct_start_delimiter": string,
    "struct_end_delimiter": string,
    "binary_data_encoding": enum (BinaryDataEncoding),
    "date_format": string,
    "timestamp_format": string,
    "quote_mode": enum (QuoteMode)
}
Champs
null_representation

string

Spécifiez la chaîne représentant un caractère nul.

header

enum (WriteHeaderMode)

Définissez cette valeur sur "true" si vous souhaitez que la première ligne contienne des noms de colonnes au lieu de données réelles.

quote_escaping

string

Spécifiez le caractère d'échappement.

quote

string

Spécifiez le caractère de guillemet.

delimiter

string

Spécifiez le caractère à utiliser pour séparer les champs.

line_terminator

string

Spécifiez le caractère à utiliser pour séparer les lignes.

support_list

boolean

Définissez cette option sur "true" si vous souhaitez que Mainframe Connector accepte les listes au format CSV.

list_start_delimiter

string

Si support_list est défini sur "true", cette valeur représente le délimiteur de caractère de début des listes.

list_end_delimiter

string

Si support_list est défini sur "true", cette valeur représente le délimiteur de caractère de fin pour les listes.

support_struct

boolean

Définissez cette option sur "true" si vous souhaitez que le connecteur Mainframe accepte les structs dans les fichiers CSV.

struct_start_delimiter

string

Si support_struct est défini sur "true", cette valeur représente le délimiteur de caractère de début pour les structs.

struct_end_delimiter

string

Si support_struct est défini sur "true", cette valeur représente le délimiteur de caractère de fin pour les structs.

binary_data_encoding

enum (BinaryDataEncoding)

Spécifiez la manière dont Mainframe Connector encode ou décode les données binaires. Les valeurs valides sont hexadécimal, base64 ou hex. La valeur par défaut est "base64".

date_format

string

Spécifiez le format de la date. Le format par défaut est yyyy-mm-dd.

timestamp_format

string

Spécifiez le format de l'horodatage. La valeur par défaut est DateTimeFormatter.ISO_INSTANT.

quote_mode

enum (QuoteMode)

Spécifiez le comportement de citation. La valeur par défaut est MINIMAL.

BinaryDataEncoding

Spécifiez la manière dont Mainframe Connector encode ou décode les données binaires. Les valeurs valides sont hexadécimal, base64 ou hex. La valeur par défaut est "base64".

Enums
BASE64 Encode les données binaires en chaîne ASCII.
HEX Encode les données binaires au format hexadécimal (\x) ou octal échappé.
HEXADECIMAL Encode les données binaires au format hexadécimal (format 0x) ou binaire brut.

WriteHeaderMode

Définit le comportement d'écriture de l'en-tête CSV.

Enums
NO N'écrit pas l'en-tête CSV.
YES Écrit l'en-tête CSV uniquement si des données sont présentes.
ALWAYS Écrivez toujours l'en-tête du fichier CSV.

QuoteMode

Définit le comportement de la citation.

Enums
MINIMAL Place entre guillemets les champs contenant des caractères spéciaux tels que le délimiteur de champ, le caractère de guillemet ou l'un des caractères de la chaîne de séparateur de ligne.
ALL_NON_NULL Met entre guillemets tous les champs non nuls.
ALL Met tous les champs entre guillemets.
NON_NUMERIC Place des guillemets autour de tous les champs non numériques.
NONE Ne met jamais les champs entre guillemets. Lorsqu'un délimiteur se trouve dans les données, l'imprimante le fait précéder du caractère d'échappement. Si le caractère d'échappement n'est pas défini, la validation du format génère une exception.