Získání doplňku Business Central pro Excel

Článek
12/16/2024

Business Central obsahuje doplněk pro Excel, který uživatelům umožňuje vybrat akci Upravit v Excelu na určitých stránkách a otevřít data v excelovém listu. Tato akce se liší od akce Otevřít v Excelu, protože umožňuje uživatelům provádět změny v Excelu a poté změny publikovat zpět do Business Central

Přehled

O doplňku

Doplněk se nazývá Microsoft Dynamics Office Add-in a je k dispozici pro instalaci z Office Store (AppSource). S nainstalovaným doplňkem je akce Upravit v Excelu k dispozici na většině stránek částí seznamu a seznamu z ikony Sdílet . Další informace o používání doplňku najdete v části Zobrazení a úpravy v Excelu z Business Central.

Poznámka

Doplněk funguje pouze v systému Windows.

O nasazení jako správce

S Business Central online existuje několik možností nasazení, jak dostat doplněk k uživatelům. Jednou z možností je individuální získání, kdy necháte uživatele, aby si doplněk nainstalovali sami. S touto možností musí mít uživatelé přístup ke stahování souborů z Office Store. Další možností je nastavit Centralizované nasazení v centru pro správu Microsoft 365, aby se doplněk automaticky nasadil do celé vaší organizace, skupin nebo konkrétních uživatelů. Centralizované nasazení poskytuje způsob, jak dostat doplněk k uživatelům, pokud vaše organizace nedává uživatelům přístup do Office Store.

Pro uživatele se instalace liší pro dva scénáře nasazení:

Při individuálním získání noví uživatelé zvolí akci Upravit v Excelu, v Excelu se otevře podokno Nový doplněk Office. Pro instalaci doplňku uživatel zvolí Důvěřovat tomuto doplňku, čímž se doplněk nainstaluje přímo z Office Store. Uživatelé se poté přihlásí do Business Central pomocí svého uživatelského jména a hesla.
Při centralizovaném nasazení, když noví uživatelé zvolí akci Upravit v Excelu, doplněk se automaticky nainstaluje do Excelu z centralizovaného nasazení, ne Office Store. Jediné, co musí uživatelé udělat, je přihlásit se do Business Central.

S oběma těmito možnostmi nasazení je doplněk automaticky nakonfigurován pro připojení k Business Central. Třetí možností nasazení je ruční instalace doplňku přímo z Excelu. S touto volbou musí uživatelé nakonfigurovat doplněk pro připojení k Business Central.

Přechod z individuálního získání na centralizované nasazení nebo naopak

Když přejdete z individuálního získání doplňku na centralizované nasazení nebo naopak, budou ovlivněny soubory aplikace Excel, které uživatelé vytvořili před přechodem. Po přechodu mohou uživatelé stále otevírat jakékoli listy aplikace Excel dříve vytvořené pomocí akce Upravit v Excelu nebo vytvořené ručně konfigurací doplňku aplikace Excel. Nemohou však aktualizovat data v souboru z Business Central ani odeslat aktualizace do Business Central.

Tento stav nastává, protože každému souboru aplikace Excel je přiřazen identifikátor „doplněk“. Při přechodu na centralizované nasazení nebo z něj je přiřazeno jiné ID, takže dřívější ID bude zablokováno.

Příprava (pouze místně)

Místní Business Central vyžaduje, aby vaše prostředí bylo nakonfigurováno pro doplněk. Když není, akce Upravit v Excelu není uživatelům k dispozici. Další informace naleznete v části Nastavení doplňku Business Central pro Excel v místním Business Central v nápovědě pro vývojáře a IT profesionály.

Nasaďte doplněk pomocí centralizovaného nasazení

Centralizované nasazení je funkce v centru pro správu Microsoft 365, kterou používáte k automatické instalaci doplňků do aplikací Office uživatelů, jako je Excel. Abychom vám pomohli s centralizovaným nasazením, Business Central obsahuje Centralizované nasazení doplňku Excel.

Než začnete

Další informace o tom, jak uživatelům zabránit ve stahování z obchodu Office, naleznete na stránce Správa doplňků v centru pro správu.
Ověřte, že centralizované nasazení ve vaší organizaci funguje. Další informace naleznete na stránce Zjištění, zda centralizované nasazení doplňků pro vaši organizaci funguje.
Pokud přecházíte z individuálního získání, přečtěte si další informace v části Přechod z individuálního získání na centralizované nasazení.

Poznámka

Zapnutí centralizovaného nasazení ovlivní funkce, které používají doplněk Excel, jako je například akce Upravit v Excelu. Nemá žádný vliv na další funkce související s Excelem nebo oprávnění přiřazená uživatelům v Business Central.

Nastavení centralizovaného nasazení doplňku

V tomto úkolu pracujete jak v Business Central, tak v centru pro správu Microsoft 365.

V Business Central vyberte ikonu , zadejte Centralizované nasazení doplňku Excelu a vyberte související odkaz.
Přečtěte si informace na stránce Nastavení doplňku Excelu Business Central a vyberte Další.
Přihlaste se do centra pro správu Microsoft 365 a přejděte na Integrované aplikace.

Chcete-li nakonfigurovat doplněk k nasazení z Office Store, postupujte takto:
1. Vybrat Získat aplikace k otevření Office Store (AppSource).
2. Vyhledejte Microsoft Dynamics Office Add-in a poté vyberte Získat.
3. Na stránce Přidat uživatele zadejte uživatele, pro které chcete doplněk nasadit, a poté vyberte Další.
4. Zkontrolujte Přijmout žádosti o oprávnění, pak vyberte Další>Dokončit nasazení.
5. Počkejte, až se vedle Nasazeno u doplňku zobrazí zelená značka zaškrtnutí, a poté vyberte Hotovo.
  
  Doplněk se zobrazí na stránce Doplňky. Další informace o nasazení doplňků v centru pro správu Microsoft 365 viz Nasazení doplňků v centru pro správu.
Vraťte se k asistovanému nasazení Centralizované nasazení doplňku Excelu v Business Central a vyberte Další.
Zapněte Použít centralizované nasazení a vyberte Dokončit.

Pokud tento přepínač nezapnete, Business Central získá doplněk přímo z obchodu Office Store.

Po dokončení můžete nasazení kdykoli změnit v centru pro správu Microsoft 365, jako je přiřazení více uživatelů. Další informace o nasazení doplňků v centru pro správu viz Nasazení doplňků v centru pro správu.

Důležité

Pokud máte více než jedno prostředí, musíte spustit asistované nastavení Centralizované nasazení doplňku Excel v každém prostředí, které chcete použít centralizované nasazení. Centralizované nasazení však nemusíte znovu konfigurovat v Microsoft 365. Jediné, co musíte udělat, je zapnout v asistovaném nastavení přepínač Použít centralizované nasazení.

Poznámka

Uživatelům může trvat až 24 hodin, než se doplněk automaticky nasadí do aplikace Excel uživatelů.

Individuální získání: Nainstalujte doplněk ručně pro vlastní použití

Ve většině případů, když otevřete Excel z Business Central, se vám doplněk buď nainstaluje automaticky, nebo se zobrazí výzva k jeho instalaci. Mohou však nastat případy, kdy budete muset doplněk nainstalovat ručně.

Otevřete Excel a poté otevřete libovolný excelový sešit.
Na kartě Domů vyberte Doplňky>Další doplňky.
Přejděte na Spravováno správcem a vyhledejte Microsoft Dynamics Office Add-In. Pokud ho vidíte, vyberte ho a poté zvolte Přidat. Pokud ho nevidíte, přejděte do Obchod a vyhledejte Microsoft Dynamics Office Add-In a postupujte podle pokynu na obrazovce pro přidání.

Když je doplněk nainstalován, zobrazí se jako panel v aplikaci Excel. Dále nakonfigurujte připojení.

Konfigurace připojení Business Central

Pokud se uživatel nemůže připojit automaticky, můžete ho odblokovat tím, že ho požádáte, aby provedl následující kroky:

V podokně doplňků Microsoft Dynamics v Excelu vyberte Přidat informace o serveru. Pokud to nevidíte, vyberte ikonu nahoře a otevřete dialogové okno možností.
Pro Business Central online nastavte Adresa URL serveru na https://exceladdinprovider.smb.dynamics.com. Pro místní Business Central nastavte adresu URL webového klienta, například https://myBCserver/240.
Zvolte OK a poté potvrďte, že se aplikace znovu načte.
Po zobrazení výzvy se přihlaste pomocí svého uživatelského jména a hesla Business Central.
Volitelně vyberte prostředí a společnost, ke které se chcete připojit.

Doplněk je nyní připojen k Business Central a vy můžete upravovat data a publikovat změny v Business Central.

Příprava zařízení a sítě pro doplněk Excel

Síťové služby, jako jsou proxy nebo brány firewall, musí umožňovat směrování mezi každým klientským zařízením, na kterém je doplněk nainstalován, a mnoha koncovými body služeb. Seznam koncových bodů naleznete v části Příprava sítě na doplněk Excel.

Řešení potíží

Někdy se uživatelé setkají s problémy s doplňkem Excelu. Tato část poskytuje tipy, jak za určitých okolností uživatele odblokovat.

Problém	Řešení nebo náhradní řešení	Komentáře
Doplněk se nespustí. Uživatel například obdrží zprávu „Upozornění doplňku: Tento doplněk již není k dispozici“ při pokusu o použití doplňku. Tento konkrétní problém může nastat, pokud je centralizované nasazení správně nakonfigurováno, ale uživateli nebyl přidělen přístup.	Zkontrolujte, zda je doplněk nasazen centrálně. Nebo zkontrolujte, zda uživatel nemá blokovanou instalaci lokálně.	Správce může nakonfigurovat Office tak, aby uživatelé nemohli získávat doplňky. V tomto případu musí správce nasadit doplněk centrálně. Další informace viz Nasazení doplňků v centru pro správu.
Data se nenačtou do Excelu.	Otestujte připojení otevřením dalšího seznamu v Excelu z Business Central. Nebo otevřete sešit v aplikaci Excel v prohlížeči.	Pokud uživatel zadal název společnosti, který obsahuje speciální znaky, doplněk se nemůže připojit.
Data nelze publikovat zpět do Business Central.	Otestujte připojení otevřením sešitu v Excelu v prohlížeči.	Někdy může rozšíření zablokovat úlohu publikování. Pokud je stránka rozšířena nebo přizpůsobena, odeberte rozšíření a zkuste to znovu.
Data jsou chybná.	Excel může zobrazovat časy a data v jiném formátu než Business Central. Tento stav neznamená chybu a data v Business Central nejsou rozbita.
U některých stránek seznamu způsobuje úprava více řádků v Excelu soustavně chyby. Tento stav může nastat, pokud volání OData zahrnují pole FlowField a pole mimo kontrolu opakovače.	Na stránce Webové služby zaškrtněte políčka Vyloučit neupravitelná pole FlowField a Vyloučit pole mimo opakovač pro publikovanou stránku. Zaškrtnutím těchto zaškrtávacích políček vyloučíte neupravitelná pole FlowField a pole z výpočtu eTag.	Tato zaškrtávací políčka jsou ve výchozím nastavení skrytá. Chcete-li je zobrazit na stránce Webové služby, použijte personalizaci.
Uživatelé se již nemohou přihlásit k doplňku. Když se pokusí přihlásit, proces se zastaví, aniž by byl dokončen.	Tento problém může být způsoben aktualizací doplňku, kterou jsme provedli někdy v červenci 2022. Další informace a opravu najdete v části Úprava konfigurace doplňku aplikace Excel pro podporu aktualizace z července 2022.	Platí pouze pro místní Business Central.
Doplněk komunikuje pomocí rozhraní API v2.0 pro Dynamics 365 Business Central a všechna omezení tohoto rozhraní API se automaticky dědí. Příkladem omezení je, když se pokusíte upravit seznam a podkladová karta používá ve své logice AL například potvrzovací dialog jako logiku ověření.	Někdy se nedá nic dělat, protože jde o návrhovou volbu, kterou musí uživatel výslovně potvrdit. Pokud je potvrzení při použití Upravit v Excelu zanedbatelné, pak můžete zabalit volání potvrzovacího dialogu v podmíněném příkazu if, který kontroluje, zda se typ klienta liší od ODataV4, například `if SESSION.CurrentClientType() <> ClientType::ODataV4 then`.	Mohou existovat další klienti, ze kterých chcete odebrat potvrzovací dialog, například OData a SOAP.

Známá omezení v obchodní logice

Stránka	Omezení	Komentáře
Prodejní objednávky	Chybová zpráva: „Datové služby Microsoft Dynamics 365 Business Central se pokusily vyvolat zpětné volání klienta pro spuštění stránky 301 Seznam adres příjemců zásilky jako modální okno.“ Zpětná volání klientů nejsou v datových službách Microsoft Dynamics 365 Business Central podporována.	Kód příjemce zásilky na stránce Prodejní objednávka lze upravovat pouze se specifickými možnostmi příjemce zásilky. Nastavení Alternativní dodací adresa na Příjemce zásilky otevře modální dialogové okno Seznam adres příjemců zásilky, který není kompatibilní s možností Upravit v Excelu.
Deník projektu	Aktualizace pole Jednotková cena nespouští aktualizaci Částky řádku. Místo toho se aktualizuje Řádková sleva.	Pomocí webového klienta můžete aktualizovat pole v libovolné objednávce, cena, částku, sleva na řádek. Ostatní pole se aktualizují automaticky. Aby se předešlo kaskádovým aktualizacím, mají pole nějakou pokročilou logiku, která se spoléhá na xRec, který se při volání přes API chová jinak.

Známá omezení při generování metadat

Při použití Upravit v Excelu v Business Central buď výběrem akce Upravit v Excelu nebo když se doplněk aplikace Excel načte po otevření sešitu aplikace Excel, můžete narazit na následující chybu: Nebylo možné načíst metadata pro entitu <název entity>, protože nebyla nalezena.

K této chybě dochází, když je stránka, kterou se pokoušíte upravit, příliš složitá na to, aby ji akce Upravit v Excelu efektivně zpracovala. Primární příčinou je instalace více rozšíření, která přidávají pole se stejnými názvy polí na stejnou nadřazenou stránku, což vede ke konfliktům. Je také možné, aby generování metadat blokovalo jediné rozšíření.

Jedno rozšíření blokující vytváření metadat

Zvažte následující scénář zahrnující rozšíření A, které zahrnuje rozšíření stránky CustomerCardExtA a stránku WebViewerA kde PageType = CardPart.

Když jsou generována metadata pro stránku Karta zákazníka, algoritmus vyhodnotí každé jednotlivé pole, včetně polí přidaných rozšířeními. Pokud je však nainstalováno rozšíření A, tento proces selže, protože WebViewerA nesdílí stejnou zdrojovou tabulku jako stránka Karta zákazníka.

Chcete-li tento problém vyřešit, musíte na stránku WebViewerA přidat vlastnost ZákazníkSourceTable. Příklad této úpravy lze pozorovat ve fragmentech kódu obsahujících CustomerCardExtB a WebViewerB.

V některých případech může být nutné vložit CardPart na více stránek bez odkazování na konkrétní zdrojovou tabulku. Pro takové scénáře doporučujeme vytvořit samostatnou CardPart pro každou stránku, kde také potřebujete generovat metadata a refaktorovat sdílenou logiku 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
            }
        }
    }
}

Vícenásobné rozšíření způsobující kolize

Chcete-li tento problém vyřešit, existují dvě možná řešení:

Deaktivovat rozšíření: Chcete-li zjistit, které rozšíření způsobuje konflikt, můžete rozšíření, která ovlivňují stránku, jedno po druhém deaktivovat. Tento přístup však nemusí být ideální, pokud jsou dotyčná rozšíření nezbytná pro vaše obchodní procesy.
Upravit kód rozšíření: Toto řešení zahrnuje analýzu hlavní příčiny problému a její řešení úpravou kódu konfliktních rozšíření.

Abyste tomuto problému lépe porozuměli, zvažte následující příklad zahrnující stránku Karta zákazníka (ID 21). Když jste na stránce Seznam zákazníků (ID 22) a vyberete Upravit v Excelu, webová služba je generována na pozadí, které odhaluje pole ze stránky Karta zákazníka. Tato webová služba zahrnuje všechna pole stránky definovaná na stránce Karta zákazníka, zatímco pole tabulky se zobrazí pouze v případě, že odpovídají poli stránky nebo jsou součástí primárního klíče.

Když je nainstalováno rozšíření, které rozšiřuje stránku Karta zákazníka, pole přidaná rozšířením se zobrazí také ve webové službě. Rozšíření sice nemohou vytvářet pole stránky se stejnými názvy, jako mají pole již existující na stránce Karta zákazníka, přesto může dojít ke konfliktům, když více rozšíření přidá pole se stejnými názvy.

Předpokládejme například, že je nainstalováno následující rozšíření označované 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) { }
    }
}

Nyní zvažte, že je nainstalováno další rozšíření, označované jako B, které také upravuje stránku Karta zákazníka:

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

V tomto scénáři rozšíření A i B přidají pole stránky s názvem ShoeSize na stránku Karta zákazníka. Tato podmínka vede ke konfliktu, který vede k selhání generování metadat pro stránku Karta zákazníka.

Chcete-li tento problém vyřešit, potřebujete přístup ke kódu alespoň jednoho z rozšíření a poté upravte konfliktní názvy polí stránky, abyste předešli kolizím.

Viz také

Analýza finančních výkazů v Microsoft Excel
Práce s Business Central
Vylepšení integrace Excelu ve vlně 2 vydání 2019

Zde najdete bezplatné e-learningové moduly pro Business Central

Sdílet prostřednictvím

Získání doplňku Business Central pro Excel

Přehled

O doplňku

O nasazení jako správce

Přechod z individuálního získání na centralizované nasazení nebo naopak

Příprava (pouze místně)

Nasaďte doplněk pomocí centralizovaného nasazení

Než začnete

Nastavení centralizovaného nasazení doplňku

Individuální získání: Nainstalujte doplněk ručně pro vlastní použití

Konfigurace připojení Business Central

Příprava zařízení a sítě pro doplněk Excel

Řešení potíží

Známá omezení v obchodní logice

Známá omezení při generování metadat

Jedno rozšíření blokující vytváření metadat

Vícenásobné rozšíření způsobující kolize

Viz také

Váš názor

Další materiály