Publikování webových služeb
Webové služby jsou snadný způsob, jak zpřístupnit funkce aplikace různým externím systémům a uživatelům. Business Central obsahuje řadu objektů, které jsou ve výchozím nastavení vystaveny jako webové služby z důvodu integrace s jinými službami společnosti Microsoft, můžete ale také sami přidat další webové služby.
Webovou službu můžete nastavit v klientu Business Central. Poté musíte webovou službu publikovat, aby byla přes síť dostupná. Uživatelé mohou webové služby najít nasměrováním prohlížeče na umístění serveru a vyžádáním seznamu dostupných služeb. Když publikujete webovou službu, je okamžitě k dispozici v síti pro ověřené uživatele. Všichni oprávnění uživatelé mají přístup k metadatům webových služeb, ale pouze uživatelé, kteří mají dostatečná oprávnění, mají přístup ke skutečným datům.
Vytvoření a publikování webové služby
Následující kroky vysvětlují, jak vytvořit a publikovat webovou službu.
Pro vytvoření a publikování webové služby
Vyberte ikonu
, zadejte Webové služby, a poté vyberte související odkaz.Na stránce Webové služby vyberte Nový. Chcete-li si přečíst krátký popis, umístěte ukazatel myši na pole.
Hinweis
Codeunit a Stránka jsou platné typy webových služeb SOAP. Stránka a Dotaz jsou platné typy webových služeb OData.
Pokud databáze obsahuje více společností, můžete také zvolit ID objektu, které je specifické pro jednu ze společností. Nakonec, je název služby viditelný pro spotřebitele webové služby a je základem pro identifikaci a rozlišování webových služeb, takže byste měli učinit tento název smysluplným.
- Zaškrtněte políčko ve sloupci Publikováno.
Při publikování webové služby v polích OData URL a SOAP URL, zobrazí se adresy URL, které jsou generovány pro webovou službu. Webovou službu můžete okamžitě vyzkoušet výběrem odkazů v polích OData URL a SOAP URL. Volitelně můžete zkopírovat hodnotu pole a uložit jej pro pozdější použití.
Wichtig
U codeunit, které jsou publikovány jako webová služba SOAP, musí být metody vystavěné v codeunitě v kódu označeny jako [External].
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 můžete vybrat odkaz na polích 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.
Do prohlížeče zadejte příslušnou adresu URL. Následující tabulka znázorňuje typy adres URL, které můžete zadat pro různé typy webových služeb.
|Type|Syntax|Example|
|----------------|------|-------| |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/InvoiceDocument| |OData 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
The company name is case-sensitive.|
- Zkontrolujte informace, které se zobrazí v prohlížeči. Ověřte, zda vidíte název webové služby, kterou jste vytvořili.
Při přístupu k webové službě a chcete zapisovat data zpět do Business Central, musíte zadat název společnosti. Společnost můžete určit jako součást URI, jak je uvedeno v příkladech, nebo můžete určit společnost jako součást parametrů dotazu. Například následující URI odkazují na stejnou webovou službu OData a jsou obě platné 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.'