Academy
CLI y MCP

CLI Dattos: comandos y capacidades

CLI Dattos: comandos y capacidades

Este artículo es la referencia de los comandos de la CLI Dattos, organizados por área. Todos aceptan --help para consultar la documentación completa de las flags, y dattos status-glossary explica el significado de cualquier estado devuelto por la plataforma. Para la instalación y autenticación, consulta "CLI Dattos: instalación y primeros pasos".

Alcance actual: la CLI cubre la Automatización de Procesos (flujos, ejecuciones, conciliación, informes), la Gestión de Tareas y la administración de la plataforma. El módulo Comprobación de Cuentas todavía no está disponible mediante la CLI; su cobertura está prevista en la evolución del producto. Requiere Dattos 16.4 o superior.

Flujos y ejecución (dattos etl)

El grupo central de la CLI: cubre el ciclo de vida de los flujos de preparación de datos y conciliación:

  • Crear y construir con Dattos AI: etl create --name <nome> crea el análisis; etl add-source --etl <id> --file <arquivo> añade fuentes (xlsx, csv, pdf, xml); etl pipeline create "<descrição em linguagem natural>" --etl <id> construye el flujo completo con inteligencia artificial (acepta --rules <documento> con las reglas de negocio). El atajo etl new lo hace todo en una sola llamada.

  • Ejecutar: etl start <id> --date <AAAA-MM-DD> inicia la ejecución para una fecha de referencia; --file carga el archivo antes, --wait espera hasta que finalice, --incremental conserva los datos ya cargados.

  • Supervisar y gestionar: etl execution-status <id> --date <data>, etl list, etl get <id>, etl resolve <código> (traduce códigos a identificadores), etl datasources <id>, etl publish <id> (promueve el borrador a versión publicada) y etl activate/etl deactivate.

  • Copia de seguridad y restauración: etl download <id> descarga el blueprint .xdtt del flujo; etl upload <id> --file <blueprint> lo restaura.

  • Calendario: etl set-calendar cambia el calendario de ejecución del flujo.

  • Construcción avanzada: para crear el flujo etapa por etapa mediante programación, existen etl add-step, etl connect, etl configure-step, etl set-params, etl add-matching, etl components (catálogo y parámetros de cada etapa), etl formulas (referencia de la Fórmula Dattos), etl sql-help, etl step-data (muestra de la salida de una etapa) y etl refresh-sample.

No existe la eliminación definitiva de un flujo. El comando etl deactivate equivale a eliminarlo: oculta el flujo de los listados y puede revertirse con etl activate.

Consulta de resultados

  • dattos loads: loads get <análise> <data> devuelve la carga y sus conjuntos de datos; loads list-dates muestra las fechas de referencia que contienen datos; loads views muestra las vistas disponibles.

  • dattos datasets: datasets search <análise> <load> <dataset> consulta las filas del resultado, con paginación y filtros en JSON.

  • dattos matching: matching status muestra los totales de la conciliación (conciliados, pendientes), matching summary muestra el resumen por columna y matching get devuelve los registros. Las reglas se encuentran en matching rules (add, update, delete, active), el catálogo en matching configs list, los responsables en matching responsible list y el avance en el flujo de aprobación en matching stage.

Exportación (dattos reports)

  • reports generate <análise> --load-id <id> --dataset-id <id> --format csv|xlsx — generación asíncrona.

  • reports status supervisa el proceso y reports download <análise> <reportId> --output <arquivo> descarga el resultado.

Límite de formato: por encima de 1 millón de filas, la exportación solo está disponible en CSV.

Gestión de Tareas (dattos tasks)

Lectura y escritura completas en el módulo de tareas:

  • Listar y filtrar: tasks list combina filtros de carpeta, responsable, etiqueta y plazo, con paginación.

  • Ver detalles: tasks get <id> muestra todos los detalles, incluidos los contadores de comentarios y archivos adjuntos.

  • Crear: tasks create acepta título, fechas y recurrencia — diaria, semanal, mensual o anual, con variaciones como "solo días laborables", "3 días laborables antes de que termine el mes" o "segunda semana del mes".

  • Actualizar y mover: tasks update modifica campos; el cambio de etapa siempre se realiza mediante tasks move (en ambos sentidos).

  • Registrar: tasks comment añade un comentario y tasks attach adjunta un archivo o una URL.

  • Exportar: tasks report --output <arquivo.xlsx> descarga el informe de tareas.

Dos filtros que se parecen, pero no son lo mismo. La etapa es el paso manual de la tarea (pendiente, en curso, completada, cancelada). El estado lo calcula la plataforma a partir de los plazos (atrasada, dentro del plazo, completada a tiempo, completada con retraso, completada anticipadamente, cancelada).

Administración

  • dattos users: listar, crear, actualizar, bloquear y eliminar usuarios; users set-roles define los perfiles; users sessions y users kill-session gestionan las sesiones activas.

  • dattos roles: gestión de los perfiles de privacidad — CRUD, alcance de carpetas (roles folders) y niveles de aprobación de conciliación (roles approval-levels).

  • dattos connectors: conectores de bases de datos — crear, probar (connectors test), activar/desactivar.

  • dattos calendars: consulta de los calendarios de ejecución.

  • dattos batch: operaciones masivas — batch batch-start ejecuta varios análisis en secuencia; batch batch-create --file <usuarios.json> crea usuarios por lotes.

  • dattos folders: navegación, selección del contexto de carpeta y creación de carpetas.

Atención con users set-roles y roles folders set: ambos sustituyen la lista completa, no añaden elementos. Para incluir un elemento conservando los demás, usa roles folders add (y remove para retirarlo).

Utilidades

  • dattos doctor [--deep] — diagnóstico de configuración, conectividad, autenticación, versión de la instancia y carpeta activa.

  • dattos config profile list|switch — perfiles para múltiples instancias/entornos.

  • dattos cache clear — limpia la caché local de consultas (TTL de 5 minutos; las operaciones de escritura la invalidan automáticamente).

  • dattos mcp install <ferramenta> — configura el servidor MCP local en los asistentes de inteligencia artificial. Para la opción alojada, que es la recomendada, consulta el artículo sobre MCP.

  • dattos version y dattos status-glossary.

Comportamiento y límites

  • Archivos aceptados para la carga: .csv, .edi, .ofx, .pdf, .rem, .ret, .txt, .xlsx, .xls, .xlsb, .xml.

  • Las eliminaciones requieren confirmación: los comandos destructivos (users delete, roles delete, connectors delete, matching rules delete, users kill-session) requieren la flag --yes.

  • Límite de solicitudes: al recibir HTTP 429, la CLI vuelve a ejecutar automáticamente hasta 3 veces, con una espera progresiva (5 s, 10 s, 20 s).

  • Tiempo de espera: 30 s en las llamadas comunes; 120 s en cargas y descargas; 10 minutos en los flujos de inteligencia artificial (streaming).

  • Códigos de salida: 0 éxito, 1 error de la API, 2 autenticación/configuración; los errores se muestran en JSON en stderr con next_step y correlation_id para el soporte.

Artículos relacionados

¿Te fue útil?
¿Te fue útil?