Convertir à l'aide de JavaScript

Ce convertisseur de données offre la possibilité de spécifier la conversion à l'aide de JavaScript. Ce convertisseur de données peut par exemple être utile lorsque vous effectuez une manipulation de texte avancée telle que la réécriture d'URL, ou lors de l'exécution de calculs complexes. Pour les limitations, voir Limitations Kofax RPA.

L'entrée du convertisseur est disponible dans une variable INPUT définie implicitement. Le résultat de la conversion doit être assigné à la variable OUTPUT. Des fonctions d'aide peuvent être définies et appelées si nécessaire. Notez que l'accès à l'état du navigateur depuis JavaScript n'est pas possible dans ce convertisseur.

Propriétés

Le convertisseur de données Convertir à l'aide de JavaScript peut être configuré à l'aide des propriétés suivantes :

Script: Le JavaScript à exécuter. Cela peut être spécifié littéralement ou créé de plusieurs manières différentes en utilisant le Sélecteur de valeur.
Description: Saisissez une description à afficher dans la liste des convertisseurs de données. S'il n'existe aucun type dans une description, un type sera généré.

Exemple 1

Pour calculer la moyenne d'une liste de nombres séparés par des virgules, nous configurons le convertisseur de données Convertir à l'aide de JavaScript avec le script suivant qui effectue le calcul :

    var sum = 0;
    var numbers = INPUT.split(",");
    for (var i = 0; i < numbers.length; i++) {
        sum += parseInt(numbers[i]);
    }

    OUTPUT = sum / numbers.length;

Le JavaScript lit la liste des nombres, par exemple « 23,22,25,31,24 » de la variable INPUT, la découpe à chaque virgule en utilisant la fonction JavaScript intégrée split(), parcoure les nombres pour calculer la somme (notez que la fonction parseInt() est utilisée pour convertir une chaîne en nombre entier ; sinon, nous aurions concaténé les chaînes plutôt que de calculer la somme), et enfin calcule la moyenne et attribue le résultat à la variable OUTPUT.

Dans le cas où l'entrée du convertisseur de données est la chaîne « 23,22,25,31,24 », la sortie du convertisseur sera donc 25.

Exemple 2

Pour calculer la moyenne d'une liste de nombres séparés par des virgules, par exemple « $10.50,$13,$21.75,$7 », nous configurons le convertisseur de données Convertir à l'aide de JavaScript avec le script suivant qui effectue le calcul :

    function getNumber(amountWithDollarSign) {
        return parseFloat(amountWithDollarSign.substring(1));
    }

    var amountsWithDollarSigns = INPUT.split(",");
    var max = getNumber(amountsWithDollarSigns[0]);
    for (var i = 1; i < amountsWithDollarSigns.length; i++) {
        max = Math.max(max, getNumber(amountsWithDollarSigns[i]));
    }

    OUTPUT = max;

Dans le JavaScript ci-dessus, nous avons défini une fonction d'aide nommée getNumber() qui supprime le préfixe dollar du montant et convertit le reste en un nombre à virgule flottante. Cette fonction est appelée à plusieurs reprises dans le script. La fonction JavaScript intégrée Math.max() utilisée pour trouver le maximum de deux nombres ; à chaque itération, le nombre le plus élevé trouvé jusque-là est comparé au nombre suivant.

Enfin, le nombre le plus élevé trouvé est stocké dans la variable OUTPUT et représente la sortie du convertisseur de données.

Manipulation de chaînes

Les méthodes suivantes sont utiles lors de la conversion d'objets Chaîne. Notez que les chaînes sont écrites entre "" tandis que les expressions rationnelles sont écrites entre //. Un attribut global g à la fin d'une expression régulière indique que la méthode doit s'appliquer à toutes les correspondances.

Méthode	Description
string.charAt(n)	Renvoie le caractère avec l'index n.
string.charCodeAt(n)	Renvoie la valeur Unicode du caractère avec l'index n.
string.concat(valeur1, valeur2, etc.)	Une ou plusieurs valeurs sont concaténées en chaîne.
String.fromCharCode(c1, c2, etc.)	Crée une nouvelle chaîne à partir de nombre entiers en spécifiant le codage Unicode des caractères.
string.indexOf(sous-chaîne) string.indexOf(sous-chaîne, début)	Renvoie l'index de la sous-chaîne dans la chaîne. Début spécifie l'index à partir duquel la recherche doit commencer (0 étant le premier caractère de la chaîne et string.length-1 étant le dernier. La valeur par défaut est 0).
string.lastIndexOf(sous-chaîne) string.lastIndexOf(sous-chaîne, début)	Renvoie la position de la dernière occurrence de la sous-chaîne dans la chaîne. Début spécifie l'index à partir duquel la recherche doit commencer (0 étant le premier caractère de la chaîne et string.length-1 (par défaut) étant le dernier).
string.length	Longueur des caractères de la chaîne.
string.match(expression régulière)	Recherche dans la chaîne des correspondances avec une expression régulière. Renvoie uniquement la première correspondance à moins que l'expression régulière n'ait l'attribut global (g) spécifié, grâce auquel un tableau contenant tous les résultats de la correspondance est renvoyé.
string.replace(expression régulière, remplaçant) string.replace(sous-chaîne, remplaçant)	Recherche dans la chaîne des correspondances avec une expression régulière ou une sous-chaîne, puis remplace la première occurrence par le remplaçant. Si l'expression régulière possède l'attribut global (g) spécifié, toutes les occurrences sont remplacées par le remplaçant.
string.search(expression régulière)	Renvoie l'index du premier caractère de la première correspondance avec une expression régulière.
string.slice(début, fin)	Renvoie une chaîne contenant tous les caractères du début à fin-1.
string.split(délimiteur, limite)	le délimiteur est une chaîne ou une expression régulière qui spécifie les endroits où découper la chaîne. Renvoie un tableau de chaînes. Le tableau n'est pas plus long que la limite
string.substr(début, longueur)	Renvoie une copie de la sous-chaîne à partir du début de l'index et de la longueur.
string.substring(de, à)	Renvoie la sous-chaîne commençant à la position de et se terminant à -1.
string.toLowerCase()	Renvoie une copie de la chaîne convertie en minuscules.
string.toUpperCase()	Renvoie une copie de la chaîne avec toutes les lettres converties en majuscules.

L'objet Math

Les propriétés et méthodes suivantes sont utiles pour effectuer des calculs mathématiques. Tous les angles sont mesurés en radians.

Propriété / méthode	Description
Math.E	Renvoie le nombre d'Euler.
Math.LN10	Renvoie le logarithme naturel de 10.
Math.LN2	Renvoie le logarithme naturel de 2.
Math.LOG10E	Renvoie le logarithme en base 10 de E.
Math.LOG2E	Renvoie le logarithme en base 2 de E.
Math.PI	Renvoie pi.
Math.SQRT1_2	Renvoie la racine carrée de 1/2.
Math.SQRT2	Renvoie la racine carrée de 2.
Math.abs(x)	Renvoie la valeur absolue.
Math.acos(x)	Calcule le cosinus d'arc.
Math.asin(x)	Renvoie le sinus d'arc.
Math.atan(x)	Calcule la tangente d'arc.
Math.atan2(y, x)	Calcule l'angle par rapport à un point. L'entrée représente les coordonnées habituelles (x,y) mais l'ordre a été inversé.
Math.ceil(x)	Arrondit un nombre.
Math.cos(x)	La fonction cosinus.
Math.exp(x)	Prend e à la puissance x.
Math.floor(x)	Arrondit un nombre à la baisse.
Math.log(x)	Calcule l'algorithme naturel.
Math.max(x1, x2, etc.)	Renvoie le plus grand des nombres.
Math.min(x1, x2, etc.)	Renvoie le plus petit des nombres.
Math.pow(x,y)	Calcule x à la puissance y
Math.random()	Renvoie un nombre aléatoire compris entre 0 et 1
Math.round(x)	Arrondit au nombre entier le plus proche.
Math.sin(x)	La fonction sinus.
Math.sqrt(x)	Calcule la racine carrée.
Math.tan(x)	La fonction tangente.

Nombres

Il est possible de convertir un nombre en chaîne en utilisant String(nombre) et vice versa en utilisant Number(chaîne). Voici quelques-unes des méthodes utiles de l'objet Nombre.

Méthode	Description
number.toExponential(chiffres)	Spécifie le nombre de chiffres après la virgule décimale. Renvoie une représentation sous forme de chaîne du nombre en notation exponentielle.
number.toFixed(chiffres)	Spécifie le nombre de chiffres après la virgule décimale. Renvoie une représentation sous forme de chaîne du nombre qui n'utilise pas la notation exponentielle.
number.toPrecision(précision)	Spécifie le nombre de chiffres significatifs. Renvoie une représentation sous forme de chaîne du nombre avec le nombre spécifié de chiffres significatifs.
number.toString(base)	Renvoie une représentation sous forme de chaîne du nombre en utilisant la base spécifiée.

Convertir à l'aide de JavaScript

Propriétés

Manipulation de chaînes

L'objet Math

Nombres

Résultats de la recherche

Conseils de recherche