save_result_file() methode

Slaat een resultaatbestand op dat tijdens een taakuitvoering door een Python/HCL-script is gegenereerd.

Syntaxis

hcl.save_result_file(name = "result_file_name")

Parameters

Naam Beschrijving
name = result_file_name

De naam van het resultaatbestand. De naam moet tussen aanhalingstekens staan.

U moet de naam van het bestand dat al door het Python/HCL-script is geproduceerd, exact repliceren, inclusief de bestandsextensie.

result_file_name is hoofdlettergevoelig. U moet de hoofdletters en kleine letters van de bestandsnaam die door het Python/HCL-script wordt gegenereerd, exact overnemen.

Retourneert

Voor succes is de retourcode 202. Voor een fout, een foutmelding.

Voorbeelden

Een resultaatbestand van een taakuitvoering opslaan

U wilt een resultaatbestand opslaan met dubbele factuurrecords uit het eerste kwartaal van 2022. De records bevinden zich in een bestand genaamd Duplicate_Invoices_Q1_2022.csv dat u eerder in een script produceert met behulp van een Python-methode. Om het bestand permanent op te slaan op het tabblad Taakuitvoeringen in de robot, moet u de afzonderlijke HCL-methode save_result_file() gebruiken.

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

Opmerkingen

Gedrag bij opslaan van bestanden

Als u hetzelfde resultaatbestand meer dan één keer opslaat in hetzelfde script, wordt de eerder opgeslagen kopie van het bestand automatisch overschreven.

Visualisatie van het resultaatbestand

Als u de methode save_result_file() test door een script interactief uit te voeren in de Robots-scripteditor, wordt het resultaatbestand opgeslagen op de cloudgebaseerde opslaglocatie van Diligent One. Het opgeslagen resultaatbestand wordt echter niet apart gevisualiseerd van de tijdelijke kopie van het bestand dat wordt gevisualiseerd in het paneel Sessiebestanden in de scripteditor. Een 202-retourcode geeft aan dat een resultaatbestand succesvol is opgeslagen.

Als u het opgeslagen bestand afzonderlijk gevisualiseerd wilt zien, maakt u een taak en voert u het script uit met behulp van de taak. Het opgeslagen resultaatbestand verschijnt in het paneel Details van taakuitvoering dat is gekoppeld aan de specifieke taakuitvoering op het tabblad Taakuitvoeringen.

Scriptfoutbericht

Elk van deze situaties veroorzaakt de onderstaande scriptfoutmelding:

  • het opgegeven bestand is niet eerder door het script geproduceerd

  • de bestandsnaam is verkeerd gespeld

  • de hoofdletters en kleine letters van de bestandsnaam zijn niet exact overgenomen

  • the file extension is missing

Script-foutmelding:

FileNotFoundError: Bestand result_file_name bestaat niet in de werkmap