Kachel
Eine Kachel ist ein Steuerelement, das ähnlich wie ein Button eine Funktion bei Berührung ausführt. Anders als ein Button wird eine Kachel aber nicht in einer der Leisten auf einem Schritt angezeigt, sondern innherhalb einer Kachelansicht. Die grafische Oberfläche der Kachel lässt sich weiter individualisieren, indem man Hintergrundfarbe, Schriftart, Größe und vieles mehr vorgibt. Außerdem kann eine Kachel gleichzeitig einen Text und ein Bild anzeigen.
Eigenschaften
| Eigenschaft | Typ | Erklärung |
|---|---|---|
| Aktivator | Dropdown | Auswahl eines Aktivators, der bei Berührung ausgelöst wird. Wird ausgeblendet, falls es bereits einen Übergang von diesem Button zu einem Schritt gibt. |
| Darstellung | Dropdown | Auswahl einer Darstellung zur Beschreibung der Kacheloberfläche. |
Aktivator
Der Aktivator einer Kachel beschreibt, welche Aktion die App ausführen soll, wenn der Benutzer auf die Kachel tippt. Es gibt viele verschiedene Arten von Aktivatoren. Es kann z.B. eine Nachricht angezeigt, auf einen Schritt navigiert oder ein Datensatz gelöscht werden. Weitere Informationen zu Aktivatoren sind hier zu finden.
Tipp
Aktivatoren, die ein Skript oder eine fest definierte Funktion ausführen, müssen über das Feld Aktivator im Inspektor hinterlegt werden. Aktivatoren, die auf einen Schritt navigieren werden per Drag & Drop am Konnektor der Kachel erzeugt.
Darstellung
Die Benutzeroberfläche der Kachel wird durch ihre Darstellung beschrieben. Sie muss, ebenso wie ein Aktivator, über ein Dropdown-Feld ausgewählt werden. Eine Darstellung besteht aus einem Bild und einem Text, die übereinander oder nebeneinander angezeigt werden. Außerdem lässt sich eine Hintergrundfarbe für die Kachel definieren. Weitere, speziell für Kacheln vorgesehene, dynamische Eigenschaften sind nachfolgend aufgelistet.
| Eigenschaft | Typ | Erklärung |
|---|---|---|
| badgeActivator | Text | Name des Aktivators, der den Abzeichentext der Kachel vorgibt. |
| textInside | Ja / Nein | Gibt an, ob der Text innerhalb oder außerhalb der Kachel steht. |
| layout | Text | Information über die Ausrichtung von Bild und Text innerhalb der Kachel. Mögliche Werte: horizontal, vertical. |
| width | Ganzzahl | Breite der Kachel in Pixeln. |
| height | Ganzzahl | Höhe der Kachel in Pixeln. |
| size | Ganzzahl | Breite und Höhe der quadratischen Kachel in Pixeln. Wird ignoriert, falls width oder height definiert ist. |
| imageSize | Ganzzahl | Größe des als Icon verwendeten Bilds in Pixeln. |
| labelTextColorDark | Ganzzahl | Textfarbe der Kachel |
| bgColorDark | Ganzzahl | Hintergrundfarbe der Kachel bei aktiviertem Dark-Mode |
| labelTextColorDark | Ganzzahl | Textfarbe der Kachel bei aktiviertem Dark-Mode |
Abzeichen
Eine Kachel kann in pit - Mobile 4.0 ein Abzeichen in der rechten oberen Ecke anzeigen. Das Abzeichen besteht aus einem weißen Kurztext auf rotem Hintergrund und signalisiert dem Benutzer weitere kontextuelle Informationen zur Kachel.
An der zugehörigen Darstellung kann über die dynamische Eigenschaft badgeActivator vom Typ Text der Name eines Aktivators hinterlegt werden, der den Abzeichentext berechnet. Der hinterlegte Aktivator muss vom Typ Skript sein und einen Text zurückgeben. Um aktuelle Informationen zum Prozess abzufragen, wird eine Datenbankabfrage empfohlen.
Mit der aktivierten Eigenschaft badgeUpdatesAlways vom Typ Ja / Nein wird der Abzeichentext bei jedem Betreten und Verlassen des Schritts aktualisiert.
Nachfolgend ist ein Skript für ein Abzeichen zu sehen, das die Anzahl der Datensätze aller offenen bzw. in Bearbeitung befindlichen Ereignisse aus der Datenbank abfragt und als Text zurückgibt.
var count = 0;
// Alle 'Occurrence'-Datensätze finden, die den Status 'offen' oder 'in Bearbeitung' haben
var occurrences = Ti.App.dataController.executeQuery("SELECT count(id) as Count FROM STANDARD_Occurrence WHERE ref_Occurence_status='00000235:00000004' OR ref_Occurence_status='00000235:00000007'");
if (occurrences && occurrences.length > 0)
{
count = count + occurrences[0].Count;
}
// Die Anzahl der Elemente in einen Text umwandeln und zurückgeben.
return count ? '' + count : '-';