Para se conectar ao Oracle® Enterprise Data Management Cloud Service (EDMCS) como parte de uma cadeia, adicione uma etapa que inclua um comando de conexão Oracle EDMCS. Por exemplo:
- Importar e exportar hierarquias
- Transformar as hierarquias em um formato equilibrado ou geracional
- Automatizar o gerenciamento do EDMCS
Para habilitar esses comandos, um administrador de TI primeiro cria um conector Oracle EDMCS.
Converter arquivo geracional em pai-filho
Para converter uma estrutura de dados geracional em um formato pai-filho - também conhecido como ragged-, use o comando Convert generational file to parent-child (Converter arquivo geracional em pai-filho).
Propriedades
Propriedade |
Detalhes |
Arquivo de entrada |
Digite o arquivo a ser convertido. |
Delimitador |
Selecione o delimitador usado em Arquivo de entrada. |
Possui cabeçalho |
Se o arquivo de entrada contiver uma linha de cabeçalho, marque essa caixa. |
Possui aliases |
Se o arquivo de entrada contiver um alias a ser preservado após o valor pai ou filho, como as colunas de Parent,Alias ou Child,Alias , marque essa caixa. |
Saídas
Saída |
Tipo de saída |
Arquivo pai-filho convertido |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Converter arquivo pai-filho
Para converter uma estrutura de dados pai/filho em um formato ragged generational ou balanced , use o comando Convert parent-child file .
Propriedades
Propriedade |
Detalhes |
Arquivo de entrada |
Digite o arquivo a ser convertido. |
Delimitador |
Selecione o delimitador usado no arquivo de entrada . |
Tipo de hierarquia |
Selecione o tipo de hierarquia para a qual deseja converter o arquivo. |
Nome da coluna pai |
Digite o nome da coluna que contém os valores parent . |
Nome da coluna filho |
Digite o nome da coluna que contém os valores child . |
Saídas
Saída |
Tipo de saída |
Arquivo de hierarquia |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Copiar arquivo entre instâncias
Para copiar um arquivo de um ambiente de origem para o ambiente de destino atual, use o comando Copy File Between Instances . Por exemplo, use este comando para copiar um arquivo de um ambiente de teste para o ambiente de produção.
Propriedades
Propriedade |
Detalhes |
Nome do arquivo de origem |
Digite o nome do arquivo a ser copiado. |
Nome do usuário de origem |
Digite o nome de usuário do ambiente de origem. |
Senha da instância de origem |
Digite a senha do ambiente de origem. Observação: Como alternativa, insira o arquivo de senha gerado pelo EPM Automate em Arquivo de senha de origem. |
Arquivo de senha de origem |
Digite o arquivo de senha do ambiente de origem. Observação: Como alternativa, digite a senha diretamente em Source instance password. |
URL da fonte |
Digite o URL do ambiente de origem. |
Nome do arquivo de destino |
Digite o nome do arquivo copiado no ambiente de destino. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Copiar instantâneo
Para migrar - ou clonar- um ambiente copiando um instantâneo de um ambiente de origem para o ambiente de destino atual, use o comando Copy snapshot . Por exemplo, use esse comando para copiar um snapshot de um ambiente de teste para o ambiente de produção.
Propriedades
Propriedade |
Detalhes |
Nome do instantâneo |
Digite o nome do snapshot a ser migrado. |
Nome do usuário de origem |
Digite o nome de usuário do ambiente de origem. |
Senha da instância de origem |
Digite a senha do ambiente de origem. Observação: Como alternativa, insira o arquivo de senha gerado pelo EPM Automate em Arquivo de senha de origem. |
Arquivo de senha de origem |
Digite o arquivo de senha do ambiente de origem. Observação: Como alternativa, digite a senha diretamente em Source instance password. |
URL da fonte |
Digite o URL do ambiente de origem. |
Domínio de origem |
Digite o domínio do ambiente de origem. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Criar solicitação
Para criar uma nova solicitação Oracle EDMCS, use o comando Create Request .
Propriedades
Propriedade |
Detalhes |
Ver nome |
Digite o nome da visualização na qual a solicitação será criada. |
Título |
Digite o título da solicitação. |
Descrição |
Opcionalmente, insira a descrição da solicitação. |
Notas |
Opcionalmente, insira as notas da solicitação. |
Nome da coluna filho |
Digite o nome da coluna que contém os valores child . |
Saídas
Saída |
Tipo de saída |
Solicitar JSON |
JSON |
ID da solicitação |
String |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Criar itens de solicitação do arquivo
Para adicionar itens em um arquivo de upload a uma solicitação EDMCS, use o comando Create Request Items From File .
Propriedades
Propriedade |
Detalhes |
Título da solicitação |
Digite o título da solicitação EDMCS. |
Nomes de planilhas |
Digite os nomes das folhas de solicitação. |
Arquivo |
Insira o arquivo a ser usado para criar os itens da solicitação. |
Saídas
Saída |
Tipo de saída |
JSON de solicitação atualizado |
JSON |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Excluir arquivo
Para excluir um arquivo ou snapshot de aplicativo do local de upload padrão, de uma pasta do Data Management ou de profitinbox/profitoutbox, use o comando Delete file .
Propriedades
Propriedade |
Detalhes |
Nome do arquivo |
Digite o nome do arquivo a ser excluído. Se o arquivo for e não no local de upload padrão, inclua o caminho para o local. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Baixar arquivo
Para fazer o download de um arquivo de um ambiente, use o comando Download file .
Propriedades
Propriedade |
Detalhes |
Nome do arquivo |
Digite o nome do arquivo a ser baixado. Se o arquivo for e não no local de upload padrão, inclua o caminho para o local. |
Descompactar automaticamente |
Para descompactar automaticamente o arquivo baixado para uso como saída com um comando posterior na cadeia, marque essa caixa. Observação: Se o arquivo ZIP contiver vários arquivos, ele permanecerá compactado. |
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 |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Exportar mapeamento de dimensão para conexão
Para exportar um mapeamento de dimensão em um arquivo de valores separados por vírgula (CSV), use o comando Export Dimension Mapping to Connection .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo que contém a dimensão. |
Nome da dimensão |
Digite o nome da dimensão a ser exportada. |
Nome da conexão |
Digite o nome da conexão para a qual exportar a dimensão. |
Nome do arquivo |
Digite o nome do arquivo de destino para exportar o mapeamento de dimensão. |
Localização do mapeamento |
Digite o local de mapeamento a ser exportado. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Exportar o mapeamento de dimensões para um arquivo
Para exportar um mapeamento de dimensão para um arquivo CSV, use o comando Export Dimension Mapping to File .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo ao qual a dimensão pertence. |
Nome da dimensão |
Digite o nome da dimensão a ser exportada. |
Nome do arquivo |
Digite o nome do arquivo de destino para exportar o mapeamento de dimensão. |
Localização do mapeamento |
Digite o local de mapeamento a ser exportado. |
Saídas
Saída |
Tipo de saída |
Exportar arquivo de mapeamento |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Exportar dimensão para conexão
Para exportar uma dimensão no Oracle EDMCS para uma conexão existente, use um comando Export Dimension to Connection .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo que contém a dimensão a ser exportada. |
Nome da dimensão |
Digite o nome da dimensão a ser exportada. |
Nome da conexão |
Digite o nome da conexão para a qual exportar a dimensão. |
Nome do arquivo |
Digite o nome do arquivo de destino para o qual exportar a dimensão. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Exportar dimensão para o arquivo
Para exportar uma dimensão no Oracle EDMCS para um arquivo CSV que pode ser baixado, use um comando Export Dimension to File .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo que contém a dimensão a ser exportada. |
Nome da dimensão |
Digite o nome da dimensão a ser exportada. |
Nome do arquivo |
Digite o nome do arquivo de destino para o qual exportar a dimensão. |
Nome dos pais |
Para exportar apenas os descendentes de um membro pai, digite o nome do pai. |
Nome da coluna pai |
Para exportar apenas os descendentes de um pai com base em uma coluna, digite o nome da coluna que contém o pai. |
Saídas
Saída |
Tipo de saída |
Exportar arquivo de dimensão |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Exportar instantâneo
Para repetir uma operação de exportação anterior e criar um instantâneo do conteúdo da migração, use um comando Export snapshot .
Propriedades
Propriedade |
Detalhes |
Nome do instantâneo |
Digite o nome do snapshot a ser exportado. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Extrair o ponto de vista da dimensão
Para extrair um ponto de vista de dimensão para um arquivo ou conexão, use um comando Extract Dimension Viewpoint .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo que contém a dimensão a ser extraída. |
Nome da dimensão |
Digite o nome da dimensão a ser extraída. |
Nome do arquivo |
Digite o nome do arquivo de destino para extrair a dimensão. Observação: Se Nome da conexão estiver em branco, o comando criará esse arquivo em sua instância do Oracle EDMCS e fará o download como saída. |
Nome do extrato |
Digite o nome da extração. |
Nome da conexão |
Para extrair a dimensão para uma conexão em vez de um arquivo, digite o nome da conexão. |
Saídas
Saída |
Tipo de saída |
Exportação do ponto de vista da dimensão |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Obter aplicativos
Para listar os aplicativos Oracle EDMCS disponíveis e recuperar seus metadados, incluindo dimensões, use o comando Get Applications .
Propriedades
Nenhum
Saídas
Saída |
Tipo de saída |
Lista de aplicativos |
Matriz |
Arquivo JSON de aplicativos |
JSON |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Obter conexões
Para listar as conexões disponíveis para um aplicativo Oracle EDMCS, use o comando Get Connections .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo que contém as conexões a serem listadas. |
Saídas
Saída |
Tipo de saída |
Lista de conexões |
Matriz |
Arquivo JSON de conexões |
JSON |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Obter mapeamentos de dimensão
Para listar os mapeamentos disponíveis para uma dimensão Oracle EDMCS, use o comando Get Dimension Mappings .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo da dimensão. |
Nome da dimensão |
Digite o nome da dimensão que contém os mapeamentos desejados. |
Saídas
Saída |
Tipo de saída |
Mapeamentos de dimensão JSON |
JSON |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Obter solicitação
Para recuperar os metadados de uma solicitação Oracle EDMCS, use o comando Get Request .
Propriedades
Propriedade |
Detalhes |
Título da solicitação |
Digite o título da solicitação desejada. |
Saídas
Saída |
Tipo de saída |
Solicitar JSON |
JSON |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Obter solicitações
Para listar todas as solicitações que o usuário de integração do conector pode acessar, use o comando Get Requests .
Propriedades
Nenhum
Saídas
Saída |
Tipo de saída |
Lista de solicitações |
Matriz |
Solicita arquivo JSON |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Obter visualizações
Para listar todas as visualizações que o usuário de integração do conector pode acessar, use o comando Get Views .
Propriedades
Nenhum
Saídas
Saída |
Tipo de saída |
Lista de visualizações |
Matriz |
Visualizações do arquivo JSON |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Importar dimensão por nome
Para importar uma dimensão para o Oracle EDMCS por seu nome de arquivo, use um comando Importar dimensão por nome .
Propriedades
Propriedade |
Detalhes |
Nome do arquivo |
Digite o nome do arquivo a ser importado. Observação: O arquivo é importado da área de preparação ou de uma conexão. |
Nome do aplicativo |
Digite o nome do aplicativo que contém a dimensão. |
Nome da dimensão |
Digite o nome da dimensão que receberá a importação. |
Opção de importação |
Selecione se deseja redefinir, substituir ou mesclar a dimensão na importação. |
Nome da conexão |
Digite o nome da conexão da qual o arquivo será importado. Para importar da área de preparação, deixe em branco. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Importar dimensão da conexão
Para importar uma dimensão para o Oracle EDMCS a partir de uma conexão existente, use o comando Import Dimension from Connection .
Propriedades
Propriedade |
Detalhes |
Nome do aplicativo |
Digite o nome do aplicativo que contém a dimensão. |
Nome da conexão |
Digite o nome da conexão da qual a dimensão será importada. |
Nome da dimensão |
Digite o nome da dimensão que receberá a importação. |
Nome do arquivo |
Digite o nome do arquivo a ser importado na conexão fornecida. |
Redefinir dimensão |
Para redefinir a dimensão antes da importação, marque essa caixa. |
Opção de importação |
Se Reset dimension não estiver marcado, selecione se deseja redefinir, substituir ou mesclar a dimensão na importação. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Importar dimensão do arquivo
Para importar uma dimensão para o Oracle EDMCS a partir de um arquivo CSV ou ZIP carregado, use um comando Import Dimension from File .
Propriedades
Propriedade |
Detalhes |
Arquivo |
Digite o arquivo a ser importado. |
Nome do aplicativo |
Digite o nome do aplicativo que contém a dimensão. |
Nome da dimensão |
Digite o nome da dimensão que receberá a importação. |
Redefinir dimensão |
Para redefinir a dimensão antes da importação, marque essa caixa. |
Opção de importação |
Se Reset dimension não estiver marcado, selecione se deseja substituir, mesclar ou redefinir a dimensão na importação. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Importar instantâneo
Para importar o conteúdo de um instantâneo do local de upload padrão para o ambiente de serviço, use um comando Import snapshot .
Propriedades
Propriedade |
Detalhes |
Nome do instantâneo |
Digite o nome do snapshot a ser importado. |
Nova senha padrão |
Digite a senha a ser atribuída aos novos usuários criados no domínio de identidade. Observação: A senha deve atender aos requisitos mínimos do domínio de identidade. |
Redefinir senha |
Para exigir que os novos usuários alterem a senha quando fizerem o primeiro login, marque essa caixa. |
Saídas
Nenhum
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Listar arquivos
Para listar os arquivos no local padrão, as pastas Data Management e profitinbox/profitoutbox, use o comando List files .
Observação: Esse comando não lista os snapshots de migração.
Propriedades
Propriedade |
Detalhes |
Filtro |
Insira os critérios dos arquivos a serem retornados. Por exemplo, use o glob synax - como *.csv - para retornar todos os arquivos que correspondem ao padrão. |
Saídas
Saída |
Tipo de saída |
Arquivos EDMCS |
Matriz |
Arquivos EDMCS CSV |
Arquivo |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Atualizar o status da solicitação
Para atualizar o status de uma solicitação Oracle EDMCS, use o comando Update Request Status .
Propriedades
Propriedade |
Detalhes |
Título da solicitação |
Digite o título da solicitação a ser atualizada. |
Status |
Selecione o status para o qual atualizar a solicitação. |
Transição com aviso |
Ative essa caixa de seleção para ignorar qualquer falha de validação personalizada com uma gravidade de ADVERTÊNCIA e prosseguir para a próxima etapa.
|
Saídas
Saída |
Tipo de saída |
JSON de solicitação atualizado |
JSON |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
Carregar arquivo
Para fazer upload de um arquivo, use o comando Upload file. Por exemplo, use esse comando para fazer upload de arquivos que contenham:
- Dados ou metadados
- Definições de regras ou dimensões
- Transações mapeadas
- Modelos
- Instantâneos de backup
Propriedades
Propriedade |
Detalhes |
Carregar arquivo |
Digite o arquivo a ser carregado. |
Nome do upload |
Digite o nome do arquivo carregado. Para manter o mesmo nome, deixe em branco. |
Caminho do arquivo |
Digite o caminho para onde carregar o arquivo. Para usar o local de upload padrão, deixe em branco. |
Sobrescrever |
Para substituir um arquivo existente com o mesmo nome no local do upload, marque essa caixa. |
Tamanho do pedaço |
Digite o tamanho dos blocos usados para carregar o arquivo. Por padrão, 50. |
Saídas
Saída |
Tipo de saída |
Tamanho do arquivo carregado |
Inteiro |
Registros carregados |
Inteiro |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Fazer upload do arquivo para a preparação
Para carregar um arquivo na área de preparação, use o comando Upload file to staging .
Propriedades
Propriedade |
Detalhes |
Carregar arquivo |
Digite o arquivo a ser carregado. |
Nome do arquivo |
Digite o nome do arquivo carregado. Para manter o mesmo nome, deixe em branco. |
Saídas
Saída |
Tipo de saída |
Tamanho do arquivo carregado |
Inteiro |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |
10 |
Advertência |
Comando concluído com avisos |
Carregar arquivo de solicitação
Para fazer upload de um arquivo como anexo de uma solicitação, use o comando Upload request file .
Propriedades
Propriedade |
Detalhes |
ID da solicitação |
Digite o ID da solicitação para a qual o arquivo será carregado. |
Carregar arquivo |
Digite o arquivo a ser carregado. |
Saídas
Saída |
Tipo de saída |
Solicitar URL de upload de arquivo |
String |
Códigos de saída
Código |
Tipo |
Detalhes |
0 |
Sucesso |
Sucesso |
1 |
Erro |
Argumentos inválidos |
2 |
Erro |
Falha geral |