Creación de una plantilla de listado de visitas de documento de texto enriquecido

La plantilla se guarda como un documento de texto enriquecido (.rtf). Puede crear o modificar la plantilla mediante un procesador de texto que admita archivos rtf.
Esta guía del usuario utiliza el diseño de la plantilla predeterminada en todas las muestras y figuras. La plantilla predeterminada completa se añade en el apéndice Plantilla predeterminada para listado de visitas. Esta plantilla predeterminada también está disponible en LN en la sesión Plantillas del listado de visitas (tsmdm5100m000).
Nota

Las plantillas rtf se utilizan en LN Mobile Service para Windows, pero no en la versión para Android/iOS. La versión para Android/iOS utiliza plantillas html.

Marcadores de posición de documento de texto enriquecido

En las plantillas de listado de visitas de documentos de texto enriquecido, los marcadores de posición se definen mediante texto dentro de los marcadores. Hay cuatro tipos de marcadores de posición. Todos ellos se definen utilizando texto dentro de los marcadores.

Anotación Tipos de marcadores de posición
<<label name>> Etiqueta
##placeholder name## Artículo de datos de un conjunto de datos
%%placeholder name%% Imagen de un conjunto de datos
[[data set identifier]] Identificador del conjunto de datos
Tabla 1. Ejemplo de marcadores de posición:
##DepartmentName## <<Order>> ##ServiceOrder##

##DepartmentAddress##

<<OrderReference>>

<<StartTime>>

<<ServiceEngineer>>

##ReferenceA##

##StartTime##

##Engineer##

En este ejemplo, <<Order>>, <<OrderReference>>, etc. son etiquetas (marcadores de posición de texto traducible). ##DepartmentName##, ##ServiceOrder##, etc. son artículos de datos. En este caso, se recuperan del conjunto de datos de nivel de documento. Ya que normalmente este conjunto de datos del documento está disponible, estos marcadores de posición se pueden utilizar en cualquier parte del documento. Para ver una lista de todos los marcadores de posición, consulte el apéndice Marcadores de posición para Plantillas del listado de visitas.

El ejemplo anterior puede tener como resultado lo siguiente cuando se genera el listado y los marcadores de posición se sustituyen por datos reales.
Departamento de servicio de los Países Bajos Orden de servicio SOO001407

Het Torentje

Binnenhof 19

2513 AA Den Haag, Zuid Holland

Países Bajos

Referencia

Fecha de inicio

Ingeniero servicio

CUST_B_00012

15-8-2016 10:28

John Doe

Formato

Básicamente, los marcadores de posición se pueden colocar en cualquier punto del documento rtf. Por lo tanto, una construcción como el número de orden de servicio ##ServiceOrder## tiene como fecha de inicio ##StartDate## es completamente válida.

Para poder alinear los elementos, tabulaciones o tablas que se pueden utilizar. Se pueden insertar las tablas. Es posible unir las columnas o filas. Por ejemplo, será válida una tabla de dos filas en la que la primera fila tenga una celda y la segunda tenga tres.

<<SomeTranslatedText>>
##FieldA## ##FieldB## ##FieldC##

El formato mostrado anteriormente obtiene los Campos A, B y C del conjunto de datos del documento.

Para poder mostrar los datos desde cualquier otro conjunto de datos, se debe seguir una convención de formato. Todos los marcadores de posición dependientes del conjunto de datos se deben colocar dentro de una tabla. El identificador del conjunto de datos es clave para la convención de formato. Este identificador se debe colocar en la primera fila en la primera celda, como el primer texto de esta tabla.

Convención de formato de conjunto de datos:

[[DataSetIdentifier]]
<<HeaderTextA>> <<HeaderTextB>> <<HeaderTextC>>
##FieldA## ##FieldB## ##FieldC##

La convención del conjunto de datos define tres o más filas.

  • La primera file debe contener el identificador del conjunto de datos (con los marcadores [[ ]]). Consulte también las definiciones del conjunto de datos proporcionadas anteriormente en el documento. Si no se encontrara el identificador del conjunto de datos, la tabla se gestionaría como una tabla de formato. Consulte lo mencionado anteriormente. La fila del identificador del conjunto de datos se borra una vez que se lleva a cabo la fusión.
  • La última fila se replica tantas veces como registros contenidos en el conjunto de datos. Los marcadores de posición de datos de cada fila replicada se sustituyen por los valores correspondientes de registros del conjunto de datos. Si la fila de formato contiene marcadores de posición 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.
  • Totas las demás filas son files de encabezado (cero, una o más). Las filas de encabezado normalmente contienen marcadores de posición de texto traducible (<< >>). Si las filas de encabezado contienen marcadores de posición de datos, estos se sustituyen con el conjunto de datos principal. Si este no fuese el caso, los marcadores de posición se sustituyen por datos del conjunto de datos de documento.

El requisito mínimo para una tabla de conjunto de datos es tener dos filas. Las filas de encabezado son opcionales.

Ejemplo con dos filas de encabezado:

[[MaterialCost]]
<<Materials>>
<<Quantity>> <<ItemCode>> <<ItemDescription>> <<Amount>>
##Quantity## ##Item## ##Description## ##AmountOrCoverage##

Ejemplo sin filas de encabezado:

[[MaterialCost]]
##Quantity## ##Item## ##Description## ##AmountOrCoverage##

Formato anidado

Se debe definir una convención adicional para poder representar las relaciones principal-secundario. En el caso de las actividades y los materiales, si los materiales por actividad deben estar presentes, la tabla de materiales debe estar anidada en la tabla de la actividad. Los conjuntos de datos tienen una estructura para reconocer si se utilizan como un conjunto secundario. En lugar de presentar todos los materiales de una visita, en las tablas de materiales anidadas se muestran solo los materiales de la visita actual.

Nota

Tenga cuidado al insertar las tablas anidadas en la última fila. Si se requiere más de una tabla (por ejemplo, material, mano de obra y otros costos), las tablas se insertarán en la misma celda con un final de párrafo (solo un RETORNO) entre ellas. Consulte también el formato de Materiales - LaborCost - OtherCost en el apéndice Plantilla predeterminada para listado de visitas.

En Word, esto resulta muy sencillo. Configure el cursor en una celda de tabla y seleccione Añadir tabla en la ficha Insertar.

Convención de formato de conjunto de datos anidados:

[[DataSetIdentifier]]
<<HeaderTextA>> <<HeaderTextB>> <<HeaderTextC>>
##FieldA## ##FieldB## ##FieldC##
[[DataSetIdentifier]]
<<HeaderTextX>> <<HeaderTextY>> <<HeaderTextZ>>
##FieldX## ##FieldY## ##FieldZ##

Ejemplo de formato de conjunto de datos anidados:

[[Activities]]
<<Activity>> ##Description##
[[MaterialCost]]
<<Materials>>
<<Quantity>> <<ItemCode>> <<Description>>
##Quantity## ##Item## ##ItemDescription##

En el ejemplo anterior, un conjunto de datos de costo de material [[MaterialCost]] está anidado en un conjunto de datos de actividad [[Activities]]. ##Description## se obtiene del conjunto de datos de Activities. ##Quantity##, ##Item## y ##ItemDescription## se obtienen del conjunto de datos de MaterialCost.

Ejemplo de resultado de formato de conjunto de datos anidados:

Cuadro de reparación de actividad
Materiales
Cantidad Código de artículo Descripción
6 pcs AVDK17 Conglomerado
Cuadro 3 AVDK1501 Clavos

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.

De esta forma, puede decidir mostrar solo los totales sin detalles o bien mostrar los detalles y a continuación mostrar los totales de estos detalles.

Herramientas para editar la plantilla

La plantilla se debe guardar como archivo rtf. Microsoft Word puede gestionar este tipo de archivos, aunque existen otras aplicaciones de procesamiento de texto que también pueden editar este tipo de archivos. Una vez que se ha creado la plantilla, el archivo se debe guardar como documento rtf.

Nota

Aunque el diseño de la pantalla pueda parecer idéntico, existen diferencias entre el material impreso de los procesadores de texto (y la aplicación). Así que si utiliza papel preimpreso, pruebe el papel con datos reales, guardados en formato pdf.

Herramientas para editar la plantilla

La plantilla se debe guardar como archivo rtf. Microsoft Word puede gestionar este tipo de archivos, aunque existen otras aplicaciones de procesamiento de texto que también pueden editar este tipo de archivos. Una vez que se ha creado la plantilla, el archivo se debe guardar como documento rtf.

Nota

Aunque el diseño de la pantalla pueda parecer idéntico, existen diferencias entre el material impreso de los procesadores de texto (y la aplicación). Así que si utiliza papel preimpreso, pruebe el papel con datos reales, guardados en formato pdf.

Consejo: Edición de los marcadores de posición

Al añadir o modificar los marcadores de posición, se debe escribir el marcador completo en una acción, sin modificar ningún carácter. Por ejemplo, ocasionalmente Word añade marcadores invisibles en los documentos rtf. Así, la fusión de los listados no puede interpretar la plantilla correctamente y el marcador de posición no se sustituye en el listado de visitas. Para aquellos marcadores que estén bien escritos pero aún así no muestran el valor fusionado, edite el documento de plantilla y vuelva a escribir el marcador de principio a fin, incluyendo los marcadores de apertura y cierre.

Consejo: Vista de diseño web en configuración de MS Word

Al utilizar Word como editor, se aconseja utilizar la vista de Diseño web. En la barra de menús, seleccione la ficha VISTA y, a continuación, haga clic en la vista Diseño web. Los bordes de las tablas más allá del margen derecho del papel son visibles y se pueden editar.

Consejo: ver líneas de cuadrícula

Las líneas de cuadrícula de la celda también se pueden mostrar. Esta función no viene activada de forma predeterminada. Utilice la opción del diseño de bordes en la ficha INICIO y haga clic en Ver líneas de la cuadrícula. Los bordes que no tiene líneas visibles se representan con una línea de puntos.