Table of Contents

Ustawienia odbiorców

Odbiorcą jest firma, która odbiera zestawy danych od firmy głównej. W ten sposób udostępnia usługę sieci Web, z którą łączy się firma główna. Dlatego dla każdej kartoteki odbiorcy należy określić niezbędne parametry połączenia.

Konfigurowanie odbiorców

Aby skonfigurować odbiorcę:

  1. Wybierz ikonę Lightbulb that opens the Tell Me feature, wprowadź Odbiorcy, a następnie wybierz powiązane łącze.

  2. Na stronie Odbiorcy wybierz Nowy, a następnie wypełnij poniższe pola:

    • Nr – Określa unikatowy kod służący do identyfikacji odbiorcy.
    • Opis – Określa tekst służący do identyfikacji odbiorcy.
    • Grupowy odbiorca – Określa, czy odbiorca jest grupowym odbiorcą.
    • Zewnętrzny – Określa, czy używane są wzorce integracji systemów zewnętrznych.
    • Kod języka – Określa kod języka do celów tłumaczenia.
    • Połączenie - Określa typ połączenia między firmą główną a odbiorcą.
      • Usługa sieci Web: połącz za pomocą usług sieci Web.
      • Baza danych: połącz się z odbiorcą w ramach tej samej dzierżawy. Dodatkowe informacje zamieszczono w artykule Połączenie z bazą danych.
      • System zewnętrzny: połącz się z systemami przy użyciu wzorców integracji zewnętrznej. Dodatkowe informacje zamieszczono w artykule Wzorce integracji systemów zewnętrznych.
    Ostrzeżenie

    W przypadku korzystania z Połączenia typu Baza danych, aby wykonać operacje usuwania, należy określić adres usługi sieci Web i poświadczenia.

    • Protokół usługi sieci Web - Określa protokół usługi sieci web. Możliwe opcje to: SOAP, ODataV4.
    • Adres usługi sieci Web - Określa adres usługi sieci Web. Usługa sieci Web ReceiverWS zostanie opublikowana automatycznie. Szczegóły dotyczące tej usługi można znaleźć na liście usług sieci Web w firmie odbiorcy. Adres URL protokołu SOAP należy skopiować, a adres URL protokołu ODataV4 można utworzyć za pomocą przycisku asysty edycji.
    Uwaga

    Adres usługi sieci Web protokołu SOAP musi być zgodny z poniższym wzorcem dla odbiorców Microsoft Dynamics 365 Business Central on-prem:

    http(s)://<SERVER>:<NUMERIC_PORT>/<INSTANCE>/WS/<COMPANY NAME>/Codeunit/ReceiverWS

    Uwaga

    Adres usługi sieci Web protokołu SOAP musi być zgodny z poniższym wzorcem dla odbiorców modelu chmurowego (SaaS) Microsoft Dynamics 365 Business Central:

    https://api.businesscentral.dynamics.com/<API VERSION>/<TENANT ID>/<ENVIRONMENT NAME>/WS/<COMPANY NAME>/Codeunit/ReceiverWS

    Uwaga

    Adres usługi sieci Web protokołu ODATAV4 musi być zgodny z poniższym wzorcem dla odbiorców Microsoft Dynamics 365 Business Central on-prem:

    http(s)://<SERVER>:<NUMERIC_PORT>/<INSTANCE>/ODataV4?company=<COMPANY NAME>

    Uwaga

    Adres usługi sieci Web protokołu ODataV4 musi być zgodny z poniższym wzorcem dla odbiorców modelu chmurowego (SaaS) Microsoft Dynamics 365 Business Central:

    https://api.businesscentral.dynamics.com/<API VERSION>/<TENANT ID>/<ENVIRONMENT NAME>/ODataV4?company=<COMPANY NAME>

    Ważne

    <ENVIRONMENT NAME> i <COMPANY NAME> powinny być zakodowane w adresie URL.

    • Metoda uwierzytelniania - Określa metodę uwierzytelniania usługi sieci Web. Dostępne opcje to:

      • Podstawowe
      • Microsoft Entra

    • Nazwa użytkownika usługi sieci Web – Określa nazwę użytkownika usługi sieci Web (jeśli wybrano uwierzytelnianie podstawowe).

    • Hasło usługi sieci Web – Określa hasło usługi sieci Web (jeśli wybrano uwierzytelnianie podstawowe).

    • Identyfikator klienta – Określa identyfikator klienta (jeśli wybrano uwierzytelnianie Microsoft Entra).

    • Tajny klucz klienta – Określa tajny klucz klienta (jeśli wybrano uwierzytelnianie Microsoft Entra).

    • Identyfikator dzierżawcy — Określa identyfikator dzierżawcy Microsoft Entra (jeśli wybrano uwierzytelnianie Microsoft Entra).

  3. Wybierz akcję Testuj połączenie na pasku akcji.

Metody uwierzytelniania

Metody uwierzytelniania: Podstawowe i Microsoft Entra są dostępne.

Uwierzytelnianie podstawowe

Aby uwierzytelnić usługę sieci Web przy pomocy uwierzytelniania podstawowego, należy określić nazwę użytkownika usługi sieci Web i hasło do usług sieci Web.

W przypadku instalacji on-premises, należy użyć ustawień Nazwa użytkownika oraz Hasło do Business Central. Dodatkowe informacje zamieszczono w artykule Instalacja on-premises.

Dla instalacji online, ustawienie Nazwa użytkownika zostanie użyte jako Nazwa użytkownika usługi sieci Web.
Klucza dostępu do usług sieci Web wygenerowanego na stronie Kartoteka użytkownika (w firmie odbiorcy) należy użyć jako hasła do usług sieci Web.

Uwaga

Wraz z wydaniem aktualizacji Business Central 2022 wave 1 uwierzytelnianie podstawowe stało się przestarzałą metodą. Aby połączyć się z odbiorcą w Microsoft Dynamics 365 Business Central online, należy wykorzystać uwierzytelnianie Microsoft Entra.

Uwierzytelnianie Microsoft Entra

Dodatkowe informacje zamieszczono w sekcji Jak skonfigurować uwierzytelnianie Microsoft Entra?.

Testowanie połączenia

Weryfikacja połączenia usługi sieci Web z firmą odbiorcy jest możliwa przy użyciu akcji Testuj połączenie na stronie Kartoteka odbiorcy.

Wersja MDMS odbiorcy

Pole Wersja MDMS na stronie Kartoteka odbiorcy wskazuje wersję MDMS uruchomioną przez odbiorcę. Pole jest pobierane w trakcie działań typu Testuj połączenie, Zwolnij i Synchronizuj w procesie replikacji. Wartości tego pola używa w celu określenia zgodności między różnymi wersjami oprogramowania MDMS.

Uwaga

Jeśli połączenie nie zostanie nawiązane lub jeśli wersja odbiorcy jest niższa niż 5.5.0.0, w polu Wersja MDMS wyświetlona zostanie wartość Nie dotyczy.

Uwaga

Wartość pola Wersja MDMS nie jest pobierana dla połączenia: System zewnętrzny i Baza danych.

Konfigurowanie odbiorców grupowych

Grupowy odbiorca umożliwia utworzenie pojedynczej replikacji, która wysyła te same dane do wszystkich odbiorców w grupie. Opcji można użyć w sytuacji, gdy grupa firm zawsze otrzymuje te same dane, co ma na celu zaoszczędzenie czasu na konfiguracji i konserwacji replikacji.

Aby przekonwertować istniejącego odbiorcę na odbiorcę grupowego: 1. Otwórz kartotekę odbiorcy dla utworzonego odbiorcy.

  1. Na stronie Odbiorcy przejdź do skróconej karty Ogólne i oznacz następujące pola jako Prawda: Grupowy odbiorca.

  2. Na stronie Odbiorcy przejdź do skróconej karty Wiersze odbiorcy grupowego i dodaj innych odbiorców do grupy.

Kiedy proces replikacji jest uruchomiony dla odbiorcy grupowego, tworzone są zapisy synchronizacji rekordów dla każdego wiersza odbiorcy.

Jak skonfigurować odbiorcę grupowego](https://www.youtube.com/watch?v=XDmN22PSw0s)

Aktualizacja seryjna szczegółów uwierzytelniania

Możliwe jest aktualizowanie szczegółów uwierzytelniania wielu odbiorców jednocześnie za pomocą akcji Aktualizuj seryjnie poświadczenia ... na stronie Odbiorcy.

Aby uruchomić akcję Aktualizuj seryjnie poświadczenia ...:

  1. Wybierz ikonę Lightbulb that opens the Tell Me feature, wprowadź Odbiorcy, a następnie wybierz powiązane łącze.
  2. Wybierz akcję Aktualizuj seryjnie poświadczenia ... na pasku akcji.
  3. Wprowadź następujące informacje na stronie żądania:
    • Typ uwierzytelniania - Określa typ uwierzytelniania wszystkich odbiorców, którzy mają zostać zaktualizowani.

Uwierzytelnianie Microsoft Entra:

  • Identyfikator dzierżawcy - Określa identyfikator dzierżawcy wszystkich odbiorców, którzy mają zostać zaktualizowani.
  • Identyfikator klienta - Określa identyfikator klienta wszystkich odbiorców, którzy mają zostać zaktualizowani.
  • Klucz tajny klienta - Określa klucz tajny klienta wszystkich odbiorców, którzy mają zostać zaktualizowani.

Uwierzytelnianie podstawowe:

  • Nazwa użytkownika - Określa nazwę użytkownika usługi sieci Web wszystkich odbiorców, którzy mają zostać zaktualizowani.
  • Hasło - Określa hasło usługi sieci Web wszystkich odbiorców, którzy mają zostać zaktualizowani.
  1. Ustaw filtry na skróconej karcie Odbiorca na stronie żądania, aby filtrować odbiorców.
  2. Wybierz przycisk OK, aby uruchomić zadanie wsadowe.
Uwaga

Pole Nr odbiorcy źródłowego w żądaniu raportu umożliwia określenie odbiorcy, od którego kopiowane są szczegóły uwierzytelniania.

Testowanie seryjne połączenia

Możliwe jest przetestowanie połączenia z wieloma odbiorcami jednocześnie za pomocą akcji Testuj seryjnie połączenie na stronie Odbiorcy.

Aby uruchomić akcję Testuj seryjnie połączenie:

  1. Wybierz ikonę Lightbulb that opens the Tell Me feature, wprowadź Odbiorcy, a następnie wybierz powiązane łącze.
  2. Wybierz akcję Testuj seryjnie połączenie na pasku akcji.
  3. Wprowadź filtry odbiorców na karcie Odbiorcy na stronie żądania.
  4. Wybierz przycisk OK, aby wykonać połączenie testowe.
  5. Przejrzyj listę błędów lub zamknij komunikat potwierdzający powodzenie połączenia.

Konfigurowanie zewnętrznych odbiorców

Dodatkowe informacje zamieszczono w artykule Wzorce integracji systemów zewnętrznych.