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 operation that has 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, which 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 at the 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 add more operations 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 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 the operation <PUT OPERATION NAME HERE>

   <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>