Microsoft OneDrive

Il connettore di OneDrive permette di connettersi all'Archiviazione cloud Microsoft OneDrive da Designer. OneDrive è disponibile come origine dati negli strumenti Dati di input e Dati di output.

Upgrade al nuovo connettore di OneDrive

Se il flusso di lavoro utilizza la versione autonoma degli strumenti di Input OneDrive e Output di OneDrive, ricorda che ora sono deprecati. Al loro posto, devi usare la versione 2.2.0 o successiva del connettore, con i relativi strumenti Dati di input e Dati di output. Utilizza l'Utilità Migrazione del flusso di lavoro per aggiornare i flussi di lavoro preesistenti. Output Data Tool Icon Strumento Dati di output

Prerequisiti

Prima di procedere, verifica la disponibilità di tutti i prerequisiti seguenti:

Requisito	Dettagli
Designer	Designer 2026.1 o versione successiva. Designer 2025.2 Patch 3 o versione successiva. Designer 2025.1 Patch 5 o versione successiva.
Versione del connettore	Microsoft OneDrive 2.2.0 o versione successiva. Disponibile nei Componenti aggiuntivi di Designer.
Autorizzazioni per Azure	Consulta Configurazione dell'applicazione API Microsoft Azure.
DCM	È necessario abilitare DCM in Designer. A tale scopo, vai a Opzioni >Impostazioni avanzate > DCM.
Accesso di rete	Accesso in uscita agli endpoint di OneDrive Online e Microsoft OAuth.

Installazione del connettore

Installa la versione più recente del connettore di OneDrive direttamente da Designer, tramite Componenti aggiuntivi. Questo è il metodo di installazione consigliato, poiché consente di cercare, installare e aggiornare i connettori senza uscire da Designer e senza visitare Alteryx Marketplace.

Per installare il connettore...

In Designer, vai a Componenti aggiuntivi > Gestisci componenti aggiuntivi Marketplace. Viene visualizzato l'elenco dei connettori disponibili.
Seleziona Connettore di Microsoft OneDrive, quindi Installa. Designer scarica e installa il pacchetto. Per completare l'installazione potrebbe essere necessario riavviare Designer.
Terminate le fasi di installazione e configurazione, il connettore di OneDrive è disponibile negli strumenti Dati di input e Dati di output.

Configurazione di una connessione

Per connettersi a Microsoft OneDrive...

Trascina lo strumento Dati di input o Dati di output sull'area di disegno e seleziona Connessione ai dati.
In Configurazione del connettore, seleziona Crea o Sfoglia una connessione dati.
Se in precedenza è stata creata una connessione Microsoft OneDrive, puoi selezionarla dalla scheda Recenti.
Seleziona +Nuova. Dall'elenco delle tecnologie, seleziona Microsoft OneDrive.
Compila i campi Nome connessione e Nome origine dati.
Nella sezione Credenziali seleziona il tuo metodo di autenticazione e inserisci le credenziali. Per ulteriori informazioni, consulta la sezione Metodi di autenticazione.
Seleziona Salva. Puoi anche testare la connessione prima di salvare.
Seleziona Connetti. Microsoft OneDrive potrebbe richiedere l'autenticazione.
Seleziona la configurazione di lettura o scrittura nella finestra Opzioni. Per ulteriori informazioni sulle opzioni, consulta la sezione Lettura di dati da OneDrive o Scrittura di dati in OneDrive.Lettura di dati da OneDriveScrittura di dati in OneDrive
Seleziona Conferma per creare una connessione al file. Puoi continuare a creare il flusso di lavoro.

Migrazione del flusso di lavoro

Se i flussi di lavoro preesistenti utilizzano gli strumenti Input OneDrive o Output OneDrive deprecati, per utilizzare il nuovo connettore è necessario eseguire la migrazione tramite l'Utilità Migrazione del flusso di lavoro per aggiornarli.

L'utilità visualizza tutte le modifiche in anteprima e sostituisce le istanze degli strumenti deprecati con le nuove versioni dei connettori, senza interrompere i flussi di lavoro.

Metodi di autenticazione

Microsoft OneDrive supporta tre metodi di autenticazione. Per scegliere quella appropriata per il tuo scenario di utilizzo, usa la tabella che segue.

Metodo	Dettagli
Azure AD-privato (app integrata)	Utilizza questa opzione per impostare una connessione ad-hoc personale con le tue credenziali Microsoft. Indirizzo e-mail e password sono legati alle tue credenziali Microsoft personali. Questo metodo può essere utilizzato per gli SDK. Non è consigliato per la programmazione dei flussi di lavoro. DCM è facoltativo.
Azure AD-privato (app personalizzata)	Utilizza questo metodo se il tuo team condivide un'app Azure con registrazione personalizzata. Questo metodo può essere utilizzato per gli SDK. Per istruzioni sulla configurazione, consulta la sezione Configurazione dell'app API di Microsoft Azure. DCM è facoltativo.
Entità di servizio (applicazione)	Utilizza questo metodo per programmare o automatizzare i flussi di lavoro senza vincolare l'autenticazione a un utente specifico. Sfrutta le capacità delle applicazioni API personalizzate con un'entità di servizio. Per istruzioni sulla configurazione, consulta la sezione Configurazione dell'app API di Microsoft Azure. DCM è obbligatorio.

Limitazioni

Il connettore Microsoft OneDrive presenta attualmente le seguenti limitazioni:

Le API di Microsoft Graph alla base delle pagine Recenti e Condivise con me sono deprecate, pertanto non restituiscono dati. Si tratta di un limite a livello di piattaforma, che non dipende dal connettore.
Di conseguenza, non è possibile sfogliare o accedere alle pagine Recenti e Condivisi con me, pertanto l'ambito di OneDrive è limitato a I miei file.
Il partizionamento non è supportato.
La lettura di dati contenenti caratteri jolly, oppure da più file o cartelle, non è supportata, ma può essere eseguita utilizzando le macro.
L'azione di output Aggiungi non è supportata. Il comportamento di tale azione può essere tuttavia riprodotto selezionando leggi > Unione > Sovrascrivi.
In questo modo, infatti, se si crea un nuovo file e nella destinazione esiste già un file con lo stesso nome, tale file non viene sovrascritto, ma vengono mantenuti entrambi i file, aggiungendo il timestamp come suffisso al nome del nuovo file.
La lettura di file XLSX con più fogli e la selezione dei fogli in base al nome o all'indice non sono supportate.

Note di release

Versione	Descrizione
v3.1.1	Il campo URL autorità è stato migliorato, inserendo automaticamente un valore predefinito e aggiungendo una Guida in linea che riduce il ricorso dalla documentazione esterna. È stato risolto un problema che determinava la visualizzazione di opzioni di configurazione non pertinenti in seguito alla selezione di un formato di file non supportato nel connettore di input di OneDrive. È stato risolto un problema che determinava il fallimento della connessione di prova in DCM quando si utilizzava l'autenticazione integrata nell'app. La gestione degli errori delle operazioni Ingresso e Uscita di OneDrive è stata migliorata.
v3.1.0	Compatibile con Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versioni successive. È stata introdotta la possibilità di utilizzare il login sicuro di Microsoft OAuth 2.0 per connettersi a OneDrive. Nei flussi di lavoro automatizzati senza supervisione, è possibile eseguire l'autenticazione con un'entità di servizio. È possibile memorizzare le credenziali di accesso una volta sola tramite DCM e riutilizzarle in tutti i flussi di lavoro, sia in Designer che in Server. È possibile eseguire processi non supervisionati su Server, con aggiornamento automatico dei token, senza eseguire una nuova autenticazione manuale. È disponibile un filtro che consente di passare velocemente a File personali, Condivisi con me o File recenti. Per selezionare i file, è possibile sfogliare, digitare un percorso manualmente o semplicemente incollare un collegamento condiviso a OneDrive. Quando si incolla un URL, il connettore identifica e carica automaticamente i dettagli dei file. È possibile scegliere un foglio specifico indicandone il nome o il numero, definire un intervallo di celle personalizzato o estrarre solo l'elenco dei nomi dei fogli. È possibile inserire dettagli come nome, percorso, dimensioni, data dell'ultima modifica e tipo di file, insieme ai propri dati. È possibile recuperare solo la struttura di file e cartelle, senza scaricare i contenuti completi. È possibile leggere file .csv, .xlsx e .yxdb direttamente da OneDrive.
v2.3.0	Compatibile con Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versioni successive. Compatibile solo con AMP Engine. DCM necessario per l'esecuzione di questo connettore su Alteryx Server. Finestra delle opzioni di autenticazione migliorata. Quando scarichi file XLSX in locale, adesso l'output di Input OneDrive include i nomi dei fogli. Tali nomi possono essere utilizzati in altri strumenti del flusso di lavoro. Risolto il problema a causa del quale Output OneDrive, impostato per sovrascrivere uno specifico foglio nel file XLSX, modificava anche altri fogli. Risolto il problema a causa del quale l'autenticazione degli strumenti OneDrive non funzionava correttamente. (TPM-3833) Risolto il problema a causa del quale Input OneDrive non leggeva correttamente determinati tipi di dati. (TPM-3751, TPM-3722, TPM-3721) Risolto il problema a causa del quale Output OneDrive generava file errati in presenza di dati contenenti valori decimali fissi o nulli. (TPM-3720) Risolto il problema a causa del quale Output OneDrive convertiva erroneamente valori nulli nei file CSV. (TPM-3719) Risolto il problema a causa del quale l'autenticazione principale del servizio non funzionava in Output OneDrive. (TPM-3580) Risolto il problema a causa del quale Output OneDrive includeva il campo nell'output, anche se l'esclusione del campo era stata impostata in Seleziona foglio. (TPM-3393) Risolto il problema a causa del quale Output OneDrive non aggiungeva correttamente i dati. (TPM-2564) Risolto il problema a causa del quale l'opzione di interruzione di Output OneDrive non funzionava correttamente per tutti i tipi di dati. (TPM-2563) Risolti i problemi di codifica degli strumenti OneDrive. (TPM-1984) Risolto il problema a causa del quale Output OneDrive modificava il formato delle intestazioni. (TPM-1375) Risolto il problema a causa del quale l'opzione di aggiunta di Output OneDrive sovrascriveva la formattazione e le formule del documento. (TPM-1179) Risolto il problema a causa del quale Input OneDrive non riuscita a leggere i file YXDB contenenti Data e ora. (TPM-1100) Risolto il problema a causa del quale Output OneDrive generava un errore in presenza di tipi di dati Byte e Int16 nel flusso di lavoro. (TPM-209)
v2.2.0	Compatibile con Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versioni successive. Compatibile solo con AMP Engine. Aggiunto il supporto per DCM. DCM necessario per l'esecuzione di questo connettore su Alteryx Server. Compatibile con FIPS. Aggiunta l'opzione per sovrascrivere solo un foglio. Modificato il comportamento del campo del nome del foglio in modo da escluderlo dai dati scritti. Aggiunta opzione per mantenere il campo del nome del foglio. La convalida SSL/TLS viene ora eseguita a fronte dell'archivio certificati Windows.
v2.1.0	L'autenticazione avviene utilizzando il browser dell'utente anziché il CEF incorporato in Designer, per garantire la conformità ai criteri di sicurezza attuali.
v2.0.2	Risolto il problema relativo alla perdita della configurazione dello strumento in caso di attivazione dell'opzione "Fornisci le informazioni di autenticazione".
v2.0.1	È stato risolto un problema che determinava la visualizzazione di una schermata vuota durante l'autenticazione in Designer 2021.3.2.54175. È tuttavia necessario eseguire anche l'aggiornamento a Designer 21.3.3.63061 o versione successiva.
v2.0.0	App Azure multi-tenant integrata con opzione di utilizzo di un'app Azure personalizzata (inclusa un'app single-tenant o un'entità servizio). Supporta la lettura e la scrittura dei formati di file XLSX, CSV e YXDB. Supporto proxy. Compatibile con Designer, versione 2021.2.2 e successive. Richiede OneDrive 365.
v1.0.2	Aggiornamento delle opzioni di Tabella codici. Distinzione tra codifiche con la stessa lingua (ad esempio 'Lingua' -> 'Lingua (codice specifico)') e codifiche in ordine alfabetico. Possibilità per l'utente di specificare la codifica per i file CSV nello strumento di output. Gestione migliorata della conversione dei dati in modo da non generare un avviso al posto di un errore quando in un campo manca un valore. È stato risolto il problema a causa del quale occasionalmente le impostazioni predefinite venivano ignorate. La registrazione in produzione è stata disabilitata per evitare problemi di autorizzazioni per installazioni/configurazioni diverse di Designer e supportare la funzionalità di programmazione dei flussi di lavoro.
v1.0.1	È stato risolto il problema che impediva l'installazione dei pacchetti.
v1.0.0	Versione iniziale per Input OneDrive e Output OneDrive.

Applicazione API Microsoft Azure personalizzata

Per impostare un'applicazione API personalizzata per questo strumento, vai alla nostra guida.

Nota

Per i flussi di lavoro che contengono gli strumenti di OneDrive versione 2.2.0 e successive, assicurati che AMP Engine sia abilitato. Per ulteriori informazioni, consulta la sezione AMP Engine.

Strumenti Alteryx utilizzati per Connect


Strumento Input di OneDrive	Strumento Output di OneDrive

In questa sezione: