STRUCT-FK - odwołania międzyszablonowe muszą znajdować cel (B_01.02, B_01.03, B_02.01, B_02.02, B_02.03, B_03.01, B_03.02, B_03.03, B_04.01, B_05.01, B_05.02, B_06.01, B_07.01)

Oficjalny tekst kontroli (EBA, verbatim)

The reported data must follow the key-foreign key contraints defined in the DPM

Źródło: kontrola techniczna EBA 807 (arkusz "Technical checks", kategoria "Additional Plain-csv" w oficjalnym zestawieniu kontroli technicznych RoI). RoI Builder wykonuje ją jako kontrolę strukturalną STRUCT-FK.

Uwaga do oficjalnego tekstu kontroli: artefakt EBA publikuje ten tekst z literówką "contraints". Strona dokumentuje tekst dokładnie tak, jak go opublikowano; kontrola działa dokładnie tak, jak ją opublikowano.

Co sprawdza ta reguła

Kontrola egzekwuje 22 relacje klucz-klucz obcy (R1-R22) zdefiniowane w paczce taksonomii, w tym 2 relacje złożone i 3 samoodwołania na kolumnach danych (c0060 w B_01.02, c0030 w B_02.01, c0110 w B_05.01). Typowe relacje: numer referencyjny ustalenia umownego wiersza podrzędnego (B_02.03, B_03.01, B_03.02, B_03.03, B_04.01, B_05.02, B_07.01) musi istnieć jako c0010 w B_02.01; LEI podmiotu podpisującego w B_03.01 musi istnieć jako c0010 w B_01.02; kod dostawcy użyty w łańcuchu dostaw (B_05.02) musi istnieć jako c0010 w B_05.01.

Dla każdego wiersza źródłowego wskazywana wartość (albo kombinacja wartości, przy relacjach złożonych) musi trafić w istniejący wiersz szablonu docelowego po jego kluczu naturalnym. Naruszenie kotwiczy się w wierszu ŹRÓDŁOWYM, wskazuje pierwszą kolumnę źródłową relacji i niesie nazwę relacji verbatim, szablon docelowy oraz błędne wartości. To jedyna mechanika międzyszablonowa stosu walidacji - pomiar: W2 nie ma żadnej reguły międzyszablonowej.

Obsługa pustych wartości (przejściowa, udokumentowana w specu mapowania jako punkt otwarty oficjalnych artefaktów): odwołanie z JAKIMKOLWIEK pustym składnikiem źródłowym jest pomijane, nigdy nie raportowane. Nic zasadnego nie ucieka - puste kolumny KLUCZOWE już blokują przez STRUCT-MANDATORY, a trzy kolumny danych niosące samoodwołania to pola opcjonalne.

To kontrola strukturalna (warstwa STRUCT, severity: blocking). Jej niezaliczenie oznacza techniczne odrzucenie paczki przy przyjęciu (feedbackMain = REJECTED). Warstwa strukturalna jest jedyną warstwą blokującą złożenie.

Najczęstsze przyczyny

• Wiersz podrzędny wprowadzono najpierw, a wiersz docelowy nigdy nie powstał - np. ustalenie umowne wskazywane w B_03.01 nigdy nie trafiło do B_02.01.
• Literówka w komórce odwołania: wartość różni się od klucza docelowego jednym znakiem (dopasowanie jest dokładne).
• Wiersz docelowy usunięto (albo przenumerowano) już po utworzeniu wierszy, które się na niego powołują.

Jak to naprawić, krok po kroku

1. Otwórz wskazany wiersz źródłowy - naruszenie podaje szablon, wiersz, kolumnę i nazwę relacji z szablonem docelowym (np. "must match_B_02.01").
2. Sprawdź, czy wiersz docelowy istnieje w szablonie docelowym z dokładnie tą wartością klucza.
3. Albo dodaj brakujący wiersz docelowy (np. wprowadź ustalenie umowne do B_02.01), albo popraw komórkę odwołania w wierszu źródłowym na istniejący klucz.
4. Przy relacjach złożonych (np. B_02.02 do B_06.01: identyfikator funkcji plus LEI podmiotu) upewnij się, że KAŻDY składnik trafia w ten sam wiersz docelowy.
5. Uruchom walidację ponownie i potwierdź, że naruszenie zniknęło.

Przykład: błędnie vs poprawnie

Błędnie - B_02.01 (cel) zawiera tylko ustalenie CTR-1, a wiersz B_03.01 (źródło) wskazuje CTR-2. Naruszenie kotwiczy się w wierszu B_03.01, kolumna c0010, relacja "R10 Contractual arr. reference number must match_B_02.01":

B_02.01 (cel):

c0010 (numer referencyjny ustalenia umownego)
CTR-1

B_03.01 (źródło, oznaczone):

c0010 (numer referencyjny ustalenia umownego)	c0020 (LEI podmiotu podpisującego ustalenie umowne)
CTR-2	549300Q5EH2NP82EPE32

Poprawnie - albo dodaj wiersz CTR-2 do B_02.01, albo popraw c0010 wiersza B_03.01 na CTR-1.

Powiązane reguły

• STRUCT-KEY-UNIQUE - odwołania rozwiązują się po kluczach naturalnych szablonu docelowego; te klucze muszą być unikalne.
• STRUCT-MANDATORY - puste komórki klucza raportowane są tam; odwołania z pustym składnikiem źródłowym są tu pomijane.
• STRUCT-EMPTY-REGISTER - przy zupełnym braku danych rejestr zatrzymuje się tam, zanim jakiekolwiek odwołanie zostanie zbadane.