© navision.pl | Opracowano na podstawie: Microsoft Learn (CC BY 4.0)

Pobieranie dodatku Business Central dla programu Excel

Business Central includes an add-in for Excel that lets users select the Edit in Excel action on certain pages to open the data in an Excel worksheet. This action is different than the Open in Excel action because it lets users make changes in Excel, then publish the changes back to Business Central

Przegląd

Informacje o dodatku

Dodatek nosi nazwę Microsoft Dynamics Office Add-in i jest dostępny do instalacji ze sklepu Office Store (AppSource). Po zainstalowaniu dodatku akcja Edytuj w programie Excel jest dostępna na większości stron list i części list z ikony Udostępnij . Dowiedz się więcej o korzystaniu z dodatku w artykule Wyświetlanie i edytowanie w programie Excel z Business Central.

Uwaga

Dodatek działa tylko w systemie Windows.

Informacje o wdrażaniu jako administrator

W przypadku Business Central online dostępnych jest kilka opcji wdrażania dodatku dla użytkowników. Jedną z opcji jest samodzielne pozyskanie, w którym użytkownicy sami instalują dodatek. W przypadku tej opcji użytkownicy muszą mieć dostęp do pobierania plików ze sklepu Office Store. Inną opcją jest skonfigurowanie Scentralizowanego wdrożenia w centrum administracyjnym Microsoft 365 w celu automatycznego wdrożenia dodatku dla całej organizacji, grup lub określonych użytkowników. Scentralizowane wdrożenie umożliwia udostępnienie dodatku użytkownikom, jeśli organizacja nie daje użytkownikom dostępu do sklepu Office Store.

Dla użytkownika proces instalacji różni się w zależności od scenariusza wdrożenia:

W przypadku samodzielnego pozyskania, gdy użytkownicy po raz pierwszy wybiorą akcję Edytuj w programie Excel, w programie Excel zostanie otwarte okienko Nowy dodatek pakietu Office. Aby zainstalować dodatek, użytkownik wybiera opcję Ufaj temu dodatkowi, co powoduje zainstalowanie dodatku bezpośrednio ze sklepu Office Store. Następnie użytkownicy logują się do Business Central przy użyciu nazwy użytkownika i hasła.
W przypadku Scentralizowanego wdrożenia, gdy użytkownicy po raz pierwszy wybiorą akcję Edytuj w programie Excel, dodatek zostanie automatycznie zainstalowany w programie Excel ze Scentralizowanego wdrożenia, a nie ze sklepu Office Store. Jedyne, co użytkownicy muszą zrobić, to zalogować się do Business Central.

W przypadku obu tych opcji wdrażania dodatek jest automatycznie konfigurowany do łączenia się z Business Central. Trzecią opcją wdrażania jest ręczna instalacja dodatku bezpośrednio z programu Excel. W przypadku tej opcji użytkownicy muszą skonfigurować dodatek do łączenia się z Business Central.

Przełączanie z samodzielnego pozyskania na Scentralizowane wdrożenie i odwrotnie

Zmiana z samodzielnego pozyskania dodatku na Scentralizowane wdrożenie lub odwrotnie wpływa na pliki programu Excel utworzone przez użytkowników przed przejściem. Po przejściu użytkownicy nadal mogą otwierać arkusze programu Excel utworzone wcześniej za pomocą akcji Edytuj w programie Excel lub utworzone ręcznie przez skonfigurowanie dodatku Excel. Nie mogą jednak aktualizować danych w pliku z Business Central ani wysyłać aktualizacji do Business Central.

Ta sytuacja występuje, ponieważ każdemu plikowi programu Excel przypisywany jest identyfikator "dodatku". Podczas przejścia do lub ze Scentralizowanego wdrożenia przypisywany jest inny identyfikator, więc wcześniejszy identyfikator zostaje zablokowany.

Przygotowanie (tylko wersja lokalna)

Business Central w wersji lokalnej wymaga skonfigurowania środowiska dla dodatku. W przeciwnym razie akcja Edytuj w programie Excel nie będzie dostępna dla użytkowników. Dowiedz się więcej w artykule Konfigurowanie dodatku Business Central dla programu Excel w Business Central w wersji lokalnej w pomocy dla deweloperów i specjalistów IT.

Wdrażanie dodatku przy użyciu Scentralizowanego wdrożenia

Scentralizowane wdrożenie to funkcja w centrum administracyjnym Microsoft 365 używana do automatycznej instalacji dodatków w aplikacjach pakietu Office użytkowników, takich jak Excel. Aby ułatwić Scentralizowane wdrożenie, Business Central zawiera asystenta konfiguracji Scentralizowane wdrożenie dodatku Excel.

Przed rozpoczęciem

Dowiedz się więcej o zapobieganiu pobieraniu przez użytkowników ze sklepu Office w artykule Zarządzanie dodatkami w centrum administracyjnym.
Sprawdź, czy Scentralizowane wdrożenie działa w Twojej organizacji. Dowiedz się więcej w artykule Określanie, czy Scentralizowane wdrożenie dodatków działa w Twojej organizacji.
Dowiedz się więcej o przechodzeniu z samodzielnego pozyskania w artykule Przełączanie z samodzielnego pozyskania na Scentralizowane wdrożenie.

Uwaga

Włączenie Scentralizowanego wdrożenia wpływa na funkcje korzystające z dodatku Excel, takie jak akcja Edytuj w programie Excel. Nie ma wpływu na inne funkcje związane z programem Excel ani uprawnienia przypisane użytkownikom w Business Central.

Konfigurowanie Scentralizowanego wdrożenia dodatku

W tym zadaniu pracujesz zarówno w Business Central, jak i w centrum administracyjnym Microsoft 365.

W Business Central wybierz Szukaj (Alt+Q) w prawym górnym rogu wprowadź Scentralizowane wdrożenie dodatku Excel, a następnie wybierz powiązane łącze.
Przeczytaj informacje na stronie Konfiguracja dodatku Excel Business Central i wybierz Dalej.
Zaloguj się do centrum administracyjnego Microsoft 365 i przejdź do Zintegrowane aplikacje.

Wykonaj następujące kroki, aby skonfigurować dodatek do wdrożenia ze sklepu Office Store: 1. Wybierz Pobierz aplikacje, aby otworzyć sklep Office Store (AppSource). 2. Wyszukaj Microsoft Dynamics Office Add-in, a następnie wybierz Pobierz teraz. 3. Na stronie Dodaj użytkowników określ użytkowników, dla których chcesz wdrożyć dodatek, a następnie wybierz Dalej. 4. Przejrzyj Akceptuj żądania uprawnień, a następnie wybierz Dalej > Zakończ wdrażanie. 5. Poczekaj, aż przy dodatku pojawi się zielony znacznik wyboru obok Wdrożono, a następnie wybierz Gotowe.

Dodatek pojawi się na stronie Dodatki. Dowiedz się więcej o wdrażaniu dodatków w centrum administracyjnym Microsoft 365 w artykule Wdrażanie dodatków w centrum administracyjnym. 4. Wróć do konfiguracji asystowanej Scentralizowane wdrożenie dodatku Excel w Business Central i wybierz Dalej. 5. Włącz opcję Użyj scentralizowanego wdrożenia i wybierz Zakończ.

Jeśli nie włączysz tego przełącznika, Business Central pobierze dodatek bezpośrednio ze sklepu Office Store.

Po zakończeniu zawsze możesz zmienić wdrożenie w centrum administracyjnym Microsoft 365, na przykład przypisując więcej użytkowników. Dowiedz się więcej o wdrażaniu dodatków w centrum administracyjnym w artykule Wdrażanie dodatków w centrum administracyjnym.

Ostrzeżenie

Jeśli masz więcej niż jedno środowisko, musisz uruchomić konfigurację asystowaną Scentralizowane wdrożenie dodatku Excel w każdym środowisku, w którym chcesz używać scentralizowanego wdrożenia. Nie musisz jednak ponownie konfigurować scentralizowanego wdrożenia w Microsoft 365. Wystarczy włączyć przełącznik Użyj scentralizowanego wdrożenia w konfiguracji asystowanej.

Uwaga

Automatyczne wdrożenie dodatku w programie Excel dla użytkowników może potrwać do 24 godzin.

Indywidualne pozyskanie: Zainstaluj dodatek ręcznie do własnego użytku

W większości przypadków, gdy otwierasz program Excel z Business Central, dodatek instaluje się automatycznie lub zostaniesz poproszony o jego zainstalowanie. Mogą jednak wystąpić przypadki, w których konieczna jest ręczna instalacja dodatku.

Otwórz program Excel, a następnie otwórz dowolny skoroszyt programu Excel.
Na karcie Narzędzia główne wybierz Dodatki, a następnie Więcej dodatków.
Przejdź do sekcji Zarządzane przez administratora i znajdź Microsoft Dynamics Office Add-In. Jeśli ta opcja jest dostępna, wybierz ją, a następnie wybierz Dodaj. Jeśli opcja nie jest dostępna, przejdź do Sklepu i wyszukaj Microsoft Dynamics Office Add-In, a następnie postępuj zgodnie z instrukcjami, aby go dodać.

Po zainstalowaniu dodatek wyświetla się jako panel w programie Excel. Następnie skonfiguruj połączenie.

Konfigurowanie połączenia z Business Central

Jeśli użytkownik nie może połączyć się automatycznie, możesz odblokować go, prosząc o wykonanie następujących kroków:

W okienku dodatku Microsoft Dynamics w programie Excel wybierz Dodaj informacje o serwerze. Jeśli ta opcja nie jest dostępna, wybierz ikonę u góry, aby otworzyć okno dialogowe opcji.
W przypadku Business Central online ustaw Adres URL serwera na https://exceladdinprovider.smb.dynamics.com. W przypadku Business Central lokalnie ustaw go na adres URL klienta webowego, na przykład https://myBCserver/240.
Wybierz OK, a następnie potwierdź, że aplikacja zostanie ponownie załadowana.
Po wyświetleniu monitu zaloguj się przy użyciu nazwy użytkownika i hasła Business Central.
Opcjonalnie wybierz środowisko i firmę, z którymi chcesz się połączyć.

Dodatek jest teraz połączony z Business Central i możesz edytować dane oraz publikować zmiany w Business Central.

Przygotowanie urządzeń i sieci do obsługi dodatku Excel

Usługi sieciowe, takie jak serwery proxy lub zapory, muszą umożliwiać routing między każdym urządzeniem klienckim, na którym zainstalowano dodatek, a wieloma punktami końcowymi usługi. Aby uzyskać listę punktów końcowych, przejdź do artykułu Przygotowanie sieci do obsługi dodatku Excel.

Rozwiązywanie problemów

Czasami użytkownicy napotykają problemy z dodatkiem Excel. W tej sekcji przedstawiono wskazówki dotyczące odblokowywania użytkowników w określonych sytuacjach.

Problem	Rozwiązanie lub obejście	Komentarze
Dodatek nie uruchamia się. Na przykład użytkownik otrzymuje komunikat "Ostrzeżenie dodatku: Ten dodatek nie jest już dostępny" podczas próby użycia dodatku. Ten konkretny problem może wystąpić, jeśli scentralizowane wdrożenie zostało poprawnie skonfigurowane, ale użytkownikowi nie przypisano dostępu.	Sprawdź, czy dodatek jest wdrożony centralnie. Ewentualnie sprawdź, czy użytkownik ma zablokowaną możliwość lokalnej instalacji.	Administrator może skonfigurować pakiet Office tak, aby użytkownicy nie mogli pozyskiwać dodatków. W takim przypadku administrator musi wdrożyć dodatek centralnie. Dowiedz się więcej w artykule Wdrażanie dodatków w centrum administracyjnym.
Dane nie są ładowane do programu Excel.	Przetestuj połączenie, otwierając inną listę w programie Excel z Business Central. Możesz też otworzyć skoroszyt w programie Excel w przeglądarce.	Jeśli użytkownik podał nazwę firmy zawierającą znaki specjalne, dodatek nie może nawiązać połączenia.
Nie można opublikować danych z powrotem do Business Central.	Przetestuj połączenie, otwierając skoroszyt w programie Excel w przeglądarce.	Czasami rozszerzenie może blokować zadanie publikowania. Jeśli strona jest rozszerzona lub dostosowana, usuń rozszerzenia, a następnie spróbuj ponownie.
Daty są nieprawidłowe.	Program Excel może wyświetlać godziny i daty w innym formacie niż Business Central. Nie oznacza to, że są one nieprawidłowe, a dane w Business Central nie zostaną uszkodzone.
W przypadku niektórych stron listy edytowanie wielu wierszy w programie Excel stale powoduje błędy. Ten problem może wystąpić, jeśli wywołania OData zawierają pola FlowField i pola spoza kontrolki repeater.	Na stronie Usługi sieci Web zaznacz pola wyboru Wyklucz nieedytowalne pola FlowField i Wyklucz pola spoza kontrolki Repeater dla opublikowanej strony. Zaznaczenie tych pól wyboru powoduje wykluczenie nieedytowalnych pól FlowField i innych pól z obliczeń eTag.	Te pola wyboru są domyślnie ukryte. Aby wyświetlić je na stronie Usługi sieci Web, użyj personalizacji.
Użytkownicy nie mogą już logować się do dodatku. Gdy próbują się zalogować, proces zatrzymuje się bez ukończenia.	Ten problem może wystąpić z powodu aktualizacji, którą wprowadziliśmy w dodatku. Dowiedz się więcej w artykule Modyfikowanie konfiguracji dodatku Excel w celu obsługi aktualizacji z lipca 2022.	Dotyczy tylko Business Central lokalnie.
Dodatek komunikuje się przy użyciu interfejsu API v2.0 dla Dynamics 365 Business Central, a wszelkie ograniczenia tego interfejsu API są automatycznie dziedziczone. Przykładowym ograniczeniem jest sytuacja, gdy próbujesz edytować listę, a podstawowa karta używa okna dialogowego potwierdzenia w swojej logice AL, na przykład jako logiki walidacji.	Czasami nie można nic zrobić, ponieważ jest to wybór projektowy, który wymaga, aby użytkownik jawnie potwierdził zmianę. Jeśli potwierdzenie jest nieistotne podczas korzystania z funkcji Edytuj w programie Excel, możesz umieścić wywołanie okna dialogowego potwierdzenia w instrukcji warunkowej if, która sprawdza, czy typ klienta jest inny niż ODataV4, na przykład `if SESSION.CurrentClientType() <> ClientType::ODataV4 then`.	Mogą istnieć inni klienci, dla których chcesz usunąć okno dialogowe potwierdzenia, na przykład OData i SOAP.
Po wybraniu opcji Edytuj w programie Excel wyświetlany jest następujący komunikat: "Niektóre filtry zastosowane na stronie nie są dostępne w pakiecie Office, więc zostanie wyświetlonych więcej wierszy w porównaniu z Business Central. Usunięte filtry: ...".	Jeśli usunięty filtr dotyczy pola dodanego przez rozszerzenie AL, upewnij się, że nazwa pola strony i nazwa pola tabeli bazowej są identyczne. Na przykład dla pola strony `field("Customer Name", Rec."Customer Name")` nazwa pola tabeli "Customer Name" musi mieć postać `field(1; "Customer Name"; Text)`. Jeśli usunięty filtr dotyczy pola należącego do firmy Microsoft lub innego dostawcy, mimo że filtr został usunięty w Business Central, może być nadal dostępny na karcie filtru dodatku Office. Wymaga to jednak ręcznego stosowania za każdym razem. Aby trwale naprawić pola, nad którymi nie masz kontroli, skontaktuj się z właścicielem rozszerzenia.

Znane ograniczenia w logice biznesowej

Page	Ograniczenie	Komentarze
Zamówienia sprzedaży	Komunikat o błędzie: 'Microsoft Dynamics 365 Business Central Data Services attempted to issue a client callback to run page 301 Ship-to Address List as modal.' Wywołania zwrotne klienta nie są obsługiwane w Microsoft Dynamics 365 Business Central Data Services.	Pole Kod dostawy na stronie Zamówienie sprzedaży można edytować tylko przy określonych opcjach dostawy. Ustawienie Alternatywny adres wysyłki na Adres dostawy otwiera okno modalne Lista adresów dostawy, które nie jest kompatybilne z funkcją Edytuj w programie Excel.
Dziennik projektu	Aktualizacja pola Cena jednostkowa nie powoduje aktualizacji pola Kwota wiersza. Zamiast tego aktualizowane jest pole Rabat wiersza.	Korzystając z klienta internetowego, można aktualizować pola w dowolnej kolejności — cenę, kwotę, rabat wiersza. Pozostałe pola są aktualizowane automatycznie. Aby uniknąć kaskadowych aktualizacji, pola mają zaawansowaną logikę opartą na xRec, która działa inaczej przy wywołaniu przez interfejsy API.

Znane ograniczenia w generowaniu metadanych

Podczas korzystania z funkcji Edytuj w programie Excel w Business Central, zarówno przez wybranie akcji Edytuj w programie Excel na stronie, jak i podczas ładowania dodatku Excel po otwarciu skoroszytu programu Excel, może pojawić się następujący błąd: Metadata was unable to be retrieved for entity \<entity name> as it was not found.

Ten błąd występuje, gdy strona, którą próbujesz zmodyfikować, staje się zbyt złożona, aby funkcja Edytuj w programie Excel mogła ją skutecznie przetworzyć. Główną przyczyną jest instalacja wielu rozszerzeń, które dodają pola o identycznych nazwach do tej samej strony nadrzędnej, co prowadzi do konfliktów. Możliwe jest również, że pojedyncze rozszerzenie blokuje generowanie metadanych.

Pojedyncze rozszerzenie blokujące tworzenie metadanych

Rozważ następujący scenariusz obejmujący rozszerzenie A, które zawiera rozszerzenie strony CustomerCardExtA oraz stronę WebViewerA, gdzie PageType = CardPart.

Podczas generowania metadanych dla strony Kartoteka nabywcy algorytm ocenia każde pojedyncze pole, w tym pola dodane przez rozszerzenia. Jednak jeśli zainstalowane jest rozszerzenie A, proces ten kończy się niepowodzeniem, ponieważ WebViewerA nie współdzieli tej samej tabeli źródłowej co strona Kartoteka nabywcy.

Aby rozwiązać ten problem, należy dodać właściwość SourceTable z wartością Customer do strony WebViewerA. Przykład tej modyfikacji można zobaczyć we fragmentach kodu zawierających CustomerCardExtB i WebViewerB.

W niektórych przypadkach może być konieczne osadzenie CardPart na wielu stronach bez odwoływania się do określonej tabeli źródłowej. W takich scenariuszach zalecamy utworzenie oddzielnego CardPart dla każdej strony, na której trzeba również generować metadane, oraz przeniesienie współdzielonej logiki do 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
            }
        }
    }
}

Wiele rozszerzeń powodujących kolizje

Aby rozwiązać ten problem, istnieją dwa możliwe rozwiązania:

Wyłącz rozszerzenia: Aby zidentyfikować, które rozszerzenie powoduje konflikt, można wyłączać rozszerzenia wpływające na stronę pojedynczo. Jednak takie podejście może nie być idealne, jeśli dane rozszerzenia są niezbędne dla procesów biznesowych.
Zmodyfikuj kod rozszerzenia: To rozwiązanie polega na analizie głównej przyczyny problemu i rozwiązaniu go poprzez modyfikację kodu konfliktujących rozszerzeń.

Aby lepiej zrozumieć ten problem, rozważ następujący przykład dotyczący strony Kartoteka nabywcy (ID 21). Gdy znajdujesz się na stronie Lista nabywców (ID 22) i wybierzesz Edytuj w programie Excel, w tle generowana jest usługa internetowa, która udostępnia pola ze strony Kartoteka nabywcy. Ta usługa internetowa zawiera wszystkie pola strony zdefiniowane na stronie Kartoteka nabywcy, podczas gdy pola tabeli są udostępniane tylko wtedy, gdy odpowiadają polu strony lub są częścią klucza głównego.

Gdy zainstalowane jest rozszerzenie rozszerzające stronę Kartoteka nabywcy, pola dodane przez rozszerzenie są również udostępniane w usłudze internetowej. Chociaż rozszerzenia nie mogą tworzyć pól strony o takich samych nazwach jak pola już istniejące na stronie Kartoteka nabywcy, konflikty mogą nadal występować, gdy wiele rozszerzeń dodaje pola o identycznych nazwach.

Na przykład załóżmy, że zainstalowane jest następujące rozszerzenie, oznaczone jako A:

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

Teraz rozważ, że zainstalowane jest inne rozszerzenie, oznaczone jako B, które również modyfikuje stronę Kartoteka nabywcy:

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

W tym scenariuszu oba rozszerzenia A i B dodają pole strony o nazwie ShoeSize do strony Kartoteka nabywcy. Ten stan powoduje konflikt, który prowadzi do niepowodzenia generowania metadanych dla strony Kartoteka nabywcy.

Aby rozwiązać ten problem, potrzebujesz dostępu do kodu co najmniej jednego z rozszerzeń, a następnie musisz zmodyfikować konfliktujące nazwy pól strony, aby uniknąć kolizji.

Powiązane informacje

Praca z przeglądami finansowymi w programie Excel (wersja przestarzała)
Praca z Business Central
Enhancements to Excel integration in 2019 release wave 2

Znajdź bezpłatne moduły e-learningowe dla Business Central tutaj