Working with History

Geogig is a specialized database that was designed for distributed editing and supports collaborative editing of geospatial data. It is designed for vector data (point, line, polygon, etc.). When a layer has been stored in Geogig, it maintains the history of all of the changes made to the data along with who made the changes and when. Within the web map, you can view the history for a layer and for the features.

History tab in Geoshape

Geogig layers in Geoshape will have a Geogig tab in addition to the other tabs on the Layer detail page. This shows a history of commits that have been made to the layer.

  1. In the Layer detail page, click on the Geogig tab to see the chronological list of commits.

    _images/en_geoshapegeogigtab.png

    Layer Geogig tab in Geoshape

View layer history

You can also view the history of a layer stored in Geogig when the layer has been added to a map.

  1. Click on the name of the layer you want to view. The menu will expand to show additional layer options.

  2. Click on the Show History button. The history will expand at the bottom.

    _images/en_showhistorybutton.png

    Show History Button for Layers

  3. To view details about a commit, hover the mouse over it. The bar next to the commit indicates the type of edits that were made. Green indicates a new feature was added. Yellow indicates a feature was modified. Red indicates a feature was deleted. A commit can have multiple types of edits. In such a case, the bar will have colors proportional to the types of edits that were made.

    _images/en_layerhistory.png

    History detail for a commit

  4. Click on the commit and the history will update to show the individual edits within that commit. MapLoom will make one commit per edit. The Arbiter mobile app can upload many edits as one commit.

    _images/en_commitlist.png

    List of edits in a commit

  5. Clicking on an edit will bring up a new window that shows the specific changes that were made. The changes will be highlighted with the same color coding as the commits. Green means something was added, yellow means it was changed, and red means it was deleted. In the image below, the feature was moved, and so the point on the map is highlighted in yellow.

    _images/en_featurechange.png

    Detailed view of changes

View feature history

In addition to viewing the history of edits on a Geogig layer, you can also view the history of a feature.

  1. Click on the feature on the map. The feature details will appear.

  2. Click on the Show History button. The history list will expand with the commits that contain changes for that feature.

    _images/en_featurehistorybutton.png

    Show History for a feature

  3. Click on the specific commit you want to view details for. The history will update to show the edits made to the feature for that commit.

    _images/en_commitlist.png

    List of edits in a commit

  4. Clicking on the edit in the list will bring up a new window that shows the specific changes that were made. The changes will be highlighted with the same color coding as the commits. Green means something was added, yellow means it was changed, and red means it was deleted. In the image below, the feature was moved, and so the point on the map is highlighted in yellow.

    _images/en_featurechange.png

    Detailed view of changes

  5. Click on the Show Authors button to see the names and dates for every attribute in the feature. Note that through the lifetime of a feature, there can be several authors. This is a good way to see who has contributed to a feature’s current state.

    _images/en_showauthors.png

    The Show Authors button

Summarize history

You can visualize a summary of all of the edits within a date range for a layer.

  1. Click on the Show History button for layer that you want to summarize.

    _images/en_showhistorybutton.png

    Show History Button for Layers

  2. Click on the History Summary button.

    _images/en_historysummarybutton.png

    History Summary button

  3. Enter the date range for the history to summarize

    _images/en_selectdaterange.png

    Select the Date Range

  4. Click on the Summarize button

    _images/en_summaryofchanges.png

    Summary of changes for the selected date range

  5. Click on one of the edits in the list to see a detailed view

Export history

You can export a summary of all of the edits within a date range for a layer.

  1. Click on the Show History button for layer that you want to summarize.

    _images/en_showhistorybutton.png

    Show History Button for Layers

  2. Click on the History Summary button.

    _images/en_historysummarybutton.png

    History Summary button

  3. Enter the date range for the history to summarize

    _images/en_selectdaterange.png

    Select the Date Range

  4. Click on the Export CSV button

  5. When you are prompted to save the file, browse to the location where you want to save it to your computer and click Ok