Manual

 

Application settings

Synchronisation interval

On the main screen of Bugzi press your device's menu button to see the options. Tap on the menu item that’s called Settings. Under this option you can set the application's Synchronisation interval in minutes. The default option is 0, that means the application always synchronises data with the Bugzilla server, otherwise the application gets the bug list and project data from the local database, if the given did not expire since the last synchronization.


Setting up a  Synchronisation interval can greatly affect the speed of the application, since the local database is much faster than synchronising with the server!


Of course pressing the refresh button on the top right corner on the bug list screen, always forces a synchronisation from the server if Internet is available ignoring the Synchronisation interval.


Synchronisation interval does not apply for bug details, a bug detail is always synchronised from server if connection is available. Of course you can access the locally stored bug detail if there is no connection and you already visited the bug’s detail screen at least once.



About

You can also find the about section in the Settings. There is information about the application version, your licence status, useful links including the user manual, and contact information.


Please contact us if you have any problem, bug report or feature request. Please note that we can not contact you if you leave a comment in the android market, and it can be very hard to fix a bug if we can not reproduce it ourselfes.


Setting up an account

On the main screen press the menu button and choose Account Management to jump to the account manager screen. Here you can add/modify/delete your bugzilla server settings. To add a new account, tap the plus button on the top right corner. A dialog will appear where you can set your account settings.

  • Description

Description of the server. It's just for you to help to choose between accounts. This name will be shown on the main screen top of the bugs.

  • Server address

Url of the server. Bugzi supports http and https connections too. Do not include index.cgi in server url!

HTTP authentication is supported if you enter the server address in the http://username: This e-mail address is being protected from spambots. You need JavaScript enabled to view it format.

  • Username

Your bugzilla account's username

  • Password

Password of your bugzilla account.

  • Allow not trusted certificate

You can allow, or deny the not trusted https certificates.



Modify an existing account

Tap on the account that you want to modify in the account list. A dialog will appear. Here you can rewrite your account's parts. When you finished, tap on Modify account button to save the changes. After you modify your account, all of your synchronised bugs will be deleted from local database.


Deleting an existing account

Tap on the account that you want to delete in the account list. On the dialog that contains your account data tap on delete account button to remove your account and all of the bug that belonged to that account.


Testing account data

Tap on “Test” button in the add account dialog for check easily the compatibility of Bugzi with your Bugzilla server account. If it has success result then Bugzi will work with it. If you get the message that Bugzi seems not to bee compatible with the given server, double check if you entered the correct server address. If the error still exists, Bugzi may not be compatible with your server, maybe because of version mismatch, or customization issues.

Listing bugs

The application starts with the bug list screen, this is the main screen of Bugzi. The home button in the upper left corner on other screens brings you back here.


There are 5 buttons in the top of the screen:

  • Sort bugs: you can sort bugs in two orders

  • Quick search: you can use it to fast search in bugs

  • Reload: this button reloads the current list from the server

  • Query list: you can select the current query here as discussed later

  • Accounts: you can change between accounts here


After you set up an account, the list of ‘My open bugs’ is loaded by default. There are 3 built in queries:

  • My open bugs: list of bugs with open status and assigned to you

  • Reported by me: list of bugs reported by you

  • By product: list of products


In the Pro version you can also add custom queries, which will appear here.


In the ‘By product’ list tapping a product loads all the bugs for that product.

Tapping a bug brings up the details of that bug.


The summary, icon and some other information of bugs are displayed In the bug list. In landscape orientation mode other information is displayed.


The icon of each bug symbolises its severity, and closed status:

  • blocker: red shield with exclamation mark

  • critical: red shield

  • major: orange shield

  • normal: nothing, just the base icon

  • minor: green shield

  • trivial: grey shield

  • enhancement: green plus

  • closed: a severity icon with a check mark


Every list you load, is stored in the local database, and is available for offline usage.


By pressing the menu button you access the following screens:

  • Settings

  • File new bug

  • Account management

  • Query Management


The Synchronization interval in the settings affects this screen. If you work with long lists, or with a slow Internet connection, setting up a synchronization interval can speed up this screen, but should have a considerable effect in any case.


Quick search

Press the search button on the right corner of the top of the screen to open the quick search dialog. You can search a specific bug by bug id, or a containing text in summary.


Sort bugs

Sorting bugs is available on the main screen when the bugs are listed, to use this function tap the sort icon on the top of the screen. You can set up a primary and a secondary order, both of them can be sorted by descending or ascending.


Viewing bugs

When selecting a bug, the bug detail screen appears. The bug detail screen always synchronises with the server, to make sure you see the most up-to-date state of the bug.

In case you want to reload the bug from the server, tap the refresh button in the upper right corner of the screen.


The bug detail screen is divided into 5 tabs, each of which contain some information on a bug. You can access pages with swiping left and right.


Comments

This tab contains the list of comments of a bug. The first comment is technically the description of the bug.


Attributes

This tab contains the most important attributes of a bug, like the Os, Component, Version, Priority, Platform, Target milestone and Severity. In the Pro edition you can also change these values, and save them with pressing the “Save” button at the top of the screen.


Status

This tab contains information about the assigner and reporter of the bug, and also about the status of the bug. In the Pro edition you can also change these values, and save them with pressing the “Save” button at the top of the screen.


Attachments

This tab lists the files, that are attached to a bug. To download an attachment to your device, tap the desired element in the list.


WorkTime

This tab contains work time information of a bug, like hours worked, hours left, percentage of complete.


Updating Bugs (Pro)

If you want to update one of your bug's details, select a bug from the bug-list. When you are in the bug detail screen, you can change the selected bug's data. The system alert you when you want to leave the bug detail screen without save.


The details, which you can update are on 4 tabs:


Comments

Entering text into the “New comment” text  field at the bottom of the screen, you can also add your comment to the bug. You can enter the comment here, them move to other bugdetail tabs, make more modifications and save them together with the comment


Attributes

You can change the values in this page, and save them by pressing the “Save” button at the top of the screen.


Status

You can change the values in this page, and save them by pressing the “Save” button at the bottom of the screen.


WorkTime

You can change the values in this page, and save them by pressing the “Save” button at the bottom of the screen.



Creating bugs (Pro)

Creating new bugs is available from the menu on the main bug list screen with the “File new bug” button. After a successful bug creation you are redirected to the new bug’s detail screen.


Query management (Pro)

There are 3 built in queries:

  • My open bugs: list of bugs with open status and assigned to you

  • Reported by me: list of bugs reported by you

  • By product: list of products


This 3 queries can not be edited or deleted, but you can create custom queries in the “Query management” screen found in the menu on the main Bug list screen. Created queries are added to the currently selected account, each account has its own list of queries.


Tapping on a previously created query allows to modify it.


Tapping the “+” button in the top right corner on the Query management screen allows creating a new query by bringing up the Query editor screen. A query must have a name, and may have multiple filters. A query without any filters is allowed too, such query will simply load all the bugs.


Tapping the “+” button in the top right corner on the Query editor brings up the filter editor popup.


Each filter has 4 attributes:

  • Filter logic: possible values are AND/OR, this specifies the logical connection between filters in the query, because of this the order of the filters in a query is important

  • Filter field: the field/attribute you want to specify a condition for, available filter types can be different for each filter field

  • Filter type: the logical condition, please note some filter types may allow multiple filter values separated by commas, while others does not allow this

  • Filter value: the value for the filter, in some cases you have to enter it manually, while others allow to select possible values from a list


Please fill the filters attributes in top-down order, because when you change a filter all other attributes below are reseted.


Modifying filters is possible by tapping the filter on the Query editor screen.


Queries can be selected and used on the bug list screen.

Using multiple accounts (Pro)

After you selected the Account management in the Main screen from the menu, you can simply add multiple accounts using the “+” button in the header. The actual account to use can be selected in the main screen using the key icon.

Please note that:
  • each account has its own queries, when you create a custom query it is added to the actually selected account.
  • all locally stored bugs and values are deleted for an account, when it is modified, since we can not tell if they are valid any more. (queries are not deleted)
  • when you delete an account all data in connection with it is deleted from the local database, including its queries