Retrieving Device Details

WSO2 EMM stores and maintains the details of the registered devices. The registered devices communicate with WSO2 EMM to retrieve the list of operations that are queued up at the server and when getting the list of pending operations that needs to be executed on the device, the device shares the device information and the details of the operations that have been executed on the device, with the server.

Configuring WSO2 EMM to retrieve device details

To achieve this, a task needs to run in the background of the WSO2 EMM server. This taks will add operations to the devices, such as device_info, device_location and application_list. You need to configure WSO2 EMM to get this task running in the back ground as mentioned below:

1. Open the cdm-config.xml that is in the <EMM_HOME>/repository/conf directory.
2. Configure the fields under the <TaskConfiguration> tag.
   • Enable: Assign true as the value to get the task running on the WSO2 EMM server background.
   • Frequency: Define the frequency, at which the server should receive the details of the devices registered with WSO2 EMM.

   • Operations: Defines the Operations such as, device_info, device_location and application_list.

     If you wish to define more operations when retrieving the details of the devices, you can ad them under the operations tag.

   • Operation: The field used to define each operation for the task.
   • Name: The operation code. For example, the operation code to retrieve the device information is device_info.
   • RecurrentTimes: Define how often the operation should be added to the task. 
     Example: If you define the value as 5, it indicates that you need to add the operation at every 5th run of the task.
   Sample Configuration

   <TaskConfiguration>
      <Enable>true</Enable>
      <Frequency>30000</Frequency>
      <Operations>
         <Operation>
            <Name>DEVICE_INFO</Name>
            <RecurrentTimes>1</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>APPLICATION_LIST</Name>
            <RecurrentTimes>5</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>DEVICE_LOCATION</Name>
            <RecurrentTimes>1</RecurrentTimes>
         </Operation>
      </Operations>
   </TaskConfiguration>

    Click here for more information on adding an additional operation

   Add a new operation within the <operations> tag. 

   <TaskConfiguration>
      <Enable>true</Enable>
      <Frequency>30000</Frequency>
      <Operations>
         <Operation>
            <Name>{Define the operation code}</Name>
            <RecurrentTimes>{Integer}</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>DEVICE_INFO</Name>
            <RecurrentTimes>1</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>APPLICATION_LIST</Name>
            <RecurrentTimes>5</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>DEVICE_LOCATION</Name>
            <RecurrentTimes>1</RecurrentTimes>
         </Operation>
      </Operations>
   </TaskConfiguration>

   Example: Adding an operation to get the device temperature.

   <TaskConfiguration>
      <Enable>true</Enable>
      <Frequency>30000</Frequency>
      <Operations>
         <Operation>
            <Name>DEVICE_TEMPERATURE</Name>
            <RecurrentTimes>3</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>DEVICE_INFO</Name>
            <RecurrentTimes>1</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>APPLICATION_LIST</Name>
            <RecurrentTimes>5</RecurrentTimes>
         </Operation>
         <Operation>
            <Name>DEVICE_LOCATION</Name>
            <RecurrentTimes>1</RecurrentTimes>
         </Operation>
      </Operations>
   </TaskConfiguration>