Metodi API dell'agente di integrazione EPM

L'agente di integrazione EPM offre numerosi metodi che possono essere utilizzati negli script per eseguire azioni quali la specifica di testo nel file di log, l'aggiornamento di variabili di associazione e query e azioni che danno indicazione all'agente di integrazione EPM di saltare il passo dell'elaborazione SQL nei casi in cui venga utilizzata una query speciale o un'origine dati non SQL.

Di seguito sono riportati i metodi API dell'agente di integrazione EPM.

Metodo API	Descrizione	Esempio
`logInfo()`	Registra un messaggio informativo nel log di processo dell'agente. Questa voce viene registrata nel log di processo nella cartella `EPM_APP_DATA_HOME\logs`, nel log del job in Oracle Enterprise Performance Management Cloud, ma non in epmagent.log locale. La voce log viene creata a livello del log INFO.	`agentAPI.logInfo("SAMPLE: INFO log message from script")`
`logError()`	Registra un messaggio di errore nel log di processo dell'agente. Questa voce viene registrata nel log di processo nella cartella `EPM_APP_DATA_HOME\logs`, nel log del job in EPM Cloud e anche in epmagent.log. La voce log viene creata a livello del log SEVER.	`agentAPI.logError("SAMPLE: SEVER log message from script")`
`setBindVariables()`	Il metodo `setBindVariables()` consente di aggiornare le variabili di associazione della query di estrazione. È applicabile solo allo script `befExtract`. Le variabili di associazione devono essere passate come voce di una mappa Java per ogni variabile con la variabile `NAME` come chiave e `VALUE`.	`newBindVar = dict({'PERIOD':'Feb-05', 'LEDGER':'Vision Operations (USA)'})` `jmap = java.util.HashMap()` per la chiave in `newBindVar.keys(): jmap[key] = newBindVar[key]` `agentAPI.setBindVariables(jmap)`
`getBindVariables()`	Il metodo `getBindVariables()` consente di recuperare le variabili di associazione per la query di estrazione. Ogni variabile di associazione è memorizzata in una mappa che utilizza le chiavi `NAME` e `VALUE` per definire la variabile stessa.	`bindVariables = agentAPI.getBindVariables()` per la voce in `bindVariables.entrySet(): print entry.key, entry.value`
`updateQuery()`	Il metodo `updateQuery()`consente di aggiornare la query di estrazione. È applicabile solo allo script `befExtract`.	`agentAPI.updateQuery("SELECT * FROM TDATASEG")`
`getQuery()`	Il metodo `getQuery()` consente di recuperare la query passata da EPM Cloud all'agente di integrazione EPM durante la chiamata di esecuzione dell'estrazione.	`print "Printing Query: " + agentAPI.getQuery()`
`skipAction()`	Il metodo `skipAction()` consente di saltare il passo dell'estrazione dei dati quando l'agente di integrazione EPM utilizza una routine di estrazione customizzata. Si noti che l'esecuzione dell'estrazione può essere saltata solo durante lo script `befExtract`. Se si desidera fornire a EPM Cloud un file di dati da caricare invece di eseguire la query salvata, è necessario salvare un file denominato `<process ID>.dat` nella cartella `MyData/data` affinché possa essere caricato in EPM Cloud nel momento opportuno. Ciò significa che occorre salvare il file in questa cartella negli script `befExtract`, `aftExtract` o `befUpload`.	`agentAPI.skipAction('true')`