Para desarrollo y TI corporativa
La interfaz – qué hace y cómo se llama.
TAOM ofrece procesos, atributos y funciones a través de una interfaz. Esta página describe para qué sirve y cómo es un acceso. No sustituye una referencia completa – los clientes la reciben con su acceso.
Fundamentos
Cuatro cosas por delante
Versionada
La interfaz está bajo un espacio de nombres versionado. Una versión nueva no sustituye a la anterior en silencio; las integraciones existentes siguen funcionando.
Accesos con nombre
Un acceso propio por aplicación conectada, con alcance, mandante y fecha de caducidad. Revocable por separado, el uso queda registrado.
Alcance en vez de acceso total
Solo lectura, lectura y escritura o acceso completo. Borrar exige el nivel más alto. El alcance se comprueba en cada llamada.
Ligado al mandante
Si un acceso lleva un mandante, solo alcanza sus espacios de trabajo – sea cual sea el identificador enviado.
Autenticación
Un campo de cabecera, nada más
GET https://su-entorno/wp-json/taom/v1/… Authorization: Bearer <su clave de acceso>
La clave se muestra una vez al crear el acceso y después solo se guarda como suma de comprobación. Debe estar en el servidor, nunca en una aplicación del navegador.
Áreas
Lo que se puede invocar
Espacios de trabajo y modelos
Crear, leer, modificar, recuperar versiones. Además fases, metadatos, grupos de varios diagramas y el sello de procedencia: cada archivo de modelo generado lo lleva y puede verificarse sin acceso a TAOM.
Enriquecimiento
Iniciar una ejecución, consultar su estado, recoger el resultado – para un elemento o para todo el modelo.
Eventos de Jira y Confluence
Los cambios de estado en Jira y los pasajes de texto modificados en Confluence vuelven al modelo a través de nuestra propia aplicación de Atlassian. Qué lado manda en cada dato está fijado campo por campo. Ida, vuelta y competencia por campo →
Adjuntos
Subir, listar, recuperar y eliminar documentos – ligados al elemento al que pertenecen.
Agentes
Directorio, perfil de estilo, biblioteca, así como petición y resultado de una ejecución.
Usuarios y licencia
Inicio de sesión, cuenta, estado de licencia – la base para que otra aplicación actúe en nombre de un usuario autorizado.
Presencia
Quién trabaja en un modelo en este momento. Así el trabajo conjunto también se refleja fuera de la interfaz.
Dos patrones
Cómo suele ser una integración
Consulta
La aplicación externa pregunta, TAOM responde. Adecuado para análisis, cuadros de mando y todo lo que quiera leer el estado.
Encargo y retorno
Se lanza una ejecución, TAOM responde de inmediato con una confirmación y comunica el resultado después a una dirección registrada. Necesario porque una ejecución de agente dura más de lo que una petición puede esperar.
Posible desde hace poco
Consultar todos los espacios de trabajo
La consulta sobre todo el fondo funciona: por atributos, con texto libre o mediante trece preguntas listas – por ejemplo «revisión obligatoria pero sin caso de prueba». La respuesta indica modelo, fase y rol por resultado.
Todavía no disponible
Lo que hay que añadir con sinceridad
Sugerencias al modelar
La biblioteca del Learning Model está lista. Ofrecerla como sugerencia al escribir solo está implementado en un punto.
Límites de llamadas
Los límites por acceso están previstos pero aún no fijados.