Das Business Central-Add-in für Excel abrufen

Artikel
10/21/2024

Business Central enthält ein Add-in für Excel, mit dem Benutzer auf bestimmten Seiten eine Aktion In Excel bearbeiten auswählen können, um die Daten in einem Excel-Arbeitsblatt zu öffnen. Diese Aktion unterscheidet sich von der Aktion In Excel öffnen, denn sie erlaubt den Benutzenden, Änderungen in Excel vorzunehmen und diese dann wieder in Business Central zu veröffentlichen

Übersicht

Über das Add-in

Das Add-in heißt Microsoft Dynamics Office Add-in und kann über den Office Store (AppSource) installiert werden. Wenn das Add-in installiert ist, ist die Aktion In Excel bearbeiten auf den meisten Listen- und Listenteilseiten über das Symbol Freigeben icon verfügbar. Weitere Informationen zur Verwendung des Add-Ins finden Sie unter Anzeigen und Bearbeiten in Excel von Business Central.

Hinweis

Das Add-In funktioniert nur unter Windows, nicht unter macOS.

Über das Bereitstellen als Admin

Mit Business Central Online gibt es einige Bereitstellungsoptionen, um das Add-In für die Benutzer bereitzustellen. Eine Option ist der individuelle Erwerb, bei dem Sie die Benutzer das Add-In selbst installieren lassen. Bei dieser Option müssen die Benutzer Zugriff auf das Herunterladen von Dateien aus dem Office Store haben. Eine andere Möglichkeit ist, die Zentrale Bereitstellung im Microsoft 365 Admin Center festzulegen, um das Add-In automatisch für Ihr gesamtes Unternehmen, für Gruppen oder für bestimmte Benutzer bereitzustellen. Die zentrale Bereitstellung bietet eine Möglichkeit, das Add-in den Benutzern zur Verfügung zu stellen, wenn Ihr Unternehmen den Benutzern keinen Zugriff auf den Office Store gewährt.

Für den Endbenutzer stellt sich die Installation in den beiden Bereitstellungsszenarien unterschiedlich dar:

Bei der Einzelerfassung wählen die Benutzer zum ersten Mal die Aktion In Excel bearbeiten und das Fenster Neues Office Add-in wird in Excel geöffnet. Um das Add-in zu installieren, wählt der Benutzer Diesem Add-in vertrauen, was wiederum das Add-in direkt aus dem Office Store installiert. Der Benutzer meldet sich dann mit seinem Benutzernamen und Kennwort bei Business Central an.
Bei der zentralen Bereitstellung wird das Add-in bei der ersten Auswahl der Aktion In Excel bearbeiten automatisch aus der zentralen Bereitstellung in Excel installiert, nicht aus dem Office Store. Benutzer müssen sich nur bei Business Central anmelden.

Bei beiden Bereitstellungsoptionen wird das Add-In automatisch so konfiguriert, dass es eine Verbindung zu Business Central herstellt. Eine dritte Bereitstellungsoption ist eine manuelle Installation des Add-Ins direkt aus Excel. Bei dieser Option müssen die Benutzenden das Add-In so konfigurieren, dass es eine Verbindung zu Business Central herstellt

Wechsel von der individuellen Erfassung zur zentralen Bereitstellung oder andersherum

Wenn Sie vom Einzelerwerb des Add-Ins zur zentralen Bereitstellung oder umgekehrt wechseln, sind Excel-Dateien betroffen, die Benutzer vor dem Übergang erstellt haben. Nach der Umstellung können Benutzer weiterhin alle Excel-Arbeitsblätter öffnen, die zuvor mit der Aktion In Excel bearbeiten erstellt wurden oder die manuell durch die Konfiguration des Excel-Add-Ins erstellt wurden. Aber sie können die Daten in der Datei nicht von Business Central aus aktualisieren oder Aktualisierungen an Business Central senden.

Dieser Zustand wird dadurch verursacht, dass jeder Excel-Datei eine „Add-In“-Kennung zugewiesen wird. Beim Übergang zur oder von der zentralen Bereitstellung wird eine andere Kennung zugewiesen, sodass die frühere Kennung blockiert wird.

Vorbereitung (nur on-premises)

Business Central On-Premises setzt voraus, dass Ihre Umgebung für das Add-In konfiguriert ist. Ist dies nicht der Fall, steht die Aktion In Excel bearbeiten den Benutzenden nicht zur Verfügung. Weitere Informationen finden Sie unter Einrichten des Excel-Add-Ins zum Bearbeiten von Business Central-Daten in der Hilfe für Entwicklungsfachkräfte und IT-Profis.

Bereitstellen des Add-Ins mit Hilfe der zentralen Bereitstellung

Die zentrale Bereitstellung ist eine Funktion im Microsoft 365 Admin Center, mit der Sie Add-Ins automatisch in den Office-Apps der Benutzer, z. B. Excel, bereitstellen können. Um Ihnen bei der zentralen Bereitstellung zu helfen, enthält Business Central die unterstützte Einrichtung für die zentrale Bereitstellung des Excel-Add-Ins.

Bevor Sie beginnen

Informationen dazu, Sie Benutzenden am Herunterladen aus dem Office Store hindern können, finden Sie in Add-ins im Admin Center verwalten.
Vergewissern Sie sich, dass die zentrale Bereitstellung in Ihrer Organisation funktioniert. Weitere Informationen finden Sie unter Bestimmen Sie, ob die zentrale Bereitstellung von Add-Ins für Ihr Unternehmen geeignet ist.
Wenn Sie von der individuellen Erfassung zur zentralen Bereitstellung umstellen, finden Sie unter Umstellung von der individuellen Erfassung zur zentralen Bereitstellung weitere Informationen.

Notiz

Die Aktivierung der zentralen Bereitstellung wirkt sich auf Funktionen aus, die das Excel-Add-In verwenden, wie z.B. die Bearbeiten in Excel Aktion. Sie hat keine Auswirkungen auf andere Excel-bezogene Funktionen und Berechtigungen, die Benutzern in Business Central zugewiesen sind.

Zentrale Bereitstellung des Add-Ins festlegen

Bei dieser Aufgabe arbeiten Sie sowohl in Business Central als auch im Microsoft 365 Admin Center.

Wählen Sie in Business Central das Symbol aus, geben Sie Excel Add-In Zentrale Bereitstellung ein und wählen Sie dann den entsprechenden Link aus.
Lesen Sie die Informationen auf der Seite Einrichtung des Business Central-Add-in für Excel und wählen Sie Weiter.
Melden Sie sich beim Microsoft 365 Admin Center an, und wechseln Sie zu Integrierte Apps.

Führen Sie die folgenden Schritte aus, um das Add-in so zu konfigurieren, dass es aus dem Office Store bereitgestellt wird:
1. Wählen Sie Apps holen, um den Office Store zu öffnen (AppSource).
2. Suchen Sie nach Microsoft Dynamics Office Add-in, und wählen Sie dann Jetzt holen.
3. Geben Sie auf der Seite Benutzer hinzufügen die Benutzer an, für die Sie das Add-In bereitstellen möchten, und wählen Sie dann Weiter aus.
4. Überprüfen Sie die Seite Anforderungen für Berechtigungen akzeptieren und wählen Sie dann Weiter>Einsatz fertig stellen.
5. Warten Sie, bis das grüne Häkchen neben Bereitgestellt für das Add-In erscheint, und wählen Sie dann Erledigt.
  
  Das Add-In erscheint auf der Seite Add-ins. Weitere Informationen über das Bereitstellen von Add-Ins im Microsoft 365 Admin Center finden Sie unter Einsatz von Add-Ins im Admin Center.
Gehen Sie zurück zur unterstützten Einrichtung für die zentrale Bereitstellung des Excel-Add-Ins in Business Central, und wählen Sie Weiter aus.
Aktivieren Sie Zentrale Bereitstellung verwenden und wählen Sie Fertigstellen.

Wenn Sie diesen Umschalter nicht einschalten, ruft Business Central das Add-In direkt über den Office Store ab.

Wenn Sie fertig sind, können Sie die Bereitstellung im Microsoft 365 Admin Center jederzeit ändern, z. B. weitere Benutzer zuweisen. Weitere Informationen zur Bereitstellung von Add-Ins im Admin Center finden Sie unter Add-Ins im Admin Center bereitstellen.

Wichtig

Wenn Sie über mehr als eine Umgebung verfügen, müssen Sie die unterstützte Einrichtung Excel Add-in Zentrale Bereitstellung in jeder Umgebung ausführen, in der Sie die zentrale Bereitstellung verwenden möchten. Sie müssen die zentrale Bereitstellung in Microsoft 365 jedoch nicht erneut konfigurieren. Sie müssen lediglich den Schalter Zentrale Bereitstellung bereitstellen in der unterstützten Einrichtung aktivieren.

Hinweis

Es kann bis zu 24 Stunden dauern, bis das Add-In automatisch in Excel von Benutzern bereitgestellt wird.

Individuelle Übernahme: Installieren Sie das Add-In manuell für Ihren eigenen Gebrauch

Wenn Sie Excel von Business Central aus öffnen, wird das Add-in meistens entweder automatisch für Sie installiert oder Sie werden aufgefordert, es zu installieren. Es kann jedoch Fälle geben, in denen Sie das Add-in manuell installieren müssen.

Öffnen Sie Excel und dann eine beliebige Excel-Arbeitsmappe.
Wählen Sie auf der Registerkarte Start Add-Ins>Weitere Add-Ins aus.
Gehen Sie zu Admin verwaltet und suchen Sie nach Microsoft Dynamics Office Add-in. Wenn Sie es sehen, wählen Sie es aus und wählen Sie dann Hinzufügen. Wenn Sie es nicht sehen, gehen Sie zu Store, suchen Sie dann nach Microsoft Dynamics Office Add-in und folgen Sie den Anweisungen auf dem Bildschirm, um es hinzuzufügen.

Wenn das Add-In installiert ist, wird es in Excel als ein Panel angezeigt. Als nächstes konfigurieren Sie die Verbindung.

Konfigurieren Sie die Business Central Verbindung

Wenn ein Benutzer die Verbindung nicht automatisch herstellen kann, können Sie ihn auffordern, die folgenden Schritte auszuführen:

Wählen Sie im Microsoft Dynamics Add-In-Fenster in Excel die Option Serverinformationen hinzufügen. Wenn sie nicht angezeigt wird, wählen Sie oben das Symbol aus, um das Dialogfeld für Optionen anzuzeigen.
Legen Sie für Business Central Online die Server-URL auf https://exceladdinprovider.smb.dynamics.com fest. Legen Sie für Business Central On-Premises die URL des Webclients fest, wie https://myBCserver/240.
Wählen Sie OK, und bestätigen Sie dann, dass die App neu geladen wird.
Wenn Sie dazu aufgefordert werden, melden Sie sich mit Ihrem Business Central Benutzernamen und Kennwort an.
Wählen Sie optional die Umgebung und die Firma aus, mit der Sie sich verbinden möchten.

Das Add-In ist nun mit Business Central verbunden, und Sie können Daten bearbeiten und die Änderungen in Business Central veröffentlichen.

Geräte und Netzwerk für das Excel Add-In vorbereiten

Netzwerkdienste wie Proxys oder Firewalls müssen Routing zwischen jedem Client-Gerät, auf dem das Add-In installiert ist, und vielen Dienstendpunkten zulassen. Eine Liste der Endpunkte finden Sie unter Vorbereiten Ihres Netzwerks für das Excel-Add-In.

Problembehebung

Manchmal kommt es vor, dass Benutzer Probleme mit dem Excel-Add-In ausführen. In diesem Abschnitt finden Sie einige Tipps, wie Sie die Sperrung für Benutzer unter bestimmten Umständen aufheben können.

Problem	Lösung oder Workaround	Bemerkungen
Das Add-In lässt sich nicht starten Angenommen der Benutzende erhält die Meldung „Add-In-Warnung: Dieses Add-In ist nicht mehr verfügbar“, wenn er versucht, das Add-In zu verwenden. Dieses spezielle Problem kann auftreten, wenn die zentralisierte Bereitstellung korrekt konfiguriert ist, dem Benutzenden jedoch kein Zugriff zugewiesen wurde.	Prüfen Sie, ob das Add-in zentral bereitgestellt wird. Oder überprüfen Sie, ob der Benutzer für die lokale Installation gesperrt ist.	Der Admin kann Office so konfigurieren, dass Benutzer keine Add-Ins erwerben können. In diesen Fällen muss der Admin das Add-In zentral bereitstellen. Weitere Informationen finden Sie unter Add-ins im Admin Center bereitstellen.
Die Daten werden nicht in Excel geladen	Testen Sie die Verbindung, indem Sie eine andere Liste in Excel über Business Central öffnen. Oder öffnen Sie die Arbeitsmappe in Excel in einem Browser.	Wenn der Benutzende einen Firmennamen mit Sonderzeichen angegeben hat, kann das Add-In keine Verbindung herstellen.
Daten können nicht wieder zurück in Business Central veröffentlicht werden.	Testen Sie die Verbindung, indem Sie die Arbeitsmappe in Excel in einem Browser öffnen.	Manchmal kann eine Erweiterung den Veröffentlichungsauftrag blockieren. Wenn die Seite erweitert oder angepasst ist, entfernen Sie die Erweiterungen und versuchen Sie es dann erneut.
Die Daten sind falsch	Excel zeigt Zeiten und Datumsangaben möglicherweise in einem anderen Format als Business Central an. Diese Bedingung macht sie nicht falsch, und die Daten in Business Central werden nicht durcheinander gebracht.
Bei einigen Listenseiten führt das Bearbeiten mehrerer Zeilen in Excel immer wieder zu Fehlern. Diese Bedingung kann auftreten, wenn OData-Aufrufe FlowFields und Felder außerhalb des Steuerelements des Repeaters enthalten.	Aktivieren Sie auf der Seite Webdienste die Kontrollkästchen Nicht editierbare FlowFields ausschließen und Felder außerhalb des Repeaters ausschließen für die veröffentlichte Seite. Wenn Sie diese Kontrollkästchen aktivieren, werden nicht bearbeitbare FlowFields und Felder von der ETag-Berechnung ausgeschlossen.	Diese Kontrollkästchen sind standardmäßig ausgeblendet. Um sie auf der Seite Webdienste anzuzeigen, verwenden Sie Personalisierung.
Benutzer können sich nicht mehr beim Add-In anmelden. Wenn sie versuchen, sich anzumelden, wird der Vorgang abgebrochen, ohne abgeschlossen zu werden.	Dieses Problem wird möglicherweise durch ein Update verursacht, das irgendwann im Juli 2022 am Add-In vorgenommen wurde. Weitere Informationen und eine Fehlerbehebung finden Sie unter Excel-Add-In-Konfiguration zur Unterstützung des Updates vom Juli 2022 ändern.	Gilt nur für Business Central On-Premises
Das Add-In kommuniziert mithilfe der API v2.0 für Dynamics 365 Business Central und alle Einschränkungen dieser API werden automatisch übernommen. Zum Beispiel liegt eine Einschränkung vor, wenn Sie versuchen, eine Liste zu bearbeiten und die zugrunde liegende Karte beispielsweise als Validierungslogik einen Bestätigungsdialog in ihrer AL-Logik verwendet.	Manchmal kann nichts unternommen werden, weil es sich um eine Designauswahl handelt und der Benutzende die Änderung explizit bestätigen muss. Wenn die Bestätigung bei der Verwendung von In Excel bearbeiten vernachlässigbar ist, können Sie den Aufruf des Bestätigungsdialogs in eine bedingte If-Anweisung einschließen, die prüft, ob der Clienttyp sich von ODataV4 unterscheidet, z. B. `if SESSION.CurrentClientType() <> ClientType::ODataV4 then`.	Aus andere Clients möchten Sie den Bestätigungsdialog dagegen vielleicht entfernen, z. B. OData und SOAP.

Bekannte Einschränkungen in der Geschäftslogik

Seite	Einschränkung	Bemerkungen
Aufträge	Fehlermeldung: „Microsoft Dynamics 365 Business Central Data Services hat versucht, einen Clientrückruf auszugeben, um Seite 301 Übersicht Lief.-an-Adressen als modal auszuführen.“ Client Rückrufe werden Microsoft Dynamics 365 Business Central Data Services nicht unterstützt.	Lieferung an Code auf der Seite Verkaufsauftrag kann nur mit bestimmten Versandoptionen bearbeitet werden. Wenn Sie Alternative Lieferadresse auf Lief. an einstellen, öffnet sich der modale Dialog Übersicht Lief.an-Adressen, der nicht mit der Bearbeitung in Excel kompatibel ist.
Projekt Buch.-Blatt	Die Aktualisierung des Felds Preis je Einheit löst keine Aktualisierung des Zeilenbetrags aus. Stattdessen wird der Zeilenrabatt aktualisiert.	Mit dem Webclient können Sie Felder in jedem Auftrag aktualisieren, wie Preis, Betrag, Zeilenrabatt. Andere Felder werden automatisch aktualisiert. Um kaskadierende Aktualisierungen zu vermeiden, verfügen die Felder über eine erweiterte Logik, die auf xRec basiert und sich anders verhält, wenn sie über APIs aufgerufen wird.

Bekannte Einschränkungen bei der Metadatengenerierung

Bei Verwendung von In Excel bearbeiten in Business Central durch Auswahl der Aktion In Excel bearbeiten auf einer Seite oder wenn das Excel-Add-In nach dem Öffnen einer Excel-Arbeitsmappe geladen wird, tritt möglicherweise der folgende Fehler auf: Für die Entität <Entitätsname> konnten keine Metadaten abgerufen werden, da sie nicht gefunden wurde.

Dieser Fehler tritt auf, wenn die Seite, die Sie ändern möchten, zu komplex wird, als dass In Excel bearbeiten sie effektiv bearbeiten könnte. Die Hauptursache ist die Installation mehrerer Erweiterungen, die derselben übergeordnetes Seite Felder mit identischen Feldnamen hinzufügen, was zu Konflikten führt. Es kann auch sein, dass eine einzelne Erweiterung die Metadatengenerierung blockiert.

Einzelne Erweiterung blockiert die Metadatenerstellung

Sehen Sie sich das folgende Szenario mit der Erweiterung A an, zu der die Seitenerweiterung CustomerCardExtA und die Seite WebViewerA gehören, auf der PageType = CardPart.

Bei der Generierung von Metadaten für die Seite Debitorenkarte wertet der Algorithmus jedes einzelne Feld aus, einschließlich der Felder, die durch Erweiterungen hinzugefügt wurden. Wenn jedoch die Erweiterung A installiert ist, schlägt dieser Prozess fehl, weil WebViewerA nicht die gleiche Quelltabelle wie die Seite Debitorenkarte hat.

Um dieses Problem zu beheben, sollten Sie eine Eigenschaft DebitorSourceTable zur Seite WebViewerA hinzufügen. Ein Beispiel für diese Änderung ist in den Codeausschnitten zu sehen, die CustomerCardExtB und WebViewerB enthalten.

In manchen Fällen müssen Sie CardPart möglicherweise auf mehreren Seiten einbetten, ohne auf eine bestimmte Quelltabelle zu verweisen. Für solche Szenarien empfehlen wir, für jede Seite, auf der Sie auch Metadaten generieren müssen, einen separaten CardPart zu erstellen und die gemeinsame Logik in eine Codeunit umzugestalten.

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

Mehrere Erweiterungen verursachen Konflikte

Zur Behebung dieses Problems gibt es zwei mögliche Lösungen:

Erweiterungen deaktivieren: Um herauszufinden, welche Erweiterung den Konflikt verursacht, können Sie Erweiterungen, welche die Seite betreffen, einzeln deaktivieren. Wenn die fraglichen Erweiterungen jedoch für Ihre Geschäftsprozesse erforderlich sind, ist dieser Ansatz möglicherweise nicht ideal.
Erweiterungscode ändern: Bei dieser Lösung wird die Grundursache des Problems analysiert und behoben, indem der Code der für den Konflikt verantwortlichen Erweiterungen geändert wird.

Um dieses Problem besser zu verstehen, betrachten Sie das folgende Beispiel mit der Seite Debitorenkarte (ID 21). Wenn Sie auf der Seite Debitorenliste (ID 22) sind und In Excel bearbeiten auswählen, wird im Hintergrund ein Webdienst generiert, der die Felder der Seite Debitorenkarte verfügbar macht. Dieser Webdienst umfasst alle auf der Seite Debitorenkarte festgelegten Seitenfelder, während Tabellenfelder nur angezeigt werden, wenn sie einem Seitenfeld entsprechen oder zum Primärschlüssel gehören.

Wenn eine Erweiterung installiert wird, welche die Seite Debitorenkarte erweitert, werden die von der Erweiterung hinzugefügten Felder auch im Webdienst angezeigt. Obwohl Erweiterungen keine Seitenfelder mit denselben Namen wie die bereits auf der Seite Debitorenkarte vorhandenen Felder erstellen können, können dennoch Konflikte entstehen, wenn mehrere Erweiterungen Felder mit identischen Namen hinzufügen.

Angenommen, die folgende Erweiterung mit der Bezeichnung A ist installiert:

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) { }
    }
}

Stellen Sie sich nun vor, dass eine weitere Erweiterung mit der Bezeichnung B installiert wird, die auch die Seite Debitorenkarte ändert:

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 diesem Szenario fügen sowohl Erweiterung A als auch Erweiterung B der Seite Debitorenkarte ein Seitenfeld mit dem Namen ShoeSize hinzu. Dies führt zu einem Konflikt, der einen Fehler bei der Metadatengenerierung für die Seite Debitorenkarte auslöst.

Um dieses Problem zu beheben, benötigen Sie Zugriff auf den Code von mindestens einer der Erweiterungen und müssen dann die widersprüchlichen Seitenfeldnamen ändern, um Konflikte zu vermeiden.

Siehe auch

Finanzauswertungen analysieren in Microsoft Excel
Arbeiten mit Business Central
Verbesserungen der Excel-Integration in der Veröffentlichungswelle 2 von 2019

Kostenlose E-Learning-Module für Business Central finden Sie hier

Freigeben über