Fonction PYDATE( )

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

Syntaxe

PYDATE("fichier py;fonction py" <; 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 objet DateHeure.Date Python.
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 objet DateHeure.Date Python.

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

DateHeure.

Exemples

Exemples basiques

Renvoie `20160630` :

PYDATE('hello,due_date'; `20160531`; 30)

Script Python externe qui accepte une date et un délai de grâce sous forme de nombres de jours et calcule la date d'échéance de la facture : Pour une date de facture au 2016-05-31 et une période de 30 jours : "2016-06-30"

#! python
from datetime import timedelta

def due_date(inv_date, period):
    return(inv_date + timedelta(period))

Exemples avancés

Définition d'un champ calculé

Définit un champ calculé dans la table Trans_Cf à l'aide du script Python qui calcule la date d'échéance :

OPEN Trans_Cf
DEFINE FIELD date_échéance COMPUTED 
WIDTH 27
    PYDATE( "hello;due_date" ; date_facture; période_paie)