NotifyConferenceUtil - 범위가 지정됨, 전역

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기31분
  • NotifyConferenceUtil API는 및 Webex와 같은 Zoom 다양한 전화 통신 서비스 공급자에 대한 알림 전화 회의 및 SMS 메시지를 관리하는 메서드를 제공합니다.

    NotifyConferenceUtil API를 사용하여 다음을 수행할 수 있습니다.

    • 새 컨퍼런스 회의 생성
    • 전화번호 또는 사용자 ID로 참가자 추가
    • 전화 회의에서 참가자 제거
    • 전화 회의에서 참가자 음소거
    • 전화 회의에서 참가자 음소거 해제
    • 지정된 서비스 제공자의 역량 확보
    • 전화 회의 종료

    범위가 지정된 스크립트와 전역 스크립트 모두에서 이 API를 사용할 수 있습니다. 이 API를 사용하려면 별도의 구독이 필요한 회의 알림 플러그인(com.snc.notify)을 활성화해야 합니다. 이 플러그인 활성화에 대한 자세한 내용은 알림 활성화를 참조하십시오.

    NotifyConferenceUtils 알림 - 알림 ConferenceUtils()

    NotifyConferenceUtils 개체(생성자)를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    안 함
    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);
    		})
    	}
    })();

    알림 ConferenceUtils - addToConferenceByPhoneNumber(String toNumber, GlideRecord confGR)

    전화 번호를 사용해 지정된 전화 회의에 참가자를 추가하여 참가자를 식별합니다.

    표 2. 매개변수
    이름 유형 설명
    toNumber 문자열 전화 회의에 추가할 참가자의 전화 번호입니다.
    confGR GlideRecord 지정된 참가자를 추가할 전화 회의의 GlideRecord입니다.

    테이블: 알림 전화 회의[notify_conference_call]

    표 3. 반환
    유형 설명
    객체 회의 작업의 결과입니다.

    <action>.status: 회의 작업의 상태입니다.

    • 데이터 유형: 부울
    • 가능한 값:
      • true: 회의 작업 성공
      • false: 회의 작업 실패

    <action>.successMessages: 상태가 예이면, 성공 메시지, 그렇지 않으면 비어 있습니다.

    • 데이터 유형: 문자열 배열

    <action>.warnMessages: 상태가 false인 경우 처리 중에 발생하는 경고 메시지입니다.

    • 데이터 유형: 문자열 배열

    <action>.errorMessages: 상태가 false인 경우 처리 중에 발생한 오류 메시지입니다.

    • 데이터 유형: 문자열 배열

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    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);
    		})
    	}
    })();

    알림 ConferenceUtils - addToConferenceByUserId(String userId, GlideRecord confGR)

    고유 사용자 식별자를 사용하여 전달된 GlideRecord에서 참조하는 전화 회의에 참가자를 추가합니다.

    표 4. 매개변수
    이름 유형 설명
    userID 문자열 지정된 전화 회의에 추가할 참가자의 시스템 ID입니다.

    테이블: 사용자 [sys_user]

    confGR GlideRecord 지정된 참가자를 추가하기 위한 전화 회의의 GlideRecord

    테이블: 알림 전화 회의[notify_conference_call]

    표 5. 반환
    유형 설명
    객체 회의 작업의 결과입니다.

    <action>.status: 회의 작업의 상태입니다.

    • 데이터 유형: 부울
    • 가능한 값:
      • true: 회의 작업 성공
      • false: 회의 작업 실패

    <action>.successMessages: 상태가 예이면, 성공 메시지, 그렇지 않으면 비어 있습니다.

    • 데이터 유형: 문자열 배열

    <action>.warnMessages: 상태가 false인 경우 처리 중에 발생하는 경고 메시지입니다.

    • 데이터 유형: 문자열 배열

    <action>.errorMessages: 상태가 false인 경우 처리 중에 발생한 오류 메시지입니다.

    • 데이터 유형: 문자열 배열

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

    (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(문자열 작업, 객체 데이터)

    전화 회의 시작/종료, 전화 회의에서 참가자 참가, 제거, 음소거 또는 음소거 해제 등 지정된 전화 회의 작업을 수행합니다.

    새 전화 회의를 시작하고 이 메서드에 대한 단일 호출 내에 참가자를 추가하거나, 메서드를 여러 번 호출하여 호출을 시작한 다음 참가자를 개별적으로 관리할 수 있습니다. 또한 전달된 데이터 객체를 통해 다음과 같이 메서드를 구성할 수 있습니다.
    • 전화 회의 기록에 전화 회의의 논의 주제인 인시던트 또는 문제 등의 특정 기록(소스 기록)에 대한 포인터를 저장합니다.
    • 소스 기록에 대해 여러 컨퍼런스 회의를 허용/허용하지 않습니다.
    • 소스 기록의 "작업 메모" 필드에 전화 회의에 참여했던 참가자를 자동으로 로깅합니다.
    • 참가자가 회의에서 걸려오는 전화에 응답할 때 메시지를 소리 내어 읽게 합니다.
    표 6. 매개변수
    이름 유형 설명
    작업 문자열 수행할 전화 회의 작업을 정의합니다.
    사용 가능한 컨퍼런스 회의 작업은 다음과 같습니다.
    • 종료: 에서 식별 data.confId된 전화 회의를 종료합니다.
    • join: 배열에 data.items 지정된 참가자를 에서 data.confId식별된 전화 회의에 추가합니다.
    • kick: 에서 식별data.confId된 전화 회의에서 배열에 data.items 지정된 참가자를 제거합니다.
    • multiJoin: 배열에 data.items 지정된 참가자를 다음에서 식별된 전화 회의에 추가합니다. data.confId
    • multiKick: 에서 식별data.confId된 전화 회의에서 배열에 data.items 지정된 참가자를 제거합니다.
    • multiMute: 에서 식별data.confId된 전화 회의에서 배열에 data.items 지정된 참가자를 음소거합니다.
    • multiUnmute: 에서 식별data.confId된 전화 회의에서 배열에 data.items 지정된 참가자를 음소거 해제합니다.
    • 음소거: 에서 식별data.confId된 전화 회의의 배열에 data.items 지정된 참가자를 음소거합니다.
    • selfJoin: 현재 로그인한 사용자를 전화 회의에 추가합니다(입력 data.items 필요 없음).
    • start: 에서 식별 data.confId된 전화 회의를 시작합니다.
    • unmute: 에서 식별data.confId된 전화 회의에서 배열에 data.items 지정된 참가자를 음소거 해제합니다.
    데이터 객체 전화 회의를 설명하는 객체입니다.
    data.addToWorkNotes 부울 관련 기록의 작업 메모 필드에 전화 회의에 포함된 참가자에 대한 정보를 추가할지 여부를 나타내는 플래그입니다.

    이 기능이 작동하려면 and data.sysId 매개 변수의 값 data.table 도 지정해야 합니다. 이러한 매개변수는 작업 메모를 추가할 기록을 식별합니다.

    기본값: false

    이 매개변수가 유효한 작업:

    • 가입
    • 멀티조인
    • 셀프조인
    • 시작
    data.allowMulticonference 부울 특정 기록에 대해 한 번에 여러 컨퍼런스 회의를 허용할지 여부를 나타내는 플래그입니다.

    이 기능이 작동하려면 and data.sysId 매개 변수의 값 data.table 도 지정해야 합니다. 이러한 매개변수는 여러 컨퍼런스 회의를 가질 수 있는 기록을 식별합니다.

    기본값: false

    이 매개변수가 유효한 작업:

    • 시작
    데이터.confId 문자열 전화 회의의 Sys_id입니다.

    테이블: 알림 전화 회의[notify_conference_call]

    이 매개변수가 필요한 작업:

    • 가입
    • 멀티조인
    • 셀프조인
    주:
    메서드가 알림 전화 회의 참가자[notify_participant] 테이블에서 이 정보를 가져오므로 참가자 작업(예: 음소거, 음소거 해제 및 킥)의 경우 이 매개변수를 설정할 필요가 없습니다.
    데이터.fromNumber 문자열 전화 회의를 위해 호출할 서비스 제공자 번호입니다.

    알림 전화 번호 [notify_number] 테이블의 번호 또는 전화 번호 열에서 이 값을 찾습니다.

    이 매개변수가 필요한 작업:

    • 시작
    data.isNewConference 부울 새 컨퍼런스 회의인지 기존 컨퍼런스 회의인지 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • true: 새 컨퍼런스 회의
    • false: 기존 컨퍼런스 회의

    기본값: false

    이 매개변수가 유효한 작업:

    • 시작
    데이터.항목 배열 각 참가자가 전화 회의에 포함할 정보입니다.

    유효한 배열 값:

    • ID: 사용자의 Sys_id; 사용자 [sys_User] 테이블에 있습니다.

      유효한 작업: join, multiJoin, start

    • notifyParticipantId: 알림 참가자의 시스템 ID입니다. 알림 참가자 [notify_participant] 테이블에 있습니다.

      유효한 작업: join, kick, multiJoin, mute, start, unmute

    • phoneNumber: 참가자의 전화 번호입니다. 이 값이 OR notifyParticipantIdid 함께 전달되면 이 값은 사용자/참가자 기록의 전화 번호를 대체하며 전화를 거는 데 사용됩니다.

      유효한 작업: join, multiJoin, start

    • 이메일: 참가자의 이메일 주소입니다.

      유효한 작업: join, multiJoin, start

    data.message 문자열 사용자가 호출에 응답할 때 소리내어 읽어주는 메시지입니다(예: "P1 인시던트가 생성되었습니다. 인스턴스에 로그인하십시오.").

    이 매개변수가 유효한 작업:

    • 가입
    • 멀티조인
    • 시작
    data.serviceProvider 문자열 필수. Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다.

    이 매개변수가 필요한 작업:

    • 모두
    데이터.sysId 문자열 전화 회의와 연결할 소스 기록의 Sys_id입니다.

    예를 들어 특정 인시던트나 문제를 논의하기 위해 전화 회의가 열리는 경우 인시던트 또는 문제 기록의 sys_id 이 값에 입력합니다. 이 sys_id NotifyConference Call [notify_conference_call] 테이블의 소스 열에 저장되며 나중에 추적할 수 있습니다.

    이 매개 변수는 , data.addToWorkNotesallowMulticonference 매개 변수와 data.Table함께 사용됩니다.

    이 매개변수가 유효한 작업:

    • 시작
    데이터.테이블 문자열 전화 회의와 연결할 소스 기록이 들어 있는 테이블입니다. 소스 기록은 전화 회의에서 논의되는 "인시던트" 또는 "문제"와 같은 기록일 수 있습니다.

    이 테이블 이름은 알림 전화 회의 [notify_conference_call] 테이블의 테이블 열에 저장되며 추적할 수 있습니다.

    이 매개 변수는 , data.addToWorkNotesallowMulticonference 매개 변수와 data.sysId함께 사용됩니다.

    이 매개변수가 유효한 작업:

    • 시작
    표 7. 반환
    유형 설명
    객체 회의 작업의 결과입니다.

    <action>.status: 회의 작업의 상태입니다.

    • 데이터 유형: 부울
    • 가능한 값:
      • true: 회의 작업 성공
      • false: 회의 작업 실패

    <action>.successMessages: 상태가 예이면, 성공 메시지, 그렇지 않으면 비어 있습니다.

    • 데이터 유형: 문자열 배열

    <action>.warnMessages: 상태가 false인 경우 처리 중에 발생하는 경고 메시지입니다.

    • 데이터 유형: 문자열 배열

    <action>.errorMessages: 상태가 false인 경우 처리 중에 발생한 오류 메시지입니다.

    • 데이터 유형: 문자열 배열
    (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');
    

    알림 전화 회의 유틸리티 - getConferenceInputDataTemplate()

    doConferenceAction() 메서드와 함께 사용할 JSON 데이터 템플릿을 반환합니다. 이 템플릿을 사용하면 데이터 객체가 자동으로 구조화되므로 수동으로 만들 필요가 없습니다.

    doConferenceAction() 메서드를 호출하기 전에 이 메서드를 호출합니다. 원하는 전화 회의 작업을 위해 템플릿 내에서 원하는 매개변수를 설정한 다음 doConferenceAction() 호출에서 템플릿을 전달합니다. 각 작업의 유효한 매개변수에 대한 자세한 내용은 doConferenceAction()을 참조하십시오.

    주:
    도우미 메서드입니다. 이 객체를 수동으로 생성하고 해당 객체를 doConferenceAction() 메서드에 전달해도 동일한 결과를 얻을 수 있습니다.
    표 8. 매개변수
    이름 유형 설명
    없음
    표 9. 반환
    유형 설명
    데이터 전화 회의를 설명하는 객체입니다.
    data.addToWorkNotes 관련 기록의 작업 메모 필드에 전화 회의에 포함된 참가자에 대한 정보를 추가할지 여부를 나타내는 플래그입니다.

    이 기능이 작동하려면 and data.sysId 매개 변수의 값 data.table 도 지정해야 합니다. 이러한 매개변수는 작업 메모를 추가할 기록을 식별합니다.

    기본값: false

    이 매개변수가 유효한 작업:

    • 가입
    • 멀티조인
    • 셀프조인
    • 시작
    data.allowMultconference 특정 기록에 대해 한 번에 여러 컨퍼런스 회의를 허용할지 여부를 나타내는 플래그입니다.

    이 기능이 작동하려면 and data.sysId 매개 변수의 값 data.table 도 지정해야 합니다. 이러한 매개변수는 여러 컨퍼런스 회의를 가질 수 있는 기록을 식별합니다.

    기본값: false

    이 매개변수가 유효한 작업:

    • 시작
    데이터.confId 전화 회의의 Sys_id입니다.

    테이블: 알림 전화 회의[notify_conference_call]

    이 매개변수가 필요한 작업:

    • 가입
    • 멀티조인
    • 셀프조인
    주:
    메서드가 알림 전화 회의 참가자[notify_participant] 테이블에서 이 정보를 가져오므로 참가자 작업(예: 음소거, 음소거 해제 및 킥)의 경우 이 매개변수를 설정할 필요가 없습니다.
    데이터.fromNumber 전화 회의를 위해 호출할 서비스 제공자 번호입니다.

    알림 전화 번호 [notify_number] 테이블의 번호 또는 전화 번호 열에서 이 값을 찾습니다.

    이 매개변수가 필요한 작업:

    • 시작
    data.isNewConference 새 컨퍼런스 회의인지 기존 컨퍼런스 회의인지 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • true: 새 컨퍼런스 회의
    • false: 기존 컨퍼런스 회의

    기본값: false

    이 매개변수가 유효한 작업:

    • 시작
    데이터.항목 각 참가자가 전화 회의에 포함할 정보입니다.

    유효한 배열 값:

    • ID: 사용자의 Sys_id; 사용자 [sys_User] 테이블에 있습니다.

      유효한 작업: join, multiJoin, start

    • notifyParticipantId: 알림 참가자의 시스템 ID입니다. 알림 참가자 [notify_participant] 테이블에 있습니다.

      유효한 작업: join, kick, multiJoin, mute, start, unmute

    • phoneNumber: 참가자의 전화 번호입니다. 이 값이 OR notifyParticipantIdid 함께 전달되면 이 값은 사용자/참가자 기록의 전화 번호를 대체하며 전화를 거는 데 사용됩니다.

      유효한 작업: join, multiJoin, start

    • 이메일: 참가자의 이메일 주소입니다.

      유효한 작업: join, multiJoin, start

    data.message 사용자가 호출에 응답할 때 소리내어 읽어주는 메시지입니다(예: "P1 인시던트가 생성되었습니다. 인스턴스에 로그인하십시오.").

    이 매개변수가 유효한 작업:

    • 가입
    • 멀티조인
    • 시작
    data.serviceProvider 필수. Zoom 또는 Webex와 같은 회의 서비스 제공자의 이름입니다.

    이 매개변수가 필요한 작업:

    • 모두
    데이터.sysId 전화 회의와 연결할 소스 기록의 Sys_id입니다.

    예를 들어 특정 인시던트나 문제를 논의하기 위해 전화 회의가 열리는 경우 인시던트 또는 문제 기록의 sys_id 이 값에 입력합니다. 이 sys_id NotifyConference Call [notify_conference_call] 테이블의 소스 열에 저장되며 나중에 추적할 수 있습니다.

    이 매개 변수는 , data.addToWorkNotesallowMulticonference 매개 변수와 data.Table함께 사용됩니다.

    이 매개변수가 유효한 작업:

    • 시작
    데이터.테이블 전화 회의와 연결할 소스 기록이 들어 있는 테이블입니다. 소스 기록은 전화 회의에서 논의되는 "인시던트" 또는 "문제"와 같은 기록일 수 있습니다.

    이 테이블 이름은 알림 전화 회의 [notify_conference_call] 테이블의 테이블 열에 저장되며 추적할 수 있습니다.

    이 매개 변수는 , data.addToWorkNotesallowMulticonference 매개 변수와 data.sysId함께 사용됩니다.

    이 매개변수가 유효한 작업:

    • 시작
    (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');

    알림 전화 회의 유틸리티 - getServiceProvidersCapabilities()

    인스턴스에 있는 모든 전화 통신 서비스 제공자 드라이버의 기능을 반환합니다.

    가능한 기능은 다음과 같습니다.
    • 아카이브: 회의가 끝난 후 보관합니다.
    • beepOnLeave: 참가자가 전화 회의에서 나가면 "삐" 소리를 재생합니다.
    • beepOnJoin: 참가자가 전화 회의에 참가하면 "삐" 소리를 재생합니다.
    • 종료: 식별된 컨퍼런스 회의를 종료합니다.
    • 파일 공유: 참여자 간 파일 공유 가능
    • 참가: 전화 회의에 참가자를 추가합니다.
    • KICK: 전화 회의에서 참가자를 제거합니다.
    • multiJoin: 전화 회의에 여러 참가자를 추가합니다.
    • multiKick: 전화 회의에서 여러 참가자를 제거합니다.
    • muteOnJoin: 참가자가 처음 전화 회의에 참가할 때 참가자를 음소거합니다.
    • multiUnmute: 전화 회의에서 여러 참가자를 음소거 해제합니다.
    • 기록: 컨퍼런스 회의 기록
    • 녹화: 컨퍼런스 회의가 녹화 중일 때 화면에 표시기를 제공합니다.
    • screenSharing: 참가자 화면을 그룹과 공유할 수 있습니다.
    • selfJoin: 현재 로그인한 사용자를 전화 회의에 추가합니다.
    • 말하기: 현재 말하고 있는 사람에 대한 화면 메시지를 제공합니다.
    • 시작: 식별된 전화 회의를 시작합니다.
    • unmute: 전화 회의 참가자를 음소거 해제합니다.
    표 10. 매개변수
    이름 유형 설명
    없음
    표 11. 반환
    유형 설명
    객체 각 드라이버 기능 상태의 키-값 쌍입니다.

    유효한 값은 다음과 같습니다.

    • isSupported = 0: 역량이 지원되지 않음
    • isSupported = 1: 역량이 지원됨

    인스턴스의 모든 전화 통신 서비스 제공자 드라이버에 대한 드라이버 기능을 나열합니다.

    (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);
    	}
    })();
    

    출력: 메서드는 인스턴스 내의 각 활성 전화 통신 서비스 제공자에 대해 다음과 유사한 노드를 반환합니다.

    {
        "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(숫자 작업)

    전화 통신 서비스 제공자가 알림 회의 작업을 지원하는지 여부를 결정합니다.

    이 메서드를 사용하려면 먼저 getServiceProviderCapabilities() 메서드를 호출해야 합니다. 이 메서드는 인스턴스에 구성된 각 서비스 제공자에 대해 가능한 각 알림 회의 작업의 가용성에 대한 정보가 포함된 객체를 반환합니다.

    예:

    {
        "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": {}
            }
        }
    }
    표 12. 매개변수
    이름 유형 설명
    작업 번호

    특정 작업 및 서비스 제공자에 대해 getServiceProvidersCapabilities() 메서드에서 반환하는 매개변수의 isSupported 값입니다.

    주:
    isSupported 값이 부울처럼 보일 수 있지만 실제로는 숫자입니다. 역량을 부울 값으로 평가하려고 시도하지 마십시오. 연결된 값이 이후 버전에서 확장될 수 있으므로 이 방법을 사용하십시오.
    표 13. 반환
    유형 설명
    부울 전화 통신 서비스 제공자가 지정된 작업을 지원하는지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.

    • True: 서비스 제공자가 작업을 지원합니다.
    • false: 서비스 제공자가 작업을 지원하지 않습니다.
    (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)

    전달된 GlideRecord와 관련된 참가자를 현재 컨퍼런스 회의에서 제거합니다.

    표 14. 매개변수
    이름 유형 설명
    알림 참가자GR GlideRecord 전화 회의에서 제거할 참가자의 GlideRecord 객체입니다.

    테이블: 참가자에게 알림 [notify_participant]

    표 15. 반환
    유형 설명
    객체 회의 작업의 결과입니다.

    <action>.status: 회의 작업의 상태입니다.

    • 데이터 유형: 부울
    • 가능한 값:
      • true: 회의 작업 성공
      • false: 회의 작업 실패

    <action>.successMessages: 상태가 예이면, 성공 메시지, 그렇지 않으면 비어 있습니다.

    • 데이터 유형: 문자열 배열

    <action>.warnMessages: 상태가 false인 경우 처리 중에 발생하는 경고 메시지입니다.

    • 데이터 유형: 문자열 배열

    <action>.errorMessages: 상태가 false인 경우 처리 중에 발생한 오류 메시지입니다.

    • 데이터 유형: 문자열 배열

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

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

    현재 컨퍼런스 회의에서 전달된 GlideRecord와 관련된 참가자를 음소거합니다.

    표 16. 매개변수
    이름 유형 설명
    알림 참가자GR 객체 음소거할 참가자의 GlideRecord 객체입니다.

    테이블: 참가자에게 알림 [notify_participant]

    표 17. 반환
    유형 설명
    객체 회의 작업의 결과입니다.

    <action>.status: 회의 작업의 상태입니다.

    • 데이터 유형: 부울
    • 가능한 값:
      • true: 회의 작업 성공
      • false: 회의 작업 실패

    <action>.successMessages: 상태가 예이면, 성공 메시지, 그렇지 않으면 비어 있습니다.

    • 데이터 유형: 문자열 배열

    <action>.warnMessages: 상태가 false인 경우 처리 중에 발생하는 경고 메시지입니다.

    • 데이터 유형: 문자열 배열

    <action>.errorMessages: 상태가 false인 경우 처리 중에 발생한 오류 메시지입니다.

    • 데이터 유형: 문자열 배열

    다음 코드 예제에서는 이 메서드를 호출하는 방법을 보여 줍니다.

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

    현재 컨퍼런스 회의에서 전달된 GlideRecord와 관련된 참가자를 음소거 해제합니다.

    표 18. 매개변수
    이름 유형 설명
    알림 참가자GR GlideRecord 음소거를 해제할 참가자의 GlideRecord 객체입니다. 이러한 기록은 알림 참가자 [notify_participant] 테이블에 있습니다.
    표 19. 반환
    유형 설명
    객체 회의 작업의 결과입니다.

    <action>.status: 회의 작업의 상태입니다.

    • 데이터 유형: 부울
    • 가능한 값:
      • true: 회의 작업 성공
      • false: 회의 작업 실패

    <action>.successMessages: 상태가 예이면, 성공 메시지, 그렇지 않으면 비어 있습니다.

    • 데이터 유형: 문자열 배열

    <action>.warnMessages: 상태가 false인 경우 처리 중에 발생하는 경고 메시지입니다.

    • 데이터 유형: 문자열 배열

    <action>.errorMessages: 상태가 false인 경우 처리 중에 발생한 오류 메시지입니다.

    • 데이터 유형: 문자열 배열
    (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);
            })
        }
    })();