cancel
Showing results for 
Search instead for 
Did you mean: 
cancel
6232
Views
1
Helpful
8
Comments
dekwan
Cisco Employee
Cisco Employee

Finesse 11.5(1)

I'm excited to hear that Finesse 11.5(1) has been released and that it has included some frequently requested features.

What is new?

  • Have agents handle non-voice multichannel tasks. Task routing (CCE Only) is the system's ability to route requests from different media channels to agents in a contact center. The Task Routing APIs allows developers to write applications to request, queue, route, and handle third-party multichannel tasks in CCE. Specifically, the Finesse APIs open the doors to allow agents to sign into different types of media (e.g. email, chat, etc.) and handle the tasks. Agents can sign into and manage their state in each media independently. Please see the DevNet Task Routing site for more information.

  • Host gadgets across domains. Cross-Origin Resource Sharing (CORS) is a mechanism that allows JavaScript on a web page to make XMLHttpRequests to another domain, not the domain the JavaScript originated from. It defines a way in which the browser and the server can interact to determine whether or not to allow the cross-origin request. CORS is now supported when third-party web applications instantiated from a third-party web server need to make calls to the Finesse Desktop as well as cross domain calls on the BOSH Openfire channel. Please see the CORS Support for Finesse REST API section of the Finesse Developer Guide for more information.


  • Configure the Team Performance Gadget height. Administrators can change the height of the team performance gadget by adding a maxRow attribute in the desktop layout: <gadget>/desktop/gadgets/TeamPerformance.jsp?maxRows=20</gadget>. The height is determined by the number of rows to be displayed. If you do not set or if you set the height to less than 10 rows, then default value of 10 is applied.


  • No need to log into individual gadgets. Single Sign On (SSO) support has been added to the Finesse desktop. What is even better is that custom Finesse gadgets can utilize this feature without lifting a finger. The REST API authentication for single sign on has been incorporated into the Finesse JavaScript library. Therefore, gadget development does not change and all existing gadgets will work with both SSO and non-SSO.

DevNet Finesse site

In conjunction with the release of Finesse 11.5(1), DevNet is excited to bring you a newly redesigned Finesse DevNet page!

Finesse_site_screenshot.png

Whats new on the site?

  • The Finesse 11.5(1) Developer Guide & JavaScript Library documentation are now available.

To access the html version of the documentation,

    1. Go to the Finesse DevNet page.
    2. Click the Docs link in the upper right.
    3. Under Guides, click appropriate documentation.


To access the PDF version of the documentation (as well as documentation for older releases),

    1. Go to the Finesse DevNet page.
    2. Click the Docs link in the upper right.
    3. Under Downloads, click Previous Documentation
    4. Download the appropriate documentation


  • The Finesse Learning Labs have been added. There are two learning labs that walk you through using some of the User REST APIs with and without the Finesse notification. These learning labs are geared towards developers who are not familiar with the Finesse REST APIs. More learning labs are to come! (If you have suggestions on learning lab topics, please leave them in the comments below.)

  • The Finesse overview page has been updated with technical details such as the Finesse architecture for both UCCE and UCCX deployments, the Cisco Finesse Notification Service, BOSH and XMPP.


  • The Getting Started page has been rewritten with step by step instructions and pointers to help those who are new to Finesse.


  • The Sample Gadgets page has a new format! You no longer need to go to the Archives page to download sample gadgets for previous Finesse versions! The new sample gadget page displays a list of all the sample gadgets available for download. Clicking a specific sample gadget takes you to the DevNet Finesse gitHub which contains the different versions available for that specific sample gadget. Download the version that matches your Finesse version.

  • A Task Management sample gadget has been added. This sample gadget showcases the usage of the new 11.5 Finesse Task Routing APIs such as logging in and out, changing state and accepting tasks.


  • The sample gadget versioning has changed. You may or may not have noticed a versioning change for Finesse 11.0(1). That wasn't quite working so we reevaluated and came up with a new format. Since the Finesse JavaScript Library is now hosted on the Finesse server itself, there is no longer a need to update the sample gadget code for every Finesse product release as long as the Finesse JavaScript Library maintains backwards compatibility. This makes it simpler for customers to maintain custom gadgets since they no longer have to update each custom gadget whenever they upgrade the Finesse version. As a result, you may not see a sample gadget version for every Finesse release. So, the sample gadgets have the following format for the filename:

<GadgetName>-Finesse.<MinProductVersion>-v.<GadgetMajorVersion>.<GadgetMinorVersion>.zip

For example: LearningSampleGadget-Finesse.11.0.1-v.1.0.zip

MinProductVersion: The first Finesse version that the gadget supports. In the example above, the LearningSampleGadget works for Finesse 11.0 and above. The "maxProductVersion" is determined by the next version of the sample gadget. If there is not a newer version of the sample gadget, the latest version of the sample gadget is still compatible with the latest version of Finesse. For example, if there is a LearningSampleGadget-Finesse.12.0.1-v.1.0.zip, the file LearningSampleGadget-Finesse.11.0.1-v.1.0.zip is compatible with Finesse 11.0(1) and 11.5(1), but not 12.0(1).

GadgetMajorVersion: This number is increased for feature enhancements to the gadget for the same product release. (e.g. LearningSampleGadget-Finesse.11.0.1-v.2.0.zip)

GadgetMinorVersion: This number is increased for bug fixes and documentation changes to the gadget for the same product release. (e.g. LearningSampleGadget-Finesse.11.0.1-v.1.1.zip)

  • A Finesse DevNet Sandbox page has been added to list out the different DevNet Sandboxes available for Finesse. A PCCE 11.5(1) Sandbox will be coming soon! This sandbox will be preconfigured for Task Routing and it will even preloaded with the Task Management Finesse sample gadget and a SocialMiner form to send tasks!

Well, I hope you take the time to explore the new Finesse page and check out the resources that DevNet has to offer. For those who have been eagerly awaiting some of the new Finesse 11.5 features, it is now available to you!

Please leave feedback in the comments on what you think of the new Finesse site. Also, what would you like to see more of? How can we help make your development for Finesse better?

8 Comments
joycentiong
Level 1
Level 1

Hi,

We are migrating to Finesse 11.5 from 10.5. There is Finesse-10.5.1.java Cisco Finesse library. Where can I find 11.5 Cisco Finesse library?

Thanks.

Danny

dekwan
Cisco Employee
Cisco Employee

Hi Danny,

I am not aware of the Finesse team providing a Finesse-10.5.1.java library, so unfortunately I would not know where to get a 11.5 version.

Thanx,

Denise

joycentiong
Level 1
Level 1

Hi,

My mistake in wording the question. We have Finesse-10.5.js library running on Finesse 10.5. One of our client is going to run Finesse 11.5. So I am looking for Finesse-11.5.js library.

Client is going to ask why we are using Finesse-10.5.js if we are going to Finesse 11.5.

Thanks.

Danny

dekwan
Cisco Employee
Cisco Employee

Hi Danny,

Ah. That makes a lot more sense. Starting Finesse 10.6, the Finesse javascript library is now hosted on the Finesse server itself.

  • You can access the JavaScript library at the following URL: http(s)://<FQDN>:<port>/desktop/assets/js/finesse.js
  • You can access the JavaScript documentation at the following URL: http(s)://<FQDN>:<port>/desktop/assets/js/doc/index.html
  • You can access JQuery at the following URL: http(s)://<FQDN>:<port>/desktop/assets/js/jquery.min.js.

In the *.xml, you change your import to:

            <!-- jQuery -->

            <script type="text/javascript" src="/desktop/assets/js/jquery.min.js"></script>

          

            <!-- Finesse Library -->

            <script type="text/javascript" src="/desktop/assets/js/finesse.js"></script>

Please see the developer guide for more information: https://developer.cisco.com/media/finesseDevGuide4.1/CFIN_RF_J0447D2F_00_javascript-library-and-sample-gadgets.html

Do know that there are changes that must be made to make 10.5 gadgets work for 11.5: How to convert your existing 10.5.1 custom gadget to work with 10.6.1, 11.0.1, or 11.5.1

Thanx,

Denise

joycentiong
Level 1
Level 1

Hi Denise,

I have a client who is going to run Finesse on 11.5 and using IE 11. Finesse 11.5 User Guide recommends that ActiveX setting be enabled.

But the client does not want to enabled ActiveX setting due to security reasons. What happen if the client use IE 11 but does not enabled ActiveX settings?

What is the side effects?

Thanks.

Danny

dekwan
Cisco Employee
Cisco Employee

Hi Danny,

Looks like you posted this question on the Finesse forum as well, so please refer to that thread: Cisco Finesse 11.5 IE Browser settings

Thanx,

Denise

ehtasham.malik
Level 1
Level 1

Denise,
We have a gadget which actually used to transfer calls with help of Finesse Rest API. For transfer call rest API we need to provide current login agent password, which we can get from finesse config.password() for non SSO user, for SSO user its getting Null.
How can we call rest API for SSO user?

dekwan
Cisco Employee
Cisco Employee

Hi,

If you are doing this in the Finesse gadget, are you using the Finesse Javascript API to transfer the call? If so, you should not need to pass in the agent's credentials because it will be handled for you. If not, please use the Finesse JavaScript API from the Dialog object: https://pubhub.devnetcloud.com/media/finesse-microsite-docs/docs/guides/javascript-library/symbols/finesse.restservices.…

Thanx,

Denise

Getting Started

Find answers to your questions by entering keywords or phrases in the Search bar above. New here? Use these resources to familiarize yourself with the community: