Informazioni di riferimento su OneDrive per L'IQ aziendale (anteprima)

Panoramica

Strumenti disponibili

ottieniOneDrive

Ottenere informazioni su OneDrive dell'utente, inclusi i metadati dell'unità, la quota e le informazioni sul proprietario.

Non è necessario alcun parametro.

getFolderChildrenInMyOnedrive

Enumera i primi 20 file e cartelle (DriveItems) contenuti in una cartella padre specificata in OneDrive dell'utente.

Parametri facoltativi:

• parentFolderId: ID della cartella padre i cui file e cartelle verranno elencati (impostazione predefinita: 'root')

TrovaFileOCartellaNelMioOnedrive

Trova un file o una cartella (DriveItem) nella query di ricerca di OneDrive dell'utente. Più efficiente rispetto alla ricerca di tutti i file accessibili se si sa che l'elemento si trova in OneDrive dell'utente.

Parametri obbligatori:

• searchQuery: Query di ricerca; può essere l'intero o parziale nome di file

getFileOrFolderMetadataInMyOnedrive

Ottenere i metadati di un file o di una cartella (DriveItem) da OneDrive dell'utente.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella in OneDrive dell'utente

getFileOrFolderMetadataByUrl

Ottenere i metadati di un file o di una cartella (DriveItem) da un URL di condivisione. Solo gli utenti con autorizzazioni esplicite esistenti per accedere al file potranno ottenere i metadati.

Parametri obbligatori:

• fileOrFolderUrl: URL del file o della cartella. L'URL non verrà utilizzato per condividerlo con l'utente; deve già avere un accesso esplicito.

leggiFileDiTestoPiccoloDaMioOnedrive

Leggere (scaricare) un file di testo da OneDrive dell'utente.

Parametri obbligatori:

• fileId: ID del file (DriveItem) da leggere/scaricare

creaPiccoloFileDiTestoNelMioOnedrive

Creare o caricare un file di testo di dimensioni inferiori a 5 MB in OneDrive dell'utente.

Parametri obbligatori:

• Filename: Nome del file da creare
• contentText: Contenuto di testo del file

Parametri facoltativi:

• parentFolderId: ID della cartella padre (impostazione predefinita: 'root')

creaCartellaNelMioOneDrive

Creare una nuova cartella (DriveItem) nell'OneDrive dell'utente come sottocartella della cartella principale specificata. Se esiste già una cartella con lo stesso nome, viene aggiunto un suffisso numerico(ad esempio, NewFolder (1)).

Parametri obbligatori:

• Foldername: Nome della cartella da creare

Parametri facoltativi:

• parentFolderId: ID della cartella padre (impostazione predefinita: 'root')

rinominaFileOCartellaNelMioOnedrive

Rinominare un file o una cartella (DriveItem) in OneDrive dell'utente. Il nuovo nome deve essere conforme alle convenzioni di denominazione.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella da rinominare
• newFileOrFolderName: Nuovo nome per il file o la cartella

Parametri facoltativi:

• Etag: Valore ETag per il controllo di concorrenza. L'operazione ha esito positivo solo se l'ETag corrente di DriveItem corrisponde

eliminaFileOCartellaNelMioOnedrive

Eliminare un file o una cartella (DriveItem) da OneDrive dell'utente.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella da eliminare

Parametri facoltativi:

• Etag: Valore ETag per il controllo di concorrenza

condividiFileOCartellaNelMioOnedrive

Invia un invito alla condivisione per concedere autorizzazioni di lettura/scrittura per un file o una cartella (DriveItem) in OneDrive dell'utente.

Parametri obbligatori:

• fileOrFolderId: ID del file o della cartella da condividere
• recipientEmails: Matrice di indirizzi di posta elettronica dei destinatari da invitare
• Ruoli: Matrice di ruoli da assegnare. Valori accettati: 'read', 'write' ('write' concede sia la lettura che la scrittura)

Parametri facoltativi:

• Messaggio: Messaggio personalizzato da includere nel messaggio di posta elettronica di invito (impostazione predefinita: "Ecco il file su cui stiamo collaborando".)
• sendInvitation: Indica se inviare un invito alla condivisione (impostazione predefinita: true)

impostareEtichettaSensibilitàSuFileNelMioOnedrive

Impostare l'etichetta di riservatezza di un file in OneDrive dell'utente.

Parametri obbligatori:

• fileId: ID del file (DriveItem)
• sensitivityLabelId: ID dell'etichetta di riservatezza da assegnare o una stringa vuota da rimuovere

Parametri facoltativi:

• assignmentMethod: Metodo di assegnazione: 'standard', 'privileged', 'auto' o 'unknownFutureValue' (impostazione predefinita: 'privileged')
• justificationText: Testo della giustificazione a scopo di controllo; obbligatorio durante il downgrade o la rimozione di un'etichetta (impostazione predefinita: 'Modificato da MCPServer')

creaPiccoloFileBinarioNelMioOnedrive

Creare un file binario di dimensioni inferiori a 5 MB codificandone il contenuto in base64 nel OneDrive dell'utente.

Parametri obbligatori:

• Filename: Nome del file da creare, inclusa l'estensione di file
• base64Content: Contenuto del file binario codificato come stringa base64

Parametri facoltativi:

• parentFolderId: ID della cartella padre (impostazione predefinita: 'root')

readSmallBinaryFileFromMyOneDrive

Leggere un file binario di dimensioni inferiori a 5 MB dal OneDrive dell'utente. Il contenuto del file viene restituito come stringa con codifica base64.

Parametri obbligatori:

• fileId: ID del file (DriveItem) da leggere o scaricare

copiaFileOCartellaNelMioOnedrive

Copiare un file o una cartella (DriveItem) in una cartella di destinazione all'interno del OneDrive dell'utente. Questa operazione è asincrona; usare checkOperationStatusInMyOnedrive per monitorare lo stato di avanzamento.

Parametri obbligatori:

• sourcefileid: ID del file o della cartella di origine (DriveItem) da copiare
• destfolderid: ID della cartella di destinazione (deve esistere nel OneDrive dell'utente)

Parametri facoltativi:

• newfilename: Nuovo nome per l'elemento copiato (per impostazione predefinita è il nome originale)

Sposta file o cartella nel mio OneDrive

Spostare un file o una cartella (DriveItem) in una cartella di destinazione all'interno del OneDrive dell'utente. Questa operazione è asincrona; usare checkOperationStatusInMyOnedrive per monitorare lo stato di avanzamento.

Parametri obbligatori:

• sourcefileid: ID del file o della cartella di origine (DriveItem) da spostare
• destfolderid: ID della cartella di destinazione (deve esistere nel OneDrive dell'utente)

Parametri facoltativi:

• newfilename: Nuovo nome per l'elemento spostato (per impostazione predefinita è il nome originale)

controllaStatusOperativoNelMioOneDrive

Controllare lo stato di un'operazione asincrona, ad esempio copia o spostamento, usando il token dell'operazione restituito dall'operazione originale. Restituisce informazioni sullo stato di avanzamento se sono ancora in corso, i dettagli dell'errore se non sono riusciti o i metadati del file o della cartella finali se sono stati completati correttamente.

Parametri obbligatori:

• operationToken: Token dell'operazione restituito da un'operazione asincrona come copyFileOrFolderInMyOnedrive o moveFileOrFolderInMyOnedrive

Funzionalità chiave

gestione OneDrive

• Ottenere informazioni su OneDrive (quota, proprietario)
• Accedere a OneDrive personale dell'utente
• Tutte le operazioni hanno come destinazione OneDrive dell'utente autenticato

Ricerca e individuazione di file

• Cercare file e cartelle in base al nome all'interno di OneDrive dell'utente
• Ottenere i metadati di file o cartelle in base all'ID o all'URL di condivisione
• Sfoglia il contenuto della cartella (fino a 20 elementi)

Operazioni con i file

• Creare file di testo e binari (≤5 MB)
• Leggere file di testo e binari (≤5 MB)
• Eliminare file con controllo della concorrenza
• Rinominare i file con protezione eTag
• Copiare e spostare file e cartelle in modo asincrono

Gestione della cartella

• Creare cartelle con percorsi padre facoltativi
• Suffisso numerico automatico per i nomi di cartelle duplicati
• Contenuto della cartella elenco (fino a 20 elementi)
• Ottenere i metadati della cartella
• Eliminare cartelle con il controllo della simultaneità
• Rinominare le cartelle con protezione eTag

Condivisione e autorizzazioni

• Condividere file e cartelle con gli utenti
• Controllo degli accessi in base al ruolo (lettura, scrittura)
• Notifiche tramite posta elettronica per la condivisione
• Messaggi personalizzati negli inviti

Sicurezza e conformità

• Applicare e rimuovere etichette di riservatezza
• Più metodi di assegnazione (standard, con privilegi, auto)
• Supporto per la giustificazione del controllo
• Controllo di concorrenza con eTag

Note

• Tutte le operazioni sono destinate al OneDrive personale dell'utente autenticato.
• Le operazioni su file sono limitate a ≤5 MB per il caricamento e il download
• Le operazioni di eliminazione e ridenominazione supportano gli eTag per il controllo della concorrenza
• La condivisione richiede indirizzi di posta elettronica validi e autorizzazioni appropriate
• Le etichette di riservatezza richiedono licenze e configurazione appropriate
• L'elenco di cartelle restituisce un massimo di 20 elementi per impostazione predefinita