Verify data and time configuration settings

1. Verify the results of the payment received events

Verify the results of payments received by navigating back in time. Change the time machine controls back to 14:40 on June 1.

The dashboard is still empty. That is because the previous section of the tutorial did not specify that you still need to change the timestamp of your Payment Received events.

In a standard business cycle, an instance is created then closed like in the image below. A first event creates the instance in your solution, then some time later, another event arrives and closes the instance.

Currently, the timestamps the create and close event are set to the same time, as shown in the diagram below. This means your instance has a lifespan of zero seconds, and can't be seen from the dashboard. For example, in your test data, the purchase order with a CycleNumber of 16040022 is both created then ended in Decision Insight 14:24:14.  

Important: While developing in Decision Insight, when you have errors in the data within your solution, sometimes the best answer is to erase all data instances and start over. Two options are available:

  1. A separate guide to truncating applications explains how to erase data instances. You can navigate to that guide now, follow the instructions, and start the tutorial back from part 1 again. Remember to fix the data for Payment Received before running that route.
  2. Alternatively, re-run the New Order route, fix the data in the second resource, and then re-run the Payment Received route, which is explained here. 

2. Correct the data, re-run the routes

Caution: Because Decision Insight is developed as an agile product, if you are not using the recommended release, it always possible that the behavior of the software might be different. If you do not get the expected results when following the procedure below, use the first solution, that is truncate the applications, and start the tutorial back from the very beginning.

 Modify the data in your resource

Start by modifying the data for the Payment Received resource.

Step

Action

1

On the main menu, click Data Integration.

2

On the left menu, click Resources > the resPaymentReceived resource.

3

Edit the timestamps for the first three purchase orders.

  • Add one hour to the first one.
  • Add two hours to the second one.
  • Add three hours to the third one.
  • Delete the fourth event.
Your data should now look like this:
Timestamp|CustomerName|CustomerReference|CycleNumber
2016-12-01T15:24:14|Utensil Systems|9558RQ|16040022
2016-12-01T16:36:38|Springbok Space | ORDN051|16040023
2016-12-01T17:49:02|Triangle Technologies|1711|16040024
4

Click Save.


Re-run the routes

Next, run your routes again:

Step

Action

1

On the left menu, click Routes.

2

Click the play icon next to the rouNewOrder route to run the route again.

3

Go back to the dashboard. Click the Home icon on the main menu, then the thumbnail for your search dashboard.

4

Check that the data displayed matches your expectations.

5 On the main menu, click Data integration > Routes .
6

Click the play icon next to the rouPaymentReceived route to run the route again. Don't forget the manual injection part.

7 Click the Logs icon for the route and check that they look as expected.
8

Go back to the dashboard. Click All dashboards on the main menu, then the thumbnail for your search dashboard.

Because your Time Machine is set to 14:40, you should see the two instances that exist at that time.

The begin / close times of the instances of Order should look something like in the diagram below.

Test Data Timeline

9 Adjust the Time Machine so all four orders are displayed in your dashboard.


Experiment with the results

Case 1: Set the Time Machine to 17:12. This corresponds to a time where the first two purchase orders are completed, but the other two are still active. The Selected Orders pagelet in your dashboard displays two active orders, both for Triangle Technologies.

Case 2: Set the Time Machine to 16:37. This corresponds to the time one minute after the payment for the 16040023 order is received. 

Even though that order is complete since 16:34:18, it is still displayed  as active in the Selected Order pagelet at 16.35:

The reason why the pagelet is not refreshed immediately is all due to the rhythm of your time machine.

The current rhythm of your application is 5 minutes. That means the data is refreshed every 5 minutes, not instantaneously. There is no data visible between 16:35:00 and 16:39:59. To see the conclusion of Purchase Order 16040022, which Decision Insight received at 16:36:28, set your time machine no earlier than 16:40:00. The purchase order is no longer displayed in the selected orders pagelet.

Your current dashboard only displays purchase orders that are being processed. To make your dashboard display completed orders, examine time settings in more details.

3. Examine time settings

Time machine observation modes

Time instant observation mode

A closer look: The time machine

When looking at the information on your dashboard, you have been looking at the data at time machine instant. This is a little bit like looking at exactly one page out a book without looking at the previous or the next page. Whenever you talk about an instant in Decision Insight, it means the absolute thinnest slice of time you can imagine. It is a split-second, frozen mid-stride.

When you navigate into the past with the time machine using the default settings, you still have that same time machine instant view. In other words, you are looking at a particular past instant in time as if it were now. This enables you to replay past events exactly as they happened.

Over interval observation mode

The over interval observation mode enables you to look at data and how it evolves over a set range of time.


The width of that interval, the begin time and the end time are all tied directly to the rhythms defined in your application. For example, if the rhythm of your application is 5 minutes, you must pick begin and end times which are a multiple of 5 minutes. This means your interval will also be a multiple of 5 minutes.

When you select the over interval option for a pagelet in edit mode, some additional settings become available. The current option enables you to specify using a length of time, for example, five minutes, over which you want to see your data. That length of time starts at the current time that matches the selected rhythm of the application.

For example, if your application rhythm is 5 minutes, and you start the over interval observation mode at 4.43pm, which is not a multiple of 5 minutes, then the current over interval time extends into the future and goes from 4.40pm till 4.45pm.

This feature can be useful if the rhythm of your application is set to 1 day. Selecting the 1-day interval allows you to show progress so far in the current day. The width of the selected time interval stretches forward with the current time, giving you a consistent view of the day.

Select an observation mode

You can select a data observation mode from your dashboard.

Step

Action

1

In the context of your dashboard, at the right-hand side of the screen, click the Actions icon > Edit. The dashboard is displayed in edit mode.

2 Click the pencil icon of the Selected Orders pagelet.
3

In the Time Range area, for the observation mode, you can choose between two options:

  • at instant
  • over interval

Note:No need to change the default observation mode at this point of the tutorial.


The best way to understand how different time selections and operations function is to experiment with them. One important tip to keep in mind:

Whenever possible, use an abundance of caution. Before you experiment with a working dashboard or pagelet, create a clone of that dashboard or pagelet before conducting your experiment.

4. Clone a pagelet

The safest way to investigate the behavior of a pagelet is to clone the pagelet and then edit the clone. You can always delete the cloned pagelet if your modifications fail. For this task, start with the assumption that you will successfully display information about closed purchase orders and that you will be able to use the current day as the interval.

Step

Action

1

In the context of your dashboard, at the right-hand side of the screen, click the Actions icon > Edit. The dashboard is displayed in edit mode.

2

Mouse over the title bar for the Selected Orders pagelet. On the right-hand side of that pagelet, click the Split vertically icon.

3

This is a good time to adjust the size of your pagelets. Mouse over the divider just above the title bar of the Selected Orders pagelet. When a double-headed arrow appears, you can:

  • Click and drag the top of the pagelet up, or
  • Click, then release the mouse. A sizing control pop-up window is displayed. Click anywhere in the pop-up to prevent it from fading, and set each section to 33%.
4 Click the Click here to configure the pagelet hyperlink in your new pagelet.
5 In the Enter title here text box, give a name to your pagelet. For example, Orders Closed Today.
6 Click the Clone pagelet component. A list of the existing dashboards in your deployment is displayed.
7 Click Search for Orders under Dashboard.
8 Click the Selected Orders pagelet, which lists your purchase orders details.
9 Click Done.Your new pagelet is now an exact clone of the Selected Orders pagelet. Now, you have a safe place to experiment with time.

Once you've finished, you can move on to the next step.

Related Links