416.467.9100 | Dundas Data Visualization | Login
Welcome Guest
Dashboard v5.0

This site makes extensive use of JavaScript.

Please enable JavaScript in your web browser and reload the page before proceeding.

Troubleshooting SharePoint WebPart Connection

Hide navigation
RSS
Modified on Wed, 23 Jul 2014 09:59 AM Categorized as Error Message, Errors, Login, SharePoint, Troubleshooting

Dundas Dashboard for SharePoint is a Web Part that lets your SharePoint users view and interact with available dashboards from your Dundas Dashboard server. You can go over this troubleshooting guide if you are having issues logging in to the SharePoint Server Web Part, either when using a Local or Windows User Account.

Note: Make sure you've followed the steps on Installing Dundas Dashboard for SharePoint

Issue: ''Connecting'' message does not go away

In general, this is a problem with Silverlight's URL restrictions and not a problem with Dundas Dashboard. You can find general information on this error here. When you get this error you should see a blank area where the Silverlight plugin starts, but does not load Dashboard. If you right click on the area you should see the Silverlight right click menu.

The  Connecting  message does not go away.

The ''Connecting'' message does not go away.


To Troubleshoot:
  1. Verify if it is a Cross-scheme issue:
    • To prevent an SSL mismatch, both the SharePoint site and the Dashboard site should use the same scheme. Both servers should be on HTTP, or both should be on HTTPS.
    • When Dashboard is integrated into an application which uses HTTPS, Dashboard must be configured to run using HTTPS. This is common with SharePoint sites or applications with limited access. Silverlight will not load an application from an insecure site on a secure page.
    • If you are using SSL, make sure that the Dashboard web application has a proper and valid SSL certificate associated with it. If it is an SSL issue there are three things to check:
      • In the IIS Manager, select the server name, then select server certificates. Make sure the “Issued To” column matches the URL being used to access the site.
      • If the SSL certificate is self-signed, or not signed by a default trusted source like VeriSign, you will need to install the root certificate on the SharePoint machine in the trusted certificate store. A tutorial on how to create a Self Signed Certificate in IIS 7 can be found here.
      • The root certificate also needs to be installed through SharePoint Central Administration. To do this:
        • Under the Security->General Security->Manage Trust section, select New
        • Give it an appropriate name
        • Use add the certificate.
  2. Verify if it is a Cross-domain issue:
    • When integrating Dashboard into an application, and if the Dundas Dashboard server application is not on the same server and port as your application, you need to make sure the root of the website where the Dundas Dashboard server application is hosted contains a valid client access policy file. You can find more information here.
      Note: During Installation of a new Dundas Dashboard instance, you have the option to create a client access policy.
  3. Verify if it is a Cross-zone issue:
    • It is possible that you have mismatched internet zones, internet/intranet. Both Dashboard and SharePoint should be within the same security zone.
  4. Check for missing MIME types:
    • Dundas Dashboard's viewer is a Silverlight application. All Silverlight applications (.XAP) must be served from IIS with the MIME type application/x-silverlight-app. If the MIME type is wrong, Silverlight will start up but will not load the application. Using your tool of choice, make sure the .XAP file loaded by the browser is the right MIME type. You can find more information here.
  5. Use Fiddler or Firebug to monitor network traffic:
    • If none of the above applies to your set-up, or you are still getting issue(s) after making the appropriate updates, you need to use a utility (e.g. Fiddler, Firebug) that can monitor network traffic between the client and the Dundas Dashboard server. You can find more information on such utilities here.

Issue: Red ''Unable to Connect'' error message

If this is the error message received, it is very likely a server error connecting from SharePoint to Dashboard. The Silverlight plug-in should not have loaded. Verify this by right clicking on the space where the plug in would be normally loaded and make sure the Silverlight menu does not appear.

The  Unable to connect to server  .

The ''Unable to connect to server''.


Tip: Additional details on the error message can be found by hovering over the red error message.

To Troubleshoot:
  1. Verify the Dundas Dashboard URL:
    • Ensure that the Dundas Dashboard URL is correct. Try to connect to this URL from a separate browser window on the client machine, and see if you are able to connect/log-on. Try also to connect/log-on directly to the Dundas Dashboard application from the SharePoint server using a separate browser window.
  2. Verify the Dundas Dashboard Login:
    • If you are using local user account, make sure you have created the account in Dundas Dashboard, and you are entering the correct user name and password.
    • If you are using Windows account to login, make sure you've created the Windows user or Windows group in Dundas Dashboard, and you've configured Windows Login.
  3. Verify if it is a Cross-scheme issue:
    • To prevent an SSL mismatch, both the SharePoint site and the Dashboard site should use the same scheme. Both servers should be on HTTP, or both should be on HTTPS.
    • When Dashboard is integrated into an application which uses HTTPS, Dashboard must be configured to run using HTTPS. This is common with SharePoint sites or applications with limited access. Silverlight will not load an application from an insecure site on a secure page.
    • If you are using SSL, make sure that the Dashboard web application has a proper and valid SSL certificate associated with it. If it is an SSL issue there are three things to check:
      • In the IIS Manager, select the server name, then select server certificates. Make sure the “Issued To” column matches the URL being used to access the site.
      • If the SSL certificate is self-signed, or not signed by a default trusted source like VeriSign, you will need to install the root certificate on the SharePoint machine in the trusted certificate store. A tutorial on how to create a Self Signed Certificate in IIS 7 can be found here.
      • The root certificate also needs to be installed through SharePoint Central Administration. To do this:
        • Under the Security->General Security->Manage Trust section, select New
        • Give it an appropriate name
        • Use add the certificate.
  4. Verify if it is a Cross-domain issue:
    • When integrating Dashboard into an application, and if the Dundas Dashboard server application is not on the same server and port as your application, you need to make sure the root of the website where the Dundas Dashboard server application is hosted contains a valid client access policy file. You can find more information here.
      Note: During Installation of a new Dundas Dashboard instance, you have the option to create a client access policy.
  5. Verify if it is a Cross-zone issue:
    • It is possible that you have mismatched internet zones, internet/intranet. Both Dashboard and SharePoint should be within the same security zone.
  6. Check for missing MIME types:
    • Dundas Dashboard's viewer is a Silverlight application. All Silverlight applications (.XAP) must be served from IIS with the MIME type application/x-silverlight-app. If the MIME type is wrong, Silverlight will start up but will not load the application. Using your tool of choice, make sure the .XAP file loaded by the browser is the right MIME type. You can find more information here.
  7. Check the Event Viewer logs.
    • If this red "Unable to connect" error is shown, it should always generate an error message here with more details. Note that you must check the event log of the SharePoint server, not the client machine, and that if the SharePoint environment is in a farm, you may need to individually check each front end server on the farm to find the correct event log entry.
  8. Use Fiddler or Firebug to monitor network traffic:
    • If none of the above applies to your set-up, or you are still getting issue(s) after making the appropriate updates, you need to use a utility (e.g. Fiddler, Firebug) that can monitor network traffic between the client and the Dundas Dashboard server. You can find more information on such utilities here.

Note: If you get an error message about something like "Could not establish trust relationship for the SSL/TLS...", refer to this article.

Issue: ''Your login credentials were not recognized.'' error message

Unable login using the Local or Windows account.

Unable login using the Local or Windows account.


To Troubleshoot:
  1. Verify the Dundas Dashboard URL:
    • Ensure that the Dundas Dashboard URL is correct. Try to connect to this URL from a separate browser window on the client machine, and see if you are able to connect/log-on. Try also to connect/log-on directly to the Dundas Dashboard application from the SharePoint server using a separate browser window.
  2. Verify the Dundas Dashboard Login:
    • If you are using local user account, make sure you have created the account in Dundas Dashboard, and you are entering the correct user name and password.
    • If you are using Windows account to login, make sure you've created the Windows user or Windows group in Dundas Dashboard, and you've configured Windows Login.



Related topics


Click to return to: Documentation | Dundas Dashboard for SharePoint

About Dundas | Contact Us Follow us on Twitter! | Privacy Statement | Report Site Issues

Copyright © 2009-2014 Dundas Data Visualization, Inc.