Apigee Integration con un trigger API

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ù

Questa guida rapida mostra come creare un'integrazione di esempio in Apigee Integration. I passaggi seguenti spiegano come per configurare l'attivatore, le attività, gli spigoli, le variabili e le mappature dei dati necessari per eseguire un'integrazione completa.

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'interno del designer dell'integrazione.

Creazione di una nuova integrazione

Per creare una nuova integrazione:

1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
2. Fai clic su Sviluppo > Integrazioni.
3. Fai clic su Create Integration (Crea integrazione).
4. 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.

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 saperne di più, consulta Attivare una nuova regione.
6. Fai clic su Crea per aprire l'editor delle integrazioni.

Aggiungi e configura 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 il trigger API.

Per configurare il trigger API:

1. Nell'editor dell'integrazione, fai clic su Trigger per visualizzare un elenco di trigger disponibili.
2. Fai clic sull'elemento trigger API e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento Trigger API nel designer per aprire il trigger di configurazione del deployment.
4. Apigee Integration compila automaticamente il trigger Label, Nome trigger e ID trigger. L'ID trigger è generato automaticamente e non puoi modificarlo. Tuttavia, puoi modificare il valore le proprietà Etichetta e Nome trigger.

   Le modifiche alle proprietà vengono salvate automaticamente.

Aggiungi e configura attività

Un'attività è un insieme eseguibile di passaggi che possono prendere le variabili come input e generare variabili come output. Come per i trigger, qualsiasi attività disponibile può essere utilizzata in un'integrazione. Questa guida rapida utilizza Chiama endpoint REST, Mappatura dei dati e Invia email. Configurazione per ogni attività sono descritti nei passaggi riportati di seguito.

Configura l'attività Chiama endpoint REST

Per configurare l'attività Chiama endpoint REST, segui questi passaggi:

1. Seleziona Attività per visualizzare un elenco delle attività disponibili.
2. Fai clic e posiziona l'elemento Chiama endpoint REST nell'editor di integrazione.
3. Aggiungi una connessione perimetrale dall'elemento trigger API all'elemento Richiama l'endpoint REST passando il mouse sopra un punto di controllo sull'elemento trigger API facendo clic e trascinando una linea fino a un punto di controllo sull'elemento dell'attività Chiama endpoint REST. Il perimetro indica il flusso di controllo dal trigger API all'attività Chiama endpoint REST.

   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.

4. Fai clic sull'elemento Chiama endpoint REST nel designer per aprire l'attività di configurazione del deployment. 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 Creare profili di autenticazione nell'integrazione Apigee.
   • Input attività: inserisci i dettagli per chiamare l'endpoint REST. Le informazioni inserito qui viene utilizzato come input 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 di un determinato mese chiamato Albero.
     • Metodo HTTP: seleziona GET dall'elenco a discesa.
   • Task Output: qui l'integrazione Apigee compila variabili per contenere l'output dei dati di risposta della chiamata all'endpoint REST:
     .
     • responseHeader(Call REST Endpoint): questa variabile contiene l'intestazione della risposta I dati associati all'attività Chiama endpoint REST. I dati variabili è 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) (Endpoint REST di chiamata):questa variabile contiene lo stato della risposta I dati associati all'attività Chiama endpoint REST. I dati variabili è di tipo String (STR).
   • Visualizza i dettagli di ogni variabile facendo clic sul nome della variabile nel riquadro di configurazione dell'attività. Per questa guida rapida, lascia i valori predefiniti per ciascuna di queste variabili.
   • I restanti campi devono contenere i seguenti valori predefiniti:
     • Segui i reindirizzamenti: True
     • L'attività non dovrebbe riuscire in caso di errore HTTP: False
     • Strategia di gestione degli errori
       .
       • Strategia per le esecuzioni sincrone: None
       • Strategia per le esecuzioni asincrone: None

   Le modifiche alle proprietà vengono salvate automaticamente.

Aggiungere e configurare l'attività 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 Mappatura dei dati e posizionalo nell'editor dell'integrazione.
3. Aggiungi una connessione perimetrale dall'elemento Call REST Endpoint (Endpoint REST di chiamata) all'elemento L'elemento Mappatura dei dati passa il mouse sopra un punto di controllo sull'elemento Call REST Endpoint, quindi facendo clic su una linea e trascinandola fino a un punto di controllo sull'elemento dell'attività Mappatura dei dati. Il bordo indica il flusso di controllo dall'attività Chiama endpoint REST all'attività Mappatura dei dati.
4. Fai clic sull'attività Mappatura dei dati nel designer per aprire il riquadro di configurazione l'attività.
5. 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 nell'integrazione di Apigee.

   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 a discesa delle variabili funzioni.
   3. 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.

      • 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 estrarrà una proprietà dal payload JSON. Passa nella proprietà items come parametro per questa funzione. Verrà restituito un elenco SOLO i nomi dei prodotti, senza altre informazioni sul prodotto. La funzione dovrebbe essere come segue:

        responseBody(Call REST Endpoint).TO_JSON().GET_PROPERTY(items)

      • Per rimuovere o eliminare una funzione, fai clic sul simbolo -.
   4. Fai clic sul primo campo della colonna Output per creare una nuova variabile di output che contenga il valore dell'oggetto trasformato e i dati di Google Cloud. Completa i seguenti campi:
      • Nome: inserisci JSONList.
      • Tipo di dati: JSON
      • 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 JSONList verrà visualizzata nel Elenco Variabili sul lato sinistro dell'editor di mappatura dei dati.
   5. 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 Tasks nell'editor dell'integrazione per visualizzare l'elenco delle attività disponibili.
2. Fai clic sull'elemento Invia email e posizionalo nell'editor dell'integrazione.
3. 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. Il bordo indica il flusso di controllo dalla mappatura dei dati all'attività Invia email.
4. Fai clic sull'elemento Send Email (Invia email) del designer per aprire il riquadro di configurazione dell'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 Apigee Integration.
   • Corpo in testo normale: seleziona la variabile JSONList creata in precedenza nell'attività Mappatura dei dati.
   • Le altre opzioni possono essere lasciate nella configurazione predefinita.

   Le modifiche alle proprietà vengono salvate automaticamente.

Verifica le connessioni perimetrali richieste

Verifica di aver aggiunto una connessione perimetrale tra gli elementi 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:

Testare l'integrazione

Per testare la nuova integrazione:

1. Fai clic su Test (Test) nella barra degli strumenti dell'editor delle integrazioni.

   Viene visualizzato il riquadro Testa integrazione.

2. Fai clic su Testa integrazione.

Per saperne di più 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:

1. Fai clic su Log nella barra degli strumenti dell'editor integrazioni.
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
   • Data/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, oltre allo stato delle attività e ai payload variabili.