Introduction

My Logs Pro is an application which allows users to categorize information in a log. Users can create any number of logs to track information (e.g. ToDo, Work Activites, Medication, etc..). A log consists of log entries each of which contains a time stamp, log catergory, and log details. Log entries can also be assigned a rating to add additional significance (or priority) to the entry. Furthermore, log entries can be filtered by category, date, and rating in order to show only the entries of interest.


My Logs Pro has the following features not found in My Logs

 App Widget

Main Activities: Place the App Widget on your home screen for quick access to the following activities:

Locked / Unlocked: You can also see if access to your logs is currently locked or unlocked. If a password is set, clicking on the unlocked icon will lock access to your logs. To unlock access to your logs, select any of the quick access menu buttons on the widget and you will be taken to the password activity.

widget_launch_pad.png
App Widget

 Password Access

Your logs can be protected by enabling password protection. When a password is set, to access your logs you will need to enter the saved password.

Set Password: From the List or Calendar view, select the options menu "More" and then select "Settings." From the Settings activity, select "Password" which is found under the "Security" section. This will bring up the "Set Password" dialog. Enter a password and then re-enter it to confirm. Press "OK" when you are ready to save the password. To remove the password, just delete the password and press "OK"

settings_password.png
Password Settings

Lock Access: There are three ways to lock access to your logs

Unlock Access: If a password is set and access to your logs is locked, you will need to enter a password the next time you try to access your logs,

view_password_access.png
Password View

 Views

There are two ways to view your log entries - List view and Calendar view:

view_list_log_entries.png
List View

view_calendar_log_entries.png
Calendar View

For phones with a larger screen size, the log entries for the selected day will be shown below the calendar. Long press on a log entry in the list to show the context menu (Edit, Delete, Duplicate...)

view_calendar_log_entries_xlarge.png
Calendar View
Log Entries on Large Screen

 Category Data

The category data dialog can be accessed from the options menu on the List or Calendar view.

NOTE: Plot Form Data is only available when filtering on a category which uses a form for log entries. The form must contain numeric text entry widgets.

dialog_category_data.png
Stats View
Time Ago

view_category_stats.png
Time Ago

view_category_stats_duration.png
Duration

view_form_data.png
Plot Form Data

Note: The data in the views will depend on the filter settings. If you are interested in the stats over a specific time period (e.g. This Month), use the filter settings to set the Date filter and then view the category data.

 Manage Lists

The navigation drawer menu "Manage" allows you to access and manage your lists:

dialog_manage.png
Manage dialog

 Log ID's

Log entries are associated with a Log ID. To create a Log ID, select the options menu on the main view (Log Entries view) and then select "Log ID List". A list of available Log ID's will be displayed.

The following actions can be performed by long pressing on a Log ID in the list:

dialog_log_entry.png
Log ID dialog

 Log Categories

To view the log categories, select "Catergory List" from the options menu on the Log Entries view. A list of available Log Types will be display. Each Log Type can be expanded to view all associated Log Items.

To add a new Log Type or Log Item, press the Add button. This will bring up a dialog where you can then choose to add a Log Type or a Log Item

The following actions can be performed by long pressing on a Log Item in the list:

view_log_categories.png
Log Cateroies view

 Tags

Tags allow you to create relationships between log categories. You can create as many tags as you like. You assign tags to a log entry when you add or edit a Log Entry. There is also a Tags filter settings allowing you to view log entries with specific tags.

view_tags.png
Tags list view

To add,edit, or delete an existing tag, long press on the tag in the list and select "Add", "Edit", or "Delete" from the context menu

view_tags_context_menu.png
Tags view context menu

 Log Templates

Templates allow you to pre-define the log details for a log entry. It provides a starting point for log entries which are repeated. To add, edit, delete, or view the log templates, select "Catergories" from the options menu on the Log Entries view. A list of available log categories will be display.

To add a template, long press on the log type or log item which you would like to have a template and select "Add Template" from the context menu.

view_categories_context_menu.png
Cateroies view context menu

Enter the template details and press save.

view_templates_entry.png
Template entry dialog

Log types or items which have templates defined will have an icon with a "T" displayed to the right.

view_categories_template_icon.png
Cateroies View
showing teplate icon

To edit or delete a template, long press on the log type or item which already has a template defined and select either "Edit Template" or "Delete Template".

template_edit_delete.png
Cateroies view context menu
when category has template

 Forms

Forms allow you to pre-define the log entry view for log types or items. It provides a starting point for log entries which need a common starting point. To add, edit, delete, or view the log forms, select the "Manage" options menu and then select "Categories". A list of available log categories will be displayed. To add a form, long press on the log type or log item which you would like to have a form and select "Add Form" from the context menu.

view_categories_context_menu.png
Cateroies view context menu

Selecting "Add Form" will start the Form Builder activity. With the form builder, you can create custom log entries consisting of the following widgets:

view_form_builder_widgets.png
Form Builder Widgets


Once a widget is added to the form it can be edited, deleted or moved by long pressing on the widget and selecting from the context menu:

view_form_builder_context_menu.png
Form Builder view
context menu

Below are the three different widget entry dialogs with example entries:

view_form_builder_choice_entry.png
Choice Widget Entry

view_form_builder_text_entry.png
Text Entry

view_form_builder_checkbox_entry.png
CheckBox Entry

Here is an example of a custom form created for logging gas entries:

view_form_builder.png
Custom Log Entry Form
applies to all Gas log items

Once the form is complete, save it by pressing the Save icon. The form will then be availabe when you go to add a log entry...

view_add_log_entry.png
Log Entry view
showing custom form

Note: The form is saved with the log entry. If you update the form at a later time, the newly updated form only applies to new log entries.

 Log Entry

To add an entry to a log, select "Add Log Entry" from the options menu on the Log Entries view. The following settings are available for a log entry:

To add an attachment to the log entry, select one of the following from the options menu:

When finished entering log entry information, click the save icon to save the log entry to the database. Pressing the cancel icon will discard the log entry. Note: the back button also performs a save to the database.

view_add_log_entry.png
Add Log Entry view
showing custom form

Stop Time: to add a stop time to a log select the stop menu icon located on the shortcut menu bar. The log entry view will update to include log stop Date and Time buttons.

view_add_log_entry_stop.png
Add Log Entry view
showing stop time and duration

 Quick & Timed Log Entry

There are two additional ways to enter logs: Quick Log Entry or Timed Log Entry. You can access the Quick/Timed entry view from the menu bar icon located between the add log icon and the filter icon on the List or Calendar view. Once in the Quick/Timed entry view, you can only view one entry mode at a time. You can toggle between the two modes of entry by pressing the Quick Entry/Timed menu bar icon. Toggling between the two modes of entry gives you the ability to add quick log entries while also timing a log.

Note: The list of entry widgets is unique to each type of entry mode. The text displayed in the widget will depend on the preference setting "Widget Display Text". You can either display the Log Type/ Log Item or just the Log Item name.

view_quick_log_entry.png
Quick Log Entry view

view_timed_log_entry.png
Timed Log Entry view
Select entry to be timed

Selecting a timed log entry widget will do the following:


The following actions can be performed while the log entry is being timed:

view_timed_log_entry_running.png
Timed Log Entry view
Entry being timed

 Date and Time Format

My Logs uses the phones system settings for the date & time format. You can change the time and date format by opening the phones system settings (Programs: Settings) and selecting Date & Time.

system_settings_date_time.png
Phone Settings / Date & Time

view_24hr_mmddyyyy.png
Date Format: mm/dd/yyyy
Time Format: 24hr

 Filter Settings

To filter the log entries, select "Filter Settings" from the options menu on the Log Entries view. The log entries are filtered based on the following settings:

view_filter_settings.png
Filter Settings view

 Search

Search allows you to search your log entries for a specified word. The search is case insensitive and searches all the log entry descriptions based on the filter settings. Make sure to set the filter settings to view all log entries if you want to search all your log entries. When Search is enabled, you will see the word you are searching for next to a search icon in the log header. Log entries which contain the search word will be displayed in the view and the word will be highlighted.

dialog_search.png
Search Dialog

view_search_results.png
Search Results

 Export / Import

dialog_export_columns.png
Export columns dialog

dialog_export_duration.png
Export duration dialog

dialog_export.png
Export dialog

dialog_import.png
Import dialog

 Backup / Restore

Your logs entries are stored in a database and the log attachments are organized under the MyLogs folder on the SDcard. It is highly recommended that you backup your database before deleting any log entries and before upgrading to new versions of My Logs. From the List or Calendar view select the "More" menu item. From there you can select the following:

dialog_backup.png
Backup dialog

dialog_restore.png
Restore dialog

 Upgrade from My Logs

If you have already been using My Logs and would like to continue using your log entries in My Logs Pro, you will need to perform the following steps:

NOTE: It is highly recommended that you make a backup copy of your My Logs data before proceeding.

  1. Launch My Logs and select Backup
  2. Launch My Logs Pro and select the Restore option.
  3. From the Restore dialog select MyLogs.db from the drop down.
  4. Verify your log entries (Note: you may need to reset your filter settings to see your logs)
  5. Uninstall My Logs


 New Phone

If you are switching phones and would like to continue using your log entries from your old phone, you will need to copy the MyLogs folder from your old phone to the MyLogs folder of the new phone. The steps are outlined below:

  1. From the old phone select Backup
  2. Connect your old phone to your computer and copy the MyLogs folder to known location on your computer (e.g.Desktop).
  3. From your new phone, select Backup. This will create the MyLogs folder on the SD card of the new phone.
  4. Connect the new phone to your computer and copy the MyLogs folder from your computer to the folder MyLogs of the new phone.
  5. Disconnect the new phone from your computer and select Restore.


 Troubleshooting

  Support

To report issue, defects, crashes, suggestions, or feedback of any type, please send email to:
support@ambitico.com