Lea antes:
../conectores.md(mapa de estados) yfichas.md(índice de las fichas).
⚠️ Aviso — Roadmap (no disponible)#
Este conector no está implementado: la configuración y la ejecución son rechazadas por el producto (nada finge éxito).
La plataforma Senior X exige gateway y credencial de partner homologado; no hay acceso público para un conector genérico.
El resto de esta página describe la especificación planificada (campos y forma de conexión), no un recurso activo.
Qué es#
Conector planificado: la lectura de datos del ERP y de RRHH de Senior por la plataforma Senior X aún no existe — hoy los datos ingresan mediante exportaciones programadas al área de recepción de su entorno.
Modos de ingestión soportados:
- Nosotros buscamos — Nosotros buscamos los datos en su fuente.
Para qué sirve#
Traer los datos de Senior a su datalake y disponibilizarlos a las capas Bronze/Silver/Gold, a los modelos de BI y al wizard de preguntas en lenguaje natural.
Cuándo usar / cuándo no usar#
Use cuando necesita consolidar esta fuente en el datalake de forma programada, con aislamiento por workspace.
No use para producción hoy: el conector está en Roadmap. Mientras tanto, para archivos, use el modo "Você deposita" (envíe los archivos a la landing).
Plan y permisos#
- Plan: núcleo del producto (los conectores forman parte de todos los planes; el límite es el número de fuentes del plan).
- Acceso: exige workspace activo — con la suscripción en mora, suspendida o cancelada, la ejecución queda bloqueada.
- Desconexión: la ejecución de ingestión puede ser apagada temporalmente (mantenimiento o incidente). Cuando eso sucede, la pantalla informa que el recurso está indisponible en este momento.
Requisitos previos#
- Una cuenta Senior con acceso a los datos que desea ingerir.
- Cuando el conector exista, la conexión usará las APIs de la plataforma Senior X con credencial de aplicación emitida por el gateway. Hoy los datos entran por exportaciones programadas al área de recepción de su entorno.
Credenciales#
Forma de autenticación: Credenciales de aplicación (client id/secret) intercambiadas por un token de acceso.
Este conector no exige secretos propios (modo de upload / sin credencial en la plataforma).
Los secretos nunca se re-muestran y pasan por la redacción en todo error/log (token crudo, URL-encoded y en JSON).
Campos del formulario#
| Campo | Rótulo | Tipo | Obligatorio | Observación |
|---|---|---|---|---|
tenantSenior | Tenant en Senior X (informativo) | texto | no | Solo para registro de interés — la configuración es rechazada mientras el conector no exista. |
Paso a paso#
- En el menú Dados → Conexões, use Nova conexão.
- Elija Senior en el catálogo.
- Complete los campos del formulario (vea la tabla arriba).
- Use Testar conexão. El resultado viene separado en Conectividade, Autenticação y Listagem/leitura — cada uno con OK, Falló, No aplica o No probado. Una capacidad sin prueba propia para este conector aparece como No aplica, y No aplica nunca cuenta como éxito.
- Use Salvar conexão. Guardar NO inicia ninguna ingestión.
- En la tarjeta de la conexión, use Montar extração (o vaya a Orquestração → Pipelines y use Conectar fonte). El pipeline apunta a la conexión guardada — la credencial no se copia.
- En la revisión, Publicar (agenda desligada) crea la versión 1 sin ejecutar nada. Después, Ativar agenda y Executar agora son acciones separadas.
En el estado actual (Roadmap), los pasos 4–5 son rechazados por el producto.
Ejemplo — prueba de conexión#
Configuración de ejemplo (todos los valores son ficticios; los secretos aparecen enmascarados):
# Exemplo sintético (valores fictícios — não são credenciais reais)
tenantSenior = <tenantSenior>Resultado esperado#
El producto rechaza la configuración con un mensaje claro de que el conector está en Roadmap.
Límites y costos#
- Paginación: tope duro por ejecución (por defecto 10.000 páginas / 5.000.000 filas); mecanismo anti-bucle.
- Carga SaaS: por defecto
batchSize5.000,maxRows200.000 por recurso. - Volumen estimado: ~1 GB/mes (estimación de catálogo, no medición).
- **
Seguridad#
- Alcance por workspace: cada cliente lee y escribe solo en su propio datalake (
<prefixo>_bronze/_silver/_gold); nunca hay filtración entre workspaces. - Secretos cifrados: material sensible es cifrado con AES-256-GCM antes de ser almacenado. El cofre externo de credenciales es opcional y activado por conexión; sin él, el valor cifrado queda en la base. Cambiar el valor aquí NO revoca la credencial en el origen.
- Redacción: todo error/log pasa por la redacción de secretos (crudo, URL-encoded y en JSON).
- Producción no finge: un camino que caería en mock activa la protección de producción (falla explícita en lugar de simular éxito).
Errores comunes#
- Credencial rechazada (401/403) — el proveedor no aceptó la credencial: expirada, revocada o sin el permiso necesario. Reconecte la fuente (la fuente y el historial se conservan; no recree la fuente).
- Límite de solicitudes (429) — el proveedor pidió esperar. La extracción respeta
Retry-Aftery reintenta; si se repite, aguarde y reduzca la frecuencia de la agenda. - Recurso no encontrado — verifique el identificador del recurso (cuenta, objeto, informe) y los permisos concedidos.
- Cursor de paginación atascado — la extracción termina cuando el cursor de la API no avanza (mecanismo anti-bucle). Si ocurre en ejecuciones seguidas, abra un ticket con el soporte informando el conector y el recurso.
- Ruta de registros vacía — la respuesta llegó sin registros en el lugar esperado. Verifique el recurso seleccionado y los filtros (periodo, cuenta, estado) antes de asumir que no hay datos.
Solución de problemas#
- Use Testar conexão para aislar problemas de credencial/red antes de programar.
- Monitoree las ejecuciones en la observabilidad por conector (tasa de error, p50/p95, freshness).
- Un cambio de esquema en el origen es señalado por el schema drift (columna nueva = info; columna removida/tipo cambiado = atención).
Relacionados#
../conectores.md— catálogo de conectores por estado../ingestao-incremental-backfill.md— full, incremental por watermark, backfill y checkpoint../pipeline-medalhao.md— capas Bronze/Silver/Gold y calidad../agendamento-retry-dlq.md— programación, retry/backoff y DLQ../custo-limites-seguranca.md— costo, topes y seguridad por workspace
Última revisión: 2026-10-04. Ficha generada automáticamente del catálogo de conectores del producto.