EPM統合エージェントのAPIメソッド

EPM統合エージェントには、ログ・ファイルのテキストの指定、バインド変数や問合せの更新などのアクション、および特別な問合せまたはSQL以外のデータ・ソースが使用されている場合に、SQL処理ステップをスキップするようにEPM統合エージェントに指示するアクションを実行するために、スクリプトで使用できる多数のメソッドが用意されています。

EPM統合エージェントのAPIメソッドは次のとおりです:

APIメソッド	説明	例
`logInfo()`	エージェント・プロセス・ログに情報メッセージを記録します。このエントリは、`EPM_APP_DATA_HOME\logs`フォルダのプロセス・ログ、Oracle Enterprise Performance Management Cloudのジョブ・ログに記録されますが、ローカルのepmagent.logには記録されません。ログ・エントリは、INFOログ・レベルで作成されます。	`agentAPI.logInfo("SAMPLE: INFO log message from script")`
`logError()`	エージェント・プロセス・ログにエラー・メッセージを記録します。このエントリは、`EPM_APP_DATA_HOME\logs`フォルダのプロセス・ログ、EPM Cloudのジョブ・ログ、およびepmagent.logにも記録されます。ログ・エントリは、SEVERログ・レベルで作成されます。	`agentAPI.logError("SAMPLE: SEVER log message from script")`
`setBindVariables()`	`setBindVariables()`メソッドを使用して、抽出問合せのバインド変数を更新します。これは、`befExtract`スクリプトにのみ適用されます。バインド変数は、キーとして変数`NAME`および`VALUE`を含む、各変数のJavaマップ・エントリとして渡される必要があります。	`newBindVar = dict({'PERIOD':'Feb-05', 'LEDGER':'Vision Operations (USA)'})` `jmap = java.util.HashMap()` (キーの場合)`newBindVar.keys(): jmap[key] = newBindVar[key]` `agentAPI.setBindVariables(jmap)`
`getBindVariables()`	`getBindVariables()`メソッドを使用して、抽出問合せのバインド変数をフェッチします。各バインド変数はマップに格納され、キー`NAME`および`VALUE`を使用してバインド変数を定義します。	`bindVariables = agentAPI.getBindVariables()` (エントリの場合)`bindVariables.entrySet(): print entry.key, entry.value`
`updateQuery()`	`updateQuery()`メソッドを使用して、抽出問合せを更新します。これは、`befExtract`スクリプトにのみ適用されます。	`agentAPI.updateQuery("SELECT * FROM TDATASEG")`
`getQuery()`	`getQuery()`メソッドを使用して、抽出実行呼出し中にEPM CloudからEPM統合エージェントに渡される問合せをフェッチします。	`print "Printing Query: " + agentAPI.getQuery()`
`skipAction()`	`skipAction()`メソッドを使用して、カスタム抽出ルーチンがEPM統合エージェントで使用されている場合にデータの抽出ステップをスキップします。抽出実行は`befExtract`スクリプトでのみスキップできることに注意してください。保存された問合せを実行するのではなく、EPM Cloudにアップロードするデータ・ファイルを提供する場合は、EPM Cloudへのアップロード時に、`<process ID>.dat`という名前のファイルが`MyData/data`フォルダに保存されている必要があります。つまり、`befExtract`、`aftExtract`または`befUpload`スクリプトで、ファイルがこのフォルダに保存されている必要があります。	`agentAPI.skipAction('true')`