13.10.SharePoint shortcut repair job configuration
The SharePoint shortcut repair job is a specialized maintenance tool designed to help locate and repair shortcut files based on specific parameters. Its primary function is to ensure that shortcuts have the correct FileType, filtered according to the selected UFO filter and shortcut type. To run the job, selecting both the UFO filter and the shortcut type is mandatory. The repair process only applies to HTML shortcuts. The tool operates strictly within the selected shortcut repository ID, meaning it will ignore shortcuts outside this scope.
Please note that when a shortcut matching the criteria is found, it is always reported as “repaired”, even if no actual modification was made. The “repaired” status only indicates that the shortcut was identified and processed, not necessarily that any change was applied.
The SharePoint shortcut repair job can be created and configured on the Jobs page. Click the “+ new” button, fill the required settings (Job type, Run on node, Display name) in the pop up window and click on “Add“.
To configure the job immediately, click “Yes” in the next pop up window, or configure it later on (using the “Configure” option in the job’s context menu).
On the job’s configuration page go through the following sections. Most of them are mandatory, but filtering settings is optional.
✓ Report mode settings
If the ‘Use report mode‘ checkbox is checked, the job will run in report mode and the user will be able to download a .csv report here in this section after the job finishes the run. This file will contain a list of items that belong to the site(s)/related path(s) that is (are) selected in section ‘Sites to process‘ of the job and some information about them, including whether they will be processed or not.
✓ Scheduling settings
In this step, the running times of the shortcut repair job must be selected. It is possible either to select a scheduler from the list or to create a new scheduler via creating a new option. For shortcut repairing jobs, it is recommended to set up a One time scheduler for or to start the job manually from the status bar. For more information about how to set schedules please refer to the section Schedules above.
✓ Repairing shortcuts
This section allows you to define what the job should do with the shortcuts. By checking the ‘Repair file type of shortcuts matching filter‘ option, you can set the filtering settings to fix the FileType of shortcuts matching the given filter. The repair will only apply to the HTML shortcuts, which is set from the dropdown menu. You can set which files/items will be repaired with the filtering settings by clicking on the “not set” or “Change filter” buttons. More details about the filtering settings can be found in this section.
✓ Sites to process
In this section, you can decide which site(s) or group(s) will be processed. The options are changing based on the settings.
In On-premise mode, only the select site option is accessible for the users. Click on “+ select site” button, and specify the root connection and the relative URL in the pop-up window. A root can be a site collection, a subsite, a library or a folder already defined in the Site section.
When Microsoft 365 type is selected on the System settings page, you can either process all sites (all provisioned sites will be processed), or selected sites and/or groups in this section.
When the selected sites option is selected from the drop-down list, click on “+ select site” or “+ select group” and specify the root connection and the relative URL (if you do not wish to process the whole site) in the pop-up window. A root can be a site collection, a subsite, or a library. It is also possible to test the connection by using the Test button.
✓ Notification settings
Select here, when you will need to get notification emails from the SharePoint shortcut repair job. Into the Recipient list textbox insert the email address(es) of the person(s), who get the notifications. It is also possible to set that the emails will be sent only when the version count reaches a certain number.
✓ Resource settings
The number of worker threads responsible for the repairing processes can be set here; by default this value is set to 2.
