Collega il tuo account SharePoint a Goodweek per gestire documenti, elenchi, cartelle, file e contenuti del sito direttamente dal tuo spazio di lavoro IA.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di SharePoint, garantendo l'allineamento con le policy di governance della tua organizzazione. I risultati e le funzionalità disponibili possono variare in base alle autorizzazioni specifiche e all'accesso autenticato di ciascun utente.
📋 Prerequisiti
Prima che qualsiasi utente possa vedere e collegare l'integrazione con SharePoint, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
L'integrazione con SharePoint utilizza Microsoft OAuth 2.0 tramite Microsoft Entra ID. Per consentire agli utenti di collegarsi, un amministratore del tenant Microsoft Entra deve concedere il consenso amministratore per l'applicazione. Senza questo passaggio, gli utenti potrebbero visualizzare un errore di autorizzazione durante il processo di connessione.
Esistono tre scenari tipici a seconda della configurazione del tuo Entra ID:
Il consenso amministratore è già stato concesso. Gli utenti possono collegarsi direttamente senza ulteriori passaggi.
Il consenso utente è disabilitato nel tuo tenant. Un amministratore di Entra deve concedere il consenso per conto dell'organizzazione prima che gli utenti possano collegarsi. Vai su Centro di amministrazione di Microsoft Entra → Applicazioni aziendali → Composio → Autorizzazioni → Concedi consenso amministratore per [la tua organizzazione].
L'accesso a SharePoint è limitato a livello di risorsa. A seconda delle impostazioni di SharePoint della tua organizzazione, potrebbe essere necessario configurare autorizzazioni aggiuntive a livello di sito o di tenant prima che l'integrazione possa accedere ai contenuti.
⚠️ Importante: caso particolare della sessione amministratore Microsoft
Se un amministratore del tenant Microsoft Entra completa personalmente il flusso di connessione OAuth, Microsoft potrebbe applicare automaticamente il consenso amministratore e collegare l'integrazione all'account dell'amministratore anziché al suo account utente individuale. Questo è un comportamento di Microsoft e non può essere modificato a livello di OAuth.
Approccio consigliato: L'amministratore dovrebbe pre-approvare l'app in Entra ID (Applicazioni aziendali → Composio → Autorizzazioni → Concedi consenso amministratore per la tua organizzazione) prima che qualsiasi utente, incluso l'amministratore, effettui il flusso di connessione di Goodweek. Una volta pre-approvata, qualsiasi utente, incluso l'amministratore, può completare il flusso e l'integrazione verrà collegata al proprio account individuale.
In alternativa, un utente non amministratore può completare per primo il flusso di connessione per evitare questo problema.
Connessione utente
In Goodweek, vai su Integrazioni.
Trova SharePoint e fai clic su Connetti.
Verrai reindirizzato a Microsoft, dove ti verrà chiesto di accedere con il tuo account Microsoft e autorizzare l'accesso.
Fai clic su Accetta per concedere l'accesso e tornare a Goodweek.
Note importanti
Ogni utente deve collegare il proprio account individualmente.
Goodweek può accedere solo ai siti, agli elenchi e ai documenti a cui il tuo account individuale ha accesso all'interno di SharePoint.
Puoi revocare l'accesso di Goodweek in qualsiasi momento da Account Microsoft → Il mio account → Privacy → App e servizi → Composio → Rimuovi accesso.
Strumenti disponibili
Strumento | Descrizione | Tipo |
List SharePoint Sites | Elenca tutti i siti SharePoint accessibili all'utente, a scopo di ricerca. | Lettura |
Get SharePoint Site by Hostname | Recupera i metadati del sito in base al nome host o all'URL, inclusi ID del sito e nome visualizzato. | Lettura |
Get SharePoint Root Site | Recupera i metadati del web radice di una raccolta siti SharePoint. | Lettura |
Get SharePoint Web Info | Recupera informazioni sul web SharePoint corrente, inclusi titolo e URL. | Lettura |
List SharePoint Lists | Elenca tutti gli elenchi e le raccolte documenti nel sito SharePoint corrente. | Lettura |
Get SharePoint List by GUID | Recupera un elenco SharePoint specifico in base al suo identificatore univoco. | Lettura |
Get SharePoint List by Title | Recupera un elenco SharePoint in base al suo titolo visualizzato. | Lettura |
List SharePoint List Columns | Elenca tutte le definizioni delle colonne di un elenco SharePoint, inclusi i metadati dei campi. | Lettura |
Create SharePoint List | Crea un nuovo elenco in SharePoint utilizzando la REST API. | Scrittura |
Update SharePoint List | Aggiorna le proprietà di un elenco SharePoint esistente, ad esempio titolo o descrizione. | Scrittura |
Get SharePoint List Items | Recupera gli elementi di un elenco SharePoint con filtro OData e paginazione facoltativi. | Lettura |
Get List Item by ID | Recupera un elemento specifico di un elenco SharePoint in base al suo ID numerico. | Lettura |
Create SharePoint List Item | Crea un nuovo elemento in un elenco SharePoint. | Scrittura |
Update SharePoint List Item | Aggiorna i campi di un elemento esistente di un elenco SharePoint. | Scrittura |
List Drive Children | Elenca file e cartelle in una raccolta documenti o cartella di SharePoint. | Lettura |
List Files in Folder | Elenca i file all'interno di una cartella SharePoint specifica (non ricorsivo). | Lettura |
List Subfolders in Folder | Elenca le sottocartelle dirette all'interno di una cartella SharePoint. | Lettura |
Get All SharePoint Folders | Recupera tutte le cartelle nel web SharePoint, a scopo di ricerca. | Lettura |
Create SharePoint Folder | Crea una nuova cartella in una raccolta documenti di SharePoint. | Scrittura |
Rename SharePoint Folder | Rinomina una cartella SharePoint aggiornando i metadati del relativo elemento elenco. | Lettura |
Upload File to Folder | Carica un file in una raccolta documenti o cartella di SharePoint. | Scrittura |
Upload File from URL to SharePoint | Recupera un file da un URL e lo carica direttamente su SharePoint. | Scrittura |
Download File by Server-relative URL | Scarica un file da SharePoint utilizzando il suo URL relativo al server. | Lettura |
Get Site Drive Item by Path | Recupera i metadati di un file o di una cartella in base al percorso relativo al server. | Lettura |
Update Drive Item | Aggiorna le proprietà di un elemento drive (file o cartella) in SharePoint. | Scrittura |
Update File Item Metadata | Aggiorna i campi dei metadati di un elemento file di SharePoint. | Scrittura |
Search SharePoint Site | Cerca contenuti SharePoint utilizzando Keyword Query Language per documenti, elementi e cartelle. | Lettura |
Search Files Across All Sites | Cerca file in tutti i siti SharePoint e in OneDrive utilizzando Keyword Query Language. | Lettura |
Check Out SharePoint File | Effettua il check-out di un file per bloccarlo prima di apportare modifiche. | Lettura |
Check In SharePoint File | Effettua il check-in di un file per finalizzare le modifiche e rendere disponibile la nuova versione. | Lettura |
Recycle SharePoint File | Sposta un file nel Cestino di SharePoint (eliminazione reversibile, recuperabile). | Lettura |
Restore Recycle Bin Item | Ripristina un elemento SharePoint eliminato dal Cestino in base al suo GUID. | Lettura |
Create Drive Item Sharing Link | Crea un link di condivisione per un elemento drive di SharePoint con tipo di accesso configurabile. | Scrittura |
Add Attachment to List Item | Carica un file binario come allegato a un elemento di un elenco SharePoint. | Scrittura |
List Item Attachments | Elenca tutti gli allegati di un elemento di un elenco SharePoint. | Lettura |
Download List Item Attachment | Scarica il contenuto binario di un allegato di un elemento di un elenco SharePoint. | Lettura |
Get Content Types for List | Recupera tutti i tipi di contenuto per un elenco SharePoint specifico. | Lettura |
Create Content Type | Crea un nuovo tipo di contenuto in SharePoint con le definizioni di campo specificate. | Scrittura |
List Site Groups | Elenca tutti i gruppi del sito SharePoint per una raccolta siti. | Lettura |
Get Group Users | Recupera tutti gli utenti membri di un gruppo SharePoint specificato. | Lettura |
List Site Users | Elenca gli utenti nella raccolta siti, inclusi utenti singoli e gruppi. | Lettura |
Find SharePoint User | Cerca un utente nel sito SharePoint in base all'indirizzo email. | Lettura |
Get Drive Item Analytics | Recupera le statistiche di accesso (numero di visualizzazioni) di un elemento drive di SharePoint. | Lettura |
List Recently Modified Drive Items | Elenca gli elementi modificati di recente in un drive SharePoint. | Lettura |
Restore Drive Item Version | Ripristina una versione precedente di un elemento drive di SharePoint. | Lettura |
Delete SharePoint File | Elimina definitivamente un file da una raccolta documenti di SharePoint. | ⚠️ Destruttivo |
Delete SharePoint Folder | Elimina definitivamente una cartella da una raccolta documenti di SharePoint. | ⚠️ Destruttivo |
Delete SharePoint List Item | Elimina definitivamente un elemento di un elenco SharePoint in base al suo ID. | ⚠️ Destruttivo |
Delete SharePoint List | Elimina definitivamente un elenco SharePoint in base al suo GUID. | ⚠️ Destruttivo |
Casi d'uso
Trova e recupera documenti tra più siti. Cerca nei siti SharePoint tramite parole chiave o esplora la struttura delle cartelle da Goodweek per individuare file specifici e recuperarne il contenuto o i link di download senza dover navigare nell'interfaccia di SharePoint.
Crea e aggiorna elementi di elenco. Aggiungi o modifica elementi negli elenchi SharePoint dalle conversazioni di Goodweek: utile per aggiornare tracker di progetto, registri dei problemi o qualsiasi dato strutturato memorizzato negli elenchi SharePoint.
Carica e organizza i file. Carica file nelle raccolte documenti, crea cartelle e gestisci l'organizzazione dei file in SharePoint direttamente da Goodweek, mantenendo i documenti aggiornati senza navigazione manuale nel browser.
Condividi documenti con livelli di accesso specifici. Genera link di condivisione per file o cartelle con il livello di autorizzazione appropriato da Goodweek quando condividi risorse con stakeholder interni o esterni.
Risoluzione dei problemi
Errore di autorizzazione durante la connessione
Il tuo amministratore del tenant Microsoft Entra potrebbe dover concedere il consenso per l'applicazione. Chiedi al tuo amministratore di seguire i passaggi di Configurazione amministratore sopra riportati prima di provare a riconnetterti.
Integrazione collegata ma alcuni siti o file non sono accessibili
SharePoint rispetta le autorizzazioni a livello di sito e di elemento. Se non riesci ad accedere a un sito o a una raccolta documenti specifici, il tuo amministratore SharePoint dovrà concederti l'accesso direttamente all'interno di SharePoint.
Integrazione non visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione con SharePoint dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.