Passa al contenuto principale
Administrator Guide
Ultimo aggiornamento: 2023-06-23
Riferimenti: Proprietà del trasporto FTP-Out

Riferimenti: Proprietà del trasporto FTP-Out

Scheda Common

Proprietà
Nome attributo XML
Descrizione
ID
id
ID univoco del componente
ftp-out
all'interno dell'assieme.
Inoltra la risposta a
routes-response-to
La destinazione del messaggio di risposta per il trasporto
ftp-out
.
Eseguire quando
execute-when
Condizione che determina se il trasporto viene eseguito.
Endpoint
endpoint
Specifica l'host (e, facoltativamente, la porta) e la directory FTP in cui scrivere i file.
Segue il formato
ftp://FTP-directory
, dove
FTP-directory
è la sede di destinazione.
Esempio:
ftp://ftpserver.example.org/outputDir
La posizione della directory specificata deve essere già presente sul server FTP.
File binario
binary-file
Specifica se i file di output vengono trasferiti come file binari.
Modello file di input
input-file-pattern
Un modello di nome file per la corrispondenza di file di un tipo particolare.
Esempio: specificare
*.xls
per prelevare solo file Excel.
Immettere il tipo di contenuto
input-content-type
Il tipo di supporto incluso nel runtime per il file
content-type
valore nell'intestazione del messaggio. Un tipo di supporto è composto da almeno due parti: un tipo, un sottotipo e uno o più parametri facoltativi. Il
text
Il sottotipo ha un valore facoltativo
charset
parametro, che specifica la codifica dei caratteri.
Esempio:
text/html; charset=UTF-8
Questa proprietà è particolarmente utile nel caso di formati di file di testo non XML in cui il tipo di file multimediale e il set di caratteri non sono specificati in modo esplicito nel file.
Modello file di output
output-file-pattern
Specifica come vengono generati i nomi dei file di output. Il modello può contenere stringhe letterali e uno o più dei seguenti token:
  • ${INFILE}
    , che viene sostituito con il nome del file di input.
  • ${UUID}
    , che viene sostituito con un identificatore univoco universale.
  • ${EXT}
    , posizionato alla fine del modello, che viene sostituito con un'estensione del nome file in base al tipo di contenuto dei dati scritti nell'output del componente dell'assieme.
Metodo
method
Specifica il metodo di trasferimento:
  • put
    : scrive i file nell'endpoint FTP che contiene la directory remota.
  • list
    : elenca tutti i file e le directory nell'endpoint FTP. Utilizzare la proprietà
    Modello file di input
    con
    list
    per applicare un modello all'elenco restituito. È possibile accedere ai risultati di
    list
    utilizzando l'oggetto
    ftp
    MVEL. Esempio:
    ftp.list()
    restituisce un elenco di stringhe che contiene l'ultimo elenco recuperato.
  • get
    : recupera il primo file trovato corrispondente al valore della proprietà
    Modello file di input
    .
  • delete
    : elimina il primo file trovato corrispondente al valore della proprietà
    Modello file di input
    .
    Un file non viene eliminato automaticamente dal sito FTP dopo a
    get
    è stata eseguita. Se si desidera eliminare un file, è necessario richiamare un metodo separato. Esempio: è possibile includere un elemento separato
    ftp-out
    trasporto in modo specifico per eliminare il file.
Password
password
La password associata al nome utente utilizzato per accedere al server FTP.
Nome utente
username
Il nome utente utilizzato per accedere al server FTP.

Scheda Advanced

Proprietà
Nome attributo XML
Descrizione
Memorizzare il messaggio
store-message
Specificare
nessuno
se non diversamente indicato dall'assistenza Workday.
Per archiviare i messaggi, utilizzare lo step
store
di Studio.
Classe di trasporto
transport-class
Specifica una classe di implementazione alternativa in base all'assieme, se necessario.
È possibile modificare le classi di implementazione a livello globale modificando il file WEB-INF/classes/Spring/Assembly-bean.xml.
Ignora gli endpoint dinamici
ignore-dynamic-endpoints
Specifica se ignorare il valore dinamico WS-Addressing (WSA) nell'intestazione del messaggio in arrivo o utilizzarlo per sostituire il valore nella proprietà
Endpoint
del trasporto.
Utilizzare lo step
set-dynamic-endpoint
per specificare i dettagli di WS-Addressing.
Modalità passiva
passive-mode
Specifica se il trasporto supporta FTP in modalità passiva.
In modalità passiva, il client FTP avvia entrambe le connessioni necessarie per il trasferimento FTP. Il client contatta il server sulla porta dei comandi ed emette il comando PASV. Il server risponde, indicando su quale porta è in ascolto per la connessione dati. Il client avvia quindi la connessione dati dalla propria porta dati a quella del server specificata. Infine, il server rinvia un ACK alla porta dati del client. In modalità attiva, il client avvia la connessione del comando e il server avvia la connessione dati.
Timeout
timeout
Specifica in millisecondi un periodo di timeout per le sessioni FTP tra i client e il server FTP su cui è in attesa il trasporto.
Se non si specifica un valore, la sessione scade dopo 300000 ms (5 minuti).
File mappa tipi MIME
mime-types-map-file
Il percorso di un file di mappa per la mappatura tra i tipi MIME e le estensioni di file. Utilizzare questa proprietà per:
  • Mappare i tipi MIME alle estensioni di file quando la proprietà
    Metodo
    è impostata su
    put
    .
  • Mappare le estensioni dei file ai tipi MIME quando la proprietà
    Metodo
    è impostata su
    get
    .
Il file per questa mappatura è
ccx/conf/mime.types
. È possibile fornire una versione personalizzata di questo file.
Questo trasporto può generare nomi di file per i file di output utilizzando a
${EXT}
token posizionato alla fine di
output-file-pattern
valore
Nome file temporaneo
temp-file-name
Specifica un nome file temporaneo. Quando la proprietà
Metodo
è impostata su
put
, il file viene caricato utilizzando questo nome file temporaneo. Al termine dell'FTP, il file viene rinominato con il nome specificato dalla proprietà
Output File Pattern
.
Chiudere la connessione
close-connection
Specifica se si verifica la disconnessione al termine dell'azione FTP.
Dimensioni pool
pool-size
Numero massimo di connessioni e sessioni simultanee che possono essere supportate per host per questo componente. Se un numero di thread superiore a quello specificato tenta di connettersi allo stesso host, alcuni sono costretti ad attendere per accedere al pool.
Per rendere illimitate le dimensioni del pool, specificare un numero negativo.
Eseguire il debug
debug
Abilita la modalità di debug JSCAPE nel trasporto.