Consulta i connettori supportati per Application Integration.

Richiama un'integrazione secondaria utilizzando un'attività Per ogni loop

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

Crea l'integrazione secondaria

1. Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Elenco delle integrazioni.
3. Fai clic su Create integration (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: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 API nell'integrazione secondaria

Gli attivatori 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 il trigger API, segui questi passaggi:

1. Nell'editor di integrazione, fai clic su Attivatori per visualizzare l'elenco degli attivatori disponibili.
2. Fai clic sull'elemento attivatore API e posizionalo nell'editor di integrazione.

Crea una variabile di input nell'integrazione secondaria

L'integrazione secondaria utilizza una variabile per archiviare i dettagli ricevuti in formato JSON dall'integrazione principale. Per creare una nuova variabile di input, segui questi passaggi:

1. Fai clic su (riquadro di attivazione/disattivazione) 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 Deduci 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 email che vuoi utilizzare per testare l'integrazione.

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

   f. Fai clic su Crea.

Aggiungi e configura un'attività di mappatura dei dati

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

Per aggiungere e configurare un'attività di mappatura dei dati, segui questi passaggi:

1. Nell'editor di integrazione, fai clic su Tasks per visualizzare l'elenco delle attività disponibili.
2. Fai clic sull'elemento Data Mapping e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento Mappatura dei dati nell'editor di integrazione per aprire il riquadro di configurazione delle attività.
4. Fai clic su Apri editor di mappatura dei dati.
5. Configura l'ingresso come segue:
   1. Nella sezione Input, fai clic su Variabile o valore.
   2. In Variabile, inserisci item e 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(Any) -> 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 le 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 PROPRIETÀ 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 creane uno nuovo.
   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 mappatura dati per tornare all'editor di integrazione.

Aggiungere e configurare un'attività di invio email

Per aggiungere e configurare l'attività Invia email in modo che invii un'email a ciascun destinatario, segui questi passaggi.

1. Nell'editor di integrazione, fai clic su Aggiungi un'attività/un attivatore.
2. Vai a Tasks, fai clic sull'elemento Send Email e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento attività Send Email (Invia email) nell'editor di integrazione per aprire il riquadro di configurazione delle attività.

4. Imposta i seguenti campi di immissione attività:

   1. Ai 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. Corpo 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 nell'integrazione secondaria

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

1. Aggiungi un bordo dall'elemento attivatore API all'elemento Data Mapping. Passa il mouse sopra un punto di controllo sull'elemento attivatore API, poi fai clic su una linea e trascinala in corrispondenza di un punto di controllo sull'elemento Data Mapping.
2. Allo stesso modo, aggiungi un bordo dall'elemento Data Mapping all'elemento Send Email.

Testa e pubblica l'integrazione secondaria

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

Crea l'integrazione principale

1. Nel menu di navigazione, fai clic su Integrations (Integrazioni) per tornare alla pagina Integrations (Integrazioni).
2. Fai clic su Create integration (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 di integrazione, fai clic su Attivatori per visualizzare l'elenco di attività e attivatori disponibili.
2. Fai clic sull'elemento attivatore API e posizionalo nell'editor di integrazione.

Crea una variabile di input nell'integrazione principale

Nell'integrazione principale, viene utilizzata una variabile di input per archiviare i dati trasmessi tramite il ciclo per ogni ciclo all'integrazione secondaria. Puoi creare questa variabile ora o nel passaggio successivo, quando aggiungi e configuri l'attività Per ogni loop. Per questa guida rapida, crea subito la variabile.

1. Fai clic su (riquadro di attivazione/disattivazione) 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 Deduci 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 email che vuoi utilizzare per testare l'integrazione.

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

   f. Fai clic su Crea.

Aggiungere e configurare un'attività For Every Loop

1. Nell'editor di integrazione, fai clic su Tasks.
2. Fai clic sull'elemento For ogni Loop e posizionalo nell'editor di integrazione.
3. Fai clic sull'elemento dell'attività For Every Loop (Per ogni loop) nell'editor di integrazione per aprire il riquadro di configurazione delle attività.
4. Nel riquadro di configurazione, segui questi passaggi:
   1. Elenco da ripetere: seleziona la variabile di input che hai creato, order_requests.
   2. ID trigger API: seleziona l'attivatore API nell'integrazione secondaria. Per questa guida rapida, seleziona api_trigger/ForEachSendEmailSubIntegration_API_1.
   3. Nome integrazione: seleziona il nome dell'integrazione secondaria che vuoi richiamare. Per questa guida rapida, seleziona ForEachSendEmailSubIntegration.
   4. Mappatura delle integrazioni secondarie degli elementi di iterazione: seleziona order_details.

Collega gli elementi nell'integrazione principale

1. Aggiungi un bordo dall'elemento Trigger API all'elemento For every Loop. Passa il mouse sopra un punto di controllo sull'elemento attivatore API, quindi fai clic su una linea e trascinala in corrispondenza di un punto di controllo sull'elemento For every Loop.

Testa e pubblica l'integrazione principale

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

1. Fai clic su Test nella barra degli strumenti dell'editor di integrazioni, quindi su Testa l'integrazione nella finestra di dialogo Testa l'integrazione. Al termine del test, dovresti visualizzare un messaggio che indica che l'operazione è riuscita.

2. Per pubblicare questa integrazione, fai clic su Pubblica nella barra degli strumenti dell'editor delle 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.