Ressourcenaktionen

Einführung in Ressourcenaktionen in ConSol CM

Ressourcenaktionen ermöglichen die Ausführung von Skripten für Ressourcen. Zusätzlich kann im Rahmen einer Ressourcenaktion ein Formular auf der Ressourcenseite oder über der Detailsuche angezeigt werden. Ressourcenaktionen werden Ressourcentypen zugewiesen.

Konzepte, Begriffe und Definitionen

Konzept	Andere Begriffe	Definition
Ressource		Asset, das im Geschäftsprozess verwendet wird; gehört immer zu einem Ressourcentyp
Ressourcentyp		Untere hierarchische Ebene des Ressourcenmodells; definiert das Datenmodell, das für dessen Ressourcen verwendet wird; Grundlage für das Zuweisen von Berechtigungen und das Bestimmen der verfügbaren Aktivitäten und Relationen
Ressourcenkategorie	Ressourcengruppe	Obere hierarchische Ebene des Ressourcenmodells; kann mehrere Ressourcentypen enthalten
Ressourcenmodell		Hierarchisches Datenmodell für Ressourcenobjekte, das Ressourcenkategorien auf der oberen Hierarchieebene und Ressourcentypen auf der unteren Hierarchieebene enthält
Ressourcenformular		Formular, das beim Ausführen einer manuellen oder Suche-Aktion oben auf der Seite angezeigt wird
Aktionsskript		Skript des Typs Ressourcenaktion oder Suche-Aktion für Ressourcen, in dem die auszuführende Logik implementiert ist

Zweck und Verwendung

Ressourcenaktionen können entweder automatisch ausgeführt werden, wenn ein bestimmter Ereignis eintritt, oder manuell durch einen Benutzer im Web Client.

Es sind folgende Aktionstypen verfügbar:

Automatische Aktionen: Aktion wird automatisch ausgeführt, wenn eine Ressource erstellt, geändert oder gelöscht wird, oder wenn eine Ressourcenrelation erstellt oder gelöscht wird.
Manuelle Aktionen: Aktion, die für die manuelle Ausführung auf der Ressourcensuche oder in der Detailsuche verfügbar ist. Sie wird im Feld Aktivitäten in der oberen rechten Ecke des Web Clients angezeigt. Manuelle Aktionen auf der Ressourcenseite gelten nur für die aktuelle Ressource. Suche-Aktionen gelten für die ausgewählten Ergebnisse des geöffneten Tabs mit Ergebnissen der Detailsuche.

Manuelle Aktionen können ein Formular umfassen, das oben auf der Seite angezeigt wird und ausgefüllt werden muss, um die Aktion durchzuführen.

Die Verfügbarkeit der Aktion kann mittels Skript bestimmt werden. Wenn das Bedingungsskript „true“ zurückgibt, werden automatische Aktionen ausgeführt und manuelle Aktionen im Web Client angezeigt.

Benutzer brauchen die Berechtigung „Ausführen“ für den Ressourcentyp, um manuelle und Suche-Aktionen ausführen zu können.

Beispiele für Ressourcenaktionen sind Aktionen zum Aktualisieren von Ressourcendaten aus einem externen System oder zum Erstellen eines Vorgangs auf Basis bestimmter Parameter, die im Aktionsformular eingegeben werden.

Einstellungen für Ressourcenaktionen

Folgende Einstellungen sind im Tab Basisdaten für Ressourcenaktionen verfügbar.

Interner Name: Pflichtangabe. Der technische Name der Ressourcenaktion.
Typ: Pflichtangabe. Die Verwendung der Ressourcenaktion. Mögliche Werte sind:
- Aktion beim Erstellen: Automatische Ausführung, wenn eine Ressource erstellt wird.
- Aktion beim Aktualisieren: Automatische Ausführung, wenn eine Ressource aktualisiert wird, d.h. Daten geändert werden oder Kommentare oder Attachments hinzugefügt oder entfernt werden.
- Aktion bei Löschen: Automatische Ausführung, wenn eine Ressource gelöscht wird.
- Aktion beim Setzen von Relationen: Automatische Ausführung, wenn eine Relation zur Ressource erstellt oder gelöscht wird.
- Manuelle Aktion: Manuelle Ausführung auf der Ressourcenseite des Web Client.
- Suche-Aktione: Manuelle Ausführung für Ergebnisse der Detailsuche im Web Client. Die Ressourcenaktion ist verfügbar, wenn der Tab des Ressourcentyps, dem die Aktion zugewiesen ist, ausgewählt ist.
Bedingungsskript: Optional. Das Skript des Typs Ressourcenbedingung oder Suche-Bedingung für Ressourcen, das ausgeführt wird, um zu bestimmen, ob die Aktion ausgeführt wird oder nicht. Bei automatischen Aktionen wird das Aktionsskript nur ausgeführt, wenn das Bedingungsskript „true“ zurückgibt. Manuelle und Suche-Aktionen werden nur angezeigt, wenn das Bedingungsskript „true“ zurückgibt.
Aktionsskript: Pflichtangabe außer für manuelle Aktionen mit Formular. Das Skript des Typs Ressourcenaktion oder Suche-Aktion für Ressourcen, das ausgeführt wird.
Verwendung in Ressourcentypen: Schreibgeschützt. Zeigt die Ressourcentypen an, denen die Aktion zugewiesen ist.
Lokalisierter Name: Pflichtangabe. Der lokalisierte Name der Ressourcenaktion. Im Web Client für manuelle und Suche-Aktionen angezeigt.
Lokalisierte Beschreibung: Optional. Die lokalisierte Beschreibung der Ressourcenaktion. Im Web Client als Tooltip für manuelle und Suche-Aktionen angezeigt.

Einstellungen für Aktionsformulare

Für manuelle und Suche-Aktionen ist der Tab Formular verfügbar. Er ermöglicht die Auswahl eines Formulars, das beim Ausführen der Aktion angezeigt wird (optional). Es sind folgende Einstellungen verfügbar:

Aktionsformular: Optional. Das Aktionsformular, das angezeigt wird, wenn der Benutzer auf die Aktion klickt. Das Aktionsskript wird nach dem Speichern des Formulars ausgeführt.
Bedingungsskript für Formular: Optional. Skript des Typs Bedingung für Aktionsformular, das bestimmt, ob das Formular angezeigt wird.
Vorbelegungsskript für Formular: Optional. Skript des Typs Vorbelegung für Aktionsformular, das Formularfelder mit bestimmten Werten vorbefüllt.
Pflichtfelder: Optional. Wählen Sie die Felder, die im Formular Pflichtfelder sein sollen.

Grundlegende Aufgaben

Verwenden von Ressourcenaktionen

Führen Sie folgende Schritte aus, um eine Ressourcenaktion zu verwenden:

Erstellen Sie ein Skript des Typs Ressourcenaktion oder Suche-Aktion für Ressourcen, siehe Aktionsskripte. Dies kann entweder auf der Seite Skripte erfolgen, oder indem Sie den gewünschten Namen in das Auswahlfeld Aktionsskript eintragen und die Option zum Erstellen wählen.
Erstellen Sie bei Bedarf ein Skript des Typs Ressourcenbedingung oder Suche-Bedingung für Ressourcen, siehe Aktionsskripte. Dies kann entweder auf der Seite Skripte erfolgen, oder indem Sie den gewünschten Namen in das Auswahlfeld Bedingungsskript eintragen und die Option zum Erstellen wählen.
Erstellen Sie auf der Seite Ressourcenaktionen eine Ressourcenaktion.
Weisen Sie die Ressourcenaktion auf der Seite Ressourcenmodelle einem Ressourcentypen zu, siehe Ressourcenmodelle.

Verwalten von Ressourcenaktionen

Ressourcenaktionen werden auf der Seite Ressourcenaktionen der Web Admin Suite verwaltet. Es sind folgende Aktionen verfügbar:

Neue Ressourcenaktion erstellen
Klicken Sie über der Liste der Ressourcenaktionen auf den Button Neue Aktion oder duplizieren Sie eine vorhandene Ressourcenaktion, indem Sie auf das Icon Duplizieren der Aktion klicken. Geben Sie die erforderlichen Einstellungen im Tab Basisdaten (siehe Einstellungen für Ressourcenaktionen) ein und definieren Sie bei Bedarf im Tab Formular ein Aktionsformular (nur manuelle und Suche-Aktionen, siehe Einstellungen für Aktionsformulare).
Ressourcenaktion bearbeiten
Klicken Sie auf das Icon Bearbeiten oder auf die Zeile der Aktion, um die gewünschten Daten in den Tabs Basisdaten (siehe Einstellungen für Ressourcenaktionen) und Formular (siehe Einstellungen für Aktionsformulare) zu aktualisieren.
Ressourcenaktion deaktivieren
Sie können Ressourcenaktionen deaktivieren, indem Sie auf das Icon Deaktivieren klicken.

Wenn Sie eine Ressourcenaktion deaktivieren, können Sie sie keinen Ressourcentypen mehr zuweisen. Wenn die Aktion bereits Ressourcentypen zugewiesen ist, wird sie ignoriert, d. h. eine automatische Aktion wird nicht ausgeführt und eine manuelle oder Suche-Aktion wird nicht im Web Client angezeigt.
Ressourcenaktion aktivieren
Sie können deaktivierte Ressourcenaktionen aktivieren, indem Sie auf das Icon Aktivieren klicken.
Ressourcenaktion löschen
Sie können eine Ressourcenaktion, die keinem Ressourcentypen zugewiesen ist, löschen, indem Sie auf das Icon Löschen klicken.

Erweiterte Aufgaben

Arbeiten mit Skripten für Ressourcenaktionen

Für Ressourcenaktionen sind folgende Skripte relevant:

Ressourcenaktion: Hauptskript, das beim Ausführen einer manuellen oder automatischen Aktion ausgeführt wird.
Suche-Aktion für Ressourcen: Hauptskript, das beim Ausführen einer Suche-Aktion ausgeführt wird.
Ressourcenbedingung: Skript, das bestimmt, ob eine manuelle Aktion im Web Client angezeigt wird, oder eine automatische Aktion ausgeführt wird. Muss true oder false zurückgeben.
Suche-Bedingung für Ressourcen: Skript, das bestimmt, ob eine Suche-Aktion im Web Client angezeigt wird. Muss true oder false zurückgeben.
Bedingung für Aktionsformular: Skript, das bestimmt, ob ein Aktionsformular für eine manuelle oder Suche-Aktion angezeigt wird. Muss true oder false zurückgeben.
Vorbelegung für Aktionsformular: Skript, das das Aktionsformular mit bestimmten Werten vorbelegt.

Details über die Programmierung von Aktionsskripten finden Sie in Aktionsskripte.