Bestand overdragen transfer-file
Beschrijving description
Met de activiteit Transfer file kunt u bestanden ontvangen of verzenden, testen of er bestanden aanwezig zijn of een lijst met bestanden weergeven in Adobe Campaign.
Gebruikscontext context-of-use
De manier waarop de data worden geëxtraheerd, wordt gedefinieerd wanneer de activiteit wordt geconfigureerd. Het te laden bestand kan bijvoorbeeld een lijst met contactpersonen zijn.
U kunt deze activiteit gebruiken om data te herstellen die vervolgens met de activiteit Load file zullen worden gestructureerd.
Verwante onderwerpen:
Configuratie configuration
-
Zet een activiteit Transfer file neer in uw workflow.
-
Selecteer de activiteit en open deze met de knop
-
Gebruik de vervolgkeuzelijst in het veld Action om een van de volgende activiteitsacties te selecteren:
- File download: Hiermee kunt u een bestand downloaden.
- File upload: Hiermee kunt u een bestand uploaden. Wanneer u een bestand uploadt uit een Adobe Campaign-bestand, wordt een logboekvermelding in het menu Export audits gegenereerd. Raadpleeg de sectie Audits uitvoeren op exportlogboeken voor meer informatie over exportaudits.
- Test to see if file exists: Hiermee kunt u controleren of er een bestand is.
- File listing: Hiermee kunt u de bestanden weergeven die aanwezig zijn op de server die is gedefinieerd op het tabblad Protocol. Deze actie wordt hoofdzakelijk gebruikt voor foutopsporing, om te controleren of de activiteit volgens uw behoeften is geconfigureerd voordat de bestanden van de externe server worden gedownload.
-
Selecteer het protocol dat u wilt gebruiken:
-
De Additional options kunt u parameters toevoegen aan uw protocol, afhankelijk van het geselecteerde protocol.
U kunt:
-
Delete the source files after transfer: wist de bestanden op de externe server. Als deze optie uitgeschakeld blijft, controleert u handmatig de grootte van de gearchiveerde inhoud in de SFTP-map.
-
Sorting files: hiermee kunt u bestanden alfanumeriek sorteren. Deze optie is standaard uitgeschakeld.
-
List all files: deze optie is beschikbaar als u de optie File listing in de General tab. Hiermee kunt u alle bestanden indexeren die aanwezig zijn op de server in de gebeurtenisvariabele vars.filenames waarin de bestandsnamen worden gescheiden door de tekens ‘n’
-
-
In de sectie If no files are found van het tabblad Advanced options kunt u specifieke acties configureren als er fouten of onbestaande bestanden worden gedetecteerd wanneer de activiteit wordt gestart.
U kunt ook nieuwe pogingen definiëren. De verschillende nieuwe pogingen worden weergegeven in het logboek voor workflowuitvoering.
-
Bevestig de configuratie van uw activiteit en sla de workflow op.
Configuratie met HTTP HTTP-configuration-wf
Met het HTTP-protocol kunt u beginnen met het downloaden van een bestand vanaf een extern account of van een URL.
Met dit protocol kunt u ervoor kiezen Use connection parameters defined in an external account -optie. Selecteer in dit geval de account die u wilt downloaden en geef het pad op van het bestand dat u wilt downloaden.
U kunt ook de optie Quick configuration kiezen. U hoeft de URL alleen in te voeren in het veld URL.
Follow redirections, Ignore the HTTP return code, en Add received HTTP headers to the file zijn de extra opties beschikbaar wanneer u het protocol van HTTP selecteert.
Configuratie met SFTP SFTP-configuration-wf
Met het SFTP-protocol kunt u beginnen met het downloaden van een bestand vanaf een URL of een extern account.
Met dit protocol kunt u ervoor kiezen Use connection parameters defined in an external account selecteert u vervolgens het account dat u wilt gebruiken en geeft u het pad op van het bestand dat u wilt downloaden.
U kunt ook de optie Quick configuration kiezen. U hoeft de URL alleen in te voeren in het veld URL.
Configuratie met Amazon S3 S3-configuration-wf
Met het Amazon S3-protocol kunt u beginnen met het downloaden van een bestand vanaf een URL of een extern account via Amazon Simple Storage Service (S3).
-
Selecteer een extern Amazon S3-account. Raadpleeg deze pagina voor meer informatie.
-
Kies Define a file path of Use a dynamic file path.
-
Geef het pad op van het bestand dat u wilt downloaden.
note caution CAUTION Jokertekens worden niet ondersteund in Amazon S3. Meerdere bestanden als doel instellen my_file_02enmy _file_3433kunt u de volgende syntaxis gebruiken:acs-myawsbucket.s3.amazonaws.com/object-path/my_file_. -
Als u de bronbestanden wilt verwijderen wanneer de overdracht is voltooid, selecteert u Delete the source files after transfer.
Configuratie met Microsoft Azure Blob-opslag azure-blob-configuration-wf
Met het Microsoft Azure Blob-protocol hebt u toegang tot een blob op een Microsoft Azure Blob Storage-account.
-
Selecteer een extern Microsoft Azure Blob-account. Raadpleeg deze pagina voor meer informatie.
-
Kies Define a file path of Use a dynamic file path.
-
Geef het pad op van het bestand dat u wilt downloaden. Dit pad kan overeenkomen met meerdere blobs. In dat geval activeert de activiteit File transfer de uitgaande overgang eenmaal per aangetroffen blob. Vervolgens worden ze in alfabetische volgorde verwerkt.
note caution CAUTION Jokertekens worden niet ondersteund om overeen te komen met meerdere bestandsnamen. In plaats daarvan moet u een voorvoegsel invoeren. Alle blobnamen die overeenkomen met dat voorvoegsel, komen in aanmerking. Hieronder vindt u een lijst met voorbeelden van bestandspaden:
- “campaign/”: Komt overeen met alle blobs in de map Campaign in de hoofdmap van de container.
- ‘campaign/new-’: Komt overeen met alle blobs met een bestandsnaam die begint met ‘new-’ en zich in de map Campaign bevindt.
- “”: Door een leeg pad toe te voegen, kunt u alle blobs afstemmen die in de container beschikbaar zijn.
Configuratie met bestanden aanwezig op de Adobe Campaign-server files-server-configuration-wf
Het protocol File(s) present on the Adobe Campaign server komt overeen met de opslagplaats die de te herstellen bestanden bevat.
Metatekens of jokertekens (bijvoorbeeld * of ?) kunnen worden gebruikt om bestanden te filteren.
Kies Define a file path of Use a dynamic file path.
Met de optie Use a dynamic file path kunt u een standaardexpressie en gebeurtenisvariabelen gebruiken om de naam van het over te dragen bestand te personaliseren. Raadpleeg deze pagina voor meer informatie.
Houd er rekening mee dat het pad relatief moet zijn ten opzichte van de map met de opslagruimte van de Adobe Campaign-server. De bestanden bevinden zich in de map sftp<yourinstancename>/. U kunt ook niet door de mappen boven de opslagruimte bladeren.
Bijvoorbeeld:
user<yourinstancename>/my_recipients.csv is correct.
../hello/my_recipients.csv is onjuist.
//myserver/hello/myrecipients.csv is onjuist.
Historialisatie-instellingen historization-settings
Telkens wanneer een activiteit Transfer file wordt uitgevoerd, worden de geüploade of gedownloade bestanden opgeslagen in een speciale map. Er wordt één map gemaakt voor elke activiteit Transfer file van een workflow. Daarom is het belangrijk om de grootte van deze map te kunnen beperken om fysieke ruimte op de server vrij te houden.
Hiervoor kunt u Historization settings definiëren in de Advanced options van de activiteit Transfer File.
Met Historization settings kunt u een maximum aantal bestanden of een totale grootte voor de map van de activiteit definiëren. Standaard zijn 100 bestanden en 50 MB geautoriseerd.
Telkens wanneer de activiteit wordt uitgevoerd, wordt de map als volgt gecontroleerd:
- Alleen bestanden die meer dan 24 uur vóór de uitvoering van de activiteit zijn gemaakt, worden in aanmerking genomen.
- Als het aantal bestanden dat in aanmerking komt, groter is dan de waarde van de parameter Maximum number of files, worden de oudste bestanden verwijderd totdat het toegestane waarde voor Maximum number of files is bereikt.
- Als de totale grootte van de bestanden die in aanmerking komen, groter is dan de waarde van de parameter Maximum size (in MB), worden de oudste bestanden verwijderd totdat de toegestane waarde voor Maximum size (in MB) is bereikt.
Uitvoervariabelen output-variables
De Transfer file activiteit genereert gebeurtenisvariabelen als output, die u in andere activiteiten kunt gebruiken, bijvoorbeeld om het aantal gedownloade dossiers te controleren gebruikend Testen activiteit.
Gebeurtenisvariabelen kunnen ook aan een andere workflow worden doorgegeven via een extern signaal (zie Een workflow aanpassen met externe parameters).
Beschikbare uitvoervariabelen zijn:
- fileName: naam van de overgedragen bestanden.
- filesCount: aantal overgedragen bestanden.