U ontwerpt een PDF-formulier voor klantintake. Als de klant "Individueel" als accounttype moet het formulier velden tonen voor hun naam en burgerservicenummer. Als ze 'Zakelijk' selecteren, het formulier moet in plaats daarvan velden tonen voor de bedrijfsnaam en het werkgeversidentificatienummer. Op een papieren formulier drukt u beide secties af en schrijft u 'Indien van toepassing'. naast elk. In een digitale PDF kan voorwaardelijke logica het irrelevante gedeelte volledig verbergen, waardoor de gebruiker alleen de velden te zien krijgt die hij/zij daadwerkelijk moet invullen.
Voorwaardelijke logica in PDF-formulieren is reëel en functioneel, maar er zijn belangrijke kanttekeningen bij. In tegenstelling tot webformulieren, waar JavaScript en CSS flexibele controle bieden over de zichtbaarheid en lay-out, wordt de voorwaardelijke logica van PDF beperkt door de beperkte JavaScript-implementatie van het PDF-formaat en de inconsistente manier waarop verschillende PDF-viewers scripts uitvoeren. Als u begrijpt wat wel en niet mogelijk is, kunt u geen formulier ontwerpen dat in uw testomgeving werkt, maar voor de helft van uw ontvangers niet werkt.
Wat voorwaardelijke logica in een PDF-formulier feitelijk kan doen
Voorwaardelijke PDF-logica draait op Acrobat JavaScript, een vereenvoudigde versie van JavaScript die sinds het begin van de jaren 2000 deel uitmaakt van de PDF-specificatie. Het kan formuliervelden tonen of verbergen op basis van gebruikersinvoer. Het kan velden in- of uitschakelen, hun kleur of rand wijzigen, ze markeren als vereist of optioneel, en hun waarden invullen vanuit opzoektabellen. Het kan invoer valideren terwijl de gebruiker typt, waarschuwingsberichten weergeven en berekeningen activeren wanneer aan bepaalde voorwaarden wordt voldaan.
Wat het niet kan doen, is de pagina-indeling herstructureren. Als je een veld verbergt, wordt het uit het zicht verwijderd, maar de ruimte die het in beslag nam blijft bestaan. De onderstaande velden schuiven niet omhoog om het gat op te vullen. De pagina wordt niet opnieuw weergegeven. Dit is het grootste verschil tussen een PDF Forms en een webformulier, en het is de bron van de meeste teleurstelling wanneer iemand een webformulierervaring probeert te repliceren in een PDF. Als uw voorwaardelijke logica de pagina-indeling drastisch moet veranderen, is een PDF het verkeerde hulpmiddel. Als het een paar velden binnen een vaste lay-out moet tonen of verbergen, kan de voorwaardelijke PDF-logica dat goed aan.
Een regel voor tonen/verbergen instellen op basis van een vervolgkeuzelijst of selectie van selectievakjes
Het meest voorkomende voorwaardelijke patroon is een vervolgkeuzelijst of een reeks keuzerondjes die bepalen welke volgende velden zichtbaar zijn. Begin in de formuliereditor van WukongPDF met het maken van het controleveld, de vervolgkeuzelijst of keuzerondjegroep waarvan de waarde bepaalt wat er vervolgens gebeurt. Geef het een duidelijke naam, zoals "accountType." Maak vervolgens alle velden aan die mogelijk worden weergegeven of verborgen. Elk mogelijk veld moet vanaf het begin op het formulier voorkomen. Voorwaardelijke logica regelt alleen de zichtbaarheid. Het creëert of vernietigt geen velden.
Nadat de velden zijn gemaakt, opent u de eigenschappen van het controlerende veld en zoekt u het tabblad Valideren of Bij vervagen. Hier schrijft u het JavaScript dat reageert op de selectie van de gebruiker. Een eenvoudig show-hide-script ziet er als volgt uit: var choice = event.target.value; this.getField("ssnField").display = (keuze === "Individueel") ? display.zichtbaar: display.verborgen; this.getField("einField").display = (keuze === "Zakelijk") ? display.zichtbaar: display.verborgen; Wanneer de gebruiker de vervolgkeuzelijst wijzigt, wordt het script uitgevoerd, wordt de geselecteerde waarde gecontroleerd en wordt de weergave-eigenschap van elk veld ingesteld op zichtbaar of verborgen.
Een belangrijk detail: stel de beginstatus van alle voorwaardelijke velden zo in dat deze overeenkomen met de standaardwaarde van het controlerende veld. Als de vervolgkeuzelijst standaard 'Individueel' is, het SSN-veld moet zichtbaar worden en het EIN-veld moet verborgen worden. Als de velden in de verkeerde status beginnen, ziet de gebruiker beide of geen van beide totdat hij voor de eerste keer interactie heeft met de vervolgkeuzelijst, die er niet goed uitziet. De beginstatus en de scriptlogica moeten overeenkomen.
Validatieregels die de invoer controleren voordat de gebruiker verdergaat
Voorwaardelijke logica gaat verder dan zichtbaarheid en gaat over invoervalidatie. Een datumveld kan controleren of de ingevoerde datum binnen een acceptabel bereik valt. Een e-mailveld kan verifiëren dat de invoer een @-teken en een domein bevat. Een telefoonnummerveld kan exact tien cijfers bevatten. Validatiescripts worden uitgevoerd in de Validate-gebeurtenis van het veld, die wordt geactiveerd wanneer de gebruiker probeert het veld te verlaten. Als het script event.rc = false aanroept, blijft de focus op het veld liggen en kan de gebruiker pas verdergaan als de invoer is gecorrigeerd.
Een praktische telefoonvalidatie ziet er als volgt uit: var phone = event.value.replace(/\s|-|\(|\)/g, ''); if (phone !== "" && !/^\d{10}$/.test(phone)) { app.alert("Voer een telefoonnummer van 10 cijfers in."); gebeurtenis.rc = onwaar; } Dit script verwijdert spaties, streepjes en haakjes en controleert vervolgens of de overige tekens precies uit tien cijfers bestaan. Als het veld leeg is, vindt validatie plaats, omdat niet elk telefoonveld vereist is. Als het veld inhoud heeft maar geen tien cijfers bevat, toont het script een waarschuwingsbericht en blokkeert het de gebruiker om het veld te verlaten.
Validatieregels moeten spaarzaam worden gebruikt en met duidelijke foutmeldingen. Een formulier dat de gebruiker bij elk veld blokkeert met cryptische waarschuwingen zorgt voor frustratie. Een formulier dat alleen de velden valideert waar onjuiste invoer echte problemen zou veroorzaken, en uitlegt wat de gebruiker moet oplossen, schept vertrouwen. In de waarschuwingstekst moet precies worden vermeld wat er mis is en hoe u dit kunt oplossen. "Ongeldige invoer" is nutteloos. "Telefoonnummer moet uit 10 cijfers bestaan, zonder spaties of streepjes" vertelt de gebruiker wat hij moet doen.
Het probleem met de viewercompatibiliteit en hoe u dit kunt omzeilen
PDF JavaScript wordt ondersteund in Adobe Acrobat Reader, Acrobat Pro en de meeste desktop-PDF-toepassingen. Het wordt niet ondersteund in de meeste browsergebaseerde PDF-viewers, inclusief de ingebouwde viewer van Chrome, PDF.js van Firefox en de preview van Safari. Het wordt gedeeltelijk ondersteund in sommige mobiele PDF-apps en volledig afwezig in andere. Als uw formulier afhankelijk is van voorwaardelijke logica en validatiescripts, en uw ontvanger het opent in een viewer die geen JavaScript uitvoert, ziet hij of zij alle velden, inclusief de velden die verborgen moeten zijn, en wordt geen van de validatieregels geactiveerd.
Hiervoor bestaat geen perfecte technische oplossing. De beste aanpak is een combinatie van duidelijke etikettering en een prominente instructie bovenaan het formulier. Label voorwaardelijke secties met hun triggervoorwaarde: "Als u hierboven Zakelijk heeft geselecteerd, vult u deze sectie in." Op deze manier kan de gebruiker, zelfs als de scripting mislukt, het formulier handmatig volgen. De Interactieve PDF-ervaring vervalt op elegante wijze tot een bruikbare statische vorm in plaats van onbegrijpelijk te worden.
Voorwaardelijke formulieren testen op meerdere viewers
Voordat u een voorwaardelijk PDF-formulier distribueert, moet u het in ten minste vier omgevingen testen: Adobe Acrobat Reader op de desktop, de ingebouwde PDF-viewer van Chrome, de Safari- of Preview PDF-viewer op Mac en een mobiele PDF-viewer op zowel iPhone als Android. Werk in elke omgeving het formulier systematisch door. Wijzig vervolgkeuzelijsten en controleer of de juiste velden verschijnen en verdwijnen. Voer ongeldige gegevens in en bevestig dat de validatieberichten verschijnen en indiening voorkomen. Sla het formulier op en open het opnieuw om te controleren of de opgeslagen status consistent is.
Voor formulieren die naar een bekende doelgroep gaan, zoals interne bedrijfsformulieren of formulieren die via een specifieke portal zijn ingediend, test u alleen de kijkers die uw doelgroep daadwerkelijk gebruikt. Als iedereen in uw organisatie Adobe Acrobat gebruikt, is browsercompatibiliteit niet relevant. Als uw formulier op een openbare website wordt geplaatst en door iedereen met welk apparaat dan ook wordt geopend, gaat u ervan uit dat een aanzienlijk percentage van de gebruikers het formulier zonder JavaScript te zien krijgt. Ontwerp het formulier zo dat het in die gedegradeerde staat acceptabel functioneert, met alle velden zichtbaar en alle instructies duidelijk, en laat de voorwaardelijke logica eerder een verbetering dan een vereiste zijn.
Als voorwaardelijke logica thuishoort in een webformulier
Als uw formulier wizards met meerdere stappen, het dynamisch aanmaken van velden, realtime servervalidatie of het opnieuw plaatsen van pagina's nodig heeft wanneer velden verschijnen en verdwijnen, is een webformulier het juiste hulpmiddel, geen PDF. PDF-formulieren zijn statische documenten met interactieve verbeteringen. Webformulieren zijn interactieve toepassingen met een documentachtige uitvoer. Het onderscheid is belangrijk omdat het bouwen van een complex voorwaardelijk formulier in PDF, om vervolgens te ontdekken dat de helft van uw publiek het niet kan gebruiken zoals bedoeld, een frustrerende en tijdrovende fout is.
Een praktische hybride aanpak is het gebruik van een webformulier voor het verzamelen van gegevens en voorwaardelijke logica, en het genereren van een PDF van de ingediende gegevens voor ondertekening, archivering en delen. De PDF-editor van WukongPDF werkt goed in deze workflow: verzamel de gegevens via een webformulier, vul een PDF-sjabloon in met de antwoorden en lever de gepolijste PDF aan de gebruiker voor zijn administratie. Het webformulier zorgt voor de logica. De PDF verzorgt de presentatie. Elk hulpmiddel doet waar het goed in is.