データのエクスポートとインポート¶
Gem LogicではCSVやその他のファイル形式を使用して、データを一括でエクスポート・インポートできます。これは他システムからのデータ移行、一括更新、またはレポート生成に便利です。
参考
:doc:`data_migration`では、他システムからGem Logicへデータを移行する手順を段階的にご案内しています。
エクスポートとインポートのアクションは、ほとんどのリストビューの**Actions**メニューからご利用いただけます。
データのエクスポート¶
データをエクスポートするには、エクスポートしたいレコードのリストビュー(例:商品、連絡先、受注)に移動し、**アクション**メニューをクリックします。ダウンロードアイコンを選択してエクスポートダイアログを開きます。
エクスポート形式は複数から選択できます:
エクスポートされたファイルには、現在のフィルタに一致するすべてのレコードが含まれます。エクスポート前にフィルタを適用して、データを絞り込んでください。
エクスポート履歴¶
すべてのエクスポートは記録されます。対応するリストビューの から過去のエクスポートを確認できます。そこから、以前にエクスポートしたファイルを再ダウンロードできます。
データのインポート¶
データをインポートするには、リストビューに移動して をクリックします。これにより、CSVファイルをアップロードできるインポートダイアログが開きます。
空のテンプレートのダウンロード¶
インポートする前に、インポートダイアログから空のCSVテンプレートをダウンロードしてください。テンプレートは2つの形式で提供されています:
テンプレートには、2行のヘッダー行を持つすべての利用可能な列が含まれています:1行目は各フィールドの説明、2行目は内部フィールド名です。これらのヘッダー行を変更または削除しないでください。
3行目からデータを入力してください。不要な列は削除でき、必要に応じて並べ替えることもできます。
新規レコードの作成¶
新規レコードを作成するには、**id**列を空のままにしてください。Gem Logicは、インポート時に各新規レコードに自動的にIDを割り当てます。
既存レコードの更新¶
既存のレコードを更新するには、更新したいレコードの正しいデータベースIDを含む**id**列を含めてください。これらのIDは、まず既存のデータをエクスポートすることで取得できます。
id列に既存のレコードと一致する値が含まれている場合、Gem Logicは新しいレコードを作成する代わりに、CSV行の値でそのレコードを更新します。
ちなみに
一般的なワークフローは、まず既存のデータを**エクスポート**し、エクスポートされたファイル内で必要な値を変更してから、それを**再インポート**することです。エクスポートされたファイルにはデータベースIDが含まれているため、インポートは既存のレコードを更新します。
インポート履歴¶
すべてのインポートは記録されます。対応するリストビューの から過去のインポートを確認できます。各インポートエントリにはステータスが表示され、元のファイルや発生したエラーのレポートをダウンロードできます。
商品のインポート¶
商品のインポートは他のインポートと同じ一般的な流れに従います — 空のCSVテンプレート(USカンマ区切りまたはEUセミコロン区切り)をダウンロードし、行に入力して、 からファイルをアップロードします。
商品固有の2つの詳細:
既存の商品は ``id`` ではなく ``item_sku`` で照合されます。 行の
item_skuがGem Logicに既に存在する場合、その商品はその行の値で更新されます。新しいitem_skuまたは空のitem_skuを持つ行は新しい商品を作成します(フィールドを空白のままにすると、SKUが自動生成されます)。商品テンプレートの最初のヘッダー行は予約されており、変更または削除してはいけません。不要な列は削除でき、自由に並べ替えることができます。
アップロード後、各インポートのステータスは から確認でき、失敗した行のエラーレポートもダウンロードできます。
商品インポートにおける価格設定ルール¶
商品をインポートする際、各販売チャネルの価格設定は、3つのカラムが組み合わさったトリプルによって設定されます。
price— ルールで使用される金額(最終的な販売価格とは限りません)pricing_rule—priceから販売価格がどのように計算されるかsales_channel_price— この価格が適用される販売チャネル
各商品に対して最大 **5つのトリプル**(price、price_2 … price_5、それぞれに対応する pricing_rule_* と sales_channel_price_* を含む)を設定できます。空のトリプルは無視されます。
pricing_rule で許可される値¶
pricing_rule カラムは 次の4つの値のいずれか でなければなりません。それ以外の値を指定すると行が却下されます。
fixed_price— 販売価格はpriceそのものcost_multiplier— 販売価格は原価 × price``(ここで ``原価は商品の金属、宝石、部品の原価の合計)price_per_carat— 販売価格はprice × 商品の宝石の総カラット重量cost_based— 販売価格は商品の原価と等しく、priceは無視されます
トリプルの適用方法¶
priceが設定されていてsales_channel_priceが 空 の場合、ルールと金額はその商品の すべての販売チャネル に適用されます。priceとsales_channel_priceの両方が設定されている場合、ルールと金額は その販売チャネルのみ に適用されます。追加のチャネルには2番目と3番目のトリプルを使用します。priceが空の場合、pricing_ruleやsales_channel_priceを入力していても、そのトリプルに対する価格変更は行われません。
価格を更新するための再インポート¶
既存の商品を再インポートする場合:
空の
pricing_ruleは、新規商品でも既存商品の更新時でも、常にルールをfixed_priceに設定します。別のルール(cost_multiplierやprice_per_caratなど)を維持したい場合は、pricing_ruleカラムにその値を入力してください。
インポート後、Gem Logicはルールに基づいて各販売チャネルの販売価格を自動的に再計算するため、通常の価格カラムを入力する必要はありません。
対応レコードタイプ¶
以下のレコードタイプがエクスポートとインポートに対応しています。
属性
ブランド
カテゴリー
鑑定書
コレクション
連絡先
顧客からの買取
メールアドレス
メールテンプレート
ギフトカード
仕入請求書とクレジットノート
素材
メモとメモ明細
売上請求書とクレジットノート
商品
プロジェクト
見積書と見積明細
修理と修理明細
販売と販売明細
出荷
保管場所
仕入先注文
タスク
取引