Creación de conexiones globales

Las conexiones globales permiten que Oracle Fusion Cloud Enterprise Data Management se integre con sistemas externos. Algunos tipos de conexión global se utilizan para compartir datos con aplicaciones externas, mientras que otros se utilizan para enviar datos a servicios externos para su validación y verificación.

Están soportados los tipos de conexión siguientes:

  • Validación externa: envía la información de la solicitud a un sistema externo mediante una llamada a la API de REST y recibe la información de validación.
  • Microsoft Azure Blob Storage: envíe datos a un contenedor de archivos de Microsoft Azure Blob Storage.
  • Oracle Address, Email, and Phone Verification: verifique las direcciones de las solicitudes conectándose a un servicio de verificación externa.
  • Oracle Cloud EPM: envíe datos a un buzón de Enterprise Performance Management para que los utilice un proceso de importación de metadatos.
  • Oracle Cloud ERP: envíe datos a una cuenta de documento de Universal Content Management (UCM) para que los utilice un proceso de Importación de datos basada en archivos (FBDI).
  • Oracle Object Storage: actúa como adaptadores de tecnología para sistemas externos de uso más general.

Casos de uso

Uso compartido de datos

  • Las conexiones globales a Microsoft Azure Blob Storage se pueden utilizar para transferir la salida desde extracciones y paquetes de extracciones a un contenedor de archivos de Microsoft Azure Blob Storage.
  • Las conexiones globales a Oracle Cloud ERP se pueden utilizar para transferir datos, como combinaciones de cuentas, conjuntos de asignaciones y conjuntos de valores relacionados, para su importación en Financials Cloud.
  • Las conexiones globales a Oracle Cloud EPM se pueden utilizar de las siguientes maneras:
    • Las aplicaciones Universal que gestionan el proceso de negocio Account Reconciliation pueden utilizar conexiones globales para enviar perfiles al buzón de la aplicación.
    • Las aplicaciones Universal que gestionan dimensiones para el proceso de negocio Profitability and Cost Management pueden utilizar conexiones globales para enviar archivos de metadatos a profitinbox.
    • Para enviar archivos de asignación a un buzón de Data Management

Validación y verificación

Puede restringir tipos de conexión de modo que solo puedan utilizarlos aplicaciones específicas de Cloud EDM. Las conexiones globales a Oracle Address, Email, and Phone Verification se aplican a todas las aplicaciones.

Creación de una conexión global

Nota:

Debe ser administrador del servicio para crear conexiones globales.

Consideraciones

  • Después de crear una conexión global, puede utilizarla en una extracción. Puede utilizar una conexión global en varias extracciones, pero cada extracción solo puede utilizar una conexión global.

    Nota:

    No puede utilizar un tipo de conexión de Oracle Address, Email, and Phone Verification en una extracción.
  • No puede cambiar el tipo de conexión después de crear una conexión global.
  • Las conexiones globales no se utilizan para importaciones y exportaciones de aplicaciones. En su lugar se utiliza la información de conexión de la aplicación que haya especificado al registrar la aplicación.

  • Los parámetros que especifique para una conexión global están determinados por el tipo de conexión.
  • Las conexiones globales a las aplicaciones Oracle Cloud EPM y Oracle Cloud ERP soportan la autenticación básica y de OAuth2. Debe registrar un cliente de OAuth2 para cada conexión global. Consulte Uso de OAuth2 para conexiones globales y de aplicación.
  • Las conexiones globales a Oracle Object Storage soportan la autenticación básica y la autenticación de clave de firma de API.
  • La conexión global a Oracle Address, Email, and Phone Verification solo soporta la autenticación OAuth2.
  • Las conexiones globales para validaciones externas solo soportan la autenticación básica.

Para crear una conexión global:

  1. En el cluster Conexiones, haga clic en Crear.
  2. Seleccione el tipo de conexión:
    • Validación externa
    • Microsoft Azure Blob Storage
    • Oracle Address, Email, and Phone Verification

      Nota:

      Solo puede crear una conexión global para Oracle Address, Email y Phone Verification.
    • Oracle Cloud EPM
    • Oracle Cloud ERP
    • Oracle Object Storage
  3. Introduzca un nombre y, si lo desea, una descripción para la conexión y, a continuación, haga clic en Crear.

    La conexión global se muestra en el inspector de conexiones.

  4. Haga clic en Editar y especifique los parámetros para la conexión. Los parámetros que especifique dependen del tipo de conexión:
    • Parámetros de validación externa:
      Campo Descripción
      Ubicación URL al punto final de REST de validación externa. Se realiza una operación GET para probar la conexión y una operación POST para ejecutar una validación.

      Ejemplo: https://externalhostname.example.com/api/rest/externalValidation

      Nombre de usuario/contraseña Credenciales para la autenticación básica.
      Tamaño máximo de lote Número máximo de nodos que debe validar el sistema externo en un único lote, hasta un valor de 10 000. El valor predeterminado es 1,000.
      Máximo de procesos simultáneos Número máximo de procesos de validación simultáneos que debe ejecutar el sistema externo, hasta un valor de 3. El valor predeterminado es 1.
    • Parámetros de Microsoft Azure Blob Storage:
      Campo Descripción
      Ubicación URL de la cuenta de Microsoft Azure Blob Storage. Por ejemplo: https://myblobstorageaccount.blob.core.windows.net

      Nota: La URL debe contener el nombre de su cuenta de Azure Blob Storage (myblobstorageaccount en el ejemplo anterior). Esta cuenta debe tener la asignación de rol Storage Blob Data Contributor en Azure.

      ID de inquilino ID de inquilino del registro de aplicación en el inquilino de Microsoft Azure.
      ID de cliente ID de aplicación (cliente) de un principal de servicio en el inquilino de Microsoft Azure.
      Secreto de cliente Valor del secreto de cliente en el inquilino de Microsoft Azure.
      Nombre de contenedor predeterminado Contenedor de almacenamiento de datos en el que se escribirán los datos en el inquilino de Microsoft Azure. El contenedor debe existir en el inquilino de Azure.
      Subcarpeta predeterminada Opcional: Subcarpeta del contenedor en la que se escribirán los datos en el inquilino de Microsoft Azure.

      Nota: Si la subcarpeta que especifique no existe, se creará cuando se ejecute la extracción o el paquete de extracciones en esta conexión. Puede especificar subcarpetas adicionales mediante el carácter de barra diagonal (/) (por ejemplo, Application/Extract Data).

    • Parámetros de Oracle Address, Email, and Phone Verification:
      Campo Descripción
      Ubicación URL del servidor de Oracle Address, Email, and Phone Verification. Por ejemplo: https://mydataservice-myidentitydomain.data.us2.oraclecloud.com

      Atención:

      Si pega la dirección en el explorador, no incluya el contexto (por ejemplo, /data/ui) en la URL.
      ID de cliente ID de cliente de OAuth que se utilizará al conectarse al servicio de verificación de direcciones.

      Nota: Debe crear credenciales de cliente de OAuth para el servicio Oracle Address, Email, and Phone Verification. Consulte la sección sobre cómo comenzar con Address, Email, and Phone Verification en Using Oracle Address, Email, and Phone Verification.

      Secreto de cliente Secreto de cliente de OAuth que se utilizará al conectarse al servicio de verificación de direcciones.
    • Parámetros de Oracle Cloud EPM:
      Campo Descripción
      Ubicación URL del buzón de EPM. Por ejemplo: https://acme-test-epmidm.epm.us-phoenix-1.ocs.oraclecloud.com

      Atención:

      Si pega la dirección en el explorador, no incluya el contexto (por ejemplo, /epmcloud) en la URL.
      Tipo de autenticación Seleccione una opción:
      • Básica: utilice las credenciales de usuario proporcionadas para autenticarse.
      • OAuth: utilice los ID y los símbolos de OAuth2 para autenticarse. (Solo está disponible para entornos de la arquitectura Oracle Cloud Infrastructure (OCI)/Gen 2). Uso de OAuth2 para conexiones globales y de aplicación

      Carpeta predeterminada (opcional)

      Carpeta predeterminada a la que enviar archivos de extracción en entornos de Cloud EPM:
      • Casilla de verificación de aplicación predeterminada Planning, FreeForm, Financial Consolidation and Close, Enterprise Profitability and Cost Management
      • Carpeta de Data Management (por ejemplo, inbox/repository)
      • Buzón de Profitability and Cost Management (por ejemplo, profitinbox)
      Parámetros de autenticación básica:
      Nombre de usuario/contraseña Credenciales necesarias para la autenticación básica

      Dominio de identidad (opcional)

      Dominio de identidad para agregar delante del nombre de usuario al autorizar.
      Parámetros de autenticación de OAuth:
      ID de cliente ID de cliente del cliente que ha creado para las conexiones globales.
      Símbolo de acceso Símbolo de acceso del cliente que ha creado para las conexiones globales.
      Símbolo de refrescamiento Símbolo de refrescamiento del cliente que ha creado para las conexiones globales.
    • Parámetros de Oracle Cloud ERP:
      Campo Descripción
      Ubicación URL del servidor de EPM. Por ejemplo: https://erp.mycloud.com
      Tipo de autenticación Seleccione una opción:
      • Básica: utilice las credenciales de usuario proporcionadas para autenticarse.
      • OAuth: utilice los ID y los símbolos de OAuth2 para autenticarse. (Solo está disponible para entornos de la arquitectura Oracle Cloud Infrastructure (OCI)/Gen 2). Uso de OAuth2 para conexiones globales y de aplicación

      Cuenta de documento predeterminada

      Carpeta en la que extraer el archivo en Oracle Cloud ERP. Por ejemplo, fin/generalLedger/import.
      Parámetros de autenticación básica:
      Nombre de usuario/contraseña Credenciales necesarias para la autenticación básica

      Dominio de identidad (opcional)

      Dominio de identidad para agregar delante del nombre de usuario al autorizar.
      Parámetros de autenticación de OAuth:
      URL de símbolo de IDCS Servidor de autenticación del proveedor. Se utiliza para intercambiar un código de autorización por un símbolo de acceso.
      ID de cliente ID de cliente del cliente que ha creado para las conexiones globales.
      Ámbito Proporciona un método para controlar la cantidad de acceso que se otorga a un símbolo JSON Web Token.
      Alias de certificado Alias que ha especificado al importar el certificado en Cloud ERP.
      Carga de clave privada Archivo de certificado que ha importado en Cloud ERP. Haga clic en Ubicación de archivo de carga para cargar el archivo. El archivo debe tener la extensión de archivo .PEM.
    • Parámetros de Oracle Object Storage:
      Campo Descripción
      Ubicación URL de Swift del bucket de Oracle Object Storage Cloud. El formato de la URL es: https://swiftobjectstorage.region_identifier.oraclecloud.com/v1/namespace, donde:
      • host name (con el tipo de API de Swift), por ejemplo, swiftobjectstorage.
      • region_identifier es el alojamiento de Oracle Cloud Infrastructure (OCI), por ejemplo us-phoenix-1. Consulte Regiones y dominios de disponibilidad.
      • namespace es el contenedor de nivel superior para todos los buckets y objetos. A cada inquilino de Oracle Cloud Infrastructure se le asigna un nombre de espacio de nombre de Object Storage inmutable, generado por el sistema y único durante la creación de la cuenta.

      Sugerencia:

      La URL de Swift del almacén de objetos de Oracle debe incluir la versión y el espacio de nombre. No se debe incluir una barra diagonal final en el parámetro Ubicación.
      Tipo de autenticación Seleccione el método de autenticación Básica o Clave de firma de API.
      Básica
      Nombre de usuario/contraseña Credenciales necesarias para la autenticación, de la siguiente forma:
      1. Genere un símbolo de autenticación (consulte Para crear un símbolo de autentificación en Oracle Cloud Infrastructure Documentation).
      2. En Nombre de usuario, introduzca el nombre de usuario de OCI para el que se ha generado el símbolo de autenticación.
      3. En Contraseña, introduzca el símbolo de autenticación generado. Este parámetro distingue entre mayúscula y minúscula.
      Clave de firma de API
      • OCID de arrendamiento
      • OCID de usuario
      • Huella de clave pública
      • Carga de clave privada

      Las credenciales necesarias para una clave de firma de API son las siguientes:

      1. En la consola de Oracle Cloud, genere una clave de firma de API. Consulte la sección sobre cómo generar una clave de firma de API en Oracle Cloud Infrastructure Developer Guide.
      2. Desde la consola, descargue la clave privada y guárdela en el directorio .oci y, a continuación, haga clic en Agregar.

        Los parámetros para la clave de firma se muestran en la consola.

      3. Copie los siguientes parámetros de la consola y péguelos en Cloud EDM:
        • En OCID de arrendamiento, pegue el valor de arrendamiento de la consola.
        • En OCID de usuario, pegue el valor de usuario de la consola.
        • En Huella de clave pública, pegue el valor de huella de la consola.
      4. En Carga de clave privada, haga clic en Cargar y cargue el archivo de clave privada que ha descargado en el paso b.
      Bucket predeterminado (opcional)

      Nota: Este campo es necesario para probar la conexión.

      Contenedor para almacenar el archivo extraído en el espacio de nombre para el almacenamiento de objetos. Este parámetro distingue entre mayúscula y minúscula.
      Subcarpeta predeterminada (opcional) Subcarpeta en Bucket predeterminado en la que escribir el archivo de extracción. Si la carpeta que especifique no existe, se creará. Este parámetro distingue entre mayúscula y minúscula.
  5. (Opcional): en Aplicaciones soportadas, haga clic en Especificado y, a continuación, seleccione las aplicaciones que pueden utilizar esta conexión global.
  6. Haga clic en Probar conexión para validar los detalles de conexión.

    Nota:

    Para las conexiones de Oracle Object Storage, debe introducir un Bucket predeterminado para probar la conexión.
  7. Haga clic en Guardar.

    Nota:

    Es necesario corregir todas las incidencias de todas las conexiones para poder guardar las conexiones. Si falta algún campo necesario en los detalles de conexión de alguna conexión, se muestra un indicador en esa conexión y aparece un error que indica que una o más conexiones tienen incidencias que deben corregirse.

Para suprimir una conexión global, en la columna Acciones, haga clic en Acciones y, a continuación, en Suprimir. No puede suprimir una conexión global que esté utilizando una extracción. No puede suprimir una conexión global de Oracle Address, Email, and Phone Verification si la está utilizando una propiedad de dirección.