como trabalhar com o epm automate para oracle enterprise ... · • importar dados de saldo...

Oracle® CloudComo Trabalhar com o EPM Automate para Oracle Enterprise

Performance Management Cloud

F10718-01

Oracle Cloud Como Trabalhar com o EPM Automate para Oracle Enterprise Performance ManagementCloud

F10718-01

Copyright © 2016, 2018, Oracle e/ou suas empresas afiliadas. Todos os direitos reservados.

Autor Principal: EPM Information Development Team

Este programa de computador e sua documentação são fornecidos sob um contrato de licença que contémrestrições sobre seu uso e divulgação, sendo também protegidos pela legislação de propriedade intelectual.Exceto em situações expressamente permitidas no contrato de licença ou por lei, não é permitido usar,reproduzir, traduzir, divulgar, modificar, licenciar, transmitir, distribuir, expor, executar, publicar ou exibirqualquer parte deste programa de computador e de sua documentação, de qualquer forma ou através dequalquer meio. Não é permitida a engenharia reversa, a desmontagem ou a descompilação deste programade computador, exceto se exigido por lei para obter interoperabilidade.

As informações contidas neste documento estão sujeitas a alteração sem aviso prévio. A Oracle Corporationnão garante que tais informações estejam isentas de erros. Se você encontrar algum erro, por favor, nos envieuma descrição de tal problema por escrito.

Se este programa de computador, ou sua documentação, for entregue / distribuído(a) ao Governo dosEstados Unidos ou a qualquer outra parte que licencie os Programas em nome daquele Governo, a seguintenota será aplicável:

U.S. GOVERNMENT END USERS:

Oracle programs, including any operating system, integrated software, any programs installed on thehardware, and/or documentation, delivered to U.S. Government end users are "commercial computersoftware" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplementalregulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, includingany operating system, integrated software, any programs installed on the hardware, and/or documentation,shall be subject to license terms and license restrictions applicable to the programs. No other rights aregranted to the U.S. Government.

Este programa de computador ou equipamento foi desenvolvido para uso em diversas aplicações degerenciamento de informações. Ele não foi desenvolvido nem projetado para uso em aplicaçõesinerentemente perigosas, incluindo aquelas que possam criar risco de lesões físicas. Se utilizar este programaou equipamento em aplicações perigosas, você será responsável por tomar todas e quaisquer medidasapropriadas em termos de segurança, backup e redundância para garantir o uso seguro de tais programas decomputador. A Oracle Corporation e suas afiliadas se isentam de qualquer responsabilidade por quaisquerdanos causados pela utilização deste programa de computador ou equipamento em aplicações perigosas.

Oracle e Java são marcas comerciais registradas da Oracle Corporation e/ou de suas afiliadas. Outros nomespodem ser marcas comerciais de seus respectivos proprietários.

Intel e Intel Xeon são marcas comerciais ou marcas comerciais registradas da Intel Corporation. Todas asmarcas comerciais SPARC são usadas sob licença e são marcas comerciais ou marcas comerciais registradasda SPARC International, Inc. AMD, Opteron, o logotipo da AMD e o logotipo do AMD Opteron são marcascomerciais ou marcas comerciais registradas da Advanced Micro Devices. UNIX é uma marca comercialregistrada do The Open Group. Microsoft, Windows, PowerPoint, Word, Excel, Access, Office, Outlook,Visual Studio, Visual Basic, Internet Explorer, Active Directory e SQL Server são marcas comerciais oumarcas comerciais registradas da Microsoft Corporation nos Estados Unidos e/ou em outros países.

Este programa ou equipamento e sua documentação podem oferecer acesso ou informações relativas aconteúdos, produtos e serviços de terceiros. A Oracle Corporation e suas empresas afiliadas não fornecemquaisquer garantias relacionadas a conteúdos, produtos e serviços de terceiros e estão isentas de quaisquerresponsabilidades associadas a eles, a menos que isso tenha sido estabelecido entre você e a Oracle em umcontrato vigente. A Oracle Corporation e suas empresas afiliadas não são responsáveis por quaisquer tiposde perdas, despesas ou danos incorridos em consequência do acesso ou da utilização de conteúdos, produtosou serviços de terceiros, a menos que isso tenha sido estabelecido entre você e a Oracle em um contratovigente.

Sumário

Acessibilidade da Documentação........................................................................................................... v

Feedback sobre a Documentação........................................................................................................ vii

1 Sobre o EPM Automate Utility

Instalação do Utilitário............................................................................................................................. 1-2

Linux/UNIX...................................................................................................................................... 1-3

Conceitos Básicos do Nível de Criptografia do EPM Automate Utility........................................... 1-3

2 Referência de Comando

Visão Geral dos Comandos ..................................................................................................................... 2-1

Comandos do Oracle Planning and Budgeting Cloud e do Oracle Enterprise Planning and

Budgeting Cloud ................................................................................................................................. 2-4

Comandos do Oracle Financial Consolidation and Close Cloud ...................................................... 2-4

Comandos do Oracle Tax Reporting Cloud.......................................................................................... 2-5

Comandos do Oracle Profitability and Cost Management Cloud..................................................... 2-5

Comandos do Oracle Account Reconciliation Cloud.......................................................................... 2-6

Comandos do Oracle Enterprise Data Management Cloud............................................................... 2-6

Comandos do Strategic Workforce Planning ....................................................................................... 2-7

Sobre Como Executar os Comandos do EPM Automate Utility........................................................ 2-7

Pré-requisitos .................................................................................................................................... 2-7

Locais Padrão dos Arquivos ........................................................................................................... 2-9

Comandos do EPM Automate Utility ................................................................................................... 2-9

Códigos de Saída..................................................................................................................................... 2-44

Execução do EPM Automate Utility .................................................................................................... 2-49

Windows.......................................................................................................................................... 2-50

Linux ................................................................................................................................................ 2-51

Execução de Várias Instâncias do Utilitário ............................................................................... 2-51

3 Exemplos de Cenários de Execução de Comandos

Exemplos de Cenários para Todos os Serviços .................................................................................... 3-1

iii

Fazer Backup de Instantâneos de Aplicativo em um Computador .......................................... 3-2

Criar e Provisionar Usuários .......................................................................................................... 3-3

Contar o Número de Usuários Provisionados ............................................................................. 3-4

Criar Relatórios de Auditoria de Usuários Provisionados......................................................... 3-6

Automatizar os Downloads do Relatório de Atividade para um Computador Local........... 3-9

Download de Logs de Acesso a Partir de um Ambiente.......................................................... 3-13

Automatizar a Clonagem de Ambientes..................................................................................... 3-16

Clonar um Ambiente ..................................................................................................................... 3-18

Remover Arquivos Desnecessários de um Ambiente............................................................... 3-20

Localização e Download de Arquivos de um Ambiente.......................................................... 3-20

Exemplos de Cenários para o Oracle Planning and Budgeting Cloud, Oracle EnterprisePlanning and Budgeting Cloud, Oracle Financial Consolidation and Close Cloud e Oracle

Tax Reporting Cloud ........................................................................................................................ 3-21

Importar Metadados no Aplicativo ............................................................................................. 3-21

Importar Dados, Executar um Script de Cálculo e Copiar Dados de um Banco de Dadosde Armazenamento em Bloco para um Banco de Dados de Armazenamento Agregado

..................................................................................................................................................... 3-22

Exportar e Fazer Download de Metadados e Dados................................................................. 3-22

Exportar e Fazer Download de Dados de Aplicativo ............................................................... 3-23

Importar Dados no Gerenciamento de Dados, Executar uma Regra de Carregamento de

Dados e Exportar Dados para o Planning............................................................................. 3-23

Automatizar a Integração de Dados Diária................................................................................ 3-24

Exemplos de Cenários do Oracle Account Reconciliation Cloud.................................................... 3-26

Carregar Saldos Pré-formatados em um Período...................................................................... 3-26

Fazer Upload e Importar um Instantâneo de Backup............................................................... 3-27

Exemplos de Cenários do Oracle Profitability and Cost Management Cloud .............................. 3-27

Importar Metadados no Aplicativo ............................................................................................. 3-28

Importar Dados e Executar Regras de Programa ...................................................................... 3-28

Automação da Execução de Scripts ..................................................................................................... 3-28

Monitoramento de Atividades do EPM Automate Utility ............................................................... 3-29

4 Como Replicar um Ambiente do EPM Cloud

Configuração da Replicação Diária........................................................................................................ 4-1

Configuração de Replicações sob Demanda......................................................................................... 4-2

Configuração do Ambiente Secundário ................................................................................................ 4-2

A Preparação para Executar o Comando Replay

Sobre o Comando Reproduzir ................................................................................................................ A-1

Pré-requisitos............................................................................................................................................. A-1

Criação de Arquivos HAR....................................................................................................................... A-2

Criação de Arquivos de Reprodução..................................................................................................... A-5

Geração de Arquivos de Rastreamento ................................................................................................. A-6

Exemplo de Sessão de Reprodução........................................................................................................ A-6

iv

Acessibilidade da Documentação

Para obter mais informações sobre o compromisso da Oracle com a acessibilidade,visite o site do Programa de Acessibilidade da Oracle em http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Acesso ao Suporte Técnico da Oracle

Os clientes Oracle que adquiriram serviços de suporte têm acesso ao suporteeletrônico por meio do My Oracle Support. Para obter mais informações, visite http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info ou visite http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs caso tenha deficiência auditiva.

v

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs

Feedback sobre a Documentação

Para fornecer feedback sobre esta documentação, envie um e-mail [email protected] ou, em um tópico da Central de Ajuda da Oracle, clique nobotão Feedback localizado abaixo do Índice (talvez seja necessário rolar a tela parabaixo para ver o botão).

Siga EPM Information Development nestes sites de mídia social:

LinkedIn - http://www.linkedin.com/groups?gid=3127051&goback=.gmp_3127051

Twitter - http://twitter.com/hyperionepminfo

Facebook - http://www.facebook.com/pages/Hyperion-EPM-Info/102682103112642

Google+ - https://plus.google.com/106915048672979407731/#106915048672979407731/posts

YouTube - https://www.youtube.com/oracleepminthecloud

vii

http://www.linkedin.com/groups?gid=3127051&goback=.gmp_3127051

http://twitter.com/hyperionepminfo

http://www.facebook.com/pages/Hyperion-EPM-Info/102682103112642

https://plus.google.com/106915048672979407731/#106915048672979407731/posts

https://plus.google.com/106915048672979407731/#106915048672979407731/posts

https://www.youtube.com/oracleepminthecloud

1Sobre o EPM Automate Utility

O EPM Automate Utility permite aos Administradores de Serviço executar tarefasremotamente nos ambientes deste serviço do Oracle Enterprise PerformanceManagement Cloud.

• Oracle Planning and Budgeting Cloud

• Oracle Enterprise Planning and Budgeting Cloud

• Financial Consolidation and Close Cloud

• Oracle Tax Reporting Cloud

• Oracle Profitability and Cost Management Cloud

• Oracle Account Reconciliation Cloud

• Oracle Enterprise Data Management Cloud

• Oracle Strategic Workforce Planning Cloud

Nota: Este guia não se aplica ao Oracle Enterprise Performance ReportingCloud.

O EPM Automate Utility permite que os Administradores de Serviço automatizemvárias tarefas repetitivas, como as seguintes:

• Importar e exportar metadados, dados, instantâneos de artefato e aplicativo,modelos e mapeamentos de Gerenciamento de Dados

• Fazer upload de arquivos em ambientes, listar arquivos e excluir arquivos doserviço

• Fazer download de snapshots, relatórios, metadados e arquivos de dados doserviço

• Executar regras de negócios em dados e atualizar o aplicativo

• Copiar dados de um banco de dados para outro; normalmente, de um banco dedados de armazenamento em bloco para um banco de dados de armazenamentoagregado ou de um banco de dados de armazenamento em bloco para outrobanco de dados de armazenamento em bloco

• Executar uma regra de lote do Gerenciamento de Dados

• Gerar relatórios de Gerenciamento de Dados, o relatório de provisionamento e orelatório de auditoria de usuários.

Sobre o EPM Automate Utility 1-1

• Importar dados de saldo pré-mapeados, taxas de moeda, transações pré-mapeadas, dados de saldo e perfis para o Oracle Account Reconciliation Cloud

• Copiar perfis em um período para iniciar o processo de reconciliação

• Implantar o cubo de cálculo de um aplicativo do Oracle Profitability and CostManagement Cloud

• Limpar, copiar e excluir Pontos de Vista de aplicativos do Oracle Profitability andCost Management Cloud

• Reproduzir o carregamento do Oracle Smart View para Office em um ambientepara que seja possível testar o desempenho sob condições de carga pesada

• Importar dados complementares de um arquivo no Oracle FinancialConsolidation and Close Cloud

Você pode criar scripts capazes de concluir uma grande variedade de tarefas eautomatizar sua execução usando o agendador. Por exemplo, é possível criar umscript para fazer o download do backup de manutenção diária de ambientes a fim decriar backups locais dos seus artefatos e dados.

Visão geral do vídeo do EPM Automate Utility

Tutorial: How to execute Oracle Planning and Budgeting Cloud commandsusing EPM Automate Utility

Instalação do UtilitárioO instalador do EPM Automate Utility para Windows e Linux/UNIX está disponívelno serviço.

Nota:

Esse utilitário só pode ser usado em sistemas operacionais de 64 bits queatualmente tenham suporte para o fornecedor do sistema operacional.

Em computadores Linux, o utilitário procura as variáveis de ambiente a seguir paradeterminar configurações do proxy:

• proxyHost

• proxyPort

• https.proxyHost

• https.proxyPort

Instalação do Utilitário

1-2 Oracle Cloud Como Trabalhar com o EPM Automate para Oracle Enterprise Performance Management Cloud

https://apexapps.oracle.com/pls/apex/f?p=44785:265:0:::265:P265_CONTENT_ID:10891

https://apex.oracle.com/pls/apex/f?p=44785:265:0:::265:P265_CONTENT_ID:10717

https://apex.oracle.com/pls/apex/f?p=44785:265:0:::265:P265_CONTENT_ID:10717

Nota:

O EPM Automate Utility não funciona com credenciais SSO corporativas(provedor de identidade). Como os usuários não podem efetuar sign-in comas credenciais corporativas, as contas de usuário para acesso ao utilitáriodevem ser mantidas no serviço.

Se você tiver configurado sua inscrição para SSO, também deverá permitir queos usuários se conectem usando as respectivas credenciais do domínio deidentidade. Consulte Como Habilitar a Conexão com Credenciais do Domíniode Identidade em Administering Oracle Cloud Identity Management.

Linux/UNIX

Para instalar o utilitário:

1. Acesse um ambiente.

2. Na Homepage, acesse Setting and Actions clicando no nome do usuário.

3. Clique em Downloads.

4. Na página Downloads, clique em Download for Linux na seção EPM Automate.

5. Salve o instalador (EPMAutomate.tar) em um diretório no qual você tenhaprivilégios de leitura/gravação/execução.

6. Usando um comando como o apresentado a seguir, extraia o conteúdo doinstalador:

tar -xvf EPMAutomate.tar

Conceitos Básicos do Nível de Criptografia do EPM Automate UtilityO Oracle Enterprise Performance Management Cloud usa o TLS (Transport LayerSecurity) com o Algoritmo Hash Criptográfico SHA-2/SHA-256 para proteger acomunicação com o EPM Automate Utility.

Conceitos Básicos do Nível de Criptografia do EPM Automate Utility

Sobre o EPM Automate Utility 1-3

Conceitos Básicos do Nível de Criptografia do EPM Automate Utility


2Referência de Comando

Não há suporte para o EPM Automate Utility no Oracle Enterprise PerformanceReporting Cloud.

• Visão Geral dos Comandos

• Comandos do Oracle Planning and Budgeting Cloud e do Oracle EnterprisePlanning and Budgeting Cloud

• Comandos do Oracle Financial Consolidation and Close Cloud

• Comandos do Oracle Tax Reporting Cloud

• Comandos do Oracle Profitability and Cost Management Cloud

• Comandos do Oracle Account Reconciliation Cloud

• Comandos do Oracle Enterprise Data Management Cloud

• Comandos do Strategic Workforce Planning

Cada serviço usa uma combinação de comandos gerais e de comandos específicos doserviço descritos neste capítulo.

Visão Geral dos Comandos

Tabela 2-1 Lista em Ordem Alfabética dos Comandos do EPM Automate

Nome do Comando PBCS,EPBCS,

SWPFCCS TRCS PCMCS ARCS DMCS

addUsers

applydatagrants

assignRole

clearcube

clearpov

copyfilefrominstance

copypov

copysnapshotfrominstance

createreconciliations

deletefile

Referência de Comando 2-1

Tabela 2-1 (Cont.) Lista em Ordem Alfabética dos Comandos do EPM Automate



deletepov

deploycube

downloadfile

enableapp

encrypt

exportdata

exportMapping

exportmetadata

exportqueryresults

exportsnapshot

exporttemplate

feedback

getsubstvar

help

importbalances

importdata

importMapping

importmetadata

importpremappedbalances

importpremappedtransactions

importprofiles

importrates

importsnapshot

importsupplementaldata

importtemplate

importtmpremappedbalances

importtmpremappedtransactions

listfiles

loaddata

loaddimdata

login



Tabela 2-1 (Cont.) Lista em Ordem Alfabética dos Comandos do EPM Automate



logout

maskData

provisionreport

recreate

refreshcube

removeUsers

replay

resetservice

runautomatch

runbatch

runbusinessrule

runcalc

runDailyMaintenance

rundatarule

runDMReport

runplantypemap

setdemodates

setperiodstatus

setsubstvars

unassignRole

upgrade

uploadfile

userauditreport

Abreviações

• PBCS: Oracle Planning and Budgeting Cloud

• EPBCS: Oracle Enterprise Planning and Budgeting Cloud

• SWP: Oracle Strategic Workforce Planning Cloud

• FCCS: Oracle Financial Consolidation and Close Cloud

• TRCS: Oracle Tax Reporting Cloud

• PCMCS: Oracle Profitability and Cost Management Cloud



• ARCS: Oracle Account Reconciliation Cloud

• DMCS: Oracle Enterprise Data Management Cloud

Comandos do Oracle Planning and Budgeting Cloud e do OracleEnterprise Planning and Budgeting Cloud

Comandos do Oracle Planning and Budgeting Cloud e do Oracle Enterprise Planningand Budgeting Cloud

addUsers

assignRole

clearcube



deletefile

downloadfile

encrypt

exportdata

exportMapping

exportmetadata

exportsnapshot

feedback

getsubstvar

help

importdata

importMapping

importmetadata

importsnapshot

listfiles

login

logout

maskData

provisionreport

recreate

refreshcube

removeUsers

replay

resetservice

runbatch

runbusinessrule

runDailyMaintenance

rundatarule

runDMReport

runplantypemap

setsubstvars

unassignRole

upgrade

uploadfile

userauditreport

Comandos do Oracle Financial Consolidation and Close Cloud

Comandos do EPM Automate Utility para Oracle Financial Consolidation and CloseCloud

addUsers

assignRole



deletefile

downloadfile

encrypt

exportdata

exportMapping

exportmetadata

exportsnapshot

feedback

getsubstvar

help

importdata

importMapping

importmetadata

importsnapshot


listfiles

login

logout

maskData

provisionreport

recreate

refreshcube

removeUsers

replay

resetservice

runbatch

runbusinessrule

runDailyMaintenance

rundatarule

runDMReport

runplantypemap

setdemodates

setsubstvars

unassignRole

upgrade

uploadfile

userauditreport

Comandos do Oracle Planning and Budgeting Cloud e do Oracle Enterprise Planning and Budgeting Cloud


Comandos do Oracle Tax Reporting Cloud

Comandos do EPM Automate Utility para o Oracle Tax Reporting Cloud

addUsers



deletefile

downloadfile

encrypt

exportdata

exportMapping

exportmetadata

exportsnapshot

feedback

getsubstvar

help

importdata

importMapping

importmetadata

importsnapshot


listfiles

login

logout

maskData

provisionreport

recreate

refreshcube

removeUsers

replay

resetservice

runbatch

runbusinessrule

rundatarule

runDMReport

runplantypemap

setdemodates

setsubstvars

unassignRole

upgrade

uploadfile

userauditreport

Comandos do Oracle Profitability and Cost Management Cloud

Comandos do EPM Automate Utility para Oracle Profitability and Cost ManagementCloud

addUsers

applydatagrants

assignRole

clearpov


copypov


deletefile

deletepov

deploycube

downloadfile

enableapp

encrypt

exportMapping

exportqueryresults

exportsnapshot

exporttemplate

feedback

help

importMapping

importsnapshot

importtemplate

listfiles

loaddata

loaddimdata

login

logout

provisionreport

recreate

removeUsers

resetservice

runbatch

runcalc

runDailyMaintenance

rundatarule

runDMReport

unassignRole

upgrade

uploadfile

userauditreport

Comandos do Oracle Tax Reporting Cloud


Comandos do Oracle Account Reconciliation Cloud

Comandos do EPM Automate Utility para Oracle Account Reconciliation Cloud

addUsers

assignRole




deletefile

downloadfile

encrypt

exportMapping

exportsnapshot

feedback

help

importbalances

importMapping



importprofiles

importrates

importsnapshot

listfiles

login



logout

provisionreport

recreate

removeUsers

resetservice

runautomatch

runbatch

runDailyMaintenance

rundatarule

runDMReport

setdemodates

setperiodstatus

unassignRole

upgrade

uploadfile

userauditreport

Comandos do Oracle Enterprise Data Management Cloud

Comandos do Oracle Enterprise Data Management Cloud

addUsers

assignRole



deletefile

downloadfile

encrypt

exportsnapshot

feedback

help

importsnapshot

listfiles

login

logout

provisionreport

recreate

removeUsers

resetservice

runDailyMaintenance

unassignRole

uploadfile

userauditreport

upgrade

Comandos do Oracle Account Reconciliation Cloud


Comandos do Strategic Workforce Planning

Comandos do Oracle Strategic Workforce Planning Cloud

addUsers

assignRole

clearcube



deletefile

downloadfile

encrypt

exportdata

exportMapping

exportmetadata

exportsnapshot

feedback

getsubstvar

help

importdata

importMapping

importmetadata

importsnapshot

listfiles

login

logout

maskData

provisionreport

recreate

refreshcube

removeUsers

replay

resetservice

runbatch

runbusinessrule

runDailyMaintenance

rundatarule

runDMReport

runplantypemap

setsubstvars

unassignRole

upgrade

uploadfile

userauditreport

Sobre Como Executar os Comandos do EPM Automate UtilityTodos os serviços, com exceção doOracle Enterprise Performance Reporting Cloud,usam estes comandos do EPM Automate Utility. Para obter uma lista dos comandosusados por cada serviço, consulte:








Pré-requisitos

Gerais

• Para executar os comandos, é necessário ser um Administrador de Serviço.

• Os arquivos necessários para executar um comando deverão existir no ambiente.Utilize o comando uploadfile para fazer o upload dos arquivos.

Consulte Locais Padrão dos Arquivos para obter informações sobre o local padrãodos arquivos para cada serviço.

• Uso da extensão de arquivo em comandos:

Comandos do Strategic Workforce Planning


– Especifique o nome completo do arquivo, inclusive a extensão de arquivo(por exemplo, data.csv), para executar comandos que realizam operaçõescom arquivos. Exemplos de comandos de operação de arquivo incluemdeletefile, listfiles e uploadfile.

– Não utilizem extensões de arquivo para executar comandos que realizamoperações de Migração. As operações de Migração requerem que vocêespecifique o nome de um instantâneo.

• Valores de parâmetros que contêm um caractere de espaço, tais como, porexemplo, comentários, nomes de locais e caminhos de pastas, devem serdelimitados por aspas.

Oracle Planning and Budgeting Cloud

• Jobs

Vários dos comandos abordados na seção a seguir requerem jobs. Os jobs sãoações, como importar ou exportar dados, que podem ser iniciadas imediatamenteou agendadas para um momento posterior; por exemplo, a importação ou aexportação de dados e a atualização do banco de dados.

Usando o Console de Jobs, você deve criar os jobs apropriados para executar asoperações a seguir. Para obter instruções detalhadas sobre como criar jobs noPlanning, consulte Gerenciamento de Jobs em Administração do Planning paraOracle Planning and Budgeting Cloud.

– Importar dados para um aplicativo

– Exportar dados de um aplicativo

– Importar metadados para um aplicativo

– Exportar metadados de um aplicativo

– Copiar dados de um banco de dados de armazenamento em bloco para outrode armazenamento agregado ou de um banco de dados de armazenamentoem bloco para outro de armazenamento em bloco

• Regras de Negócios

As regras de negócios que você deseja executar devem existir no aplicativo.

Você usa o Calculation Manager para criar regras de negócios, que sãoimplantadas no aplicativo. Consulte Como Projetar com o Calculation Manager paraOracle Enterprise Performance Management Cloud.

Gerenciamento de Dados

• Regra de Dados

As regras de carregamento de dados definem como o Gerenciamento de Dadoscarrega dados de um arquivo. Para carregar dados com o utilitário, é necessárioter regras de carregamento de dados predefinidas.

• Lotes

É possível carregar dados usando lotes definidos no Gerenciamento de Dados.Usando um lote, os Administradores de Serviço podem combinar várias regras decarregamento em um lote e executá-las no modo serial ou paralelo.

Sobre Como Executar os Comandos do EPM Automate Utility


Locais Padrão dos Arquivos

• O local padrão no qual o utilitário faz o upload dos arquivos, e armazena osarquivos para download, pode ser acessado por esses aplicativos. Você deve fazerupload dos arquivos para esse local caso planeje processá-los usando um processonativo destes aplicativos.

– Planning

– Enterprise Planning

– Account Reconciliation

– Financial Consolidation and Close

– Tax Reporting

Você pode usar o Explorer da Caixa de Entrada/Saída para procurar os arquivosarmazenados no local padrão. Os instantâneos do aplicativo que você cria com outilitário não são listados no Explorer da Caixa de Entrada/Saída; é possível exibi-los na guia Instantâneos da Migração.

• É necessário fazer upload dos arquivos que devem ser processados com umprocesso nativo do Profitability and Cost Management para profitinbox. Osarquivos exportados pelos processos do Profitability and Cost Management sãoarmazenados em profitoutbox. Use o Explorer de Arquivos para procuraresses arquivos.

• Os arquivos a serem processados com o Gerenciamento de Dados devem estardisponíveis na caixa de entrada ou em uma pasta dentro dela. Por padrão, osarquivos exportados com o Gerenciamento de Dados são armazenados na caixade saída, enquanto as saídas de relatório do Gerenciamento de Dados sãoarmazenadas no pasta outbox/report do Gerenciamento de Dados. Use oExplorer de Arquivos do Gerenciamento de Dados para procurar esses arquivos.

Comandos do EPM Automate UtilityPara obter uma lista dos comandos usados por cada serviço, consulte:








Para obter informações sobre os códigos de status usados pelo utilitário, consulte Códigos de Saída.

Comandos do EPM Automate Utility


addUsers

Cria um lote de usuários em um domínio de identidades usando um arquivo deValores Separados por Vírgulas (CSV) codificados em UTF-8 cujo upload foi feito noambiente. Use o comando uploadfile a fim fazer upload dos arquivos para umambiente. O formato de arquivo é o seguinte:

First Name,Last Name,Email,User LoginJane,Doe,[email protected],jdoeJohn,Doe,[email protected],[email protected]

Consulte Importação de um Lote de Contas de Usuário em Noções Básicas sobre o OracleCloud para obter uma descrição detalhada do formato CSV.

Se uma definição do usuário no arquivo CSV corresponder a uma conta de usuárioexistente no domínio de identidades, nenhuma alteração será feita na conta de usuárioexistente. Esse comando cria contas somente para novos usuários cujas informaçõessobre a conta estão incluídas no arquivo. Como as contas de usuário são comuns atodos os ambientes de serviço que um domínio de identidades suporta, os novosusuários estarão disponíveis para todos os ambientes que compartilham o domínio deidentidades.

Nota:

Esse comando só deve ser executado por um Administrador de Domínios deIdentidades no domínio de identidades no qual os usuários deverão sercriados.

Após as contas de usuários serem criadas, o administrador do Oracle Cloudenviará um e-mail a cada novo usuário com detalhes sobre as contas deles.

Uso: epmautomate addUsers FILE_NAME userPassword=PASSWORDresetPassword=true|false, onde

• FILE_NAME é o nome de um arquivo CSV que contém informações do usuário

• userPassword indica a senha padrão a ser atribuída a novos usuários criados nodomínios de identidades. A senha especificada deverá atender aos requisitosmínimos da senha do domínio de identidades.

• resetPassword indica se os novos usuários devem alterar a senha no primeirologon. A menos que esse parâmetro opcional seja definido como false, os novosusuários deverão alterar a senha na primeira conexão.

Exemplo: epmautomate addUsers user_file.CSVuserPassword=ExamplePwd1 resetPassword=true

applydatagrants

Atualiza as concessões de dados, que controlam o acesso às partes de dados doEssbase, para que correspondam às concessões de dados definidas em um aplicativodo Oracle Profitability and Cost Management Cloud.

As concessões de dados no nível de usuário e de grupo feitas no aplicativo do OracleProfitability and Cost Management Cloud são sincronizadas automaticamente noEssbase. Use esse comando para sincronizar o acesso aos dados do Essbase se vocêsuspeitar que existe uma discordância entre a concessão de dados do aplicativo e osfiltros do Essbase.



O tempo necessário para concluir essa operação depende do tamanho do aplicativo.Certifique-se de que a operação de atualização da concessão de dados seja concluídaantes de ser efetuado backup do aplicativo durante a próxima janela de manutenção.Como o aplicativo não deverá ser usado enquanto essa operação estiver emandamento, a Oracle recomenda agendá-la para que ocorra quando os usuários nãoestiverem trabalhando no aplicativo.

Uso: epmautomate applydatagrants APPLICATION_NAME, ondeAPPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud para o qual as concessões de dados devem ser recriadas.

Exemplo: epmautomate applydatagrants BksML12

assignRole

Atribui uma função de domínio de identidades a todos os usuários em um arquivoCSV codificado em ANSI ou em UTF-8 cujo upload foi feito no ambiente. Use ocomando uploadfile a fim fazer upload dos arquivos para um ambiente. O formato dearquivo é o seguinte:

User [email protected]@example.com

Consulte Atribuição de Uma Função a Vários Usuários em Introdução ao Oracle Cloud.

Nota:

Esse comando pode ser executado por um Administrador de Domínios deIdentidades no domínio de identidades, no qual as funções deverão serdesignadas, ou por um Administrador de Serviços.

Uso: epmautomate exportMapping FILE_NAME ROLE, onde:

• FILE_NAME é o nome de um arquivo CSV que contém e-mails de usuários.

• ROLE identifica o nome de uma função predefinida aplicável ao serviço quedeverá ser atribuída aos usuários. Consulte Noções Básicas de FunçõesPredefinidas em Introdução ao Oracle Enterprise Performance Management Cloud paraAdministradores.

Nota: Algumas dessas funções podem não ser aplicáveis ao serviço atual.

Os valores aceitáveis são:

– Administrador de Serviços

– Usuário Avançado

– User (não utilize Planner, que foi usado em versões anteriores do serviço)

– Viewer

Exemplo: epmautomate assignRole admin_role_file.CSV "ServiceAdministrator"



clearcube

Exclui dados específicos de cubos de entrada e relatório usando as configuraçõesespecificadas em um job do tipo clear cube. Este comando não exclui a definição doaplicativo nas tabelas relacionais do aplicativo. Consulte Limpeza de Cubos emAdministração do Planning para Oracle Planning and Budgeting Cloud.

Uso: epmautomate clearcube JOB_NAME, onde JOB_NAME é o nome de um jobdefinido no aplicativo.

Exemplo: epmautomate clearcube ClearPlan1

clearpov

Limpa os artefatos de modelo e os dados de uma combinação de PDV (Ponto de Vista)ou uma região de dados do PDV em um aplicativo.

Uso: epmautomate clearpov APPLICATION_NAME POV_NAME [QUERY_NAME]PARAMETER=VALUE stringDelimiter="DELIMITER", onde:

• APPLICATION_NAME é o nome de um aplicativo do Oracle Profitability and CostManagement Cloud

• POV_NAME é um PDV no aplicativo. Este valor é obrigatório.

• QUERY_NAME, opcionalmente, é o nome de uma consulta exatamente comodefinido no Oracle Profitability and Cost Management Cloud. Se a opção forespecificada, essa consulta será usada para limpar a região de dados no PDV.

Nota: Se você especificar um nome de consulta, deverá definir o valor detodos os parâmetros de tempo de execução (veja abaixo) como falso.

• PARAMETER=VALUE indica os parâmetros de tempo de execução e os respectivosvalores para limpar o PDV. Especifique tantos emparelhamentos de parâmetros evalores quantos forem necessários para o processo. Parâmetros válidos, pelomenos um de cada é obrigatório, e os respectivos valores:

– isManageRule=true|false especifica se as regras devem ou não serlimpas

– isInputData=true|false especifica se os dados de entrada devem ounão ser limpos

– isAllocatedValues=true|false especifica se os valores de alocaçãodevem ou não ser limpos

– isAdjustmentValues=true|false especifica se os valores de ajustedevem ou não ser limpos



Nota:

Os valores de parâmetros (true ou false) devem ser inseridos em letrasminúsculas.

Para limpar regiões de dados em um PDV (se um QUERY_NAME forespecificado), você deverá definir o valor de parâmetros de tempo deexecução (isManageRule, isInputData, isAllocatedValues eisAdjustmentValues) como false.

• stringDelimiter="DELIMITER" especifica o delimitador usado nos valoresde PDV. O delimitador deve estar entre aspas duplas.

Exemplos:

• Limpar todos os dados e artefatos de modelo de um PDV: epmautomateclearpov BksML12 2012_Jan_Actual isManageRule=trueisInputData=true isAllocatedValues=trueisAdjustmentValues=true stringDelimiter=”_”

• Limpar dados de região em um PDV: epmautomate clearpov BksML122012_Jan_Actual queryName=BksML12_2012_Jan_clear_queryisManageRule=false isInputData=false isAllocatedValues=falseisAdjustmentValues=false stringDelimiter=”_”


Copia um arquivo de um ambiente de origem para o ambiente (de destino) a partir doqual você executa este comando. Antes de executar esse comando, inicie uma sessãono EPM Automate Utility e faça log-in no ambiente de destino.

Uso: epmautomate copyfilefrominstance SOURCE_FILE_NAME USERNAMEPASSWORD_FILE URL IDENTITYDOMAIN TARGET_FILE_NAME, onde:

• SOURCE_FILE__NAME é o nome do arquivo (incluindo a extensão) que vocêdeseja copiar do ambiente de origem.

• USERNAME é o nome de usuário do Administrador do Serviço do ambiente deorigem.

• PASSWORD_FILE é o nome e a localização do arquivo que contém a senhacriptografada do Administrador do Serviço do ambiente de origem.

• URL é o URL do ambiente de origem.

• IDENTITYDOMAIN é o domínio de identidade do ambiente de origem.

• TARGET_FILE_NAME é um nome exclusivo para o arquivo (incluindo a extensão)no ambiente a partir do qual esse comando será executado.

Exemplo: epmautomate copyfilefrominstance "my data file.zip"serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myprodIdentityDomain "my targetdata file.zip"

copypov

Copia os artefatos de modelo e os dados do cubo do Essbase de um PDV de origempara outro de destino.



Uso: epmautomate copypov APPLICATION_NAME SOURCE_POV_NAMETARGET_POV_NAME PARAMETER=VALUE stringDelimiter="DELIMITER", onde:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud que contém o PDV de origem.

• SOURCE_POV_NAME é o nome do PDV de origem no aplicativo especificado

• TARGET_POV_NAME é o nome de um PDV de destino válido com o status Draft

• PARAMETER=VALUE indica os parâmetros de tempo de execução e os respectivosvalores para copiar o PDV. Especifique tantos emparelhamentos de parâmetros evalores quantos forem necessários para o processo. Parâmetros válidos e osrespectivos valores:

– isManageRule=true|false

especifica se as regras devem ou não ser limpas

– isInputData=true|false especifica se os dados de entrada devem ounão ser limpos

– modelViewName especifica o nome da fatia de dados a ser copiada do PDVde origem para o PDV de destino.

– createDestPOV=true|false especifica se o PDV de destino deverá sercriado caso ele não exista

Nota:



Exemplo: epmautomate copypov BksML12 2012_Jan_Actual2012_Feb_Actual isManageRule=true isInputData=truemodelViewName="Balancing - 5 Customer Costs" createDestPOV=truestringDelimiter=”_”


Copia o instantâneo atual de um ambiente de origem para o ambiente (de destino) apartir do qual você executa este comando.

Esse comando é principalmente usado para migrar (clonar) um ambiente copiando oinstantâneo atual de outro ambiente; por exemplo, de um ambiente de teste para umambiente de produção. Antes de executar esse comando, inicie uma sessão no EPMAutomate Utility e faça log-in no ambiente de destino.

Uso: epmautomate copysnapshotfrominstance SNAPSHOT_NAME USERNAMEPASSWORD_FILE URL IDENTITYDOMAIN, onde:

• SNAPSHOT_NAME é o nome de um instantâneo existente no ambiente de origem.

• USERNAME é o nome de usuário do Administrador do Serviço do ambiente deorigem.



• PASSWORD_FILE é o nome e a localização do arquivo que contém a senhacriptografada do Administrador do Serviço do ambiente de origem.

• URL é o URL do ambiente de origem.

• IDENTITYDOMAIN é o domínio de identidade do ambiente de origem.

Exemplo: epmautomate copysnapshotfrominstance "Instantâneo deArtefato" serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myprodIdentityDomain


Copia os perfis em um período específico.

Uso: epmautomate createreconciliations PERIOD SAVED_FILTER, onde:

• PERIOD é o nome de um período

• SAVED_FILTER é o nome de um filtro público salvo. Se você não especificar umfiltro salvo, o utilitário copiará todos os perfis aplicáveis

Exemplos:

• epmautomate createreconciliations “January 2015”

• epmautomate createreconciliations “January 2015” “CorporateRecs”

deletefile

Exclui um arquivo ou um instantâneo do local de upload padrão, que pode ser umapasta de Gerenciamento de Dados ou profitinbox/profitoutbox. Para excluir umarquivo de um local diferente do local de upload padrão, é necessário especificar olocal do arquivo.

Uso: epmautomate deletefile FILE_NAME

Nota:

Você deverá especificar o nome do arquivo incluindo a extensão; por exemplo,data.csv, data.zip, se aplicável.

Você pode excluir um instantâneo sem especificar sua extensão de arquivo(.zip). No entanto, essa prática está obsoleta.

Exemplos:

• Excluir do local de upload padrão: epmautomate deletefile data.csv

• Excluir do local de download padrão: epmautomate deletefile outbox/data.csv

• Exclua um instantâneo criado por meio de Migração:

– epmautomate deletefile "Backup 18-06-12.zip" ou

– epmautomate deletefile "Backup 18-06-12" (obsoleto)



• Excluir de profitinbox: epmautomate deletefile profitinbox/data.csv

• Excluir de profitoutbox: epmautomate deletefile profitoutbox/data.csv

• Excluir de uma pasta do Gerenciamento de Dados: epmautomate deletefileoutbox/dm_data/data.csv

deletepov

Exclui os artefatos de modelo e os dados do cubo do Essbase de um PDV.

Uso: epmautomate deletepov APPLICATION_NAME POV_NAMEstringDelimiter=""DELIMITER", onde:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud que contém o PDV a ser excluído.

• POV_NAME é o nome do PDV que deverá ser excluído. Este valor é obrigatório.


Exemplo: epmautomate deletepov BksML12 2012_Jan_ActualstringDelimiter="_"

deploycube

Implanta ou reimplanta o cubo de cálculo de um aplicativo do Oracle Profitability andCost Management Cloud.

Uso: epmautomate deploycube APPLICATION_NAME PARAMETER=VALUEcomment="comment", onde:

• APPLICATION_NAME é o nome de um aplicativo do Oracle Profitability and CostManagement Cloud

• PARAMETER=VALUE indica os parâmetros de tempo de execução e os respectivosvalores para implantação do cubo. Especifique tantos emparelhamentos deparâmetros e valores quantos forem necessários para o processo. Parâmetrosválidos e os respectivos valores:

Nota:


– isKeepData=true|false

especifica se os dados existentes, se houver, devem ou não ser preservados

– isReplaceCube=true|false especifica se o cubo existente deve ou nãoser substituído



Nota:

Os valores de isKeepData e isReplaceCube não podem ser definidosambos como true.

– isRunNow=true|false especifica se o processo deve ou não ser executadoimediatamente

• comment é um comentário opcional incluído entre aspas duplas

Exemplo: epmautomate deploycube BksML12 isKeepData=trueisReplaceCube=false isRunNow=true comment=”Test cube deployment”

downloadfile

Faz o download de um arquivo de um ambiente para o computador local. Estecomando é usado para fazer download de instantâneos de backup, metadados e dadospara o armazenamento local. É feito download do arquivo para a pasta na qual outilitário é executado.

Uso: epmautomate downloadfile "[FILE_PATH]/FILE_NAME"

Exemplos:

• Download do instantâneo de manutenção diária: epmautomate downloadfile"Instantâneo de Artefato"

• Download de um instantâneo personalizado: epmautomate downloadfile"mySnapshot.zip"

• Download de um arquivo do local de download padrão: epmautomatedownloadfile data.csv

• Download de uma pasta do Gerenciamento de Dados: epmautomatedownloadfile outbox/dm_data/data.csv

• Download de profitoutbox: epmautomate downloadfile profitOutbox/data.csv

enableapp

Habilita um aplicativo.

Uso: epmautomate enableapp APPLICATION_NAME, onde APPLICATION_NAME éo nome do aplicativo do Oracle Profitability and Cost Management Cloud que vocêdeseja habilitar.

Exemplo: epmautomate enableapp BksML12

encrypt

Usa o padrão de criptografia avançada (AES, Advanced Encryption Standard) paracriptografar a senha do Oracle Enterprise Performance Management Cloud e,opcionalmente, a senha do servidor proxy de internet e armazená-las em um arquivode senhas. A criptografia da senha é um processo que só precisa ser feito uma vez.

Uso: epmautomate encrypt PASSWORD KEY PASSWORD_FILE[ProxyServerPassword=PROXY_PASSWORD], onde:



• PASSWORD é a senha do Administrador do Serviço no serviço. Não é possível usarcredenciais corporativas com o EPM Automate Utility.

• KEY é a chave privada que deverá ser usada para criptografar a senha.

• PASSWORD_FILE é o nome e o local do arquivo que armazena a senhacriptografada. O arquivo de senha deve usar a extensão .epw.

• ProxyServerPassword=PROXY_PASSWORD é a senha para autenticar o usuáriono servidor proxy. Esta opção só será obrigatória se a autenticação no servidorproxy estiver habilitada para a sua rede.

Exemplos:

• Criptografar somente a senha do EPM Cloud: epmautomate encryptP@ssword1 myKey C:\mySecuredir\password.epw

• Criptografar as senhas do servidor proxy de internet e do EPM Cloud:epmautomate encrypt E@xample1 myKey C:\mySecuredir\password.epw ProxyServerPassword=E@xample1

exportdata

Exporta dados do aplicativo para um arquivo ZIP usando as configurações deexportação de dados, como o nome do arquivo, especificadas em um job do tipoexport data. O arquivo de dados exportado é armazenado no local de downloadpadrão do qual será possível fazer o seu download para o computador. Use o Explorerda Caixa de Entrada/Saída para exibir detalhes do arquivo exportado.

Uso: epmautomate exportdata JOB_NAME [FILE_NAME], onde: JOB_NAME é onome de um job definido no aplicativo e FILE_NAME é o nome do arquivo ZIP(opcional) para o qual os dados deverão ser exportados.

Exemplo: epmautomate exportdata dailydataexport dailyData.zip

exportMapping

Exporta regras de mapeamento de uma dimensão ou local específico para criar umarquivo de regras de mapeamento. Você deve especificar o nome do arquivo e umlocal na caixa de saída (por exemplo, outbox/exportedAccountMap.txt ou outbox/france sales/exportedAccountMap.txt) para exportar os mapeamentos. Use ocomando downloadfile a fim de fazer download do arquivo de mapeamentoexportado para um computador local.

Uso: epmautomate exportMapping DIMENSION_NAME|ALL FILE_NAMELOCATION, onde

• DIMENSION_NAME|ALL é a dimensão de origem da qual os mapeamentos devemser exportados. Especifique o nome da dimensão da qual os mapeamentosdeverão ser exportados ou ALL para exportar os mapeamentos de todas asdimensões de um local.

• FILE_NAME é o nome exclusivo do arquivo de mapeamento e um local na caixade saída.

• LOCATION é o local do Gerenciamento de Dados para o qual as regras demapeamento devem ser exportadas.

Exemplos:



• epmautomate exportMapping Account outbox/exportedAccountMap.txt "France Sales"

• epmautomate exportMapping ALL "outbox/france sales/exportedAccountMap.txt" "France Sales"

exportmetadata

Exporta metadados para um arquivo usando as configurações especificadas em umjob do tipo export metadata. O arquivo que contém os dados exportados éarmazenado no local de download padrão do qual será possível fazer o seu downloadpara o computador.

Opcionalmente, você pode especificar um nome de arquivo para os dados exportados,que substituirá o nome de arquivo padrão (nome do job usado para exportar osmetadados). Os metadados são exportados como um arquivo ZIP apenas.

Uso: epmautomate exportmetadata JOB_NAME [FILE_NAME], onde JOB_NAMEé o nome de um job definido no aplicativo e FILE_NAME é o nome do arquivo ZIPpara o qual os metadados deverão ser exportados.

Exemplo: epmautomate exportmetadata dailyAccountexportAccountexport.ZIP

exportqueryresults

Executa uma consulta definida em um aplicativo e exporta os resultados para umarquivo de texto. O arquivo de resultados da consulta é armazenado em profitoutbox;é possível fazer o download do arquivo com o comando downloadfile.

Uso: epmautomate exportqueryresults APPLICATION_NAMEfileName=FILE_NAME [queryName=QUERY_NAME][exportOnlyLevel0Flg=true], onde:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud no qual você deseja executar a consulta

• fileName é o nome do arquivo .TXT que armazenará os resultados da consulta

• queryName é um parâmetro opcional que identifica uma consulta definida noaplicativo. Os nomes de consulta que contêm o caractere de espaço devem estarentre aspas duplas.

Não especifique um nome de consulta se desejar exportar todos os dados doEssbase que pertencem ao aplicativo.

As seguintes condições podem fazer com que esse comando crie um arquivo dedados vazio:

– Uma consulta com formato incorreto que não recupera dados

– Uma consulta que gera um volume excessivo de dados. Nesse cenário,considere limitar o escopo da consulta para que ela recupere um volumemenor de dados ou dividi-la em consultas menores

Consulte Gerenciamento de Consultas do Oracle Profitability and CostManagement Cloud em Administração do Oracle Profitability and CostManagement Cloud.



• exportOnlyLevel0Flg é um parâmetro opcional que especifica se os dadosrecuperados pela consulta devem estar no nível mínimo de granularidade.Especifique esse valor de parâmetro totalmente em minúsculas.

Esse parâmetro será ignorado se você estiver exportando todos os dados doaplicativo omitindo o nome da consulta.

Exemplos:

• Exportar todos os dados do aplicativo:

epmautomate exportqueryresults BksML12fileName=”MyQuery1.txt”

• Exportar os resultados de uma consulta específica:

epmautomate exportqueryresults BksML12fileName=”MyQuery1.txt” queryName=”My Product Query”exportOnlyLevel0Flg=true

exportsnapshot

Repete uma operação de exportação executada anteriormente para criar uminstantâneo do conteúdo da Migração. Você pode fazer download do instantâneoexportado do local padrão.

Utilizando a Migração, selecione e exporte os artefatos desejados para um instantâneo;por exemplo, October16FullApp. Use o nome do instantâneo com esse comandopara repetir a operação de exportação subsequentemente. Dessa forma, apenas osartefatos selecionados durante a operação de exportação original serão exportados.Consulte Exportação de Artefatos e Aplicativos em Administração da Migração para oOracle Enterprise Performance Management Cloud.

Uso: epmautomate exportsnapshot SNAPSHOT_NAME , onde SNAPSHOT_NAME éo nome de um instantâneo existente na Migração. Esse instantâneo é substituído pelonovo.

Exemplo: epmautomate exportsnapshot October16FullApp

exporttemplate

Exporta um aplicativo como um modelo para um arquivo .ZIP. O arquivo exportado éarmazenado em profitoutbox. Você pode fazer o seu download para um computadorlocal usando o comando downloadfile.

Uso: epmautomate exporttemplate APPLICATION_NAME File_Name, onde:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud que você deseja exportar como modelo

• File_Name é o nome do arquivo de modelo

Exemplo: epmautomate exporttemplate BksML12 template1

feedback

Envia feedback para a Oracle e para os Administradores de Serviço do ambiente. Essecomando, que imita o recurso Fornecer Feedback do serviço, é especialmente útil parafornecer feedback (somente em texto) para a Oracle nos casos em que não há respostada interface do usuário ou quando é encontrado um problema durante a execução doutilitário.



Para obter informações sobre o recurso Fornecer Feedback, consulte Como Ajudar aOracle a Coletar Informações de Diagnóstico Usando o Utilitário Fornecer Feedbackem Introdução ao Oracle Enterprise Performance Management Cloud para Administradores.

Nota:

Os comentários devem ser incluídos entre aspas.

Uso: epmautomate feedback "comment" [screenshot="FILE_PATH"]

Exemplos:

• Windows: epmautomate feedback "runplantypemapCampaignToReporting ClearData=True did not clear data fromaggregate storage" screenshot=C:/feedback/issue.jpg

• Linux: epmautomate feedback "runplantypemapCampaignToReporting ClearData=True did not clear data fromaggregate storage" screenshot=/scratch/screens/issue.jpg

getsubstvar

Recupera os valores das variáveis de substituição e exibe-os na tela, no formatoCUBE_NAME.SUBSTVAR=value; por exemplo, Plan2.CurYear=2016. Os valoresdas variáveis de substituição no nível do aplicativo são exibidos no formatoALL.SUBSTVAR=value; por exemplo, ALL.CurYear=2016

Uso: epmautomate getsubstvar CUBE_NAME|ALL [name=VARIABLE_NAME],onde:

• CUBE_NAME é o cubo (por exemplo, Plan1, Plan2) do qual você deseja recuperar avariável de substituição. Use ALL para recuperar variáveis de substituição nonível do aplicativo.

• name=VARIABLE_NAME identifica opcionalmente a variável de substituição cujovalor você deseja recuperar. Se você não especificar um nome de variável, ocomando recuperará o valor de todas as variáveis de substituição.

Exemplos:

• Obter o valor de todas as variáveis de substituição no nível do aplicativo e docubo: epmautomate getsubstvar ALL

• Obter o valor de uma variável de substituição específica no nível do aplicativo:epmautomate getsubstvar ALL name=CurYear

• Obter o valor de todas as variáveis de substituição no nível do cubo:epmautomate getsubstvar Plan2

• Obter o valor de uma variável de substituição específica no nível do cubo:epmautomate getsubstvar Plan2 name=CurYear

help

Exibe a ajuda de todos os comandos.

Uso: epmautomate help



Exemplo: epmautomate help

importbalances

Utiliza o Gerenciamento de Dados para importar dados de saldo de uma definição decarregamento de dados.

Uso: epmautomate importbalances DL_DEFINITION PERIOD, em que:

• DL_DEFINITION é uma definição de carregamento de dados existente no OracleAccount Reconciliation Cloud.

• PERIOD é o nome de um período.

Exemplo: epmautomate importbalances DailyLoad “January 2016”

importdata

Importa dados de um arquivo para o aplicativo usando as configurações deimportação de dados especificadas em um job do tipo import data. Use o comando uploadfile a fim de fazer o upload do arquivo que contém os dados do aplicativo parao local de upload padrão.

Opcionalmente, você poderá especificar o nome do arquivo ZIP, CSV ou TXT (arquivode dados no formato do Essbase) do qual os dados deverão ser importados. Se vocêespecificar um nome de arquivo, o nome do arquivo de importação do job seráignorado.

Se o job estiver definido para importar dados no formato do Essbase, o arquivo ZIPdeverá conter um arquivo TXT no formato do Essbase. Para outros jobs de importação,o arquivo ZIP poderá conter um ou mais arquivos CSV que identificam a sequência deimportação nos nomes de arquivos; por exemplo, data1-3.csv, data2-3.csv edata3-3.csv.

Uso: epmautomate importdata JOB_NAME [FILE_NAME], onde: JOB_NAME é onome de um job definido no aplicativo e FILE_NAME identifica o arquivo ZIP ou CSVdo qual os dados serão importados.

Exemplo: epmautomate importdata dailydataload dailydata.zip

importMapping

Importa mapeamentos de um arquivo de importação de mapeamentos submetido aupload para o serviço anteriormente. Use o comando uploadfile a fim de fazer oupload dos arquivos para a caixa de entrada do Gerenciamento de Dados ou para umapasta dentro dela.

Uso: epmautomate importMapping DIMENSION_NAME|ALL FILE_NAMEIMPORT_MODE VALIDATION_MODE LOCATION, onde

• DIMENSION_NAME|ALL indica o destinatário do mapeamento. Especifique onome da dimensão para a qual os mapeamentos deverão ser importados ou ALLpara importar todos os mapeamentos incluídos no arquivo para as dimensõesapropriadas.

• FILE_NAME é o nome e o local do arquivo de importação de mapeamentodisponível na caixa de entrada do Gerenciamento de Dados ou em um diretóriodentro dela. Especifique o nome do arquivo (arquivos TXT no formato padrão doGerenciamento de Dados) e o seu caminho (por exemplo, inbox/AccountMap.txt ou inbox/pbcs_maps/AccountMap.txt).



• IMPORT_MODE é REPLACE para limpar as regras de mapeamento existentes antesde importar os mapeamentos ou MERGE para adicionar novas regras demapeamento às regras existentes.

• VALIDATION_MODE é TRUE para validar os membros de destino no aplicativo ouFALSE para carregar o arquivo de mapeamento sem executar validações.

• LOCATION é o local do Gerenciamento de Dados para o qual as regras demapeamento devem ser carregadas.

Exemplos:

• epmautomate importMapping Account inbox/AccountMap.txt MERGEFALSE "France Sales"

• epmautomate importMapping ALL "inbox/France Sales/AllMaps.txt" MERGE FALSE "France Sales" (carrega mapeamentos doarquivo de importação de mapeamento para todas as dimensões mapeadas nolocal France Sales)

importmetadata

Importa metadados para o aplicativo usando as configurações de importação de dadosespecificadas em um job do tipo import metadata. Opcionalmente, você podeespecificar o nome do arquivo ZIP do qual os metadados deverão ser importados. Useo comando uploadfile a fim de fazer o upload do arquivo que contém os metadadospara o local de upload padrão.

O conteúdo do arquivo ZIP especificado tem precedência sobre os nomes de arquivodefinidos no job. O arquivo ZIP pode conter um ou mais arquivos CSV. Os nomes dearquivo que contêm metadados de dimensões devem corresponder aos nomes dearquivo de importação definidos no job ou terminar com _DIMENSIONNAME.csv; porexemplo, metadata_Entity.csv, metadata_HSP_Smart Lists.csv emetadata_Exchange Rates.csv.

Nota:

Apenas os metadados das dimensões para as quais a importação demetadados está configurada no job são importados. Os metadados de outrasdimensões, se contidos no arquivo ZIP, serão ignorados



Nota:

Uma situação de importação ambígua será criada se ambas as seguintescondições forem verdadeiras para o arquivo ZIP:

• O zip contém um arquivo de metadados com um nome correspondenteao nome do arquivo definido no job

• O zip contém arquivos de metadados com nomes que terminam em_DIMENSIONNAME.CSV ou _DIMENSIONNAME.TXT, em queDIMENSIONNAME é o nome da dimensão para a qual os metadados estãosendo importados.

A Oracle recomenda que o arquivo ZIP contenha um arquivo de metadadoscom um nome idêntico ao referenciado no job ou um arquivo com um nomeque termine em _DIMENSIONNAME.CSV (ou _DIMENSIONNAME.TXT), masnão os dois ao mesmo tempo. Por exemplo, se você estiver carregando um jobque faz referência ao arquivo de metadados Employees_A-Z.CSV para adimensão Employees, o seu arquivo ZIP poderá incluir Employees_A-Z.CSV ou New_Employees.CSV, mas não os dois. Se o seu ZIP contiverEmployees_A-Z.CSV e New_Employees.CSV, o utilitário poderá selecionarambos os arquivos para importação, dependendo da ordem dos arquivos noZIP. O arquivo Employees_A-Z.CSV é uma possível correspondência paraimportação, pois seu nome corresponde ao nome do arquivo referenciado nojob; New_Employees.CSV também é uma possível correspondência, pois seunome corresponde ao padrão _DIMENSIONNAME.CSV.

Uso: epmautomate importmetadata JOB_NAME [FILE_NAME], onde JOB_NAMEé o nome de um job definido no aplicativo e FILE_NAME é o nome do arquivo ZIP doqual os metadados deverão ser importados.

Exemplo: epmautomate importmetadata importAccountimportAccount.zip


Importa dados de saldo pré-mapeados de um arquivo para o repositório do OracleAccount Reconciliation Cloud.

Uso: epmautomate importpremappedbalances PERIOD FILE_NAMEBALANCE_TYPE CURRENCY_BUCKET, onde:


• FILE_NAME é o nome do arquivo CSV que contém os dados a serem importados

• BALANCE_TYPE é SRC ou SUB

• CURRENCY_BUCKET é Entered, Functional ou Reporting

Exemplo: epmautomate importpremappedbalances “January 2015”dailydata.csv SRC Reporting


Importa transações pré-mapeadas de um arquivo CSV para o repositório do OracleAccount Reconciliation Cloud.



Uso: epmautomate importpremappedtransactions PERIODTRANSACTION_TYPE FILE_NAME DATE_FORMAT, onde:


• TRANSACTION_TYPE é um dos seguintes:

– BEX para ajuste do saldo explicado

– SRC para ajuste no sistema de origem

– SUB para ajuste do subsistema

• FILE_NAME é o nome do arquivo CSV do qual os dados devem ser importados

• DATE_FORMAT é a string de texto de formato de data; por exemplo, MMM d, aaaa.

Exemplo: epmautomate importpremappedtransactions “January 2015”“BEX” transactions.csv “MMM d, yyyy”

importprofiles

Importa novas definições de perfil de um arquivo CSV no repositório do OracleAccount Reconciliation Cloud.

Uso: epmautomate importprofiles FILE_NAME PROFILE_TYPE METHODDATE_FORMAT, onde:

• FILE_NAME é o nome do arquivo CSV do qual os dados devem ser importados

• PROFILE_TYPE é profiles ou children

• METHOD é Replace ou Update

• DATE_FORMAT é uma string de texto de formato de data; por exemplo, MMM d,aaaa

Exemplo: epmautomate importprofiles NewRecProfiles.csv ProfilesReplace “MMM d, yyyy”

importrates

Importa tarifas de moeda de um arquivo CSV para o repositório do Oracle AccountReconciliation Cloud.

Uso: epmautomate importrates PERIOD RATE_TYPE REPLACE_MODEFILE_NAME, onde:


• RATE_TYPE é um tipo de tarifa predefinido

• REPLACEMENT_MODE é Replace ou ReplaceAll

• FILE_NAME é o nome do arquivo CSV do qual as tarifas devem ser importadas

Exemplo: epmautomate importrates “January 2015” Actual ReplaceAllavgrates.csv



importsnapshot

Importa o conteúdo de um instantâneo para o ambiente do serviço. O instantâneoimportado deve estar disponível no local de upload padrão. Use o comando uploadfilea fim de fazer upload de um instantâneo para o local padrão.

As atividades que você pode concluir usando este comando dependem da sua função.

• Os Administradores de Serviços só podem importar artefatos de aplicativos paraum ambiente do serviço.

• Administradores de Domínios de Identidades podem só podem importarartefatos de domínios de identidades.

• Os Administradores de Serviços que também têm a função Administrador deDomínios de Identidades podem importar conteúdos de aplicativos para oambiente de serviço e artefatos de domínios de identidades (usuários e suasatribuições de funções) para o domínio de identidades do ambiente.

Se um usuário que não está no domínio de identidades for referenciado noinstantâneo que está sendo importado, o utilitário criará um usuário no domíniode identidades e atribuirá a senha padrão especificada no comando. Por padrão, ousuário deverá redefinir a senha durante a primeira conexão.

Nota: Os usuários que são membros de grupos no Controle de Acessodeverão ser atribuídos a uma função predefinida. Não é permitido atribuir aum grupo um usuário que não está designado a uma função predefinida.

Uso: epmautomate importsnapshot SNAPSHOT_NAME[userPassword=DEFAULT_PASSWORD] [resetPassword=true|false], onde

• SNAPSHOT_NAME é o nome de um instantâneo no local de upload padrão.

• userPassword indica a senha padrão a ser atribuída a novos usuários criados nodomínios de identidades. A senha especificada deverá atender aos requisitosmínimos da senha do domínio de identidades.

• resetPassword indica se o novo usuário deve alterar a senha na primeira vezque fizer logon. A menos que esse parâmetro opcional seja definido como false,o novo usuário deverá alterar a senha na primeira vez que se conectar.

Exemplos:

• Importar artefatos do aplicativo

epmautomate importsnapshot October16FullApp

• Importar artefatos do aplicativo e do domínio de identidades (paraAdministradores de Serviços com a função Administrador do Domínio deIdentidades apenas.)

– epmautomate importsnapshot October16FullAppuserPassword=Password1

Este comando força novos usuários a redefinirem a senha depois da primeiravez que se conectarem.

– epmautomate importsnapshot October16FullAppuserPassword=Password1 resetPassword=false



Este comando permite que os usuários mantenham a senha padrão casooptem por isso.


Nota:

Todos os parâmetros de comandos devem ser delimitados por aspas duplas.

Importa dados complementares de um arquivo para o aplicativo. Use o comando uploadfile a fim de fazer o upload do arquivo que contém os dados do aplicativo parao local de upload padrão.

Uso: epmautomate importsupplementaldata "FILE_NAME""DATA_SET_NAME" "YEAR" "PERIOD_NAME" "SCENARIO_NAME", em que:

• FILE_NAME é o nome de um arquivo CSV, disponível no local de upload padrão,que contém dados complementares formatados de forma adequada.

• DATA_SET_NAME é o nome do conjunto de dados para o qual os dadoscomplementares do arquivo deverão ser importados.

• YEAR é o ano para o qual o conjunto de dados será implantado.

• PERIOD_NAME é o nome do período no qual o conjunto de dados será implantado.

• SCENARIO_NAME é o nome do cenário no qual o conjunto de dados seráimplantado.

Exemplo: epmautomate importsupplementaldata "DatasetImport.csv""EmployeeDataSet" "FY17" "Jan" "Actual"

importtemplate

Cria uma estrutura de aplicativo importando-a de um arquivo de modelo existente emprofitinbox. É possível fazer o upload de um arquivo de modelo para profitinbox como comando uploadfile.

Uso: epmautomate importtemplate APPLICATION_NAME File_NameisApplicationOverwrite=true|false, onde:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud que você deseja criar por meio da importação do modelo

• File_Name é o nome do arquivo .ZIP que contém o modelo de aplicativo. Essearquivo deve existir em profitinbox.

• isApplicationOverwrite especifica se o aplicativo existente, se houver, deveou não ser substituído. Especifique esse valor de parâmetro totalmente emminúsculas.

Exemplo: epmautomate importtemplate BksML12 template1.zipisApplicationOverwrite=true




Para uma origem de dados específica, importa dados de saldo pré-mapeados de umarquivo no repositório do Oracle Account Reconciliation Cloud para aCorrespondência da Transação.

Consulte Importação de Dados em Reconciliação de Contas com o Oracle AccountReconciliation Cloud para obter os requisitos de formato de arquivo de importação einformações sobre a importação de dados.

Nota:

Ao contrário da tela de Jobs, você só pode importar dados de saldos pré-mapeados de um arquivo por vez.

Use o comando uploadfile a fim de fazer o upload do arquivo de saldos para o serviço.

Uso: epmautomate importtmpremappedbalances RECONCILIATION_TYPEDATA_SOURCE FILE_NAME [DATE_FORMAT], em que:

• RECONCILIATION_TYPE é o tipo de reconciliação definido no Oracle AccountReconciliation Cloud.

• DATA_SOURCE é o identificador da origem de dados associada ao tipo dereconciliação especificado.

• FILE_NAME é o nome do arquivo CSV que contém os detalhes dos saldos a seremimportados. Esse arquivo deverá estar disponível no serviço.

• DATE_FORMAT é um parâmetro opcional que indica o formato dos campos de dataincluídos no arquivo de importação de saldos. O padrão é DD-MMM-YYYY, que é oúnico formato suportado atualmente.

Exemplo: epmautomate importtmpremappedbalances "INTERCOMPANY""AP" dailybalances.csv


Para uma origem de dados específica, importa dados de transações pré-mapeadas deum arquivo no repositório do Oracle Account Reconciliation Cloud para aCorrespondência da Transação. Use o comando uploadfile a fim de fazer o upload doarquivo de transações para o serviço.

Consulte Importação de Dados em Reconciliação de Contas com o Oracle AccountReconciliation Cloud para obter os requisitos de formato de arquivo de importação einformações sobre a importação de dados.

Nota:

• Ao contrário da tela de Jobs, você só pode importar dados de transaçõespré-mapeadas de um arquivo por vez.

• Após a importação de transações pré-mapeadas para todas as origens dedados, execute o comando runautomatch.



Uso: epmautomate importtmpremappedtransactionsRECONCILIATION_TYPE DATA_SOURCE FILE_NAME [DATE_FORMAT], em que:

• RECONCILIATION_TYPE é um tipo de reconciliação definido no Oracle AccountReconciliation Cloud.

• DATA_SOURCE é o identificador da origem de dados associada ao tipo dereconciliação especificado.

• FILE_NAME é o nome do arquivo CSV que contém as transações a seremimportadas. Esse arquivo deverá estar disponível no serviço.

• DATE_FORMAT é um parâmetro opcional que indica o formato dos campos de dataincluídos no arquivo de importação de transações. O padrão é DD-MMM-AAAA, queé o único formato suportado atualmente.

Exemplo: epmautomate importtmpremappedtransactions "INTERCOMPANY""AP" dailydata.csv

listfiles

Lista os arquivos no local padrão, nas pastas do Gerenciamento de Dados e emprofitinbox/profitoutbox. Também lista arquivos de exportação incremental e debackup, além de instantâneos de Migração.

Uso: epmautomate listfiles

loaddata

Carrega dados em um cubo de cálculo usando um arquivo disponível em profitinbox.Use o comando uploadfile para carregar arquivos em profitinbox.

Uso: epmautomate loaddata APPLICATION_NAME PARAMETER=VALUEdataFileName=File_Name, onde:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud para o qual você deseja carregar os dados

• PARAMETER=VALUE indica os parâmetros de tempo de execução e os respectivosvalores para carregamento dos dados. Especifique tantos emparelhamentos deparâmetros e valores quantos forem necessários para o processo. Parâmetrosválidos e os respectivos valores:

– clearAllDataFlag=true|false especifica se os dados existentes no cubodo aplicativo devem ou não ser limpos

– dataLoadValue=OVERWRITE_EXISTING_VALUES|ADD_TO_EXISTINGespecifica como tratar os dados existentes

Nota:

O nome do arquivo de dados deve estar entre aspas duplas.

• dataFileName=File_Name especifica um arquivo de carregamento de dadosdisponível em profitinbox.



Exemplo: epmautomate loaddata BksML12 clearAllDataFlag=truedataLoadValue=”OVERWRITE_EXISTING_VALUES”dataFileName=”data1.txt”

loaddimdata

Carrega metadados de dimensão de um ou mais arquivos em profitinbox para umaplicativo. Use o comando uploadfile para carregar arquivos em profitinbox.

Uso: epmautomate loaddimdata APPLICATION_NAMEdataFileName=File_Name [stringDelimiter="DELIMITER"], onde:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud para o qual você deseja carregar os metadados de dimensão

• dataFileName=File_Name especifica um arquivo de carregamento demetadados de dimensão disponível em profitinbox. Para carregar metadadoscontidos em vários arquivos, liste os nomes dos arquivos separados por umdelimitador.

• stringDelimiter="DELIMITER" especifica o delimitador usado para separarnomes de arquivos de metadados. O delimitador deve estar entre aspas duplas.

Exemplo: epmautomate loaddimdata BksML12dataFileName=”dimdata1.txt#dimdata1.txt” stringDelimiter="#"

login

Estabelece uma conexão segura com um ambiente. Você efetua sign-in para iniciaruma sessão, que permanece ativa até que você efetue sign-out. Não é possível usarcredenciais corporativas para se conectar a esse utilitário.

Nota:

Quando esse comando é usado em arquivos de lote para automatizaratividades, a Oracle recomenda o uso de senhas criptografadas para evitar agravação de senhas com texto não criptografado nesses arquivos.

Durante o login, uma mensagem para atualizar o utilitário será exibida se você estiverusando uma versão mais antiga do utilitário. Você pode usar o comando upgrade paraatualizar a sua instalação silenciosamente.

Uso:

• Com uma senha não criptografada: epmautomate login USERNAMEPASSWORD URL IDENTITYDOMAIN[ProxyServerUserName=PROXY_USERNAMEProxyServerPassword=PROXY_PASSWORDProxyServerDomain=PROXY_DOMAIN]

• Com senhas criptografadas: epmautomate login USERNAMEPASSWORD_FILE URL IDENTITYDOMAIN[ProxyServerUserName=PROXY_USERNAME][ProxyServerDomain=PROXY_DOMAIN]

Nesses comandos:



• USERNAME é o nome de usuário do Administrador do Serviço.

• PASSWORD é a senha do Administrador do Serviço.

• PASSWORD_FILE é o nome e o local do arquivo que armazena a senhacriptografada do Administrador do Serviço. Consulte o comando encrypt.

• URL é o URL do ambiente para conexão.

• IDENTITYDOMAIN é o domínio de identidade do ambiente.

• ProxyServerUserName é o nome do usuário para autenticar uma sessão segurano servidor proxy que controla o acesso à internet. Esta opção só será obrigatóriase a autenticação no servidor proxy estiver habilitada para a sua rede.

• ProxyServerPassword é a senha para autenticar o usuário no servidor proxy.Esta opção só será obrigatória se a autenticação no servidor proxy estiverhabilitada para a sua rede e se você estiver usando um arquivo de criptografia desenha.

• ProxyServerDomain é o nome do domínio definido para o servidor proxy. Estaopção só será obrigatória se a autenticação no servidor proxy estiver habilitadapara a sua rede e se houver um domínio de servidor proxy configurado.

Nota:

O utilitário detecta e usa as configurações de proxy da internet no seucomputador. Se as configurações de proxy exigirem que você se autentique noservidor proxy, será necessário inserir o domínio de servidor proxy, o nomedo usuário e uma senha como parâmetros para esse comando. Entre emcontato com o administrador de rede para obter ajuda com o nome e ascredenciais do domínio do servidor proxy.

Exemplos:

• Usando uma senha não criptografada, sem autenticação de proxy:

epmautomate login serviceAdmin P@ssword1 https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain

• Usando uma senha criptografada, sem autenticação de proxy:

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain

• Usando a senha do EPM Cloud criptografada, se a autenticação no servidorproxy estiver habilitada para o domínio do servidor:

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]=example ProxyServerDomain=example

• Usando a senha do EPM Cloud criptografada, se a autenticação no servidorproxy estiver habilitada sem um domínio do servidor:



epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]=example

• Usando senhas criptografadas, se a autenticação no servidor proxy estiverhabilitada para o domínio do servidor:

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]=example

• Usando senhas criptografadas, se a autenticação no servidor proxy estiverhabilitada sem um domínio do servidor:

epmautomate login serviceAdmin C:\mySecuredir\password.epwhttps://test-cloud-pln.pbcs.us1.oraclecloud.commyIdentityDomain [email protected]

logout

Encerra a sua conexão atual com um ambiente.

Uso: epmautomate logout

maskData

Mascara os dados do aplicativo para garantir a privacidade dos dados. Utilize estecomando somente em ambientes de teste para ocultar dados confidenciais dosdesenvolvedores de aplicativos.

AVISO: Não utilize esse comando em ambientes de produção porque ele randomizadados do aplicativo atual; a renderização desses dados é insignificante. Você não podedesfazer os efeitos desse comando. Se você tiver mascarado os dados por engano emum ambiente de serviço, deverá restaurar os dados de um backup ou do instantâneode manutenção.

Uso: epmautomate maskData [–f], em que -f é uma opção para forçar o início doprocesso de mascaramento sem a confirmação do usuário. Se você não usar a opção -f, o utilitário solicitará que você confirme a sua ação.

provisionreport

Gera um relatório de provisionamento (arquivo .CSV) e armazena-o no local dedownload padrão do qual será possível fazer o seu download para o computador.Esse relatório contém informações sobre as funções atribuídas aos usuários einformações de herança que mostram a sequência a partir da função original que eraresponsável por conceder a função provisionada ao usuário.

Uso: epmautomate provisionreport REPORT_NAME, onde REPORT_NAME é onome do arquivo de relatório.

Exemplo: epmautomate provisionreport myProvReport.CSV

recreate

Restaura um ambiente para um estado inicial atualizando a implantação. Esseprocesso exclui do ambiente o aplicativo existente e todos os artefatos definidos pelo



usuário. Após recriar o serviço, você poderá criar um novo aplicativo ou importar umaplicativo usando a Migração ou o EPM Automate Utility.

Cuidado:

O uso deste comando resulta na perda dos dados e dos artefatos existentes.Execute um backup completo do aplicativo antes de recriar um ambiente.

Uso: epmautomate recreate [-f], em que -f é a opção para forçar o processo derecriação a ser iniciado sem a confirmação do usuário. Se você não usar a opção -f, outilitário solicitará que você confirme a sua ação.

Exemplo: epmautomate recreate -f recria o ambiente atual sem solicitarconfirmação.

refreshcube

Atualiza o cubo do aplicativo. Normalmente, você atualiza o cubo após importarmetadados para o aplicativo.

O tempo necessário para concluir a operação de atualização do cubo depende dasalterações efetuadas na estrutura do aplicativo e do seu impacto no cubo. Por exemplo,uma atualização após a atualização de um membro do cubo de armazenamento embloco esparso poderá não ser muito demorada, enquanto uma atualização do cuboapós a atualização de um membro do cubo de armazenamento em bloco denso ou deum membro do cubo de armazenamento agregado poderá levar um tempoconsiderável. Você deve garantir que a operação de atualização do cubo seja concluídaantes de ser efetuado backup do aplicativo durante a próxima janela de manutenção.

Uso: epmautomate refreshcube [JOB_NAME], onde

JOB_NAME é, opcionalmente, o nome de um job definido no aplicativo

Exemplo: epmautomate refreshcube dailyCubeRefresh

removeUsers

Exclui as contas de domínio de identidades identificadas em um arquivo CSVcodificado em ANSI ou em UTF-8 cujo upload foi feito no ambiente. Utilize ocomando uploadfile para fazer o upload dos arquivos. O formato de arquivo é oseguinte:




Nota:

Esse comando só deve ser executado por um Administrador de Domínios deIdentidades no domínio de identidades do qual os usuários deverão serremovidos.

O arquivo CSV não deve incluir a conta do usuário que executa esse comando.

Como as contas de usuário são comuns a todos os ambientes de serviço queum Administrador de Domínios de Identidades atende, a exclusão de umaconta de um ambiente a exclui para todos os ambientes que compartilham oAdministrador de Domínios de Identidades.

Uso: epmautomate removeUsers FILE_NAME, onde FILE_NAME é o nome de umarquivo CSV que contém os IDs de e-mail dos usuários a serem removidos do domíniode identidades.

Exemplo: epmautomate removeUsers remove_users.CSV

replay

Reproduz o carregamento do Oracle Smart View para Office em um ambiente paraque seja possível testar o desempenho sob condições de carga pesada, a fim deverificar se a experiência do usuário é aceitável quando o serviço está sob determinadacarga.

Você deve criar o arquivo de reprodução que identifica as atividades do Smart Viewque devem ser executadas no serviço. Consulte Preparação para Executar o ComandoReplay para obter informações detalhadas sobre como criar o arquivo de reprodução.

Uso: epmautomate replay REPLAY_FILE_NAME.csv [duration=N][trace=true], onde:

• REPLAY_FILE_NAME é um arquivo CSV que armazena as atividades a seremexecutadas no ambiente.

• O parâmetro Duration é opcional e indica o número de minutos para os quaisatividades são executadas no ambiente.

As atividades no arquivo HAR serão executadas uma vez se esse valor não fordefinido. Se as atividades no arquivo HAR forem concluídas no tempoespecificado por esse parâmetro, o utilitário executará novamente o arquivo HARaté que as atividades estejam concluídas. Por exemplo, pressuponha que vocêdefina duration=10 para reproduzir um arquivo HAR que necessita de trêsminutos para ser executado. Nesse cenário, o comando replay executa asatividades do arquivo HAR quatro vezes (o que dura 12 minutos) até a quartaiteração estar concluída.

• trace=true é uma configuração opcional que instrui o utilitário a criar arquivosde rastreamento no formato XML.

Se essa configuração opcional for especificada, o utilitário criará uma pasta paracada arquivo HAR incluído no arquivo CSV de reprodução e armazenará todos osarquivos de rastreamento relacionados nela. Para cada atividade do arquivo HAR,o utilitário gera um arquivo de rastreamento que contém a resposta do SmartView. Os arquivos de rastreamento são nomeados como trace-N.xml; porexemplo, trace-1.xml, onde N é um contador que inicia em 1.



As pastas que armazenam os arquivos de rastreamento são criadas no diretório noqual o EPM Automate Utility é executado. O utilitário usa uma combinação dahora do sistema de servidor e do nome do arquivo HAR atuais no formatoYYYY_MM_DD_HH_MM_SS_HAR_FILE_NAME para nomear as pastas. Por exemplo,se o nome do arquivo HAR for forecast1.har, o nome da pasta poderá ser2016_06_08_10_21_42_forecast1.

Exemplo: epmautomate replay forecast1.csv duration=15

Consulte Exemplo de Sessão de Reprodução para obter as etapas detalhadasenvolvidas na execução desse comando.

resetservice

Reinicia o ambiente. Use esse comando somente quando você observar umadegradação muito acentuada do desempenho ou se receber mensagens de erroindicando que não é possível usar o ambiente. A redefinição do serviço não afeta aspersonalizações do aplicativo (por exemplo, alteração da configuração regional,configurações relacionadas a tema e moeda etc.). A redefinição leva até 15 minutos.

Nota:

Os comentários devem ser incluídos entre aspas.

Uso: epmautomate resetservice "comment"

Exemplo: epmautomate resetservice "Users experience unacceptablyslow connections"

runautomatch

Executa o processo Correspondência Automática para estabelecer umacorrespondência com transações usando as regras definidas por um Administrador deServiços. Você pode monitorar o status do processo de correspondência automática naguia Histórico de Jobs no Oracle Account Reconciliation Cloud.

Nota: Execute este comando após importar dados de transações para aCorrespondência da Transação usando o comandoimporttmpremappedtransactions. Após executar a correspondênciaautomática, execute o comando importtmpremappedbalances paraimportar dados de saldo na Correspondência da Transação.

Uso: epmautomate runautomatch RECONCILIATION_TYPE, em queRECONCILIATION_TYPE é um tipo de reconciliação definido no Oracle AccountReconciliation Cloud.

Exemplo: epmautomate runautomatch INTERCOMPANY

runbatch

Executa um lote do Gerenciamento de Dados.

Se o modo de execução em lote estiver definido como Serial no Gerenciamento deDados, o controle será retornado quando todos os jobs do lote estiverem concluídos; seele estiver definido como Paralelo, o controle será retornado quando todos os jobs dolote forem enviados para execução.



Uso: epmautomate runbatch BATCH_NAME, onde

BATCH_NAME é o nome de um lote definido no Gerenciamento de Dados

Exemplos: epmautomate runbatch Accounting_batch

runbusinessrule

Inicia uma regra de negócios ou um conjunto de regras.

Uso: epmautomate runbusinessrule RULE_NAME [PARAMETER=VALUE], onde:

• RULE_NAME é o nome de uma regra de negócios exatamente como definido noambiente.

• PARAMETER=VALUE indica os parâmetros opcionais de tempo de execução e osrespectivos valores necessários para executar a regra de negócios.

Especifique os parâmetros de tempo de execução somente para iniciar regras. Sevocê estiver executando conjuntos de regras, o comando ignorará os parâmetrosde tempo de execução especificados. Os conjuntos de regras são executados comos valores padrão especificados durante a sua criação com o Calculation Manager.

Nota:

A regra é executada no tipo de plano para o qual foi implantada.

Use o emparelhamento PARAMETER=VALUE para especificar tantassolicitações em tempo de execução quantas forem necessárias para a regra denegócios. O exemplo a seguir usa duas solicitações em tempo de execução(Period e Entity) e os respectivos valores (Q1 e USA).

Os valores padrão serão usados se você não fornecer valores para parâmetrosde tempo de execução. O comando ignora solicitações de tempo de execuçãoque correspondem exatamente às solicitações definidas na regra.

Exemplo: epmautomate runbusinessrule RollupUSSales Period=Q1Entity=USA

runcalc

Executa cálculos em um aplicativo.

Uso: epmautomate runcalc APPLICATION_NAME POV_NAMEPARAMETER=VALUE [comment="comment"] stringDelimiter="DELIMITER",where:

• APPLICATION_NAME é o nome do aplicativo do Oracle Profitability and CostManagement Cloud que contém o PDV a ser calculado.

• POV_NAME é o nome do PDV que deverá ser calculado.

• PARAMETER=VALUE indica os parâmetros de tempo de execução e os respectivosvalores para executar o cálculo. Especifique tantos emparelhamentos deparâmetros e valores quantos forem necessários para o processo. Parâmetrosválidos e os respectivos valores:

– exeType=ALL_RULES|RULESET_SUBSET|SINGLE_RULE identifica o tipode execução da regra. Este é um parâmetro obrigatório.



Dependendo do valor definido para exeType, os parâmetros a seguir podemser especificados:

* Se você especificar exeType=ALL_RULES, não inclua parâmetrosrelacionados a um subconjunto de regras ou a uma regra individual,como subsetStart, subsetEnd, ruleSetName e ruleName.

* Se você especificar exeType=SINGLE_RULE, especifique os valores pararuleSetName e ruleName apenas.

* Se você especificar exeType=RULESET_SUBSET, especifique os valorespara subsetStart e subsetEnd.

– subsetStart especifica o número de sequência da primeira regra doconjunto de regras a ser executada

– subsetEnd especifica o número de sequência da última regra do conjunto deregras a ser executada

– ruleSetName identifica o conjunto de regras que contém os cálculos a seremexecutados

– ruleName nome da regra a ser executada (para executar uma única regra)

– isClearCalculated=true|false especifica se os cálculos existentesdevem ou não ser limpos

– isExecuteCalculations=true|false especifica se os cálculos devemou não ser executados

– isRunNow=true|false defina esse valor como true para executar oprocesso agora

– optimizeReporting=true|false. Defina este valor opcional comofalse se os cálculos forem executados sem que haja otimização para geraçãode relatórios. O padrão é true

Melhores Práticas:

* Defina optimizeReporting=false somente quando necessário parasalvar o tempo de processamento; por exemplo, durante a execução deuma única regra ou de uma série sequencial de diversos PDVs

* Ao executar vários jobs de cálculo simultâneos, definaoptimizeReporting=true para todos os jobs; somente o último job aser concluído executará a agregação, evitando um processamentoredundante e impedindo que os jobs em execução se tornem lentos.

– comment é um comentário opcional incluído entre aspas duplas

– stringDelimiter é o delimitador usado nos valores de PDV. Odelimitador deve estar entre aspas duplas.

Nota:




Exemplo: epmautomate runcalc BksML12 2012_Jan_ActualisClearCalculated=true isExecuteCalculations=true isRunNow=truesubsetStart=10 subsetEnd=20 ruleSetName=”Utilities ExpenseAdjustment" ruleName="Occupancy Expense Allocations"exeType=”ALL_RULES” comment=”Test calculation”stringDelimiter="_"

runDailyMaintenance

Inicia o processo diário de manutenção de serviço imediatamente, em vez de aguardara janela de manutenção diária agendada. Esse comando permite forçar a criação de uminstantâneo de backup e atualizar o seu ambiente nos casos em que um patch isolado éaplicado ao ambiente e você não deseja aguardar pela próxima janela de manutençãopara que as alterações entrem em vigor. Antes de executar esse comando, certifique-sede que ninguém esteja usando o ambiente. A agenda de manutenção diária não éafetada por esse comando.

Uso: epmautomate runDailyMaintenance

rundatarule

Executa uma regra de carregamento de dados do Gerenciamento de Dados com basenos períodos de início e término e nas opções de importação e exportaçãoespecificadas.

Uso: epmautomate rundatarule RULE_NAME START_PERIOD END_PERIODIMPORT_MODE EXPORT_MODE [FILE_NAME], onde:

• RULE_NAME é o nome de uma regra de carregamento de dados definida noGerenciamento de Dados. Você deverá incluir o nome da regra entre aspas casoele contenha espaço.

• START_PERIOD é o primeiro período para o qual os dados devem ser carregados.O nome desse período deve ser definido no mapeamento de períodos doGerenciamento de Dados.

• END_PERIOD, para carregamento de dados de vários períodos, é o último períodopara o qual os dados deverão ser carregados. Para o carregamento de um únicoperíodo, especifique o mesmo período como o inicial. O nome desse período deveser definido no mapeamento de períodos do Gerenciamento de Dados.

• IMPORT_MODE determina como os dados são importados para o Gerenciamentode Dados. Os valores aceitáveis são:

– APPEND para adicionar aos dados de PDV existentes no Gerenciamento deDados

– REPLACE para excluir os dados de PDV e substituí-los pelos dados doarquivo

– RECALCULATE para recalcular os dados

– NONE para ignorar a importação de dados para a tabela intermediária doGerenciamento de Dados

• EXPORT_MODE determina como os dados são exportados para o aplicativo. Osvalores aceitáveis são:



Nota:

Para o Oracle Financial Consolidation and Close Cloud, somente os seguintesmodos de exportação são suportados:

– MERGE para mesclar os dados na tabela intermediária do Gerenciamentode Dados com os dados existentes

– REPLACE para remover entradas da tabela intermediária e substituí-loscom entradas do carregamento de dados

– NONE para ignorar a exportação de dados do Gerenciamento de Dadospara o aplicativo

Nota:

Para o Oracle Fusion Cloud como um destino, somente os seguintes modos deexportação são suportados:

– MERGE para mesclar os dados na tabela intermediária do Gerenciamentode Dados com os dados existentes

– NONE para ignorar a exportação de dados do Gerenciamento de Dadospara o aplicativo

– STORE_DATA para mesclar os dados na tabela intermediária doGerenciamento de Dados com os dados existentes

– ADD_DATA para adicionar os dados da tabela intermediária doGerenciamento de Dados ao aplicativo

– SUBTRACT_DATA para subtrair dos dados existentes os dados da tabelaintermediária do Gerenciamento de Dados

– REPLACE_DATA para limpar os dados de PDV e substituí-los pelos dados databela intermediária do Gerenciamento de Dados. Os dados referentes aCenário, Versão, Ano, Período e Entidade são limpos

– NONE para ignorar a exportação de dados do Gerenciamento de Dados para oaplicativo

• FILE_NAME é um nome de arquivo opcional. Se você não especificar um nome dearquivo, o EPM Automate Utility importará os dados contidos no nome dearquivo especificado na regra de carregamento de dados. Esse arquivo deve estardisponível na pasta caixa de entrada ou em uma pasta contida nela.

Nota: As configurações de modo de Importação e Exportação fazem distinçãoentre maiúsculas e minúsculas.

Exemplos:

• Importação de vários períodos: epmautomate rundatarule VisionActualMar-15 Jun-15 REPLACE STORE_DATA inbox/Vision/GLActual.dat



• Importação de um período: epmautomate rundatarule "Vision Actual"Mar-15 Mar-15 REPLACE STORE_DATA inbox/Vision/GLActual.dat

runDMReport

Cria um relatório do Gerenciamento de Dados e armazena-o na pasta outbox/reports. Use o comando downloadfile a fim de fazer download do relatório paraum computador local.

O relatório gerado é nomeado com base no ID do job do Gerenciamento de Dados quegera o relatório e no formato do relatório. Por exemplo, se o ID do job do relatório for2112, e o formato de saída especificado for PDF, o nome do relatório será 2112.pdf.Depois que o relatório for gerado, o seu nome será exibido no console. Também épossível identificar o nome do relatório na guia Detalhes do Processo doGerenciamento de Dados ou com o comando listfiles.

Uso: epmautomate runDMReport REPORT_NAME PARAMETER=Value "ReportOutput Format=[PDF|HTML|XLS|XLSX]", onde

• REPORT_NAME é o nome do modelo de relatório do Gerenciamento de Dados quedeverá ser usado para gerar o relatório.

• PARAMETER=Value indica os parâmetros do relatório e os respectivos valores.Você pode especificar tantos parâmetros quantos forem necessários no formatoPARAMETER=Value. A lista de parâmetros necessários depende do relatório quevocê deseja gerar.

Nota:

Os parâmetros de tempo de execução do relatório são definidos durante acriação dos relatórios. Para executar esse comando, é necessário gerar e copiaresses parâmetros e os valores para o utilitário na guia Fluxo de Trabalho. Paragerar os parâmetros de tempo de execução de um relatório, na guia Fluxo deTrabalho do Gerenciamento de Dados, clique em Execução de Relatório eselecione um grupo no Grupo de Relatórios. Selecione o relatório para o qualdeseja gerar os parâmetros e clique em Criar Script de Relatório.Opcionalmente, especifique os valores dos parâmetros do relatório, selecioneum formato de saída e clique em OK. Use os parâmetros mostrados em GerarScript de Relatórios a fim de especificar os parâmetros de tempo de execuçãoe os valores para geração do relatório

• Report Output Format indica o formato de saída do relatório. As opçõesválidas são PDF, HTML, XLS e XLSX. O formato de relatório padrão é PDF.

Exemplo: epmautomate runreport "TB Current Location By TargetAcct (Cat,Per)" "Period=Jul 14" "Category=Forecast""Location=FCSTtoVISCONSOL1" "Rule Name=FCSTtoVISCONSOL1" "ReportOutput Format=HTML"

runplantypemap

Copia dados de um banco de dados de armazenamento em bloco para outro dearmazenamento agregado ou de um armazenamento em bloco para outro do mesmotipo, com base nas configurações especificadas em um job do tipo plan type map.

Uso: epmautomate runplantypemap JOB_NAME [clearData=true|false],onde:



• JOB_NAME é o nome de um job do tipo plan type map definido no aplicativo.

• clearData é uma configuração opcional que indica se os dados do banco dedados de destino devem ser removidos antes da cópia de dados. Se o valor desseparâmetro não for definido, o valor padrão true será usado.


Exemplo: epmautomate runplantypemap CampaignToReportingclearData=false

setdemodates

Use esse comando apenas na configuração de instalações com dados de demonstraçãointernos da Oracle.

Para o Oracle Account Reconciliation Cloud somente: Renomeia os períodos noOracle Account Reconciliation Cloud para consistência com a data especificada. Eletambém redefine as datas de todas as reconciliações que têm os valores de atributoDemo Code associados: setdemodate ou setdemodatenostatuschage.

Esse comando trata as reconciliações em até dois períodos: um período atual e umperíodo anterior (histórico). Se reconciliações de mais de dois períodos foremidentificadas com o atributo Demo Code, o comando tratará esses períodos comosendo o período anterior. As reconciliações que não têm esse valor de atributo nãoserão afetadas.

• Se o valor for setdemodate, o comando redefinirá as datas de reconciliação combase na data especificada e o retornará para o status Abrir com Preparador

• Se o valor for setdemodatenostatuschage, o comando redefinirá as datas dereconciliação com base na data especificada sem alterar o status da reconciliação

Para o Oracle Financial Consolidation and Close Cloud e o Oracle Tax ReportingCloud somente: Esse comando redefine as datas de início e de término das tarefas, eoutras informações de data relacionadas, para tornar as tarefas visualmente adequadaspara uma demo. Calcula as datas da nova tarefa com base no valor do atributoSETDEMODATES definido na tarefa juntamente com o valor de Demo Date fornecido.Se o valor de Demo Date não for especificado, o comando utilizará a data atual paracalcular as datas da nova tarefa.

Nota: Tarefas em agendamentos que não têm o valor SETDEMODATES não sãoafetadas.

Com base na Data da Demo especificada, esse comando adiantará todas as datasassociadas à tarefa. Isso inclui datas de tempo de execução principal (data de início,data de término etc.) e datas auxiliares incluindo datas históricas de vencimento deworkflow individual e datas de início (real). O status da tarefa não é afetado.

Uso: epmautomate setdemodates [DEMO_DATE], onde DEMO_DATE é uma dataopcional no formato AAAA-MM-DD. As reconciliações serão redefinidas como a dataatual se você não especificar esse valor.

Exemplo: epmautomate setdemodates 2017-02-15



setperiodstatus

Define o status de um período específico.

Uso: epmautomate setperiodstatus PERIOD STATUS, onde:


• STATUS é OPEN, CLOSED ou LOCKED

Exemplo: epmautomate setperiodstatus “January 2015” OPEN

setsubstvars

Cria ou atualiza variáveis de substituição no nível do aplicativo ou do cubo. Não épossível usar esse comando para definir vários valores e/ou funções para variáveis desubstituição.

Uso: epmautomate setsubstvars CUBE_NAME SUBSTVAR=VALUE[SUBSTVAR=VALUE], onde:

• CUBE_NAME é o cubo (por exemplo, Plan1, Plan2) para o qual a variável desubstituição será criada ou atualizada. Use All, em vez de um nome de cubo,para definir ou atualizar a variável de substituição no nível do aplicativo.

• SUBSTVAR é o nome da variável de substituição para a qual um valor deverá serdefinido ou atualizado.

• VALUE é o novo valor da variável de substituição.

Exemplos:

• Criar ou atualizar uma variável de substituição no nível do aplicativo:epmautomate setsubstvars ALL CurYear=2015 CurPeriod=Jan

• Criar ou atualizar variáveis de substituição no nível do cubo: epmautomatesetsubstvars Plan2 CurYear=2013 CurPeriod=Jan

unassignRole

Remove uma função designada atualmente aos usuários cujos IDs de e-mail estãoincluídos no arquivo CSV codificado em ANSI ou em UTF-8 usado com este comando.Antes de executar esse comando, faça upload do arquivo para o ambiente usando ocomando uploadfile. O formato de arquivo é o seguinte:


Nota:

Esse comando pode ser executado por um Administrador de Domínios deIdentidades no domínio de identidades, no qual as funções deverão serdesignadas, ou por um Administrador de Serviços.

O arquivo CSV não deve incluir a conta do usuário que executa esse comando.

Uso: epmautomate unassignRole FILE_NAME ROLE, onde:



• FILE_NAME é o nome de um arquivo CSV que contém os IDs de e-mail dosusuários cuja atribuição de função será modificada

• ROLE identifica o nome de uma função predefinida aplicável ao serviço. Um nomede função incorreto resultará em um erro. Consulte Noções Básicas de FunçõesPredefinidas em Introdução ao Oracle Enterprise Performance Management Cloud paraAdministradores.

Nota: Algumas dessas funções podem não ser aplicáveis ao serviço atual.

Os valores aceitáveis são:

– Administrador de Serviços

– Usuário Avançado

– User (não utilize Planner, que foi usado em versões anteriores do serviço)

– Viewer

Exemplo: epmautomate unassignRole remove_roles.CSV "ServiceAdministrator"

upgrade

Faz download automático da versão mais recente do EPM Automate Utility e a instalasilenciosamente.

Após executar o comando login para iniciar uma sessão, o utilitário identifique aversão atual instalada. Se a versão instalada não for a mais recente disponível, outilitário informará que uma versão mais nova disponível.

Uso: epmautomate upgrade

uploadfile

Faz upload de um arquivo do computador local para o serviço. Use este comando parafazer upload de arquivos que contêm dados, metadados, definições de regras,definições de dimensões, transações mapeadas, modelos e instantâneos de backup.

Uso: epmautomate uploadfile "FILE_NAME" [DATA_MANAGEMENT_FOLDER |profitinbox]

Exemplos:

• Fazer upload para o local padrão: epmautomate uploadfile "C:/pbcsdata/quarterlydata.csv"

• Fazer upload para uma pasta do Gerenciamento de Dados: epmautomateuploadfile "C:/fdmee_data/data.zip" inbox/repository

• Fazer upload para profitinbox (Oracle Profitability and Cost Management Cloud):epmautomate uploadfile "C:/profitability_data/data.zip"profitinbox

userauditreport

Gera um relatório de auditoria do usuário (arquivo .CSV) e armazena-o no local dedownload padrão do qual será possível fazer o seu download para o computador.



Esse relatório contém informações sobre os usuários que fizeram login em umambiente durante o período de tempo especificado. Ele mostra o endereço IP docomputador de onde o usuário fez login e a data e o horário em que o usuário acessouo ambiente.

Uso: epmautomate userauditreport FROM_DATE TO_DATE REPORT_NAME ,onde:

• FROM_DATE indica a data de início (no formato YYYY-MM-DD) do período para oqual o relatório de auditoria deve ser gerado

• TO_DATE indica a data de término (no formato YYYY-MM-DD) do período para oqual o relatório de auditoria deve ser gerado

• REPORT_NAME é o nome do arquivo de relatório

Exemplo: epmautomate userauditreport 2016-10-15 2016-12-15myAuditReport.CSV

Códigos de SaídaO EPM Automate Utility retorna um código de saída e uma mensagem para indicar ostatus da operação. Os códigos de saída são agrupados em cinco números de código;cada código pode indicar várias condições de erro. Verifique a mensagem associadapara identificar a condição específica que causou o erro. Além disso, o utilitário criaum arquivo de log (COMMANDNAME_TIMESTAMP.log, por exemplo,uploadfile_16_11_2016_11_27_10.log) para cada execução de comando emque ocorreu falha. Os arquivos de log são criados no computador no qual o utilitário éexecutado.

Erros do Código de Saída 1

Command failed to execute O utilitário usa este código de saída para exibir asmensagens relacionadas aos códigos de status HTTP 200 e 400. Esses códigos sãoretornados pelas APIs REST usadas pelo utilitário.

Insufficient privileges to perform the operation Este erro seráexibido se o usuário cujas credenciais são utilizadas para efetuar sign-in no serviço nãotiver privilégios suficientes para executar a operação desejada.

Efetue sign-in com uma conta que tenha privilégios suficientes para executar aoperação. Geralmente, apenas os Administradores de Serviço têm permissão paraexecutar operações no serviço.

Resource does not exist Este erro será exibido se o arquivo ou o instantâneoque você deseja excluir ou do qual deseja fazer download não existir no serviço.

Use o comando listfiles para verificar o nome do arquivo e o seu local.

Invalid snapshot SNAPSHOT Este erro é exibido quando o serviço não é capaz devalidar o instantâneo especificado para a operação de exportação ou importação.

Verifique se você está usando um instantâneo válido.

Internal server error. Unable to delete file: FILE_NAME Pleaseissue "Provide Feedback" with details Este erro será exibido se não forpossível excluir o arquivo ou o instantâneo do serviço por causa de um erro doservidor.

Reporte esse problema à Oracle usando o comando Feedback ou o recurso FornecerFeedback.

Códigos de Saída


Invalid file: FILE_NAME Este erro será exibido se o arquivo ou o instantâneoque você deseja excluir ou do qual deseja fazer download não existir no serviço ou se onome do arquivo não estiver no formato necessário.

Use o comando listfiles para verificar o nome do arquivo e o seu local.

Recreate is running for a long time. Please contact support Esteerro será exibido se a operação de recriação iniciada não for concluída em uma hora.


Reset service is running for a long time. Please contact supportEste erro será exibido se a operação de redefinição do serviço iniciada não forconcluída em uma hora.


Cannot perform operation. Another instance is in progress.Please try after some time Este erro será exibido se você tentar executar ocomando copysnapshotfrominstance quando outra instância desse comandoestiver ativa.

Aguarde o comando copysnapshotfrominstance ser concluído antes de tentarexecutá-lo novamente.

Cannot perform operation. Another maintenance script is inprogress. Please try after some time Este erro será exibido se você tentarexecutar o comando copysnapshotfrominstance, recreate ou resetservicequando o processo de manutenção diária ou de redefinição do serviço estiver emexecução.

Execute novamente a operação depois que o processo de manutenção ou redefiniçãoterminar.

Login to source instance failed: SOURCE_URL Este erro será exibido se outilitário não conseguir estabelecer conexão com o ambiente de origem para iniciar ocomando copysnapshotfrominstance

Verifique se as credenciais, o domínio de identidade e o URL usados para acessar oambiente de origem são válidos.

Internal server error. Copy snapshot from source instancefailed. Please issue "Provide Feedback" with details Este erro seráexibido quando o utilitário encontrar uma falha inesperada durante a execução doprocesso copysnapshotfrominstance.


Internal server error. Please issue "Provide Feedback" withdetails Este erro é exibido para indicar várias condições internas do servidor queexigem ações corretivas da Oracle.


Snapshot SNAPSHOT_NAME already exists. Please delete thesnapshot and rerun the command Este erro é exibido quando você fazdownload ou upload de um instantâneo para um local onde existe outro instantâneocom esse mesmo nome.

Códigos de Saída


Exclua ou remova o instantâneo existente e tente executar o comando novamente.

Error in extracting the snapshot. Please retry with a propersnapshot Este erro será exibido se o utilitário não conseguir extrair o conteúdo doinstantâneo ao executar o comando importsnapshot.

Verifique se o instantâneo é válido.

Internal server error. Unable to open file for write. Pleaseissue "Provide Feedback" with details Este erro será exibido se algum erroocasionar a criação ou a atualização de arquivos CSV, por exemplo, durante a geraçãodo Relatório de Auditoria.


No matching records found, please select a different date rangeEste erro será exibido se você executar o comando userauditreport a fim de geraro Relatório de Auditoria referente a um intervalo de datas para o qual dados deauditoria não estejam disponíveis.

Especifique um intervalo de datas válido e execute novamente o comandouserauditreport. Observe que o serviço mantém um histórico de auditoriasomente dos últimos 120 dias.

File with same name exists: FILE_NAME, please choose a differentfilename Este erro será exibido se um relatório com o nome de Relatório deAuditoria especificado existir no serviço.

Exclua o arquivo existente do serviço ou especifique outro nome de arquivo e executenovamente o comando userauditreport.

Operation failed with status $1. Please issue "Provide Feedback"Esta mensagem indica um erro interno do servidor que faz com que o processo deredefinição ou recriação do serviço falhe.


EPMCSS-20643: Failed to add users. File FILE_NAME.csv is notfound. Please provide a valid file name. Esse erro será exibido se oarquivo CSV especificado que contém informações sobre os usuários a seremadicionados não estiver disponível na caixa de entrada.

Use o comando listfiles para verificar o nome do arquivo e o seu local. Se oarquivo não estiver na caixa de entrada, use o comando uploadfile para fazer uploaddo arquivo.

EPMCSS-20644: Failed to remove users. File FILE_NAME.csv is notfound. Please provide a valid file name. Esse erro será exibido se oarquivo CSV especificado que contém informações sobre os usuários a seremexcluídos não estiver disponível na caixa de entrada.


20645: Failed to assign role for users. Invalid role name role.Please provide a valid role name. Esse erro será exibido se a funçãoespecificada no arquivo CSV não for suportada.

Verifique se o nome de função especificado no arquivo é Service Administrator,Power User, User ou Viewer.

Códigos de Saída




Service Unavailable O serviço não está disponível por causa do Erro HTTP 404.

Verifique a disponibilidade do serviço acessando-o em um navegador no computadorno qual você está executando o utilitário. Se o serviço estiver desativado por algummotivo, aguarde alguns minutos e faça uma nova tentativa ou entre em contato com osuporte Oracle.

Read/Write timeout Este erro será exibido se o tempo limite do soquete do clientefor atingido (o tempo limite do soquete é 15 minutos) durante uma operação deleitura/gravação por causa de problemas de rede lenta ou firewall.

Execute novamente o comando que falhou quando o throughput da rede estiver alto.Se a falha resuItar das configurações de firewall, entre em contato com oAdministrador da Rede.

Erros do Código de Saída 7O utilitário exibirá este erro se não conseguir executar um comando. A mensagem deerro, por exemplo, Invalid command, especifica por que o erro ocorreu.

O EPM Automate não oferece suporte a proxies que exigemautenticação As configurações de proxy no seu computador são definidas paraautenticação com um servidor proxy para que o seu navegador possa acessar aInternet.

Para autenticação no servidor proxy, especifique uma senha, um domínio e um nomede usuário de servidor proxy (ou use um arquivo de senha criptografada contendo asenha do servidor proxy) no comando de login.

Unable to open password file FILE_NAME Arquivo inválido de senhacriptografada; por exemplo, PASSWORD_FILE.EPW. O utilitário não encontrou oarquivo no local especificado ou o arquivo não está no formato necessário.

Verifique o nome e o caminho do arquivo. Se não for possível analisar o arquivo porcausa do formato inválido, use o comando encrypt para recriá-lo.

Unable to parse password file FILE_NAME O utilitário não conseguiuanalisar o arquivo de senha criptografada por causa do formato inválido ou porque elefoi corrompido.

Use o comando encrypt para recriar o arquivo.

Unable to connect to URL. Root cause MESSAGE Este erro será exibido senão for possível estabelecer uma conexão por causa de um URL incorreto. Amensagem exibida como a causa-raiz descreve a falha subjacente resultante daconfiguração de um URL incorreto.

• Verifique se você está usando uma URL válida

• Se a sua configuração de proxy requerer a autenticação no servidor proxy paraconexão com a internet, especifique uma senha, um domínio e um nome deusuário do servidor proxy (ou use um arquivo de senha criptografada contendo asenha do servidor proxy) para acessar o sistema. Entre em contato com oAdministrador da Rede se precisar de assistência.

Códigos de Saída


Unable to connect to URL Unsupported Protocol Ocorreu uma falha nocomando login porque a URL especificada usa um protocolo não suportado. Amensagem de erro associada identifica esse protocolo.

Verifique se a URL que você está usando com o comando login utiliza o protocoloseguro (HTTPS).

Session is not authenticated. Please execute the “login” commandbefore executing any other command Você tentou executar um comandoantes de estabelecer uma sessão usando o comando login.

Execute o comando login para estabelecer uma conexão segura com um ambienteantes de tentar executar outros comandos.

Invalid parameter Esta mensagem indica um erro no uso de um comandocausado por uma sequência incorreta de parâmetros do comando ou pela ausência dealguns valores de parâmetro necessários.

Verifique e corrija os parâmetros do comando e a sequência na qual eles estãoespecificados.

O comando COMMAND_NAME não é suportado por SERVICE_TYPE O utilitárionão pôde executar o comando para o serviço com o qual você está conectado porque oserviço não oferece suporte ao comando.

Consulte Referência de Comando para obter listas de comandos suportados pelostipos de serviço.

File does not exist in location: PATH O utilitário não conseguiuencontrar o arquivo que você deseja processar, por exemplo, usando o comandoupload ou replay.

Verifique se o nome e o caminho do arquivo estão corretos.

Unable to open file for read: PATH O utilitário não conseguiu ler o arquivoespecificado.

Verifique se o arquivo está no formato necessário. Verifique se o usuário que estáexecutando o utilitário tem acesso de leitura ao arquivo.

Unable to open file for write: PATH O utilitário não conseguiu gravar noarquivo especificado.

Verifique se o arquivo não está bloqueado por outro processo. Verifique se o usuárioque está executando o utilitário tem acesso de gravação ao arquivo.

Invalid command O utilitário encontrou um comando não suportado.

Verifique se o utilitário suporta o comando; além disso, verifique se o nome docomando foi digitado corretamente.

Invalid date format O utilitário encontrou um formato de data inválido.

Especifique as datas de geração de relatório em um formato suportado.

FROMDATE DATE cannot be greater than TODATE DATE O utilitárioencontrou uma data de término anterior à data de início.

Verifique se a data final no intervalo de datas especificado é posterior à datainicial.

Exceeded maximum number of feedbacks (6) for a day Este erro éexibido quando você excede a quantidade de feedback que pode ser enviada com ocomando feedback.

Códigos de Saída


File with the same name already exists in the download pathPATH. Please delete the file and rerun the command Este erro éexibido quando você tenta fazer download de um arquivo para um local onde já existeoutro com o mesmo nome.

Exclua, renomeie ou mova o arquivo existente e execute o comando novamente.

File is empty: PATH Este erro será exibido se o arquivo de reprodução não tiverqualquer conteúdo.

Verifique se o arquivo de reprodução (arquivo CSV) lista as credenciais (nome deusuário e senha), bem como o nome dos arquivos HAR que deverão ser usados paraexecutar o comando replay.

Não é possível criptografar a senha porque não é possívelresolver o host local. Certifique-se de que os nomes de hostsestejam mapeados de forma adequada para endereços IP Esse erro seráexibido se o utilitário não conseguir resolver a definição de host local para umendereço MAC porque o arquivo de hosts do computador contém um nome deservidor, em vez de localhost, para o endereço 127.0.0.1.

Verifique se o arquivo de hosts especifica localhost como o nome do servidor para127.0.0.1


Invalid credentials Este erro é exibido quando o nome de usuário ou a senhausada com o comando login está incorreta.

Especifique credenciais válidas para o ambiente ao qual você está tentando seconectar.

Authentication failed while executing command. Please retry Esteerro é exibido quando a autenticação básica falha durante a execução de um comandodiferente de login. Este erro também poderá ocorrer para chamadas HTTP quandohouver várias tentativas de executar um comando (até três vezes).


Internal server error MESSAGE Este erro será exibido se o utilitário encontrarexceções desconhecidas não relacionadas a conexões HTTP. Inclui os erros de servidor503 e 500.

Unable to connect to URL: MESSAGE Este erro será exibido quando o servidornão estiver disponível. A mensagem de erro indica a exceção que causou a falha docomando.

Se o servidor não estiver disponível, entre em contato com o Suporte Oracle. Se amensagem indicar problemas com a URL, verifique se a URL que você está usando éválida.

Execução do EPM Automate UtilityÉ necessário ser um Administrador de Serviço para executar tarefas com o EPMAutomate Utility.

Como Gerar o Arquivo de Log de Depuração

O Suporte Oracle solicitará um arquivo de log de depuração da sessão para solucionarproblemas encontrados ao executar o EPM Automate Utility. O utilitário suporta aopção -d para gerar mensagens de depuração, que poderão, então, ser redirecionadas

Execução do EPM Automate Utility


para um arquivo usando a diretiva >. Você pode criar um arquivo de depuração paraum comando ou um arquivo de execução em lote ou script que contenha várioscomandos.

Uso: epmautomate command [command_parameters] -d > log_file 2>&1

Exemplo do Windows: epmautomate downloadfile "Instantâneo deArtefato" -d > C:\logs\download_log.txt 2>&1

Exemplo do Linux: epmautomate.sh downloadfile "Instantâneo deArtefato" -d > ./logs/download_log 2>&1

Windows

Antes de executar o EPM Automate Utility, verifique se você tem acesso ao ambienteno computador no qual está executando o utilitário.

Para executar o EPM Automate Utility em um cliente Windows:

1. Clique em Iniciar, Todos os Programas, EPM Automate e Launch EPM Automate.O prompt de comando do EPM Automate é exibido.

2. Opcional: Navegue até o diretório no qual você deseja executar operações usandoo EPM Automate Utility.

3. Opcional: Gere um arquivo de criptografia de senha. Use esse arquivo parainformar uma senha criptografada a fim de iniciar uma sessão.

epmautomate encrypt P@ssword1 myKey C:/mySecuredir/password.epw

4. Inicie uma sessão como o Administrador do Serviço. Use um comando como oseguinte:

• Usando uma senha não criptografada:

epmautomate login serviceAdmin P@ssword1 https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

• Usando uma senha criptografada:

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

5. Insira os comandos para executar as tarefas desejadas. Consulte um dos tópicos aseguir para obter uma descrição dos comandos, do seu uso e exemplos.






Consulte Códigos de Saída para obter informações sobre o status de execução doscomandos.

6. Saia do ambiente. Use o seguinte comando:



epmautomate logout

Linux

Nota:

Verifique se JAVA_HOME está definido na variável PATH de seuarquivo .profile ou como uma variável de ambiente de shell.

Para executar o EPM Automate Utility em um cliente Linux:

1. Abra uma janela de terminal e navegue até o diretório onde você instalou o EPMAutomate Utility.

2. Opcional: gera um arquivo de criptografia de senha. Você usa o arquivo decriptografia de senha para passar uma senha criptografada, em vez de uma senhanão criptografada, para iniciar uma sessão.

epmautomate encrypt P@ssword1 myKey ../misc/encrypt/password.epw

3. Inicie uma sessão como o Administrador do Serviço. Use um comando como oseguinte:

• Usando uma senha não criptografada:

./bin/epmautomate.sh login serviceAdmin P@ssword1 https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

• Usando uma senha criptografada:

./bin/epmautomate.sh login serviceAdmin ../misc/encrypt/password.epw https://test-cloudpln.pbcs_us1.oraclecloud.com myIdentityDomain

4. Insira os comandos para executar as tarefas desejadas. Consulte um dos tópicos aseguir para obter uma descrição dos comandos, do seu uso e exemplos.






Consulte Códigos de Saída para obter informações sobre o status de execução doscomandos.

5. Saia do ambiente. Use o seguinte comando:

./bin/epmautomate.sh logout

Execução de Várias Instâncias do UtilitárioAs seguintes opções estão disponíveis para executar várias instâncias:



• Executar várias instâncias para um ambiente a partir de um diretório; porexemplo, C:\Oracle\EPM Automate\bin. Nesse caso, ao fazer logout de umainstância, você também se desconecta automaticamente de outras instâncias. Asatividades iniciadas com o utilitário continuam sendo executadas até suaconclusão no ambiente mesmo que você faça logout. Você precisa fazer loginnovamente para iniciar novas atividades.

Nota: Você não pode executar várias instâncias em diferentes ambientes apartir do mesmo diretório.

• Execute as instâncias do EPM Automate Utility a partir de diretórios separados.Nesse caso, cada instância do utilitário funciona de forma independente; ao fazerlogout de uma instância, você não se desconecta da outra.

Por exemplo, você precisa atualizar simultaneamente o cubo do aplicativoPlanning em https://cloudpln.pbcs.us1.oraclecloud.com e emhttps://testcloudpln.pbcs.us1.oraclecloud.com. Nesse cenário, vocêpode executar o utilitário em diretórios separados; por exemplo, em C:/scripts/MyService, para se conectar com o primeiro ambiente, e em C:/scripts/MyServicetest, para se conectar com o segundo ambiente, e deveexecutar o comando cuberefresh.



3Exemplos de Cenários de Execução de

Comandos

• Exemplos de Cenários para Todos os Serviços

• Exemplos de Cenários para o Oracle Planning and Budgeting Cloud, OracleEnterprise Planning and Budgeting Cloud, Oracle Financial Consolidation andClose Cloud e Oracle Tax Reporting Cloud

• Exemplos de Cenários do Oracle Account Reconciliation Cloud

• Exemplos de Cenários do Oracle Profitability and Cost Management Cloud

Exemplos de Cenários para Todos os ServiçosOs cenários a seguir ilustram uma sequência típica de comandos que podem serusados para executar operações específicas nos serviços do Oracle EnterprisePerformance Management Cloud.

• Fazer Backup de Instantâneos de Aplicativo em um Computador

• Criar e Provisionar Usuários

• Importar Dados no Gerenciamento de Dados, Executar uma Regra deCarregamento de Dados e Exportar Dados para o Planning

• Contar o Número de Usuários Provisionados

• Criar Relatórios de Auditoria de Usuários Provisionados

• Automatizar os Downloads do Relatório de Atividade para um ComputadorLocal

• Download de Logs de Acesso a Partir de um Ambiente

• Automatizar a Clonagem de Ambientes

• Clonar um Ambiente

• Remover Arquivos Desnecessários de um Ambiente

• Localização e Download de Arquivos de um Ambiente

Os cenários anteriores usam uma sequência de comandos para concluir váriasatividades com o EPM Automate Utility. Eles usam as seguintes credenciais fictíciaspara conexão com um ambiente:

• Nome de usuário: serviceAdmin

• Arquivo de senha: C:/mySecuredir/password.epw

Exemplos de Cenários de Execução de Comandos 3-1

Esse arquivo é criado manualmente. Consulte o comando encrypt.

• URL do Serviço: https://test-cloud-pln.pbcs.us1.oraclecloud.com

• Domínio de identidade: myIdentityDomain

Fazer Backup de Instantâneos de Aplicativo em um ComputadorEste cenário explica como automatizar o processo de backup do instantâneo criadodurante a manutenção diária do serviço em um computador local.

Crie um arquivo de lote (.bat) ou shell (.sh) contendo um script semelhante aoseguinte para automatizar os downloads de instantâneos. O exemplo de script paraWindows a seguir trata estas atividades.

• Faz download do instantâneo do aplicativo (Instantâneo de Artefato)criado durante a janela de manutenção

• Renomeia o instantâneo submetido a download acrescentando um timestamp

• Mantém 10 backups excluindo o backup mais antigo, se necessário

Nota:

Se você adaptar esse script para seu uso, modifique os valores dos parâmetrosSET url, SET user e SET NumberOfBackups conforme necessário.

Consulte Automação da Execução de Scripts para obter informações sobre comoprogramar o script usando o Agendador de Tarefas do Windows.

@echo offrem Sample script to download and maintain 10 maintenance backupsrem Update the following three parameters

SET url=https://test-cloud-pln.pbcs.us1.oraclecloud.comSET [email protected] NumberOfBackups=10SET password=%1SET SnapshotName=Artifact Snapshot

rem EPM Automate commandsCD /D %~dp0

call epmautomate login %user% %password% %url%IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate downloadfile "%SnapshotName%"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate logoutIF %ERRORLEVEL% NEQ 0 goto :ERROR

rem Renames the downloaded artifacts, keeps the last 10 backups

Set Timestamp=%date:~4,2%_%date:~7,2%_%date:~10,4%_%time:~1,1%%time:~3,2%%ren "%SnapshotName%.zip" "%SnapshotName%_%Timestamp%.zip"

SET Count=0FOR %%A IN ("%SnapshotName%*.*") DO SET /A Count += 1

Exemplos de Cenários para Todos os Serviços


IF %Count% gtr %NumberOfBackups% FOR %%A IN ("%SnapshotName%*.*") DO del "%%A" && GOTO EOF

:EOF

echo Scheduled Task Completed successfullyexit /b %errorlevel%:ERROR

echo Failed with error #%errorlevel%.exit /b %errorlevel%

Criar e Provisionar UsuáriosNeste cenário, você executa uma sequência de comandos para concluir estas etapas:

• Entre no ambiente como um Administrador do Serviço.

• Exporte as informações de Grupos e Filiação como Membro do ambiente paraexample_snapshot.zip. Esse discussão pressupõe que você exportouanteriormente os artefatos de Grupos e Filiação como Membro usando Migraçãopara criar example_snapshot.zip.

• Faça download do instantâneo (example_snapshot.zip) em um diretóriolocal.

• Exclua o instantâneo (example_snapshot.zip) do ambiente.

• Saia do ambiente.

• Extraia o conteúdo do example_snapshot.zip.

• Acrescente informações sobre novos usuários ao HSS-Shared Services\resource\External Directory\Users.csv no formatoNome,Sobrenome,E-mail,Log-in do Usuário.

Para obter informações detalhadas, consulte Importação de um Lote de Contas deUsuário em Introdução ao Oracle Cloud.

• Acrescente informações sobre atribuições de função de novos usuários (noformato Nome,Sobrenome,E-mail,Log-in do Usuário) aos arquivos de funçõesadequados.

A atribuição de usuário para cada função de domínio de identidade deve serespecificada em um arquivo separado disponível em HSS-Shared Services\resource\External Directory\Roles. Por exemplo, a atribuição à funçãoAdministrador do Serviço deve ser acrescentada ao <service_name> ServiceAdministrator.csv, enquanto as atribuições à função Visualizador devem seracrescentadas ao HSS-Shared Services\resource\External Directory\Roles\<service_name> Viewer.csv.

Para obter informações detalhadas, consulte Atribuição de Uma Função a VáriosUsuários em Introdução ao Oracle Cloud.

• Recrie example_snapshot.zip compactando o diretório HSS-SharedServices e seu conteúdo.

• Entre no ambiente como um Administrador do Serviço que também tem a funçãoAdministrador do Domínio de Identidade.



• Faça upload do example_snapshot.zip modificado no ambiente.

• Importe example_snapshot.zip no ambiente.

• Exclua do ambiente o example_snapshot.zip carregado.

• Saia.

Nota:

Você pode automatizar esse cenário escrevendo um script personalizado queconclua estas tarefas:

• Descompactar example_snapshot.zip

• Acrescentar informações de usuário a Users.csv

• Acrescentar atribuições de função a arquivos

• Compactar HSS-Shared Services e seu conteúdo para recriarexample_snapshot.zip

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate exportsnapshot example_snapshotepmautomate downloadfile "example_snapshot.zip"epmautomate deletefile "example_snapshot.zip"epmautomate logout

/* Custom code to extract the contents of example_snapshot.zip

/* Custom code to append new user information to HSS-Shared Services\resource\External Directory\Users.csv /* Optional: Custom code to append role information to the appropriate role file(s) in HSS-Shared Services\resource\External Directory\Roles\/* Custom code to zip HSS-Shared Services and its contents as example_snapshot.zip */

epmautomate login serviceAdmin example_dom_pwd https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate uploadfile "example_snapshot.zip"epmautomate importsnapshot example_snapshot userPassword=Password1 resetPassword=trueepmautomate deletefile example_snapshot.zipepmautomate logout

Nota: O valor que você especifica para userPassword (Password1 nocomando anterior) será definido como a senha inicial de novos usuários.Defina o valor de resetPassword como true para forçar os novos usuáriosa redefinir a senha no primeiro logon. Consulte importsnapshot para obterdetalhes.

Contar o Número de Usuários ProvisionadosEste cenário explica como automatizar o processo de geração do Relatório deProvisionamento para contar o número de usuários em um ambiente.

Crie provisionedUsersCount.bat copiando o script a seguir para contar e listaros usuários identificados no relatório.



Nota:

Os parâmetros de entrada para execução desse script são username,password/password_file, service_url, identity_domain eprovision_report_file_name.

@echo offset paramRequiredMessage=Syntax: provisionedUsersCount.bat USERNAME PASSWORD/PASSWORD_FILE URL IDENTITY_DOMAIN PROVISION_REPORT_FILE_NAME

if "%~1" == "" ( echo User Name is missing. echo %paramRequiredMessage% exit /b 1 )if "%~2" == "" ( echo Password or Password_File is missing. echo %paramRequiredMessage% exit /b 1 )if "%~3" == "" ( echo URL is missing. echo %paramRequiredMessage% exit /b 1 )if "%~4" == "" ( echo Identity Domain is missing. echo %paramRequiredMessage% exit /b 1 )if "%~5" == "" ( echo Provision Report File Name is missing. echo %paramRequiredMessage% exit /b 1 )call epmautomate.bat login %~1 "%~2" %~3 %~4REM call epmautomate.bat login %~1 "%~2" %~3

if %errorlevel% NEQ 0 exit /b 1 call epmautomate.bat provisionreport "%5"if %errorlevel% NEQ 0 exit /b 1 call epmautomate.bat downloadfile "%5"if %errorlevel% NEQ 0 exit /b 1

set filePath="%cd%\%5"

if exist %filePath% ( SETLOCAL EnableDelayedExpansion set /a lineCount=0 set /a userCount=0 set userHeaderFound=false for /f "tokens=*" %%A in ( 'type %filePath%' ) do ( set /a lineCount+=1 set line=%%A REM Fetch username from provisioning information row if !userHeaderFound!==true ( for /f "delims=," %%i in ("!line!") do ( set userName=%%i



) if NOT !userName! == "" ( if !userCount! gtr 0 if NOT !userName! == !lastUserName! ( set /a userCount+=1 set users[!userCount!]=!userName! ) if !userCount! == 0 ( set /a userCount+=1 set users[!userCount!]=!userName! ) set lastUserName=!userName! ) ) REM Check for headers of provisioning report if "!line!"=="User,Role,Granted through Groups" ( set userHeaderFound=true ) if "!line!"=="User,Roles,Granted Through" ( set userHeaderFound=true ) ) echo Number of Users: !userCount! for /l %%n in (1,1,!userCount!) do ( REM echo !users[%%n]! ) endlocal

) else ( echo Invalid provisioning report file path - %filePath%.)

Criar Relatórios de Auditoria de Usuários ProvisionadosEste cenário explica como automatizar o processo de criar um relatório de auditoriapara usuários provisionados. Esse relatório mostra os usuários e funções ou gruposassociados que mudaram desde da última vez que o relatório foi gerado. Para criar umrelatório de auditoria, execute esse script diariamente.

Crie provisioningAuditReport.bat copiando o script a seguir. Esse script emlote do wrapper chama o script do PowerShell provisioningAuditReport.ps1, ocódigo de origem para o qual é fornecido mais adiante nesse cenário.

Nota:

• Os parâmetros de entrada para executar esse script são username,password ou password_file, service_url e identity_domain.

• Para evitar quebras de linha e informações de cabeçalho que tornarão essescript não utilizável, copie o script de Versão em HTML deste tópico.

@echo offset paramRequiredMessage=Syntax: provisioningAuditReport.bat USERNAME PASSWORD/PASSWORD_FILE URL IDENTITY_DOMAIN

if "%~1" == "" ( echo User Name is missing.



https://docs.oracle.com/cloud/latest/epm-common/CEPMA/sample_script_6_provisioning_audit.htm

echo %paramRequiredMessage% exit /b 1 )if "%~2" == "" ( echo Password or Password_File is missing. echo %paramRequiredMessage% exit /b 1 )if "%~3" == "" ( echo URL is missing. echo %paramRequiredMessage% exit /b 1 )

PowerShell.exe -File provisioningAuditReport.ps1 %*

provisioningAuditReport.bat chama provisioningAuditReport.ps1, quevocê cria copiando o script a seguir.

provisioningAuditReport.ps1 cria o relatório de auditoria dos usuáriosprovisionados. Coloque-o no mesmo diretório em queprovisioningAuditReport.bat está localizado.

$username=$args[0]$password=$args[1]$url=$args[2]$identitydomain=$args[3]

$date=$(get-date -f dd_MM_yy_HH_mm_ss)$datedefaultformat=$(get-date)$logdir="./logs/"$logfile="$logdir/epmautomate-provisionauditreport-" + $date + ".log"$reportdir="./reports/"$provisionreport="provreport-audittest-" + $date + ".csv"$provisionreporttemp="./provreport-audittest-temp.csv"$provisionreportunique="./provreport-audittest-unique.csv"$provisionreportbaselineunique="./provreport-audittest-baseline-unique.csv"

function EchoAndLogMessage{ $message=$args[0] echo "$message" echo "$message" >> $logfile}

function Init{ $logdirexists=Test-Path $logdir if (!($logdirexists)) { mkdir $logdir 2>&1 | out-null }

$logfileexists=Test-Path $logfile if ($logfileexists) { rm $logfile 2>&1 | out-null }

$reportdirexists=Test-Path $reportdir if (!($reportdirexists)) { mkdir $reportdir 2>&1 | out-null



}}

function PostProcess{ rm $provisionreporttemp mv -Force $provisionreportunique $provisionreportbaselineunique}

function ProcessCommand{ $op=$args echo "EPM Automate operation: epmautomate.bat $op" >> $logfile epmautomate.bat $op >> $logfile 2>&1 if ($LASTEXITCODE -ne 0) { echo "EPM Automate operation failed: epmautomate.bat $op. See $logfile for details." exit }}

function RunEpmAutomateCommands{ EchoAndLogMessage "Running EPM Automate commands to generate the provisioning report." ProcessCommand login $username $password $url $identitydomain ProcessCommand provisionreport $provisionreport ProcessCommand downloadfile $provisionreport ProcessCommand deletefile $provisionreport ProcessCommand logout}

function CreateProvisionReportTempFile{ # Loop through iteration csv file and parse Get-Content $provisionreport | ForEach-Object { $elements=$_.split(',') echo "$($elements[0]),$($elements[2])" >> $provisionreporttemp }}

function CreateUniqueElementsFile{ gc $provisionreporttemp | sort | get-unique > $provisionreportunique}

function CheckBaselineAndCreateAuditReport{ $provisionreportbaselineuniqueexists=Test-Path $provisionreportbaselineunique if (!($provisionreportbaselineuniqueexists)) { EchoAndLogMessage "No existing provisioning report, so comparison with a baseline is not possible. Audit report will be created at the next test run." } else { CreateAuditReport }}

function CreateAuditReport{ $auditreport=$reportdir + "auditreport-"+ $date + ".txt" $additions = @()



$deletions = @()

EchoAndLogMessage "Comparing previous provisioning report with the current report." $compare=compare-object (get-content $provisionreportunique) (get-content $provisionreportbaselineunique)

$compare | foreach { if ($_.sideindicator -eq '<=') { $additions += $_.inputobject } elseif ($_.sideindicator -eq '=>') { $deletions += $_.inputobject } }

echo "Provisioning Audit Report for $datedefaultformat" > $auditreport echo "------------------------------------------------" >> $auditreport

if ($additions.count -ne 0) { echo " " >> $auditreport echo "Additions:" >> $auditreport foreach($element in $additions) { echo "$element" >> $auditreport } }

if ($deletions.count -ne 0) { echo " " >> $auditreport echo "Deletions:" >> $auditreport foreach($element in $deletions) { echo "$element" >> $auditreport } }

if (($additions.count -eq 0) -and ($deletions.count -eq 0)) { echo " " >> $auditreport echo "No changes from last audit report." >> $auditreport }

EchoAndLogMessage "Provisioning audit report has been generated: $auditreport."}

InitEchoAndLogMessage "Starting EPMAutomate provisioning audit reporting"RunEpmAutomateCommandsCreateProvisionReportTempFileCreateUniqueElementsFileCheckBaselineAndCreateAuditReportPostProcessEchoAndLogMessage "EPMAutomate provisioning audit reporting completed"

Automatizar os Downloads do Relatório de Atividade para um Computador Local

Neste cenário, você utiliza syncAprReports.bat para fazer o download deRelatórios de Atividade de um ambiente para um computador local. Você podeagendar o arquivo de lote usando o agendador do Windows para automatizar odownload de Relatórios de Atividade. Consulte Uso de Relatórios de Atividade e Logsde Acesso para Monitoramento do Uso em Introdução ao Oracle Enterprise PerformanceManagement Cloud para Administradores para obter informações detalhadas sobre oRelatório de Atividade.



Você cria relatórios syncAprReports.bat manualmente copiando o script fornecidono procedimento a seguir e, em seguida, atualizando as variáveis de conexão. Essescript verifica o ambiente e faz o download apenas dos relatórios mais recentes que osdisponíveis no diretório de download do computador local.

Nota: O script deve ser executado somente a partir de um computadorWindows.

1. Crie um arquivo de lote (.BAT) chamado syncAprReports.bat contendo oscript a seguir e salve-o em um local conveniente, como, por exemplo, C:\automate_scripts.

Nota: Para evitar quebras de linha e informações de cabeçalho que tornarãoesse script não utilizável, copie o script de Versão em HTML deste tópico.

@echo offtitle APRsetlocal DisableDelayedExpansion

REM To hardcode the values in the script replace %1, %2, %3, %4, %5 with the actual values.REM Example:REM set apr_dir="C:\Oracle\apr"REM set username="serviceAdmin"REM set password="C:\mySecuredir\password.epw"REM set url="https://test-cloudpln.pbcs.us1.oraclecloud.com"REM set domain="myIdentityDomain"set apr_dir=%1set username=%2set password=%3set url=%4set domain=%5

setlocal EnableDelayedExpansionset epmautomate_dir=%cd%set lastfile=REM if [%1]==[] goto :usageREM if [%2]==[] goto :usageREM if [%3]==[] goto :usageREM if [%4]==[] goto :usage

set argC=0for %%x in (%*) do Set /A argC+=1if %argC% neq 0 ( if %argC% neq 4 ( if %argC% neq 5 ( goto :usage ) ))goto :login

:usageecho.echo Invalid syntax. Please check the parameters.echo Syntax:echo 1) syncAprReports.bat APR_FolderPath_on_client username password url domain



http://docs.oracle.com/cloud/latest/epm-common/CEPMA/sample_script_4.htm

echo or echo 2) set the parameters in the file and use below syntaxecho syncAprReports.batgoto :end

:loginsetlocal DisableDelayedExpansionREM for /f "delims=" %%i in ('epmautomate login %2 %3 %4 %5') do set result=%%ifor /f "delims=" %%i in ('epmautomate login %username% %password% %url% %domain%') do set result=%%iif "Login successful" neq "%result%" ( echo Login Failed goto :end)

if not exist %apr_dir% (echo.echo apr folder does not exist GOTO :end)cd /D %apr_dir%for /f "delims=" %%D in ('dir /a:d /b /o:-n') do ( REM AFTER: for /f "delims=" %%D in ('dir /a-d /b /s /o:-n') do ( set "lastFile=%%~nD" goto :next)

:nextsetlocal EnableDelayedExpansionecho.echo Most Recent APR on client is %lastFile%

set "output_cnt=0"cd /D %epmautomate_dir%for /F "delims=" %%f in ('epmautomate listfiles') do (

cd /D !apr_dir! set "line=%%f" for /f "tokens=* delims= " %%a in ("!line!") do set line=%%a if "!line:~0,3!" equ "apr" ( if "!line:~-5!" equ ".html" ( if "%lastFile%" lss "!line:~4,19!" ( if "!line:~4,19!" neq "!dirname!" ( set apr_dir=!apr_dir:"=! set /a output_cnt+=1 set "output[!output_cnt!]=!apr_dir!\!line:~4,19!" set "dirname=!line:~4,19!" REM start downloading mkdir "!dirname!" cd /D !dirname! echo downloading !line! set "downloadDir=!apr_dir!\!dirname!" cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) else (



REM start downloading cd /D !dirname! echo downloading !line! set apr_dir=!apr_dir:"=! set "downloadDir=!apr_dir!\!dirname!" cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) ) else ( REM TO-DO ) ) ))

echo.echo %output_cnt% APR's downloadedfor /L %%n in (1 1 !output_cnt!) DO echo !output[%%n]!goto :end

:endcd /D %epmautomate_dir%endlocal

2. Modifique syncAprReports.bat para definir os valores dos parâmetros natabela a seguir. Esses valores são usados para acessar o ambiente com o objetivo defazer o download de Relatórios de Atividade.

Tabela 3-1 Valores de Variáveis a Incluir no syncAprReports.bat

Variável Valor Esperado

set apr_dir=%1 Especifique o diretório no qual será feito o download dos Relatóriosde Atividade.Exemplo: set apr_dir="C:\Oracle\apr"

set username=%2 Um nome de usuário do Oracle Enterprise PerformanceManagement Cloud que é usado para conexão com o ambiente efazer o download de Relatórios de Atividade.Exemplo: set username="ServiceAdmin"

set password=%3 O nome e a localização do arquivo que armazena a senhacriptografada do usuário especificado pela variável username.Você também pode especificar a senha do usuário em texto simples(não recomendado). Consulte o comando encrypt para obterinformações sobre a criação de um arquivo de senha criptografada.

Exemplos:

set password="C:\mySecuredir\password.epw"

set password="P@ssword1"

set url=%4 O URL do ambiente.Exemplo: set url="https://test-cloudpln.pbcs.us1.oraclecloud.com"

set domain=%5 O domínio de identidades que atende ao ambiente.Exemplo: set domain="myIdentityDomain"



3. Utilizando o Agendador do Windows, agende syncAprReports.bat. Consulte Automação da Execução de Scripts para obter as etapas detalhadas.

Download de Logs de Acesso a Partir de um Ambiente

Nesse cenário, você utiliza syncAccessLog.bat para automatizar o processo dedownload de arquivos de log de acesso a partir de um ambiente para um computadorlocal. Você pode agendar o arquivo de lote usando o agendador do Windows paraautomatizar o download dos arquivos de log. Consulte Exibição e Download deRelatórios de Atividades e Logs de Acesso em Introdução ao Oracle EnterprisePerformance Management Cloud para Administradores para obter os processosrelacionados ao download de logs de acesso usando o Gerenciamento de Aplicativos.

Você cria relatórios syncAccessLog.bat manualmente copiando o script fornecidono procedimento a seguir e, em seguida, atualizando as variáveis de conexão. Essescript verifica o ambiente e faz o download apenas dos arquivos de log mais recentesque os disponíveis no diretório de download do computador local. O script deve serexecutado somente a partir de um computador Windows.

1. Crie um arquivo de lote (.BAT) chamado syncAccessLog.bat contendo o scripta seguir e salve-o em um local conveniente, como, por exemplo, C:\automate_scripts.

Nota:

Para evitar quebras de linha e informações de cabeçalho que tornarão essescript não utilizável, copie o script de Versão em HTML deste tópico.

@echo offtitle APRsetlocal DisableDelayedExpansion

REM To hardcode the values in the script replace %1, %2, %3, %4, %5 with the actual values.REM Example:REM set apr_dir="C:\Oracle\apr"REM set username="serviceAdmin"REM set password="C:\mySecuredir\password.epw"REM set url="https://test-cloudpln.pbcs.us1.oraclecloud.com"REM set domain="myIdentityDomain"set apr_dir=%1set username=%2set password=%3set url=%4set domain=%5

setlocal EnableDelayedExpansionset epmautomate_dir=%cd%set lastfile=REM if [%1]==[] goto :usageREM if [%2]==[] goto :usageREM if [%3]==[] goto :usageREM if [%4]==[] goto :usage

set argC=0for %%x in (%*) do Set /A argC+=1if %argC% neq 0 ( if %argC% neq 4 (



https://docs.oracle.com/en/cloud/saas/enterprise-performance-management-common/cepma/sample_script_8_download_files.html

if %argC% neq 5 ( goto :usage ) ))goto :login

:usageecho.echo Invalid syntax. Please check the parameters.echo Syntax:echo 1) syncAccessLog.bat APR_FolderPath_on_client username password url domainecho or echo 2) set the parameters in the file and use below syntaxecho syncAccessLog.batgoto :end

:loginsetlocal DisableDelayedExpansionREM for /f "delims=" %%i in ('epmautomate login %2 %3 %4 %5') do set result=%%ifor /f "delims=" %%i in ('epmautomate login %username% %password% %url% %domain%') do set result=%%i

if not exist %apr_dir% (echo.echo apr folder does not exist GOTO :end)cd /D %apr_dir%for /f "delims=" %%D in ('dir /a:d /b /o:-n') do ( REM AFTER: for /f "delims=" %%D in ('dir /a-d /b /s /o:-n') do ( set "lastFile=%%~nD" goto :next)

:nextsetlocal EnableDelayedExpansionecho.echo Most Recent Access Log on client is %lastFile%

set "output_cnt=0"cd /D %epmautomate_dir%for /F "delims=" %%f in ('epmautomate listfiles') do (

cd /D !apr_dir! set "line=%%f" for /f "tokens=* delims= " %%a in ("!line!") do set line=%%a if "!line:~0,3!" equ "apr" ( if "!line:~-4!" equ ".zip" ( if "%lastFile%" lss "!line:~4,19!" ( if "!line:~4,19!" neq "!dirname!" ( set apr_dir=!apr_dir:"=! set /a output_cnt+=1 set "output[!output_cnt!]=!apr_dir!\!line:~4,19!" set "dirname=!line:~4,19!" REM start downloading mkdir "!dirname!" cd /D !dirname! echo downloading !line! set "downloadDir=!apr_dir!\!dirname!"



cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) else ( REM start downloading cd /D !dirname! echo downloading !line! set apr_dir=!apr_dir:"=! set "downloadDir=!apr_dir!\!dirname!" cd /D %epmautomate_dir% for /f "delims=" %%i in ('epmautomate downloadfile "!line!"') do set result1=%%i move "!line:~24!" "!downloadDir!" > nul echo !result1! REM end downloading ) ) else ( REM TO-DO ) ) ))

echo.echo %output_cnt% access logs downloadedfor /L %%n in (1 1 !output_cnt!) DO echo !output[%%n]!goto :end

:endcd /D %epmautomate_dir%endlocal

2. Modifique syncAccessLog.bat para definir os valores dos parâmetros na tabelaa seguir. Esses valores são usados para acessar o ambiente com o objetivo de fazero download de logs de acesso.

Tabela 3-2 Valores de Variáveis a Incluir no syncAccessLog.bat


set apr_dir=%1 Especifique o diretório no qual será feito odownload de logs de acesso.Exemplo: set apr_dir="C:\Oracle\apr"

set username=%2 Um nome de usuário do Oracle EnterprisePerformance Management Cloud que éusado para conexão com o ambiente e fazero download de logs de acesso.Exemplo: setusername="ServiceAdmin"



Tabela 3-2 (Cont.) Valores de Variáveis a Incluir no syncAccessLog.bat


set password=%3 O nome e a localização do arquivo quearmazena a senha criptografada do usuárioespecificado pela variável username. Vocêtambém pode especificar a senha dousuário em texto simples (nãorecomendado). Consulte o comando encrypt para obter informações sobre acriação de um arquivo de senhacriptografada.

Exemplos:

set password="C:\mySecuredir\password.epw"

set password="P@ssword1"

set url=%4 O URL do ambiente.Exemplo: set url="https://test-cloudpln.pbcs.us1.oraclecloud.com"

set domain=%5 O domínio de identidades que atende aoambiente.Exemplo: setdomain="myIdentityDomain"

3. Utilizando o Agendador do Windows, agende syncAccessLog.bat. Consulte Automação da Execução de Scripts para obter as etapas detalhadas.

Automatizar a Clonagem de AmbientesCrie um arquivo de lote (.bat) ou shell (.sh) contendo um script semelhante aomostrado a seguir para clonar um ambiente. O seguinte exemplo de script paraWindows trata essas atividades no ambiente de destino (clone):

• Estabeleça conexão com o ambiente de destino.

• Prepare o ambiente para aceitar dados da origem.

• Exclua o Instantâneo de Artefato criado durante a última janela demanutenção.

• Copie o Instantâneo de Artefato do ambiente de origem.

• Importe os artefatos do Artifact Snapshot para o destino. Os novos usuárioscriados no domínio de identidades de destino recebem a senha especificada nolugar de IDM_NEW_USER_PWD no script.

• Sair



Nota:

O script a seguir pressupõe que você informará os valores dos parâmetrosneste formato como parte da sua execução: clone usernamepasswordsource URL source identity domain target URLtarget password target identity domain. Por exemplo, [email protected] P@ssw0rd https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain https://test-cloud-pln.pbcs.us2.oraclecloud.com P@ssw0rd2myNewIdentityDomain.

Nota:

O utilitário, durante o processo de importação de artefatos, cria novosusuários e atribui a eles as funções apropriadas no domínio de identidades dedestino. Isso requer que o usuário que executa esse script tenha as funçõesAdministrador de Serviços e Administrador de Domínios de Identidades noambiente de destino.


@echo offSET /A ARGS_COUNT=0 FOR %%A in (%*) DO SET /A ARGS_COUNT+=1 if %ARGS_COUNT% == 0 ( cls echo. echo Welcome to Clone echo Type Clone help and press ^ENTER for help. echo. exit /b 0 ) IF /I %1=="help" goto :HELP REM echo %ARGS_COUNT% if %ARGS_COUNT% NEQ 7 ( goto :HELP )set user=%1set password=%2set url1=%3set domain=%4set url2=%5set tgtPassword=%6set tgtDomain=%7set returnValue=0

CD /D %~dp0echo Login to Target Environmentcall epmautomate login %user% %tgtPassword% %url2% %tgtDomain%IF %ERRORLEVEL% NEQ 0 ( echo Login into target environment failed with error %ERRORLEVEL%. goto :END )

echo Recreating Target Environmentcall epmautomate recreate -f



IF %ERRORLEVEL% NEQ 0 ( echo Recreate failed on target environment with error %ERRORLEVEL%. goto :END )

echo Deleting Old Artifact Snapshot from the Target Environmentcall epmautomate deletefile "Artifact Snapshot" > NUL IF %ERRORLEVEL% NEQ 0 ( IF %ERRORLEVEL% NEQ 8 ( echo deletefile failed on target environment with error %ERRORLEVEL%. goto :END ) )

echo Copying Artifact Snapashot from the Source Environment to Target call epmautomate copysnapshotfrominstance "Artifact Snapshot" %password% %url1% %domain%IF %ERRORLEVEL% NEQ 0 (echo Login into target environment failed with error %ERRORLEVEL%.goto :END)

echo Importing Snapshot into the Target Environmentcall epmautomate importsnapshot "Artifact Snapshot" "userPassword=IDM_NEW_USER_PWD IF %ERRORLEVEL% NEQ 0 ( echo Restore failed on target environment with error %ERRORLEVEL%. goto :END )

echo Logging out from the Target Environmentcall epmautomate logout IF %ERRORLEVEL% NEQ 0 ( echo Logout failed with error %ERRORLEVEL%. goto :END )

echo Clone on target completed:printOnConsoleecho.echo %1echo.

:HELPecho.echo Usage : Clone ^<user name^> ^<Source password^> ^<Source domain^> ^<Source URL^> ^<Target URL^> ^<Target password^> ^<Target domain^>echo All the values are mandatory for clone to executeexit /B 0

:ENDset returnValue=%ERRORLEVEL%exit /B %returnValue%

Clonar um AmbienteVocê pode clonar um ambiente por muitos motivos. Este cenário pressupõe que vocêclonará um ambiente para se proteger contra a perda do serviço. Também pressupõe-se que você esteja usando o instantâneo de aplicativo que foi criado no ambiente deorigem durante a manutenção diária do serviço.



Pré-requisitos

O domínio de identidade usado pelo ambiente que você está clonando (origem) e oambiente que você está criando como o clone (destino) devem usar um conjuntoidêntico de usuários e de atribuições de função.

• Se a origem e o destino residirem no mesmo centro de dados, eles deverãocompartilhar um domínio de identidade.

• Se a origem e o destino não compartilharem um centro de dados, você deverácriar manualmente o conjunto de usuários e as atribuições de função da origem nodomínio de identidade do destino.

Clonagem de um AmbienteEste cenário usa as seguintes informações de origem:

• URL: https://test-cloud-pln.pbcs.us1.oraclecloud.com

• Domínio de Identidade: myprodIdentityDomain

Para clonar um ambiente, você executará comandos para concluir as seguintes etapas:

• Acesse o ambiente de destino onde você deseja colocar o clone com estascredenciais:

– Nome de usuário: serviceAdmin

Pressupõe-se que o serviceAdmin também tenha a função Administradorde Domínios de Identidades, que permite a esse usuário criar os novosusuários referenciados no instantâneo do artefato.

– Arquivo de senha: C:/mySecuredir/password2.epw

Você precisa criar esse arquivo. Consulte o comando encrypt.

– URL: https://test-cloud-pln.pbcs.us2.oraclecloud.com

– Domínio de Identidade: myNewIdentityDomain

• Recrie o ambiente

• Exclua Instantâneo de Artefato se ele estiver presente.

• Copie o Instantâneo de Artefato do ambiente de origem para o ambientede destino.

• Importe os artefatos do Instantâneo de Artefato para o ambiente e crienovos usuários no domínio de identidades.

• Saia

epmautomate login serviceAdmin C:\mySecuredir\password2.epw https://test-cloud-pln.pbcs.us2.oraclecloud.com myNewIdentityDomainepmautomate recreate -fepmautomate deletefile "Artifact Snapshot"epmautomate copysnapshotfrominstance "Artifact Snapshot" C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myprodIdentityDomainepmautomate importsnapshot "Artifact Snapshot" "userPassword=IDM_NEW_USER_PWDepmautomate logout



Remover Arquivos Desnecessários de um AmbienteNeste cenário, você executa uma sequência de comandos para concluir estas etapas:

• Entre no ambiente.

• Liste os arquivos e os instantâneos do ambiente.

• Exclua os arquivos entitymetadata.csv da Caixa de Entrada/Caixa de Saídae Backupsnapshot.zip do ambiente.

• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate listfilesepmautomate deletefile entitymetadata.csvepmautomate deletefile Backupsnapshot.zipepmautomate logout

Localização e Download de Arquivos de um AmbienteEsse cenário explica como automatizar o processo de fazer download de um ou maisarquivos usando uma string de texto como um curinga. O script a seguir permite fazera correspondência da string que você especifica como o valor do parâmetro FILENAMEcom os nomes de arquivo exibidos usando o comando listfiles e, em seguida,fazer download automaticamente dos arquivos que correspondem à string.

Certifique-se de atribuir a string de pesquisa apropriada ao parâmetro FILENAME. Porexemplo, FILENAME="Scheduler Output/epm" corresponderá à stringScheduler Output/epm em relação aos nomes de arquivo na saída do comandolistfiles em seu ambiente para identificar os arquivos a serem baixados.

Os parâmetros de entrada para executar esse script são username, password oupassword_file, service_url e identity_domain.

Nota:

Para evitar quebras de linha e informações de cabeçalho que tornarão essescript não utilizável, copie o script de Versão em HTML deste tópico.

Windows

@echo off setlocal EnableExtensions EnableDelayedExpansion set USERNAME="username" set PASSWORD="password" set URL="url" set IDENTITY_DOMAIN="identity_domain_name"

call epmautomate login %USERNAME% %PASSWORD% %URL% %IDENTITY_DOMAIN% set FILENAME="Scheduler Output/epm" for /f "tokens=*" %%i in ('epmautomate listfiles ^| findstr ^ %FILENAME%') do ( call epmautomate downloadfile "%%i" )call epmautomate logoutendlocal



https://docs.oracle.com/cloud/latest/epm-common/CEPMA/sample_script_7_list_file.htm

Linux/UNIX

#!/bin/sh USERNAME="username" PASSWORD="password" URL="url" IDENTITY_DOMAIN="identity_domain_name"

./epmautomate.sh login $USERNAME $PASSWORD $URL $IDENTITY_DOMAIN FILENAME='Scheduler Output/epm' #echo $FILENAME./epmautomate.sh listfiles | grep "^ $FILENAME" | while read -r line ; do echo "Processing $line" ./epmautomate.sh downloadfile "$line" done./epmautomate.sh logout

Exemplos de Cenários para o Oracle Planning and Budgeting Cloud,Oracle Enterprise Planning and Budgeting Cloud, Oracle FinancialConsolidation and Close Cloud e Oracle Tax Reporting Cloud

• Importar Metadados no Aplicativo

• Importar Dados, Executar um Script de Cálculo e Copiar Dados de um Banco deDados de Armazenamento em Bloco para um Banco de Dados deArmazenamento Agregado

• Exportar e Fazer Download de Metadados e Dados

• Exportar e Fazer Download de Dados de Aplicativo

• Automatizar a Integração de Dados Diária





• URL do Serviço: https://test-cloud-pln.pbcs.us1.oraclecloud.com


Importar Metadados no AplicativoNeste cenário, você executa uma sequência de comandos para concluir estas etapas:

• Entre em um ambiente.

• Carregue o arquivo de metadados accounts.zip.

• Importe os metadados do arquivo accounts.zip para o aplicativo usando o jobaccountMetadata.

Exemplos de Cenários para o Oracle Planning and Budgeting Cloud, Oracle Enterprise Planning and Budgeting Cloud, OracleFinancial Consolidation and Close Cloud e Oracle Tax Reporting Cloud


• Atualize o cubo.

• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate uploadfile accounts.zipepmautomate importmetadata accountMetadata accounts.zipepmautomate refreshcubeepmautomate logout

Importar Dados, Executar um Script de Cálculo e Copiar Dados de um Banco de Dadosde Armazenamento em Bloco para um Banco de Dados de Armazenamento Agregado

Neste cenário, você executa uma sequência de comandos para concluir estas etapas:


• Faça upload de um arquivo data.csv.

• Importe os dados do arquivo data.csv para o aplicativo usando o jobloadingq1data.

• Atualize o cubo.

• Execute a regra de negócios RevenueAllocation implantada para o tipo deplano RollupUSSales com as solicitações em tempo de execução Quarter=Q1Entity=USA para transformar os dados.

• Faça push dos dados para um banco de dados de armazenamento agregadousando o job CampaignToReporting.

• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate uploadfile data.csvepmautomate importdata loadingq1data data.csvepmautomate refreshcubeepmautomate runbusinessrule RevenueAllocation Quarter=Q1 Entity=USAepmautomate runplantypemap CampaignToReporting clearData=trueepmautomate logout

Exportar e Fazer Download de Metadados e DadosNeste cenário, você executa uma sequência de comandos para concluir estas etapas:


• Exporte os metadados para entityData.zip usando o jobexportentitymetadata.

• Exporte os dados do aplicativo para forecastData.zip usando o jobforecastdata.

• Liste o conteúdo da Caixa de Entrada/Caixa de Saída do Planning.

• Fazer download dos arquivos de dados exportados (exportentitydata.zip eforecastdata.zip) da Caixa de Entrada/Saída do Planning para ocomputador local.



• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate exportmetadata exportentitymetadata entityData.zipepmautomate exportdata forecastdata forecastData.zipepmautomate listfilesepmautomate downloadfile entityData.zipepmautomate downloadfile forecastData.zipepmautomate logout

Exportar e Fazer Download de Dados de AplicativoNeste cenário, você executa uma sequência de comandos para concluir estas etapas:


• Criar backups de dados (entitydata.zip e forecastdata.zip).

• Listar os arquivos da Caixa de Entrada/Saída para verificar se os backups estãopresentes.

• Fazer download (entitydata.zip e forecastdata.zip) para umcomputador local.

• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate exportmetadata exportentitymetadata entityData.zipepmautomate exportdata entitydata entitydata.zipepmautomate exportdata forecastdata forecastdata.zipepmautomate listfilesepmautomate downloadfile entityData.zipepmautomate downloadfile forecastData.zipepmautomate logout

Importar Dados no Gerenciamento de Dados, Executar uma Regra de Carregamento deDados e Exportar Dados para o Planning

Nota: Esse cenário não se aplica ao Oracle Enterprise Data ManagementCloud.

Pré-requisitos

• As definições a seguir do Gerenciamento de Dados:

– Uma definição de regra de carregamento de dados denominadaVisionActual

– Definições de períodos Mar-15 a Jun-15

• Um arquivo de dados devidamente formatado (GLActual.dat) que contenhadados.



Importação de Dados para o Gerenciamento de Dados e Execução de umaRegra de Carregamento de Dados

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


• Faça upload de um arquivo GLActual.dat que contenha dados referentes aosperíodos Mar-15 a Jun-15 para a pasta inbox/Vision do Gerenciamento deDados.

• Importe os dados de GLActual.dat para o Gerenciamento de Dados usando aregra de carregamento de dados VisionActual, o período inicial Mar-15, operí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 tabelaintermediária do Gerenciamento de Dados com os dados existentes do Planning.

• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomainepmautomate uploadfile GLActual.dat inbox/Visionepmautomate rundatarule VisionActual Mar-15 Jun-15 REPLACE STORE_DATA inbox/Vision/GLActual.datepmautomate logout

Automatizar a Integração de Dados DiáriaCrie um arquivo de lote (.bat) ou shell (.sh) que contenha um script semelhante aoseguinte para automatizar atividades relacionadas à integração de dados. O seguinteexemplo de script para Windows automatiza a integração diária de dados doaplicativo executando estas atividades:


• Exclua DailyPlanData se ele estiver presente.

• Faça upload de DailyPlanData para o serviço.

• Execute a regra de negócios Clear Plan Targets no tipo de plano Plan1.

• Importe os dados usando o nome de job LoadDailyPlan.

• Execute a regra de negócios Balance Sheet - Plan.

• Execute a regra de negócios Allocate Plan Targets.

• Exclua DailyTarget.zip se ele estiver presente.

• Exporte os dados para DailyTarget.zip usando o nome de jobExportDailyTarget.

• Faça download de DailyTarget.zip para o servidor e acrescenta o timestamp.

• Efetue sign-out do Oracle Planning and Budgeting Cloud.



Nota:

Se você adaptar esse script para seu uso, certifique-se de modificar os valoresdos parâmetros SET url, SET user e SET domain. Além disso, você podemodificar os valores dos parâmetros dataimportfilename,dataexportfilename, importdatajobname, exportdatajobname,br_clear, br_calculatebalancesheet e br_allocatetarget deacordo com seus requisitos.


@echo off

rem Sample Script to demonstrate daily data integration with rem Oracle Planning and Budgeting Cloud Services application.rem This script uploads Plan data, clears target numbers,.rem runs a business rule to calculate balance sheet data, and .rem recalculates target numbers on the Vision demo application

rem Please input the below parametersSET url=https://test-cloud-pln.pbcs.us1.oraclecloud.comSET [email protected] domain=myIdentitydomainSET dataimportfilename=DailyPlanData.csvSET dataexportfilename=DailyTargetSET importdatajobname=LoadDailyPlanSET exportdatajobname=ExportDailyTargetSET br_clear=Clear Plan TargetsSET br_calculatebalancesheet=Balance Sheet - PlanSET br_allocatetarget=Allocate Plan Targets

SET password=%1

rem Executing EPM Automate commands

CD /D %~dp0call epmautomate login %user% %password% %url% %domain%IF %ERRORLEVEL% NEQ 0 goto :ERROR

for /f %%i in ('call epmautomate listfiles') do if %%i==%dataimportfilename% (call epmautomate deletefile %%i)IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate uploadfile %dataimportfilename%IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate runbusinessrule "%br_clear%"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate importdata "%importdatajobname%"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate runbusinessrule "%br_calculatebalancesheet%"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate runbusinessrule "%br_allocatetarget%" "TargetVersion=Baseline"IF %ERRORLEVEL% NEQ 0 goto :ERROR



for /f %%i in ('call epmautomate listfiles') do if %%i=="%dataexportfilename%.zip" (call epmautomate deletefile %%i)IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate exportdata %exportdatajobname% "%dataexportfilename%.zip"IF %ERRORLEVEL% NEQ 0 goto :ERROR

call epmautomate downloadfile "%dataexportfilename%.zip"IF %ERRORLEVEL% NEQ 0 goto :ERROR

rem Section to rename the file

Set Timestamp=%date:~4,2%_%date:~7,2%_%date:~10,4%_%time:~1,1%%time:~3,2%%ren "%dataexportfilename%.zip" "%dataexportfilename%_%Timestamp%.zip"

call epmautomate logoutIF %ERRORLEVEL% NEQ 0 goto :ERROR

:EOFecho Scheduled Task Completed successfullyexit /b %errorlevel%

:ERRORecho Failed with error #%errorlevel%.exit /b %errorlevel%

Exemplos de Cenários do Oracle Account Reconciliation Cloud• Carregar Saldos Pré-formatados em um Período

• Fazer Upload e Importar um Instantâneo de Backup




Esse é um arquivo criado manualmente. Consulte o comando encrypt.

• URL de Serviço: https://test-cloud-arcs.us1.oraclecloud.com

• Domínio de Identidade: myARCSDomain

Carregar Saldos Pré-formatados em um PeríodoNeste cenário, você executa uma sequência de comandos para concluir estas etapas:


• Faça upload dos dados de saldo pré-formatados para o Oracle AccountReconciliation Cloud em C:/Staging/April15Bal.csv, que foi criado comum aplicativo General Ledger de terceiros.

• Importe os dados mapeados de April15Bal.csv para April 2015.

• Exclua April15Bal.csv do Oracle Account Reconciliation Cloud.

Exemplos de Cenários do Oracle Account Reconciliation Cloud


• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-arcs.us1.oraclecloud.commyARCSDomainepmautomate uploadfile “C:/Staging/ARMBalUpload.csv”epmautomate importpremappedbalances “April 2015” ARMBalUPload.csvepmautomate deletefile ARMBalUpload.csvepmautomate logout

Fazer Upload e Importar um Instantâneo de Backup

Pré-requisitos

Foi feito backup de um instantâneo diário (por exemplo, April15FullApp) de todosos artefatos e dados do serviço em um servidor local.

Restauração de Dados e Artefatos

Neste cenário, você executa uma sequência de comandos para concluir estas etapas:

• Conecte-se com um ambiente usando uma conta que tenha as funçõesAdministrador de Serviços e Administrador de Domínios de Identidades.

• Faça upload do instantâneo C:/dailybackups/April15FullApp, submetido abackup, para o serviço.

• Importe os artefatos e os dados de April15FullApp.

• Exclua April15FullApp.

• Saia.

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud-arcs.us1.oraclecloud.com myARCSDomainepmautomate uploadfile “C:/dailybackups/April15FullApp”epmautomate importsnapshot April15FullApp "userPassword=IDM_NEW_USER_PWD"epmautomate deletefile “April15FullApp”mautomate logout

Exemplos de Cenários do Oracle Profitability and Cost ManagementCloud

• Importar Metadados no Aplicativo

• Importar Dados e Executar Regras de Programa

Os cenários anteriores usam uma sequência de comandos para concluir váriasatividades com o EPM Automate Utility. Eles usam as seguintes credenciais fictíciaspara conexão com um ambiente de exemplo:




• URL do Serviço: https://test-cloud.pcmcs.us1.oraclecloud.com

Exemplos de Cenários do Oracle Profitability and Cost Management Cloud



Importar Metadados no AplicativoNeste cenário, você executa uma sequência de comandos para concluir estas etapas:


• Faça upload do arquivo de metadados dimdata1.txt.

• Importe os metadados de dimdata1.txt para o aplicativo BksML12.

• Habilite o aplicativo.

• Saia

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud.pcmcs.us1.oraclecloud.com myIdentityDomainepmautomate uploadfile "c:\profit_data\dimdata1.txt" profitinboxepmautomate loaddimdata BksML12 dataFileName=dimdata1.txtepmautomate enableapp BksML12epmautomate logout

Importar Dados e Executar Regras de ProgramaNeste cenário, você executa uma sequência de comandos para concluir estas etapas:


• Fazer upload do arquivo de dados c:\profit_data\profitdata1.txt paraprofitinbox.

• Fazer upload do arquivo de regras c:\profit_data\rule1.txt paraprofitinbox.

• Carregar dados de profitdata1.txt para o aplicativo BksML12 a fim desubstituir os valores existentes.

• Executar todas as regras.

• Efetuar sign-out.

epmautomate login serviceAdmin C:\mySecuredir\password.epw https://test-cloud.pcmcs.us1.oraclecloud.com myIdentityDomainepmautomate uploadfile "c:\profit_data\profitdata1.txt" profitinboxepmautomate uploadfile "c:\profit_data\rule1.txt" profitinboxepmautomate loaddata BksML12 clearAllDataFlag=True dataLoadValue=”OVERWRITE_EXISTING_VALUES” rulesFileName=”rule1.txt” dataFileName=”profitdata1.txt”epmautomate logout

Automação da Execução de ScriptsO Administrador do Serviço agenda um script no Agendador de Tarefas do Windowsou usa um job cron para automatizar atividades com o EPM Automate Utility.

Para agendar a execução do script do EPM Automate Utility com o Agendador deTarefas do Windows:

1. Clique em Start, Control Panel e Administrative Tools.

Automação da Execução de Scripts


2. Abra Task Scheduler.

3. Selecione Action e, em seguida, Create Basic Task.

4. Informe um nome de tarefa e uma descrição opcional e clique em Next.

5. Em Task Trigger, selecione um agendamento para executar o script e clique emNext.

6. Na próxima tela, especifique outros parâmetros de agendamento e clique em Next.

7. Em Action, verifique se Start a program está selecionado.

8. Em Start a Program, conclua estas etapas:

a. Em Program/script, procure e selecione o script que você deseja agendar.

b. Em Adicionar argumentos (opcional), informe a senha do Administrador doServiço identificado pelo parâmetro de script SET user.

c. Em Começar em (opcional), informe o local em que o EPM Automate Utilityestá instalado; geralmente, C:/Oracle/EPMAutomate/bin.

d. Clique em Próximo.

9. Em Summary, selecione Open the Properties dialog for this task when I clickFinish e clique em Finish.

10. Em General, selecione estas opções de segurança e clique em OK.

• Run whether user is logged in or not

• Run with highest privileges

Monitoramento de Atividades do EPM Automate UtilityPara ajudar você a identificar o status da operação inicializada, o utilitário exibecódigos de status no console no qual o EPM Automate Utility é executado. Consulte Códigos de Saída.

Use o Console de Jobs do Planning para monitorar os jobs executados com o Utilitáriode Automação do EPM. Consulte Gerenciamento de Jobs em Administração do Planningpara Oracle Planning and Budgeting Cloud para obter detalhes.

Monitoramento de Atividades do EPM Automate Utility


Monitoramento de Atividades do EPM Automate Utility


4Como Replicar um Ambiente do EPM Cloud

Este apêndice aborda as etapas envolvidas na configuração de um ambientesecundário do Oracle Enterprise Performance Management Cloud a fim de garantir adisponibilidade do serviço se o centro de dados principal da Oracle permanecerindisponível em decorrência de circunstâncias imprevistas. A criação de um ambientesecundário de um serviço envolve estas etapas:

Nota:

Os procedimentos analisados neste apêndice não se aplicam ao OracleEnterprise Performance Reporting Cloud.

• Configuração da replicação diária de artefatos

• Configuração de Replicações sob Demanda

• Configuração do Ambiente Secundário

Configuração da Replicação DiáriaA Oracle realiza uma manutenção de rotina em cada ambiente diariamente. Duranteessa janela de uma hora de manutenção do serviço, o sistema Oracle cria uminstantâneo de manutenção fazendo backup do conteúdo do ambiente (dados eartefatos existentes, incluindo atribuições de usuário e função do domínio deidentidade). Para replicar o serviço, use o EPM Automate Utility a fim de copiar oinstantâneo de artefatos do ambiente primário para o secundário.

Para configurar a replicação diária do serviço:

1. Crie um arquivo de script que contenha os seguintes comandos do EPM AutomateUtility. Esse script replica o instantâneo do aplicativo do ambiente primário noambiente secundário.

Nota: Certifique-se de alterar o nome de usuário, o arquivo de senha, osnomes de domínio de identidade e as URLs do serviço. Para obter informaçõessobre como criar um arquivo de senha criptografada, consulte o comando encrypt.

REM Sign in to the secondary instanceepmautomate login serviceAdmin secondaryPassword.epw secondary_URL secondaryDomainREM Delete the existing artifact snapshotepmautomate deletefile "Artifact Snapshot"REM Copy the snapshot from the primary instanceepmautomate copysnapshotfrominstance "Artifact Snapshot" primaryPassword.epw primary_URL primaryDomain

Como Replicar um Ambiente do EPM Cloud 4-1

REM Sign out of the secondary instanceepmautomate logout

2. Usando um agendador; por exemplo, o Agendador de Tarefas do Windows,agende a execução do arquivo de script para que ocorra duas horas após o início dajanela de manutenção.

3. Defina horas de início da Janela de Manutenção idênticas nos ambientes primário esecundário. Consulte Definição do Horário de Manutenção do Serviço emIntrodução ao Oracle Enterprise Performance Management Cloud para Administradorespara obter mais informações.

Configuração de Replicações sob DemandaPara reduzir o RPO, você poderá criar instantâneos sob demanda do ambienteprimário e copiá-los para o ambiente secundário. Por exemplo, você pode criar eagendar um script do EPM Automate Utility que é executado a cada seis horas entre asreplicações diárias para reduzir o RPO de 24 para seis horas.

Nota: Durante a criação de instantâneos sob demanda, o ambiente primáriodo serviço é colocado no modo somente leitura por alguns minutos.

Para configurar a replicação sob demanda:

1. Crie um arquivo de script que contenha os seguintes comandos do EPM AutomateUtility. Esse script replica o instantâneo do aplicativo do ambiente primário noambiente secundário.

Nota: Certifique-se de alterar o nome de usuário, o arquivo de senha, osnomes de domínio de identidade e as URLs do serviço. Para obter informaçõessobre como criar um arquivo de senha criptografada, consulte o comando encrypt.

REM Sign in to the primary instanceepmautomate login serviceAdmin primaryPassword.epw primary_URL primaryDomainREM Create a snapshot and then sign outepmautomate exportsnapshot "Artifact Snapshot"epmautomate logoutREM Sign in to the secondary instanceepmautomate login serviceAdmin secondaryPassword.epw secondary_URL secondaryDomainREM Copy the snapshot from the primary instanceepmautomate copysnapshotfrominstance "Artifact Snapshot" primaryPassword.epw primary_URL primaryDomainREM Sign out of the secondary instanceepmautomate logout

2. Usando um agendador; por exemplo, o Agendador de Tarefas do Windows,agende a execução do arquivo de script para que ocorra conforme necessário a fimde atender ao RPO desejado.

Configuração do Ambiente SecundárioConclua este procedimento somente se precisar ativar o ambiente secundário quandoo primário permanecer indisponível por um longo período.

Configuração de Replicações sob Demanda


Para configurar o ambiente secundário:

1. Inicie uma sessão do EPM Automate Utility e conclua estas atividades.

• Conecte-se com o ambiente secundário usando uma conta que tenha as funçõesAdministrador de Serviços e Administrador de Domínios de Identidades.Especifique o nome de usuário, a senha, o nome de domínio e o URL doserviço corretos.

• Recrie o ambiente

• Importe os artefatos do aplicativo e do domínio de identidades a partir doinstantâneo.

• Efetue sign-out.

Para concluir as atividades anteriores, execute os seguintes comandos. Consulte Comandos do EPM Automate Utility para obter informações sobre estes comandos:

epmautomate login serviceAdmin secondaryPassword.epw secondary_URL secondaryDomainepmautomate recreate –fepmautomate importsnapshot “Artifact Snapshot” "userPassword=IDM_NEW_USER_PWD"epmautomate logout

2. Acesse o ambiente secundário e verifique se todos os dados estão disponíveis.

3. Envie o URL do ambiente para todos os usuários.

Configuração do Ambiente Secundário

Como Replicar um Ambiente do EPM Cloud 4-3

Configuração do Ambiente Secundário


APreparação para Executar o Comando

Replay

Esta seção descreve as etapas que os Administradores de Serviço devem concluir antesde executar o comando replay do EPM Automate Utility.

• Sobre o Comando Replay

• Pré-requisitos

• Criação de Arquivos HAR

• Criação de Arquivos de Reprodução

• Geração de Arquivos de Rastreamento

• Exemplo de Sessão de Reprodução

Sobre o Comando ReproduzirO comando replay reproduz o carregamento do Oracle Smart View para Office em umambiente para que seja possível testar o desempenho sob condições de carga pesada, afim de verificar se a experiência do usuário é aceitável quando o serviço está sobdeterminada carga. Por exemplo, você pode testar a experiência do usuário em umambiente de teste sob condições de carga pesada, a fim de garantir que o serviço teráum bom desempenho após a migração do aplicativo do ambiente de teste para o deprodução.

Pré-requisitos• Identifique os formulários que exigem um processamento significativo no

ambiente. Os formulários que envolvem grandes volumes de dados ou queincluem cálculos complexos são bons candidatos. Por exemplo, os formuláriosusados para enviar previsões e os processos envolvidos na criação de relatórios adhoc e estáticos podem acarretar uma carga pesada no serviço.

• Instale o Fiddler se necessário. O EPM Automate Utility requer um arquivo noformato HTTP Archive (HAR) 1.1 que contém o log da interação do seunavegador da Web com o Oracle Smart View para Office. Use o Fiddler para criaresse arquivo. Caso ele não esteja instalado, faça download e instale a versão maisrecente do Fiddler.

• Execute as principais atividades identificadas anteriormente em diversosformulários. Use o Smart View para executar as atividades e o Fiddler paracapturar os detalhes das atividades e exportá-los para arquivos HAR. Consulte Criação de Arquivos HAR para obter detalhes.

Preparação para Executar o Comando Replay A-1

• Crie um arquivo CSV de reprodução que liste as credenciais (nomes de usuário esenhas), bem como o nome dos arquivos HAR a serem executados. Cada linha doarquivo pode conter o nome de usuário e a senha de um usuário exclusivo parasimular várias sessões simultâneas do usuário. Consulte Criação de Arquivos deReprodução para obter detalhes

O usuário cujas credenciais são especificadas em uma linha para executar umarquivo HAR não precisa ser o mesmo que executou a sessão do Smart Viewusada para criar o arquivo HAR. Entretanto, esse usuário deverá ter os direitospara executar essas atividades no ambiente.

Quando você executa o comando usando um arquivo de reprodução, o EPMAutomate Utility executa cada linha desse arquivo em paralelo a fim de submetero serviço a uma carga, de modo que você possa realizar testes para verificar se aexperiência do usuário é aceitável quando o serviço está sob determinada carga.

Consulte Exemplo de uma Sessão de Reprodução a fim de obter as etapas detalhadaspara execução do comando replay.

Criação de Arquivos HARO arquivo HAR captura rastreamentos dos processos do Oracle Smart View paraOffice que são executados no ambiente. Como o Fiddler captura informações sobretodo o tráfego HTTP(S), evite atividades que possam adicionar um rastreamentodesnecessário ao Fiddler durante a criação de arquivos HAR.

Para criar um arquivo HAR:

1. Inicie o Fiddler.

2. Verifique se o Fiddler está configurado para Descriptografar o tráfego HTTPS detodos os processos.

a. Selecione Tools, Fiddler Options e HTTPS.

b. Selecione a opção Decrypt HTTPS traffic, se ela não estiver selecionada.

O Fiddler exibe informações sobre o certificado raiz que ele usa para interceptaro tráfego HTTPS. Em geral, é seguro confiar nesse certificado.

c. Clique em Yes se quiser adicionar o certificado raiz à lista de autoridades decertificação confiáveis; caso contrário, escolha No.

Criação de Arquivos HAR

A-2 Oracle Cloud Como Trabalhar com o EPM Automate para Oracle Enterprise Performance Management Cloud

d. Opcional: Se tiver selecionado No na etapa anterior, você poderá escolherIgnore server certificate errors para suprimir os avisos de segurança do Fiddlerrelacionados à descriptografia do tráfego HTTPS.

e. Clique em OK.

3. Inicie o Smart View e acesse o ambiente cujo rastreamento você deseja capturar.

4. No Smart View, abra os formulários ou execute as atividades que acarretam umacarga de processamento pesada no ambiente.

O Fiddler registra os processos do Smart View que você iniciou.



5. No Fiddler, conclua estas etapas:

a. Selecione File, Export Sessions e, em seguida, All Sessions ouSelected Sessions. Se, ao executar o Fiddler, você estiver conectado aoutros sites, selecione Selected Sessions a fim de escolher as sessõesrelevantes para o ambiente.

b. Em Select Export Format, selecione HTTPArchive v1.1 como o formatode exportação.

c. Clique em Next.

d. Em Export As HTTPArcive v1.1, selecione o diretório onde desejaarmazenar o arquivo e especifique um nome de arquivo.



e. Clique em Save.

Criação de Arquivos de ReproduçãoUm arquivo de reprodução é um arquivo CSV que lista as credenciais (nome deusuário e senha), bem como o nome dos arquivos HAR que deverão ser executadospara carregar o sistema com o comando replay do EPM Automate Utility. Verifique seo nome de usuário e a senha especificados têm os direitos para executar as atividadesincluídas no arquivo HAR.

Quando o comando replay é executado, o EPM Automate Utility executa cada linhado arquivo de reprodução em paralelo, a fim de submeter o serviço a determinadacarga. Por exemplo, se o arquivo de reprodução contiver 10 linhas, o utilitárioreproduzirá 10 sessões, a fim de que você possa executar testes para verificar se aexperiência do usuário é aceitável quando o serviço está sob determinada carga. Cadaatividade incluída no arquivo HAR é executada serialmente.

Consulte Comandos do EPM Automate Utility para obter informações sobre aexecução do comando replay.

Para criar um arquivo de reprodução:

1. Abra o Microsoft Office Excel e inicie uma nova planilha.

2. Insira o nome de usuário, a senha e o local de um arquivo HAR nas Colunas A, B eC, respectivamente, da linha 1.

Repita essa etapa para criar linhas adicionais.

Nota: Você deve especificar o caminho absoluto para o local do arquivo HAR.

3. Salve o arquivo.

4. Em Salvar Como, conclua estas etapas:

a. Selecione o diretório onde deseja armazenar o arquivo de reprodução.

b. Em Nome do Arquivo, especifique um nome e, em Salvar como tipo,selecione CSV (Delimitado por vírgula) (*.csv).

c. Clique em Salvar.

Veja a seguir um exemplo de arquivo de reprodução:

Criação de Arquivos de Reprodução


Geração de Arquivos de RastreamentoAo executar o comando replay, você pode gerar arquivos de rastreamento a fim decompartilhá-los com o Suporte Oracle para a solução de problemas. O Suporte Oracleusa arquivos de rastreamento para entender como o ambiente tratou uma atividade doOracle Smart View para Office.

Use o parâmetro trace=true opcional com o comando replay para gerar arquivos derastreamento no formato XML. Se você usar esse parâmetro, para cada atividade doarquivo HAR, o EPM Automate Utility criará um arquivo de rastreamento que contéma resposta do Smart View para a atividade.

Os arquivos de rastreamento são nomeados como trace-N.xml; por exemplo,trace-1.xml, onde N é um contador que inicia em 1. Se vários arquivos HARidentificados de forma idêntica forem especificados no arquivo de reprodução, outilitário consolidará os arquivos de rastreamento em uma pasta.

Os arquivos de rastreamento relacionados a um arquivo HAR são armazenados emuma pasta no diretório no qual o EPM Automate Utility foi executado. O utilitário criauma pasta para cada arquivo HAR listado no arquivo de reprodução. O utilitário usauma combinação da hora do sistema de servidor e do nome do arquivo HAR atuais noformato YYYY_MM_DD_HH_MM_SS_HAR_FILE_NAME para nomear as pastas. Porexemplo, se o nome do arquivo HAR for forecast1.har, o nome da pasta poderáser 2016_06_08_10_21_42_forecast1.

Exemplo de Sessão de ReproduçãoEsta seção pressupõe o seguinte:

• Você criou os arquivos HAR a seguir. Cada arquivo HAR pode conter o mesmoconjunto de atividades. Consulte Criação de Arquivos HAR para obterinformações detalhadas.

– C:\Oracle\EPM Automate\forecast_vision_plan1.har

– C:\Oracle\EPM Automate\forecast_vision_plan2.har

– C:\Oracle\EPM Automate\forecast_plan2.har

• Você criou o arquivo de reprodução C:\Oracle\EPM Automate\vision_forecast_replay.csv com o seguinte conteúdo (consulte Criaçãode Arquivos de Reprodução para obter detalhes):

epm_default_cloud_admin,Password123,C:\Oracle\EPM Automate\forecast_vision_plan1.harepm_default_cloud_admin,Password123,C:\Oracle\EPM Automate\forecast_vision_plan2.harepm_default_cloud_admin,Password123,C:\Oracle\EPM Automate\forecast_plan2.har

Para executar o comando replay:

1. Em uma janela de Prompt de Comando, navegue até o diretório, por exemplo, C:\Oracle\EPM Automate\bin, onde o EPM Automate Utility está instalado.

2. Conecte-se a um ambiente e execute o comando replay:

epmautomate login service_administrator Password1 https://test-cloud-pln.pbcs.us1.oraclecloud.com myIdentityDomain

Geração de Arquivos de Rastreamento


epmautomate replay "c:\Oracle\EPM Automate\vision_forecast_replay.csv" duration=12 trace=true

O utilitário exibe informações sobre o comando replay no console e encerra oprocessamento após a duração especificada (12 minutos no exemplo anterior). Eletambém cria pastas e arquivos de rastreamento porque o comando anterior inclui oparâmetro trace=true. A ilustração a seguir mostra as informações exibidas paraum exemplo de sessão:

Como o comando foi executado em C:\Oracle\EPM Automate\bin, o utilitárioarmazenou os arquivos de rastreamento nas seguintes pastas. Observe que essaspastas são nomeadas com base nos nomes dos arquivos HAR.

• C:\Oracle\EPM Automate\bin\[email protected]



3. Saia do ambiente:

epmautomate logout

Exemplo de Sessão de Reprodução


Exemplo de Sessão de Reprodução


como trabalhar com o epm automate para oracle enterprise ... · • importar dados de saldo...

Documents