Anwendungszuordnung

Die Anwendungszuordnung weist Prozessnamen einen lesbaren Anwendungsnamen zu. So lassen sich die Prozesse einfacher erkennen und gruppieren.

Die Definitionen für die Zuordnungen erstellst du in der Datei application_map.xml im Datenverzeichnis. Die Datei wird einmal beim Start des Servers gelesen.

Das folgende Beispiel zeigt die Struktur der Datei:

 1<?xml version="1.0" encoding="UTF-8" ?>
 2<RaptorApplicationMap
 3    version="1"
 4    xmlns="http://educateit.ch/software/Raptor/ApplicationMap/1"
 5    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 6
 7    <Application name="..." filtered="...">
 8        <Process name="..." />
 9            ...
10    </Application>
11    ...
12</RaptorApplicationMap>

Das Dokument Element RaptorApplicationTag

Die ganze Datei wird in das Dokument Element RaptorApplicationTag eingeschlossen. Darin schreibst du dann eines, oder beliebig viele Application Elemente. Jedes dieser Elemente definiert eine einzelne Anwendung.

Das RaptorApplicationTag benötigt zwingend das Attribut version welches auf den Wert 1 gesetzt sein muss.

Das Element Application

Für jede Anwendung definierst du ein Application Element, welches die beiden Attribute name und filtered hat.

In dieses Element schreibst du eines, oder beliebig viele Process Elemente. Jedes dieser Elemente definiert den Namen eines Prozesses, welcher der Anwendung zugeordnet wird.

Das name Attribut

Das name Attribut definiert einen eindeutigen Namen für die Anwendung. Dieser Name wird für alle dieser Anwendung zugeordneten Prozesse angezeigt.

Der Name darf maximal 64 Zeichen lang sein und nur bestimmte Zeichen enthalten. Neben Buchstaben und Zahlen sind noch der Punkt ., der Unterstrich _ sowie runde Klammern () und ein Leerzeichen erlaubt.

Das filtered Attribut

Das filtered Attribut erlaubt es, bestimmte Prozesse komplett auszublenden. Setzt du es auf true, werden alle in diesem Application Element definierten Prozesse ausgeblendet. Steht es auf false bleiben die Prozesse sichtbar.

Das Element Process

Mit dem Element Process weist du einen einzelnen Prozess der Anwendung hinzu. Dabei benötigt er ein einzelnes Attribut name mit dem Namen des Prozesses.

Das name Attribut

Mit dem name Attribut definierst du den exakten Namen des Prozesses. Dieser Name muss für die ganze Datei eindeutig sein. Du darfst den selben Prozess nicht mehreren Anwendungen zuweisen.

Die Gross-/Kleinschreibung spielt bei dem Namen keine Rolle, er muss aber in dem Format angegeben werden, wie er auch durch die Erweiterungen zurückgeliefert wird. Beispielsweise entfernen bestimmte Erweiterungen die Endung .exe oder .com. In diesem Fall darf sie in dem Namen auch nicht enthalten sein.

Beispiel

Das folgende Beispiel zeigt einige sehr einfache Zuordnungen und einige versteckte Prozesse:

 1<?xml version="1.0" encoding="UTF-8" ?>
 2<RaptorApplicationMap
 3    version="1"
 4    xmlns="http://educateit.ch/software/Raptor/ApplicationMap/1"
 5    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
 6
 7    <Application name="Word" filtered="false">
 8        <Process name="word.exe" />
 9        <Process name="msword.exe" />
10    </Application>
11    <Application name="Explorer" filtered="false">
12        <Process name="explorer.exe" />
13    </Application>
14    <Application name="Firefox" filtered="false">
15        <Process name="firefox.exe" />
16    </Application>
17    <Application name="Hidden" filtered="true">
18        <Process name="svchost.exe" />
19        <Process name="csrss.exe" />
20        <Process name="test1.exe" />
21        <Process name="test2.exe" />
22    </Application>
23</RaptorApplicationMap>