Skriptfragmente verwenden

Ein Skriptfragment enthält grundsätzlich ein Skriptobjekt. Ein Skriptobjekt enthält wiederverwendbare JavaScript-Funktionen oder Werte, die unabhängig von einem bestimmten Formularobjekt, z.B. einem Datumsparser oder einem Webdienstaufruf, gespeichert werden. Normalerweise verwenden Sie Skriptobjekte zur Erstellung von benutzerdefinierten Funktionen und Methoden, die Sie an mehreren Stellen in Ihrem Formular verwenden möchten. Dadurch wird der Arbeitsaufwand, der bei der Skripterstellung für sich wiederholende Aktionen normalerweise anfällt, erheblich reduziert.

Skriptfragmente enthalten nur Skriptobjekte, die als untergeordnete Objekte von Variablen auf der Palette „Hierarchie“ angezeigt werden. Fragmente können keine Skripten enthalten, die mit anderen Formularobjekten verbunden sind. Dies gilt z. B. für Ereignisskripten wie „validate“, „calculate“ oder „initialize“.

Sie können Skriptfragmente über die Palette „Hierarchie“ erstellen.

Skriptfragmente werden genau wie herkömmliche Fragmente bearbeitet.

Eigenschaften von Skriptfragmenten

Bei Auswahl eines Skriptfragments werden auf der Registerkarte „Skriptobjekt“ der Palette „Objekt“ die Eigenschaften des Skriptfragments angezeigt.

Quelldatei

Legt die Quelldatei für den Fragmentverweis fest. Diese Eigenschaft ist nur sichtbar, wenn das ausgewählte Objekt eine Fragmentverweis ist.

Fragmentname

Legt den Namen des Fragments fest. Über die Schaltfläche „Fragmentinformationen“ können Sie die entsprechenden Informationen zu einem Fragment anzeigen.

Diese Eigenschaft ist sichtbar, wenn ein Fragmentverweis bzw. ein in einer Quelldatei definiertes Fragment ausgewählt ist. Wenn es sich bei dem ausgewählten Objekt um einen Fragmentverweis handelt und keine Quelldatei angegeben wurde, wird diese Eigenschaft nicht angezeigt. Unter „Fragmentname“ werden alle in der angegebenen Quelldatei festgelegten Fragmente aufgeführt. Die Option „Benutzerdefiniert“ bietet eine direkte Unterstützung für das Festlegen eines SOM-Ausdrucks oder eines ID-Werts als Fragmentverweis sowie für die Implementierung in die XML Forms Architecture.

So erstellen Sie ein Skriptfragment

Sie können ein in mehreren Formularen wiederverwendbares Skriptfragment mit allgemeinen Funktionen erstellen. Zum Erstellen eines Skriptfragments erstellen Sie ein Skriptobjekt mit den entsprechenden wiederverwendbaren Funktionen. Ein Skriptfragment kann auch nur aus einem Skriptobjekt bestehen.

  1. Erstellen Sie ein Skriptobjekt.

  2. Klicken Sie in der Palette „Hierarchie“ mit der rechten Maustaste auf das Skriptobjekt und wählen Sie „Fragmente“ und dann „Fragment erstellen“.

    Hinweis: Sie können Skriptfragmente auch durch Ziehen des Skriptobjekts aus der Palette „Hierarchie“ in die Palette „Fragmentbibliothek“ erstellen.

  3. Zum Verwenden eines anderen Fragmentnamens geben Sie im Feld „Name“ den gewünschten Namen ein.

  4. (Optional) Geben Sie im Feld „Beschreibung“ eine Beschreibung des Fragments ein.

  5. Wählen Sie eine Methode zum Erstellen des Fragments:

    • Wenn Sie das Fragment in einer separaten XDP-Datei definieren möchten, die in der Fragmentbibliothek gespeichert wird, wählen Sie die Option „Neues Fragment in Fragmentbibliothek erstellen“. Wählen Sie in der Liste „Fragmentbibliothek“ die Fragmentbibliothek aus, in der Sie die Fragmentdatei speichern möchten. Wenn Sie einen anderen Dateinamen verwenden möchten, geben Sie im Feld „Dateiname“ den gewünschten Dateinamen für das Fragment ein. Wenn Sie die Auswahl nicht durch das neue Fragment ersetzen möchten, deaktivieren Sie das Kontrollkästchen „Auswahl durch Verweis auf neues Formularfragment ersetzen“.

    • Um das Fragment in der aktuellen Datei zu definieren, wählen Sie „Neues Fragment in aktuellem Dokument erstellen“.

  6. Klicken Sie auf OK.

So fügen Sie ein Skriptfragment ein

Skriptfragmente bieten Ihnen die Möglichkeit, JavaScript-Funktionen in mehreren Formularen wiederzuverwenden. Beim Erstellen eines neuen Formularentwurfs fügen Sie einen Verweis auf ein vorhandenes Skriptfragment ein. Das Fragment wird dann im Formularentwurf angezeigt.

Fragmente können nicht in XFAF-Dokumente eingefügt werden.

Hinweis: Aktivieren Sie im Menü der Palette „Fragmentbibliothek“ die Option „Vorschaufenster einblenden“, um eine Vorschau der Fragmente in der Palette anzuzeigen.

So fügen Sie ein Skriptfragment über die Palette „Fragmentbibliothek“ ein

  1. Wählen Sie in der Fragmentbibliothek das Skriptfragment aus.

  2. Ziehen Sie das Fragment auf ein Teilformular- oder Variablen-Objekt in der Palette „Hierarchie“.

So fügen Sie ein Skriptfragment über das Menü „Einfügen“ ein

  1. Wählen Sie „Einfügen“ „Fragment“.

  2. Rufen Sie die Datei mit dem Fragment auf.

  3. Wählen Sie die Datei aus und klicken Sie auf „OK“. Das Fragment wird im Stammteilformular als dem Variablen-Objekt untergeordnetes Objekt angezeigt.