NotifyAction – Global

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 21 Minuten Lesedauer

    • Mit der NotifyAction-API können Sie Aktionen definieren, die an einen Telefonanbieter gesendet werden sollen.

    Sie fügen einem NotifyAction-Objekt Aktionen hinzu, indem Sie die jeweilige Hinzufügen-Funktion für jeden Aktionstyp aufrufen. Jede Hinzufügen-Funktion gibt ein Aktions-Objekt aus, beispielsweise ein SayAction-Objekt für die addSay()-Funktion. Informationen zu zurückgegebenen Objekten finden Sie in jedem Methodenbeispiel.

    Hinweis:
    Die NotifyAction-API ist nur in globalen Anwendungen gültig. Um diese Art von Funktionalität in bereichsbezogenen Anwendungen nutzen zu können, müssen Sie benutzerdefinierte Notify-Workflow-Aktivitäten erstellen. Weitere Informationen zum Erstellen dieser Aktivitäten finden Sie unter Notify-Workflow-Aktivitäten.

    NotifyAction – addConference()

    Fügt eine Konferenzaktion hinzu, um den aktuellen Anruf in die aktuelle Konferenzschaltung zu verschieben.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Konferenzaktion Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das ConferenceAction-Objekt, um den Namen der Konferenzschaltung und das Verhalten der Konferenzschaltung zu definieren, wenn ein Teilnehmer ihr beitritt oder sie verlässt.

    Dieses Beispiel zeigt, wie Sie eine Konferenzaktion hinzufügen und den Namen der Konferenz festlegen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a conference call action and set its name
var conference = notifyAction.addConference();
conference.setName('Brown Bag: Week 3');

    NotifyAction – addConference.setEndOnExit(Boolean endOnExit)

    Legt fest, ob die Konferenzschaltung beendet werden soll, wenn ein bestimmter Anrufer die Konferenzschaltung verlässt.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    endOnExit Boolean Kennzeichnung, die angibt, ob die Konferenzschaltung beendet werden soll, wenn ein bestimmter Anrufer die aktuelle Konferenzschaltung verlässt.
    • true: Beendet die Konferenzschaltung, wenn der angegebene Anrufer die Konferenzschaltung verlässt
    • false: Standard. Beenden Sie die Konferenzschaltung, sobald alle Teilnehmer sie verlassen haben
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Konferenzschaltungsaktion hinzufügen und sie so festlegen, dass die Konferenzschaltung endet, wenn der angegebene Anrufer sie verlässt.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a conference call action and set the caller that starts the meeting
var conference = notifyAction.addConference();

// retrieve the participant for which the conference call should exit when they leave
var notifyParticipantGr = new GlideRecord('notify_participant');
notifyParticipantGr.get('active participant sys id');
 
if (notifyParticipantGr.isValid) {
conference.setEndOnExit(true);
}

    NotifyAction – addConference.setHangupOnStar(Boolean hangupOnStar)

    Legt fest, ob die Konferenzschaltung beendet werden soll, wenn ein Teilnehmer die Stern-Taste (*) drückt.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    hangupOnStar Boolean Kennzeichnung, die angibt, ob die Konferenzschaltung beendet werden soll, wenn ein Teilnehmer die Stern-Taste (*) drückt.

    Gültige Werte:

    • true: Beenden Sie die Konferenzschaltung
    • false: Standard. Beenden Sie die Konferenzschaltung nicht
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Konferenzaktion hinzufügen und die Konferenzschaltung dann aufzeichnen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a conference call action and set the hang up action
var conference = notifyAction.addConference();
conference.setHangupOnStar(true);

    NotifyAction – addConference.setMuted(Boolean muted)

    Legt fest, ob der angegebene Anrufer in der aktuellen Konferenzschaltung stummgeschaltet werden soll.

    Wenn Sie diese Methode nicht aufrufen, wird der Anrufer standardmäßig nicht stummgeschaltet.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    stummgeschaltet Boolean Kennzeichnung, die angibt, ob der angegebene Anrufer in der aktuellen Konferenzschaltung stummgeschaltet werden soll.
    • true: Anrufer sollte stummgeschaltet sein
    • false: Standard. Anrufer sollte nicht stummgeschaltet sein
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Konferenzaktion hinzufügen und dann einen angegebenen Anrufer stummschalten.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a conference call action and set it to mute the specified participant
var conference = notifyAction.addConference();

var notifyParticipantGr = new GlideRecord('notify_participant');
notifyParticipantGr.get('active participant sys id');
 
if (notifyParticipantGr.isValid) {
conference.setMuted(true);
}

    NotifyAction – addConference.setName(String name)

    Legt den Namen der aktuellen Konferenzschaltung auf den angegebenen Namen fest.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name, der der aktuellen Konferenzschaltung zugeordnet werden soll.
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Konferenzaktion hinzufügen und den Namen der Konferenzschaltung festlegen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a conference call action and set its name
var conference = notifyAction.addConference();

conference.setName('Brown Bag: Week 3');

    NotifyAction – addConference.setRecord(Boolean record)

    Legt fest, ob die zugehörige Konferenzschaltung aufgezeichnet werden soll.

    Wenn Sie diese Methode nicht aufrufen, wird die Konferenzschaltung standardmäßig nicht aufgezeichnet.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    record Boolean Kennzeichnung, die angibt, ob die aktuelle Konferenzschaltung aufgezeichnet werden soll.
    • true: Aufzeichnung der Konferenz beginnen
    • false: Standard. Konferenzschaltung wird nicht aufgezeichnet. Die Aufzeichnung wird angehalten, wenn sie gerade aufgezeichnet wird.
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Konferenzaktion hinzufügen und die Konferenzschaltung dann aufzeichnen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a conference call action and set it to be recorded
var conference = notifyAction.addConference();
conference.setRecord(true);

    NotifyAction – addConference.setStartOnEnter(Boolean startOnEnter)

    Legt fest, ob die Konferenzschaltung beginnen soll, wenn der angegebene Anrufer der Konferenzschaltung beitritt.

    Wenn zwei oder mehr Anrufer anwesend sind, wird die Konferenzschaltung standardmäßig gestartet. Damit die Konferenzschaltung nur dann beginnt, wenn ein bestimmter Anrufer beitritt, müssen Sie diese Methode für jeden der anderen Anrufer aufrufen und den Wert auf „false“ festlegen. Auf diese Weise beginnt die Konferenzschaltung erst, wenn die gewünschte Person der Konferenzschaltung beitritt.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    startOnEnter Boolean Kennzeichnung, die angibt, ob die Konferenzschaltung beginnen soll, wenn der ausgewählte Anrufer der aktuellen Konferenzschaltung beitritt.
    • true: Standard. Starten Sie die Konferenzschaltung, wenn der angegebene Anrufer der Konferenzschaltung beitritt.
    • false: Starten der Telefonkonferenz, sobald sie hinzugefügt wurde
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Konferenzaktion hinzufügen und sie so festlegen, dass die Konferenzschaltung erst dann beginnt, wenn der angegebene Anrufer ihr beitritt.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a conference call action and set the caller that starts the meeting
var conference = notifyAction.addConference();

// retrieve the participant for which the conference call should start when they arrive
var notifyParticipantGr = new GlideRecord('notify_participant');
notifyParticipantGr.get('active participant sys id');
 
if (notifyParticipantGr.isValid) {
conference.setStartOnEnter(true);
}

    NotifyAction – addDial()

    Leitet einen Anruf an eine angegebene Telefonnummer oder Notify-Client weiter.

    Sobald die addDial-Aktion erstellt wurde, muss die zugehörige Telefonnummer (setPhoneNumber()) oder Notify-Client (setClientRecord()) auch festgelegt werden.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    DialAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird.

    Dieses Beispiel zeigt, wie Sie einen ausgehenden Anruf tätigen und den Anruf aufzeichnen.

    // Initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addDial() to connect to another party – this returns an object of type DialAction
var dialAction = notifyAction.addDial();
 
// Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
dialAction.setPhoneNumber('+919765xxxxxxx');
 
// Invoke setRecord(Boolean record) to record the call to this new number +919765xxxxxxx
dialAction.setRecord(true);

    NotifyAction – addDial.setCallerID(String callerID)

    Definiert die Anrufer-ID für den ausgehenden Anruf.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    callerID Zeichenfolge Für den ausgehenden Anruf festzulegender Anrufer-Identifier.
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen ausgehenden Anruf tätigen und eine Anruf-Zeitüberschreitung festlegen.

    // Initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addDial() to connect to another party – this returns an object of type DialAction
var dialAction = notifyAction.addDial();
 
// Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
dialAction.setPhoneNumber('+919765xxxxxxx');
 
// Set the caller ID
dialAction.setCallerID('Planning Conf Call');

    NotifyAction – addDial.setClientRecord(String tableName, String sysID)

    Legt den aktuellen Anrufer als Notify-Anrufer fest, indem die Tabelle angegeben wird, in der der Notify-Anrufer-Datensatz und der eindeutige Identifier des Anrufers zu finden sind.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    tableName Zeichenfolge Name der Tabelle, die die Informationen des gewünschten Anrufers enthält.
    sysID Zeichenfolge Eindeutiger Identifier (sys_id) des gewünschten Notify-Anrufers.
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie den aktuellen Anrufer mithilfe von setClientRecord() festlegen.

    // set up a dial action to forward the
// call to the specified client
var action = new SNC.NotifyAction();
var dial = action.addDial();
dial.setClientRecord(notifyClientRecord.getTableName(), notifyClientRecord.getUniqueValue());
dial.setTimeout(activity.vars.timeout);
dial.setRecord(activity.vars.record);

    NotifyAction – addDial.setDTMF(String value)

    Definiert die DTMF-Töne, die abgespielt werden sollen, wenn eine Verbindung hergestellt wird.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Wert Zeichenfolge Gültige DTMF-Ziffern, die abgespielt werden sollen, wenn die Verbindung hergestellt wird.
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie ein ausgehender Anruf getätigt wird, und definiert die DTMF-Töne, die abgespielt werden sollen, wenn der Anruf verbunden wird.

    // Initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addDial() to connect to another party - this returns an object of type DialAction
var dialAction = notifyAction.addDial();
 
// Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
dialAction.setPhoneNumber('+919765xxxxxxx');
 
// DTMF tones to play when call connects
dialAction.setDTMF("1246AF");

    NotifyAction – addDial.setHangupOnStar(Boolean hangupOnStar)

    Legt fest, ob der Anruf bei Drücken der Stern-Taste (*) beendet werden soll.

    Tabelle : 23. Parameter
    Name Typ Beschreibung
    hangupOnStar Boolean Kennzeichnung, die angibt ob der Anruf bei Drücken der Stern-Taste (*) beendet werden soll.
    • true: den Anruf beenden
    • false: den Anruf nicht beenden
    Tabelle : 24. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen ausgehenden Anruf tätigen und die Auflege-Taste mit „Stern“ festlegen.

    // Initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addDial() to connect to another party – this returns an object of type DialAction
var dialAction = notifyAction.addDial();
 
// Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
dialAction.setPhoneNumber('+919765xxxxxxx');
 
// End call by pressing star
dialAction.setHangupOnStar(true);

    NotifyAction – addDial.setPhoneNumber(String phoneNumber)

    Legt die anzurufende Telefonnummer fest.

    Tabelle : 25. Parameter
    Name Typ Beschreibung
    phoneNumber Zeichenfolge E.164-kompatible Telefonnummer, die angerufen werden soll.
    Tabelle : 26. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen ausgehenden Anruf tätigen und eine Anruf-Zeitüberschreitung festlegen.

    // Initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addDial() to connect to another party – this returns an object of type DialAction
var dialAction = notifyAction.addDial();
 
// Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
dialAction.setPhoneNumber('+919765xxxxxxx');

    NotifyAction – addDial.setRecord(Boolean record)

    Legt fest, ob der ausgehende Anruf aufgezeichnet werden soll.

    Tabelle : 27. Parameter
    Name Typ Beschreibung
    record Kennzeichnung, die angibt, ob der ausgehende Anruf aufgezeichnet werden soll.

    Gültige Werte:

    • true: den ausgehenden Anruf aufzeichnen
    • false: den ausgehenden Anruf nicht aufzeichnen
    Tabelle : 28. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen ausgehenden Anruf tätigen und den Anruf aufzeichnen.

    // Initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addDial() to connect to another party – this returns an object of type DialAction
var dialAction = notifyAction.addDial();
 
// Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
dialAction.setPhoneNumber('+919765xxxxxxx');
 
// Record the call
dialAction.setRecord(true);

    NotifyAction – addDial.setTimeout(Integer timeout)

    Legt fest, nach wie vielen Sekunden der ausgehende Anruf unterbrochen wird.

    Tabelle : 29. Parameter
    Name Typ Beschreibung
    timeout Ganzzahl Anzahl der Sekunden, nach denen der ausgehende Anruf unterbrochen wird. Standard: 30
    Tabelle : 30. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen ausgehenden Anruf tätigen und eine Anruf-Zeitüberschreitung festlegen.

    // Initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addDial() to connect to another party – this returns an object of type DialAction
var dialAction = notifyAction.addDial();
 
// Call setPhoneNumber(String phoneNumber)in DialAction.java to specify the phone number to dial
dialAction.setPhoneNumber('+919765xxxxxxx');
 
// Set the number of seconds to wait before timing out
dialAction.setTimeout(45);

    NotifyAction – addGather()

    Präsentiert dem Anrufer ein angegebenes interaktives Telefonmenü.

    Tabelle : 31. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 32. Ergebnisse
    Typ Beschreibung
    GatherAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das GatherAction-Objekt, um die Menüeinstellungen und Optionen zu definieren, die dem Benutzer angezeigt werden sollen. 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// present the user with a menu
var gather = notifyAction.addGather();
gather.setNumberOfDigits(1);    // the user can type 1 digit
gather.setFinishKey('#');       // # or *, useful for > 1 digit
gather.setTimeout(10);          // time to enter answer, in seconds

// add first menu item
var usSay = gather.addSay();
usSay.setText('Press 1 for english');
usSay.setLanguage('en-US');

// add second menu item
var nlSay = gather.addSay();
nlSay.setText('Kies 2 voor Nederlands');
nlSay.setLanguage('nl-NL');

// add third menu item
var frSay = gather.addSay();
frSay.setText('Choisissez 3 pour le français.');
frSay.setLanguage('fr-FR');

// and finish off with an applause
var play = gather.addPlay();
play.setURL('http://www.wavsource.com/snds_2015-04-12_5971820382841326/sfx/applause_y.wav');

    NotifyAction – addGather.addPlay()

    Spielt beim Anruf eine Audiodatei ab.

    Eine Beschreibung der unterstützten Nachfolge-Methoden finden Sie in der NotifyAction-addPlay()-Methode.

    Tabelle : 33. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 34. Ergebnisse
    Typ Beschreibung
    PlayAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das PlayAction-Objekt, um die Audiodatei-URL und die Anzahl der Schleifen des Audios zu definieren. 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// Create the gather action object
var gather = notifyAction.addGather();

// Play an audio file
var play = gather.addPlay();
play.setURL('http://www.wavsource.com/snds_2015-04-12_5971820382841326/sfx/applause_y.wav');

    NotifyAction – addGather.addSay()

    Definiert das im Anruf zu lesende Text-zu-Sprache.

    Eine Beschreibung der unterstützten Nachfolge-Methoden finden Sie in der NotifyAction-addSay()-Methode.

    Tabelle : 35. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 36. Ergebnisse
    Typ Beschreibung
    SayAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das SayAction-Objekt, um den zu lesenden Text und die zu lesende Sprache zu definieren. 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// present the user with a menu
var gather = notifyAction.addGather();
gather.setNumberOfDigits(1);    // the user can type 1 digit
gather.setTimeout(20);          // time to enter answer, in seconds

// add first menu item
var gatherSay = gather.addSay();
gatherSay.setText('Press 1 for english');
gatherSay.setLanguage('en-US');

    NotifyAction – addGather.setFinishKey(String finishKey)

    Definiert die Taste, die der Anrufer eingibt, um das Ende seiner Eingabe zu bezeichnen.

    Tabelle : 37. Parameter
    Name Typ Beschreibung
    beendenSchlüssel Zeichenfolge Taste, die das Ende der Anrufereingabe angibt.

    Gültige Werte:

    • 0–9
    • Nr. (Standard)
    • *
    Tabelle : 38. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Erfassungsaktion hinzufügen und die Taste festlegen, die das Ende der Anrufereingabe angibt.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

var gather = notifyAction.addGather();
gather.setNumberOfDigits(4);    // the user can type four digit
gather.setFinishKey('#');       // # or *, useful for > 1 digit

    NotifyAction – addGather.setNumberOfDigits(Integer numberOfDigits)

    Legt die Anzahl der zu erfassenden Ziffern fest.

    Tabelle : 39. Parameter
    Name Typ Beschreibung
    AnzahlStellen Ganzzahl Anzahl der zu erfassenden Ziffern. Null ist ein ungültiger Wert.
    Tabelle : 40. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Erfassungsaktion hinzufügen und die Anzahl der zu erfassenden Tastenanschläge festlegen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// present the user with a menu
var gather = notifyAction.addGather();
gather.setNumberOfDigits(4);    // the user can type four digit
gather.setFinishKey('#');       // # or *, useful for > 1 digits
gather.setTimeout(20);          // time to enter answer, in seconds

    NotifyAction – addGather.setTimeout(Integer timeout)

    Legt die Zeitdauer fest, nach der das Erfassen der Eingabe abläuft.

    Tabelle : 41. Parameter
    Name Typ Beschreibung
    timeout Ganzzahl Anzahl der Sekunden, die auf die Anrufereingabe gewartet wird, bevor das Zeitlimit überschritten wird. Standard: 10
    Tabelle : 42. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie eine Erfassungsaktion hinzufügen und den Eingabe-Zeitüberschreitungswert festlegen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// present the user with a menu
var gather = notifyAction.addGather();
gather.setNumberOfDigits(4);    // the user can type 1 digit
gather.setFinishKey('#');       // # or *, useful for > 1 digits
gather.setTimeout(20);          // time to enter answer, in seconds

    NotifyAction – addHangUp()

    Beendet ein aktives Telefonat.

    Tabelle : 43. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 44. Ergebnisse
    Typ Beschreibung
    HangUpAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// hang up
notifyAction.addHangUp();

    NotifyAction – addQueue()

    Der Anruf wird in eine Warteschlange gestellt, wodurch der Anruf auf „Halten“ gestellt wird.

    Tabelle : 45. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 46. Ergebnisse
    Typ Beschreibung
    QueueAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das QueueAction-Objekt, um den Namen der Warteschlange sowie das Verhalten beim Einreihen in die Warteschlange oder dem Ausgehen aus der Warteschlange zu definieren.

    Dieses Beispiel zeigt, wie der Anruf zur angegebenen Warteschlange hinzugefügt wird.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// queue the call
var queue = notifyAction.addQueue();
queue.setName('my queue');

    Dieses Beispiel zeigt, wie der Anruf aus der Warteschlange entfernt wird.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// dequeue the call
var queue = notifyAction.addQueue();
queue.setDequeue(true);

    NotifyAction – addQueue.setDequeue(Boolean dequeue)

    Entfernt den Anruf aus der aktuellen Warteschlange (beendet das „Halten“).

    Tabelle : 47. Parameter
    Name Typ Beschreibung
    aus der Warteschlange entfernen Boolean Kennzeichnung, die angibt, ob der aktuelle Anruf aus der Warteschlange entfernt werden soll.
    • true: Den Anruf aus der Warteschlange entfernen
    • false: Anruf wird in die Warteschlange gestellt
    Tabelle : 48. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie der Anruf aus der Warteschlange entfernt wird.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// dequeue the call
var queue = notifyAction.addQueue();
queue.setDequeue(true);

    NotifyAction – addQueue.setName(String name)

    Definiert den Namen, der einer Warteschlange zugeordnet ist.

    Tabelle : 49. Parameter
    Name Typ Beschreibung
    Name Zeichenfolge Name, der der Warteschlange zugeordnet werden soll.
    Tabelle : 50. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie der Name einer Warteschlange festgelegt wird.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// queue the call
var queue = notifyAction.addQueue();
queue.setName('my queue');

    NotifyAction – addPlay()

    Spielt beim Anruf eine Audiodatei ab.

    Tabelle : 51. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 52. Ergebnisse
    Typ Beschreibung
    PlayAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das PlayAction-Objekt, um die Audiodatei-URL und die Anzahl der Schleifen des Audios zu definieren. 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a play action
var play = notifyAction.addPlay();
play.setURL('http://www.moviesounds.com/2001/imsorry.wav');
play.setLoop(1);

    NotifyAction – addPlay.setLoop(Integer loop)

    Legt fest, wie oft die Audiodatei abgespielt wird (in Schleifen).

    Tabelle : 53. Parameter
    Name Typ Beschreibung
    Schleife Ganzzahl Anzahl der Wiedergaben der Audiodatei.
    Tabelle : 54. Ergebnisse
    Typ Beschreibung
    void 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a play action
var play = notifyAction.addPlay();
play.setURL('http://www.moviesounds.com/2001/imsorry.wav');
play.setLoop(2);

    NotifyAction – addPlay.setURL(String url)

    Definiert die URL, unter der die abzuspielende Audiodatei abgerufen werden soll.

    Tabelle : 55. Parameter
    Name Typ Beschreibung
    URL Zeichenfolge URL der wiederzugebenden Audiodatei.
    Tabelle : 56. Ergebnisse
    Typ Beschreibung
    void 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a play action
var play = notifyAction.addPlay();
play.setURL('http://www.moviesounds.com/2001/imsorry.wav');
play.setLoop(1);

    NotifyAction – addRecord()

    Fügt eine Aktion hinzu, um den Anruf auf dem aktuellen NotifyAction-Objekt aufzuzeichnen.

    Die Aufzeichnung wird automatisch beendet, wenn der Anruf abgeschlossen ist oder eine angegebene Beenden-Taste gedrückt wird (setFinishKey()). Die Aufnahme wird dann in die notify_record-Tabelle für den zugehörigen Anruf aufgenommen.

    Tabelle : 57. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 58. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie ein Anruf aufgezeichnet wird.

    // First we initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Call addRecord() of NotifyAction – This returns an object of type RecordAction
var recordAction = notifyAction.addRecord();
 
// Optional. Define the key that callers use to stop the recording
recordAction.setFinishKey('#'); // Stop the call recording when caller presses the '#' key.

    NotifyAction – addRecord.setFinishKey(String finishKey)

    Definiert die Taste, mit der die Aufzeichnung beendet wird.

    Tabelle : 59. Parameter
    Name Typ Beschreibung
    beendenSchlüssel Zeichenfolge Taste, die die Aufzeichnung beendet.

    Gültige Werte:

    • 0–9
    • Nr. (Standard)
    • *
    Tabelle : 60. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen Anruf aufzeichnen und die Anrufbeendigungstaste festlegen.

    // First we initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Then we call addRecord() of NotifyAction 
var recordAction = notifyAction.addRecord();
 
// Set the key that terminates the recording
recordAction.setFinishKey('#'); // This means that we stop the call recording when user presses the '#' key.

    NotifyAction – addRecord.setMaxDuration(Integer seconds)

    Legt die maximale Dauer der Aufzeichnung fest.

    Tabelle : 61. Parameter
    Name Typ Beschreibung
    seconds Ganzzahl Maximale Länge der Aufzeichnung in Sekunden. Standard: 3600
    Tabelle : 62. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen Anruf aufzeichnen und die Anrufbeendigungstaste festlegen.

    // First we initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Then we call addRecord() of NotifyAction 
var recordAction = notifyAction.addRecord();
 
// Set the maximum length of the recording
recordAction.setMaxDuration(4800);

    NotifyAction – addRecord.setTimeout(Integer timeout)

    Legt die Anzahl der Sekunden ohne Aktivität fest, nach denen die Aufzeichnung endet.

    Tabelle : 63. Parameter
    Name Typ Beschreibung
    timeout Ganzzahl Anzahl der Sekunden ohne Aktivität in dem Anruf, nach denen die Aufzeichnung endet. Standard: 10
    Tabelle : 64. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie einen Anruf aufzeichnen und den Zeitüberschreitungswert für die Aufzeichnung festlegen.

    // First we initialize NotifyAction
var notifyAction = new SNC.NotifyAction();
 
// Then we call addRecord() of NotifyAction 
var recordAction = notifyAction.addRecord();
 
// Set the recoding timeout value
recordAction.setTimeout(360);

    NotifyAction – addReject()

    Lehnt einen eingehenden Anruf ab.

    Tabelle : 65. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 66. Ergebnisse
    Typ Beschreibung
    RejectAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das RejectAction-Objekt, um den Grund für die Ablehnung des Anrufs zu definieren. 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// reject the call
var rejectAction = notifyAction.addReject();
rejectAction.setReason('busy'); // 'busy' or 'rejected'

    NotifyActon – addReject.setReason(String reason)

    Definiert den Grund für die Ablehnung des Anrufs.

    Tabelle : 67. Parameter
    Name Typ Beschreibung
    reason Zeichenfolge Grund für die Ablehnung des Anrufs.

    Gültige Werte:

    • Belegt
    • abgelehnt
    Alle anderen Werte werden ignoriert.
    Tabelle : 68. Ergebnisse
    Typ Beschreibung
    void 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// reject the call
var rejectAction = notifyAction.addReject();
rejectAction.setReason('busy'); // 'busy' or 'rejected'

    NotifyAction – addSay()

    Definiert das im Anruf zu lesende Text-zu-Sprache.

    Bei der Sprachausgabe werden mehrere Sprachen unterstützt. Die verfügbaren Sprachen hängen vom Telefonanbieter ab.

    Tabelle : 69. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 70. Ergebnisse
    Typ Beschreibung
    SayAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das SayAction-Objekt, um den zu lesenden Text und die zu lesende Sprache zu definieren.

    Dieses Beispiel zeigt das Lesen von Text in mehreren Sprachen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a say action to say something in US English
var usSay = notifyAction.addSay();
usSay.setText('Welcome. I can speak english');
usSay.setLanguage('en-US');

// add a say action to say something in Dutch
var nlSay = notifyAction.addSay();
nlSay.setText('Ik spreek ook vloeiend nederlands');
nlSay.setLanguage('nl-NL');

// and german
var deSay = notifyAction.addSay();
deSay.setText('Und ich kan auch deutsch sprechen');
deSay.setLanguage('de-DE');

    NotifyAction – addSay.setLanguage(String language)

    Definiert die Sprache, in der der Text gesprochen werden soll.

    Verwenden Sie diese Methode in Verbindung mit der setText()-Methode zum Festlegen der zu sprechenden Sprache.

    Tabelle : 71. Parameter
    Name Typ Beschreibung
    language Zeichenfolge ISO 3166-Sprachcode, der die Sprache festlegt, in der der zugehörige Text gesprochen werden soll. Zum Beispiel „en-US“ oder „nl-NL“.
    Tabelle : 72. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt das Lesen von Text in mehreren Sprachen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a say action to say something in US English
var usSay = notifyAction.addSay();
usSay.setText('Welcome. I can speak english');
usSay.setLanguage('en-US');

// add a say action to say something in Dutch
var nlSay = notifyAction.addSay();
nlSay.setText('Ik spreek ook vloeiend nederlands');
nlSay.setLanguage('nl-NL');

// and german
var deSay = notifyAction.addSay();
deSay.setText('Und ich kan auch deutsch sprechen');
deSay.setLanguage('de-DE');

    NotifyAction – addSay.setText(String text)

    Legt den Text fest, der innerhalb des aktuellen Anrufs gelesen werden soll.

    Verwenden Sie diese Methode in Verbindung mit der setLanguage()-Methode zum Festlegen der Sprache, in der der bereitgestellte Text gesprochen werden soll.

    Tabelle : 73. Parameter
    Name Typ Beschreibung
    text Zeichenfolge Text, der innerhalb des aktuellen Anrufs laut vorgelesen werden soll.
    Tabelle : 74. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt das Lesen von Text in mehreren Sprachen.

    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// add a say action to say something in US English
var usSay = notifyAction.addSay();
usSay.setText('Welcome. I can speak english');
usSay.setLanguage('en-US');

// add a say action to say something in Dutch
var nlSay = notifyAction.addSay();
nlSay.setText('Ik spreek ook vloeiend nederlands');
nlSay.setLanguage('nl-NL');

// and german
var deSay = notifyAction.addSay();
deSay.setText('Und ich kan auch deutsch sprechen');
deSay.setLanguage('de-DE');

    NotifyAction – addSMS()

    Sendet eine SMS-Nachricht.

    Hinweis:
    Wenn Sie diese Funktion bei einem aktiven Anruf verwenden, müssen Sie nicht die setTo-Funktion für das ausgegebene SMSAction-Objekt aufrufen. Die SMS wird automatisch an den Anrufer gesendet.
    Tabelle : 75. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 76. Ergebnisse
    Typ Beschreibung
    SMSAction Aktion, die dem NotifyAction-Objekt hinzugefügt wird. Verwenden Sie das SMSAction-Objekt, um den Nachrichtentext und die Telefonnummer zu definieren, an die die Nachricht gesendet werden soll. 
    // Instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// Define where to send the SMS to
var number = new GlideElementPhoneNumber();
number.setPhoneNumber('+31612345678', true);

// Add an SMS action
var sms = notifyAction.addSMS();
sms.setMessage('Lorem ipsum dolor sit amet, consectetur adipiscing elit.');
sms.setTo(number);

    NotifyAction – addSMS.setMessage(String message)

    Legt den Text der zu sendenden SMS-Nachricht fest.

    Tabelle : 77. Parameter
    Name Typ Beschreibung
    Nachricht Zeichenfolge Text der zu sendenden SMS-Nachricht.
    Tabelle : 78. Ergebnisse
    Typ Beschreibung
    void 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// define where to send the sms to
var number = new GlideElementPhoneNumber();
number.setPhoneNumber('+31612345678', true);

// add a SMS action
var sms = notifyAction.addSMS();
sms.setMessage('Lorem ipsum dolor sit amet, consectetur adipiscing elit.');
sms.setTo(number);

    NotifyAction – addSMS.setTo(String to)

    Legt die Telefonnummer fest, an die die SMS-Nachricht gesendet werden soll.

    Tabelle : 79. Parameter
    Name Typ Beschreibung
    to Zeichenfolge E.164-konforme Telefonnummer, an die die SMS-Nachricht gesendet werden soll.
    Tabelle : 80. Ergebnisse
    Typ Beschreibung
    void 
    // instantiate NotifyAction
var notifyAction = new SNC.NotifyAction();

// define where to send the sms to
var number = new GlideElementPhoneNumber();
number.setPhoneNumber('+31612345678', true);

// add a SMS action
var sms = notifyAction.addSMS();
sms.setMessage('Lorem ipsum dolor sit amet, consectetur adipiscing elit.');
sms.setTo(number);

    NotifyAction – append(NotifyAction action)

    Hängt das angegebene NotifyAction-Objekt an das NotifyAction-Objekt des aktuellen Client an.

    Es gibt zwei Arten von NotifyActions: Terminale und nicht-terminale. Wenn Sie eine Terminal-Aktion an das NotifyAction-Objekt eines Client anhängen, können Sie keine weiteren Aktionen anhängen. Nicht-terminale Aktionen umfassen:
    • PlayAction
    • RecordAction
    • SayAction
    • SMSAction

    Alle anderen NotifyActions sind terminal. Wenn Sie versuchen, nach einer Terminal-Aktion eine weitere NotifyAction hinzuzufügen, schlägt der Aufruf fehl.

    Tabelle : 81. Parameter
    Name Typ Beschreibung
    Aktion NotifyAction NotifyAction-Objekt, das an das NotifyAction-Objekt des aktuellen Anrufers angehängt werden soll.
    Tabelle : 82. Ergebnisse
    Typ Beschreibung
    void

    NotifyAction – fromJson(String json)

    Deserialisieren eines NotifyAction-Objekts eins JSON-Strings.

    Tabelle : 83. Parameter
    Name Typ Beschreibung
    json Zeichenfolge Eine JSON-Zeichenfolgendarstellung von einem NotifyAction-Objekt.
    Tabelle : 84. Ausgabe
    Typ Beschreibung
    Leer

    In diesem Beispiel wird die Deserialisierung eines NotifyAction-Objekts veranschaulicht.

    var json = ".... some json obtained from toJson ....";

// instantiate notify action
var notifyAction = new SNC.NotifyAction();

// deserialize and reconstruct the notify action instance
notifyAction.fromJson(json);

    Dieses Beispiel zeigt, wie ein NotifyAction-Objekt serialisiert und deserialisiert wird.

    // instantiate notify action
var notifyAction = new SNC.NotifyAction();

// add a queue
var queue = notifyAction.addQueue();
queue.setName('myQueueName');
queue.setDequeue(false);

// serialize to json
var json = notifyAction.toJson();
gs.log('serialization result: ' + json);

// instantiate a new notify action
var newAction = new SNC.NotifyAction();

// deserialize the json generated above
newAction.fromJson(json);

// serialize the new object and log the result
newJson = newAction.toJson();
gs.log('new serialization result: ' + newJson);
gs.log('the same: ' + (json == newJson));

    Ausgabe: *** Script: serialization result: {"fClassName":"NotifyAction","fActions":[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}]} *** Script: new serialization result: {"fClassName":"NotifyAction","fActions":[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}]} *** Script: the same: true

    NotifyAction – setCallRecord(GlideRecord callRecord)

    Legt den Notify-Call-Datensatz, in dem nachfolgende Aktionen hinzugefügt werden, fest.

    Tabelle : 85. Parameter
    Name Typ Beschreibung
    callRecord GlideRecord GlideRecord, der den Datensatz des Anrufers (innerhalb der notify_call-Tabelle) enthält, für den Aktionen hinzugefügt werden sollen. Dieser Anrufer bleibt solange aktiv, bis diese Methode erneut mit einem anderen Anrufer aufgerufen wird.
    Tabelle : 86. Ergebnisse
    Typ Beschreibung
    void

    Dieses Beispiel zeigt, wie Sie den Anrufer festlegen, zu dem Sie Aktionen hinzufügen möchten.

    public NotifyAction runIncomingCallWorkflow(NotifyPhoneNumber notifyPhoneNumber, GlideRecord callRecord) throws NoWorkflowConfiguredException, NoSuchNotifyGroupRecordException {
   NotifyAction notifyAction = runWorkflow(notifyPhoneNumber, COL_INCOMING_CALL_WF, callRecord);
   notifyAction.setCallRecord(callRecord);
   return notifyAction;
}

    NotifyAction – toJson()

    Serialisieren Sie das NotifyAction-Objekt in eine JSON-Zeichenfolge.

    Tabelle : 87. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 88. Ergebnisse
    Typ Beschreibung
    Zeichenfolge JSON-Darstellung dieses NotifyAction-Objekts.

    Dieses Beispiel zeigt die Serialisierung eines NotifyAction-Objekts.

    // instantiate notify action
var notifyAction = new SNC.NotifyAction();

// add one or more notify actions
// ...

// and serialize to json
var json = notifyAction.toJson();

    Dieses Beispiel zeigt, wie ein NotifyAction-Objekt serialisiert und deserialisiert wird.

    // instantiate notify action
var notifyAction = new SNC.NotifyAction();

// add a queue
var queue = notifyAction.addQueue();
queue.setName('myQueueName');
queue.setDequeue(false);

// serialize to json
var json = notifyAction.toJson();
gs.log('serialization result: ' + json);

// instantiate a new notify action
var newAction = new SNC.NotifyAction();

// deserialize the json generated above
newAction.fromJson(json);

// serialize the new object and log the result
newJson = newAction.toJson();
gs.log('new serialization result: ' + newJson);
gs.log('the same: ' + (json == newJson));

    Ausgabe: *** Script: serialization result: {"fClassName":"NotifyAction","fActions":[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}]} *** Script: new serialization result: {"fClassName":"NotifyAction","fActions":[{"fClassName":"QueueAction","fDequeue":true,"fQueueName":"myQueueName"}]} *** Script: the same: true