Skip to main content
Version: 7.3

Configuration of shortcut repair job in Teams archive

Introduction​

The Teams shortcut repair job is a specialized maintenance job designed to locate and process shortcut files based on selected parameters in the selected team(s) of a Teams archive. 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) are selected.

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.

This page describes how to create and configure the Teams shortcut repair job, including its report mode, scheduling, logging, repair and conversion, address book, notification, and resource settings.

info

Note: The repair function applies only to HTML shortcuts. Processing is filtered by the selected filter and shortcut type; both are mandatory for the job to run. The job operates strictly within the selected shortcut repository ID, so shortcuts outside that scope are ignored.

info

Note: 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.

Create the job​

The Teams shortcut repair job can be created and configured on the Jobs page.

  1. Click the + new button.
  2. Fill in the required settings (Job type, Run on node, Display name) in the pop-up window.
  3. Click 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.

Configure the job​

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. You can either select a scheduler from the list or create a new one via the creating a new option. For shortcut repair 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, refer to the Schedules page.

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.

  • What to scan: Defines the scope of the scan. By default, all shortcuts are included, but you can also filter out shortcuts by clicking 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 on the Filtering in jobs page.
  • Repair shortcuts: Decides what happens with the shortcuts.
    • By checking Repair the file type of shortcuts, 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 Repair the last modification date and Editor, 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 Convert shortcuts to different type, 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. You can select all teams or selected teams from the dropdown menu.

If you choose the selected teams option, click + select team, check the desired teams in the Team selection window, and click OK to confirm your selection.

Notification settings​

Select here when you need to receive notification emails from the Teams shortcut repair job — for example, always, never, or only when an error or warning occurs. In the Recipient list textbox, insert the email address(es) of the person(s) who will receive the notifications.

Resource settings​

Set the value that determines 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.