Saltar al contenido principal
Administrator Guide
Última actualización: 2023-06-23
Referencia: propiedades del transporte sftp-out

Referencia: propiedades del transporte sftp-out

Ficha Common

Propiedad
Nombre de atributo XML
Descripción
ID
id
El ID exclusivo del componente
sftp-out
en el ensamblaje.
Envío de respuesta a
routes-response-to
El destino del mensaje de respuesta para el transporte
sftp-out
.
Ejecutar cuando
execute-when
Especifica una condición que determina si se ejecuta el transporte.
Punto final
endpoint
Especifica el host (y, opcionalmente, el puerto) y el directorio FTP en los que se escribirán los archivos.
Sigue el formato
sftp://SFTP-directory
, donde
SFTP-directory
es la ubicación de destino.
Ejemplo:
sftp://sftpserver.example.org/outputDir
La ubicación de directorio que especifique ya debe existir en el servidor.
Autenticación dual
dual-authentication
Especifica si se debe aplicar la autenticación dual con una combinación de nombre de usuario y contraseña y una clave privada. El valor por defecto es
false
, lo que significa que un usuario puede autenticarse con una clave privada o con una combinación de nombre de usuario y contraseña, pero no con ambas.
Si la propiedad se establece en
false
y un usuario introduce una clave privada (configurando las propiedades de clave privada del componente
sftp-out
), la autenticación utiliza automáticamente ese valor de clave y el nombre de usuario, ignorando el campo de contraseña. Si la propiedad se establece en
false
y no se ha configurado ninguna clave privada, la autenticación utiliza la combinación de nombre de usuario y contraseña.
Si la propiedad se establece en
true
la autenticación utiliza tanto el valor de clave privada como la combinación de nombre de usuario y contraseña.
Huella digital de clave de host
host-key-fingerprint
La clave de cifrado que utilizará el servidor FTP para las comunicaciones SSH.
Nombre de usuario
username
El nombre de usuario utilizado para acceder al servidor FTP.
Contraseña
password
La contraseña asociada al nombre de usuario utilizado para acceder al servidor FTP.
Archivo binario
binary-file
Especifica si los archivos de resultado se transfieren como binarios.
SSL explícito
explicit-ssl
Tipo de conexión: SSL explícito (AUTH TLS) o SSL implícito (AUTH SSL). Definir en
true
para utilizar SSL explícito.
Patrón de archivo de entrada
input-file-pattern
Un patrón de nombre de archivo para cotejar archivos de un tipo concreto.
Ejemplo: especifique
*.xls
para seleccionar solo archivos de Excel.
Tipo de contenido de entrada
input-content-type
El tipo de elemento multimedia que incluye el tiempo de ejecución para el
content-type
en la cabecera del mensaje. Un tipo de elemento multimedia consta de al menos dos partes: un tipo, un subtipo y uno o varios parámetros opcionales. El
text
el subtipo tiene un valor opcional
charset
, que especifica la codificación de caracteres.
Ejemplo:
text/html; charset=UTF-8
Esta propiedad es especialmente útil en el caso de formatos de archivo de texto no XML en los que el tipo de elemento multimedia y el conjunto de caracteres no se indican explícitamente en el archivo.
Patrón de archivo de resultado
output-file-pattern
Especifica cómo se generan los nombres de los archivos de resultado. El patrón puede contener cadenas de literales, así como uno o varios de los siguientes tokens:
  • ${INFILE}
    , que se sustituye por el nombre del archivo de entrada.
  • ${UUID}
    , que se sustituye por un identificador único universal.
  • ${EXT}
    , situado al final del patrón, que se sustituye por una extensión de nombre de archivo basada en el tipo de contenido de los datos que se escriben en la salida del componente de ensamblaje.
Método
method
Especifica el método de transferencia:
  • put
    : escribe archivos en el punto final FTP que contiene el directorio remoto.
  • list
    : enumera todos los archivos en el punto final de FTP. Utilice la propiedad
    Patrón de archivo de entrada
    con
    list
    para aplicar un patrón al listado que se devuelve. Puede acceder a los resultados de la
    list
    mediante el objeto
    ftp
    de MVEL. Ejemplo:
    ftp.list()
    devuelve una lista de cadenas que contiene el último listado recuperado.
  • get
    : recupera el primer archivo encontrado que coincida con el valor de la propiedad
    Patrón de archivo de entrada
    .
  • delete
    : elimina el primer archivo encontrado que coincida con el valor de la propiedad
    Patrón de archivo de entrada
    .
    Un archivo no se elimina automáticamente del sitio FTP después de un
    get
    se ha realizado. Si desea eliminar un archivo, debe invocar un método independiente. Ejemplo: puede incluir un
    ftp-out
    transport específicamente para eliminar el archivo.

Ficha Avanzado

Propiedad
Nombre de atributo XML
Descripción
Almacenar mensaje
store-message
No especifique
ninguno,
a menos que el servicio de asistencia de Workday le indique lo contrario.
Para almacenar mensajes, utilice el paso
store
de Studio.
Clase de transporte
transport-class
Especifica una clase de implementación alternativa por ensamblaje, si es necesario.
Puede cambiar las clases de implementación de forma global al editar el archivo WEB-INF/classes/spring/assembly-bean.xml.
Ignorar puntos finales dinámicos
ignore-dynamic-endpoints
Especifica si se ignora el valor dinámico de WS-Addressing (WSA) en la cabecera del mensaje entrante o se utiliza para sustituir el valor de la propiedad
Punto final
del transporte.
Utilice el paso
set-dynamic-endpoint
para especificar los detalles de WS-Addressing.
Tiempo de espera
timeout
Especifica en milisegundos un periodo de tiempo de espera para las sesiones FTP entre clientes y el servidor FTP en el que está a la escucha el transporte.
Si no especifica ningún valor, la sesión se interrumpe después de 300 000 milisegundos (5 minutos).
Archivo de asignación de tipos Mime
mime-types-map-file
Especifica la ubicación de un archivo de asignación para la asignación entre tipos MIME y extensiones de archivo. Utilice esta propiedad para:
  • Asigne tipos MIME a extensiones de archivo cuando la propiedad
    Método
    esté definida como
    put
    .
  • Asigne extensiones de archivo a tipos MIME cuando la propiedad
    Método
    se establezca en
    get
    .
El archivo de esta asignación es
ccx/conf/mime.types
. Puede proporcionar su propia versión de este archivo.
Este transporte puede generar nombres de archivo para sus archivos de salida mediante un
${EXT}
token colocado al final de la
output-file-pattern
valor
Nombre de archivo temporal
temp-file-name
Especifica un nombre de archivo temporal. Cuando la propiedad
Método
se establece en
put
, el archivo se carga con este nombre de archivo temporal. Una vez finalizado el FTP, se cambia el nombre del archivo al especificado por la propiedad
Patrón de archivo de salida
.
Cerrar conexión
close-connection
Especifica si la desconexión se produce cuando finaliza la acción de FTP.
Tamaño de partida
pool-size
El número máximo de conexiones y sesiones simultáneas que se pueden admitir por host para este componente. Si más hilos de los especificados intentan conectarse al mismo host, algunos se ven obligados a esperar para acceder al grupo.
Para que el tamaño del grupo sea ilimitado, especifique un número negativo.
Depuración
debug
Activa el modo de depuración JSCAPE en el transporte.