Pour afficher des données de docu tools dans un Rapport pdf ou excel, nous utilisons des placeholders. Ces placeholders servent de marqueurs au sein de votre Modèle et indiquent où les données de docu tools doivent être insérées. Vous pouvez, par exemple, créer un placeholder tel que {{project-name}} dans le Modèle, qui sera dynamiquement rempli avec le nom réel du projet dans docu tools lors de la génération du Rapport.
Il existe différents groupes de placeholders pour Excel et pour Word, certains étant disponibles uniquement dans l'un ou l'autre. L'utilisation efficace de ces placeholders vous permet de créer des Modèles dynamiques et flexibles qui représentent précisément les données de vos projets, Rapports et Tâches.
Syntaxe et mise en forme des placeholders
Tous les placeholders sont encadrés de doubles accolades {{ }} et doivent suivre exactement la syntaxe spécifiée, indépendamment de la langue utilisée dans le texte du Modèle : Par exemple, {{pin-number}} est un placeholder valide qui récupère le Numéro du Pin sélectionné. Cependant, des placeholders comme {pin-number}, {{pinnummer}} ou {{pinnumber}} sont invalides en raison d'une syntaxe incorrecte et ne fonctionneront pas.
Les placeholders ne fonctionnent pas s'ils contiennent des espaces. Pour créer un placeholder pour un Titre de plusieurs mots, remplacez l'espace par un trait d'union -, par exemple utilisez {{dataset-room-info}} au lieu de {{dataset-Room info}}.
L'apparence de la sortie est définie sur la base de la formatage du placeholder dans le Modèle. Si votre Rapport ne ressemble pas à ce que vous voulez, vous devez modifier le Modèle. D'autre part, les données dynamiques sont affichées telles qu'elles sont entrées dans docu tools. Si donc il y a une faute de frappe dans le Titre du Pin affiché, elle doit être corrigée dans le Pin correspondant dans docu tools.
Zones de placeholders
Lorsque vous travaillez avec des placeholders de Tâches et de Pins, une structure spécifique doit être respectée. Comme les Pins et les Tâches se répètent souvent dans un Rapport, il est important de définir la section spécifique où ces placeholders apparaissent. Cette zone limitée sera remplie avec les données d'un Pin ou d'une Tâche, se répétant autant de fois qu'ils apparaissent dans le Rapport.
Ces sections commencent toujours par {{pins}} ou {{tasks}} et se terminent par {/pins}} ou {{/tasks}}. Tout contenu entre ces placeholders sera répété en fonction du nombre de Pins ou de Tâches. Il est important de noter que le / supplémentaire est uniquement inclus dans la balise de fermeture.
D'autres zones concernent :
{{pin-sort}}et{{/pin-sort}}- Zone pour les placeholders de tri des Pins.{{pin-medias}}et{{/pin-medias}}- Espace pour{{pin-media-file-name}}dans les Rapports Excel.{{comments}}et{{/comments}}- Zone pour les commentaires des Tâches.{{attendees}}et{{/attendees}}- Section pour les placeholders de contact.
Il existe également des sections où le texte n'est affiché que si une condition est remplie. Normalement, les placeholders ne sont pas affichés dans le Rapport s'il n'y a pas de données pour les remplir. Par exemple, s'il n'y a pas de Tâches dans un Pin spécifique, les placeholders de Tâches ne seront pas affichés. Cependant, pour ajouter un Titre qui s'affiche lorsque le contenu correspondant est présent, des placeholders If ont été introduits. Ces sections sont positionnées en dehors des placeholders ouvrants et fermants et vérifient la présence de contenu. Les Titres ne sont affichés que si un contenu correspondant à la condition spécifiée est présent.
Nous avons défini les sections if suivantes :
{{if-tasks}}et{{end-if-tasks}}- Les Titres ne sont affichés que s'il y a au moins une Tâche active dans le Pin.{{if-media}}et{{end-if-media}}- Les Titres ne sont affichés que si des contenus Médias sont effectivement présents.{{if-task-comment}}et{{/if-task-comment}}- Les Titres ne sont affichés que si la Tâche contient des commentaires.
Ces placeholders peuvent être utilisés comme suit :
{{pins}}{{if-media}}Photos du Pin{{end-if-media}}{{picture-table-small}}{{/pins}}
Le Titre "Photos du Pin" ne sera pas affiché dans le Rapport si le Pin ne contient aucune photo.
Contenus inactifs dans les Rapports
Dans les Rapports, les Tâches et Médias inactifs sont exclus. Cependant, les Pins inactifs sont inclus dans le Rapport.
Placeholders pour les Rapports
{{today}}- La date de création du procès-verbal pour une identification facile de l'actualité du Rapport, ce qui permet un suivi et une surveillance appropriés du progrès dans la résolution des problèmes au fil du temps.{{weeknumber}}- Indique le Numéro de la semaine pendant laquelle le Rapport a été créé.{{author}}- Indique le nom de l'utilisateur qui a créé le Rapport.{{author-email}}- Affiche l'Adresse e-mail de l'auteur du Rapport.{{author-number}}- Affiche le numéro de téléphone de l'utilisateur qui a créé le Rapport.{{author-company}}- Affiche la société de l'auteur du Rapport.{{report-title}}- Affiche le Titre donné au Rapport lors de sa création dans l'application.{{report-filter}}- Affiche le Filtre utilisé pour créer le Rapport. Il fonctionne lorsque le Rapport est créé dans la Vue en liste des Rapports.{{pagebreak}}- Ajoute un saut de page dans les Rapports Word.
Conseil : Les sauts de page généraux peuvent être insérés directement dans le Modèle Word comme éléments statiques. Si vous souhaitez insérer un saut de page après chaque Pin ou chaque Tâche, ajoutez simplement le placeholder {{pagebreak}}.
Placeholders pour la création d'un champ de signature
Ces placeholders permettent la signature directe dans l'application iPad et contribuent à la sortie finale du Rapport :
{{signature-NAME}}- Affiche un champ de signature pendant la création du Rapport, qui est ensuite inclus dans le Rapport final.{{signaturename-NAME}}- Génère un champ de texte pour le nom du signataire lors de la création du Rapport sur un iPad, qui est ensuite inclus dans le Rapport.
REMARQUE : Comme ces placeholders peuvent être utilisés plusieurs fois dans un Modèle de Rapport, il est important de les distinguer les uns des autres. Le segment "NAME" du placeholder devrait être remplacé par une description significative indiquant l'emplacement dans le Rapport où vous souhaitez afficher la signature spécifique et le nom.
Configurez, par exemple, un Rapport avec deux champs de signature et de nom en utilisant la syntaxe suivante dans le Modèle :
Le Rapport affichera les résultats comme illustré ci-dessous :
Ces placeholders sont inclus dans notre Modèle de Rapport Standard "Journal de chantier".
Placeholders pour les informations météorologiques
Les placeholders fournissent des données météorologiques basées sur l'emplacement spécifié dans vos paramètres de projet. Pour garantir leur fonctionnalité, veillez à la validation sur le côté droit de l'adresse.
{{weather-icon-info}}- Affiche les prévisions météorologiques pour l'adresse de projet spécifiée avec un petit symbole météorologique. Le placeholder est formaté comme une table qui affiche dans la première colonne le symbole météorologique et dans la seconde colonne la Description des prévisions ainsi que les informations de température.{{weather}}- Lorsque ce placeholder est utilisé dans un Modèle de Rapport, une nouvelle section apparaît dans la fenêtre de création de Rapport, sélectionnant automatiquement les données météorologiques pour le jour actuel. En Cliquant sur le bouton "Modifier", vous pouvez sélectionner ou changer la date. Avec le bouton de suppression, la date est réinitialisée au jour actuel. Ce placeholder ne contient pas de symbole météorologique.{{pin-weather}}Ce placeholder affiche la météo du jour où le Pin a été créé.
Placeholders pour le tri des Pins
Ces placeholders vous permettent d'organiser les Rapports par Plans et Catégories et d'ajouter un Titre pour assurer le bon classement dans la table des matières.
S'il n'y a pas de placeholder de tri spécifique, l'application utilise le tri Standard de la Liste de tâches des Pins. Cependant, les placeholders de tri remplacent le tri Standard de l'application. REMARQUE : Ces placeholders sont uniquement disponibles pour les Rapports Word.
REMARQUE : Les placeholders de tri devraient englober la section des Pins à l'intérieur de la zone de tri. L'utilisation correcte est :
{{pin-sort}}...Placeholder de tri...{{pin}}...Placeholder de Pin...{{/pin}}{{/pin-sort}}
{{pin-sort}}- Ouvre la zone de tri des Pins.{{/pin-sort}}- Ferme la zone de tri des Pins.{{sort-by-plan}}- Cette fonction classe les Pins selon le nom du Plan auquel ils sont associés, puis les trie par leurs Numéros de Pin.{{sort-by-category}}- Avec cette fonction, les Pins sont classés selon leurs Catégories respectives, les Catégories étant triées dans l'ordre alphabétique de Z à A.{{pin-sort-title}}- Ce placeholder est utilisé en conjonction avec l'un des deux placeholders précédents. Il sert à afficher le nom du Plan trié ou de la Catégorie.