Conflict resolution (classic)

Nexthink Finder is a Windows-only desktop application whose functionality is now available within the Nexthink web interface. Nexthink can now be used directly from a browser and most functions no longer require an additional desktop application.

When importing content manually, either from the Library or from a content pack, it is possible that the content to be imported conflicts with content that is already present in the target setup. Investigations, alerts, modules, etc. with the same name as those found among the imported items may already exist in the same locations where the items are copied. This section explains how to deal with these conflicts and resolve them.

Options for resolving conflicts

The resolution of conflicts is a step in the import process, regardless of the method used for importing content. A dialog box displays a list of the offending items along with a choice of possible corrective actions to remediate any possible issues.

The options available for resolving conflicts depend on the type of content to be imported. The default option suggested by the system to resolve a conflict follows this conservative rule:

Existing content must not be broken.

Below is a list of all possible actions and an explanation of their meaning. Keep in mind that not all of the options are eligible for any kind of item to be imported and that they may have different effects on different kinds of items:

Skip

The item will not be imported

Replace

The item to be imported takes the place of the conflicting existing item.

Replace all

All the existing items will be replaced with the new ones.

Import a copy and Keep both

These two options keep a copy of both the existing item and the item to be imported. The latter is automatically renamed by adding a numerical index to its name. The system displays one option or the other for selection depending on whether renaming the item to be imported may break dependencies or not.

Merge

The item to be imported is combined with the existing item to produce an item that is a mixture of both.

Conflicts in metrics

While all other items are identified solely by their name, metrics can also be identified by their unique identifier (UID). Although not visible to the user, the system can verify the UIDs of two conflicting metrics that have the same name to determine if they are different versions of the same original metric (same UIDs) or if they are actually two completely different metrics that happen to have the same name (different UIDs).

The options for resolving conflicts between metrics are different when they have the same UID and when they have distinct UIDs.

Choosing the appropriate option

Skip

When the system detects that the item to be imported has the same exact definition as the existing item with which it is in conflict, it automatically skips the import and notifies the user by displaying the action Skip (identical) in the list of conflicting items.

For those cases when the content is not identical, choose Skip if you want to preserve the definition of the existing item.

Replace

Replacing the definition of an existing item by that of an imported item has consequences that depend on the type of item imported:

Metrics

Replacing a metric clears the history of the metric in the Nexthink web interface only if its new definition introduces major changes (for instance, it has different grouping options). You can only replace a metric by another when both have the same UID.

Services

Replacing a service resets its corresponding Service View in Finder and its previously computed baselines. Nevertheless, the history of the service is preserved in the Nexthink web interface.

Categories

Replacing a category triggers an automatic retagging of objects when the auto-tagging rules change. In addition, all manual tags are lost.

Import a copy and Keep both

When keeping a copy of both the existing item and the imported item, the latter is renamed with an index. For instance, if you have an item called Compliance and you import another item with the same name (therefore causing a conflict with the existing item), the system assigns it the name Compliance (2) to indicate that it is a different version of the item.

There are two formulations for this option depending on the type of items to be imported. The system suggests one of the following options:

Import a copy, for categories and services

Since conditions in investigations and metrics may depend on the names of categories and services, renaming the imported categories and services may result in broken conditions.

Keep both, for investigations, folders of investigations, alerts, one-clicks, metrics with different UIDs and modules

The system suggests this formulation for all other types of items that may be renamed safely. The case of modules is special in the sense that keeping both the existing and the imported modules is the only available action for resolving the conflict; therefore, the system automatically takes this action without prompting the user.

Merge

Two types of items may merge with others of their kind:

  • Folders (of investigations, alerts, or one-clicks)

  • Categories

When folders are merged, the resulting folder combines the contents of the existing and the imported folders. If individual items inside the folder conflict, you must resolve those conflicts separately.

When merging two categories, all the keywords that are present in the category to be imported and not in the existing category are added to the resulting category. The result of the merge, understood as a set operation, is thus the union of the keywords in the two categories.

To determine what to do with the keywords that are present both in the category to be imported and in the existing category, but defining different auto-tagging rules, the merge operation comes in two flavors:

Merge - preserving auto-tagging rules

To preserve the auto-tagging rules of the keyword in the existing category against the auto-tagging rules defined by the keyword to be imported

Merge - replacing auto-tagging rules

To substitute the auto-tagging rules of the keyword in the existing category for the auto-tagging rules of the keyword to be imported

For categories, it is recommended to first choose Import a copy before committing on a Merge. Decide later whether you really want to merge the two categories. If so, re-import and choose Merge. After merging, check the order of the keywords in the resulting category.

Conflict resolution table

Below is a table containing all types of objects and the available conflict resolution options for each:

ItemsConflictSkipReplaceImport a copyKeep bothMergeMerge - preserving auto-tagging rulesMerge - replacing auto-tagging rules

Investigations / alerts / one-clicks

Same name (in same folder)

X

Default

Folder of investigations / alerts / one-clicks

Same name (in same folder)

X

X

Default

X

Metrics

Same name (globally) and same UID

Default

X

Same name (globally) and same UID

Default

Services

Same name (globally)

Default

X

X

Categories

Same name (globally)

X

X

X

Default

X

Modules

Same name (in PERSONAL section)

Default

Last updated

#451: 2024.8-Overview of integration DOC

Change request updated