Documentación de tablas, pasos y flujos de trabajo
Descripción
Sección titulada «Descripción»Seleccione un paso o un flujo de trabajo de un proyecto y se abrirá su panel de detalles. En la parte inferior, una sección Documentación muestra una página que Weave redacta sobre el elemento a partir de la configuración guardada del proyecto. El panel de detalles de una tabla muestra en cambio sus Columnas, con el tipo y la descripción de cada una; la página que sigue describe lo que leen Weave y los asistentes de IA sobre una tabla:
- para una tabla, los pasos que la escriben y la leen, y sus columnas;
- para un paso, qué hace y dónde se ejecuta;
- para un flujo de trabajo, sus pasos en orden y las tablas que lee y escribe.
La página se redacta cada vez que selecciona el elemento, a partir de la configuración tal como está guardada en ese momento, por lo que nunca queda desactualizada y no hay nada que actualizar manualmente. Después de guardar en el mismo panel de detalles, por ejemplo una nueva descripción, la página se vuelve a redactar.
Weave AI, el chat de la pestaña Weave de un proyecto, y los asistentes de IA conectados mediante MCP pueden leer la misma página. Consulte Para asistentes de IA.
La página de una tabla
Sección titulada «La página de una tabla»- La descripción: la Nota de la tabla, mostrada como una cita. PlaidCloud establece la nota Created dynamically en una tabla que crea un paso; esa no se muestra, ya que no dice nada sobre la tabla.
- Escrita por y Leída por: cada paso, por nombre, con su tipo de paso y los flujos de trabajo en los que está. (deshabilitado) acompaña a un flujo de trabajo donde el paso está deshabilitado, y no está en ningún flujo de trabajo marca un paso que no está en uno. Un paso cuyo nombre de tabla contiene una variable que puede o no designar esta tabla se enumera con según los valores de sus variables. Un paso que da solo un nombre que comparten varias tablas se enumera con, por ejemplo, a menos que se refiera a otra de las 2 tablas con este nombre, contando únicamente las tablas que usted puede abrir. Un paso Tabla: borrar, Tabla: descartar o Tabla: eliminación in situ cuenta como escritura de la tabla que modifica, y un paso que lee una tabla y la vuelve a escribir se enumera en ambas listas.
- Ningún paso de este proyecto lee esta tabla. significa que ningún paso de este proyecto la tiene como origen. La página no comprueba paneles de control, exportaciones, otros proyectos ni nada que esté fuera de los pasos del proyecto.
- Columnas: cada columna y su tipo, con su descripción de Propiedades de la columna cuando hay una definida.
La página de un paso
Sección titulada «La página de un paso»Qué hace da una frase por cada cosa que hace el paso:
| Paso | Lo que dice la página |
|---|---|
| Asignación: dividir | Qué valor divide, de qué tabla, entre qué columnas, usando qué columna inductora y cómo se calcula cada parte; por ejemplo, “La parte de cada product es su weight dividido por el weight total del mismo cost_center, year y month.” Las columnas se nombran como las nombran las tablas de origen y de inductores. Se anota un filtro en el origen o el inductor del paso y se nombran las tablas que escribe. |
| Asignación: dividir mediante dimensión | Qué valor divide, de qué tabla y qué columna inductora usa, y cada tabla que escribe, incluidas sus tablas de asignación, de ruta y de resumen. |
| Importar | El archivo o los archivos que importa y la tabla en la que importa. |
| Exportar | La tabla que exporta y el archivo que escribe. |
| Extraer: SQL sin orígenes enumerados | Que ejecuta una consulta SQL y la tabla que escribe. |
| Tabla: borrar, Tabla: descartar, Tabla: eliminación in situ | Que borra, descarta o elimina filas de su tabla o, cuando elige tablas por búsqueda o carpeta, que actúa sobre las tablas que esa configuración elige. |
| Importar tabla externa del proyecto | Que copia una tabla de otro proyecto en una tabla de este. |
| Un paso que ejecuta otro flujo de trabajo | El flujo de trabajo que ejecuta y cómo: cuando se cumplen sus condiciones, en un bucle, como macro (una vez por cada fila de su tabla de origen, o en una ejecución simultánea) o incluyéndolo. Un flujo de trabajo elegido mediante una variable se muestra con el nombre que da el paso, y uno de otro proyecto se describe como tal. También se enumera cualquier tabla que lea el propio paso, como la tabla que recorre un bucle. |
| Cualquier otro paso | Las tablas que lee y las tablas que escribe. |
A continuación, la página indica dónde se ejecuta el paso (Es el paso 3 en seguido del flujo de trabajo, numerado como en la lista de pasos del flujo de trabajo) o que no está en ningún flujo de trabajo.
Una tabla que el paso nombra mediante una variable se muestra por su nombre, seguido de (nombrada por una variable).
La página de un flujo de trabajo
Sección titulada «La página de un flujo de trabajo»- Pasos: numerados como en la lista de pasos del flujo de trabajo, con el tipo de cada paso y la tabla que escribe, o el flujo de trabajo que ejecuta. Los pasos de un flujo de trabajo que incluye se enumeran en su lugar, tal como los muestra la lista de pasos.
- Lee desde fuera de este flujo de trabajo: tablas que un paso lee antes de que algún paso de este flujo de trabajo las escriba.
- Escribe: tablas que escriben los pasos del flujo de trabajo.
Los pasos deshabilitados se enumeran en Pasos, pero se omiten de las otras dos listas. La página lo indica, ya que una tabla que escribe un paso deshabilitado podría aparecer entonces como leída desde fuera. Las tablas que usa un flujo de trabajo que ejecuta uno de sus pasos aparecen en la página de ese flujo de trabajo.
Un paquete de traspaso de todo el proyecto
Sección titulada «Un paquete de traspaso de todo el proyecto»Para traspasar un proyecto, por ejemplo a un cliente al final de un encargo, descargue todas las páginas a la vez. En la ventana Proyectos, seleccione un proyecto y elija Descargar paquete de traspaso en el menú Acciones o en el menú contextual del botón derecho. Necesita acceso de lectura al proyecto, sus pasos, sus flujos de trabajo y sus tablas.
El paquete es un único archivo Markdown, con el nombre del proyecto (por ejemplo, Month End handover.md), y se redacta a partir de la configuración guardada en el momento de la descarga. Comienza con la descripción del proyecto y un recuento de lo que contiene, y luego tiene cuatro secciones:
- Flujos de trabajo: la página de cada flujo de trabajo. Los flujos de trabajo que ningún otro flujo de trabajo ejecuta van primero, por nombre, y a cada uno le siguen los flujos de trabajo que ejecuta, en el orden en que los ejecuta. Un flujo de trabajo ejecutado desde dos lugares se enumera una sola vez.
- Tablas: la página de cada tabla, como se describió antes, con sus columnas y las descripciones de estas.
- Métricas: la versión actual de cada definición de métrica, en frases sencillas: qué mide, a partir de qué tabla, las tablas que combina, las filas que usa, sus filas reales y de presupuesto, sus períodos y por qué se puede desglosar. Una métrica construida a partir de otras indica cómo, por ejemplo Revenue dividido por Orders. Consulte Definiciones de métricas.
- Modelos de asignación: cada cadena de pasos de asignación que se alimentan entre sí, con el paso o los pasos con los que termina y la división de cada paso, en orden de ejecución. Se omite un paso que no se ejecuta en ningún flujo de trabajo. Un modelo recibe el nombre de su flujo de trabajo o de la carpeta que comparten sus flujos de trabajo. Cuando no tiene un nombre así, lo comparte con otro modelo o lo toma de algo que su rol oculta, se titula con uno de sus pasos. Un modelo de asignación no tiene página propia fuera del paquete.
El paquete sigue las mismas reglas que una sola página para lo que su rol oculta. Un flujo de trabajo, tabla o modelo de asignación que no puede abrir se omite y se cuenta al principio, por ejemplo Omite 2 flujos de trabajo y 5 tablas que no puede abrir. Un paso que no puede abrir nunca se nombra, como en una sola página.
Lo que oculta su rol
Sección titulada «Lo que oculta su rol»Una tabla, un paso o un flujo de trabajo pueden ocultarse al rol Gerente o Explorador. Una página nunca nombra uno que su rol oculta:
- Un paso que no puede abrir se cuenta (por ejemplo, 2 pasos más que no puede abrir) y conserva su número en la lista de pasos de un flujo de trabajo.
- Una tabla, un paso o un flujo de trabajo que no puede abrir se muestra igual que uno que ya no existe (por ejemplo, una tabla que no puede abrir o que ya no existe), de modo que una página no sirva para averiguar si existe algo oculto. Los pasos omitidos de las listas de un flujo de trabajo de este modo se anotan, ya que una tabla que escribe uno de ellos podría aparecer entonces como leída desde fuera. Una tabla que un paso nombra y que usted no puede abrir, o que no existe, se muestra con el nombre que le da el paso, seguido de (no es una tabla que pueda abrir), y un flujo de trabajo igualmente con (no es un flujo de trabajo que pueda abrir).
- Solicitar la página de un elemento que su rol oculta se responde como si no existiera.
Un Arquitecto puede abrirlo todo, por lo que las páginas de un Arquitecto dicen en cambio una tabla eliminada, (tabla no encontrada), Un paso eliminado o (flujo de trabajo no encontrado).
Lo que no cubre
Sección titulada «Lo que no cubre»- Recuentos de filas, tamaños y horas de actualización.
- Tablas a las que un paso llega solo mediante su texto SQL o una expresión. La página enumera las tablas que un paso nombra en su configuración.
- Ediciones sin guardar. La página describe la configuración guardada.
Para asistentes de IA
Sección titulada «Para asistentes de IA»- Weave AI puede leer la página de una tabla, un paso o un flujo de trabajo cuando le pregunta por ello en una conversación abierta sobre un proyecto, y responder a partir de lo que dice la página. Consulte Chat de Weave AI.
- Los asistentes de IA conectados mediante MCP pueden leer la misma página con la
herramienta
doc_describe, indicando el proyecto, si el elemento es una tabla, un paso o un flujo de trabajo, y su id. Necesita acceso de lectura a pasos, flujos de trabajo y tablas, y sigue las mismas reglas sobre lo que oculta su rol. Consulte Agentes de IA (MCP).