Publikowanie usługi sieci Web

Usługi sieci Web to lekki sposób udostępniania funkcji aplikacji różnym rodzajom systemów zewnętrznych i użytkowników. Domyślnie Business Central uwidacznia wiele obiektów jako usługi sieci Web w celu lepszej integracji z innymi usługami firmy Microsoft. Możesz dodać inne usługi internetowe zgodnie z wymaganiami firmy.

Skonfiguruj usługę sieci Web w Business Central, a następnie opublikuj ją, aby była dostępna dla uwierzytelnionych użytkowników. Wszyscy autoryzowani użytkownicy mogą uzyskiwać dostęp do metadanych usług sieci Web, ale tylko użytkownicy, którzy mają wystarczające uprawnienia, mogą uzyskać dostęp do rzeczywistych danych.

Tworzenie i publikowanie usługi sieci Web

W poniższych krokach wyjaśniono, jak utworzyć i opublikować usługę sieci Web.

Aby utworzyć i opublikować usługę sieci Web

Wybierz ikonę, wprowadź Usługi sieci Web, a następnie wybierz powiązane łącze.
Na stronie Usługi sieci Web wybierz pozycję Nowy. Najedź kursorem na pole, aby przeczytać krótki opis.

Uwaga

Codeunit i Page są prawidłowymi typami dla usług sieci Web SOAP. Strona i Kwerenda są prawidłowymi typami dla usług sieci Web OData. Począwszy od wersji 16.3, Codeunit jest również prawidłowym typem dla usług internetowych OData v4, ale wtedy w interfejsie użytkownika nie jest wyświetlany żaden adres URL. Ponadto, jeśli baza danych zawiera wiele firm, można wybrać identyfikator obiektu, który jest specyficzny dla jednej z firm.
Wreszcie, nazwa usługi jest widoczna dla konsumentów usługi sieci Web i stanowi podstawę do identyfikacji i rozróżnienia usług internetowych, dlatego należy nadać jej znaczenie.
Zaznacz pole wyboru w kolumnie Opublikowane.

Podczas publikowania usługi sieci Web w polach OData URL i SOAP URL są wyświetlane nowe adresy URL. Jednak w przypadku codeunits, które są widoczne jako akcje niezwiązane OData v4, pola ADRESU URL nie są wyświetlane.

Usługę sieci Web można natychmiast przetestować, wybierając łącza w polach Adres URL OData i Adres URL protokołu SOAP. Opcjonalnie skopiuj wartość pola i zapisz ją do późniejszego wykorzystania. Aby przetestować codeunits, które są widoczne jako akcje niezwiązane OData v4, postępuj zgodnie z instrukcjami w sekcji Weryfikowanie dostępności usługi sieci Web w zawartości dewelopera.

Uwaga

Jeśli obiekty uwidaczniane jako usługi sieci Web nie mogą być dostępne z Business Central online, należy oznaczyć metody uwidoczniane w kodzie jako [Scope('OnPrem')]. Aby uzyskać więcej informacji, zobacz Atrybut zakresu.

Po opublikowaniu usługi sieci Web jest ona dostępna dla stron zewnętrznych. Dostępność tej usługi sieci Web można sprawdzić za pomocą przeglądarki lub wybrać łącze w polach Adres URL OData i Adres URL protokołu SOAP na stronie Usługi sieci Web. Poniższa procedura ilustruje sposób sprawdzania dostępności usługi sieci Web do późniejszego użycia.

Aby zweryfikować dostępność usługi sieci Web

W przeglądarce wpisz odpowiedni adres URL. W poniższej tabeli przedstawiono typy adresów URL, które można wprowadzać dla różnych typów usług sieci Web.

Typ	Składnia	Przykład
MYDŁO	`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` W nazwie firmy rozróżniana jest wielkość liter.

Przejrzyj informacje wyświetlane w przeglądarce. Sprawdź, czy widzisz nazwę utworzonej usługi sieci Web.

Gdy uzyskujesz dostęp do usługi sieci Web i chcesz zapisać dane z powrotem do Business Central, musisz określić nazwę firmy. Można określić firmę jako część identyfikatora URI, jak pokazano w przykładach; alternatywnie określ firmę jako część parametrów zapytania. Na przykład następujące identyfikatory URI wskazują tę samą usługę sieci Web OData i oba są prawidłowymi identyfikatorami 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.'

Zobacz też

Administracja
Business Central Web Services dla deweloperów
Limity żądań OData