Audit Conflict Policy
On this page
Conflict resolution rules decide whether an audited computer that an inventory connector imports is a computer already in Alloy Navigator, and what happens then. One set of rules serves both connectors, Alloy Discovery Synchronization and AlloyScan, but the two connectors use it differently.
For working with imported inventory data and its conflicts, see Inventory Data and Audit Conflicts.
Parts of a rule
| Part | Description |
|---|---|
| Name | The rule's caption. |
| Description | Free text describing the rule. |
| Conditions | One condition per field, each a field and an operator. |
| Action | What the rule delivers when it matches: overwrite an existing computer, or put the device in the Conflict List. |
| Rank | The rule's place in the order in which the rules are tried. |
Condition fields and operators
A rule can test only four fields of a computer: the audit ID, the MAC address, the computer name, and the serial number. A connector does not start its run while any stored rule names another field.
| Operator | Meaning |
|---|---|
| equals | The incoming value equals the stored value. |
| does not equal | The incoming value differs from the stored value. |
| matches | Like equals, but an empty value on either side is ignored. |
| does not match | Like does not equal, but an empty value on either side is ignored. |
A rule's conditions are joined by AND: a rule matches only a computer that meets every one of them.
Retired computers are excluded from every rule's search.
Rule actions
| Action | Verdict | What the Alloy Discovery connector does when the rule matches |
|---|---|---|
| Overwrite an existing computer | Overwrite | Exactly one matching computer is updated, and no further rules are tried. More than one match is an error for the device. |
| Put in the Conflict List for manual resolving | Manual | Any match raises a conflict for an administrator, and the device is quarantined. |
| (the Default row only) | Add | No match confirms that the device is new, and no further rules are tried. |
The Add verdict exists only as the Default row; a rule you create either overwrites or goes to the Conflict List.
Order of evaluation
For each audited computer or Chromebook, the Alloy Discovery connector works through these steps:
| Order | Step | What happens |
|---|---|---|
| First | Equal ID | The connector looks for a computer already linked to the device's Alloy Discovery record. A retired computer found this way is logged and skipped. Any other one is updated, unless its stored audit date is not older than the incoming one. The log reads Used Conflict Policy "Equal ID". |
| Then | Stored rules, by rank | Tried in rank order until one fires. These rules, and the check for a scheduled conflict for the device, run only when no computer carries that link. |
In the Settings App, the rule list shows Equal ID and Default as rows, but they are not stored rules. Equal ID carries the overwrite verdict and always sorts first; Default carries the add-new verdict and always sorts last. Both are read-only: they cannot be opened, deleted, or reordered.
A rule created in the Settings App is ranked after every rule that existed when it was saved, and before only Default, until someone moves it.
When the Alloy Discovery job is set to Delete its original record from Alloy Discovery, each run finds every retired computer and hardware item that is still linked to an Alloy Discovery record, deletes that record in Alloy Discovery, and removes the link. A later audit of the same machine is then no longer found by Equal ID; the other matching steps decide whether it counts as new. See Alloy Discovery Synchronization.
How AlloyScan uses the rules
- A computer is matched by its integration key first, logged as "Matched computer by integration key". For a device migrated from Alloy Discovery, a computer whose audit ID equals the audit's legacy audit ID also matches. Only when neither matches are the rules tried.
- AlloyScan uses only the Overwrite rules that have no audit ID condition. Manual and Add rules are not used.
- AlloyScan takes the first computer any rule returns. It has no "more than one match" error, raises no conflicts, and quarantines no device.
- Hardware is not matched by rules: the integration key, then the serial number, then the name, each compared ignoring case; the first hit wins.
- A matched device whose stored audit date is at or past the incoming audit date is dropped from the run without a request for its audit data. For computers, this check applies only to a match by integration key, not to a rule match.
- A matched device that is retired is logged and left untouched, computers and hardware alike.
Conflicts
A conflict raised by a Manual rule records the incoming and the stored values of the computer name, the MAC address, and the serial number side by side.
| Status | Meaning |
|---|---|
| New | The conflict waits for an administrator. |
| Scheduled | An administrator has chosen a resolution. The next Alloy Discovery run applies it. |
| Resolved | A run has applied the resolution and recorded the resolution date. |
| Error | The Settings App shows it as "Failed to resolve". |
An administrator opens a New conflict and chooses to create a new computer or to overwrite the existing one. That choice sets the conflict to Scheduled and allows no further editing. The next Alloy Discovery run applies it and sets Resolved. The choice is never applied at the moment it is made.
- A New or Scheduled conflict belongs to a device that the run quarantined without linking it. After such a conflict is deleted, the next run processes the device again, the Manual rule matches again, and a new New conflict is raised. Deleting a Scheduled conflict loses the administrator's choice.
- A conflict left New does not stay as it was: each run that matches the device again replaces it with that run's date and freshly read field values, and counts it among the conflicts that run created.
When a run raises any conflict, it writes one entry to the system log saying that an audit conflict was detected. In the Settings App, the Alloy Discovery log shows the number of conflicts each run raised in its Created Conflicts column.
Audit conflict policy in the Settings App
The rules and the conflicts are under Services > Alloy Discovery Integration > Conflict Resolution. This manager shows the rule list above the list of outstanding conflicts. The rule list offers new, open, delete, move up, and move down; the conflict list offers resolve, view log, delete, and refresh. A Resolved conflict stays in the conflict list until it is deleted.
Create or edit a rule
- Open Services > Alloy Discovery Integration > Conflict Resolution.
- In the rule list, create a rule or open an existing rule.
- Enter its Name and, if needed, Description.
- Enable each condition to test, and choose its operator. At least one condition must be enabled.
- Under Perform action, choose whether to overwrite a matching computer or put it in the Conflict List.
- Click OK, then check that the rule appears in the list with the intended settings.
Rules run in list order. Use Move Up or Move Down to change a rule's position; Equal ID stays first and Default stays last.
Conflict Resolution Rule window
| Element | Description |
|---|---|
| Name: | The rule name. Required. |
| Description: | The rule description. |
| When all enabled conditions are met: | A grid with the columns Enabled, Field Name, and Condition: one fixed row for each of the four fields, in the order audit ID, MAC address, computer name, serial number, each shown by its Computer field label. Condition offers equals, does not equal, matches, and does not match. |
| Perform action: | Overwrite an existing computer or Put in the Conflict List for manual resolving. A new rule starts on Overwrite an existing computer. |
Selecting Enabled on a row sets its Condition to equals; clearing it empties the Condition. A row that is not enabled is not stored: when you reopen the rule, the row shows unselected with no operator.
OK refuses to save with one of these messages:
- "A rule name cannot be empty."
- "Action is not defined."
An operator for the field "<field>" is not defined., for an enabled row with no operator.- "At least one condition must be used."
Closing the window with unsaved changes asks whether to save them.
If saving the rule fails, the change is not stored, no message is shown, and the window still closes as if the rule had been saved.
Conflict Details window
The Conflict Details window opens from the conflict list's resolve action or from a double-click on a conflict. The resolve action is enabled whenever a conflict is focused, whatever its status; the window decides what can be done.
| Element | Description |
|---|---|
| Status | New, Scheduled, Resolved, or Error. |
| Conflict Date: | When the conflict was recorded. |
| Conflict Details: | A grid of Field Name, Database, and Audit for the computer name, MAC address, and serial number. |
| View Log | Opens the session log recorded on the conflict. |
For a New conflict, Resolution: offers Create new Computer in database using Audit information, preselected, and Overwrite data in database using Audit information, with Resolve and Cancel. Resolve sets the conflict to Scheduled.
A Scheduled, Resolved, or Error conflict opens read-only: it shows neither choice nor Resolve, and Cancel reads Close. The window shows "Scheduled to be resolved on <date>", "Resolved on <date>", or "Failed to resolve", and "Resolution Method: " followed by "Add New" or "Overwrite".
Delete conflicts
Delete on the conflict list is enabled whenever a conflict is focused, whatever its status, and acts on every selected conflict. It asks "Are you sure you want to delete this conflict?" or, for more than one, "Are you sure you want to delete all selected conflicts?".
Audit conflict policy in the Admin Center
The Alloy Discovery Integration page, in Services and Integrations, has four tabs: Conflict Policy, Conflict List, Synchronization, and Logs. Conflict Policy holds the ranked rules, and Conflict List holds the resolved and unresolved conflicts.
Conflict Policy tab
A rule's form holds a name and a description, one condition row for each of the four fields (audit ID, MAC address, computer name, and serial number) with a check box that enables it and an operator (equals, does not equal, matches, or does not match), and one action for the whole rule: Overwrite an existing computer or Put in the Conflict List for manual resolving.
- For a selected system rule, Edit, Delete, Move Up, and Move Down are disabled. Move Up and Move Down are also disabled when the neighboring rule in that direction is a system rule.
- You can drag a rule to a new place in the order; system rules cannot be dragged.
- The description panel shows the selected rule's description. For a rule that is not a system rule, it also shows a sentence for each condition that has an operator, followed by the rule's action.
Conflict List tab
- Delete is disabled when nothing is selected or when any selected conflict is not Resolved. A single unresolved conflict in a selection disables Delete for the whole selection.
- Details/Resolve is available when exactly one conflict is selected, whatever its status.
- For a New conflict, the form offers the choice to create a new computer or to overwrite the existing one. Resolving the conflict sets it to Scheduled, as in the Settings App.
- A Scheduled conflict shows "Scheduled to be resolved on" and a Resolved conflict shows its resolution date. Both show the chosen resolution method and offer no choice; submitting the form closes it without resolving anything.
Related topics
- Inventory Data and Audit Conflicts - work with imported inventory data and resolve audit conflicts.
- Alloy Discovery Synchronization