MicroStrategy ONE

Troubleshooting HyperIntelligence for Web

While using HyperIntelligence for Web, you may encounter the following errors. Use the guidance below to troubleshoot these errors.

Error: Invalid Data or Card

This error appears in the extension when trying to enable a card that has been modified or deleted in Workstation. To resolve the warning, click the Refreshbutton in the extension. The card is removed from the extension if it was deleted.

Error: Access Denied

This error appears on the extension when you do not have the necessary security access. To view cards, you must have View access or higher to the card and the cube. To modify the permissions to an object, see Controlling Access to Objects: Permissions.

If you already have View access to both the card and its cube, ensure you have access to the keyword attribute. To view the card, you need View access or higher on the attributes on the card. Verify your permissions by checking the ACL to attributes in Object Security Access.

If the above troubleshooting techniques do not resolve the warning, click the Refreshbutton on the extension. Its possible the card was removed from Workstation or ACL permissions were recently modified.

Error: Missing Keyword Attribute

This error appears on the extension when your card does not contain a keyword attribute. It's possible your card was saved without an attribute in the card header. Open the Card Editor in Workstation to verify if your card has an attribute in the header. If your card does have an attribute in the header and the warning persists, ensure the attribute and its values were not deleted or set to null in your cube. If your card header appears with two dashes (--) then your attribute has a value of null.

If the above troubleshooting techniques do not resolve the warning, open MicroStrategy Developer or Workstation to check to see if one or more security filters on your cube exclude the data for your keyword attribute.

Error: Locked Keyword Attribute Form

This error appears when enabling a card containing a multi-form keyword attribute that has a locked attribute form. To resolve the warning, you must unlock the keyword attribute form or use a different attribute as your keyword attribute. For more information on locked attribute elements, see Controlling the display of attribute elements.

To unlock an attribute form, perform the following steps:

  1. Open MicroStrategy Developer.
  2. Double-click your keyword attribute. The Attribute Editor appears.
  3. Select the Display tab.
  4. Under Element Display, select Unlocked.
  5. Click Save and Close.
  6. Restart the Intelligence Server for your changes to take affect.

Error: Unsupported Card Template

This error appears when a card's template is not supported by the Library Server.

This can happen in certain situations when you view the card on a different Library Server than the one you created the card on. For example, say your card was built with a custom template that was coded and added on the Library Server and stored in the metadata. If you connect to the same metadata using a different Library Server, you cannot enable the card since the Library Server you are using does not have the custom coded template. Similarly, say you build a card with a new template using the latest version of the Library Server and store the card in the metadata. If you connect to the same metadata using an older Library Server version, you cannot enable the card.

Error: You have exceeded the maximum storage available

This error appears when the total number of keywords and alternate keywords from all enabled cards exceeds 500,000. Turn off some cards in the extension (preferably with large datasets) to free up space to enable other cards. 

Error: Server Error

This error appears when enabling a card while the Intelligence Server is down or has timed out. Contact your administrator to check the status of the Intelligence Server.

Error: Your session timed out, please log in again

This error appears when enabling a card while the Intelligence Server is down or has timed out. Contact your administrator to check the status of the Intelligence Server.

Error: Card is not available

The error "Card is not available" may appear for several reasons:

  • You have more than 10 cards enabled and after refreshing the extension, the warning appears. The reason the warning appears in this situation is because the cards were not downloaded properly after enabling them. This is due to the working set limitation on the Server side.
  • The cube data behind the card has been re-structured or deleted in the metadata or Workstation. Confirm whether or not the cube has been modified or deleted.
  • The hard disk of your machine is running out of space and you continue to enable more cards in the extension. The reason the warning appears in this situation is because you need to free HD space on the machine to make room for more cards.
  • You are not connected to the network or the network is off. Check the status of the network on your machine and try again.
  • It's possible that large data preparation on the Server side has caused it to time out. You can check the network transaction using Developer Tools on your browser. Look for the sentence, "Your request has timed out. Please try again later."

Error: Card Data is Unavailable

This error appears when creating or editing a card based on an unpublished cube. To publish your cube, see the In-Memory Analytics Help.

This error appears when hovering over keyword attributes for cards enabled in the extension, but deleted from Workstation. To resolve the error, refresh the extension so you have the latest list of cards available in your environment.

Error: Please connect to an environment version 2019 or newer

This error occurs when the extension is connected to a Library Server that is connected to an Intelligence Server older than MicroStrategy 2019. To resolve this error, in the Library Server admin page, connect to an Intelligence Server version 2019 or later and then log in to the extension.

Error: You don't have the required privilege to use HyperIntelligence

This error appears when you do not have the necessary privilege to use the HyperIntelligence extension. Contact your administrator to grant you the Use Hyper Web privilege.

Error: Please enter a valid environment URL

The error may be encountered due to any of the following reasons:

  • The URL you entered does not belong to a valid MicroStrategy Library Web server. Ensure your URL contains MicroStrategyLibrary at the end, such as http://…/MicroStrategyLibrary.

  • Network connectivity issues are currently rendering the MicroStrategy Library Web server unreachable.

  • The SSL certificate for the Library server is either not valid or has expired.

Error: Server Error

This error appears when logging in to the extension while the Intelligence Server is down or has timed out. Contact your administrator to check the status of the Intelligence Server.

Error: No Cards

This message may appear for several reasons:

  • You do not have access to any cards in your environment. To see what access is required to view the card, open Workstation and select the Cards tab. Right-click your card and select Properties. Choose the Security Access tab to see what permission level you have.
  • You have access to the card, but the search index for one or a few of the projects in the environment are in a corrupted state. To resolve this issue, contact your administrator to rebuild the search index.
  • You have a few cards enabled at the same time the Intelligence Server goes down. If you refresh the extension, the error appears. Contact your administrator to check the status of the Intelligence Server.

Error: Card is not available

This message may appear when hovering over keyword attributes for several reasons:

  • The card object was deleted from Workstation but the extension has not been refreshed. When you hover over keyword attributes, the "Card is not available" error appears on non-cached cards. To resolve this error, click the Refreshbutton to remove the card.
  •  The Library Server or the Intelligence Server is down but the extension has not been refreshed. When you hover over keyword attributes, the "Card is not available" error appears on non-cached cards. Contact your administrator to check the status of both the Library Server and the Intelligence Server.
  • If the network has been lost, hovering over keyword attributes will causes the "Card is not available" error to appear on non-cached cards. Check the network status on your machine to resolve the error.

Error: No login modes are available

This error appears when all the authentication modes configured in the Library Server are not supported by the extension. For a list of supported authentications, see Supported Authentication Methods.

Error: Log in failed

This error appears under the environment URL when Kerberos is the only authentication mode enabled in the environment. This error may also appear under the Log In button if there are multiple authentication modes enabled in your environment.

These errors may appear for several reasons:

  • Kerberos is not configured correctly with the Library Server or the Intelligence Server. Try opening the Library link in a separate browser. If it returns an error, it is most likely a configuration error. Contact your administrator to check the status of your Kerberos configuration.
  • You account is unlinked or disabled. To confirm this, open MicroStrategy Developer and ensure Kerberos is linked to the corporate account and does not have a disabled status.
  • Your machine or browser is not properly configured for integrated authentication with Kerberos. To ensure your machine or browser are configured correctly, locate the existing documentation for Kerberos authentication with Library in terms of browser set up.

Error: The card author has set this card to only appear on the following websites:

Beginning in 2020 Update 1, cards authors can create cards that can only be viewed on specific websites. As such, cards may have an Inactive label on certain websites. The card can still be enabled, but it will not scan the current site for keywords.

To view cards on specific sites, contact the card author so they can modify the card property's Allowed Websites

Error: Disabled for this site

This error appears when you try to use HyperIntelligence on a site that has been specified as a Disabled Website. This setting has higher priority than the Allowed Websites setting introduced in MicroStrategy 2020 Update 1. As such, if the site is listed on Allowed Websites but is also on the Disabled Websites list, the user will be blocked from using HyperIntelligence on this page.

To allow cards, remove the website from the Disabled Websites list.

  1. In the HyperIntelligence extension, click Settings.
  2. Next to the site you want to view cards on, click Remove.

    Now that the website is off the Disabled Websites list, users can view cards on that site.