save_result_file()-Methode

Speichert eine Ergebnisdatei, die von einem Python/HCL-Skript während einer Aufgabenausführung ausgegeben wird.

Syntax

hcl.save_result_file(name = "Name_der_Ergebnisdatei")

Parameter

Name Beschreibung
name = Name_der_Ergebnisdatei

Der Name der Ergebnisdatei. Der Name muss in Anführungszeichen gesetzt werden.

Sie müssen den Namen der Datei, die bereits durch das Python/HCL-Skript erzeugt wurde, buchstabengenau, einschließlich der Dateierweiterung.

Bei Name_der_Ergebnisdatei wird die Groß- und Kleinschreibung beachtet. Die Groß- und Kleinschreibung des vom Python/HCL-Skript erzeugten Dateinamens muss übereinstimmen.

Gibt zurück

Im Erfolgsfall lautet der Rückgabecode 202. Bei einem Fehler wird die Fehlermeldung ausgegeben.

Beispiele

Ergebnisdatei einer Aufgabenausführung speichern

Sie möchten eine Ergebnisdatei mit doppelten Rechnungsdatensätzen aus dem ersten Quartal 2022 speichern. Die Datensätze befinden sich in einer Datei namens Duplicate_Invoices_Q1_2022.csv, die Sie mit einer Python-Methode in einem Skript erstellen. Um die Datei dauerhaft auf der Registerkarte Aufgabenausführungen im Robot zu speichern, müssen Sie die separate HCL-Methode save_result_file() verwenden.

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

Bemerkungen

Verhalten beim Speichern von Dateien

Wenn Sie dieselbe Ergebnisdatei mehr als einmal in demselben Skript speichern, wird die zuvor gespeicherte Kopie der Datei automatisch überschrieben.

Ergebnisdatei als Visualisierung darstellen

Wenn Sie die save_result_file()-Methode testen, indem Sie ein Skript interaktiv im Robots Skript-Editor ausführen, wird die Ergebnisdatei auf dem Cloud-basierten Diligent One-Datenspeicher gespeichert. Die gespeicherte Ergebnisdatei wird jedoch nicht gesondert von der temporären Kopie der Datei visualisiert, die im Bereich Sitzungsdateien im Skript-Editor angezeigt wird. Der Rückgabewert 202 zeigt Ihnen an, dass eine Ergebnisdatei erfolgreich gespeichert wurde.

Wenn Sie die gespeicherte Datei separat als Visualisierung anzeigen möchten, erstellen Sie eine Aufgabe und führen das Skript mit Hilfe der Aufgabe aus. Die gespeicherte Ergebnisdatei wird im Bereich Details zur Aufgabenausführung angezeigt, wobei sich die Aufgabenausführung auf der Registerkarte Aufgabenausführung befindet.

Skript-Fehlermeldung

Alle diese Situationen führen zu der unten gezeigten Fehlermeldung des Skripts:

  • die angegebene Datei wurde bisher nicht vom Skript erzeugt

  • der Dateiname ist falsch geschrieben

  • die Groß- und Kleinschreibung des Dateinamens entspricht nicht genau dem Original

  • die Dateierweiterung fehlt

Skript-Fehlermeldung:

FileNotFoundError: Die Datei Name_der_Ergebnisdatei ist im Arbeitsverzeichnis nicht vorhanden