Prepárese para conectarse a la aplicación ERP

Para conectarse a la aplicación Oracle Cloud ERP, debe:

  • Satisfacer ciertos requisitos
  • Obtener URL de catálogo de eventos o WSDL
  • Asignar roles necesarios a un usuario
  • Configurar Oracle Cloud ERP para suscripciones a eventos
  • Revisar el procedimiento para cargar archivos

Requisitos para crear una conexión

Debe cumplir los siguientes requisitos previos para crear una conexión con el adaptador de Oracle Cloud ERP.

Requisito Descripción
Suscripción a Oracle Cloud ERP Esta acción permite crear una cuenta de usuario de Oracle Cloud ERP con los privilegios correctos. Especifique esta cuenta de usuario al crear una conexión de Oracle Cloud ERP en la página Conexiones.
Obtenga la URL de WSDL del servicio de catálogo de servicios de Oracle Cloud ERP necesaria o la URL del catálogo de eventos Debe especificar un WSDL de servicio de catálogo de servicios de Oracle Cloud ERP obligatorio (para acceder a objetos de negocio) y, opcionalmente, una URL de catálogo de eventos (para suscribirse a eventos).
Asignar roles al usuario Asegúrese de que el usuario de Oracle Fusion Cloud Applications tenga los roles necesarios. Estos roles son necesarios para activar las suscripciones a eventos o seleccionar objetos de negocio.
Suscripción a eventos en Oracle Cloud ERP Para suscribirse a eventos de Oracle Cloud ERP en una integración, debe crear una clave CSF. Cree la clave CSF de la instancia de Oracle SOA Composer ubicada en el dominio Oracle Fusion Cloud Supply Chain & Manufacturing (SCM).
Cargar archivos en bloque e insertar datos en las tablas de la aplicación de Oracle Cloud ERP

El adaptador de Oracle Cloud ERP soporta la carga de datos en bloque en Oracle Cloud ERP mediante la integración con Oracle WebCenter Content. Oracle WebCenter Content permite realizar la carga en bloque de archivos e inserción de datos en tablas de aplicación de Oracle Cloud ERP.

Cargar Archivos en Oracle WebCenter Content

El adaptador de Oracle Cloud ERP soporta la carga de archivos en Oracle WebCenter Content.

Obtener el WSDL del servicio de Oracle Cloud ERP

Debe obtener el WSDL del catálogo de servicios de Oracle Cloud ERP para acceder y configurar el adaptador entrante y saliente para utilizar objetos de negocio o servicios de negocio.

Para configurar el adaptador de Oracle Cloud ERP, necesita el WSDL serviceCatalog. El WSDL serviceCatalog es un catálogo de todos los servicios expuestos por la instancia de Oracle Cloud ERP. El catálogo expone servicios de todos los productos, como finanzas, gestión de proyectos, gestión de órdenes, gestión de inventario, etc.

Para Oracle Cloud ERP, la URL de WSDL del catálogo de servicios es:

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

Asignar roles necesarios a un usuario de integración

Para utilizar el adaptador de Oracle Cloud ERP en una integración, debe asignar roles específicos a un usuario de integración.

Utilice la consola de seguridad para gestionar la seguridad de la aplicación, como roles, usuarios, certificados y tareas de administración. El acceso a la consola de seguridad lo proporciona el rol predefinido de Gestor de seguridad. Acceda a la consola de seguridad de la siguiente manera:

  • Use las tareas Gestionar roles de puesto o Gestionar tareas en el área de trabajo Configuración y mantenimiento.

  • En el menú Navegador, seleccione Herramientas.

    Seleccione Consola de seguridad.

Configurar Oracle Cloud ERP para suscripciones a eventos

Debe crear una clave CSF para suscribirse a eventos en Oracle Cloud ERP. Esta clave la necesita el marco del manejador de eventos cuando llama a la integración. Las credenciales de la integración se gestionan mediante la clave CSF. Cree la clave CSF en Oracle SOA Composer.

Asegúrese de especificar la siguiente información correctamente al crear la clave CSF:
  • Cree el nombre de la clave CSF. El nombre debe ser una combinación del ID de Oracle Identity Cloud Service y el nombre de la instancia de integración.

    1. En la esquina superior derecha de Oracle Integration, haga clic en menú de nombre de usuario y, a continuación, en Acerca de.

    2. Copie el valor de Dominio de identidad (por ejemplo, idcs-638a2ce020e60c2881) y el valor de Instancia de servicio (por ejemplo, oic1575).

    3. Ensamble el valor de clave CSF con el dominio de identidad primero y la instancia de servicio en segundo lugar (sin espacio intermedio): idcs-638a2ce020e60c2881oic1575.

  • Cree la clave CSF con la cuenta de usuario de Oracle Integration con la que se conecta a Oracle Integration y no el nombre de usuario creado al suscribirse a Oracle Cloud ERP.

  • Asegúrese de que la contraseña de clave CSF no haya caducado.

Configure Oracle Cloud ERP:

  1. Conéctese a Oracle SOA Composer con un usuario que tenga el rol de administrador de SOA. Obtenga hostname y port del administrador.
    Por ejemplo, la URL de SOA Composer es:
     https://ERP_instance_name.fa.data center.oraclecloud.com/soa/composer
  2. Haga clic en Gestionar seguridad.
  3. Agregue el nombre de la clave CSF.
  4. Proporcione el nombre de usuario y la contraseña que introduzca para conectarse a Oracle Integration.
    No introduzca el nombre de usuario y la contraseña creados al suscribirse a Oracle Cloud ERP. El usuario de Oracle Integration debe existir en Oracle Integration y debe tener asignado el rol ServiceUser. La entrada de clave CSF de la infraestructura de Oracle Cloud ERP almacena las credenciales de Oracle Integration utilizadas por Oracle Cloud ERP. Cuando Oracle Fusion Cloud Applications envía solicitudes salientes a Oracle Integration (en tiempo de ejecución), envía las credenciales (nombre de usuario y contraseña) de esta cuenta para la autenticación.
  5. Haga clic en Registrar.

Cargar archivos en bloque e insertar datos en tablas de aplicación de Oracle Cloud ERP

Debe cumplir los siguientes requisitos para cargar archivos en bloque y, a continuación, insertar datos en las tablas de la aplicación Oracle Cloud ERP.

  1. Cree un usuario similar al usuario de conexión del adaptador de ERP Cloud en la página Mi servicio. Este usuario está enlazado al dominio de seguridad WebLogic de Oracle Integration. El nombre de usuario debe coincidir exactamente con el nombre de usuario de Oracle Cloud ERP. La contraseña y la dirección de correo electrónico pueden ser cualquier cosa. Asegúrese de seleccionar los roles correctos para el usuario de Oracle Cloud ERP en la aplicación Oracle Cloud ERP. El usuario debe tener los roles SOAOperator e Integración.
  2. Importe los certificados necesarios. En el explorador, introduzca la URL de WSDL del catálogo de servicios:
    • La dirección URL de WSDL es:
      https://hostname:port/fscmService/ServiceCatalogService?WSDL
  3. En WSDL, navegue a la sección de certificados X509, que se encuentra en el elemento <dsig:x509Data>. Por ejemplo:
    </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. Copie la primera y la segunda cadena de certificados en dos archivos independientes. Por ejemplo, erp_cert1.cer y erp_cert2.cer.
  5. En el cuadro de diálogo Cargar certificado, en Oracle Integration, importe ambos certificados como tipos de Certificado de protección de mensajes e introduzca nombres de alias únicos.
  6. Satisfaga las siguientes recomendaciones de archivos de manifiesto (es decir, el archivo de propiedades del archivo ZIP que se debe cargar en Oracle WebCenter Content para la carga masiva de archivos y la inserción de datos en las tablas de la aplicación Oracle Cloud ERP. Este paso solo es necesario para una devolución de llamada de ERP Cloud al finalizar el trabajo.
    • El archivo de manifiesto espera los detalles del proceso de importación con el siguiente formato:

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

      Por ejemplo:

      oracle/apps/ess/financials/payables/invoices/transactions,APXIIMPT,AP,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,#NULL,INVOICE
    • El nombre de archivo de manifiesto debe ser un prefijo del nombre de archivo ZIP real si contiene _. De lo contrario, solo debería ser el nombre. Por ejemplo, si el nombre de archivo ZIP es AP_301.zip, el nombre de archivo de manifiesto debe ser AP.properties y el tercer valor del manifiesto debe ser el nombre de archivo de manifiesto. Si el nombre de archivo ZIP es AP.zip, el nombre de archivo de manifiesto debe ser AP.properties y el tercer valor del manifiesto debe ser el nombre de archivo de manifiesto.

    • Solo se admite un trabajo por acción de llamada. Puede tener varias entradas en el archivo de propiedades de manifiesto para importar datos de la tabla de interfaz a las tablas de aplicaciones en lotes de hasta 10 para el procesamiento secuencial o de hasta 5 para el procesamiento paralelo. Por ejemplo, el archivo de datos de importación de asientos tiene registros de 10 libros mayores. El archivo de propiedades tiene 10 entradas con el nombre de libro mayor único como parámetro. Una vez cargado el archivo de datos en la tabla de interfaz, el proceso de importación tiene 10 subprocesos para cada libro mayor.

  7. Cumpla los siguientes requisitos previos para configurar la integración que utiliza la función de importación masiva:
    Asigne los siguientes parámetros al adaptador de Oracle Cloud ERP:
    • Asigne el parámetro ICSFileReference al parámetro File Reference desde el otro adaptador (por ejemplo, el adaptador FTP, el adaptador REST o cualquier adaptador utilizado que tenga el parámetro ICSFileReference).

    • Asigne el parámetro FileName del esquema de origen al esquema de destino (el esquema de destino es el esquema de importación masiva de Oracle Cloud ERP). FileName debe ser único para cada solicitud.