Consulta i connettori supportati per Application Integration.
Ascolta l'argomento Cloud Pub/Sub e invia un'email
Scopri come creare un'integrazione di esempio utilizzando Application Integration e il trigger di Cloud Pub/Sub. I passaggi seguenti spiegano come configurare l'attivatore, le attività, le variabili e le mappature dei dati richieste per eseguire un'integrazione completa.
Panoramica
In questa guida introduttiva, creerai un'integrazione con un trigger Cloud Pub/Sub per ascoltare un argomento Pub/Sub esistente che riceve letture della temperatura in gradi Kelvin da un dispositivo IoT. Puoi quindi utilizzare l'attività Mappatura dei dati per trasformare il messaggio Pub/Sub in Celsius e inviare il valore in un'email.
Prima di iniziare
Assegna i seguenti ruoli IAM (Identity and Access Management) all'agente di servizio Application Integration (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
) nel progetto Google Cloud:
- Editor Pub/Sub
- Invoker di Application Integration
Per ulteriori informazioni sull'assegnazione dei ruoli IAM, consulta Ruoli e autorizzazioni IAM.
Configura l'ambiente
crea un nuovo argomento Cloud Pub/Sub
Questa guida rapida presuppone che tu abbia un argomento Pub/Sub con riceve letture della temperatura in gradi Kelvin da un dispositivo IoT. Non è necessario avere effettivamente l'argomento connesso a un dispositivo. Questa guida rapida verifica la capacità dell'integrazione di ascoltare l'argomento ed eseguire delle attività quando vengono attivate.
Per creare un argomento di esempio ai fini di questa guida rapida:
- Vai alla pagina degli argomenti Pub/Sub nella console Cloud.
- Fai clic su Crea un argomento.
- Nel campo ID argomento, fornisci un nome univoco per l'argomento. Ad esempio,
temperaturesensor
- Fai clic su Salva.
Creazione di una nuova integrazione
Per creare una nuova integrazione:
- Nella console Google Cloud, vai alla pagina Application Integration.
- Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Integrations (Integrazioni).
- Fai clic su Crea integrazione.
- Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione. Ad esempio:
my-test-integration
. - Seleziona una regione per l'integrazione.
- Fai clic su Crea per aprire l'editor delle integrazioni.
Aggiungi un trigger di Cloud Pub/Sub
Per aggiungere un trigger di Cloud Pub/Sub all'integrazione, segui questi passaggi:- Nell'editor dell'integrazione, seleziona Trigger per visualizzare un elenco di attivatori disponibili.
- Fai clic sull'elemento trigger Cloud Pub/Sub e posizionalo nel designer.
Configurare un trigger Cloud Pub/Sub
Fai clic sull'elemento Trigger Cloud Pub/Sub nell'editor dell'integrazione per visualizzare la configurazione del trigger riquadro.
Specifica l'argomento che l'attivatore deve ascoltare nel campo Argomento Pub/Sub nel seguente formato:
projects/PROJECT_ID/topics/TOPIC_ID
- PROJECT_ID è il progetto Google Cloud in cui viene creato l'argomento.
- TOPIC_ID è l'ID dell'argomento Cloud Pub/Sub che hai creato nella sezione Prima di iniziare.
Ad esempio, se il progetto è denominato my-project
e hai denominato l'argomento temperaturesensor
, inserisci:
projects/my-project/topics/temperaturesensor
.
Per visualizzare tutti gli argomenti disponibili nel tuo progetto Google Cloud, consulta la colonna Nome argomento in Argomenti.
Il riquadro di configurazione del trigger di Cloud Pub/Sub compilerà automaticamente il campo Output trigger con una variabile da conservare il messaggio Pub/Sub.
Aggiungere e configurare l'attività mappatura dei dati
Per configurare l'attività Mappatura dei dati:
- Seleziona Attività per visualizzare un elenco delle attività disponibili.
- Fai clic sull'elemento Mappatura dei dati e posizionalo nell'editor dell'integrazione.
- Fai clic sull'attività Mappatura dei dati nel designer per aprire il riquadro di configurazione l'attività.
- Fai clic su Apri editor di mappatura dei dati.
L'editor di mappatura dei dati ti consente di mappare le variabili di input alle variabili di output desiderate, utilizzando le funzioni di trasformazione disponibili. L'output viene quindi disponibile come variabile per qualsiasi altra attività o attivatore di integrazione. Per ulteriori dettagli su per passare i dati come variabili, consulta Utilizzo delle variabili in Application Integration.
Per questa guida rapida, segui questi passaggi per creare una mappatura utilizzando
CloudPubSubMessage
come input:- Espandi la variabile JSON
CloudPubSubMessage
nell'elenco Variabili e trascina la variabileCloudPubSubMessage.data
. alla prima riga Input. - Fai clic su + (Aggiungi una funzione) accanto alla variabile
CloudPubSubMessage.data
per visualizzare l'elenco a discesa delle funzioni. - Seleziona
TO_DOUBLE()
per convertire il valoreCloudPubSubMessage.data
a un tipo di datidouble
. - Fai di nuovo clic su + (Aggiungi una funzione) per selezionare e concatenare la funzione
SUBTRACT
. - Inserisci
273.15
come valore della funzioneSUBTRACT
. Questo serve a convertire il Kelvin temperatura in gradi Celsius. - Fai clic sulla prima riga della colonna Output per creare una nuova variabile di output che contenga il valore dei dati trasformati. Completa i seguenti campi:
- Nome: inserisci
TempInCelsius
. - Seleziona Utilizza come output dell'integrazione.
- Fai clic su Crea per creare la variabile e chiudere il riquadro. La nuova variabile TempInCelsius verrà visualizzata nella Elenco Variabili.
- Nome: inserisci
- Trascina la variabile TempInCelsius dall'elenco Variabili alla seconda nella colonna Input.
- Fai clic su + (Aggiungi una funzione) nella variabile TempInCelsius per visualizzare l'elenco a discesa delle funzioni.
- Fai clic su
TO_STRING()
per trasformare il tipo di dati della variabile dadouble
instring
. - Fai clic sulla seconda riga della colonna Output per creare una nuova variabile che contenga il valore dell'oggetto trasformato
e i dati di Google Cloud. Completa i seguenti campi:
- Nome: inserisci
TempInCelsiusString
. - Valore predefinito vuoto:seleziona Stringa vuota.
- Seleziona la casella di controllo Utilizza come output di integrazione.
- Fai clic su Crea per creare la variabile e chiudere il riquadro. La nuova variabile viene visualizzata nella Elenco Variabili a sinistra dell'editor di mappatura dei dati.
- Nome: inserisci
- Chiudi l'editor di mappatura dei dati al termine della mappatura. Eventuali modifiche verranno salvate automaticamente.
- Espandi la variabile JSON
Aggiungi e configura l'attività Invia email
Per configurare l'attività Invia email:
- Seleziona Attività nell'editor di integrazione per visualizzare l'elenco delle attività disponibili.
- Fai clic sull'elemento Invia email e posizionalo nell'editor dell'integrazione.
- Fai clic sull'elemento Send Email (Invia email) del designer per aprire il riquadro di configurazione
dell'attività. Imposta le seguenti proprietà:
- Destinatari: inserisci il tuo indirizzo email. Utilizzerai questa email per confermare il completamento dell'integrazione.
- Oggetto: inserisci
Temperature in Celsius
. - Corpo in testo normale: seleziona la variabile
TempInCelsiusString
creata in precedenza nell'attività Mappatura dei dati. - Le altre opzioni possono essere lasciate nella configurazione predefinita.
Aggiungi le connessioni perimetrali richieste
Un perimetro è una connessione tra due elementi qualsiasi in un'integrazione. La connessione indica la direzione del flusso di controllo da un elemento (attività o trigger) a un altro. Per ulteriori informazioni sui bordi, consulta la sezione Bordi.
- Aggiungi una connessione perimetrale dall'elemento trigger Cloud Pub/Sub alla L'elemento Mappatura dei dati passando il mouse sopra un punto di controllo sull'elemento Trigger Cloud Pub/Sub facendo clic su una linea e trascinandola fino a un punto di controllo sull'elemento dell'attività Mappatura dei dati. Questo bordo indica il flusso di controllo dall'attività Trigger Cloud Pub/Sub all'attività Mappatura dei dati.
- Aggiungi una connessione perimetrale dall'elemento Data Mapping alla L'elemento Invia email passa il mouse sopra un punto di controllo sull'elemento Mappatura dei dati, quindi facendo clic su una linea e trascinandola fino a un punto di controllo nell'elemento dell'attività Invia email. Questo bordo indica il flusso di controllo dalla mappatura dei dati all'attività Invia email.
La connessione completata dovrebbe essere visualizzata come mostrato nella figura seguente:
Testa l'integrazione
Per testare la nuova integrazione dalla pagina Argomenti di Pub/Sub, segui questi passaggi:
- Vai alla pagina degli argomenti Pub/Sub nella console Cloud.
- Cerca e seleziona l'argomento temperaturesensor che hai creato.
- Dalla pagina dei dettagli dell'argomento, fai clic su + Pubblica messaggio per aprire il riquadro di configurazione Pubblica messaggio.
- Nel campo Corpo del messaggio, inserisci
307.15
.La creazione di questo messaggio simula la pubblicazione di una lettura della temperatura in Kelvin ricevuti da Pub/Sub da un dispositivo IoT.
- Fai clic su Pubblica per pubblicare il messaggio nell'argomento e attivare l'integrazione.
Una volta completata l'integrazione, all'indirizzo email viene inviata un'email con la temperatura Kelvin convertita in gradi Celsius. specificato nell'attività Invia email. Conferma la ricezione dell'email nel tuo client di posta.
L'email inviata dall'integrazione deve avere un corpo del messaggio contenente il valore 34
.
Oltre a verificare i contenuti dell'email, puoi esaminare i log per visualizzare lo stato e il payload di una determinata integrazione. Per visualizzare i log:
- Nell'editor dell'integrazione, fai clic su Visualizza i log di esecuzione per questa integrazione. Viene visualizzata la pagina Log di esecuzione. Per saperne di più sui log di esecuzione, consulta Visualizzare i log di esecuzione dell'integrazione.
- Nella pagina Log di esecuzione puoi visualizzare i dettagli di ogni tentativo di eseguire un'integrazione.
Ogni voce include i dettagli del tentativo di esecuzione, tra cui:
- Nome integrazione
- ID esecuzione
- Stato
- Data/Ora di inizio
- Durata
- Versione integrazione
- ID attivatore
- Fai clic sulla freccia di espansione (>) accanto all'integrazione eseguita per visualizzare un elenco espanso di attività e variabili nell'integrazione, insieme allo stato dell'attività e ai payload delle variabili.
Quote e limiti
Per informazioni su quote e limiti, consulta Quote e limiti.