Editing

This section explains how to configure the edit function in c2cgeoportal.

Just like most administrative tasks, setting up editing in a c2cgeoportal application involves intervening in the database, through the c2cgeoportal administration interface.

Requirements

To be editable, a layer should satisfy the following requirements:

  1. It should be accessible with WMS, and correctly configured in the mapfile. See Mapfile configuration.

  2. Its data should be in a PostGIS table, which should be in the application database. The PostGIS table can be in a separate schema though, which is in fact recommended.

  3. The PostGIS table should include a primary key with a sequence associated. The name of the primary key attribute must be id. Example:

    db=# \d table;
                         Table "public.table"
        Column   |      Type   |                              Modifiers
    -------------+-------------+----------------------------------------------------------
     id          | integer     | not null default nextval('public.table_id_seq'::regclass)
    
  4. The PostGIS table should include one geometry column only. You will get errors if the table has multiple geometry columns.

  5. The following geometry types are fully supported: POINT, LINESTRING, POLYGON. The following geometry types are partially supported: MULTIPOINT, MULTILINESTRING, MULTIPOLYGON.

  6. If the PostGIS table has a many-to-one relationship to another table, (typically a dictionary table) there are additional requirements:

    • The name of the foreign key column should end with _id (e.g. type_id). This is not strictly required, but recommended.
    • The relationship’s target table should have two columns, a primary key column and a text column. The text column must be named name.

Adding or making layers editable

The application’s layers are defined in the layer table, which is managed by selecting the Layers item in the admin interface’s menu.

For a layer to be editable its geoTable field should be set. This field is the name of the PostGIS table containing the layer’s geographic data. It is a string of the form [<schemaname>.]<tablename>. If schemaname is omitted, the table is assumed to be in the public schema. The label corresponding to this field is Related Postgres table in the admin interface.

The geoTable field supports named formatting and can get values from the environment variables, for example:

[<schemaname>_{some-named-variable}.]<tablename>

with “some-named-variable” defined in the environment.

Support for other database sessions has also been implemented:

[<database-session-name>.[<schemaname>.]]<tablename>

See Using multiple databases.

Warning

Only layers embedded in a layergroup are detected as editable.

Warning

It is recommended to limit the editing to 30 editable layers per user.

Configuring security

Editing the features of a layer implies to write changes in the database. To make sure that only authorized users may edit a feature, editable layers (including public layers) must be linked to a restriction area, used itself to specify the roles of authorized users.

The restriction area should have its readwrite field set to true in the administration interface.

Binding restriction areas and layers together can be done from the Layer objects in the admin interface. Likewise for binding from the Restriction areas.

Edit views

To be able to edit PostgreSQL views a primary key must be manually configured. Add a layer metadata geotablePrimaryKey with value the name of the column to use as primary key. That column must be of type Integer.

Example: geotablePrimaryKey: id

Enable snapping

To be able to snap while editing, the snappingConfig must be set on the layer metadata. The value is a json object containing the following optional properties:

  • edge (boolean): whether to allow snapping on edges or not;
  • vertex (boolean): whether to allow snapping on vertices or not;
  • tolerance (number): the pixel tolerance.