Preparar a conexão com o aplicativo ERP

Para estabelecer conexão com o aplicativo Oracle Cloud ERP, você deve:

Satisfaça determinados pré-requisitos
Obter o URL do WSDL ou do catálogo de eventos
Designar as atribuições necessárias a um usuário
Configurar o Oracle Cloud ERP para assinaturas de eventos
Revise o procedimento para fazer upload de arquivos

Pré-requisitos para Criar uma Conexão

Você deve atender aos pré-requisitos a seguir para criar uma conexão com o Oracle Cloud ERP Adapter.

Pré-requisito	Descrição
Inscreva-se no Oracle Cloud ERP	Esta ação permite criar uma conta de usuário do Oracle Cloud ERP com os privilégios corretos. Você especifica essa conta de usuário ao criar uma conexão do Oracle Cloud ERP na página Conexões.
Obtenha o URL WSDL necessário do serviço do catálogo de serviços do Oracle Cloud ERP ou o URL do catálogo de eventos	Você deve especificar um WSDL de serviço do catálogo de serviços do Oracle Cloud ERP obrigatório (para acessar objetos de negócios) e, opcionalmente, um URL do catálogo de eventos (para assinar eventos).
Designar atribuições ao usuário	Certifique-se de que o usuário do Oracle Fusion Cloud Applications tenha as atribuições necessárias. Essas atribuições são necessárias para ativar assinaturas de eventos ou selecionar objetos de negócios.
Assine eventos no Oracle Cloud ERP	Para assinar eventos do Oracle Cloud ERP em uma integração, você deve criar uma chave CSF. Crie a chave CSF da instância do Oracle SOA Composer localizada no domínio do Oracle Fusion Cloud Supply Chain & Manufacturing (SCM).
Fazer upload de arquivos em massa e inserir dados nas tabelas do aplicativo Oracle Cloud ERP	O Adaptador do Oracle Cloud ERP suporta o carregamento de dados em massa no Oracle Cloud ERP por meio da integração com o Oracle WebCenter Content. O Oracle WebCenter Content permite que você execute upload em massa de arquivos e inserção de dados nas tabelas de aplicativos do Oracle Cloud ERP.
Fazer upload de arquivos para o Oracle WebCenter Content	O Adaptador do Oracle Cloud ERP suporta o carregamento de arquivos no Oracle WebCenter Content.

Obter o WSDL do Serviço do Oracle Cloud ERP

Você deve obter o WSDL do catálogo de serviços do Oracle Cloud ERP para acessar e configurar o adaptador de entrada e saída para usar objetos de negócios ou serviços de negócios.

Para configurar o Adaptador do Oracle Cloud ERP, você precisa do WSDL serviceCatalog. O WSDL serviceCatalog é um catálogo de todos os serviços expostos pela instância do Oracle Cloud ERP. O catálogo expõe serviços de todos os produtos, como finanças, gerenciamento de projetos, gerenciamento de pedidos, gerenciamento de estoque etc.

Para o Oracle Cloud ERP, o URL WSDL do catálogo de serviços é:

https://ERP_Host_Name.fs.<data center>.oraclecloud.com/fscmService/ServiceCatalogService?WSDL

Atribuir Funções Obrigatórias a um Usuário de Integração

Para usar o Adaptador do Oracle Cloud ERP em uma integração, você deve atribuir funções específicas a um usuário de integração.

Use a Console de Segurança para gerenciar a segurança do aplicativo, como atribuições, usuários, certificados e tarefas de administração. O acesso à Console de Segurança é fornecido pela atribuição predefinida Gerenciador de Segurança. Acesse a Console de Segurança da seguinte forma:

Use as tarefas Gerenciar Funções de Cargo ou Gerenciar Responsabilidades na área de trabalho Configuração e Manutenção.
No menu Navegador, selecione Ferramentas.

Selecione Console de Segurança.

Configurar o Oracle Cloud ERP para Assinaturas de Evento

Você deve criar uma chave CSF para se inscrever em eventos no Oracle Cloud ERP. Essa chave é exigida pela estrutura do processador de eventos quando ela chama a integração. As credenciais da integração são gerenciadas pela chave CSF. Crie a chave CSF no Oracle SOA Composer.

Certifique-se de especificar as seguintes informações corretamente ao criar a chave CSF:

Crie o nome da chave CSF. O nome deve ser uma combinação do ID do Oracle Identity Cloud Service e do nome da instância de integração.
1. No canto superior direito do Oracle Integration, clique em e, em seguida, clique em Sobre.
2. Copie o valor do Domínio de Identidades (por exemplo, idcs-638a2ce020e60c2881) e o valor da Instância de Serviço (por exemplo, oic1575).
3. Monte o valor da chave CSF com o domínio de identidades primeiro e a segunda instância de serviço (sem espaço entre): idcs-638a2ce020e60c2881oic1575.
Crie a chave CSF com a conta de usuário do Oracle Integration com a qual você acessa o Oracle Integration e não o nome de usuário criado quando você se inscreveu no Oracle Cloud ERP.
Certifique-se de que a senha da chave CSF não expirou.

Configurar o Oracle Cloud ERP:

Faça log-in no Oracle SOA Composer com um usuário que tenha a atribuição de administrador do SOA. Obtenha o hostname e o port do seu administrador.
Por exemplo, o URL do SOA Composer é:
```
 https://ERP_instance_name.fa.data center.oraclecloud.com/soa/composer
```
Clique em Gerenciar Segurança.
Adicione o nome da chave CSF.
Forneça o nome de usuário e a senha informados para acessar o Oracle Integration.
Não informe o nome de usuário e a senha criados quando você se inscreveu no Oracle Cloud ERP. O usuário do Oracle Integration deve existir no Oracle Integration e deve ter a atribuição ServiceUser. A entrada de chave CSF na infraestrutura do Oracle Cloud ERP armazena as credenciais do Oracle Integration usadas pelo Oracle Cloud ERP. Quando o Oracle Fusion Cloud Applications envia solicitações de saída para o Oracle Integration (no runtime), ele envia as credenciais (nome de usuário e senha) desta conta para autenticação.
Clique em Registrar.

Fazer Upload de Arquivos em Massa e Inserir Dados nas Tabelas de Aplicativos do Oracle Cloud ERP

Você deve atender aos seguintes pré-requisitos de upload de arquivos em massa e, em seguida, inserir dados nas tabelas do aplicativo Oracle Cloud ERP.

Crie um usuário semelhante ao usuário de conexão do Adaptador do ERP Cloud na Página Meu Serviço. Este usuário está vinculado ao realm de segurança do Oracle Integration WebLogic. O nome de usuário deve corresponder exatamente ao nome de usuário do Oracle Cloud ERP. A senha e o endereço de e-mail podem ser qualquer coisa. Certifique-se de selecionar as atribuições corretas para o usuário do Oracle Cloud ERP no aplicativo Oracle Cloud ERP. O usuário deve ter as atribuições SOAOperator e Integração.
Importe os certificados necessários. Em seu browser, informe o URL WSDL do Catálogo de Serviços:
- O URL WSDL é:
```
https://hostname:port/fscmService/ServiceCatalogService?WSDL
```

No WSDL, navegue até a seção de certificados X509, encontrada no elemento <dsig:x509Data>. Veja exemplo a seguir:

</wsdl:binding>
    <wsdl:service name="ErpIntegrationService"
        <wsdl:port name="ErpIntegrationServiceSoapHttpPort" binding="tns:ErpIntegrationServiceSoapHttpPort"/>
            <soap:address location="https://hostname:port/fscmService/ErpIntegrationService"/>
            <wsa:EndpointReference xmlns:wsa="http://www.w3.org/2005/08/addressing">
            <wsa:Address xmlna:wsa="http://www.w3.org/2005/08/addressing">
                https://hostname:port/fscmService/ErpIntegrationService
            <wsa:Address>
            <wsid:Identity xmlns:wsis="http://schemas.xmlsoap.org/ws/2006/02/addressingidentity">
                <dsig:KeyInfo xmlns:dsig="http://www.w3.org/2000/09/xmldsig#">
                    <dsig:X509Data>
                        <dsig:X509Certificate>
                        //Copy certificate 1
                        djfhisjfjkjs4637rYiucy4r84378495847ydfiu678ww7789474re873477HSsfyGkwe3847qdi378TY
                        </dsig:X509Certificate>
                        <dsig:X509IssuerSerial>
                            <dsig:X509IssuerName>CN=Cloud9CA-2, DC=cloud, DC=oracle, DC=com</dsig:X509IssuerName>
                            <dsig:X509IssuerSerialNumber>45631179900002566</dsig:X509IssuerSerialNumber>
                        </dsig:X509IssuerSerial>
                        <dsig:X509SubjectName>CN=FAEncryption, DC=cloud, DC=oracle, DC=com</dsig:X509SubjectName>
                        <dsig:X509SKI>aKdfjjkrueTY46372NeiHJ</dsig:X509SKI>
                        <dsig:X509Certificate>
                        //Copy certificate 2
                        jhKIp9845eiseroi4d9Jl094osie9r9w309cw0890w4809589348f958985e098siHDD985983558KJj9
                        </dsig:X509Certificate>
                  </dsig:X509Data>
               </dsig:KeyInfo>
             </wsid:Identity>
           </wsa:EndpointReference>
         </wsdl:port>
       </wsdl:service>
    </wsdl:definitions>

Copie a primeira e a segunda string de certificado para dois arquivos separados. Por exemplo, erp_cert1.cer e erp_cert2.cer.
Na caixa de diálogo Fazer Upload do Certificado, no Oracle Integration, importe os dois certificados como tipos de Certificado de Proteção de Mensagem e informe nomes de alias exclusivos.
Atenda às seguintes recomendações de arquivo de manifesto (ou seja, o arquivo de propriedades no arquivo ZIP que deve ser submetido a upload para o Oracle WebCenter Content para o upload em massa de arquivos e a inserção de dados nas tabelas de aplicativos do Oracle Cloud ERP. Esta etapa só é necessária para um callback do ERP Cloud após a conclusão do job.
- O arquivo de manifesto espera detalhes do processo de importação no seguinte formato:
```
job package name,job def name,manifest file name,job parameters (comma separated)
```
  Por exemplo:
```
oracle/apps/ess/financials/payables/invoices/transactions,APXIIMPT,AP,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,INVOICE
```
- O nome do arquivo de manifesto deverá ser um prefixo do nome do arquivo ZIP real se ele contiver _. Caso contrário, deve ser apenas o nome. Por exemplo, se o nome do arquivo ZIP for AP_301.zip, o nome do arquivo de manifesto deverá ser AP.properties e o terceiro valor no manifesto deverá ser o nome do arquivo de manifesto. Se o nome do arquivo ZIP for AP.zip, o nome do arquivo de manifesto deverá ser AP.properties e o terceiro valor no manifesto deverá ser o nome do arquivo de manifesto.
- Somente um job é suportado por ação de chamada. Você pode ter várias entradas no arquivo de propriedade do manifesto para importar dados da tabela de interface para as tabelas de aplicativos em lotes de até 10 para processamento sequencial ou até 5 para processamento paralelo. Por exemplo, o arquivo de dados de importação de lançamento tem registros de 10 razões. O arquivo de propriedades tem 10 entradas com o nome exclusivo do razão como um parâmetro. Depois que o arquivo de dados é carregado na tabela da interface, o processo de importação tem 10 subprocessos para cada razão.
Atenda aos seguintes pré-requisitos para configurar a integração que usa o recurso de importação em massa:
Mapeie os seguintes parâmetros para o Adaptador do Oracle Cloud ERP:
- Mapeie o parâmetro ICSFileReference para o parâmetro File Reference do outro adaptador (por exemplo, o Adaptador FTP, o Adaptador REST ou qualquer adaptador usado que tenha o parâmetro ICSFileReference).
- Mapeie o parâmetro FileName do esquema de origem para o esquema de destino (o esquema de destino é o esquema de importação em massa do Oracle Cloud ERP). O FileName deve ser exclusivo para cada solicitação.