Introduzione all'Apigee Integration e al trigger di Cloud Pub/Sub

Annuncio: Application Integration è ora disponibile per il tuo progetto Google Cloud. Ora puoi utilizzare sia Apigee Integration che Application Integration all'interno dello stesso progetto Google Cloud. Scopri di più

Scopri come creare un'integrazione di esempio utilizzando Apigee Integration e il trigger di Cloud Pub/Sub. I passaggi seguenti descrivono come configurare il trigger, le attività, le variabili e le mappature dei dati necessarie per eseguire un'integrazione completa.

Panoramica

In questa guida rapida, creerai un'integrazione con un trigger di 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

Assicurati di eseguire le attività seguenti prima di iniziare la guida rapida:

• Assegna i seguenti ruoli IAM all'agente di servizio di integrazione Apigee ([e-mail]) nel tuo progetto Google Cloud.
  • Editor Pub/Sub
  • Invoker dell'integrazione Apigee

    Per maggiori 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 che riceve le letture della temperatura in gradi Kelvin da un dispositivo IoT. Non è necessario che l'argomento sia effettivamente collegato a un dispositivo. Questa guida rapida verifica la capacità dell'integrazione di rimanere in ascolto dell'argomento ed eseguire 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: per questo argomento non è necessario un abbonamento per attivare l'integrazione.

Creazione di una nuova integrazione

Per creare una nuova integrazione, segui questi passaggi:

1. Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
2. Fai clic su Sviluppa > Integrazioni.
3. Fai clic su Create integration (Crea integrazione).
4. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione. Ad esempio, my-test-integration.
   Nota:i nomi di integrazione 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 di un trattino basso in una riga.
5. Seleziona una regione per l'integrazione.
   Nota:nel menu a discesa Regioni sono elencate solo le regioni di cui è stato eseguito il provisioning nel tuo progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Abilita regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
6. Fai clic su Crea per aprire l'editor di integrazione.

Aggiungi un trigger di Cloud Pub/Sub

Per aggiungere un trigger di Cloud Pub/Sub all'integrazione:
1. Nell'editor di integrazione, seleziona Attivatori per visualizzare un elenco degli attivatori disponibili.
2. Fai clic sull'elemento trigger di Cloud Pub/Sub e posizionalo nel designer.

configura un trigger di Cloud Pub/Sub

Fai clic sull'elemento Trigger di Cloud Pub/Sub nell'editor di integrazione per visualizzare il riquadro di configurazione del trigger.

Specifica l'argomento che il trigger deve rimanere in ascolto nel campo Argomento Pub/Sub nel seguente formato:

projects/PROJECT_ID/topics/TOPIC_ID

dove:
• PROJECT_ID è il progetto Google Cloud in cui viene creato l'argomento.
• TOPIC_ID è l'ID dell'argomento Cloud Pub/Sub che hai creato in Prima di iniziare.

Ad esempio, se il nome del tuo progetto è my-project e hai assegnato all'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 completerà automaticamente il campo Output del trigger con una variabile che conterrà il messaggio Pub/Sub.

Aggiungi e configura 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 sull'elemento Data Mapping e posizionalo 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 consente di mappare le variabili di input a quelle di output desiderate, utilizzando le funzioni di trasformazione disponibili. L'output è quindi disponibile come variabile per qualsiasi altro trigger o attività di integrazione. Per maggiori dettagli sul passaggio dei dati come variabili, consulta Utilizzare le variabili in Apigee Integration.

   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 di 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 Kelvin in gradi Celsius.
   6. Fai clic sulla prima riga della colonna Output per creare una nuova variabile di output contenente il valore dei dati trasformati. Completa i seguenti campi:
      • Nome:inserisci TempInCelsius.
      • Seleziona Utilizza come output di 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.
       • Un valore predefinito vuoto indica:seleziona Stringa vuota.
       • Seleziona la casella di controllo Usa come output di 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 Data Mapping Editor al termine della mappatura. Le modifiche verranno salvate automaticamente.

Aggiungi e configura l'attività Invia email

Per configurare l'attività Invia email:

1. Seleziona Tasks nell'editor di integrazione per visualizzare l'elenco delle attività disponibili.
2. Fai clic sull'elemento Send Email e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento Send Email sul designer per aprire il riquadro di configurazione dell'attività. Imposta le seguenti proprietà:
   • Ai destinatari: inserisci il tuo indirizzo email. Utilizzerai questo indirizzo email per confermare il corretto 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 restanti opzioni possono essere lasciate nella configurazione predefinita.
   Le modifiche alle proprietà vengono salvate automaticamente.

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 attivatore) a un altro. Per ulteriori informazioni sui bordi, vedi Bordi.

1. Aggiungi una connessione perimetrale dall'elemento trigger di Cloud Pub/Sub all'elemento Data Mapping passando il mouse sopra un punto di controllo sull'elemento trigger di Cloud Pub/Sub, quindi facendo clic e trascinando una linea su un punto di controllo sull'elemento attività Mappatura dei dati. Questo perimetro indica il flusso di controllo dall'attività trigger di Cloud Pub/Sub all'attività Mappatura dei dati.
2. Aggiungi una connessione perimetrale dall'elemento Data Mapping all'elemento Send Email passando il mouse sopra un punto di controllo sull'elemento Data Mapping, quindi fai clic e trascina una linea in un punto di controllo sull'elemento attività Send Email (Invia email). Questo bordo indica il flusso di controllo dall'attività Mappatura dei dati all'attività Invia email.

La connessione completata dovrebbe essere visualizzata come nell'immagine seguente:



Testare l'integrazione

Per testare la nuova integrazione dalla pagina degli argomenti 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 sensore di temperatura 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 della 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.

Una volta completata l'integrazione, l'integrazione invia un'email con la temperatura 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 di 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.
2. 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
   • 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 delle attività e ai payload variabili.