Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This view also provides the actions required to initiate editing and the tools required to perform the spatial edit operations.

Client panel buttons

name

description

Create

Insert a new entity.
Will be disabled if editing is in progress.

Update

Change the currently selected entity.
Will be disabled if no entity is selected or if there is more than one entity selected or editing is in progress.

Delete

Remove the currently selected entity.
Will be disabled if no entity is selected or if there is more than one entity selected or editing is in progress.

Reset

Reset the form fields back to their original values.
Will be disabled if editing is not in progress.

Submit

Complete the edit process and save the current changes.
Will be disabled when editing isn't in process or if the current state isn't value, for example if a polygon geometry is required but hasn't been added yet.

Cancel

Abort the edit process and abandon the current changes.
Will be disabled when editing isn't in process.

Modify

Modify an existing geometry.
Will be disabled if there is no geometry attached to the entity.

Point

Create a new point.
Will be disabled if the entity doesn't support point geometry or if it only supports a single point and there already is a point attached to the entity.

Line

Create a new line.
Will be disabled if the entity doesn't support line geometry or if it only supports a single point and there already is a line attached to the entity.

Polygon

Create a new polygon.
Will be disabled if the entity doesn't support polygon geometry or if it only supports a single polygon and there already is a polygon attached to the entity.

Remove

Remove the currently selected geometry.
Will be disabled if there is no geometry enabled or if the entity requires some geometry and this is the last piece of geometry related to the entity.

Snap

Toggle the snapping function on and off.

Settings

Changes the snapping settings.

Customising the client edit view

...

Unless explicitly set the types of geometry that a user can create for an entity, and also if the user can create an entity with no geometry, is defined by the underlying spatial tables, if you wish to override this then you do so with the supportedGeometry and requiredGeometry settings.

Both supportedGeometry and requiredGeometry can be listed multiple times , if more that one geometry type is supported/required, and the possible values for both of these are:

  • point
  • multipoint
  • linestring
  • multilinestring
  • polygon
  • multipolygon
Note

Specifying the single part and multi part options of the same geometry type is treated the same as just specifying the multi part option. That is <requireGeometry>polygon</requireGeometry> and <requireGeometry>multipolygon</requireGeometry> is the same as just <requireGeometry>multipolygon</requireGeometry>

Some examples of why you would want to set these values are (these assume that you can't change the underlying spatial table):

  • Spatial table allows nil geometry but you wish to enforce geometry creation
    • Add <requireGeometry>geometryType</requireGeometry> where geometryType matches the underlying spatial table
  • Spatial table allows multi part geometry but you wish to enforce creation of single part geometry
    • Add <supportGeometry>geometryType</supportGeometry> where geometryType matches the underlying spatial table
  • The spatial engine supports multiple geometry types in a single table, for example Oracle Spatial, and you wish to limit the geometry
    • Add <supportedGeometry>geometryType</supportedGeometry> to limit the available geometry types, otherwise options all will be available

...