save_result_file() メソッド

タスク実行中に Python/HCL スクリプトによって出力された結果ファイルを保存します。

構文

hcl.save_result_file(name = "結果ファイル名")

パラメーター

名前 説明
name = 結果ファイル名

結果ファイルの名前。名前は引用符で囲む必要があります。

Python/HCL スクリプトによってすでに生成されたファイルの名前（拡張子を含む）を正確に入力する必要があります。

結果ファイル名は大文字と小文字を区別します。Python/HCL スクリプトで生成されたファイル名の大文字と小文字と一致する必要があります。

戻り値

成功した場合、戻りコードは 202 です。失敗した場合、エラー メッセージ発生します。

例

タスク実行から結果ファイルを保存する

2022 年第 1 四半期の重複する請求レコードが含まれる結果ファイルを保存します。レコードは、スクリプトで Python メソッドを使用して生成された Duplicate_Invoices_Q1_2022.csv ファイルに含まれています。ファイルを永久的にロボットの［タスクの実行 ］タブに保存するには、別の HCL メソッド save_result_file() を使用する必要があります。

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

備考

ファイル保存動作

同じスクリプトで 2 回以上同じ結果ファイルを保存すると、前に保存されたファイルのコピーが自動的に上書きされます。

結果ファイルの視覚化

ロボットスクリプト エディターで対話式にスクリプトを実行し、save_result_file() メソッドをテストする場合は、結果ファイルがクラウドベースの Diligent One データストレージに保存されます。ただし、保存された結果ファイルは、スクリプト エディターの［セッションファイル］で視覚化されたファイルの一時コピーとは別に視覚化されません。戻りコード 202 は、結果ファイルが正常に保存されたことを示します。

保存済みの視覚化されたファイルを別に表示する場合は、タスクを作成し、タスクを使用してスクリプトを実行します。保存済みの結果ファイルは、［タスクの実行］タブの特定のタスク実行に関連付けられた［タスクの実行の詳細］パネルに表示されます。

スクリプト エラー メッセージ

次の状況では、スクリプト エラー メッセージが表示されます。

  • 指定されたファイルがスクリプトによって以前に生成されたファイルではない

  • ファイル名の綴りが間違っている

  • ファイル名の大文字と小文字が正確に指定されていない

  • ファイル拡張子がない

スクリプト エラー メッセージ：

FileNotFoundError: ファイル "結果ファイル名" は作業ディレクトリに存在しません