הגדרות CSV

כדי להגדיר את פורמט ה-CSV של רכיב ה-transcoder של Mainframe Connector, צריך להוסיף את ההגדרה הנדרשת בקובץ JSON ולציין את הקובץ הזה באמצעות האפשרות --input-parameter csv-dialect=DataPath עם הפקודות qsam encode או qsam decode. צריך להגדיר את קובץ ה-CSV לפי ההוראות שמפורטות בקטע CsvConfiguration.

בדף הזה מתוארים הפרמטרים השונים של קובץ ה-CSV שאפשר להגדיר כפרמטרים של קלט לטרנסקוד. אובייקט CsvConfiguration מכיל את כל אפשרויות ההגדרה של מקודד ומפענח CSV.

CsvConfiguration

אובייקט CsvConfiguration מאפשר להגדיר את ההגדרות של קידוד ופענוח קובץ CSV.

ייצוג JSON
{
    "binary_data_encoding": enum (BinaryDataEncoding),
    "date_format": string,
    "delimiter": string,
    "header": enum (WriteHeaderMode),
    "line_terminator": string,
    "list_end_delimiter": string,
    "list_start_delimiter": string,
    "null_representation": string,
    "quote": string,
    "quote_escaping": string,
    "quote_mode": enum (QuoteMode),
    "struct_end_delimiter": string,
    "struct_start_delimiter": string,
    "support_list": boolean,
    "support_struct": boolean,
    "timestamp_format": string
}
שדות
binary_data_encoding

enum (BinaryDataEncoding)

מציינים את האופן שבו Mainframe Connector מקודד או מפענח נתונים בינאריים. הערכים התקינים הם הקסדצימליים, base64 או הקסדצימליים. ערך ברירת המחדל הוא base64.

date_format

string

מציינים את הפורמט של התאריך. פורמט ברירת המחדל הוא yyyy-mm-dd.

delimiter

string

מציינים את התו שישמש להפרדה בין השדות.

header

enum (WriteHeaderMode)

אם רוצים שהשורה הראשונה תכיל שמות של עמודות במקום נתונים בפועל, צריך להגדיר את הערך הזה כ-true.

line_terminator

string

מציינים את התו שישמש להפרדה בין השורות.

list_end_delimiter

string

אם הערך של support_list הוא TRUE, הערך הזה מייצג את תו המפריד של סוף הרשימות.

list_start_delimiter

string

אם הערך של support_list מוגדר כ-True, הערך הזה מייצג את תו התחלת ההפרדה של רשימות.

null_representation

string

מציינים את המחרוזת שמייצגת תו null.

quote

string

מציינים את תו המירכאות.

quote_escaping

string

מציינים את תו הבריחה.

quote_mode

enum (QuoteMode)

מציינים את אופן השימוש במירכאות. ערך ברירת המחדל הוא MINIMAL.

struct_end_delimiter

string

אם הערך של support_struct הוא true, הערך הזה מייצג את תו הסיום של התוחם עבור מבנים.

struct_start_delimiter

string

אם הערך של support_struct הוא true, הערך הזה מייצג את התו המפריד של תחילת המחרוזת עבור מבנים.

support_list

boolean

אם רוצים ש-Mainframe Connector יתמוך ברשימות בפורמט CSV, צריך להגדיר את האפשרות כ-TRUE.

support_struct

boolean

אם רוצים ש-Mainframe Connector יתמוך במבני נתונים בקובץ CSV, צריך להגדיר את האפשרות כ-TRUE.

timestamp_format

string

מציינים את הפורמט של חותמת הזמן. ערך ברירת המחדל הוא DateTimeFormatter.ISO_INSTANT.

טיפוסים בני מנייה (enum)

BinaryDataEncoding

מציינים את האופן שבו Mainframe Connector מקודד או מפענח נתונים בינאריים. הערכים התקינים הם הקסדצימליים, base64 או הקסדצימליים. ערך ברירת המחדל הוא base64.

טיפוסים בני מנייה (enum)
BASE64 מקודד נתונים בינאריים למחרוזת ASCII.
HEX מקודד נתונים בינאריים לפורמט הקסדצימלי (פורמט ‎\x) או לפורמט אוקטלי עם תווי escape.
HEXADECIMAL מקודדת נתונים בינאריים בפורמט הקסדצימלי (פורמט 0x) או בפורמט בינארי גולמי.

QuoteMode

הגדרת התנהגות של הוספת מרכאות.

טיפוסים בני מנייה (enum)
ALL מקיף במירכאות את כל השדות.
ALL_NON_NULL מקיפים במירכאות את כל השדות שאינם null.
MINIMAL השדות שכוללים תווים מיוחדים כמו תו מפריד השדות, תו המירכאות או כל אחד מהתווים במחרוזת מפריד השורות.
NONE אף פעם לא מקיפים שדות במירכאות. אם מופיע תו הפרדה בנתונים, המדפסת מוסיפה לפניו את תו הבריחה. אם לא מגדירים תו בריחה, אימות הפורמט יגרום לחריגה.
NON_NUMERIC מקיפים במירכאות את כל השדות שאינם מספריים.

WriteHeaderMode

מגדירה את ההתנהגות של כתיבת הכותרת של קובץ ה-CSV.

טיפוסים בני מנייה (enum)
ALWAYS תמיד כותבים את הכותרת של קובץ ה-CSV.
NO לא כותב את הכותרת של קובץ ה-CSV.
YES הכותרת של קובץ ה-CSV נכתבת רק אם יש נתונים.