Méthode save_result_file()

Enregistre une sortie fichier de résultats par un script Python/HCL pendant l'exécution de la tâche.

Syntaxe

hcl.save_result_file(name = "nom_fichier_résultat")

Paramètres

Nom Description
name = nom_fichier_résultat

Le nom du fichier de résultat. Le nom doit être entouré de guillemets.

Vous devez répliquer de manière exacte le nom du fichier déjà produit par le script Python/HCL avec l'extension de fichier.

nom_fichier_résultat respecte la casse. Vous devez faire correspondre la casse du nom de fichier produit par le script Python/HCL.

Renvoie

En cas de succès, le code de retour 202. En cas d'échec, un message d'erreur.

Exemples

Enregistrer un fichier de résultat à partir une exécution de tâche

Vous souhaitez enregistrer un fichier de résultats comportement les enregistrements des factures en doublon du premier trimestre 2022. Les enregistrements sont contenus dans un fichier nommé Factures_doublons_T1_2022.csv que vous générez à l'aide d'une méthode Python auparavant dans un script. Pour enregistrer définitivement le fichier dans l'onglet Exécutions de la tâche dans le robot, vous devez utiliser la méthode HCL distincte save_result_file().

hcl.save_result_file(name = "Factures_doublons_T1_2022.csv")

Remarques

Comportement lors de l'enregistrement de fichiers

Si vous enregistrez le même fichier de résultats plusieurs fois dans le même script, la copie du fichier qui a été enregistrée précédemment est automatiquement écrasée.

Visualiser le fichier de résultats

Si vous testez la méthode save_result_file() en exécutant un script de façon interactive dans l'éditeur de script Robots, le fichier de résultats est enregistré à l'emplacement de stockage de données Diligent One sur le cloud. Toutefois, le fichier de résultats enregistré n'est pas séparé de la copie temporaire du fichier visualisé dans le panneau Fichiers de la session dans l'éditeur de script. Un code de retour 202 vous indiquer qu'un fichier de résultat a été correctement enregistré.

Pour voir une visualisation séparée du fichier enregistré, créez une tâche et exécutez le script à l'aide de la tâche. Le fichier de résultat enregistré apparaît dans le panneau Détails de l'exécution de la tâche associé à l'exécution spécifique de la tâche dans l'onglet Exécutions de la tâche.

Message d'erreur de script

Ces situations génèrent le message d'erreur de script affiché ci-dessous :

  • le fichier spécifié n'a pas été produit par le script auparavant ;

  • le nom du fichier est mal orthographié ;

  • la casse dans le nom de fichier n'est pas répliquée exactement ;

  • l'extension de fichier est manquante.

Message d'erreur de script :

FileNotFoundError : Le fichier nom_fichier_résultat n'existe pas dans le répertoire de travail