Open Thema mit Navigation

CM.Resource Pool - Ressourcenaktionen

Einleitung

Ressourcenaktionen sind Teil des ConSol CM Action Frameworks. Ressourcenaktionen sind Aktionen, die für eine Ressource ausgeführt werden, d. h. für ein im Ressourcenpool gespeichertes Objekt. Die Aktionen können automatisch vom System durchgeführt werden oder manuell von einem Bearbeiter mit den entsprechenden Berechtigungen angestoßen werden. Mögliche Anwendungsfälle für Ressourcenaktionen sind beispielsweise:

• Erstellen eines Wartungstickets für einen Drucker
• Finden aller Firmen, die eine bestimmte SLA nutzen

Sie können folgende Typen von Ressourcenaktionen verwenden:

• Automatische Aktionen, die vom System nach einer der folgenden Ressourcenoperationen durchgeführt werden:
  • Erzeugen
  • Aktualisieren
  • Löschen
  • Suche
• Manuelle Aktionen, die von einem Bearbeiter mithilfe der Aktivitätslinks auf der Ressourcenseite des Web Clients durchgeführt werden (ähnlich wie Workflow-Aktivitäten für Tickets). Manuelle Aktionen werden nur für die angezeigte Ressource ausgeführt.

Abbildung 536: ConSol CM Web Client - Ressourcenaktion (auf der Ressourcenseite)

Ressourcenaktionen werden als Groovy-Skripte definiert, die im Abschnitt Skripte und Templates des Admin Tools gespeichert werden.

Die Ausführung von Ressourcenaktionen kann mit Bedingungsskripten gesteuert werden, d. h. Sie können ein Bedingungsskript implementieren, das vor der Ressourcenaktion selber ausgeführt wird. Das Ausführungsscript wird nur ausgeführt, wenn das Bedingungsskript true zurückgibt.

Es gibt also zwei Arten von Skripten, mit denen Sie im Zusammenhang mit ConSol CM-Ressourcenaktionen arbeiten:

• Ressourcen-Aktionsskripte
  Definiert die Aktion, die ausgeführt werden soll.
• Ressourcen-Bedingungsskripte
  Definiert eine oder mehrere Bedingungen für die Ausführung des Ausführungsskripts. Muss true oder false zurückgeben. Wenn false zurückgegeben wird, wird das Ausführungsskript nicht ausgeführt. Wenn es sich um eine manuelle Aktion handelt, wird diese nicht als Aktivität im Web Client angezeigt.

Führen Sie zur Implementierung einer Ressourcenaktion folgende drei Schritte durch:

1. Erstellen Sie ein Skript für die Ressourcenaktion (entweder nur ein Ausführungsskript oder ein Ausführungsskript und ein Bedingungsskript).
2. Erstellen Sie die Ressourcenaktionen, die die Skripte verwenden.
3. Weisen Sie die Ressourcenaktionen den Ressourcentypen zu, in denen sie verfügbar sein sollen.

In den folgenden Abschnitten sind diese drei Schritte detailliert beschrieben.

Erstellen von Ressourcenaktionen mit dem Admin Tool

Schritt 1: Schreiben des Ressourcen-Ausführungsskripts

Erstellen Sie ein neues Admin-Tool-Skript des Typs Ressourcen-Aktion. Falls erforderlich, erstellen Sie ein anderes Skript des Typs Ressourcen-Bedingung.

Eine detaillierte Beschreibung der Admin-Tool-Skripte finden Sie im Abschnitt Admin-Tool-Skripte.

Abbildung 537: ConSol CM Admin Tool - Ressourcen-Ausführungsskripte im Bereich Skripte

Code-Beispiel 80: Ressourcen-Ausführungsskript

Schritt 2: Erstellen der Ressourcenaktionen, die das Skript verwenden

Öffnen Sie zum Erstellen, Editieren oder Löschen von Ressourcenaktionen das Navigationselement Aktionen der Navigationsgruppe Ressourcen im Admin Tool.

Um eine neue Aktion zu erstellen oder hinzuzufügen, klicken Sie auf den Button Hinzufügen und geben Sie die erforderlichen Daten im Pop-up-Fenster ein. Es wird das gleiche Pop-up-Fenster für das Hinzufügen und das Editieren von einer Ressourcenaktion angezeigt.

Abbildung 538: ConSol CM Admin Tool - Erstellen einer Ressourcenaktion

• Name
  Der technische Name der Ressourcenaktion. Sie können den Wert über den Button Lokalisieren lokalisieren. Der lokalisierte Name wird im Web Client angezeigt. Eine detaillierte Erklärung des Lokalisierungsmechanismus finden Sie im Abschnitt Lokalisierung von Objekten allgemein, Typ 1.
• Typ
  Der Typ der Ressourcenaktion. Wählen Sie einen der folgenden Typen aus. Ein einmal definierter Typ kann später nicht mehr geändert werden (wenn Sie eine vorhandene Ressourcenaktion editieren).
  
  • Erzeugen
    Diese Aktion wird automatisch ausgeführt, wenn die Ressource erstellt wird.
  • Aktualisieren
    Diese Aktion wird automatisch ausgeführt, wenn die Ressource aktualisiert wird, d. h. wenn die Daten (entweder manuell oder automatisch) verändert und gespeichert wurden.
  • Löschen
    Diese Aktion wird automatisch ausgeführt, wenn die Ressource gelöscht wird.
  • Manuell
    Die Ressourcenaktion wird als Aktivität im Web Client angezeigt und kann nur manuell ausgeführt werden. Wenn ein Ressourcen-Bedingungsskript implementiert wurde, wird die Aktivität im Web Client nur angezeigt, wenn das Bedingungsskript true zurückgegeben hat.
  • Suche
    Die Ressourcenaktion ist eine Suche-Aktion. Aktionen dieses Typs sind im Abschnitt Action Framework - Suche-Aktionen erklärt.
• Bedingungsskript
  Wenn vor dem Ausführungsskript ein Bedingungsskript ausgeführt werden soll, muss der Name des Bedingungsskripts hier eingetragen werden. Über das Drop-down-Menü können Sie das gewünschte Skript aus einer Liste mit allen Skripten des Typs Ressourcen-Bedingung auswählen, die im Skriptbereich des Admin Tools gespeichert sind. Das Ausführungsscript wird nur ausgeführt, wenn das Bedingungsskript true zurückgibt. Lassen Sie das Feld leer, wenn es keine Bedingung gibt.
• Ausführungsskript
  Der Name des Ausführungsskripts, das ausgeführt werden soll. Über das Drop-down-Menü können Sie das gewünschte Skript aus einer Liste mit allen Skripten des Typs Ressourcen-Aktion auswählen, die im Skriptbereich des Admin Tools gespeichert sind.
• Beschreibung
  Geben Sie die Beschreibung ein, die im Web Client als Mouseover angezeigt werden soll (nur für manuelle Aktionen).

Speichern Sie die Aktion. Danach können Sie sie Ressourcentypen zuweisen. Siehe folgenden Schritt.

Schritte 3: Zuweisen von Ressourcenaktionen zu Ressourcentypen

Um bereits definierte Ressourcen-Ausführungs- und/oder Ressourcen-Bedingungsskripte den Ressourcentypen zuzuweisen, müssen die entsprechenden manuellen oder automatischen Aktionen einem Ressourcentyp zugewiesen werden. Öffnen Sie das Navigationselement Datenmodelle der Navigationsgruppe Ressourcen im Admin Tool. Wählen Sie den Ressourcentyp, den Sie editieren möchten, und klicken Sie auf den Button Bearbeiten, um das Pop-up-Fenster zu öffnen, in dem Sie die Ressourcenaktionen zuweisen können. Eine Aktion kann nur ein Ressourcen-Ausführungsskript enthalten oder sowohl ein Ressourcen-Ausführungsskript als auch ein Ressourcen-Bedingungsskript.

Im folgenden Beispiel (nächste Abbildung) wird eine manuelle Ressourcenaktion dem Ressourcentyp PC_Desktops zugewiesen.

Abbildung 539: ConSol CM Admin Tool - Zuweisen von manuellen Ressourcenaktionen zu einem Ressourcentyp

Sie können Ressourcenaktionen folgender Aktionstypen zuweisen:

• Automatische Aktionen
  Diese Aktionen werden automatisch ausgeführt, wenn das entsprechende Ereignis (Erstellen, Aktualisieren oder Löschen) eintritt. Wählen Sie eine Aktion für jeden gewünschten Typ. In den jeweiligen Drop-down-Menüs werden nur die Aktionen des richtigen Typs angeboten (die zuvor als Ressourcenaktionen definiert wurden, siehe Schritt 2). Zum Beispiel werden für eine automatische Aktion des Typs Erzeugen nur (zuvor im Navigationselement Aktionen definierte) Ressourcenaktionen des Typs Erzeugen angeboten.
• Manuelle Aktionen
  Diese Aktionen werden im Web Client als Aktivitäten auf der Ressourcenseite angezeigt und müssen manuell ausgeführt werden. Eine Aktivität wird nur angezeigt, wenn entweder kein Ressourcen-Bedingungsskript vorhanden ist, oder wenn das entsprechende Ressourcen-Bedingungsskript true zurückgegeben hat.
• Suche-Aktionen
  Siehe Abschnitt Action Framework - Suche-Aktionen.

Verwendung von Ressourcenaktionen im Web Client (als Bearbeiter)

Als Bearbeiter (Benutzer) sind die beiden Ressourcenaktionstypen relevant für Sie, die als Aktivitäten im Web Client angezeigt werden:

• Manuell
  Manuelle Aktionen werden im Web Client angeboten, ähnlich wie Workflow-Aktivitäten für Tickets. Siehe Beispiel 1 im nächsten Abschnitt.
• Suche
  Siehe Abschnitt Action Framework - Suche-Aktionen.

Die Aktionen Löschen, Aktualisieren und Erzeugen laufen im Hintergrund.

Programmieren von Ressourcen-Ausführungs- und Bedingungsskripten

Eine allgemeine Einführung in die Grundprinzipien, Klassen und Methoden für Ausführungs- und Bedingungsskripte finden Sie im Abschnitt Skripte für das Action Framework.

Beispiele für Ressourcenaktionen

Beispiel 1: Einfache manuelle Aktion

Anwendungsfall: Der Bearbeiter soll in der Lage sein, ein neues ServiceDesk-Ticket direkt auf der Ressourcenseite eines PCs zu erstellen. Das neue Ticket soll mit der Ressource (PC) verknüpft sein. Der Hauptkontakt des neuen ServiceDesk-Tickets soll die für den PC verantwortliche Person sein. Dies wird als Ressource-Kontakt-Relation im Ressourcentyp PC_Desktop implementiert. Um die Ressourcenaktion zu implementieren, führen Sie folgende Schritte durch.

Schreiben Sie das Ressourcen-Ausführungsskript:

Code-Beispiel 81: Ressourcen-Ausführungsskript für PC_Desktops zur Erstellung eines neuen ServiceDesk-Tickets für den Kontakt, der für den PC zuständig ist

Erstellen Sie eine Ressourcenaktion, die auf dem Skript basiert:

Abbildung 540: ConSol CM Admin Tool - Erstellen einer Ressourcenaktion

Weisen Sie die Aktion dem richtigen Ressourcentyp zu:

Abbildung 541: ConSol CM Admin Tool - Zuweisen der Ressourcenaktion zum richtigen Ressourcentyp

Überprüfen Sie die Funktion mit dem Web Client:

Abbildung 542: ConSol CM Web Client - Ressourcenseite mit der Ressourcenaktion

Abbildung 543: ConSol CM Web Client - Mit der Ressourcenaktion erstelltes, neues ServiceDesk-Ticket

Abbildung 544: ConSol CM Web Client - Ressourcenseite mit einer oder mehreren Ticketrelationen (neues ServiceDesk-Ticket)

Beispiel 2: Öffnen eines Wartungstickets aus einer Ressource, mit ACF

Das Action Framework bietet die Möglichkeit, ein ACF (Activity Control Form) zu öffnen, wenn ein Ticket erstellt wird. Mit dem ACF werden Daten für die folgende Workflow-Aktivität gesammelt, d. h. das Ticket kann erstellt und einfach durch den ersten Workflow-Schritt bewegt werden. Diese Funktion wird im folgenden Beispiel dargestellt. Für die Ressource HP-Drucker soll ein Wartungsticket erstellt werden. Während dieses Vorgangs soll ein ACF geöffnet werden, um nach Daten zu fragen, die danach in der nächsten Workflow-Aktivität verwendet werden.

Um die Ressourcenaktion zu implementieren, führen Sie folgende Schritte durch.

Schreiben Sie das Ressourcen-Ausführungsskripts:

Code-Beispiel 82: Ressourcen-Ausführungsskript, das ein Ticket mit ACF öffnet

Erstellen Sie eine Ressourcenaktion, die auf dem Skript basiert.

Abbildung 545: ConSol CM Admin Tool - Erstellen der Ressourcenaktion für das HP-Drucker-Wartungsticket

Weisen Sie die Aktion dem richtigen Ressourcentyp zu:

Abbildung 546: ConSol CM Admin Tool - Zuweisen der Ressourcenaktion zum richtigen Ressourcentyp (HP-Drucker)

Überprüfen Sie die Funktion mit dem Web Client:

Abbildung 547: ConSol CM Web Client - Ressourcenaktion für HP-Drucker

Abbildung 548: ConSol CM Web Client - Neues Wartungsticket für Ressource (HP-Drucker), ACF