KB429075: How to Properly Deploy and Use Visualization Builder in Enterprise Web and MicroStrategy Analytic Desktop

• Strategy

This KB article describes issue users may encounter after deploying the Visualisation Builder in MicroStrategy Web or MicroStrategy Desktop. A resolution is provided below in MicroStrategy releases 10.4 and above.

SYMPTOM:
Extract the plug-in and copy it to the

plugins

subfolder inside the Strategy Web installation folder or to the

code/plugins

subfolder inside the Strategy Desktop installation folder. If you are using Strategy Web, the Visualization Builder in the Enterprise Web Homepage will be missing:

Figure 1: Visualization Builder tab missing in the Enterprise Web Homepage
or if you are using Strategy Desktop, when you choose Custom Viz Builder from the Develop menu, you receive the below error message:

Figure 2: Error message received when Visualisation builder is deployed in Strategy Desktop

(Highlight to read)
See the end of this message for details on invoking
just-in-time (JIT) debugging instead of this dialog box.
************** Exception Text **************
System.NullReferenceException: Object reference not set to an instance of an object.
at CefSharp.WebBrowserExtensions.GetMainFrame(IWebBrowser webBrowser)
at CefSharp.WebBrowserExtensions.ExecuteScriptAsync(IWebBrowser browser, String script)
at OneTierClientApp.DashboardWindow.InitializeComponent()
at OneTierClientApp.DashboardWindow.Init(MainAppForm iMainAppForm, ControllerManagerProxy iControllerMgr, String fileName, String iGUID, Boolean ibRecover)
at OneTierClientApp.DashboardWindow..ctor(MainAppForm iMainAppForm, ControllerManagerProxy iControllerMgr, String fileName, String iGUID, Boolean ibRecover, EnumDashboardWindowMode iWindowMode)
at OneTierClientApp.MainAppForm.LaunchNewWindow(String iFilePath, EnumDashboardWindowMode iWindow)
at OneTierClientApp.DashboardWindow.visBuilderMenuItem_Click(Object sender, EventArgs e) at System.Windows.Forms.MenuItem.OnClick(EventArgs e)
at System.Windows.Forms.MenuItem.MenuItemData.Execute()
at System.Windows.Forms.Command.Invoke() at System.Windows.Forms.Control.WmCommand(Message& m)
at System.Windows.Forms.Control.WndProc(Message& m)
at System.Windows.Forms.Form.WndProc(Message& m)
at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)
************** Loaded Assemblies **************
mscorlib
Assembly Version: 4.0.0.0
Win32 Version: 4.6.127.1 built by: NETFXREL3STAGE
CodeBase: file:///C:/Windows/Microsoft.NET/Framework64/v4.0.30319/mscorlib.dll ----------------------------------------
StrategyDesktop
Assembly Version: 1.0.6191.39291
Win32 Version: 10.6.0034.0038
CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/StrategyDesktop.EXE ----------------------------------------
System.Windows.Forms
Assembly Version: 4.0.0.0
Win32 Version: 4.6.79.0 built by: NETFXREL2
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Windows.Forms/v4.0_4.0.0.0__b77a5c561934e089/System.Windows.Forms.dll ----------------------------------------
System
Assembly Version: 4.0.0.0
Win32 Version: 4.6.1081.0 built by: NETFXREL3STAGE
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System/v4.0_4.0.0.0__b77a5c561934e089/System.dll ----------------------------------------
System.Drawing
Assembly Version: 4.0.0.0
Win32 Version: 4.6.1068.2 built by: NETFXREL3STAGE
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Drawing/v4.0_4.0.0.0__b03f5f7f11d50a3a/System.Drawing.dll ----------------------------------------
CefSharp
Assembly Version: 47.0.3.0
Win32 Version: 47.0.3.0
CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/CefSharp.DLL ----------------------------------------
CefSharp.Core
Assembly Version: 47.0.3.0
Win32 Version:
CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/CefSharp.Core.DLL ----------------------------------------
System.Core
Assembly Version: 4.0.0.0
Win32 Version: 4.6.1084.0 built by: NETFXREL3STAGE
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Core/v4.0_4.0.0.0__b77a5c561934e089/System.Core.dll ----------------------------------------
CefSharp.WinForms
Assembly Version: 47.0.3.0
Win32 Version: 47.0.3.0
CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/CefSharp.WinForms.DLL ----------------------------------------
System.ServiceModel
Assembly Version: 4.0.0.0
Win32 Version: 4.6.79.0 built by: NETFXREL2
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.ServiceModel/v4.0_4.0.0.0__b77a5c561934e089/System.ServiceModel.dll ----------------------------------------
SMDiagnostics
Assembly Version: 4.0.0.0
Win32 Version: 4.6.79.0 built by: NETFXREL2
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/SMDiagnostics/v4.0_4.0.0.0__b77a5c561934e089/SMDiagnostics.dll ----------------------------------------
System.ServiceModel.Internals
Assembly Version: 4.0.0.0
Win32 Version: 4.6.79.0 built by: NETFXREL2
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.ServiceModel.Internals/v4.0_4.0.0.0__31bf3856ad364e35/System.ServiceModel.Internals.dll ----------------------------------------
System.Configuration
Assembly Version: 4.0.0.0
Win32 Version: 4.6.79.0 built by: NETFXREL2
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Configuration/v4.0_4.0.0.0__b03f5f7f11d50a3a/System.Configuration.dll ----------------------------------------
System.Xml
Assembly Version: 4.0.0.0
Win32 Version: 4.6.1064.2 built by: NETFXREL3STAGE
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Xml/v4.0_4.0.0.0__b77a5c561934e089/System.Xml.dll ----------------------------------------
System.Runtime.Serialization
Assembly Version: 4.0.0.0
Win32 Version: 4.6.79.0 built by: NETFXREL2
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Runtime.Serialization/v4.0_4.0.0.0__b77a5c561934e089/System.Runtime.Serialization.dll ----------------------------------------
System.Transactions
Assembly Version: 4.0.0.0
Win32 Version: 4.6.79.0 built by: NETFXREL2
CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_64/System.Transactions/v4.0_4.0.0.0__b77a5c561934e089/System.Transactions.dll ----------------------------------------
************** JIT Debugging **************
To enable just-in-time (JIT) debugging, the .config file for this application or computer (machine.config) must have the jitDebugging value set in the system.windows.forms section. The application must also be compiled with debugging enabled.
For example:
<configuration>
<system.windows.forms jitDebugging="true" />
</configuration>
When JIT debugging is enabled, any unhandled exception will be sent to the JIT debugger registered on the computer rather than be handled by this dialog box.
See the end of this message for details on invoking just-in-time (JIT) debugging instead of this dialog box. ************** Exception Text ************** System.NullReferenceException: Object reference not set to an instance of an object. at CefSharp.WebBrowserExtensions.GetMainFrame(IWebBrowser webBrowser) at CefSharp.WebBrowserExtensions.ExecuteScriptAsync(IWebBrowser browser, String script) at OneTierClientApp.DashboardWindow.InitializeComponent() at OneTierClientApp.DashboardWindow.Init(MainAppForm iMainAppForm, ControllerManagerProxy iControllerMgr, String fileName, String iGUID, Boolean ibRecover) at OneTierClientApp.DashboardWindow..ctor(MainAppForm iMainAppForm, ControllerManagerProxy iControllerMgr, String fileName, String iGUID, Boolean ibRecover, EnumDashboardWindowMode iWindowMode) at OneTierClientApp.MainAppForm.LaunchNewWindow(String iFilePath, EnumDashboardWindowMode iWindow) at OneTierClientApp.DashboardWindow.visBuilderMenuItem_Click(Object sender, EventArgs e) at System.Windows.Forms.MenuItem.OnClick(EventArgs e) at System.Windows.Forms.MenuItem.MenuItemData.Execute() at System.Windows.Forms.Command.Invoke() at System.Windows.Forms.Control.WmCommand(Message& m) at System.Windows.Forms.Control.WndProc(Message& m) at System.Windows.Forms.Form.WndProc(Message& m) at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam) ************** Loaded Assemblies ************** mscorlib Assembly Version: 4.0.0.0 Win32 Version: 4.6.127.1 built by: NETFXREL3STAGE CodeBase: file:///C:/Windows/Microsoft.NET/Framework64/v4.0.30319/mscorlib.dll ---------------------------------------- StrategyDesktop Assembly Version: 1.0.6191.39291 Win32 Version: 10.6.0034.0038 CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/StrategyDesktop.EXE ---------------------------------------- System.Windows.Forms Assembly Version: 4.0.0.0 Win32 Version: 4.6.79.0 built by: NETFXREL2 CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Windows.Forms/v4.0_4.0.0.0__b77a5c561934e089/System.Windows.Forms.dll ---------------------------------------- System Assembly Version: 4.0.0.0 Win32 Version: 4.6.1081.0 built by: NETFXREL3STAGE CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System/v4.0_4.0.0.0__b77a5c561934e089/System.dll ---------------------------------------- System.Drawing Assembly Version: 4.0.0.0 Win32 Version: 4.6.1068.2 built by: NETFXREL3STAGE CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Drawing/v4.0_4.0.0.0__b03f5f7f11d50a3a/System.Drawing.dll ---------------------------------------- CefSharp Assembly Version: 47.0.3.0 Win32 Version: 47.0.3.0 CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/CefSharp.DLL ---------------------------------------- CefSharp.Core Assembly Version: 47.0.3.0 Win32 Version: CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/CefSharp.Core.DLL ---------------------------------------- System.Core Assembly Version: 4.0.0.0 Win32 Version: 4.6.1084.0 built by: NETFXREL3STAGE CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Core/v4.0_4.0.0.0__b77a5c561934e089/System.Core.dll ---------------------------------------- CefSharp.WinForms Assembly Version: 47.0.3.0 Win32 Version: 47.0.3.0 CodeBase: file:///C:/Program%20Files/MicroStrategy/Strategy%20Desktop/CefSharp.WinForms.DLL ---------------------------------------- System.ServiceModel Assembly Version: 4.0.0.0 Win32 Version: 4.6.79.0 built by: NETFXREL2 CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.ServiceModel/v4.0_4.0.0.0__b77a5c561934e089/System.ServiceModel.dll ---------------------------------------- SMDiagnostics Assembly Version: 4.0.0.0 Win32 Version: 4.6.79.0 built by: NETFXREL2 CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/SMDiagnostics/v4.0_4.0.0.0__b77a5c561934e089/SMDiagnostics.dll ---------------------------------------- System.ServiceModel.Internals Assembly Version: 4.0.0.0 Win32 Version: 4.6.79.0 built by: NETFXREL2 CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.ServiceModel.Internals/v4.0_4.0.0.0__31bf3856ad364e35/System.ServiceModel.Internals.dll ---------------------------------------- System.Configuration Assembly Version: 4.0.0.0 Win32 Version: 4.6.79.0 built by: NETFXREL2 CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Configuration/v4.0_4.0.0.0__b03f5f7f11d50a3a/System.Configuration.dll ---------------------------------------- System.Xml Assembly Version: 4.0.0.0 Win32 Version: 4.6.1064.2 built by: NETFXREL3STAGE CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Xml/v4.0_4.0.0.0__b77a5c561934e089/System.Xml.dll ---------------------------------------- System.Runtime.Serialization Assembly Version: 4.0.0.0 Win32 Version: 4.6.79.0 built by: NETFXREL2 CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_MSIL/System.Runtime.Serialization/v4.0_4.0.0.0__b77a5c561934e089/System.Runtime.Serialization.dll ---------------------------------------- System.Transactions Assembly Version: 4.0.0.0 Win32 Version: 4.6.79.0 built by: NETFXREL2 CodeBase: file:///C:/windows/Microsoft.Net/assembly/GAC_64/System.Transactions/v4.0_4.0.0.0__b77a5c561934e089/System.Transactions.dll ---------------------------------------- ************** JIT Debugging ************** To enable just-in-time (JIT) debugging, the .config file for this application or computer (machine.config) must have the jitDebugging value set in the system.windows.forms section. The application must also be compiled with debugging enabled. For example: <configuration> <system.windows.forms jitDebugging="true" /> </configuration> When JIT debugging is enabled, any unhandled exception will be sent to the JIT debugger registered on the computer rather than be handled by this dialog box.

CAUSE:
This issue occurs when the "_VisBuilder" folder contains an extra subfolder "_VisBuilder" which has the Visualization Builder plugins is deployed into the Strategy Web installation folder or to the

code/plugins

subfolder inside the Strategy Desktop installation folder as shown below:

Figure 3: Visualization Builder plugins using an incorrect folder structure

ACTION:
To fix the issue, copy the "_VisBuilder" folder that directly contains the Visualization Builder plugins as shown below:

Figure 4: Visualization Builder plugins with correct folder structure

into the existing plugins subfolder inside the Strategy Web installation folder, or to the existing Content/Resource/code/plugins subfolder inside the Strategy Desktop installation folder.

Figure 5a: Existing plugins subfolder inside the Strategy Desktop installation folder

Figure5b: Existing plugins subfolder inside the Strategy Web installation folder
KB429075

Comment

0 comments

Details

Knowledge Article

Published:

August 16, 2017

Last Updated:

December 12, 2018