This documentation supports the 21.3 version of Smart Reporting.To view an earlier version, select the version from the Product version menu.

Automatically synchronizing AR System users to Smart Reporting


After installing BMC Helix ITSM: Smart Reporting(Smart Reporting), the administrator adds users from AR System to Smart Reporting through the onboarding process. After the initial onboarding of users, when a user with a Fixed, Floating, or Bundled license type is added, updated, or deleted in AR System, the User Sync utility automatically synchronizes that user record in real time in Smart Reporting. For example, if a new user is added to AR System, the User Sync utility immediately creates a new record for that user in Smart Reporting. The User Sync utility also synchronizes the Timezone of the user from the User Preference form of AR System to Smart Reporting.

Note

User cache does not get synchronized on read-only DB-hosted AR server. For example, if a user moves from company A to company B, the user must not be able to access the data for company A. However, on read-only DB-hosted AR Server, the user A is still able to access data of company A. To prevent this, either run the cache sync or restart the AR server. For more information, see arcache.exe or arcache in the AR System online documentation.

Instant synchronization feature is available out-of-the-box. However, an administrator can disable the instant synchronization of users by disabling the following filters in AR System:

  • RSR:UserSyncDeleteUser
  • RSR:UserSyncCreateUser
  • RSR:UserSyncModifyUserQual
  • RSR:UserSyncModifyUser
  • RSR:UserSyncModifyCaseCreate
  • RSR:UserSyncModifyCaseDelete

If you set the default role of users before user synchronization, then all the new users that are synchronized are assigned the new role. The role of the existing users is not changed. For more information, see Setting the default role.

The following diagram illustrates the automatic user synchronization process:

UserSync.png


Ensuring Smart Reporting user synchronization runs successfully

For the User Sync utility to work correctly, make sure that following occurs: 

  • The onboarding process has completed successfully.
  • The email ID for each user is unique.
  • The OrgName Reporting Server on the SmartReportingServer_Info form and the OrgName defined during the Smart Reporting onboarding process are the same.

When to manually run user synchronization

In addition to the User Sync utility synchronizing users, they are also synchronized in Smart Reporting through the RSR:UserSync escalation at the scheduled interval. You can manually run the RSR:UserSync escalation in the following scenarios:

  • If the users are not automatically synchronized in Smart Reporting in real time.
  • If a user's login details changed.
  • If you want to synchronize users based on the modified filter criteria in Smart Reporting. For example, after initial onboarding, the admin updates the user filter criteria, and those users are synchronized into Smart Reporting through the escalation.

The RSR:UserSync escalation runs every 12 hours, but you can change the frequency of this escalation.

For more information see To change the frequency of an escalation and To manually run an escalation.

What the User Sync Utility does not automatically change

Login details

If you change the login details of a user on the AR System server, the User Sync utility does not modify the login details of that user in Smart Reporting. Instead, the User Sync utility creates a new record for that user in Smart Reporting. The next time the RSR:UserSync escalation runs, the User Sync utility deletes the existing record of that user.

Language preferences

Though the User Sync utility updates the user information in Smart Reporting, it does not change the language preference that the user sets in Smart Reporting. To manually change the language preference, see Setting-your-locale-and-time-zone-for-Smart-Reporting.

Deleted users

When a user is deleted from AR System, if this user has any private reports or public broadcasts in Smart Reporting, the User Sync utility does not delete the user from Smart Reporting. Instead, it displays a warning message in the smartreporting.log file, which is located in the ARSystemInstallDir/ARServer/Db directory. You must change the ownership of the private reports and public broadcasts and then manually delete this user from Smart Reporting. For more information, see Managing-Smart-Reporting-user-accounts.

Synchronizing users that are a part of the Smart Reporting Custom App Users group

If you have not installed BMC Helix ITSM, you can add users to Smart Reporting from the Smart Reporting Custom App Users group in AR System. You can onboard up to seven users that are part of this new group. While synchronizing with Smart Reporting, the Smart Reporting User Sync utility syncs only these seven users to Smart Reporting. 

Notes

  • To synchronize more than seven users, contact BMC Customer Support.
  • If any of the onboarded users are deleted from the Smart Reporting Custom App Users group, the User Sync utility syncs the next users based on the user creation time.

To view the user synchronization job status

  1. After users are successfully onboarded, on the SmartReportingServer_Info form, ensure that the Report Server details are correctly populated.
  2. Open the smartreporting.log file in the ARSystemInstallDir/ARServer/Db directory, and verify that no error messages appear.

To change the frequency of an escalation

  1. Log in to Developer Studio.
  2. Select the required workspace.
  3. Enter the AR System server user name and password.
  4. From the File menu, select Switch Mode. Click OK on both alerts that are displayed.
  5. In the left pane, expand All Objects, and open Escalations.
  6. Under Filtering Options, select Name from the first drop-down menu and Contains from the second drop-down menu.
  7. Enter RSR in the text box and press Enter.
  8. From the search results, double click the required escalation.
  9. Under Execution Options, select the DaysHours, and Minutes as per your requirement.
  10. Click Save.

To manually run an escalation

  1. Log in to Developer Studio.
  2. Select the required workspace.
  3. Enter the AR System server user name and password.
  4. From the File menu, select Switch Mode
  5. Click OK on both alerts that are displayed.
  6. In the left pane, expand All Objects and open Escalations.
  7. Under Filtering Options, select Name from the first drop-down menu and Contains from the second drop-down menu.
  8. Enter RSR in the text box and click Enter.
  9. From the search results, right click the required escalation.
  10. Click Run.

Where to go from here

Managing-Smart-Reporting-user-accounts

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*