Variabelen

U kunt in Designer formuliervariabelen definiëren om zo specifieke informatie op te slaan op een centrale, vrij toegankelijke locatie. Een variabele wordt doorgaans gebruikt als tijdelijke opslagplaats voor tekst die u mogelijk in de toekomst moet wijzigen. Formuliervariabelen in Designer zijn altijd van het type "tekenreeks". U kunt in een variabele bijvoorbeeld de tekst opslaan van de titel van een berichtvenster. Wanneer de tekst moet worden gewijzigd, hoeft u alleen maar het betreffende formulier of de sjabloon te openen en de tekst eenmaal bij te werken via de definitie van de variabele. Designer voert de nieuwe tekst automatisch in alle versies van de ingevoegde variabele door.

Formuliervariabelen worden buiten de Scripteditor gedefinieerd en zijn toegankelijk voor alle scripts in alle objecten op een formulier, in tegenstelling tot scriptvariabelen die u maakt in een specifiek FormCalc- of JavaScript-script.

U kunt variabelen maken, bekijken of verwijderen zonder scripts te gebruiken. U moet echter wel scripts gebruiken als u toegang wilt krijgen tot de waarden die zijn opgeslagen in variabelen en als u deze wilt bewerken, of als u de waarden wilt toepassen op objecten in uw formulier.

Opmerking: Waarden van formuliervariabelen worden telkens opnieuw ingesteld wanneer u een formulier opent.

Voordat u een variabele maakt, moet u weten welke naam u aan de variabele wilt toewijzen en welke tekst de variabele moet bevatten. De definities van de variabelen worden in het formulier of de sjabloon opgeslagen.

Naamgeving van variabelen

Bij uitvoering treden naamconflicten op wanneer de namen van variabelen identiek zijn aan namen die gebruikt worden als namen van eigenschappen of methoden van het XML-formulierobjectmodel of veldnamen van het formulierontwerp. Deze conflicten kunnen ertoe leiden dat scripts onverwachte waarden als resultaat geven. Het is dus van belang variabelen zoveel mogelijk unieke namen te geven. Hierna volgen enkele voorbeelden:

  • Gebruik de variabelenamen fieldWidth en fieldHeight in plaats van x en y.

  • Gebruik als naam voor het formulierontwerpobject clientName in plaats van name.

    Opmerking: De namen van variabelen zijn hoofdlettergevoelig en mogen geen spaties bevatten.

Een tekstvariabele definiëren

  1. Selecteer Bestand > Formuliereigenschappen.

  2. Klik op het tabblad Variabelen op Nieuw (Invoegen) .

  3. Typ in de lijst Variabelen een unieke naam voor de variabele en druk op Enter. De namen van variabelen zijn hoofdlettergevoelig en mogen geen spaties bevatten.

  4. Klik eenmaal in het vak rechts en typ de tekst die u aan de variabele wilt toewijzen.

    In het palet Hiërarchie wordt de variabele weergegeven op het niveau van het formulier.

    A. Nieuwe formuliervariabele

De definitie van een tekstvariabele bekijken

  1. Selecteer Bestand > Formuliereigenschappen.

  2. Klik op het tabblad Variabelen en selecteer de variabele in de lijst Variabelen. De toegewezen tekst wordt weergegeven in het vak rechts.

Een tekstvariabele verwijderen

  1. Selecteer Bestand > Formuliereigenschappen.

  2. Selecteer de variabele op het tabblad Variabelen en klik op Verwijderen (Verwijderen)  .

Variabelen gebruiken in berekeningen en scripts

Als u formuliervariabelen hebt gemaakt, hoeft u in uw berekeningen en scripts alleen naar de naam van de variabele te verwijzen om de waarde van deze variabele op te halen.

Belangrijk: Als u namen toewijst aan variabelen, moet u geen namen gebruiken die gelijk zijn aan de namen van eigenschappen, methoden en objecten in het XML-formulierobjectmodel.

Zie de Scriptreferentie voor informatie over eigenschappen, methoden en objecten van het XML-formulierobjectmodel.

Maak bijvoorbeeld de volgende definities van formuliervariabelen:

Naam van variabele

Waarde

voorNaam

Tony

achterNaam

Blue

age

32

In FormCalc kunt u de waarden van variabelen gebruiken op dezelfde manier als waarop u de waarden van de velden en objecten gebruikt. In dit voorbeeld zijn de waarden toegewezen aan drie afzonderlijke velden:

    TextField1 = firstName 
    TextField2 = lastName 
    NumericField1 = age

U kunt de variabelen in de FormCalc-functies ook op dezelfde manier gebruiken, zoals in dit voorbeeld:

    Concat( "Dear ", firstName, lastName )

In JavaScript verwijst u naar de waarden in de variabelen met de eigenschap .value in plaats van de eigenschap .rawValue die voor de waarde van velden en objecten wordt gebruikt, zoals in dit voorbeeld:

TextField1.rawValue = firstName.value;

Opmerking: Als formuliervariabelen door scripts in XFA-formulieren worden gebruikt en veranderd, kan op de documentberichtenbalk in Acrobat en Adobe Reader de waarschuwing verschijnen dat de geldigheid van de handtekening onbekend is als gevolg van wijzigingen in het document.