Consulta i connettori supportati per Application Integration.

Richiamare una sottointegrazione utilizzando un'attività per ogni loop

Questa guida rapida mostra come creare un'integrazione che utilizza un'attività For Each Loop per richiamare una sottointegrazione. L'integrazione secondaria riceve l'input dall'integrazione principale e invia le email ai destinatari utilizzando l'attività Invia email.

Crea l'integrazione secondaria

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 per l'integrazione.

   Per questa guida rapida, inserisci il nome ForEachSendEmailSubIntegration e la descrizione Quickstart sub-integration.

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 API nella sottointegrazione

I trigger sono necessari per avviare la sequenza di attività che costituiscono un'integrazione. In questa guida rapida, utilizzerai un trigger API per avviare l'integrazione.

Per aggiungere e configurare l'attivatore API, segui questi passaggi:

1. Nell'editor dell'integrazione, fai clic su Trigger per visualizzare l'elenco degli attivatori disponibili.
2. Fai clic e posiziona l'elemento API trigger nell'editor di integrazione.

Crea una variabile di input nella sottointegrazione

La sottointegrazione utilizza una variabile per memorizzare i dettagli ricevuti in formato JSON dall'integrazione principale. Per creare una nuova variabile di input, svolgi i seguenti passaggi:

1. Fai clic su (Attiva/disattiva riquadro) nella barra di navigazione del designer per visualizzare il riquadro Variabili.
2. Fai clic su +Crea per creare una variabile.

3. Nel riquadro Crea variabile, segui questi passaggi:

   a. Nome: inserisci order_details.

   b. Tipo di dati: seleziona JSON.

   c. Fai clic su Deduce dal valore predefinito.

   d. In Valore predefinito, inserisci il seguente JSON.

     {
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
         },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
         }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
         }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
         },
       "expectedDelivery": "15 March 2023"
     }
   

   In questo oggetto JSON di esempio, sostituisci YOUR_EMAIL_ID con l'ID indirizzo email che vuoi utilizzare per testare l'integrazione.

   e. Fai clic su Utilizza come input per l'integrazione.

   f. Fai clic su Crea.

Aggiungere e configurare un'attività di mappatura dei dati

L'attività di mappatura dei dati ti consente di eseguire assegnazioni di variabili nell'integrazione, ottenere e impostare le proprietà degli oggetti JSON e applicare ai valori funzioni di trasformazione nidificate. Le variabili utilizzate dall'attività di mappatura dei dati possono essere variabili di integrazione o variabili di attività.

Per aggiungere e configurare un'attività di mappatura dei dati, svolgi i seguenti passaggi:

1. Nell'editor di integrazione, fai clic su Attività per visualizzare l'elenco delle attività disponibili.
2. Fai clic e posiziona l'elemento Mappatura dei dati nell'editor di integrazione.
3. Fai clic sull'elemento Mappatura dei dati nell'editor di integrazione per aprire il riquadro di configurazione dell'attività.
4. Fai clic su Apri editor di mappatura dei dati.
5. Configura l'input come segue:
   1. Nella sezione Input, fai clic su Variabile o valore.
   2. In Variabile, inserisci item e poi seleziona order_details.items.
   3. Fai clic su Salva.
   4. Aggiungi una funzione di mappatura a order_details.items. Fai clic sul simbolo + accanto a order_details.items. Nell'elenco delle funzioni, scorri verso il basso e seleziona FOR_EACH(Qualsiasi) -> JSON.
   5. Inserisci il parametro di input della funzione FOR_EACH. Fai clic su Variabile o valore e seleziona ~obj1.
   6. Fai clic su Salva.
   7. Aggiungi una funzione di mappatura a obj1. Fai clic su + nella riga FOR EACH tra parentesi dopo l'elemento obj1 che hai appena aggiunto. Nell'elenco delle funzioni, scorri verso il basso e seleziona GET PROPERTY(String) -> JSON.
   8. Fai clic su Variabile o valore e in Valore inserisci itemName.
   9. Fai clic su Salva.
   10. Fai clic su + Aggiungi una funzione nella riga dopo GET PROPERTY e seleziona TO_STRING() -> Stringa.
   11. Fai clic su + Aggiungi una funzione nell'ultima riga e seleziona TO_STRING() -> Stringa.
6. Configura l'output come segue:
   1. Crea una nuova variabile di output. Nella sezione Output, fai clic su Crea un nuovo output.
   2. Nel riquadro Crea variabile, inserisci il nome items, mantieni i valori predefiniti per tutti gli altri campi e fai clic su Crea.
7. Verifica che la configurazione della mappatura dei dati sia simile all'immagine seguente.

   

8. Chiudi l'editor di mappatura dei dati per tornare all'editor di integrazione.

Aggiungere e configurare un'attività Invia email

Per aggiungere e configurare l'attività Invia email in modo da inviare un'email a ciascuno dei destinatari, svolgi i seguenti passaggi.

1. Nell'editor dell'integrazione, fai clic su Aggiungi un'attività/trigger.
2. Vai a Attività e fai clic e posiziona l'elemento Invia email nell'editor di integrazione.
3. Fai clic sull'elemento dell'attività Invia email nell'editor di integrazione per aprire il riquadro di configurazione dell'attività.

4. Imposta i seguenti campi Input attività:

   1. A destinatari: fai clic su Variabile e seleziona order_details.emailId.
   2. Oggetto: inserisci l'oggetto dell'email. Per questa guida rapida, inserisci Order delivery notification.
   3. Testo in testo normale: inserisci il seguente testo:

   Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
   

Collega gli elementi nella sottointegrazione

Ora che hai aggiunto e configurato le attività e i trigger richiesti nella sottointegrazione, aggiungi una connessione (bordo) tra gli elementi. Un bordo indica il flusso di controllo da un elemento all'altro.

1. Aggiungi un bordo dall'elemento Trigger API all'elemento Mappatura dati. Passa il mouse sopra un punto di controllo nell'elemento Trigger API, quindi fai clic e trascina una riga in un punto di controllo nell'elemento Mappatura dei dati.
2. Analogamente, aggiungi un bordo dall'elemento Mappatura dei dati all'elemento Invia email.

Testa e pubblica la sottointegrazione

1. Per testare questa sottointegrazione, fai clic su Test nella barra degli strumenti dell'editor dell'integrazione e poi su Testa integrazione nella finestra di dialogo Testa integrazione. L'integrazione secondaria viene eseguita con il valore predefinito come input e invia un'email all'indirizzo specificato nell'attività Invia email. Al termine del test, dovresti visualizzare un messaggio di esito positivo.
2. Per pubblicare questa sottointegrazione, fai clic su Pubblica nella barra degli strumenti dell'Editor integrazioni.

Crea l'integrazione principale

1. Nel menu di navigazione, fai clic su Integrations (Integrazioni) per tornare alla pagina Integrations (Integrazioni).
2. Fai clic su Crea integrazione.
3. Inserisci un nome e, facoltativamente, una descrizione per l'integrazione. Per questa guida rapida, inserisci il nome ForEachSendEmail e la descrizione Quickstart main integration.
4. Seleziona una regione per l'integrazione dall'elenco delle regioni supportate. Assicurati di creare l'integrazione principale nella stessa regione dell'integrazione secondaria.
5. Fai clic su Crea.

Aggiungi un trigger API nell'integrazione principale

1. Nell'editor dell'integrazione, fai clic su Trigger per visualizzare l'elenco di attività e trigger disponibili.
2. Fai clic e posiziona l'elemento API trigger nell'editor di integrazione.

Crea una variabile di input nell'integrazione principale

Nell'integrazione principale, viene utilizzata una variabile di input per memorizzare i dati trasmessi tramite il ciclo For Each alla sottointegrazione. Puoi creare questa variabile ora o nel passaggio successivo quando aggiungi e configuri l'attività Ciclo For Each. Per questa guida rapida, crea subito la variabile.

1. Fai clic su (Attiva/disattiva riquadro) nella barra di navigazione del designer per visualizzare il riquadro Variabili.

2. Nel riquadro Crea variabile, segui questi passaggi:

   a. Nome: inserisci order_requests.

   b. Tipo di dati: seleziona JSON.

   c. Fai clic su Deduce dal valore predefinito.

   d. In Valore predefinito, inserisci il seguente JSON:

     [{
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
       },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
       }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
       }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
       },
      "expectedDelivery": "15 March 2023"
     }, {
       "orderId": "2",
       "customerName": "Tim Harvey",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "Los Angeles",
         "country": "USA",
         "zipcode": "210738"
       },
       "items": [{
         "itemid": "222-333-444",
         "itemName": "Laptop",
         "itemPrice": 5999.0,
         "quantity": 1.0
      }],
       "paymentDetails": {
         "mode": "Online Payment",
         "status": "Success"
       },
       "expectedDelivery": "21 Feb 2023"
     }]
   

   In questo oggetto JSON di esempio, sostituisci entrambe le occorrenze di YOUR_EMAIL_ID con l'ID indirizzo email che vuoi utilizzare per testare l'integrazione.

   e. Fai clic su Utilizza come input per l'integrazione.

   f. Fai clic su Crea.

Aggiungere e configurare un'attività per ogni loop

1. Nell'editor dell'integrazione, fai clic su Attività.
2. Fai clic e posiziona l'elemento Per ogni ciclo nell'editor di integrazione.
3. Fai clic sull'elemento attività Per ogni ciclo nell'editor di integrazione per aprire il riquadro di configurazione dell'attività.
4. Nel riquadro di configurazione:
   1. Elenco da iterare: seleziona la variabile di input che hai creato, order_requests.
   2. ID trigger API: seleziona l'attivatore API nella sottointegrazione. Per questa guida rapida, seleziona api_trigger/ForEachSendEmailSubIntegration_API_1.
   3. Nome integrazione: seleziona il nome della sottointegrazione che vuoi richiamare. Per questa guida rapida, seleziona ForEachSendEmailSubIntegration.
   4. Mappatura della sottointegrazione dell'elemento di iterazione: seleziona order_details.

Collega gli elementi nell'integrazione principale

1. Aggiungi un bordo dall'elemento Trigger API all'elemento Per ogni ciclo. Passa il mouse sopra un punto di controllo nell'elemento Trigger API, quindi fai clic e trascina una riga in un punto di controllo nell'elemento Per ogni ciclo.

Testa e pubblica l'integrazione principale

L'ultima attività consiste nel testare e pubblicare l'integrazione principale.

1. Fai clic su Test nella barra degli strumenti dell'Editor integrazioni e poi su Testa integrazione nella finestra di dialogo Testa integrazione. Al termine del test, dovresti visualizzare un messaggio di esito positivo.

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

   Al completamento dell'operazione, l'integrazione invia un'email all'indirizzo specificato nell'attività Invio email. Conferma la ricezione dell'email nel tuo client di posta.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.