Cette page a été traduite par l'API Cloud Translation.

Oracle Eloqua

Le connecteur Oracle Eloqua vous permet d'effectuer des opérations de lecture, d'insertion, de mise à jour et de suppression sur les données Oracle Eloqua.

Versions compatibles

Voici la version minimale compatible pour ce connecteur: Oracle Eloqua 10-24C (standard).

Avant de commencer

Avant d'utiliser le connecteur Oracle Eloqua, effectuez les tâches suivantes:

Dans votre projet Google Cloud :
- Vérifiez que la connectivité réseau est configurée. Pour en savoir plus sur les modèles réseau, consultez la section Connectivité réseau.
- Attribuez le rôle IAM roles/connectors.admin à l'utilisateur qui configure le connecteur.
- Attribuez les rôles IAM suivants au compte de service que vous souhaitez utiliser pour le connecteur :
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Un compte de service est un compte Google spécial destiné à représenter un utilisateur non humain qui doit s'authentifier et obtenir les autorisations permettant d'accéder aux données des API Google. Si vous ne possédez pas de compte de service, vous devez en créer un. Pour plus d'informations, consultez la section Créer un compte de service.
- Activez les services suivants :
  - secretmanager.googleapis.com (API Secret Manager)
  - connectors.googleapis.com (API Connectors)
  Pour savoir comment activer des services, consultez la page Activer des services.
Si ces services ou autorisations n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la configuration du connecteur.

Configurer le connecteur

Une connexion est spécifique à une source de données. Cela signifie que si vous disposez de nombreuses sources de données, vous devez créer une connexion distincte pour chacune d'elles. Pour créer une connexion, procédez comme suit:

Dans la console Cloud, accédez à la page Integration Connectors > Connections (Connecteurs d'intégration > Connexions), puis sélectionnez ou créez un projet Google Cloud.
Accéder à la page "Connexions"
Cliquez sur + Créer pour ouvrir la page Créer une connexion.
Dans la section Emplacement, choisissez l'emplacement de la connexion.
1. Région : sélectionnez un emplacement dans la liste déroulante.
  Pour obtenir la liste de toutes les régions disponibles, consultez la page Emplacements.
2. Cliquez sur Next (Suivant).
Dans la section Détails de connexion, procédez comme suit :
1. Connecteur: sélectionnez Oracle Eloqua dans la liste déroulante des connecteurs disponibles.
2. Version du connecteur : sélectionnez la version du connecteur dans la liste déroulante des versions disponibles.
3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.
  Les noms de connexion doivent répondre aux critères suivants :
  - Les noms de connexion peuvent contenir des lettres, des chiffres ou des traits d'union.
  - Les lettres doivent être en minuscules.
  - Les noms de connexion doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
  - Les noms de connexion ne peuvent pas dépasser 49 caractères.
4. Saisissez éventuellement une Description pour l'instance de connexion.
5. Vous pouvez également activer Cloud Logging, puis sélectionner un niveau de journalisation. Par défaut, le niveau de journalisation est défini sur Error.
6. Compte de service : sélectionnez un compte de service disposant des rôles requis.
7. Vous pouvez également configurer les paramètres du nœud de connexion :
  - Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
  - Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.
  Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre comment les nœuds affectent la tarification de votre connecteur, consultez la section Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.
8. Entreprise: indiquez l'identifiant unique de l'entreprise. Ce champ permet de s'authentifier auprès des serveurs Eloqua.
9. Intervalle d'interrogation groupée: spécifiez l'intervalle de temps entre les requêtes API groupées. La valeur par défaut est de 200 ms.
10. Délai avant expiration des requêtes groupées: spécifiez le temps d'attente en minutes pour une réponse à une requête groupée. La valeur par défaut est de 25 minutes.
11. Durée de conservation des données: spécifiez la durée en heures pendant laquelle les données groupées doivent être stockées sur le serveur. Vous pouvez spécifier des valeurs comprises entre une heure et deux semaines. La valeur par défaut est de 24 heures.
12. Nom de la colonne à afficher: spécifiez le nom à afficher pour les colonnes lorsque vous utilisez l'API Oracle Eloqua Bulk. Vous pouvez spécifier une chaîne vide, internal ou statement.
13. Respecter la casse lors du mappage des fiches de données: indiquez si vous souhaitez utiliser la casse lors du mappage des fiches de données.
14. Map Data Cards Relationship (Mappage de la relation des fiches de données) : saisissez une liste des relations entre les tables d'objets personnalisés et les tables d'entités, séparées par une virgule.
15. Nombre de nouvelles tentatives: spécifiez le nombre maximal de nouvelles tentatives pour une requête API groupée qui échoue en raison d'un code d'état HTTP 500 (erreur interne du serveur).
16. Intervalle de nouvelle tentative: spécifiez l'intervalle de temps entre les tentatives de nouvelle tentative d'une requête API groupée ayant échoué avec un code d'état HTTP 500 (erreur interne du serveur).
17. Utiliser l'API Bulk: indiquez si vous souhaitez utiliser l'API Bulk pour récupérer les données.
18. Vous pouvez également cliquer sur + Ajouter un libellé pour ajouter un libellé à la connexion sous la forme d'une paire clé/valeur.
19. Cliquez sur Suivant.
Dans la section Destinations, saisissez les informations concernant l'hôte distant (système backend) auquel vous souhaitez vous connecter.
1. Type de destination : sélectionnez un type de destination.
  - Sélectionnez Adresse hôte dans la liste pour spécifier le nom d'hôte ou l'adresse IP de la destination.
  - Si vous souhaitez établir une connexion privée à vos systèmes backend, sélectionnez Rattachement du point de terminaison dans la liste, puis sélectionnez le rattachement du point de terminaison requis dans la liste Rattachement du point de terminaison.
    Remarque : Pour savoir comment créer un rattachement du point de terminaison, consultez Rattachement de service PSC et Rattachement du point de terminaison. Une fois le rattachement du point de terminaison créé, il apparaît dans la liste Rattachement du point de terminaison.
  Si vous souhaitez établir une connexion publique à vos systèmes backend avec une sécurité supplémentaire, vous pouvez envisager de configurer des adresses IP sortantes statiques pour vos connexions, puis de configurer vos règles de pare-feu pour ajouter à la liste d'autorisation uniquement les adresses IP statiques spécifiques.
  
  Pour saisir d'autres destinations, cliquez sur + AJOUTER UNE DESTINATION.
2. Cliquez sur Next (Suivant).
Dans la section Authentification, saisissez les informations d'authentification.
1. Sélectionnez un type d'authentification, puis saisissez les informations appropriées.
  Les types d'authentification suivants sont compatibles avec la connexion Oracle Eloqua:
  - Mot de passe utilisateur
  - Code d'autorisation OAuth 2.0/li>
2. Cliquez sur Next (Suivant).
Vérifiez vos informations de connexion et d'authentification.
Cliquez sur Créer.

Configurer l'authentification

Saisissez les détails en fonction de l'authentification que vous souhaitez utiliser.

Mot de passe utilisateur
- Nom d'utilisateur: nom d'utilisateur pour authentifier la connexion.
- Mot de passe: secret Secret Manager contenant le mot de passe associé au nom d'utilisateur.
- Version du secret: version du secret sélectionné ci-dessus.

Code d'autorisation OAuth 2.0
- ID client : ID client fourni par le connecteur pour l'application que vous avez créée.
- Champs d'application: liste des champs d'application souhaités, séparés par une virgule.
- Code secret du client : secret Secret Manager contenant le code secret client pour l'application connectée que vous avez créée.
- Version du secret: version du secret sélectionné ci-dessus.
- URL d'autorisation: URL d'autorisation générée lors de la création d'un client dans l'instance Oracle Eloqua.

Exemples de configuration de connexion

Cette section présente des exemples de valeurs pour les différents champs que vous configurez lors de la création de la connexion.

Type de connexion avec nom d'utilisateur et mot de passe

Nom du champ	Détails
Emplacement	europe-west1
Connecteur	Oracle Eloqua
Version du connecteur	1
Nom de connexion	oracle-eloqua-googlecloud
Compte de service	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Nombre minimal de nœuds	2
Nombre maximal de nœuds	50
Entreprise	AltostratLtd
Nom d'utilisateur	NOM D'UTILISATEUR
Mot de passe	MOT DE PASSE
Version de secret	1

Type de connexion OAuth 2.0

Nom du champ	Détails
Emplacement	europe-west1
Connecteur	Oracle Eloqua
Version du connecteur	1
Nom de connexion	oracle-eloqua-googlecloud-oauth
Description	oracle-eloqua-googlecloud-oauth
Compte de service	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Nombre minimal de nœuds	2
Nombre maximal de nœuds	50
Entreprise	AltostratLtd
ID client	CLIENT_ID
Niveaux d'accès	complet
Code secret du client	CLIENT_SECRET
Version de secret	4

Limites du système

Le connecteur Oracle Eloqua peut traiter un maximum de 12 transactions par seconde et par nœud, et limite les transactions dépassant cette limite. Par défaut, les connecteurs d'intégration allouent deux nœuds (pour une meilleure disponibilité) à une connexion.

Pour en savoir plus sur les limites applicables à Integration Connectors, consultez la section Limites.

Remarque:Le nombre de nœuds de connecteurs d'intégration est automatiquement ajusté en fonction de votre utilisation. Toutefois, si vous souhaitez réserver de la capacité pour de grands volumes sans attendre l'autoscaling, vous pouvez ajuster la valeur minimale de nœud pour une connexion. Pour traiter plus de transactions pour une connexion, plus de nœuds sont nécessaires. À l'inverse, moins de nœuds sont nécessaires si une connexion traite moins de transactions. Pour configurer les valeurs de nœud, procédez comme suit :

Si vous êtes un client facturé à l'usage, configurez la valeur minimale et maximale du nœud sur la page de modification de la connexion.
Si vous êtes abonné, contactez l'assistance.

Le nombre maximal de transactions qu'un nœud peut gérer dépend de plusieurs facteurs. Par conséquent, avant d'ajuster le nombre minimal de nœuds pour améliorer le débit, nous vous recommandons de vérifier si vos systèmes backend sont configurés de manière optimale pour gérer le trafic requis.

Utiliser la connexion Oracle Eloqua dans une intégration

Une fois la connexion créée, elle devient disponible à la fois dans Apigee Integration et Application Integration. Vous pouvez utiliser la connexion dans une intégration via la tâche Connecteurs.

Pour découvrir comment créer et utiliser la tâche Connecteurs dans Apigee Integration, consultez la section Tâche Connecteurs.
Pour savoir comment créer et utiliser la tâche Connecteurs dans Application Integration, consultez la section Tâche Connecteurs.

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines des opérations d'entité dans ce connecteur.

Exemple : Lister tous les groupes de comptes

Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
Sélectionnez AccountGroup dans la liste Entity.
Sélectionnez l'opération List, puis cliquez sur OK.

Vous pouvez également effectuer l'opération "List" sur les entités suivantes:

Événement, Utilisateur et Campagne

Exemple : Obtenir un AccountGroup

Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
Sélectionnez AccountGroup dans la liste Entity.
Sélectionnez l'opération Get, puis cliquez sur OK.
Définissez l'ID d'entité sur l'entité du groupe de comptes. Pour définir l'ID d'entité, dans la section Data Mapper (Mappeur de données) de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données), puis saisissez 1 dans le champ Input Value (Valeur d'entrée) et choisissez EntityId comme variable locale.

Vous pouvez également effectuer l'opération "Get" sur les entités suivantes : "Email" et "User".

Exemple : Supprimer un AccountGroup

Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
Sélectionnez AccountGroup dans la liste Entity.
Sélectionnez l'opération Delete, puis cliquez sur OK.
Définissez l'ID d'entité sur l'entité du groupe de comptes. Pour définir l'ID d'entité, dans la section Data Mapper (Mappeur de données) de Data Mapping (Mappage de données), cliquez sur Open Data Mapping Editor (Ouvrir l'éditeur de mappage de données), puis saisissez 8 dans le champ Input Value (Valeur d'entrée) et choisissez EntityId comme variable locale.

Vous pouvez également effectuer l'opération de suppression sur l'entité "Email".

Exemple : Créer une campagne

Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
Sélectionnez Campaign dans la liste Entity.
Sélectionnez l'opération Create, puis cliquez sur OK.
Dans la section Data mapper (Mappeur de données) de l'éditeur Task (Tâche), cliquez sur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le champ field:
```
{
  "Name": "AltostratCampaign1.11",
  "BudgetedCost": 100000
}
```
L'exécution de cet exemple renvoie une réponse semblable à celle-ci dans la variable de sortie connectorOutputPayload de la tâche de connecteur:
```
{
  "ID": 9
}
```

Exemple : Créer un événement

Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
Sélectionnez "Événement" dans la liste Entity.
Sélectionnez l'opération Create, puis cliquez sur OK.
Dans la section Data mapper (Mappeur de données) de l'éditeur Task (Tâche), cliquez sur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le champ field:
```
{
  "Name": "Marketing Experience GCP2.2",
  "Description": "Modern Marketing Experience brings together Modern Marketers from around the globe",
  "EmailAddressFieldId": "-2"
}
```
L'exécution de cet exemple renvoie une réponse semblable à celle-ci dans la variable de sortie connectorOutputPayload de la tâche de connecteur:
```
{
  "Id": "16"
}
```

Exemple : Modifier une campagne

Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
Sélectionnez Campaign dans la liste Entity.
Sélectionnez l'opération Update, puis cliquez sur OK.
Définissez l'ID d'entité sur l'entité de la campagne. Pour définir l'EntityID, dans la section Data mapper (Mappeur de données) de Tasks (Tâches), cliquez sur EntityID (EntityID), puis saisissez 5 dans le champ donné.
Dans la section Data mapper (Mappeur de données) de l'éditeur Task (Tâche), cliquez sur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le champ field:
```
{
  "Name": "AltostratCamp9",
  "BudgetedCost": 100
}
```

L'exécution de cet exemple renvoie une réponse semblable à celle-ci dans la variable de sortie connectorOutputPayload de la tâche de connecteur:

{
  "ID": 5
}

Exemple : Modifier un e-mail

Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
Sélectionnez Email dans la liste Entity.
Sélectionnez l'opération Update, puis cliquez sur OK.
Définissez l'ID d'entité sur l'entité de l'e-mail. Pour définir l'EntityID, dans la section Data mapper (Mappeur de données) de Tasks (Tâches), cliquez sur EntityID (EntityID), puis saisissez 59 dans le champ donné.

Dans la section Data mapper (Mappeur de données) de l'éditeur Task (Tâche), cliquez sur OpenDataMapping, puis saisissez une valeur semblable à la suivante dans le champ 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"
}

L'exécution de cet exemple renvoie une réponse semblable à celle-ci dans la variable de sortie connectorOutputPayload de la tâche de connecteur:

{
  "ID": 59
}

Obtenir de l'aide auprès de la communauté Google Cloud

Vous pouvez publier vos questions et discuter de ce connecteur sur les forums Cloud de la communauté Google Cloud.

Étape suivante

Découvrez comment suspendre et réactiver une connexion.
Découvrez comment surveiller l'utilisation des connecteurs.
Découvrez comment afficher les journaux des connecteurs.