Prepararsi alla connessione all'applicazione ERP

Per connettersi all'applicazione Oracle Cloud ERP, è necessario effettuare le operazioni riportate di seguito.

  • Soddisfa determinati prerequisiti
  • Ottenere l'URL WSDL o del catalogo eventi
  • Assegnare ruoli obbligatori a un utente
  • Configura Oracle Cloud ERP per le sottoscrizioni agli eventi
  • Esaminare la procedura per il caricamento dei file

Prerequisiti per la creazione di una connessione

Per creare una connessione con l'adattatore Oracle Cloud ERP, è necessario soddisfare i prerequisiti riportati di seguito.

Prerequisito Descrizione
Iscriviti a Oracle Cloud ERP Questa azione consente di creare un account utente Oracle Cloud ERP con i privilegi corretti. Specificare questo account utente quando si crea una connessione di Oracle Cloud ERP nella pagina Connessioni.
Ottenere l'URL WSDL del servizio del catalogo servizi Oracle Cloud ERP o l'URL del catalogo eventi necessario È necessario specificare un WSDL del servizio del catalogo dei servizi Oracle Cloud ERP obbligatorio (per accedere ai business object) e facoltativamente un URL del catalogo eventi (per la sottoscrizione agli eventi).
Assegna ruoli all'utente Assicurarsi che l'utente di Oracle Fusion Cloud Applications disponga dei ruoli richiesti. Questi ruoli sono necessari per abilitare le sottoscrizioni agli eventi o selezionare i business object.
Iscriviti agli eventi in Oracle Cloud ERP Per effettuare la sottoscrizione agli eventi Oracle Cloud ERP in un'integrazione, è necessario creare una chiave CSF. Creare la chiave CSF dall'istanza di Oracle SOA Composer presente nel dominio Oracle Fusion Cloud Supply Chain and Manufacturing (SCM).
Caricare i file in massa e inserire i dati nelle tabelle dell'applicazione Oracle Cloud ERP

L'adattatore Oracle Cloud ERP supporta il caricamento di dati di massa in Oracle Cloud ERP tramite l'integrazione con Oracle WebCenter Content. Oracle WebCenter Content consente di eseguire il caricamento di massa dei file e l'inserimento dei dati nelle tabelle dell'applicazione Oracle Cloud ERP.

Caricare i file in Oracle WebCenter Content

L'adattatore Oracle Cloud ERP supporta il caricamento dei file in Oracle WebCenter Content.

Ottieni WSDL del servizio Oracle Cloud ERP

È necessario ottenere il WSDL del catalogo dei servizi Oracle Cloud ERP per accedere e configurare l'adattatore in entrata e in uscita per utilizzare business object o servizi business.

Per configurare l'adattatore Oracle Cloud ERP, è necessario il WSDL serviceCatalog. WSDL serviceCatalog è un catalogo di tutti i servizi esposti dall'istanza di Oracle Cloud ERP. Il catalogo espone i servizi di tutti i prodotti, ad esempio finanza, project management, gestione ordini, gestione magazzino e così via.

Per Oracle Cloud ERP, l'URL WSDL del catalogo servizi è:

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

Assegna ruoli obbligatori a un utente di integrazione

Per utilizzare l'adattatore Oracle Cloud ERP in un'integrazione, è necessario assegnare ruoli specifici a un utente di integrazione.

Utilizzare la console di sicurezza per gestire la sicurezza dell'applicazione, ad esempio ruoli, utenti, certificati e task di amministrazione. L'accesso alla console di sicurezza viene fornito dal ruolo predefinito di Security Manager. Accedere alla Console sicurezza come indicato di seguito.

  • Utilizzare i task Gestisci ruoli mansione o Gestisci responsabilità nell'area di lavoro Impostazione e manutenzione.

  • Dal menu Navigator selezionare Strumenti.

    Selezionare Security Console.

Configura Oracle Cloud ERP per le sottoscrizioni agli eventi

È necessario creare una chiave CSF per effettuare la sottoscrizione agli eventi in Oracle Cloud ERP. Questa chiave è richiesta dal framework del gestore di eventi quando richiama l'integrazione. Le credenziali dell'integrazione vengono gestite dalla chiave CSF. Creare la chiave CSF in Oracle SOA Composer.

Assicurarsi di specificare correttamente le seguenti informazioni durante la creazione della chiave CSF:
  • Creare il nome della chiave CSF. Il nome deve essere una combinazione dell'ID Oracle Identity Cloud Service e del nome dell'istanza di integrazione.

    1. Nell'angolo in alto a destra di Oracle Integration fare clic su menu utente, quindi su Informazioni.

    2. Copiare il valore del dominio di Identity (ad esempio, idcs-638a2ce020e60c2881) e il valore dell'istanza del servizio (ad esempio, oic1575).

    3. Assemblare prima il valore della chiave CSF con il dominio di Identity e la seconda istanza del servizio (nessun intervallo tra): idcs-638a2ce020e60c2881oic1575.

  • Creare la chiave CSF con l'account utente di Oracle Integration al quale si accede a Oracle Integration e non con il nome utente creato al momento della sottoscrizione a Oracle Cloud ERP.

  • Assicurarsi che la password della chiave CSF non sia scaduta.

Configura Oracle Cloud ERP:

  1. Eseguire il login a Oracle SOA Composer con un utente che dispone del ruolo di amministratore SOA. Richiedere hostname e port all'amministratore.
    L'URL di SOA Composer, ad esempio, è:
     https://ERP_instance_name.fa.data center.oraclecloud.com/soa/composer
  2. Fare clic su Gestisci sicurezza.
  3. Aggiungere il nome della chiave CSF.
  4. Fornire il nome utente e la password immessi per collegarsi a Oracle Integration.
    Non immettere il nome utente e la password creati al momento della sottoscrizione a Oracle Cloud ERP. L'utente di Oracle Integration deve esistere in Oracle Integration e deve essere assegnato al ruolo ServiceUser. La voce relativa alla chiave CSF nell'infrastruttura Oracle Cloud ERP memorizza le credenziali di Oracle Integration utilizzate da Oracle Cloud ERP. Quando Oracle Fusion Cloud Applications invia richieste in uscita a Oracle Integration (in runtime), invia le credenziali (nome utente e password) di questo account per l'autenticazione.
  5. Fare clic su Registra.

Carica file in massa e inserisci dati nelle tabelle dell'applicazione Oracle Cloud ERP

È necessario soddisfare in blocco i file di caricamento dei prerequisiti riportati di seguito, quindi inserire i dati nelle tabelle dell'applicazione Oracle Cloud ERP.

  1. Creare un utente simile all'utente di connessione dell'adattatore ERP Cloud nella pagina My Service. Questo utente è collegato al realm di sicurezza Oracle Integration WebLogic. Il nome utente deve corrispondere esattamente al nome utente di Oracle Cloud ERP. La password e l'indirizzo e-mail possono essere qualunque cosa. Assicurarsi di selezionare i ruoli corretti per l'utente Oracle Cloud ERP nell'applicazione Oracle Cloud ERP. L'utente deve disporre dei ruoli SOAOperator e Integrazione.
  2. Importare i certificati necessari. Nel browser, immettere l'URL WSDL del catalogo servizi:
    • L'URL WSDL è:
      https://hostname:port/fscmService/ServiceCatalogService?WSDL
  3. Nel documento WSDL, passare alla sezione Certificati X509, disponibile nell'elemento <dsig:x509Data>. Di seguito è riportato un esempio:
    </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>
  4. Copiare la prima e la seconda stringa di certificato in due file separati. Ad esempio, erp_cert1.cer e erp_cert2.cer.
  5. Nella finestra di dialogo Carica certificato, in Oracle Integration, importare entrambi i certificati come tipi di Certificato di protezione messaggi e immettere nomi alias univoci.
  6. Soddisfare i seguenti suggerimenti relativi ai file manifest (ovvero il file delle proprietà nel file ZIP che deve essere caricato in Oracle WebCenter Content per il caricamento di massa dei file e l'inserimento dei dati nelle tabelle dell'applicazione Oracle Cloud ERP. Questo passo è necessario solo per un callback di ERP Cloud al completamento del job.
    • Il file manifesto prevede i dettagli del processo di importazione nel seguente formato:

      job package name,job def name,manifest file name,job parameters (comma separated)

      Ad esempio:

      oracle/apps/ess/financials/payables/invoices/transactions,APXIIMPT,AP,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,INVOICE
    • Il nome del file manifesto deve essere un prefisso del nome effettivo del file ZIP se contiene _. Altrimenti, dovrebbe essere solo il nome. Se ad esempio il nome del file ZIP è AP_301.zip, il nome del file manifesto deve essere AP.properties e il terzo valore nel manifesto deve essere il nome del file manifesto. Se il nome del file ZIP è AP.zip, il nome del file manifesto deve essere AP.properties e il terzo valore nel manifesto deve essere il nome del file manifesto.

    • È supportato un solo job per azione di richiamo. Nel file delle proprietà del manifesto possono essere presenti più voci per importare i dati dalla tabella di interfaccia alle tabelle di applicazioni in batch fino a 10 per l'elaborazione sequenziale o fino a 5 per l'elaborazione parallela. Ad esempio, il file di dati di importazione delle scritture contabili contiene record di 10 libri contabili. Il file delle proprietà contiene 10 voci con il nome univoco del libro contabile come parametro. Dopo il caricamento del file di dati nella tabella di interfaccia, il processo di importazione ha 10 sottoprocessi per ogni libro contabile.

  7. Soddisfare i prerequisiti riportati di seguito per configurare l'integrazione che utilizza la funzione di importazione di massa.
    Mappare i seguenti parametri all'adattatore Oracle Cloud ERP:
    • Mappare il parametro ICSFileReference al parametro File Reference dall'altro adattatore (ad esempio, l'adattatore FTP, l'adattatore REST o qualsiasi adattatore utilizzato con il parametro ICSFileReference).

    • Eseguire il mapping del parametro FileName dallo schema di origine allo schema di destinazione (lo schema di destinazione è lo schema di importazione di massa di Oracle Cloud ERP). Il valore FileName deve essere univoco per ogni richiesta.