Documentos

La lista de documentos dinámicos y la ventana de cada uno: plantillas de partida, editor HTML con comprobación, datos de archivo y preguntas.

FlexHub → Documentos lista todos los documentos dinámicos de la empresa: lo que se imprime de una sección, como una factura, un albarán o una etiqueta. Desde la lista se crea un documento y se abre la ventana de cada uno, que junta el nombre, los datos de archivo, el HTML y las preguntas.

El lenguaje, los tipos de documento y los ejemplos están en Documentos dinámicos y DinaScript.

Antes de empezar

Ser Administrador de la empresa. Ver FlexHub.
Tener creada la sección desde la que se imprime. Ver Secciones.
Un documento también se crea y se abre desde su sección, en Contenido → Documentos.

La lista

La tarjeta Documentos lleva Nuevo y el icono Recargar. El buscador busca por nombre y por nombre interno. Filtros abre el embudo con Sección, Estado (Obsoletos, Eliminados), Origen (Míos, De otros módulos), Categoría y Subcategoría. Arranca en Míos; si eso esconde algo, debajo de la lista sale Ver de otros módulos (N).

La rejilla sale agrupada por categoría, con el nombre de cada una en la cabecera de su grupo. Las columnas son Documento, Sección, Módulo y Modificado, y cada fila lleva Editar. El aspa de la etiqueta Categoría, encima de la rejilla, quita la agrupación y devuelve la columna Categoría, con la subcategoría detrás.

Sección es un botón que abre la ventana de la sección en su pestaña Contenido. Vacía, el documento se ha quedado sin sección.
Módulo dice Propio o el módulo que trae el documento, más Obsoleto y Eliminado si se piden en el embudo.
Pulsar la fila hace lo mismo que Editar.

Sin nada que mostrar, la tarjeta dice Sin documentos y el motivo:

Cuándo	Qué dice
No hay ninguno, o la búsqueda no encaja con ninguno	No hay ningún documento que enseñar. Cambia la búsqueda o pulsa «Nuevo» para crear uno.
Míos esconde todos los que hay	Aquí no hay nada tuyo. Los N que quedan vienen de otros módulos: pulsa «Ver de otros módulos» para verlos.
Los demás filtros del embudo esconden todos	Con los filtros puestos no queda ninguno. Abre «Filtros» y quita alguno.

La lista es la misma pantalla que la de informes, con otro tipo: el embudo y las columnas se explican en Informes.

La ficha de un documento

Se abre al pulsar una fila o Editar, y al terminar de elegir plantilla y sección en el alta. El título dice lo que haces: Nuevo documento o Editar documento. A su derecha, el interruptor Yudo enciende o apaga el copiloto.

Debajo, una tarjeta lleva el Nombre a todo el ancho: es lo que se lee en el menú de impresión de la ficha. Bajo el nombre salen el Nombre interno, con el que se identifica el documento por dentro, y la Sección de la que se imprime. Después vienen las pestañas General, Contenido y Preguntas; Preguntas solo sale con el documento ya creado. El pie lleva Aceptar, que guarda todo a la vez, y Cerrar. Si el documento no se puede editar o no se ha podido leer, Aceptar no sale.

Encima de esa tarjeta, Avisos sale cuando hay algo que contar:

Este documento está marcado como obsoleto: sigue existiendo, pero no se debe usar para nada nuevo.
El motivo por el que el documento no se puede editar, con un candado. En Contenido no sale aquí: lo lleva la etiqueta Solo lectura del editor.
El aviso de Yudo, con Deshacer los cambios de Yudo.
El resultado del último guardado y, si el servidor rechaza algo, una tabla con Campo y Motivo.
El aviso de consolidar, con Consolidar ahora.

Crear un documento

Pulsa Nuevo

Pulsa Nuevo en la lista, o en Contenido → Documentos de la sección.

Elige la plantilla

La ventana Nuevo documento ofrece seis plantillas en tres grupos. Todas crean lo mismo: solo cambia el contenido de partida del editor. Impresión sale marcada. Pulsa una tarjeta; Enter elige la marcada y Cerrar cancela el alta.

Grupo	Plantilla	Qué trae
Para imprimir	Impresión	Una hoja A4 con la cabecera de la empresa, el cuerpo y el pie con la fecha.
Para imprimir	Factura	La hoja anterior con emisor y cliente, tabla de conceptos y totales con IVA.
Para enviar	Plantilla de correo	El cuerpo de un email, con el asunto y el destinatario en los metadatos.
Para enviar	Documento para firmar	Un contrato con su bloque de firmas y el metadato que lo manda a Dinaup Sign.
Empezar de cero	JSON + Vue	Solo la cabecera de bibliotecas: jQuery, Vue, Bootstrap y el `div#app`.
Empezar de cero	Documento en blanco	El esqueleto HTML mínimo que escribe el servidor. Sin nada dentro.

Las cuatro primeras traen texto de ejemplo: cambia lo que dice CAMBIA ESTO por lo tuyo.

Elige la sección

Desde la lista, otra ventana Nuevo documento pide la sección: Elige la sección de la que se imprime el documento. Busca por nombre o palabra clave y pulsa una. Salen las secciones principales, sin plantillas base ni tablas de líneas; las obsoletas, solo si las marcas en Filtros. Desde una sección este paso no sale.

Escribe el nombre

La ventana del documento abre en General, con la plantilla ya puesta en Contenido. Escribe el Nombre, de al menos 3 caracteres. La Categoría empieza en Documentos y Se imprime, marcado. Subcategoría y Descripción son opcionales. La pestaña Preguntas no está en el alta: las preguntas se añaden con el documento ya creado.

Pulsa Aceptar

El botón pasa a Creando… mientras el servidor consolida el esquema, unos 11 segundos. Mientras dura, Cerrar está apagado. Si falta algo, la ventana para antes de enviar: Nombre demasiado corto o Falta la categoría, y en ese caso salta a General. Si todo va bien, la ventana se cierra sola y el documento sale en la lista. Si el servidor rechaza el alta, la ventana sigue abierta con el motivo en Avisos.

General

La tarjeta Datos del documento lleva los datos de archivo: Categoría, Subcategoría, Se imprime y Descripción. Con el nombre, el contenido y la codificación del fichero, son todo lo que el servidor deja cambiar de un documento. La codificación la pone el servidor al crear y no se muestra. Los campos en rojo son obligatorios.

Categoría y Subcategoría ofrecen las que ya usan los documentos de la empresa. El botón del lápiz (Escribir una categoría nueva) cambia a caja de texto, y el de la lista (Elegir una categoría existente) vuelve al desplegable. Si no hay ninguna que ofrecer, el campo ya es una caja de texto.
Cambiar de categoría vacía la subcategoría.
La categoría decide si el documento se ve. Sin categoría no aparece en el menú de impresión de la ficha, y con Dinaup, Desarrollo o Eliminado tampoco.
Se imprime es una casilla, marcada de serie en el alta, y Descripción, texto libre.

Contenido

La pestaña Contenido es el editor. Un documento dinámico es HTML con trozos de código entre : fuera de esas marcas escribes la página tal cual se imprime; dentro, código que saca los datos del registro. El editor marca con fondo los trozos de código. El subtítulo cuenta cuántos lleva, o dice HTML puro: no lleva ningún trozo de código.

La tarjeta Contenido lleva en su cabecera Ayuda, Metadatos y Comprobar, más Cambiar plantilla en el alta o Releer al editar.

Comprobar pide al servidor que compile los trozos de código, uno a uno y sin ejecutar nada; el HTML de fuera no se comprueba. También se comprueba solo, medio segundo después de dejar de escribir.
En el alta, hasta que el documento existe, la comprobación no tiene sus variables y marca las v. como no declaradas.
Cambiar plantilla vuelve a abrir las plantillas y sustituye lo que haya en el editor.
Escribe F. dentro de un trozo de código y salen las funciones del motor con su descripción; al abrir el paréntesis se ve qué espera cada parámetro. Los campos de la sección salen con C., sus algoritmos con A., los datos del contexto con D. y el esquema con S..
Debajo del editor, el panel Problemas lista lo que no compila con su posición: Ln 12, Col 3, o todo el código si el fallo no tiene sitio. Pulsar una línea lleva el cursor a ese punto. Pasados 50 problemas, el panel dice cuántos quedan y pide arreglar esos primero. Su cabecera lo pliega y lo despliega.
Sin fallos, el panel dice Sin errores. El código es válido; comprueba que hace lo que quieres.
La barra de estado no se pliega nunca. A la izquierda dice Comprobando…, Sin errores, N problemas o Sin comprobar. A la derecha van Solo lectura, si el documento no se puede editar, y el lenguaje, Documento dinámico.
El último botón de la barra, Pantalla completa, lleva el editor a toda la pantalla. Se vuelve con Esc o con el mismo botón.

Aviso	Qué hacer
Este documento no tiene sección: no se puede comprobar su código.	Sale en el subtítulo. El documento se escribe y se guarda igual, pero sin comprobación ni campos que sugerir. La sección no se elige en esta ventana: crea el documento desde su sección.
Este servidor no ofrece la lista de funciones. El editor funciona igual, sin autocompletado.	El servidor de la empresa no publica el catálogo de funciones. El editor colorea, comprueba y guarda igual.
No se ha podido comprobar el código.	Sale en Problemas con el motivo, y la barra dice Sin comprobar. Pulsa Comprobar para repetirlo. Puedes guardar, pero nadie ha revisado el código.
Solo lectura	El motivo sale al pasar el ratón por la etiqueta: el documento está eliminado, es de otro módulo o el servidor no deja escribir el cuerpo. Si dice que no se ha podido leer qué se puede modificar, cierra la ventana y vuelve a abrirla.

Lo que se guarda es el documento tal como lo ves; el servidor lo traduce a su formato interno al guardarlo.

Ayuda del editor de documentos

Ayuda abre esta ventana por su primera pestaña, y Metadatos la abre directamente en Metadatos.

Pestaña	Qué trae
Cómo se escribe	Qué es cada letra (`F.`, `C.`, `A.`, `D.`, `S.`, `I.`, `V.`) y nueve ejemplos, de escribir un campo a recorrer una lista o incluir otro documento.
Funciones	El catálogo de funciones del motor, con su firma y un buscador.
Datos	Los campos, algoritmos, contexto y esquema de la sección, con buscador.
Metadatos	Las claves que deciden a dónde va el documento: por correo (`email_to`, `email_subject` y las demás) o a firmar.

Insertar pega el trozo en el cursor, ya entre sus marcas; en Datos, el campo va dentro de F.WriteText. Si el documento no se puede editar, la ayuda se lee pero no lleva Insertar.

Yudo, el copiloto

Con el interruptor Yudo encendido, el chat Yudo · Copiloto del documento se pega a la derecha de la ventana. Arranca encendido y conserva cómo lo dejaste la última vez. Sin la IA de la empresa activa, o sin presupuesto semanal de IA en tu usuario, no salen ni el interruptor ni el chat. Ver Yudo.

Yudo lee el documento, busca funciones y campos, escribe en el editor y comprueba lo que escribe. No guarda nada. Cuando escribe, Avisos dice Yudo ha cambiado el contenido. Revísalo: no se guarda hasta que pulses «Aceptar»., con el botón Deshacer los cambios de Yudo. Hace falta porque el editor pierde su historial al recibir un texto entero, y Ctrl+Z ya no lo recupera.

Preguntas

Lo que el documento pide antes de imprimirse, por ejemplo de qué pedido. La pestaña sale cuando el documento ya existe. La primera pregunta de tipo Relación es la sección desde la que se imprime, y el servidor no deja quitarla: lo dice con su motivo al guardar. Si cambias la sección de esa pregunta, al guardar el editor pasa a comprobar y sugerir con los campos de la nueva. Una pregunta nueva que pases a Relación trae ya puesta la sección del documento. La tarjeta es la misma que en informes: Las preguntas.

Guardar, releer y cerrar

Aceptar guarda a la vez el nombre, los datos de General, el contenido y las preguntas. Solo viaja lo que has cambiado; sin nada que guardar, avisa con Sin cambios. Si solo has cambiado las preguntas, se guardan ellas y el aviso es Preguntas guardadas. Mientras guarda, el botón dice Guardando….
Si el nombre baja de 3 caracteres o un campo obligatorio va vacío, la ventana para antes de enviar con Faltan campos por rellenar y la lista de lo que hay que repasar.
Si el servidor rechaza una propiedad, el aviso es Hay propiedades sin guardar y Avisos la nombra con su motivo. Las rechazadas siguen pendientes: el siguiente Aceptar las vuelve a intentar.
Si rechaza el guardado entero, el aviso es No se ha guardado, el motivo queda en Avisos y las preguntas tampoco se guardan.
Un cambio que el servidor marca como pendiente de consolidar se guarda, pero no se aplica hasta pulsar Consolidar ahora. Antes pide confirmación (Consolidar ahora o Ahora no): reconstruye la estructura de toda la empresa, tarda unos diez segundos y mientras dura nadie puede cambiarla. Al terminar, el aviso se va y la notificación dice Cambios aplicados.
Releer, en Contenido, vuelve a leer el documento y sus preguntas del servidor. Con cambios sin guardar, también en las preguntas, pregunta antes: Perder los cambios o Seguir editando.
Cerrar con cambios, también si solo son de las preguntas, pregunta: Cerrar y perder los cambios o Seguir editando. La ventana no se cierra pulsando fuera ni con Esc; dentro del editor, Esc cierra el autocompletado.
Un documento eliminado abre en solo lectura y no se restaura desde FlexHub: copia el contenido y crea uno con Nuevo. Un documento no se elimina desde FlexHub.
Un documento de otro módulo abre en solo lectura, con el motivo que da el servidor.

En esta página