Modèles de texte
Outre la saisie manuelle de longs textes dans la ligne vente et le stockage de descriptions étendues dans les données de base (pour les articles, les articles catalogue et les ressources), des modèles de texte peuvent être définis librement. Ils peuvent également servir de valeurs par défaut automatiques pour les textes d'introduction et de conclusion dans les documents de vente. Les modèles de texte contiennent du texte et des images déjà mis en forme. Ils peuvent être adaptés ou étendus selon les besoins. Ils offrent également la possibilité d'utiliser des espaces réservés, qui sont ensuite automatiquement remplacés par des valeurs spécifiques ultérieurement.
Créer et modifier des modèles de texte
Sur la page Modèles de texte, ceux-ci peuvent être créés et personnalisés, et leur utilisation peut être contrôlée en définissant des filtres. La Zone sert de valeur par défaut pour le champ d'application des modèles de texte, car l'ID table et les éventuels filtres de table y sont prédéfinis. Par principe, les zones Ventes, Devis vente, Commande vente, Article, Ressource, Article catalogue et Défini par l'utilisateur sont disponibles, étant entendu que les zones liées aux données de base — Article, Ressource et Article catalogue — sont masquées par défaut. Lors de la sélection d'un modèle de texte, l'ID table est automatiquement filtré en fonction du contexte.
Outre l'ID table, l'utilisation du modèle de texte peut être restreinte via les Filtres table. Pour ce faire, l'action Filtres permet d'ouvrir une page de filtre correspondant à la table, dans laquelle les filtres de table souhaités sont définis.
L'action Contenu permet d'accéder au contenu réel d'un modèle de texte. Celui-ci peut être constitué de plusieurs textes, par exemple pour couvrir plusieurs langues. Il est également possible de définir ici une période de validité (via Date début et Date fin) d'un contenu. Le contenu peut aussi être ouvert via le champ Nombre de contenus sur la page Modèles de texte.
La période de validité d'un contenu est facultative. Si rien n'est spécifié ici, elle n'est soumise à aucune limite de temps. Il est toutefois possible de définir plusieurs périodes de validité, par exemple pour différents contenus du même modèle de texte à certaines périodes.
Le texte concerné est saisi ou modifié avec l'action Modifier le texte. Cela se fait à l'aide de l'éditeur de DYCE Happy Texts.
Il n'est nécessaire de spécifier un code langue pour le contenu d'un modèle de texte que si ce contenu doit être saisi ou valide uniquement pour une langue spécifique. Si aucun code langue n'est spécifié, le contenu est valide pour toutes les langues.
Sélectionner un modèle de texte
Outre l'ID table, d'autres filtres de table sont également pris en compte lorsque l'utilisateur sélectionne manuellement les modèles de texte appropriés. Si plusieurs modèles de texte sont trouvés après application de ces filtres, ils sont affichés dans l'ordre du Code du modèle de texte.
Utilisation des espaces réservés
Les espaces réservés peuvent généralement être utilisés dans tous les modèles de texte. Certains emplacements s'y prêtent toutefois mieux que d'autres, par exemple le texte d'en-tête d'un devis ou d'une commande vente. Ils représentent un contenu textuel qui est substitué à l'une des étapes suivantes (voir Moment de la substitution) :
- L'espace réservé est remplacé au moment où le modèle est appliqué.
- L'espace réservé est remplacé lors de la sortie (par exemple, impression/PDF).
Les espaces réservés peuvent contrôler une numérotation automatique ou appeler des fonctions qui génèrent du contenu textuel. Ils peuvent également représenter des variables système (telles que la date actuelle ou l'ID utilisateur) ou des références à des champs de l'enregistrement actuel ou d'une table référençante. Les références à des champs peuvent être assez complexes. Par exemple, un appel depuis l'En-tête vente peut référencer l'adresse e-mail du vendeur à l'aide du code vendeur qui y est attribué.
Moment de la substitution
Le fait que la substitution d'un espace réservé ait lieu lorsqu'un modèle de texte est appelé ou seulement lorsque le texte est généré est déterminé par l'utilisation d'accolades ou de crochets.
Espace réservé entre accolades
Les espaces réservés entre accolades (par exemple {TIME}) ne sont généralement (pré)définis que dans les modèles de texte. Si le modèle est utilisé, par exemple inséré automatiquement comme texte d'en-tête, ces espaces réservés sont immédiatement substitués. L'espace réservé est donc remplacé par le contenu réel lors de l'insertion du modèle.
- Espaces réservés entre crochets
Le contenu des espaces réservés entre crochets (par exemple [TIME]) n'est déterminé qu'au moment de la sortie, de sorte que la valeur actuelle soit générée.
Des champs doivent être référencés dans le texte d'en-tête d'un devis vente. La table actuelle est donc En-tête vente (table 36).
- Exemple 1 : {@152} affiche la date jusqu'à laquelle le devis est valide (champ Date de validité du devis)
- Exemple 2 : {@2} génère le numéro du client qui reçoit les produits (champ N° client ou N° client donneur d'ordre)
Variables comme espaces réservés
Les variables système et l'astérisque peuvent être utilisés comme variables pour les espaces réservés. L'espace réservé {*} déclenche une numérotation automatique. Les variables système suivantes sont également substituées :
| Variable système | est déterminée comme |
|---|---|
| * | liste non numérotée |
| TODAY | Date système actuelle |
| TIME | Heure système actuelle |
| WORKDATE | Date de travail définie par l'utilisateur |
| CURRENTDATETIME | Date/heure système actuelle |
| USERID | ID utilisateur de l'utilisateur connecté |
| COMPANYNAME | Nom de la société |
Référence au champ d'une autre table
Une référence peut également être utilisée pour récupérer des données d'un champ d'une autre table sur la base de l'enregistrement actuel. Pour définir de manière unique l'enregistrement dans la table cible, sa clé primaire est notamment requise. L'expression se compose de trois sections : d'abord, la table distante est référencée, suivie du champ à renvoyer et de la clé primaire de cette table.
Structure schématique : {<@remote_table>;<field_in_remote_table>{<@primary_key_of_remote_table>}}
| Chaîne | Explication |
|---|---|
| remote_table | le numéro de la table, qui peut être déterminé à l'aide de l'Inspection de page, indiqué avec un @ au début |
| field_in_remote_table | le numéro du champ, qui peut être déterminé à l'aide de l'Inspection de page, indiqué sans @ au début |
| primary_key_of_remote_table | la clé primaire de la table référencée, indiquée avec un @ au début |
Remarque : si la clé est composée de plusieurs champs, ceux-ci sont listés séparés par une virgule.
Des champs doivent être référencés dans le texte d'en-tête d'un devis vente. La table actuelle est donc En-tête vente (table 36).
- Exemple 1 : Générer le numéro de téléphone du vendeur
Schéma : [<@SalesPerson/Purchaser>;<Phone No.>;[@<Code>]]
Réel : [@13;5053;[@43]]
À partir de la table En-tête vente (table 36), champ Code vendeur (champ 43), le N° téléphone (champ 5053) est déterminé depuis la table Vendeur/acheteur (table 13).
Remarque : le numéro de téléphone n'est remplacé que lors de la sortie. - Exemple 2 : Récupérer le nom du destinataire de la facture
Schéma : {<@Customer>;<Name>;{@<Bill-to Customer No.>}}
Réel : {@18;2;{@4}}
Le nom du destinataire de la facture est récupéré dans le champ Nom (champ 2) du Client (table 18). La clé primaire sous laquelle le client est trouvé est déterminée à partir du champ N° client à facturer (champ 4) de l'enregistrement actuel de la table En-tête vente (table 36).
Remarque : le destinataire de la facture est remplacé directement lors de l'application du modèle de texte.
Fonctions comme espaces réservés
Les fonctions peuvent également être utilisées comme espaces réservés. La valeur de retour de la fonction est alors insérée sous forme de texte. Les fonctions peuvent être spécifiées comme espaces réservés de la manière suivante : {#FUNCTIONNAME(PARAMETER 1,PARAMETER 2,...)}
| Chaîne | Explication |
|---|---|
| FUNCTIONNAME | Nom de la fonction souhaitée |
| PARAMETER(S) | les paramètres nécessaires à l'exécution de la fonction |
Attention : il ne doit y avoir aucun espace dans la liste des paramètres !
Une seule fonction est actuellement disponible, qui remplace la formule de salutation. La fonction #ContactSalutation(ContactNumber,Type) sert par exemple à déterminer la formule de salutation d'un contact. Le paramètre ContactNumber référence le contact souhaité pour la salutation, tandis que le paramètre Type contrôle la définition du type de salutation. Les valeurs For, Inf et Int sont autorisées pour les salutations formelles, informelles et internes.
Dans tous les exemples, En-tête vente (table 36) est utilisée comme table actuelle.
- Exemple 1 : {#ContactSalutation({@5052},For)}
La fonction détermine la formule de salutation formelle pour le N° contact donneur d'ordre (champ 5052) de l'enregistrement actuel. Veuillez vous assurer qu'une formule de salutation formelle existe pour le code langue utilisé dans le contact. Sinon, aucune formule de salutation formelle ne pourra être trouvée dans les documents et une erreur se produira. - Exemple 2 : {#ContactSalutation({@5052},Inf)}
Cet appel de fonction renvoie la formule de salutation informelle. Veuillez vous assurer qu'une formule de salutation informelle existe pour le code langue utilisé dans le contact. Sinon, aucune formule de salutation informelle ne pourra être trouvée dans les documents et une erreur se produira.