Launch a Velixo report from a link

Applies to:

• Velixo Classic
• Velixo NX

TABLE OF CONTENTS

• Smart Links Overview
• Setting up the Velixo report
• Setting up the Velixo Smart Link
• Example with more flexibility

Important: This article describes how to launch a Velixo report from an Excel workbook.

If you are wanting to know how to use Sage Intacct Smart Links to launch a Velixo report from within Intacct, see Launch a Velixo report from Sage Intacct.

Smart Links Overview

The Velixo Smart Link feature provides the ability to create an Excel hyperlink to an existing Velixo report and allows parameters to be passed to that report from the file containing the hyperlink.

Thus, with a single click, we can launch an existing Velixo report, provide specific parameters to it (having it refresh with those parameters), and see the newly refreshed report displayed.

This Velixo feature requires that either the latest Insider Channel release of Velixo Classic or Velixo NX and the latest version of Velixo Tools (version 7.1.484 or higher) be installed.  To find out what version of Velixo Tools is currently installed, you can use the VELIXOTOOLSVERSION function within your workbook.

Setting up the Velixo report

Once Velixo Classic or the Velixo Tools have been installed and our Velixo report is created, the next step is to determine the parameters we want to be able to modify from within our separate workbook.

Here we have a report (on the NetChange sheet) where the displayed values update based on the selected Location ID (cell B4): 

And we have given a name ("LocationID") to that cell:

Once saved, we can now reference that named cell using a Velixo Smart Link

Setting up the Velixo Smart Link

Now that we have a report which we want to open, let's set up the link to it.

In a new workbook, we'll use a combination of Excel's HYPERLINK function with the specific syntax for launching our Velixo report.

The syntax for that function is:

=HYPERLINK("velixo: open | {path and file name of the report} | {name of parameter} = {value of parameter} |sheet='{name of worksheet to be displayed}'", "{text to be displayed on this worksheet}")

For our example:

With that information, we can create our Excel HYPERLINK function.  If we were not using a cell reference for our Location ID, the hyperlink would look like this:

=HYPERLINK("velixo:open|C:\Reports\IntacctReport.xlsx|LocationID=100,|sheet=NetChange","Open Test Report")

Since we do want to refer to cell B1, we'll replace the value of 100 with a reference to that cell:

=HYPERLINK("velixo:open|C:\Reports\IntacctReport.xlsx|LocationID="&B1&"|sheet=NetChange","Open Test Report")

Once we save our workbook and then click the link, our Velixo report will be opened, the specified location value (100) will be placed in the named cell, our report will be updated based on that location, and the newly refreshed report will be displayed:

Example with more flexibility

Let's assume that we wanted our workbook viewer to specify more than just the location code.

Here, we've added additional names to our report for StartDate and EndDate (cells B2 and B3):

In our other workbook, we've added choices for those parameters along with additional options fr the name of the report and the worksheet we want to display:

Now we can build our HYPERLINK function.  We can use the "| parameter=value" syntax for as many parameters as we need.  

If we were not using cell references, that function would look like this:

=HYPERLINK("velixo:open|C:\Reports\IntacctReport.xlsx|LocationID=100|StartDate=7/1/2019|EndDate=7/31/2019|Sheet='NetChange'","Open Test Report")

Using Excel's ampersand (&) operator and references to those cells, we have this:

=HYPERLINK("velixo:open|"&B1&"|"&A5&"="&B5&"|"&A3&"="&B3&"|"&A4&"="&B4&"|Sheet='"&B2&"'", "Open Test Report")

Once we save our workbook and then click the new hyperlink, the specified Velixo report is opened to the specified worksheet and refreshed with all of the new parameter values: