Eine gute Benennung der Elemente der Facility-Bibliothek ist unabdingbar für eine problemlose Anwendung in QBRX. Nicht nur Administratoren, sondern auch alle anderen Nutzer müssen damit problemlos arbeiten können.
Um das zu gewährleisten, sollte sich bei der Namensfindung an die unten stehenden Regeln gehalten werden.
Ein Name ist immer die bestmögliche Beschreibung!
Am Namen eines Elements ist sofort erkennbar, worum es sich handelt. Jeder weiß, was an dieser Stelle dargestellt wird.
Beispiel:
Eindeutige und unverwechselbare Namen wählen!
Durch eine gute Namensgebung ist ein Element unverwechselbar und eindeutig von anderen unterscheidbar. Werden mehrere, sehr ähnliche Meanings an einem Facility-Typen benötigt, dann sollten diese, trotz ihrer Ähnlichkeit, so benannt werden, dass man sie bei der Auswertung voneinander unterscheiden kann. Das erleichtert nicht nur die Zuordnung von Datenquellen beim Erstellen von Facilities, sondern auch die Auswertung der Daten.
Beispiel: Drei Thermometer einer Verkaufsfläche sollten demnach nicht "Temperatur 1, 2 und 3" heißen, sondern eher "Temperatur Eingangsbereich, vordere Verkaufsfläche und hintere Verkaufsfläche".
| Regel | DOs | DON'Ts |
| Eindeutige Bezeichnung, die so wenig Interpretationsspielraum wie möglich zulässt | Temperatur Eingangsbereich Temperatur Verkaufsfläche vorne Temperatur Verkaufsfläche hinten | Temperatur 1 Temperatur 2 Temperatur 3 |
| Einfache Bezeichnungen | Analysis | Scrutiny |
| Keine Abkürzungen | Nice to have | NTH |
| Konsistente Namensgebung | ||
| Kurz fassen |
So allgemein wie möglich und so spezifisch wie nötig
Eine universell gültige Benennung sorgt dafür, dass Elemente für so viele Anwendungsbeispiele wie möglich benutzt werden können. Gleichzeitig sollte alles natürlich so spezifisch wie möglich benannt werden, um Verwechslungen auszuschließen und eine eindeutige Zuordnung möglich zu machen (wie im vorherigen Punkt beschrieben).
Beispiel: Der Facility-Typ "Raum" ist so allgemein gehalten, dass er für eine Vielzahl an Facilities verwendet werden kann, die keine besonderen Anforderungen haben, wie zum Beispiel Büros. Es gibt jedoch auch spezifischere Raum-Typen wie "Kühlraum", die für Facilities geeignet sind, die spezielle Eigenschaften für die Auswertung ihrer Daten benötigen. Wofür die Der Facility-Typ dann genau benutzt werden kann ist von der Konfiguration abhängig. Der Name "Raum" lässt eine breite Nutzung des Typen zu und trotzdem weiß jeder Nutzer, was damit gemeint ist.
Fasse dich kurz!
Ein schnell und einfach erfassbarer Name erleichtert die Arbeit mit QBRX und alle Auswertungsprozesse. Ist ein Name zu lange, wird er zudem möglicherweise abgekürzt oder sorgt für unschöne Formatierungen in QBRX.
Halte es einfach!
Egal ob Englisch, Deutsch oder eine andere Sprache - bei der Namensgebung sollten einfache, allgemein bekannte Worte verwendet werden. Nicht jeder Nutzer ist Muttersprachler (vor allem in Bezug auf die englische Benutzeroberfläche) und kennt alle möglichen, komplexen Ausdrücke.
Die Ausnahmen dafür sind natürlich Fachbegriffe, die nach einer eindeutigen, im jeweiligen Umfeld bekannten Formulierung verlangen.
| Do | Don't |
Bekannter, einfacher Begriff Analysis | Unbekannter, komplizierter Begriff Scrutiny |
Fachbegriff Benchmark | "Simple" Umschreibung Vergleichsmaßstab |
Beispiel: Der Bereich für Auswertungen heißt im Englischen "Analysis", da jeder etwas mit diesem Begriff anfangen kann. Wir hätten ihn auch "Scrutiny" nennen können, was ungefähr das gleiche bedeutet, aber kaum jemand könnte etwas damit anfangen.
Namen konsistent wählen!
Bei der Benennung sollte sich an vorher festgelegte Konventionen gehalten werden, um eine gewisse Konsistenz zu gewährleisten.
Es sollte vorher eine dementsprechende Einigung getroffen werden, die in einer Dokumentation festgehalten wird.
Beispiel: Es gibt die Meanings "Lastgang", "Lastgang Elektro" und "Lastgang Erdgas". Sollte ein weiteres Meaning dieser Art benötigt werden, wäre es ratsam, es ebenfalls "Lastgang ..." zu nennen und nicht mit einer anderen Terminologie zu arbeiten,. Selbst wenn ein anderes Wort im Prinzip (fast) das selbe ausdrückt, wie "Lastprofil", kann eine unterschiedliche Benennung zu Verwirrung führen.
Abkürzungen vermeiden!
Es gibt Abkürzungen, die allgemein bekannt sind und von jedem verstanden werden, wie zum Beispiel "z.B.". Es gibt allerdings auch Abkürzungen, die zwar praktisch erscheinen, aber aufgrund ihrer Unbekanntheit oder Doppeldeutigkeit mehr Probleme verursachen als lösen. Nicht jeder kennt die Abkürzung "NTH" für "nice to have". Stattdessen könnte sie auch als "Nothing" oder "No Therapy Helpful" gedeutet werden.
Im Zweifelsfall sollte immer davon ausgegangen werden, dass die Bedeutung einer Abkürzung nicht bekannt ist!