Working With Custom Desktop Layouts

Video example

Table of Contents

Introduction

Lab Objective

The object of this lab excercise is to customize the logo and title of the agent desktop and also add widget in the header section and nav bar section.

Pre-requisite

  1. Administrator/ Supervisor with portal access​.
  2. New user (Agent) is already created​.
  3. Agent is able to login to agent desktop​.
  4. Agent should be part of a team​.
  5. Basic knowledge of JSON format​
  6. Use any online JSON validator to validate the file​

1. Download default desktop Layout

  • Login to WxCC portal with admin credentials​
    • Note that you should have at least one agent configured for testing at this point
  • Navigate to Provisioning –> Desktop Layout​
  • Click on ellipses ... of Global Layout to edit Video Direct Link
  • Now click on edit
  • Click on download button ​
  • Download the Default Desktop Layout.json file​
  • Now cancel out, as you only need to get the JSON file

2. Customize default desktop layout with logo and title

  • Open the Default Layout JSON in any text editor e.g. Notepad or Sublime text.​
  • Modify the value of appTitle key to change Agent Desktop title ​
  • Modify the value of logo key as your company logo URL or use this dummy url: https://widget-kad.s3.amazonaws.com/Logos/boscologo5.png
  • “Save As” the JSON file with a distinguishable name.

3. Upload the custom desktop layout an verify

  • Login to WxCC portal with admin credentials​
  • Navigate to Provisioning –> Desktop Layout​
  • Click on New Layout
  • Provide any preferable name and description ​
  • Click on Team textbox to add the team ​
  • Click Upload button to upload the modified JSON file​
  • Click Save button to apply the layout.
  • Login/Reload WxCC agent desktop to verify the layout

4. Assign header widget and nav bar widget

  • Open the layout JSON file in any text editor e.g.
  • Notepad or Sublime text.(be careful copying from PowerPoint might add unwanted spaces/characters… causing the JSON to * * fail on load) use an online JSON formatter to clean up if required.​
  • Modify the header section as mentioned in video
  • Modify the navigation section by creating a new navigation widgit with a direct link​ Video Direct Link
  • “Save As” the JSON file with a unique preferable name

5. Upload the modified layout

  • Login to WxCC portal with admin credentials​
  • Navigate to Provisioning –> Desktop Layout​
  • Search for your layout ​
  • Click on … to edit the existing layout​
  • Now click on edit
  • Click Upload button to upload the modified JSON file​
  • Finally click Save button to apply the layout.

6. Verify the layout