Configuration of shortcut repair job in Teams archive

The Teams shortcut repair job is a specialized maintenance tool designed to locate and process shortcut files based on selected parameters in the selected team(s). Its primary purpose is to repair shortcut metadata: it can repair the FileType, and it can also repair the Last modification date and Editor depending on which repair checkbox(es) is selected. Processing is filtered by the selected filter and shortcut type. To run the job, selecting both the filter and the shortcut type is mandatory. The repair function applies only to HTML shortcuts.
In addition to repair, the job configuration page also provides shortcut conversion in the Repair and convert shortcuts section, including conversion between HTML and Modern shortcut types. The job operates strictly within the selected shortcut repository ID, so shortcuts outside that scope are ignored. If a shortcut matching the criteria is found, it is always reported as "repaired", even if no actual modification was made. In this context, the "repaired" status indicates that the shortcut was identified and processed, not necessarily that any change was applied.

The Teams shortcut repair job can be created and configured on the Jobs page. Click the “+ new” button, fill in 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 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 are 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 after the job has finished running. This file will contain a list of items belonging to the selected team(s) along with information about each item, including whether it will be processed.

✓ Scheduling settings
In this step, the running times of the Teams shortcut repair job must be selected. It is possible either to select a scheduler from the list or to create a new scheduler via the creating a new option. For shortcut repairing jobs, it is recommended to set up a One time scheduler or to start the job manually from the status bar. For more information about how to set schedules, please refer to the section Schedules.

✓ Logging options
This section controls the logging behavior of the Teams shortcut repair job.
By enabling the Log successful repair messages option, the job will record log entries not only for errors and warnings but also for successfully processed repair actions. This can be useful for auditing and troubleshooting purposes, as it provides detailed visibility into completed operations.

✓ Repair and convert shortcuts
This section allows you to define what the job should do with the shortcuts, including repairing shortcut properties and converting shortcuts between different types.
Here, you can configure the following options:

• What to scan - defines the scope of the scan. By default, all shortcuts are included, but you can also filter out shortcuts by clicking on the "not set" or "Change filter" buttons. The filtering settings allow you to define which files or items will be repaired. More details about the filtering options can be found in the related section.
• Repair shortcuts - decides what happens with the shortcuts. By checking the "Repair the file type of shortcuts" option, you can configure the job to ensure that shortcuts have the correct FileType. The repair process applies only to HTML shortcuts, which can be selected from the dropdown menu. By enabling the "Repair the last modification date and Editor" option, the job will update the shortcut metadata so that the Last modified date and Editor fields are corrected according to the current repair operation.
• Convert shortcuts - in addition to repairing shortcuts, this section also supports shortcut conversion. By selecting the "Convert shortcuts to different type" option, the job can convert shortcuts from one type to another. The "Convert from" and "Convert to" dropdown lists allow you to specify the source shortcut type and the target shortcut type.

✓ Address book objects to process
In this section, you can decide which team(s) will be processed during the shortcut repair job. It is possible to select all teams or selected teams from the drowndown menu in this section.

In case you choose the "selected teams" option, click on the + select team button and check the desired Teams in the Team selection window, then click on the OK button to confirm your selection.

✓ Notification settings
Select here, when you will need to get notification emails from the Teams shortcut repair job. You can set here when you need such notifications, like always, never, or when an error or warning occurs. Into the Recipient list textbox, insert the email address(es) of the person(s) who will receive the notifications.

✓ Resource settings
Set the value, which will determine how many items will be processed simultaneously by the Teams shortcut repair job. The recommended value is "2".

Save your changes and start the job manually or wait until the scheduler starts the job automatically.