De Business Central-invoegtoepassing voor Excel verkrijgen

Artikel
10/22/2024

Business Central bevat een invoegtoepassing voor Excel waarmee gebruikers een Bewerken in Excel-actie op bepaalde pagina's kunnen selecteren om de gegevens in een Excel-werkblad te openen. Deze actie is anders dan de actie Openen in Excel omdat het gebruikers in staat stelt wijzigingen aan te brengen in Excel en de wijzigingen vervolgens weer te publiceren naar Business Central

Overzicht

Over de invoegtoepassing

De invoegtoepassing heet Microsoft Dynamics Office-invoegtoepassing en is beschikbaar voor installatie vanuit de Office Store (AppSource). Met de invoegtoepassing geïnstalleerd is de actie Bewerken in Excel beschikbaar op de meeste lijst- en lijstonderdeelpagina's vanuit het pictogram Delen . Zie voor meer informatie over het gebruik van de invoegtoepassing Weergeven en bewerken in Excel vanuit Business Central.

Opmerking

De invoegtoepassing werkt alleen onder Windows, niet onder MacOS.

Over implementatie als beheerder

Met Business Central Online zijn er een paar implementatieopties om de invoegtoepassing voor gebruikers te krijgen. Eén optie is individuele acquisitie, waarbij u gebruikers de invoegtoepassing zelf laat installeren. Met deze optie moeten gebruikers toegang hebben tot het downloaden van bestanden uit de Office Store. Een andere optie is om Gecentraliseerde implementatie in te stellen 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 eindgebruiker 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 behulp van 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 hoeven te doen is zich aanmelden bij Business Central

Bij 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 vanuit 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. Zie voor meer informatie De Excel-invoegtoepassing instellen om Business Central-gegevens te bewerken in de Help voor ontwikkelaars en IT Pro.

De invoegtoepassing implementeren met behulp van gecentraliseerde implementatie

Gecentraliseerde implementatie is een functie in het Microsoft 365-beheercentrum die u gebruikt om automatisch invoegtoepassingen te installeren in Office-apps van gebruikers, zoals Excel. Om u te helpen met gecentraliseerde implementatie, bevat Business Central de begeleide instelling Gecentraliseerde implementatie van Excel-invoegtoepassing.

Voordat u begint

Zie voor meer informatie over het voorkomen dat gebruikers downloaden uit de Office Store Invoegtoepassingen beheren in het beheercentrum.
Controleer of gecentraliseerde implementatie werkt voor uw organisatie. Zie voor meer informatie Bepalen of gecentraliseerde implementatie van invoegtoepassingen werkt voor uw organisatie.
Als u overstapt van individuele acquisitie, raadpleegt u voor meer informatie Overschakelen van individuele acquisitie naar gecentraliseerde implementatie.

Notitie

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

Gecentraliseerde implementatie van de invoegtoepassing instellen

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

Kies in Business Central het pictogram , voer Gecentraliseerde implementatie van Excel-invoegtoepassing in en kies vervolgens de gerelateerde koppeling.
Lees de informatie op de pagina Instelling van Excel-invoegtoepassing van Business Central en kies Volgende.
Meld u aan bij het Microsoft 365-beheercentrum en ga naar Geïntegreerde 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 (AppSource) te openen.
2. Zoek Microsoft Dynamics Office-invoegtoepassing en selecteer vervolgens Nu ophalen.
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. Zie Invoegtoepassingen implementeren in het beheercentrum voor meer informatie over het implementeren van invoegtoepassingen in het Microsoft 365-beheercentrum.
Ga terug naar de begeleide instelling Gecentraliseerde implementatie van Excel-invoegtoepassing in Business Central en kies Volgende.
Zet Gecentraliseerde implementatie gebruiken aan en kies Voltooien.

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

Als u klaar bent, kunt u de implementatie altijd wijzigen in het Microsoft 365-beheercentrum, zoals het toewijzen van meer gebruikers. Zie Invoegtoepassingen implementeren in het beheercentrum voor meer informatie over het implementeren van invoegtoepassingen 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 in Microsoft 365 echter niet opnieuw te configureren. 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 de Excel van gebruikers.

Individuele acquisitie: de invoegtoepassing handmatig installeren voor eigen gebruik

In de meeste gevallen, wanneer u Excel opent vanuit Business Central, wordt 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.

Open Excel en open vervolgens een Excel-werkmap.
Op het tabblad Start Invoegtoepassingen>Meer invoegtoepassingen.
Ga naar Door beheerder beheerd en zoek naar Microsoft Dynamics Office-invoegtoepassing. Als u het daar ziet, selecteert u het en kiest u Toevoegen. Als u het niet ziet, gaat u naar Winkel, zoekt u naar Microsoft Dynamics Office-invoegtoepassing en volgt u de instructies op het scherm om het 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:

Kies in het deelvenster van de Microsoft Dynamics-invoegtoepassing in Excel Serverinformatie toevoegen. Als u dit niet ziet, kiest u het pictogram bovenaan om het dialoogvenster met opties te openen.
Stel voor Business Central Online Server-URL in op https://exceladdinprovider.smb.dynamics.com. Stel deze voor Business Central on-premises in op de URL van de webclient, bijvoorbeeld https://myBCserver/240.
Kies OK en bevestig vervolgens dat de app opnieuw wordt geladen.
Meld u wanneer daarom wordt gevraagd, aan met uw Business Central-gebruikersnaam en -wachtwoord.
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 publiceren naar Business Central.

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. Zie voor een lijst met eindpunten Uw netwerk voorbereiden op de Excel-invoegtoepassing.

Problemen oplossen

Soms ondervinden gebruikers problemen met de Excel-invoegtoepassing. Dit gedeelte geeft enkele 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 die gevallen moet de beheerder de invoegtoepassing centraal implementeren. Voor meer informatie zie 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 terug naar Business Central worden gepubliceerd.	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	Excel toont mogelijk tijden en datums in een andere indeling dan Business Central. Dit maakt ze echter niet verkeerd en de gegevens in Business Central blijven intact.
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 worden veroorzaakt door een update die we hebben aangebracht in de invoegtoepassing, ergens in juli 2022. Voor meer informatie en een oplossing, zie De configuratie van de Excel-invoegtoepassing wijzigen om de update van juli 2022 te ondersteunen.	Geldt alleen voor Business Central on-premises
De add-in communiceert via 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.

Bekende beperkingen in bedrijfslogica

Pagina	Beperking	Opmerkingen
Verkooporders	Foutmelding: 'Microsoft Dynamics 365 Business Central Gegevensservices probeert een client-callback te verzenden om scherm 301 Verzendadressenoverzicht als modaal uit te voeren'. Clientcallbacks worden niet ondersteund in Microsoft Dynamics 365 Business Central Gegevensservices.	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 Bewerken in Excel in Business Central gebruikt, door de actie Bewerken in Excel op een pagina te selecteren of wanneer de Excel-invoegtoepassing wordt geladen na het openen van een Excel-werkmap, kan de volgende foutmelding optreden: Metagegevens kunnen niet worden opgehaald voor entiteit <entiteitsnaam> omdat deze niet zijn 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 KlantkaartExtA 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 KlantenkaartExtB 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:

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.
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.

Zie ook

Financiële overzichten analyseren in Microsoft Excel
Werken met Business Central
Verbeteringen aan Excel-integratie in releasewave 2 van 2019

U vindt hier gratis e-learningmodules voor Business Central

Delen via