Task item errors

Task items are validated to ensure that they've been authored correctly. When a task item is opened, it's automatically validated, and errors are listed under the Messages tab in the Tasks pane. Errors must either resolved to successfully run the associated task.

When authoring a task item, the task item is automatically validated for both errors and best practices. Best practice suggestions are displayed as warning messages. When the Task Designer pane is open, both task warnings and task errors are displayed under the Messages tab.

Task items can have the following errors and warnings:

Task item errors

  • The step <step name> in task <task name> uses a command ID <command ID> that does not exist.

    The step is trying to run a command that does not exist. Follow these steps to resolve this error:

    1. In the Tasks pane, select the step and click Options > Edit In Designer to open the Task Designer pane.
    2. Under the Actions tab, select or record the correct command for the step.
    3. Close the Task Designer pane and save the project to save your changes.

  • The step <step name> in task <task name> uses a command ID <command ID> or geoprocessing tool <tool name> that requires <license level\extension name>.

    The step is trying to run a command or geoprocessing tool that is not supported by your current license level. Contact your organization administrator to update your license.

  • The task <task name> is referencing maps that are inaccessible. This Task Item might have been designed for a different project.

    Open the task Item in the correct project or follow these steps to resolve this error:

    1. In the Tasks pane under the Messages tab, select the error message and click Show Me .
    2. Under the Resources tab in the Task Designer pane, choose All broken resources from the drop-down list.
    3. Select the broken map resource and choose the correct map resource from the Set selected resource to drop-down list.

      You can also click Remove Resource to remove the broken resource from the task item.

    4. Save the project to save your changes and close the Task Designer pane.

      Tip:

      Under the Resources tab in the Task Designer pane, choose Unsaved changes to view the fixed resources that have not been saved to the project. Saving the project will empty the list of unsaved resource changes.

    5. After resolving existing task errors, click Validate Validate under Messages in the Tasks pane to confirm there are no more errors or to check for any additional errors.

  • The task <task name> is referencing layers that are inaccessible.

    The task is using layers that are not present in the active map view. Add the layers to the active map view that the task is using, or reference the correct layers under the Resources tab:

    1. In the Tasks pane under the Messages tab, select the error message and click Show Me .
    2. Under the Resources tab in the Task Designer pane, choose All broken resources from the drop-down list.
    3. Select the broken layer resource and choose the correct layer resource from the Set selected resource to drop-down list.

      You can also click Remove Resource to remove the broken resource from the task item.

    4. Save the project to save your changes and close the Task Designer pane.

      Tip:

      Under the Resources tab on the Task Designer pane, choose Unsaved changes to view the fixed resources that have not been saved to the project. Saving the project will empty the list of unsaved resource changes.

    5. After resolving existing task errors, click Validate Validate under Messages in the Tasks pane to confirm there are no more errors or to check for any additional errors.

  • The task <task name> is referencing a geoprocessing tool <tool name> that is not accessible.

    The task is using a geoprocessing tool or model that is not accessible. Follow these steps to resolve this error:

    1. In the Tasks pane under the Messages tab, select the error message and click Show Me .
    2. Under the Resources tab in the Task Designer pane, choose All broken resources from the drop-down list.
    3. Select the broken geoprocessing tool resource and choose the correct tool resource from the Set selected resource to drop-down list.

      You can also click Remove Resource to remove the broken resource from the task item.

    4. Save the project to save your changes and close the Task Designer pane.

      Tip:

      Under the Resources tab in the Task Designer pane, choose Unsaved changes to view the fixed resources that have not been saved to the project. Saving the project will empty the list of unsaved resource changes.

    5. After resolving existing task errors, click Validate Validate under Messages in the Tasks pane to confirm there are no more errors or to check for any additional errors.

Task item warnings

To display task item warnings, open the Task Designer pane. Task item warnings are suggestions for best practices when designing a task. Task item warnings will not a prevent a task from being run. Task item warnings report the following information:

  • Missing task item, task and group descriptions
  • Missing task, group, and step names
  • The use of default names such as "New Task" and "New Step"
  • Duplicate names
  • Tasks that contain no steps
  • A task item that contains only hidden tasks

To resolve a task item warning, select the warning message and click Show Me to open the Task Designer pane. Modify the task accordingly.