Configurazione dell'integrazione di OneDrive con Business Central in locale

Questo articolo descrive come configurare l'integrazione di OneDrive per l'azienda o la scuola (precedentemente noto come OneDrive for Business) con Business Central in locale. A differenza di Business Central online, la connessione tra Business Central e OneDrive non viene configurata automaticamente. Se la connessione non è configurata, gli utenti non possono usare le funzioni di OneDrive.

Ci sono due attività che devono essere eseguite per configurare l'integrazione di OneDrive.

• La prima attività prevede la registrazione di un'applicazione (app) nel tenant di Microsoft Entra del tuo piano Microsoft 365. L'app registrata viene utilizzata per scopi di autenticazione. Questa attività viene in genere eseguita nel portale di Azure e nel client Web Business Central.
• La seconda attività prevede l'impostazione della connessione all'URL di OneDrive e l'attivazione delle funzionalità OneDrive in Business Central. Questa attività viene eseguita nel client Web Business Central. È diversa per la versione 21 rispetto alle versioni 19 e 20. La versione 21 introduce una nuova Impostazione di OneDrive che sostituisce Impostazione connessioni di SharePoint.

Registrare un'app in Microsoft Entra ID per l'integrazione di OneDrive

In questa attività aggiungi un'app registrata per Business Central nel tenant Microsoft Entra del tuo piano Microsoft 365. Analogamente ad altri servizi di Azure che funzionano con Business Central, OneDrive richiede un'app registrata in Microsoft Entra ID. L'app registrata fornisce servizi di autenticazione e autorizzazione tra Business Central e SharePoint, usati da OneDrive.

Per i passaggi dettagliati per completare questo passaggio, vedere Registrare un'applicazione in Microsoft Entra ID nella Guida per sviluppatori e professionisti IT.

Per la registrazione dell'applicazione, considera i seguenti punti:

• Se hai già registrato un'applicazione come parte di un'integrazione con un altro prodotto Microsoft, come Power BI, allora puoi riutilizzare l'app registrata. In questo caso, dovrai solo impostare le autorizzazioni di SharePoint per l'app registrata esistente.

• Assicurati di configurare l'app registrata con le seguenti autorizzazioni delegate all'API SharePoint :

  • AllSites.FullControl
  • User.ReadWrite.All

  Per Business Central 2021 release wave 2 (versione 19), impostare invece queste autorizzazioni:

  • TuttiSiti.Write
  • Scrivere i miei file
  • User.Read.All

• Se si utilizza Business Central versione 19 o 20, copiare l'ID dell'applicazione (client) e il client secret usati dall'app registrata. Avrai bisogno di queste informazioni nel prossimo compito.

Ottieni l'URL di OneDrive

Avrai bisogno di un URL per effettuare la connessione a OneDrive da Business Central. Il modo più semplice per ottenere l'URL è accedere a OneDrive per la tua organizzazione Nell'indirizzo del browser vedrai un URL che ha il seguente formato:

https://<your Microsoft 365 tenant name>-my.sharepoint.com/personal/<your user name>

Ad esempio: https://contoso-my.sharepoint.com/personal/rsimone_contoso_onmicrosoft_com.

Non è necessario l'intero URL. Usi solo la porzione prima di /personal:

https://<your Microsoft 365 tenant name>-my.sharepoint.com

Ad esempio: https://contoso-my.sharepoint.com.

Ci sono anche altri modi per ottenere l'URL. Per maggiori informazioni, vedi OneDrive URL per gli utenti della tua organizzazione nella documentazione di OneDrive .

Configurare la connessione OneDrive nella versione 21 e successive

Utilizza questa procedura se usi il secondo ciclo di rilascio di Business Central 2022 (versione 21) o successive.

Prerequisiti

• Autorizzazione di modifica indiretta e di eliminazione (imd) sulla tabella Scenario di servizio documenti come requisito minimo

Eseguire la configurazione di OneDrive

1. Selezionare Search (Alt+Q) nell'angolo superiore destro, immettere OneDrive Setup e quindi scegliere il collegamento correlato.

2. La prima volta che esegui il setup assistito, vedrai La tua privacy. Leggi le informazioni della pagina e, se sei d'accordo con le condizioni, seleziona Accetto e continua.

3. Sulla pagina Configura gestione file hai le seguenti opzioni tra cui scegliere:

   Opzione	Description
   Usa per le funzionalità dell'app	Se attivi questa opzione, le azioni Apri in OneDrive e Condividi sono rese disponibili sui file in Business Central, come i file allegati ai documenti o nella Posta in arrivo dei report. Queste azioni consentono agli utenti di copiare, aprire e condividere file in OneDrive. Le funzionalità di Business Central che archiviano o acquisiscono documenti e altri file e offrono le azioni Apri in OneDrive e Condividi per portare quei file fuori da Business Central, come i documenti in entrata e gli allegati dei record. Le funzionalità della linea di business che generano cartelle di lavoro Excel personalizzate, come il budget di vendita. Report inviati in Report elaborati Se hai installato personalizzazioni o estensioni, queste potrebbero aggiungere più funzionalità che utilizzano OneDrive. Per ulteriori informazioni, vedi Apertura e condivisione dei file di Business Central in OneDrive.
   Usa per funzioni del sistema	L'attivazione di questa opzione attiva le seguenti funzionalità: Le azioni Apri in Excel e Modifica in Excel nelle pagine elenco copieranno automaticamente il file Excel in OneDrive, quindi aprilo in Excel Online. Per ulteriori informazioni, vedi Visualizzazione e modifica in Excel. L'invio di un report a un file di Excel o Word copia automaticamente il file in OneDrive, quindi lo aprirà in Excel o Word online. Per ulteriori informazioni, vedi Salvataggio di un report in un file.

4. Nella pagina Configurare Business Central immettere l'URL di OneDrive nel campo OneDrive URL.

   Come trovare l'URL di OneDrive?

5. Scegli Test della connessione e aspetta i risultati.

   • Se il test ha esito positivo, scegli Fatto, e sei pronto per iniziare.
   • Se il test non riesce, viene visualizzato un messaggio che descrive il problema. In genere il problema ha a che fare con l'URL che hai fornito. Scegli OK per tornare alla pagina Configura Business Central, verifica l'URL e riprova.
   • Se non è già stata configurata l'app registrata Microsoft Entra ID, verrà visualizzata la guida Impostare Microsoft Entra ID.

6. Una volta completata, l'informativa sulla privacy per l'integrazione OneDrive è concordata per tutti gli utenti. Se si vuole modificarlo in modo che gli utenti debbano accettare o non essere d'accordo per se stessi, passare alla pagina Privacy Notices Status e selezionare Let User Decide per l'integrazione OneDrive. Agli utenti verrà quindi richiesto di accettare o meno l'informativa sulla privacy la prima volta che utilizzano le funzionalità OneDrive. Altre informazioni in Informative sulla privacy.

Impostare la connessione in Business Central nella versione 19 e 20

Utilizza questa procedura se usi il primo ciclo di rilascio di Business Central 2022 (versione 20) o il secondo ciclo di rilascio 2021 (versione 19).

1. Selezionare Search (Alt+Q) nell'angolo superiore destro, immettere Microsoft SharePoint Connection Setup e quindi scegliere il collegamento correlato.

2. Nel campo Descrizione, inserisci una descrizione per la connessione, come OneDrive.

3. Nel campo Folder immettere Business Central.

4. Nel campo Posizione, inserisci l'URL del tuo OneDrive.

   Come trovare l'URL di OneDrive?

5. Nel campo ID cliente, inserisci l'ID client dell'app registrata.

6. Nel campo Segreto client, inserisci il segreto dell'app registrata.

Dopo l'aggiornamento alla versione 21

Quando si esegue l'aggiornamento alla versione 21 o successiva, la connessione esistente a OneDrive configurata nella pagina SharePoint Configurazione connessione funzionerà ancora. Tuttavia, poiché la pagina SharePoint Connection Setup verrà rimossa nella versione 23, è consigliabile passare alla nuova integrazione OneDrive, come descritto nella sezione successiva. Effettuare questo cambiamento ora rende più facile quando il SharePoint Connection Setup verrà eventualmente rimosso. Inoltre, ti consentirà di utilizzare la guida al setup assistito Setup OneDrive per gestire le funzionalità OneDrive accessibili agli utenti.

Passaggio dal SharePoint legacy alla nuova integrazione di OneDrive

Per passare alla nuova integrazione OneDrive, esegui la guida alla configurazione assistita OneDrive Setup, che è possibile aprire direttamente o dalla pagina legacy di SharePoint Connection Setup. Il programma di installazione OneDrive guida la transizione, fornendo informazioni sulle modifiche apportate lungo il percorso.

Prima di iniziare con il passaggio o mentre lo stai facendo, fai riferimento alla sezione successiva per conoscere alcuni aspetti e considerazioni sul processo.

Informazioni sul passaggio alla nuova integrazione OneDrive

Oltre all'integrazione OneDrive, Business Central può anche integrarsi con altri servizi, ad esempio Power BI e stampa universale. L'integrazione con questi altri servizi richiede anche un'app Microsoft Entra registrata per l'autenticazione. L'app Microsoft Entra usata da questi altri servizi è configurata nella configurazione assistita di Impostare gli account Microsoft Entra. Quando si passa dalla configurazione legacy di connessione di SharePoint, la nuova configurazione assistita OneDrive Setup modifica l'integrazione di OneDrive per utilizzare anche la configurazione assistita Imposta gli account Microsoft Entra, così tutte le integrazioni utilizzano la stessa app di Microsoft Entra.

Questa modifica ha implicazioni quando si passa alla nuova integrazione OneDrive, a seconda che sia già presente un'app Microsoft configurata nella Configura i tuoi account Microsoft Entra configurazione assistita.

Come le modifiche influiscono sull'integrazione

L'installazione assistita di OneDrive userà sempre l'app configurata nella configurazione assistita di Impostare gli account Microsoft Entra, se ce n'è uno. Quando si esegue l'installazione assistita OneDrive, confronta l'app configurata in Imposta gli account Microsoft Entra con l'app corrente configurata in Configurazione connessione SharePoint.

• Se l'app in Configura i tuoi account Microsoft Entra è diversa dall'app in Configurazione connessione SharePoint, l'integrazione di OneDrive cambia per utilizzare l'app in Configura i tuoi account Microsoft Entra.

  In OneDrive Setup mentre si esegue l'opzione, viene visualizzato un messaggio simile al testo seguente:

  L'applicazione Microsoft Entra utilizzata per l'autenticazione verrà configurata per tutte le integrazioni di Business Central. Ciò significa che l'ID client cambierà in NNNNNNNNN-NNNN-NNNN-NNNN-NNNN-NNNNNNNNNNNNNN ed è consigliabile verificare che abbia le autorizzazioni corrette.

  NNNNNNNNN-NNNN-NNNN-NNNN-NNNNNNNNNNNN rappresenta l'ID client dell'app in Imposta i tuoi account Microsoft Entra a cui è stata trasferita l'integrazione di OneDrive.

  Importante

  Per utilizzare la nuova integrazione OneDrive dopo aver effettuato il passaggio, è necessario concedere l'autorizzazione dell'app all'API SharePoint nel portale di Azure. È possibile eseguire questo passaggio prima o dopo il passaggio alla nuova configurazione OneDrive. Per altre informazioni, vedere la sezione Registrare un'app in Microsoft Entra ID per l'integrazione di OneDrive.

• Se l'app nella configurazione degli account Microsoft Entra è la stessa app nella configurazione della connessione SharePoint, l'integrazione di OneDrive utilizza la stessa app utilizzata in precedenza, eccetto per la configurazione nella configurazione degli account Microsoft Entra.

  In OneDrive Setup mentre si esegue l'opzione, viene visualizzato un messaggio simile al testo seguente:

  L'applicazione Microsoft Entra utilizzata per l'autenticazione verrà configurata per tutte le integrazioni di Business Central. Questo è già stato configurato con lo stesso ID client (aaaabbbb-0000-cccc-1111-dddd2222eeee).

• Se nel set-up del tuo account Microsoft Entra non è configurata nessuna app, l'integrazione di OneDrive utilizza la stessa app di prima.

  L'installazione guidata di OneDrive copia la configurazione dell'app nell'impostazione di Configura gli account Microsoft Entra, così da essere utilizzata per altre integrazioni che potrebbero essere configurate successivamente.

  In OneDrive Setup mentre si esegue l'opzione, viene visualizzato un messaggio simile al testo seguente:

  L'applicazione Microsoft Entra usata per l'autenticazione verrà configurata per tutte le integrazioni di Business Central.

Esegui l'installazione di OneDrive per passare alla nuova integrazione di OneDrive

1. Aprire la pagina OneDrive Setup o la pagina SharePoint Connection Setup.

2. Se si usa la pagina Configurazione di SharePoint, scegliere Vai alla nuova configurazione di OneDrive nella notifica nella parte superiore della pagina.

3. Segui la guida di configurazione guidata OneDrive Setup.

4. Quando arrivi alla pagina Configura gestione file scegli una delle seguenti opzioni per attivare le funzioni:

   Opzione	Description
   Usa per le funzionalità dell'app	Se attivi questa opzione, le azioni Apri in OneDrive e Condividi sono rese disponibili sui file in Business Central, come i file allegati ai documenti o nella Posta in arrivo dei report. Queste azioni consentono agli utenti di copiare, aprire e condividere file in OneDrive. Le funzionalità di Business Central che archiviano o acquisiscono documenti e altri file e offrono le azioni Apri in OneDrive e Condividi per portare quei file fuori da Business Central, come i documenti in entrata e gli allegati dei record. Le funzionalità della linea di business che generano cartelle di lavoro Excel personalizzate, come il budget di vendita. Report inviati in Report elaborati Se hai installato personalizzazioni o estensioni, queste potrebbero aggiungere più funzionalità che utilizzano OneDrive. Per ulteriori informazioni, vedi Apertura e condivisione dei file di Business Central in OneDrive.
   Usa per funzioni del sistema	L'attivazione di questa opzione attiva le seguenti funzionalità: Le azioni Apri in Excel e Modifica in Excel nelle pagine elenco copieranno automaticamente il file Excel in OneDrive, quindi aprilo in Excel Online. Per ulteriori informazioni, vedi Visualizzazione e modifica in Excel. L'invio di un report a un file di Excel o Word copia automaticamente il file in OneDrive, quindi lo aprirà in Excel o Word online. Per ulteriori informazioni, vedi Salvataggio di un report in un file.

5. La pagina Configura Business Central mostra lo stesso URL utilizzato dall'esistente integrazione OneDrive. Se necessario, puoi modificare l'URL.

6. Seleziona Test della connessione e segui le istruzioni.

   Se il test ha esito positivo, seleziona Fatto, e sei pronto per iniziare. In caso contrario, utilizza i messaggi nella pagina per aiutarti a risolvere il problema.

Informazioni pertinenti

Integrazione di Business Central e OneDrive
Aprire file di Business Central in OneDrive
Domande frequenti su OneDrive