ジョブ実行結果を
ユニークなファイル名でフォルダに格納する

プラグインを活用し、ジョブ実行結果をユニークなファイル名で定期的に自動保存

POLESTAR Automationでは、プラグイン（定期的な運用作業ルール化のための機能）を利用することで、ジョブの実行結果をテキストファイルに変換し、ユニークなファイル名を付けて特定のフォルダに保管できます。

ログや返り値を定期的に保存できるプラグインの特徴は次のとおりです。

ファイル作成タイミングをスケジュール化できる（GUIで設定が可能）
出力したい項目を選択できる（ネットワーク機器のConfig情報、Windowsサーバーのイベントログ、各種サーバーのアクセスログなど）
作成日時分秒、ジョブ名、デバイス名などを組み合わせてユニークなファイル名を設定できる
作成日付日時分形式フォーマットを多数提供している
デバイス基準またはジョブ基準でファイルを出力できる

テキスト出力を行うためには、POLESTAR Automationの「JobResult Export Service」プラグインを利用します。「JobResult Export Service」プラグインには10のプロパティがあり、必要事項を設定することで、目的にあったテキストファイルをユニークなファイル名で出力することができます。

１．「JobResult Export Service」プラグインで設定するプロパティ項目

プラグインに設定するプロパティを表1に示します。

２．「COLUMNS」で出力設定可能な項目

「TABLE_NAME」でビューテーブル「V_JOB_RESULT_DEVICE_LAST」を選択した場合、「COLUMNS」で出力設定可能な項目を表２に示します。

「COLUMNS」では、出力したい項目が設定できます。デフォルト値は「*＝すべての項目」です。図１に「*」を設定した場合の出力結果を示します。

図1　「COLUMNS」値を「*」に設定した結果

図2　「COLUMNS」値を「HOSTNAME, IP_ADDRESS, MESSAGE, START_DATE, END_DATE」に設定した結果

３．「CREATION_OPTIONS」出力基準の設定

デバイス基準で出力するのか、またはジョブ基準で出力するのかの設定が行なえます。
図３にジョブ基準での出力例を示します。

図3　ジョブ基準の出力例（「dir確認」ネットワークスクリプトジョブ）

図４にデバイス基準での出力例を示します。

図4　デバイス基準の出力例（C2960X_192.168.10.198_20230422_dir確認）

４．「FILE_NAME」生成するファイル名の設定

「FILE_NAME」では、生成するファイル名が設定できます。
例） yyyyMMdd_$J_OBJECT_NAME$.txt

表３にファイルの生成年月日とジョブ名を出力する場合の設定方法、表４にホスト名、ファイルの生成日付、ジョブ名を出力する場合の設定方法を示します。

【参考】ジョブ名の出力は、「VALUES」に設定したビュー名の「$J_OBJECT_NAME$」が表示されます。
※VALUESをパラメータとして使用する場合は、前後に$を付けます。

５．「TABLE_NAME」ビューテーブル名の設定

「TABLE_NAME」には、DBコンソールにおけるビューテーブル名を設定します。
例） V_JOB_RESULT_DEVICE_LAST

６．「VALUES」パラメータの設定

「VALUES」では、パラメータを設定できます。
【形式】 {“J_SYSTEM_OBJECT_TYPE” : “ジョブタイプ”, “J_OBJECT_NAME” : “ジョブ名”}

７．プラグインの自動実行と手動実行

作成したプラグインを実行するには2種類の方法があります。

1．スケジュールを設定することによる自動実行
2．各プラグインの「実行」ボタンを押下することによる手動実行