runIntegration

Si applica a

Ruoli necessari

Utilizzo

• Per le integrazioni in modalità standard, è necessario specificare i valori per importMode, exportMode e periodName
• Per le integrazioni in modalità rapida, è necessario specificare il valore per exportMode
• Per i nomi dei parametri e i relativi valori è prevista la distinzione tra maiuscole e minuscole

• 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 esistenti
    • NONE per saltare l'esportazione dei dati da Data Integration all'applicazione
• periodName è 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.
  • Per caricamenti di singoli periodi, specificare il nome del periodo tra parentesi graffe, ad esempio {Jan-21}
  • Per caricamenti di dati di più periodi, racchiudere i nomi del periodo di inizio e del periodo di fine tra parentesi graffe, ad esempio {Jan-21}{Mar-21} (per caricare i dati per tutti i periodi a partire dal 21 gennaio fino al 21 marzo)
  • Per Planning, Planning Modules, Financial Consolidation and CloseFreeForm e Tax Reporting: è possibile specificare il nome e l'anno del periodo del processo aziendale nel formato {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.

    • Periodo singolo: fa riferimento al nome del periodo di Data Management per un singolo periodo definito nel mapping di periodi.
    • Più periodi: fa riferimento al caricamento di dati di più periodi. Il parametro è specificato nel formato {Month-Year}{Month-Year}. Ad esempio, {Jan-20}{Mar-20} per un caricamento di dati di più periodi dal 20 gennaio al 20 marzo.
    • Nome periodo di Planning: fa riferimento a un nome di periodo di Planning nel formato {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.

    • Variabile di sostituzione: estensione del formato del nome dei periodi di Planning precedente in cui è possibile specificare una variabile di sostituzione anziché i nomi dei membri effettivi Anno e Mese nel formato {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: esegue il caricamento dei dati per il periodo POV globale. Utilizzare il formato {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.

    Le convenzioni di denominazione dei periodi e delle variabili di sostituzione precedenti funzionano solo se i mapping dei periodi dell'applicazione o i mapping dei periodi globali con Anno e Mese nei valori target esistono già in Data Integration.
• 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

• Importazione di dati di un periodo singolo:

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15}"

• Importazione di dati di più periodi:

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15} {Jun-15}"

• Integrazione di dati basati su file incrementale:

  epmAutomate runIntegration IncrementalFileLoad importMode=Replace exportMode=Merge period="{Jan-20}{Mar-20}" inputFileName=File1.txt