Carregar Arquivo de Dados em um Ambiente e Executar Regra de Carregamento de Dados

Use esses scripts para fazer upload de um arquivo em um ambiente e, em seguida, execute uma regra de dados para importar dados do arquivo em um aplicativo.

Pré-requisitos

  • As definições a seguir do Gerenciamento de Dados:
    • Uma definição de regra de carregamento de dados denominada VisionActual. Pressupõe que a regra de dados não especifique um caminho de arquivo para o arquivo de entrada.
    • Definições de períodos Mar-15 a Jun-15
  • Um arquivo de dados devidamente formatado (GLActual.dat) que contenha dados.

Para importar dados e executar a regra de carregamento de dados, execute comandos para estas etapas:

  • Entre no ambiente.
  • Faça upload de um arquivo GLActual.dat que contenha dados referentes aos períodos Mar-15 a Jun-15 para a pasta inbox/Vision do Gerenciamento de Dados.
  • Importe os dados de GLActual.dat para o Gerenciamento de Dados usando a regra de carregamento de dados VisionActual, o período inicial Mar-15, o período final Jun-15 e o modo de importação REPLACE.
  • Exporte os dados com a opção STORE_DATA para mesclar os dados da tabela intermediária do Gerenciamento de Dados com dados de aplicativo existentes.
  • Saia

Script de Amostra para Windows

Crie runDataLoadRule.ps1 copiando o script a seguir. Armazene-o em um diretório local. 
$inputproperties = ConvertFrom-StringData(Get-Content ./input.properties -raw)
$username="$($inputproperties.username)"
$passwordfile="$($inputproperties.passwordfile)"
$serviceURL="$($inputproperties.serviceURL)"
$dataFile="$($inputproperties.dataFile)"
$dataRuleName="$($inputproperties.dataRuleName)"
$startPeriod="$($inputproperties.startPeriod)"
$endPeriod="$($inputproperties.endPeriod)"
$importMode="$($inputproperties.importMode)"
$exportMode="$($inputproperties.exportMode)"

epmautomate login ${username} ${passwordfile} ${serviceURL}
epmautomate uploadfile ${datafile} ${dataFileUploadLocation}
epmautomate rundatarule ${dataRuleName} ${startPeriod} ${endPeriod} ${importMode} ${exportMode} ${dataFileUploadLocation}/${dataFile}
epmautomate logout

Script de Amostra para Linux/UNIX

Crie runDataLoadRule.sh copiando o script a seguir. Armazene-o em um diretório local. 
#!/bin/bash
. ./input.properties
export JAVA_HOME=${javahome}
${epmautomatescript} login "${username}" "${passwordfile}" "${serviceURL}"
${epmautomatescript} uploadfile "${datafile}" "${dataFileUploadLocation}"
${epmautomatescript} rundatarule "${dataRuleName}" "${startPeriod}" "${endPeriod}" "${importMode}" "${exportMode}" "${dataFileUploadLocation}/${dataFile}"
${epmautomatescript} logout

Criação do Arquivo input.properties

Crie o arquivo input.properties copiando um dos scripts a seguir e atualizando-o com as informações do seu ambiente. Salve o arquivo no diretório em que runDataLoadRule.ps1 ou runDataLoadRule.sh está armazenado.

Windows 
username=serviceAdmin
passwordfile=./password.epw
serviceURL=https://example.oraclecloud.com
dataFile=GLActual.dat
dataFileUploadLocation=UPLOAD_LOCATION
dataRuleName=RULE_NAME
startPeriod=START_PERIOD
endPeriod=END_PERIOD
importMode=IMPORT_MODE
exportMode=EXPORT_MODE
Linux/UNIX 
javahome=JAVA_HOME
epmautomatescript=EPM_AUTOMATE_LOCATION
username=exampleAdmin
passwordfile=examplePassword.epw
serviceURL=exampleURLdataFile=GLActual.dat
dataFileUploadLocation=UPLOAD_LOCATION
dataRuleName=RULE_NAME
startPeriod=START_PERIOD
endPeriod=END_PERIOD
importMode=IMPORT_MODE
exportMode=EXPORT_MODE

Tabela 3-21 Parâmetros de input.properties

Parâmetro Descrição
javahome Localização de JAVA_HOME. Somente para Linux/UNIX.
epmautomatescript Caminho absoluto do EPM Automate (epmautomate.sh). Somente para Linux/UNIX.
username Nome de usuário de um Administrador de Serviço, que também tem a função de Administrador do Domínio de Identidades.
senha A senha do Administrador de Serviço ou o nome e a localização do arquivo de senha criptografado.
serviceURL URL do ambiente do qual você deseja gerar o instantâneo.
dataFile O arquivo que contém os dados a serem importados usando a regra de dados.
dataFileUploadLocation Local para o qual o arquivo de dados será carregado.
dataRuleName Nome de uma regra de carregamento de dados definida na Integração de Dados.
startPeriod O primeiro período para o qual os dados deve ser carregados. Esse nome de período deve ser definido no mapeamento de período da Integração de Dados.
endPeriod Para carregamento de dados de vários períodos, o último período para o qual os dados serão carregados. Para o carregamento de um único período, use o mesmo período do período de início. Esse nome de período deve ser definido no mapeamento de período da Integração de Dados.
importMode Modo de importação de dados na Integração de Dados. Use APPEND, REPLACE ou RECALCULATE. Use NONE para ignorar a importação de dados nas tabelas intermediárias.
exportMode Modo de exportação de dados para o aplicativo. Use a Integração de Dados. Use STORE_DATA, ADD_DATA, SUBTRACT_DATA ou REPLACE_DATA. Use NONE para ignorar a exportação de dados da Integração de Dados para o aplicativo.

Nota:

O Financial Consolidation and Close oferece suporte apenas aos modos MERGE e NONE.

Execução do Script

  1. Crie runDataLoadRule.ps1 ou runDataLoadRule.sh copiando o script de uma seção anterior.
  2. Crie o arquivo input.properties e salve-o no diretório em que o script runDataLoadRule está localizado. O conteúdo desse arquivo varia em função do seu sistema operacional. Consulte Criação do Arquivo input.properties.

    Certifique-se de ter privilégios de gravação nesse diretório. Para Windows, pode ser que você precise iniciar o PowerShell usando a opção Executar como Administrador para poder executar o script.

  3. Inicie o script.
    • Windows PowerShell: execute runDataLoadRule.ps1.
    • Linux/UNIX: execute ./runDataLoadRule.sh.