カタログ項目データの転送

カタログ項目取り込み機能は、外部システムからSterling Intelligent Promisingのカタログに項目データを転送する。 無効な入力は.csvファイルとしてアップロードされ、エラーに対処されます。

始める前に

モデルアイテムがある場合は、それらは個別の .csv ファイルで取り込まれる必要があります。 次に、それらが取り込まれた後、別の .csv ファイル内の子アイテムから参照することができます。

このタスクについて

カタログ・サービスAPIを使用してカタログ・データを管理している場合は、カタログ項目データをアップロードする必要はありません。

以下のことに注意することが重要である：
  • ファイル転送アダプタを使用して、指定された形式の.csvアイテムデータをアップロードし、必要な情報を利用できるようにします。
  • primaryInformation、inventoryInformation、inventoryInformationTag、codeフィールドなどのデータには、.csvアップロードを使用します。
  • アイテムを削除したり、カテゴリー、属性、コンポーネントを管理したい場合は、適切なREST APIを使用できます。
  • .csvファイルで処理される項目の順序が、ファイル内の項目の順序と異なる場合があります。
  • 副次的なオプションとして、APIリクエストを使ってカタログ項目の管理を行うことができる。 Sterling Intelligent Promising 外部システムからのデータ取り込みを.csvファイルを使用して可能にします。

アップロードされた.csvファイル内の無効な項目データ

アップロードされた.csvアイテムのデータが検証されます。 しかし、.csvファイル内の無効なデータ項目については、itemId、unitOfMeasure、および検証エラーの説明がIBM Cloud® Object Storageに公開されます。 アップロードされたアイテムに無効な入力が含まれている場合に備えて、.csvファイルの無効アイテムリストは<Input_Prefix>/itemIngestValidateFailureの仮想フォルダIBM Cloud Object Storageからダウンロードできます。

手順

  1. .csv ファイルを作成するには、以下の手順を実行する：
    1. ファイル名は、.csv形式で適切な命名をしてください。 例えば、<tenantId>_Items_20240531010101.csv。
    2. 区切り文字にはカンマ（","）を使う。
    3. 複数の .csv ファイルを tar.gz ファイルに圧縮してアップロードします。
  2. データ型テーブルに示されたフィールドの順番に従って、CSVファイルのカラムのフィールドも同じ順番にする必要があります。 たとえば、Item IDがデータ型テーブルで定義されている最初のフィールドである場合、CSVファイルのカラムでも同じ順序に従わなければなりません。 カタログ項目の取り込みデータについて、以下のフィールドと説明を確認する

順序 フィールド名 必須 タイプ 説明
1秒. itemId はい ストリング データ取り込みのためのアイテムID。
2 unitOfMeasure はい ストリング アイテムの数量に関する単位。
3 itemGroupCode いいえ ストリング アイテムが商品であるかどうかを示す。
注意: PRODタイプのみサポート。
4 globalItemId いいえ ストリング アイテムの相互参照に使用される一意のグローバル識別子。
5 allowGiftWrap いいえ ストリング ギフト包装が可能な商品。 有効な値は、 TRUE 、FALSE （または空白）です。
6. assumeInfiniteInventory いいえ ストリング 常に入手可能であることが前提のアイテム。 有効な値は、TRUE 、FALSE （または空白）です。
< isAirShippingAllowed いいえ ストリング 航空便で輸送できるもの。 有効な値は、 TRUE 、FALSE （または空白）です。
8. isDeliveryAllowed いいえ ストリング 配達を可能にするアイテム。 有効な値は、 TRUE 、FALSE （または空白）です。
9. isForwardingAllowed いいえ ストリング ゾーンスキップのために転送できる項目。 有効な値は、 TRUE 、FALSE （または空白）です。
10. isFreezerRequired いいえ ストリング 輸送に冷凍庫を必要とするもの。 有効な値は、 TRUE 、FALSE （または空白）です。
11. isHazmat いいえ ストリング 危険物を含む物品。 有効な値は、 TRUE、FALSE（または空白）です。
12. isModelItem いいえ ストリング バリエーションを持つアイテム。 有効な値は、 TRUE 、FALSE、または空白です。
13. isParcelShippingAllowed いいえ ストリング 宅配便で発送できる商品。 有効な値は、 TRUE 、FALSE （または空白）です。
14. isPickupAllowed いいえ ストリング ピックアップが許可されているアイテム。 有効な値は、 TRUE 、FALSE （または空白）です。
15. isProcurementAllowed いいえ ストリング 調達可能な品目。 有効な値は、 TRUE 、FALSE （または空白）です。
16. isReturnable いいえ ストリング 返品可能な商品。 有効な値は、 TRUE、FALSE（または空白）です。
17. isShippingAllowed いいえ ストリング 発送が可能な商品。 有効な値は、 TRUE 、FALSE （または空白）です。
18. substitutionAllowed いいえ ストリング 代用可能なアイテム。 有効な値は、 TRUE、FALSE（または空白）です。
19. taxable いいえ ストリング 課税対象品目。 有効な値は、 TRUE 、FALSE （または空白）です。
20. bundleFulfillmentMode いいえ ストリング バンドルがどのように履行されるかを示す。
  • 単独で発送する場合は、コード00を使用してください。
  • 同梱の場合は、コード01をご利用ください。
  • 一緒にお届けする場合は、コード02をご利用ください。
21. colorCode いいえ ストリング アイテムのカラーコード。
22. costCurrency いいえ ストリング 商品原価を定義する通貨。
23. countryOfOrigin いいえ ストリング 商品の製造国。
24. defaultProductClass いいえ ストリング 商品のデフォルトの商品クラス。
25. description いいえ ストリング 製品の説明。
26. effectiveEndDate いいえ dateTime YYYY-MM-DDThh:mm:ss.SSSZの形式で、その項目が有効である期限。
27. effectiveStartDate いいえ dateTime 項目が有効な開始日を YYYY-MM-DDThh:mm:ss.SSSZ の形式で指定します。
28. extendedDescription いいえ ストリング アイテムの拡張複数行説明。
29. extendedDisplayDescription いいえ ストリング アイテムの説明を表示します。
30. itemType いいえ ストリング アイテムの一般的なタイプ。
31. keywords いいえ ストリング アイテムに関連付けるキーワードを指定します。
32. kitCode いいえ ストリング アイテムのキットコード。 BUNDLEはバンドルアイテムを示す。 LKは論理キット項目を示す。 PKはフィジカルキットを示す。 DPKはダイナミック・フィジカル・キットを示す。
33. manufacturerDescription いいえ ストリング 商品のメーカーによる説明。
34. manufacturerItemId いいえ ストリング メーカーが品目を識別するために使用する識別子。
35. manufacturerName いいえ ストリング 商品の製造元。
36. masterCatalogId いいえ ストリング このアイテムが属するマスター電卓ID。
37. maxOrderQty いいえ 二重 最大注文数量。
38. minOrderQty いいえ 二重 最小発注量。
39. minReturnWindow いいえ ロング 返品を受け付ける可能性のある最短日数。
40. returnWindow いいえ ロング 返品を受け付けない可能性のある日数。
41. shipmentConsolidationWindow いいえ ロング その品目が1つの出荷に統合されるのを遅らせることができる日数。
42. modelItemId いいえ ストリング このアイテムが属するバリエーションを持つ固有の itemId
43. modelItemUnitOfMeasure いいえ ストリング ばらつきのある品目の単位。
44. primaryEnterpriseCode いいえ ストリング アイテムに関連する主要企業。
45. primarySupplier いいえ ストリング その品目の主要サプライヤー。
46. productLine いいえ ストリング アイテムに関連する製品ライン。
47 shortDescription いいえ ストリング アイテムの簡略説明。
48. sizeCode いいえ ストリング 商品のサイズコード。
49. status いいえ 整数 アイテムのステータス
  • 2000は保有状況。
  • 3,000ドルは公表されたステータス。
50. unitCost はい 二重 ある商品の1単位の値段。
51. unitHeight はい 二重 アイテムの1単位の高さ。
52. unitLength はい 二重 アイテムの1単位の長さ。
53. unitWidth はい 二重 アイテムの1単位の幅。
54. unitWeight はい 二重 商品の1単位の重量。
55. unitHeightUOM はい ストリング アイテムの高さの単位。
56. unitLengthUOM いいえ ストリング アイテムの長さの単位。
57. unitWeightUOM いいえ ストリング 品目の重さの単位。
58. unitWidthUOM いいえ ストリング アイテムの幅を表す単位。
59. imageUrl いいえ ストリング アイテムURL。
60. advanceNotificationTime いいえ ロング 発送ノードへの注文発送の連絡は、最大でも発送予定日の何日か前に行われます。
61. timeSensitive いいえ ストリング 一刻を争うもの。 有効な値は、 TRUE 、FALSE （または空白）です。
62. fifoTracked いいえ ストリング 先入先出法で追跡される品目。 有効な値は、 TRUE 、FALSE （または空白）です。
63. itemBasedAllocationAllowed いいえ ストリング 項目ベース配分プロセスが許可されている項目。 有効な値は、 TRUE 、FALSE （または空白）です。
64. useUnplannedInventory いいえ ストリング 未計画在庫の使用が許可されているアイテム。 有効な値は、 TRUE 、FALSE （または空白）です。
65. tagControlled いいえ ストリング タグで管理されているアイテム。
  • Yは、inventoryTagInformationのケースを渡す必要がある場合、その項目が常にタグ制御されていることを示します。
  • Nはタグが制御されていないことを示す。
  • Sはタグが制御されている場合があることを示す。
66. leadTime いいえ ロング 製品が届くまでのリードタイム。
67. maxNotificationTime いいえ 二重 発送ノードへの注文発送の連絡は、最大でも発送予定日の発送暦時間以上前に行われます。
68. minNotificationTime いいえ 二重 発送の連絡は、遅くとも発送予定日の何日前までに行われる。
69. onhandSafetyFactorQty いいえ 二重 実際の手持ち在庫から除外される数量。
70. onhandSafetyFactorPercentage いいえ 二重 実際の手持ち在庫から除外される割合。
71. futureSafetyFactorPercentage いいえ 二重 その品目の実際の将来の入手可能性から除外される数量。
72. defaultExpirationDays いいえ ロング アイテムの有効期限が切れるデフォルトの日数。
73. processingTime いいえ ロング 特別サービスの処理にかかる日数。
74. batchNo いいえ ストリング タグ識別子またはタグ記述子として使えるbatchNo。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
75. lotAttribute1 いいえ ストリング タグ識別子またはタグ記述子として使えるlotAttribute1。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
76. lotAttribute2 いいえ ストリング タグ識別子またはタグ記述子として使えるlotAttribute2。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
77. lotAttribute3 いいえ ストリング タグ識別子またはタグ記述子として使えるlotAttribute3。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
78. lotKeyReference いいえ ストリング タグ識別子またはタグ記述子として使えるlotKeyReference。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
79. lotNumber いいえ ストリング タグ識別子またはタグ記述子として使えるlotNumber。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
80. manufactureDate いいえ ストリング タグ識別子またはタグ記述子として使えるmanufactureDate。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
81. revisionNo いいえ ストリング revisionNoがタグ識別子またはタグ記述子として使えるかどうかを示します。 有効な値は
  • 01 - タグ記述子として使用する。
  • 02 - タグ識別子として使用
  • 03 - 使用しないでください。
82. commodityCode いいえ ストリング 商品の商品コード。
83. eccnNo いいえ ストリング 商品のECCN番号。
84. harmonizedCode いいえ ストリング 品目の調和コード。
85. hazmatClass いいえ ストリング 品目の危険物分類コード。
86. naicsCode いいえ ストリング 品目のNAICSコード。
87. nmfcClass いいえ ストリング アイテムの NMFC コード。
88. nmfcCode いいえ ストリング アイテムのNMFCコード。
89. pickingType いいえ ストリング アイテムのタイプコードをピッキングする。
90. postingClassification いいえ ストリング 品目の掲示区分。
91. scheduleBcode いいえ ストリング アイテムのスケジュールBコード。
92. storageType いいえ ストリング アイテムの保管タイプコード。
93. taxProductCode いいえ ストリング 商品の税商品コード。
94. unspsc いいえ ストリング 商品のUNSPSCコード。
95. velocityCode いいえ ストリング ベロシティコード。

  1. 次のサンプル.csvファイルを確認してください：
    itemId,unitOfMeasure,itemGroupCode,globalItemId,allowGiftWrap,assumeInfiniteInventory,isAirShippingAllowed,isDeliveryAllowed,isForwardingAllowed,isFreezerRequired,isHazmat,isModelItem,isParcelShippingAllowed,isPickupAllowed,isProcurementAllowed,isReturnable,isShippingAllowed,substitutionAllowed,taxable,bundleFulfillmentMode,colorCode,costCurrency,countryOfOrigin,defaultProductClass,description,effectiveEndDate,effectiveStartDate,extendedDescription,extendedDisplayDescription,itemType,keywords,kitCode,manufacturerDescription,manufacturerItemId,manufacturerName,masterCatalogId,maxOrderQty,minOrderQty,minReturnWindow,returnWindow,shipmentConsolidationWindow,modelItemId,modelItemUnitOfMeasure,primaryEnterpriseCode,primarySupplier,productLine,shortDescription,sizeCode,status,unitCost,unitHeight,unitLength,unitWidth,unitWeight,unitHeightUOM,unitLengthUOM,unitWeightUOM,unitWidthUOM,imageUrl,advanceNotificationTime,timeSensitive,fifoTracked,itemBasedAllocationAllowed,useUnplannedInventory,tagControlled,leadTime,maxNotificationTime,minNotificationTime,onhandSafetyFactorQty,onhandSafetyFactorPercentage,futureSafetyFactorPercentage,defaultExpirationDays,processingTime,batchNo,lotAttribute1,lotAttribute2,lotAttribute3,lotKeyReference,lotNumber,manufactureDate,revisionNo,commodityCode,eccnNo,harmonizedCode,hazmatClass,naicsCode,nmfcClass,nmfcCode,pickingType,postingClassification,scheduleBcode,storageType,taxProductCode,unspsc,velocityCode

pen,EACH,PROD,GTIN1,TRUE,FALSE,TRUE,TRUE,FALSE,FALSE,TRUE,FALSE,TRUE,TRUE,FALSE,FALSE,TRUE,FALSE,TRUE,,RED,USD,US,,ballpoint pen,2030-09-09T01:01:01.001Z,2024-05-09T01:01:01.001Z,red color ballpoint pen,,,,,,,,,20,2,1,1,2,,,,,,pen,,3000,10,1,4,1,1,inch,inch,gram,inch,http://image/item/1,,FALSE,FALSE,FALSE,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,

book,EACH,PROD,GTIN2,TRUE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,TRUE,TRUE,TRUE,TRUE,TRUE,TRUE,FALSE,,,USD,US,,notebook,2030-09-09T01:01:01.001Z,2024-05-09T01:01:01.001Z,notebook for students,,,,,,,,,5,3,1,1,2,,,,,,book,,3000,6,1,8,7,1,inch,inch,gram,inch,http://image/item/2,,FALSE,FALSE,FALSE,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
  2. 特に のみ IBM Cloud Object Storage を対象に、以下のいずれかの手順を完了してください：
    • IBM Cloud Object Storageの<Input_Prefix>/UPLOAD/ITEM/ virtual folderにファイルを1つアップロードします。
    • ローカルディレクトリからIBM Cloud Object Storage上の<Input_Prefix>/UPLOAD/ITEM/ virtual folderにすべてのファイルをアップロードします。
  3. 例えば、ファイル形式を熟知する：
    • 元のファイルが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
  4. Sterling Intelligent Promising自動的に作成される接頭辞を理解し、以下の現在の状態に基づいて処理されたファイルを保存する：
    /failed
    処理に失敗した行は、ダウンロードとレビューのためにファイルに保存されるCSV 監視プロセスの一環として、この接頭辞に置かれたファイルを確認する必要があります。 その後、失敗を修正し、入力ストリームで再処理のために行を再送信しなければならないCSV
    /reprocessed
    接続性の問題で再処理のキューにあるファイル。 このプレフィックスには何もする必要はない。 Any files that are stored in the reprocessing prefix temporarily are retired automatically inSterling Intelligent Promising. データを処理するために、より多くのアクションは必要ない。
    /completed
    処理が完了したすべてのファイル。 完了したファイルを定期的にクリーンアップし、IBM Cloud Object Storageのストレージ要件を最小限に抑えることが重要である。
    /summary
    実行中に発生したエラーを記述したデータ取り込み要約ファイル。 このサマリーファイルは、処理に失敗したファイルと一緒に使用することで、エラーコードと失敗の理由を理解するのに役立つ。

例

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

設定されているルールによっては、sip-catalogの代わりにsip-data-captureが含まれることもある。