Open Tracked Times

The List of Open Tracked Data contains all Tracked Times where no Accounting Report exists. As soon as you completed an Accounting Period all corresponding Data will be moved to History. While you have started the next Time-Tracking without finishing it’s not visible in the List of Open Times, but the HomePage will show you how long it’s already running.

The List

Open List of Open Tracked Times from TabbedPane:

Here’s the List grouped by days and sorted by Timestamp:

If there’s no ‘Add Data‘ Action you have no permission to insert data manually (Application Menu Settings Permissions) – opening this list from History ActionBar will also look different. Action ‘Summary Open‘ will show a chart diagram of all entries from this list. (see below). Action ‘Reporting‘ will directly jump to Accounting to create a new Accounting Report.

Dimmed Rows

Data already transmitted to server are dimmed and read-only.

List Menu

Here’s the complete Menu:

You also have access to Charts per Week or Month (see below) or jump directly to History.

List Charts

Summary All Open

Directly from ActionBar Action ‘Summary Open‘ will tell you how many hours are tracked since last Accounting Report.

Charts can be summarized per legal/other, paid/unpaid or per Category:

…per Month

Sums per Month (from Overflow Menu):

Sums start with newest month and you can go back and forth. (Previous / Next Actions)

To see older sums from History: there’s a quickl-jump Action in Overflow Menu:

… per Week

Sums per Week (from Overflow Menu)

Sums start with newest week and you can go back and forth. (Previous / Next Actions)

… per Day

Sums per Day (from List Header Rows)

List is grouped by Day and ech Group Header gives you access to sums of this specific day: simply click on the Chart Icon:

 

Time Data Row in detail

Tapping on a List Row you’ll get a Page with all the details:

The content on this Page can be very different – it depends on Time Category, Device (Touch-Only or Keyboard) and Orientation (Portrait/Landscape). Chapter ‘UX Highligths‘ will explain in more detail.

On Top of Page there’s a Segmented TitleBar with up to 4 Segments:

1. Category (Overview)
2. Details
3. Time
4. Geo

Toggeling between these Segments is easy: Tap on a Title, use the Action from Overflow Menu, use the Navigation-Icons on Bottom of Page or Keyboard Shortcuts.

First Segment Category is also a Overview Page: you see from available Images what kind of data is there, tapping on a Image will go directly to corresponding Segment etc. If there’s a signed Customer Report: toggle ON and get the Report. If you have the Permission to modify Data you can change Values – even the Category can be changed using the Toggle.

Here’s a sample of Details Segment:

Sample of Time Stamps:

and here a sample of Geo Data:

Data Menu

This is the full Menu:

 

• Tracked Data (Overview)
• Transmitted Times
• History

 

Transmitted or Queued Data

To see the current state of transmitted data to Server, select the Tab from tabbedPane:

Running the Personal Edition ?

There’s nothing to transmit yet:

Running the Group Edition ?

TBD

Running the Enterprise Edition ?

Content of this Page depends on the way how you’re synchronizing your transmitted data: manually, every day, every week, …

The Upload Page tells you about the last sync done and next one scheduled.

Starting with Enterprise Edition your first steps probably will be to try it  out for FREE: there’s a 30 Day Test Account available from CoMo Solution.

To make it simple and easy to understand and follow the workflow using the Test Account you have to start transmission of tracked data manually.

Here’s the Upload Page for Test Accounts:

There’s a DropDown to select the Date: all Open Tracked Data including the selected Date will be transmitted to Server. While doing your first tests it could make sense to switch Logging ON – this will give you a short protocol what happened. We’ll take a look on this later.

The ActionBar provides 3 ActionItems:

• Network gives you some informations on Network State
• Send Now will select all open records until selected Date and send to the Server
• Admin opens the Browser and gives you access to TimeTracker Server Web Portal. Attention: you need username / password credentials !

Info on Network State opens a Dialog:

Please take a look at the TitleBar: the Icons also tell you about Network State. More info on Dynamic TitleBars here.

Tapping on “Send Now” Action will

1. select the data from open records
2. add data to the Queue
3. mark data as transmitted

From List of Open Tracked Data you can see which data already was transmitted: transmitted rows are ‘dimmed‘

You can take a look at the Queue tapping on the Tab:

The ‘Queue‘ tab is only visible if you’re using the Enterprise Edition !

Normaly TimeTracker will transmit the data faster then switching to the Queue Tab, so it’s OK if there’s nothing inside the Queue:

It’s always a good idea to try out what happens if there’s no internet connection. Easiest way to test: Set your Device to ‘Airplane Mode‘ , switch ‘Logging‘ ON and Tap on ‘Send Now‘

Watch the TitleBar: No Network, No Internet

We got a Toast telling us that 3 Records are transmitted and immediately we got a Logging entry: ‘Cannot transmit to Server’

Looking at the List of Open Tracked Data you’ll see: all are dimmed – all is marked as transmitted:

In reality the data was not sent to the Server because of missing network connection. Now there’s an entry in your Queue:

The Queue can contain different kind of data: ‘Tracked Data’ as seen above, Signature Files, Customer Reports, Accounting Reports. There are different Icons to see what kind of Data is waiting for transmission. All Actions trying to access your server will go into the Queue and sent to server step-by-step if network connection comes back. (FIFO – First-In-First-Out)

Tapping on a row opens a details Page:

Server Action describes the type of data.

Messages: an Array of Server Messages: in this case telling you that there’s no connection. There could be other cases where you get HTTP Status Errors or so if something is wrong from Server. TimeTracker then will try again after 500 ms if there’s an Internet Connection.

JSON Data contains the Payload. You can do a long-press, select all and copy and send via email to your Admin.

Hint: In Test Mode this is always possible – otherwise there’s a property in settings if this is allowed or not – so maybe the Payload is invisible for users.

Below the Payload there’s the Creation Timestamp and your Device PIN, userID and Transmission UUID.

Switch ‘Airplane Mode’ OFF and automagically the entry disappears from Queue and Logging shows success:

Tap on ‘Admin‘ to Open the TimeTracker Server. (You need Username/Password)

Here are the 3 transmitted records:

You can tap on a row to see the Details. This is the ‘User’ Details View – there’s also a special ‘Admin’ Details View where you can see and edit all properties.

Besides the TimeLog properties you’ll see Contact info (if a Contact was selected from your Device) and also all Geo Locations with Coordinates and Address from Reverse Geocoding. From GeoCoding DropDown you can select a specific location – this one will be marked green inside the embedded Map.

You can also see the Locations on a large fullscreen map:

Normally you will use the Server Webportal from your Desktop or Laptop, but I integrated the direct access into TimeTracker to enable this while you’re on-the-road. More Info on the Server Webportal can be found here (TBD)

To open the Browser from inside TimeTracker I’m using the Cascades Invokation Framework as usual. (See also chapter ‘Deep Integration‘)

Here’s the ActionItem (QML Code)

ActionItem {
    title: qsTr("Admin")
    imageSource: "asset:///images/server.png"
    ActionBar.placement: ActionBarPlacement.OnBar
    onTriggered: {
        app.invokeBrowser(REST.serverUrl() + "/TimeTrackerAdmin/")
    }
}

We’re asking the Server Class (C++ – mapped as ‘REST’) for the serverUrl from settings, then calling the method to invoke the Browser (C++)

void ApplicationUI::invokeBrowser(const QString& uri) {
    InvokeRequest request;
    request.setUri(uri);
    request.setTarget("sys.browser");
    request.setAction("bb.action.OPEN");
    mInvokeManager->invoke(request);
}

Have Fun with TimeTracker Enterprise Edition and TimeTracker Server by CoMo.

• Tracked Data (Overview)
• Open Tracked Times
• History

History

In ApplicationMenu Accounting you can specify how many months should be stored in local History. A maximum of 12 months is allowed.

From TabbedPane tap on History Tab:

Next Page shows you only months where History exists – in this sample for January, February and March:

Tap on a Month from History or use the corresponding ActionItem from Overflow Menu (three dots) and you’ll see exactly your Accounting Report:

Of course the Report now is read-only, but you can send the Report again via Mail.

Also from ActionBar you have access to the details: all tracked data:

This List of History Data is similar to the List of Open Tracked Data:

Please notice the only difference:the ActionBar is missing all Actions.

Tapping on a row you’ll see the Details – also similar to Details from List of Open Data:

Only difference again the ActionBar: from History it’s read-only so there’s only a Back Action and no Cancel / Save.

Hint: you cannot set ActionItems to invisible, you have to remove them:

You can remove all ActionItems:

//
trackedListPage.removeAllActions()
//

or you can remove single ActionItems:

if (! monitorTime.isAddTrackingPermitted()) {
    trackedListPage.removeAction(addDataAction)
}

 

From History Page you can also take a look at Monthly Charts:

Using Previous and Next Actions you can get Charts from all Months in History.

There’s another Action to show the sums for Categories:

Here’s the same Page in Landscape:

There’s a chapter about Layouting if Orientation changes here.

• Tracked Data (Overview)
• Open Tracked Times
• Transmitted Times