1. Home
  2. Getting Started
  3. Getting Started with VisualSP
  4. VisualSP FAQ (Frequently Asked Questions)

VisualSP FAQ (Frequently Asked Questions)

Applies to: VisualSP
Print Friendly, PDF & Email
  • What exactly is the VisualSP Help System?

    Our Help System provides in-context, on-demand help to SharePoint, Office 365, and other browser-based applications. It provides walkthroughs, task based video tutorials, tips sheets and annotated screenshots to help users when they need it most. In addition, it has the capability to accept in-house created content or content from the web and display them in-context as well.

    • Is the help content available everywhere or just in one site?

      The context sensitive solution is available everywhere to end users wherever they go. Once deployed, the help content is available in-context and on-demand throughout your environment.

    • Can we buy just the video content without the VisualSP Help System?

      Yes, you can buy the 105 video tutorials package without purchasing the system.

    • How long are the video tutorials?

      The end user level videos in the Help System are each 2 mins or less in duration – just long enough so the end users’ attention is not lost.

    • How easy is it for our company to add custom content so that it can be presented to our users?

      A VisualSP administrator can modify and customize the product in minutes. After the purchase, one of our engineers will guide you through the install and setup process. This person will also train your administrator on how to customize the content.

    • How can I buy the VisualSP Help System?

      Fill out the form on this page to get in contact with us and get the process started.

    • Is the VisualSP Help System available for SharePoint 2010, 2013, 2016, 2019, and Online?

      Yes! Our Help System works for all versions of SharePoint. The functionality is exactly the same in all versions of the system (of course, the content is different). VisualSP can also be used in other browser-based applications as well.

    • If I buy the VisualSP Classic Help System for on-premises and then we migrate to online, do I have to buy the other product as well?

      As long as you have a maintenance plan with us, we will switch you over to the appropriate online version of the product at the time of migration with a customer loyalty discount.

    • Can we get custom videos produced to plug into the Help System?

      Yes, we can produce a custom 10-pack for you (additional cost) and plug it directly into your Help System when we deliver the product.

    • How long has your company been in business. Who are your current customers?

      Rehmani Consulting, Inc. (dba: VisualSP) has been in business since 2005 serving our corporate customers. Feel free to browse through the list of our customers and testimonials.

    • Can you supply a Sole Source letter for VisualSP Help System?

      Yes. We are the only supplier of the VisualSP Help system. We can certainly provide a letter certifying that we are the sole source supplier.

    • Do users see help items that point to or describe functionality that they don’t have access to?

      No. The help system is role sensitive as well. So for example, if a user is an Editor, they would not see help items related to Administrator functionality.

    • What type of analytics do you collect when the application is running? Do you use Google Analytics?

      We use Telerik tools to provide you the graphical data you need about your subscription and your users. You will see that information when you use the admin menu to View Analytics. Our application also uses Google Analytics, but it is only added to our pages, not the host pages. We pass along the page URL to our page so that we can determine the scope of the page and that is picked up by the analytics but we don’t use it for anything in the analytics (we’re just looking at what help items were clicked and which of our pages are viewed). It only tracks anonymous usage of the VisualSP slide-out panel and doesn’t track anything related to the customer’s  sites.

    • Is Analytics data being gathered now, even if we are not licensed for Enterprise? If so, does that mean that if we upgrade the subscription level we will be able to see Analytics on how VisualSP has been used already?

      Yes. Analytics data is collected regardless of subscription level, but it’s not exposed through the application unless you are licensed for Enterprise. If you upgrade later you will be able to see all your historical data.

    • What is your privacy policy?

      You can read our privacy policy here.

    • How does VisualSP affect performance of our system?

      The VisualSP elements are loaded only after everything else on the page has loaded. You should be able to confirm this by noticing that the VisualSP help tab doesn’t appear until after everything else on the page has been rendered. Libraries and graphics that are used throughout the application are cached locally for each user so they don’t have to be loaded each time a page loads. VisualSP runs in its own iframe on the page, so it is isolated from the rest of the page. It does communicate and interact with SharePoint, Office 365, and other browser-based applications, but that is done asynchronously so nothing else that is native to the application is affected.

    • What is the install process and components with the Installation Wizard?

      It depends on whether modern or classic or both are targeted. If modern then an SPFx extension needs to be deployed to the app catalog and a custom user action element added to the site collection. If it’s classic then just a custom user action is added to the site collection.

    • VisualSP doesn’t seem to be working as expected. What troubleshooting steps can I take before I submit a support ticket?

      If VisualSP isn’t working, open the Developer tools (F12) on your browser and look for any errors in the Console tab. Often the errors you see won’t be associated with our product, however it could be helpful for our support team to see the error messages  generated by the browser. You can filter out everything but errors, copy it into a text file and email it to support@visualsp.com.

    • Can I install VisualSP in an environment that uses multi-factor authentication (MFA)?

      Yes. However, instead of using the Installation Wizard, you will need to use our PowerShell script for installation.

    • How does installation work for a large group of users?

      For SharePoint Online the recommended way is through our Installation Wizard. To use VisualSP with O365 you will need a browser extension, which can be deployed via Group Policy. Here are your installation options.

    • How are users authorized to VisualSP? Suppose you have different target groups of users because of a phased introduction of SharePoint. What options do we have?

      Users are activated with cookies. If your users will be restricted from accessing SharePoint via Active Directory, then that will also limit who has access to VisualSP. Another option is to block everyone except for a list of authorized users. You can add to the list as necessary. Read What Happens When ‘Block New Users’ is Enabled for details.

    • How does VisualSP authenticate users?

      VisualSP does not authenticate users, it relies on the host application to do so. Users are activated automatically as part of a VisualSP subscription based on their authenticated identity in the host system. That activation is then stored in cookies. Users without authenticated cookies have only limited access to basic functionality and content in the subscription system. For users and for subscription administrators, authorization is granted when the system browser extension/add-on is activated.

    • How is data protected in transit?

      All traffic is encrypted using SSL via a 2048 bit sha256RSA certificate.

    • Do you scan for malicious code in your Help editor?

      Yes, we white-list acceptable tags. Scripts are not allowed.

    • There are certain sites we don’t want to have contextual help. Can the tab be turned off for certain parts (per App like Word, OneDrive, Outlook) or per SharePoint site?

      Yes, you can control which parts will display the help tab. Please see How and why to use the ‘hide VisualSP tab’ functionality for details.

    • In which way does VisualSP support different SharePoint templates e.g. projectsite, teamsite? Each template has a different design which means it needs to have different In-context help content.

      We have custom content for all different templates and scopes (wiki pages, site pages, lists, libraries, etc.)

    • Can you exclude sites because you may not want to make tab / content available there?

      Yes, you can control which parts will display the help tab. Please see How and why to use the ‘hide VisualSP tab’ functionality for details.

    • Where is VisualSP content stored?

      Content is stored on Azure.

    • What happens to my content when I add a custom help item?

      Your custom help items are added to your subscription and can only be viewed by users in your subscription. Because it is custom, it can only be edited by you.

    • What permission level is needed to install VisualSP using your installation wizard?

      You need to be a site collection administrator.

    • Are there different user groups or only ‘Read’ and ‘Edit mode’?

      From an administrative perspective, there are Subscription Admins, App Admins, and Editors. From a user perspective, VSP follows SharePoint permission groups. So a user with Read privileges would not see Help items that are restricted to users who have Contribute permissions.

    • Can you embed a video in the Walkthrough pop-ups?

      Yes. Check out Adding a Video to a Walkthrough.

    • Suppose you want to use VisualSP in multiple browsers. Is this possible? Do changes to help content have to be made uniquely for each browser?

      VisualSP has extensions for all the major browsers. Once the extension has been deployed, our Help content is browser agnostic so there is no need to create content specific to a particular browser.

    • How do we handle updates from the VisualSP product? What needs to be done by us once there is an update?

      New content/updates are available immediately and automatically. There is no need to do anything on your part.

    • Are there any URLs we should white-list on our firewall?

      Yes. To prevent your firewall from blocking calls to our content server, please white-list  https://visualsponline.azurewebsites.net/

    • What information does VisualSP collect about the user? Does it collect location data?

      The VisualSP application extracts only the username, first name and last name, and email of the user that’s logged in to activate you and associate you with your organization’s subscription (if it has one). This information is stored in our Azure database for the user. There is no “location” data that we collect about the user. The only thing we are determining is what page the user is browsing to in your application in order to serve them the contextual help information. We do that by looking at the URL and other page specific variables.

    • If a user leaves our organization, will their VisualSP subscription automatically be deleted?

      No. Once someone becomes a subscription user, there is no way for VisualSP to know if they have left your organization. The VisualSP Administrator for your organization will need to manually block the user to free up the license. They can do this from the Users tab in the VisualSP Online Help System Management window. Also see What Happens When ‘Block New Users’ is Enabled.

  • What are the technical requirements for installing VisualSP?

    VisualSP can be installed in a variety of ways, such as with a browser extension, through an installation wizard, or PowerShell. Here are further details about your options.

  • How do we plan to store the customized additions on our side when we choose the cloud subscription?

    Your custom help content artifacts can be stored in any location your users have access to. This could be a site assets library, document library, etc.

  • Does VisualSP work in native applications like Outlook, Word, Excel etc.?

    VisualSP works with web-based applications such as Outlook, Word, Excel, etc. VisualSP does not work on client-side applications.

  • What are the browser add-ins required for IE, Chrome and Edge?

    VisualSP has browser extensions available for IE, Chrome, and Edge. They are available here.

  • Can walkthroughs span multiple products ie: SharePoint > Outlook > Teams?

    Walkthroughs can span multiple products. There is a feature when creating the walkthrough to configure that the next step opens on a different page. This does work across applications, as long as both are in the same browser window / tab.

  • Can information in the VisualSP Help panel be customized by library settings (– ex: do we manually add check-in/check-out instructions to those that have it enabled or does VisualSP know to do so?)

    No. The system detects classic / modern UI, scope (library, list, page…), and user permissions in that location. It doesn’t have a way to detect other library settings.

  • Users typically make the connection pretty intuitively that the search blank in the help panel is for help content. If you would like the help content to be searchable outside the panel, that can be done. The entire list of help items can be exported to CSV and then used to populate a list of help items in a SharePoint site. That list would then be searchable via the native SharePoint search boxes. It would also be usable in various other ways – like a web part that filters things down to a specific set of items for display on a web page. We’ve done this for other clients setting up their subscriptions.

Updated on September 16, 2020

Related Articles