Web-Services

Configuration Item Invoker

Dieses Paket bietet die Funktionalität, eine Liste von Configuration Items von einem entfernten System mit dem generischen Interface anzufordern. Es ist eine vollständige Zuordnung zwischen dem Namen von entfernten Wertschlüsseln und den Klassendefinitionen von lokalen Configuration Item möglich. Um die Möglichkeit zu geben, alle Klassenattribute in der Abbildung zu definieren, ist eine erweiterte Abbildung vorgesehen.

So verwenden Sie diesen Invoker:

1. Gehen Sie zur Ansicht Web Service-Verwaltung.

2. Fügen Sie einen neuen Web Service hinzu oder wählen Sie einen bestehenden aus.

3. Wählen Sie den Invoker ITSM::ConfigItem im Abschnitt Invokers.

Für den Umgang mit entfernten Configuration Items und Links wird eine erweiterte Zuordnung mit diesem Paket geliefert. Um diese Funktionalität zu nutzen, wählen Sie in der Mapping-Auswahlbox ITSMConfigItem aus.

Eines dieser fortgeschrittenen Mapping-Features sind statische Werte. Diese ermöglichen es, statische Werte für definierte Schlüssel zu definieren, z.B. die Einstellung der Configuration Item-Klasse für jedes Element. Diese Einträge können vom entfernten System gesendete Daten überschreiben.

Ein weiteres Merkmal des erweiterten Mappings ist die Umwandlung von Zeichenketten in Listenstrukturen. Für die Erstellung einer Liste aus einem String kann ein Listentrennzeichen definiert werden, z.B. ;. Das Trennfeld nimmt einen regulären Ausdruck, der komplexere Trennzeichen wie ;(?:\s+)?` (ein ; optional gefolgt von mehreren Leerzeichen) möglich macht.

Es ist möglich zu definieren, wo der Index der Elemente in der Configuration Item Struktur stattfinden soll. Dazu muss der Platzhalter ####INDEX##### in der Schlüsselabbildung platziert werden. Die Konfiguration im Screenshot würde die getrennte IP-Adressenliste jeweils in einer neuen Schnittstelle speichern. Wenn in der Abbildung kein Index definiert ist, erhöht der Index den Hauptattributzähler, wie ein Suffix.

Das Configuration Item Number-Attribut wird verwendet, um die logische Verbindung zwischen den Remote-Daten und den in der OTRS-Datenbank gespeicherten Daten herzustellen. Um Configuration Items mit diesem Invoker zu erstellen und zu aktualisieren, sind Werte für die folgenden Schlüssel erforderlich:

- Name
- Class
- Number
- DeploymentState
- IncidentState

Die Werte für diese Schlüssel (außer Nummer) können statisch sein oder vom entfernten System bereitgestellt werden.

Generic Link Object Invoker

Zusätzlich zur Configuration-Item-Funktionalität bietet dieses Paket die Funktionalität, Objekte wie z. B. Tickets mit Configuration Items oder Configuration Items mit Configuration Items miteinander zu verknüpfen. Der Invoker kann sich damit beschäftigen, neue Links von einem entfernten System zu erhalten oder die bereitgestellten Links synchron zu halten und entfernte Links aus der OTRS-Datenbank zu löschen. Es gibt keine Einschränkungen bei der Verknüpfung verschiedener Objekte.

So verwenden Sie diesen Invoker:

1. Gehen Sie zur Ansicht Web Service-Verwaltung.

2. Fügen Sie einen neuen Web Service hinzu oder wählen Sie einen bestehenden aus.

3. Wählen Sie im Abschnitt Invokers den Invoker Generic::LinkObject aus.

Um verschiedene Objekte miteinander zu verknüpfen, benötigen die folgenden Mapping-Schlüssel Werte:

- SourceClass
- SourceObject
- TargetClass
- TargetObject
- Type

Die OTRS-interne Objekt-ID kann direkt mit den Schlüsseln SourceKey und TargetKey versehen werden oder kann durch die Angabe der OTRS-Objektnummer mit den Schlüsseln SourceNumber und TargetNumber nachgeschlagen werden.

Um das OTRS mit dem entfernten System synchron zu halten, ist es möglich, verschiedene Link-Kombinationen, auszuwählen, die synchronisiert werden sollen. Das heißt, wenn eine Remote-Link-Kombination entfernt wurde, wird auch der lokale Link entfernt.

Die Synchronisation von Configuration Item-Klassen kann durch Auswahl der Klassen, die synchronisiert werden sollen, aus der Liste in der Invoker-Administrationsansicht eingeschränkt werden.

Configuration Item Synchronization Invoker

Dieses Paket bietet die Funktionalität, Configuration Items zwischen zwei OTRS-Instanzen mit Hilfe eines speziellen Synchronisations-Invoker zu synchronisieren. Dieser Invoker erlaubt es, Invoker für das Erstellen, Aktualisieren und Löschen von Synchronisationen zu definieren, die bei Bedarf automatisch aufgerufen werden.

Um Configuration Items zwischen zwei Systemen zu synchronisieren, ist es erforderlich, einen Web Service mit einem Invoker vom Typ ITSM::ConfigItemSync hinzuzufügen. Dieser Invoker ist der grundlegende (Such-) Invoker, der verwendet wird, um ITSM-Objektsuchen auf dem entfernten System durchzuführen, um Configuration Items zu bestimmen, die geändert werden sollen.

So verwenden Sie diesen Invoker:

1. Gehen Sie zur Ansicht Web Service-Verwaltung.

2. Fügen Sie einen neuen Web Service hinzu oder wählen Sie einen bestehenden aus.

3. Wählen Sie den Invoker ITSM::ConfigItemSync im Abschnitt Invokers.

Es arbeitet bei jeder Synchronisierungsaktion mit zwei Schritten:

1. Abhängig von der Änderung, die im lokalen System vorgenommen wurde (Hinzufügen, Aktualisieren oder Löschen eines Configuration Items), führt der Invoker zunächst eine verwandte Suche auf dem entfernten System durch, um festzustellen, ob es zum Erstellen, Aktualisieren oder Löschen eines entfernten Configuration Items erforderlich ist.

2. Im zweiten Schritt wird ein zugehöriger Invoker für Erstellungsaktionen, Aktualisierungsaktionen oder Löschaktionen aufgerufen, der die wichtigsten Änderungen auf dem entfernten System ausführt. Diese Invoker müssen ebenfalls erstellt werden und müssen vom Invoker-Typ ITSM::ConfigItem sein, um sicherzustellen, dass die Kommunikation einwandfrei funktioniert.

Siehe die beiliegende Übersicht der Beispiel-Invokers:

Innerhalb der Konfiguration des Such-Invokers müssen die Invoker, die die Änderungen durchführen sollen, für jede Aktion in den entsprechenden Dropdown-Menüs separat konfiguriert werden.

Wenn ein Invoker nicht für die entsprechende Aktion konfiguriert ist, wird er ausgelassen. Der konfigurierte Invoker wird in jeder Dropdown-Liste aufgeführt und kann leicht für die verschiedenen Aktionen ausgewählt werden.

Die verschiedenen Invoker müssen ihre Daten abbilden. Damit dies richtig funktioniert, wird empfohlen, das Mapping-Modul ITSMConfigItem zu verwenden, das in dieser Dokumentation beschrieben wird. Tatsächlich ist es aber auch möglich, andere Arten von Mappings wie XSLT zu verwenden, wenn es richtig konfiguriert ist.

Da diese Struktur entfernte Systeme aufruft, ist es erforderlich, zumindest die Verbindungs-Anmeldedaten für den Zugriff auf die entfernte CMDB zu konfigurieren.

Alle anderen Konfigurationen können optional eingestellt werden, aber sie sind nicht erforderlich, damit die Grundfunktion funktioniert.

Um sicher zu gehen, dass der Such-Invokerr nur auf bestimmte Ereignisse hört, erweitert dieses Paket die Möglichkeiten des Invoker-Event-Filter-Features von OTRS, mit dem zusätzliche Bedingungen zu den Ereignis-Triggern hinzugefügt werden können, die für den Such-Invokerr konfiguriert sind. Ein Beispiel könnte sein, dass nur Configuration Items der ITSM-Klasse Computer mit dem Remote-System synchronisiert werden.

Die Konfiguration des entfernten Systems, das synchronisiert wird, muss nicht speziell sein, aber dafür muss es mindestens eine Operation für die Suchausführungen und eine separate Operation für jede Synchronisierungsaktion, die ausgeführt werden muss, bereitstellen.