GreaseMunky User Guide

Editing Entries

Editing a record in GreaseMunky works similarly regardless of the record being edited. It is intended to be as simple as possible and to make it easier to edit the data without cluttering the display. Since we apply this editing paradigm across all the editors in the GreaseMunky, it makes sense to describe the editing process in a general way.

Editor Pages

To edit a record, you will select the entry to be edited from a list of available records in the associated log. When you select a record, you will navigate to a page which displays each field in the record. This page is called the editor page. The editor page for the trip log looks like this:

Trip Editor Page

No editing is actually performed directly on this page. More on how to change the data in the next section. There are two buttons in the navigation bar:

Edit Buttons

If you click the Cancel button, all changes will be discarded and you will be returned to the previous page. If you select Save, all changes will be recorded, and you will return to previous page.

Sometimes you will want to delete a record. There is a Delete button at the bottom of each editor (except the vehicle editor, these entries are deleted directly from the listing on the Rides page). Select this button, then you will be presented with a dialog to confirm the deletion. If you confirm it, the record will be deleted, and will not be recoverable.

Field Editors

Fields with related data or related data types are typically displayed in single table row in the editor page. When you select a row in the editor page, you will be presented with another page where you can actually change the value or values in that row. We will call these pages field editor pages. Date editing occurs on it's own page, but quite often editable text fields are clustered on the same page to improve efficiency. When you click any text field in a field editor page, the familiar keyboard will be presented. If the field includes a decimal point, the decimal will be available from the button in the lower left of the keypad.

Here is an example of a field editor for a fuel log entries text data:

Field Editor

This field editor has three numeric fields, cost, mileage and gallons. When this editor first comes up, the keyboard is not displayed, when you select any one of these fields, the keyboard appears. You can then select any of the other fields to change their values as well. To save any changes, select the Done button on the right of the navigation bar. If you want to discard any changes you have made, use the navigation button on the left side of the navigation bar.

Bad Data

Sometimes the data you enter may conflict with other data already entered. For example, imagine that you had entered a repair that occurred on Oct 17th, and the odometer recorded for that entry was 24,345 miles. If on a later date, you then tried to specify an odometer reading for the same vehicle that was less than 24,345, it would contradict the previous entry. In such cases, the user is presented with an alert indicating the problem:

Bad Date Alert

As you can see, there are two buttons in this alert. As you would expect, the Cancel button will cancel the save operation, taking you back to the editor so you can correct the problem. If you select Continue, you will record the operation regardless of the error, and you will be returned to the previous page. Also, notice the message in this alert. This message should provide sufficient information to identify the record that this entry conflicts with. This may be useful sin the event the other record is the one in error, and not this one.