Agent : Global

Die Agent API bietet Methoden zum Abrufen oder Festlegen der Anwesenheit von Service Desk-Mitarbeitern und Kanalverfügbarkeit.

Die Agent API wird im Namespace sn_awa bereitgestellt.

Folgendes ist erforderlich:

• Plugin „Advanced Work Assignment“ (com.glide.awa)
• Rolle: awa_integration_user oder admin

Agent – get(String user_sys_id)

Ruft einen Agenten nach sys_id ab.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
user_sys_id	Zeichenfolge	Die sys_id des Benutzers, der in der Tabelle „sys_user“ aufgeführt wird.

Tabelle : 2. Ergebnisse

Typ	Beschreibung
Boolean	„True“, wenn der Benutzer vorhanden ist, andernfalls „false“.

var agent = sn_awa.Agent.get("<user_sys_id>");
var presence  = agent.getPresence();

Service Desk-Mitarbeiter – getPresence ()

Ruft den aktuellen Anwesenheitsstatus und die Kanalverfügbarkeit eines bereitgestellten Agenten ab.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
Objekt	Anwesenheitsstatus sys_id, Name des Anwesenheitsstatus und Kanalinformationen. Andernfalls Fehlermeldung.

var agent = sn_awa.Agent.get("<user_sys_id>");
        var presence  = agent.getPresence();

Agent – setPresence(Object setRequest)

Legt den Status der Anwesenheit eines angegebenen Service Desk-Mitarbeiters fest und legt die Kanalverfügbarkeit des Service Desk-Mitarbeiters für diesen Status fest.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
festlegenAnforderung	Objekt	setRequest.sys_id und setRequest.channels
festlegenAnforderung.sys_id	Zeichenfolge	Die „presence_sys_id“ aus der Tabelle „AWA-Anwesenheitsstatus“ [awa_presence_state]
festlegenAnforderung.Kanäle	Name/Wert-Paar	Optional. sys_id: Channel_sys_id aus der Tabelle „awa_service_channel“. available: Verfügbarkeit des Service Desk-Mitarbeiters, um Arbeit für diesen Kanal zu erhalten (wahr oder falsch).

Tabelle : 6. Rückgaben

Typ	Beschreibung
Boolean	„True“, falls erfolgreich, andernfalls „false“.

var agent = sn_awa.Agent.get("<user_sys_id>");
var presence = agent.setPresence({
    sys_id: <presence_sys_id>,
    channels: [{
        sys_id: "<channel_sys_id>",
        available: true // or false
    }]
});