Beta License Agreement

This product is still in beta and may undergo further changes.

The following are instructions for using various equipment with Sisense’s BI Everywhere software functionality (the equipment and the BI Everywhere software is collectively referred to herein as the “Product”). This notice is to remind users that the Product is a beta release offering and is not warranted to be at the level of performance of a commercially available product offering. In addition, the Product may be substantially modified prior to first commercial release, or at Sisense’s option may not be released commercially in the future. As such, by using the equipment along with the Sisense Software, each user agrees (i) to follow all instructions provided by Sisense with respect to the installation and use of the equipment with the Sisense Software, including the below, and (ii) that such use continues to be for testing and evaluation purposes only.

The Product and Documentation are provided “AS IS” without warranty of any kind, and Sisense and its licensors and suppliers disclaim all warranties, express, implied or statutory, including without limitation any implied warranties of title, non-infringement of third party rights, merchantability, or fitness for a particular purpose. The entire risk arising out of the use or performance of the Product remains with the user.

For the sake of clarity, the provisions in the license agreement between the licensee of the Sisense Software and Sisense (the “License Agreement”), providing any representations, warranties or indemnities shall not apply to the Product. For purposes of the limitation of liability provisions of the License Agreement, no amount has been paid or is payable to Sisense in connection with the Product. However, the license provisions continue to apply to the Sisense Software and the confidentiality provisions of the License Agreement shall continue to apply to those portions of the information shared with you by Sisense that are Confidential Information as defined in the License Agreement or any confidentiality agreement in effect between the licensee and Sisense.

Introduction

Sisense provides you with the means to interact with your data through traditional point-and-click interfaces as well as through voice commands. With a single voice command, you can retrieve and hear your numeric KPIs. The Sisense-Enabled Echo searches your widgets and dashboards to provide you with the best result according to your command.

Sisense enables Amazon’s Echo, which is a voice-powered, wireless-enabled speaker that interfaces with Alexa, to retrieve your data in Sisense. Alexa is a cloud-based voice service that powers the Echo. Alexa’s default capabilities such as playing music can be extended through skills. Sisense has developed a Sisense skill that extends the Echo’s functionality and returns numeric KPIs through voice commands.

This page provides the following information:

  1. How does it Work: Describes how the Sisense-Enabled Echo works.
  2. Setting up the Sisense-Enabled Echo: Describes how to set up the Sisense-Enabled Echo.
  3. Querying the Sisense-Enabled Echo: Describes how to query the Sisense-Enabled Echo.
  4. Troubleshooting: Describes how to troubleshoot potential issues with the Sisense-Enabled Echo.

How does it Work?

After launching Sisense via voice command, you can retrieve numeric data quickly by asking Alexa about your KPIs similar to issuing traditional queries through Sisense.  Your Sisense-Enabled Echo listens for the command and forwards it to Alexa.

alexadiagram

Alexa handles your requests and routes the request to the Sisense ElastiCube where your information is retrieved. Alexa then translates this data into an audio response played back by your Sisense-Enabled Echo.

Setting Up Sisense-Enabled Echo

Sisense has developed a skill that enables you to retrieve your data via voice commands. This skill takes requests from the Alexa service and leverages the Sisense APIs to retrieve your data.

To enable your Sisense-Enabled Echo to accept your voice commands and pass them through the Alexa service and the Sisense APIs, you will need to enable the Sisense skill.

Before setting up your Sisense-Enabled Echo, you may want to create a new user with a single dashboard associated with their account so you can easily test your Echo without returning unexpected results from various dashboards.

To set up the Sisense-Enabled Echo:

  1. Download the Alexa app from the app store and activate it using your email address.
  2. Turn on your Echo and connect it to your WIFI.
  3. Contact us via email and provide the email address you used to register your Alexa app. You will receive an email with the subject line: Amazon Mobile App Distribution Program Invitation from Sisense. This email is an invitation to developer.amazon.com where you can enable the Sisense skill.
  4. Click the link in the email you received in the previous step. You are redirected to Amazon’s developer site. If you do not have a developer account, you will be prompted to create one.
  5. Log into https://developer.amazon.com.
  6. In the Developer site, select the Alexa tab from the main menu and click Get Started.
    Alexagettingstarted
  7. In the Skills list, click Sisense.
    Alexagettingstarted2
  8. Click Test. You are redirected to the Testing Skills page.
    alexatest
  9. In the Test page, select Enabled.
    alexaenabled
  10. Activate Alexa and say “Start Sisense“. Alexa responds that your account is not linked.
  11. Open the Alexa app or in your web browser open http://alexa.amazon.com.
  12. Click Link Account.
  13. Sisense Insights page is opened in a new window. If you have a pop-up blocker enabled, you may need to allow the website insights.sisense.com to be opened in a new window.
  14. In the Sisense Insights page, enter the following details:
  15. Sisense server address: The address of your Sisense account including “http://.
    Email address: Your Sisense account email address.
    Password: The password of your Sisense account.
  16. Click Authenticate. If you receive an error saying “Unable to link your skill”, this is fine, Sisense has received your request.
    Your account is now authenticated and you can begin to work with the Sisense-Enabled Echo.

Querying the Sisense-Enabled Echo

There are two ways you can query your Sisense-Enabled Echo. The first option is to ask a question in a single question session. The second option is to ask your questions in a multi-question session, in which you ask multiple questions in a single session. The difference between the two options is that in single question sessions, you must invoke Sisense each time you ask a question. In a multi-question session, you invoke Sisense once, and then ask your questions without having to invoke Sisense again until after you exit the session.

When querying your Sisense-Enabled Echo, there are three ingredients that should be part of your request.

  1. Invocation phrases
  2. Connector words/phrases
  3. Intent requests

Single Question Session

alexaphrase

Multi-Question Session

Invocation: Echo/Alexa, Start Sisense (Opens a multi-question session)

Connector and Intent:

“What is my total sales?”

“Get total visits”

“Provide Total Sales”

“Exit” (Closes a multi-question session)

The invocation phrase is the name of the custom skill where you want to request information. In a single question session, you include the invocation phrase each time you ask a question. In a multi-question session, you can invoke Sisense once by starting Sisense via a voice command and exit the session by saying ‘Exit’. When you invoke Sisense in either session type, Alexa forwards your request to Sisense.

The second ingredient is the connector words or phrases. These words are supported by the Alexa service in combination with the invocation name for a custom skill to request information.

An example of a connector phrase is in bold below:

Alexa, ask <skill> what is my <intent request>

For a list of supported connector words, click here.

The third ingredient is your intent request. The intent request is a request for specific information that corresponds to the skill, in this case, Sisense. Intent requests are defined by Sisense. Sisense supports the following intent requests:

  • Widgets: The names of numeric widgets.
  • Dashboards: The names of dashboards. Alexa returns a list of numeric widgets.
  • Dashboardwidget: The name of a widget within a specific dashboard.
  • Build: The name of an ElastiCube to be built.
  • Share: Share a widget that you opened in the last request. For example, if you ask about a Total Sales widget, then want to share that widget with another user, your request would be:
    • Alexa, ask Sisense what is my Total Sales?
    • Alexa, ask Sisense to share with [email protected]

The order is not relevant. You can invoke Sisense at the beginning or your request or following your request. In addition, additional words and phrases such as ‘the’, ‘please’, and ‘I want’ can be added to your request without interfering with the response.

In a multi-question session, you end the session by saying “Exit”.

Examples

After you have enabled the Sisense skill, you can begin to use your Sisense-Enabled Echo.

Single Question Mode:

Widgets: Alexa, ask Sisense What is my Total Sales.
Dashboards: Alexa, ask Sisense to summarize my Sales dashboard.
Dashboardwidget: Alexa, ask Sisense what is my Total Revenue from the Sales Dashboard.
Build: Alexa, ask Sisense to build the Marketing Elasticube.
Share: Alexa, ask Sisense what is my Total Sales, Alexa, ask Sisense to share with [email protected]
Refresh metadata (Updates your dashboard/widget list)
Analyze [Widget Name] (Runs narrative analysis on your column/scatter/pivot widgets)

Multi-Question Mode:

Alexa, Start Sisense. (Creates a session)
What is my Total Revenue?  (Widgets)
Summarize my Sales dashboard. (Dashboards)
What is my Total Revenue from the Sales Dashboard? (Dashboardwidget)
Build the Marketing Elasticube. (Build)
What is my Total SalesShare with [email protected] (Share)
Exit (Exits a session)

Security

There are two potential security issues that arise when working with the Sisense-Enabled Echo. The first issue is what happens to data when you ask a question.  When you ask questions and receive answers, your data is sent to and returned from the Alexa service. This data transfer takes place across secured SSL ensuring that no one can access your data.

The second issue is securing the Sisense-Enabled Echo itself, so no one can access it and retrieve your data. When you say to Alexa, “Deactivate Account”, this disconnects your Sisense-Enabled Echo from your Sisense account. Alexa will ask you to confirm that you want to deactivate your account. If you respond “Yes”, the account is deactivated. No one will be able to access your data through the Sisense-Enabled Echo until the next time you manually reactivate your account.

Troubleshooting

For Amazon Tap and Echo devices, you can use Voice Training. Voice Training helps Alexa understand your speech patterns. During a Voice Training session, the Alexa app shows 25 different phrases, which you say to your device. To learn more, go to Voice Training.

If you have any issues authenticating your Echo, you can try to enable the device from the desktop through the following site.