We're in the process of exporting a confluence space from one instance to another.
In this context, we've discovered that mentions break upon import into another instance, as they reference the user by some unique user identifier from the database. For some mentions, however, the link breaks but the name of the referenced user is displayed (i.e. it fails gracefully). In this case, the storage format in the SOURCE wiki looks like this:
<ri:user ri:userkey="<32hexdigits>" />
For other mentions, the link breaks and a "broken image" icon is shown instead, with no easy way of discerning the user that was mentioned originally. In this way, the storage format in the SOURCE wiki looks like this:
<ac:link><ri:user ri:userkey="<32hexdigits>" /></ac:link>
I realize this is a long shot, but does anyone know what makes a mention use the former (more gracefully failing) format, rather than the latter?
Also, if anyone has experience with fixing up mentions after an export/import to another system, I'd be interested in your solution.
The "32hexdigits" is the user key of the user in Confluence. The user key is mapped to a username and a user with this username is looked up in the user directories registered in Confluence. If a user is not found the macro breaks.
When doing imports from another instance you need to make sure that all the users from the source instance are available inside the target instance - and the usernames should match. The importer looks the users by name and fixes the references inside pages (fixes the userkey), but if the user is not found then the importer leaves the old user key (the one from the source instance).
To fix this you have a few options:
Do you use templates with Confluence? Take part in a remote 1-hr workshop. You'll receive USD $100 for your time! We're looking for people to participate in a remote 1-hr workshop...
Connect with like-minded Atlassian users at free events near you!Find a group
Connect with like-minded Atlassian users at free events near you!
Unfortunately there are no AUG chapters near you at the moment.Start an AUG
You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs