Oracle Eloqua

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

Versiones compatibles

La siguiente es la versión mínima compatible con este conector: Oracle Eloqua 10-24C (estándar).

Antes de comenzar

Antes de usar el conector de Oracle Eloqua, realiza las siguientes tareas:

• En tu proyecto de Google Cloud, haz lo siguiente:
  • 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 siguientes roles de IAM a la cuenta de servicio que deseas usar para el conector:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano que debe autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

  • 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 Eloqua 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. Company: Especifica el identificador único de la empresa. Este campo se usa para la autenticación en los servidores de Eloqua.
   9. Intervalo de sondeo masivo: Especifica el intervalo de tiempo entre las solicitudes masivas a la API. El valor predeterminado es 200 ms.
   10. Tiempo de espera de la consulta masiva: Especifica el tiempo en minutos que se debe esperar para obtener una respuesta de la consulta masiva. El valor predeterminado es de 25 minutos.
   11. Duración de retención de datos: Especifica la duración en horas para almacenar datos masivos en el servidor. Puedes especificar valores de 1 hora a 2 semanas. El valor predeterminado es de 24 horas.
   12. Display Column Name: Especifica el nombre visible de las columnas cuando se usa la API de Oracle Eloqua Bulk. Puedes especificar una cadena vacía, internal o statement.
   13. Map Data Cards Case Sensitive Match: Especifica si se debe usar la coincidencia que distingue mayúsculas de minúsculas en la asignación de tarjetas de datos.
   14. Map Data Cards Relationship: Ingresa una lista separada por comas de las relaciones entre las tablas de objetos personalizados y las tablas de entidades.
   15. Retry Count: Especifica la cantidad máxima de veces que se reintentará una solicitud de la API de Bulk que falla debido a un código de estado HTTP 500 (error interno del servidor).
   16. Intervalo de reintento: Especifica el intervalo de tiempo entre los intentos para volver a intentar una solicitud de la API de Bulk que falló con un código de estado HTTP 500 (error interno del servidor).
   17. Usar la API masiva: Especifica si se debe usar la API masiva para recuperar datos.
   18. De forma opcional, haz clic en + Agregar etiqueta para agregar una etiqueta a la conexión en forma de un par clave-valor.
   19. Haz 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. Haz 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 Eloqua admite los siguientes tipos de autenticación:

      • Contraseña de usuario
      • Código de autorización de OAuth 2.0

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

   2. Haz 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.

• Contraseña del usuario
  • Nombre de usuario: Es el nombre de usuario para autenticar la conexión.
  • Contraseña: El Secret de Secret Manager que contiene la contraseña asociada con el nombre de usuario.
  • Versión del secreto: Es la versión del secreto seleccionado anteriormente.

• Código de autorización de OAuth 2.0
  • ID de cliente: el ID de cliente que proporciona el conector para la app que creaste.
  • Scopes: Es una lista separada por comas de los permisos deseados.
  • Secreto de cliente: Secret de Secret Manager que contiene el secreto del cliente para la app conectada que creaste.
  • Versión del secreto: Es la versión del secreto seleccionado anteriormente.
  • Authorize URL: Es la URL de autorización que se genera cuando se crea un cliente en la instancia de Oracle Eloqua.

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.

Tipo de conexión con nombre de usuario y contraseña

Nombre del campo	Detalles
Ubicación	europe-west1
Conector	Oracle Eloqua
Versión del conector	1
Nombre de la conexión	oracle-eloqua-googlecloud
Cuenta de servicio	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Cantidad mínima de nodos	2
Cantidad máxima de nodos	50
Empresa	AltostratLtd
Nombre de usuario	NOMBRE DE USUARIO
Contraseña	CONTRASEÑA
Versión del Secret	1

Tipo de conexión OAuth 2.0

Nombre del campo	Detalles
Ubicación	europe-west1
Conector	Oracle Eloqua
Versión del conector	1
Nombre de la conexión	oracle-eloqua-googlecloud-oauth
Descripción	oracle-eloqua-googlecloud-oauth
Cuenta de servicio	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Cantidad mínima de nodos	2
Cantidad máxima de nodos	50
Empresa	AltostratLtd
ID de cliente	CLIENT_ID
Permisos	completo
Secreto del cliente	CLIENT_SECRET
Versión del Secret	4

Limitaciones del sistema

El conector de Oracle Eloqua puede procesar un máximo de 12 transacciones por segundo, por nodo, y limita las transacciones que superen 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 Eloqua 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 muestra cómo realizar algunas de las operaciones de entidades en este conector.

Ejemplo: Enumera todos los AccountGroup

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

También puedes realizar la operación List en las siguientes entidades:

Evento, usuario y campaña

Ejemplo: Obtén un AccountGroup

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona AccountGroup en la lista Entity.
3. Selecciona la operación Get y haz clic en Listo.
4. Establece el ID de la entidad en la entidad de AccountGroup. 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 1 en el campo Input Value y elige EntityId como variable local.

También puedes realizar la operación Get en las siguientes entidades: Correo electrónico y Usuario.

Ejemplo: Borra un AccountGroup

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona AccountGroup en la lista Entity.
3. Selecciona la operación Delete y haz clic en Listo.
4. Establece el ID de la entidad en la entidad de AccountGroup. 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 8 en el campo Input Value y elige EntityId como variable local.

También puedes realizar la operación de borrado en la entidad Email.

Ejemplo: Crea una campaña

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Campaign 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": "AltostratCampaign1.11",
     "BudgetedCost": 100000
   }

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

   {
     "ID": 9
   }
   

Ejemplo: Crea un evento

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Event 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": "Marketing Experience GCP2.2",
     "Description": "Modern Marketing Experience brings together Modern Marketers from around the globe",
     "EmailAddressFieldId": "-2"
   }
   

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

   {
     "Id": "16"
   }
   

Ejemplo: Actualiza una campaña

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Campaign en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. Establece el ID de la entidad en la entidad de la campaña. 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": "AltostratCamp9",
     "BudgetedCost": 100
   }
   

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

{
  "ID": 5
}

Ejemplo: Actualiza un correo electrónico

1. En el cuadro de diálogo Configure connector task, haz clic en Entities.
2. Selecciona Email en la lista Entity.
3. Selecciona la operación Update y haz clic en Listo.
4. Establece el ID de la entidad en la entidad del correo electrónico. 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::

   {
     "Name": "My Googlecloud email updated",
     "EmailGroupId": 1,
     "HtmlContent_Type": "RawHtmlContent",
     "IsPlainTextEditable": false,
     "IsTracked": false,
     "PlainText": "\r\n",
     "BouncebackEmail": "AltostratLtd@s119222.m.en25.com",
     "ReplyToEmail": "newclient@en25.com",
     "ReplyToName": "AltostratLtd",
     "SenderEmail": "newclient@en25.com",
     "SenderName": "AltostratLtd",
     "SenderPlainTextOnly": null,
     "Subject": "New subject line",
     "Description": null,
     "FolderId": 42,
     "EmailHeaderId": 1,
     "EmailFooterId": 1,
     "Permissions": "Retrieve,SetSecurity,Delete,Update,Activate",
     "AccessedAt": null,
     "CurrentStatus": "Draft",
     "Depth": "complete"
   }
   

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

{
  "ID": 59
}

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?

• Obtén información para suspender y reanudar una conexión.
• Obtén información para supervisar el uso del conector.
• Comprende cómo ver los registros del conector.