Disabling of Event Receivers

1. Introduction

2. Requirements

3. Configuration

4. Re-enabling Event Receivers

5. Notes

During migration of documents from the existing OpenText platform to WorkPoint it is recommended to disable event receivers to optimize performance. A common standard when performing such migration is to disable event receivers for the entire solution, then do the migration, and then re-enable event receivers. This is, as previously mentioned, for performance reasons. It is also possible to only disable event receivers for specific sites instead of the entire solution. The configuration steps are explained in the Configuration section of this article.

When disabling Event Receivers for a single entity site, the following features will NOT automatically trigger upon creation, modification, or deletion of elements:

• Aggregation for entity site lists
• Inheritance of user fields
• Numerator service
• List Item security rules

If disabling Event Receivers for all sites or the root site, the following features will ALSO NOT automatically trigger upon creation, modification, or deletion of elements:

• Automatic site creation
• Aggregation for parent entity and relations
• Stage tagging
• Entity security rules
• Item Location
• Update of favorites and relations for entity
• Update of inheritence when entity is updated

WorkPoint is now able to specify certain accounts, ignored accounts (or "Service Accounts"), for which actions will be ignored by the event receivers. This is done by introducing an account check during initialization of the event receivers. If the account is found in the “Ignored accounts” list, all following code is skipped.

The interface for setting up Service accounts and disabling of event receivers can be accessed from the left side menu of the WorkPoint 365 Administration as shown in the image below:

1. From the left side menu of the WorkPoint 365 Administration, click the "Event Receiver Management" button.

Users are advised that when migration is needed, it should be done from a Service Account.

Disabling event receivers is included in the WorkPoint 365 Core package.

The settings for Service Accounts and Disabling of Event Receivers can be done through the interface accessible from the left side menu of the WorkPoint 365 Administration. It can be configured in the following way:

2. One or more people, SharePoint groups or Active Directory groups can be chosen as ignored users. It is recommended to create a specific service account and use that one as ignored user. Available people and groups can be chosen by starting to type their names in the field. Available options become selectable from a list.
3. The administrator can choose to disable event receivers for the SharePoint System Account by checking the checkbox.
4. Choose whether the disabling of event receivers should apply to all sites or only specific sites. If the scope "All Sites" is chosen, no more settings needs to be configured. If the scope "Specific Sites" is chosen, the interface is expanded with the following section:

In the text box in the image above you can enter the URL of one or more specific sites for which event receivers should be disabled. The user is advised that if multiple sites require disabling of event receivers, each site should be separated by a carriage return.

Disabling Event Receivers only for specific sites is helpful if an organization is running and using WorkPoint at the same time as data migration is needed. In that case, disabling event receivers for the entire solution might not be optimal, and disabling the event receivers only for the specific sites is a good way to circumvent issues related to this scenario.

5. Click the "Save"-button to confirm and save the settings.

The event receivers should now ignore events triggered by the specified account(s).

Under certain circumstances, it may be necessary to run jobs to re-enable specific features after disabling of event receivers. Examples could be:

• Aggregation
• Inheritance
• Security rules

In this case, contact support at support@workpoint.dk for more information and help regarding any issues in relation to this.

It is recommended for this feature to create a specific service account and to use that as ignored user.