Create New Alert

This section describes how to create scheduled Alerts for SPDocKit reports. Alerts are sent after each automatic snapshot, that is snapshot created by the SPDocKit Service.

  • Best Practice reports will be sent when either warnings or errors are detected in the latest snapshot.
  • Difference reports will be sent when differences between the newest snapshot and the previous one are detected.

1. Navigate to the Backstage Configuration Screen and click  Subscriptions and Alerts.

2. When the Manager opens, click New Alert. In General tab, type in the alert name. Under Status section you can see the following information:

  • Whether automatic subscriptions are enabled on the selected farm or not.
  • Last sent on – information on when was the last time this alert was sent. If this is entirely new subscription, it will say Never.

SPDocKit Create New Alert

3. Go to Delivery tab and set the delivery method you would like to use.

  • Email – required fields are Send To and Body. Provide the email address to which you wish the alert to be sent. You can enter more recipients – just separate the email addresses with semicolons. Type in the subject and body text. In case that this method is disabled, click the Configure link to adjust your subscription settings.
  • File Share – input the File Share location here. You can use the Test button to check if the given location is reachable and if SPDocKit can write to the location.
  • SharePoint Library – If this is the first time you are using this feature, you need to create a new library connection. Click New, specify whether you are connecting to an On-Premise or SharePoint Online site. Input the Library URL and the Display name. You can use Integrated or Custom Credentials, whichever suits your needs. Finally, click Test. SPDocKit will try to send a test subscription to check if the given Library URL is in order. If it is you will be notified and you can click the Save button.Please note! Each SPDocKit alert can be sent to a different SharePoint document library. All previously used connections will be listed in this drop down menu so you can use them for multiple alerts. User account running the SPDocKit and SPDocKit service account should have at least Contribute permission level granted on a specified SharePoint document library to successfully upload SPDocKit subscriptions.

You can select all three delivery methods. Scheduled reports will be sent to the email addresses you provided and uploaded to the File Share and SharePoint document library.

4. Go to the Reports tab and click Add Report to select which reports you wish to subscribe to. Choose a report you wish to schedule. Currently, you can pick from Farm Differences, Permissions Differences, Group to Group Compare, Membership Differences and any of the Best Practice reports.

5. For certain reports, you will have to adjust filters to append that report. Those filters will define how the emailed report data will look. Click OK to add the selected report to the subscription. To define the preferred date format, use curly brackets. Only culture-invariant formats are supported, for example: {MM-dd-yyyy}, {dd-MM-yyyy}, or {MM-yyyyy-dd}.

SPDocKit Add Reports to Alert

6. You can add more reports by repeating previous steps. Also, you can Edit current report settings or Delete added reports.

7. Click  Save & Close to finish creating the Alert and exit. If you wish to send this alert immediately, click the Save & Send Now.


If you would like to schedule best practices alert, Alert Me is available in Home ribbon of the Best Practices tab. The best practices report that is currently selected will be added to this alert automatically. If you want to add currently selected best practices report to an existing alert, just use the drop down menu in Alert me icon to select Add to Existing Alert option. Select the alert to which you would like to add more reports and click OK.