Uso di frammenti di script

Un frammento di script contiene un oggetto script. Un oggetto script contiene funzioni JavaScript riutilizzabili o valori che vengono memorizzati separatamente da qualsiasi particolare oggetto modulo, ad esempio analisi delle date o chiamata a un servizio Web. Generalmente gli oggetti script sono utilizzati per creare funzioni e metodi personalizzati che si desidera usare in diversi punti di un modulo. L'utilizzo di oggetti script consente di ridurre la quantità di script totale necessaria per eseguire azioni ripetitive.

I frammenti di script includono solo oggetti script che vengono visualizzati come elementi secondari delle variabili nella palette Gerarchia. Nei frammenti non sono consentiti script associati ad altri oggetti modulo, ad esempio script di evento per eseguire convalide, calcoli o inizializzazioni.

È possibile creare un frammento di script dalla palette Gerarchia.

I frammenti di script sono modificabili nello stesso modo degli altri frammenti.

    Proprietà dei frammenti di script

    Quando si seleziona un frammento di script, la scheda Oggetto di script nella palette Oggetto consente di visualizzare le proprietà del frammento.

    File di origine

    Imposta il file di origine per il riferimento al frammento. Questa proprietà è disponibile solo se l'oggetto selezionato è un riferimento a un frammento.

    Nome frammento

    Imposta il nome del frammento. Se si desidera, è possibile fare clic sul pulsante Informazioni frammento per visualizzare le informazioni sul frammento.

    Questa proprietà è visibile se è selezionato un riferimento a un frammento o un frammento definito in un file di origine. Se l'oggetto selezionato è un riferimento a un frammento e non è specificato il file di origine, la proprietà non viene visualizzata. Nell'elenco dei nomi dei frammenti sono inclusi tutti i frammenti presenti nel file di origine specificato. L'opzione per la personalizzazione supporta direttamente l'impostazione di un'espressione SOM o di un valore ID come riferimento a un frammento; è inoltre supportata l'implementazione in XML Forms Architecture.

      Creazione di un frammento di script

      È possibile creare un frammento di script di funzioni comuni che è possibile riutilizzare in più moduli. Per creare un frammento di script, è possibile creare un oggetto script che contiene le funzioni che si desidera riutilizzare in più strutture del modulo. Il frammento di script può includere solo un oggetto script.

      1. Creare un oggetto script.

      2. Fare clic con il tasto destro del mouse sull’oggetto di script nella palette Gerarchia, quindi selezionare Frammenti > Crea frammento.

        Nota: Per creare un frammento di script è inoltre possibile trascinare l'oggetto script dalla palette Gerarchia alla palette Libreria frammenti.

      3. Per utilizzare un nome di frammento differente, digitare un nome per il frammento nella casella corrispondente.

      4. (Facoltativo) Nella casella Descrizione digitare una descrizione del frammento.

      5. Selezionare un metodo per la creazione del frammento:

        • Per definire il frammento in un file XDP separato e memorizzato nella Libreria frammenti, selezionare Crea nuovo frammento nella Libreria frammenti. Nell'elenco Libreria frammenti selezionare la Libreria frammenti all'interno della quale si desidera salvare il file del frammento. Per utilizzare un nome file differente, digitare il nome file per il frammento nell'apposita casella. Se non si desidera sostituire la selezione con il nuovo frammento, deselezionare l'opzione Sostituisci la selezione con un riferimento a un nuovo frammento del modulo.

        • Per definire il frammento nel file corrente, selezionare Crea nuovo frammento nel documento corrente.

      6. Al termine, fare clic su OK.

        Inserimento di un frammento di script

        È possibile usare frammenti di script per riutilizzare funzioni JavaScript in più moduli. Al momento della creazione di una struttura del modulo, è possibile inserire un riferimento ad un frammento di script esistente e il frammento viene visualizzato nella struttura del modulo.

        Non è possibile inserire un frammento in un documento XFAF.

        Nota: Per visualizzare un'anteprima dei frammenti disponibili nella palette Libreria frammenti, selezionare Mostra anteprima frammento nel menu della palette.

        Per inserire un frammento di script dalla palette Libreria frammenti:

        1. Selezionare il frammento di script nella Libreria frammenti.

        2. Trascinare il frammento su un oggetto sottomodulo o variabile nella palette Gerarchia.

        Per inserire un frammento di script dal menu Inserisci:

        1. Selezionare Inserisci > Frammento.

        2. Individuare il file che contiene il frammento.

        3. Selezionare il file, quindi fare clic su OK. Il frammento viene visualizzato come un elemento derivato dell'oggetto variabili nel sottomodulo principale