Commande PYCOMMAND

Transmet une table Analytics à un script Python externe sous forme de cadre de données et crée une nouvelle table dans le projet Analytics à l’aide de la sortie renvoyée par le script Python externe.

Syntaxe

PYCOMMAND <<FIELDS> field <...n>|<FIELDS> ALL> <IF test> <TO table_name> SCRIPT path_to_script <WHILE test> <FIRST range|NEXT range> <KEEPTITLE> <SEPARATOR character> <QUALIFIER character> <PASSWORD num|PROMPT_PASSWORD> <OPEN>

Paramètres

Exemples

• Allers-retours de données entre Analytics et un script Python

• Utiliser un script Python pour importer des données dans Analytics

OPEN Trans_Cf
PYCOMMAND FIELDS No_Fournisseur No_Facture Date_Facture Montant_Facture Coût_Unitaire Quantité NumProd SCRIPT "testInOutput.py" KEEPTITLE TO aller-retour_AN_Python.fil

OPEN Trans_Cf
PYCOMMAND FIELDS ALL SCRIPT "testInOutput.py" KEEPTITLE TO aller-retour_AN_Python.fil

import sys
import os
import logging
import pandas as pd
from acl_py_util import acl_py_util
from acl_py_util import logger

def main(args):
    error_file = os.getenv("ACL_PY_ERROR_FILE")
    if not error_file:
        error_file = os.getenv('LOCALAPPDATA') + "/acl_py_utl.error"

    # Import data from Analytics to Python
    # Use Python function included with Analytics
    df = acl_py_util.from_an()

    ''' Sample user code '''

    # Create acl_py_util log entry with column names and rows from dataframe
    logger.info(df)

    # Copy the original dataframe to a new dataframe
    user_df = df.copy()

    # Multiply the Invoice_Amount column by 2
    user_df.Invoice_Amount = user_df.Invoice_Amount * 2

    # Create acl_py_util log entry with column names and rows from dataframe
    logger.info(user_df)

    ''' End sample user code '''

    # Export data from Python to Analytics
    # Use Python function included with Analytics
    acl_py_util.to_an(user_df)

    # Create acl_py_util log entry recording script completion, and add an empty line
    logger.info(f"*** Python script completed successfully ***\n")

if __name__ == "__main__":
    main(sys.argv)

PYCOMMAND SCRIPT "testOutput.py" TO Entrée_de_Python.fil

import sys
import os
import logging
import pandas as pd
from acl_py_util import acl_py_util
from acl_py_util import logger 

def main(args):

    # Initialize sample accounts payable data
    data = {'Vendor_Number': ['12701', '10134', '11663'],
            'Nom_Fournisseur': ['Harris Projects', 'Stars Trading', 'More Power Industries'],
            'Ville_fournisseur': ['Baton Rouge', 'Milwaukee', 'Los Angeles'],
            'Numéro_Facture': ['232556', '74841', '5986811'],
            'Date_Facture': ['2024-10-22', '2024-10-22', '2024-10-23'],
            'Invoice_Amount': [2064,48, 18883,34, 1145,58],
            'Numéro_Produit': ['030302903', '030302303', '090501551'],  
            'Quantité': [204, 458, 626],
            'Coût_unitaire': [10, 41, 1]}

    # Create dataframe
    df = pd.DataFrame(data)

    # Create acl_py_util log entry with column names and rows from dataframe
    logger.info(df)

    # Sample user code

    user_df = df

    # End sample user code

    # Export data from Python to Analytics
    # Use Python function included with Analytics
    acl_py_util.to_an(user_df)

    # Create acl_py_util log entry recording script completion, and add an empty line
    logger.info(f"*** Python script completed ***\n")

if __name__ == "__main__":
    main(sys.argv)

Remarques

Fonctionnement de PYCOMMAND

PYCOMMAND transmet une table Analytics à un script Python externe sous forme de cadre de données, attend pendant que le script Python s’exécute, puis crée une nouvelle table dans Analytics à l’aide de la sortie renvoyée par le script Python externe. Vous pouvez utiliser PYCOMMAND autant de fois que nécessaire au cours d’un script Analytics.

Deux fonctions Python sont incluses dans l’installation d’Analytics ; vous pouvez les utiliser dans le script Python pour les données d’entrée et de sortie :

• Données d'entréeacl_py_util.from_an() importe des données d’Analytics vers Python

• Données de sortieacl_py_util.to_an() exporte des données de Python vers Analytics

Fichiers traces

Analytics crée deux fichiers traces associés à PYCOMMAND. Les journaux peuvent vous aider à résoudre les problèmes d’intégration entre Analytics et Python, ainsi qu’à déboguer les erreurs des scripts Analytics et Python associés.

Les fichiers traces sont stockés dans le dossier du projet Analytics :

• aclpython.log : enregistre les messages d'erreur d'Analytics lorsque PYCOMMAND échoue

• acl_py_util.log : enregistre les messages d'information renvoyés par le script Python

Configurer acl_py_util.log

acl_py_util.log est une trace configurable incluse dans l'installation d'Analytics. Appliquez les étapes ci-dessous et configurez la trace.

1. Dans le bloc d’instructions d’importation tout en haut du script Python, ajoutez cette instruction :

   from acl_py_util import logger

2. À n’importe quel endroit du script Python où vous souhaitez créer une saisie de la trace, ajoutez la ligne suivante :

   logger.info(Python_object)

   Par exemple :

   • logger.info(dataframe_name.head(10)) crée une saisie de trace avec les noms de colonne et les 10 premières lignes du cadre de données nommé dans son état actuel.

   • logger.info(f"*** Python script completed ***\n") inséré à la fin du script enregistre l'achèvement du script dans la trace et insère une ligne vide entre les détails de la trace pour permettre des exécutions de script séparées.

Comment PYCOMMAND met un mot de passe à la disposition du script Python

Lorsque PYCOMMAND inclut le paramètre PASSWORD ou PROMPT_PASSWORD, un mot de passe fourni par l’utilisateur est mis à la disposition du script Python. Le mot de passe est stocké temporairement et en toute sécurité dans la mémoire, dans la variable d’environnement ACL_PY_PASSWORD. Le mot de passe ne figure pas dans la trace Analytics.

Pour accéder à la variable d’environnement PASSWORD dans le script Python, définissez une variable Python en utilisant la syntaxe suivante :

password_from_analytics = os.getenv("ACL_PY_PASSWORD")