UżYWANIE IRON SUITE

Projektowanie potoku dokumentów lotniczych z Iron Suite dla .NET

Zaktualizowano:

Podróż pasażera przez platformę lotniczą to ścieżka dokumentów. Rezerwują lot i system generuje bilet; rejestrują się i generuje się karta pokładowa; ich torba trafia na taśmę, a system generuje etykietę bagażową; lot się kończy i zostają wydane manifest operacyjny, paragon finansowy oraz raport dla organów regulacyjnych. Ta sama platforma musi również odczytywać dokumenty: paszporty i wizy przy odprawie, faktury dostawców, zeskanowaną dokumentację operacyjną i kody kreskowe na bagażu, z szybkością i dokładnością, których wymaga przepływowy ruch pasażerów. Ten przewodnik pokazuje jeden sposób, jak zbudować tę warstwę dokumentów w stosie .NET za pomocą Iron Suite (IronPDF, IronOCR, IronBarcode, IronQR, IronXL, IronSecureDoc, IronZIP i IronPrint), działając wewnątrz mikrousług na Red Hat OpenShift lub Kubernetes. Format to opis rozwiązania, nie szczegółowy samouczek krok po kroku; samouczki na poziomie funkcji są zamieszczone w tekście, a głębokość implementacji kodu jest dostępna tam, a nie zduplikowana tutaj.

TL;DR: Przewodnik Quickstart

  • Dla kogo to jest: CTO, architektów rozwiązań i starszych inżynierów .NET, budujących warstwy dokumentów dla linii lotniczych, platform podróżnych i sąsiadujących systemów o wysokiej przepustowości na infrastrukturze kontenerowej.
  • Co zbudujesz: Sześciostopniowy potok dokumentów (tworzenie, odczyt, transformacja, zabezpieczanie, dystrybucja i raportowanie) obejmujący generowanie HTML do PDF, OCR z uwzględnieniem pozycji, generowanie i odczyt kodów kreskowych i QR, raportowanie w Excelu, podpisywanie oparte na certyfikatach, nieodwracalne zaciemnianie, drukowanie po stronie serwera i pakowanie ZIP.
  • Gdzie działa: .NET Framework 4.6.2+, .NET 6+, .NET Standard 2.0. Red Hat OpenShift na Azure, Kubernetes, on-premises lub w modelu hybrydowym, z tą samą licencją i API we wszystkich docelowych miejscach. Dostępne są powiązania Node.js i Python dla sąsiadujących usług, zazwyczaj wprowadzające nowe funkcje około miesiąc po .NET.
  • Kiedy używać tego podejścia: Tysiące dokumentów na minutę w szczytowych momentach, mieszane przetwarzanie w czasie rzeczywistym i przetwarzanie wsadowe zgodnie z harmonogramem, ścisła izolacja najemców i infrastruktura zarządzana przez klientów.
  • Dlaczego to ma znaczenie techniczne: Iron Suite konsoliduje osiem obszarów funkcjonalnych na jednolitej platformie SDK w natywnym środowisku .NET, działa w procesie wewnątrz twoich podów, dzięki czemu zawartość dokumentu nigdy nie opuszcza dzierżawy, oraz współpracuje z IronSecureDoc jako izolowana granica bezpieczeństwa dla podpisywania i nieodwracalnej redakcji.

  1. Install Iron Suite with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Skopiuj i uruchom ten fragment kodu.

    using IronPdf;

var renderer = new ChromePdfRenderer();
var html = "<h1>Booking Confirmation</h1><p>FLT123 · 2026-04-30 · Seat 14A</p>";

var pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("booking-confirmation.pdf");

  3. Wdrożenie do testowania w środowisku produkcyjnym

    Rozpocznij używanie Iron Suite w swoim projekcie już dziś z darmową wersją próbną

    arrow pointer

Po zakupie lub zarejestrowaniu się na wersję próbną, dodaj klucz licencyjny na początku uruchamiania aplikacji:

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
Imports IronPdf

IronPdf.License.LicenseKey = "KEY"
$vbLabelText   $csharpLabel

Spis treści

Obszar problemów przemysłowych

Linie lotnicze i platformy podróżne działają na dokumentach. Przepływ pasażerów na głównym węźle generuje karty pokładowe sekundowo; węzeł towarowy generuje manifesty co minutę; zaplecze produkuje raporty finansowe i rejestry regulacyjne co godzinę. Każdy z tych dokumentów musi być gotowy w krótkim czasie, wyglądać zgodnie z marką linii lotniczej, zawierać dane czytelne maszynowo, które systemy docelowe będą skanować, a kiedy zawiera dane osobowe lub informacje o płatnościach, być bezpieczny do udostępniania, przechowywania, a później do udowodnienia, że nie został zmodyfikowany. Ta sama platforma obsługuje również stronę przychodzącą: OCR paszportów i wiz przy odprawie, odczytywanie kodów kreskowych podczas odpadu bagażu, zeskanowane dokumenty operacyjne z linii, oraz importowanie arkuszy kalkulacyjnych od partnerów i obsługi naziemne.

Zbuduj to naiwnie, a tryby awarii są przewidywalne. Synchroniczny renderer obsługujący karty pokładowe na wątku API zatrzyma się, gdy manifest o 80 stronach zostanie wyrenderowany po zamknięciu lotu. Darmowa biblioteka OCR dopasowana do czystych skanów przegapi fotografowany telefonem paszport w kiosku samoobsługowym. Rozproszony stos dostawców, jedna biblioteka na PDF, druga na OCR, trzecia na kody kreskowe, czwarta na Excel, zwiększa przeglądy EULA, ryzyka redystrybucji i modele kosztów na bibliotekę, które dział zakupów będą musiały ścigać. Każda awaria staje się widoczna na bramce, na karcie pokładowej, w manifeście lub w raporcie dla organu regulacyjnego, który jest wysyłany na koniec dnia.

Przegląd architektury rozwiązania

Docelowa architektura rozdziela obciążenia dokumentami według pięciu osi: frontofice, przetwarzanie w tle, przechowywanie, stan i bezpieczeństwo.

Usługa API. Przednie drzwi. Bezpośrednio obsługuje szybkie renderowanie: karty pokładowe, rachunki, jednowstronowe potwierdzenia. Wszystko, co trwa dłużej, niż powinno być utrzymane przez poziom API, zostaje przekazane dalej.

Podwójki pracowników. Pracownicy w tle konsumują kolejkę zadań i wykonują ciężkie operacje: długie PDF-y, OCR na fotografowanych dokumentach, transformacje wsadowe, zaplanowane raporty. Skalują się horyzontalnie na podstawie własnych metryk, oddzielnie od poziomu API. Renderowanie wymaga intensywności procesora i pamięci, więc dedykowane podwójki pracowników zapewniają przewidywalne rozmiary.

Wspólne przechowywanie. Azure Blob Storage lub ekwiwalentne dla wykonanych dokumentów, szablonów źródłowych, czcionek i zasobów marki. Prefiksy najemców lub kosze dla twardej izolacji tam, gdzie partnerzy tego wymagają.

Baza danych przepływu pracy. Śledzi każdy dokument: najemca, właściciel, stan, lokalizacja przechowywania i ścieżka audytu. Jeden wiersz na zdarzenie dokumentu utrzymuje zapytania o cykl życia i umożliwia jego odtworzenie.

Dedykowana granica bezpieczeństwa. IronSecureDoc wdrożone jako lokalna usługa REST obok pracowników, za własnymi kontrolami dostępu. Klucze podpisywania, klucze szyfrowania i nieodwracalne operacje zaciemniania działają za tą wąską API, a nie rozkładają się na wszystkie uniwersalne pracowników, co daje zakresowi bezpieczeństwa własny obszar audytu.

Cykl życia dokumentu

Dokumenty przepływają przez sześć etapów. Każdy etap koncentruje się na innym, istotnym obszarze zdolności Iron Suite i łączy się z kanonicznymi samouczkami w celu uzyskania głębokości implementacji.

Etap 1 — Tworzenie

Cel: Produkcja dokumentów dla klientów i operacji (bilety, karty pokładowe, paragony, etykiety bagażowe, manifesty i raporty dla regulatorów) z danych biznesowych i szablonów HTML.

Elementy Suite:

  • IronPDF: ChromePdfRenderer.RenderHtmlAsPdf dla renderowanie HTML do PDF; SaveAsPdfA dla wyjścia archiwalnego; PDF/UA dla dokumentów wynikających z dostępności
  • IronBarcode i IronQR: kody na kartach pokładowych i etykietach bagażowych, osadzone w szablonach PDF, a nie kompozycjonowane później
  • IronXL: WorkBook dla manifestów operacyjnych i arkuszy uzgadniania, gdzie Excel jest odpowiednim dostarczanym dokumentem

Wejścia: PNR, dane o locie, miejsca i pasażera; szablony HTML; czcionki i zasoby związane z marką linii lotniczej.

Wyniki: Pliki PDF skierowane do klientów (często z embedowanymi kodami); pliki XLSX dla operacji.

Rozważania dotyczące wdrożenia: Ładowanie czcionek i zasobów marki przy starcie pada; zapiekaj je w obrazie kontenera. Pierwsze ładowanie czcionki to najczęstsza przyczyna wolnego ogonowego opóźnienia. Zbuduj szablon karty pokładowej raz i przesyłaj dane; nie generuj kodów kreskowych poza PDF i nie kompozycjonuj ich później.

Więcej informacji: Samouczek HTML do PDF

Etap 2 — Odczyt

Cel: Pobranie tekstu i danych strukturalnych z przychodzących plików PDF, fotografowanych dokumentów tożsamości (paszportów przy ladach, zdjęć telefonicznych na kioskach) i skanów (faktur od dostawców, dokumentacji operacyjnej), z danymi pozycyjnymi na tyle dokładnymi, by prowadzić do zaciemniania i reguł w dół strumienia.

Elementy Suite:

  • IronOCR: IronTesseract dla OCR na fotografowanych i skanowanych dokumentach; OcrInput przetwarzanie wstępne (prostowanie, odszumianie, kontrast) dla wejść kioskopodobnej jakości; koordynatowo świadome OcrResult z ramkami ograniczającymi dla każdego słowa
  • IronPDF: PdfDocument ekstrakcja tekstu i metadanych z czystych cyfrowych PDF
  • IronBarcode: BarcodeReader dla dekodowania kodów na kartach pokładowych i etykietach bagażu na przychodzących skanach

Wejścia: Strony PDF, fotografowane dokumenty tożsamości, skanowane faktury, dokumentacja operacyjna.

Wyniki: Tekst z polami ograniczającymi na słowo, dekodowane wartości kodów kreskowych, wyniki oceny pewności dla każdego wyciągu.

Rozważania dotyczące przepustowości: Jakość obrazu wpływa na jakość OCR. Routowanie wejść przez etap triage, który wybiera profil wstępnej obróbki: agresywne wyrównywanie i denoising dla zdjęć z kiosków, delikatne podejście dla czystych skanów. Trwałość wyników oceny pewności z każdym wyciągiem i rutowanie wyników o niskiej pewności do przeglądu człowieka, zamiast cichego niepowodzenia.

Więcej informacji: Przewodnik OCR PDF

Stage 3 — Transform

Cel: Stosowanie reguł biznesowych do wyodrębnionych danych: klasyfikowanie dokumentów, routowanie według rodzajów, konwertowanie między formatami i wzbogacanie z metadanymi z systemów upstream.

Elementy Suite:

  • IronPDF: PdfDocument operacje na stronach (podział, łączenie, kopiowanie, zmiana kolejności, edycja metadanych)
  • IronOCR: wyodrębnianie docelowe do regionu wobec znanych kształtów szablonów
  • IronXL: WorkBook dla transformacji opartych na arkuszach kalkulacyjnych, przeliczania formuł i scalania arkuszy

Wejścia: Wyodrębniony tekst i pola ograniczające z Etapu 2, dekodowane wartości kodów kreskowych, źródłowe pliki PDF i XLSX.

Wyniki: Zklasyfikowane rekordy, przekształcone pliki, czyste obiekty biznesowe gotowe do przetwarzania w dół strumienia.

Rozważania dotyczące operacji: Napędzaj reguły routingu i klasyfikacji z konfiguracji, a nie z twardo-kodowanej logiki; konwencje regulatorów i partnerów zmieniają się szybciej niż cykle wydawnicze. Przechowuj zarówno artefakt źródłowy, jak i wynik przekształcony; audytory zapytają o oba. Każdy krok powinien być idempotentny, aby potok mógł czysto się odtworzyć, gdy coś w dół strumienia wymaga ponownego przetwarzania.

Więcej informacji: Przetwarzanie wsadowe IronPDF

Etap 4 — Zabezpieczanie

Cel: Ochrona, podpisywanie i weryfikacja dokumentów zawierających dane osobowe podróżnych, dane o płatnościach lub treści regulacyjne, które muszą pozostać widoczne na zmiany.

Elementy Suite:

  • IronSecureDoc: REST API do nieodwracalnej redakcji, szyfrowania, kontroli dostępu, polityk ochrony dokumentów i detekcji manipulacji
  • IronPDF: PdfSignature dla podpisów cyfrowych opartych na certyfikatach; opcja zaciemniania oparta na współrzędnych; password protection
  • IronPDF: SaveAsPdfA dla długoterminowego przechowywania archiwalnego

Wejścia: Zwykłe dokumenty z etapów upstream; klucze podpisywania z magazynu tajemnic (Azure Key Vault lub równoważne); mapy zaciemnień uzyskane z pól ograniczających OCR.

Wyniki: Zaszyfrowane, podpisane, nieodwracalnie zredagowane pliki PDF gotowe do dystrybucji lub archiwizacji.

Rozważania dotyczące bezpieczeństwa: Nigdy nie ładuj kluczy podpisywania z plików konfiguracyjnych lub zmiennych środowiskowych kontenera; pobieraj je z magazynu tajemnic w momencie podpisywania i rotuj na najemcę, zamiast używać jednego klucza platformowego.

OstrzeżenieCzarny prostokąt narysowany nad tekstem nie jest zaciemnieniem; podstawowe znaki pozostają w strumieniu treści. Kieruj redakcję PII na eksport przez bezpieczną ścieżkę redakcji IronSecureDoc. Weryfikuj podpisy na zaufanych dokumentach przychodzących, a nie tylko wychodzących.

Więcej informacji: Podpisy cyfrowe dla PDF

Etap 5 — Dystrybucja

Cel: Zapisz gotowy dokument, oznacz go metadanymi audytu i dostarcz na właściwy kanał: e-mail, aplikacja mobilna, kiosk przy bramce, lada agenta lub system partnera.

Elementy Suite:

  • IronPDF: tłoczenie metadanych (ID śledzenia, tag najemcy, znacznik czasu generacji) wbudowane w dokument dla śledzenia w dół strumienia
  • IronPrint: drukowanie po stronie serwera dla liczników przy bramce i kiosków samoobsługowych, gdzie wymagana jest fizyczna emisja
  • IronZIP: pakowanie dla dostaw partnerów i pobierań wsadowych, w tym codziennych zbiorów operacyjnych i rozliczeń finansowych

Wejścia: Gotowe dokumenty z wcześniej zakończonych etapów, metadane audytu, docelowe miejsce dostawy.

Wyniki: Zapisane pliki w magazynie; wydarzenia publikowane do systemów odpowiedzialnych za rzeczywistą dostawę.

Przypadki brzegowe: Nadaj każdemu dokumentowi stabilne ID śledzenia i wbuduj je w metadane PDF; wsparcie będzie tego potrzebować miesiące później. Traktuj dostarczanie e-mail jako odrębne zadanie od renderowania; nieudanego e-mail'a nie można traktować jako nieudanego renderowania, a oba powinny próbować ponownie samodzielnie. Planuj na przypadek, kiedy kiosk będzie offline; druk powinien być próbą najlepszą z możliwością przejścia na dostawę e-mail lub przez aplikację, gdyby było to konieczne.

Więcej informacji: Drukowanie po stronie serwera IronPrint

Etap 6 — Raportowanie

Cel: Budowanie zaplanowanych i na żądanie raportów dla finansów, operacji, regulatorów i partnerów; zwykle na kadencję wsadową, często wieloarkuszowe, czasem pobierane z zewnętrznych portali partnerskich, gdzie nie ma dostępnego API.

Elementy Suite:

  • IronXL: WorkBook dla wieloarkuszowych arkuszy kalkulacyjnych z formułami, formatowaniem warunkowym i wykresami; Eksport CSV przez SaveAsCsv dla wniosków regulacyjnych z możliwością przetwarzania maszynowego
  • IronPDF: ChromePdfRenderer.RenderHtmlAsPdf dla raportów dla kierownictwa i operacyjnych, które muszą wyglądać jak dokument PDF zgodny z marką, a nie arkusz kalkulacyjny
  • IronWebScraper: do pobierania z partnerów lub portali regulacyjnych, gdzie nie istnieje programistyczne API

Wejścia: Dane platformy z bazy danych przepływu pracy, szablony raportów, zakres dat i parametry filtra.

Wyjścia: Skoroszyty Excel wieloarkuszowe do wewnętrznej konsumpcji; pliki płaskie CSV do spożycia przez regulatorów i partnerów; markowe pliki PDF do raportów kierowniczych.

Rozważania dotyczące raportowania: Uruchamiaj ciężkie raporty na warstwie roboczej, nigdy na warstwie API. Uczyń raporty idempotentnymi; ponowne uruchomienie tego samego raportu dla tych samych wejść powinno dawać identyczny wynik bajtowy miesiące później, co oznacza sortowanie w sposób deterministyczny i unikanie wycieku znaczników czasu do komórek. Podpisz raporty związane z administracją w momencie generacji, a nie w momencie dostawy.

Więcej informacji: Eksport do Excela

Uzasadnienie projektowe

Sześć decyzji niesie większość ciężaru architektury.

Asynchroniczny model roboczy. Szybkie dokumenty (karty pokładowe, paragony) i wolne dokumenty (długie manifesty, raporty wsadowe) działają na oddzielnych ścieżkach przetwarzania, aby wolniejsze nie blokowały szybszych. To samo ustawienie absorbuje zdarzenia zakłóceń: gdy lot zostaje odwołany i system musi wygenerować dziesiątki tysięcy dokumentów zmiany rezerwacji, paragonów zwrotu pieniędzy i plików PDF z kuponami w ciągu minut, wolniejsza ścieżka obsługuje napływ, podczas gdy szybsza ścieżka nadal produkuje karty pokładowe dla lotów wciąż operacyjnych. Kompromis: większa złożoność budowy i eksploatacji niż konfiguracja pojedynczej ścieżki.

Biblioteki w procesie, nie wywołania usług. Iron Suite działa wewnątrz węzłów własnej platformy; brak zewnętrznej usługi, brak opłat za połączenia, brak przeskoków sieciowych, brak zawartości dokumentu przekraczającego granicę najmu. Kompromis: zależność od harmonogramu jednego dostawcy, łagodzona przez zaangażowanie suite dla kompatybilności wstecz i opowieść o wielu środowiskach wykonawczych (.NET, Node.js, Python).

Świadome pozycjonowanie OCR. Wyodrębnienie świadome pozycji z IronOCR umożliwia zgodne zaciemnienie i redukuje pracę analityczną w dół strumienia. To samo zakotwiczenie przestrzenne jest tym, co AI- wspomagane przepływy pracy dotyczące dokumentów podróży coraz częściej odczytują, w tym dopasowanie biometryczne tożsamości przy wchodzeniu na pokład i automatyzowana weryfikacja wiz przy odprawie; warstwa AI na OCR konsumuje dane o polach ograniczających, nie tylko tekst. Kompromis: więcej danych do trwałego przechowywania wraz z każdym dokumentem.

Izolowana granica bezpieczeństwa przez IronSecureDoc. Podpisywanie, szyfrowanie i nieodwracalne zaciemnianie znajduje się za wąską API REST ze swoimi własnymi kontrolami dostępu. Zamiana: jedna dodatkowa usługa do wdrożenia i monitorowania.

Jeden dostawca, jeden kontrakt. Konsolidacja na jednej rodzinie SDK redukuje przeglądy EULA, ryzyko redystrybucji i relacje wsparcia, szczególnie gdy międzynarodowe zamówienia (KSA, UE i podobne jurysdykcje) są na stole. Kompromis: mniej możliwości zamiany na najlepszą opcję dla pojedynczej zdolności, jeśli jedna specyficzna potrzeba przewyższa możliwości suite, choć granice SDK pozostają na tyle czyste, aby móc zamienić jedną bibliotekę bez zakłócenia innych.

Multitenancja od pierwszego dnia. Każda praca ma etykietę najemcy; szablony i znaki towarowe są konfigurowalne, a nie zakodowane. Kompromis: nieco cięższa warstwa metadanych, znacznie tańsza niż przyszłe dodawanie najmu.

Rzeczywistość operacyjna

Skalowanie. Podwójki robocze ponoszą większość kosztów. HPA na CPU i pamięć dla pracowników renderujących; KEDA lub odpowiednik na głębokość kolejek dla partii i pracowników OCR. Instancje ChromePdfRenderer są wielokrotnie wykorzystywane w ramach żądań, ale każde renderowanie zajmuje pamięć operacyjną proporcjonalnie do złożoności dokumentu, więc użyj MaxDegreeOfParallelism, aby ograniczyć współbieżność na pracownika do poziomu tolerowanego przez RAM twojego poda.

Wąskie gardła. OCR na danych wejściowych zrobionych telefonem jest pierwszym wąskim gardłem produkcyjnym, na które napotykają większości platform lotniczych. Renderowanie dużych lub ciężkich zasobów PDF jest drugie; podgrzewaj podwójki i zapiekaj czcionki w obrazie kontenera. I/O podczas przechowywania podczas szczytowych okien odprawy jest trzeci.

PoradyKontrole zdrowotne, które tylko zwracają 200, nie złapią uszkodzonego renderera; niech wykonują mały syntetyczny render przeciwko znanemu szablonowi zamiast tego.

Pułapki. Brakujące czcionki w obrazach kontenera powodują bilety "dlaczego wygląda inaczej w produkcji?"; zapiekaj je. Starsze przesyłane pliki PDF z uszkodzonymi tabelami cross-reference powinny przejść przez etap walidacji przed ścieżką roboczą. Konteksty bezpieczeństwa OpenShift mogą blokować ładowanie czcionki i biblioteki obrazów; zweryfikuj na reprezentatywnym podzie przed skalowaniem.

Kolejne kroki

Zacznij mało. Zweryfikuj jeden etap od końca do końca przed rozszerzeniem; Stwórz + Zabezpiecz to najczystszy pierwszy wycinek dla platformy lotniczej, ponieważ testuje zarówno rendering ogólnodostępny, jak i granicę bezpieczeństwa. Gdy to będzie stabilne, warstwy w Odczycie i Transformacji, a następnie Dystrybucji i Raportowaniu. Dla zespołów prowadzących operacje w wielu jurysdykcjach, pasażer lecący KSA → UE → USA przekracza trzy reżimy prywatności na podróż, Etap Transformacji to miejsce, w którym siedzą reguły per-trasa zaciemniania, a Etap Zabezpieczania je stosuje; architektura poniżej nie zmienia się, ale zestaw reguł dotyczący ładowania Etapu Transformacji tak.

Dla przeglądu architektury dla konkretnego modelu najemcy, topologii OpenShift lub postawy regulacyjnej, Inżynieria rozwiązań prowadzi głęboko zasiedziałe sesje obejmujące dokładnie tego rodzaju potok.