OneDrive-integratie configureren met Business Central On-Premises
Notitie
Azure Active Directory is nu Microsoft Entra ID. Meer informatie
Dit artikel legt uit hoe u integratie van OneDrive voor werk of school (voorheen bekend als OneDrive voor Bedrijven) instelt met Business Central on-premises. In tegenstelling tot Business Central online wordt de verbinding tussen Business Central en OneDrive niet automatisch tot stand gebracht. Als de verbinding niet is geconfigureerd, kunnen gebruikers de functies niet gebruiken voor OneDrive.
Er zijn twee taken die moeten worden uitgevoerd om de OneDrive-integratie te configureren.
- De eerste taak betreft het registreren van een toepassing (app) op uw Microsoft Entra-tenant van uw Microsoft 365-abonnement. De geregistreerde app wordt gebruikt voor verificatiedoeleinden. Deze taak wordt meestal uitgevoerd in de Azure-portal en in de Business Central-webclient.
- De tweede taak betreft het instellen van de verbinding met de OneDrive-URL en het inschakelen van de OneDrive-functies in Business Central. Deze taak wordt uitgevoerd in de Business Central-webclient. Voor versie 21 wordt dit anders gedaan dan voor versies 19 en 20. Versie 21 introduceert de optie Configuratie van OneDrive waarmee Instellingen SharePoint-verbinding wordt vervangen.
Belangrijk
Business Central on-premises kan alleen worden verbonden met OneDrive gehost door Microsoft in de cloud. Business Central on premises verbinden met de My Sites-opslag van SharePoint Server wordt niet ondersteund.
Registreer een app in Microsoft Entra ID voor OneDrive integratie
In deze taak voegt u een geregistreerde app voor Business Central toe in de Microsoft Entra-tenant van uw Microsoft 365-abonnement. Net als andere Azure-services die werken met Business Central, vereist OneDrive een geregistreerde app in Microsoft Entra ID. De geregistreerde app biedt verificatie- en autorisatieservices tussen Business Central en SharePoint, wat wordt gebruikt door OneDrive.
Gedetailleerde stappen voor het voltooien van stap vindt u in Registreer een applicatie in Microsoft Entra ID de Help voor ontwikkelaars en IT-professionals.
Houd bij het registreren van de toepassing rekening met de volgende punten:
Als u al een toepassing hebt geregistreerd als onderdeel van een integratie met een ander Microsoft-product, zoals Power BI, dan gebruikt u die geregistreerde app opnieuw. In dit geval hoeft u alleen de SharePoint-machtigingen in te stellen voor de bestaande geregistreerde app.
Zorg ervoor dat u de geregistreerde app met de volgende gedelegeerde machtigingen voor de SharePoint-API configureert:
- AllSites.FullControl
- User.ReadWrite.All
Stel in plaats daarvan de volgende machtigingen in voor Business Central 2021 releasewave 2 (versie 19):
- AllSites.Write
- MyFiles.Write
- User.Read.All
Als u Business Central versie 19 of 20 gebruikt, kopieert u Id van toepassing (client) en Clientgeheim die door de geregistreerde app worden gebruikt. U hebt deze informatie nodig bij de volgende taak.
Uw OneDrive-URL ophalen
U hebt een URL nodig om verbinding te kunnen maken met OneDrive vanuit Business Central. De eenvoudigste manier om de URL op te vragen, is door zich aan te melden bij OneDrive voor uw organisatie. In het browseradres ziet u een URL met de volgende indeling:
https://<your Microsoft 365 tenant name>-my.sharepoint.com/personal/<your user name>
Bijvoorbeeld: https://contoso-my.sharepoint.com/personal/rsimone_contoso_onmicrosoft_com.
U hebt niet de hele URL nodig. U gebruikt alleen de portie vóór /personal:
https://<your Microsoft 365 tenant name>-my.sharepoint.com
Bijvoorbeeld: https://contoso-my.sharepoint.com.
Er zijn ook andere manieren om de URL op te vragen. Voor meer informatie zie OneDrive-URL's voor gebruikers in uw organisatie in de OneDrive-documentatie.
De OneDrive-verbinding instellen in versie 21 en later
Gebruik deze procedure als u Business Central 2022 releasewave 2 (versie 21) of hoger gebruikt.
Vereisten
- Minimaal imd-machtiging (indirect, modify, delete) voor tabel Documentservicescenario
Configuratie van OneDrive uitvoeren
Kies het pictogram
, ga naar OneDrive Setup en kies vervolgens de gerelateerde koppelen.De eerste keer dat u de ondersteunde installatie uitvoert, ziet u Uw privacy. Lees de informatie op de pagina, en als u akkoord gaat met de voorwaarden, kiest u Akkoord om door te gaan.
Op de pagina Bestandsverwerking configureren hebt u de volgende opties om uit te kiezen:
Optie Omschrijving gebruik voor app-functies Als u deze optie inschakelt, worden de acties Openen in OneDrive en Delen beschikbaar gemaakt in bestanden in Business Central, zoals bestanden die zijn bijgevoegd bij documenten of in de Rapportinbox. Met deze acties kunnen gebruikers bestanden kopiëren, openen en delen in OneDrive. - Business Central-functies die documenten en andere bestanden opslaan of vastleggen en de acties Openen in OneDrive en Delen bieden om die bestanden uit Business Central op te halen, zoals Inkomende documenten en recordbijlagen.
- Bedrijfsfuncties die aangepaste Excel-werkmappen genereren, zoals verkoopbudgetten.
- Rapporten die worden verzonden naar de Rapportinbox
- Als je aanpassingen of extensies hebt geïnstalleerd, kunnen deze meer functies toevoegen die gebruikmaken van OneDrive.
gebruik voor systeemfuncties Als u deze optie inschakelt, worden de volgende functies geactiveerd: - Met de acties Openen in Excel en Bewerken in Excel op lijstpagina´s wordt het Excel-bestand naar OneDrive gekopieerd en vervolgens in Excel Online geopend. Zie Weergeven en bewerken in Excel voor meer informatie.
- Als u een rapport naar een Excel- of Word-bestand exporteert, wordt het bestand automatisch gekopieerd naar OneDrive en vervolgens geopend in Excel Online of Word Online. Zie Een rapport opslaan in een bestand voor meer informatie.
Op de pagina Business Central configureren voert u de URL van OneDrive in het veld OneDrive-URL in.
Kies Verbinding testen en wacht op de resultaten.
- Als de test slaagt, kiest u Gereed. Dan kunt u aan de slag.
- Als de test mislukt, krijgt u een bericht waarin het probleem wordt beschreven. Meestal heeft het probleem te maken met de URL die u hebt opgegeven. Kies OK om terug te keren naar de pagina Business Central configureren, controleer de URL en probeer het opnieuw.
- Als u de Microsoft Entra ID-geregistreerde app nog niet hebt ingesteld, wordt de Set Up Microsoft Entra ID guide geopend.
Wanneer dit is voltooid, wordt voor alle gebruikers akkoord gegaan met de privacyverklaring voor OneDrive-integratie. Als u dit wilt wijzigen zodat gebruikers zelf al dan niet akkoord moeten gaan, gaat u naar de pagina Status van privacyverklaringen en selecteert u Gebruiker laten beslissen voor de OneDrive-integratie. Gebruikers wordt vervolgens gevraagd om al dan niet akkoord te gaan met de privacyverklaring wanneer ze de OneDrive-functies voor het eerst gebruiken. Zie Privacyverklaringen voor meer informatie.
De verbinding in Business Central instellen in versie 19 en 20
Gebruik deze procedure als u Business Central 2022 releasewave 1 (versie 20) of 2021 releasewave 2 (versie 19) gebruikt.
Belangrijk
Door deze functie te configureren schakelt u ook oudere functies in die bestanden verzenden naar OneDrive.
- De functie Openen in Excel kopieert het Excel-bestand automatisch naar OneDrive en opent het vervolgens in Excel Online.
- Als u een rapport naar een bestand exporteert, wordt het bestand automatisch gekopieerd naar OneDrive en vervolgens geopend in Excel Online, Word Online of OneDrive.
- Andere functies kunnen ook automatisch worden geopend in OneDrive.
Kies het pictogram
, voer Microsoft SharePoint Connection Setup in en kies vervolgens de gerelateerde koppelen.Voer in het veld Omschrijving een omschrijving in voor de verbinding, zoals OneDrive.
Voer in het veld Map Business Central in.
Voer in het veld Locatie de URL in voor uw OneDrive.
Voer in het veld Client-id de client-id van uw geregistreerde app in.
Voer in het veld Clientgeheim het geheim van uw geregistreerde app in.
Belangrijk
De pagina Instellingen SharePoint-verbinding wordt gebruikt om meerdere verouderde functies te configureren. De sectie Algemeen configureert de verbinding met OneDrive en de sectie Gedeelde documenten leidt bestanden om naar SharePoint. De SharePoint-verbindingsinstelling is verouderd en wordt in de komende release verwijderd. We raden u aan de sectie Gedeelde documenten te gebruiken. Zie voor meer informatie Verouderde functies in de basisapp .
Na upgrade naar versie 21
Wanneer u een upgrade uitvoert naar versie 21 of hoger, werkt de bestaande verbinding met OneDrive die is geconfigureerd op de pagina Instellingen SharePoint-verbinding nog steeds. Maar omdat de pagina Instellingen SharePoint-verbinding wordt verwijderd in versie 23, raden we u aan over te schakelen naar de nieuwe OneDrive-integratie, zoals wordt beschreven in het volgende gedeelte. Door deze schakelaar nu aan te zetten, wordt het makkelijker wanneer de SharePoint Connection Setup uiteindelijk wordt verwijderd. Bovendien kunt u de door de OneDrive Setup ondersteunde installatie guide gebruiken om de OneDrive functies te beheren die toegankelijk zijn voor gebruikers.
Overschakelen van oude SharePoint naar nieuwe OneDrive-integratie
Als u wilt overschakelen naar de nieuwe OneDrive-integratie, voert u de begeleide instelling Configuratie van OneDrive uit die u rechtstreeks kunt openen of via de oude pagina Instellingen SharePoint-verbinding. De OneDrive Setup ondersteunde setup begeleidt u door de overgang en biedt informatie over de wijzigingen die onderweg worden aangebracht.
Voordat u aan de slag gaat met de overschakeling of terwijl u dit doet, raadpleegt u het volgende gedeelte voor meer informatie over enkele aspecten en overwegingen over het proces.
Over overschakelen naar de nieuwe OneDrive-integratie
Naast OneDrive-integratie kan Business Central ook worden geïntegreerd met andere services, zoals Power BI en Universeel afdrukken. Integratie met deze andere services vereist ook een geregistreerde Microsoft Entra-app voor verificatie. De Microsoft Entra app die door deze andere services wordt gebruikt, wordt geconfigureerd in de ondersteunde installatie Uw Microsoft Entra accounts instellen . Wanneer u overschakelt van de oude verbindingsconfiguratie, verandert de nieuwe ondersteunde configuratie uw integratie zodat deze ook de ondersteunde configuratie van uw accounts gebruikt. Alle integraties gebruiken dus dezelfde app. SharePoint OneDrive OneDrive Microsoft Entra Microsoft Entra
Deze wijziging heeft gevolgen bij de overstap naar de nieuwe OneDrive integratie, afhankelijk van of er al een Microsoft-app is geconfigureerd in de ondersteunde installatie van Uw Microsoft Entra accounts instellen .
Belangrijk
Nadat u bent overgeschakeld naar de nieuwe OneDrive-instelling, kunt u de pagina Instellingen SharePoint-verbinding niet meer gebruiken om OneDrive-integratie te configureren.
Hoe de wijzigingen van invloed zijn op de integratie
De ondersteunde installatie van OneDrive Setup maakt altijd gebruik van de app die is geconfigureerd in de ondersteunde installatie van Uw Microsoft Entra accounts instellen , indien beschikbaar. Wanneer u de ondersteunde installatie van OneDrive Setup uitvoert, wordt de app die is geconfigureerd in Uw Microsoft Entra accounts instellen vergeleken met uw huidige app die is geconfigureerd in SharePoint Verbindingsinstellingen.
Tip
Op de pagina SharePoint Verbindingsinstellingen en de begeleide installatie Uw Microsoft Entra accounts instellen wordt de Microsoft Entra app geïdentificeerd door de client-ID.
Als de app in Uw Microsoft Entra accounts instellen anders is dan de app in SharePoint Verbinding instellen, verandert de OneDrive integratie om de app in Uw Microsoft Entra accounts instellen te gebruiken.
Tijdens het overschakelen in OneDrive Setup krijgt u een bericht dat lijkt op de volgende tekst:
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-NNNNNNNNNNNNvertegenwoordigt de client-ID van de app in Uw Microsoft Entra accounts instellen waarnaar OneDrive de integratie is overgeschakeld.Belangrijk
Om de nieuwe OneDrive-integratie te laten werken na de overschakeling, moet u de app toestemming geven voor de SharePoint-API in Azure-portal. U kunt deze stap uitvoeren voordat of nadat u overschakelt naar de nieuwe OneDrive-configuratie. Zie het gedeelte Een app registreren in Microsoft Entra ID voor OneDrive integratie voor meer informatie.
Als de app in Uw Microsoft Entra accounts instellen dezelfde is als de app in SharePoint Verbindingsinstellingen, gebruikt de OneDrive integratie dezelfde app als voorheen, behalve de configuratie in de Uw Microsoft Entra accounts instellen instellingen.
Tijdens het overschakelen in OneDrive Setup krijgt u een bericht dat lijkt op de volgende tekst:
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).Als er geen app is geconfigureerd in de instellingen van Uw Microsoft Entra accounts instellen , gebruikt de OneDrive integratie dezelfde app als voorheen.
Met de ondersteunde installatie wordt de app-configuratie gekopieerd naar de installatie van uw accounts, zodat deze kan worden gebruikt voor andere integraties die later worden geïnstalleerd. OneDrive Microsoft Entra
Tijdens het overschakelen in OneDrive Setup krijgt u een bericht dat lijkt op de volgende tekst:
The Microsoft Entra application used for authentication will be configured for all Business Central integrations.
Configuratie van OneDrive uitvoeren om over te schakelen naar de nieuwe OneDrive-integratie
Open de pagina Configuratie van OneDrive of de pagina Instellingen SharePoint-verbinding.
Als u de pagina Instellingen SharePoint-verbinding gebruikt, kiest u Ga naar nieuw OneDrive-instelling in de melding bovenaan de pagina.
Volg de begeleide instelling Configuratie van OneDrive.
Wanneer u bij de pagina Bestandsverwerking configureren komt, kiest u een van de volgende opties om functies in te schakelen:
Optie Omschrijving gebruik voor app-functies Als u deze optie inschakelt, worden de acties Openen in OneDrive en Delen beschikbaar gemaakt in bestanden in Business Central, zoals bestanden die zijn bijgevoegd bij documenten of in de Rapportinbox. Met deze acties kunnen gebruikers bestanden kopiëren, openen en delen in OneDrive. - Business Central-functies die documenten en andere bestanden opslaan of vastleggen en de acties Openen in OneDrive en Delen bieden om die bestanden uit Business Central op te halen, zoals Inkomende documenten en recordbijlagen.
- Bedrijfsfuncties die aangepaste Excel-werkmappen genereren, zoals verkoopbudgetten.
- Rapporten die worden verzonden naar de Rapportinbox
- Als je aanpassingen of extensies hebt geïnstalleerd, kunnen deze meer functies toevoegen die gebruikmaken van OneDrive.
gebruik voor systeemfuncties Als u deze optie inschakelt, worden de volgende functies geactiveerd: - Met de acties Openen in Excel en Bewerken in Excel op lijstpagina´s wordt het Excel-bestand naar OneDrive gekopieerd en vervolgens in Excel Online geopend. Zie Weergeven en bewerken in Excel voor meer informatie.
- Als u een rapport naar een Excel- of Word-bestand exporteert, wordt het bestand automatisch gekopieerd naar OneDrive en vervolgens geopend in Excel Online of Word Online. Zie Een rapport opslaan in een bestand voor meer informatie.
De pagina Business Central configureren bevat dezelfde URL die wordt gebruikt door de bestaande OneDrive-integratie. U kunt de URL indien nodig wijzigen.
Selecteer Verbinding testen en volg de instructies.
Als de test slaagt, selecteert u Gereed. Dan kunt u aan de slag. Gebruik anders de berichten op de pagina om u te helpen het probleem op te lossen.
Zie ook
Business Central en OneDrive integratie
Business Central-bestanden openen in OneDrive
OneDrive Veelgestelde vragen