Skip To Content

Добавление и настройка инструмента Запустить инструмент геообработки Pro

Шаг Запустить инструмент Pro GP запускает настроенный инструмент геообработки, скрипт Python или модель ModelBuilder в ArcGIS Pro.

После выполнения шага в листе задания появляется значок Запуск Starting. Когда инструмент запускается, появляется значок Выполняется Running, указывающий на то, что инструмент работает.

Если какой-либо из параметров шага сконфигурирован с помощью выражений ArcGIS Arcade, они преобразуются в соответствующие значения перед запуском инструмента.

Если опция Видимый в момент выполнения включена, инструмент, настроенный на шаге, открывается на панели Геообработка и позволяет вам определять значения параметров перед запуском инструмента. Если значения параметров по умолчанию были настроены, они появляются при запуске шага и могут быть переопределены. Если значения Подсказка пользователя и Справка по шагам не настроены для шага, шаг завершится автоматически при запуске.

Примечание:

Если значение параметра, полученное из выражения ArcGIS Arcade, несовместимо с инструментом, шаг не выполняется.

When the step is run, the following actions can be performed:

  • Если включена опция Видимый в момент выполнения, можно указать значения параметров и запустить шаг, щелкнув Запустить на панели Геообработка.
  • Шаг можно отменить, щелкнув кнопку Отмена.
    Примечание:

    В некоторых случаях вы не сможете отменить этот шаг после его запуска.

Настройка шага

To configure the step, do the following:

  1. Create or edit a workflow diagram to access the Step Library panel.
  2. Перетащите Запустить инструмент Pro GP из панели Библиотека шагов на стрелку соединения шага на холсте рабочего процесса.

    The Step Details panel appears.

  3. Provide a name for the step in the Step Name text box.
  4. Optionally, add the message you want to appear when the step is run in the User Prompt text box.

    You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:

    'This job is currently assigned to ' + jobOwner($job) + '.'
  5. Выберите тип инструмента, который вы хотите запустить, в разделе Аргументы:
    • Системный набор инструментов - Инструменты геообработки, включенные в ArcGIS Pro, и наборы инструментов, импортированные в проект ArcGIS Pro
    • Другой набор инструментов - Пользовательские инструменты геообработки и скрипты
  6. Вы можете сделать следующее:

    Инструменты в системных наборах инструментов

    Введите псевдоним набора инструментов для набора инструментов, который содержит инструмент, который вы хотите запустить, в текстовое окно Псевдоним набора инструментов.

    Псевдоним набора инструментов можно найти на вкладке Python на странице справки инструмента в документации ArcGIS Pro.

    Инструменты, импортированные в проект ArcGIS Pro

    Введите псевдоним набора инструментов для набора инструментов, который содержит инструмент, который вы хотите запустить, в текстовое окно Псевдоним набора инструментов.

    Щелкните правой кнопкой мыши набор инструментов на панели Каталог и щелкните Свойства, чтобы просмотреть псевдоним набора инструментов.

    Пользовательские инструменты геообработки и скрипты

    Введите полный путь к набору инструментов в текстовом окне Путь набора инструментов. Путь к набору инструментов также может ссылаться на наборы инструментов, хранящиеся в файловой базе геоданных или многопользовательская база геоданных. Путь должен быть доступен в ArcGIS Pro.

  7. Введите имя инструмента, который вы хотите запустить, в текстовое окно Имя инструмента.

    Имя инструмента можно найти на вкладке Python на странице справки инструмента в документации ArcGIS Pro.

  8. При желании отметьте Видимый в момент выполнения, чтобы разрешить установку значений параметров при выполнении шага в ArcGIS Pro.
  9. Щелкните Добавить новый параметр.
  10. Введите имя параметра в текстовое окно Имя параметра.

    Имя параметра можно найти на вкладке Python на странице справки инструмента геообработки в документации ArcGIS Pro.

  11. При желании щелкните кнопку Показать значение по умолчанию Show Default Value, чтобы определить значение параметра по умолчанию при выполнении шага.
    1. Выберите одну из следующих опций:
      • Значение - Предоставьте статическое значение.
      • Выражение Arcade - Предоставьте динамическое значение с помощью выражения Arcade.
    2. Укажите значение по умолчанию для свойства в текстовом окне Значение или Выражение Arcade.
  12. Повторите шаги с 9 по 11, чтобы добавить больше параметров.
  13. При желании введите имя производного выходного параметра, которое вы хотите использовать в качестве выходного значения, когда инструмент завершит работу.

    Производные выходные параметры инструмента можно найти на вкладке Python на странице справки инструмента в документации ArcGIS Pro.

  14. При желании отметьте Прикрепить журнал геообработки, чтобы сохранить историю инструмента как вложение задания.
  15. При желании укажите имя папки, в которой будут храниться журналы, в текстовом окне Папка.

    Имя папки не может содержать специальные символы.

    Примечание:

    Если имя папки не указано, автоматически создается папка с именем Общие.

  16. Click the Options tab.
  17. Configure Step Options as necessary.
    • Manual—Run the step manually.
      • Optional—Allow the step to be finished without being run.
    • Automatic—Run the step as soon as it becomes active.
      Примечание:

      If your workflow diagram is configured to automatically run a sequence of steps that includes the Evaluate Data Quality or the Run GP Service step, steps that attempt to run after the user token that started the sequence of steps expires will not run automatically. You must have a license for the ArcGIS Workflow Manager Server Advanced role to continue running the additional automated steps without manual intervention.

    • Run on a Schedule—Run the step according to a schedule you set.

      Learn more about scheduling options

  18. Optionally, provide help text for the step in the Step Help text box.

    You can also use the following example to display a dynamic value using ArcGIS Arcade expressions:

    'For further assistance, please contact ' + jobCreator($job) + '.'
  19. Optionally, click the Style tab to change the shape and color of the step.
  20. Optionally, click the About tab and provide a description for the step in the Step Description text box.
    Примечание:

    The About tab also contains the step's ID that can be used with dynamic job properties to obtain a step's output.

Return value

When the step is completed, its return value is stored to indicate the result of the step. The return value can be immediately evaluated using paths to determine the next steps in the workflow. You can also retrieve the return value for completed steps throughout the workflow using ArcGIS Arcade expressions. The following table lists the step's return values:

Return valuesDescription

S000001

The step completed successfully.

F000001

The step failed to complete successfully.

Выходное значение

When the step is completed, its output value is stored and can be used to determine the path the workflow follows or be used as inputs for other steps throughout the workflow. The following table shows the step's output value:

Выходные данныеОписаниеСинтаксис выражения ArcGIS Arcade

<DerivedOutputParameterValue>

Возвращает сконфигурированное производное выходное значение, полученное от инструмента.

jobOutputValue($job, '<step_id>','<derived_output_parameter_name>')

Примечание:

derived_output_parameter_name - необязательный параметр. Если имя производного выходного параметра не указано, возвращается первое производное выходное значение.

Связанные разделы