Skip to main content

Beispiele für Jobs

Nachfolgend finden Sie Beispiele für die Konfiguration von Jobs für häufig benötigte Anwendungsfälle.

Periodischer Job "Lizenzverlängerung"

In diesem UseCase wird ein Job erstellt, der ein Ticket generiert, sobald die Lizenz eines Software-Assets innerhalb der nächsten 1 bis 3 Wochen abläuft. 

Dazu prüft der Job alle Assets der Klasse "Software" und kontrolliert das angegebene Lizenz-Ablaufdatum. Liegt dieses Datum innerhalb der nächsten 1 bis 3 Wochen, wird ein Ticket generiert und dem zuständigen Team zugeordnet. Im Ticket sind das betroffene Asset sowie dessen Name und ID angegeben, sodass der Agent auf einen Blick erkennt, um welches Asset es sich handelt.

Vorbereitung

  1. An den betreffenden Assets der Klasse "Software" muss das Ablaufdatum der Lizenz hinterlegt sein, da dieses Datum im Job geprüft wird.

    Ergänzen Sie daher ggf. das Ablaufdatum der Lizenz für eine oder mehrere Software-Assets.

    Ablaufdatum.png

  2. Das Attribut "Ablaufdatum | Expiration Date" ist initial nicht durchsuchbar und steht somit in den Job-Filtern nicht zur Auswahl. Die Asset-Klassendefinition der Klasse "Software" muss daher angepasst werden:

    1. Navigieren Sie im Admin Modul zu KIX > Assets > Asset-Klassen.

    2. Klicken Sie die Klasse "Software" an, um die Detailansicht zu öffnen und klicken Sie dann auf Bearbeiten.

      Der Dialog Assetklasse bearbeiten wird geöffnet.

    3. Vergrößern Sie das Textfeld Klassendefinition, um den Code einfacher bearbeiten zu können.

      Optional können Sie den Code in einen (Text-)Editor Ihrer Wahl kopieren.

    4. Nutzen Sie die Suchfunktion Ihres Browsers oder Editors und suchen Sie nach dem Attribut "Expiration Date".

    5. Setzen Sie ein Komma nach der letzten Zeile und fügen Sie den Parameter Searchable => 1 hinzu.

      Damit wird das Attribut Ablaufdatum auf durchsuchbar gesetzt.

      AssetClass-_ExpirationDate_-_searchable.png

    6. Speichern Sie die Änderung.

Job konfigurieren

  1. Job Informationen

    1. Job Typ: Asset

      Hinweis: Mit Ausführung des Jobs wird zwar ein Ticket erstellt, aber da der Job auf Assets angewendet wird, ist als Job-Typ "Asset" anzugeben.

    2. Name, Kommentar: Die Felder können individuell belegt werden.

    3. Gültigkeit: gültig

  2. Ausführungsplan

    Konfigurieren Sie einen Zeitpunkt Ihrer Wahl. Es empfiehlt sich eine zeitgesteuerte Ausführung, z. B.

    1. Wochentag(e): Montag

    2. Zeit: 10:00 (Uhr)

  3. Filter

    Setzen Sie die Filter, um die Software-Assets zu ermitteln, deren Lizenz innerhalb de nächsten 1 bis 3 Wochen abläuft.

    1. Klasse - enthalten in  - Software

    2. Ablaufdatum - innerhalb - der nächsten - 1 - Wochen - bis - der nächsten - 3 - Wochen

      (Kann das Attribut "Ablaufdatum" nicht gewählt werden, ist es nicht durchsuchbar (s. Vorbereitung)

  4. Aktionen

    1. Action: Variable Setzen

      Mittels Platzhalter wird vom auslösenden Asset die Asset-Nr. und dessen Name ermittelt und gemeinsam mit Text als String in einer Variable gespeichert. 

      Hinweis: Variablen können mehrere Attribute aufnehmen und Arrays bilden. Die Kombination aus Text und Platzhaltern ist ebenfalls möglich.

      1. Variable: varCurrentAsset

      2. Wert: A#: <KIX_ASSET_Number> ( <KIX_ASSET_Name>)

    2. Action: Macro ausführen

      1. Macro: Ticket

        1. 1. Aktion: Ticket anlegen

          Die nachfolgend angegebenen Parameter können Sie nach Bedarf ändern.

          • Kanal: Notiz

          • Artikeltext:

            Die Software-Lizenz läuft innerhalb der nächsten 14 Tage aus. Bitte Lizenz erneuern.

            Asset: ${varCurrentAsset}(Asset-ID: ${RootObjectID})

          • Kontakt: Martin Mustermann

          • Organisation: My Organisation

          • Priorität: 2 high

          • Status: new

          • Titel: Erneuerung Software-Lizenz erforderlich: ${varCurrentAsset}

          • Team: Service Desk

          • Dynamische Felder:

            Die Variable ${RootObjectID} ermittelt das Asset, welches den Job auslöst und setzt dieses als "Betroffenes Asset" am Ticket.

            • Name: Betroffenes Asset

            • Wert: ${RootObjectID}

Job ausführen

Der Job wird zum konfigurierten Zeitpunkt ausgeführt und erstellt ein Ticket zur Verlängerung der Lizenz. Als Betroffenes Asset ist das den Job auslösende Objekt gesetzt (${RootObjectID}). Dies entspricht dem Asset, dessen Software-Lizenz verlängert werden muss.

Zudem enthält der Artikeltext und der Ticketbetreff die Asset-Nummer und den Namen des betreffenden Assets, sodass der Agent auf einen Blick erkennt, um welches Asset es sich handelt. Diese Informationen wurden in der Variable varCurrentAsset gespeichert und beim Generieren des Tickets an entsprechender Stelle ausgegeben.

Ticket.png

Abb.: Ein durch den Job erstelltes Ticket

In diesem Abschnitt: