Para conectar e automatizar o Oracle® Analytics Cloud (OAC) como parte de uma cadeia, adicione uma etapa que inclua um comando de conexão do Oracle Analytics Cloud. Por exemplo:
- Executar cálculos
- Trocar e carregar dados e comandos para administrar o OAC
Para habilitar esses comandos, um administrador de TI primeiro cria um conector do Oracle Analytics Cloud.
Dimensão da construção
Para carregar dimensões em um cubo, adicione um comando Build Dimension .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC para o qual carregar. |
| Banco de dados |
Digite o banco de dados OAC - ou cube- para carregar. |
| Arquivo de dimensões |
Digite o nome do arquivo de criação de dimensão. O caminho completo é desnecessário; presume-se que os arquivos estejam no diretório relevante do aplicativo ou do banco de dados. |
| Arquivo de regras |
Digite o nome do arquivo de regras. O caminho completo é desnecessário; presume-se que os arquivos estejam no diretório relevante do aplicativo ou do banco de dados. |
| Reestruturação |
Selecione a opção de preservação para a reestruturação do esboço. |
| Força |
Para forçar a construção da dimensão sem verificar o contorno, marque a caixa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Script de cálculo
Para calcular um cubo, adicione um comando Calculation Script .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Entre no aplicativo OAC. |
| Banco de dados |
Insira o banco de dados OAC - ou o cubo - para calcular. |
| Arquivo de script |
Digite o nome do script de cálculo, com a extensão de arquivo .csc . O caminho completo é desnecessário; presume-se que os arquivos estejam no diretório relevante do aplicativo ou do banco de dados. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Limpar dados
Para limpar os dados de um cubo, adicione um comando Clear Data .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Entre no aplicativo OAC para limpar os dados. |
| Banco de dados |
Entre no banco de dados OAC - ou no cubo - para limpar os dados. |
| Opção |
Selecione a palavra-chave que especifica o que deve ser limpo. |
| Região |
Digite a expressão multidimensional (MDX) que especifica a região a ser limpa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Criar variável
Para criar uma variável de substituição definida no escopo do aplicativo ou do cubo, adicione um comando Create Variable .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC para criar a variável. Para criar a variável no escopo do cubo, deixe em branco. |
| Banco de dados |
Digite o banco de dados - ou o cubo - para criar a variável. Para criar a variável no escopo do aplicativo, deixe em branco. |
| Nome |
Digite o nome da variável a ser criada. |
| Valor |
Digite o valor da variável a ser criada. |
Saídas
| Saída |
Tipo de saída |
| Variável criada |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Excluir arquivo
Para remover artefatos de cubo do aplicativo, do banco de dados ou do diretório inicial do usuário, adicione um comando Delete File .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC do qual deseja excluir. |
| Banco de dados |
Insira o banco de dados OAC - ou o cubo - do qual deseja excluir. |
| Arquivo |
Digite o nome do arquivo a ser excluído. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Excluir variável
Para excluir uma variável de substituição definida no escopo do aplicativo ou do cubo, adicione um comando Delete Variable .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC do qual deseja excluir. Para excluir uma variável definida no escopo do cubo, deixe em branco. |
| Banco de dados |
Digite o banco de dados - ou o cubo - do qual deseja excluir. Para excluir uma variável definida no escopo do aplicativo, deixe em branco. |
| Arquivo |
Digite o nome da variável a ser excluída. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Implementar
Para criar um cubo a partir de uma pasta de trabalho do Microsoft Excel®, adicione um comando Deploy .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Insira o aplicativo OAC para criar o cubo. |
| Banco de dados |
Digite o nome do banco de dados - ou o cubo - para criar. |
| Pasta de trabalho do Excel |
Insira o arquivo da pasta de trabalho do Excel para criar o cubo. Se estiver se referindo a um arquivo no servidor, ele deve estar no diretório do usuário. |
| Executar script |
Para executar os scripts de cálculo incluídos na pasta de trabalho, marque essa caixa. |
| Criar arquivos |
Para criar artefatos de cubo no diretório de arquivos na instância do serviço de nuvem, marque essa caixa. |
| Recriar aplicativo |
Para recriar o aplicativo se ele já existir, marque essa caixa. |
| Carregar dados |
Para carregar dados de uma pasta de trabalho que contenha uma planilha de dados, marque essa caixa. Caso contrário, o comando importa apenas metadados para o cubo. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Baixar arquivo
Para fazer o download de artefatos de cubo de uma instância do Essbase® para um diretório local, adicione um comando Download File .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC para fazer o download. |
| Banco de dados |
Digite o banco de dados - ou o cubo - para fazer o download. |
| Arquivo |
Digite o nome do arquivo a ser baixado. |
| Descompactação automática |
Para descompactar automaticamente o conteúdo do arquivo, marque essa caixa. Ignorado se o arquivo ZIP contiver mais de um arquivo. |
Saídas
| Saída |
Tipo de saída |
| Arquivo baixado |
Arquivo |
| Tamanho do arquivo baixado |
Inteiro |
| Registros baixados |
Inteiro |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Executar script MDX
Para executar um script de expressões multidimensionais (MDX), adicione um comando Execute MDX Script .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC no qual o script será executado. |
| Banco de dados |
Insira o banco de dados OAC - ou o cubo - para executar o script. |
| Script |
Digite o nome do arquivo de script a ser executado, com uma extensão .msh . |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Executar o script MaxL
Para executar um script MaxL, adicione um comando Execute MaxL Script .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC no qual o script será executado. |
| Banco de dados |
Insira o banco de dados OAC - ou o cubo - para executar o script. |
| Script |
Digite o nome do arquivo de script a ser executado, com uma extensão .msh . |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Executar script de relatório
Para retornar as saídas geradas pela execução de um arquivo de especificação de script de relatório, adicione um comando Execute report script .
Observação: Esse comando requer o Essbase versão 21c (versão 21.1) ou superior.
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC no qual o script será executado. |
| Banco de dados |
Insira o banco de dados OAC - ou o cubo - para executar o script. Compatível apenas com o Essbase versão 21c ou superior. |
| Script |
Digite o nome do arquivo de script a ser executado, com uma extensão .msh . |
| Bloqueio para atualização |
Bloqueia todos os blocos acessados pela especificação do relatório. Desativado por padrão. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Exportar metadados
Para exportar metadados de dimensão em um formato hierárquico pai-filho tabular, adicione um comando Export Metadata .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo OAC do qual exportar. |
| Banco de dados |
Digite o nome do banco de dados OAC - ou do cubo - para exportar. |
| Nome da dimensão |
Digite o nome da dimensão a ser exportada. |
| Mostrar atributos |
Para mostrar atributos além dos nomes de cada membro da dimensão, marque essa caixa (opcional). Se você precisar apenas de nomes de membros em um formato pai-filho, deixe a opção desmarcada. Observação: Os atributos podem levar um tempo significativo para serem exportados. |
| Atributos estendidos |
Se os membros tiverem mais de 10 atributos, marque essa caixa (opcional). Por padrão, somente os 10 primeiros atributos são exibidos. |
Saídas
| Saída |
Tipo de saída |
| Contagem de membros |
Inteiro |
| Membros exportam CSV |
Arquivo |
<!--For example, an output in tabular format with a header record and the corresponding members:
```
Parent Child COMMENT CONSOLIDATION DATASTORAGETYPE DIMSTORAGETYPE FORMULA GENERATIONNUMBER LEVELNUMBER MEMBERSOLVEORDER TIMEBALANCE TIMEBALANCESKIPOPTION TWOPASSCALC ALIAS1 ALIAS2 ALIAS3 ALIAS4 ALIAS5 ALIAS6 ALIAS7 ALIAS8 ALIAS9 ALIAS10 ATTRIBUTE1 ATTRIBUTE2 ATTRIBUTE3 ATTRIBUTE4 ATTRIBUTE5 ATTRIBUTE6 ATTRIBUTE7 ATTRIBUTE8 ATTRIBUTE9 ATTRIBUTE10 UDA1 UDA2 UDA3 UDA4 UDA5 UDA6 UDA7 UDA8 UDA9 UDA10
Measures Measures LABELONLY DENSE 1 3 0 NONE NONE false 評價 メジャー Реестр финансовых результатов Umsätze
Measures Profit + STOREDATA 2 2 0 NONE NONE false 利益 利益
Measures Inventory ~ LABELONLY 2 1 0 NONE NONE false 存貨 棚卸資産
Measures Ratios ~ LABELONLY 2 1 0 NONE NONE false 比率 比率
Profit Margin + STOREDATA 3 1 0 NONE NONE false Gross Margin 毛利 差益 Добавочная стоимость
Profit Total Expenses - STOREDATA 3 1 0 NONE NONE false 總銷費 総出費
Inventory Opening Inventory + STOREDATA "IF(NOT @ISMBR(""Jan"")) ""Opening Inventory""=@PRIOR(""Ending Inventory""); ENDIF ""Ending Inventory"" = ""Opening Inventory"" + ""Additions"" - ""Sales"";" 3 0 0 FIRST NONE false 期初存貨 開始棚卸資産
Inventory Additions ~ STOREDATA 3 0 0 NONE NONE false 追加 追加資産
Inventory Ending Inventory ~ STOREDATA 3 0 0 LAST NONE false 期末存貨 期末棚卸資産
Ratios Margin % + DYNAMICCALC """Margin"" % ""Sales"";" 3 0 100 NONE NONE true 毛利率 差益率
Ratios Profit % ~ DYNAMICCALC """Profit"" % ""Sales"";" 3 0 100 NONE NONE true 利益率 利益率
Ratios Profit per Ounce ~ DYNAMICCALC """Profit"" / @ATTRIBUTEVAL(@NAME(""Ounces""));" 3 0 100 NONE NONE true 每盎司利益 オンス毎利益
Margin Sales + STOREDATA 4 0 0 NONE NONE false Revenue 銷售 売上 Продажи
Margin COGS - STOREDATA 4 0 0 NONE NONE false Cost of Goods Sold 成本 原価 Затраты
Total Expenses Marketing + STOREDATA 4 0 0 NONE NONE false 行銷
Total Expenses Payroll + STOREDATA 4 0 0 NONE NONE false 工資 給与
Total Expenses Misc + STOREDATA 4 0 0 NONE NONE false Miscelleneous 其他 その他 Разное
```
-->
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Obter variável
Para recuperar uma variável de substituição definida no escopo do aplicativo ou do cubo, adicione um comando Get Variable .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC com a variável a ser recuperada. Para recuperar uma variável definida no escopo do cubo, deixe em branco. |
| Banco de dados |
Insira o banco de dados - ou o cubo - com a variável a ser recuperada. Para recuperar uma variável definida no escopo do aplicativo, deixe em branco. |
| Nome |
Digite o nome da variável a ser recuperada. |
Saídas
| Saída |
Tipo de saída |
| Variável |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Exportação de LCM
Para fazer backup dos artefatos do cubo em um arquivo ZIP do Lifecycle Management (LCM), adicione um comando LCM Export .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o aplicativo OAC onde o arquivo está localizado. Para verificar o diretório do usuário, deixe em branco. |
| Nome do arquivo ZIP |
Digite o nome do arquivo compactado para armazenar os arquivos de backup (opcional). |
| Diretório local |
Digite o diretório local onde o arquivo está armazenado. Se estiver usando como saída em outro comando, deixe em branco. |
| Número de linhas |
Se estiver usando uma exportação paralela, insira o número de threads a serem gerados (opcional). |
| Ignorar dados |
Para não incluir dados no backup, marque essa caixa. |
| Sobrescrever |
Para substituir um arquivo de backup existente, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Exportar arquivo ZIP |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Importação de LCM
Para restaurar artefatos de cubo de um arquivo ZIP do Lifecycle Management (LCM), adicione um comando LCM Import .
Propriedades
| Propriedade |
Detalhes |
| Nome do arquivo ZIP |
Digite o nome do arquivo compactado que contém os arquivos de backup. |
| Sobrescrever |
Para substituir um arquivo LCM Export existente no servidor, marque essa caixa. Caso contrário, o comando gera um erro se já existir um arquivo ZIP com o mesmo nome no servidor. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Listar aplicativos
Para listar os aplicativos que existem em uma instância do OAC Essbase®, adicione um comando List Applications .
Propriedades
Nenhum
Saídas
| Saída |
Tipo de saída |
| Aplicativos OAC |
Matriz |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Listar bancos de dados
Para listar os bancos de dados em um determinado aplicativo, adicione um comando List Databases .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Insira o aplicativo OAC com os bancos de dados a serem listados. |
Saídas
| Saída |
Tipo de saída |
| Bancos de dados OAC |
Matriz |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Listar arquivos
Para listar os artefatos de cubo existentes em uma determinada instância, adicione um comando List Files .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Insira o aplicativo OAC com os arquivos a serem listados. Para listar arquivos do diretório inicial no serviço de nuvem, deixe em branco. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- com os arquivos a serem listados (opcional). |
| Tipo de arquivo |
Selecione o tipo de arquivo a ser retornado (opcional). |
| Filtro |
Insira os critérios de filtro dos arquivos a serem retornados, usando a sintaxe glob, como log_*.txt. |
Saídas
| Saída |
Tipo de saída |
| Arquivos OAC |
Matriz |
| Arquivos OAC como CSV |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Filtros de lista
Para listar os filtros de segurança do Essbase, adicione um comando List Filters .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo OAC com os filtros a serem listados. |
| Banco de dados |
Digite o nome do banco de dados com os filtros a serem listados. |
Saídas
| Saída |
Tipo de saída |
| Filtros OAC |
Matriz |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Bloqueios de lista
Para listar todos os blocos de dados bloqueados ou objetos relacionados ao cubo, adicione um comando List Locks .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo OAC com os objetos bloqueados a serem listados. |
| Banco de dados |
Digite o nome do banco de dados - ou do cubo - com os objetos bloqueados a serem listados. |
| Mostrar bloqueios de objetos |
Para exibir arquivos e artefatos bloqueados, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Bloqueios OAC |
Matriz |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Listar variáveis
Para listar as variáveis de substituição definidas no escopo do aplicativo ou do cubo, adicione um comando List Variables .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo com as variáveis a serem listadas. Para listar as variáveis definidas no escopo do cubo, deixe em branco. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- com as variáveis a serem listadas. Para listar as variáveis definidas no escopo do aplicativo, deixe em branco. |
Saídas
| Saída |
Tipo de saída |
| Variáveis OAC |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Carregar dados
Para carregar dados em um cubo, adicione um comando Load Data .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo OAC para o qual será carregado. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- para carregar. |
| Arquivo de dados |
Digite o nome do arquivo de carregamento de dados. O caminho completo é desnecessário; presume-se que os arquivos estejam no diretório relevante do aplicativo ou do banco de dados. |
| Arquivo de regras |
Digite o nome do arquivo de regras. O caminho completo é desnecessário; presume-se que os arquivos estejam no diretório relevante do aplicativo ou do banco de dados. |
| Abortar |
Para interromper o comando em caso de falha, marque essa caixa. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
Início
Para iniciar um aplicativo ou banco de dados OAC, adicione um comando Start .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo OAC a ser iniciado. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- para iniciar. Para iniciar o aplicativo , deixe em branco. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
| 10 |
Erro |
Aplicativo ou banco de dados já iniciado |
Parar
Para interromper um aplicativo ou banco de dados OAC, adicione um comando Stop .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo OAC a ser interrompido. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- a ser interrompido. Para interromper o aplicativo , deixe em branco. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |
| 10 |
Erro |
O aplicativo ou banco de dados já foi interrompido |
Atualizar variável
Para atualizar uma variável de substituição definida no escopo do aplicativo ou do cubo, adicione um comando Update Variable .
Propriedades
| Propriedade |
Detalhes |
| Aplicativo |
Digite o nome do aplicativo OAC com a variável a ser atualizada. Para atualizar uma variável definida no escopo do cubo, deixe em branco. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- com a variável a ser atualizada. Para atualizar uma variável definida no escopo do aplicativo, deixe em branco. |
| Nome |
Digite o nome da variável a ser atualizada. |
| Valor |
Digite o novo valor da variável. |
Saídas
| Saída |
Tipo de saída |
| Variável atualizada |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Argumentos inválidos |
| 3 |
Erro |
Falha geral |