Objektum-összekapcsolási csatlakozó

Tartalomjegyzék

Az OTRS képes külső rendszerektől érkező, az objektum-összekapcsolással való interakcióra irányuló kéréseket fogadni. A funkciót az adminisztrátori felület Webszolgáltatások moduljában kell beállítani. Mind a SOAP, mind a REST módszerekre vannak példabeállítások.

A webszolgáltatás beállításának importálásához:

Menjen a Webszolgáltatás kezelés képernyőre az adminisztrátori felületen.
Kattintson a Webszolgáltatás hozzáadása gombra a bal oldalsávban.
Kattintson a Webszolgáltatás importálása gombra a bal oldalsávban.
Válassza ki a development/webservices/GenericLinkConnectorSOAP.yml vagy a development/webservices/GenericLinkConnectorREST.yml fájlt az OTRS saját mappájában.
Kattintson az Importálás gombra.

Ezek a fájlok tartalmaznak minden információt a webszolgáltatás beállításához. A webszolgáltatás személyre szabható az importálási folyamat után, ha szükséges. Ezen folyamat eredménye ugyanaz lesz, mint az alább ismertetett kézi eljárásé, azonban néhány hasznos megjegyzés is hozzáadásra került a műveletekhez. Az importált webszolgáltatások készen állnak, és képesek kezelni az összes műveletet.

Lehetőség van a beállítás kézi megadására is, ha nem szeretné használni a beépített beállítási példákat.

Megjegyzés

A következő lépések csak akkor szükségesek, ha a webszolgáltatások nem kerültek importálásra a fent ismertetett módon.

A következő lépések szükségesek egy teljesen működő beállítás biztosításához:

Menjen a Webszolgáltatás kezelés képernyőre az adminisztrátori felületen.
Kattintson a Webszolgáltatás hozzáadása gombra a bal oldalsávban.
Töltse ki az űrlapot az alábbi adatokkal:
- Név: LinkObjectConnector
- Hibakeresési küszöbszint: Hibakeresés
- Hálózati átvitel: HTTP::SOAP
Kattintson a Mentés gombra a Művelet hozzáadása választás és a Beállítás gomb engedélyezéséhez a hálózati átvitelnél.
Kattintson a hálózati átvitel Beállítás gombjára az átviteli lehetőségek megjelenítéshez.
Használja a következő paramétereket:
- Névtér: https://otrs.org/LinkObjectConnector/
- Legnagyobb üzenethossz: 100000
Kattintson a Mentés gombra. Várja meg, amíg az oldal újratölt, majd kattintson a Vissza a webszolgáltatáshoz gombra a folytatáshoz.

A Művelet hozzáadása kiválasztás hét műveletet biztosít az összekapcsoláshoz:

Link::LinkAdd
Link::LinkDelete
Link::LinkDeleteAll
Link::LinkList
Link::PossibleLinkList
Link::PossibleObjectsLst
Link::PossibleTypesList

Adja hozzá a Link::LinkAdd műveletet, és állítsa be a LinkAdd nevet a következő képernyőn. Ez nem igényel semmilyen további beállítást.
Kattintson a Mentés gombra. Várja meg, amíg az oldal újratölt, majd kattintson a Vissza a webszolgáltatáshoz gombra a folytatáshoz.
Ismételje meg a 9. és a 10. lépést a többi hat Link:: műveletnél is.
Az összes művelet hozzáadása után kattintson a Mentés és befejezés gombra a Webszolgáltatás szerkesztése: LinkObjectConnector képernyőről.

Most a Webszolgáltatás kezelése áttekintő képernyőn van, az új webszolgáltatás készen áll, és képes kezelni az összes műveletet.

Megjegyzés

Ha az új webszolgáltatás teljesen le lett tesztelve, akkor a hibakeresési küszöbszintet meg lehet változtatni Értesítés szintre. Ez csökkenteni fogja az adatok mennyiségét, amelyek az adatbázisban lesznek eltárolva, és csak az értesítés és a hibaüzenetek lesznek naplózva.

Használat

Az objektumok összekapcsolása funkció az objektumokból (például Ticket, ITSMChangeManagement) származó elemek (például jegyek, változások) összekapcsolásához szolgáltat funkcionalitást, annak érdekében hogy logikai kapcsolatot biztosítson.

Ezen kérések egyszerűen olvashatóvá és megérthetővé tételéhez itt van néhány SOAP kéréssablon, amely az egyes műveletek paramétereit mutatja be.

A `Link::LinkAdd` kéréssablon

<RootElement>
    <UserLogin>?</UserLogin>
    <Password>?</Password>
    <SessionID>?</SessionID>
    <SourceObject>?</SourceObject>
    <SourceKey>?</SourceKey>
    <TargetObject>?</TargetObject>
    <TargetKey>?</TargetKey>
    <Type>?</Type>
    <State>?</State>
</RootElement>

UserLogin és Password: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SessionID: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SourceObject: Az az objektum, ahonnan a kapcsolat származik.
SourceKey: A kapcsolatot létesítő objektum azonosítója.
TargetObject: Az az objektum, ahova a kapcsolat mutat.
TargetKey: A célobjektum azonosítója.
Type: A kapcsolat típusa.
State: A kapcsolat állapota, általában Valid.

A `Link::LinkDelete` kéréssablon

<RootElement>
    <UserLogin>?</UserLogin>
    <Password>?</Password>
    <SessionID>?</SessionID>
    <Object1>?</Object1>
    <Key1>?</Key1>
    <Object2>?</Object2>
    <Key2>?</Key2>
    <Type>?</Type>
</RootElement>

UserLogin és Password: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SessionID: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
Object1: Az az objektum, ahonnan a kapcsolat származik.
Key1: A kapcsolatot létesítő objektum azonosítója.
Object2: Az az objektum, ahova a kapcsolat mutat.
Key2: A célobjektum azonosítója.
Type: A kapcsolat típusa.

A `Link::LinkDeleteAll` kéréssablon

<RootElement>
    <UserLogin>?</UserLogin>
    <Password>?</Password>
    <SessionID>?</SessionID>
    <Object>?</Object>
    <Key>?</Key>
</RootElement>

UserLogin és Password: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SessionID: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
Object: Az az objektum, ahonnan a kapcsolatok származnak.
Key: A kapcsolatot létesítő objektum azonosítója.

A `Link::LinkList` kéréssablon

<RootElement>
    <UserLogin>?</UserLogin>
    <Password>?</Password>
    <SessionID>?</SessionID>
    <Object>?</Object>
    <Key>?</Key>
    <Object2>?</Object2>
    <State>?</State>
    <Type>?</Type>
    <Direction>?</Direction>
</RootElement>

UserLogin és Password: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SessionID: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
Object: Az az objektum, ahonnan a kapcsolatok származnak.
Key: A kapcsolatot létesítő objektum azonosítója.
Object2: Azon objektum elhagyható korlátozása, ahova a kapcsolatok mutatnak.
State: A kapcsolatok állapota, általában Valid.
Type: A kapcsolat típusának elhagyható korlátozása.
Direction: A kapcsolat irányának elhagyható korlátozása (Source vagy Target).

A `Link::PossibleLinkList` kéréssablon

<RootElement>
    <UserLogin>?</UserLogin>
    <Password>?</Password>
    <SessionID>?</SessionID>
</RootElement>

UserLogin és Password: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SessionID: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.

A `Link::PossibleObjectsList` kéréssablon

<RootElement>
    <UserLogin>?</UserLogin>
    <Password>?</Password>
    <SessionID>?</SessionID>
    <Object>?</Object>
</RootElement>

UserLogin és Password: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SessionID: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
Object: Az az objektum, ahonnan a kapcsolatok származnak.

A `Link::PossibleTypesList` kéréssablon

<RootElement>
    <UserLogin>?</UserLogin>
    <Password>?</Password>
    <SessionID>?</SessionID>
    <Object1>?</Object1>
    <Object2>?</Object2>
</RootElement>

UserLogin és Password: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
SessionID: Hitelesítéshez használható. Ez elhagyható, de vagy egy felhasználói bejelentkezési nevet és egy jelszót, vagy egy munkamenet-azonosítót meg kell adni.
Object1: Az az objektum, ahonnan a kapcsolat származik.
Object2: Az az objektum, ahova a kapcsolat mutat.

Példák

A következő példák használják az összes olyan objektumot és típust, amelyek elérhetők az alapértelmezett beállítást használó OTRS-ben. Ha megváltoztatta a kapcsolat alapértelmezett beállításait, akkor a példákat esetleg módosítani kell.

Új kapcsolat létrehozása

Ez a példa azt mutatja be, hogy hogyan kell létrehozni egy kapcsolatot a Link::LinkAdd általános felületi művelet használatával.