Przejdź do głównej zawartości

Elementy pakietu

Dostępne elementy zależą od typu połączenia SAP System:

  • Połączenie RFC: Tabele, Tabele wirtualne, Filtry, Repozytoria, Obiekty czasu rzeczywistego oraz Raporty
  • Połączenie OData: wyłącznie Tabele, Tabele wirtualne oraz Filtry. Repozytoria, Obiekty czasu rzeczywistego i Raporty są niedostępne.

Większość sekcji elementu umożliwia wykonanie tych samych czynności:

CzynnośćOpis działania
DodajDodaje nowy wpis do sekcji
Przejdź do, OtwórzPrzenosi do powiązanego elementu w pakiecie
Ikona koła zębategoOtwiera konfigurację wpisu
KoszUsuwa wpis lub Link między dwoma elementami

Jeśli w sekcji znajduje się lista rozwijana, należy jej użyć do wyboru wpisu. Sam element dodaje się dedykowanym przyciskiem u góry. Pozostała część tej strony opisuje wyłącznie te właściwości, które są specyficzne dla danego elementu lub sekcji.


Tabele​

Tabele określają, które tabele SAP zostaną wyeksportowane. Wszystkie dodane tu tabele zostaną później zapisane jako tabele wynikowe.

Dodawanie zależy od rodzaju połączenia pakietu:

  • Połączenie RFC: należy wyszukać tabelę SAP po nazwie lub wpisać ją bezpośrednio, np. T001.
  • Połączenie OData: dodaje się zbiór encji. Zbiór encji to zestaw danych udostępniany przez usługę OData, który dab Nexus traktuje jak tabelę. Należy wyszukać usługę, rozwinąć ją i wybrać zbiór encji. Można też podać pełną ścieżkę, która stanie się nazwą tabeli, np. /sap/opu/odata4/sap/cdi_cds/cdi_cds/sap/i_companycode/0001/MasterData.

Po kliknięciu dodanej tabeli można nadać jej alias (czyli dodatkową nazwę) lub usunąć ją z pakietu za pomocą Kosza.

Typ ładowania​

Typ ładowania jest widoczny tylko dla zbiorów encji OData umożliwiających śledzenie zmian (delta tracking).

  • Pełne ładowanie (Full Load): eksportuje wszystkie dane
  • Delta Load: przy pierwszym uruchomieniu eksportuje wszystkie dane, a przy kolejnych jedynie nowe lub zmienione rekordy. Szczegóły: CDC z SAP OData.

Strategia​

Strategia steruje sposobem zapisu do obszaru docelowego. Ustawienia strategii danych zadania (Task) mogą ją nadpisać: scalanie (Merge) i dodanie (Append) działają tylko wtedy, gdy strategia danych również wykorzystuje scalanie. W przypadku Keep Database - Overwrite przykładowo, tabela z ustawioną strategią Merge zostaje nadpisana. Wszystkie kombinacje opisano w Współdziałanie strategii danych i tabel.

  • Merge: wyeksportowane wiersze są scalane z istniejącymi danymi, które są aktualizowane
  • Overwrite: usuwa tabelę na początku eksportu
  • Append: dodaje nowe dane do już istniejących
  • Layout: tworzy wyłącznie strukturę tabeli w docelowym systemie bez pobierania danych

Pola tabeli​

Należy wybrać pola do eksportu. Klucze podstawowe są zawsze wybrane automatycznie i nie można ich odznaczyć.

  • Lista pól: zawiera wszystkie pola wybranej tabeli. Zaznaczenie/odznaczenie pola decyduje, czy jego dane będą eksportowane.
  • Sortowanie pól: wyświetla pola pogrupowane według: Domyślne (jak w SAP), Wybrane, Nazwa, Opis, Długość pola
  • Odśwież: ponownie wczytuje listę pól
  • Zbiorcze zaznaczenie: zaznacza/odznacza wszystkie pola oprócz kluczy podstawowych
  • Szukaj: umożliwia wyszukiwanie konkretnych pól

Filtry tabel i repozytoria​

Przy połączeniu OData dostępne są tylko Filtry, ponieważ repozytoria nie występują.

Filtry nakładają ograniczenia na wartości pól tabeli. Należy dodać istniejący filtr, wybrać go w polu Filtr i określić pole docelowe za pomocą Field. Przejście do filtra otwiera jego ustawienia.

Dependency pobiera tabelę w zależności od wartości z repozytorium. Należy wybrać istniejące repozytorium z listy Repository. Ikona koła zębatego pozwala zmienić typ zależności lub włączyć Custom Mapping. dab Nexus automatycznie łączy pola, jeśli mają identyczną nazwę w repozytorium i tabeli (uwzględnia wielkość liter). Jeśli nazwy się różnią, należy Link pola ręcznie w Custom Mapping. Typy zależności opisano w Repozytoria – zależności.

Deletion Dependency usuwa wiersze tej tabeli w obszarze docelowym na podstawie wartości z repozytorium. Tabela staje się docelowa dla usuwania. Każda tabela może mieć tylko jedną zależność do usuwania. Należy wybrać istniejące repozytorium z listy Repository. Ikona koła zębatego pozwala uzupełnić mapowanie pól repozytorium do kluczowych pól tabeli. Pełny opis znajduje się w Deletion Dependencies.

Target Repositories zapisują wartości tabeli do repozytorium. Przyciskiem Add dodaje się docelowe repozytorium. Ikona koła zębatego umożliwia dostosowanie mapowania pól przez Custom Mapping – dokładnie tak, jak w przypadku Dependency.


Tabele wirtualne​

Tabele wirtualne są pobierane jak normalne tabele, ale dab Nexus po zakończonej ekstrakcji odrzuca ich dane. Tabele wirtualne nie pojawiają się w tabelach wynikowych.

Z tabeli wirtualnej należy korzystać, jeśli nie zależy Państwu na samych danych, lecz potrzebne są określone wartości do filtrowania innych tabel. Tabela wirtualna zwykle przekazuje te wartości do repozytorium, a tabele docelowe są pobierane w zależności od tych wartości. Mechanizm ten jest przydatny np. podczas pobierania zmian (delta load): tabela wirtualna określa zmienione rekordy, a tabele docelowe eksportują tylko te wybrane.

Dodawanie tabeli wirtualnej przebiega identycznie jak zwykłej tabeli. Można tu również nadać alias. Wszystkie sekcje są takie same jak dla tabel, z wyjątkiem sekcji Strategia, która tu nie występuje.


Filtry​

Filtry umożliwiają ograniczenie pobieranych wartości. Można je stosować do tabel oraz tabel wirtualnych, a także do raportów i obiektów czasu rzeczywistego poprzez relacje.

Nazwę filtra można nadać dowolnie.

Wskazówka

Jeśli zostanie użyta jedna z poniższych nazw filtra, typ filtra automatycznie zostanie ustawiony na Lookup: Fiscal Year, Companycode, Company Code, Time Period

Ustawienia filtra​

  • Required: wartości muszą zostać podane dla tego filtra podczas tworzenia Zadania (Task)
  • Offline: stosowanie filtra po stronie klienta
  • Określanie zakresu filtra (Scope Determination): poziom, na którym podaje się wartości – szczegóły poniżej
  • Data Type: typ danych filtra, do wyboru – String, Date lub Numeric
  • Filter Type:
    • Input: podanie wartości podczas definiowania Zadania
    • Fixed Value: wartości są ustawione na stałe w Pakiecie
    • Lookup: możliwość wyboru wartości w SAP podczas tworzenia Zadania
    • Fiscal Year: podanie roku obrotowego lub ustawienie go zgodnie z harmonogramem Zadania

Określanie zakresu filtra​

Zakres (scope) decyduje, na jakim poziomie wpisuje się wartości filtra przy tworzeniu Zadania. Dotyczy to typów filtra Input, Lookup oraz Fiscal Year. Filtry typu Fixed Value mają już ustawione wartości, więc zakres nie ma dla nich znaczenia.

  • Per Task: jedna wartość dla całego Zadania; stosowane, gdy wartości są takie same dla wszystkich systemów SAP oraz dla wariantu początkowego i Delta.
  • Per SAP System: oddzielne wartości dla każdego SAP System Zadania; stosowane, gdy wartości różnią się w poszczególnych systemach, np. kody firm.
  • Per Variant: oddzielne wartości dla wariantu początkowego oraz Delta; stosowane, gdy pierwszy i następne eksporty wymagają różnych wartości, np. długi zakres dla pierwszego pobrania, krótki dla kolejnych pobrań zmian.
  • Automatic: dab Nexus sam dobiera poziom w zależności od typu filtra. Zalecane, gdy nie potrzeba konkretnego poziomu.

Automatic przydziela poziomy następująco:

Typ filtraPoziom
Input z typem danych DatePer Variant
Input z innym typem danychPer Task
LookupPer SAP System
Fiscal YearPer Variant

Warunek​

Warunek decyduje, jaka klauzula filtra jest generowana.

WarunekOpisPrzykład
EqualObie wartości są równe100 = 100
Not EqualObie wartości są inne100 <> 99
GreaterJedna wartość jest większa od drugiej100 > 99
Greater EqualJedna wartość równa lub większa od drugiej100 >= 99/100
LessJedna wartość jest mniejsza od drugiej99 < 100
Less EqualJedna wartość równa lub mniejsza od drugiej99/100 <= 100
LikeJedna wartość zawiera fragment drugiej%est is contained in Test
Not LikeJedna wartość nie zawiera fragmentu drugiej%ame is not contained in Test
BetweenWartość mieści się w określonym zakresie5 is between 3 and 7
InWartość występuje wśród innych wartościDE exists in the series 'DE, EN, IT, FR'
Not InWartość nie występuje wśród innych wartościDE doesn't exist in the series 'EN, IT, FR'
EmptyWartość (ciąg znaków) musi być pustaValue = ''
Not EmptyWartość (ciąg znaków) musi być wypełnionaValue = 'Here is a text'

Relacje filtrów​

Relacje określają, gdzie filtr ma być zastosowany. W każdej sekcji należy dodać istniejący element i wybrać odpowiednie pola z obu list rozwijanych:

SekcjaZastosowanie filtraCo wybrać
Table RelationsTabeleWybierz tabelę i pole. Możliwe są tylko pola wybrane wcześniej do eksportu z tej tabeli
Report RelationsRaportyWybierz raport i parametr
Real-Time Objects RelationsObiekty czasoweWybierz obiekt czasu rzeczywistego oraz pole

Repozytoria​

Repozytoria przechowują wyniki pośrednie i udostępniają je dla dalszego przetwarzania pomiędzy elementami pakietu.

Nazwa repozytorium jest dowolna.

Repozytoria łączą elementy w określonej kolejności. Tabele źródłowe i obiekty czasu rzeczywistego najpierw zapisują swoje wartości do repozytorium. Tabele docelowe eksportowane są po tabelach źródłowych i pobierają dane zależnie od tych wartości. Repozytorium jest wypełniane na nowo przy każdym uruchomieniu, więc zawiera wyłącznie aktualne wartości.

Praktyka rekomendowana: prosimy utworzyć repozytorium, jeśli wartości z pierwszego eksportu są potrzebne w kolejnych zapytaniach do innych tabel. Przykłady znajdują się w Przewodniku.

Przegląd repozytorium​

W tym miejscu ustala się, z czego składa się repozytorium i skąd pochodzą jego wartości.

Fields to pola, które budują repozytorium. Można dodawać po jednym lub więcej pola jednocześnie.

Source Table wyświetla tabele, których wartości trafiają do repozytorium. Należy dodać tabelę i wybrać ją w polu Select source table. Ikona koła zębatego otwiera mapowanie relacji:

  • Custom Mapping: po włączeniu umożliwia ręczne przypisanie Link między polem tabeli źródłowej, a polem repozytorium
  • Typy relacji (gdy aktywne Custom Mapping):
    • Identity: kopiuje wartość pola tabeli do pola repozytorium
    • Substring: zapisuje część wartości pola do repozytorium
    • Concat: łączy kilka pól tabeli do jednego pola repozytorium

Real-Time Objects wyświetla obiekty czasu rzeczywistego, których wartości trafiają do repozytorium. Należy dodać obiekt czasu rzeczywistego, a następnie wybrać go poprzez Select real-time object. Ikona koła zębatego otwiera ustawienia zależności:

  • Numbers: numer w zakresie numeracji
  • Subobject: podkategoria (najczęściej Company Code, opcjonalnie w zależności od zakresu numeracji)
  • Fiscal Year: rok obrotowy (opcjonalnie, zależnie od zakresu numeracji)

Przykładowo, EINKBELEG dotyczy wyłącznie Numbers, natomiast RF_BELEG może obejmować Numbers, Subobject lub Fiscal Year.

Repozytorium – zależności​

Repozytorium można wykorzystać jako źródło danych dla tabel docelowych. Tabele te są eksportowane zależnie od wartości repozytorium.

Należy dodać tabelę docelową i wybrać ją poprzez Select target table. Ikona koła zębatego umożliwia ustawienie typu zależności oraz Custom Mapping. Custom Mapping służy do powiązania pól repozytorium z polami tabeli docelowej (szczegóły w Filtry tabel i repozytoria).

Typ zależności decyduje o sposobie budowania zapytania:

Typ zależnościOpisPrzykład
InZapytanie ze słowem kluczowym INBELNR IN (1,2,3,4,...)
BetweenZapytanie ze słowem kluczowym BETWEENBELNR Between 1 and 10
OptimizedPołączenie IN oraz BETWEENBELNR between 1 and 5 AND BELNR NOT IN (1,2,3,5)

Dependency usuwające​

Mechanizm zależności usuwających pozwala na usuwanie wierszy z obszaru docelowego, np. jeśli rekordy zostały usunięte w SAP i w przeciwnym razie pozostałyby w Państwa danych delta SAP. Usuwane są tylko wiersze w lokalizacji docelowej – nigdy w SAP.

Obiektem docelowym dla usuwania jest tabela, która ma zależność usuwającą. dab Nexus kasuje wiersze tej tabeli w obszarze docelowym. Repozytorium przekazuje klucze identyfikujące wiersze do usunięcia.

Obiekt docelowy dla usuwania to nie to samo co tabela docelowa. Tabela docelowa wykorzystuje wartości repozytorium do ograniczenia zapytania w SAP, podczas gdy obiekt docelowy dla usuwania używa tych wartości do kasowania wierszy w systemie docelowym.

Przebieg procesu wygląda tak:

  1. Tabela źródłowa zapisuje do repozytorium kluczowe wartości rekordów przeznaczonych do usunięcia. Na przykład, odczytywane są dokumenty zmian, jak CDPOS, z zawężeniem do usuniętych rekordów.
  2. dab Nexus pobiera obiekt docelowy dla usuwania po tabelach źródłowych.
  3. dab Nexus następnie usuwa z obszaru docelowego wiersze, w których przypisane pola kluczowe tabeli pokrywają się z dowolnym rekordem z repozytorium. Jeśli repozytorium jest puste, żadne wiersze nie zostaną usunięte.

Uwaga: usuwane są wszystkie pasujące wiersze, dlatego repozytorium powinno zawierać wyłącznie rekordy naprawdę wymagające usunięcia.

Dependencje usuwające można konfigurować zarówno tutaj, jak i w tabeli (patrz Filtry tabel i repozytoria). Tutaj należy dodać tabelę docelową dla usuwania i wybrać ją w polu Select Table.

Za pomocą ikony koła zębatego dokonuje się mapowania pól repozytorium do pól klucza głównego tabeli docelowej. Obowiązują następujące reguły:

  • Każde pole repozytorium musi być powiązane.
  • Dostępne są wyłącznie pola kluczowe tabeli docelowej.
  • Każde pole kluczowe można użyć tylko raz.

Dependencje usuwające są obsługiwane dla SQL Server, Snowflake oraz Microsoft Fabric (Lakehouse i Mirror) jako środowisk docelowych.


Obiekty czasu rzeczywistego​

Obiekty czasu rzeczywistego pobierają wiele obiektów numeracji z SAP i mogą zapisać ich wartości do repozytorium.

Można dowolnie określić nazwę obiektu czasu rzeczywistego.

Obiekt zakresu numerów i wartości​

Proszę wybrać odpowiedni obiekt zakresu numerów z listy rozwijanej.

W SAP zakresy numerów definiują unikalne ciągi numerów przypisanych do obiektów lub dokumentów (np. faktur, zamówień itp.). Utrzymują one kolejność i zapobiegają powstawaniu duplikatów. Funkcje, z których można korzystać:

  • Dodaj nowy zakres numerów: wybrać jeden lub więcej dostępnych zakresów z SAP. Dostępność zależy od wybranego obiektu zakresu numerów.
    • Dostępne: prezentuje wszystkie zakresy numeracji dostępne w SAP System
    • Wybrane: pokazuje zakresy już wybrane; można je także usunąć
  • Dodaj wartości: ręczne dopisanie nowych wartości
  • Kosz: usuwa wartość z listy

Więcej informacji na temat Obiektów zakresu numerów znajdą Państwo w sekcji Zakresy numerów.

Filtry obiektu czasu rzeczywistego i repozytoria docelowe​

Filtry służą do ograniczania wartości obiektów czasu rzeczywistego. Ich konfiguracja przebiega identycznie jak w przypadku filtrów tabel.

Repozytoria docelowe zapisują wartości obiektów czasu rzeczywistego do repozytorium. Przycisk Add umożliwia dodanie repozytorium docelowego. Ikona koła zębatego pozwala skonfigurować zależność za pomocą pól Numbers, Subobject oraz Fiscal Year (więcej: Przegląd repozytorium).


Raporty​

Raporty pobierają wynik działania raportu SAP (transakcji SAP). Możliwe jest użycie wyłącznie raportów, które generują wynik w postaci tabelarycznej.

Ważne

Raporty nie są dostępne w Managed App z przyczyn technicznych.

Dodając raport, należy podać nazwę raportu (transakcji SAP) w oknie i kontynuować. dab Nexus wczyta dostępne parametry, jeśli istnieją.

Filtry można nakładać na raport identycznie jak w przypadku filtrów tabel.