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, il collegamento tra Business Central e OneDrive for Business non viene impostato 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 Setup connessione SharePoint.

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

In questa attività aggiungi un'app registrata per Business Central nel tenant Microsoft Entra del tuo piano Microsoft 365. Come altri servizi Azure che lavorano 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, utilizzato da OneDrive.

Per passaggi dettagliati per completare questa attività, vedi 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, devi 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 il secondo ciclo di rilascio di Business Central 2021 (versione 19), imposta queste autorizzazioni:

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

• Se utilizzi Business Central versione 19 o 20, copia l'ID applicazione (client). e il segreto client utilizzati dall'app registrata. Avrai bisogno di queste informazioni nel prossimo compito.

Ottenere l'URL 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 .

Impostare 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 indiretta, modifica ed eliminazione (imd) sulla tabella Scenario di servizio documenti come minimo

Eseguire Setup OneDrive

1. Scegli l'icona , immetti Setup OneDrive, quindi scegli il collegamento correlato.

2. La prima volta che esegui il setup assistito, vedrai il collegamento 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	Descrizione
   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 in Report elaborati. 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à line-of-business che generano cartelle di lavoro Excel personalizzate, ad esempio Budget vendite. 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 funzionalità di 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 Excel o Word copierà automaticamente il file in OneDrive, quindi aprilo in Excel o Word online. Per ulteriori informazioni, vedi Salvataggio di un report in un file.

4. Sulla pagina Configura Business Central immetti l'URL OneDrive nel campo URL OneDrive.

   Come si trova l'URL 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 hai già impostato l'app registrata in Microsoft Entra ID, si apre la guida Impostare Microsoft Entra ID.

6. Una volta completata, l'informativa sulla privacy per l'integrazione OneDrive è concordata per tutti gli utenti. Se vuoi cambiarla in modo che gli utenti debbano essere d'accordo o non essere d'accordo per se stessi, allora vai alla pagina Stato informative sulla privacy e seleziona Consenti all'utente di decidere 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. Per maggiori informazioni, vedi 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. Scegli l'icona , immetti Setup connessione Microsoft SharePoint, quindi scegli il collegamento correlato.

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

3. Nel campo Cartella, inserisci Business Central.

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

   Come si trova l'URL 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 esegui l'aggiornamento alla versione 21 o successiva, la connessione esistente a OneDrive che è configurata nella pagina Setup connessione SharePoint funzionerà ancora. Ma poiché la pagina Setup connessione SharePoint pagina verrà rimossa nella versione 23, ti consigliamo di passare alla nuova integrazione OneDrive, come descritto nella sezione successiva. Fare questo passaggio ora renderà le cose più facili quando il Setup connessione SharePoint viene infine rimosso. Inoltre, ti consentirà di utilizzare la guida al setup assistito Setup OneDrive per gestire le funzionalità OneDrive accessibili agli utenti.

Passaggio da SharePoint legacy alla nuova integrazione OneDrive

Per passare alla nuova integrazione OneDrive, esegui la guida al setup assistito Setup OneDrive che puoi aprire direttamente o dalla pagina legacy Setup connessione SharePoint. Il setup assistito Setup OneDrive ti guida attraverso 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, come 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 utilizzata da questi altri servizi è configurata nel setup assistito Impostazione account Microsoft Entra. Quando passi dalla configurazione della connessione SharePoint legacy, il nuovo setup assistito Setup OneDrive cambia l'integrazione OneDrive per utilizzare anche il setup assistito Impostazione account Microsoft Entra, quindi tutte le integrazioni usano la stessa app Microsoft Entra.

Questa modifica ha implicazioni quando si passa alla nuova integrazione OneDrive, a seconda che sia già presente un'app Microsoft configurata nel setup assistito Impostazione account Microsoft Entra.

Come le modifiche influiscono sull'integrazione

Il setup assistito Setup OneDrive utilizzerà sempre l'app configurata nel setup assistito Impostazione account Microsoft Entra, se presente. Quando esegui il setup assistito Setup OneDrive, confronta l'app configurata in Impostazione account Microsoft Entra con l'app corrente configurata in Setup connessione SharePoint.

• Se l'app in Impostazione account Microsoft Entra è diversa dall'app in Setup connessione SharePoint, l'integrazione OneDrive utilizza l'app in Impostazione account Microsoft Entra.

  In Setup OneDrive mentre effettui il passaggio, viene visualizzato un messaggio simile al seguente testo:

  The Microsoft Entra application used for authentication will be configured for all Business Central integrations. This means the client id will change to NNNNNNNNN-NNNN-NNNN-NNNN-NNNNNNNNNNNN, you may want to test it has the correct permissions.

  NNNNNNNNN-NNNN-NNNN-NNNN-NNNNNNNNNNNN rappresenta l'ID client dell'app in Impostazione account Microsoft Entra che è utilizzata dall'integrazione 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. Puoi eseguire questo passaggio prima o dopo il passaggio al nuovo setup OneDrive. Per ulteriori informazioni, vedi la sezione Registrare un'app in Microsoft Entra ID per l'integrazione OneDrive.

• Se l'app in Impostazione account Microsoft Entra è la stessa app in Setup connessione SharePoint, l'integrazione OneDrive utilizza la stessa app di prima, ad eccezione della configurazione nel setup Impostazione account Microsoft Entra.

  In Setup OneDrive mentre effettui il passaggio, viene visualizzato un messaggio simile al seguente testo:

  The Microsoft Entra application used for authentication will be configured for all Business Central integrations. This has already been configured with the same client id (aaaabbbb-0000-cccc-1111-dddd2222eeee).

• Se non ci sono app configurate nel setup Impostazione account Microsoft Entra l'integrazione OneDrive utilizza la stessa app di prima.

  Il setup assistito Setup OneDrive copia la configurazione dell'app nel setup Impostazione account Microsoft Entra, quindi viene utilizzato per altre integrazioni che potrebbero essere configurate in seguito.

  In Setup OneDrive mentre effettui il passaggio, viene visualizzato un messaggio simile al seguente testo:

  The Microsoft Entra application used for authentication will be configured for all Business Central integrations.

Eseguire il setup OneDrive per passare alla nuova integrazione OneDrive

1. Apri la pagina Setup OneDrive o la pagina Setup connessione SharePoint.

2. Se usi la pagina Setup connessione SharePoint scegli Vai al nuovo setup di OneDrive nella notifica nella parte superiore della pagina.

3. Segui la guida di setup assistito Setup OneDrive.

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

   Opzione	Descrizione
   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 in Report elaborati. 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à line-of-business che generano cartelle di lavoro Excel personalizzate, ad esempio Budget vendite. 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 funzionalità di 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 Excel o Word copierà automaticamente il file in OneDrive, quindi aprilo 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.

Vedere anche

Business Central e integrazione OneDrive
Apertura dei file di Business Central in OneDrive
Domande frequenti su OneDrive