Dateiübertragung transfer-file

Beschreibung description

Die Dateiübertragung dient dem Empfang und Versand von Dateien. Sie ermöglicht es des Weiteren, die Präsenz von Dateien zu testen und die in Adobe Campaign enthaltenen Dateien aufzulisten.

Anwendungskontext context-of-use

Die Art der Datenextraktion wird im Zuge der Aktivitätskonfiguration definiert. Bei der zu ladenden Datei kann es sich z. B. um eine Kontaktliste handeln.

Sie können die Aktivität darüber hinaus dazu nutzen, Daten abzurufen, die im Anschluss mithilfe der Datei laden-Aktivität strukturiert werden können.

Verwandte Themen:

Konfiguration configuration

  1. Ziehen Sie eine Dateiübertragung in den Workflow.

  2. Markieren Sie die Aktivität und öffnen Sie sie mithilfe der in der Schnellaktion angezeigten Schaltfläche  .

  3. Wählen Sie mithilfe der entsprechenden Dropdown-Liste die von der Aktivität auszuführende Aktion aus:

    • Datei-Download - dient dem Herunterladen von Dateien.
    • Datei-Upload - dient dem Hochladen von Dateien. Durch das Hochladen einer Datei aus Adobe Campaign wird im Menü Export-Audits ein Protokolleintrag erstellt. Weiterführende Informationen zu Export-Audits finden Sie im Abschnitt Log-Exporte überprüfen.
    • Existenztest einer Datei - dient der Prüfung des Vorhandenseins einer Datei.
    • Dateiauflistung: ermöglicht das Auflisten der auf dem Server vorhandenen Dateien, die auf dem Tab Protokoll definiert sind. Diese Aktion wird hauptsächlich zum Debugging verwendet. So lässt sich überprüfen, ob die Aktivität Ihren Anforderungen entsprechend konfiguriert ist, bevor die Dateien vom Remote-Server heruntergeladen werden.
  4. Wählen Sie das Protokoll aus, das Sie verwenden möchten:

  5. Im Bereich Weitere Optionen, der je nach gewähltem Protokoll angezeigt wird, ist die Konfiguration weiterer Protokollparameter möglich.

    Sie haben folgende Möglichkeiten:

    • Quelldateien nach der Übertragung löschen: löscht die Dateien auf dem Remote-Server. Wenn Sie diese Option deaktiviert lassen, müssen Sie die Größe des archivierten Inhalts im SFTP-Verzeichnis manuell überwachen.

    • Sortieren von Dateien: ermöglicht die alphanumerische Sortierung von Dateien. Standardmäßig ist diese Option deaktiviert.

    • Alle Dateien auflisten: Diese Option ist verfügbar, wenn die Aktion Dateiauflistung auf der Registerkarte Allgemein ausgewählt wird. Mithilfe dieser Option können alle auf dem Server verfügbaren Dateien in der Ereignisvariable vars.filenames verzeichnet werden. Darin sind die Dateinamen durch die Zeichen 'n' getrennt.

  6. Im Bereich Bei Abwesenheit von Dateien des Tabs Erweiterte Optionen können Sie bestimmen, was geschehen soll, wenn die gewünschten Dateien beim Start der Aktivität nicht auffindbar sind.

    Sie können darüber hinaus Neuversuche definieren. Die einzelnen Versuche erscheinen im Ausführungsprotokoll des Workflows.

  7. Validieren Sie die Konfiguration der Aktivität und speichern Sie Ihren Workflow.

Konfiguration mit HTTP HTTP-configuration-wf

Das HTTP-Protokoll ermöglicht den Download einer Datei über ein externes Konto oder mithilfe einer URL.

Bei diesem Protokoll können Sie die Option In einem externen Konto definierte Verbindungsparameter verwenden auswählen. Wählen Sie in diesem Fall das gewünschte Konto aus und geben Sie den Pfad der herunterzuladenden Datei an.

Sie können sich auch für die Option Schnelle Konfiguration entscheiden. Sie müssen nur die URL in das URL-Feld eingeben.

Wenn Sie das HTTP-Protokoll auswählen, sind die zusätzlichen verfügbaren Optionen Weiterleitungen verfolgen, HTTP-Rückgabecode ignorieren und Empfangene HTTP-Header zur Datei hinzufügen.

Konfiguration mit SFTP SFTP-configuration-wf

Das SFTP-Protokoll ermöglicht den Download einer Datei mithilfe einer URL oder über ein externes Konto.

Bei diesem Protokoll können Sie die Option In einem externen Konto definierte Verbindungsparameter verwenden auswählen. Wählen Sie anschließend das gewünschte Konto aus und geben Sie den Pfad der herunterzuladenden Datei an.

CAUTION
Platzhalter werden unterstützt.

Sie können sich auch für die Option Schnelle Konfiguration entscheiden. Sie müssen nur die URL in das URL-Feld eingeben.

Konfiguration mit Amazon S3 S3-configuration-wf

Das S3-Protokoll ermöglicht den Download einer Datei über ein externes Konto oder mithilfe einer URL über den Amazon Simple Storage Service (S3).

  1. Wählen Sie ein externes Amazon S3-Konto aus. Weiterführende Informationen hierzu finden Sie auf dieser Seite.

  2. Entscheiden Sie, ob Sie einen Dateipfad definieren oder einen Dynamischen Dateipfad verwenden möchten.

  3. Geben Sie den Pfad der herunterzuladenden Datei an.

    note caution
    CAUTION
    Platzhalter werden in Amazon S3 nicht unterstützt.
    Um mehrere Dateien wie my_file_02 und my _file_3433 auszuwählen, können Sie die folgende Syntax verwenden: acs-myawsbucket.s3.amazonaws.com/object-path/my_file_.
  4. Wenn Sie Ihre Quelldateien nach Abschluss der Übertragung löschen möchten, aktivieren Sie die Option Quelldateien nach der Übertragung löschen.

Konfiguration mit Microsoft Azure Blob Storage azure-blob-configuration-wf

Das Microsoft Azure Blob-Protokoll erlaubt Ihnen Zugriff auf einen Blob in einem Microsoft Azure Blob Storage-Konto.

  1. Wählen Sie ein externes Microsoft Azure Blob-Konto. Weiterführende Informationen hierzu finden Sie auf dieser Seite.

  2. Entscheiden Sie, ob Sie einen Dateipfad definieren oder einen Dynamischen Dateipfad verwenden möchten.

  3. Geben Sie den Pfad der herunterzuladenden Datei an; er kann mit verschiedenen Blobs übereinstimmen. In diesem Fall aktiviert die Aktivität Dateiübertragung die ausgehende Transition einmal pro gefundenem Blob. Sie werden dann in alphabetischer Reihenfolge verarbeitet.

    note caution
    CAUTION
    Platzhalter für das Finden mehrerer Dateinamen werden nicht unterstützt. Stattdessen müssen Sie ein Präfix eingeben. Alle Blob-Namen, die mit diesem Präfix übereinstimmen, sind geeignet.

    Nachfolgend finden Sie eine Liste mit Beispielen für Dateipfade:

    • "Campaign/": findet alle Blobs im Ordner „Campaign“, der sich im Stammordner des Containers befindet.
    • "campaign/new-": findet alle Blobs mit einem Dateinamen, der mit „new-“ beginnt und sich im Ordner „Campaign“ befindet.
    • "": Wenn Sie einen leeren Pfad hinzufügen, können Sie alle im Container verfügbaren Blobs finden.

Konfiguration mit Dateien, die auf dem Adobe Campaign-Server vorhanden sind files-server-configuration-wf

Das Protokoll Auf dem Adobe Campaign-Server vorhandene Datei(en) entspricht dem Repository, das die abzurufenden Dateien enthält.
Zur Filterung der Dateien ist die Verwendung von Metazeichen oder Platzhaltern (zum Beispiel * oder ?) möglich.

Entscheiden Sie, ob Sie einen Dateipfad definieren oder einen dynamischen Dateipfad verwenden möchten.
Mit der Option Dynamischen Dateipfad verwenden können Sie mit einem Standardausdruck und Ereignisvariablen den Dateinamen für die Übertragung personalisieren. Weitere Informationen hierzu finden Sie auf dieser Seite.

Hinweis: Der Pfad muss relativ zum Speicherort des Adobe Campaign-Servers angegeben werden. Die Dateien befinden sich im Verzeichnis sftp<yourinstancename>/. Darüber hinaus können dem Speicherort übergeordnete Verzeichnisse nicht durchsucht werden.

Beispiel:

user&lt;yourinstancename>/my_recipients.csv Ist richtig.

../hello/my_recipients.csv ist falsch.

//myserver/hello/myrecipients.csv ist falsch.

Verlaufsparameter historization-settings

Jedes Mal, wenn die Aktivität Dateiübertragung ausgeführt wird, werden die hoch- oder heruntergeladenen Dateien in einem bestimmten Ordner gespeichert. Für jede Aktivität Dateiübertragung in einem Workflow wird ein Ordner erstellt. Deshalb ist es wichtig, die Größe dieses Ordners zu begrenzen, um physischen Platz auf dem Server zu sparen.

Zu diesem Zweck können Sie die Verlaufsparameter in Erweiterte Optionen der Aktivität Dateiübertragung definieren.

In Verlaufsparameter können Sie eine Höchstzahl an Dateien oder die Gesamtgröße des Ordners für die Aktivität definieren. Standardmäßig sind 100 Dateien und 50 MB zugelassen.

Jedes Mal, wenn die Aktivität ausgeführt wird, wird der Ordner folgendermaßen überprüft:

  • Nur Dateien, die mehr als 24 Stunden vor der Durchführung der Aktivität erstellt wurden, werden berücksichtigt.
  • Wenn die Anzahl der berücksichtigten Dateien größer ist als der Parameterwert Maximale Dateianzahl, werden die ältesten Dateien gelöscht, bis die zulässige Maximale Dateianzahl erreicht ist.
  • Wenn die Gesamtzahl der berücksichtigten Dateien größer ist als der Wert des Parameters Maximale Größe (in MB), werden die ältesten Dateien gelöscht, bis die zulässige Maximale Größe (in MB) erreicht ist.
NOTE
Wenn die Aktivität nicht ausgeführt wird, wird der Ordner weder überprüft noch geleert. Seien Sie deshalb achtsam beim Transfer großer Dateien.

Ausgabevariablen output-variables

Die Aktivität Dateiübertragung erzeugt Ereignisvariablen als Ausgabe, die Sie in anderen Aktivitäten nutzen können, z. B., um die Anzahl der heruntergeladenen Dateien mit der Aktivität Test zu überprüfen.

Beachten Sie, dass Ereignisvariablen auch über ein externes Signal an einen anderen Workflow übergeben werden können (siehe Workflow mit externen Parametern anpassen).

Verfügbare Ausgabevariablen sind:

  • fileName: Name der übertragenen Dateien.
  • filesCount: Anzahl der übertragenen Dateien.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff