Runapp

This help page is for Desktop Studio. This information is also available for CXone Studio.

특히 양식, 웹 페이지 또는 애플리케이션을 실행하는 스크립트에서 사용자 정의 기능을 시작합니다. 컨택 패널을 대상으로 하는 모든 URL은 iframe에 표시될 수 있도록 구성해야 합니다. 상담원은 MAX에서 Panels 설정을 On(으)로 설정해야 합니다. Salesforce Agent 및 Salesforce Agent Lightning은(는) 이 작업을 지원합니다.

이 작업은 Ondata 브랜치를 통해 정보를 제출합니다.

Runapp의 일반적인 사용법은 ONANSWER 이벤트(Onanswer 작업으로 관리됨)가 있는 상담원을 위한 표준 양식 또는 사용자 정의 URL을 표시하는 것입니다.

PAGE action을 사용하여 상담원에게 간단한 HTML 페이지를 표시할 수 있습니다. Page은(는) 별도의 브랜치를 따르는 항목 시퀀스를 만드는 데 유용하지만 Runapp(으)로 정보를 제출할 때마다 정보는 Ondata 브랜치를 통과합니다.

지원되는 스크립트 형식


일반	이메일	채팅	전화	작업 항목	SMS

유사한 작업 비교

다음 작업에는 유사한 기능이 있지만 주요 차이점이 있습니다.

Runapp: 특히 양식, 웹 페이지 또는 애플리케이션을 실행하는 스크립트에서 사용자 정의 기능을 시작합니다.
PopURL: 웹 페이지 URL을 열고 웹페이지를 표시하는 패널의 위치 및 스타일에 대한 옵션을 제공합니다.
Indicate : 사용자 정의 기능, 특히 상담원이 클릭하여 사용자 정의 기능을 초기화할 수 있는 아이콘으로 상담원 인터페이스를 확장합니다. 이는 Indicate 사용 시 ActionType이(가) 상담원이 아닌 스크립트에 의해 시작된다는 점을 제외하면 Runapp과(와) 유사합니다.

입력 속성

이러한 속성은 실행할 때 작업이 사용하는 데이터를 정의합니다.

속성	설명
캡션 추가	스크립트에서 이 작업을 고유하게 식별하는 짧은 문구를 입력합니다. 캡션은 스크립트 캔버스의 작업 아이콘 아래에 표시됩니다. The default is the action name.
AgentID	상담원 ID입니다. 이 필드에 {agentId} 등의 변수를 사용할 수 있습니다. 아웃바운드 스킬에는 사용자 정의 스크립트가 할당되어 있으므로, Runapp이(가) 아웃바운드 사용자 정의 스크립트에서 실행될 때 상담원(아웃바운드 전화를 거는 사람)을 이미 ‘알고’ 있기 때문에 Begin 작업을 사용합니다. 따라서 화면 팝업은 {__agentID}이(가) 변수 이름으로 사용되는 경우에만 작동합니다. 인바운드 스크립트의 경우, 상담원 ID 변수를 AGENTID(으)로 설정하는 Onanswer이(가) 실행되지 않으면 스크립트에서 상담원이 누구인지 ‘알지’ 못합니다. RunApp 속성 편집기에서 이 작업을 두 번 클릭하여 이 속성을 구성할 수 있습니다.
ActionType	RunExe: CXone은(는) 지원하지 않습니다. 이를 위해서는 Windows 경로 또는 ActionValue 필드에 입력된 전체 경로에 있는 로컬 실행 파일이 필요합니다. 파일 경로는 경로에 이중 백슬래시(\\)를 포함해야 합니다. 예: C:\\Program Files\\CXone\\studio.exe. 대부분의 최신 브라우저는 실행 파일 프로그램의 실행을 지원하지 않습니다. 이 유형을 사용하려면, 상담원이 호환되는 브라우저를 사용하는지 확인하십시오. OpenURL: ActionValue 필드에 지정된 URL에 대한 기본 웹 브라우저를 엽니다. ShowCustomForm: Studio에서 생성된 사용자 정의 HTML 양식을 시작합니다. 사용자 정의 양식에서 캡처된 데이터는 스크립트에서 ONDATA 이벤트를 트리거합니다. RunApp Property 편집기에서 이 작업을 두 번 클릭하여 이 속성을 구성할 수 있습니다.
ActionValue	지정된 ActionType 유형에 필요한 값입니다. 이 속성에서 변수는 {중괄호}로 캡슐화하여 지원합니다. RunExe: Windows 실행 파일의 이름 또는 경로입니다. 파일 경로는 경로에 이중 백슬래시(\\)를 포함해야 합니다. 예: C:\\Program Files\\MyCompany\\myApp.exe -h {ANI}. OpenURL: 정규화된 도메인 이름 및 URL이어야 합니다. 쿼리 문자열 매개변수를 지원합니다. 예: http://www.example.com/file.asp?ANI={ANI}. URL에 매개변수 icAgentPanelTitle=을(를) 추가하여 MAX 인터페이스에 팝업되는 탭의 제목을 사용자 정의할 수 있습니다. ShowCustomForm: 이 필드는 사용자 정의 HTML 양식을 작성하는 기능을 제공합니다. 입력, 텍스트 영역, 암호, 확인란, 라디오, 선택, 버튼 및 제출을 포함한 모든 표준 양식 입력 필드를 사용할 수 있습니다. <form> 태그를 포함하지 마십시오. 각 입력 필드는 이름을 포함해야 합니다. 이름이 없는 필드는 무시됩니다. 예, <input type="text" name="phone">. 사용자 정의 양식이 작동하려면 스크립트에 다음 중 하나가 포함되어야 합니다. Ondata 작업: 이 작업을 사용하여 이름과 값이 변수로 스크립트에 반환됩니다. WaitForSubmit 속성: 스크립트에 포함되고 True(으)로 설정되면 필드 이름이 스크립트에서 변수가 됩니다. 필드 값은 변수의 내용이 됩니다. 여러 값을 지원하는 양식 필드(예: 확인란 및 선택)에는 쉼표로 구분한 배열이 포함됩니다. 여러 개의 제출 버튼을 같은 이름이나 다른 이름으로 사용할 수 있지만, 어떤 제출 버튼이든지 데이터를 제출하고 창을 닫습니다. 제출하지 않는 버튼이 필요하면, 제출 대신 버튼을 사용하십시오. 연결된 스타일시트는 지원되지 않으며 인라인 스타일을 사용할 수 있습니다. 예를 들면 <div style="position: absolute: left: 10px: top: 100px:">입니다. 외부 Javascript로 링크하는 경우 Javascript가 작동하지만, 오류를 방지하려면 콘텐츠가 HTTPS여야 합니다. 예: <script type="text/javascript" src="https://www.example.com/test.js"></script> <INPUT TYPE="button" NAME="button" Value="Click" onClick="MyFunction(this.form)"> 작업을 두 번 클릭하여 RunApp Property Editor을(를) 구성할 수 있습니다.
WaitForSubmit	True 또는 False입니다. True은(는) 시스템이 상담원의 제출 작업을 대기한다는 의미입니다. 또한 필드 이름은 스크립트에서 변수가 되고 필드 값은 변수 내용으로 사용됩니다. WaitForSubmit은(는) Action Type이(가) ShowCustomForm일 때만 해당합니다. WaitTimeout과(와) 함께 작동합니다. WaitForSubmit이(가) False(으)로 설정되면 스크립트에 필드 이름과 값을 변수로 반환하는 Ondata 작업을 포함해야 합니다. 시스템이 상담원의 제출 작업을 대기할지 여부를 결정합니다. 사용 설정하면 시스템이 상담원의 제출 작업을 기다립니다. 필드 이름은 스크립트에서 변수가 되고 필드 값은 변수의 값으로 사용됩니다. 비활성화되면 스크립트에 필드 이름과 값을 변수로 반환하는 Ondata 작업을 포함해야 합니다. 활성화하려면 True(으)로 설정하고, 비활성화하려면 False(으)로 설정합니다. 이 옵션은 Action Type이(가) ShowCustomForm일 때만 해당합니다. WaitTimeout과(와) 함께 작동합니다.
WaitTimeout	Action Type이(가) ShowCustomForm인 경우 OnTimeout 브랜치를 트리거하는 시간(초)입니다.

결과 브랜치 조건

결과 브랜치 조건을 사용하면 작업이 실행될 때 여러 결과를 처리하기 위해 스크립트에 브랜치를 생성할 수 있습니다.

조건	설명
Default	다른 분기를 사용하기를 요구하는 조건을 스크립트가 충족하지 않는다면 사용되는 경로입니다. 작업의 다른 분기가 정의되지 않았을 때도 사용되는 경로입니다.
Submit	WaitForSubmit을 참으로 설정할 경우 사용되는 경로입니다.
Timeout	지정된 시간(초) 동안 응답이 없을 경우 사용되는 경로입니다.
OnError	작업이 올바로 실행되지 않을 때 사용되는 경로. 예를 들어, 연결 불량, 구문 오류 등 예기치 않은 문제가 있을 때 사용됩니다. _ERR 변수(밑줄 문자 하나 포함)는 문제의 요약 설명으로 채워져야 합니다.

Runapp 마법사

작업 속성에서 직접 작업을 구성할 수도 있습니다.

Runapp 작업을 두 번 클릭하여 RunApp Property Editor 마법사를 엽니다.
이미지 보기
Runapp 작업을 수신할 상담원의 상담원 ID를 입력합니다. 아웃바운드 스크립트의 경우 {__agentID}을(를) 변수 이름으로 사용하고 다른 모든 스크립트에는 {AGENTID}을(를) 사용합니다.

작업 유형을 선택합니다.

필드	설명
Run an executable program	로컬 실행 파일을 실행합니다. 이 옵션은 CXone이 지원하지 않는 Internet Explorer에서만 작동하는 Java 플러그인을 사용합니다. 이를 위해서는 Windows 경로 또는 ActionValue 필드에 입력된 전체 경로에 있는 로컬 실행 파일이 필요합니다. 파일 경로는 경로에 이중 백슬래시(\\)를 포함해야 합니다. 예: C:\\Program Files\\CXone\\studio.exe. 대부분의 최신 브라우저는 실행 파일 프로그램의 실행을 지원하지 않습니다. 이 유형을 사용하려면, 상담원이 호환되는 브라우저를 사용하는지 확인하십시오.
Pop open a web page	Action Command 필드에 웹페이지의 전체 URL을 입력합니다. 이 페이지가 상담원의 로컬 컴퓨터에서 기본 브라우저로 열립니다.
Prompt the user with a web page like form	HTML 코드를 입력하여 Action Command 필드에 양식을 생성합니다. 여는 <양식> 태그와 닫는 <양식> 태그를 포함할 필요가 없습니다. 양식을 보려면 Preview을(를) 클릭하십시오.

OK을(를) 클릭합니다.