Criando Conexões Globais

Casos de Uso

Compartilhamento de Dados

• As conexões globais com o Armazenamento de Blobs do Microsoft Azure podem ser usadas para transferir a saída de extrações e pacotes de extração para um contêiner de arquivos do Armazenamento de Blobs do Microsoft Azure.
• Conexões globais com o Oracle Cloud ERP podem ser usadas a fim de transferir dados, como combinações de contas, conjuntos de mapeamentos e conjuntos de valores relacionados para importação no Financials Cloud.
• Conexões globais com o Oracle Cloud EPM podem ser usadas das seguintes maneiras:
  • Aplicativos universais que gerenciam o processo de negócios do Account Reconciliation podem usar conexões globais para enviar perfis para a caixa de entrada do aplicativo.
  • Aplicativos universais que gerenciam dimensões do processo de negócios do Profitability and Cost Management podem usar conexões globais para enviar arquivos de metadados para profitinbox.
  • Para enviar arquivos de mapeamento para uma caixa de entrada do Data Management

Validação e Verificação

• As conexões globais para validações externas permitem que você valide itens de solicitação no Cloud EDM usando regras de negócios e dados de referência que residem em um sistema externo. Consulte Validações Personalizadas Externas.
• Conexões globais com o serviço de Verificação de Endereço, E-mail e Telefone da Oracle permitem verificar endereços em solicitações. Consulte Integração com o Serviço de Verificação de Endereço, E-mail e Número de Telefone da Oracle.

Você pode restringir tipos de conexão de modo que eles possam ser usados apenas por aplicativos específicos no Cloud EDM. Conexões globais com o serviço de Verificação de Endereço, E-mail e Telefone da Oracle se aplicam a todos os aplicativos.

Criação de uma Conexão Global

Considerações

• Depois que você criar uma conexão global, poderá usá-la em uma extração. Você também pode usar uma conexão global em várias extrações, mas cada extração só pode usar uma conexão global.

  Nota:

  Não é possível usar um tipo de conexão com o serviço de verificação de Endereço, E-mail e Telefone da Oracle em uma extração.
• Depois de criar uma conexão global, você não poderá alterar o tipo de conexão.

• Conexões globais não são usadas para importações e exportações do aplicativo. Em vez disso, são usadas as informações de conexão do aplicativo que você deseja especificar ao registrar o aplicativo.

• Os parâmetros que você especifica para uma conexão global são determinados pelo tipo de conexão.
• As conexões globais com os aplicativos Oracle Cloud EPM e Oracle Cloud ERP suportam autenticação básica e OAuth2. Você deve registrar um cliente de OAuth2 para cada conexão global. Consulte Uso do OAuth2 para Conexões Globais e de Aplicativo.
• Conexões globais com o Armazenamento de Objetos da Oracle suportam autenticação básica e autenticação de Chave de Assinatura de API.
• A conexão global com o serviço de Verificação de Endereço, E-mail e Telefone da Oracle só suporta autenticação OAuth2.
• Conexões globais para validações externas suportam somente autenticação básica.

Para criar uma conexão global:

1. No cluster Conexões, clique em Criar.
2. Selecione o tipo de conexão:
   • Validação Externa
   • Armazenamento de Blobs do Microsoft Azure
   • Serviço de Verificação de Endereço, E-mail e Telefone da Oracle

     Nota:

     Você só pode criar uma conexão global para o Serviço de Verificação de Endereço, E-mail e Telefone da Oracle.
   • Oracle Cloud EPM
   • Oracle Cloud ERP
   • Armazenamento de Objetos da Oracle
3. Informe um nome e, opcionalmente, uma descrição para a conexão. Depois clique em Criar.

   A conexão global é exibida no inspetor de conexão.

4. Clique em Editar e especifique os parâmetros da conexão. Os parâmetros que você especifica são dependentes do tipo de conexão:
   • Parâmetros de Validação Externa:

     Campo	Descrição
     Localização	O URL para o ponto final REST de validação externa. Uma operação GET é executada para testar a conexão, e uma operação POST é executada para fazer uma validação. Exemplo: https://externalhostname.example.com/api/rest/externalValidation
     Nome de Usuário/Senha	Credenciais para autenticação básica.
     Tamanho Máximo do Lote	O número máximo de nós que devem ser validados pelo sistema externo em um único lote, até 10.000. O padrão é 1.000.
     Número Máximo de Processos Simultâneos	O número máximo de processos de validação simultâneos que devem ser executados pelo sistema externo, até 3. O padrão é 1.

   • Parâmetros do Armazenamento de Blobs do Microsoft Azure:

     Campo	Descrição
     Localização	O URL da conta do Armazenamento de Blobs do Microsoft Azure. Por exemplo: https://myblobstorageaccount.blob.core.windows.net Observação: O URL deve conter o nome da sua Conta de Armazenamento de Blobs do Azure (myblobstorageaccount no exemplo acima). Essa conta deve ter a atribuição de função de Colaborador de Dados do Armazenamento de Blobs no Azure.
     ID do Tenant	O ID do Tenant para o registro do aplicativo no tenant do Microsoft Azure.
     ID do Cliente	O ID do Aplicativo (cliente) de um controlador de serviços no tenant do Microsoft Azure.
     Segredo do Cliente	O Valor do Segredo do Cliente no tenant do Microsoft Azure.
     Nome do Contêiner Padrão	O Contêiner de armazenamento de dados onde serão gravados dados no tenant do Microsoft Azure. O contêiner deve existir no tenant do Azure.
     Subpasta Padrão	Opcional: A subpasta no contêiner onde serão gravados os dados no tenant do Microsoft Azure. Observação: Se a subpasta especificada não existir, ela será criada quando o pacote de extração ou extração for executado para essa conexão. Você pode especificar mais subpastas usando o caractere de barra (/) (por exemplo, Application/Extract Data).

   • Parâmetros do Serviço de Verificação de Endereço, E-mail e Telefone da Oracle:

     Campo	Descrição
     Localização	O URL do servidor do Serviço de Verificação de Endereço, E-mail e Telefone da Oracle. Por exemplo: https://mydataservice-myidentitydomain.data.us2.oraclecloud.com Cuidado: Se estiver colando o endereço do navegador, não inclua o contexto (por exemplo, /data/ui) no URL.
     ID do Cliente	O ID do Cliente OAuth a ser usado ao estabelecer conexão com o serviço de verificação de endereço. Observação: Crie credenciais de cliente OAuth para o Serviço de Verificação de Endereço, E-mail e Telefone da Oracle. Consulte Como Começar a Usar o Serviço de Verificação de Endereço, E-mail e Telefone em Como Usar o Serviço de Verificação de Endereço, E-mail e Telefone da Oracle.
     Segredo do Cliente	O Segredo do Cliente OAuth a ser usado ao estabelecer conexão com o serviço de verificação de endereço.

   • Parâmetros do Oracle Cloud EPM:

     Campo	Descrição
     Localização	O URL para a caixa de entrada do EPM. Por exemplo: https://acme-test-epmidm.epm.us-phoenix-1.ocs.oraclecloud.com Cuidado: Se estiver colando o endereço do navegador, não inclua o contexto (por exemplo, /epmcloud) no URL.
     Tipo de Autenticação	Selecione uma opção: Básico: Use as credenciais de usuário fornecidas para autenticação. OAuth: Use tokens e IDs do OAuth2 para autenticação. (Disponível somente para ambientes na arquitetura Oracle Cloud Infrastructure (OCI) Gen 2.) Uso do OAuth2 para Conexões Globais e de Aplicativo
     Pasta Padrão (Opcional)	Pasta padrão para a qual enviar arquivos de extração em ambientes Cloud EPM: Caixa de entrada padrão do aplicativo Planning, FreeForm, Financial Consolidation and Close, Enterprise Profitability and Cost Management Pasta do Data Management (por exemplo, inbox/repository) Caixa de entrada do Profitability and Cost Management (por exemplo, profitinbox)
     Parâmetros de Autenticação Básica:
     Nome de Usuário/Senha	Credenciais obrigatórias para autenticação básica
     Domínio de Identidade (Opcional)	Domínio de identidade para anexar na frente do nome do usuário ao autorizar.
     Parâmetros de Autenticação OAuth:
     ID do Cliente	O ID do Cliente criado para conexões globais.
     Token de Acesso	O token de acesso do cliente criado para conexões globais.
     Token de Atualização	O token de atualização do cliente criado para conexões globais.

   • Parâmetros do Oracle Cloud ERP:

     Campo	Descrição
     Localização	O URL para o servidor do EPM. Por exemplo: https://erp.mycloud.com
     Tipo de Autenticação	Selecione uma opção: Básico: Use as credenciais de usuário fornecidas para autenticação. OAuth: Use tokens e IDs do OAuth2 para autenticação. (Disponível somente para ambientes na arquitetura Oracle Cloud Infrastructure (OCI) Gen 2.) Uso do OAuth2 para Conexões Globais e de Aplicativo
     Conta de Documentos Padrão	Pasta na qual extrair arquivos no Oracle Cloud ERP. Por exemplo, fin/generalLedger/import.
     Parâmetros de Autenticação Básica:
     Nome de Usuário/Senha	Credenciais obrigatórias para autenticação básica
     Domínio de Identidade (Opcional)	Domínio de identidade para anexar na frente do nome do usuário ao autorizar.
     Parâmetros de Autenticação OAuth:
     URL do Token do IDCS	Servidor de autenticação do provedor. Usado para trocar um código de autorização por um token de acesso.
     ID do Cliente	O ID do Cliente criado para conexões globais.
     Escopo	Fornece um método para controlar o volume de acesso concedido a um Token Web JSON.
     Alias do Certificado	O alias especificado quando você importou o certificado para o Cloud ERP.
     Upload de Chave Privada	Arquivo de certificado importado para o Cloud ERP. Clique em Carregar Localização do Arquivo para fazer upload do arquivo. O arquivo deve ter uma extensão de arquivo .PEM.

   • Parâmetros do Oracle Object Storage:

     Campo	Descrição
     Localização	O URL Swift do bucket do Oracle Object Storage Cloud. O formato do URL é: https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace, em que: host name (usando o tipo API do Swift), como swiftobjectstorage. region_identifier é a Oracle Cloud Infrastructure (OCI) de hospedagem, como us-phoenix-1. Consulte Regiões e Domínios de Disponibilidade. namespace é o contêiner de nível superior para todos os buckets e objetos. Cada locatário do Oracle Cloud Infrastructure recebe um nome de namespace exclusivo e imutável do Object Storage e gerado pelo sistema no momento da criação da conta. Dica: O URL Swift do Oracle Object Store deve incluir a versão e o namespace. Não inclua uma barra normal à direita no parâmetro Local.
     Tipo de Autenticação	Selecione o método de autenticação de Chave de Assinatura Básico ou API.
     Básico
     Nome de Usuário/Senha	As credenciais obrigatórias para autenticação, da seguinte forma: Gere um token de Autenticação (consulte Para criar um token de Autenticação na Documentação do Oracle Cloud Infrastructure). Em Nome de Usuário, insira o nome de usuário do OCI para o qual o token de Autenticação foi gerado. Em Senha, insira o token de Autenticação gerado. Este parâmetro faz distinção entre maiúsculas e minúsculas.
     Chave de Assinatura de API
     OCID da Tenancy OCID do Usuário Impressão Digital de Chave Pública Upload de Chave Privada	Credenciais necessárias para uma Chave de Assinatura de API, da seguinte forma: No console do Oracle Cloud, gere uma Chave de Assinatura de API. Consulte Como Gerar uma Chave de Assinatura de API no Guia do Desenvolvedor da Oracle Cloud Infrastructure. No console, faça download da chave privada e salve-a no diretório .oci. Em seguida, clique em Adicionar. Os parâmetros da chave de assinatura são exibidos no console. Copie os seguintes parâmetros do console e cole-os no Cloud EDM: Em OCID da Tenancy, cole o valor tenancy no console. Em OCID da Tenancy, cole o valor user no console. Em Impressão Digital de Chave Pública, cole o valor fingerprint do console. Em Upload de Chave Privada, clique em Fazer Upload e faça upload do arquivo de chave privada que você fez download na etapa b.
     Bucket Padrão (Opcional) Observação: Este campo é obrigatório para testar sua conexão.	Contêiner para armazenar o arquivo extraído dentro do namespace do armazenamento de objetos. Este parâmetro faz distinção entre maiúsculas e minúsculas.
     Subpasta Padrão (Opcional)	Subpasta no Bucket Padrão para gravar o arquivo de extração. Se a subpasta especificada não existir, ela será criada. Este parâmetro faz distinção entre maiúsculas e minúsculas.

5. (Opcional): em Aplicativos Suportados, clique em Especificados e depois selecione os aplicativos que podem usar essa conexão global.
6. Clique em Testar Conexão para validar os detalhes da conexão.

   Nota:

   Para conexões do Armazenamento de Objetos da Oracle, insira um Bucket Padrão para testar a conexão.
7. Clique em Salvar.

   Nota:

   Todos os problemas devem ser corrigidos em todas as conexões antes de salvar as conexões. Se houver quaisquer campos obrigatórios ausentes nos detalhes da conexão de quaisquer conexões, um indicador é exibido nessa conexão e um erro é exibido para informar que uma ou mais conexões apresentam problemas que devem ser corrigidos.

Para excluir uma conexão global, na coluna Ações, clique em e depois clique em Excluir. Não é possível excluir uma conexão global que esteja sendo usada por uma extração. Não será possível excluir uma conexão global do Serviço de Verificação de Endereço, E-mail e Telefone da Oracle se ela estiver sendo usada por uma propriedade de Endereço.