MQ IBM

Stai visualizzando la documentazione di Apigee e Apigee ibrido.
Visualizza la documentazione di Apigee Edge.

Il connettore IBM MQ fornisce connettività a IBM MQ.

Prima di iniziare

Prima di utilizzare il connettore Ibmmq, esegui le seguenti operazioni:

Nel progetto Google Cloud:
- 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 di Google. Se non ne hai uno, devi crearne uno. Per saperne di più, consulta Creazione di un account di servizio.
- Abilita i seguenti servizi:
  - apigee.googleapis.com (API Apigee)
  - secretmanager.googleapis.com (API Secret Manager)
  - connectors.googleapis.com (API Connectors)
  Per saperne di più su come attivare i servizi, vedi Attivare i servizi.
Se questi servizi o autorizzazioni non sono stati abilitati per il tuo progetto in precedenza, ti verrà chiesto di abilitarli durante la configurazione del connettore.

Configura il connettore

Per configurare il connettore è necessario creare una connessione all'origine dati (sistema di backend). Una connessione è specifica per un'origine dati. Ciò significa che, se disponi di molte origini dati, devi creare una connessione separata per ogni origine. Per creare una connessione:

Nella console Cloud, vai alla pagina Apigee > Connettori, quindi seleziona o crea un progetto Google Cloud.
Vai alla pagina Connections (Connessioni)
Fai clic su + CREA NUOVO per aprire la pagina Crea connessione.
Nella sezione Località, scegli la posizione per la connessione.
1. Regione: seleziona una località dall'elenco a discesa.
  Le regioni supportate per i connettori includono:
  - asia-east1
  - asia-northeast1
  - asia-south1
  - asia-southeast1
  - australia-southeast1
  - europe-west1
  - europe-west2
  - europe-west3
  - europe-west4
  - europe-west6
  - northamerica-northeast1
  - southamerica-east1
  - us-central1
  - us-east1
  - us-east4
  - us-west1
  - us-west2
2. Fai clic su AVANTI.
Nella sezione Dettagli connessione, completa i seguenti passaggi:
1. Connettore: seleziona IBM MQ dall'elenco a discesa dei connettori disponibili.
2. Versione 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 63 caratteri.
4. Facoltativamente, inserisci una Descrizione per l'istanza di connessione.
5. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
6. Nome coda predefinito: il nome della coda predefinita può essere sostituito durante l'esecuzione dell'azione.
7. Nome del gestore delle code: il nome del gestore della coda a cui connetterti.
8. Nome del canale: il canale da collegare a Queue Manager.
9. In via facoltativa, fai clic su + AGGIUNGI ETICHETTA per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
10. Fai clic su AVANTI.
Nella sezione Destinazioni, inserisci i dettagli dell'host remoto (sistema di backend) a cui vuoi connetterti.
1. Tipo di destinazione: puoi specificare i dettagli della destinazione come indirizzo host o collegamento a un servizio. Seleziona uno dei seguenti tipi di destinazione:
  - Indirizzo host: se vuoi specificare il nome host o l'indirizzo IP della destinazione.
  - Collegamento di servizio: se vuoi specificare l'endpoint privato per i tuoi indirizzi IP interni. Il collegamento del servizio consente di nascondere gli indirizzi IP interni dalla rete esterna. Puoi creare un collegamento a un servizio in Google Cloud utilizzando la funzionalità Private Service Connect. Per informazioni sulla configurazione di Private Service Connect, vedi Pubblicare servizi gestiti.
  In base alla selezione del tipo di destinazione, inserisci l'indirizzo host o il nome dell'allegato del servizio.
  
  Per inserire altre destinazioni, 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 IBM MQ supporta i seguenti tipi di autenticazione:
  - Anonimo
  - Nome utente e password
2. Fai clic su AVANTI.
Esamina: esamina i dettagli di connessione e autenticazione.
Fai clic su Crea.

Configura l'autenticazione

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

Anonimo
Se vuoi utilizzare l'accesso anonimo, seleziona Non disponibile.

Nome utente e password
- Nome utente: il nome utente IBM MQ da utilizzare per la connessione.
- Password: Secret Manager Secret contenente la password associata al nome utente IBM MQ.

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. È possibile accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

Entità : un'entità può essere considerata come un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità differisce da un connettore a un connettore. Ad esempio, per una connessione al database, le tabelle sono entità, per una connessione file server le cartelle sono entità e, per una connessione al sistema di messaggistica, le code sono entità. Tuttavia, è possibile che un connettore non supporti le entità, nel qual caso l'elenco Entities sarà vuoto.
Operazioni : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una qualsiasi delle seguenti operazioni su un'entità:
- Elenco
- Get
- Crea
- Aggiornamento
- Elimina
Se selezioni un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta l'articolo sulle operazioni delle entità dell'attività Connettori. Tuttavia, è possibile che un connettore non supporti le operazioni delle entità, nel qual caso l'elenco Operations sarà vuoto.
Azioni: un'azione è una funzione di prima classe che viene resa disponibile per l'integrazione tramite l'interfaccia del connettore. Le azioni consentono di apportare modifiche a un'entità o alle entità e variano da connettore a connettore. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

La connessione IBM MQ supporta le seguenti azioni:

sendMessage invia un messaggio a una coda.
requestAnswer: invia un messaggio a una coda e specifica anche la coda di risposta in cui l'autore della risposta deve scrivere la risposta.

azione sendMessage

Le seguenti tabelle descrivono i parametri di input e output dell'azione sendMessage.

Parametri di input dell'azione sendMessage

Nome parametro	Obbligatoria	Tipo di dati	Descrizione
messaggio	Sì	Stringa	Messaggio da inviare alla coda IBM MQ. Attualmente, la dimensione massima supportata per i messaggi è 10 MB.
nome coda	No	Stringa	Nome della coda IBM MQ. Se non specifichi un nome di coda, viene utilizzato il nome predefinito della coda durante la creazione della connessione.
messageContentType	Sì	Stringa	Tipo di contenuti dei messaggi che puoi specificare come `Text` o `Bytes`. Devi impostare il tipo su `Bytes` se stai inviando dati binari. Per inviare un messaggio in formato binario, devi eseguire le seguenti attività: Codifica il messaggio binario come stringa Base64, quindi imposta il parametro `message` sul valore codificato. Imposta il valore del parametro `messageContentType` su `Bytes`.
tipo messaggio	Sì	Stringa	Tipo di messaggio che puoi specificare come `Datagram` o `Reply`.

Parametri di output dell'azione sendMessage

Nome parametro	Tipo di dati	Descrizione
ID messaggio	Stringa	ID del messaggio inviato.

azionerequestAnswer

Le seguenti tabelle descrivono i parametri di input e output dell'azione requestAnswer.

Inserisci i parametri dell'azione requestAnswer

Nome parametro	Obbligatoria	Tipo di dati	Descrizione
messaggio	Sì	Stringa	Messaggio da inviare alla coda IBM MQ. La dimensione massima supportata per i messaggi è 10 MB.
nome coda	No	Stringa	Nome della coda IBM MQ. Se non specifichi un nome di coda, viene utilizzato il nome predefinito della coda durante la creazione della connessione.
messageContentType	Sì	Stringa	Tipo di contenuti dei messaggi che puoi specificare come `Text` o `Bytes`. Devi impostare il tipo su `Bytes` se stai inviando dati binari. Per inviare un messaggio in formato binario, devi eseguire le seguenti attività: Codifica il messaggio binario come stringa Base64, quindi imposta il parametro `message` sul valore codificato. Imposta il valore del parametro `messageContentType` su `Bytes`.
answerToQueue	Sì	Stringa	Coda su cui l'autore della risposta deve scrivere la risposta.
RispondiTimeout	Sì	Stringa	Il tempo (in millisecondi) finché il connettore attende la risposta nella coda delle risposte. Il valore massimo supportato è 180.000 millisecondi (3 minuti). Se la coda delle risposte riceve un messaggio dopo il periodo di timeout, il messaggio non viene elaborato dal connettore. Tuttavia, puoi visualizzare i dettagli dei messaggi scaduti nei log di esecuzione dell'integrazione. Nota: l'impostazione di un valore di timeout più elevato potrebbe influire sulle prestazioni del connettore.

Parametri di output dell'azione requestAnswer

Nome parametro	Tipo di dati	Descrizione
rispostaMessaggio	Stringa	Messaggio di risposta dell'autore della risposta.

Utilizza la connessione IBM MQ in un'integrazione

Dopo aver creato la connessione, questa diventa disponibile nellApigee Integration. Puoi quindi utilizzare la connessione per configurare l'attività Connettori nell'integrazione. Per saperne di più, consulta Configurare l'attività Connettori.