Rozpoznawanie dokumentów osób fizycznych
Przegląd
Funkcja Rozpoznawanie dokumentów osobowych 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:
- Utwórz zasób Azure AI Foundry (lub Azure AI Services) w Azure Portal.
- Otwórz portal Azure AI Foundry i przejdź do swojego projektu.
- W sekcji Content Understanding utwórz nowy Analizator:
- Wybierz typ analizatora — Dokument (dla dokumentów tożsamości).
- Nadaj nazwę analizatora (np.
person-id-card).
- W schemacie analizatora dodaj pola (Schemat pól), 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. - Zapisz i zbuduj (Build) analizator.
- Przetestuj analizator na portalu Azure AI Foundry, przesyłając przykładowy dokument.
Po zakończeniu konfiguracji będą potrzebne następujące dane:
- Adres URL punktu końcowego — adres URL (znajdziesz w Azure Portal → Twój zasób → Keys and Endpoint)
- Klucz API — klucz dostępu (Key 1 lub Key 2 z tej samej strony)
Krok 2. Konfiguracja Azure Content Understanding w Business Central
- Wyszukaj stronę Ustawienia Azure Content Understanding w Business Central.
- Wypełnij:
- Adres URL punktu końcowego — adres URL z Azure Portal
- Klucz API — klucz dostępu (przechowywany bezpiecznie w Isolated Storage)
- Wersja API —
2025-11-01(domyślnie)
- Jeśli analizator korzysta z własnych wdrożeń modeli (LLM), wypełnij sekcję Wdrożenia modeli Foundry:
- Wdrożenie modelu 1 — nazwa wdrożenia głównego modelu językowego (np.
gpt-4o) - Wdrożenie modelu 2 — nazwa wdrożenia zapasowego modelu (opcjonalnie)
- Wdrożenie modelu 3 — nazwa wdrożenia modelu embeddingowego (opcjonalnie)
- Wdrożenie modelu 1 — nazwa wdrożenia głównego modelu językowego (np.
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 Przetwarzanie asynchroniczne, można skonfigurować zachowanie przetwarzania w tle:
| Pole | Opis | Domyślnie |
|---|---|---|
| Przetwarzanie asynchroniczne włączone | Włącz przetwarzanie w tle (zalecane) | Tak |
| Interwał odpytywania (sekundy) | Interwał sprawdzania statusu, 1–60 s | 5 |
| Maksymalny czas odpytywania (minuty) | Maksymalny czas oczekiwania, 1–1440 min | 30 |
Krok 3. Synchronizacja analizatorów
- Na stronie Ustawienia Azure Content Understanding kliknij akcję Synchronizuj analizatory.
- System pobierze listę dostępnych analizatorów z Azure i zapisze je w Business Central.
- Sprawdź listę na stronie Analizatory (dostępna przez nawigację ze strony Setup).
Krok 4. Konfiguracja scenariusza
- Otwórz Ustawienia scenariuszy Azure CU (dostępna przez nawigację ze strony Ustawienia lub wyszukiwanie).
- Utwórz rekord:
- Scenariusz =
Dokument osobowy - Identyfikator analizatora = wybierz analizator utworzony do rozpoznawania dokumentów
- Scenariusz =
- Ten scenariusz będzie używany domyślnie przy rozpoznawaniu.
- Aby zweryfikować — kliknij Testuj scenariusz, 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:
- Otwórz katalog Typy Dokumentów Osoby.
- W polu Identyfikator analizatora wybierz konkretny analizator dla danego typu dokumentu.
- Jeśli wypełnione — ten analizator ma priorytet nad scenariuszem.
Priorytet wyboru analizatora: Identyfikator analizatora na typie dokumentu → Scenariusz → błąd, jeśli nic nie jest skonfigurowane.
Tworzenie osoby fizycznej na podstawie dokumentu
- Otwórz Kartę osoby fizycznej lub listę osób fizycznych.
- Przejdź do Dokumenty osoby fizycznej i kliknij Utwórz z dokumentu.
- Otworzy się kreator rozpoznawania:
Krok 1 — Przesyłanie
- Wybierz Typ dokumentu osobowego (paszport, dowód osobisty itp.).
- Kliknij Prześlij plik, aby przesłać PDF lub obraz, lub Zrób zdjęcie, aby zrobić zdjęcie aparatem.
- Dla dokumentów dwustronnych — prześlij obie strony. System automatycznie połączy obrazy w jeden PDF.
- Kliknij Dalej, 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 Zakończ, aby utworzyć lub zaktualizować rekord.
Co się dzieje po kliknięciu Zakończ
System:
- Szuka istniejącej osoby fizycznej na podstawie numeru identyfikacyjnego (PESEL) i/lub daty urodzenia.
- Jeśli znaleziono — pyta, czy zaktualizować istniejącą osobę, czy utworzyć nową.
- Jeśli nie znaleziono — tworzy nową kartę osoby fizycznej.
- 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 (K/M odpowiednio Kobieta/Mężczyzna) |
| Obywatelstwo | Nationality (określane na podstawie kodu ISO lub nazwy kraju) |
| PESEL | PersonalNumber |
- Tworzy rekord dokumentu osoby fizycznej (numer dokumentu, data wydania, data ważności, organ wydający, numer rekordu).
- 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:
- Aktualizuj istniejący dokument — zastąpienie danych i załącznika w istniejącym dokumencie
- Utwórz nowy dokument — 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
- Otwórz Azure AI Foundry → Twój projekt → Content Understanding.
- Kliknij Utwórz analizator → wybierz typ Dokument.
- Nadaj nazwę analizatora (np.
person-passport,person-id-card). - W sekcji Schemat pól dodaj pola z poniższej tabeli.
- 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".
- Field Name — nazwa z tabeli (np.
- Kliknij Build (Zbuduj), aby utworzyć analizator.
- 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ć (K/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.