STRUCT-COUNTRY-VALUE - kolumny kraju przyjmują wyłącznie kody z list krajów EBA (B_01.01, B_01.02, B_01.03, B_02.02, B_05.01)

Oficjalny tekst kontroli (EBA, verbatim)

Extensible main property and explicit key dimension must only be reported with one of the restricted value of a hierarchy

Źródło: kontrola techniczna EBA 503 (arkusz "DPM Technical Checks", kategoria "DPM Technical Checks" w oficjalnym zestawieniu kontroli technicznych RoI). RoI Builder wykonuje ją jako kontrolę strukturalną STRUCT-COUNTRY-VALUE.

Co sprawdza ta reguła

Kontrola obejmuje kolumny typu kraj. Pomiar w eba-4.0-errata5: 8 kolumn - c0030 (Country of the entity - kraj podmiotu) w B_01.01 i B_01.02; c0040 (kraj oddziału) w B_01.03; c0120 (kraj prawa właściwego ustalenia umownego), c0130 (kraj świadczenia usług ICT), c0150 (lokalizacja danych w spoczynku - przechowywanie) i c0160 (lokalizacja zarządzania danymi - przetwarzanie) w B_02.02; c0080 (kraj siedziby dostawcy) w B_05.01.

Każda niepusta komórka musi być jednym z kodów krajów dozwolonych dla TEJ kolumny - wszystkie kody żyją w przestrzeni eba_GA i kodują domenę ISO 3166 alpha-2 (np. eba_GA:PL dla Polski). Pomiar: kolumny danych używają list 251-kodowych (słowniki ei1355, ei1555, ei1556), a trzy kolumny kluczowe B_02.02 (c0130, c0150, c0160) list 252-kodowych, które dodatkowo niosą eba_GA:qx2007 ("Not applicable" - nie dotyczy) - qx2007 jest więc ważny WYŁĄCZNIE w tych trzech kolumnach kluczowych.

Pusta komórka jest tu pomijana; pustość trzech kolumn kluczowych B_02.02 to STRUCT-MANDATORY. Porównanie jest dokładne, z kodami verbatim: goły kod ISO (PL) ani nazwa kraju nie pasują.

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

• Goły kod ISO bez prefiksu: PL zamiast eba_GA:PL.
• Nazwa kraju wpisana tekstem: Polska zamiast eba_GA:PL.
• eba_GA:qx2007 ("Not applicable") użyty w kolumnie danych (np. c0030 w B_01.02), gdzie nie ma go na liście.

Jak to naprawić, krok po kroku

1. Otwórz wskazany szablon i znajdź wiersz - wynik walidacji podaje numer wiersza, wartości klucza i błędną wartość.
2. Wpisz kraj jako kod z prefiksem z listy właściwej dla tej kolumny, np. eba_GA:PL; wynik walidacji pokazuje przykładowe dozwolone kody.
3. Wyłącznie dla trzech kolumn kluczowych B_02.02 (c0130, c0150, c0160): jeśli wymiar naprawdę nie ma zastosowania, lista niesie eba_GA:qx2007 ("Not applicable").
4. Uruchom walidację ponownie i potwierdź, że naruszenie zniknęło.

Przykład: błędnie vs poprawnie

Błędnie - goły kod ISO; wynik walidacji wskazuje kolumnę c0030 tego wiersza B_01.02:

c0010 (LEI podmiotu)	c0030 (kraj podmiotu)
549300Q5EH2NP82EPE32	PL

Poprawnie - kod EBA z prefiksem:

c0010 (LEI podmiotu)	c0030 (kraj podmiotu)
549300Q5EH2NP82EPE32	eba_GA:PL

Przypadek brzegowy - eba_GA:qx2007 ("Not applicable") przechodzi w kolumnach kluczowych B_02.02 c0130/c0150/c0160 (ich listy 252-kodowe go niosą), a nie przechodzi w c0030 w B_01.02 (lista 251-kodowa go nie ma).

Powiązane reguły

• STRUCT-ENUM-VALUE - ta sama kontrola EBA 503 na 30 ogólnych kolumnach słownikowych.
• STRUCT-CURRENCY-VALUE - ta sama kontrola EBA 503 na kolumnach waluty.
• STRUCT-MANDATORY - pustość kolumn kluczowych B_02.02 c0130/c0150/c0160 raportowana jest tam.
• VR_16 - kontrola jakości danych W3 porównująca c0030 w B_01.02 z referencją krajów GLEIF (nigdy nie blokuje).