カテゴリーツリーのエクスポートとインポート
エクスポートはカテゴリーツリーのスプレッドシートのスナップショットを作成します。インポートはファイルを検証し、プレビューを表示し、保存を押したときにのみ変更を適用します。
概要
エクスポートインポートは、スプレッドシートファイルを使ってカテゴリーツリーを更新するための管理されたワークフローです。エクスポートは現在のツリーからファイルを生成し、明確なスナップショットを作成します。インポートはそのファイルを読み込み、検証し、結果のプレビューを生成して、変更が適用される前に結果を確認できます。プレビューを確認した後、保存を押して変更を適用します。この方法は慎重な変更、バックアップ、および構造の意図的な再利用のために設計されています。
使用するタイミング
大きな変更を行う前に現在のカテゴリーツリーをバックアップする
ExcelやGoogle Sheetsなどのスプレッドシートエディタで一括編集を行う
古いエクスポートファイルをインポートして以前の構造を復元またはロールバックする
ストアAから意図的にエクスポートし、ストアBにインポートして構造を再利用する
仕組み
エクスポートは現在のカテゴリーツリーに基づいてスプレッドシートファイルを作成します。スプレッドシートエディタで編集し、インポートを使ってアップロードできます。インポートはファイルを検証し、結果のツリーのプレビューを表示します。プレビュー中は何も適用されません。保存を押したときにのみアプリが変更を適用します。
ステップバイステップ
現在のツリーをエクスポートする
1. アプリのカテゴリーツリーページを開きます。
2. 正しいストアとワークスペースにいることを確認します。
3. エクスポートをクリックします。
4. スプレッドシートファイルをコンピュータにダウンロードします。
5. 編集する前にエクスポートしたファイルをバックアップとして保持します。
6. 編集する場合は、エクスポートしたファイルのコピーを作成してコピーで作業します。
スプレッドシートで安全に編集する
1. 元の列ヘッダーは変更しないでください。
2. IDの値は変更しないでください。
3. DISPLAY NAMEやPATH IN TREEなど理解しているフィールドのみ編集してください。
4. コレクションごとに1行を使用し、行を重複させないでください。
5. PATH IN TREEを編集するときは、ルールと検証で説明されているIDベースの形式を使用してください。
6. PATH IN TREEのIDの前後に余分なスペースを追加しないでください。
7. ノードの順序を変更する場合は、検証が親を解決できるように親の行を残してください。
8. ファイルをサポートされているスプレッドシート形式で保存し、シート名を変更しないでください。
インポートとプレビュー
1. アプリのカテゴリーツリーページに戻ります。
2. インポートをクリックします。
3. 編集したスプレッドシートファイルを選択します。
4. アプリがファイルを検証するのを待ちます。
5. プレビューツリーを確認し、構造が正しいことを確認します。
6. 検証エラーが表示された場合は、ファイルを修正して再度インポートしてください。
変更を適用する
1. プレビューで結果に満足していることを確認します。
2. 保存を押してプレビューされた変更を適用します。
3. 保存処理が完了するのを待ちます。
4. ページを更新し、現在のツリーがプレビューと一致していることを確認します。
ルールと検証
インポートはプレビューを生成する前にスプレッドシートファイルを検証します。以下のルールはPATH IN TREEの最低要件とノード間の関係を説明しています。
PATH IN TREEは/で始まらなければなりません
例：/100は有効です。100は無効です。
パスの最後のIDは行自身のIDでなければなりません
例：IDが200の行の場合、PATH IN TREEは/200で終わる必要があります。
パス内のすべての親IDはこのファイルに存在しなければなりません
例：PATH IN TREEが/100/200の場合、IDが100と200の行が存在する必要があります。
コレクションは同時に1つの親のみ持つことができます
例：ID 200 は、同じインポートファイル内で異なる2つの親の子として現れることはできません。
ループ（循環参照）を作成しないでください
例：100 が 200 の親である場合、200 はツリー内のどのパスでも 100 の親になることはできません。
簡単な例
よくあるエラーと修正方法
親が見つからない
症状：検証に失敗し、プレビューが生成できません。
考えられる原因：PATH IN TREE の親IDがファイル内の行として存在しません。
修正方法：不足している親の行を追加するか、PATH IN TREE を既存の親を参照するように更新してください。
循環参照
症状：循環参照のメッセージで検証に失敗します。
考えられる原因：PATH IN TREE がノード自身を祖先にするループを作成しています。
修正方法：PATH IN TREE を編集し、階層が親から子へ厳密に一方向でループがないようにしてください。
重複ID
症状：検証に失敗し、重複IDが報告されます。
考えられる原因：同じIDが複数の行やシートに現れています。
修正方法：IDごとに1行だけ残し、重複を削除してからインポートしてください。
無効なパス形式
症状：PATH IN TREE の形式が原因で検証に失敗します。
考えられる原因：PATH IN TREE が / で始まっていない、またはIDが期待される部分に数字以外のセグメントが含まれています。
修正方法：IDベースの形式を使用し、PATH IN TREE が / で始まることを確認してください。
存在しないコレクションID
症状：プレビューにノードが欠けている、または検証で不明なIDが報告されます。
考えられる原因：ファイルに現在のストアに存在しないコレクションIDが含まれています。
修正方法：現在のストアから再度エクスポートし、新しいエクスポートファイルに編集を再適用してください。
複数の親
症状：検証に失敗するか、プレビューに予期しない構造が表示されます。
考えられる原因：同じIDが異なる親の下に複数の行やシートで配置されています。
修正方法：各ノードがツリー内で正確に1箇所に現れ、そのIDに対して単一のPATH IN TREEを保持してください。
安全上の注意
インポートは保存を押すまでプレビューのみを作成します。
編集を開始する前にバックアップをエクスポートしてください。
以前のエクスポートファイルをインポートして保存を押すことで復元できます。
よくある質問
はい。変更を適用する前にバックアップをエクスポートしてください。元に戻す必要がある場合は、バックアップファイルをインポートし、プレビューを確認してから保存を押してください。
いいえ。IDは行とコレクションを一致させるために使用されます。IDは変更しないでください。
いいえ。このファイルはアプリで使用されるカテゴリーツリー構造と関連フィールド用です。Shopifyのコレクション名を変更するものではありません。
インポートのワークフローは、タイトルやハンドルなどのShopifyコレクションの基礎データを変更しません。アプリ内のカテゴリーツリー内でのコレクションの配置を更新します。
はい。ストアAから意図的にエクスポートし、ストアBにインポートする場合です。対象ストアにはファイル内のIDで参照されるコレクションが存在している必要があります。
PATH IN TREE を更新して希望の並び順と親子関係を反映させ、インポートしてプレビューを確認し、保存を押してください。
アプリはプレビューを生成しません。エラーの詳細に基づいてスプレッドシートファイルを修正し、再度インポートしてください。
UIマイクロコピー
インポートダイアログ本文テキスト
スプレッドシートファイルをアップロードして検証し、プレビューを生成します。プレビューを確認して保存を押すまで変更は適用されません。
プレビュースクリーンのヒント
プレビューを注意深く確認し、変更を適用するには保存を押してください。