Plugin installed incorrectly. Rename plugin directory 'swiftmail.backup' to 'swiftmail'.
software:cba:messages
Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
| Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste Überarbeitung Beide Seiten der Revision | ||
|
software:cba:messages [2014/11/24 15:50] max.neumaier |
software:cba:messages [2014/11/24 15:54] max.neumaier |
||
|---|---|---|---|
| Zeile 24: | Zeile 24: | ||
| * In verteilten Anwendungen sind Meldungen transparent, d.h. sie werden so zwischen Service-Aufruf und Service kommuniziert, das ein einheitliches Verhalten unabhängig vom Ort der Meldungs-Entstehung realisiert wird. | * In verteilten Anwendungen sind Meldungen transparent, d.h. sie werden so zwischen Service-Aufruf und Service kommuniziert, das ein einheitliches Verhalten unabhängig vom Ort der Meldungs-Entstehung realisiert wird. | ||
| + | ------ | ||
| ===Architektur=== | ===Architektur=== | ||
| Das Meldungs-Management ist in das CBA-Framework eingebettet. Es besteht aus | Das Meldungs-Management ist in das CBA-Framework eingebettet. Es besteht aus | ||
| Zeile 35: | Zeile 35: | ||
| {{ software:cba:message-handling.png?400 }} | {{ software:cba:message-handling.png?400 }} | ||
| + | ------- | ||
| + | |||
| + | ===Konfiguration=== | ||
| + | Die potenziellen Meldungen werden mit einer Meldungs-Nummer konfiguriert. In der Meldungs-Definition sind Platzhalter für die später einzufügenden Parameter definierbar. Die Meldungstexte sind mehrsprachfähig. | ||
| + | |||
| + | ------ | ||
| + | ===Funktionen=== | ||
| + | Das CBA-Framework stellt eine Menge von Funktionen zum Meldungs-Management zur Verfügung: | ||
| + | |||
| + | * **clearMessage** Löschen des Meldungs-Puffers | ||
| + | * **setMessage** Einfügen einer Meldung in den Meldungs-Puffer | ||
| + | * **getMessageText** Konvertierung einer Meldung in einen Text | ||
| + | * **getMessages** Rückgabe des Meldungs-Puffers | ||
| + | * **saveMessage** Speichern der Meldungen in der Logging-Datenbank | ||
| + | * **removeMessage** Löschen der zuletzt eingestellten Meldung aus dem Meldungs-Puffer | ||
| + | |||
| + | Der Funktion **setMessage** werden eine Meldungsnummer, ggf. Meldungs-Parameter (z.B. Informationen über das fehlerhafte Objekt u.ä.), die Klassifikation und ein Flag zur Verhaltens-Spezifikation übergeben. Weitere Parameter können die Meldung stärker spezifizieren und sind insbesondere für einen Fehleranalyse wichtig. Mit Hilfe der Funktion getMessageText wird anhand der Meldungsnummer eine sprachabhängige Zeichenkette ermittelt, die mit den angegebenen Meldungs-Parametern formatiert wird. {0} ist dabei der Platzhalter für den ersten Meldungs-Parameter, {1} für den zweiten etc. Die Meldungs-Parameter sind eine Zeichenkette, in der beliebig viele Parameter durch ‚|’ getrennt hintereinander angegeben werden können. Automatisch wird der Meldung der Zeitstempel, die Session-Zuordnung und (wenn vorhanden) die Transaktionsnummer angefügt, sodass Meldungen in einen Kontext eingeordnet werden können. | ||
| + | |||
| + | **Beispiel:** | ||
| + | * Meldungsnummer: 1234 | ||
| + | * Meldungstext: 'Die Datei '{0}' hat folgenden Fehler verursacht: {1} | ||
| + | * Aufruf: setMessage (1234, "bild.gif|Datei schreibgeschützt", "E", "e6", myTable, null, 4711); | ||
| + | * Meldung: Die Datei 'bild.gif' hat folgenden Fehler verursacht: Datei schreibgeschützt | ||
software/cba/messages.txt · Zuletzt geändert: 2021/07/01 09:52 (Externe Bearbeitung)
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: 2013 T!M Solutions GmbH
