NotifyConferenceUtil: Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 16 Minuten Lesedauer

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

    Mit der NotifyConferenceUtil -API können Sie:

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

    Sie können diese API sowohl in bereichsbezogenen als auch in globalen Skripts verwenden. Zur Verwendung dieser API müssen Sie das Plugin „Conference Notify“ (com.snc.notify) aktivieren, für das ein separates Abonnement erforderlich ist. Weitere Informationen zur Aktivierung dieses Plugins finden Sie unter Notify aktivieren.

    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(String toNumber, GlideRecord confGR)

    Fügt einen Teilnehmer einer angegebenen Telefonkonferenz hinzu, indem er seine Telefonnummer verwendet, um den Teilnehmer zu identifizieren.

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    toNumber Zeichenfolge Telefonnummer des Teilnehmers, der der Telefonkonferenz hinzugefügt werden soll.
    confGR 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:
      • true: Konferenzaktion erfolgreich
      • false: Konferenzaktion fehlgeschlagen

    <action.successMessages: Erfolgsnachricht(en), wenn der Status „wahr“ ist, sonst leer.

    • Datentyp: Array von Zeichenfolgen

    <action.warnMessages: Wenn der Status „falsch“ ist, alle Warnmeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    <action.errorMessages: Wenn der Status „falsch“ ist, 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 einen Teilnehmer hinzu, auf den von in GlideRecord übergebenen verwiesen wird, und zwar anhand seines eindeutigen Anwenderbezeichners.

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

    Tabelle: Benutzer [sys_user]
    confGR 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:
      • true: Konferenzaktion erfolgreich
      • false: Konferenzaktion fehlgeschlagen

    <action.successMessages: Erfolgsnachricht(en), wenn der Status „wahr“ ist, sonst leer.

    • Datentyp: Array von Zeichenfolgen

    <action.warnMessages: Wenn der Status „falsch“ ist, alle Warnmeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    <action.errorMessages: Wenn der Status „falsch“ ist, 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 Telefonkonferenzaktion aus, z. B. Starten/Beenden einer Telefonkonferenz oder Beitreten, Entfernen, Stummschalten oder Aufheben der Stummschaltung von Teilnehmern.

    Sie können einen neuen Telefonkonferenz starten und innerhalb eines einzigen Anrufs zu dieser Methode Teilnehmer 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 für Folgendes konfigurieren:
    • Speichern Sie die Verweise im Datensatz der Telefonkonferenz auf den spezifischen Datensatz (Quelldatensatz), z. B. einen Incident oder ein Problem, der das Gesprächsthema in der Telefonkonferenz ist.
    • Mehrere Telefonkonferenzen für einen Quelldatensatz zulassen/nicht zulassen.
    • Protokolliert automatisch die Teilnehmer der Telefonkonferenz im Feld „Arbeitsnotizen“ des Quelldatensatzes.
    • Lassen Sie sich eine Nachricht vorlesen, wenn ein Teilnehmer einen ausgehenden Anruf aus der Konferenz beantwortet.
    Tabelle : 6. Parameter
    Name Typ Beschreibung
    Aktion Zeichenfolge Definiert die auszuführende Telefonkonferenzaktion.
    Es folgen die verfügbaren Telefonkonferenzaktionen:
    • end: Beendet die in data.confIdidentifizierte Telefonkonferenz.
    • beitreten: Fügt den im Array data.items angegebenen Teilnehmer der in data.confIdidentifizierten Telefonkonferenz hinzu.
    • Kick: Entfernt den im Array data.items angegebenen Teilnehmer aus der in data.confIdidentifizierten Telefonkonferenz.
    • multiJoin: Fügt die im Array data.items angegebenen Teilnehmer der in data.confIdidentifizierten Telefonkonferenz hinzu.
    • multiKick: Entfernt die im Array data.items angegebenen Teilnehmer aus der in data.confIdidentifizierten Telefonkonferenz.
    • multiMute: Schaltet die im Array data.items angegebenen Teilnehmer in der in data.confIdidentifizierten Telefonkonferenz stumm.
    • multiUnmute: Hebt die Stummschaltung der im Array data.items angegebenen Teilnehmer aus der in data.confIdidentifizierten Telefonkonferenz auf.
    • mute: Schaltet den im Array data.items angegebenen Teilnehmer in der in data.confIdangegebenen Telefonkonferenz stumm.
    • SelfJoin: Fügt den aktuell angemeldeten Anwender zur Telefonkonferenz hinzu (Eintrag in data.items nicht erforderlich).
    • start: Startet die in data.confIdidentifizierte Telefonkonferenz.
    • unmute: Hebt die Stummschaltung des im Array data.items angegebenen Teilnehmers in der in data.confIdidentifizierten Telefonkonferenz auf.
    Daten Objekt Objekt, das die Telefonkonferenz beschreibt.
    data.addToWorkNotes Boolean Kennzeichnung, die angibt, ob Informationen zu den Teilnehmern, die in die Telefonkonferenz einbezogen wurden, im Feld „Arbeitsnotizen“ des zugeordneten Datensatzes hinzugefügt werden sollen.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in den Parametern data.table und data.sysId angeben. Diese Parameter geben den Datensatz an, 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 zulässig sind.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in den Parametern data.table und data.sysId angeben. Diese Parameter geben den Datensatz an, der mehrere Telefonkonferenzen enthalten darf.

    Standardwert: false

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

    • start
    data.confId Zeichenfolge Sys_id der Telefonkonferenz.

    Tabelle: Notify-Telefonkonferenz [notify_conference_call]

    Aktionen, für die dieser Parameter erforderlich ist:

    • end
    • teilnehmen
    • multiJoin
    • SelfJoin
    Hinweis:
    Für Teilnehmeraktionen wie „stummschalten“, „Stummschaltung aufheben“ und „Kick“ muss dieser Parameter nicht festgelegt werden, da die Methode diese Informationen aus der Tabelle „Teilnehmer der Notify-Telefonkonferenz“ [notify_participant] erhält.
    data.fromNumber Zeichenfolge Für die Telefonkonferenz anzurufende Service Provider-Nummer.

    Suchen Sie diesen Wert in der Spalte Nummer oder Telefonnummer der Tabelle „Notify-Telefonnummer“ [notify_number].

    Aktionen, für die dieser Parameter erforderlich ist:

    • start
    Daten.istNeueKonferenz Boolean Kennzeichnung, die angibt, ob es sich um eine neue oder eine vorhandene Telefonkonferenz handelt.

    Gültige Werte:

    • true: Neue Telefonkonferenz
    • false: Vorhandene Telefonkonferenz

    Standardwert: false

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

    • start
    Daten.Elemente Array Informationen für jeden Teilnehmer, der in die Telefonkonferenz aufgenommen werden soll.

    Gültige Array-Werte:

    • id: Sys_id des Anwenders; befindet sich in der Tabelle „Benutzer“ [sys_User].

      Gültige Aktionen: „join“, „multiJoin“, „start“.

    • notifyParticipantId: Sys-ID des Notify-Teilnehmers. in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant]

      Gültige Aktionen: beitreten, treten, multijoin, mute, starten, Stummschaltung aufheben

    • phoneNumber: Telefonnummer des Teilnehmers. Wenn dieser Wert in Verbindung mit id oder notifyParticipantIdübergeben wird, ersetzt dieser Wert die Telefonnummern im Benutzer-/Teilnehmerdatensatz und wird zum Tätigen des Anrufs verwendet.

      Gültige Aktionen: „join“, „multiJoin“, „start“.

    • email: E-Mail-Adresse des Teilnehmers.

      Gültige Aktionen: „join“, „multiJoin“, „start“.
    Daten.Nachricht Zeichenfolge Nachricht, die laut vorgelesen wird, wenn ein Benutzer 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 Service Providers für Konferenzen, z. B. Zoom oder Webex.

    Aktionen, für die dieser Parameter erforderlich ist:

    • alle
    data.sysId Zeichenfolge Sys_id des Quelldatensatzes, der der Telefonkonferenz zugeordnet werden soll.

    Wenn beispielsweise eine Telefonkonferenz abgehalten 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 Call“ [notify_conference_call] gespeichert und kann später nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit den Parametern data.Table, data.addToWorkNotesund allowMulticonference verwendet.

    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 ein „Problem“, der in der Telefonkonferenz behandelt wird.

    Dieser Tabellenname wird in der Spalte „Tabelle“ der Tabelle „NotifyConference Call“ [notify_conference_call] gespeichert und kann nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit den Parametern data.sysId, data.addToWorkNotesund allowMulticonference verwendet.

    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:
      • true: Konferenzaktion erfolgreich
      • false: Konferenzaktion fehlgeschlagen

    <action.successMessages: Erfolgsnachricht(en), wenn der Status „wahr“ ist, sonst leer.

    • Datentyp: Array von Zeichenfolgen

    <action.warnMessages: Wenn der Status „falsch“ ist, alle Warnmeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    <action.errorMessages: Wenn der Status „falsch“ ist, 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 der doConferenceAction()- Methode verwendet werden soll. Durch die Verwendung dieser Vorlage wird das Datenobjekt automatisch strukturiert, sodass Sie es nicht manuell erstellen müssen.

    Rufen Sie diese Methode auf, bevor Sie die doConferenceAction()- Methode aufrufen. Legen Sie für die gewünschte Telefonkonferenzaktion die gewünschten Parameter in der Vorlage fest, und übergeben Sie die Vorlage dann im doConferenceAction() -Aufruf. Weitere Informationen zu den gültigen Parametern für die einzelnen Aktionen finden Sie unter doConferenceAction().

    Hinweis:
    Dies ist eine Hilfsmethode. Sie können dieses Objekt auch manuell erstellen und an die Methode „doConferenceAction()“ übergeben, um dasselbe Ergebnis zu erzielen.
    Tabelle : 8. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 9. Ergebnisse
    Typ Beschreibung
    Daten Objekt, das die Telefonkonferenz beschreibt.
    data.addToWorkNotes Kennzeichnung, die angibt, ob Informationen zu den Teilnehmern, die in die Telefonkonferenz einbezogen wurden, im Feld „Arbeitsnotizen“ des zugeordneten Datensatzes hinzugefügt werden sollen.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in den Parametern data.table und data.sysId angeben. Diese Parameter geben den Datensatz an, dem die Arbeitsnotizen hinzugefügt werden sollen.

    Standardwert: false

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

    • teilnehmen
    • multiJoin
    • SelfJoin
    • start
    data.allowMulticonference Kennzeichnung, die angibt, ob mehrere Telefonkonferenzen für einen bestimmten Datensatz gleichzeitig zulässig sind.

    Damit diese Funktionalität funktioniert, müssen Sie auch Werte in den Parametern data.table und data.sysId angeben. Diese Parameter geben den Datensatz an, der mehrere Telefonkonferenzen enthalten darf.

    Standardwert: false

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

    • start
    data.confId Sys_id der Telefonkonferenz.

    Tabelle: Notify-Telefonkonferenz [notify_conference_call]

    Aktionen, für die dieser Parameter erforderlich ist:

    • end
    • teilnehmen
    • multiJoin
    • SelfJoin
    Hinweis:
    Für Teilnehmeraktionen wie „stummschalten“, „Stummschaltung aufheben“ und „Kick“ muss dieser Parameter nicht festgelegt werden, da die Methode diese Informationen aus der Tabelle „Teilnehmer der Notify-Telefonkonferenz“ [notify_participant] erhält.
    data.fromNumber Für die Telefonkonferenz anzurufende Service Provider-Nummer.

    Suchen Sie diesen Wert in der Spalte Nummer oder Telefonnummer der Tabelle „Notify-Telefonnummer“ [notify_number].

    Aktionen, für die dieser Parameter erforderlich ist:

    • start
    Daten.istNeueKonferenz Kennzeichnung, die angibt, ob es sich um eine neue oder eine vorhandene Telefonkonferenz handelt.

    Gültige Werte:

    • true: Neue Telefonkonferenz
    • false: Vorhandene Telefonkonferenz

    Standardwert: false

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

    • start
    Daten.Elemente Informationen für jeden Teilnehmer, der in die Telefonkonferenz aufgenommen werden soll.

    Gültige Array-Werte:

    • id: Sys_id des Anwenders; befindet sich in der Tabelle „Benutzer“ [sys_User].

      Gültige Aktionen: „join“, „multiJoin“, „start“.

    • notifyParticipantId: Sys-ID des Notify-Teilnehmers. in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant]

      Gültige Aktionen: beitreten, treten, multijoin, mute, starten, Stummschaltung aufheben

    • phoneNumber: Telefonnummer des Teilnehmers. Wenn dieser Wert in Verbindung mit id oder notifyParticipantIdübergeben wird, ersetzt dieser Wert die Telefonnummern im Benutzer-/Teilnehmerdatensatz und wird zum Tätigen des Anrufs verwendet.

      Gültige Aktionen: „join“, „multiJoin“, „start“.

    • email: E-Mail-Adresse des Teilnehmers.

      Gültige Aktionen: „join“, „multiJoin“, „start“.
    Daten.Nachricht Nachricht, die laut vorgelesen wird, wenn ein Benutzer 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 Service Providers für Konferenzen, z. B. Zoom oder Webex.

    Aktionen, für die dieser Parameter erforderlich ist:

    • alle
    data.sysId Sys_id des Quelldatensatzes, der der Telefonkonferenz zugeordnet werden soll.

    Wenn beispielsweise eine Telefonkonferenz abgehalten 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 Call“ [notify_conference_call] gespeichert und kann später nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit den Parametern data.Table, data.addToWorkNotesund allowMulticonference verwendet.

    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 ein „Problem“, der in der Telefonkonferenz behandelt wird.

    Dieser Tabellenname wird in der Spalte „Tabelle“ der Tabelle „NotifyConference Call“ [notify_conference_call] gespeichert und kann nachverfolgt werden.

    Dieser Parameter wird in Verbindung mit den Parametern data.sysId, data.addToWorkNotesund allowMulticonference verwendet.

    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 Telefonie-Service Provider-Treiber in der Instanz zurück.

    Mögliche Fähigkeiten:
    • Archiv: Archiviert die Konferenz nach deren Ende
    • beepOnLeave: Gibt einen „Beep“-Ton wieder, wenn ein Teilnehmer die Telefonkonferenz verlässt
    • beepOnJoin: gibt einen „Beep“-Ton wieder, wenn ein Teilnehmer der Telefonkonferenz beitritt
    • end: Beendet die identifizierte Telefonkonferenz
    • Filesharing: Ermöglicht die Dateifreigabe zwischen Teilnehmern
    • beitreten: Fügt einen Teilnehmer zu einer Telefonkonferenz 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 zum ersten Mal an einer Telefonkonferenz teilnimmt
    • multiUnmute: Hebt die Stummschaltung mehrerer Teilnehmer für eine Telefonkonferenz auf
    • Datensatz: zeichnet Telefonkonferenzen auf
    • Aufzeichnung: bietet einen Indikator auf dem Bildschirm, wenn die Telefonkonferenz aufgezeichnet wird
    • screenSharing: Ermöglicht das Freigeben von Teilnehmerbildschirmen für die Gruppe
    • SelfJoin: Fügt den aktuell angemeldeten Anwender zu einer Telefonkonferenz hinzu
    • sprechen: zeigt auf dem Bildschirm an, wer gerade spricht
    • Start: Startet den identifizierten Konferenzanruf
    • 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 Treiberfunktionen für alle Telefonie-Service Provider-Treiber 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 Telefonie-Service Provider in der Instanz einen Knoten zurück, der dem folgenden ähnelt.

    {
    "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 Telefoniedienstanbieter unterstützt wird.

    Um diese Methode zu verwenden, müssen Sie zuerst die getServiceProviderCapabilities()- Methode aufrufen. Diese Methode gibt ein Objekt zurück, das Informationen über die 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 Nummer

    Wert des Parameters isSupported, der von der Methode getServiceProvidersCapabilities() für eine bestimmte Aktion und einen bestimmten Service Provider zurückgegeben wird.

    Hinweis:
    Der Wert isSupported scheint zwar ein boolescher Wert zu sein, ist jedoch tatsächlich eine Zahl. Versuchen Sie nicht, die Fähigkeiten als boolesche Werte auszuwerten. Verwenden Sie diese Methode, da die zugeordneten Werte in zukünftigen Versionen erweitert werden können.
    Tabelle : 13. Rückgaben
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob der Telefonie-Service Provider die angegebene Aktion unterstützt.

    Gültige Werte:

    • wahr: Die 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 – trittByParticipantGR(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, der 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:
      • true: Konferenzaktion erfolgreich
      • false: Konferenzaktion fehlgeschlagen

    <action.successMessages: Erfolgsnachricht(en), wenn der Status „wahr“ ist, sonst leer.

    • Datentyp: Array von Zeichenfolgen

    <action.warnMessages: Wenn der Status „falsch“ ist, alle Warnmeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    <action.errorMessages: Wenn der Status „falsch“ ist, 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 stumm, der dem in GlideRecord übergebenen zugeordnet ist, und zwar in der aktuellen Telefonkonferenz.

    Tabelle : 16. Parameter
    Name Typ Beschreibung
    notifyParticipantGR Objekt GlideRecord-Objekt des stummgeschalteten Teilnehmers.

    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:
      • true: Konferenzaktion erfolgreich
      • false: Konferenzaktion fehlgeschlagen

    <action.successMessages: Erfolgsnachricht(en), wenn der Status „wahr“ ist, sonst leer.

    • Datentyp: Array von Zeichenfolgen

    <action.warnMessages: Wenn der Status „falsch“ ist, alle Warnmeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    <action.errorMessages: Wenn der Status „falsch“ ist, 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 bei der aktuellen Telefonkonferenz dem in GlideRecord übergebenen zugeordnet ist.

    Tabelle : 18. Parameter
    Name Typ Beschreibung
    notifyParticipantGR GlideRecord GlideRecord-Objekt des Teilnehmers, dessen Stummschaltung Sie aufheben möchten. Diese Datensätze befinden sich in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant].
    Tabelle : 19. Rückgaben
    Typ Beschreibung
    Objekt Ergebnisse der Konferenzaktion.

    <action.status: Status der Konferenzaktion.

    • Datentyp: Boolesch
    • Mögliche Werte:
      • true: Konferenzaktion erfolgreich
      • false: Konferenzaktion fehlgeschlagen

    <action.successMessages: Erfolgsnachricht(en), wenn der Status „wahr“ ist, sonst leer.

    • Datentyp: Array von Zeichenfolgen

    <action.warnMessages: Wenn der Status „falsch“ ist, alle Warnmeldungen, die während der Verarbeitung ausgelöst werden.

    • Datentyp: Array von Zeichenfolgen

    <action.errorMessages: Wenn der Status „falsch“ ist, 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);
        })
    }
})();