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

Overview

Strumenti disponibili

ottieniOneDrive

Ottiene informazioni sul 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 nella OneDrive dell'utente.

Parametri facoltativi:

• parentFolderId: ID della cartella padre i cui file e cartelle si desidera elencare (impostazione predefinita: 'root')

TrovaFileOCartellaNelMioOnedrive

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

Parametri obbligatori:

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

getFileOrFolderMetadataInMyOnedrive

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

Parametri obbligatori:

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

getFileOrFolderMetadataByUrl

Ottiene 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 possono ottenere i metadati.

Parametri obbligatori:

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

leggiFileDiTestoPiccoloDaMioOnedrive

Legge (scarica) un file di testo dal OneDrive dell'utente.

Parametri obbligatori:

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

creaPiccoloFileDiTestoNelMioOnedrive

Crea o carica un file di testo di dimensioni inferiori a 5 MB nel 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

Crea una nuova cartella (DriveItem) nel OneDrive dell'utente come figlio della cartella padre specificata. Se esiste già una cartella con lo stesso nome, il metodo aggiunge 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

Rinomina un file o una cartella (DriveItem) nella 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

Elimina un file o una cartella (DriveItem) dal 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 o scrittura per un file o una cartella (DriveItem) nel 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. Valore predefinito: true.

impostareEtichettaSensibilitàSuFileNelMioOnedrive

Imposta l'etichetta di riservatezza di un file nel 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

Crea un file binario di dimensioni inferiori a 5 MB mediante la codifica base64 del relativo contenuto 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

Legge un file binario inferiore a 5 MB dal OneDrive dell'utente. Restituisce il contenuto del file come stringa con codifica Base64.

Parametri obbligatori:

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

copiaFileOCartellaNelMioOnedrive

Copia 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

Sposta 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

Controlla 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à principali

gestione OneDrive

• Recupera informazioni su OneDrive, ad esempio quota e 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.
• Usare più metodi di assegnazione, tra cui standard, con privilegi e auto.
• Supporto della giustificazione del controllo.
• Usare il controllo di concorrenza con eTags.

Notes

• Tutte le operazioni hanno come destinazione il OneDrive personale dell'utente autenticato.
• Le operazioni sui file sono limitate ai file di dimensioni pari o inferiori a 5 MB per il caricamento e il download.
• Le operazioni di eliminazione e ridenominazione supportano 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.