需要 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
在不显示地理处理对话框的情况下运行地理处理工具、模型或脚本。 工具的整型输出可用作返回代码以指引工具完成运行时的工作流路径。
注:
当使用 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
将作业版本设置为命名的版本。 例如,将作业版本设置为“质量控制版本”以验证在版本中提交的编辑内容。 如果没有 step 参数,则作业版本将重置为原始版本。 该步骤支持传统数据工作空间和要素服务数据工作空间。
参数
下表中包含步骤参数列表:
参数 | 描述 | 参数类型 |
---|---|---|
/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
创建一个作业并允许您定义与该作业的父/子依赖关系。 创建子作业时,起始日期、截止日期、数据工作空间和优先级将会从父作业中复制。 而作业分配将会从作业类型默认属性中复制(如果未在 step 参数中指定具体值)。 该步骤支持使用传统数据工作空间和要素服务数据工作空间来创建作业的版本。 如果使用要素服务数据工作空间设置子作业,则父版本只能为 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
显示允许用户定义 AOI 的工具。
参数
该步骤不需要任何参数。
返回代码
以下是返回代码列表:
- 1 = 成功
- 0 = 失败
EditExtendedProperties—JTXDesktopSteps.EditExtendedProperties
将作业的扩展属性以弹出表单的形式显示,以便定义所需的属性。 工作流中可多次执行该步骤,从而在工作流的不同阶段打开不同的扩展属性。 这样便能够选择在弹出表单中显示针对作业类型配置的特定扩展属性。 要选择扩展属性,可通过打开参数编辑器或在参数框中输入。 所有选定属性都将应用作业类型中所设置的属性,如可见、可编辑等。 如果未指定参数,则在运行步骤后将显示针对作业类型选择的所有扩展属性。 参数编辑器将包含为资料档案库中全部作业类型配置的所有表和字段;但是,如果选择未针对作业类型配置的属性,则在弹出表单中将不会显示这些属性。 参数由扩展属性表名称和字段名称组成。 例如,要显示 RequestorInformation 表中的 RequestorName<fieldName> 字段,则参数是 /Property: RequestorInformation.RequestorName。
参数
下表中包含步骤参数列表:
参数 | 描述 | 参数类型 |
---|---|---|
/Property:<Property Name> | 扩展属性表名称和字段名称 | 必需项 |
返回代码
如果该步骤成功,则该步骤将返回 1。
Import/Launch Mapping Items—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) 打开的地图中。
警告:
如果存储在 Workflow Manager (Classic) 资料档案库中的 ArcGIS Pro 地图 (.mapx) 以及存储在 ArcGIS Online 或 Portal for ArcGIS 中的 ArcGIS Pro 地图 (.mapx)、布局 (.pagx) 或 web 地图与作业类型以及为 ArcMap 配置的步骤配合使用,则它不会打开,并且将显示一条错误消息。 如果使用 ArcMap 中的要素服务数据工作空间运行该步骤,则它不会打开,并且将显示一条错误消息。
参数描述
“导入/启动映射项目”步骤提供了许多无需编写代码即可对其进行自定义的可选参数。
将显示已配置了默认行为的启动 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 参数,则作业的地图文档中的数据框将裁剪成 AOI 的形状。 如果未在作业的地图文档中定义 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适用于 Data Reviewer 许可。
创建 Reviewer 会话步骤 - ProductionMappingSteps.CreateReviewerSession
“创建 Reviewer 会话”步骤用于创建 Reviewer 会话并将其与作业相关联。 “导入/启动映射项目”步骤可以使用关联的 Reviewer 会话来执行其操作。 每个作业支持多个 Reviewer 会话。
参数
下表中包含步骤参数列表:
名称 | 描述 | 参数示例 | 行为 |
---|---|---|---|
结果工作空间(必填) | 指定要从中创建新会话的结果工作空间。 可通过三种方式指定此参数:
注:必须选择现有的 Reviewer 工作空间。 此步骤不会创建 Reviewer 工作空间。 | /StoreInJobDW | Reviewer 工作空间被视为与作业的数据工作空间相同的工作空间。 运行此步骤时,会在作业的数据工作空间中创建新的 Reviewer 会话。 此参数中可以使用令牌。 |
/RevWSVersion:[JOB:VERSION] | 运行此步骤时,新 Reviewer 会话将与指定的地理数据库版本相关联。 默认为 [JOB:VERSION] 令牌。 | ||
/WMXDW:Reviewer | Reviewer 工作空间被视为 Workflow Manager (Classic) 数据工作空间。 运行此步骤时,会在工作空间中创建 Reviewer 会话。 | ||
/RevWSVersion:DEFAULT | 运行此步骤时,新 Reviewer 会话将与指定的地理数据库版本相关联。 | ||
/ReviewWS:"C:\Data\Reviewer.gdb" | Reviewer 工作空间被视为文件或个人地理数据库。 运行此步骤时,会在工作空间中创建 Reviewer 会话。 此参数中可以使用令牌。 | ||
会话属性(仅会话名称属性必填) | 指定会话的属性,包括会话名称、创建者、重复检查执行方式以及是否应存储结果几何。 必须设置以下属性:
| /SessionName:Job[JOB:ID] | 运行此步骤时,将根据此参数来命名新 Reviewer 会话。 在本参数示例中,是基于作业 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 会话。 注:Reviewer 会话必须在执行步骤前已存在。 此步骤不会创建 Reviewer 会话。 | /RevSessionName:JOB[JOB:ID] | 运行此步骤时,Reviewer 记录将被写入指定的会话。 如果多个 Reviewer 会话具有相同名称,系统将提示您选择一个 Reviewer 会话以便将记录写入其中。 此参数中可以使用令牌。 |
分析区域(必填) | 指定运行批处理作业的空间范围。 | /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 会话