Använda skriptfragment

Ett skriptfragment innehåller ett skriptobjekt. Ett skriptobjekt innehåller återanvändningsbara JavaScript-funktioner eller värden som har lagrats separat från formulärobjekt, så som datumanalys eller webbtjänstanrop. Det används normalt för att skapa anpassade funktioner och metoder som du vill använda på olika ställen i formuläret. När du använder skriptobjekt behöver du inte skriva samma kod flera gånger när olika skript ska utföra samma handling.

Skriptfragmenten innehåller enbart skriptobjekt som visas som underordnade variabler i paletten Hierarki. Fragment kan inte innehålla skript som är kopplade till andra formulärobjekt, t.ex. händelseskript som validate, calculate och initialize.

Du skapar ett skriptfragment från paletten Hierarki.

Du redigerar skriptfragment på samma sätt som du redigerar andra fragment.

    Egenskaper för skriptfragment

    När du markerar ett skriptfragment visas fragmentegenskaperna på fliken Skriptobjekt på paletten Objekt.

    Källfil

    Anger fragmentreferensens källfil. Egenskapen är endast synlig om det markerade objektet är en fragmentreferens.

    Fragmentnamn

    Anger fragmentets namn. Du kan klicka på knappen Fragmentinformation och utvidga området automatiskt.

    Den här egenskapen visas när en fragmentreferens eller ett fragment som har definierats i en källfil har markerats. Om det markerade objektet är en fragmentreferens visas inte den här egenskapen om källfilen inte har specificerats. I listan Fragmentnamn visas alla fragment i den specificerade källfilen. Alternativet Egen stöder inställningen av ett SOM-uttryck eller ett ID-värde som fragmentreferens och stöder implementering i XML-formulärarkitekturen (XML Forms Architecture).

      Skapa ett skriptfragment

      Du kan skapa ett skriptfragment av vanliga funktioner som du kan återanvända i flera formulär. Om du vill skapa ett skriptfragment skapar du ett skriptobjekt som innehåller de funktioner som du vill återanvända i flera formulärdesigner. Skriptfragmentet kan innehålla enbart ett skriptobjekt.

      1. Skapa ett skriptobjekt.

      2. Högerklicka på skriptobjektet på paletten Hierarki och välj Fragment > Skapa fragment.

        Obs! Du kan även skapa ett skriptfragment genom att dra skriptobjektet från paletten Hierarki till paletten Fragmentbibliotek.

      3. Om du vill använda ett annat fragmentnamn skriver du det i rutan Namn.

      4. (Valfritt) Skriv en beskrivning av fragmentet i rutan Beskrivning.

      5. Välj en metod för att skapa fragmentet:

        • Om du vill definiera fragmentet i en separat XDP-fil som lagras i fragmentbiblioteket väljer du Skapa nytt fragment i fragmentbibliotek. Välj fragmentbibliotek där du vill spara fragmentfilen i fragmentbibliotekslistan. Om du vill använda ett annat filnamn skriver du fragmentets filnamn i rutan Filnamn. Om du inte vill ersätta urvalet med det nya fragmentet avmarkerar du Ta bort avsnitt med referens till nytt formulärfragment.

        • Om du vill definiera fragmentet i det aktuella dokumentet väljer du Skapa nytt fragment i aktuellt dokument.

      6. Klicka på OK.

        Infoga ett skriptfragment

        Du kan använda skriptfragment för att återanvända JavaScript-funktioner i flera formulär. När du skapar en formulärdesign infogar du en referens i ett befintligt skriptfragment, och fragmentet visas i formulärdesignen.

        Du kan inte infoga något fragment i ett XFAF-dokument.

        Obs! Om du vill förhandsgranska fragmenten på fliken Fragmentbibliotek väljer du Visa förhandsgranskningsfönster på palettmenyn.

        Så här infogar du ett skriptfragment från paletten Fragmentbibliotek:

        1. Välj ett skriptfragment i fragmentbiblioteket.

        2. Dra fragmentet till ett delformulär eller variabelobjekt på paletten Hierarki.

        Infoga ett skriptfragment från Infoga-menyn:

        1. Välj Infoga > Fragment.

        2. Navigera till den fil som innehåller fragmentet.

        3. Markera filen och klicka på OK. Fragmentet visas som underordnat variabelobjektet i rotdelformuläret