SFTP Upload
SFTP Upload
Sección titulada «SFTP Upload»Tipo: sftp-upload · Paquete: SFTP Activities v1.1.0 · Salida: string
Sube un archivo de la máquina del robot al servidor SFTP. Para entregar resultados a un sistema externo: enviar un lote de facturas, un reporte generado, un archivo de intercambio.
Cómo funciona
Sección titulada «Cómo funciona»Copia el archivo de localPath (máquina del robot) a remotePath (el servidor, incluyendo el nombre de archivo):
- Si ya existe un archivo remoto con ese nombre, se sobrescribe.
- La carpeta remota debe existir: la actividad no la crea. Prepárala con SFTP Create Directory.
- Si el archivo local no existe, falla sin tocar el servidor.
Parámetros requeridos
Sección titulada «Parámetros requeridos»| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
localPath | string | — | Ruta del archivo local a subir. |
remotePath | string | — | Ruta destino en el servidor, con el nombre de archivo (ej. "/entrada/datos.csv"). |
Parámetros opcionales
Sección titulada «Parámetros opcionales»| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
session | ZoanSftpSession | — | Sesión de SFTP Connect. Dentro de un body se hereda. |
Devuelve un string con la ruta remota del archivo subido (el mismo valor de remotePath). Desde la versión 1.1.0 el Designer la ofrece como salida.
Errores comunes
Sección titulada «Errores comunes»| Mensaje | Causa y solución |
|---|---|
No se encontró el archivo local. | localPath no existe en la máquina del robot. Revisa la ruta o compruébala antes con File Exists. |
'localPath' es obligatorio. / 'remotePath' es obligatorio. | Falta el parámetro o la expresión dio null. |
'session' debe ser una ZoanSftpSession. | La actividad está fuera del body de SFTP Connect y no recibió session. |
| Error del servidor: ruta no encontrada | La carpeta de remotePath no existe en el servidor. Créala con SFTP Create Directory. |
| Error del servidor: permiso denegado | El usuario no puede escribir en esa carpeta remota. |
Ejemplo
Sección titulada «Ejemplo»SFTP Connect host = "sftp.proveedor.com" username = "zoan" password = credential("sftp-proveedor")["password"] └─ body: SFTP Upload localPath = "C:/salida/factura_" + numero + ".xml" remotePath = "/entrada/factura_" + numero + ".xml" SFTP Exists remotePath = "/entrada/factura_" + numero + ".xml" → output: subido Log message = subido ? "Factura entregada" : "La factura no aparece en el servidor"Actividades relacionadas
Sección titulada «Actividades relacionadas»- SFTP Download — la operación inversa.
- SFTP Exists / SFTP Create Directory — preparar el destino.