Plugin installed incorrectly. Rename plugin directory 'swiftmail.backup' to 'swiftmail'.
Dies ist eine alte Version des Dokuments!
Konfigurieren statt Programmieren
Schnell Smartforms erstellen. Validierung, Layout, Struktur
Ausbaustufen:
2.1 Systemrollen für den Zugang zur TSS
Die folgenden Systemrollen müssen im TIM Admin Client den entsprechenden Usern zugeordnet werden, so dass sie die Ausbaustufen der TIM Smartform Suite nutzen können:
2.2 Zugang via Repository
Der Zugang zum Konfigurator der TSS erfolgt über das TIM Repository. Im Tab Smartform des gewünschten Prozess befindet sich der BEARBEITEN-Button. Ein Klick auf ihn öffnet den Konfigurator.
2.3 Systemrolle für die Verwaltung von TSS Ressourcen
Alle Datei-Artefakte, die für die Erstellung von Smartforms benötigt werden, werden in der Datenbank zentral abgelegt.
Zur Verwaltung der Artefakte wurde eine Oberfläche im Admin Client integriert.
Die folgende Rolle wird zur Verwaltung von TSS-Resourcen (z.B. Konfigurationsdateien, csv-Dateien, css-Dateien, etc.) in Ihrem Mandanten oder im super-Mandant benötigt:
2.3.1 Globale Ressourcen im super-Mandant
Im super-Mandanten müssen nach der Installation/ einem Update der TSS die grundlegenden Konfigurationen (Dokumententyp Konfigurationsdateien) für die Applikationen CMD und CFG hochgeladen werden
2.3.2 Mandantenspezifische Ressourcen
In Ihrem Mandanten können Sie analog Artefakte verwalten, die nur innerhalb des Mandanten gelten und verfügbar sind
Hierzu zählt analog eine
CSS-Datei zur Gestaltung des mandantenspezifischen CIs (Highlightfarben, Akzente, etc.)
Weiterhin Datenformate wie csv, txt, xls, png, etc. zur Integration als Datenquellen in Smartforms
3.1 Zielgruppe & Projektscope
Fachnutzer, die ein einfaches Smartform erstellen möchten
Vorgegebene Templates
Bewusst eingeschränkte Auswahl an gängigen Datentypen
Anlegen und Anordnen von Attributen
Nur einfache Smartforms, d.h. ohne Tabpages, Tabellen, Accordions, etc.
3.2 Erklärung der Oberfläche und Funktionen – Zielgruppe Fachnutzer!
3.2.1 Oberfläche und Bedienphilosophie
Im Fokus des Smartform Designers steht das Smartform.
Es basiert auf einem Template und bietet die Möglichkeit, Attribute per drag and drop anzuordnen.
Somit können Sie sich ihr Formular so gestalten, wie es zu Ihrem Prozess passt.
Die TSS ermöglicht Ihnen, ohne viel Vorwissen, eine einheitliche Bedienphilosophie in Ihren Smartforms umzusetzen.
Durch einheitliche Strukturen für die Anordnung von Elementen, Validierungen, Pflichtfeldern und Editierbarkeit, etc. finden sich Ihre Endnutzer sehr schnell in allen Prozessen zurecht
Über den Button Aktivitäten einlesen können Sie die Aufgaben Ihres modellierten Prozess einlesen
Über Import und Export können Sie eine bestehende Konfiguration als Grundlage importieren oder zum externen Backup/ Weiterverwendung in anderen Prozessen exportieren
Über Validieren können Sie prüfen lassen, ob Ihre Konfiguration syntaktische Fehler enthält
Über
Testen können Sie sich live anschauen, wie Ihr Smartform in einer konkreten Aufgabe aussieht (Details siehe
3.2.3 Testmodus)
Über Veröffentlichen sichern Sie Ihre Konfiguration. Alles, was Sie konfigurieren muss erst durch Veröffentlichen gesichert werden, bevor es im ToDo Client sichtbar wird.
Es empfiehlt sich ein häufiges Veröffentlichen, nachdem/ bevor Sie komplexe Änderungen am Smartform vornehmen
Grundlegend wird das Smartform für den Wert „—“ in der Statusdropdown erstellt. Dies stellt die grundlegende Konfiguration dar.
Per drag and drop können Attribut beliebig in der Reihenfolge innerhalb eines Elementes angeordnet, in ein anderes Element verschoben oder für einen Status ausgeblendet werden
3.2.2 Attribute
Im Smartform Designer werden die Attribute für die strukturierte Erfassung und Darstellung von Prozessinformationen angelegt.
Ein neues Attribut wird durch einen Klick auf [neu] () und drag&drop in das gewünschte Element angelegt.
Die Ablage erfolgt als TIM Prozessvariablen
Die Attribute sind im Prozess mit ${technischer_Attributname} für die Steuerung des Prozesses oder zur Verwendung in WordTemplates, Mails, etc. verfügbar
Eine spätere Auswertbarkeit im Dashboard zur KVP ist gegeben
Wenn ein neues Attribut auf ein Element gezogen wird, oder auf ein bereits platziertes Attribut geklickt wird, dann erscheint das Attribute-Popup zur Pflege der Eigenschaften:
Feld | Beschreibung |
Attribut | technischer Identifikator für das Attribut. Kann auch in Aufgabenmails mit ${…} referenziert werden(„status“ sowie „name“ sind als Attribut zu vermeiden) |
Beschreibung | Erscheint als Tooltip, wenn der Nutzer mit der Maus über das Feld fährt |
Datentyp | Auswahl eines Datentyps oder Erstellen eines eigenen zur individuellen Validierung (siehe Datentypen) |
Beschriftung | Wird als Text links neben dem Eingabefeld dargestellt |
UI-Flag | Definition der Editierbarkeit des Attributs (Details s.u.) |
Layout | Auswahl eines Layouts zur Darstellung des Attributs (siehe Datentypen) |
Breite Überschrift | Breite des Bereiches, in dem die oben angegebene Beschriftung dargestellt werden soll |
Breite Zwischenraum | Abstand zwischen Beschriftung und Feld |
Breite Wert | Breite des Eingabefeldes |
Höhe | Höhe des Eingabefeldes. Bei allem über 24px wird die Layoutvariante „groß“ verwendet. (siehe Datentypen) |
Buttons | Beschreibung |
Für alle Status auf Standard zurücksetzen | Dieser Button erscheint, wenn die Statusdropdown auf „—“ steht. Damit können alle Status-spezifischen Varianten des Attributs zurückgesetzt werden |
Auf Standard zurücksetzen | Dieser Button erscheint, wenn die Statusdropdown auf einem Status ungleich „—“ steht. Damit kann die Status-Variante auf die Grundkonfiguration des Attributs zurückgesetzt werden |
„Zurücksetzen einzelner Attributvarianten auf Standard“-Icon | Jede Attributeigenschaft, die für einen ausgewählten Status von der Grundkonfiguration abweicht, wird fett dargestellt. Zudem erscheint daneben ein Icon, mit dem die betroffene Eigenschaft auf die Grundkonfiguration zurückgesetzt werden kann |
Kopieren-Icon | Nutzt das geöffnete Attribut als Grundlage für eine Neuanlage. Die Felder Attribut und Beschriftung werden zurückgesetzt |
Löschen-Icon | Löscht das Attribut aus der Konfiguration. Dieses Icon ist nur im Status „—“ verfügbar. Wenn Sie ein Attribut für einen Status nur ausblenden möchten, dann ziehen Sie es bitte per drag and drop auf die Fläche Attribut ausblenden neben der Statusdropdown. Sobald die Fläche rot wird, lassen Sie die linke Maustaste los. Das Attribut wird für den Status ausgeblendet, es verbleibt aber links in der Attributauswahlliste |
Speichern-Icon | Speichert die getätigten Änderungen/ Neuanlage |
Rückgängig-Icon | Setzt die getätigten Werte auf den Stand zurück, zu dem das Attribut das letzte mal gespeichert wurde |
Hinweis: Details zum Statusabhängigen Konfigurieren siehe Statusabhängige Konfiguration - Aktivitäten einlesen
Die UI-Flags dienen zur Konfiguration der Editierbarkeit und können im Attribute-Popup entweder durch die Lupe in einem Popup ausgewählt, oder direkt eingegeben werden:
3.2.3 Testmodus
Der Testmodus dient dazu, das Smartform für einen ausgewählten Status zu testen, d.h. es öffnet sich nach Klick auf TESTEN ein Popup, in dem das Smartform voll funktional dargestellt wird. Dort können Sie prüfen, ob für den jeweiligen Status die konfigurierten Attribute sichtbar/ editierbar sind:
3.2.4 Statusabhängige Konfiguration - Aktivitäten einlesen
Nachdem Sie Ihr Smartform für den Status „—“ konfiguriert haben, können Sie es nun an die Besonderheiten der Aktivitäten im Prozess anpassen.
Hierzu klicken Sie bitte auf AKTIVITÄTEN EINLESEN. Die Dropdown füllt sich mit den Namen der Aktivitäten.
Nun können Sie eine Aktivität, oder einen der Standard-Status [neu, Suche, in Arbeit, Prozess-Manager, beendet, Betrachter] auswählen und das Formular entsprechend anpassen
Verschieben oder ausblenden von bereits angeordneten Attributen
Modifikation der Attributeigenschaften durch einen Klick auf ein Attribut. Details siehe
3.2.2 Attribute
* z.B. können Sie dadurch einstellen, dass ein Attribut für eine konkrete Aktivität ein Pflichtfeld wird
Hinweis: Wenn Sie ein Attribut nur für einen konkreten Status benötigen, dann müssen Sie es zuerst für den Status „—“ anlegen, und dort auf Attribut ausblenden schieben. Wenn Sie nun den gewünschten Status auswählen, dann können Sie das Attribut links in der Attributliste auswählen und in das gewünschte Element schieben.
3.2.5 Datentypen
Im Attribute-Popup können Sie aus einer Liste vordefinierter Datentypen auswählen:
Datentyp | Beschreibung | Beispielhafte Verwendung |
boolean | Boolescher Wert | Als Checkbox |
decision-no-yes | Boolscher Wert nein/ja | Als Radio Button mit Ausprägung Ja/ Nein |
date | Datums-Angabe | Als Textfeld mit Date Picker |
email | Text mit automatischer Validierung von E-Mails | Als Textfeld |
float.2 | Gleitkommazahl mit zwei Nachkommastellen | Als Textfeld, welches den Input versucht, zu einer Zahl mit 2 Nachkommastellen umzuwandeln. Alle anderen Eingaben werden verweigert |
int | Ganze Zahl | Als Textfeld, welches den Input versucht, zu einer Zahl umzuwandeln. Alle anderen Eingaben werden verweigert |
message | Darstellung einer Meldung | Zur Darstellung von Hinweistexten |
percent.0 | Prozentwert ohne Nachkommastelle | Als Textfeld mit fester Einheit % und Validierung auf Zahlen |
price-€ | Preisangabe mit Tausendertrennzeichen und Währung EUR | Als Textfeld mit fester Einheit EUR und Validierung auf Zahlen mit 2 Nachkommastellen |
string4000 | Zeichenkette mit einer Maximallänge von 4000 Zeichen | Als ein- oder mehrzeiliges Textfeld |
3.2.6 Templates
Grundlegend basiert das Smartform auf einem Template, welches das grobe Layout vorgibt. Serienmäßig wird das Template 3columns vorgegeben. Wenn Sie ein individuelles Template für Ihren Prozess benötigen, so kann dies im Smartform Architect oder Expert erfolgen. Hierzu öffnet ein Nutzer mit der Rolle smartform-architect oder smartform-expert Ihre Konfiguration und erstellt ein Template. Anschließend können Sie das Template via ELEMENTE ANPASSEN auswählen und Ihre Attribute darin anordnen
Hinweis: Der Smartform Architect richtet sich an Fachuser. Deswegen ist eine Pflege von komplexen Layoutelementen, wie z.B. Tabs und Platzhalter für die Darstellung von Tabellen, nicht im Designer pflegbar
3.2.7 Ergebnis im ToDo Client
Der folgende Screenshot zeigt das konfigurierte Smartform einmal für den Prozessstart und einmal für die erste Aufgabe. Sie können sehen, dass teilweise Attribute ausgeblendet, oder rot als Pflichtfelder hervorgehoben sind:
3.2.8 Config zum Selbertesten
Die Konfiguration, anhand der die Screenshots erstellt wurden, können Sie hier einsehen und für Ihre Tests verwenden: Beispielkonfiguration
4.1 Zielgruppe & Projektscope
IT Berater
Erstellung komplexer Smartforms mit Datenstrukturen, Tabpages, etc.
Integration von strukturierten Daten aus csv, txt, xls oder Datenbanktabellen
Erstellung von Übersetzungen für mehrsprachige Smartforms in DE und EN
Erstellung von Datentypen, Templates und Meldungen für einen Prozess
Einfacher Zugang zu Groovy für showInterface zum modifizieren der Benutzeroberfläche für Sonderkonstellationen oder Feldabhängigkeiten
ALLES, was für einen Prozess definiert wird, d.h. Templates, Datentypen, etc. ist nur innerhalb dieses Prozesses gültig und existent!
4.2 Erklärung der Oberfläche und Funktionen
Überblick: Menü; Sidebar;
WYSIWYG
-
5.1 Zielgruppe & Projektscope
IT Berater und Entwickler
Tiefe Systemintegration
Komplexe Konfigurationsmöglichkeiten
Groovy extended. Auch zur Verwendung im Prozess via CBAGenericActionHandler möglich
ALLES, was für einen Prozess definiert wird, d.h. Templates, Datentypen, etc. ist nur innerhalb dieses Prozesses gültig und existent!
5.2 Erklärung der Oberfläche und Funktionen
Überblick: Menü; Sidebar;
WYSIWYG
-
6.1 Modul Bedienoberfläche
6.2 Modul Templates
6.3 Modul Tabellen
dau- immer entsprechend des Dateityps, oder Datenbankzugriff
Bei Ablage als Prozessvariable (BL-Flag P) immer dau-tim verwenden. Achtung: Max. 4000 Zeichen in einer Prozessvariable erlaubt. Dies schließt Steuerzeichen der Tabelle mit ein. Bitte nur zum fixen Testen verwenden
6.4 Modul Datentypen
Auflistung aller Basistypen und Details dazu
Reguläre Ausdrücke
Stellen Pattern erlaubter Zeichenketten dar.
Ist im Feld für den regulären Ausdruck ein Pattern eingegeben, ist der Attributwert nur erlaubt, wenn er dem Pattern entspricht.
-
Masken
6.5 Modul Meldungen
6.6 Modul Übersetzung
6.7 Modul funktionale Struktur
6.8 Verwaltung von TSS-Resourcen
7.1 Attribute in Taskliste darstellen
Attribute, die in der Taskliste angezeigt werden sollen, sind sog. Indexfelder
Es gibt 10 Felder, die mit beliebigen Attributen belegt werden können
Modul Tabellen - tim_process auswählen - Tab Attribute - Attribut auswählen - rechts in der Sidebar unter Geschäftslogik das BL-Flag auf 1 oder 2 … oder 0 setzen - speichern - Veröffentlichen - Echten Prozess zum Testen starten
Die Spaltenüberschriften können mittels dem folgenden Eintrag in der custom.js für jeden Mandanten angepasst werden:
7.2 Besondere Eigenschaften von Attributen
7.3 Einbinden einer csv-Datei für ein Autocomplete-/Dropdownfeld
Zuerst muss im Modul Tabellen eine Tabelle angelegt werden, die genau so heißt, wie die vorliegende csv, txt oder xls
Die Tabelle bekommt die entsprechend ihrer Endung passende DAU zugeordnet.
Die BLU muss immer auf blu-basic gesetzt werden
Nun müssen in dieser Tabelle alle Spalten, die in der zugrundeliegenden Datei existieren, als Attribute angelegt werden
Dies ist analog zu den Attributen im Smartform auszufüllen
Wichtig: DA-Flag immer auf „SIU“ setzen
Indizes: Hier geben Sie an, welche Spalten zur eindeutigen Referenz (= Index 1) eines Datensatzes zusammengezogen werden müssen
Ref.-Typ:
Hier entscheiden Sie, welches Attribut mit „D“ automatisch als Bezeichnung, z.B. später in einer Dropdown verwendet wird
Hier entscheiden Sie, welches Attribut mit „I“ automatisch als fachlicher Kurzidentifier verwendet wird
Hier entscheiden Sie, welches Attribut mit „V“ automatisch verwendet wird, wenn ein ausgewählter Eintrag gespeichert wird
Details siehe unten (Exemplarisches Ergebnis eines Dropdowneintrags im
HTML: <option value=„Attribut mit V“>„Attribut mit I“ „Attribut mit D“</option>)
7.4 Erstellung von Tabpages
7.5 Integration einer fachlichen Tabelle als Grid
7.6 Erstellung eines Accordions
Im Modul Bedienoberfläche gibt es für jede Bedienoberfläche links in der Sidebar den Button „showInterface“
Mit dem Flag r kann das Neuladen des Smartforms nach Eingabe eines Wertes in ein Feld aktiviert werden
Dadurch wird das Smartform neu geladen und showInterface erneut ausgeführt
Ebenso werden dynamische Filter in Datentypen oder Tabellen, die auf andere Attribute zugreifen, neu ausgeführt
Eingegebene Daten bleiben bei diesem Neuladen erhalten
Beispiele:
def locale = FRAME.getProperty("locale_id").toUpperCase();
if (locale != null && locale.length() > 1 && locale.substring(0,2) != "DE") {
DATA_ROW.setValue("mm_sprache","EN");
}
ICbaRow attribut_xxxx = FRAME.searchRow("dd_intattr", "interf_recid=" + CONFIG_ROW.getRecid() + "&attr_id=TECHNISCHER_ATTRIBUTNAME");
attribut_xxxx.setValue("ui_flag", "D");
String wert_des_attributs_im_moment_des_seitenaufbaus = DATA_ROW.getValue("TECHNISCHER_ATTRIBUTNAME");
DATA_ROW.setValue("TECHNISCHER_ATTRIBUTNAME", "neuer_Wert_für_das_Attribut");
7.8 Konfiguration von statusabhängigen Attributeigenschaften
Zurücksetzen einzelner Attributvarianten auf Standard
„Für alle Status auf Standard zurücksetzen“ bzw. „Auf Standard zurücksetzen“ Schaltflächen
Statusübersicht. Kopieren, Löschen, * Schritt, der entfallen ist *
8. Installation
9. Altes CBA Wiki