Open Thema mit Navigation

CM.Resource Pool - Einrichten des Ressourcenmodells

Einleitung

Dieses Kapitel beschreibt die komplette Einrichtung eines Ressourcenmodells. Sie lernen dabei Folgendes:

• Erstellen einer Ressourcengruppe
• Erstellen von zwei Ressourcentypen innerhalb dieser Ressourcengruppe
• Erstellen von Datenfeldern für die Ressourcen, d. h. von Ressourcenfeldgruppen für die Ressourcentypen
• Erstellen von Ressourcenfeldern innerhalb der Ressourcenfeldgruppen, d. h. Erstellen der Datenfelder
• Definieren von Templates für das Anzeigeformat der Ressourcennamen im Web Client

In unserem Beispiel sind Sie ein Administrator, der ein Ressourcenmodell für ein Unternehmen aufsetzt, das seine IT-Assets und seine Produkte im Ressourcenpool verwalten möchte.

Das vollständige Modell ist in der folgenden Abbildung dargestellt. Anhand der Definition der Drucker und Office-Software zeigen wir Ihnen das Grundprinzip. Danach sollten Sie in der Lage sein, alle verbleibenden Ressourcen selbst zu konfigurieren.

Abbildung 515: ConSol CM Admin Tool - Beispiel für Ressourcenmodell

Erstellen einer Ressourcengruppe mit dem ersten Ressourcentyp

Eine Ressourcengruppe stellt die Objekte auf der obersten Hierarchiestufe im Datenmodell des Ressourcenpools dar. In unserem Beispiel werden die Drucker in der Ressourcengruppe Printers und die Office-Softwarepakete in der Ressourcengruppe OfficeSoftware verwaltet. Die folgende Abbildung zeigt einige Ressourcengruppen und Ressourcentypen im Web Client. Diese soll Ihnen dabei helfen, den Überblick über die Konfiguration im Admin Tool und ihre Auswirkungen auf die GUI zu behalten. Denken Sie daran, dass die im Admin Tool verwendeten technischen Namen normalerweise nicht die (lokalisierten) Namen sind, die im Web Client angezeigt werden.

Abbildung 516: ConSol CM Web Client - Ressourcen im Ressourcenpool-Dashboard

Der erste Schritt bei einem neuen (leeren) Ressourcenmodell ist die Erstellung einer neuen Ressourcengruppe, die bereits einen Ressourcentyp enthält. Der Ressourcentyp enthält wiederum bereits eine Ressourcenfeldgruppe.

Abbildung 517: ConSol CM Admin Tool - Erstellen einer Ressourcengruppe

Füllen Sie zum Erstellen einer Ressourcengruppe folgende Felder aus. Die Lokalisierung der Namen für die Ressourcengruppe, den Ressourcentyp und die Ressourcenfeldgruppe erfolgt mithilfe der Felder im Navigationselement Datenmodelle und ist im Abschnitt Lokalisierung von Datenfeldern erklärt. Die Beschreibungen werden über den Button Lokalisieren lokalisiert, was im Abschnitt Lokalisierung von Objekten allgemein, Typ 1 erklärt ist.

• Ressourcengruppe, Name
  Der technische Name der Ressourcengruppe.
• Ressourcentyp, Name
  Der technische Name des ersten Ressourcentyps innerhalb der Ressourcengruppe.
  Später können weitere Ressourcentypen für die Ressourcengruppe hinzugefügt werden.
• Ressourcenfeldgruppe, Name
  Der Name der ersten Ressourcenfeldgruppe (ähnlich wie eine Benutzerdefinierte Feldgruppe für Ticketdaten) innerhalb des Ressourcentyps. Falls die Ressourcenfeldgruppe im Gruppenbereich der Ressourcenseite angezeigt wird (Annotation show-in-group-section = true), wird der lokalisierte Name als Titel des entsprechenden Tabs verwendet.
  Später können weitere Ressourcenfeldgruppen für den Ressourcentyp hinzugefügt werden.

Klicken Sie auf Speichern, um die Ressourcengruppe, den Typ und die erste Feldgruppe zu erstellen.

Wenn Sie die Ressourcengruppe definiert haben, können Sie weitere Daten für die erstellten Objekte hinzufügen.

Editieren der Ressourcengruppe

Abbildung 518: ConSol CM Admin Tool - Editieren einer Ressourcengruppe

Markieren Sie die Ressourcengruppe und klicken Sie auf den Button Bearbeiten, um einige Parameter der Ressourcengruppe zu editieren:

• Beschreibung
  Sie können direkt im Pop-up-Fenster eine Beschreibung eingeben, die danach als Standardbeschreibung dient. Alternativ können Sie über den Button Lokalisieren die lokalisierten Werte für die einzelnen Sprachen eingeben. Die Beschreibung der Ressourcengruppe wird nur zu Informationszwecken im Admin Tool angezeigt, sie ist im Web Client nicht zu sehen.
• Icon
  Wählen Sie eines der CM-Standardicons, indem Sie auf das Icon klicken, oder laden Sie über den Dateibrowser ein Icon Ihrer Wahl hoch. Das Icon der Ressourcengruppe wird im Web Client neben dem Namen der Ressourcengruppe angezeigt. Auf diese Weise können Sie zum Beispiel für die Drucker ein Drucker-Icon auswählen, für die PCs ein PC-Icon usw. Die zulässigen Formate sind: jpg, jpeg, png, gif. Wir empfehlen eine Bildgröße von 32 x 32 px, um eine gute Darstellung auf der Ressourcentypseite zu erreichen. In Tabellen und an anderen Stellen, an denen die Ressource auf der GUI angezeigt wird, wird das Icon automatisch (kleiner) skaliert.



Abbildung 519: ConSol CM Web Client - Angepasstes Icon für eine Ressourcengruppe

Klicken Sie auf Speichern, um Ihre Änderungen zu übernehmen.

Editieren des Ressourcentyps

Abbildung 520: ConSol CM Admin Tool - Editieren eines Ressourcentyps

Markieren Sie den Ressourcentyp und klicken Sie auf den Button Bearbeiten, um einige Parameter des Ressourcentyps zu editieren:

• Beschreibung
  Sie können direkt im Pop-up-Fenster eine Beschreibung eingeben, die danach als Standardbeschreibung dient. Alternativ können Sie über den Button Lokalisieren die lokalisierten Werte für die einzelnen Sprachen eingeben. Die Beschreibung des Ressourcentyps wird nur zu Informationszwecken im Admin Tool angezeigt, sie ist im Web Client nicht zu sehen.
• Modus (eine detaillierte Erklärung aller Modi finden Sie im Abschnitt Information über Ressourcenmodi)
  
  • Intern
    Die Ressourcendaten werden komplett in ConSol CM verwaltet. Details zu diesem Modus finden Sie im Abschnitt Interne Ressourcen.
  • Auf Anforderung
    Die Ressourcendaten werden auf Anforderung aus einem externen Backend-System abgerufen (verfügbar in ConSol CM 6.10.3.0 und höher). Details zu diesem Modus finden Sie im Ressourcen auf Anforderung.
  • Cached
    Die Ressourcendaten stammen aus einem externen Backend-System und werden in ConSol CM zwischengespeichert. Eine Aktualisierung eines Elements kann manuell angestoßen werden (verfügbar in ConSol CM 6.10.3.0 und höher). Details zu diesem Modus finden Sie im Abschnitt Ressourcen im Cache.
  • Importiert
    Die Ressourcendaten stammen aus einem externen Backend-System und werden in ConSol CM gespeichert. Für eine Aktualisierung ist ein neuer Massendatenimport erforderlich (verfügbar in ConSol CM 6.10.3.0 und höher). Details zu diesem Modus finden Sie im Abschnitt Importierte Ressourcen.
• Icon
  Wählen Sie eines der CM-Standardicons, indem Sie auf das Icon klicken, oder laden Sie über den Dateibrowser ein Icon Ihrer Wahl hoch. Das Icon des Ressourcentyps wird im Web Client neben dem Namen des Ressourcentyps angezeigt, z. B. auf der Ressourcentypseite. Auf diese Weise können Sie zum Beispiel für die Drucker ein Drucker-Icon auswählen, für die PCs ein PC-Icon usw. Die zulässigen Formate sind: jpg, png, gif. Wir empfehlen eine Bildgröße von 32 x 32 px, um eine gute Darstellung auf der Ressourcenseite zu erreichen. In Tabellen und an anderen Stellen, an denen die Ressource auf der GUI angezeigt wird, wird das Icon automatisch (kleiner) skaliert.
• Templates
  Hier können Sie die Templates für das Anzeigeformat der Ressourcendaten im Web Client definieren (analog zu Templates für Kundendaten). Dies wird im Abschnitt CM.Resource Pool - Templates für Ressourcendaten näher erklärt.
• Automatische Aktionen
  Hier können Sie dem Ressourcentyp automatische Ressourcenaktionen zuweisen. Die Ressourcenaktionen müssen zuerst im Bereich Ressourcenaktionen des Admin Tools definiert werden. Eine detaillierte Erklärung dazu finden Sie im Abschnitt CM.Resource Pool - Ressourcenaktionen.
• Manuelle Aktionen
  Hier können Sie dem Ressourcentyp manuelle Ressourcenaktionen zuweisen. Die Ressourcenaktionen müssen zuerst im Bereich Ressourcenaktionen des Admin Tools definiert werden. Eine detaillierte Erklärung dazu finden Sie im Abschnitt CM.Resource Pool - Ressourcenaktionen.
• Suche-Aktionen
  Hier können Sie dem Ressourcentyp Suche-Aktionen zuweisen. Die Suche-Aktionen müssen zuerst im Bereich Skripte und Templates des Admin Tools definiert werden. Eine detaillierte Erklärung dazu finden Sie im Abschnitt Action Framework - Suche-Aktionen.

Die Ressourcenrelationen werden ebenfalls für den Ressourcentyp definiert. Dies wird im Abschnitt CM.Resource Pool - Ressourcenrelationen näher erklärt.

Information über Ressourcenmodi

Der Modus eines Ressourcentypen definiert, ob die Ressourcendaten im ConSol CM-System gespeichert sind und, sofern erforderlich, wie die Übertragung von einem externen System an ConSol CM verwaltet wird. Wenn der Modus festgelegt wurde und es im System Ressourcen des entsprechenden Typs gibt, kann der Modus nicht mehr geändert werden.

In ConSol CM wird zwischen internen Ressourcen und externen Ressourcen unterschieden. Die letzteren umfassen Ressourcen auf Anforderung, Ressourcen im Cache und Importierte Ressourcen, d. h. alle Ressourcen, die nicht komplett in ConSol CM gespeichert und verwaltet werden.

Im Web Client können nur interne Ressourcen erstellt werden. Externe Ressourcen können mit dem Web Client weder erstellt, noch (permanent) geändert, noch gelöscht werden. Für alle externen Ressourcen muss das komplette Datenmodell im Admin Tool definiert werden, bevor die erste Datenübertragung ausgeführt werden kann. Die Verwendung von Ressourcen auf Anforderung und Ressourcen im Cache basiert auf der Implementierung eines speziellen Interface. Daher können diese Ressourcen nur mit einer kundenspezifischen .ear-Datei von ConSol CM verwendet werden. Das entsprechende Entwicklungsprojekt muss gebaut und installiert werden, bevor die erste Datenübertragung stattfindet. Die folgenden Abschnitte enthalten eine detaillierte Übersicht über alle vier Ressourcentypen.

Abbildung 521: Ressourcenmodi

Abbildung 522: ConSol CM Admin Tool - Konfiguration des Ressourcentypmodus

Interne Ressourcen

Dieser Modus ist in allen ConSol CM-Versionen mit einem Ressourcenpool verfügbar, d. h. ab CM-Version 6.10.1.

Die Ressourcendaten werden komplett von ConSol CM verwaltet. Bearbeiter mit den entsprechenden Zugangsberechtigungen können im Web Client Ressourcen erstellen, ändern und löschen.

Ressourcen auf Anforderung

Dieser Modus ist in ConSol CM-Versionen 6.10.3.0 und höher verfügbar. In den früheren Versionen ist dieser Modus nicht verfügbar.

Die Ressourcendaten werden auf Anforderung aus einem externen Backend-System abgerufen. Der Modus auf Anforderung benötigt eine kundenspezifische Implementierung des Java Interface ResourceExternalSource.

Für eine Ressource auf Anforderung sind in ConSol CM keine Daten gespeichert mit Ausnahme einer externen ID. Mit dieser ID werden die Daten auf Anforderung aus dem externen System abgerufen.

Im Web Client:

• Die Detailsuche ist nicht verfügbar.
• Für die Suche nach einer Ressource auf Anforderung kann nur die externe ID verwendet werden.
• Es gibt keine Ressourcenseite.
• Es gibt keine Ressourcentypseite.
• Die Ressource ist nur im Bereich für verknüpfte Ressourcen verfügbar in
  • Tickets
  • Kunden
  • anderen Ressourcen
• Die Ressourcendaten können nicht editiert werden.

Ressourcen im Cache

Dieser Modus ist in ConSol CM-Versionen 6.10.3.0 und höher verfügbar. Er kann in früheren Versionen nicht ausgewählt werden.

Die Ressourcendaten stammen aus einem externen Backend-System. Die Daten werden nach der ersten Anforderung an ConSol CM übertragen und dann in der ConSol CM-Datenbank zwischengespeichert (gecached). Die erste Anforderung an das externe System wird ausgeführt, sobald eine Ressource mit einem anderen Objekt verknüpft wird (einem Ticket, einem Kunden oder einer anderen Ressource), d. h. wenn eine Relation hergestellt wird. Der Modus Cached benötigt eine kundenspezifische Implementierung des Java Interface ResourceExternalSource.

Im Web Client:

• Die Detailsuche ist nur für Ressourcen verfügbar, die mindestens einmal angefordert wurden und deren kompletter Datensatz daher in ConSol CM vorhanden ist.
• Für in ConSol CM vorhandene Ressourcen (d. h. Ressourcen im Cache) gilt:
  • Es ist eine Ressourcenseite verfügbar.
  • Es ist eine Ressourcentypseite verfügbar.
  • Eine Aktualisierung der Ressourcendaten kann manuell auf der Ressourcenseite angestoßen werden.
• Um in ConSol CM nach einer Ressource im Cache zu suchen, die noch nicht angefordert wurde, kann nur die externe ID verwendet werden.
• Es gibt keine Ressourcenseiten für noch nicht zwischengespeicherte Ressourcen.
• Die Ressource ist nur im Bereich für verknüpfte Ressourcen von Tickets, Kunden und anderen Ressourcen verfügbar. Die Ressourcenfelder werden auch nur im Bereich für verknüpfte Ressourcen angezeigt.
• Die Ressourcendaten können nicht editiert werden.

Importierte Ressourcen

Dieser Modus ist in ConSol CM-Versionen 6.10.3.0 und höher verfügbar. Er kann in früheren Versionen nicht ausgewählt werden.

Die Ressourcendaten stammen aus einem externen Backend-System und werden in der ConSol CM-Datenbank gespeichert. Nachdem die Daten nach ConSol CM importiert wurden, werden sie fast genauso wie interne Daten behandelt. Für den Import nach ConSol CM wird normalerweise ein ETL-Job (Extract - Transform - Load) eingesetzt, der einmal oder nach einem bestimmten Zeitplan ausgeführt wird.

Im Web Client:

• Die Detailsuche ist für importierte Ressourcen komplett verfügbar.
• Es ist eine Ressourcenseite verfügbar.
• Es ist eine Ressourcentypseite verfügbar.
• Importierte Ressourcen können nicht im Web Client erstellt werden (nur über einen Import).
• Die Ressourcendaten können editiert werden, aber ein neuer Import kann die Änderungen überschreiben.

Editieren der Ressourcenfeldgruppe

Eine Ressourcenfeldgruppe ist eine Sammlung von Ressourcenfeldern, den Datenfeldern für Ressourcendaten (analog zur Benutzerdefinierten Feldgruppe, die eine Sammlung von Benutzerdefinierten Feldern für Ticketdaten darstellt). Ressourcenfelder können nie als alleinstehende Objekte verwaltet werden; sie werden immer als Ressourcenfeldgruppe verwaltet (z. B. eingeblendet oder ausgeblendet).

Eine Ressourcenfeldgruppe hat folgende gruppenspezifische Parameter. Markieren Sie die Ressourcenfeldgruppe und klicken Sie auf Bearbeiten, um diese Werte zu editieren (siehe nächster Abschnitt).

Editieren der spezifischen Parameter einer Ressourcenfeldgruppe

Abbildung 523: ConSol CM Admin Tool - Editieren der spezifischen Parameter einer Ressourcenfeldgruppe

Hier können Sie folgende Felder editieren:

• Name
  Der technische Name der Ressourcenfeldgruppe. Dieser sollte nur geändert werden, wenn dies unumgänglich ist, da dies Nebeneffekte auf alle Skripte haben kann (Workflow und Admin Tool), die den Namen der Ressourcengruppe verwenden. Um den auf der GUI für die Ressourcengruppe angezeigten Begriff zu ändern, setzen Sie den im Abschnitt Lokalisierung von Datenfeldern erklärten Mechanismus ein.
• Skripte für abhängige sortierte Listen
  Hier können Sie einer Ressourcenfeldgruppe eine abhängige sortierte Liste zuweisen. Die abhängige sortierte Liste muss zuerst als Admin-Tool-Skript definiert werden, siehe Abschnitt Skripte des Typs Abhängige sortierte Liste.

Annotieren von Ressourcenfeldgruppen

Eine Ressourcenfeldgruppe kann Annotationen haben. Wählen Sie die Ressourcenfeldgruppe und klicken Sie auf den Button Annotieren, um Annotationen zu setzen oder zu löschen. Es gibt die gleichen Annotationen wie für Benutzerdefinierte Feldgruppen. Alle Annotationen sind in Annotationen aufgeführt und beschrieben.

Abbildung 524: ConSol CM Admin Tool - Annotationen von Ressourcenfeldgruppen

Erstellen und Editieren von Ressourcenfeldern

Ressourcenfelder sind Container für alle Daten der Ressourcen (analog zu den Benutzerdefinierten Feldern für die Ticketdaten). Ressourcenfelder gehören immer zu einer Ressourcenfeldgruppe. Um Ressourcenfelder zu einer Ressourcenfeldgruppe hinzuzufügen oder zu editieren, wählen Sie die Gruppe im Ressourcendatenmodell und geben Sie alle erforderlichen Daten auf der rechten Seite im Admin Tool ein.

Abbildung 525: ConSol CM Admin Tool - Verwalten von Ressourcenfeldern

Erstellen eines neuen Ressourcenfeldes

Um ein neues Ressourcenfeld zu erstellen, klicken Sie auf den Button Hinzufügen und geben Sie im Pop-up-Fenster alle erforderlichen Daten ein.

Abbildung 526: ConSol CM Admin Tool - Erstellen eines Ressourcenfeldes

Geben Sie die folgenden Daten ein:

• Name
  Der technische Name des Ressourcenfelds. Dieser wird in Skripten und Templates verwendet. Geben Sie den lokalisierten Wert über den Button Lokalisieren ein.
• Datentyp
  Der Datentyp des Ressourcenfelds. Wie bei den Benutzerdefinierten Feldern oder Datenobjektgruppenfeldern können Sie einen Datentyp aus der Drop-down-Liste auswählen. Der folgende Abschnitt enthält detaillierte Informationen über die verfügbaren Datentypen.

Arten von Datenfeldern

Die folgenden Datentypen sind für Benutzerdefinierte Felder, Datenobjektgruppenfelder und Ressourcenfelder verfügbar.

• boolean (Ja/Nein)
  Werte: true/false. Je nach Einstellung in der Annotation boolean-type wird der Wert als Checkbox, Radio-Button oder Drop-down-Liste angezeigt.

  Wenn Sie in CM-Workflows oder im Admin Tool mit Skripten arbeiten, sollten Sie wissen, dass das Verhalten von Boolean-Feldern, die als Checkboxen dargestellt werden, d. h. mit der Annotation boolean-type = checkbox (Standardwert) versehen sind, anders ist als in früheren CM-Versionen!

  • In CM-Versionen vor 6.9.4.0:
    Wenn ein Boolean-Feld noch nicht angefasst wurde, ist der Wert false. Wenn es aktiviert wird, ist der Wert true, und wenn es danach wieder deaktiviert wird, ist der Wert wieder false.
  • In Version 6.9.4.0 und höher:
    Wenn ein Boolean-Feld noch nicht angefasst wurde, ist der Wert NULL. Wenn es aktiviert wird, ist der Wert true, und wenn es danach wieder deaktiviert wird, ist der Wert false.

  Felder, die in der Datenbank bereits mit Werten gefüllt sind, werden während des Updates von einer Version vor 6.9.4.0 auf Version 6.9.4.0 und höher nicht verändert.

  Boolean-Felder, die als Radio-Button (Annotation boolean-type = radio) oder Drop-down-Liste (Annotation boolean-type = select) dargestellt sind, hatten schon immer das Verhalten, das für Version 6.9.4.0 oder höher beschrieben ist, d. h. sie haben den Wert NULL, wenn sie noch nicht angefasst wurden.

• date (Datum)
  Format und Genauigkeit können über Annotationen festgelegt werden.
• enum (Sortierte Liste)
  Für Sortierte Listen. Die Bearbeiter können im Web Client zwischen einem der Listenwerte wählen. Die Sortierten Listen und ihre Werte müssen zuvor in der Verwaltung von Sortierten Listenerstellt worden sein. Wählen Sie den gewünschten Listentyp und die Listengruppe in den Feldern darunter.
• list (Liste)
  Ein Feld dieses Datentyps ist der erste Schritt zur Erstellung einer Liste (eine Spalte) oder einer Tabelle (mehrere Spalten) von Eingabefeldern im Web Client.
  
  • Für eine Tabelle wird im nächsten Schritt ein anderes Feld des Typs struct erstellt (siehe unten), das später die Eingaben der einzelnen Listenfelder enthält (die die Spalten der Tabelle sind). Wenn Sie also eine Tabelle erstellen möchten, müssen Sie zuerst ein Feld des Typs struct erzeugen (siehe unten), bevor Sie die Felder für die Tabellenspalten hinzufügen können.
  • Für eine einfache Liste ist der nächste Schritt die Erstellung der Felder, die zu der Liste gehören. In diesem Fall ist kein struct erforderlich.
  Für alle Felder, die zu einer Liste oder Tabelle gehören, müssen Sie die Abhängigkeiten im Feld Gehört zu angeben (siehe unten). Ein Tabellenfeld (ein normales Datenfeld), gehört zum Beispiel immer zu einem struct und ein struct gehört immer zu einer list.
• struct (Struktur)
  Mit einem Datenfeld dieses Typs wird eine Datenstruktur (Zeile einer Tabelle) definiert, die ein oder mehrere Felder umfasst. Das ist der zweite Schritt zur Erstellung einer Tabelle, nachdem Sie zuerst ein Feld des Typs list erstellt haben. Im nächsten Schritt fügen Sie die Felder für die Spalten der Tabelle hinzu. Die Abhängigkeiten müssen für jedes Datenfeld im Feld Gehört zu (siehe unten) gesetzt werden, d. h. ein struct gehört immer zu einer list.

  

  Abbildung 527: Schema: List of Structs

  Technisch gesehen ist eine Liste ein Array, der in jedem Feld eine Map (= Paare von Schlüssel:Wert) enthält.

  

  Abbildung 528: List of structs, technisches Prinzip

• number (Zahl)
  Für Ganzzahlen (Integer).
• fixed point number (Festkommazahl)
  Für Festkommazahlen, z. B. Währungen. Sie müssen die Gesamtanzahl der Ziffern (Genauigkeit) und die Anzahl der Ziffern nach dem Komma (Skalierung) in den entsprechenden Feldern eingeben.
• string (Text)
  Für bis zu 4000 alphanumerische Zeichen.

  Beschränkung bei der Verwendung einer Oracle-Datenbank: Es können höchstens 4000 Bytes in UTF-Codierung gespeichert werden. Ab Oracle12c.

• long string (Text)
  Für große Objekte

  Beim Datentyp long string (Text) hängt die Grenze von dem für ConSol CM verwendeten Datenbanksystem ab: MS SQL Server: 2 GByte; MySQL: 4 GByte; Oracle: 16 - 64 GByte (je nach Page-Größe des Tablespace).

• short string (Text)
  Für bis zu 255 alphanumerische Zeichen.

  Bei Feldern des Datentyps string (Text) können Sie die Felddefinition mithilfe von Annotationen präzisieren. Ein Feld des Datentyps string kann zum Beispiel so definiert werden, dass es eine URL enthält und automatisch als Hyperlink angezeigt wird. Lesen Sie dazu den folgenden Abschnitt.

• contact data reference (Referenz auf ein Kontaktdatenfeld)
  Besonderer Datentyp, der intern als Referenz auf die mit dem Ticket verknüpften Kontakte verwendet wird. In FlexCDM (d. h. ab CM-Version 6.9.0), wird dieser Datentyp nicht mehr angezeigt, sondern nur noch intern im CM-System verwendet.
• MLA field (Baum sortierter Listen)
  Dieser Datentyp wird für Felder verwendet, die hierarchische Listen mit einer Baumstruktur enthalten, das sogenannte MLA (Multi Level Attributes). Der Name dieses Feldes ist der Name des neuen MLA, das in der MLA-Verwaltung angelegt werden muss. Die Gruppe des Feldes muss angegeben werden, nachdem das MLA erstellt wurde.

Der Datentyp, den Sie beim Erstellen eines Datenfeldes verwenden, kann danach nicht mehr verändert werden!

Details über String-Felder: Verwenden von Annotationen zum Anpassen von Strings

String-Felder werden häufig für Kunden-, Ticket- und Ressourcendaten verwendet und in Strings kann unterschiedlicher Inhalt gespeichert werden, zum Beispiel ein Textfeld mit einem Kommentar, ein einfaches Eingabefeld mit nur 20 Zeichen, eine URL oder ein Passwort. Das Anpassen von String-Feldern erfolgt mithilfe von speziellen Annotationen, die auf der Seite Annotationen des Anhangs aufgeführt sind. Da die Arbeit mit diesen Annotationen zu den alltäglichen Aufgaben eines CM-Administrators gehört, sind die wichtigsten und am häufigsten verwendeten Annotationen zusätzlich an dieser Stelle erklärt.

Wie kann ich ...

... statt einer einzelnen Zeile ein Textfeld einfügen?

Wert für Annotation text-type: textarea

Die Größe des Textfeldes kann angepasst werden. Es wird je nach Webbrowser als Standardtextfeld angezeigt. Verwenden Sie die Annotation field-size, wenn das Textfeld eine bestimmte Größe haben soll.

... die Eingabe des Feldes für Passwörter ausblenden?

Wert für Annotation text-type: password

Es werden nur Punkte angezeigt. Diese Annotation legt nicht fest, dass das Feld ein Passwort enthält! Es definiert nur den Anzeigemodus! Verwenden Sie die Annotation password, um ein String-Feld zu definieren, das das CM.Track-Passwort enthält.

... einen Hyperlink anzeigen, den Namen statt dem Link anzeigen?

Wert für Annotation text-type: url

Die Eingabe wird im Ansichtsmodus als Hyperlink angezeigt. Der String muss einem bestimmten URL-Muster entsprechen:

• "^((?:mailto\:|(?:(?:ht|f)tps?)\://)1\S+)(?: (?:\| )?(.*))?$"

Der erste Teil des Strings ist der Link (URL) und der zweite Teil ist der Name, der angezeigt werden soll.

Beispiel: "http://consol.de ConSol"

... einen Dateilink anzeigen?

Wert für Annotation text-type: file-url

Die Eingabe wird als Link auf eine Datei im Dateisystem angezeigt. Der Webbrowser muss solche Links zulassen/unterstützen!

Beispiel: Aktivieren von file://-URLs in einem Firefox-Browser

Fügen Sie die folgenden Zeilen entweder zur Konfigurationsdatei prefs.js oder zu user.js im Benutzerprofil hinzu. Auf einem Windows-System befindet sich diese normalerweise in einem Ordner wie C:\Benutzer\<BENUTZERNAME>\AppData\Roaming\Mozilla\Firefox\Profiles\uvubg4fj.default

• user_pref("capability.policy.localfilelinks.checkloaduri.enabled", "allAccess");
• user_pref("capability.policy.localfilelinks.sites", "http://cm-server.domain.com:8080");
• user_pref("capability.policy.policynames", "localfilelinks");

Alternativ kann ein Add-on des Firefox-Browsers wie Local Filesystem Links installiert werden, um einfacher auf die referenzierten Dateien und Ordner zugreifen zu können.

Dieser Link wird auch als Tooltip angezeigt.

Die URL ist korrekt formatiert, wenn folgende Bedingungen erfüllt sind:

• Sie beginnt mit file: gefolgt von normalen Schrägstrichen:
• drei Schrägstriche "///" für Dateien, die sich auf demselben Computer befinden wie der Browser (alternativ "//localhost/") oder
• zwei Schrägstriche gefolgt vom Servernamen und einem weiteren Schrägstrich für Dateien auf Dateiservern, die vom Rechner, auf dem der Webbrowser läuft, erreichbar sind.
• Danach folgt der vollständige Dateipfad, der mit dem Dateinamen endet.
• Auf Microsoft Windows-Systemen wird der Pfad ebenfalls mit normalen Schrägstrichen anstelle von umgekehrten Schrägstrichen geschrieben.
• Der Laufwerksbuchstabe eines lokalen Pfads auf Microsoft Windows-Systemen wird wie üblich verwendet, zum Beispiel C:.
• Pfade mit Leerzeichen und Sonderzeichen wie "{, }, ^, #, ?" müssen auf Microsoft Windows-Systemen mit Prozentzeichen kodiert werden (z. B. mit "%20" für ein Leerzeichen).

Beispiel-URLs:

• file://file-server/path/to/my/file.ext
• file:///linux/local/file.pdf
• file:///C:/Users/myuser/localfile.doc

... ein Label definieren?

Wert für Annotation text-type: label

Dies ist ein schreibgeschütztes Feld, das grau angezeigt wird. Verwenden Sie die Annotation label-group, um das Label und die dazugehörigen Eingabefelder zu verknüpfen. Berücksichtigen Sie die Annotationen für Label (show-label-in-edit, show-label-in-view), bevor Sie spezielle Label-Felder implementieren!

... ein Feld für das CM.Track-Login definieren?

Wert für Annotation username: true

Wird für die Authentifizierung beim CM.Track-Server verwendet. Nur für Datenobjektgruppenfelder in einem Kontaktobjekt.

... ein Feld für das CM.Track-Passwort definieren?

Wert für Annotation password: true

Wird (im Datenbankmodus) für die Authentifizierung beim CM.Track-Server verwendet. Nur für Datenobjektgruppenfelder in einem Kontaktobjekt.

... ein Feld für gültige E-Mail-Adressen definieren?

Wert für Annotation email: true

Das Feld darf nur gültige E-Mail-Adressen enthalten. Die Eingabe wird gemäß des Standardformats für E-Mail-Adressen validiert <name>@<domain>.

... eine skriptbasierte Autocomplete-Liste definieren? 

Wert für die Annotation text-type = autocomplete

Optional: Wert für die Annotation autocomplete-script = <Name des entsprechenden Skripts>

Eine skriptbasierte Autocomplete-Liste wird verwendet, um ein Drop-down-Menü bereitzustellen, das anhand der Eingabe, die der Bearbeiter bereits vorgenommen hat, dynamisch gefüllt wird. Wenn der Benutzer zum Beispiel "Mei" eingibt, werden die möglichen Werte "Meier", "Meister" und "Meinert" als Liste angezeigt und der Bearbeiter kann den für das Feld erforderliche Wert auswählen. Sie kennen dieses Verhalten von anderen Autocomplete-Feldern, z. B. der Suche nach Bearbeitern für ein Ticket oder die Suche nach Kunden bei der Ticketerstellung. In diesen Fällen erzeugt CM die Liste allerdings automatisch und das Verhalten kann nicht beeinflusst oder angepasst werden. Im Gegensatz dazu können skriptbasierte Autocomplete-Listen vom CM-Administrator implementiert werden. Die Werte basieren auf einem Ergebnissatz, der dynamisch erstellt wird. Der Ergebnissatu kann Strings, Bearbeiter, Kunden (Units) und Ressourcen enthalten.

Eine detaillierte Beschreibung von skriptbasierten Autocomplete-Listen finden Sie im Abschnitt Skriptbasierte Autocomplete-Listen.

Annotieren von Ressourcenfeldern

Die Eigenschaften eines Ressourcenfeldes werden mithilfe von Annotationen definiert, z. B. die Sichtbarkeit, die Position im Web Client, ob das Feld indiziert werden soll, ob es reportbar sein soll usw. Sie kennen dieses Prinzip wahrscheinlich von der Arbeit mit Annotationen von Benutzerdefinierten Feldern.

Abbildung 529: ConSol CM Admin Tool - Definieren von Ressourcenfeld-Annotationen

Es sind die gleichen Annotationen verfügbar wie für Benutzerdefinierte Felder. Sie sind detailliert in Annotationen erklärt.

Die Annotation position bestimmt die Position des Feldes an folgenden Stellen:

• Das Formular zur Erstellung einer neuen Ressource, siehe Abschnitt Kurze Einführung in CM.Resource Pool-Funktionen im Web Client, Formular zum Erstellen von Ressourcen.
• Die Ressourcenseite, die im Abschnitt Kurze Einführung in CM.Resource Pool-Funktionen im Web Client, Ressourcendetailseite erklärt ist.

Wie beim Ticketlayout können Sie auch Ressourcenfelder nach dem Matrix-Prinzip auf der GUI anordnen und ihre Position folgendermaßen festlegen:

Abbildung 530: Beispielmatrix für die Annotation position

Erstellen von weiteren Ressourcentypen innerhalb einer Ressourcengruppe

Um innerhalb einer Ressourcengruppe einen neuen Ressourcentypen hinzuzufügen, markieren Sie einen anderen Ressourcentypen der gewünschten Ressourcengruppe in der Liste und klicken Sie auf den Button Hinzufügen. Geben Sie danach alle erforderlichen Daten so ein, wie im Abschnitt Editieren des Ressourcentyps beschrieben.

Erstellen von Ressourcenfeldgruppen und Ressourcenfeldern

Um eine neue Ressourcenfeldgruppe innerhalb eines Ressourcentyps zu erstellen, wählen Sie eine andere Ressourcenfeldgruppe des gewünschten Ressourcentyps in der Liste aus und klicken Sie auf den Button Hinzufügen. Geben Sie danach alle erforderlichen Daten so ein, wie im Abschnitt Editieren der Ressourcenfeldgruppe beschrieben.

Erstellen weiterer Ressourcengruppen

Um eine neue Ressourcengruppe zu erstellen (in unserem Beispiel Office_Software), wählen Sie eine andere Ressourcengruppe in der Liste aus und klicken Sie auf den Button Hinzufügen.

Geben Sie dann alle erforderlichen Daten so ein, wie im Abschnitt Editieren der Ressourcengruppe beschrieben.

Abbildung 531: ConSol CM Admin Tool - Hinzufügen einer neuen Ressourcengruppe

Um eine neue Ressourcengruppe mit Ressourcentypen und Ressourcenfeldern zu füllen, gehen Sie so vor, wie in den vorherigen Abschnitten beschrieben.

Beispiel für ein komplettes Ressourcenmodell

In unserem Beispiel haben wir das folgende Ressourcenmodell erstellt. Es wird in diesem Handbuch weiter verwendet.

Abbildung 532: ConSol CM Admin Tool - Beispiel für Ressourcenmodell

Abbildung 533: ConSol CM Web Client - Beispiel für ein Ressourcenmodell (im Ressourcenpool-Dashboard)

Definieren von Ressourcenrelationen

Dies wird im Abschnitt CM.Resource Pool - Ressourcenrelationen näher erklärt.

Definieren von Ressourcenaktionen

Dies wird im Abschnitt CM.Resource Pool - Ressourcenaktionen näher erklärt.

Zuweisen von Zugangsberechtigungen für Ressourcen zu Bearbeitern mittels Rollen

Dies wird im Abschnitt CM.Resource Pool - Zuweisen von Berechtigungen für Ressourcen näher erklärt.