Debug Scripts in CXone Studio

Required permissions: ACD > Studio > 스크립트 디버그

You can run script traces to check for issues in your scripts. They allow you to see the actions that fire in the script, and the variables that are in the script at the time that each action fires.

Each trace opens in a separate window. This means you can keep previous traces open to compare to the new ones, or capture multiple live contacts in a row.

Capture a Script Trace

You can track the performance of your script, spawn a script, or make a test call with the Trace Output tool. This tool traces the contact or running script and displays each action that fired, what variables are being created and when, and the values the variables held at each point. This is a helpful tool to test and debug your scripts. You can run traces on live interactions or simulated ones.

스크립트가 저장될 때만 추적을 캡처할 수 있습니다. 저장되지 않은 변경 사항이 있는 상태에서 스크립트 추적 캡처를 시도하면 Studio에서 스크립트를 저장하라고 안내합니다. 스크립트에 컴파일 오류가 있으면 Studio은(는) 스크립트를 저장하지 않습니다. 스크립트를 저장하고 추적을 실행하기 전에 오류를 해결해야 합니다.

Studio doesn't keep a history of traces you've captured. If you think you might need to refer to a previous trace, either keep the trace output window open or download the trace file to your computer.

1. CXone에서 앱 선택기 를 클릭하고 선택합니다.옴니채널 라우팅 > Studio .
2. 스크립트 페이지에서 작업하려는 스크립트를 찾아 두 번 클릭하여 열거나 새 스크립트를 만듭니다. 스크립트가 새 탭에서 열립니다.
3. Click Trace > Start with Trace.
4. Select an inbound phone ACD Skill.
5. To pass values into the script via parameter variables, enter the values in the Parameters field. Enter one value per line. The values you enter map to parameters P1 through Pn, where n is the number of the last parameter value you add.
6. To simulate an interaction for an inbound phone script, click Simulate Inbound Call and provide the necessary information.

7. Click Start Capture. The trace output window opens.

   As the script runs, actions appear in the trace window in the order they fire. You can see the name of the action, its properties and their configurations, the time the action fired, and the result of its firing. You can:

   • Hover the cursor over an entry in the Properties column to see the full list of properties and their values in a popup menu.

   • Use the search bar to search for actions in the trace output. You can search using the action name, property name or value, time, or result.

   • Click any column heading to sort the list by that data.

8. Click an action in the trace output to see all variables and their values in the script at the time that the action fired.

   The variables appear in the list on the right side of the trace output window. New or changed variables are displayed in red.

   View image

   

   In the variables list, you can:

   • Hover the cursor over entries in any column to view the full contents of that variable or value in a popup menu.

   • Select or clear Global, System, or Private to filter the variables in the list. Clearing the option hides that type of variable in the list.

   • Click the greater-than symbol > next to the name of a dynamic data object to expand it and see its members and their values.
   • Use the search bar in the trace output window to search for variables by name or value.
   • Copy a variable value by clicking its row and pressing CTRL + C on your keyboard. The cell background briefly turns dark blue, indicating that the copy was successful.
   • Use the arrow keys to navigate the highlighted row in the variables list.

9. To save the trace output to your computer, click the ellipsis in the top right corner of the window, select Download the trace file, then choose a location and name for the file and click Save.

10. To end the trace without ending the interaction on the server, click Detach.
11. To end the trace and the interaction, click Terminate, then click OK to confirm that you want to end the interaction. This disconnects the contact or ends the current running script, and ends the interaction on the server.

Capture Live Contacts

You can capture a trace on a script as it runs. You can do this with production scripts processing live contacts. This allows you to diagnose issues that your contact center is experiencing, or capture data for troubleshooting with technical support.

Currently, CXone Studio can only capture the next instance of the script running. It cannot capture a continuous trace. When you capture a single trace, the resulting information appears in the Trace Output window.

Studio doesn't keep a history of traces you've run. If you think you might need to refer to a previous trace, either keep the trace output window open or download the trace file to your computer.

1. CXone에서 앱 선택기 를 클릭하고 선택합니다.옴니채널 라우팅 > Studio .
2. 스크립트 페이지에서 작업하려는 스크립트를 찾아 두 번 클릭하여 열거나 새 스크립트를 만듭니다. 스크립트가 새 탭에서 열립니다.

3. Click Trace > Capture Live Contacts.

   View image)

   

4. The Number of Contacts is currently set to 1 and cannot be changed. In a future release, you will be able to specify a number of contacts to capture.
5. Under Filters, select an option: 
   • None: Select this to capture the next instance of this script running.
   • DNIS: Select this and enter a DNIS 인바운드 음성 통화를 위해 연결된 컨택 수와 상담원 또는 아웃바운드 음성 통화에서 연결된 시스템 수를 확인합니다. in the Enter DNIS number field. The next instance of the script running with a matching DNIS will be captured.
   • ANI: Select this and enter an ANI 발신자 ID라고도 합니다. 들어오는 음성 통화의 나열된 전화번호입니다. in the Enter ANI number field. The next instance of the script running with a matching ANI will be captured.

6. Click Start Capture. The trace output window opens. The window is empty until an instance of the script matching the selected Filter option begins to run.

   As the script runs, actions appear in the trace window in the order they fire. You can see the name of the action, its properties and their configurations, the time the action fired, and the result of its firing. You can:

   • Hover the cursor over an entry in the Properties column to see the full list of properties and their values in a popup menu.

   • Use the search bar to search for actions in the trace output. You can search using the action name, property name or value, time, or result.

   • Click any column heading to sort the list by that data.

7. Click an action in the trace output to see all variables and their values in the script at the time that the action fired.

   The variables appear in the list on the right side of the trace output window. New or changed variables are displayed in red.

   View image

   

   In the variables list, you can:

   • Hover the cursor over entries in any column to view the full contents of that variable or value in a popup menu.

   • Select or clear Global, System, or Private to filter the variables in the list. Clearing the option hides that type of variable in the list.

   • Click the greater-than symbol > next to the name of a dynamic data object to expand it and see its members and their values.
   • Use the search bar in the trace output window to search for variables by name or value.
   • Copy a variable value by clicking its row and pressing CTRL + C on your keyboard. The cell background briefly turns dark blue, indicating that the copy was successful.
   • Use the arrow keys to navigate the highlighted row in the variables list.

8. To save the trace output to your computer, click the ellipsis in the top right corner of the window, select Download the trace file, then choose a location and name for the file and click Save.

9. To end the trace without ending the interaction on the server, click Detach.
10. To end the trace and the interaction, click Terminate, then click OK to confirm that you want to end the interaction. This disconnects the contact or ends the current running script, and ends the interaction on the server.

Download Trace Files

You can save the trace output as a file that you can download to your computer. This is helpful if you need to refer to a trace later. It also allows you to send a trace file to other Studio users or to CXone 계정 담당자s. The files can be viewed by loading them in CXone Studio. Files are saved in JSON format with a TRC.JSON extension.

1. CXone에서 앱 선택기 를 클릭하고 선택합니다.옴니채널 라우팅 > Studio .
2. 스크립트 페이지에서 작업하려는 스크립트를 찾아 두 번 클릭하여 열거나 새 스크립트를 만듭니다. 스크립트가 새 탭에서 열립니다.
3. Click Trace and select Start with Trace or Capture Live Contacts.
4. When the trace is captured, click the ellipsis in the upper right corner of the trace output window.
5. Select Download the trace file.
6. Specify a File name and where you want to save the file.
7. Click Save.

Load Trace Files

You can load a saved trace file into CXone Studio to view it.

1. CXone에서 앱 선택기 를 클릭하고 선택합니다.옴니채널 라우팅 > Studio .
2. On the Scripts page, click Load and select Load trace file.
3. Drag a trace file onto the Load Trace window or click browse for files to select one.
4. Click Open on the Load Trace window. The trace opens in a trace output window.