Création d'un modèle de compte-rendu de visite au format HTML
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.
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.
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).