הגדרות CSV

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

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

CsvConfiguration

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

ייצוג ב-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)
}
שדות
null_representation

string

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

enum (WriteHeaderMode)

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

string

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

string

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

string

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

string

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

boolean

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

string

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

string

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

boolean

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

string

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

string

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

enum (BinaryDataEncoding)

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

string

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

string

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

enum (QuoteMode)

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

WriteHeaderMode

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

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

BinaryDataEncoding

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

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

QuoteMode

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

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