T ログ・データの転送

トランザクション・ログ (T ログ) データ・タイプは、需要の判別に役立つトランザクションの売上履歴を収集します。 需要予測は、オーダーの履行に必要な在庫レベルを判別するのに役立ちます。 トランザクション・ログ・データは、在庫のパフォーマンス・コストを計算するために使用されます。これには、在庫切れの可能性の見積もりや重要指標の予測速度などが含まれます。

手順

  1. トランザクション・ログ .csv ファイルを作成するには、以下の手順を実行する：
    1. ファイル名には、 TLOG_[CUSTOMER NAME]_YYYYMMDDHHMISS.csv 形式を使用します。
    2. 区切り文字にはカンマ（,）を使う。
    3. 複数の .csv ファイルを tar.gz ファイルに圧縮してアップロードします。
  2. CSVファイルのカラムのフィールドと同じ順序で、データ型テーブルに示されたフィールドの順序に従わなければなりません。 たとえば、Item IDがデータ型テーブルで定義されている最初のフィールドである場合、CSVファイルのカラムでも同じ順序に従わなければなりません。 トランザクション・ログ・データについて、以下のフィールドと説明を確認する：
    表 1. トランザクション・ログ・データの説明
    順序 フィールド名 必須 タイプ 説明
    1秒. アイテム ID はい STRING トランザクションの項目。
    2 アイテム単位 いいえ STRING 部品の計測単位。 有効な値は、 「Each」、 「Pallet」 、および 「Pound」です。 デフォルトの計測単位は 「各」です。
    3 アイテム・クラス いいえ STRING アイテムのクラス。
    4 出荷ノード はい STRING トランザクションが実行されたノード。
    5 トランザクション番号 はい INTEGER トランザクションを識別するための番号。
    6. トランザクション・ワークステーションID はい INTEGER トランザクションが実行されたワークステーション。
    < トランザクション日 はい STRING トランザクションの更新が発生した日付（YYYY-MM-DDTHH:MI:SS）。

    Date TimeStampはISO 8601の日付時刻フォーマットでなければなりません。
    8. トランザクション・シーケンス番号 はい INTEGER トランザクションを識別する固有のシーケンス番号。
    9. トランザクション行シーケンス番号 はい INTEGER トランザクション内のシーケンス番号。
    10. トランザクション数量 はい DECIMAL トランザクションで販売されているアイテムの数量。
    11. トランザクション・タイプ はい STRING トランザクションのタイプ。 トランザクションのタイプには、以下のオプションがあります。
    • SALE: 通常の売上としてスキャンするすべてのアイテム。
    • RETN: 返されたすべてのアイテム。
    • EXCH: 交換されるすべての項目。
    • ADJU: 割引やギフト・カードなど、明細に対して発生する調整。
    12. トランザクション項目の状況コード はい STRING 部品とノードのペアの状況コード。 状況コードには、以下のオプションが含まれます。
    • ACTIVE: アクティブ
    • PROMO: プロモーション中
    • MKDOWN: マークダウン時
    • DISCONT: 廃止
    13. 取引合計小売金額 はい DECIMAL 税金を除く、ディスカウントなしの通常取引の小売価格の合計。
    14. ディスカウント付きのトランザクション合計小売金額 はい DECIMAL 税金を含まない、割引付きのトランザクションの合計価格。
    15. トランザクション合計請求金額 はい DECIMAL このトランザクションに対して顧客に請求された合計金額 (顧客固有の割引を含み、税金は含まれません)。
    16. 拡張トランザクション・コード いいえ STRING 注文がどのように履行されたかを示すオムニチャネル・フルフィルメント・コード。 フルフィルメント・コードには、以下のオプションが含まれます。
    • 店舗からの出荷
    • オンラインで購入
    • ストア
    17. トランザクション通貨 いいえ STRING アイテム合計に関連付けられている通貨。 この値は、3 文字の ISO 通貨形式 (USD、GBP、EUR など) でなければなりません。
  3. 次のサンプル.csvファイルを確認してください：
    
item_id,item_uom,item_class,ship_node,transaction_number,transaction_workstation_id,transaction_update_ts,transaction_sequence_number,transaction_line_sequence_number,transaction_quantity,transaction_type, transaction_item_status_code,transaction_total_retail_amount,transaction_total_retail_amount_with_discount,transaction_total_charged_amount,extension_tlog_code,transaction_currency
sku_122,EACH,GOOD,111,1,2478,2018-01-30T18:12:00.000Z,00999,2,1,SALE,MKDOWN,49.95,13.98,13.98,SFS,USD
sku_877,EACH,GOOD,222,6,2112,2018-01-30T18:47:00.000Z,00333,1,1,SALE,ACTIVE,15.95,6.00,6.00,SFS,USD
sku_747,EACH,GOOD,333,1,3344,2018-01-30T16:45:00.000Z,87878,1,-1,RETN,ACTIVE,6.95,-6.95,-6.95,SFS,USD
  4. 特に のみ IBM Cloud® Object Storage を対象に、以下のいずれかの方法を使用してトランザクションログデータをアップロードしてください。
    • IBM Cloud Object Storageの<Input_Prefix>/UPLOAD/TLOG/仮想フォルダにファイルを1つアップロードします。
    • ローカルディレクトリからすべてのファイルをIBM Cloud Object Storage上の<Input_Prefix>/UPLOAD/TLOG/仮想フォルダにアップロードします。
  5. 例えば、ファイル形式を熟知する：
    • 元のファイルが2024-01-01-10-59-00.0000-3423-Availability.csvという名前なら、わかりやすくするために、このファイルを<myfilename>.csvと呼ぶかもしれない。
    • データ行の処理に失敗した場合、以下のerror row.csvとerror summary.txtファイルを受け取る：
      <myfilename>_file_failed_row.csv. for the error rows only (all successful are not present here)
<myfilename>_file_failure_reason.txt are the summary file which provides the error code. Sterling Intelligent Promising automatically creates a prefix to store processed files based on their current state which includes:
      ファイルは、処理できないオリジナルのインジェスト記録であるerror row.csv ファイルには、処理に失敗した理由が書かれているerror summary.txt
  6. Sterling Intelligent Promising自動的に作成される接頭辞を理解し、以下の現在の状態に基づいて処理されたファイルを保存する：
    /completed
    処理が完了したすべてのファイル。 完了したファイルを定期的にクリーンアップし、IBM Cloud Object Storageのストレージ要件を最小限に抑えることが重要である。
    /summary
    実行中に発生したエラーを記述したデータ取り込み要約ファイル。 このサマリーファイルは、処理に失敗したファイルと一緒に使用することで、エラーコードと失敗の理由を理解するのに役立つ。

例

データ取り込みシステムが生成する接頭辞のサンプルは以下の通り：
  • /completed/<Input_Prefix>/sip-tlog/myinput
  • /summary/<Input_Prefix>/sip-tlog/myinput