Criação de Integrações Personalizadas de Automação de Processo

No Task Manager, você pode criar integrações personalizadas de automação de processo com aplicativos externos. Em uma integração de Automação de Processo, uma tarefa é executada automaticamente em um aplicativo externo quando sua data e hora de início são atingidas e quando qualquer tarefa predecessora é concluída, por exemplo, um feed durante a noite de um General Ledger.

Ao criar uma tarefa Automação de Processo, se você tiver configurado notificações por e-mail, o Proprietário da tarefa receberá automaticamente uma notificação por e-mail quando a tarefa for iniciada ou estiver concluída. O Destinatário que é especificado quando você configura um workflow receberá uma notificação de ação quando houver uma mudança no status da tarefa e uma ação precisar ser realizada, como uma aprovação, e o Proprietário receberá uma notificação quando a aprovação for concluída.

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

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.

Inscreva-se no Oracle Integration Cloud/Oracle Autonomous Integration Cloud. Consulte Documentação do Integration Cloud Service para obter informações detalhadas.
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.

Criação de uma Conexão no Task Manager

Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.
Clique na guia Integrações à esquerda e, em seguida, clique em Gerenciar Conexões.
Clique em Novo.
Em Conexão, informe um nome para a conexão.
Selecione Habilitado para habilitar a conexão.
Selecione Cloud se o aplicativo externo for um serviço do Cloud.
Clique em OK para salvar a conexão.

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

Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.
Clique na guia Integrações à esquerda e, em seguida, clique em Novo.
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 Automação de Processo.
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 para o 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

Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.
Clique na guia Tipos de Tarefa à esquerda.
Clique em Novo.
Na guia Propriedades, especifique um Nome do Tipo de Tarefa e uma ID do Tipo de Tarefa.
Em Integração, clique em Pesquisar, selecione a Integração e clique em OK.
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:

Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.
Clique na guia Integrações à esquerda.
Clique em Gerenciar Conexões. Em Ações, selecione Conexão com o Integration Cloud.
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
Clique em Validar. Após a validação bem-sucedida, clique em Salvar. Isso salva o servidor e as credenciais da conexão.

Criação de uma Conexão e Integração no Integration Cloud

Faça logon no Integration Cloud.
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.
Crie uma ou mais conexões com o outro aplicativo conforme necessário.
Crie Integração de Automação de Processos usando as conexões criadas e ative-a. Consulte este exemplo: Uso do Oracle Enterprise Performance Management Cloud Adapter com o Oracle Integration.

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.

Na página Inicial, clique em Aplicativo e, em seguida, em Task Manager.
Clique na guia Integrações à esquerda e verifique se a nova Integração é exibida na lista Integrações.
No Task Manager, selecione Agendamentos e crie um novo Agendamento no estado Pendente. Consulte Criação Manual de Agendamentos.
Crie a tarefa de automação de processo e adicione-a ao agendamento. Consulte Criação de Tarefas.
Em Agendamentos, selecione e abra o agendamento.