If a broken model icon appears as the tool icon in the Catalog window or ArcToolbox window, the model cannot find or use a tool within the model. The following are common causes of this problem:
- The tool was renamed or deleted.
- The toolbox containing the tool was moved, renamed, or deleted.
- Parameter names for a tool have changed.
- The number of parameters for a tool has changed.
- Data type for a parameter has changed.
- There are licensing issues associated with the tool.
Tools within the model that typically cause this problem are custom script and model tools rather than system tools installed with ArcGIS. Custom script or model tools can be renamed, moved to a different toolbox, or have their parameters modified, causing the models that use the tool to break.
Repairing a model
Models can only be repaired within ModelBuilder. From the Catalog window or ArcToolbox window, right-click the model tool and click Edit.
Reason | Repairing |
---|---|
Tools that no longer exist | In ModelBuilder, identify any tools with a broken tool icon or broken model tool icon . Broken tools can be repaired by right-clicking the tool and clicking Open. This will open a Browse dialog box, instead of the the tool's dialog box, where you can browse to the location of the correct tool and select it. |
Changed parameter names | If parameter names in a model or a script tool have changed, broken icons will not be shown on the affected tool. To repair the model, save the model; all variables and parameter names were automatically updated when you opened the model in ModelBuilder and just need to be retained. |
Changed number of parameters | If the number of parameters for a tool has changed, a broken tool icon will not be shown on the affected tool. The affected tool can typically be found by opening the dialog box for each tool not in the ready-to-run state. |
Changed parameter data types | If parameter data types have changed (for example, from a string data type to an integer data type), broken icons will not be shown on the affected tool. Only tools not in the ready-to-run state are candidates for repair, since they contain the incorrect data type for a parameter. One clue for altered parameter types is to look for disconnected variables and determine which tool was likely connected to the variable. Open that tool's dialog box and enter a new value for the parameter. If there are no disconnected variables, examine every parameter in every tool not in the ready-to-run state. |
Licensing issues | If a model uses an unlicensed tool, there will be no broken icon or locked icon by the model tool. If the model is run from the tool dialog box, a message will be given that a tool is unlicensed. Edit the model and remove any unlicensed tool with a locked icon . |