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 l'integrazione di applicazioni e l'trigger Cloud Pub/Sub. I passaggi riportati di seguito descrivono come configurare l'attivatore, le attività, le variabili e le mappature dei dati necessari 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 gradi Celsius e inviare il valore in un'email.

Prima di iniziare

Assegna i seguenti ruoli IAM (Identity and Access Management) all'agente del servizio di integrazione delle applicazioni ([e-mail]) nel tuo Google Cloud progetto:

• Pub/Sub Editor
• Application Integration Invoker

  Per ulteriori informazioni sull'assegnazione dei ruoli IAM, consulta Ruoli e autorizzazioni IAM.

Configura l'ambiente

Creare un nuovo argomento Cloud Pub/Sub

Questa guida introduttiva presuppone che tu abbia un argomento Pub/Sub che riceve letture della temperatura in gradi Kelvin da un dispositivo IoT. Non è necessario collegare l'argomento a un dispositivo. Questa guida rapida verifica la capacità dell'integrazione di ascoltare l'argomento ed eseguire le attività quando viene attivata.

Per creare un argomento di esempio ai fini di questa guida rapida:

1. Vai alla pagina degli argomenti Pub/Sub nella console Cloud.

   Vai alla pagina degli argomenti Pub/Sub

2. Fai clic su Crea un argomento.
3. Nel campo ID argomento, fornisci un nome univoco per l'argomento. Ad esempio, temperaturesensor
4. Fai clic su Salva.

Nota: non è necessario creare un abbonamento per il funzionamento dell'attivatore. L'integrazione delle applicazioni crea automaticamente una sottoscrizione per un argomento quando pubblichi l'integrazione e puoi visualizzare tutte le tue sottoscrizioni nella pagina delle sottoscrizioni Pub/Sub.

A partire dalla release dell'integrazione delle applicazioni del 1° dicembre 2023, ti verranno addebitati gli abbonamenti in base alle tariffe di fatturazione di Pub/Sub. Gli abbonamenti per l'attivatore Cloud Pub/Sub esistente continueranno a funzionare come prima e non verranno fatturati. Tuttavia, se aggiorni l'argomento di un trigger Cloud Pub/Sub esistente, la fatturazione Pub/Sub verrà applicata all'trigger Cloud Pub/Sub aggiornato.

Creazione di una nuova integrazione

Per creare una nuova integrazione, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Integrazioni.
3. Fai clic su Crea integrazione.
4. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione. Ad esempio, my-test-integration.
   Nota: i nomi delle integrazioni devono soddisfare i seguenti requisiti:

   • I nomi devono iniziare e terminare con lettere o numeri.
   • I nomi non possono contenere spazi o più di un trattino o trattino basso in una riga.
5. Seleziona una regione per l'integrazione.
   Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
6. Fai clic su Crea per aprire l'editor di integrazione.

Aggiungi un trigger Cloud Pub/Sub

Per aggiungere un trigger Cloud Pub/Sub all'integrazione, segui questi passaggi:

1. Nell'editor dell'integrazione, seleziona Trigger per visualizzare un elenco di trigger disponibili.
2. 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 di integrazione per visualizzare il riquadro di configurazione dell'attivatore.

Specifica l'argomento che l'attivatore deve ascoltare nel campo Argomento Pub/Sub nel seguente formato:

projects/PROJECT_ID/topics/TOPIC_ID

where:

• PROJECT_ID è il progetto Google Cloud in cui è stato 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 si chiama my-project e hai chiamato 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 dell'trigger Cloud Pub/Sub compila automaticamente il campo Output trigger con una variabile per memorizzare il messaggio Pub/Sub.

Aggiungere e configurare l'attività di mappatura dei dati

Per configurare l'attività Mappatura dei dati:

1. Seleziona Attività per visualizzare un elenco delle attività disponibili.
2. Fai clic e posiziona l'elemento Mappatura dei dati nell'editor di integrazione.
3. Fai clic sull'attività Mappatura dei dati nel designer per aprire il riquadro di configurazione dell'attività.
4. 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 è quindi disponibile come variabile per qualsiasi altra attività o trigger di integrazione. Per ulteriori dettagli sul passaggio dei dati come variabili, consulta Utilizzare le variabili nell'integrazione delle applicazioni.

   Per questa guida rapida, segui questi passaggi per creare una mappatura utilizzando CloudPubSubMessage come input:

   1. Espandi la variabile JSON CloudPubSubMessage nell'elenco Variabili e trascina la variabile CloudPubSubMessage.data nella prima riga Input.
   2. Fai clic su + (Aggiungi una funzione) accanto alla variabile CloudPubSubMessage.data per visualizzare l'elenco a discesa delle funzioni disponibili.
   3. Seleziona TO_DOUBLE() per convertire il valore CloudPubSubMessage.data in un tipo di dati double.
   4. Fai di nuovo clic su + (Aggiungi una funzione) per selezionare e concatenare la funzione SUBTRACT.
   5. Inserisci 273.15 come valore della funzione SUBTRACT. Questo serve a convertire la temperatura in Kelvin in gradi Celsius.
   6. 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 nell'elenco Variabili.
   7. Trascina la variabile TempInCelsius dall'elenco Variabili alla seconda riga della colonna Input.
   8. Fai clic su + (Aggiungi una funzione) nella variabile TempInCelsius per visualizzare l'elenco a discesa delle funzioni disponibili.
   9. Fai clic su TO_STRING() per trasformare il tipo di dati della variabile da double a string.
   10. Fai clic sulla seconda riga della colonna Output per creare una nuova variabile che contenga il valore dei dati trasformati. Completa i seguenti campi:
       • Nome: inserisci TempInCelsiusString.
       • Valore predefinito vuoto: seleziona Stringa vuota.
       • Seleziona la casella di controllo Utilizza come output dell'integrazione.
       • Fai clic su Crea per creare la variabile e chiudere il riquadro. La nuova variabile verrà visualizzata nell'elenco Variabili sul lato sinistro dell'editor di mappatura dei dati.
   11. Chiudi l'editor di mappatura dei dati al termine della mappatura. Eventuali modifiche verranno salvate automaticamente.

Aggiungi e configura l'attività Invia email

Per configurare l'attività Invia email:

1. Seleziona Attività nell'editor di integrazione per visualizzare l'elenco delle attività disponibili.
2. Fai clic e posiziona l'elemento Invia email nell'editor di integrazione.
3. Fai clic sull'elemento Invia email nel 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.
   • Testo in formato normale:seleziona la variabile TempInCelsiusString creata in precedenza nell'attività Mappatura dei dati.
   • Le opzioni rimanenti possono essere lasciate nella configurazione predefinita.
   Le modifiche alle proprietà vengono salvate automaticamente.

Aggiungi le connessioni ai bordi richieste

Un arco è una connessione tra due elementi in un'integrazione. La connessione indica la direzione del flusso di controllo da un elemento(attività o trigger) a un altro. Per ulteriori informazioni sugli edge, consulta Edge.

1. Aggiungi una connessione di bordo dall'elemento Trigger Cloud Pub/Sub all'elemento Mappatura dati passando il mouse sopra un punto di controllo sull'elemento Trigger Cloud Pub/Sub, quindi fai clic e trascina una riga in un punto di controllo sull'elemento dell'attività Mappatura dati. Questo bordo indica il flusso di controllo dall'attività Trigger Cloud Pub/Sub all'attività Mappatura dei dati.
2. Aggiungi una connessione di bordo dall'elemento Mappatura dati all'elemento Invia email passando il mouse sopra un punto di controllo sull'elemento Mappatura dati, quindi fai clic e trascina una riga in un punto di controllo sull'elemento dell'attività Invia email. Questo bordo indica il flusso di controllo dall'attività Mappatura dei dati all'attività Invia email.

Il collegamento completato dovrebbe apparire come mostrato nella figura seguente:

Pubblicare l'integrazione

Per pubblicare l'integrazione, fai clic su Pubblica nella barra degli strumenti dell'Editor integrazioni.

Una volta completata la pubblicazione dell'integrazione, puoi visualizzare e controllare i log di esecuzione dell'integrazione pubblicata. Per visualizzare i log, fai clic su Visualizza i log di esecuzione per questa integrazione. Viene visualizzata la pagina Log di esecuzione.

Testa l'integrazione utilizzando Cloud Pub/Sub

Per testare la nuova integrazione dalla pagina Argomenti di Pub/Sub, segui questi passaggi:

1. Vai alla pagina degli argomenti Pub/Sub nella console Cloud.

   Vai alla pagina degli argomenti Pub/Sub

2. Cerca e seleziona l'argomento temperaturesensor che hai creato.
3. Nella pagina dei dettagli dell'argomento, fai clic su + Pubblica messaggio per aprire il riquadro di configurazione Pubblica messaggio.
4. Nel campo Corpo del messaggio, inserisci 307.15.

   La creazione di questo messaggio simula la pubblicazione di una lettura della temperatura in Kelvin ricevuta da Pub/Sub da un dispositivo IoT.

5. Fai clic su Pubblica per pubblicare il messaggio nell'argomento e attivare l'integrazione.

Al termine dell'operazione, l'integrazione invia un'email con la temperatura in Kelvin convertita in gradi Celsius all'indirizzo email 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:

1. Nell'editor dell'integrazione, fai clic su Visualizza i log di esecuzione per questa integrazione. Viene visualizzata la pagina Log di esecuzione. Per ulteriori informazioni sui log di esecuzione, vedi Visualizzare i log di esecuzione dell'integrazione.
2. Nella pagina Log di esecuzione, puoi visualizzare i dettagli di ogni tentativo di esecuzione di un'integrazione. Ogni voce include i dettagli del tentativo di esecuzione, tra cui:
   • Nome integrazione
   • ID esecuzione
   • Stato
   • Ora di inizio
   • Durata
   • Versione integrazione
   • ID attivatore
3. 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.