Publikování webové služby
Webové služby představují nenáročný způsob, jak zpřístupnit funkce aplikace různým druhům externích systémů a uživatelů. Ve výchozím nastavení Business Central zpřístupňuje řadu objektů jako webové služby pro lepší integraci s jinými službami společnosti Microsoft. Podle potřeby můžete přidat další webové služby.
Nastavte webovou službu v Business Central a poté ji publikujte, aby byla dostupná ověřeným uživatelům. Všichni oprávnění uživatelé mají přístup k metadatům webových služeb, ale ke skutečným datům mají přístup pouze uživatelé, kteří mají dostatečná oprávnění.
Vytvoření a publikování webové služby
Následující kroky vysvětlují, jak vytvořit a publikovat webovou službu.
Vytvoření a publikování webové služby
Vyberte ikonu
, zadejte Webové služby a vyberte související odkaz.Na stránce Webové služby vyberte Nový. Umístěním ukazatele myši na pole zobrazíte krátký popis.
Poznámka
Codeunit a Page jsou platné typy pro webové služby SOAP. Page a Query jsou platné typy pro webové služby OData. Počínaje verzí 16.3 je Codeunit také platný typ pro webové služby OData v4, ale pak se v uživatelském rozhraní nezobrazí žádná adresa URL. Pokud databáze obsahuje více společností, můžete také vybrat ID objektu, které je specifické pro jednu ze společností.
A konečně, název služby je viditelný pro spotřebitele vaší webové služby a je základem pro identifikaci a rozlišení webových služeb, takže byste měli dát název smysluplný.Zaškrtněte políčko ve sloupci Publikováno.
Když publikujete webovou službu, v polích URL OData a Adresa URL SOAP se zobrazují nové adresy URL. U codeunit, které jsou vystaveny jako nevázané akce OData v4, se však pole adresy URL nezobrazují.
Webovou službu můžete okamžitě otestovat výběrem odkazů v polích Adresa URL OData a Adresa URL SOAP. Volitelně zkopírujte hodnotu pole a uložte ji pro pozdější použití. Chcete-li otestovat codeunits, které jsou vystaveny jako nevázané akce OData v4, postupujte podle pokynů v části Ověření dostupnosti webové služby v obsahu pro vývojáře.
Poznámka
Pokud objekty, které vystavujete jako webové služby, nesmí být přístupné z Business Central Online, musíte metody vystavené v kódu označit jako [Scope('OnPrem')]. Další informace najdete v tématu Atribut rozsahu.
Po publikování webové služby je tato služba k dispozici externím stranám. Dostupnost této webové služby můžete ověřit pomocí prohlížeče nebo vybrat odkaz v poli OData URL a SOAP URL na stránce Webové služby. Následující postup ukazuje, jak můžete ověřit dostupnost webové služby pro pozdější použití.
Ověření dostupnosti webové služby
V prohlížeči zadejte příslušnou adresu URL. Následující tabulka ukazuje typy adres URL, které můžete zadat pro různé typy webových služeb.
Typ Syntaxe Příklad SOAP https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/WS/*CompanyName*/*entity*/https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/WS/CRONUS%20USA%2C%20Inc./Page/InvoiceDocumentOData V4 https://api.businesscentral.dynamics.com/*version*/*tenant*/Production/ODataV4/Company('*CompanyName*')/*entity*https://api.businesscentral.dynamics.com/v2.0/7acc9d3d-d354-4616-8bbd-c4fc9f2b15b3/Production/ODataV4/Company('CRONUS%20USA%2C%20Inc.')/InvoiceDocument
V názvu společnosti se rozlišují malá a velká písmena.Zkontrolujte informace zobrazené v prohlížeči. Ověřte, že vidíte název webové služby, kterou jste vytvořili.
Když přistupujete k webové službě a chcete zapisovat data zpět do Business Central, musíte zadat název společnosti. Společnost můžete zadat jako součást URI, jak je znázorněno v příkladech; případně zadejte společnost jako součást parametrů dotazu. Například následující URI ukazují na stejnou webovou službu OData a oba jsou platnými URI.
https://api.businesscentral.dynamics.com/v1.0/OData/Company('CRONUS International Ltd.')/Customer
https://api.businesscentral.dynamics.com/v1.0/OData/Customer?company='CRONUS International Ltd.'
Viz také
Správa
Webové služby Business Central pro vývojáře
Limity požadavků OData
Zde najdete bezplatné e-learningové moduly pro Business Central