This tutorial takes about 30 minutes and is intended for all users of Ketura. It covers:
This tutorial can be followed with or without the example database, but you need to be logged on as a user who has work journal entries. If you are using the example database, ensure that you are logged on as Eric Samet, a partner at XYZ (the fictional firm used for the example database). Eric’s log on user id is ‘es’, and the password for his account is the same as the password for the ‘admin’ account that was provided during the installation of the Ketura server. If you are currently logged on as another user, use the Log Off link in the top-right corner of the page to return to the log on page.
Because you interact with Ketura using a web browser, finding your way around is very similar to navigating a typical website. A few points are worth noting:
Don’t use your browser's Back button with Ketura, unless explicitly instructed to do so. Using the Back button can be confusing as you can end up viewing out-of-date pages and forms with old data. Whenever possible, use Ketura
navigation features such as the navigation trail at the top of each page, the Recent pages list in the sidebar and the global navigation tabs.
Most modern web browsers enable you to open several pages at once, in different tabs. It is typically possible to open a new link in a tab, for example, by holding down the Ctrl key (on Windows) or Apple key (on a Mac) while clicking the link. This is an especially valuable technique when working with Ketura, enabling you to work quickly back-and-forth with multiple items.
Tables are used in Ketura to display various information and to allow actions to be performed on items listed.
A table is split into several pages if it contains too many items. You can move between pages, or to the first or last page,
by using the navigation buttons (>, <, |< and >|) that appear above the table. The number of the page currently being viewed is shown to the right of the navigation buttons,
together with the total number of pages in the table.
If the table contains fewer than about 1,500 rows, it is usually possible to show all the rows at once, instead of in pages.
Some tables have additional filter controls above them. These are used to show only a subset of available items. One common set of filter controls is that used to show
only those items relevant to a particular period of time.
Select the Work journal tab.
Then, either
Select one of the time periods (Today, Yesterday, This month, etc).
After the page has refreshed, notice that only those work journal entries for the chosen period are shown.
Or
The items in many tables can be sorted by clicking on one of the column headings. The columns by which you can sort have the column heading shown as a link (indicated in most web browsers by blue or purple text). The column by which the table is currently sorted has an arrow immediately after the column heading. Clicking the column heading for a second time will reverse the sort order.
An up arrow by the column name indicates that the table items are sorted in ascending order; a down arrow indicates sorting
in descending order.
Tables sometimes have selection checkboxes in the right-most column. When a checkbox is checked, the corresponding table row is highlighted with a blue background. Checking the checkbox in the selection column’s heading selects all the rows in the table.
One or more buttons might be shown below a table, making it possible to perform actions upon the table. An action button that requires a selection to be made will be enabled only once you have selected at least one row in the table. Some buttons, however, are always enabled. For example, the New Entry button on the work journal table is always enabled as this action is independent of selecting items in the work journal.
Some tables are used purely to show information. Others, however, contain entry fields that, as well as showing the current value of an item, make it possible for that value to be altered. The work journal on the Home Page is an example of such a table; it makes it possible to update multiple work journal entries at a time.
Once you have made changes to information shown in a table, you would typically click the Apply button beneath the table to save your changes. Depending on which table you are using, different buttons might be shown.
The buttons underneath a table might sometimes be disabled, meaning that it is not presently possible to perform the related action. Nothing will happen if you click on a disabled button. Buttons can be disabled for a number of reasons:
To enable easy transfer of information from Ketura to other applications, Ketura offers the facility to save table data in xml or csv format files. In the first row of most tables on the right-hand side are two links named XML and CSV. Clicking on either of these links will download the table data in the appropriate format.
If you have an application installed on your computer that can understand the data being downloaded (for example, Microsoft Excel, which can open csv files), your browser will probably ask whether you want to open the file you are downloading in that application. This makes it extremely easy, for example, to view a table’s data in Microsoft Excel, simply by clicking the CSV link and telling the browser to open the downloaded file with Excel.
Ketura presents some information as a form. One example of a form is the Details tab of an issue page (shown in the screenshot to the right).
As well as presenting information, forms often make it possible for that information to be updated. Forms, therefore, typically consist of one or more controls (such as entry fields and drop-down list boxes), with a row of buttons at the bottom. Which buttons are present will depend on the form, but most forms have an Apply button, which saves any changes you have made, and also a Reset button, which abandons the changes you have made but not yet applied.
Form buttons can be disabled for a number of reasons:
