Entrada y salida
Servidores y conectores
Un Servidor es la definición de un sistema externo (base de datos, servicio web, correo, cola, otro stxGo) que los Tasks usan.
Se crea en Servidores → + eligiendo el tipo; cada tipo muestra su formulario con los grupos Conexión, Credenciales, TLS/Seguridad y Avanzado. Todos comparten Activo, TimeOut, Log Level y los umbrales de alarma.
| Tipo | Qué hace un Task contra él | Lo esencial |
|---|---|---|
| SQL Server, Sybase, Oracle, PostgreSQL, MySQL | Llama a un stored procedure (o función en PostgreSQL) y recibe las filas como salida repetida. | Conexión, credenciales (SQL Server admite autenticación Windows), cifrado TLS opcional. Fuentes: descubrir los SP del catálogo o cargar un script SQL. Generar desde firma arma Entrada (parámetros), Salida (filas) y Fault. Solo el primer result set; sin reintentos. |
| Web (REST/JSON) | Hace una acción HTTP (get, post, put, patch, delete) sobre una ruta con huecos {id}; el motor convierte JSON a XML y viceversa. | URL base, formato del body, autenticación None, Bearer, API key, Basic u OAuth2 client-credentials con renovación automática, headers adicionales, TLS con CA propia y certificado de cliente. Tipo JSON (Número, Booleano) por campo. La respuesta trae _http (estado y headers). |
| Web Service (SOAP) | Arma el sobre SOAP 1.1 o 1.2 según el WSDL y parsea la respuesta. | URL, SOAP Action, namespaces, versión; credenciales básicas, autenticación HTTP y TLS como en REST. Chips de namespace y nil por campo, tipo XSI. Variante MAS Connectivity con token calculado por el motor. |
| Web Service INS, Web Service BNCR | Variantes SOAP para proveedores específicos. | Misma base que SOAP; INS arma su propia trama cifrada. |
| Correo (SMTP) | Envía un correo con destinatarios, asunto, cuerpo y adjuntos. | Servidor, puerto (587, 465 o 25), seguridad de transporte, autenticación Basic u OAuth2 (Microsoft 365, Gmail). Mensaje con estructura SMTP_MSG; adjuntos desde disco o embebidos en Base64. |
| IBM MQ | Pone un mensaje en una cola y espera la respuesta correlacionada en otra. | Host, puerto, canal, queue manager, colas de request, reply y ReplyTo, timeouts y reintentos. Usa un puente aparte; sin él el servidor queda deshabilitado y el motor sigue. |
| TCP Simple | Envía una trama XML o plana a otro sistema o a otro motor stxGo. | Host, puerto, codificación, largo de trama, fin de registro. Fuente: catálogo de otra instancia stxGo. |
Manejo de errores en cualquier Task
Un fallo vuelca su detalle en el mensaje Fault del Task y activa la rama de error; después va un gateway con condición Resultado. Los campos reservados Mensaje, _http y _transporte (tipo SIN_COMUNICACION, TIMEOUT, CANCELACION o CONFIGURACION, y fase CONEXION, ENVIO, RECEPCION o ESPERA_POOL) permiten distinguir un error de negocio de un corte de transporte.
Un corte en recepción no dice si el servidor procesó: hay que conciliar.
Caché en Tasks
Para consultas que no cambian, se marca Caché en el Task con un TTL (5m, 1h, 1d): el motor responde con la última respuesta exitosa sin llamar al servidor, y la bitácora marca el paso como servido desde caché. Se limpia desde el Task o desde Consola → Métricas.
Nunca para pagos, reversiones ni saldos.