Rozpoznawanie dokumentów osoby fizycznej

Przegląd

Funkcja Rozpoznawanie dokumentów osoby fizycznej umożliwia automatyczne tworzenie lub aktualizację karty osoby fizycznej na podstawie skanu lub zdjęcia dokumentu tożsamości. System wykorzystuje Azure Content Understanding (AI) do wyodrębniania danych z dokumentu i wypełniania pól karty.

Rozwiązanie jest uniwersalne — obsługuje dowolny typ dokumentu osobistego (paszporty, dowody osobiste, karty pobytu, prawa jazdy itp.) z dowolnego kraju. Analizator w Azure AI Foundry konfigurujesz pod dokumenty istotne dla Twojej działalności.

Obsługiwane formaty plików: PDF, JPG, JPEG, PNG.

Wymagania wstępne

Muszą być zainstalowane następujące rozszerzenia:

• SMART Azure Document Intelligence — zapewnia połączenie z Azure Content Understanding
• SMART Person Document Recognition — dostarcza kreator rozpoznawania i logikę integracji

W Azure musi być skonfigurowany zasób Azure AI Foundry z usługą Content Understanding oraz utworzony analizator do rozpoznawania dokumentów.

Konfiguracja

Krok 1. Utworzenie zasobu Azure AI Foundry i analizatora

Przed konfiguracją Business Central należy przygotować zasoby w Azure:

1. Utwórz zasób Azure AI Foundry (lub Azure AI Services) w Azure Portal.
2. Otwórz portal Azure AI Foundry i przejdź do swojego projektu.
3. W sekcji Content Understanding utwórz nowy Analyzer (analizator):
   • Wybierz typ analizatora — Document (dla dokumentów tożsamości).
   • Nadaj nazwę analizatora (np. person-id-card).
4. W schemacie analizatora dodaj pola (Field Schema), podając nazwę pola (Field Name) i opis (Field Description) — co dokładnie wyodrębnić z dokumentu. Lista obsługiwanych pól znajduje się w sekcji Konfiguracja analizatorów poniżej.
5. Zapisz i zbuduj (Build) analizator.
6. Przetestuj analizator na portalu Azure AI Foundry, przesyłając przykładowy dokument.

Po tym będziesz potrzebować:

• Endpoint URL — adres URL punktu końcowego zasobu (znajdziesz w Azure Portal → Twój zasób → Keys and Endpoint)
• API Key — klucz dostępu (Key 1 lub Key 2 z tej samej strony)

Krok 2. Konfiguracja Azure Content Understanding w Business Central

1. Wyszukaj stronę Azure Content Understanding Setup w Business Central.
2. Wypełnij:
   • Endpoint URL — adres URL punktu końcowego z Azure Portal
   • API Key — klucz dostępu (przechowywany bezpiecznie w Isolated Storage)
   • API Version — 2025-11-01 (domyślnie)
3. Jeśli analizator korzysta z własnych wdrożeń modeli (LLM), wypełnij sekcję Foundry Model Deployments:
   • Model Deployment 1 — nazwa wdrożenia głównego modelu językowego (np. gpt-4o)
   • Model Deployment 2 — nazwa wdrożenia zapasowego modelu (opcjonalnie)
   • Model Deployment 3 — nazwa wdrożenia modelu embedding (opcjonalnie)

Jeśli podczas tworzenia analizatora użyto standardowych modeli Azure AI Foundry, pola Model Deployment można pozostawić puste.

Ustawienia przetwarzania asynchronicznego

Na tej samej stronie, w sekcji Async Processing, można skonfigurować zachowanie przetwarzania w tle:

Pole	Opis	Domyślnie
Async Processing Enabled	Włącz przetwarzanie w tle (zalecane)	Tak
Polling Interval (Seconds)	Interwał sprawdzania statusu, 1–60 s	5
Max Polling Duration (Minutes)	Maksymalny czas oczekiwania, 1–1440 min	30

Krok 3. Synchronizacja analizatorów

1. Na stronie Azure Content Understanding Setup kliknij akcję Sync Analyzers.
2. System pobierze listę dostępnych analizatorów z Azure i zapisze je w Business Central.
3. Sprawdź listę na stronie Analyzers (dostępna przez nawigację ze strony Setup).

Krok 4. Konfiguracja scenariusza

1. Otwórz Azure CU Scenario Setup (dostępna przez nawigację ze strony Setup lub wyszukiwanie).
2. Utwórz rekord:
   • Scenario = Person Document
   • Analyzer ID = wybierz analizator utworzony do rozpoznawania dokumentów
3. Ten scenariusz będzie używany domyślnie przy rozpoznawaniu.
4. Aby zweryfikować — kliknij Test Scenario, prześlij testowy dokument i upewnij się, że analiza przebiegła pomyślnie.

Krok 5 (opcjonalnie). Analizator dla konkretnego typu dokumentu

Jeśli różne typy dokumentów wymagają różnych analizatorów:

1. Otwórz katalog Person Document Types (typy dokumentów osoby fizycznej).
2. W polu Analyzer ID wybierz konkretny analizator dla danego typu dokumentu.
3. Jeśli wypełnione — ten analizator ma priorytet nad scenariuszem.

Priorytet wyboru analizatora: Analyzer ID na typie dokumentu → Scenariusz → błąd, jeśli nic nie jest skonfigurowane.

Tworzenie osoby fizycznej z dokumentu

1. Otwórz Kartę osoby fizycznej lub listę osób fizycznych.
2. Przejdź do Dokumenty osoby fizycznej i kliknij Create from Document.
3. Otworzy się kreator rozpoznawania:

Krok 1 — Przesyłanie

• Wybierz Typ dokumentu osoby fizycznej (paszport, dowód osobisty itp.).
• Kliknij Upload File, aby przesłać PDF lub obraz, lub Upload Photo, aby zrobić zdjęcie aparatem.
• Dla dokumentów dwustronnych — prześlij obie strony. System automatycznie połączy obrazy w jeden PDF.
• Kliknij Next, aby rozpocząć analizę.

Krok 2 — Przetwarzanie

• Dokument jest wysyłany do Azure Content Understanding do analizy AI.
• Przetwarzanie odbywa się w tle — interfejs pozostaje dostępny.
• Po zakończeniu analizy kreator automatycznie przechodzi do kroku przeglądu.

Krok 3 — Przegląd i edycja

• Rozpoznane pola i ich wartości wyświetlane są w tabeli.
• Możesz edytować dowolną wartość przed zapisaniem — aby poprawić błędy rozpoznawania.
• Kliknij Finish, aby utworzyć lub zaktualizować rekord.

Co się dzieje po kliknięciu Finish

System:

1. Szuka istniejącej osoby fizycznej na podstawie numeru identyfikacyjnego (PESEL) i/lub daty urodzenia.
2. Jeśli znaleziono — pyta, czy zaktualizować istniejącą osobę, czy utworzyć nową.
3. Jeśli nie znaleziono — tworzy nową kartę osoby fizycznej.
4. Wypełnia następujące pola z rozpoznanych danych:

Pole	Źródło
Imię	FirstName (konwertowane na poprawną wielkość liter)
Drugie imię	MiddleName (konwertowane na poprawną wielkość liter)
Nazwisko	LastName (konwertowane na poprawną wielkość liter)
Imię (English)	FirstNameEnglish
Drugie imię (English)	MiddleNameEnglish
Nazwisko (English)	LastNameEnglish
Data urodzenia	BirthDate
Płeć	Sex (F/M odpowiednio Female/Male)
Obywatelstwo	Nationality (ustalane przez kod ISO lub nazwę kraju)
PESEL	PersonalNumber

5. Tworzy rekord dokumentu osoby fizycznej (numer dokumentu, data wydania, data ważności, organ wydający, numer rekordu).
6. Dołącza przesłane pliki jako załączniki dokumentu.

Obsługa duplikatów dokumentów

Jeśli dokument osoby fizycznej o tym samym typie i numerze już istnieje, system oferuje:

• Update Existing — zastąpienie danych i załącznika w istniejącym dokumencie
• Create New — utworzenie nowego rekordu dokumentu

Wykrywanie zmiany imienia i nazwiska

Jeśli rozpoznane imię i nazwisko różni się od aktualnych danych osoby fizycznej, system oferuje trzy opcje:

• Ignoruj — zachowaj aktualne imię i nazwisko
• Aktualizuj imię i nazwisko — bezpośrednio zaktualizuj dane na karcie osoby
• Raport zmiany imienia i nazwiska — uruchom raport do formalnego udokumentowania zmiany

Konfiguracja analizatorów

Możesz skonfigurować analizatory w Azure AI Foundry do rozpoznawania dowolnego typu dokumentu.

Tworzenie analizatora w Azure AI Foundry

1. Otwórz Azure AI Foundry → Twój projekt → Content Understanding.
2. Kliknij Create Analyzer → wybierz typ Document.
3. Nadaj nazwę analizatora (np. person-passport, person-id-card).
4. W sekcji Field Schema dodaj pola z poniższej tabeli.
5. Dla każdego pola podaj:
   • Field Name — nazwa z tabeli (np. FirstName). Nazwa musi dokładnie się zgadzać, ponieważ system wyszukuje pola po tych nazwach.
   • Field Description — opis tego, co wyodrębnić z dokumentu. Im bardziej szczegółowy opis, tym dokładniej analizator wyodrębni dane. Na przykład: "Person's first name as printed on the document".
6. Kliknij Build, aby zbudować analizator.
7. Przetestuj wynik, przesyłając przykładowy dokument.

Obsługiwane pola

Schemat pól analizatora powinien zawierać następujące nazwy pól do prawidłowego mapowania:

Nazwa pola	Opis	Wymagane
FirstName	Imię (w języku dokumentu)	Tak
LastName	Nazwisko (w języku dokumentu)	Tak
MiddleName	Drugie imię / imię ojca	Nie
FirstNameEnglish	Imię po angielsku (jeśli obecne na dokumencie)	Nie
MiddleNameEnglish	Drugie imię po angielsku	Nie
LastNameEnglish	Nazwisko po angielsku	Nie
BirthDate	Data urodzenia	Nie
Sex	Płeć (F/M)	Nie
Nationality	Obywatelstwo	Nie
CountryRegion	Kod kraju	Nie
PersonalNumber	PESEL / numer identyfikacyjny	Nie
DocumentNumber	Numer dokumentu	Nie
IssueDate	Data wydania dokumentu	Nie
ExpirationDate	Data ważności dokumentu	Nie
IssuingAuthority	Organ wydający	Nie
PlaceOfBirth	Miejsce urodzenia	Nie
PlaceOfIssue	Miejsce wydania	Nie
DocumentType	Typ dokumentu	Nie
MachineReadableZone	Strefa MRZ (dla paszportów)	Nie
Aliases	Alternatywne imiona i nazwiska	Nie

Możesz dodawać lub usuwać pola odpowiednio do typu dokumentu. Wypełniane są tylko te pola, które występują w wyniku analizy. Nazwy pól rozróżniają wielkość liter — wpisuj je dokładnie tak, jak w tabeli.