Work with your route

Now that your route is created, you can start it and investigate to check whether it is working as expected or not.

1. Start the Order route

You have created the data file, defined the mapping, and completed the route for the Order entity. The only thing left to do is run the route.

Step

Action

1

From the Application Data Integration screen, click Routes under Transformations in the left menu. Your Order route is displayed in the Route pane.

2

To start the route, click the play icon under Actions.

 

 Once you run a route, the following happens:

  • Under States, the route state updates from Stopped to Started.
  • Under Actions, the play icon becomes a stop icon.
  • Under Actions, a new icon (page with arrow pointing upwards) is available.

2. Investigate the route execution

While your route is running, follow these steps to see if it is running properly.

Step

Action

1

Under Actions, click the See associated logs icon. The Logs screen is displayed.

By default, the Logs screen first displays only the errors logs. So, if the screen does not contain any logs, it means there were no errors running the route.

Note: In real-life conditions, if you have a route that continuously pushes data into the application (and so continuously produces logs), it is recommended to stop the route before seeing the logs.

2

Look at the information logs. Check the Info checkbox. A list of logs about the route you just ran should be displayed.

 

 

In all of your log entries, you specified that you wanted to log the body of the message. However, the scope of the body changes over time. Let's investigate. The logs display the most recent entry at the top. You have is 6 entries. The one at the bottom (highlighted in the image above) is from the log entry right after the from tag in your route. Click that line in the top part of the pane. The results are displayed in the bottom panel:

In this case, the body of the message is the entire content of the resource.

Now click the log above it. In this case, the body is shown after the tags. What changed in the log of the body?

Click the log summary at the top. This will be the last of the log commands inside the tags. 

If you do not see entries or the log content does not look correct, you need to go back and debug your route

3. Verify the results of the Order route

Tip: Verify, verify, verify

Even when the logs appear to show success, it is a good practice to check the results for anyone working with data and Decision Insight. Always verify that the data you think was ingested actually entered the deployment in the way you thought it did. 

There are at least two ways to verify the results of your route:

  • From the Entities screen.
  • Using the Decision Insight Explore feature.

To verify the results of the order route from the Entities screen, on the Main menu, click the cog icon > Model & configuration. In the left menu, click Entities.

Your screen should look like this (or something similar):

The last time you viewed this screen for the tutorial, the number live instances was zero. Now, it should be four. To see all the details about any instances, click the grid icon to the left of the count of live instances. The level of details provided there is exhaustive enough for this tutorial. As long as the number of live instances is 4, you are on the right track.

 To verify the results of the order route via the Explore feature, follow these steps:

Step

Action

1

Click the Explore icon from the left menu. The Explore screen is displayed.

2

From the list of entities, click Order. Decision Insight prompts you to select the attributes you defined for the entity.

3

Click CycleNumber. You should see the numbers for your orders.

4

If the numbers look correct, click CustomerName > CustomerReference. The customer names and customer references that were defined in the resource data are displayed.

If the names look correct and match the intended cycle numbers, the verification is successful.

Tip : Use Explore to create a dashboard

You can use the information displayed in the Explore screen to create a simple dashboard. You will see how to do that in the next section.

You can now move on to the next step.

Related Links