アーカイブのインポート

概要

Backup & Archive を使用すると、他のバックアップアプリケーションからアーカイブされたデータを AWS S3 バケットにインポートできます。本ガイドでは、インポート手順と必要なディレクトリおよびファイル構成について説明します。

circle-info

アーカイブはからのみインポートできます AWS S3 バケット.

インポートを開始

1

インポートを作成

  1. クリック Backup & Archive 左側のサイドバーメニューから。

  2. クリック 組織スイッチャー パンくずリストから。

  3. インポート先の組織を選択します。

  4. クリック アーカイブをインポート.

2

S3 バケットを接続

インポート処理は AWS S3 バケットからのみアーカイブをインポートできます。

  1. 入力してください 名前 インポートジョブの。

  2. 入力してください バケット設定 の値。各項目の説明は下の表を参照してください。

項目
AWS 項目

バケット名

Amazon S3 > バケット > 名前

リージョン

Amazon S3 > バケット > AWS リージョン (含めるのは リージョン のみであり、 リージョン名は含めないでください。例えば、ストレージが 米国東部(バージニア北部) us-east-1にある場合は、 us-east-1.)

アクセスキー ID

生成された アクセスキー ID バケット作成時に。

シークレットアクセスキー

生成された シークレットアクセスキー バケット作成時に。

  1. クリック 検証 をクリックして S3 バケットへの接続を確認します。

  2. バケットへの接続に成功すると、 バケットの認証情報は有効です というメッセージが表示され、 次へ ボタンが有効になります。

  3. クリック 次へ.

3

プレフィックスを入力

生成された プレフィックス 設定は異なる構造のアーカイブを処理するために使用されます。次の例のような入れ子構造のディレクトリをインポートできます:

s3://my_bucket/
├── 00DWU000001IVG52AO/
│   └── nested/
│       └── path/
│           └── in/
│               └── bucket/
│                   └── export-directory_2024-7-29_17_5/
│                       ├── archive_export_1.zip
│                       ... other files

├── {other_org_id}/
... other directories
circle-info

AWS S3 バケットにはディレクトリという概念は存在しません。私たちは区切り文字として / 文字を使用します。

  1. インポートファイルのフォルダパスを プレフィックス テキストボックスに入力してください。

4

「Data and Import」を選択してください

Backup & Archive は Salesforce 組織 ID を名前に含むディレクトリから始まるディレクトリを一覧表示します。以下の構成例を参照してください:

00DWU000001IVG52AO/
├── archive_directory/
│   ├── archive_export.zip
├── archive_directory_1/
│   ├── archive_export.zip
│   └── archive_export_1.zip
... other directories

上記の例の構成では、次のディレクトリがインポートのために一覧表示されます。

  • archive_directory/

  • archive_directory_1/

インポートディレクトリ構造の詳細については、 アーカイブのインポート 以下のセクションを参照してください。

circle-info

複数のディレクトリを選択すると、それぞれが個別のジョブとして処理され、順次実行されます。例えば、2 つのアーカイブディレクトリを選択した場合、最初のものが先にインポートされ、その後に 2 番目がインポートされます。

  1. クリック 選択 各アーカイブディレクトリのインポートのために。

  2. クリック インポート インポート処理を開始するには。

  3. インポートジョブを開始した後、結果は 「Backup & Archive > History」 タブで確認できます。

ディレクトリ構造

Flosum Backup & Archive にアーカイブデータを正常にインポートするには、インポートデータに特定のディレクトリ構造が必要です。以下の例は必要な構造を示しています。

この例では、S3 バケットという名前があります: my_bucket および Salesforce 組織の ID: 00DWU000001IVG52AO。この組織から Backup & Archive アプリケーションへアーカイブデータをインポートするには、以下のようなディレクトリ構造が必要です。

s3://my_bucket/
└── 00DWU000001IVG52AO/
    ├── export-directory_2024-7-29_17_5/
    │   └── archive_export_1.zip
    └── export-directory_2024-8-30_18_10/
        ├── archive_export_1.zip
        ├── archive_export_2.zip
        └── archived_files/
              ├── Attachment/
              │   ├── 00P5x00001Koqb6EAB/
              │   │   └── attachment_body.pdf
              │   └── 00P5x00001Koqb6EAB/
              │       └── attachment_body.csv
              └── ContentVersion/
                  ├── 0685x00000AsY5aAAF/
                  │   └── content_version_body.pdf
                  └── 0685x00000AsY5bAAF/
                      └── content_version_body.csv

上のディレクトリ構造では、 アーカイブをインポート > データを選択 UI画面にはインポート可能な2つのディレクトリが一覧表示されます:

  • export-directory_2024-7-29_17_5/

  • export-directory_2024-8-30_18_10/

Zipファイル

各ディレクトリには、次の接頭辞が付いたzipファイルを含める必要があります archive_export。他の接頭辞が付いたファイルは無視されます。各zipファイルにはディレクトリと.csvファイルが含まれている必要があります。許容されるzipファイル構造の例は以下を参照してください。

インポートの処理

インポートジョブが処理されると、選択されたディレクトリ内のすべての.zipファイルが展開され、.csvファイルが処理されます。

この例では、 s3://my_bucket/ および archive_export_1.zip 上記の例からは、インポートがどのように処理されるかを説明するために使用されます。処理すると archive_export_1.zip Backup & Archiveアプリケーションにオブジェクトのレコードが作成されます Task および Case。.zipファイルにバイナリオブジェクトが含まれている場合、そのボディは archived_files/ ディレクトリの下に配置され、 レコードID を使用してボディを特定します。

を処理するとき、 archive_export_1.zip ディレクトリから、 export-directory_2024-8-30_18_10/ ファイルを見つけるために Attachment/Attachment_1.csv およびIDを持つレコード 0685x00000AsY5bAAFがある場合、S3バケット内で次のパターンを使用してそれを見つける必要があります:

例:

このパスに何も存在しない場合、レコードはインポートされません。次の点に注意してください: tmp/ の下のディレクトリ s3://{bucket_name}/{ord_id}/{export_directory_name}/archived_files/{object_api_name}/{record_id}/ は無視されます。

最終更新

役に立ちましたか?