Questa pagina è stata tradotta dall'API Cloud Translation.

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à Per ogni 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

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 per l'integrazione.
Per questa guida rapida, inserisci il nome ForEachSendEmailSubIntegration e la descrizione Quickstart sub-integration.
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.

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:

Nell'editor dell'integrazione, fai clic su Trigger per visualizzare l'elenco degli attivatori disponibili.
Fai clic sull'elemento trigger API e posizionalo 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:

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

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 consente di eseguire assegnazioni di variabili nell'integrazione, ottenere e impostare 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 variabili dell'attività.

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

Nell'editor dell'integrazione, fai clic su Tasks per visualizzare l'elenco delle attività disponibili.
Fai clic e posiziona l'elemento Mappatura dei dati nell'editor di integrazione.
Fai clic sull'elemento Mappatura dei dati nell'editor dell'integrazione per aprire il riquadro di configurazione dell'attività.
Fai clic su Apri editor di mappatura dei dati.
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 PER CIASCUNO tra parentesi dopo l'elemento obj1 appena aggiunto. Nell'elenco delle funzioni, scorri verso il basso e seleziona OTTIENI PROPRIETÀ(Stringa) -> 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 OTTIENI PROPRIETÀ e seleziona TO_STRING() -> Stringa.
11. Fai clic su + Aggiungi una funzione nell'ultima riga e seleziona TO_STRING() -> Stringa.
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, conserva i valori predefiniti per tutti gli altri campi e fai clic su Crea.
Verifica che la configurazione della mappatura dei dati sia simile all'immagine seguente.
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.

Nell'editor dell'integrazione, fai clic su Aggiungi un'attività/un trigger.
Vai ad Tasks, fai clic sull'elemento Send Email (Invia email) e posizionalo nell'editor dell'integrazione.
Fai clic sull'elemento dell'attività Invia email nell'editor di integrazione per aprire il riquadro di configurazione dell'attività.
Imposta i seguenti campi di 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 nell'integrazione secondaria, aggiungi una connessione (fronte) tra gli elementi. Un bordo indica il flusso di controllo da un elemento all'altro.

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.
Allo stesso modo, aggiungi un bordo dall'elemento Data Mapping all'elemento Send Email.

Testa e pubblica la sottointegrazione

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 email specificato nell'attività Invia email. Al termine del test dovrebbe essere visualizzato un messaggio che indica che l'operazione è riuscita.
Per pubblicare questa sottointegrazione, fai clic su Pubblica nella barra degli strumenti dell'Editor integrazioni.

Crea l'integrazione principale

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

Aggiungi un trigger API nell'integrazione principale

Nell'editor dell'integrazione, fai clic su Attivatori per visualizzare l'elenco di attività e attivatori disponibili.
Fai clic sull'elemento trigger 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 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.

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

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 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

Nell'editor dell'integrazione, fai clic su Attività.
Fai clic sull'elemento For Every Loop e posizionalo nell'editor dell'integrazione.
Fai clic sull'elemento attività Per ogni ciclo nell'editor di integrazione per aprire il riquadro di configurazione dell'attività.
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. Integration name (Nome integrazione): seleziona il nome dell'integrazione secondaria 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

Aggiungi un bordo dall'elemento Trigger API all'elemento Per ogni ciclo. Passa il mouse sopra un punto di controllo dell'elemento Trigger API, quindi fai clic e trascina una linea fino a un punto di controllo dell'elemento Per ogni loop.

Testa e pubblica l'integrazione principale

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

Fai clic su Test (Test) nella barra degli strumenti dell'editor di integrazione, quindi fai clic su Test integration (Verifica integrazione) nella finestra di dialogo Test Integration (Testa integrazione). Al termine del test dovrebbe essere visualizzato un messaggio che indica che l'operazione è riuscita.
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.