Configurazione CSV

Puoi configurare la formattazione CSV del transcodificatore Mainframe Connector aggiungendo la configurazione richiesta in un file JSON e specificando questo file utilizzando l'opzione --input-parameter csv-dialect=DataPath con i comandi qsam encode o qsam decode. Devi definire la configurazione CSV come specificato nella sezione CsvConfiguration.

Questa pagina descrive i vari parametri CSV che puoi configurare come parametri di input per la transcodifica. L'oggetto CsvConfiguration contiene tutte le opzioni di configurazione dell'encoder e del decoder CSV.

CsvConfiguration

L'oggetto CsvConfiguration consente di configurare la decodifica e la codifica CSV.

Rappresentazione 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)
}
Campi
null_representation

string

Specifica la stringa che rappresenta un carattere nullo.

header

enum (WriteHeaderMode)

Imposta questo valore su true se vuoi che la prima riga contenga i nomi delle colonne anziché i dati effettivi.

quote_escaping

string

Specifica il carattere di escape.

quote

string

Specifica il carattere delle virgolette.

delimiter

string

Specifica il carattere da utilizzare per separare i campi.

line_terminator

string

Specifica il carattere da utilizzare per separare le righe.

support_list

boolean

Imposta su true se vuoi che Mainframe Connector supporti gli elenchi in formato CSV.

list_start_delimiter

string

Se support_list è impostato su true, questo valore rappresenta il delimitatore del carattere iniziale per gli elenchi.

list_end_delimiter

string

Se support_list è impostato su true, questo valore rappresenta il delimitatore di caratteri finale per gli elenchi.

support_struct

boolean

Imposta su true se vuoi che Mainframe Connector supporti le struct in CSV.

struct_start_delimiter

string

Se support_struct è impostato su true, questo valore rappresenta il delimitatore del carattere iniziale per gli struct.

struct_end_delimiter

string

Se support_struct è impostato su true, questo valore rappresenta il delimitatore del carattere finale per le struct.

binary_data_encoding

enum (BinaryDataEncoding)

Specifica il modo in cui Mainframe Connector codifica o decodifica i dati binari. I valori validi sono esadecimali, base64 o esadecimali. Il valore predefinito è base64.

date_format

string

Specifica il formato della data. Il formato predefinito è yyyy-mm-dd.

timestamp_format

string

Specifica il formato del timestamp. Il valore predefinito è DateTimeFormatter.ISO_INSTANT.

quote_mode

enum (QuoteMode)

Specifica il comportamento di citazione. Il valore predefinito è MINIMAL.

BinaryDataEncoding

Specifica il modo in cui Mainframe Connector codifica o decodifica i dati binari. I valori validi sono esadecimali, base64 o esadecimali. Il valore predefinito è base64.

Enum
BASE64 Codifica i dati binari in una stringa ASCII.
HEX Codifica i dati binari in esadecimale (formato \x) o ottale con caratteri di escape.
HEXADECIMAL Codifica i dati binari in formato esadecimale (formato 0x) o binario non elaborato.

WriteHeaderMode

Definisce il comportamento di scrittura dell'intestazione CSV.

Enum
NO Non scrive l'intestazione CSV.
YES Scrive l'intestazione CSV solo se sono presenti dati.
ALWAYS Scrivi sempre l'intestazione CSV.

QuoteMode

Definisce il comportamento di citazione.

Enum
MINIMAL I campi tra virgolette che contengono caratteri speciali come il delimitatore di campo, il carattere virgolette o uno qualsiasi dei caratteri nella stringa del separatore di riga.
ALL_NON_NULL Mette tra virgolette tutti i campi non nulli.
ALL Mette tra virgolette tutti i campi.
NON_NUMERIC Mette tra virgolette tutti i campi non numerici.
NONE Non inserisce mai le virgolette nei campi. Quando si verifica un delimitatore nei dati, la stampante lo precede con il carattere di escape. Se il carattere di escape non è impostato, la convalida del formato genera un'eccezione.