Fonction PYSTRING( )

Renvoie une valeur de type caractère calculée par une fonction dans un script Python externe. Le traitement des données dans Python est externe à Analytics.

Syntaxe

PYSTRING("fichier py;fonction py"; longueur <;champ|valeur <;...n>>)
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 objet chaîne Python.
longueur numérique La longueur à allouer pour la chaîne de retour.
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

Caractère.

Exemples

Exemples basiques

Renvoie "my test" :

PYSTRING('hello,main'; 20; "my")

Script Python externe qui accepte une chaîne et concatène " test" à la chaîne :

#! python
# hello.py content
def main(str):
    str2 = str + ' test'
    return(str2)

Exemples avancés

Renvoi d'une sous-chaîne

Cet exemple supprime les deux derniers caractères du champ Nom du fournisseur et renvoie la sous-chaîne :

PYSTRING( "hello;sub_set"; LENGTH(Nom_Fournisseur); ALLTRIM(Nom_Fournisseur); LENGTH(ALLTRIM(Nom_Fournisseur)); 0; LENGTH(ALLTRIM(Nom_Fournisseur)) - 2)

Script Python externe qui accepte une chaîne de caractères, une longueur de chaîne et deux positions de caractères. La fonction renvoie une sous-chaîne entre la position un et la position deux :

#hello.py content
def sub_set(str, length, p1, p2):
if p1 >= 0 and p2 < length and p1 < p2:
    str2 = str[p1:p2]
else:
    str2 = str
return str2