This page covers common warning messages and troubleshooting tips for Compliance Tracker 365.

⏳ Wait Message

Message: Access to the management page is currently blocked as configuration information is missing from search results.

• Compliance Tracker 365 leverages SharePoint’s inbuilt search indexes to retrieve data.
• For new sites, search may take up to 1 hour to start indexing content.
• During this time, a message is displayed in the Management page blocking access to prevent configuration issues.
• Once indexes are in sync, the message will be cleared.

ℹ️ This is a one-time wait. For existing sites, the message should clear after a few seconds.

🚨 500 Internal Server Error

Message: 500 Internal Server Error while performing search.

• Occasionally, administrators may see a search error warning message.
• These are generated from SharePoint Online and indicate a query has failed.

Fix:

• Reload the page.
• If the error persists (especially during setup), wait a few minutes and reload again.
• These messages are only displayed to Site Collection Administrators.

🔄 Configuration Index Not in Sync

Message: Configuration index not in sync. Documents may not be indexed until message disappears.

• Seen in new installs when minor configuration changes are out of sync.
• Compliance Tracker 365 can still be configured, but some changes won’t reflect until indexes are updated.
• Index updates usually take 1–2 minutes.

Notes:

• Licenses, terms, and profiles can be configured, but results will not show in My Reads until the message disappears.
• Selecting terms related to a parent site may fail until the parent site’s index clears.

👤 User Profiles Indexing

Message: User Profiles are still being indexed by search.

• User profiles are returned by search.
• If the search index is not up to date, a warning message appears.

Fix:

• Click Skip search check to load profiles directly from the profiles list.
• This may take longer but ensures the most up-to-date profiles are used.

❌ User Profiles Not Supported

Message: User Profiles are not supported in this site due to a shared Terms set originally being used.

• Likely the User Profile management lists are missing from the site.

Fix:

1. Open Site contents from the site settings menu.
2. Click the 3 dots next to Compliance Tracker 365 and select Remove.
   • No settings or data will be lost, but the app will be temporarily unavailable.
3. Click Add an app and select Compliance Tracker 365 to recreate the missing lists.
4. Open the Management page from Site Pages and select a new Term set.

🔒 Permission Issues

Message: It looks like there was a small glitch. If you see this again, please contact the site owner.

• Displayed if the reader does not have Contribute access to record their read.
• The Visitors group is automatically granted access to the CT Log list during setup.
• Enhanced permissions (via Flow) grant access to individual folders.

Fix:

• Check that Visitors have Contribute access to the CT Log list.
• If Enhanced permissions are enabled, reset permissions on the user’s log folder:
  1. Open the CT User Profile list from Site contents in the profile management site.
  2. Search for the user’s name/email.
  3. Open their profile entry and remove text from User Details.
  4. Permissions will reapply during the next scheduled run.

📂 Site Pages Not Found

Message: ‘Site Pages’ can’t be found. Setup stopped.

• Compliance Tracker 365 must be installed in an English language site collection.
• Subsites can be created in local languages.

🛠️ General Troubleshooting

Issue: Expected documents/pages not displayed in My Reads web part.

Check the following:

• Tracker type is not set to Hidden.
• Document/page is published as a major version.
• Mandatory/Optional tags are set correctly.
• File has not already been read (check Contents I’ve read).
• Readers have access to content (profiles do not automatically grant permissions).
• Content is indexed (check Summary report details in Management > Report).
• If content is missing, wait, republish pages, or raise a support ticket with Microsoft.

Issue: No terms available for selection under Mandatory/Optional fields.

• Use Manage > Terms to configure and select the term set.
• Use Management > App > Reset to update configuration.
• This will open the My Reads page—click Reconfigure at the top of the web part.

📋 Restrictions and Limitations

• Compliance Tracker 365 only supports English site collections.
• Subsites can be created in local languages.
• The Hub Visitors group is configured for English deployments.
  • For other languages, apply the Hub Visitors group as a contributor to the Log list.

🔧 PnP Modern Search Extension Error

Error: Missing helper: “getReadDate”

• Ensure you are using the latest version of the Search Extension and PnP Modern Search.

🏠 Home Pages Limitation

• Home pages do not appear in My Reads due to a SharePoint search limitation.
• Trackers can still be added to home pages, but they will not display as targeted content.

🔗 Repost Pages and .url Files

• Repost pages and .url link files are not removed from My Reads.
• Ensure they are set to Automatic (for display) or Hidden.
• Redirected content cannot be targeted with Read, Feedback, or Quiz trackers.

🚫 Invalid Characters in Terms

• Do not use : in a term.
• Although allowed in the term store, it is used as a delimiter in search.