Disable the social analytic widgets for individual users
Use SearchService commands to control whether specific users are included or excluded from the social analytics service. The social analytics service is enabled for all users by default.
Before starting
To edit configuration files, use the IBM WAS wsadmin client. See Starting the wsadmin client for details.
About this task
You can use SearchService commands to exclude a specified user from the social analytics service. When a user is excluded from the social analytics service, the service does not build or infer relationships between that user and other users in the organization. The exempted user:
- Is not returned as a related person in search results.
- Is not recommended in the Do You Know widget.
- Is not displayed as a link between two people in the Who Connects Us widget.
When the administrator excludes a user from the social analytics service, the user still receives recommendations from the Recommendations widgets in Communities and the Home page, because these recommendations are based on the user's collaboration history with other people in the organization rather than on the user's social network.
The list of users who are included in the social analytics service is processed when the Search application starts up, and the list is only refreshed on completion of social analytics indexing tasks.
Procedure
To enable or disable the social analytic widget service on a per-user basis...
- From the dmgr host:
cd $DMGR_PROFILE/bin
./wsadmin.sh -jython
execfile("searchAdmin.py")If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, pick the node where the file is stored.
- To exclude a user from the social analytics service, enter one of the following commands.
SearchService.optOutOfSandByEmail(String email)
Excludes the user with the specified email address from the social analytics service.
This command takes a single argument:
- email. The email address of the user who is to be excluded from the social analytics service. This argument is a string value.
For example:
SearchService.optOutOfSandByEmail("ajones10@example.com")
SearchService.optOutOfSandByExId(String externalId)
Excludes the user with the specified external ID from the social analytics service.
This command takes a single argument:
- externalId. The external ID of the user who is to be excluded from the social analytics service. This argument is a string value.
For example:
SearchService.optOutOfSandByExId("11111-1111-1111-1111")
- To enable a user for the social analytics service, use one of the following commands.
SearchService.optIntoSandByEmail(String email)
Includes the user with the specified email address in the social analytics service.
This command takes a single argument:
- email. The email address of the user who is to be included in the social analytics service. This argument is a string value.
For example:
SearchService.optIntoSandByEmail("ajones10@example.com")
SearchService.optIntoSandByExId(String externalId)
Includes the user with the specified external ID in the social analytics service.
This command takes a single argument:
- externalId. The external ID of the user who is to be included in the social analytics service. This argument is a string value.
For example:
SearchService.optIntoSandByExId("11111-1111-1111-1111")
Parent topic
Administer SearchRelated concepts
Scheduling tasksRelated tasks
Disable the social analytics serviceRelated reference
SearchService commands