--- title: "Connettore per Microsoft Excel" slug: "microsoft-365-excel-connector" updated: 2026-10-22T18:10:16Z published: 2026-10-22T18:10:16Z canonical: "support.tulip.co/microsoft-365-excel-connector" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # Connettore per Microsoft Excel To download the app, visit: [connectors](https://tulip.co/library/Library ## Connettore Microsoft Excel *Integrazione con l’API Microsoft O365 Worksheet V1.0* ## Introduzione L’API Microsoft Excel Worksheets consente agli utenti di creare, leggere e modificare fogli di lavoro Microsoft Excel con le giuste autorizzazioni impostate sui propri account Office 365. L’obiettivo di questo connettore è integrare Tulip con Microsoft utilizzando l’API Graph di Microsoft (v1.0) tramite connettori HTTP e fornire ai nostri clienti un connettore pronto all’uso che possa essere importato nella loro istanza. #### Scopo Questo documento illustrerà le diverse funzionalità del connettore che possono essere realizzate effettuando chiamate HTTP all’API Graph di Microsoft (v1.0) per interagire con i fogli di lavoro Excel di M365, al fine di mostrare varie operazioni di lettura e scrittura sui fogli di lavoro che potrebbero essere sfruttate per diversi casi d’uso. #### Documentazione API [Documentazione dell’API Graph di Microsoft](https://docs.microsoft.com/en-us/graph/api/resources/excel?view=graph-rest-1.0) #### Prerequisiti 1. Creare un account su Microsoft O365 e configurare le credenziali OAuth 2.0 in Microsoft Entra ID. 2. Registrare l’API con gli ambiti richiesti nel portale Microsoft. [Azure - Entra ID](https://portal.azure.com/#home) Video sulla configurazione del connettore: [Embedded content](https://www.youtube.com/embed/jH2YIfCw4Ss) #### Dettagli di connessione a Tulip Le seguenti informazioni devono essere configurate nella sezione connettori di Tulip. 1. In esecuzione su: Host del connettore cloud 2. Host: graph.microsoft.com 3. Porta: 443 4. TLS: Sì OAuth 2: per ottenere il token di accesso necessario per comunicare con l'API Graph di Microsoft ## Funzioni del connettore #### 1) Ottenere i dettagli di un'unità **Scopo** Questo connettore recupererà tutti gli elementi da un'unità. **Endpoint** Chiamata HTTP GET all'endpoint:`https://graph.micrsoft.com:443/v1.0/me/drive/root/children` **Dati richiesti** Nessun dato richiesto **Estrattore di output richiesto** 1. SheetID: identificatore univoco della cartella di lavoro che verrà utilizzato per eseguire le altre attività. 2. CreatedAt: data e ora di creazione della cartella di lavoro. 3. UltimaModifica: data e ora dell'ultima modifica della cartella di lavoro. 4. SheetName: il nome della cartella di lavoro. 5. URL del foglio di calcolo: l'URL della cartella di lavoro. #### 2) Recuperare tutti i fogli di lavoro in una cartella di lavoro **Scopo** Questo connettore recupererà tutti i fogli di lavoro di una cartella di lavoro passando l’ID della cartella di lavoro. **Endpoint** Richiesta HTTP GET all'endpoint:`https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets` **Dati di input richiesti** Di seguito sono riportati i parametri URL da passare 1. ID della cartella di lavoro **Estrattore di output richiesto** 1. sheetId: identificatore univoco del foglio di calcolo che verrà utilizzato per eseguire le altre operazioni. 2. sheetName: il nome visualizzato del foglio di lavoro. 3. sheetPosition: la posizione del foglio di lavoro all'interno della cartella di lavoro, con riferimento a zero. 4. sheetVisibility: la visibilità del foglio di lavoro. I valori possibili sono Visible, Hidden, VeryHidden. #### 3) Recupera i metadati del foglio di lavoro **Scopo** Questo connettore recupererà i dati in base all’ID della cartella di lavoro e al nome del foglio di lavoro. **Endpoint** Chiamata HTTP GET all'endpoint `https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/` **Dati di input richiesti** Di seguito sono riportati i parametri URL da trasmettere 1. ID della cartella di lavoro 2. Nome del foglio di lavoro **Estrattore di output richiesto** 1. sheetId: identificatore univoco del foglio di calcolo che verrà utilizzato per eseguire le altre operazioni. 2. sheetName: il nome visualizzato del foglio di lavoro. 3. sheetPosition: la posizione del foglio di lavoro all'interno della cartella di lavoro, con riferimento a zero. 4. sheetVisibility: la visibilità del foglio di lavoro. I valori possibili sono: Visible, Hidden, VeryHidden. #### 4) Creazione di un nuovo foglio di lavoro **Scopo** 1. Gli utenti possono fornire come input un ID della cartella di lavoro e il nome del foglio di lavoro; Tulip creerà un nuovo foglio di lavoro con il nome specificato. La risposta dell’API conterrà i metadati e le varie proprietà del foglio di lavoro. Queste informazioni possono essere ulteriormente utilizzate per recuperare e aggiornare i dati dai fogli di lavoro. 2. Le informazioni, estratte dall’API Microsoft Graph V1.0, possono poi essere utilizzate all’interno delle app Tulip, delle tabelle Tulip o delle variabili Tulip, che verranno convogliate in altre funzioni del connettore. **Endpoint** Chiamata HTTP POST all’endpoint `https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/add` **Dati di input obbligatori** Di seguito sono riportati i parametri inviati come corpo della richiesta 1. ID della cartella di lavoro - L’ID della cartella di lavoro 2. Nome del foglio di lavoro - Titolo del foglio di lavoro **Estrattore di output richiesto** 1. WorksheetId: identificatore univoco del foglio di calcolo che verrà utilizzato per eseguire le altre operazioni. 2. spreadsheetURL: l'URL del foglio di calcolo appena creato. 3. I parametri aggiuntivi restituiti con la risposta possono essere inclusi come parte dei parametri di output. #### 5) Aggiornamento delle proprietà del foglio di lavoro **Scopo** Gli utenti possono fornire come input un ID della cartella di lavoro, il nome del foglio di lavoro precedente, la posizione del foglio di lavoro e il nome del nuovo foglio di lavoro; Tulip aggiornerà il foglio di lavoro con il nome specificato. La risposta dell’API conterrà i metadati e le varie proprietà del foglio di lavoro. Questi dati possono essere ulteriormente utilizzati per recuperare e aggiornare i dati dai fogli di calcolo. **Endpoint** Chiamata HTTP PATCH all'endpoint:`https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}` **Dati di input richiesti** Di seguito sono riportati i parametri inviati come corpo della richiesta 1. ID della cartella di lavoro - L’ID della cartella di lavoro 2. Nome del foglio di lavoro - Titolo del foglio di lavoro 3. Posizione del foglio di lavoro: la posizione del foglio di lavoro all'interno della cartella di lavoro, con riferimento a zero 4. Nome del nuovo foglio di lavoro: titolo del nuovo foglio di lavoro **Estrattore di output richiesto** 1. sheetID: identificatore univoco della cartella di lavoro che verrà utilizzato per eseguire le altre attività 2. sheetName: il nome visualizzato del foglio di lavoro. 3. sheetPosition: la posizione (a partire da zero) del foglio di lavoro all’interno della cartella di lavoro. #### 6) Recuperare i dati di una cella specifica **Scopo** Questo connettore recupererà i dati dai fogli di lavoro di una cartella di lavoro in base all’ID della cartella di lavoro, al nome del foglio di lavoro, all’indice della riga e all’indice della colonna forniti come input. La risposta dell’API sarà il valore della cella specificata. **Endpoint** Chiamata HTTP GET all’endpoint:[`https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}`](https://graph.microsoft.com:443/v1.0/me/drive/items/%7BworkbookID%7D/workbook/worksheets/%7BworksheetName%7D/range)`/cell(row={indice riga},column={indice colonna})` **Dati di input richiesti** Di seguito sono riportati i parametri URL da passare 1. ID della cartella di lavoro: ID della cartella di lavoro 2. Nome del foglio di lavoro - Titolo del foglio di lavoro 3. Indice della riga: numero di riga della cella da recuperare 4. Indice colonna: numero di colonna della cella da recuperare **Estrattore di output richiesto** Questo connettore restituisce il valore della cella corrispondente agli indici di riga e colonna forniti. #### 7) Recupera i dati dell'intervallo del foglio di lavoro **Scopo** Questo connettore recupererà i dati dai fogli di lavoro di una cartella di lavoro in base all’ID della cartella di lavoro, al nome del foglio di lavoro, all’intervallo iniziale e all’intervallo finale forniti come input. La risposta dell’API sarà costituita dai dati dell’intervallo specificato. **Endpoint** Chiamata HTTP GET all’endpoint:[`https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range`](https://graph.microsoft.com:443/v1.0/me/drive/items/%7BworkbookID%7D/workbook/worksheets/%7BworksheetName%7D/range)`(address=’{start range}:{end range}’)` **Dati di input richiesti** Di seguito sono riportati i parametri URL da passare 1. ID della cartella di lavoro: ID della cartella di lavoro 2. Nome del foglio di lavoro: titolo del foglio di lavoro 3. Intervallo iniziale - Intervallo iniziale 4. Intervallo di fine: intervallo di fine **Estrattore di output richiesto** Questo connettore restituisce tutti i valori delle celle all'interno dell'intervallo specificato. #### 8) Aggiorna valori per intervallo **Scopo** Gli utenti possono passare come input un ID della cartella di lavoro, il nome del foglio di lavoro, l'intervallo iniziale, l'intervallo finale e i valori da aggiornare; Tulip aggiornerà i valori dell'intervallo in base all'intervallo specificato. La risposta dell'API sarà costituita dai valori aggiornati dell'intervallo. **Endpoint** Chiamata HTTP PATCH all’endpoint:[`https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheets/{worksheetName}/range`](https://graph.microsoft.com:443/v1.0/me/drive/items/%7BworkbookID%7D/workbook/worksheets/%7BworksheetName%7D/range)`(address=’{start range}:{end range}’)` **Dati di input richiesti** Di seguito sono riportati i parametri URL da passare 1. ID della cartella di lavoro: ID della cartella di lavoro 2. Nome del foglio di lavoro - Titolo del foglio di lavoro 3. Intervallo iniziale - Intervallo iniziale 4. Intervallo di fine: intervallo di fine 5. Valori di ciascuna cella all'interno dell'intervallo specificato **Estrattore di output richiesto** Non è richiesto alcun estrattore di output. #### 9) Creare una tabella nel foglio di lavoro **Scopo** 1. Gli utenti possono fornire come input un ID della cartella di lavoro, il nome del foglio di lavoro, l'indirizzo del foglio di lavoro e l'indicazione "Presenza di intestazioni"; Tulip creerà una nuova tabella con il nome specificato. La risposta dell'API conterrà i metadati e le varie proprietà della tabella. 2. Ciò può essere ulteriormente utilizzato per recuperare e aggiornare i dati dai fogli di calcolo. 3. Le informazioni, estratte dall’API Microsoft Graph V1.0, possono poi essere utilizzate all’interno delle app Tulip, delle tabelle Tulip o delle variabili Tulip, che verrebbero convogliate in altre funzioni del connettore. **Endpoint** Chiamata HTTP POST all’endpoint `https://graph.microsoft.com:443/v1.0/me/drive/items/{itemID}/workbook/worksheets/add` **Dati di input obbligatori** Di seguito sono riportati i parametri inviati come corpo della richiesta 1. ID della cartella di lavoro - L’ID della cartella di lavoro 2. Nome del foglio di lavoro - Titolo del foglio di lavoro 3. Indirizzo: indirizzo o nome dell’oggetto intervallo che rappresenta l’origine dati. Se l’indirizzo non contiene il nome di un foglio, viene utilizzato il foglio attualmente attivo. 4. hasHeaders: valore booleano che indica se i dati da importare contengono etichette di colonna. Se l’origine non contiene intestazioni (ovvero quando questa proprietà è impostata su false), Excel genererà automaticamente un’intestazione spostando i dati di una riga verso il basso **Estrattore di output richiesto** Restituisce i valori dei metadati della tabella appena creata. #### 10) Aggiungere una nuova riga in una tabella **Scopo** Gli utenti possono passare come input un ID della cartella di lavoro, il nome della tabella e i valori delle righe; Tulip creerà una nuova riga con i valori forniti. La risposta dell’API conterrà i valori della riga creata nella tabella. **Endpoint** Chiamata HTTP POST all’endpoint `https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/tables/{tablename}/rows/add` **Dati richiesti** Di seguito sono riportati i parametri inviati come corpo della richiesta 1. ID della cartella di lavoro - L’ID della cartella di lavoro 2. Nome del foglio di lavoro - Titolo del foglio di lavoro 3. Valori delle righe **Estrattore di output obbligatorio** Restituisce i valori della riga appena creata. #### 11) Cancella i dati del foglio di lavoro **Scopo** Gli utenti possono inserire come input l'ID della cartella di lavoro, il nome del foglio di lavoro, l'intervallo iniziale e quello finale; Tulip cancellerà i valori delle celle in base all'intervallo specificato. **Endpoint** Chiamata HTTP POST all’endpoint [`https://graph.microsoft.com:443/v1.0/me/drive/items/{workbookID}/workbook/worksheet/{worksheetName}/range`](https://graph.microsoft.com:443/v1.0/me/drive/items/%7BworkbookID%7D/workbook/worksheet/%7BworksheetName%7D/range)`(address=’{start range}:{end range}’)/clear` **Dati richiesti** Di seguito sono riportati i parametri inviati come corpo della richiesta 1. ID della cartella di lavoro - L’ID della cartella di lavoro 2. Nome del foglio di lavoro - Titolo del foglio di lavoro 3. Intervallo iniziale 4. Intervallo di fine ## Approfondimenti Scopri ulteriori informazioni sui connettori Microsoft - [Connettore Calendario Microsoft](https://support.tulip.co/docs/microsoft-calendar-connector) - [Connettore per Microsoft Outlook](https://support.tulip.co/docs/microsoft-outlook-connector) - [Connettore Microsoft Teams](https://support.tulip.co/docs/microsoft-teams-connector)