NotifyConferenceUtil – Scoped, Global

Die NotifyConferenceUtil- API bietet Methoden zum Verwalten von Notify-Telefonkonferenzen und SMS-Nachrichten für verschiedene Telefoniedienstanbieter wie Zoom und WebEx.

Mit der NotifyConferenceUtil- API können Sie:

• Erstellen Sie neue Telefonkonferenzen
• Fügen Sie Teilnehmer per Telefonnummer oder Benutzer-ID hinzu
• Entfernen Sie Teilnehmer aus einer Telefonkonferenz
• Schalten Sie Teilnehmer in einer Telefonkonferenz stumm
• Heben Sie die Stummschaltung für Teilnehmer 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. Um diese API zu verwenden, müssen Sie das Plugin „Conference Notify“ (com.snc.notify) aktivieren, für das ein separates Abonnement erforderlich ist. Weitere Informationen zum Aktivieren dieses Plugins finden Sie unter Notify aktivieren.

NotifyConferenceUtils – addToConferenceByPhoneNumber(String toNumber, GlideRecord confGR)

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

Tabelle : 1. 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. Diese Datensätze befinden sich in der Notify-Telefonkonferenztabelle [notify_conference_call].

Tabelle : 2. Ergebnisse

Typ

Beschreibung

Objekt

Ergebnisse der Konferenzaktion. <action.status: Status der Konferenzaktion. Datentyp: Boolesch Gültige Werte: true: Konferenzaktion erfolgreich false: Konferenzaktion fehlgeschlagen <action.successMessages: Wenn der Status „ wahr“ ist, Erfolgsmeldung(en), sonst leer. Datentyp: Array von Zeichenfolgen <action.warnMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Warnmeldungen. Datentyp: Array von Zeichenfolgen <action.errorMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Fehlermeldungen. Datentyp: Array von Zeichenfolgen

Beispiel

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

	var confUtils = new NotifyConferenceUtils();
	var actionResult = confUtils.addToConferenceByPhoneNumber("[phone]", 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 einen Teilnehmer der Telefonkonferenz hinzu, auf die der übergebene GlideRecord verweist, und zwar unter Verwendung seines eindeutigen Benutzerbezeichners.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
userId	Zeichenfolge	Sys-ID des Teilnehmers, der der angegebenen Telefonkonferenz hinzugefügt werden soll. Diese Informationen befinden sich in der Benutzertabelle [sys_user].
confGR	GlideRecord	GlideRecord der Telefonkonferenz zum Hinzufügen des angegebenen Teilnehmers. Diese Datensätze befinden sich in der Notify-Telefonkonferenztabelle [notify_conference_call].

Tabelle : 4. Ergebnisse

Typ

Beschreibung

Objekt

Ergebnisse der Konferenzaktion. <action.status: Status der Konferenzaktion. Datentyp: Boolesch Gültige Werte: true: Konferenzaktion erfolgreich false: Konferenzaktion fehlgeschlagen <action.successMessages: Wenn der Status „ wahr“ ist, Erfolgsmeldung(en), sonst leer. Datentyp: Array von Zeichenfolgen <action.warnMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Warnmeldungen. Datentyp: Array von Zeichenfolgen <action.errorMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Fehlermeldungen. Datentyp: Array von Zeichenfolgen

Beispiel

(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(String action, Object data)

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

Sie können eine neue Telefonkonferenz starten und Teilnehmer innerhalb eines einzelnen 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 wie folgt konfigurieren:

• Speichern Sie Verweise im Konferenzschaltungsdatensatz auf den spezifischen Datensatz (Quelldatensatz), z. B. einen Incident oder ein Problem, der das Gesprächsthema für die Konferenzschaltung ist.
• Mehrere Telefonkonferenzen für einen Quelldatensatz zulassen/verbieten.
• Protokollieren Sie die Teilnehmer, die an der Telefonkonferenz teilgenommen haben, automatisch im Feld „Arbeitsnotizen“ des Quelldatensatzes.
• Lassen Sie eine Nachricht vorlesen, wenn ein Teilnehmer einen ausgehenden Anruf aus der Konferenz beantwortet.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Aktion	Zeichenfolge	Definiert die auszuführende Telefonkonferenzaktion. Die folgenden Aktionen sind für Telefonkonferenzen verfügbar: start: Startet die in identifizierte Telefonkonferenz data.confId end: Beendet die in identifizierte Telefonkonferenz data.confId join: Fügt den im Array [] angegebenen Teilnehmer der in data.itemsdata.confIdidentifizierten Telefonkonferenz hinzu. multiJoin: Fügt die im Array [] angegebenen Teilnehmer der in data.itemsdata.confIdidentifizierten Telefonkonferenz hinzu. selfJoin: Fügt den aktuell angemeldeten Benutzer der Telefonkonferenz hinzu (keine Eingabe in data.items erforderlich). kick: Entfernt den im Array data.items angegebenen Teilnehmer aus der in data.confIdidentifizierten Konferenzschaltung multiKick: Entfernt die im Array data.items angegebenen Teilnehmer aus der in data.confIdidentifizierten Konferenzschaltung mute: Schaltet den im Array [] angegebenen Teilnehmer bei der in data.itemsdata.confIdidentifizierten Telefonkonferenz stumm. multiMute: Schaltet die im Array [] angegebenen Teilnehmer bei der in data.itemsdata.confIdidentifizierten Telefonkonferenz stumm. unmute: Hebt die Stummschaltung des im Array [] angegebenen Teilnehmers für die in data.itemsdata.confIdidentifizierte Konferenzschaltung auf. multiUnmute: Hebt die Stummschaltung der im Array data.items angegebenen Teilnehmer aus 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 identifizieren den Datensatz, in dem die Arbeitsnotizen hinzugefügt werden sollen. Standardwert: false Aktionen, für die dieser Parameter gültig ist: Start teilnehmen multiJoin selfJoin
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 identifizieren den Datensatz, der mehrere Telefonkonferenzen enthalten darf. Standardwert: false Aktionen, für die dieser Parameter gültig ist: Start
data.confId	Zeichenfolge	Sys-ID der Telefonkonferenz. Die Konferenz-Sys-ID befindet sich in der Notify-Telefonkonferenztabelle [notify_conference_call]. Aktionen, für die dieser Parameter erforderlich ist: Ende teilnehmen multiJoin selfJoin Hinweis: Für Teilnehmeraktionen wie Stummschalten, Aufheben der Stummschaltung und Kick muss dieser Parameter nicht festgelegt werden, da die Methode diese Informationen aus der Notify-Telefonkonferenzteilnehmer-Tabelle [notify_participant] erhält.
data.fromNumber	Zeichenfolge	Service Provider-Nummer, die für die Telefonkonferenz verwendet werden soll. 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
data.isNewConference	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
data.items	Array	Informationen für jeden Teilnehmer, der in die Telefonkonferenz aufgenommen werden soll. Gültige Array-Werte: id: Sys-ID des Benutzers; befindet sich in der Benutzertabelle [sys_User]. Gültige Aktionen: join, multiJoin, start notifyParticipantId: Sys-ID des Notify-Teilnehmers; befindet sich in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant]. Gültige Aktionen: join, kick, multiJoin, mute, start, unmute 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 E-Mail: E-Mail-Adresse des Teilnehmers. Gültige Aktionen: join, multiJoin, start
data.message	Zeichenfolge	Nachricht, die laut vorgelesen wird, wenn ein Benutzer den Anruf entgegennimmt, z. B. „P1-Incident wurde erstellt, melden Sie sich bei der Instanz an.“ Aktionen, für die dieser Parameter gültig ist: Start teilnehmen multiJoin
data.serviceProvider	Zeichenfolge	Erforderlich. Name des Konferenzserviceanbieters, 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 NotifyConference-Anruftabelle [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
data.table	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 besprochen wird. Dieser Tabellenname wird in der Spalte Tabelle der NotifyConference-Anruftabelle [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 : 6. Ergebnisse

Typ

Beschreibung

Objekt

Ergebnisse der Konferenzaktion. <action.status: Status der Konferenzaktion. Datentyp: Boolesch Gültige Werte: true: Konferenzaktion erfolgreich false: Konferenzaktion fehlgeschlagen <action.successMessages: Wenn der Status „ wahr“ ist, Erfolgsmeldung(en), sonst leer. Datentyp: Array von Zeichenfolgen <action.warnMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Warnmeldungen. Datentyp: Array von Zeichenfolgen <action.errorMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Fehlermeldungen. Datentyp: Array von Zeichenfolgen

Beispiel

(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: '[phone]' });
	data.items.push({ id: 'user4SysId', email: '[e-mail]' });

	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. Mit 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 dann die Vorlage 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 dieses Objekt an die doConferenceAction()- Methode übergeben und dasselbe Ergebnis erzielen.

Tabelle : 7. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 8. 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 identifizieren den Datensatz, in dem die Arbeitsnotizen hinzugefügt werden sollen. Standardwert: false Aktionen, für die dieser Parameter gültig ist: Start teilnehmen multiJoin selfJoin
data.allowMultconference	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 identifizieren den Datensatz, der mehrere Telefonkonferenzen enthalten darf. Standardwert: false Aktionen, für die dieser Parameter gültig ist: Start
data.confId	Sys-ID der Telefonkonferenz. Die Konferenz-Sys-ID befindet sich in der Notify-Telefonkonferenztabelle [notify_conference_call]. Aktionen, für die dieser Parameter erforderlich ist: Ende teilnehmen multiJoin selfJoin Hinweis: Für Teilnehmeraktionen wie Stummschalten, Aufheben der Stummschaltung und Kick muss dieser Parameter nicht festgelegt werden, da die Methode diese Informationen aus der Notify-Telefonkonferenzteilnehmer-Tabelle [notify_participant] erhält.
data.fromNumber	Service Provider-Nummer, die für die Telefonkonferenz verwendet werden soll. 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
data.isNewConference	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
data.items	Informationen für jeden Teilnehmer, der in die Telefonkonferenz aufgenommen werden soll. Gültige Array-Werte: id: Sys-ID des Benutzers; befindet sich in der Benutzertabelle [sys_User]. Gültige Aktionen: join, multiJoin, start notifyParticipantId: Sys-ID des Notify-Teilnehmers; befindet sich in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant]. Gültige Aktionen: join, kick, multiJoin, mute, start, unmute 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 E-Mail: E-Mail-Adresse des Teilnehmers. Gültige Aktionen: join, multiJoin, start
data.message	Nachricht, die laut vorgelesen wird, wenn ein Benutzer den Anruf entgegennimmt, z. B. „P1-Incident wurde erstellt, melden Sie sich bei der Instanz an.“ Aktionen, für die dieser Parameter gültig ist: Start teilnehmen multiJoin
data.serviceProvider	Erforderlich. Name des Konferenzserviceanbieters, 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 NotifyConference-Anruftabelle [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
data.table	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 besprochen wird. Dieser Tabellenname wird in der Spalte Tabelle der NotifyConference-Anruftabelle [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

Beispiel

(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 von Telefonanbietern in der Instanz zurück.

Mögliche Fähigkeiten umfassen:

• Archiv: Archiviert die Konferenz, nachdem sie beendet wurde
• beepOnLeave: Gibt einen Signalton ab, wenn ein Teilnehmer die Telefonkonferenz verlässt
• beepOnJoin: Gibt einen Signalton ab, wenn ein Teilnehmer der Telefonkonferenz beitritt
• end: Beendet die identifizierte Telefonkonferenz
• Dateifreigabe: 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 einer Telefonkonferenz beitritt
• multiUnmute: Hebt die Stummschaltung mehrerer Teilnehmer für eine Telefonkonferenz auf
• Datensatz: Zeichnet Telefonkonferenzen auf
• Aufzeichnung: Bietet einen Bildschirmindikator, wenn die Telefonkonferenz aufgezeichnet wird
• screenSharing: Ermöglicht die Freigabe von Teilnehmerbildschirmen für die Gruppe
• selfJoin: Fügt den aktuell angemeldeten Benutzer einer Telefonkonferenz hinzu
• Reden: Zeigt auf dem Bildschirm an, wer gerade spricht
• start: Startet die identifizierte Telefonkonferenz
• unmute (Stummschaltung aufheben): Hebt die Stummschaltung eines Teilnehmers in einer Telefonkonferenz auf

Tabelle : 9. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 10. 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 die Treiberfunktionen für alle Treiber von Telefonanbietern 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 Telefoniedienstanbieter 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(Number action)

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

Um diese Methode zu verwenden, müssen Sie zuerst die Methode getServiceProviderCapabilities() aufrufen. 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.

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 : 11. 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: Obwohl der Wert isSupported wie ein Boolean-Wert aussieht, ist er 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 : 12. Ergebnisse

Typ	Beschreibung
Boolean	Kennzeichnung, die angibt, ob der Telefoniedienstanbieter die angegebene Aktion unterstützt. Gültige Werte: true: Aktion wird vom Service Provider unterstützt false: Aktion wird vom Service Provider nicht unterstützt

Beispiel

(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 übergebenen GlideRecord zugeordnet ist, aus der aktuellen Telefonkonferenz.

Tabelle : 13. Parameter

Name	Typ	Beschreibung
notifyParticipantGR	GlideRecord	GlideRecord-Objekt des Teilnehmers, der aus der Telefonkonferenz entfernt werden soll. Diese Datensätze befinden sich in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant].

Tabelle : 14. Ergebnisse

Typ

Beschreibung

Objekt

Ergebnisse der Konferenzaktion. <action.status: Status der Konferenzaktion. Datentyp: Boolesch Gültige Werte: true: Konferenzaktion erfolgreich false: Konferenzaktion fehlgeschlagen <action.successMessages: Wenn der Status „ wahr“ ist, Erfolgsmeldung(en), sonst leer. Datentyp: Array von Zeichenfolgen <action.warnMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Warnmeldungen. Datentyp: Array von Zeichenfolgen <action.errorMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Fehlermeldungen. Datentyp: Array von Zeichenfolgen

Beispiel

(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 übergebenen GlideRecord für die aktuelle Konferenzschaltung zugeordnet ist.

Tabelle : 15. Parameter

Name	Typ	Beschreibung
notifyParticipantGR	Objekt	GlideRecord-Objekt des Teilnehmers, der stummgeschaltet werden soll. Diese Datensätze befinden sich in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant].

Tabelle : 16. Ergebnisse

Typ

Beschreibung

Objekt

Ergebnisse der Konferenzaktion. <action.status: Status der Konferenzaktion. Datentyp: Boolesch Gültige Werte: true: Konferenzaktion erfolgreich false: Konferenzaktion fehlgeschlagen <action.successMessages: Wenn der Status „ wahr“ ist, Erfolgsmeldung(en), sonst leer. Datentyp: Array von Zeichenfolgen <action.warnMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Warnmeldungen. Datentyp: Array von Zeichenfolgen <action.errorMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Fehlermeldungen. Datentyp: Array von Zeichenfolgen

Beispiel

(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 – NotifyConferenceUtils()

Instantiiert ein NotifyConferenceUtils-Objekt (Konstruktor).

Tabelle : 17. Parameter

Name	Typ	Beschreibung
Keine

Beispiel

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

	var confUtils = new NotifyConferenceUtils();
	var actionResult = confUtils.addToConferenceByPhoneNumber("[phone]", 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 – unmuteByParticipantGR(GlideRecord notifyParticipantGR)

Hebt die Stummschaltung des Teilnehmers auf, der dem übergebenen GlideRecord für die aktuelle Telefonkonferenz zugeordnet ist.

Tabelle : 18. Parameter

Name	Typ	Beschreibung
notifyParticipantGR	GlideRecord	GlideRecord-Objekt des Teilnehmers, dessen Stummschaltung aufgehoben werden soll. Diese Datensätze befinden sich in der Tabelle „Teilnehmer benachrichtigen“ [notify_participant].

Tabelle : 19. Ergebnisse

Typ

Beschreibung

Objekt

Ergebnisse der Konferenzaktion. <action.status: Status der Konferenzaktion. Datentyp: Boolesch Gültige Werte: true: Konferenzaktion erfolgreich false: Konferenzaktion fehlgeschlagen <action.successMessages: Wenn der Status „ wahr“ ist, Erfolgsmeldung(en), sonst leer. Datentyp: Array von Zeichenfolgen <action.warnMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Warnmeldungen. Datentyp: Array von Zeichenfolgen <action.errorMessages: Wenn der Status „ false“ ist, alle während der Verarbeitung ausgegebenen Fehlermeldungen. 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);
        })
    }
})();