Recupera il payload dell'API e invia un'email

Scopri come creare un'integrazione di esempio in Application Integration. I passaggi riportati di seguito descrivono come configurare l'attivatore, le attività, gli edge, le variabili e le mappature dei dati necessari per eseguire un'integrazione completa.

Panoramica

In questa guida rapida, recupererai il numero di visualizzazioni di pagina da un'API pubblica, trasformerai i dati in un formato utilizzabile, e inviare l'elenco risultante in un'email, il tutto dall'editor di integrazione.

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud, fai clic su Procedura guidata:

Procedura guidata

Creazione di una nuova integrazione

Per creare una nuova integrazione:

Nella console Google Cloud, vai alla pagina Integrazione delle applicazioni.
Vai ad 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.
Per questa guida rapida, inserisci il nome my-test-integration e la descrizione Integration for quickstart.
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.
Fai clic su Crea per aprire l'editor delle integrazioni.

Aggiungere e configurare un trigger API

Gli attivatori sono necessari per avviare la sequenza di attività che compongono un'integrazione. Qualsiasi disponibile un trigger per avviare un'integrazione. Per questa guida rapida, utilizza l'attivatore API.

Per configurare l'attivatore API, segui questi passaggi:

Nell'editor dell'integrazione, fai clic su Attivatori per visualizzare un elenco degli attivatori disponibili.
Fai clic su Trigger API nell'editor di integrazione.
Per configurare l'attivatore, fai clic su Trigger API. Viene visualizzato il riquadro di configurazione dell'attivatore.
Application Integration compila automaticamente i campi Etichetta e ID trigger dei trigger. L'ID attivatore è generato automaticamente e non puoi modificarne il valore. Tuttavia, puoi modificare il valore della proprietà Etichetta.
Le modifiche alle proprietà vengono salvate automaticamente.

Aggiungere e configurare attività

Un'attività è un insieme di passaggi eseguibili che può accettare variabili come input e generare variabili come output. Come per gli attivatori, in un'integrazione è possibile utilizzare qualsiasi attività disponibile. Questa guida rapida utilizza Chiama endpoint REST, Mappatura dei dati e Invia email. I dettagli di configurazione di ogni attività sono descritti nei passaggi riportati di seguito.

Configurare l'attività di chiamata endpoint REST

Per configurare l'attività Chiama endpoint REST:

Seleziona Attività per visualizzare un elenco delle attività disponibili.
Fai clic e posiziona Chiama endpoint REST nell'editor di integrazione.
Aggiungi una connessione di bordo da Trigger API a Chiama endpoint REST passando il mouse sopra un punto di controllo su Trigger API, quindi fai clic e trascina una riga in un punto di controllo nell'attività Chiama endpoint REST. Il bordo indica il flusso di controllo dall'Trigger API all'Attività Chiamata endpoint REST.
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 saperne di più sugli edge, consulta Edge.
Per configurare l'attività, fai clic su Chiama endpoint REST. L'attività viene visualizzato il riquadro di configurazione. Imposta le seguenti proprietà:
- Etichetta:inserisci un nome personalizzato per questa attività. Ad esempio, inserisci Call REST Endpoint Task.
- Autenticazione: per questa guida rapida, non è richiesto un profilo di autenticazione. Per ulteriori informazioni sull'utilizzo dei profili di autenticazione per altri casi d'uso, vedi Crea profili di autenticazione in Application Integration.
- Input dell'attività: inserisci i dettagli per chiamare l'endpoint REST. Le informazioni inserite qui vengono utilizzate come input per l'attività Endpoint REST di chiamata. Il seguente diagramma mostra le sezioni Input attività e Impostazioni HTTP per l'attività Chiama endpoint REST:
  
  Inserisci le seguenti informazioni:
  - URL di base endpoint: inserisci https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/en.wikipedia/desktop/user/Tree/monthly/20201001/20201031. Questa API pubblica di wikimedia.org restituisce il numero di visualizzazioni di pagina per un articolo chiamato Tree per un determinato mese.
  - Metodo HTTP: seleziona GET utilizzando l'elenco a discesa.
- Impostazioni HTTP: l'integrazione delle applicazioni compila i seguenti valori:
  1. Segui i reindirizzamenti: True
  2. L'attività non dovrebbe riuscire in caso di errore HTTP: True
- Output dell'attività: l'integrazione dell'applicazione compila tre variabili per contenere l'output dei dati di risposta della chiamata all'endpoint REST. Il seguente diagramma mostra l'Output dell'attività e altre sezioni per l'attività Chiama endpoint REST:
  
  Esamina le seguenti informazioni:
  - responseHeader(Call REST Endpoint): questa variabile contiene i dati dell'intestazione della risposta associati all'attività Call REST Endpoint. I dati della variabile sono di tipo String (STR).
  - responseBody(Call REST Endpoint): questa variabile contiene il corpo della risposta I dati associati all'attività Chiama endpoint REST. I dati variabili è di tipo String (STR).
  - responseStatus(Call REST Endpoint): questa variabile contiene i dati dello stato della risposta associati all'attività Call REST Endpoint. I dati variabili è di tipo String (STR).
- I restanti campi devono contenere i seguenti valori predefiniti:
  - Strategia di esecuzione per questa attività: When all tasks succeed
  - Criterio di esecuzione per l'attività successiva: Run all match
Le modifiche alle proprietà vengono salvate automaticamente.

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 su Mappatura dei dati e posizionalo nell'editor integrazioni.
Aggiungi una connessione perimetrale da Chiama endpoint REST a Mappatura dei dati passando il mouse sopra un punto di controllo in Chiama endpoint REST. facendo clic su una linea e trascinandola fino a un punto di controllo nell'attività Mappatura dei dati. Il bordo indica il flusso di controllo dall'attività Chiamata endpoint REST all'attività Mappatura dei dati.
Per configurare l'attività, fai clic sull'attività Mappatura dei dati. Viene visualizzato il riquadro di configurazione della tarefa.
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 su per passare i dati come variabili, consulta Variabili.

Per questa guida rapida, crea una mappatura utilizzando responseBody(Call REST Endpoint) come input:
1. Trascina la variabile responseBody dal riquadro Variabili alla prima riga Input.
2. Fai clic su + (Aggiungi una funzione) nel chip della variabile responseBody per visualizzare l'elenco delle funzioni disponibili. Puoi applicare varie funzioni per trasformare i dati nella variabile di input.
  In questo caso, puoi convertire il payload in JSON e quindi Esegui l'iterazione dell'array di risposta per ottenere l'elenco dei nomi dei prodotti richiesti per le notifiche via email. Per farlo, segui questi passaggi:
  - Seleziona TO_JSON() per convertire la stringa responseBody in JSON.
  - Fai clic su + (Aggiungi una funzione) nel chip di variabile responseBody per selezionare e concatena la funzione GET_PROPERTY().
  - Per aggiungere il parametro di input per GET_PROPERTY(), fai clic su Variabile o valore e in Valore inserisci items.
    Questa funzione estrae una proprietà dal payload JSON. Passa la proprietà items come parametro per questa funzione. Verrà restituito un elenco di SOLO i nomi dei prodotti, senza altre informazioni. La funzione dovrebbe essere la seguente:
```
responseBody(Call REST Endpoint).TO_JSON().GET_PROPERTY(items)
```
  - Se devi rimuovere o eliminare una funzione, fai clic sul simbolo -.
3. Fai clic sul primo campo della colonna Output per creare una nuova variabile di output che contenga il valore dei dati trasformati. Completa i seguenti campi:
  - Nel campo Nome, inserisci JSONList.
  - Nell'elenco Tipo di variabile, seleziona Output dall'integrazione.
  - Nell'elenco Tipo di dati, seleziona JSON.
  - Per creare la variabile e chiudere il riquadro, fai clic su Crea. La nuova variabile JSONList verrà visualizzata nell'elenco Variabili sul lato sinistro dell'editor di mappatura dei dati.
4. Chiudi l'editor di mappatura dei dati al termine della mappatura. Eventuali modifiche verranno salvate automaticamente. Le seguenti immagini mostrano l'editor di mappatura dei dati con la mappatura creata in questa guida rapida:

Aggiungi e configura l'attività Invia email

Per configurare l'attività Invia email:

Seleziona Tasks nell'editor dell'integrazione per visualizzare l'elenco delle attività disponibili.
Fai clic e posiziona Invia email nell'editor di integrazione.
Aggiungi una connessione di bordo da Mappatura dati a Invia email passando il mouse sopra un punto di controllo su Mappatura dati, quindi fai clic e trascina una riga in un punto di controllo nell'attività Invia email. Il bordo indica il flusso di controllo dall'attività Mappatura dei dati all'attività Invia email.
Per configurare l'attività, fai clic su Invia email. Il riquadro di configurazione dell'attività. Nella sezione Input attività, imposta le seguenti proprietà:
- A destinatari: inserisci il tuo indirizzo email. Userai questo indirizzo email per confermare il corretto completamento dell'integrazione.
- Oggetto: inserisci Email from Application Integration.
- Testo normale del corpo: seleziona la variabile JSONList creata in precedenza nell'attività Mappatura dei dati.
- Le opzioni rimanenti possono essere lasciate nella configurazione predefinita.
Le modifiche alle proprietà vengono salvate automaticamente.

Verifica le connessioni ai bordi richieste

Verifica di aver aggiunto la connessione tra attività e trigger nell'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.

La connessione completata dovrebbe essere visualizzata come mostrato nella figura seguente:

immagine che mostra il flusso di avvio rapido

Testa l'integrazione

Per testare la nuova integrazione:

Fai clic su Test (Test) nella barra degli strumenti dell'editor delle integrazioni.
Viene visualizzato il riquadro Testa integrazione.
Fai clic su Testa integrazione.

Per ulteriori informazioni sui test, consulta Testare e pubblicare le integrazioni.

Al termine dell'operazione, l'integrazione invia un'email con i valori JSON all'indirizzo email specificato nell'attività Invia email. Conferma la ricezione dell'email nel tuo client di posta.

L'email inviata dall'integrazione deve contenere un corpo simile al seguente:

[{
   "project": "en.wikipedia",
   "article": "Tree",
   "granularity": "monthly",
   "timestamp": "2020100100",
   "access": "desktop",
   "agent": "user",
   "views": 33828.0
}]

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:

Fai clic su Log nella barra degli strumenti dell'editor di 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 dell'integrazione
- ID esecuzione
- Stato
- Inizio
- Durata
- Versione integrazione
- ID attivatore
- Cloud Logging
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.