インポートとエクスポートの構成

学習の目的

この単元を完了すると、次のことができるようになります。

• Commerce B2C 管理者がインポート/エクスポートを実行するために必要な 3 種類の許可を挙げる。
  
• インポートプロセスの基本的な手順を 3 つ挙げる。
  
• エクスポートプロセスの基本的な手順を 3 つ挙げる。
  
• サイトのインポート/エクスポートの目的を説明する。
  
• 転送の制限に対処する 2 つの方法を説明する。
  

この単元では、インポート/エクスポートプロセスを構成して実行する方法を学習します。Commerce B2C 管理者はさまざまなインポート/エクスポートプロセスを担当していますが、この単元ではカタログのインポートと注文のエクスポートに焦点を当てます。

インポートとエクスポートを構成するには、次のアクセス許可が必要です。

• サイトのインポート/エクスポート (すべてのサイト情報を含む)
  
• ストアフロント情報 (商品やコンテンツなど) のインポート/エクスポート
  
• サーバー上のログファイルやインポート/エクスポートディレクトリへの WebDAV アクセス
  

また、デベロッパーが提供する FTPClient スクリプトを使用できるよう、Agentforce Commerce for B2C サポートに FTP ポートへのアクセス権を申請する必要があります。

カタログのインポート

まず、Business Manager で手動のインポート/エクスポートプロセスを実行します。いずれはデベロッパーと協力して、標準パイプレットを使用するプロセスを作成する予定です。こうしたパイプレットは、大量のデータセットを簡単に処理し、迅速で信頼性が高く、システムリソースを効率的に使用します。また効率性を高めるために、ファイル転送とインポート/エクスポートの両方を目的とするバッチジョブも作成する予定です。現時点では、手動のプロセスで十分です。

商品データを含むカタログをインポートするには、このモジュールの最初の単元で説明したように、catalog.xsd 形式を使用して PIM システム上でカタログファイルを作成し、圧縮します。

後続の手順は次のとおりです。

このモジュールでは、受講者が B2C Commerce の管理者で、次のタスクを実行する適切な権限を有しているものと想定しています。ただし、B2C Commerce 管理者でなくても大丈夫です。このまま読み進み、管理者がこれらの手順をどのように実行するのかを見てみましょう。Trailhead Playground で以下の手順を実行しないでください。この機能は Trailhead Playground では使用できません。

1. Business Manager で [App Launcher (アプリケーションランチャー)] をクリックし、[Merchant Tools (マーチャントツール)] | [Products and Catalogs (商品とカタログ)] | [Import & Export (インポート & エクスポート)] を選択します。
   
2. [Import and Export Files (インポートファイルとエクスポートファイル)] セクションで、[Upload (アップロード)] をクリックします。
   

3. [Choose File (ファイルを選択)] をクリックします。
   
4. ファイルを選択します。
   
5. [Upload (アップロード)] をクリックします。
   

6. Business Manager がファイルを展開します。
   
7. [Back (戻る)] をクリックします。
   
8. [Catalogs (カタログ)] セクションで、[Import (インポート)] をクリックします。
   

9. カタログのインポートで、インポートするファイルを選択し、[Next (次へ)] をクリックします。
   
10. Business Manager でファイルが検証され、ファイル分析が表示されます。インポートを進める前にこの分析をチェックして、必要な情報が Business Manager で認識されていることを確認します。
    
11. [Next (次へ)] をクリックします。
    
12. マージインポートモードを選択します。
    

注文のエクスポート

外部の注文管理システム (Order Management System (OMS)) で処理するために、注文をエクスポートします。エクスポートファイルはインポートと同じスキーマ定義を使用します。Business Manager は自動的に XML ファイルを作成します。

注文をエクスポートする手順は、次のとおりです。

1. Business Manager で [App Launcher (アプリケーションランチャー)] をクリックし、[Merchant Tools (マーチャントツール)] | [Ordering (注文)] | [Import & Export (インポート & エクスポート)] を選択します。
   
2. [Export (エクスポート)] をクリックします。
   
3. エクスポートする注文を選択し、[Next (次へ)] をクリックします。
   
4. [Export Selected Orders (選択した注文のエクスポート)] を選択します。
   
5. ファイル名を入力します。
   
6. [Update Order Export Status and Inventory (注文のエクスポートステータスと在庫の更新)] を選択します。
   
7. [Export (エクスポート)] をクリックします。
   
8. [Import and Export Files (インポートファイルとエクスポートファイル)] セクションで、[Download (ダウンロード)] をクリックします。
   
9. ファイルを選択して、[Compress (圧縮)] をクリックします。
   
10. zip ファイル名をクリックすると、そのファイルがローカルシステムにダウンロードされます。
    

WebDAV を使用して XML ファイルを OMS に転送し、そのファイルを OMS にインポートします。FTP または HTTPS を使用することもできますが、会社の実装では WebDAV を使用するように開発されています。この転送プロセスでは、データ転送に関する PCI-DSS 要件と OMS システム要件を満たすセキュアな接続を使用します。

WebDAV 経由のインポート/エクスポートファイルの表示

すべての準備が整っていることを確認するために、ファイルをレビューします。手順は次のとおりです。

1. Business Manager で [App Launcher (アプリケーションランチャー)] をクリックし、[Administration (管理)] | [Site Development (サイト開発)] | [Development Setup (開発セットアップ)] を選択します。
   
2. [Import/Export (インポート/エクスポート)] をクリックします。
   
3. ログファイルを見て、正しいことを確認します。
   

Commerce for B2C では、エクスポートファイルのアップロードが 500 MB に制限されています。つまり、複数のサイトや巨大な画像を含むエクスポートを行うと、データの超過料金が生じます。エクスポートは必要な場合にのみ実行します。たとえば、1 日 1 回、必要なデータのみを対象に実行します。

サイトのインポート/エクスポート

処理するもう 1 種類のインポート/エクスポートはサイトデータです。会社では新しいサイトを実装中で、複数の開発チームが異なる開発インスタンスで並行して作業を進めています。ファンクショナルアーキテクトから、1 つの開発インスタンスの構成をコピーして、別の開発インスタンスと共有するように依頼されました。

このタスクには、サイトのインポート/エクスポートモジュールを使用します。インスタンスのスナップショット (構成とデータ) を保存して、同じまたは別のインスタンスで復元できます。

サイトデータをエクスポートする手順は、次のとおりです。

1. Business Manager で [App Launcher (アプリケーションランチャー)] をクリックし、[Administration (管理)] | [Site Development (サイト開発)] | [Site Import & Export (サイトのインポート & エクスポート)] を選択します。
   

2. [Export (エクスポート)] セクションに、アーカイブのファイル名を入力します。
   
3. エクスポートするデータを選択します。
   

4. [Export (エクスポート)] をクリックします。
   
5. エクスポートが終了したら、ページ下部にあるエクスポートファイルのリンクをクリックします。
   
6. 次のページで一番下までスクロールし、ファイルのダウンロードリンクをクリックします。ローカルシステムに zip ファイルが作成されます。
   

サイトデータをインポートする手順は、次のとおりです。

1. 受信側インスタンスの Business Manager で [App Launcher (アプリケーションランチャー)] をクリックし、[Administration (管理)] | [Site Development (サイト開発)] | [Site Import & Export (サイトのインポート & エクスポート)] を選択します。
   
2. [Import (インポート)] セクションの [Local (ローカル)] が選択されている状態で、[Choose File (ファイルを選択)] をクリックします。
   
3. ファイルを参照して、[Open (開く)] をクリックします。
   
4. [Import (インポート)] セクションのファイルを選択して、[Import (インポート)] をクリックします。
   

トランザクションの制限

標準インポートは任意のサイズの XML ファイルを処理するよう設計されていますが、1 回のプロセスのビジネスオブジェクト数は 1,000 個に制限されています。会社が成長するにつれて、この制限やその他の制限にも注意します。

圧縮された XML ファイル

XML ファイルを圧縮してサイズを縮小します。圧縮ファイルを使用することで、アップロードサイズの上限内に収まり、低速ネットワークリンクでのアップロード/ダウンロードの時間が短縮されます。

• gzip: Business Manager では標準のインポートファイルを gzip アルゴリズムを使用して圧縮するため、インスタンスで .gunzip を実行せずに済みます。インポートパイプレットにファイル名 (catalog.xml.gz など) を入力するか、Business Manager で gzip で圧縮されたファイル (拡張子は .gz である必要があります) を選択します。
  
• zip: Business Manager のインポート/エクスポート内で、XML ファイルを 1 つずつ圧縮または展開します (zip 圧縮で、gzip 圧縮ではありません)。.zip ファイルはアップロード時に Business Manager が自動的に展開します。
  

デルタフィード

カタログデータ以外のインポートでは、現在と以前の XML ファイルの差異のみを記載した XML ファイルを作成します。これをデルタフィードといいます。通常はデルタフィードのほうが容量が小さく、迅速にインポートでき、ネットワーク中断による影響が少なくなります。

カタログのデルタフィードを作成できますが、グローバルインポートモードを要素固有インポートモードで上書きする要素は含められません。たとえば、bundled-products 項目は自動的に replace (置換) モードを使用するため、バンドル商品のデルタフィードを作成することはできません。

静的ファイル

カタログやコンテンツライブラリ (カテゴリ、商品、コンテンツデータ) の永続オブジェクトには、商品の画像などの補足的な静的ファイルがあります。Commerce for B2C では、これらはインスタンスファイルシステムに保存されます。XML ファイルに含めることができるのは永続データベースオブジェクトと、静的オブジェクトへの参照のみです。静的ファイルをエクスポート/インポートまたはダウンロード/アップロードする場合は、WebDAV インターフェースを使用する必要があります。

アーカイブする理由

Commerce for B2C は XML ファイルをロールバックしないため、インポート前に必ず以前の XML ファイルをアーカイブしてください。新しい XML ファイルが検証に失敗した場合は、以前のバージョンをインポートできます。週に 1 回、古いファイル (最新ファイル以外) を削除して、ファイルが蓄積されないようにすることをお勧めします。

まとめ

この単元では、カタログをインポートして、注文をエクスポートし、WebDAV でログを表示する方法を学習しました。サイトのインポート/エクスポートで、サイトデータを 1 つの開発インスタンスから別の開発インスタンスにコピーしました。ファイルやトランザクションのサイズ制限に対処する方法や、アーカイブの重要性についても学びました。

リソース

• Trailhead: Salesforce B2C Commerce の役割と許可
• Salesforce ヘルプ: インポートとエクスポート