Knowledgebase
Act.com
Deutsch Français

Act! Insight fails to load when trying to access it

  • Updated
Symptom: When I try to access Act! Insight, it does not load
 
Product Details: 
Product Family:  Act!
Product: Act! Premium (access via web)
Version: v20
Integration: Act! Premium Web API, Act! Connect Link
 



Cause: 
 
This can occur for multiple reasons:
  • The Act! database user does not have Web API Permissions
  • The Act! Web API is the wrong version
  • The Act! Web API Host service is not running (Act! Premium for Windows only)
  • The Act! Web API Host service does not have permissions to access the database folder (Act! Premium for Windows only)
  • The database has not been added to the Website Administration (Act! Premium (access via web) installations only)
  • The admin.xml file has an invalid host listed for the database (Act! Premium (access via web) installations only)
 
 
 
Solution: 
 
The Act! database user does not have Web API Permissions

This can occur if the user attempting to use Act! Insight is not an Administrator level user and hasn't had Web API Access permissions added to their login. To resolve this:
  1. Login to the database as an administrator user
  2. Use the Manage Users option to add the Web API Access permission to the affected user. For information on managing users, refer to the following knowledgebase article:

    How to create and manage database Users in Act!


  3. Login to the database as the affected user and test Act! Insight


Wrong Act! API version
 
  1. Verify the version number of the Act! API Host by going to http://localhost/act.web.api/api/system
  2. If the version is lower than 1.0.220.0, download and install the update by going to https://www.act.com/inproduct/ie/webapi_v20_install
  3. Test accessing the Act! Insight feature
 
 
Act! API Host service is not running (Act! Premium for Windows only)
 
  1. On your keyboard, press the Windows key + R to bring up the Run dialog
  2. Type services.msc, then press Enter
  3. Right-click Act! Web API Host and choose Start
  4. Test accessing the Act! Insight feature
 
 
Inadequate permissions (Act! Premium for Windows only)

This can occur if the database files are stored in a location that the Act! API Host service does not have permission to access. You may be able to resolve this by running the service as a Windows user that has access permissions to the database in question. To do this:

  1. From the machine where Act! Insight fails to load, press the Windows key + R on your keyboard to bring up the Run dialog
  2. Type services.msc, then press Enter
  3. Right-click Act! Web API Host and choose Properties
  4. Click the Log On tab
  5. Select the option for “This account:”, then click Browse…
  6. Enter the name of an account that has proper permissions to access the databases folder for your database, then click OK
  7. Enter the Password and Confirm Password for the used in step 6, then click OK
  8. Right click Act! Web API Host and choose Restart
  9. Test accessing the Act! Insight feature
 
 
Database has not been added to Website Administration (Act! Premium (access via web) installations only)
 
If you have installed Act! Premium (access via web) and you are attempting to access Act! Insight while logged into the database using the Windows client, you may be able to resolve this issue by adding the database to the Website Administration.
 
  1. Click Tools > Web Site Administration…
  2. Click the Add/Remove Database tab
  3. Under Databases:, click the Add… button
  4. Browse to and select your database, then click Open
  5. Enter the Admin user name and password for the database, then click OK
  6. Wait for a moment while it tests, then click OK when the success message appears
  7. Click Close on the Web Site Administration
  8. Test accessing the Act! Insight feature
 

Invalid host in the admin.xml file (Act! Premium (access via web) installations only)
 
It’s possible that rather than having the server name listed in the admin.xml file, it could be displaying as “.” To verify and resolve this:
 
  1. Close Act!
  2. Browse to C:\Program Files (x86)\ACT\Act for Web\PadFiles
  3. Open admin.xml with a text editor
  4. Look for the following line:

    &ltdatabase dbName=“[yourdatabasename]” dbHost=“.” Valid=”True” /&gt
     
  5. Change the period in dbHost=“.” to the name of your server or, if the database is stored on the computer you are on, change it to read as dbHost=“(local)”
  6. Save the file
  7. On your keyboard, press the Windows key +  R to bring up the Run dialog
  8. Type inetmgr then press Enter
  9. In the Internet Information Services (IIS) Manager, right click the server name, then click Stop
  10. Wait for IIS to stop, right-click the server name again, then click Start
  11. Test accessing the Act! Insight feature
 

Related articles