Pre-Existing Bug
Throwing away a fields or abacus that is no longer used results in Update Collection reporting that the collection is damaged. (Diagnostic Code: 30/xxxx/xxxxxxxx, Error Code: 302)
This is a known bug from older versions of Helix. What has happened is this: at one time the "bad" icon was referenced by another icon (probably an abacus) but that reference was no longer needed, so the collection designer removed it. When this was done Helix failed to update an internal usage table, called a backlink table. Because the table was not updated properly, the referencing icon continues to believe that the unlinked icon is still needed. When you subsequently throw away the unused icon, the referencing icon's backlink table is not updated. When Update Collection sees this situation, it marks this as a problem that is "not corrected" and flags it with error code 302.
It is important to understand that throwing away the unused icon does not damage the collection. The damage already exists; throwing the icon away merely reveals it.
There are a number of options:
- Reuse the icon. There is no harm in this at all as the affected backlink table will either continue believing that the needed icons are intact or the object that uses the backlink table will be modified and the backlink table will be recreated, removing the incorrect reference.
- If you can recall which icons may have referred to this icon in the past, recreate those icons and throw the originals away. This will also discard the associated backlink table and allow you to delete the unused icon.
- If you can recall which icons may have referred to this icon in the past, copy those icons to the clipboard and paste them back into the collection, replacing the originals with exact duplicates. This will force the backlink tables to be reconstructed. If you can not remember which icons referred to the deleted icon, you can also try copy/paste of entire relations.
- Go to a recent backup, copy the icons you deleted, and paste them into the damaged collection. The backlink tables should now find the needed icons.
- Throw away the icons and arrange for a collection repair. Please see the pages on collection repair for procedures and charges involved. (Because this is caused by a bug inherited from the former company and because backlink repairs can be time consuming, we can not do these repairs at no charge. However, USU credits can be used for this repair.)
This bug has been reproduced in our test lab. The bug does not appear in current versions of Helix, but we are working on a way to "scour" existing databases looking for (and repairing) this type of damage. Until that solution is found, use one of the workarounds described above to repair collections that have this problem.
Update: December, 2005. A solution has been identified and will be implemented in a future release of Helix.
This bug existed in versions of Helix Express prior to our company's acquisition of Helix. Damage caused by this bug will continue to surface in current versions of Helix when previously created icons are discarded.
This bug affects Helix RADE