Delen via

De Business Central-invoegtoepassing voor Excel downloaden

Business Central bevat een invoegtoepassing voor Excel waarmee gebruikers de actie Bewerken in Excel kunnen selecteren om de gegevens in een Excel-werkblad te openen. Deze actie verschilt van Openen in Excel omdat gebruikers wijzigingen in Excel kunnen aanbrengen en die wijzigingen vervolgens terug naar Business Central kunnen publiceren.

Overzicht

Over de invoegtoepassing

De invoegtoepassing heet Microsoft Dynamics Office-invoegtoepassing en is beschikbaar voor installatie vanuit de Office Store (Marketplace). Met de invoegtoepassing geïnstalleerd is de actie Bewerken in Excel beschikbaar op de meeste lijst- en lijstonderdeelpagina's vanuit het pictogram DelenEen pagina in een andere app delen.. Meer informatie over het gebruik van de invoegtoepassing op Weergave en bewerken in Excel vanuit Business Central.

Opmerking

De invoegtoepassing werkt alleen op Windows.

Over implementatie als beheerder

Met Business Central online zijn er verschillende implementatie-opties om de invoegtoepassing beschikbaar te maken voor gebruikers. Eén optie is individuele acquisitie, waarbij gebruikers de invoegtoepassing zelf installeren. Met deze optie moeten gebruikers toegang hebben tot het downloaden van bestanden uit de Office Store. Een andere optie is het instellen van Centralized Deployment in het Microsoft 365-beheercentrum om de invoegtoepassing automatisch te implementeren voor uw hele organisatie, groepen of specifieke gebruikers. Gecentraliseerde implementatie biedt een manier om de invoegtoepassing voor gebruikers te krijgen als uw organisatie gebruikers geen toegang geeft tot de Office Store.

Voor de gebruiker is de installatie-ervaring verschillend voor de twee implementatiescenario's:

  • Met individuele acquisitie wordt de eerste keer dat gebruikers de actie Bewerken in Excel kiezen het deelvenster Nieuwe Office-invoegtoepassing geopend in Excel. Om de invoegtoepassing te installeren kiest de gebruiker Deze invoegtoepassing vertrouwen, waardoor de invoegtoepassing rechtstreeks vanuit de Office Store wordt geïnstalleerd. Gebruikers melden zich vervolgens aan bij Business Central met hun gebruikersnaam en wachtwoord.

  • Met gecentraliseerde implementatie wordt de invoegtoepassing, wanneer gebruikers voor het eerst voor de actie Bewerken in Excel kiezen, automatisch geïnstalleerd in Excel vanuit gecentraliseerde implementatie; niet vanuit de Office Store. Het enige wat gebruikers moeten doen, is zich aanmelden bij Business Central.

Met beide implementatieopties wordt de invoegtoepassing automatisch geconfigureerd om verbinding te maken met Business Central. Een derde implementatieoptie is een handmatige installatie van de invoegtoepassing rechtstreeks vanuit Excel. Met deze optie moeten gebruikers de invoegtoepassing configureren om verbinding te maken met Business Central.

Overschakelen van individuele acquisitie naar gecentraliseerde implementatie of andersom

Wanneer u overstapt van individuele acquisitie van de invoegtoepassing naar gecentraliseerde implementatie, of vice versa, heeft dit gevolgen voor Excel-bestanden die gebruikers vóór de overgang hebben gemaakt. Na de overgang kunnen gebruikers nog steeds Excel-werkbladen openen die eerder zijn gemaakt met de Bewerken in Excel-actie of die handmatig zijn gemaakt, door de Excel-invoegtoepassing te configureren. Maar ze kunnen de gegevens in het bestand niet bijwerken van Business Central of updates naar Business Central pushen.

Dit komt doordat elk Excel-bestand een 'invoegtoepassing'-id krijgt toegewezen. Bij de overgang van of naar gecentraliseerde implementatie wordt een andere id toegewezen, waardoor de eerdere id wordt geblokkeerd.

Voorbereiding (alleen voor on-premises)

Business Central on-premises vereist dat uw omgeving is geconfigureerd voor de invoegtoepassing. Zo niet, dan is de actie Bewerken in Excel niet beschikbaar voor gebruikers. Meer informatie vindt u in Het instellen van de Business Central-invoegtoepassing voor Excel in Business Central lokaal in de help voor ontwikkelaars en IT-professionals.

De invoegtoepassing implementeren met behulp van gecentraliseerde implementatie

Gecentraliseerde implementatie is een functie in het Microsoft 365-beheercentrum dat u gebruikt om invoegtoepassingen automatisch te installeren in office-apps van gebruikers, zoals Excel. Voor hulp bij gecentraliseerde implementatie bevat Business Central de Excel-invoegtoepassing Gecentraliseerde implementatie ondersteund instellen.

Voordat u begint

Opmerking

Het inschakelen van gecentraliseerde implementatie is van invloed op functies die gebruikmaken van de Excel-invoegtoepassing, zoals de actie Bewerken in Excel. Dit heeft geen invloed op andere excel-gerelateerde functies of machtigingen die zijn toegewezen aan gebruikers in Business Central.

Gecentraliseerde implementatie van de invoegtoepassing instellen

In deze taak werkt u in zowel Business Central als het Microsoft 365-beheercentrum.

  1. Selecteer in Business Central Search (Alt+Q) in de rechterbovenhoek, voer Excel-invoegtoepassing Gecentraliseerde implementatie in en kies vervolgens de gerelateerde koppeling.

  2. Lees de informatie op de pagina Business Central invoegtoepassingen van Excel en kies Volgende.

  3. Meld u aan bij het Microsoft 365-beheercentrum en ga naar Integrated Apps.

    Voer de volgende stappen uit om de invoegtoepassing te configureren voor implementatie vanuit de Office Store:

    1. Kies Apps downloaden om de Office Store (Marketplace) te openen.

    2. Zoek Microsoft Dynamics Office-invoegtoepassing en selecteer Get it now.

    3. Geef op de pagina Gebruikers toevoegen de gebruikers op voor wie u de invoegtoepassing wilt implementeren en kies Volgende.

    4. Bekijk de verzoeken om machtigingen te accepteren en kies dan Volgende>Implementatie voltooien.

    5. Wacht tot het groene vinkje naast Geïmplementeerd verschijnt voor de invoegtoepassing en kies vervolgens Gereed.

      De invoegtoepassing verschijnt op de pagina Invoegtoepassingen. Meer informatie over het implementeren van invoegtoepassingen in het Microsoft 365-beheercentrum in Deploy-invoegtoepassingen in het beheercentrum.

  4. Ga terug naar Excel Add-in Centralized Deployment naar de begeleide installatie in Business Central en kies Volgende.

  5. Zet Gecentraliseerde implementatie gebruiken aan en kies Voltooien.

    Als u deze schakelaar niet aanzet, haalt Business Central de invoegtoepassing rechtstreeks uit de Office Store.

Wanneer u klaar bent, kunt u de implementatie altijd wijzigen in het Microsoft 365-beheercentrum, zoals het toewijzen van meer gebruikers. Meer informatie over het implementeren van invoegtoepassingen in het beheercentrum op Invoegtoepassingen implementeren in het beheercentrum.

Belangrijk

Als u meer dan één omgeving hebt, moet u de begeleide instelling Gecentraliseerde implementatie van Excel-invoegtoepassing uitvoeren in elke omgeving waarin u gecentraliseerde implementatie wilt gebruiken. U hoeft de gecentraliseerde implementatie echter niet opnieuw te configureren in Microsoft 365. Het enige wat u hoeft te doen, is de schakelaar Gecentraliseerde implementatie gebruiken aanzetten in de begeleide instelling.

Opmerking

Het kan tot 24 uur duren voordat gebruikers de invoegtoepassing automatisch implementeren in Excel voor gebruikers.

Individuele acquisitie: de invoegtoepassing handmatig installeren voor eigen gebruik

In de meeste gevallen wordt, wanneer u Excel opent vanuit Business Central, de invoegtoepassing automatisch voor u geïnstalleerd of wordt u gevraagd deze te installeren. Er kunnen echter gevallen zijn waarin u de invoegtoepassing handmatig moet installeren.

  1. Open Excel en open vervolgens een Excel-werkmap.
  2. Selecteer Invoegtoepassingen op het tabblad Start en vervolgens Meer invoegtoepassingen.
  3. Ga naar Admin managed en zoek Microsoft Dynamics Office-invoegtoepassing. Als de optie beschikbaar is, selecteert u deze en kiest u Vervolgens Toevoegen. Als de optie niet beschikbaar is, gaat u naar Store en zoekt u naar Microsoft Dynamics Office-invoegtoepassing en volgt u de instructies om deze toe te voegen.

Wanneer de invoegtoepassing is geïnstalleerd, wordt deze weergegeven als een deelvenster in Excel. Configureer vervolgens de verbinding.

De Business Central-verbinding configureren

Als een gebruiker niet automatisch verbinding kan maken, kunt u de blokkering opheffen door hem of haar te vragen deze stappen te volgen:

  1. Kies in het deelvenster Microsoft Dynamics in Excel Serverinformatie toevoegen. Als de optie niet beschikbaar is, kiest u de knop Meer opties in Excel. Pictogram bovenaan om het dialoogvenster Opties te openen.
  2. Voor Business Central online stelt u Server-URL in op https://exceladdinprovider.smb.dynamics.com. Voor Business Central on-premises stelt u deze in op de URL van de webclient, zoals https://myBCserver/240.
  3. Kies OK en bevestig vervolgens dat de app opnieuw wordt geladen.
  4. Meld u aan met uw Business Central gebruikersnaam en wachtwoord wanneer u hierom wordt gevraagd.
  5. Kies desgewenst de omgeving en het bedrijf waarmee u verbinding wilt maken.

De invoegtoepassing is nu verbonden met Business Central en u kunt gegevens bewerken en de wijzigingen naar Business Central publiceren.

Apparaten en netwerk voorbereiden voor de Excel-invoegtoepassing

Netwerkservices zoals proxy's of firewalls moeten routering toestaan tussen elk clientapparaat waarop de invoegtoepassing is geïnstalleerd en vele service-eindpunten. Ga voor een lijst met eindpunten naar Uw netwerk voorbereiden op de Excel-invoegtoepassing.

Problemen oplossen

Soms ondervinden gebruikers problemen met de Excel-invoegtoepassing. Dit gedeelte geeft tips voor het deblokkeren van gebruikers in bepaalde omstandigheden.

Probleem Oplossing of tijdelijke oplossing Opmerkingen
De invoegtoepassing start niet.

De gebruiker krijgt bijvoorbeeld het bericht "Waarschuwing over invoegtoepassing: deze invoegtoepassing is niet meer beschikbaar" wanneer de gebruiker de invoegtoepassing probeert te gebruiken. Dit specifieke probleem kan optreden als gecentraliseerde implementatie correct is geconfigureerd, maar de gebruiker geen toegang heeft gekregen.		 Controleer of de invoegtoepassing centraal wordt geïmplementeerd. Of controleer of de gebruiker is geblokkeerd tegen lokale installatie. De beheerder kan Office zo configureren dat gebruikers geen invoegtoepassingen kunnen verkrijgen. In dat geval moet de beheerder de invoegtoepassing centraal implementeren. Meer informatie vindt u in Invoegtoepassingen implementeren in het beheercentrum.
Gegevens worden niet in Excel geladen. Test de verbinding door een andere lijst in Excel te openen vanuit Business Central. Of open de werkmap in Excel in een browser. Als de gebruiker een bedrijfsnaam heeft opgegeven die speciale tekens bevat, kan de invoegtoepassing geen verbinding maken.
Gegevens kunnen niet opnieuw worden gepubliceerd naar Business Central. Test de verbinding door de werkmap in Excel in een browser te openen. Soms kan een extensie de publicatietaak blokkeren. Als de pagina is uitgebreid of aangepast, verwijdert u de extensies en probeert u het opnieuw.
De datums zijn fout. In Excel kunnen tijden en datums in een andere indeling worden weergegeven dan Business Central. Deze voorwaarde maakt ze niet verkeerd en de gegevens in Business Central worden niet verpest.
Voor sommige lijstpagina's veroorzaakt het bewerken van meerdere regels in Excel consequent fouten. Dit kan optreden als OData-aanroepen FlowFields en velden buiten het repeaterbesturingselement bevatten. Selecteer op de pagina Webservices de selectievakjes Niet-bewerkbare FlowFields uitsluiten en Velden buiten de repeater uitsluiten voor de gepubliceerde pagina. Door deze selectievakjes in te schakelen worden niet-bewerkbare FlowFields en velden uitgesloten van de eTag-berekening. Deze selectievakjes zijn standaard verborgen. Om ze te laten zien op de pagina Webservices, gebruikt u personalisatie.
Gebruikers kunnen niet langer inloggen op de invoegtoepassing. Wanneer ze proberen in te loggen, stopt het proces zonder te voltooien. Dit probleem kan optreden vanwege een update die we hebben aangebracht in de invoegtoepassing. Meer informatie vindt u in De configuratie van de Excel-invoegtoepassing wijzigen ter ondersteuning van de update van juli 2022. Alleen van toepassing op Business Central on-premises.
De invoegtoepassing communiceert met behulp van de API v2.0 voor Dynamics 365 Business Central en eventuele beperkingen van deze API worden automatisch overgenomen. Een voorbeeld van een beperking is dat u een lijst probeert te bewerken en dat de onderliggende kaart bijvoorbeeld een bevestigingsdialoogvenster in zijn AL-logica gebruikt als validatielogica. Soms valt er niets te doen omdat het een ontwerpkeuze is dat de gebruiker de wijziging expliciet moet bevestigen. Als de bevestiging te verwaarlozen is bij het gebruik van Bewerken in Excel, kunt u de aanroep van het bevestigingsdialoogvenster omsluiten met een voorwaardelijke if-instructie die controleert of het clienttype verschilt van ODataV4. bijvoorbeeld if SESSION.CurrentClientType() <> ClientType::ODataV4 then. Mogelijk zijn er andere clients waarvan u het bevestigingsvenster wilt verwijderen, zoals OData en SOAP.
Wanneer u Bewerken in Excel kiest, wordt het volgende bericht weergegeven: 'Bepaalde filters die op de pagina zijn toegepast, zijn niet beschikbaar in Office, zodat er meer rijen worden weergegeven in vergelijking met Business Central. Verwijderde filters: ...". Als het verwijderde filter van toepassing is op een veld dat u hebt toegevoegd via een AL-extensie, moet u ervoor zorgen dat de naam van het paginaveld en de naam van het onderliggende tabelveld identiek zijn. Voor het paginaveld field("Customer Name", Rec."Customer Name")moet de tabelveldnaam Klantnaam bijvoorbeeld zijn field(1; "Customer Name"; Text). Als het verwijderde filter betrekking heeft op een veld dat microsoft of een niet-Microsoft-leverancier bezit, zelfs als het filter wordt verwijderd in Business Central is het mogelijk nog steeds beschikbaar op het filtertabblad van Office-invoegtoepassing. Het nadeel hiervan is dat het elke keer handmatig moet worden toegepast. Neem contact op met de eigenaar van de extensie als u de velden waar u geen controle over heeft permanent wilt herstellen.

Bekende beperkingen in bedrijfslogica

Pagina Beperking Opmerkingen
Verkooporders Foutbericht: 'Microsoft Dynamics 365 Business Central Data Services heeft geprobeerd een client-callback uit te voeren om pagina 301 Verzendadreslijst als een modale weergave uit te voeren.' Client callbacks worden niet ondersteund in Microsoft Dynamics 365 Business Central Data Services. De Verzendcode op de pagina Verkooporder kan alleen worden bewerkt met specifieke verzendopties. Als u Alternatief verzendadres instelt op Verzenden naar, wordt het modale dialoogvenster Verzendadressenoverzicht geopend. Dit dialoogvenster is niet compatibel met Bewerken in Excel.
Projectdagboek Bijwerken van het veld Eenheidsprijs leidt niet tot een update van het Regelbedrag. In plaats daarvan wordt Regelkorting bijgewerkt. Met de webclient kunt u velden in elke gewenste volgorde bijwerken: prijs, bedrag, regelkorting. Overige velden worden automatisch bijgewerkt. Om schuivende updates te voorkomen beschikken de velden over geavanceerde logica die afhankelijk is van xRec. Dit gedraagt zich anders wanneer het via API's wordt aangeroepen.

Bekende beperkingen bij het genereren van metagegevens

Wanneer u Edit in Excel in Business Central gebruikt, selecteert u de actie Edit in Excel op een pagina of wanneer de Excel-invoegtoepassing wordt geladen nadat u een Excel-werkmap hebt geopend, Mogelijk treedt de volgende fout op: Metadata kan niet worden opgehaald voor entiteit <entiteitsnaam> omdat deze niet is gevonden.

Deze fout treedt op wanneer de pagina die u probeert te wijzigen, te complex wordt voor Bewerken in Excel om deze effectief te verwerken. De voornaamste oorzaak is de installatie van meerdere extensies die velden met identieke veldnamen toevoegen aan dezelfde bovenliggende pagina, wat tot conflicten leidt. Het is ook mogelijk dat één enkele extensie het genereren van metagegevens blokkeert.

Enkele extensie blokkeert het maken van metadata

Beschouw het volgende scenario met betrekking tot extensie A, die de pagina-extensie CustomerCardExtA bevat en pagina WebViewerA waar PageType = CardPart.

Wanneer metagegevens worden gegenereerd voor de pagina Klantkaart, evalueert het algoritme elk afzonderlijk veld, inclusief de velden die door extensies zijn toegevoegd. Als extensie A echter is geïnstalleerd, mislukt dit proces omdat WebViewerA niet dezelfde brontabel deelt als de pagina Klantkaart.

Om dit probleem op te lossen, moet u een eigenschap KlantSourceTable aan de pagina WebViewerA toevoegen. Een voorbeeld van deze wijziging is te zien in de codefragmenten die CustomerCardExtB en WebViewerB bevatten.

In sommige gevallen moet u de CardPart op meerdere pagina's insluiten zonder te verwijzen naar een specifieke brontabel. Voor dergelijke scenario's raden wij aan een aparte CardPart te maken voor elke pagina waar u ook metagegevens moet genereren en de gedeelde logica moet herstructureren in een codeunit.

pageextension 50120 CustomerCardExtA extends "Customer Card"
{
    layout
    {
        addlast(content)
        {
            part("Bing WebViewer"; "WebViewer")
            {
                ApplicationArea = All;
            }
        }
    }
}

page 50120 "WebViewerA"
{
    ApplicationArea = All;
    Caption = 'WebViewer', Locked = true;
    PageType = CardPart;

    layout
    {
        area(Content)
        {
            usercontrol(WebViewer; WebPageViewer)
            {
                #region ControlAddInReady
                trigger ControlAddInReady(callbackUrl: Text)
                begin
                    CurrPage.WebViewer.Navigate('https://www.bing.com')
                end;
                #endregion ControlAddInReady
            }
        }
    }
}

pageextension 50120 CustomerCardExtB extends "Customer Card"
{
    layout
    {
        addlast(content)
        {
            part("Bing WebViewer"; "WebViewer")
            {
                ApplicationArea = All;
            }
        }
    }
}

page 50120 "WebViewerB"
{
    ApplicationArea = All;
    Caption = 'WebViewer', Locked = true;
    PageType = CardPart;
    SourceTable = Customer;

    layout
    {
        area(Content)
        {
            usercontrol(WebViewer; WebPageViewer)
            {
                #region ControlAddInReady
                trigger ControlAddInReady(callbackUrl: Text)
                begin
                    CurrPage.WebViewer.Navigate('https://www.bing.com')
                end;
                #endregion ControlAddInReady
            }
        }
    }
}

Meerdere extensies veroorzaken botsingen

Om dit probleem op te lossen zijn er twee mogelijke oplossingen:

  1. Extensies uitschakelen: om te bepalen welke extensie het conflict veroorzaakt, kunt u de extensies die invloed hebben op de pagina, één voor één uitschakelen. Deze aanpak is echter mogelijk niet ideaal als de betreffende extensies noodzakelijk zijn voor uw bedrijfsprocessen.

  2. Extensiecode wijzigen: deze oplossing houdt in dat de hoofdoorzaak van het probleem wordt geanalyseerd en dat dit wordt opgelost door de code van de conflicterende extensies aan te passen.

Om dit probleem beter te begrijpen kunt u het volgende voorbeeld bekijken met betrekking tot de pagina Klantkaart (ID 21). Als u op de pagina Klantenoverzicht (ID 22) bent en Bewerken in Excel selecteert, wordt op de achtergrond een webservice gegenereerd die de velden van de pagina Klantkaart beschikbaar maakt. Deze webservice omvat alle paginavelden die zijn gedefinieerd op de pagina Klantkaart, terwijl tabelvelden alleen worden weergegeven als ze overeenkomen met een paginaveld of deel uitmaken van de primaire sleutel.

Wanneer er een extensie wordt geïnstalleerd die de pagina Klantkaart uitbreidt, worden de velden die door de extensie zijn toegevoegd ook weergegeven in de webservice. Hoewel extensies geen paginavelden kunnen maken met dezelfde namen als de velden die al op de pagina Klantkaart staan, kunnen er nog steeds conflicten ontstaan wanneer meerdere extensies velden met identieke namen toevoegen.

Stel dat de volgende extensie, aangeduid als A, is geïnstalleerd:

using Microsoft.Sales.Customer;

// Extension A
pageextension 50101 CustomerCardExtA extends "Customer Card"
{
    layout
    {
        addLast(General)
        {
            field("ShoeSize"; Rec.ShoeSize)
            {
                ApplicationArea = ALL;
                Caption = 'ShoeSize';
            }
        }
    }
}

tableextension 50101 CustomerTableExtension extends Customer
{
    fields
    {
        field(50100; ShoeSize; Integer) { }
    }
}

Stel nu voor dat er een andere extensie, B, is geïnstalleerd, die ook de pagina Klantkaart wijzigt:

using Microsoft.Sales.Customer;

// Extension B
pageextension 50102 CustomerCardExtB extends "Customer Card"
{
    layout
    {
        addLast(General)
        {
            field("ShoeSize"; Rec.ShoeSizeField)
            {
                ApplicationArea = ALL;
                Caption = 'ShoeSize';
            }
        }
    }
}

tableextension 50102 CustomerTableExtension extends Customer
{
    fields
    {
        field(50105; ShoeSizeField; Integer) { }
    }
}

In dit scenario voegen zowel extensie A als B een paginaveld met de naam ShoeSize toe aan de pagina Klantkaart . Deze situatie resulteert in een conflict, wat leidt tot een fout bij het genereren van metagegevens voor de pagina Klantkaart.

Om dit probleem op te lossen moet u toegang hebben tot de code van ten minste één van de extensies. Vervolgens moet u de conflicterende paginaveldnamen aanpassen om conflicten te voorkomen.

Analyse van jaarrekeningen in Microsoft Excel
Werk met Business Central
Verbeteringen aan Excel-integratie in releasewave 2 van 2019

Vind gratis e-learningmodules voor Business Central hier

  • Last updated on