Oracle Sales Cloud

El conector de Oracle Sales Cloud te permite realizar operaciones de inserción, eliminación, actualización y lectura en los datos de Oracle Sales Cloud.

Versiones compatibles

La siguiente es la versión mínima compatible con este conector: Oracle Sales Cloud 24D (11.13.24.10.0)

Antes de comenzar

En tu proyecto de Google Cloud, realiza las siguientes tareas:

  • Asegúrate de que la conectividad de red esté configurada. Para obtener información sobre los patrones de red, consulta Conectividad de red.
  • Otorga el rol de IAM roles/connectors.admin al usuario que configura el conector.
  • Otorga los roles de IAM roles/secretmanager.viewer y roles/secretmanager.secretAccessor a la cuenta de servicio que deseas usar para el conector.
  • Habilita los siguientes servicios:
    • secretmanager.googleapis.com (API de Secret Manager)
    • connectors.googleapis.com (API de conectores)

    Para comprender cómo habilitar servicios, consulta Habilita servicios. Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, haz lo siguiente:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + CREAR NUEVO para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en SIGUIENTE.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Oracle Sales Cloud en la lista desplegable de conectores disponibles.
    2. Versión del conector: selecciona la versión del conector de la lista desplegable de versiones disponibles.
    3. En el campo Nombre de la conexión, ingresa un nombre para la instancia de conexión.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de las conexiones no pueden superar los 49 caracteres.
    4. De manera opcional, ingresa una Descripción para la instancia de conexión.
    5. De manera opcional, habilita Cloud Logging y, luego, selecciona un nivel de registro. De forma predeterminada, el nivel de registro se establece en Error.
    6. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    7. De manera opcional, configura los parámetros de nodo de conexión:

      • Cantidad mínima de nodos: Ingresa la cantidad mínima de nodos de conexión.
      • Cantidad máxima de nodos: Ingresa la cantidad máxima de nodos de conexión.

      Un nodo es una unidad (o réplica) de una conexión que procesa transacciones. Se requieren más nodos para procesar más transacciones para una conexión y, del mismo modo, se requieren menos para procesar menos transacciones. Para comprender cómo los nodos afectan el precio del conector, consulta Precios de nodos de conexión. Si no ingresas ningún valor, se establecen de forma predeterminada los nodos mínimos en 2 (para una mejor disponibilidad) y los nodos máximos se establecen en 50.

    8. Expand Fields: El parámetro de campo filtra los atributos del recurso. Cuando se ejecutan consultas SELECT *, si este campo se establece como verdadero, solo se devuelven los atributos especificados.
    9. Include Custom Objects: Especifica si los objetos personalizados se recuperan de forma dinámica. Si esta propiedad se establece como falsa, no se mostrarán las tablas personalizadas.
    10. Tiempo de espera de conexión: Especifica el tiempo de espera de conexión en segundos.
    11. Generate Schema Files: Especifica cuándo se deben generar y guardar los esquemas. Puedes elegir una de las siguientes opciones:
      • Nunca: Nunca genera archivos de esquema.
      • OnUse: Genera el archivo de esquema cuando se hace referencia a una tabla por primera vez y el archivo de esquema no existe.
      • OnStart: Genera el archivo de esquema para las tablas que no tienen un archivo de esquema cuando se crea la conexión.
      • OnCreate: Genera el archivo de esquema cuando se ejecuta una consulta en SQL CREATE TABLE.
    12. (Opcional) Para configurar un servidor proxy para la conexión, selecciona Usar proxy y, luego, ingresa los detalles del proxy.
      • Esquema de autenticación del proxy: Selecciona el tipo de autenticación para autenticar con el servidor proxy. Se admiten los siguientes tipos de autenticación:
        • Básico: Autenticación HTTP básica.
        • Resumen: Autenticación de HTTP de resumen.
      • Usuario de proxy: Un nombre de usuario que se usará para autenticarse con el servidor proxy.
      • Contraseña de proxy: el secreto de Secret Manager de la contraseña del usuario.
      • Tipo de SSL del proxy: el tipo de SSL que se usará para conectarse al servidor del proxy. Se admiten los siguientes tipos de autenticación:
        • Automático: Configuración predeterminada. Si la URL es HTTPS, se usa la opción Túnel. Si la URL es una URL HTTP, se usa la opción NUNCA.
        • Siempre: La conexión siempre está habilitada para SSL.
        • Nunca: La conexión no está habilitada para SSL.
        • Túnel: La conexión se realiza a través de un proxy de túnel. El servidor proxy abre una conexión con el host remoto y el tráfico fluye de un lado a otro a través del proxy.
      • En la sección Proxy Server, ingresa los detalles del servidor proxy.
        1. Haz clic en Agregar destino.
        2. Selecciona un Tipo de destino.
          • Dirección del host: Especifica el nombre de host o la dirección IP del destino.

            Si deseas establecer una conexión privada a tu sistema de backend, haz lo siguiente:
    13. De forma opcional, haz clic en + AGREGAR ETIQUETA para agregar una etiqueta a la conexión en forma de un par clave-valor.
    14. Haga clic en SIGUIENTE.
  5. En la sección Destinos, ingresa los detalles del host remoto (sistema de backend) al que deseas conectarte.
    1. Tipo de destino: Selecciona un Tipo de destino.
      • Para especificar el nombre de host o la dirección IP de destino, selecciona Dirección de host y, luego, ingresa la dirección en el campo Host 1.
      • Para establecer una conexión privada, selecciona Adjunto de extremo y elige el adjunto requerido de la lista Adjunto de extremo.

      Si deseas establecer una conexión pública con tus sistemas de backend con seguridad adicional, puedes configurar direcciones IP salientes estáticas para tus conexiones y, luego, configurar tus reglas de firewall para permitir solo las direcciones IP estáticas específicas.

      Para ingresar destinos adicionales, haz clic en +AGREGAR DESTINO.

    2. Haga clic en SIGUIENTE.
  6. En la sección Autenticación, ingresa los detalles de autenticación.
    1. Selecciona un Tipo de autenticación y, luego, ingresa los detalles relevantes.

      La conexión de Oracle Sales Cloud admite los siguientes tipos de autenticación:

      • Nombre de usuario y contraseña

      2. Para comprender cómo configurar estos tipos de autenticación, consulta Configura la autenticación.

    2. Haga clic en SIGUIENTE.
  7. Revisa: Revisa tus detalles de conexión y autenticación.
  8. Haz clic en Crear.

Configura la autenticación

Ingresa los detalles según la autenticación que desees usar.

  • Nombre de usuario y contraseña
    • Username: Nombre de usuario para el conector
    • Password: El Secret de Secret Manager que contiene la contraseña asociada con el conector.
    • Versión del secreto: Es la versión del secreto seleccionado anteriormente.

Muestras de configuración de conexión

En esta sección, se enumeran los valores de muestra para los distintos campos que configuras cuando creas la conexión.

Nombre del campo Detalles
Ubicación europe-west1
Conector Oracle Sales Cloud
Versión del conector 1
Nombre de la conexión oracle-sales-new
Cuenta de servicio SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Cantidad mínima de nodos 2
Cantidad máxima de nodos 50
Tipo de destino Dirección del host
host1 https://iaaptz.fa.ocs.oraclecloud.com//td>
Nombre de usuario OracleSalesCloudUser
Contraseña CONTRASEÑA
Versión del Secret 1

Limitaciones del sistema

El conector de Oracle Sales Cloud puede procesar un máximo de 10 transacciones por segundo, por nodo, y limita cualquier transacción que supere este límite. De forma predeterminada, Integration Connectors asigna 2 nodos (para una mejor disponibilidad) a una conexión.

Para obtener información sobre los límites aplicables a Integration Connectors, consulta Límites.

Usa la conexión de Oracle Sales Cloud en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en Application Integration. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea Connectors en Apigee Integration, consulta Tarea Connectors.
  • Para comprender cómo crear y usar la tarea Connectors en Application Integration, consulta Tarea Connectors.

Ejemplos de operaciones de entidades

En esta sección, se proporcionan ejemplos de cómo realizar las operaciones de entidades en este conector.

Ejemplo: Enumera todas las oportunidades

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Opportunities en la lista Entity.
  3. Selecciona la operación List y haz clic en Listo.

    4. Debes usar la operación List con la cláusula de filtro en las entidades en las que se requiere más de una clave para recuperar un solo registro.

Ejemplo: Obtener contactos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Contacts en la lista Entity.
  3. Selecciona la operación Get y haz clic en Listo.
  4. Establece el ID de la entidad en Contacts. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa 3046 en el campo Input Value y elige EntityId como variable local.

    5. Debes usar la operación Get con la cláusula de filtro en las entidades en las que se requiere más de una clave para recuperar un solo registro.

Ejemplo: Borra oportunidades

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Opportunities en la lista Entity.
  3. Selecciona la operación Delete y haz clic en Listo.
  4. Establece el ID de la entidad en Delete Opportunities. Para establecer el ID de la entidad, en la sección Data Mapper de Data Mapping, haz clic en Open Data Mapping Editor y, luego, ingresa 203002 en el campo Input Value y elige EntityId como variable local.

    Debes usar la operación Delete con la cláusula de filtro en las entidades en las que se requiere más de una clave para recuperar un solo registro.

Ejemplo: Crea contactos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Contacts en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
     { "FirstName": "Googlecloud2", "LastName": "TestCreate3" }

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "PartyNumber": "807006" }

Ejemplo: Crea direcciones de contacto

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona ContactAddresses en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
    { "City": "CreatingAddGooglecloud", "State": "France", "Country": "FR", "Address1": "Googlecloud Contact Address 1", "PartyNumber": "3046" }

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "AddressNumber": "411001", "PartyNumber": "3046" }

Ejemplo: Crea cuentas

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Cuentas en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
    { "OrganizationName": "Test Account7Googlecloud", "AddressLine1": "E-City", "City": "Paris", "Country": "FR" }

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "PartyNumber": "804006" }

Ejemplo: Crea oportunidades

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Oportunidades en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
    { "Name": "OpportunityGooglecloud1" }

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "OptyNumber": "203001" }

Ejemplo: Crea un asignado de actividad

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona ActivityAssignee en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
    { "ActivityId": 300000010836710, "AssigneeId": 300000001962681, "ActivityNumber": "212380" }

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "ActivityAssigneeId": 300000014424799 }

Ejemplo: Crea un contacto de actividad

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona ActivityContact en la lista Entity.
  3. Selecciona la operación Create y haz clic en Listo.
  4. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
    { "ActivityNumber": "212544", "ContactId": 100000001886382 }

    Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "ActivityContactId": 300000014968493 }

Ejemplo: Oportunidades de actualización

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Opportunities en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece el EntityID en Opportunities. Para establecer el EntityID, en la sección Data mapper de Tasks, haz clic en EntityID y, luego, ingresa 5 en el campo correspondiente.
  5. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
     { "Name": "Updated Googlecloud Opportunity again" }

    6. Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "OptyNumber": "150364" }

Ejemplo: Actualizar cuentas

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Accounts en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece el EntityID en Accounts. Para establecer el EntityID, en la sección Data mapper de Tasks, haz clic en EntityID y, luego, ingresa 804006 en el campo correspondiente.
  5. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
     { "OrganizationName": "updated Test Account7Googlecloud" }

    6. Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "PartyNumber": "804006" }

Ejemplo: Actualizar actividades

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Activities en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece EntityID en Activities. Para establecer el EntityID, en la sección Data mapper de Tasks, haz clic en EntityID y, luego, ingresa 201001 en el campo correspondiente.
  5. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
    { "ActivityFunctionCode": "APPOINTMENT", "ActivityStartDate": "2025-05-27 07:10:23", "ActivityEndDate": "2025-05-27 08:10:23" }

    6. Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

    { "ActivityNumber": "201001" }

Ejemplo: Actualiza contactos

  1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
  2. Selecciona Contacts en la lista Entity.
  3. Selecciona la operación Update y haz clic en Listo.
  4. Establece EntityID en Contacts. Para establecer el EntityID, en la sección Data mapper de Tasks, haz clic en EntityID y, luego, ingresa 59 en el campo correspondiente.
  5. En la sección Data mapper del editor de Task, haz clic en OpenDataMapping y, luego, ingresa un valor similar al siguiente en el campo field:: 
      { "FirstName": "GooglecloudUpdated2", "LastName": "Testlatency3" }

    6. Si ejecutas este ejemplo, se mostrará una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

     { "PartyNumber": "807004" }

Crea conexiones con Terraform

Puedes usar el recurso de Terraform para crear una conexión nueva.

Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de Terraform.

Para ver una plantilla de Terraform de ejemplo para la creación de conexiones, consulta la plantilla de ejemplo.

Cuando crees esta conexión con Terraform, debes establecer las siguientes variables en tu archivo de configuración de Terraform:

Nombre del parámetro Tipo de datos Obligatorio Descripción
expand_fields BOOLEAN Falso Determina si el controlador dejará en blanco el parámetro de URL de los campos cuando realice consultas SELECT *.
include_custom_objects BOOLEAN Falso Especifica si los objetos personalizados se deben recuperar de forma dinámica o no. No se mostrarán las tablas personalizadas a menos que esta propiedad esté establecida como verdadera.
generate_schema_files ENUM Falso Indica la preferencia del usuario sobre cuándo se deben generar y guardar los esquemas. Los valores admitidos son: Never, OnUse, OnStart y OnCreate.
proxy_enabled BOOLEAN Falso Especifica si se debe configurar un servidor proxy para la conexión.
proxy_auth_scheme ENUM Falso Tipo de autenticación que se usará para autenticarse en el proxy de ProxyServer. Los valores admitidos son BASIC, DIGEST y NONE.
proxy_user STRING Falso Nombre de usuario que se usará para autenticarse en el proxy de ProxyServer.
proxy_password SECRET Falso Contraseña que se usará para la autenticación en el proxy de ProxyServer.
proxy_ssltype ENUM Falso Es el tipo de SSL que se usará para conectarse al proxy de ProxyServer. Los valores admitidos son AUTO, ALWAYS, NEVER y TUNNEL.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?