需要 Workflow Manager 许可。
ArcGIS Workflow Manager (Classic) Desktop 提供了多个自定义步骤。每个自定义步骤的源代码都作为开发工具包的一部分提供。以下内容对步骤及其作用进行了概述。
所有平台库
所有平台库均包含可在 ArcMap、ArcCatalog、ArcGIS Pro 和 ArcGIS Server 中执行的步骤。以下部分将介绍步骤及其参数以及返回代码。
AddJobHold - JTXSteps.AddJobHold
将保存内容添加到当前作业。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/holdType:<hold type> | 阻停项类型的名称 | 必需项 |
/holdComment:<string> | 要为阻停项类型添加的注释 | 可选项 |
返回代码
以下是返回代码列表:
- 1 = 成功
- 0 = 失败
CheckAOI - JTXSteps.CheckAOI
检查是否存在当前作业的感兴趣位置 (LOI)。
参数
该步骤不需要任何参数。
返回代码
以下是步骤返回代码列表:
- 1 = 作业具有 LOI。
- 2 = 作业不具有 LOI。
CleanUp - JTXSteps.CleanUp
基于参数清理作业。启用管理系统设置,以允许用户删除其他用户所拥有的版本。这将提示您输入用户名和密码。
注:
删除不同用户所拥有的版本时,必须指定地理数据库超级用户的凭据。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/version|v | 清理版本 | 可选项 |
/mxd|m | 清理 MXD | 可选项 |
/attachments|a | 清理附件 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
CloseJob - JTXSteps.CloseJob
将关闭作业这一操作作为一个独立的步骤,与工作流完成后作为手动过程关闭相反。
参数
该步骤不需要任何参数。
返回代码
如果该步骤成功,则该步骤将返回 0。
CreateJob - JTXSteps.CreateJob
基于参数创建子作业。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/jobtypename:<job type name> | 作业类型的名称 | 必需项 |
/assigngroup:<group to assign to> | 将作业分配到的群组 | 可选项 |
/assignuser:<user to assign to> | 将作业分配到的用户 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
CreatePDF - JTXSteps.CreatePDF
创建作业底图的 PDF 文档并将其附加到该作业。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/initdir:<initial directory> | 将用于保存 PDF 的位置。 | 可选项 |
/noattach | 不要将 PDF 附加到作业。 | 可选项 |
/resolution:<dpi> | PDF 的分辨率。 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
CreateVersion - JTXSteps.CreateVersion
创建作业的版本。版本的保护级别通过下列参数之一指定:Version、Access 或 Scope。该步骤支持传统数据工作空间和要素服务数据工作空间。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/scope:<public|private|protected> | 版本的保护级别。默认设置为 private。 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
ExecuteGPTool - JTXSteps.ExecuteGPTool
在不显示地理处理对话框的情况下执行地理处理工具、模型或脚本。工具的整型输出可用作返回代码以指引工具完成时的工作流路径。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/toolboxpath:<toolboxpath> | 工具箱 .tbx 文件的完整路径和工具名称 | 必需项 |
/tool:<tool> | 工具箱中工具的显示名称 | 必需项 |
/param:<ParamName>:<ParamValue> | 工具上要覆盖的参数(可以多次指定) | 可选项 |
/attach | 可在工具完成运行后将日志附加到作业 | 可选项 |
/outParam:<parameter name> | 要用作返回值的输出参数 | 可选项 |
返回代码
以下是步骤返回代码列表:
- 0 = 成功
- 1 = 取消
注:
当使用 /outParam 参数时,成功返回代码为指定地理处理工具的输出参数的值,而“取消”返回代码为 -1。
ExecuteSQL - JTXSteps.ExecuteSQL
执行 SQL 语句。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/database:<jtxsystem|data> | 查询将发送到的数据库 | 必需项 |
/sql:<sql command> | 将发送到数据库的 SQL 查询 | 必需项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
ExecuteURL - JTXSteps.ExecuteURL
执行 URL,并且不显示浏览器以显示响应。例如,可将地理处理服务或任何其他 Web 服务作为工作流步骤来执行.
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/url:<url> | 要执行的 URL | 必需项 |
/timeout:<timeout in seconds> | 请求的超时,以秒为单位 | 可选项 |
/proxy:<proxy> | 要使用的代理服务器 | 可选项 |
/addjobcomment | 通过响应向作业添加评论 | 可选项 |
/postdata:<data to post> | 执行 URL 时要发送的数据 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 200。
ExecuteWorkflow - JTXSteps.ExecuteWorkflow
执行与作业类型关联的其他工作流。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/jobtype:<job type name> | 作业类型的名称。 | 必需项 |
/donotuseaoi | 不使用作业 AOI。 | 必需项 |
/donotuseversion | 不使用作业版本。 | 可选项 |
/donotcopyactivities | 不会将活动复制到父作业的历史记录中。 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
ReassignJob - JTXSteps.ReassignJob
重新分配作业。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/assignType:<user|group> | 将作业重新分配到用户或群组。 | 必需项 |
/assignTo:<user or group name> | 将作业分配到的用户或群组 | 必需项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
ReturnValue - JTXSteps.ReturnValue
检索传递的扩展属性或令牌的值,该值作为工作流中下一个路径的返回代码。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/value:<extended properties field> | 您要从中检索返回值的扩展属性字段 | 必需项 |
返回代码
该步骤将返回指定扩展属性字段的值。
SendNotification - JTXSteps.SendNotification
发送参数指定类型的通知。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/notifType:<type> | 要发送的通知类型 | 必需项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
SetVersion - JTXSteps.SetVersion
将作业版本设置为命名的版本。例如,将作业版本设置为“质量控制版本”以验证在版本中提交的编辑内容。如果无步骤参数,则作业版本将重置为原始版本。该步骤支持传统数据工作空间和要素服务数据工作空间。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/version:<versionName> | 用作作业版本的版本 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
UpdateExtentFeatureClass - JTXSteps.UpdateExtentFeatureClass
使用作业信息来更新要素类以使状态可见。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/fclass:<fully qualified feature class name> | 要更新的要素类(必须在数据地理数据库中) | 必需项 |
/jobfield:<field name> | 将在其中存储作业 ID 的字段 | 可选项 |
/datefield:<field name> | 将在其中存储日期和时间的字段 | 可选项 |
返回代码
如果该步骤成功,则该步骤将返回 0。
VersionExists - JTXSteps.VersionExists
检查是否已存在作业的地理数据库版本。该步骤支持传统数据工作空间和要素服务数据工作空间。
参数
该步骤不需要任何参数。
返回代码
以下是步骤返回代码列表:
- 1 = 存在版本
- 2 = 不存在版本
- 3 = 未选择数据工作空间
仅 ArcGIS Pro 和 ArcGIS Desktop 库
仅 ArcGIS Pro 和 ArcGIS Desktop 库包含只能在 ArcGIS Pro、ArcMap 和 ArcCatalog 中执行的步骤。以下部分将介绍步骤及其参数以及返回代码。
AddAttachments - JTXDesktopSteps.AddAttachments
将链接式、嵌入式及 URL 附件添加到作业。
参数
该步骤不需要任何参数。
返回代码
以下是返回代码列表:
- 1 = 成功
- 0 = 失败
CreateJobAdvanced - JTXDesktopSteps.CreateJobAdvanced
创建一个作业并允许您定义与该作业的父/子依赖关系。创建子作业时,起始日期、截止日期、数据工作空间和优先级将会从父作业中复制,而作业分配将会从作业类型默认属性中复制(如果未在步骤参数中指定具体值)。该步骤支持使用传统数据工作空间和要素服务数据工作空间来创建作业的版本。如果使用要素服务数据工作空间设置子作业,则父版本只能为 sde.Default。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/jobtypename:<job type name> | 作业类型的名称。 | 必需项 |
/assigngroup:<group to assign to> | 将作业分配到的群组。 | 可选项 |
/assignuser:<username to assign to> | 将作业分配到的用户。 | 可选项 |
/dependThisStep | 创建一个依赖项,并在此步骤中阻停当前作业。 | 可选项 |
/dependNextStep | 创建一个依赖项,并阻停将在工作流的下一步中阻停的当前作业。 | 可选项 |
/dependStatus:<Status Type Name> | 依赖项状态类型的名称(将阻停当前作业,直到新作业达到此状态为止)。 | 可选项 |
/useparentaoi | 将当前作业的 AOI 用作新作业的 AOI。 | 可选项 |
/aoiOverlapFeatureClassName:<fully qualified feature class name > | 根据当前作业的 AOI 和指定要素类之间的重叠创建新的作业。 | 可选项 |
/numberJobs:<number of jobs to create> | 要创建的默认作业数。 | 可选项 |
/createVersionSetting:<the version to use as the parent version> | 创建新作业时要使用的版本。 | 可选项 |
/assignVersionSetting:<the existing version the job will be assigned to> | 创建新作业时要使用的现有版本。 | 可选项 |
/setExtendedProps:<ChildJobFullyQualifiedExtendedPropertiesTableName.FieldName=[JOBEX:ParentJobFullyQualifiedExtendedPropertiesTableName.FieldName]>; <ChildJobFullyQualifiedExtendedPropertiesTableName.FieldName=[JOBEX:ParentJobFullyQualifiedExtendedPropertiesTableName.FieldName]>;... | 创建新作业时,扩展属性值将设置为当前作业的扩展属性值之一(由 JTX 令牌指定)或给定的字符串值。 要设置多个扩展属性值,请用分号分隔每个条目。 | 可选项 |
/dueDate:<due date of the new job> | 新作业的截止日期。 | 可选项 |
/jobDuration:<duration of the new job> | 新作业的持续时间。 | 可选项 |
/child | 将新作业创建为现有作业的子作业 | 可选项 |
返回代码
以下是返回代码列表:
- 0 = 成功
- 1 = 失败
DefineAOI - JTXDesktopSteps.DefineAOI
显示允许用户定义感兴趣位置的工具。
参数
该步骤不需要任何参数。
返回代码
以下是返回代码列表:
- 1 = 成功
- 0 = 失败
EditExtendedProperties - JTXDesktopSteps.EditExtendedProperties
将作业的扩展属性以弹出表单的形式显示,以便定义所需的属性。工作流中可多次执行该步骤,从而在工作流的不同阶段打开不同的扩展属性。这样便能够只选择在弹出表单中显示为作业类型配置的某些扩展属性。可通过打开参数编辑器或在参数框中输入来选择扩展属性。所有选定属性都将应用作业类型中所设置的属性,如可见、可编辑等。如果未指定参数,则在运行步骤后将显示针对作业类型选择的所有扩展属性。参数编辑器将包含为资料档案库中全部作业类型配置的所有表和字段;但是,如果选择未针对作业类型配置的属性,则在弹出表单中将不会显示这些属性。参数由扩展属性表名称和字段名称组成。例如,如果要显示 RequestorInformation 表中的 RequestorName<fieldName> 字段,则参数将是 /Property: RequestorInformation.RequestorName。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/Property:<Property Name> | 扩展属性表名称和字段名称 | 必需项 |
返回代码
如果该步骤成功,则该步骤将返回 1。
导入/启动映射项目 - JTXDesktopSteps.LaunchArcMap
启动 ArcGIS Pro 或 ArcMap,转至作业版本的资源图层,然后将地图缩放到感兴趣的作业位置。
参数
有关步骤参数的详细信息,请参阅“导入/启动映射项目”步骤部分。
返回代码
如果该步骤成功,则该步骤将返回 0。
LaunchGPTool - JTXDesktopSteps.LaunchGPTool
从工作流中执行地理处理工具。工具的整型输出可用作返回代码以指引工具完成时的工作流路径。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/toolboxpath:<toolboxpath> | 工具箱 .tbx 文件的完整路径和工具名称 | 可选项 |
/toolbox:<toolbox> | 工具箱的名称(如果在系统工具箱中) | 可选项 |
/tool:<tool> | 工具箱中工具的显示名称 | 必需项 |
/param:<ParamName>:<ParamValue> | 工具上要覆盖的参数(可以多次指定) | 可选项 |
/attach | 可在工具完成运行后将日志附加到作业 | 可选项 |
/license:<enum value> | 应用于执行该工具的任何其他许可的许可代码 | 可选项 |
/outParam:<parameter name> | 要用作返回值的输出参数 | 可选项 |
返回代码
以下是步骤返回代码列表:
- 0 = 成功
- 1 = 取消
注:
当使用 /outParam 参数时,成功返回代码为指定地理处理工具的输出参数的值,而“取消”返回代码为 -1。
SelectDataWorkspace - JTXDesktopSteps.SelectDataWorkspace
显示一个表单,允许您从预配置数据工作空间的列表中选择作业的数据工作空间。
参数
该步骤不需要任何参数。
返回代码
以下是返回代码列表:
- 1 = 成功
- 0 = 失败
仅 ArcGIS Pro 库
仅 ArcGIS Pro 库包含只能从 ArcGIS Pro 执行的步骤。以下部分将介绍步骤及其参数以及返回代码
导入任务 - ArcGISProSteps.OpenTask
在 ArcGIS Pro 工程中打开任务。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/taskfile:<name of the file> | 要在工程中打开的任务文件 | 可选项 |
/task:<name of the task within the task item> | 任务项目中要执行的任务 | 可选项 |
返回代码
以下是步骤返回代码列表:
- 0 = 失败
- 1 = 成功
打开 Pro 工程项目 - ArcGISProSteps.OpenMap
在 ArcGIS Pro 工程中打开地图。
参数
下表中包含步骤参数列表:
参数 | 说明 | 参数类型 |
---|---|---|
/map:<mapname> | 要在工程中打开的地图 | 可选项 |
/nobookmark | 不要将作业的 LOA 添加为书签 | 可选项 |
/taskItem:<name of task project item> | 要在工程中打开的任务项目 | 可选项 |
/task:<name of the task within the task item> | 任务项目中要执行的任务 | 可选项 |
/resetVersion | 完成该步骤后,将版本重置为默认版本 | 可选项 |
/closeMaps | 完成该步骤后,关闭打开的地图 | 可选项 |
返回代码
以下是步骤返回代码列表:
- 0 = 失败或取消
- 1 = 成功
“导入/启动映射项目”步骤
下表详细介绍了无参数的“导入/启动映射项目”步骤的预期行为。
是否已定义作业类型地图文档? | 使用数据工作空间和版本启动映射项目 | 使用数据工作空间而不使用版本启动映射项目 | 在不使用数据工作空间的情况下启动映射项目 |
---|---|---|---|
支持 | ArcMap 使用定义的地图文档打开。基于要素类的简称为作业版本提供图层资源。地图将缩放至感兴趣区域。 注:简称是要素类名称,而不是完全限定名称。例如,应该是 Streets,而不是 NIS.Streets。另请注意,无论底图的最初定义是什么,都应提供简称匹配项资源。 | 这与存在版本时的情形相同,只是数据工作空间的默认版本可用于提供图层资源。 | 未对图层源进行任何更改。地图缩放至 LOI。 |
不支持 | ArcMap 将打开并显示一个空白文档。在这种情况下,因为不存在任何地图,因此无法提供任何图层资源。将图层添加到地图后,Workflow Manager 工具条上的添加数据按钮会将您直接带到作业的已定义版本或所选数据工作空间的默认版本。 | 这与存在版本时的情形相同。 | ArcMap 将打开并显示一个空白文档。Workflow Manager 工具条上的添加数据按钮不可用。如果存在作业的 LOI,则可以使用缩放至 LOI 工具。 |
底图图层不会重嵌到由 Workflow Manager (Classic) 打开的地图中。
警告:
如果 ArcGIS Pro 地图 (.mapx) 存储在 Workflow Manager (Classic) 资料档案库中,且存储在 ArcGIS Online 或 Portal for ArcGIS 中的 ArcGIS Pro 地图 (.mapx)、布局 (.pagx) 或 web 地图与为 ArcGIS Desktop 配置的作业类型以及步骤配合使用,则其将无法打开,并且将显示一条错误消息。如果使用 ArcGIS Desktop 中的要素服务数据工作空间运行该步骤,则其将无法打开,并且将显示一条错误消息。
参数描述
“导入/启动映射项目”步骤提供了许多可选参数,您无需编写代码便可根据需要使用它们来自定义该步骤的执行。
将显示已配置了默认行为的启动 ArcMap 参数编辑器和步骤类型“执行”选项卡。
注:
地图中的图层必须引用 Workflow Manager (Classic) 系统内数据工作空间中的数据,这样才能重定向版本和用户连接信息。如果地图图层引用来自 Workflow Manager (Classic) 系统内数据工作空间的数据,但未对作业指定作业版本,则地图图层将重定向到数据工作空间的默认数据库版本。在下列情景中不会重定向地图图层:
- 如果未定义作业地图,则会打开空白地图,原因是没有可重定向的图层。
- 如果将步骤配置为仅更改版本,同时作业地图图层不来自数据工作空间,则这些图层将显示为具有损坏数据源的图层。
- 如果图层不来自数据工作空间,同时在作业类型属性中被选定为用于重定向,则这些图层将显示为具有损坏数据源的图层。
- 如果图层不来自数据工作空间,同时在作业类型属性中未被选定为用于重定向,则这些图层将重定向至默认数据库版本。
了解有关 Workflow Manager (Classic) 中地图和版本化的详细信息
描述性名称 | 参数示例 | 行为 |
---|---|---|
缩放至 LOI |
或者
| 在默认行为下,地图将被平移到作业的 AOI 并按照因子 1 缩放至形状几何。 (可选)可选择使用 /nozoomloi 选项,不平移或缩放地图。或者,可以使用 /aoifactor 参数,以更大的缩放因子缩放至 AOI。 缩放因子对 POI 不起作用。如果是单个 POI,则地图将缩放至 1:2000;如果有多个 POI,则地图将缩放至这些 POI 的范围。 |
不更改任何连接信息 |
| 如果未使用 /norepoint,则默认行为会将地图中的所有图层更改为当前数据工作空间或更改为作业版本。 |
仅更改作业数据工作空间的版本 |
| 如果选择使用 /changeversiononly 选项,则作业类型地图文档中的图层版本将发生更改。数据用户和连接信息将保持最初的配置不变。来自数据库工作空间的所有图层都将被重定向,无论在作业类型属性中是否将其选定为用于重定向。如果图层不来自数据工作空间,则这些图层将显示为具有损坏数据源的图层。 注:使用个人登录帐户时,此选项不会重嵌地图图层,这些图层将指向默认版本。 |
保存 MXD |
| 如果未使用 /nosavemxd 参数,默认行为会将作业的地图文档保存在 Workflow Manager (Classic) 数据库中。因此,每当使用工作流中的这一步骤打开作业的地图文档时,都将检索数据库中上次保存的地图。 然而,如果选择使用 /nosavemxd 选项,Workflow Manager (Classic) 数据库中则不会保存作业的地图文档。因此,如果更改作业地图的范围并将其关闭,则不会保存新范围,且下一次打开地图时仍会使用原始范围。 注:ArcMap 在每次关闭地图时都会显示保存地图的消息,但是在使用 /nosavemxd 的情况下,即使您在 ArcMap 消息中单击是,也不会保存地图。 如果地图文档很大,则可能需要调整 MAXBLOBSIZE SDE 配置设置。 此选项还允许您在 ArcMap 中切换作业,而无需清除地图文档。 |
将数据框裁剪至 AOI |
| 如果未使用 /cliptoaoi 参数,则默认行为会在可查看的地图文档中显示所有数据。 如果使用 /cliptoaoi 选项,则作业的地图文档中的数据框将裁剪成 AOI 的形状。 注:这不会创建对图层的定义查询。地图图层中的所有要素仍可通过其各自的表进行访问。 |
等待 ArcMap 关闭(暂停 Workflow Manager (Classic))。 |
| 如果未使用 /nowait 参数,则默认的 Workflow Manager (Classic) 应用程序行为会在运行 ArcMap 进程时隐藏。这意味着,用户无法在使用 ArcMap 时与 Workflow Manager (Classic) 应用程序进行交互。 如果使用 /nowait 选项,则会在单独进程中启动 ArcMap,从而允许用户在运行 ArcMap 时与 Workflow Manager (Classic) 应用程序进行交互。 注:此选项已添加,因为工作流步骤的异步启动进程选项不适用于自定义步骤对象。 |
使用现有 ArcMap 会话 |
| 如果未配置 /useexisting 参数,则默认行为是在执行该步骤时打开一个新的 ArcMap 会话。 在使用 /useexisting 选项的情况下,如果 ArcMap 会话在执行该步骤时处于打开状态,则 Workflow Manager (Classic) 将在该现有会话中打开作业的地图文档。如果没有处于打开状态的 ArcMap 会话,则 Workflow Manager (Classic) 将打开一个新会话。 |
将 MXD 存储于共享位置 |
| 在默认行为下,不会配置任何备用位置,且作业的地图文档将存储在 Workflow Manager (Classic) 数据库中。如果地图文档很大,则可能需要调整 MAXBLOBSIZE SDE 配置设置。 如果选择将地图文档存储在备用位置,则 Workflow Manager (Classic) 便不会将地图文档保存在数据库中,而是将其保存在该备用位置,以供今后使用。 |
使用备选 MXD |
| 在默认行为下,该步骤会将作业类型的默认地图文档用作“导入/启动映射项目”步骤的底图文档。 如果选择使用此选项,Workflow Manager (Classic) 将加载为参数配置的地图文档或模板。 注:ArcGIS Pro 地图 (.mapx) 可作为备选 MXD 用于为 ArcGIS Pro 配置的步骤。 |
运行 ArcMap 命令。 |
| 加载完 ArcMap 后,将运行指定命令。 |
加载任务助手工作流 |
| 如果已配置此参数,则在 ArcMap 打开后,Workflow Manager (Classic) 将打开已配置的“任务助手”工作流。传入的工作流名称是存储在 Workflow Manager (Classic) 系统中的“任务助手”工作流的别名。 通过添加附加的 /taworkflow 条目或通过在参数编辑器中选择工作流,可传入多个工作流。 |
将任务助手历史记录存储在作业历史记录中 |
| 如果已配置此参数,则“任务助手”工作流会默认添加到作业历史中。仍可以选择使用 Workflow Manager (Classic) 工具将其附加为文本文件。 |
Data Reviewer 库
Data Reviewer 库包含可用于自动选择 Data Reviewer 功能的步骤作为工作流的一部分。可通过将这些步骤和令牌搭配使用,为作业创建和删除 Reviewer 会话、直接从工作流运行 Reviewer 批处理作业,以及自动启动作业的 Reviewer 会话。以下部分将介绍步骤及其参数以及返回代码。
许可:
适用于 Data Reviewer 许可。
“创建 Reviewer 会话”步骤 - ProductionMappingSteps.CreateReviewerSession
“创建 Reviewer 会话”步骤用于创建 Reviewer 会话并将其与作业相关联。“导入/启动映射项目”步骤可以使用关联的 Reviewer 会话来执行其操作。每个作业支持多个 Reviewer 会话。
参数
下表中包含步骤参数列表:
名称 | 说明 | 参数示例 | 行为 |
---|---|---|---|
结果工作空间(必填) | 指定要从中创建新会话的结果工作空间。 可通过三种方式指定此参数:
注:必须选择现有的 Reviewer 工作空间。此步骤不会创建 Reviewer 工作空间。 | /StoreInJobDW | Reviewer 工作空间被视为与作业的数据工作空间相同的工作空间。 步骤执行后,会在作业的数据工作空间中创建新的检查器会话。 此参数中可以使用令牌。 |
/RevWSVersion:[JOB:VERSION] | 步骤执行后,新检查器会话将与指定的地理数据库版本相关联。默认令牌为 [JOB:VERSION]。 | ||
/WMXDW:Reviewer | Reviewer 工作空间将被视为 Workflow Manager (Classic) 数据工作空间。 步骤执行后,会在此工作空间中创建检查器会话。 | ||
/RevWSVersion:DEFAULT | 步骤执行后,新检查器会话将与指定的地理数据库版本相关联。 | ||
/ReviewWS:"C:\Data\Reviewer.gdb" | Reviewer 工作空间被视为与文件或个人地理数据库相同的工作空间。 步骤执行后,会在此工作空间中创建 Reviewer 会话。 此参数中可以使用令牌。 | ||
会话属性(仅会话名称属性必填) | 指定会话属性。这些属性包括会话名称、创建者、重复检查执行方式以及是否应存储结果几何。 必须设置以下参数:
| /SessionName:Job[JOB:ID] | 步骤执行后,将根据此参数来命名新检查器会话。 在本参数示例中,是基于作业 ID 对 Reviewer 会话进行命名,如 Job123。默认令牌为 [JOB:ID]。 |
/SessionUserName:[JOB_ASSIGNED_TO] | 创建此 Reviewer 会话的人员的名称。默认名称为 [JOB_ASSIGNED_TO] - 向其分配作业的人员。 注:如果此字段留空,则应用 [JOB_ASSIGNED_TO] 令牌。 此参数中可以使用令牌。 | ||
/CheckDuplicateResults:SESSION | 确定在会话中对重复验证结果的处理方法。
| ||
/DoNotStoreResultsGeometry | 确定结果是否包括关联的几何。
|
返回代码
以下是步骤返回代码列表:
- 0 = 成功
- 1 = 失败
删除 Reviewer 会话 - ProductionMappingSteps.DeleteReviewerSessions
“删除 Reviewer 会话”步骤将删除在作业执行期间,使用“创建 Reviewer 会话”步骤创建的一个或多个 Reviewer 会话。
在步骤配置期间,必须指定用于确定要删除的 Reviewer 会话的参数。
参数
下表中包含步骤参数列表:
名称 | 说明 | 参数示例 | 行为 |
---|---|---|---|
要删除的会话(必填) | 指定要删除的 Reviewer 会话。 | /sessionsToDelete:all | 在执行步骤时,将删除指定的 Reviewer 会话。
|
返回代码
以下是步骤返回代码列表:
- 0 = 已成功删除会话
- 1 = 未删除一个或多个 Reviewer 会话
- 2 = 已删除 Reviewer 会话,但无法更新作业信息
运行 Reviewer 批处理作业 - ProductionMappingSteps.RunReviewerBatchJob
“运行 Reviewer 批处理作业”步骤在工作流中执行批处理作业。
参数可用于指定以下内容:
- 要执行的批处理作业
- 要验证的空间数据
- 用于存储结果的 Reviewer 工作空间和会话
参数
下表中包含步骤参数列表:
名称 | 说明 | 参数示例 | 行为 |
---|---|---|---|
Reviewer 批处理作业文件(必填) | 指定检查器批处理作业的路径。 | /BatchJobPath:"C:\Data\sample.rbj" | 执行后,将运行指定的批处理作业。 此参数中可以使用令牌。 |
数据工作空间(可选) 注:选中覆盖批处理作业数据工作空间复选框时必填。 | 指定将要对其运行批处理作业的数据工作空间。 可通过三种方式指定此参数:
| 选中覆盖批处理作业数据工作空间复选框时,使用 /OverrideBatchDataWS 等参数。 | 执行步骤后,将对步骤类型中指定的数据工作空间运行批处理作业。 必须使用“检查器批处理作业数据工作空间”和“检查器批处理作业数据版本”参数指定备用的工作空间和版本。 |
/SameAsJobDW | 步骤执行后,批处理作业将验证作业的数据工作空间中的数据。 | ||
/BatchJobDataVersion:[JOB:VERSION] | 步骤执行后,批处理作业将验证指定版本中的数据。默认令牌为 [JOB:VERSION]。 | ||
/BatchJobInWMXDW:Reviewer | 步骤执行后,批处理作业将验证指定的 Workflow Manager (Classic) 数据工作空间中的数据。 | ||
/BatchJobInWMXDW:DEFAULT | 步骤执行后,批处理作业将验证指定版本中的数据。 | ||
/BatchJobDataInPersonalFile:"C:\Data\MyData.gdb" | 步骤执行后,批处理作业将验证指定的文件或个人地理数据库中的数据。 此参数中可以使用令牌。 | ||
结果工作空间(必填) | 指定要将结果写入其中的 Reviewer 工作空间。 可通过三种方式设置此参数:
注:必须选择现有的 Reviewer 工作空间。此步骤不会创建 Reviewer 工作空间。 | /RevIsSameAsJobDW | Reviewer 工作空间被视为与作业的数据工作空间相同的工作空间。 步骤执行后,Reviewer 结果将被写入作业的数据工作空间。 |
/RevWSVersion:[JOB:VERSION] | 步骤执行后,Reviewer 结果将被写入指定的版本。默认令牌为 [JOB:VERSION]。 | ||
/RevInWMXDW:Reviewer | Reviewer 工作空间被视为 Workflow Manager (Classic) 数据工作空间。 步骤执行后,Reviewer 结果将被写入此数据工作空间中。 | ||
/RevWSVersion:DEFAULT | 步骤执行后,Reviewer 结果将被写入指定的版本。 | ||
/RevInPersonalFile:"C:\Data\Reviewer.gdb" | Reviewer 工作空间被视为与文件或个人地理数据库相同的工作空间。 步骤执行后,Reviewer 记录将被写入此数据工作空间中。此参数中可以使用令牌。 | ||
Reviewer 会话名称(必填) | 指定要将结果写入其中的 Reviewer 会话。 注:执行步骤前必须存在检查器会话。此步骤不会创建检查器会话。 | /RevSessionName:JOB[JOB:ID] | 步骤执行后,检查器记录将被写入指定的会话。 如果多个检查器会话具有相同名称,系统将提示您选择一个检查器会话以便将记录写入其中。此参数中可以使用令牌。 |
分析区域(必填) | 指定运行批处理作业的空间范围。 | /AreaValidation:FullDB | 步骤执行后,将对整个地理数据库运行批处理作业。 |
/AreaValidation:AOI | 步骤执行后,将对作业的感兴趣区域运行批处理作业。 | ||
/AreaValidation:ChangedOnly | 步骤执行后,将只对更改的要素运行批处理作业。 注:此选项仅在与版本化数据集结合使用时有效。 | ||
结果创建者 | 指定创建 Reviewer 结果的人员的名称。 | /SessionUserName:[JOB_ASSIGNED_TO] | 创建此 Reviewer 结果的人员的名称。默认名称为 [JOB_ASSIGNED_TO]。 注:如果此字段留空,则应用 [JOB_ASSIGNED_TO] 令牌。 |
返回代码
以下是步骤返回代码列表:
- 0 = 批处理作业已成功执行,且未返回任何结果
- 1 = 批处理作业已成功执行,且结果已写入 Reviewer 会话
- 2 = 批处理作业执行失败
- 3 = 批处理作业已成功执行,但出现错误或警告,且未返回任何结果
- 4 = 批处理作业已成功执行,但出现错误或警告,且结果已写入 Reviewer 会话