NotifyConferenceUtil: Bereichsbezogen, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 16 Minuten Lesedauer

    • Die NotifyConferenceUtil Die API bietet Methoden zum Verwalten von Notify-Telefonkonferenzen und SMS-Nachrichten für verschiedene Telefondienstanbieter, z. B. Zoom Und Webex.

    Mit NotifyConferenceUtil API Sie können:

    • Erstellen Sie neue Telefonkonferenzen
    • Fügen Sie Teilnehmer nach Telefonnummer oder Anwender-ID hinzu
    • Entfernen Sie Teilnehmer aus einer Telefonkonferenz
    • Schalten Sie Teilnehmer in einer Telefonkonferenz stummschalten
    • Heben Sie die Stummschaltung von Teilnehmern in einer Telefonkonferenz auf
    • Ruft die Fähigkeiten eines angegebenen Service Providers ab
    • Telefonkonferenz beenden

    Sie können diese API sowohl in bereichsbezogenen als auch globalen Skripts verwenden. Zur Verwendung dieser API müssen Sie das Conference Notify-Plugin (com.snc.notify) aktivieren, das ein separates Abonnement erfordert. Weitere Informationen zum Aktivieren dieses Plugins finden Sie unter Aktivieren Sie Notify .

    NotifyConferenceUtils: NotifyConferenceUtils()

    Instanziiert ein NotifyConferenceUtils-Objekt (Konstruktor).

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Keine 
    function () {
	var confGR = new GlideRecord('notify_conference_call');
	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

	var confUtils = new NotifyConferenceUtils();
	var actionResult = confUtils.addToConferenceByPhoneNumber("+917799555331", confGR)
	if (actionResult.status)
		gs.info('Participant has been added to conference');
	else {
		gs.info('join operation failed');
		actionResult.warnMessages.forEach(function (msg) {
			gs.info(msg);
		});
		actionResult.errorMessages.forEach(function (msg) {
			gs.info(msg);
		})
	}
})();

    NotifyConferenceUtils – addToConferenceByPhoneNumber(Zeichenfolge zu Nummer, GlideRecord confGR)

    Fügt einer angegebenen Telefonkonferenz einen Teilnehmer mithilfe seiner Telefonnummer hinzu, um den Teilnehmer zu identifizieren.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Bis Nummer Zeichenfolge Telefonnummer des Teilnehmers, der der Telefonkonferenz hinzugefügt werden soll.
    Konfr GlideRecord GlideRecord der Telefonkonferenz, der der angegebene Teilnehmer hinzugefügt werden soll.

    Tabelle: Notify-Telefonkonferenz [Notify_Conference_call]
    Tabelle : 3. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisse der Konferenzaktion.

    <action>.Status : Status der Konferenzaktion.

    • Datentyp: Boolesch
    • Mögliche Werte:
      • Wahr: Konferenzaktion erfolgreich
      • Falsch: Konferenzaktion fehlgeschlagen

    <action>.Erfolgsnachrichten : Wenn Status Ist „wahr“, Erfolgsmeldung(en), andernfalls leer.

    • Datentyp: Array von Zeichenfolgen

    <action>.Warnmeldungen : Wenn Status Ist „falsch“, alle während der Verarbeitung ausgelösten Warnmeldungen.

    • Datentyp: Array von Zeichenfolgen

    <action>.Fehlernachrichten : Wenn Status Ist „falsch“, alle Fehlermeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    function () {
	var confGR = new GlideRecord('notify_conference_call');
	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

	var confUtils = new NotifyConferenceUtils();
	var actionResult = confUtils.addToConferenceByPhoneNumber("+917799555331", confGR)
	if (actionResult.status)
		gs.info('Participant has been added to conference');
	else {
		gs.info('join operation failed');
		actionResult.warnMessages.forEach(function (msg) {
			gs.info(msg);
		});
		actionResult.errorMessages.forEach(function (msg) {
			gs.info(msg);
		})
	}
})();

    NotifyConferenceUtils – addToConferenceByUserId(String userid, GlideRecord confGR)

    Fügt der Telefonkonferenz, auf die in GlideRecord verwiesen wird, mithilfe ihres eindeutigen Anwenderbezeichners einen Teilnehmer hinzu.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    userId Zeichenfolge SYS-ID des Teilnehmers, der der angegebenen Telefonkonferenz hinzugefügt werden soll.

    Tabelle: Benutzer [sys_user]
    Konfr GlideRecord GlideRecord der Telefonkonferenz zum Hinzufügen des angegebenen Teilnehmers.

    Tabelle: Notify-Telefonkonferenz [Notify_Conference_call]
    Tabelle : 5. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisse der Konferenzaktion.

    <action>.Status : Status der Konferenzaktion.

    • Datentyp: Boolesch
    • Mögliche Werte:
      • Wahr: Konferenzaktion erfolgreich
      • Falsch: Konferenzaktion fehlgeschlagen

    <action>.Erfolgsnachrichten : Wenn Status Ist „wahr“, Erfolgsmeldung(en), andernfalls leer.

    • Datentyp: Array von Zeichenfolgen

    <action>.Warnmeldungen : Wenn Status Ist „falsch“, alle während der Verarbeitung ausgelösten Warnmeldungen.

    • Datentyp: Array von Zeichenfolgen

    <action>.Fehlernachrichten : Wenn Status Ist „falsch“, alle Fehlermeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    (function () {
	var confGR = new GlideRecord('notify_conference_call');
	confGR.get('76d3364d0b5133008e64aabcb4673a6d');

	var confUtils = new NotifyConferenceUtils();
	var actionResult = confUtils.addToConferenceByUserId(gs.getUserID(), confGR)
	if (actionResult.status)
		gs.info('Participant has been added to conference');
	else {
		gs.info('join operation failed');
		actionResult.warnMessages.forEach(function (msg) {
			gs.info(msg);
		});
		actionResult.errorMessages.forEach(function (msg) {
			gs.info(msg);
		})
	}
})();

    NotifyConferenceUtils – doConferenceAction(Zeichenfolgenaktion, Objektdaten)

    Führt die angegebene Telefonkonferenz-Aktion aus, z. B. Starten/Beenden einer Telefonkonferenz oder Beitritt, Entfernen, Stummschalten oder Aufheben der Stummschaltung von Teilnehmern aus einer Telefonkonferenz.

    Sie können eine neue Telefonkonferenz starten und Teilnehmer innerhalb eines einzigen Anrufs zu dieser Methode hinzufügen oder die Methode mehrmals aufrufen, um den Anruf zu starten und die Teilnehmer dann separat zu verwalten. Darüber hinaus können Sie die Methode über das übergebene Datenobjekt konfigurieren, um:
    • Speichern Zeiger Im Telefonkonferenzdatensatz auf den spezifischen Datensatz (Quelldatensatz), z. B. einen Incident oder ein Problem, der das Diskussionsthema für die Telefonkonferenz ist.
    • Mehrere Telefonkonferenzen für einen Quelldatensatz zulassen/nicht zulassen.
    • Protokollieren Sie die Teilnehmer, die sich in der Telefonkonferenz befanden, automatisch im Feld „Arbeitsnotizen“ des Quelldatensatzes.
    • Lassen Sie eine Nachricht laut vorlesen, wenn ein Teilnehmer einen ausgehenden Anruf aus der Konferenz beantwortet.
    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Aktion Zeichenfolge Definiert die auszuführende Telefonkonferenz-Aktion.
    Im Folgenden sind die verfügbaren Telefonkonferenzaktionen aufgeführt:
    • Ende: Beendet die in identifizierte Telefonkonferenz data.confId.
    • Beitreten: Fügt den in angegebenen Teilnehmer hinzu data.itemsArray für die in identifizierte Telefonkonferenz data.confId.
    • Kick: Entfernt den in angegebenen Teilnehmer data.itemsArray aus der in identifizierten Telefonkonferenz data.confId.
    • MultiJoin: Fügt die in angegebenen Teilnehmer hinzu data.itemsArray für die in identifizierte Telefonkonferenz data.confId
    • MultiKick: Entfernt die in angegebenen Teilnehmer data.itemsArray aus der in identifizierten Telefonkonferenz data.confId.
    • Multistummschaltung: Schaltet die in angegebenen Teilnehmer stumm data.itemsArray in der in identifizierten Telefonkonferenz data.confId.
    • Mehrfache Stummschaltung: Hebt die Stummschaltung der in angegebenen Teilnehmer auf data.itemsArray aus der in identifizierten Telefonkonferenz data.confId.
    • Stummschalten: Schaltet den in angegebenen Teilnehmer stumm data.itemsArray in der in identifizierten Telefonkonferenz data.confId.
    • SelfJoin: Fügt der Telefonkonferenz den derzeit angemeldeten Anwender hinzu (kein Eintrag in data.itemsErforderlich.)
    • Start: Startet die in identifizierte Telefonkonferenz data.confId.
    • Stummschaltung aufheben: Hebt die Stummschaltung des in angegebenen Teilnehmers auf data.itemsArray aus der in identifizierten Telefonkonferenz data.confId.
    Daten Objekt Objekt, das die Telefonkonferenz beschreibt.
    Data.addToArbeitsnotizen Boolean Kennzeichnung, die angibt, ob im Feld Arbeitsnotizen des zugehörigen Datensatzes Informationen zu den Teilnehmern hinzugefügt werden sollen, die in der Telefonkonferenz enthalten waren.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in angeben data.tableUnd data.sysIdParameter. Diese Parameter identifizieren den Datensatz, in dem die Arbeitsnotizen hinzugefügt werden sollen.

    Standardwert: false

    Aktionen, für die dieser Parameter gültig ist:

    • teilnehmen
    • MultiJoin
    • SelfJoin
    • Start
    Data.allowMultiConference Boolean Kennzeichnung, die angibt, ob mehrere Telefonkonferenzen für einen bestimmten Datensatz gleichzeitig zugelassen werden sollen.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in angeben data.tableUnd data.sysIdParameter. Diese Parameter identifizieren den Datensatz, der mehrere Telefonkonferenzen haben darf.

    Standardwert: false

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    Daten.Konfid Zeichenfolge SYS_ID der Telefonkonferenz.

    Tabelle: Notify-Telefonkonferenz [Notify_Conference_call]

    Aktionen, für die dieser Parameter erforderlich ist:

    • Ende
    • teilnehmen
    • MultiJoin
    • SelfJoin
    Hinweis:
    Für Teilnehmeraktionen wie Stummschaltung, Stummschaltung aufheben und Kick muss dieser Parameter nicht festgelegt werden, da die Methode diese Informationen aus der Tabelle Notify-Konferenzanruf-Teilnehmer [Notify_participant] abruft.
    data.fromNumber Zeichenfolge Nummer des Service Providers, der für die Telefonkonferenz angerufen werden soll.

    Suchen Sie diesen Wert in der Spalte Nummer oder Telefonnummer der Tabelle Notify Phone Number [Notify_number].

    Aktionen, für die dieser Parameter erforderlich ist:

    • Start
    Data.isNeuKonferenz Boolean Kennzeichnung, die angibt, ob es sich um eine neue oder eine vorhandene Telefonkonferenz handelt.

    Gültige Werte:

    • Wahr: Neue Telefonkonferenz
    • Falsch: Vorhandene Telefonkonferenz

    Standardwert: false

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    data.items Array Informationen, die jeder Teilnehmer in die Telefonkonferenz aufnehmen soll.

    Gültige Array-Werte:

    • id: SYS_ID des Anwenders; befindet sich in der Anwendertabelle [sys_User].

      Gültige Aktionen: Join, MultiJoin, Start

    • NotifyParticipantId: SYS-ID des Notify-Teilnehmers; befindet sich in der Notify-Teilnehmer-Tabelle [Notify_participant].

      Gültige Aktionen: Beitreten, Kick, MultiJoin, Stummschaltung, Start, Stummschaltung aufheben

    • Telefonnummer: Telefonnummer des Teilnehmers. Ob dieser Wert in Verbindung mit übergeben wird idOder notifyParticipantId, Dieser Wert ersetzt die Telefonnummern im Anwender-/Teilnehmerdatensatz und wird zum Tätigen des Anrufs verwendet.

      Gültige Aktionen: Join, MultiJoin, Start

    • E-Mail: E-Mail-Adresse des Teilnehmers.

      Gültige Aktionen: Join, MultiJoin, Start
    Daten.Nachricht Zeichenfolge Nachricht, die laut vorgelesen wird, wenn ein Anwender den Anruf beantwortet, z. B. „P1-Incident wurde erstellt, melden Sie sich bei der Instanz an.“

    Aktionen, für die dieser Parameter gültig ist:

    • teilnehmen
    • MultiJoin
    • Start
    data.serviceProvider Zeichenfolge Erforderlich. Name des Konferenzservice Providers, z. B. Zoom oder Webex.

    Aktionen, für die dieser Parameter erforderlich ist:

    • alle
    Daten.sysId Zeichenfolge SYS_ID des Quelldatensatzes, der der Telefonkonferenz zugeordnet werden soll.

    Wenn beispielsweise eine Telefonkonferenz gehalten wird, um einen bestimmten Incident oder ein bestimmtes Problem zu besprechen, geben Sie die sys_ID des Incident- oder Problemdatensatzes in diesen Wert ein. Diese sys_ID wird in der Spalte „Quelle“ der Tabelle „NotifyConference-Anruf“ [Notify_Conference_call] gespeichert und kann später nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit verwendet data.Table, data.addToWorkNotes, Und allowMulticonferenceParameter.

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    Daten.Tabelle Zeichenfolge Tabelle, die den Quelldatensatz enthält, der der Telefonkonferenz zugeordnet werden soll. Ein Quelldatensatz kann ein beliebiger Datensatz sein, z. B. ein „Incident“ oder „Problem“, der das Diskussionsthema in der Telefonkonferenz ist.

    Dieser Tabellenname wird in der Tabellenspalte der Tabelle NotifyConference Call [Notify_Conference_call] gespeichert und kann nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit verwendet data.sysId, data.addToWorkNotes, Und allowMulticonferenceParameter.

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    Tabelle : 7. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisse der Konferenzaktion.

    <action>.Status : Status der Konferenzaktion.

    • Datentyp: Boolesch
    • Mögliche Werte:
      • Wahr: Konferenzaktion erfolgreich
      • Falsch: Konferenzaktion fehlgeschlagen

    <action>.Erfolgsnachrichten : Wenn Status Ist „wahr“, Erfolgsmeldung(en), andernfalls leer.

    • Datentyp: Array von Zeichenfolgen

    <action>.Warnmeldungen : Wenn Status Ist „falsch“, alle während der Verarbeitung ausgelösten Warnmeldungen.

    • Datentyp: Array von Zeichenfolgen

    <action>.Fehlernachrichten : Wenn Status Ist „falsch“, alle Fehlermeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen
    		 
    (function (confId) {
	var confUtils = new NotifyConferenceUtils();
	var data = confUtils.getConferenceInputDataTemplate();
	data.table = 'incident';
	data.sysId = '1234';
	data.addToWorkNotes = false;
	data.confId = confId;
	data.message = 'p1 incident has been created';
	data.fromNumber = 'twilio/Telephony driver number';
	data.items.push({ id: 'user3SysId', phoneNumber: '+917799555332' });
	data.items.push({ id: 'user4SysId', email: 'yln99518@gmail.com' });

	var result = confUtils.doConferenceAction('start', data);
	if (result.status) {
		gs.info('Start conference action succeeded');
	} else
		gs.info('Start conference action failed');

	result.errorMessages.forEach(function (msg) {
		gs.info(msg);
	});
	result.warnMessages.forEach(function (msg) {
		gs.info(msg);
	});
	result.successMessages.forEach(function (msg) {
		gs.info(msg);
	});
})('activeConfSysId');

    NotifyConferenceUtils – getConferenceInputDataTemplate()

    Gibt eine JSON-Datenvorlage zurück, die mit verwendet werden soll DoConferenceAction() Methode. Wenn Sie diese Vorlage verwenden, wird das Datenobjekt automatisch so strukturiert, dass Sie es nicht manuell erstellen müssen.

    Rufen Sie diese Methode auf, bevor Sie aufrufen DoConferenceAction() Methode. Legen Sie für die gewünschte Telefonkonferenz-Aktion die gewünschten Parameter in der Vorlage fest, und übergeben Sie die Vorlage dann in DoConferenceAction() Rufen Sie an. Weitere Informationen zu den gültigen Parametern für jede Aktion finden Sie unter DoConferenceAction() .

    Hinweis:
    Dies ist eine Hilfsmethode. Sie können dieses Objekt auch manuell erstellen und an übergeben DoConferenceAction() Methode und haben das gleiche Ergebnis.
    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    Daten Objekt, das die Telefonkonferenz beschreibt.
    Data.addToArbeitsnotizen Kennzeichnung, die angibt, ob im Feld Arbeitsnotizen des zugehörigen Datensatzes Informationen zu den Teilnehmern hinzugefügt werden sollen, die in der Telefonkonferenz enthalten waren.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in angeben data.tableUnd data.sysIdParameter. Diese Parameter identifizieren den Datensatz, in dem die Arbeitsnotizen hinzugefügt werden sollen.

    Standardwert: false

    Aktionen, für die dieser Parameter gültig ist:

    • teilnehmen
    • MultiJoin
    • SelfJoin
    • Start
    Data.allowMultConference Kennzeichnung, die angibt, ob mehrere Telefonkonferenzen für einen bestimmten Datensatz gleichzeitig zugelassen werden sollen.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in angeben data.tableUnd data.sysIdParameter. Diese Parameter identifizieren den Datensatz, der mehrere Telefonkonferenzen haben darf.

    Standardwert: false

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    Daten.Konfid SYS_ID der Telefonkonferenz.

    Tabelle: Notify-Telefonkonferenz [Notify_Conference_call]

    Aktionen, für die dieser Parameter erforderlich ist:

    • Ende
    • teilnehmen
    • MultiJoin
    • SelfJoin
    Hinweis:
    Für Teilnehmeraktionen wie Stummschaltung, Stummschaltung aufheben und Kick muss dieser Parameter nicht festgelegt werden, da die Methode diese Informationen aus der Tabelle Notify-Konferenzanruf-Teilnehmer [Notify_participant] abruft.
    data.fromNumber Nummer des Service Providers, der für die Telefonkonferenz angerufen werden soll.

    Suchen Sie diesen Wert in der Spalte Nummer oder Telefonnummer der Tabelle Notify Phone Number [Notify_number].

    Aktionen, für die dieser Parameter erforderlich ist:

    • Start
    Data.isNeuKonferenz Kennzeichnung, die angibt, ob es sich um eine neue oder eine vorhandene Telefonkonferenz handelt.

    Gültige Werte:

    • Wahr: Neue Telefonkonferenz
    • Falsch: Vorhandene Telefonkonferenz

    Standardwert: false

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    data.items Informationen, die jeder Teilnehmer in die Telefonkonferenz aufnehmen soll.

    Gültige Array-Werte:

    • id: SYS_ID des Anwenders; befindet sich in der Anwendertabelle [sys_User].

      Gültige Aktionen: Join, MultiJoin, Start

    • NotifyParticipantId: SYS-ID des Notify-Teilnehmers; befindet sich in der Notify-Teilnehmer-Tabelle [Notify_participant].

      Gültige Aktionen: Beitreten, Kick, MultiJoin, Stummschaltung, Start, Stummschaltung aufheben

    • Telefonnummer: Telefonnummer des Teilnehmers. Ob dieser Wert in Verbindung mit übergeben wird idOder notifyParticipantId, Dieser Wert ersetzt die Telefonnummern im Anwender-/Teilnehmerdatensatz und wird zum Tätigen des Anrufs verwendet.

      Gültige Aktionen: Join, MultiJoin, Start

    • E-Mail: E-Mail-Adresse des Teilnehmers.

      Gültige Aktionen: Join, MultiJoin, Start
    Daten.Nachricht Nachricht, die laut vorgelesen wird, wenn ein Anwender den Anruf beantwortet, z. B. „P1-Incident wurde erstellt, melden Sie sich bei der Instanz an.“

    Aktionen, für die dieser Parameter gültig ist:

    • teilnehmen
    • MultiJoin
    • Start
    data.serviceProvider Erforderlich. Name des Konferenzservice Providers, z. B. Zoom oder Webex.

    Aktionen, für die dieser Parameter erforderlich ist:

    • alle
    Daten.sysId SYS_ID des Quelldatensatzes, der der Telefonkonferenz zugeordnet werden soll.

    Wenn beispielsweise eine Telefonkonferenz gehalten wird, um einen bestimmten Incident oder ein bestimmtes Problem zu besprechen, geben Sie die sys_ID des Incident- oder Problemdatensatzes in diesen Wert ein. Diese sys_ID wird in der Spalte „Quelle“ der Tabelle „NotifyConference-Anruf“ [Notify_Conference_call] gespeichert und kann später nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit verwendet data.Table, data.addToWorkNotes, Und allowMulticonferenceParameter.

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    Daten.Tabelle Tabelle, die den Quelldatensatz enthält, der der Telefonkonferenz zugeordnet werden soll. Ein Quelldatensatz kann ein beliebiger Datensatz sein, z. B. ein „Incident“ oder „Problem“, der das Diskussionsthema in der Telefonkonferenz ist.

    Dieser Tabellenname wird in der Tabellenspalte der Tabelle NotifyConference Call [Notify_Conference_call] gespeichert und kann nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit verwendet data.sysId, data.addToWorkNotes, Und allowMulticonferenceParameter.

    Aktionen, für die dieser Parameter gültig ist:

    • Start
    		 
    (function (confId) {
	var confUtils = new NotifyConferenceUtils();
	var data = confUtils.getConferenceInputDataTemplate();
	data.confId = confId;
	var result = confUtils.doConferenceAction('end', data);
	if (result.status) {
		gs.info('Conference call has been ended');
	} else
		gs.info('End conference call action failed');

	result.errorMessages.forEach(function (msg) {
		gs.info(msg);
	});
	result.warnMessages.forEach(function (msg) {
		gs.info(msg);
	});
	result.successMessages.forEach(function (msg) {
		gs.info(msg);
	});
})('activeConfSysId');

    NotifyConferenceUtils – getServiceProvidersCapabilities()

    Gibt die Fähigkeiten aller Treiber des Telefonservice Providers in der Instanz zurück.

    Mögliche Fähigkeiten sind:
    • Archiv: Archiviert die Konferenz nach dem Ende
    • BeepOnLeave: Gibt einen Signalton ab, wenn ein Teilnehmer die Telefonkonferenz verlässt
    • BeepOnJoin: Gibt einen Signalton ab, wenn ein Teilnehmer der Telefonkonferenz beitritt
    • Ende: Beendet die identifizierte Telefonkonferenz
    • Dateifreigabe: Ermöglicht die Dateifreigabe zwischen Teilnehmern
    • Beitreten: Fügt einer Telefonkonferenz einen Teilnehmer hinzu
    • Kick: Entfernt einen Teilnehmer aus einer Telefonkonferenz
    • MultiJoin: Fügt einer Telefonkonferenz mehrere Teilnehmer hinzu
    • MultiKick: Entfernt mehrere Teilnehmer aus einer Telefonkonferenz
    • MuteOnJoin: Schaltet einen Teilnehmer stumm, wenn er anfänglich an einer Telefonkonferenz teilnimmt
    • Mehrfache Stummschaltung: Hebt die Stummschaltung mehrerer Teilnehmer für eine Telefonkonferenz auf
    • Datensatz: Zeichnet Telefonkonferenzen auf
    • Aufzeichnung: Stellt einen Bildschirmindikator bereit, wenn die Telefonkonferenz aufgezeichnet wird
    • ScreenSharing: Ermöglicht die Freigabe von Teilnehmerbildschirmen für die Gruppe
    • SelfJoin: Fügt den aktuell angemeldeten Anwender einer Telefonkonferenz hinzu
    • Sprechen: Zeigt eine Bildschirmnachricht an, wer derzeit spricht
    • Start: Startet die identifizierte Telefonkonferenz
    • Stummschaltung aufheben: Hebt die Stummschaltung eines Teilnehmers in einer Telefonkonferenz auf
    Tabelle : 10. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 11. Ergebnisse
    Typ Beschreibung
    Objekt Schlüssel-Wert-Paare des Status jeder Treiberfähigkeit.

    Gültige Werte:

    • IsSupported = 0: Fähigkeit wird nicht unterstützt
    • IsSupported = 1: Fähigkeit wird unterstützt

    Listet Treiberfähigkeiten für alle Treiber des Telefonservice Providers in der Instanz auf.

    (function () {
	var confUtils = new NotifyConferenceUtils();
	var providerToCapability = confUtils.getServiceProvidersCapabilites();
	for (var provider in providerToCapability) {
		gs.info('{0} supported capabilities \n\n', provider);
		var capabilities = providerToCapability[provider]
		for (var cap in capabilities)
			if(confUtils.isActionSupported(capabilities[cap].isSupported))
				gs.info('"{0}" action supported', cap);
			else
				gs.info("'{0}' action is not supported by this conference driver", cap);
	}
})();

    Ausgabe: Die Methode gibt für jeden aktiven Telefonservice Provider in der Instanz einen Knoten ähnlich dem folgenden zurück.

    {
    "Telephony": {
        "start": {
            "isSupported": 1,
            "meta": {}
        },
        "end": {
            "isSupported": 1,
            "meta": {}
        },
        "selfJoin": {
            "isSupported": 1,
            "meta": {}
        },
        "join": {
            "isSupported": 1,
            "meta": {}
        },
        "multiJoin": {
            "isSupported": 1,
            "meta": {}
        },
        "mute": {
            "isSupported": 1,
            "meta": {}
        },
        "multiMute": {
            "isSupported": 1,
            "meta": {}
        },
        "unmute": {
            "isSupported": 1,
            "meta": {}
        },
        "multiUnmute": {
            "isSupported": 1,
            "meta": {}
        },
        "kick": {
            "isSupported": 1,
            "meta": {}
        },
        "multiKick": {
            "isSupported": 1,
            "meta": {}
        },
        "record": {
            "isSupported": 0,
            "meta": {}
        },
        "speaking": {
            "isSupported": 0,
            "meta": {}
        },
        "recording": {
            "isSupported": 0,
            "meta": {}
        },
        "screenSharing": {
            "isSupported": 0,
            "meta": {}
        },
        "fileSharing": {
            "isSupported": 0,
            "meta": {}
        },
        "archive": {
            "isSupported": 0,
            "meta": {}
        },
        "muteOnJoin": {
            "isSupported": 0,
            "meta": {}
        },
        "beepOnJoin": {
            "isSupported": 0,
            "meta": {}
        },
        "beepOnLeave": {
            "isSupported": 0,
            "meta": {}
        }
    }
}

    NotifyConferenceUtils – isActionSupported(Nummernaktion)

    Bestimmt, ob eine Notify-Konferenzaktion von einem Telefonservice Provider unterstützt wird.

    Zur Verwendung dieser Methode müssen Sie zuerst aufrufen GetServiceProviderCapabilities() Methode. Diese Methode gibt ein Objekt zurück, das Informationen zur Verfügbarkeit jeder möglichen Notify-Konferenzaktion für jeden in Ihrer Instanz konfigurierten Service Provider enthält.

    Zum Beispiel:

    {
    "Telephony": {
        "start": {
            "isSupported": 1,
            "meta": {}
        },
        "end": {
            "isSupported": 1,
            "meta": {}
        },
        "selfJoin": {
            "isSupported": 1,
            "meta": {}
        },
        "join": {
            "isSupported": 1,
            "meta": {}
        },
        "multiJoin": {
            "isSupported": 1,
            "meta": {}
        },
        "mute": {
            "isSupported": 1,
            "meta": {}
        },
        "multiMute": {
            "isSupported": 1,
            "meta": {}
        },
        "unmute": {
            "isSupported": 1,
            "meta": {}
        },
        "multiUnmute": {
            "isSupported": 1,
            "meta": {}
        },
        "kick": {
            "isSupported": 1,
            "meta": {}
        },
        "multiKick": {
            "isSupported": 1,
            "meta": {}
        },
        "record": {
            "isSupported": 0,
            "meta": {}
        },
        "speaking": {
            "isSupported": 0,
            "meta": {}
        },
        "recording": {
            "isSupported": 0,
            "meta": {}
        },
        "screenSharing": {
            "isSupported": 0,
            "meta": {}
        },
        "fileSharing": {
            "isSupported": 0,
            "meta": {}
        },
        "archive": {
            "isSupported": 0,
            "meta": {}
        },
        "muteOnJoin": {
            "isSupported": 0,
            "meta": {}
        },
        "beepOnJoin": {
            "isSupported": 0,
            "meta": {}
        },
        "beepOnLeave": {
            "isSupported": 0,
            "meta": {}
        }
    }
}
    Tabelle : 12. Parameter
    Name Typ Beschreibung
    Aktion Anzahl

    Wert von isSupportedParameter, der von zurückgegeben wird GetServiceProvidersCapabilities() Methode für eine bestimmte Aktion und einen bestimmten Service Provider.

    Hinweis:
    Obwohl isSupportedDer Wert kann als boolescher Wert erscheinen, er ist eigentlich eine Zahl. Versuchen Sie nicht, die Fähigkeiten als boolesche Werte auszuwerten. Verwenden Sie diese Methode, da die zugehörigen Werte in zukünftigen Versionen erweitert werden können.
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Telefonservice Provider die angegebene Aktion unterstützt.

    Gültige Werte:

    • Wahr: Aktion wird vom Service Provider unterstützt
    • Falsch: Aktion wird vom Service Provider nicht unterstützt
    		 
    (function () {
  var confUtils = new NotifyConferenceUtils();
  var providerToCapability = confUtils.getServiceProvidersCapabilites();
    for (var provider in providerToCapability) {
      gs.info('{0} supported capabilities \n\n', provider);
      var capabilities = providerToCapability[provider]
      for (var cap in capabilities)
        if (confUtils.isActionSupported(capabilities[cap].isSupported))
          gs.info('"{0}" action supported', cap);
        else
          gs.info("'{0}' action is not supported by this conference driver", cap);
    }
})();

    NotifyConferenceUtils – kickByParticipantGR(GlideRecord notifyParticipantGR)

    Entfernt den Teilnehmer, der dem in GlideRecord übergebenen zugeordnet ist, aus der aktuellen Telefonkonferenz.

    Tabelle : 14. Parameter
    Name Typ Beschreibung
    NotifyParticipantGR GlideRecord GlideRecord-Objekt des Teilnehmers, das aus der Telefonkonferenz entfernt werden soll.

    Tabelle: Notify-Teilnehmer [Notify_participant]
    Tabelle : 15. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisse der Konferenzaktion.

    <action>.Status : Status der Konferenzaktion.

    • Datentyp: Boolesch
    • Mögliche Werte:
      • Wahr: Konferenzaktion erfolgreich
      • Falsch: Konferenzaktion fehlgeschlagen

    <action>.Erfolgsnachrichten : Wenn Status Ist „wahr“, Erfolgsmeldung(en), andernfalls leer.

    • Datentyp: Array von Zeichenfolgen

    <action>.Warnmeldungen : Wenn Status Ist „falsch“, alle während der Verarbeitung ausgelösten Warnmeldungen.

    • Datentyp: Array von Zeichenfolgen

    <action>.Fehlernachrichten : Wenn Status Ist „falsch“, alle Fehlermeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    (function () {
    var confUtils = new NotifyConferenceUtils();
    var participantGR = new GlideRecord('notify_participant');  // Participant record contains conf call ID
    participantGR.get('validParticipantSysId');
    var actionResult = confUtils.kickByParticipantGR(participantGR);
    if (actionResult.status)
        gs.info('Participant has been kicked out of conference');
    else {
        gs.info('kick operation failed');
        actionResult.warnMessages.forEach(function (msg) {
            gs.info(msg);
        });
        actionResult.errorMessages.forEach(function (msg) {
            gs.info(msg);
        })
    }
})()

    NotifyConferenceUtils – muteByParticipantGR(GlideRecord notifyParticipantGR)

    Schaltet den Teilnehmer, der der in GlideRecord in der aktuellen Telefonkonferenz übergeben wurde, stumm.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    NotifyParticipantGR Objekt GlideRecord-Objekt des Teilnehmers, der stummgeschaltet werden soll.

    Tabelle: Notify-Teilnehmer [Notify_participant]
    Tabelle : 17. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisse der Konferenzaktion.

    <action>.Status : Status der Konferenzaktion.

    • Datentyp: Boolesch
    • Mögliche Werte:
      • Wahr: Konferenzaktion erfolgreich
      • Falsch: Konferenzaktion fehlgeschlagen

    <action>.Erfolgsnachrichten : Wenn Status Ist „wahr“, Erfolgsmeldung(en), andernfalls leer.

    • Datentyp: Array von Zeichenfolgen

    <action>.Warnmeldungen : Wenn Status Ist „falsch“, alle während der Verarbeitung ausgelösten Warnmeldungen.

    • Datentyp: Array von Zeichenfolgen

    <action>.Fehlernachrichten : Wenn Status Ist „falsch“, alle Fehlermeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    (function () {
    var confUtils = new NotifyConferenceUtils();
    var participantGR = new GlideRecord('notify_participant');
    participantGR.get('validSysId');
    var actionResult = confUtils.muteByParticipantGR(participantGR);
    if (actionResult.status)
        gs.info('Participant has been muted');
    else {
        gs.info('mute operation failed');
        actionResult.warnMessages.forEach(function (msg) {
            gs.info(msg);
        });
        actionResult.errorMessages.forEach(function (msg) {
            gs.info(msg);
        })
    }
})()

    NotifyConferenceUtils – unmuteByParticipantGR(GlideRecord notifyParticipantGR)

    Hebt die Stummschaltung des Teilnehmers auf, der in GlideRecord in der aktuellen Telefonkonferenz übergeben wurde.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    NotifyParticipantGR GlideRecord GlideRecord-Objekt des Teilnehmers, dessen Stummschaltung aufgehoben werden soll. Diese Datensätze befinden sich in der Notify-Teilnehmer [Notify_participant]-Tabelle.
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisse der Konferenzaktion.

    <action>.Status : Status der Konferenzaktion.

    • Datentyp: Boolesch
    • Mögliche Werte:
      • Wahr: Konferenzaktion erfolgreich
      • Falsch: Konferenzaktion fehlgeschlagen

    <action>.Erfolgsnachrichten : Wenn Status Ist „wahr“, Erfolgsmeldung(en), andernfalls leer.

    • Datentyp: Array von Zeichenfolgen

    <action>.Warnmeldungen : Wenn Status Ist „falsch“, alle während der Verarbeitung ausgelösten Warnmeldungen.

    • Datentyp: Array von Zeichenfolgen

    <action>.Fehlernachrichten : Wenn Status Ist „falsch“, alle Fehlermeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen
    		 
    (function () {
    var confUtils = new NotifyConferenceUtils();
    var participantGR = new GlideRecord('notify_participant');
    participantGR.get('validSysId');
    var actionResult = confUtils.unmuteByParticipantGR(participantGR);
    if (actionResult.status)
        gs.info('Participant has been Unmuted');
    else {
        gs.info('Unmute operation failed');
        actionResult.warnMessages.forEach(function (msg) {
            gs.info(msg);
        });
        actionResult.errorMessages.forEach(function (msg) {
            gs.info(msg);
        })
    }
})();