Převod souboru PDF do PKPASS

PDF ticket nebo certifikát je nutné znovu sestavit, když jej příjemce potřebuje přidat do Apple Wallet namísto otevření jako dokumentu. Převod vytvoří nový strukturovaný průkaz; nepřejmenuje PDF ani automaticky nezachová jeho stránky.

Co je formát PDF

PDF je formát popisu stránky, který zachovává typografii, grafiku, obrázky a rozvržení napříč operačními systémy a tiskárnami. Adobe Acrobat, Microsoft Word, LibreOffice, InDesign, webové prohlížeče, skenery a ticketingové systémy vytvářejí soubory PDF.

Letecké společnosti, organizátoři akcí, firmy, školy a státní úřady používají PDF pro ticket, palubní dokumenty, faktury, certifikáty, formuláře, příručky a archivované záznamy. Soubor může obsahovat vybratelný text, vektorovou grafiku, vložené obrázky nebo naskenovanou stránku. Čárový kód viditelný na stránce nemusí zpřístupňovat svá data jako vybratelný text.

Co je formát PKPASS

.pkpass je formát balíčku založený na ZIP pro průkazy Apple Wallet. Typický balíček obsahuje definici pass.json, obrázky, například icon.png, volitelný lokalizační adresář, soubor manifest.json obsahující hashe souborů a kryptografický signature.

Strukturovaná definice může obsahovat pole pro událost, palubní vstupenku, obchod, kupón nebo obecný průkaz, včetně jmen, dat, míst konání, údajů o sedadle, kontaktních údajů a čárového kódu QR, Aztec, PDF417 nebo Code 128. Relevance data mohou aktivovat zobrazení na zamčené obrazovce podle času nebo polohy a vydavatel může průkaz aktualizovat prostřednictvím služby Apple pro aktualizace průkazů.

Průkaz Wallet není upravitelnou ani tisknutelnou kopií PDF. Původní dokument si ponechte pro účtenky, podmínky, podpisy, plánky míst k sezení nebo jiné stránky, které se do polí Wallet nevejdou. Průkaz může v zadním poli obsahovat zabezpečený odkaz na původní PDF, ale Wallet není obecný prohlížeč PDF.

Jak vytvořit průkaz

Pro jeden osobní ticket

1. Prohlédněte PDF a vyhledejte číslo ticketu, jméno cestujícího nebo účastníka, datum, místo konání, sedadlo a čárový kód. Vyberatelný text extrahujte pomocí pdftotext ticket.pdf ticket.txt; pokud je čárový kód obrázkem, stránku vykreslete nebo naskenujte. U naskenovaných PDF použijte OCR a každou hodnotu ručně ověřte.
2. Pro jednoduchý osobní průkaz použijte na iPhonu Pass2U Wallet. Vyberte vhodnou šablonu, naskenujte nebo zadejte čárový kód, zvolte formát čárového kódu dodaný vydavatelem, zadejte viditelná pole a případně přidejte datum nebo polohu. Pass2U vytvoří reprezentaci ve Wallet; stránky PDF nepřevede.
3. Otevřete vygenerovaný soubor .pkpass na iPhonu a v Apple Wallet vyberte Add. Čárový kód otestujte na místě konání nebo u vstupní brány a zdrojové PDF si ponechte jako zálohu. Pass2U je služba třetí strany, proto si před nahráním ticketu obsahujícího osobní údaje nebo informace o rezervaci zkontrolujte její podmínky zpracování dat.

Pro organizaci nebo automatizovaný pracovní postup

1. Pokud potřebujete šablony, hostovanou distribuci, podepisování, uživatelské odkazy nebo aktualizace průkazů, použijte zavedenou online platformu Apple Wallet, například PassKit nebo Passcreator. Jedná se o služby pro generování průkazů, nikoli o obecné převaděče PDF: namapujte data ticketu na pole průkazu, nahrajte grafiku Wallet, zvolte formát čárového kódu vydavatele a vygenerujte podepsaný balíček.
2. Pro workflow s vlastním hostováním nebo vývojářský workflow použijte Node.js s knihovnou passkit-generator nebo jinou udržovanou knihovnou PassKit. Definujte hodnoty, jako jsou formatVersion, passTypeIdentifier, serialNumber, teamIdentifier, organizationName a příslušný styl průkazu, a poté přidejte extrahovaná data ticketu a obrázky.
3. Získejte požadované přihlašovací údaje Apple Developer a certifikát Wallet pro daný typ průkazu. Nakonfigurujte certifikát a privátní klíč v generátoru nebo na platformě. Systém vytvoří manifest.json, podepíše jej a zabalí výsledek jako ticket.pkpass.
4. Soubor distribuujte e-mailem, prostřednictvím stahování přes HTTPS nebo pomocí online platformy s použitím MIME typu application/vnd.apple.pkpass. Na skutečném iPhonu otestujte instalaci, zkrácení polí, zobrazení data, relevanci na zamčené obrazovce, skenování čárového kódu a případný odkaz na PDF v zadním poli.

Desktopový převaděč PDF nedokáže z libovolné grafiky stránky spolehlivě odvodit pole ticketu ani vytvořit požadovaný podpis Apple. Platforma pro průkazy může zajistit podepisování a distribuci, nahráním ticketu však tomuto poskytovateli předáváte jeho osobní údaje a data o rezervaci.

Omezení kvality a kompatibility

• Data čárového kódu jsou důležitější než jeho obrázek. Opětovné použití původního obrázku čárového kódu může fungovat, ruční přepis nebo nesprávné dekódování jeho obsahu však může vytvořit průkaz, který skener nepřijme.
• Použijte formát určený vydavatelem. Palubní dokumenty leteckých společností běžně používají PDF417, zatímco akce často používají QR nebo Code 128; změna formátu nebo obsahu může zabránit skenování.
• Některé letecké společnosti a systémy pro akce používají rotující, podepsané nebo serverově ověřované čárové kódy. Zkopírovaný čárový kód z PDF může být prošlý, již použitý nebo odmítnutý, i když vypadá správně. Pokud je k dispozici vlastní tlačítko nebo průkaz vydavatele pro Wallet, je vhodnější jej použít.
• PKPASS je primárně formát Apple Wallet. Google Wallet, Samsung Wallet a obecné ticketové aplikace pro Android vyžadují vlastní formáty generování průkazů nebo metody importu.
• Certifikát musí být platný a musí odpovídat identifikátoru typu průkazu. Prošlý, zneplatněný, neodpovídající nebo nepodepsaný balíček se běžným způsobem nenainstaluje.
• U každého odkazovaného PDF použijte HTTPS a vyhněte se odkazům, které vyžadují přihlášení, jež příjemce nemůže v rámci workflow Wallet dokončit. Pokud průkaz vynechává právně nebo provozně relevantní obsah, původní PDF si ponechte.