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
  • Relation
  • 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 551: 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 552: ConSol CM Admin Tool - Ressourcen-Ausführungsskripte im Bereich Skripte

Code-Beispiel 83: 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 553: 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.

  • Relation
    Dieses Skript wird automatisch ausgeführt, wenn eine Relation zu oder von einer Ressource dieses Typs

    • erstellt
    • gelöscht

    wird. (Das Skript wird nicht ausgeführt, wenn der Kommentar einer Relation geändert 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 554: 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 84: 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 555: ConSol CM Admin Tool - Erstellen einer Ressourcenaktion

Weisen Sie die Aktion dem richtigen Ressourcentyp zu:

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

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

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

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

Abbildung 559: 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 85: Ressourcen-Ausführungsskript, das ein Ticket mit ACF öffnet

Erstellen Sie eine Ressourcenaktion, die auf dem Skript basiert.

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

Weisen Sie die Aktion dem richtigen Ressourcentyp zu:

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

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

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

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

Arbeiten mit dem Changes-Objekt in Ressourcenaktionen des Typs Aktualisieren

Ab CM-Version 10.5.4 ist es möglich, die Änderungen zu überwachen, die während einer Aktion zur Ressourcenaktualisierung durchgeführt wurden. (Dasselbe gilt für Aktionen zur Unit-Aktualisierung, siehe Arbeiten mit dem Changes-Objekt in Kundenaktionen des Typs Aktualisieren).

Mit dem Objekt der Klasse ResourceChanges in Ressourcenaktionen können Sie herausfinden, welche Änderungen erfolgt sind.

Denken Sie daran, dass das Skript Aktualisieren in folgenden Fällen ausgeführt wird:

• bei einer expliziten Aktion des Typs Aktualisieren
• wenn ergänzende Details (Kommentare und/oder Attachments) hinzugefügt werden
• wenn ergänzende Details (Kommentare und/oder Attachments) entfernt werden

Es gibt zwei Methoden des ResourceChanges-Objekts, die Informationen über die geänderten Daten bereitstellen: 

• getCustomFieldChangeInfo()
  liefert Informationen über Änderungen an Ressourcendaten (in Ressourcenfeldern)
• getContentChangeInfo()
  liefert Informationen über Änderungen im Ressourcenprotokoll (Kommentare, Attachments) 

Da die Rückgabeparameter der Methode ziemlich komplexe Bestandteile haben, empfehlen wir, die API Doc der Klasse ResourceChanges zu lesen. Das folgende Codebeispiel enthält ein Skript, in dem das ResourceChanges-Objekt verwendet wird.

Code-Beispiel 86: Ressourcen-Aktualisierungsskript, in dem Änderungen überwacht und in die Datei server.log geschrieben werden

Wenn bei einer Ressource des Typs PC_Desktops der Inhalt der Ressourcenfelder modell und name geändert wird, wird folgender Text in die Datei server.log geschrieben.

Code-Beispiel 87: Log-Ausgabe für das obige Skript