Para presentar datos de docu tools en un Informe en formato PDF o Excel, utilizamos marcadores de posición. Estos marcadores de posición sirven como indicadores dentro de su Plantilla y señalan dónde se deben insertar los datos de docu tools. Por ejemplo, puede crear un marcador de posición como #{{project-name}} en la Plantilla, que se llenará dinámicamente con el nombre real del proyecto en docu tools al generar el Informe.
Existen diferentes grupos de marcadores de posición para Excel y para Word, ya que algunos están disponibles solo en uno u otro. Mediante el uso efectivo de estos marcadores de posición, puede crear Plantillas dinámicas y flexibles que representen con precisión los datos de sus proyectos, Informes y Tareas.
Sintaxis y diseño de los marcadores de posición
Todos los marcadores de posición están encerrados en dobles llaves #{{ }} y deben seguir exactamente la sintaxis proporcionada, independientemente del idioma utilizado en el texto de la Plantilla: Por ejemplo, #{{pin-number}} es un marcador de posición válido que recupera el Número del Pin seleccionado. Sin embargo, marcadores de posición como {pin-number}, #{{pinnummer}} o #{{pinnumber}} son inválidos debido a una sintaxis incorrecta y no funcionarán.
Los marcadores de posición no funcionan si contienen espacios. Para crear un marcador de posición para un Título de varias palabras, reemplace el espacio por un guion -, por ejemplo, use #{{dataset-room-info}} en lugar de #{{dataset-Room info}}.
La apariencia de la salida se define según el formato del marcador de posición en la Plantilla. Por lo tanto, si su Informe no se ve como desea, debe modificar la Plantilla. Por otro lado, los datos dinámicos se presentarán tal como se ingresaron en docu tools. Si hay un error tipográfico en el Título del Pin mostrado, debe corregirse en el Pin correspondiente en docu tools.
Ámbitos de los marcadores de posición
Al trabajar con marcadores de posición de Tareas y Pins, es importante observar una estructura específica. Dado que los Pins y Tareas a menudo se repiten en un Informe, es crucial definir la sección específica donde aparecerán estos marcadores de posición. Esta área limitada se llenará con datos de un Pin o una Tarea y se repetirá tantas veces como aparezcan en el Informe.
Estas secciones siempre comienzan con #{{pins}} o #{{tasks}} y terminan con #{{/pins}} o #{{/tasks}}. Todo el contenido entre estos marcadores de posición se mostrará repetidamente según la cantidad de Pins o Tareas. Es importante notar que el / adicional solo está presente en la etiqueta de cierre.
Otras áreas incluyen:
#{{pin-sort}}y#{{/pin-sort}}- Área para marcadores de posición de ordenación de Pins.#{{pin-medias}}y#{{/pin-medias}}- Espacio para#{{pin-media-file-name}}en Informes de Excel.#{{comments}}y#{{/comments}}- Área para comentarios de Tareas.#{{attendees}}y#{{/attendees}}- Sección para marcadores de posición de contacto.
También hay secciones donde el texto solo se muestra si se cumple una condición. Normalmente, los marcadores de posición no se muestran en el Informe si no hay datos para llenarlos. Por ejemplo, si no hay Tareas en un Pin específico, los marcadores de posición de Tareas no se mostrarán. Sin embargo, para agregar un encabezado que se muestre cuando el contenido correspondiente esté presente, se introdujeron marcadores de posición If. Estas secciones se colocan fuera de los marcadores de posición de apertura y cierre y verifican la presencia de contenido. Los encabezados solo se mostrarán si realmente hay contenido que cumpla con la condición especificada.
Hemos definido los siguientes segmentos if:
#{{if-tasks}}y#{{end-if-tasks}}- Los encabezados solo se mostrarán si hay al menos una Tarea activa en el Pin.#{{if-media}}y#{{end-if-media}}- Los encabezados solo se mostrarán si realmente hay contenido de Medios.#{{if-task-comment}}y#{{/if-task-comment}}- Los encabezados solo se mostrarán si la Tarea contiene comentarios.
Estos marcadores de posición pueden usarse, por ejemplo, de la siguiente manera:
#{{pins}}#{{if-media}}Fotos del Pin#{{end-if-media}}#{{picture-table-small}}#{{/pins}}
El encabezado "Fotos del Pin" no se mostrará en el Informe si el Pin no contiene fotos.
Contenidos inactivos en Informes
En los Informes, se excluyen las Tareas y Medios inactivos. Sin embargo, los Pins inactivos se incluyen en el Informe.
Marcadores de posición para Informes
#{{today}}- La fecha de creación del Informe para una fácil identificación de la actualidad del Informe, lo que permite un seguimiento y monitoreo adecuados del progreso en la resolución de problemas a lo largo del tiempo.#{{weeknumber}}- Muestra el Número de la semana en que se creó el Informe.#{{author}}- Indica el nombre del usuario que creó el Informe.#{{author-email}}- Muestra la Dirección de correo electrónico del creador del Informe.#{{author-number}}- Muestra el número de teléfono del usuario que creó el Informe.#{{author-company}}- Muestra la empresa del creador del Informe.#{{report-title}}- Muestra el Título que se le dio al Informe al crearlo en la aplicación.#{{report-filter}}- Muestra el Filtro utilizado para crear el Informe. Funciona cuando el Informe se crea en la Vista de lista de Informes.#{{pagebreak}}- Añade un salto de página en Informes de Word.
Consejo: Los saltos de página generales pueden insertarse directamente en la Plantilla de Word como elementos estáticos. Si desea agregar un salto de página después de cada Pin o Tarea, simplemente inserte el marcador de posición #{{pagebreak}}.
Marcadores de posición para la creación de un campo de firma
Estos marcadores de posición permiten firmar directamente dentro de la aplicación para iPad y contribuyen a la salida final del Informe:
#{{signature-NAME}}- Muestra un campo de firma durante la creación del Informe, que luego se incluye en el Informe final.#{{signaturename-NAME}}- Genera un campo de texto para el nombre del firmante durante la creación del Informe en un iPad, que luego se incluye en el Informe.
NOTA: Dado que estos marcadores de posición pueden usarse múltiples veces dentro de una Plantilla de Informe, es importante distinguirlos entre sí. El segmento "NAME" del marcador de posición debe ser reemplazado por una descripción significativa que indique el lugar en el Informe donde desea mostrar la firma y el nombre específicos.
Configure, por ejemplo, un Informe con dos campos de firma y nombre utilizando la siguiente sintaxis en la Plantilla:
El Informe mostrará los resultados como se muestra a continuación:
Estos marcadores de posición están incluidos en nuestra Plantilla de Informe Predeterminada "Diario de obra".
Marcadores de posición para la información meteorológica
Los marcadores de posición proporcionan datos relacionados con el clima basados en la ubicación especificada en la configuración de su proyecto. Para asegurar su funcionalidad, tenga en cuenta la validación en el lado derecho de la dirección.
#{{weather-icon-info}}- Muestra el pronóstico del tiempo para la dirección del proyecto especificada con un pequeño símbolo meteorológico. El marcador de posición está formateado como una tabla que muestra en la primera columna el símbolo del tiempo y en la segunda columna la descripción del pronóstico y la información de temperatura.#{{weather}}- Cuando este marcador de posición se utiliza en una Plantilla de Informe, aparece una nueva sección en la ventana de creación del Informe que selecciona automáticamente los datos meteorológicos para el día actual. Al hacer Click en el botón "Editar", puede seleccionar o cambiar la fecha. Con el botón de borrar, la fecha se restablece al día actual. Este marcador de posición no incluye un símbolo meteorológico.#{{pin-weather}}- Este marcador de posición proporciona el clima del día en que se creó el Pin.
Marcadores de posición para la ordenación de Pins
Con estos marcadores de posición, puede organizar Informes por Planos y Categorías y adjuntar un Título para asegurar la correcta ordenación en el índice de contenidos.
Si no hay un marcador de posición de ordenación específico, la aplicación utiliza la ordenación Predeterminada de la Lista de tareas/Pins. Sin embargo, los marcadores de posición de ordenación anulan la ordenación Predeterminada de la aplicación. NOTA: Estos marcadores de posición están solo disponibles para Informes de Word.
NOTA: Los marcadores de posición de ordenación deben incluir el área de Pin dentro del área de ordenación. El uso correcto es:
#{{pin-sort}}...Marcador de posición de ordenación...#{{pin}}...Marcador de posición de Pin...#{{/pin}}#{{/pin-sort}}
#{{pin-sort}}- Abre el área de ordenación de Pins.#{{/pin-sort}}- Cierra el área de ordenación de Pins.#{{sort-by-plan}}- Esta función ordena los Pins según el nombre del Plano al que están asignados, y luego los ordena según sus Números de Pin.#{{sort-by-category}}- Con esta función, los Pins se ordenan según sus respectivas Categorías, ordenando las Categorías en orden alfabético de Z a A.#{{pin-sort-title}}- Este marcador de posición se utiliza en combinación con uno de los dos marcadores de posición anteriores. Sirve para mostrar el nombre del Plano o Categoría ordenado.