Collega il tuo account OneDrive a Goodweek per gestire file, cartelle, link di condivisione, cartelle di lavoro e contenuti dei documenti direttamente dal tuo spazio di lavoro IA.
ℹ️ Nota sulla governance
Goodweek non supererà mai i livelli di accesso concessi all'utente all'interno di OneDrive, garantendo l'allineamento con le politiche 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 un utente possa vedere e collegare l'integrazione OneDrive, l'amministratore della tua organizzazione deve prima abilitarla dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.
Configurazione amministratore
L'integrazione OneDrive utilizza OAuth 2.0 di Microsoft 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 della tua 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 Entra deve concedere il consenso per conto dell'organizzazione prima che gli utenti possano collegarsi. Vai su Centro amministrazione Microsoft Entra → Applicazioni aziendali → Composio → Autorizzazioni → Concedi il consenso amministratore per [la tua organizzazione].
L'accesso ai dati di OneDrive o SharePoint è limitato a livello di risorsa. A seconda delle impostazioni della tua organizzazione, potrebbe essere necessario configurare autorizzazioni aggiuntive prima che l'integrazione possa accedere al contenuto dei file.
⚠️ Importante: caso particolare della sessione amministratore Microsoft
Se un amministratore del tenant Microsoft Entra completa personalmente il processo 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 OAuth.
Approccio consigliato: l'amministratore dovrebbe pre-approvare l'app in Entra ID (Applicazioni aziendali → Composio → Autorizzazioni → Concedi il consenso amministratore per la tua organizzazione) prima che qualsiasi utente, incluso l'amministratore, esegua il processo di connessione di Goodweek. Una volta pre-approvata, qualsiasi utente, incluso l'amministratore, può completare il processo e l'integrazione verrà collegata al suo account individuale.
In alternativa, un utente non amministratore può completare per primo il processo di connessione per evitare questo problema.
Connessione dell'utente
In Goodweek, vai su Integrazioni.
Trova OneDrive 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 file e alle cartelle appartenenti all'account che autorizzi, oltre a eventuali file condivisi con te.
Puoi revocare l'accesso di Goodweek in qualsiasi momento dal tuo account Microsoft → Il mio account → Privacy → App e servizi → Composio → Rimuovi accesso.
Strumenti disponibili
Strumento | Descrizione | Tipo |
List OneDrive Items | Recupera file e cartelle dalla radice di OneDrive dell'utente. | Lettura |
List Folder Children | Elenca i file e le cartelle diretti all'interno di una cartella di OneDrive tramite l'ID DriveItem o il percorso. | Lettura |
List All Drive Items | Elenca in modo sicuro un intero drive di OneDrive o SharePoint utilizzando la paginazione delta. | Lettura |
Find Item | Trova un file o una cartella in base al nome all'interno di una cartella specifica di OneDrive. | Lettura |
Find Folder | Trova cartelle in base al nome all'interno di una cartella principale accessibile in OneDrive. | Lettura |
Search Drive Items | Cerca per parola chiave in OneDrive e nei file di SharePoint accessibili, tra nomi di file, metadati e contenuto. | Lettura |
Search Items | Cerca file e cartelle in OneDrive per parola chiave, incluso il contenuto dei file. | Lettura |
Get Item Metadata | Recupera i metadati di un DriveItem tramite il suo ID univoco, inclusi nome, dimensione e timestamp. | Lettura |
Get Drive Root Folder | Recupera i metadati della cartella radice di OneDrive dell'utente che ha eseguito l'accesso. | Lettura |
Get Drive Special Folder | Recupera una cartella speciale di OneDrive in base al nome (Documenti, Desktop, Foto, ecc.). | Lettura |
Get DriveItem by Sharing URL | Risolve un URL di condivisione di OneDrive o SharePoint in un DriveItem con metadati completi. | Lettura |
List OneDrive Shared Items | Elenca i file condivisi dagli account OneDrive di altre persone che sono accessibili all'utente. | Lettura |
Download a File | Scarica un file da OneDrive utilizzando il relativo ID elemento. | Lettura |
Download File by Path | Scarica il contenuto di un file da OneDrive tramite il relativo percorso. | Lettura |
Download Item as Format | Scarica un DriveItem convertito in un formato specificato, come PDF o HTML. | Lettura |
Upload File | Carica un file in una cartella specifica di OneDrive, creando la cartella di destinazione se necessario. | Scrittura |
Update File Content | Aggiorna il contenuto di un file esistente in OneDrive. | Scrittura |
Create Folder | Crea una nuova cartella in OneDrive dell'utente con un comportamento in caso di conflitto configurabile. | Scrittura |
Create a New Text File | Crea un nuovo file di testo semplice con il contenuto specificato in OneDrive. | Scrittura |
Move Item | Sposta un file o una cartella in una nuova cartella principale in OneDrive per la riorganizzazione. | Lettura |
Copy Item | Copia un DriveItem (file o cartella) in una nuova posizione in modo asincrono. | Lettura |
Update Drive Item Metadata | Aggiorna i metadati di un elemento di OneDrive, tra cui nome, descrizione e cartella principale. | Scrittura |
Create Sharing Link | Crea un link di condivisione per un DriveItem con tipo di accesso e permessi configurabili. | Scrittura |
Invite User to Drive Item | Invita gli utenti e concede loro i permessi su un elemento specifico di OneDrive. | Scrittura |
Get Item Permissions | Recupera i permessi di un DriveItem all'interno di un drive specifico. | Lettura |
Update Drive Item Permissions | Aggiorna i ruoli di un permesso esistente su un elemento di OneDrive. | Scrittura |
Get Item Versions | Recupera la cronologia delle versioni di un DriveItem tramite il suo ID univoco. | Lettura |
Restore Item Version | Ripristina una versione precedente di un file creando una nuova versione a partire dalla versione storica specificata. | Lettura |
Check Out Drive Item | Effettua il check-out di un DriveItem per impedire ad altri di modificarlo finché le modifiche non sono complete. | Lettura |
Check In Drive Item | Effettua il check-in di un DriveItem precedentemente sottoposto a check-out, rendendo la nuova versione visibile agli altri. | Lettura |
Discard Checkout | Annulla il check-out di un DriveItem, rilasciandolo e scartando eventuali modifiche. | Lettura |
List Drive Activities | Recupera le attività recenti su OneDrive dell'utente autenticato. | Lettura |
List Root Drive Changes | Elenca le modifiche nella radice del drive principale dell'utente utilizzando un token delta per la sincronizzazione incrementale. | Lettura |
Preview Drive Item | Genera un URL di anteprima incorporabile di breve durata per uno specifico DriveItem. | Lettura |
Get Document Comments | Estrae i commenti da un file Word .docx archiviato in OneDrive. | Lettura |
List Drives | Elenca tutte le risorse Drive disponibili per l'utente autenticato, inclusi i drive personali e condivisi. | Lettura |
Get SharePoint List Items (via OneDrive) | Recupera gli elementi di un elenco di SharePoint tramite la connessione OneDrive. | Lettura |
List Site Lists | Elenca tutti gli elenchi di un sito SharePoint specifico tramite la connessione OneDrive. | Lettura |
List Site Subsites | Elenca tutti i sottosti di un sito SharePoint tramite la connessione OneDrive. | Lettura |
Get Workbook Used Range | Recupera l'area dati attiva di un foglio di lavoro in una cartella di lavoro Excel archiviata in OneDrive. | Lettura |
Read Workbook Range | Legge un intervallo specifico di celle da un foglio di lavoro di una cartella di lavoro Excel archiviata in OneDrive. | Lettura |
Update Workbook Range | Aggiorna un intervallo in un foglio di lavoro di una cartella di lavoro Excel archiviata in OneDrive. | Scrittura |
Write Workbook Cell | Aggiorna il valore, la formula o il formato di una cella specifica in una cartella di lavoro Excel archiviata in OneDrive. | Scrittura |
Restore Deleted Item | Ripristina un DriveItem eliminato (file o cartella) dal cestino. | Lettura |
Delete Item | Elimina un DriveItem (file o cartella) tramite il suo ID univoco, spostandolo nel cestino. | ⚠️ Distruttivo |
Permanently Delete Drive Item | Elimina definitivamente un DriveItem senza spostarlo nel cestino. Questa azione è irreversibile. | ⚠️ Distruttivo |
Delete Drive Item Permission | Revoca un permesso di condivisione da un elemento di OneDrive. | ⚠️ Distruttivo |
Casi d'uso
Trova e recupera file su richiesta. Cerca in OneDrive per parola chiave tra nomi di file e contenuti da Goodweek per individuare documenti specifici senza sfogliare manualmente la struttura delle cartelle.
Carica e organizza i file. Carica nuovi file nelle cartelle di OneDrive, crea strutture di cartelle e sposta o copia file esistenti dalle conversazioni di Goodweek per mantenere i documenti organizzati.
Condividi i file con il giusto livello di accesso. Genera link di condivisione o invita utenti specifici a un file o a una cartella da Goodweek, con autorizzazioni di visualizzazione o modifica configurabili, quando condividi contenuti con colleghi o terze parti.
Leggi e aggiorna le cartelle di lavoro Excel. Recupera dati da intervalli di celle specifici in cartelle di lavoro Excel archiviate in OneDrive e aggiorna valori o intervalli di celle da Goodweek senza aprire direttamente il file.
Risoluzione dei problemi
Errore di autorizzazione durante la connessione
L'amministratore del tuo 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 tentare di ricollegarti.
Integrazione non visibile in Goodweek
Assicurati che l'amministratore della tua organizzazione abbia abilitato l'integrazione OneDrive dal Pannello di amministrazione di Goodweek, nella scheda Integrazioni.