Using Templates

This section explains how to generate artifacts representing different scenarios based on previously created templates using the Template Manager dashboard.

Prerequisites

Before you try out this scenario, a template should be created as described in Configuring a Template for Template Manager.

Using the template

Follow the procedure below to use the previously created SensorDataAnalysis template in different scenarios.

1. Start WSO2 DAS by issuing one of the following commands:

   • For Linux: sh wso2 server.sh
   • For Windows: wso2server.bat

   This is available for DAS 3.1.0 only as a WUM update and is effective from 27th April 2017 (2017-04-27). For more information on updating WSO2 DAS, see Updating WSO2 Products.

   If you are starting DAS for the first time after making an edit to the template, include the DoverwriteTemplateManager parameter in the start command as shown below.

   • For Linux: sh wso2 server.sh -DoverwriteTemplateManager=true
   • For Windows: wso2server.bat -DoverwriteTemplateManager=true

   The DoverwriteTemplateManager parameter applies the changes you have made to the template.

2. Log in to the management console using the following URL.
    https://<DAS_HOST>:<DAS_PORT/carbon/
3. Click Main, and then click Template Manager under the Manage menu. The following dashboard home page appears with the available domains as shown below.
   
4. Select the relevant domain to configure the defined template (in this example it is SensorDataAnalysis). This opens the Deployed Scenarios page.
5. Click Create New Scenario to add a new scenario to the selected domain. This opens the Edit Scenario page.
   

   1. Enter values in the Edit Scenario page as follows.

      Field	Value
      Scenario Type	SensorAnalytics This is the template created by following the instructions in Configuring a Template for Template Manager.
      Scenario Name	SensorAnalytics
      Description	Calculate maximum and average temperature values.

      Enter values for the configurable parameters as shown below. 

      Configurable Parameters	Value
      Time(Mins)	1
      Sensor Type Name	temperature

6. Click Add Scenario. A pop-up message appears to inform you that the configuration is successfully saved. Close this message. The scenario you configured is displayed in the Deployed Scenarios page as follows.
   
   You can edit or delete this scenario by clicking the relevant link under Actions.

   In this example, the scenario gets deployed at this stage because no stream mapping is configured in the default SensorAnalytics template used. If you have configured stream mapping for your template, you are redirected to the Stream Mapping page when you click Add Scenario. Select an appropriate predefined stream from the list for the Mapped From: Stream Name field. This expands the page to display the Attribute Mapping section as demonstrated below. Map attributes as required and click Save Mapping.

   

   Once this configuration is successfully completed, the artifacts included in the template are deployed in WSO2 DAS. You can view the event flow for the template artifacts by logging into the WSO2 DAS Management Console, and clicking Main ∫=> Flow where it is displayed as follows.
   

7. In the WSO2 DAS Management Console, click Main and then click Analytics Dashboard to open the Analytics Dashboard. Log in with your credentials. The dashboard named analytics-temperature-dashboard that is included in the template used in this example is displayed as follows.
    
8. To simulate data in order to view statistics in the analytics-temperature-dashboard dashboard, do the following. For more information, see Sending Multiple Events Using a CSV File.
   
   1. Download the events.csv file from here and save it in a preferred location
   2. In the WSO2 DAS Management Console, click Tools and then click Event Simulator to open the Event Stream Simulator page.
   3. Click Choose File, and browse for the events.csv file you downloaded in sub step a. Then click Upload to upload the file. Click OK in the message that appears to confirm that the file is uploaded, and refresh the page.

   4. Click Configure for the events.csv file to open the Event Mapping Configuration dialog box. Enter the following values in this dialog box.

      Parameter	Value
      Select the target event stream	org.wso2.event.temperature.stream:1.0.0
      Field delimiter	,

      Click Configure and then click OK to close the message that appears to confirm that the configuration is successful.

   5. Click Play to simulate the event flow.
   
   
9. Once you simulate the events, access the Analytics Dashboard and mentioned in step 6, and then click View on the analytics-temperature-dashboard dashboard. Data published to the dashboard is displayed as shown below.