Business Insights is an Excel plug-in that allows GoCanvas users to connect Excel directly with their GoCanvas account. It gives users the ability to download Submissions and upload both Reference Data and Dispatches.
Business Insights is available for Professional and Enterprise plans.
Limitations & specifications
- Windows desktop 2007 and above
- 32-bit versions of Excel/Office only
- Requires a full Excel installation (see Installation troubleshooting below)
- Can function in a hosted environment (i.e. VPN) – but needs to be installed on host machine
- Can function on Mac running a virtual Windows environment with a full version of Excel
Troubleshooting installing & connecting
Business Insights requires downloading an installing an executable file provided by GoCanvas. Please note, the program needs to be installed on Windows user profile of the person who is going to be using it – NOT the admin account.
Installation is straightforward; follow the Windows prompts. If there are problems with this process, contact the person responsible for maintaining the device (typically your IT department).
BI isn’t showing up in my Data tab
- Click on File > Options (at the very bottom).
- Click on Add-ins.
- In the Manage field (at the very bottom) select COM Add-ins and Go.
- Check the box next to CanvasXL and click OK.
BI isn’t showing up in the COM Add-ins window
Generally, if you've installed Business Insights without error and are still not seeing the tool, one of two things could be happening, both with a similar root.
The tool is based on a specific framework that should be included with your version of Excel. Occasionally, that framework can get corrupted. The way to fix that is to repair your version of Excel (instructions via Microsoft here).
Sometimes, however, the version of Excel that comes pre-loaded on Windows machines does NOT include that framework. In that instance, you'll need to install a version of Excel that does (which can be accomplished by logging into your Windows 365 account and downloading the full version).
I get an error message: Business Insights is not allowed
No big deal! We just need to activate it on our end. Please contact your Account Manager or put a ticket in with Support.
I get an error message: Incorrect proxy messages
This message appears in two scenarios: your password is incorrect or you need to be setup correctly with your company’s proxy settings (in which case you should get in touch with whoever manages those settings, likely your IT department).
Troubleshooting using Business Insights
When I try to download submissions, only the column headers are downloaded
This could be related to the date format discrepancy between U.S. and international standards. In the U.S. we typically use the format MM/DD/YYYY. If the format in your account is DD/MM/YYYY, the "MM" section would be limited to "12" in the U.S. format, which may be causing an issue with days greater than the 12th of the month that are chosen in the submission download date range.
Please download the most recent version of Business Insights and attempt the submission download again.
I get an error message: "Permission denied to the requested resource"
When utilizing the submission download on BI, this error occurs if your password contains certain special characters (e.g. #, &, ^, etc.). Change your password and try again.
Business Insights does not import 'static text' field when downloading submission data
This is by design. If you need your static text to appear in your download (for example, if it is working off of a condition and is therefore contextually relevant to the downloaded data), you’ll need to change the field type to something else (likely short or long text) and set it to be read only in the App Builder.
I’m not getting any data from a specific App OR an App I’m looking for isn’t showing as an option for downloading Submissions
Do you, by chance, have a retired App with the same name as the App you’re trying to download Submissions for? This is a known issue that is fixed in some versions of BI, so try updating your version. If that doesn’t work, un-retire the App, rename it, and retire it again. Going forward, make sure to update the name of the App before you retire it.
If you are in the habit of testing an App then making a copy of that App (so as to deploy Version 1 to your users), and then retiring the original App, you'll want to include the word TEST or TESTING in the name of the original App, and when copying the App simply remove the test wording.
I get an error saying that I need to choose a Department but I am not seeing any Departments to choose from/I don’t have any Departments/I'm not seeing my Departments
This particular bug crops up in a few places. It happens because of special characters (e.g. #, &, etc.) in your password. Change your password and try again.
Error message: No user email column
This can happen when uploading Dispatches. The work around is to create a new tab in Excel, copy your data into that new tab, and try again from that tab.