To download the app, visit: [connectors](https://tulip.co/library/<span translate=)/microsoft-excel-connector/">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
Prerequisiti
- Creare un account su Microsoft O365 e configurare le credenziali OAuth 2.0 in Microsoft Entra ID.
- Registrare l’API con gli ambiti richiesti nel portale Microsoft. Azure - Entra ID
Video sulla configurazione del connettore:
Dettagli di connessione a Tulip
Le seguenti informazioni devono essere configurate nella sezione
connettori di Tulip.
- In esecuzione su: Host del connettore cloud
- Host: graph.microsoft.com
- Porta: 443
- 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
- SheetID: identificatore univoco della cartella di lavoro che verrà utilizzato per eseguire le altre attività.
- CreatedAt: data e ora di creazione della cartella di lavoro.
- UltimaModifica: data e ora dell'ultima modifica della cartella di lavoro.
- SheetName: il nome della cartella di lavoro.
- 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
- ID della cartella di lavoro
Estrattore di output richiesto
- sheetId: identificatore univoco del foglio di calcolo che verrà utilizzato per eseguire le altre operazioni.
- sheetName: il nome visualizzato del foglio di lavoro.
- sheetPosition: la posizione del foglio di lavoro all'interno della cartella di lavoro, con riferimento a zero.
- 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
- ID della cartella di lavoro
- Nome del foglio di lavoro
Estrattore di output richiesto
- sheetId: identificatore univoco del foglio di calcolo che verrà utilizzato per eseguire le altre operazioni.
- sheetName: il nome visualizzato del foglio di lavoro.
- sheetPosition: la posizione del foglio di lavoro all'interno della cartella di lavoro, con riferimento a zero.
- sheetVisibility: la visibilità del foglio di lavoro. I valori possibili sono: Visible, Hidden, VeryHidden.
4) Creazione di un nuovo foglio di lavoro
Scopo
- 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.
- 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
- ID della cartella di lavoro - L’ID della cartella di lavoro
- Nome del foglio di lavoro - Titolo del foglio di lavoro
Estrattore di output richiesto
- WorksheetId: identificatore univoco del foglio di calcolo che verrà utilizzato per eseguire le altre operazioni.
- spreadsheetURL: l'URL del foglio di calcolo appena creato.
- 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
- ID della cartella di lavoro - L’ID della cartella di lavoro
- Nome del foglio di lavoro - Titolo del foglio di lavoro
- Posizione del foglio di lavoro: la posizione del foglio di lavoro all'interno della cartella di lavoro, con riferimento a zero
- Nome del nuovo foglio di lavoro: titolo del nuovo foglio di lavoro
Estrattore di output richiesto
- sheetID: identificatore univoco della cartella di lavoro che verrà utilizzato per eseguire le altre attività
- sheetName: il nome visualizzato del foglio di lavoro.
- 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}/cell(row={indice riga},column={indice colonna})
Dati di input richiesti
Di seguito sono riportati i parametri URL da passare
- ID della cartella di lavoro: ID della cartella di lavoro
- Nome del foglio di lavoro - Titolo del foglio di lavoro
- Indice della riga: numero di riga della cella da recuperare
- 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(address=’{start range}:{end range}’)
Dati di input richiesti
Di seguito sono riportati i parametri URL da passare
- ID della cartella di lavoro: ID della cartella di lavoro
- Nome del foglio di lavoro: titolo del foglio di lavoro
- Intervallo iniziale - Intervallo iniziale
- 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(address=’{start range}:{end range}’)
Dati di input richiesti
Di seguito sono riportati i parametri URL da passare
- ID della cartella di lavoro: ID della cartella di lavoro
- Nome del foglio di lavoro - Titolo del foglio di lavoro
- Intervallo iniziale - Intervallo iniziale
- Intervallo di fine: intervallo di fine
- 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
- 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.
- Ciò può essere ulteriormente utilizzato per recuperare e aggiornare i dati dai fogli di calcolo.
- 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
- ID della cartella di lavoro - L’ID della cartella di lavoro
- Nome del foglio di lavoro - Titolo del foglio di lavoro
- 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.
- 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
- ID della cartella di lavoro - L’ID della cartella di lavoro
- Nome del foglio di lavoro - Titolo del foglio di lavoro
- 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(address=’{start range}:{end range}’)/clear
Dati richiesti
Di seguito sono riportati i parametri inviati come corpo della richiesta
- ID della cartella di lavoro - L’ID della cartella di lavoro
- Nome del foglio di lavoro - Titolo del foglio di lavoro
- Intervallo iniziale
- Intervallo di fine
Approfondimenti
Scopri ulteriori informazioni sui connettori Microsoft