Documentación de tablas, pasos y flujos de trabajo

Descripción

Seleccione una tabla, un paso o un flujo de trabajo en un proyecto y se abre su panel de detalles. En la parte inferior, una sección Documentación muestra una página que Weave escribe sobre él a partir de la configuración guardada del proyecto:

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 escribe 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. No interviene ninguna IA, por lo que funciona cuando no hay ningún proveedor de IA disponible. Después de un guardado en el mismo panel de detalles, como una nueva descripción, la página se vuelve a escribir.

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

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á. (desactivado) sigue a un flujo de trabajo donde el paso está desactivado, y fuera de cualquier flujo de trabajo marca un paso que no está en ninguno. Un paso cuyo nombre de tabla contiene una variable que puede o no nombrar 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 solo las tablas que usted puede abrir. Un paso Tabla: borrar, Tabla: descartar o Tabla: eliminación in situ cuenta como escritor de la tabla que cambia, y un paso que lee una tabla y la vuelve a escribir se enumera en ambas.
Ningún paso de este proyecto lee esta tabla. significa que ningún paso de este proyecto la enumera como origen. La página no comprueba paneles de control, exportaciones, otros proyectos ni nada ajeno a los pasos del proyecto.
Columnas: cada columna y su tipo, con su descripción de Propiedades de la columna cuando hay una establecida.

La página de un paso

Qué hace da una frase por cada cosa que hace el paso:

Paso	La página dice
Asignación: dividir	Qué valor divide de qué tabla, entre qué columnas, usando qué columna de inductor, 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 inductor. Se anota un filtro en el origen o el inductor del paso, y se nombran las tablas en las que escribe.
Asignación: dividir mediante dimensión	Qué valor divide de qué tabla y qué columna de inductor usa, y todas las tablas en las que escribe, incluidas sus tablas de asignación, de ruta y de resumen.
Importar	El archivo o 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 en la 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 elige esa configuración.
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, en el caso de una ejecución concurrente) o incluyéndolo. Un flujo de trabajo elegido mediante una variable se muestra con el nombre que le 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 de 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

Pasos: numerados como en la lista de pasos del flujo de trabajo, con el tipo de cada paso y la tabla en la que escribe, o el flujo de trabajo que ejecuta. Los pasos de un flujo de trabajo que incluye se enumeran en su lugar, como los muestra la lista de pasos.
Lee desde fuera de este flujo de trabajo: tablas que un paso lee antes de que cualquier paso de este flujo de trabajo las escriba.
Escribe: tablas que escriben los pasos del flujo de trabajo.

Los pasos desactivados 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 desactivado puede aparecer entonces como leída desde fuera. Las tablas que usa un flujo de trabajo que ejecuta uno de sus pasos están en la página propia de ese flujo de trabajo.

Un paquete de traspaso para 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. Necesita acceso de lectura al proyecto, a sus pasos, a sus flujos de trabajo y a sus tablas.

El paquete es un único archivo Markdown, con el nombre del proyecto (por ejemplo, Month End handover.md) y se escribe a partir de la configuración guardada cuando lo 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 cada uno va seguido de los flujos de trabajo que ejecuta, en el orden en que los ejecuta. Un flujo de trabajo ejecutado desde dos lugares se enumera una vez.
Tablas: la página de cada tabla, como se describió antes, incluidas sus columnas y sus descripciones.
Métricas: la versión actual de la definición de cada métrica, en frases sencillas: qué mide, 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 Ingresos divididos por Pedidos. Consulte Definiciones de métricas.
Modelos de asignación: cada cadena de pasos de asignación que se alimentan unos a otros, con el paso o 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 tal nombre, lo comparte con otro modelo, o lo toma de algo que su rol oculta, se titula con uno de sus pasos en su lugar. Un modelo de asignación no tiene página propia fuera del paquete.

El paquete sigue las mismas reglas que una sola página en cuanto a 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

Una tabla, un paso o un flujo de trabajo pueden estar ocultos para el rol de Gerente o de 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 lee 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 se puede usar para averiguar si algo oculto existe. Los pasos omitidos de las listas de un flujo de trabajo de esta manera se anotan, ya que una tabla que uno de ellos escribe puede 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 de igual forma con (no es un flujo de trabajo que pueda abrir).
Solicitar la página de un elemento que su rol oculta responde como si no estuviera allí.

Un Arquitecto puede abrirlo todo, por lo que las páginas de un Arquitecto dicen una tabla eliminada, (tabla no encontrada), Un paso eliminado o (flujo de trabajo no encontrado) en su lugar.

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

Weave AI puede leer la página de una tabla, un paso o un flujo de trabajo cuando usted pregunta sobre ello en una conversación abierta en 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).