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

Riferimenti: Proprietà del trasporto SFTP-Out

Scheda Common

Proprietà
Nome attributo XML
Descrizione
ID
id
ID univoco del componente
sftp-out
all'interno dell'assieme.
Inoltra la risposta a
routes-response-to
La destinazione del messaggio di risposta per il trasporto
sftp-out
.
Eseguire quando
execute-when
Specifica una 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
sftp://SFTP-directory
, dove
SFTP-directory
è la sede di destinazione.
Esempio:
sftp://sftpserver.example.org/outputDir
La posizione della directory specificata deve essere già presente sul server.
Autenticazione doppia
dual-authentication
Specifica se applicare la doppia autenticazione sia con una combinazione di nome utente/password sia con una chiave privata. Il valore predefinito è
false
, il che significa che un utente può autenticarsi con una chiave privata o una combinazione di nome utente/password, ma non con entrambe.
Se la proprietà è impostata su
false
e un utente immette una chiave privata (configurando le proprietà della chiave privata del componente
sftp-out
), l'autenticazione utilizza automaticamente il valore della chiave e il nome utente, ignorando il campo della password. Se la proprietà è impostata su
false
e non è configurata alcuna chiave privata, l'autenticazione utilizza la combinazione nome utente/password.
Se la proprietà è impostata su
true
quindi l'autenticazione utilizza sia il valore della chiave privata sia la combinazione di nome utente/password.
Impronta digitale chiave host
host-key-fingerprint
Chiave di crittografia che verrà utilizzata dal server FTP per le comunicazioni SSH.
Nome utente
username
Il nome utente utilizzato per accedere al server FTP.
Password
password
La password associata al nome utente utilizzato per accedere al server FTP.
File binario
binary-file
Specifica se i file di output vengono trasferiti come file binari.
SSL esplicito
explicit-ssl
Tipo di connessione: SSL esplicito (AUTH TLS) o SSL implicito (AUTH SSL). Impostare su
true
per utilizzare SSL esplicito.
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 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.

Scheda Avanzate

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.
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
Specifica la posizione 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.