ファイルを転送 transfer-file
説明 description
「Transfer file」アクティビティを使用すると、ファイルの送受信、ファイルの有無のテスト、Adobe Campaign 内のファイルの一覧表示ができます。
Context of use context-of-use
データの抽出方法は、アクティビティの設定時に定義されます。 読み込むファイルとしては、例えば連絡先のリストなどがあります。
このアクティビティを使用すると、データが回復され、「Load file」アクティビティで構造化されます。
関連トピック：
設定 configuration
-
ワークフローに「Transfer file」アクティビティをドロップします。
-
アクティビティを選択し、表示されるクイックアクションの
-
「Action」フィールドのドロップダウンリストを使用して、次のアクティビティアクションのいずれかを選択します。
- ファイルのダウンロード：ファイルをダウンロードできます。
- ファイルのアップロード：ファイルをアップロードできます。 Adobe Campaign ファイルからファイルをアップロードすると、Export audits メニューにログエントリが生成されます。 エクスポートの監査について詳しくは、エクスポートの監査の節を参照してください。
- テストによりファイルの存在を確認：ファイルが存在するかどうかを確認できます。
- ファイルリスト：「Protocol」タブで定義されたサーバーに存在するファイルをリストできます。 このアクションは主にデバッグ目的で使用され、リモートサーバーからファイルをダウンロードする前に、要件を満たすようにアクティビティが設定されているかどうかを確認します。
-
使用するプロトコルを選択します。
-
選択したプロトコルに応じて利用できるAdditional options セクションでは、プロトコルにパラメーターを追加できます。
以下を行うことができます。
-
Delete the source files after transfer: リモート サーバーのファイルを消去します。 このオプションを選択しない場合は、SFTP ディレクトリにあるアーカイブ済みコンテンツのサイズを手動で監視するようにしてください。
-
Sorting files: ファイルを英数字で並べ替えることができます。 このオプションはデフォルトでは無効です。
-
List all files：このオプションは、General タブでFile listing アクションを選択する際に使用できます。 サーバー上に存在するすべてのファイルのインデックスを vars.filenames イベント変数に作成できます。この変数では、ファイル名が ‘n’ 文字で区切られています。
-
-
「Advanced options」タブの「If no files are found」セクションでは、アクティビティの起動時にエラーや存在しないファイルが検出された場合の特定のアクションを設定できます。
また、再試行も定義できます。 ワークフローの実行ログに各種の再試行が表示されます。
-
アクティビティの設定を確認し、ワークフローを保存します。
HTTPを使用した設定 HTTP-configuration-wf
HTTP プロトコルを使用すると、外部アカウントまたは URL からファイルをダウンロードできます。
このプロトコルでは、Use connection parameters defined in an external account オプションを選択できます。 この場合は、ダウンロードするアカウントを選択し、ダウンロードするファイルのパスを指定します。
また、「Quick configuration」オプションを選択することもできます。 必要なのは「URL」フィールドに URL を入力することだけです。
Follow redirections、Ignore the HTTP return codeおよび Add received HTTP headers to the file は、HTTP プロトコルを選択するときに使用できる追加オプションです。
SFTPを使用した設定 SFTP-configuration-wf
SFTP プロトコルを使用すると、URL または外部アカウントからファイルをダウンロードできます。
このプロトコルでは、Use connection parameters defined in an external account オプションを選択してから、ダウンロードするアカウントを選択し、ダウンロードするファイルのパスを指定できます。
また、「Quick configuration」オプションを選択することもできます。 必要なのは「URL」フィールドに URL を入力することだけです。
Amazon S3での設定 S3-configuration-wf
Amazon S3 プロトコルを使用すると、Amazon Simple Storage Service（S3）を使用して URL または外部アカウントからファイルをダウンロードできます。
-
Amazon S3 外部アカウントを選択します。 詳しくは、このページを参照してください。
-
「Define a file path」または「Use a dynamic file path」を選択します。
-
ダウンロードするファイルのパスを指定します。
note caution CAUTION Amazon S3では、ワイルドカードはサポートされていません。 my_file_02やmy _file_3433などの複数のファイルをターゲットにするには、次の構文を使用できます：acs-myawsbucket.s3.amazonaws.com/object-path/my_file_。 -
転送の完了時にソースファイルを削除する場合は、「Delete the source files after transfer」をオンにします。
Microsoft Azure Blob Storageを使用した設定 azure-blob-configuration-wf
Microsoft Azure Blob プロトコルを使用すると、Microsoft Azure Blob Storage アカウントにある BLOB にアクセスできます。
-
Microsoft Azure Blob 外部アカウントを選択します。 詳しくは、このページを参照してください。
-
「Define a file path」または「Use a dynamic file path」を選択します。
-
ダウンロードするファイルのパスを指定します。複数の BLOB と一致する場合があります。 この場合、「File transfer」アクティビティは、BLOB が見つかるたびに送信トランジションをアクティブ化します。 その後、アルファベット順に処理されます。
note caution CAUTION ワイルドカードを使用して複数のファイル名と一致させることはできません。 代わりに、接頭辞を入力する必要があります。 その接頭辞に一致するすべての BLOB 名が対象です。 以下のリストはファイルのパスの例です。
- “campaign/”：コンテナのルートにある Campaign フォルダー内のすべての BLOB と一致します。
- “campaign/new-”：ファイル名が「new-」で始まり、Campaign フォルダーの下にあるすべての BLOB と一致します。
- “”：空のパスを追加すると、コンテナで使用可能なすべての BLOB と一致します。
Adobe Campaign サーバーに存在するファイルを使用した設定 files-server-configuration-wf
「File(s) present on the Adobe Campaign server」プロトコルは、回復するファイルを含むリポジトリに対応します。
メタ文字、またはワイルドカード（例：*または？） を使用して、ファイルをフィルターできます。
Define a file pathまたは Use a dynamic file path
Use a dynamic file path オプションでは、標準式とイベント変数を使用して、転送するファイル名をパーソナライズできます。 詳しくは、このページを参照してください。
パスは、Adobe Campaign サーバーのストレージスペースディレクトリを基準とした相対パスである必要があります。 ファイルは、sftp<インスタンス名>/ ディレクトリにあります。 また、ストレージスペースの上にあるディレクトリを参照することはできません。
例：
user<yourinstancename>/my_recipients.csvが正しいです。
../hello/my_recipients.csvが正しくありません。
//myserver/hello/myrecipients.csvが正しくありません。
履歴化設定 historization-settings
「Transfer file」アクティビティが実行されるたびに、アップロードされたファイルまたはダウンロードされたファイルが専用のフォルダーに保存されます。 ワークフローの「Transfer file」アクティビティごとに 1 つのフォルダーが作成されます。 したがって、サーバー上の物理領域を保持するために、このフォルダーのサイズを制限できるようにする必要があります。
そのためには、「Transfer File」アクティビティの Advanced options で「Historization settings」を定義します。
「Historization settings」では、アクティビティのフォルダーのファイルの最大数または合計サイズを定義できます。 デフォルトで許可されている値はそれぞれ 100 個と 50 MB です。
このアクティビティを実行するたびに、次のようにフォルダーがチェックされます。
- アクティビティ実行の 24 時間前までに作成されたファイルのみが対象です。
- 対象となるファイルの数が「Maximum number of files」パラメーターの値より大きい場合、許可されている「Maximum number of files」の値におさまるまで、古いファイルから順に削除されます。
- 対象となるファイルの合計サイズが「Maximum size (in MB)」パラメーターの値より大きい場合、許可されている「Maximum size (in MB)」の値におさまるまで、古いファイルから順に削除されます。
出力変数 output-variables
Transfer file アクティビティは、他のアクティビティで活用できるイベント変数を出力として生成します。例えば、 テスト アクティビティを使用してダウンロードされたファイルの数を確認できます。
イベント変数は、外部信号を使用して別のワークフローに渡すこともできます（外部パラメーターを使用したワークフローのカスタマイズ を参照）。
使用可能な出力変数は次のとおりです。
- fileName：転送されたファイルの名前。
- filesCount：転送されたファイル数。