“添加线事件”微件

“添加线事件”微件可用于在线性参照系统 (LRS) 中沿路径创建线事件。 您可以使用微件，通过 ArcGIS Pipeline Referencing 管理管道数据，使用 ArcGIS Roads and Highways 管理道路数据。 您可以将路径的特征（如管线的运行压力或道路的车道信息）用线事件来代表。

注：

所有 Location Referencing 微件支持快速模式。 当您在快速模式下创建应用程序时，所有 Location Referencing 微件都会根据添加到地图微件的 Web 地图自动配置。 在地图微件中所做的任何修改（例如更改 web 地图）都将立即反映在 Location Referencing 微件中。 快速模式允许您高效地设置 ArcGIS Experience Builder 中的 Location Referencing 微件，从而简化包含 Location Referencing 微件的应用程序的部署过程。

了解有关快速模式的详细信息

Pipeline Referencing 示例

使用此微件可支持以下应用程序设计要求：

• 您是管线检查者，想为正在维护的管线添加检查注释信息。
• 您想添加一个新的事件要素并弃用之前要素的重叠部分。
• 您希望在一个编辑会话中添加操作压力和 DOT 类信息。

Roads and Highways 示例

使用此微件可支持以下应用程序设计要求：

• 您想为高速公路添加车道信息。
• 您想为一条路径添加一个新的中线，并弃用之前中线的重叠部分。
• 您想在一个编辑会话中添加停车位和访问控制信息。

用法说明

此微件需要连接到“地图”微件。 要添加线事件，“地图”微件必须连接到 Web 地图数据源，该数据源需使用在发布时启用了线性参考和版本管理功能的 LRS。

要创建 LRS 并发布启用了线性参考和版本管理功能的要素服务，请按照 ArcGIS Pro 文档中的步骤操作：

• Pipeline Referencing - 创建 LRS 并将 LRS 作为网络层共享
• Roads and Highways - 创建 LRS 并将 LRS 作为网络层共享

要将“添加线事件”微件与发布到 ArcGIS Enterprise 的要素服务配合使用，您必须使用 ArcGIS Enterprise 账户登录。

在应用程序中加入该微件后，面板会为用户提供以下参数，用于添加线事件：

• 类型 - 选择添加单个或多个线事件。
  • 单线 - 添加单个线事件。
  • 多线 - 在一个编辑活动中添加多个线事件。
• 事件（在类型下选择单线时显示）- 选择要添加线事件的事件图层。
• 网络 - 此标注将列出与线事件图层相关联的网络图层。
• 属性集（在类型下选择多线时显示）- 属性集是事件图层属性的集合。 如果要素服务配置了 Pipeline Referencing 的属性集或者 Roads and Highways 的属性集，则可以从下拉菜单中选择一个属性集。 该微件只显示属于属性集的线事件。 您可以使用属性集在单次编辑中使用一组特定于组织的附加属性来创建多个事件。
• 开始方法 - 将在此处列出微件用于指定待添加线事件开始位置的方法。
  • 路径和测量 - 使用沿路径的特定测量值来指定已添加线事件的起始位置。
    • 路径始于 ID 或路径始于名称 - 提供用于定义线事件起点的路径 ID 或路径名称。 如果网络图层已将 route name 配置为标识符，则此设置将标注为路径始于名称。
    • 开始测量 - 为线事件起点提供测量值。 测量值定义了线路上线事件开始的确切位置。 此参数的标注还会显示网络图层定义的测量单位。 例如，如果测量单位是米，则运行时此设置将标注为开始测量（米）。
• 结束方法 - 将在此处列出微件用于指定待添加线事件结束位置的方法。
  • 路径和测量 - 使用沿路径的特定测量值来指定已添加线事件的结束位置。
    • 路径止于 ID 或路径止于名称 - 提供用于定义线事件终点的路径 ID 或路径名称。 如果网络图层已将 route name 配置为标识符，则此设置将标注为路径止于名称。 仅当所选事件图层为跨线事件或所选属性集包含跨线事件图层时，此选项才可用。
    • 结束测量 - 为线事件终点提供测量值。 测量值定义了路径上线事件结束的确切位置。 此参数的标注还会显示网络图层定义的测量单位。 例如，如果测量单位是米，则运行时此设置将标注为结束测量（米）。
• 开始日期 - 指定一个或多个事件的开始日期。
• 结束日期 - 指定一个或多个事件的结束日期。
• 合并重合事件 - 合并与现有事件具有完全相同属性且在测量值方面与现有事件相邻或重叠的已编辑事件。
• 停用重叠事件 - 停用与新事件重叠的现有事件。
• 向主要路径添加事件 - 向存在路径并发的主要路径添加事件。

设置

添加线事件微件包含以下设置：

• 模式 - 选择加载数据的方法。
  • 选择图层 - 选择地图微件并加载 web 地图中的所有图层。
    • 选择地图微件 - 在连接到 web 地图的页面中选择“地图”微件。
    • 加载图层 - 在连接的地图微件中从 web 地图加载图层。 要加载图层，地图微件必须连接到包含 LRS 图层的 web 地图。
    • 清除图层 - 从微件中移除所有已加载的图层。
    • 图层 - 加载图层后，可单击向下箭头展开图层列表。 单击图层打开图层配置面板。
    • 图层配置 - 配置单个图层的设置。
      • LRS 网络和相交图层：
        • 标注 - 为图层提供一个有意义的标注。 运行时，该标签会显示在微件面板中。
      • LRS 事件图层：
        • 标注 - 为图层提供一个有意义的标注。 运行时，该标签会显示在微件面板中。
        • 使用字段别名 - 打开此设置可在运行时显示字段别名。 别名或显示名称是字段的替代名称。 它通常是简单易懂的字段内容描述。 与真实字段名称不同，别名不需要遵守数据库的限制，因此它们可以包含特殊字符（如空格）。
        • 配置字段 - 选择要在运行时将图层中的哪些属性字段包含在微件面板中。 您可以单击可编辑或不可编辑，定义每个属性字段在运行时是否可编辑。

          注：

          您在配置字段下定义的设置仅适用于用户添加单个线事件时。 对于多个线事件，如果字段包含在用户在运行时选择的属性集中，则会显示这些字段。

  • 与“地图”微件进行交互 - 将“添加线事件”微件连接到“地图”微件。 连接的“地图”微件中的任何 Web 地图将显示在列表中。 连接到地图微件后，您可以单击选择图层按钮 旁边的向下箭头以展开图层列表。 单击图层打开图层配置面板。
    • 图层配置 - 配置单个图层的设置。 查看图层配置面板中可用的设置。
    • 选择图层 - 单击选择图层按钮 以打开选择图层面板。 您可以从面板列表中选择或取消选择图层。
• 默认设置 - 配置微件首次加载时可用的默认设置。
  • 事件（单线） - 选择用于添加线点事件的默认事件图层。
  • 网络（多线） - 选择用于添加多线事件的默认网络图层。 当用户添加单线事件时，网络始终是所选事件层的注册网络。
  • 开始方法 - 微件用于指定待添加线事件开始位置的方法。
    • 路径和测量 - 如果选择此方法，则微件会使用用户提供的路径名称和测量值指定待添加线事件的位置。
  • 结束方法 - 微件用于指定待添加线事件结束位置的方法。
    • 路径和测量 - 如果选择此方法，则微件会使用用户提供的路径名称和测量值指定待添加线事件的位置。
  • 类型 - 选择微件的设置是添加单个事件还是多个事件。
  • 属性集 - 如果图层的属性集配置为 Pipeline Referencing 或 Roads and Highways，则可以从下拉菜单中选择一个默认的属性集。 该微件只显示属于属性集的线事件。 属性集是事件层属性的集合。 您可以使用属性集在单次编辑中使用一组特定于组织的附加属性来创建多个事件。
• 显示设置 - 选择运行时要在微件面板中显示的设置。 如果选择在此处隐藏设置，用户在运行时就无法更改在默认设置下配置的微件设置。
  • 隐藏类型 - 从微件面板中隐藏类型的设置。
  • 隐藏事件 - 从微件面板中隐藏事件的设置。
  • 隐藏网络 - 从微件面板中隐藏网络的设置。
  • 隐藏方法 - 从微件面板中隐藏开始方法和结束方法的设置。
  • 隐藏属性集 - 从微件面板中隐藏属性集设置。
  • 隐藏测量 - 从微件面板中隐藏开始测量和结束测量的设置。
• 并发设置 - 选择在运行时用于向微件面板中的主要路径添加事件的设置。
  • 隐藏添加至主要路径选项 - 在微件面板中隐藏将事件添加至主要路径选项。
  • 启用添加至主要路径选项 - 在微件面板中启用将事件添加至主要路径选项。
  • 不允许覆盖主要路径上的事件位置 - 打开此设置将允许用户默认将事件添加至主要路径。

通过路径和测量添加线事件

要使用路径和测量方法添加线事件，请完成以下步骤：

1. 启动 Experience Builder。 登录到 ArcGIS Enterprise 门户。
2. 添加“地图”微件。 将其连接到包含 LRS 数据的 Web 地图，该数据在发布时需已启用线性参考功能和版本管理功能。

   了解更多有关启动 Pipeline Referencing 的 ArcGIS Pro 功能的信息

   了解更多有关启动 Roads and Highways 的 ArcGIS Pro 功能的信息

3. 添加添加线事件微件。 将其连接到地图微件，然后从地图微件加载 LRS 图层。
4. 发布应用程序。
5. 启动应用程序。如果出现提示，请登录您的 ArcGIS Enterprise 门户网站。
6. 缩放到要添加线事件的位置。

   注：

   要缩放至路径位置，您可以使用“按路径搜索”微件或通过“按路径搜索”微件或“表”微件使用数据操作。

7. 打开添加线事件微件。

   

   第一张图是包含 Pipeline Referencing 数据的“添加线事件”微件面板示例。 第二张图像是包含 Roads and Highways 数据的“添加线事件”微件面板示例。

   您还可以使用数据操作来添加线事件。

8. 使用默认类型或单击类型下拉箭头，必要时更改类型。
9. 如果类型设置为单线，使用默认的线事件图层，或单击事件下拉箭头选择另一个线事件图层。

   如果类型设置为多线，则可以使用默认属性集或选择其他属性集。

   网络下参数下显示的值基于所选事件图层。

10. 通过执行以下操作之一指定线事件的开始位置：
    • 在路径开始名称文本框中提供路径名称。
    • 单击路径选择器 ，然后单击地图上的路径。

    开始测量值会基于您单击的位置填充。 提供起始测量值后，将在地图上该位置处显示一个绿点。

11. 或者，可通过执行以下操作之一来更改起始测量值：
    • 在开始测量文本框中提供测量值。

      注：

      同样支持定点测量值。

    • 单击测量选择器 ，然后沿路径单击一个点。
12. 通过执行以下操作之一指定线事件的结束位置：
    • 对于非线网络上的事件或线路网络上的非跨事件，请单击测量选取器 ，然后单击路径上希望线事件结束的点。

      路径结束名称参数值默认为路径开始名称参数值，并且无法进行更改。 如果需要更改路径结束名称参数值，请在路径开始名称参数下提供新的路径名称。

    • 对于线路网络上的跨事件，接受默认的路径结束名称，或在路径结束名称文本框中提供另一个路径名称来更改结束路径。

      或者，单击路径选取器 ，然后单击路径上希望结束线事件的点。

      注：

      路径开始和路径结束值必须在同一线上。

    提供结束测量值后，将在地图上该位置处显示一个红点。

13. 或者，可通过执行以下操作之一来指定新的结束测量值：
    • 在结束测量文本框中提供测量值。

      注：

      同样支持定点测量值。

    • 单击测量选取器 ，然后在地图上单击沿路径的测量值。
14. 通过执行以下操作之一指定事件的开始日期：
    • 保留默认的开始日期，即当前日期。
    • 在开始日期文本框中提供开始日期。
    • 单击日历按钮 并选择开始日期。
    • 选中使用路径开始日期复选框。
15. 或者，通过执行以下操作之一指定线事件的结束日期：
    • 在结束日期文本框中提供结束日期。
    • 单击日历按钮 并选择结束日期。
    • 选中使用路径结束日期复选框。

      注：

      如果未提供结束日期，则该事件从路径的开始日期到未来一直有效。

16. 选择数据验证选项以防止通过线事件设置路径特征时使用错误的输入。
    • 合并重合事件 - 当新事件的所有属性值与现有事件完全相同时，如果新事件的测量值与现有事件的测量值相邻或重叠，并且其时间片重合或重叠，则新事件会与现有事件合并，测量值范围相应地扩大。 有关详细信息，请参阅 在 ArcGIS Pipeline Referencing 中合并重合事件场景或在 ArcGIS Roads and Highways 中合并重合事件场景。

      

    • 停用重叠事件 - 创建新的线事件或事件后，现有事件的测量值、开始日期和结束日期将进行调整以防止时间和测量值发生重叠。 有关详细信息，请参阅在 ArcGIS Pipeline Referencing 中停用重叠场景或在 ArcGIS Roads and Highways 中停用重叠场景。

      

17. 如果存在路径并发，则可以向主要路径添加线事件。

    并发路径是共享同一中心线的路径。 这种关系可能存在，以建模具有不同校准方向的两条路径。 在这些并发路径的位置，您可以使用一组规则选择视为主要路径的路径。

    例如，在下图中，存在路径 ID 分别为 100、200 和 300 的三条路径。

    

    路径优先级规则设置为：路径名称越少，则路径优先级越高。 根据此条件，路径 100 是最主要路径，而路径 200 和 300 的优先级顺序相同。

    部分	描述
    1	路径 200 是主要路径，因为在此部分中不存在其他路径；事件将添加到路径 200。
    2	路径 100 的优先级排序较高；事件将添加到路径 100。
    3	路径 200 和路径 300 的优先级相同；事件将添加到您所选择的路径。
    4	路径 200 是主要路径，因为在此部分中不存在其他路径；事件将添加到路径 200。

    了解有关在 Pipeline Referencing 中向主要路径添加线事件的详细信息

    了解有关在 Roads and Highways 中向主要路径添加线事件的详细信息

18. 单击下一步。

    所选线事件图层的属性会出现在另一个窗格中。

19. 为事件图层提供属性值。

    对于多个事件，一个属性集可以包含与不同网络相关的事件。 只出现事件与所选网络相关联。

    对于多个事件，使用事件图层的复选框将它们包括或排除在编辑活动中。 未选择的事件将不会被添加。

    对于多个事件，事件字段是否可见和可编辑取决于属性集的配置。 单个事件的事件配置不适用于添加多个事件。

    您可以使用复制属性工具从现有事件中复制属性。

    

    第一张图是包含 Pipeline Referencing 数据的“添加线事件”微件面板示例。 第二张图像是包含 Roads and Highways 数据的“添加线事件”微件面板示例。

20. 单击保存。

    添加新线事件，并且其显示在地图上后，将在工具面板上显示一条确认消息。

交互选项

您可以使用其他微件中的数据操作来启动添加线事件微件并填充相关数值。 要使用数据操作，源微件件中的网络必须有相关的线事件，源微件中添加线事件的数据操作选项必须打开，添加线事件微件必须在体验中配置。

以下微件支持添加线事件微件的数据操作：

• “LRS 微件”微件 - 数据操作会填充事件或属性集、网络、路径、测量和日期选项。
• “按路径搜索”微件 - 数据操作会填充事件或属性集、网络、路径、测量和日期选项。
• “表”微件 - 数据操作会弹出事件或属性集、网络、路径和日期选项。

注：

您可以在填充后更改任何值。 如果这样做，“添加线事件”微件仍会验证所有条目。

使用“按路径搜索”微件运行数据操作

要通过“按路径搜索”微件在运行时使用数据操作，请完成以下步骤：

1. 在“按路径搜索”结果中选择记录。
2. 单击“按路径搜索”微件面板顶部的操作按钮。
3. 通过执行以下操作之一添加线：
   • 单击添加线事件，在结束测量选项中提供结束测量值和新线事件的属性。

     事件、网络、路径开始 ID 或路径开始名称、开始测量、路径结束 ID 或路径结束名称、开始日期和结束日期参数根据“按路径搜索”微件中选择的路径填充。

   • 如果搜索结果包含一条有两个测量值的路径，单击添加线事件。

     

     事件、网络、路径开始 ID 或路径开始名称、开始测量、结束测量、路径结束 ID 或路径结束名称、开始日期和结束日期参数根据“按路径搜索”微件中选择的路径填充。

   • 如果搜索结果中包含具有单一测量值的路径，请选择（从）添加线事件作为待添加的线事件的开始测量值，或选择添加线事件（至）作为待添加的线事件的终止测量值。

     

     如果选择（从）添加线事件，则会填充开始测量值，您必须提供结束测量值。

     如果选择添加线事件（至），则会填充开始测量值，您必须提供结束测量值。

     事件、网络、路径开始 ID 或路径始于名称、开始测量或结束测量、路径结束 ID 或路径结束名称、开始日期和结束日期参数根据“按路径搜索”微件中选择的路径填充。

注：

您可以在填充后更改任何值。 如果这样做，“添加线事件”微件仍会验证所有条目。

使用“表”微件运行数据操作

要通过“表”微件在运行时使用数据操作，请完成以下步骤：

1. 在“表”微件中选择一条记录。
2. 单击“表”微件面板顶部的操作按钮。
3. 单击添加线事件。

   事件或属性集、网络、路径 ID 或路径名称以及事件 OID 参数会根据从表中选择的事件弹出。

4. 对于非线网络，请选择路径。

   您选择的路径会填充开始路径和结束路径的值。 您需要填充测量值来添加事件。

5. 对于线网络，请选择同一线上的一条或两条路径。

   如果在一个属性集中为一个或多个跨事件选择了两条路径，它们会根据线的顺序填入开始路径和结束路径的值。 必须填充测量值，才能添加事件。

开始日期和结束日期值是使用已搜索路径的开始日期和结束日期填充的，或者如果选择了两条路径，则选择线顺序较低的路径。

注：

您可以在填充后更改任何值。 如果这样做，“添加线事件”微件仍会验证所有条目。

使用“LRS 识别”微件运行数据操作

要通过“LRS 识别”微件在运行时使用数据操作，请完成以下步骤：

1. 使用“LRS 识别”微件在路径上单击特定位置。
2. 单击“LRS 识别”微件面板顶部的操作按钮。
3. 单击添加线事件。

   事件、网络、路径 ID 或路径名称、测量、开始日期和结束日期参数根据“LRS 识别”微件中的路径和位置填充。