ReplaceMagicHelp

A single source scan supports both approaches, because SmartMapper stores two addresses with every key: the document's current location and its calculated future location.

Option A – repair first, then migrate

Run the replacement while the documents are still in place. The links are corrected to point at the future locations, and the corrected documents are then moved. Simple and predictable; nothing extra is required.

Option B – migrate first, then repair

Move the content, then run the replacement at the new location. ReplaceMagic recognises each document by its new address and applies exactly that document's keys.

Conditions for Option B:

• Every document's own location must be covered by a mapping rule. SmartMapper checks this and reports it explicitly:

[target] 21 document(s) have NO MappingRule for their own location -> ... Add rules for:

    \\fileserver\Finance\Reports\budget.xlsx

    ...

Add the missing rules and regenerate. If the message says all document locations are rule-covered, Option B is safe.

• The migration must place files where the rules say. Differences in upper/lower case or in encoded characters are handled automatically; genuine renames are not.

Both options can be prepared from the same run – you do not have to decide in advance.