Integrações de Monitoramento de Eventos para Oracle Cloud ERP

Esta seção lista as integrações de monitoramento de eventos prontas para serem usadas do Oracle Cloud ERP.

Nota:

Para automação do processo personalizado ou integração do monitoramento de eventos no Oracle Cloud ERP, consulte Criação de Integrações Personalizadas do Task Manager.

Eventos Suportados pelo Oracle Cloud ERP General Ledger

Os seguintes eventos são suportados no General Ledger:

Origem	Evento	Descrição
Livro-razão	Período Contábil Fechado	Sinaliza quando um período contábil do livro-razão é fechado.
Livro-razão	Período Contábil Aberto	Sinaliza quando um período contábil do livro-razão é aberto.
Livro-razão	Período Contábil Reaberto	Sinaliza quando um período contábil do livro-razão é reaberto.
Livro-razão	Lote de Diário Aprovado	Sinaliza quando um lote de diário é aprovado.
Livro-razão	Contabilização de Lote de Diário Concluída	Sinaliza quando um lote de diário é contabilizado.

Integrações Adicionadas a uma Conexão Predefinida Existente

A tabela lista integrações que são adicionadas para monitorar estes eventos de negócios no Task Manager, o que inclui:

Tipos de Integração no Tax Reporting
Tipos de Tarefa no Tax Reporting
Fluxos de Integração no Integration Cloud

Nome da Conexão	Nome da Integração	Código de Integração	Nome do Evento	Descrição	Parâmetro(s)
Oracle Cloud ERP - General Ledger	Evento de Fechamento de Período	R13GLPeriodClose	Período Contábil Fechado	Monitoramento do Evento de Fechamento do Período do Oracle Cloud ERP General Ledger	LedgerName: Nome do Razão. Por exemplo, Livro-razão Principal EUA. Period: Nome do Período. Por exemplo, 01-19.
Oracle Cloud ERP - General Ledger	Evento de Abertura de Período	R13GLPeriodOpen	Período Contábil Aberto	Monitoramento do Evento de Abertura do Período do Oracle Cloud ERP General Ledger	LedgerName: Nome do Razão. Por exemplo, Livro-razão Principal EUA. Period: Nome do Período. Por exemplo, 01-19.
Oracle Cloud ERP - General Ledger	Evento de Reabertura de Período	R13GLPeriodReopen	Período Contábil Reaberto	Monitoramento do Evento de Reabertura do Período do Oracle Cloud ERP General Ledger	LedgerName: Nome do Razão. Por exemplo, Livro-razão Principal EUA. Period: Nome do Período. Por exemplo, 01-19.
Oracle Cloud ERP - General Ledger	Evento de Aprovação de Diário	R13GLJournalBatchApprove	Lote de Diário Aprovado	Monitoramento do Evento de Aprovação em Lote de Diário do Oracle Cloud ERP General Ledger	BatchName: Nome do Lote de Diário Period: Nome do Período. Por exemplo, 01-19.
Oracle Cloud ERP - General Ledger	Evento de Contabilização de Diário	R13GLJournalBatchPost	Lote de Diário Contabilizado	Monitoramento do Evento de Contabilização do Lote de Diário do Oracle Cloud ERP General Ledger	BatchName: Nome do Lote de Diário Period: Nome do Período. Por exemplo, 01-19.

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

No Task Manager, você pode criar uma integração do Monitoramento de Eventos para o Oracle Cloud ERP - General Ledger. A integração de Monitoramento de Eventos é acionada quando um evento externo ocorre em outro Cloud Service ou em um aplicativo on-premise.

Certifique-se de que os eventos de negócios estão habilitados no Oracle Cloud ERP. Você pode verificar os eventos usando a API REST. Consulte estes tópicos na seção "ERP Business Events REST Endpoints" do guia REST API for Oracle Financials Cloud disponível em docs.oracle.com.

Para verificar os eventos, consulte "Obter todos os registros de eventos de negócios".

Se algum evento não estiver ativado, consulte "Atualizar o indicador habilitado para um evento de negócios".

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

Nota:

O Oracle Integration Cloud Generation 2 é compatível com Autenticação Básica e OAuth 2.0.
O Oracle Integration Cloud Generation 3 é compatível somente com o OAuth 2.0.
O usuário da Autorização Básica deve ter a função Administrador do Serviço para Oracle Integration Cloud.
O OAuth 2.0 oferece suporte apenas a credenciais do cliente. O aplicativo cliente do OAuth 2.0 deve ter a função Administrador do Serviço para o Oracle Integration Cloud e escopo permitido para todos.

Antes de configurar a conexão do OAuth 2.0, você deve ter as credenciais do cliente, como URL do token de acesso, ID do cliente, segredo do cliente e escopo. Para configurar o aplicativo cliente do OAuth, consulte 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 Task Manager.
Clique na guia Integrações à esquerda.
Clique em Gerenciar Conexões. Em Ações, selecione Conexão do Integration Cloud.
Selecione um dos seguintes mecanismos de autenticação:
- Autenticação Básica: Especifique o URL do Integration Cloud, o ID do usuário do administrador do serviço e a senha.
- OAuth 2.0: Especifique o URL do Integration Cloud URL, o URL do token de acesso, o ID do cliente, o segredo do cliente e o escopo.
Nota:
- Para Gen 2, insira o URL: https://<SERVICE_NAME>-<TENANT_NAME>.integration.ocp.oraclecloud.com
- Para Gen 3, insira o URL: https://<SERVICE_INSTANCE>.integration.<REGION>.ocp.oraclecloud.com. Para encontrar sua instância de serviço, faça login no Integration Cloud e abra a janela Sobre.
Clique em Validar. Após a validação bem-sucedida, clique em Salvar. Isso salvará o servidor e as credenciais da conexão.

Habilitação da Conexão Oracle Cloud ERP - General Ledger

Para habilitar a conexão Oracle Cloud ERP - General Ledger:

Na Página Inicial, clique em Aplicativo e em Task Manager.
Clique na guia Integrações à esquerda e, em seguida, clique em Gerenciar Conexões.
Selecione Oracle Cloud ERP - General Ledger na lista, clique em Ações e selecione Editar.
Na caixa de diálogo Editar Conexão, selecione Habilitado e clique em OK.

Nota:

Na primeira vez que você habilitar a conexão com o Integration Cloud, todas as implantações do Integration Cloud falharão durante a ativação. O Administrador deve fazer log-in no Integration Cloud, testar e salvar as conexões implantadas e, em seguida, ativar as integrações implantadas no Integration Cloud.

Configuração do Fluxo de Integração no Integration Cloud

Para configurar o fluxo de integração no Integration Cloud:

Login no Integration Cloud Services.
Navegue até Conexões.

A Conexão do EPM Fusion e a Conexão do EPM são criadas automaticamente.
Edite as conexões fornecendo informações sobre o ambiente e sobre as credenciais. Para obter detalhes sobre os pré-requisitos da criação de uma conexão, consulte Pré-requisitos para a Criação de uma Conexão.
- Conexão do EPM Fusion é a conexão com o Oracle Cloud ERP. Consulte Utilização do Oracle ERP Cloud Adapter para obter mais detalhes.
- EPM Connection é a conexão ao Serviço do Oracle Fusion Cloud Enterprise Performance Management no Task Manager. Consulte Utilização do Oracle Enterprise Performance Management Cloud Adapter com o Oracle Integration para obter mais detalhes.
Após configurar, testar e salvar as conexões, você verá uma marca de seleção verde ao lado das conexões.
Retorne ao Task Manager e selecione Integrações.
Selecione a integração na lista e clique em Implantar no Integration Cloud na barra de ferramentas.
Na caixa de diálogo Implantar no Integration Cloud, clique em Gerar.

A implantação do Cloud Integration será bem-sucedida. Verifique o status da ativação no Integration Cloud fazendo login no Oracle Integration Cloud Service e selecionando Integrações.

Adição da Tarefa de Monitoramento de Eventos a um Modelo ou Agendamento

Quando a configuração estiver completa, você poderá adicionar as tarefas de monitoramento de eventos a um agendamento ou a um modelo.

Na Página Inicial, clique em Aplicativo e em Task Manager.
Clique na guia Modelos à esquerda e crie um modelo, por exemplo, Modelo de Evento ERP.
Crie a tarefa de monitoramento de eventos. Consulte Criação de Tarefas.

No Tipo de Tarefa, certifique-se de selecionar Oracle Cloud ERP - General Ledger e selecione a tarefa de monitoramento de eventos, por exemplo, Evento de Abertura de Período.
No Task Manager, clique em Modelo, selecione Modelo de Evento ERP e crie um agendamento. Consulte Criando Agendamentos a partir de Modelos.
No Task Manager, clique em Agendamentos, selecione o agendamento e altere o status para Aberto.

Você pode monitorar a tarefa de agendamento na tela Agendar Tarefas.

Acionamento do Evento de Fechamento do Período no Oracle Cloud ERP

Para gerar o evento de Fechamento do Período no Oracle Cloud ERP:

Faça login no Oracle Cloud ERP.
Selecione a guia Contabilidade Geral. Em seguida, selecione Fechamento de Período.
Clique em Razão-geral e selecione o período. Em seguida, clique em Fechar Período.
Por alguns minutos, aguarde a conclusão da tarefa. Em seguida, navegue até a tela Agendar Tarefas em Tarefas para verificar se a tarefa está fechada.

Acionamento do Evento de Abertura/Reabertura do Período no Oracle Cloud ERP

Para gerar o evento de Abertura do Período no Oracle Cloud ERP:

Faça login no Oracle Cloud ERP.
Selecione a guia Contabilidade Geral. Em seguida, selecione Fechamento de Período.
Clique em Razão-geral e selecione o período. Em seguida, clique em Abrir Período.
Por alguns minutos, aguarde a conclusão da tarefa. Em seguida, navegue até a tela Agendar Tarefas em Tarefas para verificar se a tarefa está fechada.

Nota:

Se você abrir um período que nunca foi aberto, o Evento de Abertura de Período será acionado. Se você abrir um período que já foi fechado antes, o Evento de Reabertura de Período será acionado.

Acionamento do Evento de Aprovação em Lote de Diário no Oracle Cloud ERP

Para gerar o Evento de Aprovação em Lote de Diário no Oracle Cloud ERP:

Faça login no Oracle Cloud ERP.
Selecione a guia Contabilidade Geral. Em seguida, selecione Diários.
Clique em Requerem Minha Aprovação e selecione o lote de diário. Em seguida, clique em Aprovar.
Por alguns minutos, aguarde a conclusão da tarefa. Em seguida, navegue até a tela Agendar Tarefas em Tarefas para verificar se a tarefa está fechada.

Nota:
Você só poderá acionar o evento Lote de Diário Aprovado se ele representar a última aprovação no processo de aprovação em vários níveis.

Acionamento do Evento de Contabilização de Diário no Oracle Cloud ERP

Para gerar o Evento de Aprovação em Lote de Diário no Oracle Cloud ERP:

Faça login no Oracle Cloud ERP.
Selecione a guia Contabilidade Geral. Em seguida, selecione Diários.
Clique em Tarefas e selecione Criar Diário.
Na tela Criar Diário, especifique as informações necessárias. Em seguida, clique em Salvar.

Nota:
O nome do lote de diário e o período contábil devem corresponder aos parâmetros da tarefa no agendamento do Task Manager.
Por alguns minutos, aguarde a conclusão da tarefa. Em seguida, navegue até a tela Agendar Tarefas em Tarefas para verificar se a tarefa está fechada.

Solução de Problemas

Esta seção fornece as informações de solução de problemas para as integrações de monitoramento de eventos do Oracle Cloud ERP.

Problema Causa Raiz Resolução

Erro de comunicação durante a importação para o Oracle Integration Cloud

O aplicativo OAuth configurado não tem a função de Administrador de Serviço para o Oracle Integration Cloud.

Problema	Causa Raiz	Resolução
Erro de comunicação durante a importação para o Oracle Integration Cloud	O aplicativo OAuth configurado não tem a função de Administrador de Serviço para o Oracle Integration Cloud.	Crie um aplicativo OAuth separado e conceda a função de Administrador de Serviço ao aplicativo OAuth. Adicione todo o escopo OIC. Consulte Configuração da Integração no Task Manager. Isso é necessário para que você possa implantar o fluxo OIC pronto para uso do Task Manager para o OIC.
A contabilização do diário não disparou o fluxo no Oracle Integration Cloud.	Evento de negócios não ativado no ERP.	Execute as seguintes ações: Recuperar uma lista de eventos de negócios disponíveis Obter evento de negócios específico Atualizar o indicador de ativação para evento de negócios Verificar a assinatura do evento de negócios Você pode chamar o recurso REST da assinatura `PublicEvent` usando qualquer cliente REST para verificar o status da assinatura. Method : GET URL : https://fa_host.oraclecloud.com/soa-infra/PublicEvent/subscriptions A resposta contém o URL do ponto de extremidade da assinatura relacionada. Para solucionar problemas relacionados a eventos de negócios, consulte Solução de Problemas de Eventos de Negócios
O Diário Contabilizado não fecha a tarefa no Financial Consolidation and Close	O nome do lote do diário é atualizado com informações adicionais quando o Diário é contabilizado	Execute as seguintes ações: Crie uma conexão no gerenciador de tarefas. Por exemplo, Custom_XXX_ERP. Crie uma integração personalizada e um tipo de tarefa no gerenciador de tarefas. Nota: Crie a integração em uma nova conexão. Use os mesmos parâmetros da integração pronta para uso. Use prefixo no nome da integração, nome do código e nome do evento. Por exemplo, Custom_XXX_JournalPostEvent. No Oracle Integration Cloud: Crie uma conexão para o Oracle Cloud ERP e o Oracle Fusion Cloud EPM. Duplique o fluxo OIC pronto para uso. Substitua as conexões para apontar para as novas conexões criadas para o Cloud ERP e Cloud EPM. Personalize o fluxo OIC para remover informações do nome do lote. Envie o nome do lote modificado para a Tarefa de Atualização da API de Monitoramento de Eventos. Teste o fluxo de ponta a ponta entre o Oracle Cloud ERP e o Tax Reporting. Para obter mais informações, consulte Criação de Integrações Personalizadas.

Crie um aplicativo OAuth separado e conceda a função de Administrador de Serviço ao aplicativo OAuth. Adicione todo o escopo OIC. Consulte Configuração da Integração no Task Manager.

Isso é necessário para que você possa implantar o fluxo OIC pronto para uso do Task Manager para o OIC.

A contabilização do diário não disparou o fluxo no Oracle Integration Cloud.

Evento de negócios não ativado no ERP.

Execute as seguintes ações:

Recuperar uma lista de eventos de negócios disponíveis
Obter evento de negócios específico
Atualizar o indicador de ativação para evento de negócios
Verificar a assinatura do evento de negócios
Você pode chamar o recurso REST da assinatura PublicEvent usando qualquer cliente REST para verificar o status da assinatura.
```
Method : GET
URL : https://fa_host.oraclecloud.com/soa-infra/PublicEvent/subscriptions
```
A resposta contém o URL do ponto de extremidade da assinatura relacionada.

Para solucionar problemas relacionados a eventos de negócios, consulte Solução de Problemas de Eventos de Negócios

O Diário Contabilizado não fecha a tarefa no Financial Consolidation and Close

O nome do lote do diário é atualizado com informações adicionais quando o Diário é contabilizado

Execute as seguintes ações:

Crie uma conexão no gerenciador de tarefas. Por exemplo, Custom_XXX_ERP.
Crie uma integração personalizada e um tipo de tarefa no gerenciador de tarefas.

Nota:
Crie a integração em uma nova conexão. Use os mesmos parâmetros da integração pronta para uso. Use prefixo no nome da integração, nome do código e nome do evento. Por exemplo, Custom_XXX_JournalPostEvent.
No Oracle Integration Cloud:
1. Crie uma conexão para o Oracle Cloud ERP e o Oracle Fusion Cloud EPM.
2. Duplique o fluxo OIC pronto para uso.
3. Substitua as conexões para apontar para as novas conexões criadas para o Cloud ERP e Cloud EPM.
4. Personalize o fluxo OIC para remover informações do nome do lote.
5. Envie o nome do lote modificado para a Tarefa de Atualização da API de Monitoramento de Eventos.
6. Teste o fluxo de ponta a ponta entre o Oracle Cloud ERP e o Tax Reporting.

Para obter mais informações, consulte Criação de Integrações Personalizadas.