Criação de Integrações Personalizadas de Monitoramento de Eventos

No Task Manager, você pode criar uma integração de Monitoramento de Eventos para um aplicativo externo. A integração de Monitoramento de Eventos é acionada quando um evento externo ocorre em outro serviço do Cloud ou no aplicativo local. Um exemplo de integração de Monitoramento de Eventos é um acionador do Oracle E-Business Suite - General Ledger quando um período, por exemplo, Janeiro de 2018, é fechado.

Certifique-se de que você tenha os pré-requisitos e siga o procedimento a seguir para configurar uma integração entre o Task Manager e um aplicativo externo.

Para obter uma visão geral do fluxo de integrações personalizadas, consulte Criação de Integrações Personalizadas.

Pré-requisitos

Nota:

O monitoramento de eventos também pode ser acionado por meio de uma ferramenta de integração capaz de chamar APIs REST. Nesse caso, você não precisará dos pré-requisitos abaixo.

Estes são os pré-requisitos para integrar o Task Manager com um aplicativo externo:
  • Uma assinatura no Oracle Integration Cloud Service para integração com serviços on-premise e com serviços não relacionados com o EPM Cloud.

    Nota:

    Você precisa de uma instância do Integration Cloud por instância do Oracle EPM.
  • O aplicativo externo configurado.
  1. Assinatura do Oracle Integration Cloud Service / Oracle Autonomous Integration Cloud. Consulte Documentação do Integration Cloud Service para obter informações detalhadas.
  2. Instale o Agente do Integration Cloud no seu ambiente de aplicativo para comunicação com a sua instância do Oracle EPM Cloud. Para detalhes sobre a configuração do agente do Integration Cloud, consulte Gerenciamento de Grupos de Agentes.

    Nota:

    Se os serviços do aplicativo on-premise forem implantados em um ambiente configurado em uma configuração DMZ (demilitarized zone, zona desmilitarizada) para que possam ser acessados publicamente na Internet, não será necessário instalar o agente do Integration Cloud.

Configuração da Integração no Task Manager

  1. Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.
  2. Clique na guia Integrações à esquerda e, em seguida, clique em Novo.
  3. Na guia Propriedades, especifique as informações necessárias:

    1. Em Nome, informe um nome para a Integração.

    2. Em Código, digite um Código de Integração para a tarefa de integração.

      O código é usado para executar a Integração e mapear atualizações de uma importação de arquivo para uma Integração.

    3. Opcional: Em Descrição, informe uma descrição para a tarefa de integração.

    4. Em Conexão, selecione um aplicativo ao qual a tarefa pertença.

      Você pode manter a lista de aplicativos usando o ícone Gerenciar Conexões da caixa de diálogo Gerenciar Conexões.

    5. Em Tipo de Execução, selecione Monitoramento de Eventos.

    6. Em Nome do Evento, informe um nome para o evento.

  5. Na guia Parâmetros, clique em Novo e especifique as informações necessárias:

    1. Em Nome, informe um nome para o parâmetro.

    2. Em Código do Parâmetro, digite um código de parâmetro.

    3. Opcional: Insira uma dica de ferramenta de parâmetro.

    4. Na lista Tipo de Parâmetro, selecione um tipo e insira informações adicionais do parâmetro:

      • Caixa de seleção: Valor booleano

      • Data: Valor de data

      • Inteiro: Valor numérico em números inteiros

      • Número: Valor numérico em números inteiros ou frações

      • Grupo de Opções: Caixa de seleção para um conjunto predefinido de valores

      • Lista Estática: Conjunto predefinido de valores de texto

      • Informações da Tarefa: Informações da tarefa, por exemplo, destinatário, duração, datas de início e término

      • Texto: Valor de texto de formato livre

      • Artefato do EPM: Nome do artefato, como o formulário ou relatório

    5. Se o parâmetro exigir um valor, selecione Obrigatório.

    6. Clique em OK para salvar o parâmetro.

    7. Clique em Salvar e Fechar para salvar a Integração.

Criação de um Tipo de Tarefa para a Integração

  1. Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.

  2. Clique na guia Tipos de Tarefa à esquerda.

  3. Clique em Novo.

  4. Na guia Propriedades, especifique um Nome do Tipo de Tarefa e uma ID do Tipo de Tarefa.

  5. Em Integração, clique em Pesquisar, selecione a Integração e clique em OK.

  6. Na guia Parâmetros, defina os parâmetros Tipo de Tarefa.

Configuração da Conexão do Integration Cloud no Task Manager

O Task Manager usa o Integration Cloud para todas as integrações a aplicativos externos. Você pode configurar uma conexão para o Oracle Integration Cloud no Task Manager usando autenticação Básica ou OAuth 2.0.

Nota:

  • Para o Oracle Integration Cloud Generation 2, existe suporte tanto a autenticação básica quanto para OAuth 2.0.
  • Para o Oracle Integration Cloud Generation 3, existe suporte somente para OAuth 2.0.
  • O usuário da Autenticação Básica deve ter a função Administrador do Serviço para o Oracle Integration Cloud.
  • Para OAuth 2.0, apenas credenciais do cliente são suportadas. O aplicativo cliente do OAuth 2.0 deve ter a função Administrador do Serviço para o Integration Cloud e permitido que tudo seja abrangido pelo escopo.

Antes de configurar a conexão OAuth 2.0, certifique-se de ter as credenciais do cliente, como URL do token de acesso, ID do cliente, segredo do cliente e escopo. Para definir o aplicativo cliente do OAuth, veja Autenticação OAuth no Oracle Integration na documentação do Oracle Integration Cloud Generation 3.

Para configurar a conexão do Integration Cloud no Task Manager:

  1. Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.

  2. Clique na guia Integrações à esquerda.

  3. Clique em Gerenciar Conexões. Em Ações, selecione Conexão com o Integration Cloud.
  4. Selecione um dos seguintes mecanismos de autenticação:
    • Autenticação Básica: Especifique o URL do Integration Cloud, o ID de usuário do administrador de serviço e a senha.
    • OAuth 2.0: Forneça o URL do Integration Cloud, o URL do token de acesso, o ID do cliente, o segredo do cliente e o escopo.

    Nota:

    Insira o URL: https://<SERVICE_NAME>-<TENANT_NAME>.integration.ocp.oraclecloud.com
  5. Clique em Validar. Após a validação bem-sucedida, clique em Salvar. Isso salva o servidor e as credenciais da conexão.

Configuração da Integração no Integration Cloud

Nota:

Se você não tiver a intenção de usar o Integration Cloud, pule essa etapa.

Para configurar a integração no Integration Cloud:

  1. Faça logon no Integration Cloud.
  2. Crie uma conexão usando o adaptador Oracle Enterprise Performance Management Cloud para seu serviço EPM. Consulte este link para obter mais detalhes: Criar uma Conexão com o Oracle Enterprise Performance Management Cloud.
  3. Crie uma ou mais conexões com o outro aplicativo conforme necessário.
  4. Crie Integração de Monitoramento de Eventos usando as conexões criadas e ativadas. Consulte este exemplo: Uso do Oracle Enterprise Performance Management Cloud Adapter com o Oracle Integration.

Configuração da Integração sem o Integration Cloud

Nota:

Se você tiver a intenção de usar o Integration Cloud, execute essa etapa.
Configure a ferramenta de integração que planeja usar.

1. Revise a API REST, Atualizar Status da Tarefa para Monitoramento de Eventos em API REST para o Oracle Enterprise Performance Management Cloud.

2. Configure a ferramenta de integração para chamar a API REST API e fechar a tarefa de Monitoramento de Eventos informando os parâmetros do evento.

Para obter mais informações, consulte Atualizar Status da Tarefa para Monitoramento de Eventos em API REST para o Oracle Enterprise Performance Management Cloud.

Conclusão da Configuração de Integração no Task Manager

Proceda da forma a seguir para concluir a configuração da Integração no Task Manager.

  1. Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.
  2. Clique na guia Integrações à esquerda e verifique se a nova Integração é exibida.
  3. No Task Manager, clique em Agendamentos e crie um novo Agendamento no estado Pendente. Consulte Criação Manual de Agendamentos.
  4. Crie a tarefa de monitoramento de eventos e adicione-a ao agendamento. Consulte Criação de Tarefas.
  5. Em Agendamentos, selecione e abra o agendamento.
  6. Acione a ação que gera o evento no aplicativo externo (por exemplo, EBS). Se você estiver usando outra ferramenta de integração que não seja o Integration Cloud, chame a API REST na ferramenta de integração.

    Nota:

    Informe os parâmetros conforme esperado pelo tipo de integração, pelo evento e pelos parâmetros. Caso contrário, a tarefa não será considerada se eles não corresponderem.
  7. Aguarde até que a tarefa seja concluída.
  8. Opcional: Para monitorar o status da Integração no Integration Cloud Services, faça logon no Integration Cloud e navegue até Monitoramento.