Esegue un job di Data Integration per importare dati in un processo aziendale Oracle Enterprise Performance Management Cloud o per esportare dati da un processo aziendale a un sistema esterno.
Questo comando invalida il comando runDataRule. Oracle consiglia di iniziare a utilizzare questo comando invece del comando runDataRule.
Si applica a
Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management, Sales Planning e Strategic Workforce Planning.Ruoli necessari
Amministratore servizi, Utente avanzatoUtilizzo
epmautomate runIntegration JOB_NAME importMode=Append|Replace|"Map and Validate"|"No Import"|Direct exportMode=Merge|Replace|Accumulate|Subtract|"No Export"|Check periodName={PERIOD_NAME} [inputFileName=FILE_NAME] [PARAMETERS]
importMode
, exportMode
e periodName
exportMode
JOB_NAME
indica il nome di un job di integrazione definito in Data Integration.importMode
determina come vengono importati i dati in Data Integration. Di seguito sono descritte le modalità di importazione accettabili.
Append
per l'aggiunta ai dati POV esistenti in Data Integration.Replace
per eliminare i dati POV e sostituirli con i dati del file.Map and Validate
per saltare l'importazione dei dati e rielaborare invece i dati con i mapping aggiornati e i conti logici.No Import
per saltare l'importazione dei dati nella tabella intermedia di Data Integration.exportMode
determina come vengono caricati i dati nell'applicazione target. Per le integrazioni in modalità rapida, non è possibile utilizzare Check
e No Export
come valori del parametro exportMode
. Di seguito sono elencati i valori accettabili per le modalità di esportazione.
Merge
per aggiornare i dati esistenti e aggiungere nuovi dati.Replace
per cancellare i dati esistenti nel POV e caricarvi nuovi dati. Per la modalità standard, vengono cancellati i dati per le dimensioni Scenario, Versione, Anno, Periodo ed Entità. Per la modalità rapida, vengono cancellati i dati per le dimensioni Anno, Periodo ed Entità. È possibile definire aree di cancellazione customizzate per entrambe le modalità.Accumulate
per aggiungere i dati ai dati esistenti. Si applica a Planning, Planning Modules, Financial Consolidation and Close, Tax Reporting, Profitability and Cost Management ed Enterprise Profitability and Cost Management.Subtract
per sottrarre i dati dal saldo esistente. Applicabile a Profitability and Cost Management ed Enterprise Profitability and Cost Management.
Per integrazioni in modalità rapida:
Non è possibile utilizzare Check
e No Export
come valore per questo parametro.
Per Planning, Planning Modules e Financial Consolidation and Close, gli unici valori validi sono Replace
, Merge
e Accumulate
.
No Export
per saltare l'esportazione dei dati. Utilizzare questa modalità per caricare i dati nella tabella intermedia per la revisione prima del caricamento nell'applicazione target.Check
per eseguire solo una verifica di convalida dei dati.
Per Oracle Fusion Cloud come target, sono supportate solo le modalità di esportazione riportate di seguito.
MERGE
per unire i dati della tabella intermedia di Data Integration con i dati esistentiNONE
per saltare l'esportazione dei dati da Data Integration all'applicazioneperiodName
è il nome di uno o più periodi o intervalli di periodi, ognuno racchiuso tra parentesi graffe, per cui importare o esportare i dati. Di seguito sono descritte le convenzioni di denominazione accettabili per i periodi.
{Jan-21}
{Jan-21}{Mar-21}
(per caricare i dati per tutti i periodi a partire dal 21 gennaio fino al 21 marzo){Jan#FY21}{Mar#FY21}
per caricare i dati di tutti i periodi a partire dal 21 gennaio fino al 21 marzo.
I nomi dei periodi devono essere racchiusi tra parentesi graffe.
{Month-Year}{Month-Year}
. Ad esempio, {Jan-20}{Mar-20} per un caricamento di dati di più periodi dal 20 gennaio al 20 marzo.{Month#Year}
, ad esempio {Jan#FY20}{Mar#FY20}. Utilizzando questa convenzione, non è necessario specificare i nomi dei periodi di Data Integration. Specificare invece i nomi dei membri per le dimensioni Anno e Scenario.
Questo parametro è supportato nei processi aziendali di Planning,Tax Reporting e Financial Consolidation and Close. È funzionale sia per le applicazioni di servizio che per le distribuzioni cloud che derivano da origini dati in locale.
L'utilizzo di questa convenzione è utile in caso di attivazione da uno script Groovy di EPM Cloud mediante acquisizione dei nomi dei membri Anno e Periodo. Il mapping dei periodi dell'applicazione o il mapping dei periodi globali deve essere presente con Anno e Mese nei valori target del mapping dei periodi.
{Month#&CurYr}{&FcstMonth#&CurYr}
, ad esempio {Jan#&CurYr}{&FcstMonth#&CurYr}
.
È supportato l'utilizzo di una combinazione di nomi di membri effettivi e variabili di sostituzione.
Questo formato è supportato nei processi aziendali di Planning,Tax Reporting e Financial Consolidation and Close.
Il mapping dei periodi dell'applicazione o il mapping dei periodi globali deve essere presente in Data Integration nell'ambiente in cui viene eseguito il comando, con i valori di Anno e Mese disponibili nei valori target del mapping dei periodi. In questo caso, Anno e Mese fanno riferimento al valore corrente della variabile di sostituzione durante l'esecuzione.
{GLOBAL_POV}
.Note:
Se si utilizza un parametro di denominazione dei periodi diverso dai parametri descritti in questo documento, verrà visualizzato un messaggio di errore Input non valido - HTTP 400.Copiare la sezione periodName dal documento dell'API REST. In questo documento vengono definiti i diversi formati, ad esempio Global POV, Subvar e così via.
{GLOBAL_POV}
per eseguire il caricamento dei dati per il periodo definito nel POV globale nel sistema o in Impostazioni applicazione in Data Integration.
Note:
Il formato della convenzione di denominazione dei periodi {Month#Year} è supportato per Planning, Planning Modules, Financial Consolidation and Close e Tax Reporting. Secondo questa convenzione, è possibile specificare i nomi dei membri per le dimensioni Anno e Scenario anziché i nomi dei periodi di Data Integration. Questo approccio è utile se il comando viene attivato da uno script Groovy acquisendo i nomi dei membri Anno e Periodo.La convenzione di denominazione delle variabili di sostituzione {Jan#&CurYr}{&FcstMonth#&CurYr}
è un'estensione della convenzione di denominazione dei periodi precedente. È possibile specificare la variabile di sostituzione anziché i nomi dei membri Anno e Mese se si esegue il comando in Planning, Planning Modules, Financial Consolidation and Close e Tax Reporting. È supportato l'utilizzo anche di una combinazione di nomi di membri e variabili di sostituzione.
inputFileName
, per caricamenti di dati basati su file, specifica il nome del file, disponibile nella cartella inbox, da cui devono essere importati i dati. Se si specifica il nome di directory nella definizione dell'integrazione, passare solo il nome file. Se non si include un nome di directory nella definizione dell'integrazione, utilizzare il formato inbox/DIR_NAME/FILE_NAME
, ad esempio inbox/GLBALANCES.txt
o inbox/EBSGL/GLBALANCES.txt
. Se il file è stato caricato nella posizione predefinita nell'ambiente, utilizzare la convenzione #epminbox/FILE_NAME
, ad esempio #epminbox/GLBALANCES.txt
, per identificare il file dei dati di input.
Questo parametro è applicabile solo ai caricamenti di dati basati su file nativi. Se non si specifica questo valore di parametro per i caricamenti di dati basati su file, questo comando importa i dati dal file specificato nella definizione dell'integrazione. Se si specifica questo valore di parametro per i caricamenti di dati non basati su file, il comando lo ignora.
PARAMETERS
(facoltativo) identifica i parametri runtime nel formato PARAMETER_NAME="PARAMETER"
. I parametri includono sia i filtri di origine che le opzioni target.
Note:
L'unico parametro che è possibile utilizzare in questa fase per un tipo dimensione (metadati) dell'applicazione target è"Refresh Database"=Yes|No
.Esempi
epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15}"
epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15} {Jun-15}"
epmAutomate runIntegration IncrementalFileLoad importMode=Replace exportMode=Merge period="{Jan-20}{Mar-20}" inputFileName=File1.txt