Excel Online

Utilizza il connettore Excel Online per eseguire operazioni su Excel Online.

Prima di iniziare

Configura il tuo progetto Google Cloud, crea l'applicazione OAuth e concedi le autorizzazioni richieste.

Configurare il progetto Google Cloud

Prima di utilizzare il connettore Excel Online, svolgi le seguenti attività nel tuo progetto Google Cloud:

• Assicurati che la connettività di rete sia configurata. Per informazioni sui pattern di rete, consulta Connettività di rete.
• Attiva i seguenti servizi:
  • secretmanager.googleapis.com (API Secret Manager)
  • connectors.googleapis.com (API Connectors)

  Per informazioni su come attivare i servizi, consulta Abilitazione dei servizi.

Se questi servizi o autorizzazioni non sono stati attivati in precedenza per il tuo progetto, ti verrà chiesto di attivarli durante la configurazione del connettore.

Creare un'applicazione OAuth personalizzata - Azure AD

1. Accedi al portale di Azure.
2. Nel riquadro di navigazione a sinistra, seleziona Azure Active Directory, quindi applicationRegistrations.
3. Fai clic su Nuova registrazione.
4. Inserisci un nome per l'applicazione.
5. Seleziona la configurazione del tenant desiderata: singolo o multi-tenant e uso pubblico o privato.
• Se selezioni l'opzione predefinita "Solo account in questa directory dell'organizzazione", devi impostare la proprietà di connessione AzureTenant sull'ID del tenant Azure AD quando stabilisci una connessione con il driver JDBC CData per Microsoft Excel Online. In caso contrario, il tentativo di autenticazione non andrà a buon fine a causa di un errore.
• Se la tua applicazione è solo per uso privato, specifica Solo account in questa directory dell'organizzazione.
• Se vuoi distribuire la tua applicazione, scegli una delle opzioni multi-tenant.
6. Imposta l'URL di reindirizzamento su http://localhost:33333 (il valore predefinito del driver) OPPURE specifica una porta diversa e imposta CallbackURL sull'URL di risposta esatto che hai definito.
7. Fai clic su Registra per registrare la nuova applicazione. Viene visualizzata una schermata di gestione delle applicazioni. Prendi nota del valore in ID applicazione (client) come OAuthClientId e dell'ID directory (tenant) come AzureTenant.
8. Vai a Certificati e secret e definisci il tipo di autenticazione dell'applicazione. Sono disponibili due tipi di autenticazione: certificato (consigliato) o client secret.
• Per l'autenticazione del certificato: in Certificati e segreti, seleziona Carica certificato e carica il certificato dalla tua macchina locale.
• Per creare un nuovo client secret: in Certificati e secret, seleziona Nuovo client secret per l'applicazione e specifica la relativa durata. Dopo aver salvato il client secret, Microsoft Excel Online mostra il valore della chiave. Copia questo valore, poiché viene visualizzato una sola volta. Questo valore diventa OAuthClientSecret.
9. Seleziona Autorizzazioni API > Aggiungi > Autorizzazioni delegate.
10. Aggiungi le seguenti autorizzazioni di applicazione: Sites.Read.All, Files.Read, Files.Read.All, Files.Read.Selected, Files.ReadWrite, Files.ReadWrite.All, Files.ReadWrite.AppFolder, Files.ReadWrite.Selected e offline_access.
11. Salva le modifiche.
12. Se hai specificato l'utilizzo di autorizzazioni che richiedono il consenso dell'amministratore (ad esempio le autorizzazioni di applicazione), puoi concederle dall'utente corrente nella pagina Autorizzazioni API.

Creare un'applicazione OAuth personalizzata - entità servizio Azure

1. Utilizza la barra di ricerca per cercare il servizio Abbonamenti.
2. Apri la pagina Iscrizioni.
3. Seleziona l'abbonamento a cui assegnare l'applicazione.
4. Apri il controllo degli accessi (IAM).
5. Seleziona Aggiungi > Aggiungi assegnazione del ruolo. Microsoft Excel Online apre la pagina Aggiungi assegnazione del ruolo.
6. Assegna alla tua applicazione Azure AD personalizzata il ruolo di proprietario.

Assegna un ruolo all'applicazione

1. Per accedere alle risorse del tuo abbonamento, devi assegnare un ruolo all'applicazione.
2. Apri la pagina Abbonamenti cercando e selezionando il servizio Abbonamenti dalla barra di ricerca.
3. Seleziona l'abbonamento a cui assegnare l'applicazione.
4. Apri Controllo accesso (IAM) e seleziona Aggiungi > Aggiungi assegnazione del ruolo per aprire la pagina Aggiungi assegnazione del ruolo.
5. Seleziona Proprietario come ruolo da assegnare all'app Azure AD creata.

Concedi il consenso dell'amministratore

1. Accedi al portale di Azure.
2. Vai a Registrazioni app e trova l'applicazione OAuth personalizzata che hai creato.
3. In Autorizzazioni API, fai clic su Concedi consenso.

Concedi le autorizzazioni per le credenziali del client

1. Accedi al portale di Azure.
2. Vai a Registrazioni app.
3. Individua l'applicazione che hai appena creato e apri Autorizzazioni API.
4. Seleziona le autorizzazioni di Microsoft Graph. Esistono due insiemi distinti di autorizzazioni: delegate e applicazione.
5. In Autorizzazioni app, seleziona le autorizzazioni necessarie per l'integrazione.

Configura il connettore

Per configurare il connettore devi creare una connessione all'origine dati (sistema di backend). Una connessione è specifica per un'origine dati. Ciò significa che se hai molte origini dati, devi creare una connessione distinta per ciascuna. Per creare una connessione:

1. Nella console Cloud, vai alla pagina Connettori di integrazione > Connessioni, quindi seleziona o crea un progetto Google Cloud.

   Vai alla pagina Connessioni

2. Fai clic su + Crea nuovo per aprire la pagina Crea connessione.
3. Nella sezione Località, scegli la località della connessione.
   1. Regione: seleziona una località dall'elenco a discesa.

      Le regioni supportate per i connettori includono:

      Per l'elenco di tutte le regioni supportate, consulta Località.

   2. Fai clic su Avanti.
4. Nella sezione Dettagli connessione, completa quanto segue:
   1. Connettore: seleziona Excel Online dall'elenco a discesa dei connettori disponibili.
   2. Versione del connettore: seleziona la versione del connettore dall'elenco a discesa delle versioni disponibili.
   3. Nel campo Nome connessione, inserisci un nome per l'istanza di connessione.

      I nomi delle connessioni devono soddisfare i seguenti criteri:

      • I nomi delle connessioni possono contenere lettere, numeri o trattini.
      • Le lettere devono essere minuscole.
      • I nomi delle connessioni devono iniziare con una lettera e terminare con una lettera o un numero.
      • I nomi delle connessioni non possono contenere più di 49 caratteri.
   4. (Facoltativo) Inserisci una Descrizione per l'istanza di connessione.
   5. Se vuoi, attiva Cloud Logging e poi seleziona un livello di log. Per impostazione predefinita, il livello di log è impostato su Error.
   6. Account di servizio: seleziona un account di servizio con i ruoli richiesti.
   7. (Facoltativo) Configura le impostazioni del nodo di connessione:
      • Numero minimo di nodi: inserisci il numero minimo di nodi di connessione.
      • Numero massimo di nodi: inserisci il numero massimo di nodi di connessione.

      Un nodo è un'unità (o una replica) di una connessione che elabora le transazioni. Sono necessari più nodi per elaborare più transazioni per una connessione e, al contrario, sono necessari meno nodi per elaborare meno transazioni. Per capire in che modo i nodi influiscono sui prezzi dei connettori, consulta Prezzi per i nodi di connessione. Se non inserisci alcun valore, per impostazione predefinita il numero minimo di nodi è impostato su 2 (per una maggiore disponibilità) e il numero massimo di nodi è impostato su 50.

   Nota: puoi personalizzare i valori dei nodi di connessione solo se sei un cliente con pagamento a consumo.
   8. Tenant Azure: il tenant Microsoft Online utilizzato per accedere ai dati. Se non specificato, viene utilizzato il tenant predefinito.
   9. Unità: l'ID del viaggio. Puoi utilizzare le visualizzazioni Drive e SharePointSites per visualizzare tutti i siti e i drive a cui hai accesso.
   10. URL di Sharepoint: l'URL di base del server Sharepoint.
   11. Mostra documenti condivisi: indica se mostrare o meno i documenti condivisi.
   12. Workbook: il nome o l'ID del foglio di lavoro.
   13. Intestazione: indica se i nomi delle colonne devono essere rilevati o meno dalla prima riga.
   14. Tabella: limita la connessione a una tabella contenente un intervallo di celle di un foglio di lavoro. Formato: [{Nome del foglio di lavoro}_{Nome della cartella di lavoro}!{Intervallo}]
   15. Se vuoi, fai clic su + Aggiungi etichetta per aggiungere un'etichetta alla connessione sotto forma di coppia chiave/valore.
   16. Fai clic su Avanti.
5. 1. Nella sezione Autenticazione, inserisci i dettagli di autenticazione. Per capire come configurare questi dettagli di autenticazione, consulta Configurare l'autenticazione.
   2. Fai clic su Avanti.
6. Rivedi: controlla i dettagli di connessione e autenticazione.
7. Fai clic su Crea.

Configura autenticazione

Inserisci i dettagli in base all'autenticazione che vuoi utilizzare.

• ID client: l'ID client utilizzato per richiedere i token di accesso.
• Ambito: un elenco separato da virgole degli ambiti desiderati.
• Client secret: il client secret utilizzato per richiedere i token di accesso.
• URL di autorizzazione: l'URL di autorizzazione generato durante la creazione del client.

Excel Online - Tipo di connessione web

Questa sezione elenca i valori di esempio per i vari campi che configuri quando crei la connessione a Excel Online.

Nome campo	Dettagli
Località	us-central1
Connettore	Excelonline
Versione del connettore	1
Nome collegamento	excelonline-gcp
Account di servizio	SERVICE_ACCOUNT_NAME@serviceaccount
Tenant Azure	9b******-****-****-****-*********12
Drive	b!p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0
URL di SharePoint	https://*****.sharepoint.com/
Mostra documenti condivisi	Vero
Numero minimo di nodi	2
Numero massimo di nodi	50
ID client	e89*****-****-****-****-*********b6
Ambiti	https://graph.microsoft.com/.default
Client secret	CLIENT_SECRET
Versione secret	1
URL di autorizzazione	https://login.microsoftonline.com/{Azure-Tenant}/oauth2/v2.0/authorize

Passaggi aggiuntivi dopo la creazione della connessione

Se hai selezionato OAuth 2.0 - Authorization code per l'autenticazione, devi eseguire i seguenti passaggi aggiuntivi dopo aver creato la connessione:

1. Nella pagina Connessioni, individua la connessione appena creata.

   Tieni presente che lo stato del nuovo connettore sarà Autorizzazione richiesta.

2. Fai clic su Autorizzazione obbligatoria.

   Viene visualizzato il riquadro Modifica autorizzazione.

3. Copia il valore URI di reindirizzamento nell'applicazione esterna.
4. Verifica i dettagli dell'autorizzazione.
5. Fai clic su Autorizza.

   Se l'autorizzazione va a buon fine, lo stato della connessione verrà impostato su Attivo nella pagina Connessioni.

Nuova autorizzazione per il codice di autorizzazione

Se utilizzi il tipo di autenticazione Authorization code e hai apportato modifiche alla configurazione dell'applicazione Azure Synapse, devi autorizzare nuovamente la connessione ad Azure Synapse. Per autorizzare di nuovo una connessione, segui questi passaggi:

1. Fai clic sulla connessione richiesta nella pagina Connessioni.

   Viene visualizzata la pagina dei dettagli della connessione.

2. Fai clic su Modifica per modificare i dettagli della connessione.
3. Verifica i dettagli di OAuth 2.0 - Codice di autorizzazione nella sezione Autenticazione.

   Se necessario, apporta le modifiche necessarie.

4. Fai clic su Salva. Viene visualizzata la pagina dei dettagli della connessione.
5. Fai clic su Modifica autorizzazione nella sezione Autenticazione. Viene visualizzato il riquadro Autorizza.
6. Fai clic su Autorizza.

   Se l'autorizzazione va a buon fine, lo stato della connessione verrà impostato su Attivo nella pagina Connessioni.

Limitazioni del sistema

La dimensione massima del file Excel che il connettore Excel Online può elaborare è 25 MB.

Il connettore Excel Online può elaborare 3 transazioni al secondo per nodo e limita le transazioni oltre questo limite. Per impostazione predefinita, Integration Connectors alloca 2 nodi (per una maggiore disponibilità) per una connessione.

Per informazioni sui limiti applicabili a Integration Connectors, vedi Limiti.

Nota: il numero di nodi Integration Connectors verrà scalato automaticamente in base al tuo utilizzo. Tuttavia, se vuoi prenotare la capacità per volumi elevati senza dover attendere la scalabilità automatica, puoi modificare il valore del nodo minimo per una connessione. Per elaborare più transazioni per una connessione, sono necessari più nodi. Al contrario, sono necessari meno nodi se una connessione elabora meno transazioni. Per configurare i valori del nodo:

• Se sei un cliente con pagamento a consumo, configura il valore minimo e massimo del nodo nella pagina di modifica della connessione.
• Se sei un cliente con abbonamento, contatta l'assistenza.

Il numero massimo di transazioni che un nodo può gestire dipende da vari fattori. Pertanto, prima di modificare il numero minimo di nodi per migliorare il throughput, ti consigliamo di verificare se i sistemi di backend sono configurati in modo ottimale per gestire il traffico richiesto.

Utilizzare la connessione a Excel Online in un'integrazione

Una volta creata, la connessione diventa disponibile sia nell'Apigee Integration sia nell'Application Integration. Puoi utilizzare la connessione in un'integrazione tramite l'attività Connettori.

• Per informazioni su come creare e utilizzare l'attività Connectors in Apigee Integration, consulta Attività Connectors.
• Per informazioni su come creare e utilizzare l'attività Connettori in Application Integration, consulta Attività Connettori.

Entità, operazioni e azioni

Tutti gli Integration Connectors forniscono un livello di astrazione per gli oggetti dell'applicazione collegata. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione viene mostrata come entità, operazioni e azioni.

Nota: puoi visualizzare le entità, le operazioni e le azioni di un connettore nell'attività Connettori.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio collegato. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database le tabelle sono le entità, in un connettore di file server le cartelle sono le entità e in un connettore di sistema di messaggistica le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione: un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire su un'entità una delle seguenti operazioni:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  La selezione di un'entità dall'elenco disponibile genera un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta nessuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione : un'azione è una funzione di prima classe resa disponibile all'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da un connettore all'altro. In genere, un'azione avrà alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Nota: a tutte le entità e le azioni è associato uno schema. Ad esempio, uno schema di azioni avrà i dettagli dei parametri, ad esempio i nomi dei parametri e il relativo tipo di dati. Lo schema (metadati) per le entità e le azioni viene recuperato dalla connessione al runtime dal tuo backend. Se sono presenti aggiornamenti allo schema, questi non verranno applicati automaticamente alle connessioni esistenti. Dovrai aggiornare manualmente lo schema. Per aggiornare lo schema di una connessione, apri la pagina Dettagli connessione della connessione e poi fai clic su Aggiorna schema connessione.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Nota: i risultati di tutte le azioni saranno disponibili come risposta JSON nel parametro di risposta connectorOutputPayload della task Connectors dopo l'esecuzione dell'integrazione.

Aggiungi azione del foglio di lavoro

Aggiunge un foglio di lavoro a una cartella di lavoro Excel Online esistente.

Parametri di input dell'azione AddWorksheet

Nome parametro	Tipo di dati	Obbligatorio	Descrizione
Titolo	Stringa	Vero	Nome del foglio di lavoro.
WorkbookId	Stringa	Vero	L'ID del foglio di lavoro. Questo ID deve appartenere al drive accessibile con le proprietà di connessione correnti.

Parametri di output dell'azione AggiungiFoglio

Per esempio, su come configurare l'azione AddWorksheet, consulta Esempi.

Esempi

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: esegui l'azione AggiungiWorksheet

Questo esempio aggiunge un foglio di lavoro a una cartella di lavoro Excel Online esistente.

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione AddWorksheet e poi fai clic su Fine.
3. Nella sezione Mappatura dei dati, Open Data Mapping Editor e poi inserisci un valore simile al seguente nel Input campo:

   {   
   "WorkbookId": "01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL",
   "Title": "Worksheet_SP1"
   }

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload della task AddWorksheet avrà un valore simile al seguente:

[{
  "Success": "true",
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#workbookWorksheet",
  "@odata.type": "#microsoft.graph.workbookWorksheet",
  "@odata.id": "/drives('b%21p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0')/items('01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL')/workbook/worksheets(%27%7BD9372F53-CB1B-4082-9E13-02E65C2FC233%7D%27)",
  "id": "{D9372F53-CB1B-4082-9E13-02E65C2FC233}",
  "name": "Worksheet_SP1",
  "position": "1",
  "visibility": "Visible"
}]

Esempi di operazioni sulle entità

Questa sezione mostra come eseguire alcune delle operazioni sulle entità in questo connettore.

Esempio: elencare tutti i viaggi

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Dischi dall'elenco Entity.
3. Seleziona l'operazione List e poi fai clic su Fine.

Esempio: elenca tutti i documenti condivisi

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DocumentiCondivisi dall'elenco Entity.
3. Seleziona l'operazione List e poi fai clic su Fine.

Esempio: elenca tutti i fogli di lavoro

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Fogli di lavoro dall'elenco Entity.
3. Seleziona l'operazione List e poi fai clic su Fine.

Esempio: ricevi i viaggi

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
unità dall'elenco Entity.
2. Seleziona l'operazione Get e poi fai clic su Fine.
3. Imposta l'ID entità su Recupera singoli Drive. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci b!ZETdEU1T_UOBEzbgDmsvcubxvUaXbcJNrrNPM4LqokkwLC3zCRPiQLi2PBfCs9-v nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: recupera SharedDocument

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona DocumentiCondivisi dall'elenco Entity.
3. Seleziona l'operazione Get e poi fai clic su Fine.
4. Imposta l'ID entità su Get single SharedDocument. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 01BDTL6TS3OQ3HDXCKGREILDYKY47S7LEI nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: ottieni i fogli di lavoro

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Fogli di lavoro dall'elenco Entity.
3. Seleziona l'operazione Get e poi fai clic su Fine.
4. Imposta l'ID entità su Recupera singoli workbook. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: eliminare i dati da un libro

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Libro 4567_Foglio1 dall'elenco Entity.
3. Seleziona l'operazione Delete e poi fai clic su Fine.
4. Imposta l'ID entità su Elimina libro 4567_Sheet1. Per impostare l'ID entità, nella sezione Data Mapper di Mappatura dei dati, fai clic su Apri editor di mappatura dei dati, quindi inserisci 5.0 nel campo Valore di input e scegli EntityId come variabile locale.

Esempio: crea una formula per Formulae_Sheet_List

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Formulae_Sheet_List dall'elenco Entity.
3. Seleziona l'operazione Create e fai clic su Fine.
4. Nella sezione Data mapper dell'Attività, fai clic sull'editor OpenDataMapping e poi inserisci un valore simile al seguente in field:

    {
     "Excel_Sheet": "Old_Excel",
     "B": "=SUM(C8:D8)",
     "C": "6",
     "D": "6"
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 8.0
     } 
     

Example - Create With_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    {
       "Name": "workbooknew",
       "Type": "newly created",
       "Sl no": 5.0
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 6.0
     }
     

Example - Create Without_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

     {
       "A": "6",
       "B": "Halo",
       "C": "Stardust"
     } 
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 7.0
     } 
     

Example - Update an Formula for Formulae_Sheet_List

1. In the Configure connector task dialog, click Entities.
2. Select Formulae_Sheet_List from the Entity list.
3. Select the Update operation, and then click Done.
4. Set the entity ID to Update a Formulae_Sheet_List. To set the entity ID, in the Data mapper section of the Tasks, click entityId and then enter 8.0 in the given field.
5. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    
     {
     "B": "=MAX(C8:D8)",
     "C": "7",
     "D": "10"
     } 
     

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connector:

 
  {   
  "Id": 8.0
  }
  

Esempio: aggiorna Without_Header

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
2. Seleziona Libro 4567_Book4567_Sheet1 dall'elenco Entity.
3. Seleziona l'operazione Update e fai clic su Fine.
4. Imposta l'ID entità su Aggiorna un libro 4567_Book4567_Sheet1. Per impostare l'ID entità, nella sezione Data mapper di Attività, fai clic su entityId e poi inserisci 7.0 nel campo apposito.
5. Nella sezione Data mapper dell'Attività, fai clic sull'editor OpenDataMapping e inserisci un valore simile al seguente in field:

    
      {
       "B": "cosmically",
       "C": "interlinked"
     }  
     

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connector:

 
  {   
  "Id": 7.0
  }
  

Esempio: Aggiornamento_con_intestazione

1. Nella finestra di dialogo Configure connector task, fai clic su Entities.
li>Seleziona Libro 4567_Libro4567_Foglio1 dall'elenco Entity.
2. Seleziona l'operazione Update e fai clic su Fine.
3. Imposta l'ID entità su Aggiorna un libro 4567_Book4567_Sheet1 Per impostare l'ID entità, nella sezione Data mapper di Attività, fai clic su entityId e poi inserisci 6.0 nel campo apposito.
4. Nella sezione Data mapper dell'Attività, fai clic sull'editor OpenDataMapping e inserisci un valore simile al seguente in field:

    
      {
       "Name": "updated",
       "Type": "newupdate"
     }
     

L'esecuzione di questo esempio restituisce una risposta simile alla seguente nella variabile di output connectorOutputPayload dell'attività Connector:

 
  {   
  "Id": 6.0
  }
  

Ricevere assistenza dalla community Google Cloud

Puoi pubblicare le tue domande e discutere di questo connettore nella community Google Cloud ai forum di Cloud.

Passaggi successivi

• Scopri come sospendere e riprendere una connessione.
• Scopri come monitorare l'utilizzo dei connettori.
• Scopri come visualizzare i log del connettore.