Creación de una plantilla de listado de visitas html

Marcadores de posición html

En las plantillas de listado de visitas de tipo html, los marcadores de posición se definen mediante texto dentro de los marcadores dentro del contenido de las etiquetas html o se definen como atributos de elementos html. Hay cinco tipos de marcadores de posición. Tres de ellos se definen utilizando texto dentro de los marcadores. Dos de ellos se definen mediante atributos en elementos html.

Formato

Los marcadores de posición se pueden colocar en cualquier lugar como parte del contenido de las etiquetas html del documento. Por lo tanto, la siguiente construcción es completamente válida.

<span>El número de orden de servicio ##ServiceOrder## tiene como fecha de inicio ##StartDate##</span>

Los marcadores de posición ##ServiceOrder## y ##StartDate## se sustituyen por los valores correspondientes de la visita en el listado de visitas real.

Para definir una sección del conjunto de datos se utilizan dos atributos: data-dataset y data-datasetrow.

El atributo data-dataset designa el elemento, que está presente si hay registros en el conjunto de datos. Cuando el conjunto de datos no tiene registros, el elemento no se muestra. En caso de que el contenido de cabecera y pie de página solo se deba mostrar si hay registros, debe incluirse en este elemento. En caso de que el contenido de cabecera y pie de página se deba mostrar siempre aunque no haya registros, debe estar fuera de este elemento.

El atributo data-datasetrow designa el elemento que se repite para cada registro del conjunto de datos. Cada sección repetida se cumplimenta con los valores de datos de un registro del conjunto de datos. Un elemento con el atributo data-datasetrow suele estar definido dentro de un elemento con un atributo data-dataset coincidente.

Para poder representar las relaciones principal-secundario, el elemento del conjunto de datos del elemento secundario se debe anidar en el elemento de la fila del principal. Estas relaciones principal-secundario están presentes entre las actividades y, por ejemplo, el costo de mano de obra.

En el caso de actividades y costo de mano de obra, si el costo de mano de obra se debe presentar por actividad, el elemento del conjunto de datos del costo de mano de obra se debe anidar en el elemento de fila del conjunto de datos de actividad. Los conjuntos de datos tienen una estructura para reconocer si se utilizan como un conjunto secundario. En lugar de presentar todos los costos de mano de obra de una visita, solo se presenta el costo de mano de obra de la actividad actual en la sección de costos de mano de obra anidados.

No hay elementos de conjunto de datos del documento

El conjunto de datos del documento es el conjunto de datos base y solo tiene un registro. El elemento del conjunto de datos y el elemento datasetrow no se deben designar para el conjunto de datos del documento.

Elemento de conjunto de datos opcional

La designación de un elemento de conjunto de datos con el atributo data-dataset que contiene los elementos datasetrow es opcional. Si solo es necesario mostrar un elemento repetitivo para el conjunto de datos, solo se puede designar un elemento con el atributo data-datasetrow. Esto se muestra en el ejemplo 2. Para el conjunto de datos Activities no se usa ningún atributo data-dataset, solo un atributo data-datasetrow designa el elemento que se debe repetir para cada registro en el conjunto de datos Activities.

Valores de datos del elemento principal en elemento secundario

Si un conjunto de datos o un elemento datasetrow contiene marcadores de posición de datos que no corresponden con las propiedades del conjunto de datos, la sustitución tiene lugar utilizando el conjunto de datos principal. Si no se encuentra ninguna coincidencia en el conjunto de datos principales, el marcador de posición coincidirá y seguramente se sustituirá por los valores del conjunto de datos del documento. Esto se muestra en el ejemplo 2. Para el elemento datasetrow de Activities, el código de orden de servicio se lista en combinación con la línea de actividad utilizando el marcador de posición ##ServiceOrderCode## del conjunto de datos del documento.

Totales

Para cada conjunto de datos que represente costos, se calcularán los valores totales. En la plantilla predeterminada, se muestran estos valores totales en el párrafo resumen.

Los marcadores de posición Totalxxx y GrandTotal muestran valores de todos los costos de las actividades seleccionadas. Las líneas de detalle de estos costos no necesariamente deben estar representadas en el listado. Los marcadores de posición TotalDetailxxx y GrandDetailTotal contienen valores solo de las líneas de costo de detalle.

Edición de la plantilla

Para editar una plantilla de listado de visitas de tipo html, es necesario tener conocimientos básicos de html. Un archivo html puede editarse abriendo el editor de textos, pero hay disponibles muchas herramientas más sofisticadas para crear y editar archivos html.

Estilo e imágenes

La plantilla no admite archivos externos. El estilo y las imágenes deben incorporarse en el archivo de plantilla. El estilo en formato de CSS se puede definir en línea utilizando el atributo de estilo dentro de los elementos html, o internamente en un nivel de documento utilizando un elemento de estilo en la sección de encabezado. Las imágenes se pueden incorporar en el propio documento html de varias maneras.

En la plantilla html predeterminada de LN se encuentra un ejemplo de incorporación de una imagen. Esta plantilla se puede importar y descargar desde la sesión Plantillas de listado de visitas (tsmdm5100m000) o descargar desde la sesión Archivos adicionales (ttadv2570m000, archivo adicional tssocLN_Mobile_Service_Visit_Report_Template.html).