Register Eigenschaften
Auf dem Register „Eigenschaften“ lassen sich einige Einstellungen vornehmen, die für das entsprechende Skript gültig sein sollen. Das Register ist noch einmal unterteilt in die Bereiche Allgemeines und Einblendung.
In der kompakten Darstellung wird dieses Register durch das Icon dargestellt (siehe Kompakte Darstellung von Registern (→Handbuch FirstSpirit SiteArchitect)).
Allgemeines
Referenzame
Referenzname des Skriptes.
Kommentar
Hier kann ein optionaler Kommentar eingegeben werden, der das Skript näher beschreibt.
Tastaturkürzel
Für Skripte kann in diesem Feld ein eindeutiges Tastaturkürzel definiert werden. Das Skript muss in diesem Fall nicht mehr über das Kontextmenü oder das Menü „Extras“ ausgeführt werden, sondern kann direkt über das festgelegte Tastaturkürzel aufgerufen werden. Um ein neues Tastaturkürzel zu definieren, muss sich der Cursor innerhalb des Feldes befinden. Anschließend genügt es, die gewünschte Tastenkombination über die Tastatur einzugeben. Die Eingabe wird dann in das Eingabefeld übernommen. Eine Texteingabe ist nicht möglich. Zum Ändern des Tastenkürzels den Cursor erneut im Feld positionieren und anschließend die neue Tastenkombination aufrufen. Um ein definiertes Tastenkürzel für das Skript zu löschen, das Icon drücken.
Tastaturkürzel können nur für Skripte vom Typ „Menü“, „Menü und Einstiegsseite“ und „Kontextmenü“ verwendet werden.
Näheres zum Thema Vorgabewerte siehe Kapitel „Vorlagenentwicklung / Formulare“.
Einblendung
Geltungsbereich
Skripte können für verschiedene Geltungsbereiche konfiguriert werden:
- Vorlage: Das Skript kann innerhalb einer Vorlage über $CMS_RENDER(script:..)$ aufgerufen und ausgeführt werden, z. B. zum Rendern bestimmter Inhalte für den PDF-Vorlagensatz:
<fo:table table-layout="fixed" width="170mm">
$CMS_RENDER(script:"fotablecolumns",colWidth:set_cw,colNumbers:set_cn)$
<fo:table-body>
$CMS_VALUE(#content)$
</fo:table-body>
</fo:table>
- Menü: Das Skript kann im SiteArchitect über das Menü Extras > Skript ausführen aufgerufen und ausgeführt werden.
- Menü und Einstiegsseite: Das Skript kann im SiteArchitect über das Menü Extras > Skript ausführen sowie über die Projekteinstiegsseite (Icon , Bereich „Meine Aktionen“) aufgerufen und ausgeführt werden.
- Kontextmenü: Das Skript kann über das Kontextmenü auf einem bestimmten Element in der Baumansicht oder auf Pfaden im Arbeitsbereich des FirstSpirit SiteArchitect aufgerufen und ausgeführt werden.
- ContentCreator: Das Skript kann im ContentCreator über das Icon bzw. aufgerufen werden (z. B. in der EasyEdit-Toolbar, Navigationsleiste ...).
Ausnahme: auf Remote-Elementen
Die Skript-Aktionen sind über die Tailored UI einzeln steuerbar (... Execute script).
Wird in einem ausgeführten Skript vom Typ „ContentCreator“ true zurückgegeben (return true;), wird in diesem Fall das entsprechende Vorschau-Element aktualisiert. Wenn ein Skript Änderungen vornimmt, kann so bei Bedarf ein Vorschau-Reload ausgelöst werden.
Zu weiteren Kontexten siehe auch FirstSpirit Skripte.
In Projekten, die uninterpretierte Skripte verwenden, sollen die entsprechenden Vorlagen auf Formatvorlage umgestellt werden. Aus diesem Grund ist das Speichern von Skripten dieses Typs zukünftig nicht mehr möglich, bis eine Umstellung auf einen anderen Skripttyp erfolgt ist. In neu angelegten Skripten steht dieser Typ nicht mehr zur Verfügung. |
Skripte der Typen „Menü“ und „Menü und Einstiegsseite“ werden auch im ContentCreator-Menü „Aktionen“ angezeigt. |
Immer einblenden
Soll die Einblendelogik deaktiviert werden, kann die Checkbox „Immer einblenden“ aktiviert werden. Das Skript wird in diesem Fall, unabhängig von der Einblendelogik, immer eingeblendet. Die hinterlegte Einblendelogik wird zwar nicht mehr ausgewertet, bleibt aber erhalten und kann durch das Deaktivieren der Checkbox wieder aktiviert werden.
Einblendelogik verwenden
Die hinterlegte Einblendelogik wird berücksichtigt, wenn die Option „Einblendelogik verwenden“ aktiviert ist.
Über die Einblendelogik können Skripte vom Typ „Menü“, „Menü und Einstiegsseite“ oder „Kontextmenü“ abhängig von bestimmten Eigenschaften eingeblendet oder ausgeblendet werden (analog zur Einblendelogik von Arbeitsabläufen). Beispielsweise kann ein Skript vom Skripttyp „Kontextmenü“ nur dann angezeigt werden, wenn das Kontextmenü auf einer Seitenreferenz in der Struktur-Verwaltung aufgerufen wird:
//!Beanshell
import de.espirit.firstspirit.access.store.sitestore.PageRef;
storeElement = context.getElement();
return (storeElement instanceof PageRef);