Fonction PYNUMERIC( )

Renvoie une valeur numérique calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

Syntaxe

PYNUMERIC(fichier py;fonction py; décimale <; champ|valeur <;...n>>)

Paramètres

Nom	Type	Description
fichier py;fonction py	caractère	Le nom du script Python à exécuter suivi d'une virgule, puis le nom de la fonction renvoyant la valeur : "monScript;maFonction" Lorsque vous indiquez le script Python, ignorez l'extension du fichier. La fonction que vous appelez peut appeler d'autres fonctions dans le script ou à l'intérieur d'autres scripts ; toutefois, tous les scripts qui s'exécutent doivent être placés à l'intérieur d'un dossier dans la variable d'environnement système PYTHONPATH avant l'exécution. Pour plus d'informations, consultez la section Installer Python version 3.5.x (32 bits). Remarque Votre fonction py doit renvoyer un type numérique Python.
décimale	numérique	Nombre de décimales à inclure dans la valeur renvoyée. Doit être un nombre entier positif.
champ \|valeur <;...n> optionnel	caractère numérique DateHeure logique	Cette liste de champs, d'expressions ou de valeurs littérales à utiliser comme arguments pour la fonction Python. Les valeurs sont transmises dans la fonction que vous appelez dans l'ordre dans lequel vous les spécifiez. Vous pouvez inclure autant d'arguments que nécessaires pour répondre à la définition de la fonction dans le script Python. Remarque La fonction ALLTRIM() sert à supprimer les espaces de début ou de fin de l'entrée de caractères : ALLTRIM(str). Pour plus d'informations, consultez la section Fonction ALLTRIM( ).

Nom

Type

Description

fichier py;fonction py

caractère

Le nom du script Python à exécuter suivi d'une virgule, puis le nom de la fonction renvoyant la valeur :

"monScript;maFonction"

Lorsque vous indiquez le script Python, ignorez l'extension du fichier. La fonction que vous appelez peut appeler d'autres fonctions dans le script ou à l'intérieur d'autres scripts ; toutefois, tous les scripts qui s'exécutent doivent être placés à l'intérieur d'un dossier dans la variable d'environnement système PYTHONPATH avant l'exécution.

Pour plus d'informations, consultez la section Installer Python version 3.5.x (32 bits).

Remarque

Votre fonction py doit renvoyer un type numérique Python.

décimale

numérique

Nombre de décimales à inclure dans la valeur renvoyée. Doit être un nombre entier positif.

champ |valeur <;...n>

optionnel

caractère

numérique

DateHeure

logique

Cette liste de champs, d'expressions ou de valeurs littérales à utiliser comme arguments pour la fonction Python. Les valeurs sont transmises dans la fonction que vous appelez dans l'ordre dans lequel vous les spécifiez.

Vous pouvez inclure autant d'arguments que nécessaires pour répondre à la définition de la fonction dans le script Python.

Remarque

La fonction ALLTRIM() sert à supprimer les espaces de début ou de fin de l'entrée de caractères : ALLTRIM(str). Pour plus d'informations, consultez la section Fonction ALLTRIM( ).

Sortie

Numérique.

Exemples

Exemples basiques

Renvoie 35,00 :

PYNUMERIC("hello;get_nth_percent"; 2; 80; 120; 30; 45; 30; 100; 35; 45)

Script Python externe qui renvoie la valeur au centile demandé à partir d'une liste de valeurs à taille dynamique :

# hello.py content
from math import ceil
def get_nth_percent(percentage, *values):
    input_length = len(values)
    position = ceil((percentage/100.00) * input_length)
    return values[position-1]