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 para 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 configure 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. Empresa: Especifica el identificador único de la empresa. Este campo se usa para autenticarse 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 de 200 ms.
   10. Tiempo de espera de la consulta masiva: Especifica el tiempo en minutos que se espera para recibir una respuesta de la consulta masiva. El valor predeterminado es de 25 minutos.
   11. Duración de la 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. Nombre de la columna visible: Especifica el nombre visible de las columnas cuando uses la API de Oracle Eloqua Bulk. Puedes especificar una cadena vacía, internal o statement.
   13. Map Data Cards Case Sensitive Match: Especifica si deseas usar la coincidencia de mayúsculas y 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. Recuento de reintentos: Especifica la cantidad máxima de veces que se debe volver a intentar una solicitud a la API masiva 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 de reintento de una solicitud a la API masiva que falló con un código de estado HTTP 500 (error interno del servidor).
   17. Use Bulk API: Especifica si deseas 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.
      • Selecciona Dirección de host en la lista para especificar el nombre de host o la dirección IP del destino.
      • Si deseas establecer una conexión privada a tus sistemas de backend, selecciona Adjunto de extremo en la lista y, luego, selecciona el archivo adjunto de extremo requerido en la lista Adjunto de extremo.

      Si deseas establecer una conexión pública a 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 incluir en la lista de entidades permitidas 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/li>

   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 Secret: Es la versión del secreto que seleccionaste 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.
  • Permisos: Es una lista de permisos deseados separados por comas.
  • Secreto de cliente: Secret de Secret Manager que contiene el secreto del cliente para la app conectada que creaste.
  • Versión del Secret: Es la versión del secreto que seleccionaste 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 de los diversos 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 de 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, los conectores de integración asignan 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 la integración de aplicaciones. 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 la integración de Apigee, 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 entidad en este conector.

Ejemplo: Muestra una lista de 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: Cómo obtener 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: Cómo borrar 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 Borrar en la entidad Correo electrónico.

Ejemplo: Cómo crear 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 de la Task, haz clic en el editor OpenDataMapping y, luego, ingresa un valor similar al siguiente en field:.

   {
     "Name": "AltostratCampaign1.11",
     "BudgetedCost": 100000
   }

   Si ejecutas este ejemplo, se muestra 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 Evento en la lista Entity.
3. Selecciona la operación Create y haz clic en Listo.
4. En la sección Data mapper de la Task, haz clic en el editor OpenDataMapping y, luego, ingresa un valor similar al siguiente en 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 muestra una respuesta similar a la siguiente en la variable de salida connectorOutputPayload de la tarea del conector:

   {
     "Id": "16"
   }
   

Ejemplo: Cómo actualizar 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 determinado.
5. En la sección Data mapper de la Task, haz clic en el editor OpenDataMapping y, luego, ingresa un valor similar al siguiente en field:.

   {
     "Name": "AltostratCamp9",
     "BudgetedCost": 100
   }
   

Si ejecutas este ejemplo, se muestra 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 determinado.
5. En la sección Data mapper de la Task, haz clic en el editor OpenDataMapping y, luego, ingresa un valor similar al siguiente en 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 muestra 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 de los conectores.
• Obtén información para ver los registros de los conectores.