ファイルを読み込み

最終更新日： 2025年2月7日

「ファイルを読み込み」アクティビティは、「データ管理」アクティビティです。このアクティビティを使用して、外部ファイルに保存されるプロファイルとデータを操作します。プロファイルとデータはデータベースに追加されませんが、入力ファイル内のすべてのフィールドをパーソナライゼーションや、プロファイルまたは他のテーブルの更新に使用できます。

NOTE
サポートされるファイル形式は、テキスト（TXT）とコンマ区切り値（CSV）です。最大サイズが 50 MB のファイルを読み込むことができます。

このアクティビティを「紐付け」アクティビティと使用すると、識別されていないデータを既存のリソースにリンクできます。例えば、非標準のデータをデータベースにインポートする場合は、「紐付け」アクティビティの前に「ファイルを読み込み」アクティビティを配置できます。

「ファイルを読み込み」アクティビティの設定

「ファイルを読み込み」アクティビティの設定には、2 つの手順があります。まず、サンプルファイルをアップロードして、目的のファイル構造を定義する必要があります。この処理が完了したら、データをインポートするファイルのインポート元を指定します。アクティビティを設定するには、次の手順に従います。

サンプルファイルの設定

目的のファイル構造の定義に使用するサンプルファイルを設定するには、次の手順に従います。

  1. 「ファイルを読み込み」アクティビティをワークフローに追加します。

  2. 目的のファイル構造を定義するために使用するサンプルファイルを選択します。これを行うには、「サンプルファイル」セクションの「ファイルを選択」ボタンをクリックし、使用するローカルファイルを選択します。

    NOTE
    サンプルファイルのデータはアクティビティの設定に使用されますが、インポートはされません。データの少ないサンプルファイルを使用することをお勧めします。ファイル形式は、このサンプルファイルと一致させる必要があります。

  3. サンプルファイルのプレビューが表示され、最大 30 行が表示されます。

  4. ファイルタイプ ​ドロップダウンリストで、ファイルで区切り列を使用するか、固定幅の列を使用するかを指定します。

  5. 区切り列ファイルタイプの場合は、「列」セクションを使用して、各列のプロパティを設定します。

    ファイル列に使用可能なオプション
    • ラベル：列に表示するラベル。
    • データタイプ：列に含まれるデータのタイプ。
    • 幅（文字列データタイプ）：列に表示する最大文字数。
    • データ変換（文字列データタイプ）：列に含まれる値に変換を適用します。
    • スペースの管理（文字列データタイプ）：列に含まれるスペースの管理方法を指定します。
    • 区切り記号（日付、時刻、整数、数値のデータタイプ）*：区切り記号として使用する文字を指定します。
    • NULL を許可：列の空の値の管理方法を指定します。空の値が存在する場合、「Adobe Campaign のデフォルト」オプションはエラーをスローします。
    • エラー処理（文字列データタイプ）：いずれかの行にエラーが発生した場合の動作を指定します。
    • 値の再マッピング：このオプションを使用すると、特定の値を新しい値にマッピングできます。例えば、列に「True」/「False」の値が含まれる場合、マッピングを追加して、それらの値を「0」/「1」の文字に自動的に置き換えることができます。

+++

  1. 「書式設定」セクションで、データが正しくインポートされるようにファイルの書式設定方法を指定します。

アップロードするターゲットファイルを定義します。

CAUTION
ターゲットファイルを読み込む前に、サンプルファイルの書式設定に従っていることを確認します。ファイルの書式設定、列の構造、列の数に不一致があると、ワークフローの実行中にエラーが発生する場合があります。

アップロードするターゲットファイルを定義するには、次の手順に従います。

  1. 「ターゲットファイル」セクションで、サーバーにアップロードするファイルを取得する際に実行するアクションを指定します。

    • ローカルマシンからファイルをアップロード：マシンからアップロードするファイルを選択します。

    • トランジションで指定：「ファイルを転送」など、以前のアクティビティからのインバウンドトランジションで指定されたファイルをアップロードします。

    • ファイルを前処理：以前のトランジションで指定したファイルをアップロードし、「解凍」や「復号」などの前処理コマンドを適用します。

    • 計算：「ファイル名」フィールドに指定した名前のファイルをアップロードします。「パーソナライゼーションダイアログを開く」アイコンをクリックして、イベント変数を含む式エディターを活用してファイル名を計算します。

    NOTE
    クライアントコンソールで既に設定されている「ファイルを読み込み」アクティビティにアクセスしている場合、アクティビティを設定して、ファイルを外部データベースにアップロードすると、追加の「ターゲットデータベース」セクションが表示されます。これにより、ファイルを Campaign サーバーにアップロードするか、外部データベースにアップロードするかを指定できます。

追加のオプション

  1. 「却下管理」セクションで、エラーが発生した場合のアクティビティの動作を指定します。

    • 「許容されるエラー数」フィールドに、読み込むファイルの処理時に許可されるエラーの最大数を指定します。例えば、値が「20」に設定されている場合、ファイルの読み込み時に 20 を超えるエラーが発生すると、ワークフローの実行は失敗します。

    • ファイルの読み込み時に発生したエラーを保持するには、「ファイルに却下を保持」オプションをオンに切り替え、「却下ファイル」フィールドにファイルの目的の名前を指定します。

      このオプションをアクティブにすると、「補集合」という名前の追加の出力トランジションがアクティビティの後に追加されます。インポート中に発生するエラーは、サーバー上の指定したファイルに保存されます。

  2. ワークフローの実行後にアップロードしたファイルをサーバーから削除するには、「インポート後にファイルを削除」オプションを切り替えます。

  3. 設定が正しければ、「確認」をクリックします。