A simple guide to restoring adaptive items and saving the tool back to KBM

When a KBM tool contains references to GDML files that are unavailable, the tool may normally stop loading or report missing references. By adjusting the KBM loading options, you can allow the tool to open first and repair the missing links afterward.

1. Allow the Tool to Load with Missing References

Begin by opening the KBM tool and locating the KBM options or loading settings. Enable the option that allows the tool to load with missing references. Depending on your version, this setting may be labeled Load with Missing References, Ignore Missing References, or something similar.

After enabling the option, load the tool again. The tool should open even though some referenced GDML files are unavailable. Items that depend on those files may appear as missing, unresolved, or replaced with a default holder. This is expected and allows you to access the tool so that the references can be repaired.

2. Reconnect the Adaptive Items to Their Original GDML Files

Once the tool is open, identify the adaptive items that have lost their references. Select each item and open its reference, source, or file-location settings. Use the browse or reconnect command to locate the item’s original GDML file, then confirm the selection.

Repeat this process for each adaptive item. Make sure that every item is connected to its original GDML file, however it can associated to a temporary copy or a replacement file. After reconnecting the items, review the tool to confirm that the missing-reference warnings have been cleared and that the adaptive items are working as expected.

3. Save the Repaired Tool Back to KBM

After all references have been restored, save the tool using the KBM save or export command. Choose the KBM folder and save the repaired tool to the required location. Close and reopen the newly saved KBM tool as a final check. Confirm that it loads without unnecessary missing-reference messages and that each adaptive item remains connected to its original GDML file. This verification helps ensure that the repaired tool has been saved correctly and is ready for continued use.

Summary

The process is straightforward: allow the KBM tool to load despite missing references, reconnect each adaptive item to its original GDML file, and save the repaired tool back to KBM. Keeping the original GDML files in their expected locations will help prevent the references from breaking again.