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, primeiro um administrador de TI cria um conector do Oracle Analytics Cloud.
Criar dimensão
Para carregar dimensões em um cubo, adicione um comando Build Dimension.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Insira o aplicativo OAC para o qual você deseja carregar. |
| Banco de dados |
Digite o banco de dados do OAC - ou cube- para carregar. |
| Arquivo de dimensão |
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çar |
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 |
| Aplicação |
Entre no aplicativo OAC. |
| Banco de dados |
Digite o banco de dados do 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 (Limpar dados).
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o aplicativo OAC no qual você deseja limpar os dados. |
| Banco de dados |
Entre no banco de dados da OAC - ou no cubo - para limpar os dados. |
| Opção |
Selecione a palavra-chave que especifica o que você deseja limpar. |
| 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 |
| Aplicação |
Digite o aplicativo OAC no qual você deseja 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 cube- 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 |
| Aplicação |
Digite o aplicativo OAC do qual você deseja excluir. |
| Banco de dados |
Entre no banco de dados OAC - ou cube- para 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 |
| Aplicação |
Digite o aplicativo OAC do qual você deseja excluir. Para excluir uma variável definida no escopo do cubo, deixe em branco. |
| Banco de dados |
Digite o banco de dados - ou cube- para excluir de. 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 |
Desenvolver
Para criar um cubo a partir de uma pasta de trabalho do Microsoft Excel®, adicione um comando Deploy.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o aplicativo OAC no qual você deseja criar o cubo. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- para criar. |
| Pasta de trabalho do Excel |
Digite o arquivo da pasta de trabalho do Excel a partir do qual você criará o cubo. Se você estiver se referindo a um arquivo no servidor, ele deve estar no diretório do usuário. |
| Executar script |
Para executar qualquer script de cálculo incluído 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, caso ele já exista, 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 importará 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 download de artefatos de cubo de uma instância do Essbase® para um diretório local, adicione um comando Download File.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o aplicativo OAC do qual você deseja fazer 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. |
| Descompactar automaticamente |
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 o script MDX
Para executar um script MDX (Multidimensional Expressions, Expressões multidimensionais), adicione um comando Execute MDX Script.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o aplicativo OAC no qual você deseja executar o script. |
| Banco de dados |
Digite o banco de dados OAC - ou o cubo - para executar o script. |
| Script |
Digite o nome do arquivo de script a ser executado, com a 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 MaxL
Este comando não é mais suportado no contêiner do Oracle Analytics, pois a Oracle descontinuou o suporte a esse comando.
- Cadeias sem o comando não poderão mais acessar o comando.
- Cadeias existentes que contêm o comando verão um aviso nos registros.
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 Executar script de relatório.
Observação: Esse comando requer o Essbase versão 21c (versão 21.1) ou superior.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o aplicativo OAC no qual você deseja executar o script. |
| Banco de dados |
Digite o banco de dados OAC - ou cube- 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 a 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 tabular pai-filho, adicione um comando Export Metadata.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o nome do aplicativo OAC do qual você deseja exportar. |
| Banco de dados |
Digite o nome do banco de dados OAC - ou cube- 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 na dimensão, marque essa caixa (opcional). Se você precisar apenas de nomes de membros em um formato pai-filho, deixe a caixa 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 |
| Aplicação |
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 |
Digite o banco de dados - ou cube- 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 do LCM
Para fazer backup dos artefatos do cubo em um arquivo ZIP do Lifecycle Management (LCM), adicione um comando LCM Export.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o aplicativo OAC onde o arquivo reside. 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 você estiver usando como saída em outro comando, deixe em branco. |
| Número de threads |
Se você estiver usando uma exportação paralela, digite 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 do 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 emitirá 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 existentes em uma instância do OAC Essbase®, adicione um comando Listar aplicativos.
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 o comando List Databases.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Insira o aplicativo OAC com os bancos de dados a serem listados. |
Saídas
| Saída |
Tipo de saída |
| Bancos de dados do 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 artefatos de cubo que existem em uma determinada instância, adicione um comando List Files.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o aplicativo OAC com os arquivos a serem listados. Para listar os 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 |
Listar filtros
Para listar os filtros de segurança do Essbase, adicione o comando List Filters.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
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 |
Listar bloqueios
Para listar todos os blocos de dados bloqueados ou objetos relacionados ao cubo, adicione um comando List Locks.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
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 objeto |
Para exibir arquivos e artefatos bloqueados, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Bloqueios do 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 Listar variáveis.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
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 |
| Aplicação |
Digite o nome do aplicativo OAC para o qual você deseja carregar. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- para o qual você deseja 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 cancelar 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 |
Iniciar
Para iniciar um aplicativo ou banco de dados OAC, adicione um comando Start.
Propriedades
| Propriedade |
Detalhes |
| Aplicação |
Digite o nome do aplicativo OAC a ser iniciado. |
| Banco de dados |
Digite o nome do banco de dados - ou cube- a ser iniciado. 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 |
| Aplicação |
Digite o nome do aplicativo OAC a ser interrompido. |
| Banco de dados |
Digite o nome do banco de dados - ou do cubo - 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 |
| Aplicação |
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 cubo- 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 |
Insira 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 |