Map Edit

LRM Web supports map editing functionality and a number of Spatial Bizrules.    

Spatial Edit Assistant - Split

This tool will allow the user to split the selected feature(s) into 2 features. Each of the selected feature(s) will be updated with newly assigned geometry and the second one will be created as a new feature. While splitting the feature the user can copy the “Attributes”, “Activities”, and “Inventory” from the selected feature (original feature).

The “Spatial Edit split Tool” allows you to split a feature’s geometry by Line, Polygon, Shapefile, and Feature layer.

Split button Assistant will open a menu to select a desired option to split one or more stands.

For selecting the feature, select a feature from the tree view and then use the “select by rectangle” tool to select more features.

Once you click on the “select by rectangle tool”, the system will ask you to draw a rectangle to select feature(s).

Note: To execute the split function, the current feature should be included in the selected feature.

I. Click on the “Split by Line” button to activate the spatial split by line tool.

Click on the ‘Continue’ button and application will prompt a message to draw a line across the selected feature.

Draw a line across the current selected feature(s). On double click drawing will be completed.

II. Click on the “Split by Polygon” button to activate the spatial split by line tool.

Click on the ‘Continue’ button and Application will prompt a message to draw a polygon on the selected feature(s).

Draw a polygon across the current selected feature(s). On double click drawing will be completed.

III. Click on the “Split by shapefile” button to activate the spatial split by line tool. This tool will allow you to split the selected features by the shapefile. 

Once you click on the “Split by Shapefile”, the application will open another prompt where the user needs to select the shapefile.zip file.  Click on the ‘Continue’ button to start the process.

If the shapefile features intersect the selected stand features then application will proceed with split operation, else application will prompt the message “no intersecting feature”.

IV. Click on the “Split by Feature layer” button to activate the spatial split by line tool. This tool will allow you to split the selected features by the feature layer. 

Click on the ‘Continue’ button to start the process. Then a window will open with intercepting features with the selected stand feature.

If the feature layer’s features intersect the selected stand features then application will proceed with split operation, else application will prompt the message “no intersecting feature”.

Once you choose your desired split operation, the application will proceed with split operation and opens a spatial editor where you can manipulate the feature segments and save them.

The “Spatial Edit Assistant - Split” window will pop up on the screen once the drawing is completed.

‘Split Options’ like Buffer and Explode can be used to refine the operation:

A buffer can be created around the drawn geometry (e.i. Line and Polygon only). Also the multipart polygon can be exploded into individual segments. The Unit of measurement (UoM) will be auto filled as per the user settings.

Example of Buffer and Explode: 

Select a multipart polygon.  by using ‘select by rectangle tool’.

Select any ‘split by line sketched on the map’ option, check the checkbox for Buffer and Explode.

Draw a line across the feature. The spatial edit wizard will open with 5 segments.

The shape can be assigned to the segments to complete the split process.

In the Popup, based on the cut geometry (drawn line, polygone, shapefile and feature layer) there are 2 segments for each selected feature that will represent the selected feature and split operation. Left side of the popup will show the tabular representation of the split operation and the right side will show the graphical representation of the selected feature that is going to be split.

In Tabular representation - There are 3 tables. Shape Segment, Shape Assignment, and Tabular details.

• Shape Segment - this table will show the segments of the selected feature that is going to be split. The users can see the shape of the segments by clicking on the segments. 

• Shape Assignment - this table will show the originally selected feature. The user can assign segment shape to the original selected that will be updated with new shape.

• Tabular Details - this table will show the out of the user selection and the split operation will be executed on the details mentioned in this table.  

Select shape from the Shape segment table and assign the original feature. The original feature will be updated with the assigned shape. Example:- select the desired shape from the left table and click on the “Assign” or ”Auto Assign” or ”Add New” button. 

Once assignment is done both the table (shape segment and Tabular Details) will be updated as shown in the image above. (Follow the steps as show in the image)

Now, click on the second shape from the shape segment table and click on the “Add New” button. This feature will be created as a new feature and the respective tables will be updated. The user can see the selected segment on the map as well.

Users can change the name of the shape by clicking on the name in the Tabular Details table. New name will be updated instantly in the “shape segment” table and check the Activities and Inventory checkboxes if the user wants to copy the activities and inventories.

Once the assignment is completed all the buttons will be disabled  and new assignments will be updated in the “Tabular Details” table. Users can un-assign the shape by clicking on the “Unassign” button. Users can also copy the activities from the originally selected feature.

Now, the data is ready to execute the split operation. Click on the “Save Edit” button.

Once the “Save Edit” button is clicked. The Spatial Edit Assistant - Split popup will close and the selected feature will be split into 2 features as per the users selections.

Spatial Edit Assistant - Merge

The “Spatial Edit Merge Tool” allows you to merge 2 features’ geometries and can keep the child activities.

Click on the button to activate the spatial Merge.

Application will prompt a message to draw a rectangle to find out the feature to be merged.

Draw a rectangle as shown in the image below. 

The “Spatial Edit Assistant - Merge” window will pop up on the screen once the drawing is completed.

In the Popup, based on the drawn rectangle geometry, there are 2 sections that will represent the selected feature and the feature to be merged. Left side of the popup will show the tabular representation of the Merge operation and the right side will show the graphical representation of the selected features that are going to be Merged.

In Tabular representation - There are 3 tables. Shape Segment, Shape Assignment, and Tabular details.

• Shape Segment - this table will show the list of the features that are going to be merged. The users can see the shape segments on the map view by clicking on the segments. 

• Shape Assignment - this table will show the selected feature and the features that are going to be merged. The user can assign segment shape to either of the features.

• Tabular Details - this table will show the out of the user selection and the merge operation will be executed on the details mentioned in this table.  

Select shape from the Shape segment table and assign the original feature. The original feature will be updated with the assigned shape. Example:- select the desired shape from the left table and click on the “Assign” button. 

In the above example, the feature 123456 will be updated with the merged geometry of feature 1122. After Merge, feature 1122 will be deleted and all the activities will be copied to feature 123456.

Click on the “Save Edit ” button to execute the Merge operation.

Once the “Save Edit” button is clicked. The Spatial Edit Assistant - Merge popup window will close and the selected feature will be merged.

Edit Feature Widget

To edit a feature, select the feature on the tree view.  Click "Edit Feature" on the Edit toolbar to open the Edit Feature widget. 

Select a tree view item before you click "Edit Feature". When the Edit Feature Widget opens, the map will automatically set the active tree view item as the current edit feature by starting an update workflow on it. 

If you have not selected a tree view item before you click "Edit Feature", the map will display a reminder message.

When you click “Edit Feature”, the active tree view item will automatically be set as the current edit feature.  That is, the widget will enter the “Edit Feature” mode while the map selects the feature for editing.  Drag vertices or anchor points to reshape the feature and click “Update”. Attributes are not editable. The Tree View will select the corresponding node when a map feature has been updated.

Note: If the context of the current feature has subscribed to LOCK_GIS, the map will not start editing on the current feature but will simply open the Editor Widget with a warning. 

If you want to edit another feature, you can select it on the tree view.  If the selected feature is in the same context as the previous one, the widget will be kept on (there is an exception if the context has subscribed to the NO_CASCADE_DELETE BizRule). If it is from another context, the widget will be closed so that it can later be refreshed and customized for the new context, e.g. to enforce particular bizrules and to allow adding particular features.  

The widget will show the display name of the current edit feature.  Edit the shape on the map, as needed.  After you have finished editing the shape, click “Update” on the widget to update the feature.   If you do not want to update the feature, click the “<” arrow (top left corner) and click “Discard edits”.

To delete a feature, select the feature and click “Delete”. On the “Delete this feature?” prompt, click “Delete” again.  Please note that cascade delete is not supported in this release, i.e. deleting a feature will not automatically delete its children records.  After a feature is deleted, the tree view will select its parent node.

Add Feature

To add a feature, select a feature on the tree view.  Click "Add Feature" on the Edit toolbar to open the Add Feature widget.  Add feature can be enabled from Group Node selected.

Follow the instructions on the widget. “Add Feature” is context-sensitive. If the active item does not have relevant child contexts for adding features, the widget will ask you to digitize the feature (“Place feature”).  Otherwise, it will display a layer list which includes the layer of the current feature and its direct child(ren) layers.  Click the layer on which you want to add a feature. 

When you see the “Place feature” pane, digitize a shape on the map.  Double-click on a final vertex to end digitizing.  When done digitizing, click “Add” to add the feature.

If you do not want to add the feature, click the “<” arrow (top left corner) and click “Discard feature”.

The Tree View will select the corresponding node when a map feature has been added.  The shape will not be added until you click “Add”. 

The Default Values (configured in the TFM_SYS_FIELDINFO table) will be set in the added feature. 

If you insert a record on the Data View for a spatial context, the new record will have no shape. Please use the Sketch Widget and Link Feature Tool to digitize a shape and link it to the new record.

If you insert a feature beyond the layer extent, the feature may disappear after you click “Add”.  For example, if you create a feature in Mississippi, USA, while the layer has a Finland spatial reference, the feature will fail to draw after being added.  The same will happen if the feature is created via the Link Feature tool.

When the map view is visible, you can insert New map features from the tree node and launch the Add Feature Widget.  This will allow you to add records and map features through a map view workflow.

Create Multipart feature

NOTE: Add multipart feature can be created with LRM 5.6.0 and later.

If you want to create multipart feature, open Add Feature widget draw a polygon.  

1. Open Add feature widget by clicking on . Or from Edit tool bar 

2. Draw a polygon for the context you have selected.

3. Press the “shift key” to activate the draw tool. Once you click the shift button the application will prompt you.

4. Cursor will change to ‘+’ to indicate that draw tool is activated and you can create additional polygons. You will have to press the shift key for each additional polygon.

5. Double click to complete the drawing. Once the drawing is completed then press the “ADD” button to create a multipart polygon.

6. You can press the “Escape” button to deactivate the drawing tool. Application will prompt the user.

Sketch Widget

Click the "Show Sketch Widget" button to open the Sketch widget which allows you to create and update graphics on the map.

After clicking "Show Sketch Widget", the button label will change to "Hide Sketch Widget" which closes (hides) the widget.  You can draw graphics on the “Temp Graphics Layer” in the current map session.  These graphics will not persist in the next map session.  You can print/export the graphics with your map using the Print button. 

Also, Undo and Redo buttons are available.

Add Shape

The “Add Shape” button can be used for adding a shape to existing spatial context. For Example:- select a spatial context front he tree view and click on the  and select “Add Shape”. The application will open the map view and activate the sketch tool. On double click  application will save the drawn geometry as a new shape.

Note:- The “Add Shape” button will disabled if the selected records already has a shape.

Link Feature Tool

The “Link Feature Tool” links a shape to a feature.  You can link a shape from the Temp Graphics Layer or from any managed layer as indicated in “Link Layer”. 

The feature will be updated / linked with the shape you click on the Link Layer.  For a tabular record that does not have a shape, use this tool to create a shape for it.  If you have clicked on an irrelevant graphic (e.g. link a polyline graphic to a polygon feature), a warning will appear.

When the Link Feature tool is ready to link, it shows a "pointer" cursor when you hover over features on the selected Link Layer.  There is one exception - If the Sketch widget is opened on top of the LInk Feature tool, the cursor will be overridden by the widget which shows crosshair for sketching a graphic.

Link multiple geometries

NOTE: Multiple features can be linked with LRM 5.6.0 and later.

To link multiple geometries to the selected feature. Open the link tool and press “Shift Key '' then click on the feature (Temp Graphic or shapefile feature) to link. You will have to press the shift key for every additional feature. 

Reshape Tool

The Reshape Tool allows you to reshape a feature by calling the Reshape function in ESRI’s Geometry Service.  You will need to specify the Geometry Server as defined in the Administering Maps section under Settings in AppSettings.json.

Split Geometry Tool

The “Split Geometry Tool” allows you to split a feature geometry and keep one part as the geometry of the current feature.

Draw a line to split the feature along the line and click on the part you want to keep.  This tool modifies only the geometry / shape of the feature but not modifying the attributes.

The parts not selected (red hatched area below) will be kept on the Temp Graphics Layer for later use, e.g. link with other features.  Note that the unselected parts do not persist in later map sessions. 

Merge Geometries Tool

The “Merge Geometries Tool” allows you to merge the geometries of the selected features. 

Click the tool and draw a rectangle to select the features which geometries you want to merge.  This tool will merge the shapes of the selected features to become the shape of the current feature.  It will not delete the features being merged nor will it modify the attributes of the participating features.

Map Edit Tips

The following section contains some advanced map editing tips. 

Feature Editing

After selecting a feature for editing, click on a square node on the extent to show the vertices.  Or, hover over the shape boundary until the hand appears and click to show the vertices.

To move a vertex, hover over the vertex until the hand icon appears. Click (and hold briefly) on the vertex and drag.  If the hand icon does not appear when you hover over the vertex, please try 

Clear the selection by clicking “Viewing Tools \ Clear Selection”.  

Turn other layers invisible.

When you drag a vertex, sometimes it will move the whole feature.  To undo a vertex edit, press “Z”.  To redo a vertex, press “R”. To discard the edits on a feature, click “<” (Back) and “Discard Edits”.

Below are some useful shortcuts extracted from the “Read more” section in this link: 

Edit Privileges

The Editor Widget honors your insert, update and delete privileges on the contexts, configured in the Security module in LRM.  “Edit Feature” and “Add Feature” list only the layers which you have update privileges and insert privileges respectively.  

LOCK_GIS Bizrule

If a context has subscribed to the LOCK_GIS bizrule, the Editor Widget will not list its layer for “Edit Feature” and “Add Feature”.  Please take note of a particular situation when the current context (e.g. “County”) is not editable due to the LOCK_GIS bizrule while its child context (e.g. “Tract”) is still editable.  If you select a County on the tree view and Start Editing, “Add Feature” still allows you to digitize (“Place feature”).  This may lead you to think that you are digitizing a County. After you finish digitizing, you will notice that it is actually a Tract.  This happens because the Editor Widget does not indicate the current edit layer if there is only one layer eligible for adding features (This could be improved in future releases to avoid confusion).

LOCK_INSERT Bizrule

If a context has subscribed to the LOCK_INSERT bizrule, the Editor Widget will not list its layer for “Add Feature”.  Please take note of a particular situation when the current context (e.g. “County”) is not insertable due to the LOCK_INSERT bizrule while its child context (e.g. “Tract”) is still editable.  If you select a County on the tree view and Start Editing, “Add Feature” still allows you to digitize (“Place feature”).  This may lead you to think that you are digitizing a County. After you finish digitizing, you will notice that it is actually a Tract.  This happens because the Editor Widget does not indicate the current edit layer if there is only one layer eligible for adding features (This could be improved in future releases to avoid confusion).

LOCK_DELETE Bizrule

If a context has subscribed to the LOCK_DELETE bizrule, the Editor Widget will hide the “Delete Feature”.  

NO_CASCADE_DELETE Bizrule

If a context has subscribed to the NO_CASCADE_DELETE bizrule and if the feature has child records, the Editor Widget will disable the “Delete” option.  The widget will show only the Update button but not “Delete” on the “Edit Feature” pane.  For example, a feature from a context subscribed to the NO_CASCADE_DELETE bizrule with child records will inform you of the rule violation, while a context that does not subscribe to that bizrule will prompt for an action.  Please note that cascade delete is not supported on the Map View, i.e. deleting a feature on the map will not automatically delete its children records.

Note: For a context that has subscribed to the NO_CASCADE_DELETE bizrule, the Editor Widget will refresh itself for each feature you select on the tree view, even though the features selected come from the same context. This ensures that the widget will display “Delete” only for features that do not have child records.

Spatial BizRules

The ‘NO_PEER_OVERLAP’, ‘NO_OVERLAP’, ‘POLYGON_CONTAINED_BY’, ‘POLYGON_COVERED’ Spatial BizRules are supported in the web map, with certain limitations (as described below).  Similar to the Desktop Map View, if an edit has violated one of these rules, a dialog will appear.  If the subscription has a “WARN” severity, you can click the “Ignore and Save” button to proceed with saving the edit.  Clicking the “Close” button will abort the edit on the feature.   

For example, if you modify a Tract to the shape outlined in red and “Update”, the spatial validation will inform you of the violation one by one where you can select “Close” (to cancel the edit) or “Ignore and Save” to save or continue to the next violation. 

The layers participating in the Spatial Bizrules are expected to exist in managedLayerURL, managedReadOnlyLayer or geoprocessingLayerURL. 

Limitations on Spatial Bizrules: 

1. For the ‘NO_OVERLAP’ rule, OVERLAPCRITERIA1, PARENTFIELD1, PARENTFIELD2, PARENTOPERATOR in TFM_SYS_BIZRULE_NOOVERLAP table are not supported.

2. For the ‘POLYGON_COVERED’ rule, the COVEREDBYIDS field is expected to contain one context Id only, whereas the Desktop Map View allows a comma-delimited list of context Ids in this configuration field. 

3. For the ‘POLYGON_CONTAINED’ and  ‘POLYGON_COVERED’ rules, if the participating contexts are related, the web map expects them to be a direct parent-child relationship, whereas the Desktop Map View supports a broader ancestor-descendant relationship.  (The participating contexts can be unrelated, though.)

This matrix lists the major Spatial BizRules and indicates whether they have been implemented in the LRM Web.

Spatial Overlay

Spatial Overlay is supported with limitations.  The existing configurations in the TFM_SYS_BIZSPATIALOVERLAY and TFM_SYS_BIZSPATIALOVLACTION are honored, but you have to specify overlay layers for the web map in the new TFM_SYS_BIZSPATIALOVERLAY_WEB table.   For each overlay to be run on the web map, insert a row in this new table and specify the overlay layer with the layer title (e.g. “Stand”) as it is published in the GeoprocessingLayerURL. (This is different from the Desktop Map View where you specify the overlay layer with the .lyr file path.)  The overlay layers will NOT be shown on the web map but loaded in memory only. 

The Spatial Overlay on the web map does not have the full implementation as in the Desktop Map View, but the following has been implemented:

1. Target context which could be the same or different from the source context

2. OverlayLayer – If an overlay layer is specified, an overlay will be run between the subject feature and the overlay layer. If no overlay layer is specified, the subject feature will be taken to run the overlay actions.

3. Most SpatialRelationships 

4. Action – “UPDATE”

5. Cardinality - “ONE” or “MANY”

6. Overlay Action (a) Some SourceValue functions (b) SourceValue functions (e.g. “=ACRES()” and “=AREA()”) honoring ProportionalByArea (c) SourceValue as a text string, i.e. “2016” (d) SourceValue as an attribute from the overlapped feature, e.g. “OBJECTID”

7. Overlay Order

The following has not been implemented:

1. Target context which is the ancestor (as opposed to being the parent) of the source context. 

2. Source / Target criteria.

3. Actions other than “UPDATE”, i.e. “REPLACE”, “APPEND”

4. Route-event related SpatialRelationship - ‘INTERSECTEVENT’

5. Spatial Attribute Calculation

6. Spatial Administration dialog or Batch Spatial Operation

This matrix references the columns in TFM_SYS_BIZSPATIALOV* tables and summarizes the implementation.

* If you have configured a MAPCONTROLXML() SourceValue function and you see an 'Invalid untrusted Html content detected in field’ error when saving overlay results, please uncheck “Filter web content” after publishing the map.  See Publish Map in ArcGIS Pro below. 

Snapping

The web map supports snapping (starting from LRM 4.7.0) on the Edit Feature, Add Feature and Sketch widgets. You can snap your sketch to the features on the managed and base layers. Snapping is turned off by default. Turn on snapping in the user's setting when you need it.  When you edit a feature or sketch, you can toggle snapping on/off by pressing and holding down the CTRL key. If the widget is active on the map while you navigate on the tree view, the map will respond much slower than expected due to the snapping functionality. In this case, you may want to close the widget before you continue the navigation on the tree view.