This is an old revision of the document!
This page is not fully translated, yet. Please help completing the translation.
(remove this paragraph once the translation is finished)
A user has to have the following TODO:roles Systemrollento use the corresponding version of the TIM smartform suite:
The acces to the configurator of the TSS happens via TODO TIM Repository. In the Tab “Smartform” you can find an “EDIT”-Button. The configurator will be opened in a seperate tab upon clicking it.
Every data-artifact wich is used for the creation of a smartform is saved in a central database. An UI is integrated for the management of the artifacts was integrated in the admin client. A user needs the following role to manage the tss-recources (z.B- confiuratins, CSV-documents, CSS-documents etc. TODOVerwaltung von TSS-Resourcen in his client or super- client:
After the installation/update of the TSS the basic configurations (documenttype CONFIG-document) for the applications CMD and CFG have to be uploaded in the super- client.
It is possible to have artifacts in your client, wich are only available and effective in your client.
The smartform designer focuses on the smartform.
In the smartform Designer you can create attributes to gather and display process information.
Field | Description |
---|---|
Attribute | Identifier of the attribute. Can be referenced with ${…} in emails. (“status” and “name” mustn't be used as attribute-identifier) |
Decription | Appears as a tooltip as soon as the user places his mouse on the element |
Data-Type | You can select a data-type or create an individual validation (see also TODODatentypen) |
Caption | Will be displayed as text in the left side of the element |
UI-Flag | Definition of the editability of the element |
Layout | Selection of a layout for the display of the attribute. (see also TODODatentypen) |
Width label | Width of the space where the desctription will appear |
Width space | Distance between description and attribute |
Width value | Width of the attribute |
Height | Height of the attribute. Every height that is bigger than 24px will be displayed with the layout-option “big” (see also TODODatentypen) |
Button | Description |
---|---|
Reset all status to default | This button will appear, if the status-dropdown is set to ”—“. It will reset every status-specified versions of the attribute. |
Reset actual status to default | This button will appear if the status-dropdown is set to something different then ”—“. By pressing it you will reset the configurations of this attribute for the selected status. |
“Reset a selected attribute-property”-Icon | Every attribute-property that differs from the standart-configuration will be desplayed in a bold text. Moreover a button will appear, that will reset the property upon pushing |
Copy-Icon | Uses the attribute for the creation of a new one. The properties Attribute and Label will be reseted. |
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:
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:
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.
* 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.
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 |
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 |
Anlegen von komplexeren Datentypen ist aber auch im Designer möglich:
Dafür ist es notwendig einen neuen, eigenen, Datentypen zu erstellen, wie oben bereits beschrieben. Nachdem man auf das PLUS-Icon geklickt hat, muss man als Basistyp “String” auswählen, die Rot hinterlegten Felder ausfüllen und bei “Eigenschaften” “Werteliste” auswählen. Der Wert “Länge” gibt hierbei an, wie viele Zeichen das Label (Text vor dem jeweiligen Radiobutton) eines Radiobuttons enthalten darf. Wenn man nun auf Speichern (Diskette) klickt, erscheinen 2 Reiter: “Werte” und “Layout”. Sie müssen in dem Reiter “Werte” jeden gewünschten Radiobutton als einzelne Zeile hinterlegen, wobei “Wert” den Wert angibt, den der Radiobutton bei Auswahl senden wird. Nun müssen Sie alles speichern und das Pop-Up schließen. Im übrig bleibenden Pop-Up müssen Sie nun als Layout das “Layout 3” auswählen und für “Höhe” “25” oder mehr Pixel angeben.
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
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:
Die Konfiguration, anhand der die Screenshots erstellt wurden, können Sie hier einsehen und für Ihre Tests verwenden: Beispielkonfiguration
Sie brauchen Architect- oder Expertrechte. Klicken Sie oben rechts auf den Reiter “Templates”, anschließend auf das grüne “PLUS-Icon”. Bennen Sie ihr neues Template in dem Feld “Template” und speichern Sie alles (Diskette). Anschließend gehen Sie auf den Reiter Elemente und klicken auf das grüne PLUS-Icon am rechten Bildschirmrand. Bennen Sie ihr Element. (Folgendes ist nicht der einzig richtige Weg sondern nur ein Vorschlag wie man ein blankes Template in passender Größe designen kann). Wählen Sie als Position 1 aus, falls Sie noch keine anderen Elemente eingefügt haben, geben Sie als Element-Typ “A-Element” und als “UIE” “uie-details Formular-Element” an. In dem Abschnitt “Positionierung” können Sie die gewünschte Größe sowie den Abstand zu anderen Elementen in Pixeln angeben. Anschließend drücken Sie auf Speichern (Diskette) und auf “Veröffentlichen”.
Auflistung aller Basistypen und Details dazu
Reguläre Ausdrücke
Masken
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");