Automatically synchronizing AR System users to Smart Reporting
The following diagram illustrates the automatic user synchronization process:
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.
To view the user synchronization job status
- After users are successfully onboarded, on the SmartReportingServer_Info form, ensure that the Report Server details are correctly populated.
- 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
- Log in to Developer Studio.
- Select the required workspace.
- Enter the AR System server user name and password.
- From the File menu, select Switch Mode. Click OK on both alerts that are displayed.
- In the left pane, expand All Objects, and open Escalations.
- Under Filtering Options, select Name from the first drop-down menu and Contains from the second drop-down menu.
- Enter RSR in the text box and press Enter.
- From the search results, double click the required escalation.
- Under Execution Options, select the Days, Hours, and Minutes as per your requirement.
- Click Save.
To manually run an escalation
- Log in to Developer Studio.
- Select the required workspace.
- Enter the AR System server user name and password.
- From the File menu, select Switch Mode.
- Click OK on both alerts that are displayed.
- In the left pane, expand All Objects and open Escalations.
- Under Filtering Options, select Name from the first drop-down menu and Contains from the second drop-down menu.
- Enter RSR in the text box and click Enter.
- From the search results, right click the required escalation.
- Click Run.
Where to go from here