Similarités avec Excel

Si vous êtes familier avec Excel, cette page vous aidera à comprendre DocuMold en soulignant les similarités et différences entre eux.

Vue d’ensemble de haut niveau d’Excel

Une cellule dans Excel peut contenir 3 choses :

• Contenu simple
• Données
• Formules Excel

La différence entre contenu simple et données peut être subtile.

• Le contenu simple est là pour être lu par quelqu’un. Soit pour aider à utiliser/interpréter le tableau, soit pour développer ce tableau. Exemple de contenu simple : le titre d’une colonne.
• Les données sont là pour être utilisées par les formules ou pour être interprétées par quelqu’un. Les valeurs dans les colonnes et les étapes de calcul intermédiaires sont des exemples de données.

Les formules utilisent les données pour calculer ce que leur cellule doit afficher. Le résultat est généralement plus de données, mais parfois c’est seulement du contenu simple.

Vue d’ensemble de haut niveau de DocuMold

Un modèle (gabarit) DocuMold peut contenir 2 choses :

• Contenu simple
• Commandes DocuMold

Alors qu’un document Excel contient les données nécessaires à ses formules, un modèle DocuMold ne les contient pas. Au lieu de cela, vous fournissez les données dans un formulaire web lors de la génération d’un document à partir de votre modèle DocuMold.

DocuMold utilise ensuite ces données pour exécuter les commandes du modèle. Cela résulte en un nouveau document que vous pouvez utiliser. Il contient :

• Contenu simple
• Le résultat des commandes utilisant les données fournies

Faire référence aux données

Dans Excel, vous faites référence aux données par leur position dans le tableau, ex : D11 et D11:D17.

Dans DocuMold, vous faites référence à vos données par les noms que vous leur donnez, que DocuMold appelle variables. Vous pouvez utiliser n’importe quel nom tant qu’il commence par une lettre minuscule et contient uniquement des lettres, des chiffres et des tirets bas (_), ex : nom_client2 et prixTotal.

Lors de l’utilisation d’un modèle pour générer un document, DocuMold vous demande de fournir la valeur pour chacune des variables.

Les formules d’Excel et les commandes de DocuMold

Dans Excel, les formules ne peuvent que définir le contenu affiché des cellules.

Dans DocuMold, les commandes peuvent faire plus de choses :

• Écrire une valeur dans le document (c’est ce que font les formules d’Excel)
• Supprimer du contenu du document. En utilisant @IF et @ENDIF, vous pouvez supprimer des sections entières en fonction d’une condition.
• Configurer le formulaire web utilisé pour demander des données lors de l’utilisation du modèle pour générer un document.
• Définir le nom du document généré.

Dans Excel, les formules doivent être seules dans leur cellule. Les formules commencent par un signe égal (=).

Dans DocuMold, les commandes peuvent être n’importe où dans le document (ex. : au milieu d’un paragraphe), donc elles ont besoin d’indicateurs avant et après. Les commandes DocuMold commencent par <# et se terminent par #>.

Voici un exemple avec une commande DocuMold :

Ceci est un contrat entre <# UPPER(nom_client) #> et ...

Types de données

Dans Excel comme dans DocuMold, vous pouvez utiliser ces types de données de base :

• Texte : "Du texte"
• Nombre : 123 et -5.6
• Date
• Booléen : TRUE et FALSE

Excel a des plages de cellules, qui contiennent des valeurs distinctes.

DocuMold a des listes, qui contiennent des valeurs distinctes. Elles peuvent aussi être écrites directement dans une commande, voici une liste contenant des nombres : [1, 1, 2, 3, 5], les espaces sont optionnels.

Excel a des formules matricielles, qui appliquent une formule à de nombreuses cellules distinctes et affichent le résultat dans plusieurs cellules.

DocuMold a des calculs de listes, qui appliquent un calcul (fonctions et opérateurs) à chaque entrée dans une liste et renvoient une nouvelle liste.