Création d'un modèle de compte-rendu de visite au format HTML

Le modèle est enregistré en tant que document HTML. Le modèle HTML par défaut complet est présenté dans l'annexe Modèle par défaut pour le compte-rendu de visite. Le modèle par défaut est également disponible dans LN, dans la session Modèles de compte-rendu de visite (tsmdm5100m000).
Remarque

Les modèles de compte-rendu de visite HTML sont pris en charge dans LN 10.5 et les versions ultérieures, notamment LN Cloud Edition. Les modèles HTML peuvent être utilisés pour LN Mobile Service pour Windows, Android et iOS. Les modèles RTF ne peuvent être utilisés que pour la version Windows.

Espaces réservés HTML

Dans les modèles de compte-rendu de visite HTML, les espaces réservés sont définis en utilisant du texte dans des marqueurs au sein du contenu des balises HTML, ou sont définis comme des attributs des éléments HTML. Il existe cinq types d'espaces réservés. Trois d'entre eux sont définis en utilisant du texte dans les marqueurs. Deux d'entre eux sont définis par des attributs sur des éléments HTML.

Notation Types d'espaces réservés
{{label name}} Libellé
##nom espace réservé## Elément d'un jeu de données
%%nom espace réservé%% Image d'un jeu de données
data-dataset=”dataset name” (attribut) Identifiant de jeu de données
data-datasetrow=”dataset name” (attribut) Identifiant de ligne de jeu de données

Présentation

Les espaces réservés peuvent être placés n'importe où comme partie du contenu des balises HTML du document. Ainsi, la construction suivante est tout à fait valide.

<span>La date de début de l'ordre de service numéro ##ServiceOrder## est ##StartDate##</span>.

Les espaces réservés ##ServiceOrder## et ##StartDate## sont remplacés par les valeurs correspondantes de la visite dans le compte-rendu de visite réel.

Pour définir une section de jeu de données, deux attributs sont utilisés : « data-dataset » et « data-datasetrow ».

L'attribut « data-dataset » désigne l'élément qui est présent s'il y a des enregistrements dans le jeu de données. Lorsque le jeu de données ne comporte aucun enregistrement, l'élément n'est pas affiché du tout. Si le contenu de l'en-tête et du pied de page ne doit être affiché que s'il y a des enregistrements, ceux-ci doivent être contenus dans cet élément. Si le contenu de l'en-tête et du pied de page doit toujours être affiché, même s'il n'y a pas d'enregistrements, il doit se trouver en dehors de cet élément.

L'attribut « data-datasetrow » désigne l'élément qui est répété pour chaque enregistrement du jeu de données. Chaque section répétée est renseignée avec les valeurs de données d'un seul enregistrement du jeu de données. Un élément ayant l'attribut « data-datasetrow » est souvent défini dans un élément ayant un attribut « data-dataset » correspondant.

Exemple 1

td_codeblock_example1

Rouge : élément datasetrow pour LaborCost. Cet élément et tout ce qu'il contient est affiché s'il y a au moins un enregistrement dans le jeu de données LaborCost.

Orange : l'élément datasetrow est répété pour chaque enregistrement du jeu de données LaborCost.

Bleu : éléments qui font partie du jeu de données du document ou du jeu de données parent.

Supposons que l'ordre de service ABC0001 a commencé le 08/01/2020 et comporte deux coûts de main-d'oeuvre, DIG et FILL, lesquels ont duré respectivement une et deux heures. Le modèle ci-dessus peut donner lieu au compte-rendu de visite ci-dessous.

La date de début de l'ordre de service numéro ABC0001 est le 08/01/2020

Main-d'œuvre
Heures Tâche
1:00 Creuser
2:00 Remplir

Pour pouvoir représenter les relations parent/enfant, l'élément du jeu de données de l'enfant doit être imbriqué dans l'élément de ligne du jeu de données du parent. Ces relations parent/enfant sont présentes entre les prestations et, par exemple, le coût de la main-d'œuvre.

Dans le cas des prestations et du coût de la main-d'œuvre, si le coût de la main-d'œuvre doit être présenté par prestation, l'élément du jeu de données de coût de la main-d'œuvre doit être imbriqué dans l'élément de ligne du jeu de données de prestation. Les jeux de données enfants sont reconnaissables par leur structure. Au lieu de présenter tous les coûts de main-d'oeuvre d'une visite, seuls les coûts de main-d'oeuvre de la prestation en cours sont présentés dans la section imbriquée des coûts de main-d'oeuvre.

Exemple 2

td_codeblock_example2

Vert : l'élément datasetrow est répété pour chaque enregistrement du jeu de données Prestations.

Rouge : élément datasetrow pour LaborCost. Cet élément et tout ce qu'il contient est affiché s'il y a au moins un enregistrement dans le jeu de données LaborCost.

Orange : l'élément datasetrow est répété pour chaque enregistrement du jeu de données LaborCost.

Bleu : éléments qui font partie du jeu de données du document.

Supposons que l'ordre de service ABC0055 a commencé le 08/07/2021 et comporte deux prestations : Vérifier le câble et Corriger le signe. La première prestation Vérifier le câble comporte deux coûts de main-d'oeuvre, DIG et FILL, lesquels ont duré respectivement une et deux heures. La deuxième prestation Corriger le signe n'a pas de coût de main-d'œuvre. Le modèle ci-dessus donne lieu au compte-rendu de visite ci-dessous.

La date de début de l'ordre de service numéro ABC0055 est le 08/07/2021

Prestation Vérifier le câble

ABC0055-1

Main-d'œuvre
Heures Tâche
1:00 Creuser
2:00 Remplir

Prestation Corriger le signe

ABC0055-2

Aucun élément du jeu de données Document

Le jeu de données Document est le jeu de données de base ; il ne comporte qu'un seul enregistrement. L'élément dataset et l'élément datasetrow ne doivent pas être désignés pour le jeu de données Document.

Élément de jeu de données facultatif

La désignation d'un élément dataset ayant l'attribut « data-dataset » et contenant les éléments datasetrow est facultative. Si seul un élément répétitif doit être affiché pour le jeu de données, seul un élément ayant l'attribut « data-datasetrow » peut être désigné. Cela est illustré dans l'exemple 2. Pour le jeu de données Prestations, aucun attribut « data-dataset » n'est utilisé ; seul un attribut « data-datasetrow » désigne l'élément qui doit être répété pour chaque enregistrement du jeu de données Prestations.

Valeurs des données parent dans l'enfant

Si un élément dataset ou datasetrow contient des espaces réservés de données qui ne correspondent à aucune des propriétés du jeu de données, le remplacement a lieu en utilisant le jeu de données parent. Si aucune correspondance n'est trouvée dans le jeu de données parent, l'espace réservé est rapproché et éventuellement remplacé avec les valeurs du jeu de données document. Cela est illustré dans l'exemple 2. Pour la ligne de données Prestations, le code d'ordre de service est imprimé en combinaison avec la ligne de prestation, en utilisant le caractère générique ##ServiceOrderCode## du jeu de données document.

Totaux

Pour chaque jeu de données représentant des coûts, les totaux sont calculés. Dans le modèle par défaut, ces totaux sont présentés dans le paragraphe récapitulatif.

Les espaces réservés Totalxxx et GrandTotal affichent les valeurs de tous les coûts des prestations sélectionnées. Les lignes détaillées de ces coûts ne doivent pas nécessairement être présentées sur le compte-rendu. Les espaces réservés TotalDetailxxx et GrandDetailTotal contiennent uniquement les valeurs des lignes de coûts détaillées.

Modification du modèle

Pour modifier un modèle de compte-rendu de visite HTML, des connaissances de base du langage HTML sont nécessaires. Vous pouvez modifier les fichiers HTML en les ouvrant dans un éditeur de texte. Toutefois, il existe de nombreux outils plus sophistiqués pour créer et modifier des fichiers HTML.

Styles et images

Aucun fichier externe n'est pris en charge par le modèle. Les styles et les images doivent être intégrés dans le fichier du modèle. Les styles sous forme de CSS peuvent être définis en ligne en utilisant l'attribut style dans les éléments HTML, ou en interne au niveau du document en utilisant un élément de style dans la section head. Les images peuvent être intégrées dans le document HTML lui-même de différentes manières.

Un exemple d'intégration d'une image se trouve dans le modèle HTML par défaut de LN. Ce modèle peut être importé et téléchargé à partir de la session Modèles de compte-rendu de visite (tsmdm5100m000), ou téléchargé à partir de la session Fichiers supplémentaires (ttadv2570m000, fichier supplémentaire tssocLN_Mobile_Service_Visit_Report_Template.HTML).