Attività Transfer file transfer-file
Descrizione description
L’attività Transfer file ti consente di ricevere o inviare file, verificare se sono presenti o elencarli in Adobe Campaign.
Contesto di utilizzo context-of-use
La modalità di estrazione dei dati viene definita durante la configurazione dell’attività. Il file da caricare può rappresentare un elenco di contatti, ad esempio.
Puoi utilizzare questa attività per recuperare dati che sono quindi strutturati con l’attività Load file.
Argomenti correlati:
Configurazione configuration
-
Rilascia un’attività Transfer file nel flusso di lavoro.
-
Seleziona l’attività, quindi aprila utilizzando il pulsante
-
Utilizza l’elenco a discesa nel campo Action per selezionare una delle seguenti azioni dell’attività:
- File download: ti consente di scaricare un file.
- File upload: ti consente di caricare un file. Il caricamento di un file da un file di Adobe Campaign genera una voce di registro nel menu Export audits. Per ulteriori informazioni sui controlli delle esportazioni, consulta la sezione Controllo delle esportazioni.
- Test to see if file exists: ti consente di verificare se è presente un file.
- File listing: ti consente di elencare i file presenti sul server definito nella scheda Protocol. Puoi utilizzare questa azione principalmente a scopo di debug, per verificare se l’attività è configurata in base alle tue esigenze prima di scaricare i file dal server remoto.
-
Seleziona il protocollo da utilizzare:
-
Il Additional options disponibile a seconda del protocollo selezionato, ti consente di aggiungere parametri al protocollo.
Puoi eseguire le seguenti azioni:
-
Delete the source files after transfer: cancella i file sul server remoto. Se lasci questa opzione deselezionata, assicurati di monitorare manualmente le dimensioni del contenuto archiviato nella directory SFTP.
-
Sorting files: consente di ordinare i file in ordine alfanumerico. Questa opzione è disabilitata per impostazione predefinita.
-
List all files: questa opzione è disponibile quando selezioni la File listing azione in General scheda. Ti consente di indicizzare tutti i file presenti sul server nella variabile dell’evento vars.filenames, in cui i nomi dei file sono separati da “n” caratteri.
-
-
La sezione If no files are found della scheda Advanced options ti permette di configurare azioni specifiche in caso di errori o file inesistenti rilevati all’avvio dell’attività.
Puoi anche definire il numero dei tentativi. I diversi tentativi vengono visualizzati nel log di esecuzione del flusso di lavoro.
-
Conferma la configurazione dell’attività e salva il flusso di lavoro.
Configurazione con HTTP HTTP-configuration-wf
Il protocollo HTTP ti consente di iniziare a scaricare un file da un account esterno o da un URL.
Con questo protocollo, puoi scegliere di Use connection parameters defined in an external account opzione. In questo caso, seleziona l’account desiderato e specifica il percorso del file da scaricare.
Puoi anche scegliere l’opzione Quick configuration. Devi solo inserire l’URL nel relativo campo.
Follow redirections, Ignore the HTTP return code, e Add received HTTP headers to the file sono le opzioni aggiuntive disponibili quando si seleziona il protocollo HTTP.
Configurazione con SFTP SFTP-configuration-wf
Il protocollo SFTP ti consente di iniziare a scaricare un file da un URL o da un account esterno.
Con questo protocollo, puoi scegliere di Use connection parameters defined in an external account , quindi selezionare l'account desiderato e specificare il percorso del file da scaricare.
Puoi anche scegliere l’opzione Quick configuration. Devi solo inserire l’URL nel relativo campo.
Configurazione con Amazon S3 S3-configuration-wf
Il protocollo Amazon S3 ti consente di iniziare a scaricare un file da un URL o da un account esterno tramite Amazon Simple Storage Service (S3).
-
Seleziona un account esterno di Amazon S3. Per ulteriori informazioni, consulta questa pagina.
-
Scegli se vuoi Define a file path o Use a dynamic file path.
-
Specifica il percorso del file da scaricare.
note caution CAUTION I caratteri jolly non sono supportati in Amazon S3. Per eseguire il targeting di più file come my_file_02emy _file_3433, è possibile utilizzare la sintassi seguente:acs-myawsbucket.s3.amazonaws.com/object-path/my_file_. -
Se desideri eliminare i file sorgente al termine del trasferimento, seleziona la casella Delete the source files after transfer.
Configurazione con l’archiviazione BLOB di Microsoft Azure azure-blob-configuration-wf
Il protocollo BLOB di Microsoft Azure ti consente di accedere a BLOB che si trovano in un account di archiviazione BLOB di Microsoft Azure.
-
Seleziona un account esterno Microsoft Azure Blob. Per ulteriori informazioni, consulta questa pagina.
-
Scegli se vuoi Define a file path o Use a dynamic file path.
-
Specifica il percorso del file da scaricare, che può corrispondere a più BLOB. In questo caso, l’attività File transfer attiva la transizione in uscita ogni volta che viene trovato un BLOB. Vengono quindi elaborati in ordine alfabetico.
note caution CAUTION I caratteri jolly non sono supportati nel caso vengano riscontrati gli stessi nomi per più file. Invece, devi immettere un prefisso. Tutti i nomi dei BLOB che corrispondono a quel prefisso risultano idonei. Di seguito trovi alcuni esempi di percorsi di file:
- "campaign/": rileva tutti i BLOB nella cartella Campaign che si trova nella directory principale del contenitore.
- "campaign/new-": rileva tutti i BLOB con un nome di file che inizia con "new-" e si trova nella cartella Campaign.
- "": l’aggiunta di un percorso vuoto ti consente di far coincidere tutti i BLOB disponibili nel contenitore.
Configurazione con file presenti sul server Adobe Campaign files-server-configuration-wf
Il protocollo File(s) present on the Adobe Campaign server corrisponde all’archivio contenente i file da recuperare.
Metacaratteri o caratteri jolly (ad esempio * o ?) può essere utilizzato per filtrare i file.
Scegli se desideri Define a file path o Use a dynamic file path. L’opzione Use a dynamic file path ti consente di utilizzare un’espressione standard e variabili di eventi per personalizzare il nome del file da trasferire. Per ulteriori informazioni, consulta questa pagina.
Il percorso deve essere relativo alla directory dello spazio di archiviazione del server di Adobe Campaign. I file si trovano nella directory sftp<nomeistanza>/. Inoltre, non è possibile sfogliare le directory al di sopra dello spazio di archiviazione.
Ad esempio:
user<yourinstancename>/my_recipients.csv è corretta.
../hello/my_recipients.csv non è corretto.
//myserver/hello/myrecipients.csv non è corretto.
Impostazioni di storicizzazione historization-settings
Tutte le volte che esegui un’attività Transfer file, memorizzi i file caricati o scaricati in una cartella dedicata. Viene creata una cartella per ogni attività Transfer file di un flusso di lavoro. Pertanto, è importante poter limitare le dimensioni di questa cartella per preservare lo spazio fisico sul server.
A questo scopo, puoi definire le Historization settings nelle Advanced options dell’attività Transfer File.
Historization settings ti consentono di definire un numero massimo di file o una dimensione totale per la cartella dell’attività. Per impostazione predefinita sono autorizzati 100 file e 50 MB.
Tutte le volte che l’attività viene eseguita, la cartella viene controllata come segue:
- Vengono presi in considerazione solo file creati più di 24 ore prima dell’esecuzione dell’attività.
- Se il numero di file considerati è maggiore del valore del parametro Maximum number of files, i file meno recenti vengono eliminati finché non viene raggiunto il Maximum number of files consentito.
- Se la dimensione totale dei file considerati è maggiore del valore del parametro Maximum size (in MB), i file meno recenti vengono eliminati finché non viene raggiunta la Maximum size (in MB) consentita.
Variabili di output output-variables
Il Transfer file l’attività genera variabili evento come output, che puoi sfruttare in altre attività, ad esempio per verificare il numero di file scaricati utilizzando una Test attività.
Tieni presente che le variabili evento possono anche essere passate a un altro flusso di lavoro utilizzando un segnale esterno (vedi Personalizzazione di un flusso di lavoro con parametri esterni).
Le variabili di output disponibili sono:
- fileName: nome dei file trasferiti.
- filesCount: numero di file trasferiti.