Variables système

Vous pouvez définir des variables prises en charge dans l'ensemble du système Therefore™, dont la gestion peut être centralisée et que vous pouvez utiliser lors de la génération de scripts, d'appels REST et de conditions de workflow. Cette fonctionnalité vous propose un dispositif plus fiable et plus efficace pour mettre à jour les appels vers des services tiers. En définissant une variable système sur un service tiers, seule la variable système doit être mise à jour en cas de changement, au lieu de devoir mettre à jour manuellement chaque script, appel REST ou workflow qui appelle le service tiers.

Les variables système sont gérées dans Therefore™ Solution Designer. Cliquez avec le bouton droit de la souris sur le nœud « Variables système » ou sur tout répertoire sous-jacent sous « Création » pour ouvrir un menu contextuel.

Nouvelle variable système
Ouvre la boîte de dialogue « Nouvelle variable système », qui vous permet de définir une nouvelle variable système.

Nom de la variable
Entrez le nom de la variable. Il sera utilisé pour appeler la variable.

Valeur de la variable
Entrez la valeur à stocker dans cette variable.

Type de la variable
Sélectionnez le type de la variable dans le menu déroulant. Texte (texte Unicode composé de 3 000 caractères au plus), Entier (nombre 32 bits non signé) et Décimal.

Nouveau répertoire
Crée un sous-répertoire sous le nœud « Variables système » principal ou le répertoire actuellement sélectionné.

Lorsque le nœud « Variables système » ou un sous-répertoire est sélectionné, la liste des variables système qu'il contient est affichée. Cliquez avec le bouton droit de la souris sur une variable système pour ouvrir un menu contextuel.

Ouvrir la variable système
Ouvre la boîte de dialogue « Modifier la variable système », qui vous permet de modifier la variable système. Vous pouvez également double-cliquer sur une variable pour ouvrir la boîte de dialogue.

Supprimer
Supprime la variable système sélectionnée. Avant l'exécution de la suppression, un message s'affiche et vous demande de confirmer l'opération.

Lorsqu'il supprime une variable système, le système vérifie si elle est utilisée. Si tel est le cas, un second avertissement s'affiche après la première confirmation. La suppression d'une variable système utilisée peut entraîner des conséquences sérieuses et imprévisibles. Il en va de même lorsque le système doit renommer une variable système. Il effectue la même vérification et vous demande de confirmer la modification. Étant donné que les variables ne sont identifiées en interne que par leur nom, toute modification du nom signifie que chaque appel de la variable doit à présent être mis à jour pour utiliser le nouveau nom.

Utilisation de variable système

Génération de scripts

Vous pouvez charger des variables système dans le code à l'aide de la fonction suivante :

• GetSystemVariable (VariableName) : cette fonction renvoie la valeur que contient la variable. Si la variable n'existe pas, un message d'erreur s'affiche.

Conditions de workflow

Vous pouvez utiliser des variables système lorsque vous définissez des conditions de transition. Un administrateur peut sélectionner des variables comme il/elle sélectionne des macros. Les exemples d'utilisation suivants sont actuellement pris en charge :

• Appeler la variable avec [$var_name] pour remplacer un nom de colonne, un nom de table ou une valeur numérique par la valeur que contient la variable.

• Utiliser des variables de type « chaîne » pour comparer des valeurs de base de données à des variables système. This is also compatible with

• Vérifier si un document correspondant existe ou non dans une autre catégorie à l'aide de [$CategoryTable(CtgryID)]. Vous pouvez spécifier « CtgryID » à l'aide d'une variable système de type chaîne en le remplaçant par le nom de la variable.

Tâches de workflow

Vous pouvez utiliser des variables système dans des tâches de workflow telles que Appel REST, Mettre à jour données d'index, etc. Ce cas de figure s'apparente à une utilisation lors de la génération de scripts, où vous pouvez appeler une valeur stockée par une variable.

À titre d'exemple, la tâche Mettre à jour données d'index peut assigner une nouvelle valeur à un champ de données d'index à l'aide de la fonction GetSystemVariable.
Dans l'exemple d'utilisation ci-dessous, une entreprise possède des succursales implantées dans diverses villes. Elle va fermer l'une de ses succursales et transférer son personnel vers une autre adresse. En stockant les adresses des différentes succursales sous forme de variable système, l'entreprise peut mettre à jour les données relatives à chaque employé pour indiquer l'adresse correcte à l'aide de la tâche Mettre à jour données d'index et appeler la variable système.

L'entreprise définit une variable associée à l'adresse de chaque succursale.

Chaque employé basé à Édimbourg doit être transféré dans la succursale implantée à Croydon. Dans cette optique, un workflow associé à la tâche Mettre à jour données d'index a été configuré pour mettre à jour le champ de données d'index « Department Address (Adresse du service) », « GetSystemVariable » servant d'affectation.

Vous pouvez maintenant sélectionner les documents appropriés dans Therefore™ Navigator et démarrer le workflow à l'aide de la tâche Mettre à jour données d'index.

Une fois la tâche de workflow terminée, le champ pour lequel a été configurée l'affectation est mis à jour.