© navision.pl | Opracowano na podstawie: Microsoft Learn (CC BY 4.0)
Publikowanie usługi internetowej
Usługi internetowe to lekki sposób udostępniania funkcji aplikacji różnym rodzajom systemów zewnętrznych i użytkowników. Domyślnie Business Central udostępnia kilka obiektów jako usługi internetowe w celu lepszej integracji z innymi usługami Microsoft. Możesz dodać inne usługi internetowe zgodnie z wymaganiami firmy.
Skonfiguruj usługę internetową w Business Central, a następnie opublikuj usługę internetową, aby była dostępna dla uwierzytelnionych użytkowników. Wszyscy autoryzowani użytkownicy mogą uzyskać dostęp do metadanych usług internetowych, ale tylko użytkownicy z wystarczającymi uprawnieniami mogą uzyskać dostęp do rzeczywistych danych.
Tworzenie i publikowanie usługi internetowej
Poniższe kroki wyjaśniają, jak utworzyć i opublikować usługę internetową.
Aby utworzyć i opublikować usługę internetową
- Wybierz Szukaj (Alt+Q)
w prawym górnym rogu, wprowadź Usługi internetowe, a następnie wybierz powiązane łącze. - Na stronie Usługi internetowe wybierz Nowy. Najedź kursorem na pole, aby przeczytać krótki opis.
Uwaga
Codeunit and Page are valid types for SOAP web services. Page and Query are valid types for OData web services. Starting with version 16.3, Codeunit is also a valid type for OData v4 web services, but then no URL is shown in the user interface. Also, if the database contains multiple companies, you can choose an object ID that's specific to one of the companies. Finally, the service name is visible to consumers of your web service and is the basis for identifying and distinguishing web services, so you should make the name meaningful.
- Zaznacz pole wyboru w kolumnie Opublikowane.
Po opublikowaniu usługi internetowej pola Adres URL OData i Adres URL SOAP pokazują nowe adresy URL. Jednak dla codeunitów udostępnianych jako niepowiązane akcje OData v4 pola adresów URL nie są wyświetlane.
Możesz natychmiast przetestować usługę internetową, wybierając łącza w polach Adres URL OData i Adres URL SOAP. Opcjonalnie skopiuj wartość pola i zapisz ją do późniejszego użycia. Aby przetestować codeunity udostępniane jako niepowiązane akcje OData v4, postępuj zgodnie z instrukcjami w sekcji Verifying web service availability w dokumentacji deweloperskiej.
Uwaga
Jeśli obiekty udostępniane jako usługi internetowe nie powinny być dostępne z Business Central online, musisz oznaczyć metody udostępniane w kodzie jako [Scope('OnPrem')]. Dowiedz się więcej w Scope Attribute.
Po opublikowaniu usługi internetowej jest ona dostępna dla podmiotów zewnętrznych. Możesz zweryfikować dostępność tej usługi internetowej za pomocą przeglądarki lub wybrać łącze w polach Adres URL OData i Adres URL SOAP na stronie Usługi internetowe. Poniższa procedura ilustruje, jak można zweryfikować dostępność usługi internetowej do późniejszego użycia.
Aby zweryfikować dostępność usługi internetowej
-
W przeglądarce wprowadź odpowiedni adres URL. Poniższa tabela ilustruje typy adresów URL, które można wprowadzić dla różnych typów usług internetowych.
[!div class="mx-tdBreakAll"] |Typ|Składnia|Przykład| |----------|---|----| |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.| -
Przejrzyj informacje wyświetlane w przeglądarce. Sprawdź, czy widzisz nazwę utworzonej usługi internetowej.
Podczas uzyskiwania dostępu do usługi internetowej i zapisywania danych z powrotem do Business Central musisz określić nazwę firmy. Możesz określić firmę jako część identyfikatora URI, jak pokazano w przykładach; alternatywnie możesz określić firmę jako część parametrów zapytania. Na przykład poniższe identyfikatory URI wskazują na tę samą usługę internetową OData i oba są prawidłowymi identyfikatorami URI.
Powiązane informacje
Zadania administracyjne w Business Central
Business Central Web Services for developers
OData request limits
Znajdź bezpłatne moduły e-learningowe dla Business Central tutaj