メインコンテンツにスキップ
Administrator Guide
最終更新: 2023-06-23
ソース CSV データの説明

ソース CSV データの説明

Workday Studio の
"PrismAnalytics"
コンポーネントには、ソース CSV データの説明が必要です。選択したツールで JSON テキストを作成し、後で Studio で使用することができます。例:
"write"
ステップの
"Message Builder"
タブで、テキスト メッセージに貼り付けます。
  1. 次の 2 つの主要ノードを含む JSON テキストを作成します。
    • parseOptions
      : CSV データのフォーマットに関する情報 (文字セットや区切り文字など)。
    • fields
      : CSV データの各フィールドに関する情報 (データ タイプやフォーマットなど)。
  2. 次の場所
    parseOptions
    ノード: 以下のフィールドを定義できます。
    フィールド名
    タイプ
    必須
    説明
    charsetName
    オブジェクト
    はい
    CSV データ ファイルの文字セット。例:
    "charset": { "id": "Encoding=UTF-8" }
    現在、Workday でサポートされているのは、UTF-8 エンコーディング形式のみです。データは最終的に Unicode 形式で保存されます。Unicode に相当する文字がない文字は、unicode の置換文字として保存されます。画像には、画像の説明: Unicode の背景に疑問符が使用されます。
    fieldsEnclosedBy
    文字列
    いいえ
    CSV データでフィールドを囲むために使用される文字。デフォルトは二重引用符です。フィールド内で二重引用符が使用されている場合は、その前に別の二重引用符を使用してエスケープします。例:
    "fieldsEnclosedBy": "\""
    fieldsDelimitedBy
    文字列
    はい
    CSV データのフィールド値を区切る文字です。例:
    "fieldsDelimitedBy": ","
    headerLinesToIgnore
    数値
    いいえ
    パーサーがヘッダーとして無視する行数。設定先
    0
    (CSV データにヘッダーがない場合)。例:
    "headerLinesToIgnore": 1
    type
    オブジェクト
    はい
    入力ファイルのタイプ。現在、Workday では区切りファイルのみがサポートされています。例:
    "type": { "id": "Schema_File_Type=Delimited" }
    この値では大文字と小文字が区別されます。区切り記号として大文字の D があることに注意してください。
  3. 次の場所
    fields
    ノード: 以下のフィールドを定義できます。
    フィールド名
    タイプ
    必須
    説明
    ordinal
    数値
    はい
    CSV データセット内のフィールドの順序 (インデックス)。序数値の条件は、以下のとおりです。
    • 先頭が 1 であること。
    • 連続していること。
    • 数値のスキップは不可。
    • 最大 1,000 まで入力できます。
    name
    文字列
    はい
    CSV データセット フィールドの名称。フィールド名の条件は、以下のとおりです。
    • データセット内で一意であること。
    • 最大 255 文字まで使用可能。
    • 英数字と下線文字のみ使用可能。
    • 先頭が文字であること。
    • 末尾に下線文字は使用不可。
    • WPA_ で始めることはできません。
    description
    文字列
    いいえ
    フィールドの説明。1000 文字以内で入力してください。例:
    "description": "The worker's full name."
    type
    オブジェクト
    はい
    フィールドのタイプ。次のオプションがあります。
    • テキスト
    • 数値
    • ブール値
    • 日付
    例:
    "type": { "id":"Schema_Field_Type=Date"}
    parseFormat
    文字列
    はい (日付タイプの場合)
    日付の形式。例:
    "parseFormat": "dd-MM-yy HH24:mm:ss"
    precision
    数値
    はい (数値タイプの場合)
    数値の最大桁数。小数点の左側と右側のすべての数値が含まれますが、小数点自体は含まれません。最大値は 38 です。例:
    "precision": 38
    scale
    数値
    はい (数値タイプの場合)
    数値の小数点の右側の桁数。未満でなければなりません
    precision
    値。例:
    "scale": 2
    defaultValue
    テキスト
    いいえ
    アップロード ファイルにフィールドに関する指定がない場合のフィールドのデフォルト値。
    二重引用符でデフォルトのテキスト値を表現します。例:
    “N/A”
    デフォルトの数値は、指定された値と一致している必要があります
    precision
    および
    scale
    デフォルトの日付値は、次の形式にしてください: yyyy-MM-dd'T'HH:mm:ss'Z'。
    required
    ブール値
    いいえ
    フィールドに値を含める必要があるかどうかを指定します。設定先
    True
    フィールドが必須の場合は ""。それ以外の場合は、"" に設定されます。
    False
    。フィールドが必須の場合、データの挿入、更新、挿入/更新のどの操作でも値をヌルにすることはできません。
    externalID
    ブール値
    はい (更新、更新/挿入、削除の操作を利用するため)。
    フィールドが外部 ID であるかどうかを指定します。設定先
    True
    外部 ID フィールドを指定するか、設定しないでください。
    False
    外部 ID フィールドはヌルにできないため、すべての外部 ID フィールドが必須になるように指定してください。外部 ID として指定できるフィールドは 1 つだけです。
    更新、更新/挿入、削除の機能を利用する場合は、新しいテーブルで外部 ID を指定します。
    既存のテーブルで更新、更新/挿入、削除の機能を使用するには、テーブルを変更して、外部 ID として指定された単一のフィールドを持つようにする必要があります。Prism 公開 API は、データを含むテーブルの変更をサポートしていません。そのような場合は、Workday で変更を行ってください。
ソース CSV ファイルには、以下のテーブルが記述されています。
社員
社員 ID
職務名
採用日
年間給与
Logan McNeil
21001
人事担当副社長
1/1/2010
213298.00
Oliver Reynolds
21003
最高情報責任者
1/1/2010
394935.00
Maximilian Schneider
21004
最高執行責任者 (COO)
1/1/2010
255373.00
Teresa Serrano
21005
会計監査役
1/1/2010
291785.00
次のような JSON を使用して説明します。
{ "parseOptions": { "fieldsDelimitedBy": ",", "fieldsEnclosedBy": "\"", "headerLinesToIgnore": 1, "charset": { "id": "Encoding=UTF-8" }, "type": { "id": "Schema_File_Type=Delimited" } }, "fields": [ { "ordinal": 1, "name": "Employee", "description": "Employee", "precision": 255, "scale": 0, "parseFormat": null, "type": { "id": "Schema_Field_Type=Text" } }, { "ordinal": 2, "name": "Employee_ID", "description": "Employee ID", "precision": 38, "scale": 0, "parseFormat": null, "type": { "id": "Schema_Field_Type=Numeric" } }, { "ordinal": 3, "name": "Job_Title", "description": "Job Title", "precision": 255, "scale": 0, "parseFormat": null, "type": { "id": "Schema_Field_Type=Text" } }, { "ordinal": 4, "name": "Hire_Date", "description": "Hire Date", "precision": 0, "scale": 0, "parseFormat": "MM/dd/yy", "type": { "id": "Schema_Field_Type=Date" } }, { "ordinal": 5, "name": "Annual_Salary", "description": "Annual Salary", "precision": 38, "scale": 2, "type": { "id": "Schema_Field_Type=Numeric" } } ], "schemaVersion": { "id": "Schema_Version=1.0" } }