Questa pagina è stata tradotta dall'API Cloud Translation.

Oracle Eloqua

Il connettore Oracle Eloqua ti consente di eseguire operazioni di lettura, inserimento, aggiornamento ed eliminazione sui dati di Oracle Eloqua.

Versioni supportate

Di seguito è riportata la versione minima supportata per questo connettore: Oracle Eloqua 10-24C (standard).

Prima di iniziare

Prima di utilizzare il connettore Oracle Eloqua, svolgi le seguenti attività:

Nel tuo progetto Google Cloud:
- Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
- Concedi il ruolo IAM roles/connectors.admin all'utente che configura il connettore.
- Concedi i seguenti ruoli IAM all'account di servizio che vuoi utilizzare per il connettore:
  - roles/secretmanager.viewer
  - roles/secretmanager.secretAccessor
  Un account di servizio è un tipo speciale di Account Google destinato a rappresentare un utente "non umano" che deve eseguire l'autenticazione ed essere autorizzato ad accedere ai dati nelle API Google. Se non hai un account di servizio, devi crearne uno. Per maggiori informazioni, consulta Creare un account di servizio.
- Attiva i seguenti servizi:
  - secretmanager.googleapis.com (API Secret Manager)
  - connectors.googleapis.com (API Connectors)
  Per scoprire come attivare i servizi, consulta Abilitazione dei servizi.
Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.

Configura il connettore

Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione distinta per ciascuna. Per creare una connessione:

Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni e seleziona o crea un progetto Google Cloud.
Vai alla pagina Connessioni
Fai clic su + Crea nuovo per aprire la pagina Crea connessione.
Nella sezione Località, scegli la località della connessione.
1. Regione: seleziona una località dall'elenco a discesa.
  Per l'elenco di tutte le regioni supportate, consulta Località.
2. Fai clic su Avanti.
Nella sezione Dettagli connessione, completa quanto segue:
1. Connettore: seleziona Oracle Eloqua dall'elenco a discesa dei connettori disponibili.
2. Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.
  I nomi delle connessioni devono soddisfare i seguenti criteri:
  - I nomi delle connessioni possono contenere lettere, numeri o trattini.
  - Le lettere devono essere minuscole.
  - I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
  - I nomi delle connessioni non possono superare i 49 caratteri.
4. (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
5. Se vuoi, attiva Cloud Logging e poi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
6. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
7. (Facoltativo) Configura le impostazioni del nodo di connessione:
  - Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
  - Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.
  Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, al contrario, meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita il numero minimo di nodi è impostato su 2 (per una maggiore disponibilità) e il numero massimo di nodi è impostato su 50.
8. Azienda: specifica l'identificatore univoco dell'azienda. Questo campo viene utilizzato per autenticarsi sui server Eloqua.
9. Intervallo di polling collettivo: specifica l'intervallo di tempo tra le richieste API collettive. Il valore predefinito è 200 ms.
10. Timeout query collettiva: specifica il tempo in minuti di attesa per una risposta alla query collettiva. Il valore predefinito è 25 minuti.
11. Durata della conservazione dei dati: specifica la durata in ore per l'archiviazione collettiva dei dati sul server. Puoi specificare valori da 1 ora a 2 settimane. Il valore predefinito è 24 ore.
12. Nome colonna visualizzato: specifica il nome visualizzato per le colonne quando utilizzi l'API Oracle Eloqua Bulk. Puoi specificare una stringa vuota, internal o statement.
13. Corrispondenza maiuscole/minuscole per le schede di dati mappate: specifica se utilizzare la corrispondenza maiuscole/minuscole nella mappatura delle schede di dati.
14. Map Data Cards Relationship (Relazione schede di dati mappa): inserisci un elenco separato da virgole delle relazioni tra le tabelle degli oggetti personalizzati e le tabelle delle entità.
15. Numero di tentativi: specifica il numero massimo di volte per riprovare una richiesta dell'API Bulk che non va a buon fine a causa di un codice di stato HTTP 500 (errore interno del server).
16. Intervallo di ripetizione: specifica l'intervallo di tempo tra i tentativi di ripetere una richiesta dell'API Bulk non riuscita con un codice di stato HTTP 500 (errore interno del server).
17. Utilizza l'API Bulk: specifica se utilizzare l'API Bulk per recuperare i dati.
18. Se vuoi, fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
19. Fai clic su Avanti.
Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui vuoi connetterti.
1. Tipo di destinazione: seleziona un Tipo di destinazione.
  - Seleziona Indirizzo host dall'elenco per specificare il nome host o l'indirizzo IP della destinazione.
  - Se vuoi stabilire una connessione privata ai tuoi sistemi di backend, seleziona Allegato endpoint dall'elenco, quindi seleziona l'allegato endpoint richiesto dall'elenco Allegato endpoint.
    Nota: per capire come creare un collegamento endpoint, consulta Collegamento del servizio PSC e Collegamento endpoint. Una volta creato, il collegamento dell'endpoint sarà visibile nell'elenco Collegamento dell'endpoint.
  Se vuoi stabilire una connessione pubblica ai tuoi sistemi di backend con una maggiore sicurezza, puoi prendere in considerazione la configurazione di indirizzi IP statici in uscita per le tue connessioni, quindi configurare le regole del firewall in modo da inserire nella lista consentita solo gli indirizzi IP statici specifici.
  
  Per inserire destinazioni aggiuntive, fai clic su + AGGIUNGI DESTINAZIONE.
2. Fai clic su Avanti.
Nella sezione Autenticazione, inserisci i dettagli di autenticazione.
1. Seleziona un Tipo di autenticazione e inserisci i dettagli pertinenti.
  La connessione Oracle Eloqua supporta i seguenti tipi di autenticazione:
  - Password utente
  - Codice di autorizzazione OAuth 2.0/li>
2. Fai clic su Avanti.
Rivedi: controlla i dettagli di connessione e autenticazione.
Fai clic su Crea.

Configura autenticazione

Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

Password utente
- Nome utente: il nome utente per autenticare la connessione.
- Password: il segreto Secret Manager contenente la password associata al nome utente.
- Versione del secret: la versione del secret selezionato sopra.

Codice di autorizzazione OAuth 2.0
- ID client: l'ID client fornito dal connettore per l'app che hai creato.
- Ampiezze: un elenco separato da virgole degli ambiti desiderati.
- Client secret: il secret di Secret Manager contenente il client secret per l'app collegata che hai creato.
- Versione del secret: la versione del secret selezionato sopra.
- Authorize URL (URL di autorizzazione): l'URL di autorizzazione generato durante la creazione di un client nell'istanza Oracle Eloqua.

Esempi di configurazione delle connessioni

Questa sezione elenca i valori di esempio per i vari campi configurati durante la creazione della connessione.

Tipo di connessione con nome utente e password

Nome campo	Dettagli
Località	europe-west1
Connettore	Oracle Eloqua
Versione del connettore	1
Nome collegamento	oracle-eloqua-googlecloud
Account di servizio	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Numero minimo di nodi	2
Numero massimo di nodi	50
Società	AltostratLtd
Nome utente	NOME UTENTE
Password	PASSWORD
Versione secret	1

Tipo di connessione OAuth 2.0

Nome campo	Dettagli
Località	europe-west1
Connettore	Oracle Eloqua
Versione del connettore	1
Nome collegamento	oracle-eloqua-googlecloud-oauth
Descrizione	oracle-eloqua-googlecloud-oauth
Account di servizio	SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Numero minimo di nodi	2
Numero massimo di nodi	50
Società	AltostratLtd
ID client	CLIENT_ID
Ambiti	completo
Client secret	CLIENT_SECRET
Versione secret	4

Limitazioni del sistema

Il connettore Oracle Eloqua può elaborare un massimo di 12 transazioni al secondo per nodo e limita le transazioni che superano questo limite. Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Nota: il numero di nodi Integration Connectors verrà scalato automaticamente in base al tuo utilizzo. Tuttavia, se vuoi prenotare la capacità per volumi elevati senza dover attendere la scalabilità automatica, puoi modificare il valore minimo del nodo per una connessione. Per elaborare più transazioni per una connessione, sono necessari più nodi. Al contrario, sono necessari meno nodi se una connessione elabora meno transazioni. Per configurare i valori del nodo:

Se sei un cliente con pagamento a consumo, configura il valore minimo e massimo del nodo nella pagina di modifica della connessione.
Se sei un cliente con abbonamento, contatta l'assistenza.

Il numero massimo di transazioni che un nodo può gestire dipende da vari fattori. Pertanto, prima di modificare il numero minimo di nodi per migliorare il throughput, ti consigliamo di verificare se i sistemi di backend sono configurati in modo ottimale per gestire il traffico richiesto.

Utilizzare la connessione Oracle Eloqua in un'integrazione

Una volta creata, la connessione diventa disponibile sia nell'integrazione Apigee sia nell'integrazione delle applicazioni. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

Per informazioni su come creare e utilizzare l'attività Connectors in Apigee Integration, consulta Attività Connectors.
Per informazioni su come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elenca tutti gli AccountGroup

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona AccountGroup dall'elenco Entity.
Seleziona l'operazione List e poi fai clic su Fine.

Puoi eseguire l'operazione Elenca anche sulle seguenti entità:

Evento, utente e campagna

Esempio: ottieni un gruppo di account

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona AccountGroup dall'elenco Entity.
Seleziona l'operazione Get e poi fai clic su Fine.
Imposta l'ID entità sull'entità del gruppo di account. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati e poi inserisci 1 nel campo Valore di input e scegli EntityId come variabile locale.

Puoi eseguire l'operazione Get anche sulle seguenti entità: Email e Utente.

Esempio: eliminare un gruppo di account

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona AccountGroup dall'elenco Entity.
Seleziona l'operazione Delete e poi fai clic su Fine.
Imposta l'ID entità sull'entità del gruppo di account. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati e poi inserisci 8 nel campo Valore di input e scegli EntityId come variabile locale.

Puoi eseguire l'operazione di eliminazione anche sull'entità Email.

Esempio: creare una campagna

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Campaign dall'elenco Entity.
Seleziona l'operazione Create e fai clic su Fine.
Nella sezione Data mapper dell'editor Attività, fai clic su OpenDataMapping e inserisci un valore simile al seguente nel campo field:
```
{
  "Name": "AltostratCampaign1.11",
  "BudgetedCost": 100000
}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload del compito del connettore:
```
{
  "ID": 9
}
```

Esempio: creare un evento

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Evento dall'elenco Entity.
Seleziona l'operazione Create e fai clic su Fine.
Nella sezione Data mapper dell'editor Attività, fai clic su OpenDataMapping e inserisci un valore simile al seguente nel campo field:
```
{
  "Name": "Marketing Experience GCP2.2",
  "Description": "Modern Marketing Experience brings together Modern Marketers from around the globe",
  "EmailAddressFieldId": "-2"
}
```
L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload del compito del connettore:
```
{
  "Id": "16"
}
```

Esempio: aggiornare una campagna

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Campaign dall'elenco Entity.
Seleziona l'operazione Update e fai clic su Fine.
Imposta l'ID entità sull'entità della campagna. Per impostare l'attributo EntityID, nella sezione Data mapper di Attività, fai clic su EntityID e poi inserisci 5 nel campo apposito.
Nella sezione Data mapper dell'editor Attività, fai clic su OpenDataMapping e inserisci un valore simile al seguente nel campo field:
```
{
  "Name": "AltostratCamp9",
  "BudgetedCost": 100
}
```

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload del compito del connettore:

{
  "ID": 5
}

Esempio: aggiornare un'email

Nella finestra di dialogo Configure connector task, fai clic su Entities.
Seleziona Email dall'elenco Entity.
Seleziona l'operazione Update e fai clic su Fine.
Imposta l'ID entità sull'entità dell'email. Per impostare l'attributo EntityID, nella sezione Data mapper di Attività, fai clic su EntityID e poi inserisci 59 nel campo apposito.

Nella sezione Data mapper dell'editor Attività, fai clic su OpenDataMapping e inserisci un valore simile al seguente nel 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"
}

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload del compito del connettore:

{
  "ID": 59
}

Ricevere assistenza dalla community Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community di Google Cloud ai forum di Cloud.

Passaggi successivi

Scopri come sospendere e riprendere una connessione.
Scopri come monitorare l'utilizzo dei connettori.
Scopri come visualizzare i log dei connettori.