Werken met scriptfragmenten

Een scriptfragment bevat een scriptobject. Een scriptobject bevat herbruikbare JavaScript-functies of waarden die afzonderlijk van een bepaald formulierobject wordt opgeslagen, zoals datumparsering of aanroep van een webservice. Doorgaans gebruikt u scriptobjecen om aangepaste functies en methoden te maken die u wilt gebruiken op verscheidene locaties in een formulier. Met scriptobjecten vermindert u het aantal scripts dat is vereist om herhaalde bewerkingen uit te voeren.

Scriptfragmenten omvatten alleen scriptobjecten die als onderliggende elementen van variabelen in het palet Hiërarchie voorkomen. Fragmenten kunnen geen scripts bevatten die zijn gekoppeld aan andere formulierobjecten, zoals gebeurtenisscripts als validate, calculate of initialize.

U maakt een scriptfragment vanuit het palet Hiërarchie.

Scriptfragmenten worden op dezelfde manier bewerkt als andere fragmenten.

    Scriptfragmenteigenschappen

    Als u een scriptfragment selecteert, wordt op het tabblad Scriptobject in het palet Object de fragmenteigenschappen weergegeven.

    Bronbestand

    Hier geeft u het bronbestand voor de fragmentverwijzing op. Deze eigenschap is alleen zichtbaar wanneer het geselecteerde object een fragmentverwijzing is.

    Fragmentnaam

    Hier geeft u de naam van het fragment op. U kunt klikken op de knop voor fragmentinformatie voor informatie over het fragment.

    Deze eigenschap is zichtbaar wanneer een fragmentverwijzing is geselecteerd, of een fragment dat in een bronbestand is gedefinieerd. Als het geselecteerde object een fragmentverwijzing is, wordt deze eigenschap niet weergegeven als het bronbestand niet is opgegeven. De lijst met fragmentnamen bevat alle fragmenten in het opgegeven bronbestand. De optie Aangepast ondersteunt rechtstreeks de instelling van een SOM-expressie of een ID-waarde als de fragmentverwijzing en ondersteunt de implementatie in de XML-formulierarchitectuur.

      Een scriptfragment maken

      U kunt een scriptfragment van algemene functies maken dat u in meerdere formulieren kunt hergebruiken. U maakt een scriptfragment door een scriptobject te maken met de functies die u wilt hergebruiken in meerdere formulierontwerpen. Het scriptfragment kan slechts één scriptobject bevatten.

      1. Maak een scriptobject.

      2. Klik in het palet Hiërarchie met de rechtermuisknop op het scriptobject en selecteer Fragmenten > Fragment maken.

        Opmerking: U kunt ook een scriptfragment maken door het scriptobject van het palet Hiërarchie naar het palet Fragmentbibliotheek te slepen.

      3. Typ een naam voor het fragment in het vak Naam als u de naam wilt wijzigen.

      4. (Optioneel) Typ in het vak Beschrijving een beschrijving van het fragment.

      5. Selecteer een methode om een fragment te maken:

        • Selecteer Nieuw fragment maken in fragmentbibliotheek om het fragment in een afzonderlijk XDP-bestand te definiëren dat in de fragmentbibliotheek wordt opgeslagen. Selecteer in de lijst Fragmentbibliotheek de fragmentbibliotheek waarin u het fragmentbestand wilt opslaan. Typ een bestandsnaam voor het fragment in het vak Bestandsnaam als u de bestandsnaam wilt wijzigen. Als u de selectie niet wilt vervangen door het nieuwe fragment, heft u de selectie van Selectie vervangen door verwijzing naar nieuw formulierfragment op.

        • Selecteer Nieuw fragment maken in huidig document als u het fragment in het huidige bestand wilt definiëren.

      6. Klik op OK.

        Een scriptfragment invoegen

        U kunt met behulp van scriptfragmenten JavaScript-functies hergebruiken in meerdere formulieren. Bij het maken van een formulierontwerp voegt u een verwijzing in naar een bestaand scriptfragment en het fragment wordt in het formulierontwerp weergegeven.

        U kunt geen fragment invoegen in een XFAF-document.

        Opmerking: Selecteer Voorbeeldvenster weergeven in het menu van het palet Fragmentbibliotheek als u een voorbeeld van de fragmenten wilt zien.

        Een scriptfragment invoegen via het palet Fragmentbibliotheek:

        1. Selecteer het scriptfragment in de fragmentbibliotheek.

        2. Sleep het fragment naar een subformulier- of variabelenobject in het palet Hiërarchie.

        Een scriptfragment invoegen via het menu Invoegen:

        1. Selecteer Invoegen > Fragment invoegen.

        2. Navigeer naar het bestand met het fragment.

        3. Selecteer het bestand en klik op OK. Het fragment wordt weergegeven als onderliggend element van het variabele-object in het basissubformulier