Préréglages programmables

Dans Capitally, des fonctionnalités telles que les Importations et les Impôts vous permettent de définir une logique complexe à l'aide d'un simple éditeur no-code. En réalité, tous les préréglages intégrés sont créés avec cet éditeur — vous pouvez donc exploiter toutes les capacités de l'application et l'adapter à vos besoins.

Cet article vous guidera à travers les fonctionnalités communes. Veuillez consulter les articles Importation et Impôts pour plus de détails.

Briques de base

Les préréglages sont construits à l'aide de Relevés. Lors de leur évaluation, chaque relevé est exécuté un par un, jusqu'à ce qu'un relevé Exit soit rencontré, ou que la liste des relevés se termine.

Chaque fois qu'un relevé doit évaluer une valeur, une expression est utilisée. Celles-ci peuvent aller d'une valeur fixe, comme un actif ou un nombre précis, à une valeur de propriété, comme une colonne de données ou un type de transaction, en passant par des formules permettant des calculs complexes.

Vous pouvez le considérer comme un langage de script simple ou une formule Excel complexe. Il fournit des concepts de base tels que les relevés, les expressions, les variables, les fonctions et les boucles. Mais tout est construit de manière visuelle, sans écrire de code.

Prendre des décisions avec les instructions If

Le relevé le plus basique est l'instruction If . Elle vous permet de prendre des décisions en fonction de n'importe quelles propriétés, et si les conditions correspondent, les relevés imbriqués seront exécutés. Dans le cas contraire, le bloc else ou else if suivant sera vérifié.

Insérer des relevés et des blocs If

Pour insérer un nouveau relevé, survolez l'espace avant, après ou entre les relevés existants, cliquez sur le séparateur bleu séparateur qui apparaît et sélectionnez une instruction ou un préréglage dans le menu.

Pour insérer un nouveau bloc « If », survolez l'espace avant, après ou entre des blocs if/else existants et cliquez sur le gris séparateur qui apparaît

Les modifier

Chaque instruction et bloc If dispose d'un menu permettant de les copier, couper, dupliquer et supprimer.

Une fois qu'une instruction est copiée ou coupée, vous pouvez la coller de la même façon que vous ajoutez de nouvelles instructions — une option Coller apparaîtra à cet endroit.

And / Or

Lorsque des conditions complexes sont nécessaires, vous pouvez encapsuler la première condition dans un bloc And/Or et combiner ainsi plusieurs conditions.

Définir des propriétés avec l'instruction Set

Vous pouvez modifier la propriété ou la variable d'un objet avec une instruction Set . Il vous suffit de choisir la propriété à modifier et de fournir une valeur.

Interface déroulante pour définir la « Devise des frais » sur « Devise de la valeur » avec des options, dans un panneau de paramètres utilisateur surligné en violet.La devise des frais sera identique à la devise de la valeur

Modifier une valeur existante plutôt que la remplacer

En cliquant sur le menu déroulant to , vous pouvez sélectionner différents modes d'affectation, comme l'addition, la multiplication, l'ajout en fin ou en début de texte, etc.

Capture d'écran d'une interface d'automatisation de flux de travail affichant des actions pour incrémenter une valeur d'un montant et ajouter une note selon la colonne Description.La valeur sera augmentée de la colonne Montant, tandis que la Note sera complétée par la Description

Transformer des valeurs

Les valeurs scalaires simples, comme du texte ou des nombres, peuvent être transformées avant d'être affectées. En cliquant sur fx , vous pouvez choisir parmi les transformations disponibles. Vous pouvez en combiner plusieurs et les réorganiser par glisser-déposer.

Capture d'écran d'une interface d'outil de transformation de données affichant des options pour incrémenter une colonne nommée « Valeur » par valeur, avec des fonctions supplémentaires répertoriées.La valeur deviendra la valeur absolue arrondie de la colonne MontantRemplacer du texte

La transformation Replace vous permet de remplacer les occurrences d'un texte correspondant par autre chose. Par exemple, vous pouvez remplacer un mot (ex. .GR par .EU) ou supprimer quelque chose en le remplaçant par rien.

Capture d'écran d'une interface de transformation de données faisant correspondre les suffixes de codes boursiers, avec conversion du suffixe .GR en .EU pour la standardisation des données financières.

Replace gère également les Expressions régulières , y compris les groupes de capture et les rétro-références. Il suffit d'activer le bouton (.*) .

Supposons que vous ayez la chaîne « apple orange banana » et que vous souhaitiez inverser les positions des deux premiers mots. Vous pouvez utiliser le motif ([a-z]+) [a-z]+ ([a-z]+) et le remplacer par $2 $1 pour obtenir « orange apple banana ».

Extraire du texte

Plutôt que d'extraire, vous pouvez simplement faire correspondre la partie de la chaîne à utiliser. C'est particulièrement efficace avec les Expressions régulières, car le premier groupe de capture sera extrait.

En reprenant l'exemple « apple orange banana » ci-dessus, le motif [a-z]+ ([a-z]+) [a-z]+ n'extraira que le mot du milieu — « orange ».

Mapper des valeurs

Pour certaines propriétés comme le type d'actif ou de Transaction, vous pouvez également mapper la valeur d'un état à un autre. Cliquez sur l'icône S icon à côté de fx pour ajouter un mappage.

Le mappage vérifie si la valeur entrante satisfait une condition. Si oui, la valeur sélectionnée est utilisée. Les mappages sont évalués dans l'ordre, et le premier qui correspond l'emporte.

Capture d'écran d'une interface de workflow à logique conditionnelle associant des types de transactions tels qu'Achat, Vente et activité de plan d'actionnariat à des actions spécifiques.

Conversion de valeurs entre types

Les propriétés peuvent avoir des types incompatibles. Par exemple, un texte sera automatiquement converti en nombre ou en date, à condition qu'il contienne une valeur cohérente (ex. 2024-11-01 ou 1st Nov 2024).

Cela fonctionne également pour les Comptes, les Devises, les Marchés ou les Types de transaction, où toute valeur textuelle sera utilisée pour rechercher dans les données du Projet ou du marché.

Pour les actifs, vous pouvez également préciser quels Types d'actifs et quels Marchés doivent être inclus, ainsi que leur ordre de préférence.

Capture d'écran d'un filtre de recherche d'actifs financiers avec des options de type d'actif, de sélection de marché et un bouton pour activer la recherche d'actifs distants.

Définir des variables

Comme dans tout langage de script, vous pouvez définir une Variable pour stocker une valeur et la réutiliser ultérieurement. Chaque Variable possède un type spécifique et une valeur initiale. Une fois définie, elle peut être référencée ou définie comme n'importe quelle autre Propriété.

Par défaut, toutes les Variables sont locales — c'est-à-dire disponibles uniquement dans le bloc où elles sont Déclarées (y compris les blocs imbriqués), et seulement après leur déclaration.

Vous pouvez les passer en mode partagé, ce qui signifie que leur valeur ne sera initialisée qu'une seule fois et sera disponible non seulement dans l'ensemble du programme, mais aussi entre ses invocations — par exemple, pour chaque ligne d'une Importation ou chaque Événement fiscal.

Capture d'écran montrant l'initialisation d'une variable dans une interface, avec des options pour des nombres fixes ou des valeurs dynamiques, et la possibilité de basculer entre une portée locale et partagée.

Commentaires

Les calculs ne sont utiles que si vous en comprenez les résultats. Vous pouvez ajouter des Commentaires enrichis n'importe où dans le Préréglage pour mieux décrire la logique.

Capture d'écran d'une zone de texte verte avec des conseils de mise en forme Markdown, notamment les titres, les listes, le texte en gras et la création de liens hypertexte.