NotifyNow (Veraltet) – Global
Die ältere NotifyNow- API bietet Funktionen zum Senden von E-Mails, Senden von SMS-Nachrichten und Einrichten von Telefonkonferenzen.
NotifyNow − addConferenceCallParticipant(String conferenceCall, String participant)
Fügt einem laufenden Konferenzanruf einen Ad-hoc-Benutzer hinzu.
Wird die Methode mit einer Telefonnummer für den Parameter „participant“ aufgerufen und es existiert genau ein „sys_user“-Datensatz, der mit der Telefonnummer übereinstimmt, wird dieser „sys_user“-Datensatz dem Teilnehmer zugeordnet. Das Feld für die Telefonnummer des Teilnehmers bleibt leer, da sich die Telefonnummer im „sys_user“-Datensatz befindet. Existieren mehrere „sys_user“-Datensätze, die mit der Telefonnummer übereinstimmen, oder wenn keine Ergebnisse vorliegen, wird das Feld mit der Telefonnummer des Teilnehmers ausgefüllt und es wird kein Verweis auf den „sys_user“ gespeichert, da der Benutzer nicht bekannt ist.
| Name | Typ | Beschreibung |
|---|---|---|
| Konferenzanruf | Zeichenfolge oder GlideRecord | Die „sys_id“ oder GlideRecord eines aktiven Konferenzgesprächs. |
| Teilnehmer | Zeichenfolge oder GlideRecord | Die „sys_id“ oder der GlideRecord eines Benutzers mit einer E.164-konformen Telefonnummer oder eine E.164-konforme Telefonnummer. |
| Typ | Beschreibung |
|---|---|
| GlideRecord | Der Teilnehmerdatensatz des neuen Teilnehmers, der zum Konferenzanruf hinzugefügt wurde. |
// add a new participant by conference call sys_id (string) and phone number (string)
var nn = new SNC.NotifyNow();
gs.log(nn.addConferenceCallParticipant('d193b242eb020100a04d4910f206fe39', '+31612345678'));
// add a new participant by conference call sys_id (string) and user record (GlideRecord)
var user = new GlideRecord('sys_user');
user.query('user_name', 'myUserName');
if (user.hasNext() && user.next()) {
var nn = new SNC.NotifyNow();
gs.log(nn.addConferenceCallParticipant('d193b242eb020100a04d4910f206fe39', user));
// you could have added the user by sys_id as well:
// nn.addConferenceCallParticipant('d193b242eb020100a04d4910f206fe39', user.getValue('sys_id'));
} else {
gs.log('no such user');
}
// add a new participant by conference call record (GlideRecord) and phone number (string)
var conferenceCall = new GlideRecord('notifynow_conference_call');
conferenceCall.query('title', 'IA0001001');
if (conferenceCall.hasNext() && conferenceCall.next()) {
var nn = new SNC.NotifyNow();
gs.log(nn.addConferenceCallParticipant(conferenceCall, '+31612345678'));
} else {
gs.log('no such conference call');
}
NotifyNow − getReadyState()
Gibt an, ob Notify richtig eingerichtet ist oder nicht.
Auf diese Methode können nur Administratoren oder Benutzer mit der Rolle „notifynow_admin“ zugreifen. Benutzer aller anderen Rollen erhalten die Meldung „falsch“ bei dem Versuch, die Funktion in einem Skript auszuführen.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn Notify richtig eingerichtet ist, andernfalls „false“. |
var nn = new SNC.NotifyNow();
gs.log(((nn.getReadyState()) ? "OK" : "NOT OK"));
NotifyNow – getStatus()
Gibt den aktuellen Status der Notify-Konfiguration zurück.
Auf diese Methode können nur Administratoren oder Benutzer mit der Rolle „notifynow_admin“ zugreifen. Benutzer aller anderen Rollen erhalten die Meldung „nicht autorisiert“ bei dem Versuch, die Funktion in einem Skript auszuführen.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Zeichenfolge | Eine der möglichen Statusmeldungen.
|
var nn = new SNC.NotifyNow();
gs.log(nn.getStatus());
9=NotifyNow – initiateConferenceCall(String[] conferenceCallParticipants, String conferenceCallTitle)
Initiieren eines neuen Konferenzanrufs.
| Name | Typ | Beschreibung |
|---|---|---|
| conferenceCallParticipants | Zeichenfolge | Ein oder mehrere Benutzer, Konferenzanrufteilnehmer, identifiziert durch die „sys_ids“ aus der Tabelle „sys_user“ oder durch E.164-konforme Telefonnummern. |
| conferenceCallTitle | Zeichenfolge | Titel des Konferenzanrufs. Dieser Parameter darf maximal 40 Zeichen lang sein. |
| Typ | Beschreibung |
|---|---|
| GlideRecord | Der Datensatz des Konferenzanrufs oder Null, wenn ein Fehler aufgetreten ist. |
Dadurch wird ein Konferenzanruf mit E.164-konformen Telefonnummern für Teilnehmer ohne den optionalen Parameter für den Quelldatensatz initiiert und es werden keine Konferenzanrufdetails per SMS oder E-Mail gesendet.
var participants = ['+31205655548', '+31205655552', '+31652825393'];
// set up conference call
var nn = new SNC.NotifyNow();
var conferenceCall = nn.initiateConferenceCall(participants, "testing12");
gs.log('started conference call: ' + conferenceCall.getUniqueValue()); NotifyNow – initiateConferenceCall(String[] conferenceCallParticipants, String conferenceCallTitle, GlideRecord sourceRecord, Boolean private)
Initiieren eines neuen Konferenzanrufs.
| Name | Typ | Beschreibung |
|---|---|---|
| conferenceCallParticipants | Zeichenfolge | Ein oder mehrere Benutzer, Konferenzanrufteilnehmer, identifiziert durch die „sys_ids“ aus der Tabelle „sys_user“ oder durch E.164-konforme Telefonnummern. |
| conferenceCallTitle | Zeichenfolge | Titel des Konferenzanrufs. Dieser Parameter darf maximal 40 Zeichen lang sein. |
| sourceRecord | GlideRecord | Quelldatensatz, der dem Konferenzanruf zugeordnet werden soll, beispielsweise eine Incident- oder Problemnummer. |
| Privat | Boolean | Wert zur Kontrolle, ob ein Konferenzanruf privat ist. Dieser Wert ist standardmäßig auf „falsch“ gesetzt. |
| Typ | Beschreibung |
|---|---|
| GlideRecord | Der Datensatz des Konferenzanrufs oder Null, wenn ein Fehler aufgetreten ist. |
Dadurch wird ein Konferenzanruf mit Teilnehmern mit einer E.164-konformen Telefonnummer und Teilnehmern aus der Tabelle „sys_user“ initiiert, und die Konferenzanrufdaten werden per SMS und E-Mail an alle Teilnehmer gesendet.
// define phone number participants
var participants = ['+31205655548', '+31205655552', '+31652825393'];
// we also want to add two Dutch sys_user participants
var user = new GlideRecord('sys_user');
user.addNotNullQuery('mobile_phone');
user.addQuery('mobile_phone', 'STARTSWITH', '+316');
user.setLimit(2);
user.query();
// add users to the participant array
while (user.hasNext() && user.next()) {
gs.log('adding user ' + user.getValue('name') + ' with phone number ' +
user.getValue('mobile_phone') + ' to the participant array');
participants.push(user.getUniqueValue());
}
// define a source record to associate with the conference call
var source = new GlideRecord("cmdb_ci");
source.query("asset_tag", "P1000167");
if (source.hasNext() && source.next()) {
// set up conference call
var nn = new SNC.NotifyNow();
var conferenceCall = nn.initiateConferenceCall(participants, "testing 1 2", source);
// check if the conference call was successfully created
if (conferenceCall != null) {
gs.log('started conference call: ' + conferenceCall.getUniqueValue());
} else {
gs.log('could not start the conference call :(');
}
} NotifyNow − isCallable(String participant)
Bestimmt, ob ein Benutzer angerufen werden kann oder nicht.
Ein Benutzer muss über eine gültige Telefonnummer verfügen, um angerufen werden zu können. Ein Benutzer, der sich bereits in einer aktiven Sitzung befindet, kann nicht angerufen werden.
| Name | Typ | Beschreibung |
|---|---|---|
| Teilnehmer | Zeichenfolge oder GlideRecord | Ein „sys_user“- oder „notifynow_participant“-Datensatz oder eine E.164-kompatible Telefonnummer. |
| Typ | Beschreibung |
|---|---|
| Boolean | Gibt an, ob dieser Teilnehmer angerufen werden kann. |
var nn = new SNC.NotifyNow();
gs.log('by number: ' + nn.isCallable('+31612345678'));
var user = GlideRecord('sys_user');
user.query('sys_id', '13d39544eb5201003cf587b9d106fea9');
if (user.hasNext() && user.next())
gs.log('by user: ' + nn.isCallable(user));
var participant = GlideRecord('notifynow_participant');
participant.query('sys_id', '33b11430eb1201003cf587b9d106feb9');
if (participant.hasNext() && participant.next())
gs.log('by participant: ' + nn.isCallable(participant));
NotifyNow - isSMSCapable ()
Überprüft, ob die mit dem Twilio-Konto verknüpfte Telefonnummer SMS-Nachrichten senden kann.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | Gibt an, ob über die mit dem Twilio-Account verknüpfte Telefonnummer SMS-Nachrichten versendet werden können. |
gs.log('The twilio number is SMS capable: ' + ((new SNC.NotifyNow().isSMSCapable()) ? 'yes' : 'no'));
NotifyNow − isSMSCapable(String userID)
Überprüft, ob ein Benutzer SMS-Nachrichten senden kann.
| Name | Typ | Beschreibung |
|---|---|---|
| userID | Zeichenfolge | Die „sys_id“ des Benutzers, den Sie auf eine SMS-fähige Telefonnummer prüfen möchten. |
| Typ | Beschreibung |
|---|---|
| Boolean | Gibt an, ob der Benutzer SMS-Nachrichten senden kann. |
gs.log('the user is able to send SMS messages (e.g. has a SMS device): ' + ((new SNC.NotifyNow().isSMSCapable('<user sys_id>')) ?
'yes' : 'no'));
NotifyNow − isVoiceCapable()
Überprüft, ob die mit dem Twilio-Konto verknüpfte Telefonnummer Telefonanrufe führen kann.
| Name | Typ | Beschreibung |
|---|---|---|
| Keine |
| Typ | Beschreibung |
|---|---|
| Boolean | Gibt an, ob die mit dem Twilio-Account verknüpfte Telefonnummer Telefonanrufe führen kann. |
gs.log('the Twilio number is Voice capable: ' + ((new SNC.NotifyNow().isVoiceCapable()) ? 'yes' : 'no'));
NotifyNow − isVoiceCapable(String userID)
Prüft, ob ein Benutzer Sprachanrufe tätigen kann.
| Name | Typ | Beschreibung |
|---|---|---|
| userID | Zeichenfolge | Die „sys_id“ des Benutzers, den Sie auf eine sprachanruffähige Telefonnummer prüfen möchten. |
| Typ | Beschreibung |
|---|---|
| Boolean | Gibt an, ob der Benutzer eine sprachanruffähige Telefonnummer hat. |
gs.log('the user is able to send SMS messages (e.g. has a SMS device): ' +
((new SNC.NotifyNow().isVoiceCapable('someuserid')) ? 'yes' : 'no'));
NotifyNow − kick(GlideRecord participant)
Entfernt einen Teilnehmer aus einem Konferenzanruf.
| Name | Typ | Beschreibung |
|---|---|---|
| Teilnehmer | GlideRecord | Der Konferenzanrufteilnehmer, der aus dem Anruf entfernt werden soll. |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn der Teilnehmer entfernt wurde, andernfalls „false“. |
var participantId = "<participant sys_id>";
var participant = new GlideRecord('notifynow_participant');
participant.get(participantId);
if (participant.isValid()) {
// kick participant
result = new SNC.NotifyNow().kick(participant);
gs.log('participant kicked: ' + result);
}
NotifyNow − mute(GlideRecord participant)
Schaltet einen Teilnehmer beim Konferenzanruf stumm.
| Name | Typ | Beschreibung |
|---|---|---|
| Teilnehmer | GlideRecord | Der Teilnehmer des Konferenzanrufs, der stummgeschaltet werden soll. |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn der Teilnehmer stummgeschaltet wurde, andernfalls „false“. |
var participantId = "<participant sys_id>";
var participant = new GlideRecord('notifynow_participant');
participant.get(participantId);
if (participant.isValid()) {
// mute participant
result = new SNC.NotifyNow().mute(participant);
gs.log('participant muted: ' + result);
}
NotifyNow – umute(GlideRecord participant)
Hebt die Stummschaltung eines Teilnehmers bei einer Telefonkonferenz auf.
| Name | Typ | Beschreibung |
|---|---|---|
| Teilnehmer | GlideRecord | Der stummgeschaltete Konferenzanrufteilnehmer, für den die Stummschaltung aufgehoben werden soll. |
| Typ | Beschreibung |
|---|---|
| Boolean | „True“, wenn die Stummschaltung des Teilnehmers aufgehoben wurde, andernfalls „false“. |
var participantId = "<participant sys_id>";
var participant = new GlideRecord('notifynow_participant');
participant.get(participantId);
if (participant.isValid()) {
// unmute participant
result = new SNC.NotifyNow().unmute(participant);
gs.log('participant unmuted: ' + result);
}
NotifyNow – sendEmailQuestion(String emailAddress, String question, GlideRecord sourceRecord, String emailSubject)
Senden einer E-Mail-Anfrage an eine E-Mail-Adresse.
Die „sendEmailQuestion“-Methode erzeugt einen Anfragetext und erfordert, dass Benutzer auf einen Link klicken, um ihre Auswahl anzugeben.
| Name | Typ | Beschreibung |
|---|---|---|
| emailAddress | Zeichenfolge | E-Mail-Adresse, an die die Anfrage gesendet werden soll. |
| question | Zeichenfolge oder GlideRecord | Der zu sendende Anfragedatensatz oder die „sys_id“ eines Anfragedatensatzes. |
| sourceRecord | GlideRecord | Ein optionaler Quelldatensatz, der der SMS-Anfrage zugeordnet werden soll, beispielsweise ein Incident. |
| emailSubject | Zeichenfolge | Optionaler Text zum Überschreiben des Standard-E-Mail-Betreffs. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die „sys_id“ der Konversation. |
Dieses Beispiel zeigt die Verwendung des Standard-E-Mail-Betreffs.
var user = GlideRecord("sys_user");
user.get("email", "someone@somedomain.com");
new SNC.NotifyNow().sendEmailQuestion(user.getValue('email'), "b6b34500bf3111003cf585ce2c0739ce", user); In diesem Beispiel wird Dot-Walking verwendet, und ein Quelldatensatz und ein E-Mail-Betreff angegeben.
new SNC.NotifyNow().sendEmailQuestion("someone@somedomain.com", "b6071733bf1111003cf585ce2c07390f", current,
"Please answer this question"); In diesem Beispiel wird Dot-Walking verwendet, und ein E-Mail-Betreff angegeben, jedoch kein Quelldatensatz.
new SNC.NotifyNow().sendEmailQuestion("someone@somedomain.com", "b6071733bf1111003cf585ce2c07390f",
"Please answer this question"); NotifyNow – sendSMS(String phoneNumber, String smsBody)
Sendet eine SMS-Nachricht an eine E.164-konforme Mobiltelefonnummer.
Notify unterstützt internationale Telefonnummern. Wenn Sie diese Methode mit einer Telefonnummer verwenden, die das Senden von SMS-Nachrichten nicht unterstützt, wird ein Fehler protokolliert.
| Name | Typ | Beschreibung |
|---|---|---|
| phoneNumber | Zeichenfolge | Die E.164-konforme Telefonnummer, an die die Nachricht gesendet werden soll. |
| smsBody | Zeichenfolge | Die zu sendende Nachricht, maximal 1600 Zeichen. |
| Typ | Beschreibung |
|---|---|
| void |
new SNC.NotifyNow().sendSMS("+31612345678", "This is a message without source record");
NotifyNow – sendSMS(String phoneNumber, String smsBody, GlideRecord source)
Sendet eine SMS-Nachricht an eine E.164-konforme Mobiltelefonnummer.
Notify unterstützt internationale Telefonnummern. Wenn Sie diese Methode mit einer Telefonnummer verwenden, die das Senden von SMS-Nachrichten nicht unterstützt, wird ein Fehler protokolliert.
Siehe auch: Erweiterte Konfiguration für SMS.
| Name | Typ | Beschreibung |
|---|---|---|
| phoneNumber | Zeichenfolge | Die E.164-konforme Telefonnummer, an die die Nachricht gesendet werden soll. |
| smsBody | Zeichenfolge | Die zu sendende Nachricht, maximal 1600 Zeichen. |
| Quelle | GlideRecord | Der Quelldatensatz, der dieser SMS-Nachricht zugeordnet werden soll. |
| Typ | Beschreibung |
|---|---|
| nichtig |
var source = new GlideRecord("my_table");
source.query("my_field", "my_value");
if (source.hasNext() && source.next()) {
// send a text message
var nn = new SNC.NotifyNow();
var message = "this is just a test";
var number = "+31612345678";
nn.sendSMS(number, message, source);
}
In diesem Beispiel werden Dot-Walking und der aktuelle Datensatz als Quelldatensatz verwendet.
new SNC.NotifyNow().sendSMS("+31612345678", "this is a test", current);
NotifyNow − sendSMSQuestion(String phoneNumber, String question, GlideRecord sourceRecord)
Sendet eine SMS-Anfrage.
| Name | Typ | Beschreibung |
|---|---|---|
| phoneNumber | Eine E.164-konforme Telefonnummer, an die die Nachricht gesendet werden soll. | |
| question | Zeichenfolge oder GlideRecord | Der zu sendende Anfragedatensatz oder die „sys_id“ eines Anfragedatensatzes. |
| sourceRecord | Ein optionaler Quelldatensatz, der der SMS-Anfrage zugeordnet werden soll, beispielsweise ein Incident. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die „sys_id“ der Konversation oder Null, wenn die SMS nicht erfolgreich gesendet wurde. |
var question = new GlideRecord("notifynow_question");
question.query();
// get the first question
if (question.hasNext() && question.next()) {
// send the sms question
var number = "+31612345678";
var nn = new SNC.NotifyNow();
nn.sendSMSQuestion(number, question.getUniqueValue(), current);
}
NotifyNow − convertLocalPhoneNumberToE164(String userID, String phoneNumber)
Konvertiert eine lokale Telefonnummer in eine E.164-konforme Telefonnummer, basierend auf dem Standort des Benutzers.
| Name | Typ | Beschreibung |
|---|---|---|
| userID | Zeichenfolge | Die „sys_id“ eines „sys_user“-Datensatzes, von dem Standortinformationen abgerufen werden sollen. |
| phoneNumber | Zeichenfolge | Telefonnummer |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die E.164-konforme Telefonnummer. |
var localPhoneNumber = '01784 221600';
var userName = 'Heath Vanalphen';
var user = new GlideRecord('sys_user');
user.get('name',userName);
var E164Number = new SNC.NotifyNow().convertLocalPhoneNumberToE164(user.getUniqueValue(), localPhoneNumber);
gs.log('converted: ' + localPhoneNumber + ' to ' + E164Number + ' based on ' + user.getValue('name') +
'\'s location (' + user.getValue('location') + ')');
NotifyNow − getConferenceCallParticipants(String conferenceCallId, Boolean isCallable)
Gibt alle Teilnehmer an einem Konferenzanruf zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| conferenceCallId | Zeichenfolge | Die ID des Konferenzanrufs. |
| isCallable | Boolean | Ein optionales Flag, um entweder nur die Benutzer zurückzugeben, die angerufen (wahr) oder nicht angerufen (falsch) werden können. |
| Typ | Beschreibung |
|---|---|
| GlideRecord | Die Teilnehmer |
var nn = new SNC.NotifyNow();
var user = nn.getConferenceCallParticipants('c2e91710eb120100f34087b9d106fe37');
while (user.hasNext() && user.next()) {
if (user.getValue('participant')) {
gs.log('user: ' + user.getValue('sys_id'));
} else {
gs.log('phone number: ' + user.getValue('phone_number'));
}
}
var nn = new SNC.NotifyNow();
var user = nn.getConferenceCallParticipants('c2e91710eb120100f34087b9d106fe37', true);
while (user.hasNext() && user.next()) {
if (user.getValue('participant')) {
gs.log('user: ' + user.getValue('sys_id'));
} else {
gs.log('phone number: ' + user.getValue('phone_number'));
}
}
var conferenceCallId = '32b11430eb1201003cf587b9d106feb8';
// get all participants
gs.log('all conference call participants:');
var nn = new SNC.NotifyNow();
var user = nn.getConferenceCallParticipants(conferenceCallId);
gs.log(user);
// get all callable participants
gs.log('all conference call participants we can call:');
user = nn.getConferenceCallParticipants(conferenceCallId, true);
gs.log(user);
// get all un callable participants
gs.log('all conference call participants that are already in an active session and whom we cannot call:');
user = nn.getConferenceCallParticipants(conferenceCallId, false);
gs.log(user);
NotifyNow − FrequentlyCalledUsers(Number limit)
Gibt eine Anzahl von häufig angerufenen Benutzern in alphabetischer Reihenfolge bis zum Parameter „limit“ zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| limit | Zahl | Die maximale Anzahl von Ergebnissen. |
| Typ | Beschreibung |
|---|---|
| GlideRecord | Die häufig angerufenen Benutzer in alphabetischer Reihenfolge. |
var nn = new SNC.NotifyNow();
var fc = nn.getFrequentlyCalledUsers(10);
while (fc.hasNext() && fc.next()) {
gs.log("got user " + fc.getValue('name') + ' - ' + fc.getValue('sys_id'));
}
NotifyNow − getPreferredE164SMSNumber(GlideRecord user)
Gibt die bevorzugte E.164-konforme Telefonnummer eines Benutzers für SMS-Nachrichten zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Anwender | GlideRecord oder Zeichenfolge | Der Benutzerdatensatz oder die „sys_id“ eines Benutzers, von dem die E.164-konforme Telefonnummer abgerufen wird. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die E.164-konforme Telefonnummer oder Null. |
var userID = "<user sys_id>";
var E164Number = new SNC.NotifyNow().getPreferredE164SMSNumber(userID);
gs.log('the preferred phone number for sending SMS notifications is ' + E164Number + ' for user with id: ' + userID);
NotifyNow − getPreferredE164VoiceNumber(GlideRecord user)
Gibt die bevorzugte E.164-konforme Telefonnummer eines Benutzers für Sprachanrufe zurück.
| Name | Typ | Beschreibung |
|---|---|---|
| Anwender | GlideRecord oder Zeichenfolge | Der Benutzerdatensatz oder die „sys_id“ eines Benutzers, von dem die E.164-konforme Telefonnummer abgerufen wird. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die E.164-konforme Telefonnummer oder Null. |
var userID = "<user sys_id>";
var E164Number = new SNC.NotifyNow().getPreferredE164VoiceNumber(userID);
gs.log('the preferred phone number for setting up voice calls is ' + E164Number + ' for user with id: ' + userID);
NotifyNow – getPreferredEmailAddress(GlideRecord user)
Gibt die bevorzugte E-Mail-Adresse eines Benutzers zurück
| Name | Typ | Beschreibung |
|---|---|---|
| Anwender | GlideRecord oder Zeichenfolge | Der Benutzerdatensatz oder die „sys_id“ eines Benutzers, von dem die E-Mail-Adresse abgerufen wird. |
| Typ | Beschreibung |
|---|---|
| Zeichenfolge | Die E-Mail-Adresse oder Null. |
var userID = "some user sys id";
var email = new SNC.NotifyNow().getPreferredEmailAddress(userID);
gs.log('the preferred email address for sending email notifications is ' + email + ' for user with id: ' + userID);