Calculs et décisions
Les calculs et les décisions sont très semblables et sont donc modifiés pratiquement de la même façon. Tous deux sont basés sur une expression, mais avec deux grandes différences. Premièrement, un calcul est une expression qui peut donner n'importe quelle valeur, mais une décision est une expression dont le résultat doit être VRAI ou FAUX. Deuxièmement, le résultat d'un calcul est enregistré dans un élément de données, ce n'est pas le cas du résultat d'une décision. Il sert uniquement à déterminer la direction que prendra le flux d'un processus.
Les expressions peuvent être créées de différentes manières. Elles peuvent être saisies directement dans l'éditeur d'expressions ou créées en glissant et déposant des éléments depuis la liste des fonctions ou la liste des éléments de données. La liste des fonctions affiche toutes les fonctions disponibles dans Blue Prism. Lorsqu'une fonction est glissée et déposée dans l'éditeur d'expressions, le texte de la fonction par défaut est automatiquement saisi à l'écran. De même, les éléments de données peuvent être glissés à partir de la liste des éléments de données et leurs noms seront automatiquement saisis dans l'éditeur d'expressions.
Les fonctions peuvent également être composées dans la zone Générateur de fonctions au centre de l'écran. Lorsqu'une fonction est sélectionnée dans la liste des fonctions, elle est affichée dans le générateur de fonctions avec une description de son utilisation et de ses paramètres. Vous pouvez attribuer des valeurs aux paramètres soit en les saisissant directement dans les champs affichés, soit en faisant glisser les éléments de données depuis la liste des éléments de données. Une fois la fonction créée, elle peut être transférée dans l'éditeur d'expressions à l'aide du bouton Coller.
Un calcul doit spécifier l'élément de données dans lequel enregistrer le résultat évalué. Le champ « Enregistrer le résultat dans » peut être rempli en saisissant le nom d'un élément de données ou en faisant glisser un élément de données de la liste à droite.
Une fois l'expression terminée, il est recommandé de vérifier qu'elle ne contient aucune erreur en sélectionnant le bouton « Validation du processus ». Blue Prism vérifie alors l'expression et met en surbrillance l'emplacement probable de l'erreur.
Une fois vérifiée, une expression peut également être évaluée en sélectionnant le bouton Tester l'expression. Si des éléments de données ont été utilisés dans l'expression, un nouvel assistant de test d'expression apparaît et permet d'attribuer des valeurs temporaires à chaque élément de données pour que l'expression puisse produire un résultat. Si aucun élément de données n'a été utilisé dans l'expression, le résultat évalué est affiché dans un message contextuel. Si vous souhaitez uniquement tester une partie d'une expression, vous pouvez sélectionner cette partie en la faisant glisser et en la mettant en surbrillance à l'aide de la souris. Lorsque l'assistant de test d'expression apparaît, seule la partie sélectionnée de l'expression est utilisée.
Expressions
Les expressions sont composées d'éléments de données, d'opérateurs, de fonctions et de constantes.
Éléments de données
Les éléments de données sont référencés par nom et doivent être placés entre crochets, [Numéro de compte] par exemple.
Opérateurs
Les opérateurs sont représentés par leur symbole respectif, 1 + 2 par exemple.
Fonctions
Les fonctions se présentent sous la forme NomFonction(paramètre1,paramètre2), Mid(« Bonjour », 1, 2) par exemple.
La syntaxe de la plupart des fonctions est explicite. Vous trouverez ci-dessous les détails des fonctions les plus complexes.
La méthode recommandée pour trouver la différence entre deux dates, heures ou DateTimes est de les soustraire
Par exemple, MakeDate(26,5,1999) - MakeDate(29,5,1968) donnent l'intervalle de temps 11319.00:00:00
Lorsque vous devez trouver la différence dans un intervalle de temps non fixe qui peut varier selon la période de l'année, la fonction DateDiff offre quelques intervalles utiles. Ils sont répertoriés dans le tableau de la fonction DateAdd ci-dessous. Si date2 > date1 le nombre résultant est positif.
Si la semaine de l'année est utilisée, la valeur renvoyée représente le nombre de semaines entre le premier jour de la semaine contenant date1 et le premier jour de la semaine contenant date2.
Lorsque l'intervalle jour de semaine 2 est utilisé, la valeur renvoyée représente le nombre de semaines civiles complètes entre les deux dates (par exemple, si date1 est un lundi, elle compte le nombre de lundis jusqu'à date2 incluse)
Par exemple, si date1 est le jeudi 2/3/2017 et date2 est le mardi 7/3/2017 suivant, alors DateDiff(1, date1, date2) avec l'intervalle semaine de l'année renvoie 1, car les premiers jours des semaines civiles respectives sont séparés par une semaine.
Cependant, DateDiff(2, date1, date2) avec l'intervalle jour de semaine renvoie 0, car il n'y a pas de jeudi entre date1 et date2.
Paramètres
Les trois paramètres sont les suivants :
intervalle |
Un code spécifiant les unités souhaitées de la valeur renvoyée. Ces valeurs sont détaillées dans la fonction DateAdd. |
date1 |
La première des deux dates de comparaison. |
date2 |
La deuxième des deux dates de comparaison. |
Exemples
Pour calculer le nombre de semaines entre le 29/5/1968 et le 26/5/1999, utilisez DateDiff(1, MakeDate(29,5,1968), MakeDate(26,5,1999)). Cela renvoie correctement 1617.
La méthode recommandée pour ajouter un intervalle à une date, une heure ou DateTime est d'ajouter un intervalle de temps
Par exemple, MakeDate(26,5,1999) + MakeTimeSpan(3, 0, 0, 0) donnerait 29/05/1999.
Pour les heures, MakeTime(12,30,0) + MakeTimeSpan(0, 1, 5, 3) donnerait 13:35:03.
Lorsque vous devez ajouter un intervalle de temps non fixe qui peut varier selon la période de l'année, la fonction DateAdd offre quelques intervalles utiles. Chaque type d'intervalle est représenté par les nombres répertoriés ci-dessous :
Intervalle |
DateAdd |
DateDiff |
---|---|---|
0 |
Année |
Année |
1 |
Semaine |
Semaine de l'année (semaine civile) |
2 |
(n/a) |
Jour de semaine (semaine complète de 7 jours) |
3 |
(n/a) |
Seconde |
4 |
Trimestre |
Trimestre |
5 |
Mois |
Mois |
6 |
(n/a) | Minute |
7 |
(n/a) |
Heure |
8 |
(n/a) |
Jour de l'année |
9 |
(n/a) |
Jour |
Comme indiqué, certains intervalles ne sont pas applicables à la fonction DateAdd, mais ont été choisis pour que le même ensemble de nombres puisse être utilisé pour la fonction DateAdd et la fonction DateDiff
Par exemple, utilisez l'intervalle numéro 5 pour ajouter un nombre de mois à une date. Donc pour ajouter 2 mois au 26/5/1999, utilisez DateAdd(5, 2, MakeDate(26,5,1999)). Cela renvoie correctement 26/7/1999.
Les intervalles sont soustraits d'une manière similaire en utilisant une valeur négative pour la quantité d'intervalles, soit DateAdd(5, -2, MakeDate(26,5,1999)) donne 26/3/1999.
La fonction DateAdd ne renvoie pas de date non valide. Par exemple, si vous ajoutez 1 mois au 31 janvier 2005 à l'aide de DateAdd(5,1,MakeDate(31,1,2005)), la fonction renvoie 28/2/2005 (plutôt que la date 31/02/2005 inexistante).
Cette fonction est utilisée pour formater une date selon vos préférences ou pour extraire une plus petite information (telle que le jour de la semaine) d'une date complète.
Paramètres
Les deux paramètres sont les suivants :
date |
La valeur de la date à formater en tant que valeur de texte. |
format |
La chaîne de format, qui spécifie le format du résultat souhaité. Elle peut être saisie sous la forme d'une seule lettre indiquant un format de date standard ou d'une chaîne de caractères spécifiant un format de date personnalisé.. |
Exemples
- FormatDate(« 02-11-2016 », « J ») renvoie « 02 novembre 2016 »
- FormatDate(« 02 Nov 2016 », « j ») renvoie « 2/11/2016 »
- FormatDate(« 02-11-2016 », « M ») renvoie « 2 novembre »
- FormatDate(« 02-11-2016 », « jjjj ») renvoie « mercredi »
- FormatDate(« 02/11/2016 », « aaaa-MM-jj ») renvoie « 2016-11-02 »
- FormatDate(« 02/11/2016 », « MMM jj, aaaa ») renvoie « nov 02, 2016 »
Chaînes de format
- Pour une liste complète des chaînes de format de date et d'heure standard, consultez https://msdn.microsoft.com/en-us/library/az4se3k1(v=vs.110).aspx.
- Pour plus d'informations sur la création de chaînes de format de date et d'heure personnalisées, consultez https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.110).aspx.
Cette fonction est utilisée pour formater une date et heure selon vos préférences ou pour extraire une plus petite information (telle que le jour de la semaine) d'une date et heure complète.
Paramètres
Les deux paramètres sont les suivants :
date |
La valeur de date et heure à formater en tant que valeur de texte. |
format |
La chaîne de format, qui spécifie le format du résultat souhaité. Elle peut être saisie sous la forme d'une seule lettre indiquant un format de date et heure standard ou d'une chaîne de caractères spécifiant un format de date et heure personnalisé. |
Exemples
- FormatDate(« 02-11-2016 09:23:43 », « t ») renvoie « 09:23 »
- FormatDate(« 02 Nov 2016 09:23:43 », « F ») renvoie « 02 novembre 2016 09:23:43 »
- FormatDate(« 02-11-2016 21:23:43 », « h:m tt ») renvoie « 9:23 PM »
- FormatDate(« 02-11-2016 21:23:43 », « jj/MM/aa HH:m:s ») renvoie « 02/11/16 21:23:43 »
Chaînes de format
- Pour une liste complète des chaînes de format de date et d'heure standard, consultez https://msdn.microsoft.com/en-us/library/az4se3k1(v=vs.110).aspx.
- Pour plus d'informations sur la création de chaînes de format de date et d'heure personnalisées, consultez https://msdn.microsoft.com/en-us/library/8kb3ddd4(v=vs.110).aspx.
MakeDate() est utilisé pour créer une date à partir de nombres.
Paramètres
Les trois paramètres sont les suivants :
jour | Le jour du mois à utiliser. Cette valeur doit être valide par rapport au mois choisi ; 30 n'est pas une valeur valide s'il s'agit du mois 2 (c'est-à-dire février) |
mois | L'index basé sur 1 du mois souhaité (ex : 4 correspond à avril). Ne doit pas dépasser 12. |
année |
L'année souhaitée, 2001 par exemple. |
Années à deux chiffres
Pour des raisons de compatibilité avec les anciens processus, lorsque cela était autorisé, la fonction MakeDate accepte les années à deux chiffres et les interprète en utilisant la règle 2029. Cependant, il est fortement recommandé de ne jamais utiliser cette fonctionnalité. Donnez toujours une année complète, y compris le siècle. Si l'année est extraite d'un autre système à deux chiffres, renseignez-vous sur la convention utilisée par ce système et appliquez-la dès que vous consultez les données.
Exemples
- MakeDate(21,6,2005) renvoie la date 21 juin 2005
- MakeDate(21,6,1995) renvoie la date 21 juin 1995
- MakeDate(5,12,29) renvoie la date 5 décembre 2029
- MakeDate(5,12,30) renvoie la date 5 décembre 1930
Conseils
La fonction MakeDate est la méthode préférée pour former une nouvelle date, plutôt que d'utiliser une chaîne de caractères telle que « 02/03/2007 », dont la valeur est ambiguë puisqu'elle dépend des paramètres régionaux actuels (un Américain pourrait interpréter cette date différemment d'un Britannique).
Mid() est utilisé pour réduire une chaîne de caractères plus longue (c'est-à-dire une séquence de lettres) et la transformer en chaîne de caractères plus courte contenue dans cette chaîne de caractères (c'est-à-dire une sous-chaîne de caractères). Par exemple, Mid() peut être utilisé pour réduire la chaîne de caractères « Nom du client : John Smith » et la transformer en sous-chaîne de caractères, « John Smith ».
Paramètres
Les trois paramètres sont les suivants :
chaîne de caractères | La plus longue chaîne de caractères depuis laquelle une sous-chaîne de caractères doit être extraite. |
mois | L'index basé sur 1 de la première lettre souhaitée. |
année |
Le nombre maximal de caractères souhaité. La valeur renvoyée par la fonction contiendra ce nombre de caractères, à moins que la plus longue chaîne de caractères ne se termine en premier, auquel cas cette valeur deviendra un maximum théorique. |
Conseils
Lorsque la longueur maximale spécifiée par l'utilisateur dépasse la longueur de la chaîne de caractères fournie, Blue Prism réduit cette longueur pour obtenir la longueur de la chaîne de caractères fournie. Ainsi, pour éviter une trop grande quantité de lettres, il est souvent utile d'écrire un grand nombre dans le dernier argument : Mid(« Nom du client : John Smith », 16, 100). La chaîne de caractères « John » peut être obtenue en utilisant Mid(« Nom du client : John Smith »,16,4). Remarque : les arguments sont arrondis à des nombres entiers, donc Mid(« abcdefg », 1.2, 1.8) donnerait « ab ».
Exemples
Mid(« Nom du client : John Smith », 16, 25) renvoie « John Smith »
Left() est utilisé pour renvoyer les premières lettres d'une plus longue chaîne de caractères de lettres.
Paramètres
Les deux paramètres sont les suivants :
chaîne de caractères | La plus longue chaîne de caractères depuis laquelle une sous-chaîne de caractères doit être extraite. |
maxcharacters | Le nombre maximal de caractères souhaité. La valeur renvoyée par la fonction contiendra ce nombre de caractères, à moins que la plus longue chaîne de caractères ne se termine en premier, auquel cas cette valeur deviendra un maximum théorique. |
Conseils
Si la valeur maxcharacters dépasse le nombre de caractères de la chaîne de caractères (ou est égale à celui-ci), la fonction renvoie simplement la chaîne de caractères sans la modifier. Si vous le souhaitez, la valeur fournie à maxcharacters peut être zéro (renvoie une chaîne de caractères vide), mais ne peut pas être un nombre négatif.
Exemples
Left(« Blue Prism permet aux utilisateurs professionnels de faire plus en moins de temps », 10) renvoie « Blue Prism »
Right() fonctionne exactement comme Left(), mais renvoie la chaîne de caractères de fin (avec la longueur spécifiée) plutôt que la chaîne de caractères de début.
Len() renvoie le nombre de caractères d'une chaîne de caractères. Par exemple, Len(« Blue Prism ») renvoie le nombre 10.
Instr() vérifie si la sous-chaîne de caractères, la plus petite chaîne de caractères, est contenue dans la chaîne de caractères, la plus longue chaîne de caractères. Si c'est le cas, alors Instr() renvoie le nombre de caractères depuis la gauche pour que la première occurrence de sous-chaîne de caractères puisse être trouvée.
Paramètres
Les deux paramètres sont les suivants :
chaîne de caractères | La plus longue chaîne de caractères depuis laquelle une sous-chaîne de caractères doit être extraite. |
sous-chaîne de caractères | La plus petite chaîne de caractères, dont la présence doit être détectée dans la plus longue chaîne de caractères. |
Exemples
Instr(« Les calculs sont beaucoup plus rapides avec Blue Prism qu'avec un boulier », « sont ») renverra le nombre 14, car le mot « sont » apparaît pour la première fois au quatorzième caractère.
Conseils
Si la sous-chaîne de caractères ne se trouve pas dans la chaîne de caractères, Instr() renvoie zéro. Ainsi, Instr() est un moyen utile de tester la présence d'une chaîne de caractères plus petite dans une chaîne de caractères plus longue : par exemple, Instr(« Pommes », « Bananes ») > 0 renvoie FAUX.
Cette fonction permet d'ajouter un certain nombre de jours à une date choisie.
Paramètres
Les deux paramètres sont les suivants :
date | La date à laquelle les jours doivent être ajoutés. |
numDays | Le nombre de jours à ajouter. |
Exemples
AddDays(« 01/01/2006 », 10) renvoie la date « 11/01/2006 ».
Conseils
Comme pour la fonction DateAdd(), seules les dates valides sont renvoyées. Par exemple, dans une année bissextile, l'ajout d'un jour au 28 février donne le 29 février, alors que cela donne le 1er mars pour toutes les autres années.
Cette fonction permet d'ajouter un certain nombre de mois à une date choisie.
Paramètres
Les deux paramètres sont les suivants :
date | La date à laquelle les mois doivent être ajoutés. |
numMonths | Le nombre de mois à ajouter. |
Exemples
AddMonths(« 01/01/2006 », 10) renvoie la date « 01/11/2006 ».
Conseils
Comme pour la fonction DateAdd(), seules les dates valides sont renvoyées. Par exemple, l'ajout d'un mois au 31 janvier 2005 à l'aide d'AddMonths(« 31/01/2005 »,1) renvoie « 28/2/2005 » (plutôt que la date « 31/02/2005 » inexistante).
Cette fonction renvoie la date et la date et l'heure actuelles sous forme d'élément de données de date et heure.
Conseils
Si vous voulez simplement connaître la date du jour, il serait préférable d'utiliser la fonction Today() à la place.
Cette fonction renvoie la date actuelle sous forme d'élément de données de date.
Conseils
Si vous voulez connaître l'heure actuelle et la date du jour, il est préférable d'utiliser la fonction Now() à la place.
Cette fonction représente un nombre sous forme de texte. Cette fonction est souvent utile pour les devises, lorsque des nombres tels que le nombre 1 sont généralement représentés par « 1,00 ».
Paramètres
Les deux paramètres sont les suivants :
nombre | Le nombre à formater en texte. |
numPlaces | Le nombre maximal de décimales souhaité. |
Exemples
- DecPad(1,296,2) renvoie le texte « 1,30 ».
- DecPad(1,1111,2) renvoie le texte « 1,11 »
Conseils
Si le nombre de décimales de la représentation naturelle est trop élevé, alors le nombre approprié de décimales sera supprimé, en arrondissant le nombre avec une précision suffisante.
Cette fonction arrondit un nombre vers le bas pour obtenir le nombre de décimales souhaité. Le type de données de la valeur renvoyée est un nombre.
Paramètres
Les deux paramètres sont les suivants :
nombre | Le nombre à arrondir. |
numPlaces | Le nombre maximal de décimales souhaité. |
Exemples
- RndDn(9,19996,3) renvoie le nombre 9,199
- RndDn(9,1345,2) renvoie le nombre 9,13
- RndDn(3,14159,10) renvoie 3,14159 (le nombre reste inchangé)
Conseils
Si le nombre atteint déjà le niveau de précision souhaité, il reste inchangé, et ne sera notamment pas reformaté (comme il le serait avec la fonction DecPad). Voir aussi les fonctions Round et RndUp.
Cette fonction arrondit un nombre vers le haut pour obtenir le nombre de décimales souhaité. Elle fonctionne de la même manière que la fonction RndDn().
Paramètres
Les deux paramètres sont les suivants :
nombre | Le nombre à arrondir. |
numPlaces | Le nombre maximal de décimales souhaité. |
Exemples
- RndDn(9,19996,3) renvoie le nombre 9,200
- RndDn(9,1345,2) renvoie le nombre 9,14
- RndDn(3,14159,10) renvoie 3,14159 (le nombre reste inchangé)
Conseils
Si le nombre atteint déjà le niveau de précision souhaité, il reste inchangé, et ne sera notamment pas reformaté (comme il le serait avec la fonction DecPad). Voir aussi les fonctions Round et RndDn.
La fonction Round() utilise l'« arrondi bancaire ». Cela signifie qu'un nombre contenant des décimales est arrondi au nombre entier supérieur ou inférieur le plus proche. Si la décimale se trouve exactement entre deux nombres entiers, la fonction Round() arrondit au nombre entier pair le plus proche.
Paramètres
Les deux paramètres sont les suivants :
nombre | Le nombre à arrondir. |
numPlaces | Le nombre maximal de décimales souhaité. |
Exemples
- Round(2,5,0) renvoie le nombre 2
- Round(3,5,0) renvoie le nombre 4
- Round(3,513, 1) renvoie le nombre 3,5
- Round(3,14159,10) renvoie 3,14159 (le nombre reste inchangé)
Conseils
Si le nombre atteint déjà le niveau de précision souhaité, il reste inchangé, et ne sera notamment pas reformaté (comme il le serait avec la fonction DecPad). Voir aussi les fonctions RndUp et RndDn.
Cette fonction renvoie la racine carrée du nombre fourni. La racine carrée d'un nombre est le nombre positif unique qui, une fois multiplié par lui-même, donne le nombre de départ.
Exemples
- Sqrt(100) renvoie le nombre 10
- Sqrt(2) renvoie 1,414213562323731
Évalue le logarithme du nombre par rapport à la valeur de base spécifiée. Dans le cas d'une valeur v et d'une base b, le logarithme de v par rapport à la base b, écrit Log(v, b), répond à la question « quelle est la valeur de x dans bx = v ? ».
Exemples
- Log(1000, 10) = 3, car 103 = 1000.
- Log(1/4, 2) = -2, car 2-2 = 1/4
Cette fonction renvoie le caractère représenté par le code ASCII fourni.
Exemples
Chr(65) renvoie le texte « A »
Conseils
Pour une présentation complète du code ASCII, veuillez consulter une référence externe. Un guide rapide est fourni sur la page ASCII de Blue Prism.
Cette fonction renvoie la représentation en majuscules du texte fourni. Toutes les lettres du texte fourni qui sont déjà en majuscules restent inchangées, tandis que les autres sont modifiées.
Exemples
- Upper(« logiciel ») renvoie le texte « LOGICIEL »
- Upper(« aBcDeFg ») renvoie le texte « ABCDEFG »
Conseils
Voir aussi la fonction Lower().
Cette fonction renvoie la représentation en minuscules du texte fourni. Toutes les lettres du texte fourni qui sont déjà en minuscules restent inchangées, tandis que les autres sont modifiées.
Exemples
- Lower(« LOGICIEL ») renvoie le texte « logiciel »
- Lower(« aBcDeFg ») renvoie le texte « abcdefg »
Conseils
Voir aussi la fonction Upper().
Constantes
Le texte et les mots de passe sont représentés en mettant le texte entre guillemets, par exemple « Ceci est mon texte ».
Les nombres sont représentés en saisissant le nombre simple, par exemple 5 ou 1,2
Les indicateurs sont représentés par les mots Vrai ou Faux
Les dates sont représentées sous forme d'expression Texte au format jj/mm/aaaa, par exemple « 12/03/2004 »
Conversion
Une conversion se produit lorsqu'une entité d'un type de données est placée dans une expression dans laquelle un autre type de données était attendu.
Par exemple, vous pouvez attribuer un numéro à une fonction de texte.
Len(100)
Le 100 est automatiquement converti en texte « 100 », puis la fonction Length renvoie « 3 » puisque 100 est composé de 3 caractères.