Настраиваемые шаги Workflow Manager

Доступно с лицензией Standard или Advanced.

Доступно с лицензией Workflow Manager.

ArcGIS Workflow Manager for Desktop предоставляет несколько настраиваемых шагов. Исходный код для каждого из них предоставляется как часть комплекта разработчика. В таблице ниже описаны шаги процессов и их функции.

Библиотека шагов

Библиотека шагов содержит шаги, которые могут быть выполнены как в настольных, так и в серверных рабочих средах. Шаги, их аргументы и коды возврата описаны ниже.

1. AddJobHold

   JTXSteps.AddJobHold

   Добавляет удержание к текущему заданию.

   Hold Type Name:
   	/holdType:<hold type> (required) 
   Hold Comment:
   	/holdComment:<string> (optional)
   

   Коды возврата:
   • 1 = Успешное завершение
   • 0 = Неудачное завершение
2. CheckAOI

   JTXSteps.CheckAOI

   Проверяет, существует ли представляющее интерес местоположение для текущего задания.

   No Argument
   

   Коды возврата:
   • 1 = Если задание имеет LOI
   • 2 = Если задание не имеет LOI
3. CleanUp

   JTXSteps.CleanUp

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

   Примечание:

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

   Version Cleanup:
   	/version|v (optional)
   MXD Cleanup:
   	/mxd|m (optional)
   Attachment Cleanup:
   	/attachments|a (optional)
   

   Коды возврата:
   • 0 = Успешное завершение
4. CloseJob

   JTXSteps.CloseJob

   Закрытие задания как шага, в противоположность процессу, выполняемому вручную при завершении рабочего процесса.

   No Argument
   

   Коды возврата:
   • 0 = Успешное завершение
5. CreateJob

   JTXSteps.CreateJob

   Создание дочернего задания на основе аргументов.

   Job Type ID:
   	Job Type Name:
   	/jobtypename:<job type name> (required)
   Assign to Group:
   	/assigngroup:<group to assign to> (optional)
   Assign to User:
   	/assignuser:<user to assign to> (optional)
   Job Type ID:
   	/jobtypeid:<job type ID> (deprecated)
   

   Коды возврата:
   • 0 = Успешное завершение
6. CreatePDF

   JTXSteps.CreateJob

   Создание PDF-документа базовой карты задания и добавление его к заданию в виде вложения.

   Initial Directory:
   	/initdir:<initial directory> (optional)
   Do not Attach File To Job:
   	/noattach (optional)
   Resolution (dpi):
   	/resolution:<dpi> (optional)
   Attach File To Job:
   	/attach (deprecated)
   

   Коды возврата:
   • 0 = Успешное завершение
7. CreateVersion

   JTXSteps.CreateVersion

   Создание версии для задания. Уровень защиты версии определяется одним из следующих аргументов: Version, Access или Scope.Этап поддерживает традиционную рабочую область с данными и рабочую область данных сервиса объектов.

   /scope:<public|private|protected> (optional)[default:private]
   

   Коды возврата:
   • 0 = Успешное завершение
8. ExecuteGPTool

   JTXSteps.ExecuteGPTool

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

   Toolbox Path (explicit full path to the tbx file combined with toolbox name):
   		/toolboxpath:<toolboxpath> (required)
   Display Name of the Tool in the toolbox:
   	/tool:<tool> (required)
   Parameter to override on the tool (can be specified multiple times):
   /param:<ParamName>:<ParamValue> (optional)
   Flag to attach the log to the job once the tool has completed:
   /attach:(optional)
   Output parameter to use as return value:
   /outParam:<parameter name>
   

   Коды возврата:
   • 0 = Успешное завершение
   • 1 = Неудачное завершение

   Примечание:

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

9. ExecuteSQL

   JTXSteps.ExecuteSQL

   Выполняет выражение SQL.

   Database to Send SQL:
   	/database:<jtxsystem|data> (required)SQL Command:
   	/sql:<sql command>
   

   Коды возврата:
   • 0 = Успешное завершение
10. ExecuteURL

    JTXSteps.ExecuteURL

    Выполнение URL без показа браузера для отражения результата.Например, вы можете запустить сервис геообработки или любой другой веб-сервис, как шаг рабочего процесса.

    URL to execute:
    	/url:<url> (required)
    Request Timeout:
    	/timeout:<timeout in seconds> (optional)
    Proxy Server: 
     /proxy:<proxy> (optional)
    Flag to add a comment to the job with the response:
     /addjobcomment(optional)
    Post Data:
     /postdata:<data to post> (optional)
    

    Коды возврата:
    • 200 = Успешное завершение
11. ExecuteWorkflow

    JTXSteps.ExecuteWorkflow

    Выполнение другого рабочего процесса, связанного с типом задания.

    Job Type Name:
    	/jobtype:<job type name> (required)Flag to not use AOI:
    	/donotuseaoi (optional)Flag to not use version:
    	/donotuseversion (optional)Flag to not copy activities to the parent job's history:
     /donotcopyactivities (optional)
    

    Коды возврата:
    • 0 = Успешное завершение
12. ReturnValue

    JTXSteps.ReturnValue

    Извлечение значения расширенного свойства или переданного токена, которое является кодом возврата для следующего пути в рабочем процессе.

    Return value:
    	/value:<Extended properties field> (required):
    

13. ReassignJob

    JTXSteps.ReassignJob

    Переназначение задания.

    Assign Type:
    	/assignType:<user|group> (required)
    Assign To:
    	/assignTo:<user or group name> (required)
    

    Коды возврата:
    • 0 = Успешное завершение
14. SendNotification

    JTXSteps.SendNotification

    Отправляет уведомления типа, определяемого аргументам.

    /notifType:<type> (required)
    

    Коды возврата:
    • 0 = Успешное завершение
15. SetVersion

    JTXSteps.SetVersion

    Устанавливает версию задания по поименованной версии. Например, установите версию задания на QC version, чтобы проверить изменения, которые были внесены в эту версию. Если аргумент шага не задан, версия задания будет возвращена к изначальной.Этап поддерживает традиционную рабочую область с данными и рабочую область данных сервиса объектов.

    Version to use as job version: 
    /version:<versionName> (optional)
    

    Коды возврата:
    • 0 = Успешное завершение
16. UpdateExtentFeatureClass

    JTXSteps.UpdateExtentFeatureClass

    Обновляет класс пространственных объектов информацией о задании для обеспечения статуса видимости.

    Feature Class to Update (must be in data geodatabase):
    	/fclass:<fully qualified feature class name> (required)
    Job ID Field (field to put job ID in):
    	/jobfield:<field name> (optional)
    Date Field (field to put date/time):
    	/datefield:<field name> (optional)
    

    Коды возврата:
    • 0 = Успешное завершение
17. VersionExists

    JTXSteps.VersionExists

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

    No Argument
    

    Коды возврата:
    • 1 = Версия существует
    • 2 = Версия не существует
    • 3 = Рабочая область данных не выбрана

Библиотека DesktopSteps

Библиотека DesktopSteps содержит шаги, которые могут быть выполнены только из настольного приложения, в связи с наличием всплывающих пользовательских интерфейсов. Шаги, их аргументы и коды возврата описаны ниже.

1. AddAttachments

   JTXDesktopSteps.AddAttachments

   Добавляет в задание встроенное, связанное и URL вложения.

   No Argument
   

   Коды возврата:
   • 1 = Успешное завершение
   • 0 = Неудачное завершение
2. CopyFile

   JTXDesktopSteps.CopyFile

   Копирование файла из одного местоположения в другое.

   Source File:
   	/src:<source file path> (optional)
   Destination File:
   	/dest:<destination file path> (optional)
   File Title:
   	/title:<file title> (optional)
   

   Коды возврата:
   • 0 = Успешное завершение
3. CreateJobAdvanced

   JTXDesktopSteps.CreateJobAdvanced

   Создаёт задание и предоставляет вам возможность определить отношение родительское/дочернее для зависимостей в задании. При создании дочернего задания дата начала, дата окончания и рабочая область данных приоритетно копируются из родительского задания, а присвоение задания копируется из свойств типа задания, если значение не указано в аргументах шага.Этот шаг поддерживает создание версий для работы с традиционной рабочей областью данных и рабочей областью данных сервиса объектов. Когда дочернее задание задано с помощью рабочей области данных сервиса объектов, родительской версией может быть только sde.Default.

   Job Type Name:
   	/jobtypename:<job type name>(required)
   Assign To Group:
   	/assigngroup:<group to assign to>(optional)
   Assign To User:
   	/assignuser:<username to assign to> (optional)
   Dependency will be created and current job held at this step:
   	/dependThisStep (optional)
   Dependency will be created and current job held at the next step in the workflow:
   	/dependNextStep (optional)
   Dependency status (current job held until new job reaches this status):
   	/dependStatus:<Status Type Name> (optional)
   Use the current job's AOI as the new job's AOI:
   	/useparentaoi (optional)
   Create new jobs based on the overlap between the current job's AOI and this feature class:
   	/aoiOverlapFeatureClassName:<fully qualified feature class name >(optional)
   Default number of jobs to create:
   	/numberJobs:<number of jobs to create> (optional)
   A version will be created for the new job(s) based on this selection:
   	/createVersionSetting:<the version to use as the parent version> (optional)
   A version will be assigned to the new job(s) based on this selection:
   	/assignVersionSetting:<the existing version the job will be assigned to>(optional)
   New job(s) extended properties value will be set to one of the current job's extended properties values 
   specified by JTX Token) or to the given string value. To set multiple extended properties values at once separate 
   each entry by a semicolon:
   	/setExtendedProps: 
   <ChildJobFullyQualifiedExtendedPropertiesTableName.FieldName=
   [JOBEX:ParentJobFullyQualifiedExtendedPropertiesTableName.FieldName]>; 
   <ChildJobFullyQualifiedExtendedPropertiesTableName.FieldName=
   [JOBEX:ParentJobFullyQualifiedExtendedPropertiesTableName.FieldName]>;...(optional)
   Due date of the new job:
   	/dueDate:<due date of the new job>(optional)
   Job duration:
   	/jobDuration:<duration of the new job>(optional)
   New Job will be created as a child of the existing job:
   	/child(optional)
   

   Коды возврата:
   • 0 = Успешное завершение
   • 1 = Неудачное завершение
4. DefineAOI

   JTXDesktopSteps.DefineAOI

   Отображение инструмента, с помощью которого пользователь может определить местоположение интереса.

   No Argument
   

   Коды возврата:
   • 1 = Успешное завершение
   • 0 = Неудачное завершение
5. EditExtendedProperties

   JTXDesktopSteps.EditExtendedProperties

   Отображает индивидуальные (1-1) расширенные свойства задания в виде всплывающего окна, позволяющего пользователю указать необходимые свойства. Этот шаг может быть включен в рабочий процесс несколько раз с различными расширенными свойствами, которые будут открываться на разных этапах рабочего процесса. Это дает возможность выбрать только некоторые расширенные свойства, настроенные для типа задания, которые будут отображаться во всплывающем окне. Расширенные свойства могут быть выбраны посредством открытия редактора аргументов или посредством ввода в поле аргументов. Все выбранные свойства соответствуют таким свойствам, установленным для данного типа задания, как видимость, доступность для редактирования и др. Если аргументы не указаны, то все выбранные по типу задания расширенные свойства будут отображаться при выполнении шагов.Редактор аргументов отображает все таблицы и поля, настроенные для всех типов заданий в репозитории; но если выбраны свойства, которые не настроены по типу задания, то они не будут отображаться во всплывающем окне.Аргумент составлен из имени таблицы расширенных свойств и имени поля. Например, если вы хотите отобразить поле RequestorName из таблицы RequestorInformation, аргументом будет /Property: RequestorInformation.RequestorName.

   /Property:<Property Name>
   

   • 1 = Успешное завершение
6. LaunchArcMap

   Для шага JTXDesktopSteps.LaunchArcMap, когда он будет выполнен, запустится ArcMap. Слои будут использовать версию задания в качестве источника данных, и карта будет приближена к местоположению интереса задания.

   Подробнее об аргументах шагов для шага LaunchArcMap

   Коды возврата:

   • 0 = Успешное завершение

7. LaunchGPTool

   JTXDesktopSteps.LaunchGPTool

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

   Toolbox Path (explicit path to the tbx file):
   	/toolboxpath:<toolboxpath> (optional)
   Toolbox Name (if in system toolboxes):
   	/toolbox:<toolbox> (optional)
   Display Name of the Tool in the toolbox:
   	/tool:<tool> 
   Parameter to override on the tool (can be specified multiple times):
   	/param:<ParamName>:<ParamValue> (optional)
   Flag to attach the log to the job once the tool has completed:
   	/attach (optional)
   License enumeration code for any additional license that should be used in the execution of the tool:
   	/license:<enum value> (optional)
   Output parameter to use as return value:
    /outParam:<parameter name>
   

   Коды возврата:
   • 1 = Успешное завершение
   • 0 = Отмена

   Примечание:

   При использовании аргумента outParam кодом успеха является значение, возвращаемое в качестве выходного параметра инструмента геообработки, а возвращаемым кодом отмены в этом случае будет -1.

8. SelectDataWorkspace

   JTXDesktopSteps.SelectDataWorkspace

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

   No Argument
   

   Коды возврата:
   • 1 = Успешное завершение
   • 0 = Неудачное завершение

Шаг Запуск ArcMap

Ожидаемое поведение шага Запуск ArcMap без аргументов подробно описано в таблице ниже.

В ней приводится описание ожидаемого поведения шага LaunchArcMap, который поставляется с Workflow Manager.

Определен ли документ карты типа задания?	LaunchArcMap с рабочей областью данных и версией	LaunchArcMap с рабочей областью данных, но без версии	LaunchArcMap без рабочей области данных
Да	Открытый ArcMap использует определенный документ карты. Слои будут использовать в качестве источника версию задания на основе краткого имени класса объектов. Карта приближается к области интереса (AOI). Примечание: Короткое имя – это имя класса пространственных объектов, не полностью определенное. Например, Streets вместо NIS.Streets. Также учтите, что неважно, как изначально была определена базовая карта, любые случаи совпадения кратких имен должны быть предусмотрены.	Это работает так же, как и в сценарии, когда версия существует, за исключением того, что в качестве источников слоев используется версия по умолчанию для рабочей области данных.	Никаких изменений в источниках слоев не производится. Карта приближается к области интереса (LOI).
Нет	ArcMap открывается с пустым документом. В этом случае, поскольку карты не существует, слои не предоставляются. Как только слои добавлены на карту, пользователь может напрямую перейти к определенной для задания версии или к версии по умолчанию для выбранной рабочей области данных с помощью кнопки Добавить данные на панели инструментов Workflow Manager.	Поведение аналогично сценарию, когда версия существует.	ArcMap открывается с пустым документом. Кнопка Добавить данные на панели инструментов Workflow Manager недоступна. Если для задания существует местоположение интереса, можно использовать инструмент Приблизить к LOI.

Слои базовой карты не изменяются в карте, открытой с помощью Workflow Manager.

Примечание:

Исполняемый файл JTXMxLaunch.exe для открытия ArcMap больше не входит в пакет установки Workflow Manager. Обновите все шаги, использующие эту утилиту, чтобы открыть ArcMap, чтобы использовать объект настраиваемого шага JTXDesktopSteps.LaunchArcMap.

Внимание:

Если карты ArcGIS Pro (.mapx), сохраненные в репозитории Workflow Manager и карта ArcGIS Pro (.mapx), компоновка (.pagx) или веб-карта, сохраненная в ArcGIS Online или Portal for ArcGIS, используется с Типами заданий и шагами, настроенными для ArcGIS Desktop, то она не откроется, и появится сообщение об ошибке. Кроме того, если этот шаг будет запущен с помощью рабочей области данных сервиса объектов в ArcGIS Desktop, то он не откроется, и появится сообщение об ошибке.

Описания аргументов

Шаг LaunchArcMap имеет много дополнительных параметров, позволяющих настроить его выполнение в соответствии с потребностями без написания кода.

Показаны редактор аргументов шага Запустить ArcMap и вкладка типа шага Выполнение с настроенным поведением по умолчанию.

Примечание:

Слои карты должны ссылаться на данные из рабочей области данных в системе Workflow Manager для восстановления информации о версии и подключении пользователя. Если в системе Workflow Manager слои карты ссылаются на данные из рабочей области данных, но для задания не указана версия задания, то для данной рабочей области данных слои карты восстанавливаются на версию базы данных по умолчанию. Слои карты не переопределяются в следующих сценариях:

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

Более подробно о картах и версиях

Описательное имя	Пример аргумента	Поведение
Приблизить к LOI.	/aoifactor:3 или /nozoomloi	В соответствии с поведением по умолчанию, изображение карты будет перемещено к области интереса (AOI) задания и приближено с коэффициентом 1 к геометрии формы. При желании вы можете отказаться от перемещения или масштабирования карты с помощью опции /nozoomloi. Вы также можете приблизить представляющую интерес область с более высоким коэффициентом масштабирования, используя аргумент /aoifactor. Коэффициент масштабирования не применяется для POI. Для одной точки интереса карта масштабируется до 1:2000, а для нескольких – к их экстенту.
Не изменять никакую информацию о подключении.	/norepoint	Поведение по умолчанию, когда /norepoint не используется, изменяет все слои карты на текущую рабочую область и, дополнительно, версию задания.
Изменить версию только для рабочей области данных задания.	/changeversiononly	Если вы решите использовать опцию /changeversiononly, то версия слоев в документе карты типа задания изменится. Пользователь данных и информация о подключении затронуты не будут. Все слои из рабочей области данных будут переключены независимо от того, выбраны ли они для переключения в свойствах типа задания. Слои, не ссылающиеся на данные рабочей области, будут отображены с поврежденными источниками данных. Примечание: При использовании индивидуальных учетных записей, данная опция не переопределяет слои карты и они указывают на версию по умолчанию.
Сохранить MXD.	/nosavemxd	По умолчанию, когда аргумент /nosavemxd не используется, документ карты задания сохраняется в базе данных Workflow Manager. Таким образом, каждый раз, когда вы открываете документ карты задания, используя данный шаг в рабочем процессе, из базы данных извлекается последняя сохранённая карта. Однако, если вы решите использовать опцию /nosavemxd, документ карты задания не будет сохранен в базе данных Workflow Manager. Таким образом, если вы измените экстент карты задания и закроете её, новый экстент не будет сохранен и в следующий раз карта будет вновь открыта в оригинальном экстенте. Примечание: ArcMap предлагает сохранить карту при каждом закрытии карты, но при использовании опции /nosavemxd карта не сохранится, даже если вы подтвердите сохранение, нажав Да в ответ на сообщение ArcMap. Если ваши документы карты имеют большой размер, вам может понадобиться скорректировать настройку конфигурации MAXBLOBSIZE SDE. Эта опция позволяет также переключаться между заданиями в ArcMap без очистки документа карты.
Вырезать фрейм данных по AOI.	/cliptoaoi	По умолчанию, если аргумент /cliptoaoi не используется, в документе карты отображаются все доступные для просмотра данные. При использовании опции /cliptoaoi фрейм данных в документе карты задания вырезается по форме области интереса. Примечание: При этом не создается определяющий запрос для слоев. Все пространственные объекты в слоях карты всё ещё доступны через их соответствующие таблицы.
Подождите, пока ArcMap закроется (приостановить Workflow Manager)	/nowait	Поведение приложения Workflow Manager по умолчанию, когда аргумент /nowait не используется, заключается в том, чтобы быть скрытым во время выполнения процесса ArcMap. Это означает, что пользователь не может работать с приложением Workflow Manager во время работы в ArcMap. Когда используется опция /nowait, ArcMap запускается в отдельном процессе, позволяя пользователю работать с приложением Workflow Manager во время работы ArcMap. Примечание: Эта опция была добавлена, поскольку опция Запустить процесс асинхронно для шагов рабочего процесса является недоступной для объектов настраиваемых шагов.
Используйте существующий сеанс ArcMap.	/useexisting	По умолчанию, если не настроен аргумент /useexisting, новый сеанс ArcMap открывается во время выполнения шага. С опцией /useexisting, если при выполнении шага сеанс ArcMap открыт, Workflow Manager открывает документ карты задания в этом существующем сеансе. Если открытого сеанса ArcMap нет, Workflow Manager откроет новый сеанс.
Хранить MXD в совместно используемой директории.	/mxdfolder:"D:\Data\JTXMapDocuments"	По умолчанию альтернативное местоположение не настраивается, а документы карты задания сохраняются в базе данных Workflow Manager. Если ваши документы карты имеют большой размер, вам может понадобиться скорректировать настройку конфигурации MAXBLOBSIZE SDE. Если вы решите сохранять документы карты в другом месте, то Workflow Manager не будет сохранять документы карты в базе данных, а сохранит их в этом альтернативном местоположении для использования в будущем.
Использовать альтернативный MXD.	/mxd:"D:\Data\JTXTemplates\Editing.mxd"	Следуя поведению по умолчанию, данный шаг использует документ карты по умолчанию для типа задания в качестве документа базовой карты для LaunchArcMap. Если вы решите использовать эту опцию, Workflow Manager загрузит документ или шаблон карты, настроенный для аргумента. Примечание: Карты ArcGIS Pro (.mapx) можно использовать в вместо MXD в шагах, настроенных для ArcGIS Pro.
Запустите команду ArcMap.	/guid:esriArcMapUI.AddDataCommand	После того, как ArcMap закончит загрузку, представленная введенным ProgID кнопка будет нажата программными средствами.
Загрузить рабочий процесс Task Assistant.	/taworkflow:"LotSplit"	Если этот аргумент настроен, то при открытии ArcMap Workflow Manager откроет настроенный рабочий процесс Task Assistant. Переданное имя рабочего процесса является псевдонимом рабочего процесса Task Assistant, сохраненного в системе Workflow Manager. Можно ввести имена нескольких рабочих процессов путем добавления дополнительных записей /taworkflow или выбирая желаемые рабочие процессы в редакторе аргументов.
Хранить историю Task Assistant в Истории задания.	/storetahistory	Если данный аргумент настроен, рабочий процесс task assistant добавляется в историю задания по умолчанию. Вы по-прежнему можете прикрепить его как текстовый файл с помощью инструментов Workflow Manager.