Objective

This document explains the procedure to add a customized QR code within the Invite User email template that is sent to users as a part of the ZENworks mobile enrollment process. By including a customized QR code, you can share a public or private app with users. Users only need to scan the QR code to download the app on their mobile devices.

Prerequisites

Prior to including the QR code in the Invite User email, you need to ensure that the following prerequisites are met:

• ZENworks 2017 Update 2 or a newer version is installed in the Management Zone.

• An SMTP server is configured.

• An MDM server is configured.

• A User Source is added and the Mobile Enrollment policy is assigned to the user to whom the invite has to be sent.

• The email client on the user's device has access to the MDM server or the third-party web service to obtain the QR code.

Procedure

To include the QR code in the Invite User email:

1. Log into ZENworks Control Center (ZCC).

• In the left pane, click Configuration > Event and Messaging > Email Notifications > Invite Users.

• From Languages drop down, choose the language in which the email should be sent.

• Copy the body of the email template into an HTML Editor or Notepad .

• Embed a QR code in the invite user template. This can be achieved by either:
  
  
  
  • Generating the QR code image and placing it within the ZENworks Webapp.
  
  
• Obtaining the QR code from a third-party webservice.

• After adding the QR code, copy the content and overwrite the existing email template content in ZCC.

• Save the email template.

Generating the QR code image and placing it within the ZENworks Webapp:

1. Create a new folder (folder name should not include spaces) in the following location, in all the MDM Servers in your zone, to place the QR code image:
   
   Windows: C:\Program Files (x86)\Novell\ZENworks\share\tomcat\webapps
   
   Linux: /opt/novell/zenworks/share/tomcat/webapps
   
   In this example, 'qrcode' is the folder name we have created.
   
   
   
   

   Note: You need to have the following ownership and permissions to access the new folder: On the Windows server: read permission. On the Linux server: the same ownership and permissions as that of the other folders in the location. To ensure that the relevant permissions are in place, after editing the email template, you can send a test mail and validate whether the QR code image has downloaded on the email client. Also, we recommend that you take a back-up of the newly created folder as this folder will be deleted after a system update. You can place the backed-up folder back in the same location after the system update process is completed.

   
   
   
   
   

• Use any third party tool or online service to create a QR code image and download it onto your device. For example, you can download the QR code image from http://www.qr-code-generator.com/.
  
• Place the downloaded QR code image in the 'qrcode' folder on all the MDM Servers.
  
• Copy and paste the following content, which you had earlier copied to an HTML editor or Notepad , in the Invite User email template:
  
  <img src="https://$HOSTNAME$/qrcode/<img name>.png" alt="Get it from MDM server" width="150" height="150" />
  
  
• Replace the highlighted content with the QR code image name. For example: <img src="https://$HOSTNAME$/qrcode/iprintqrcode.png".
  
  

  Example of a modified invite user email template:

  
  
  

  
  <tr>
  <td colspan="2">
  <p><strong>To Install Micro Focus iPrint application:</strong>
  <br/>Download the Micro Focus iPrint application OR scan the QR code from your mobile device.
  </p>
  </td>
  </tr>
  <tr>
  <td><a target="_blank" class="btn" href="https://play.google.com/store/apps/details?id=com.novell.iprint.android">Install iPrint</a></td>
  <td><img src="https://$HOSTNAME$/qrcode/iprintqrcode.jpg" alt="Get it on MDM server" width="150" height="150" />
  </td>
  </tr>
  

  
  
  

Obtaining the QR code from a third-party webservice:

1. Obtain the QR code from any third-party service that provides QR codes. For example: https://api.qrserver.com/v1/create-qr-code/?data.

• Add the following content in the invite user email template that you had earlier copied to an HTML editor or in Notepad :
  
  

  <img id='barcode' src= https://api.qrserver.com/v1/create-qr-code/?data=<app URL> " &amp;size=100x100"
  alt=""
  width="150"
  height="150"/>
  

  
  
  

• Replace the highlighted content with the URL of the app. For example:
  
  src= https://api.qrserver.com/v1/create-qr-code/?data= https://play.google.com/store/apps/details?id=com.novell.iprint.android"
  
  

  Example of a modified Invite User email template:

  
  
  
  

  
  <tr>
  <td colspan="2">
  <p><strong>To Install Micro Focus iPrint application:</strong>
  <br/>Download the Micro Focus iPrint application OR scan the QR code from your mobile device.
  </p>
  </td>
  </tr>
  <tr>
  <td><a target="_blank" class="btn" href="https://play.google.com/store/apps/details?id=com.novell.iprint.android">Install iPrint</a></td>
  <td><img id='barcode' src="https://api.qrserver.com/v1/create-qr-code/?data=https://play.google.com/store/apps/details?id=com.novell.iprint.android&amp;size=100x100"
  alt=""
  width="150"
  height="150"/>
  </td>
  </tr>
  
  

  
  

Previewing the edited email notification

1. In the left pane, in ZCC, click Users and select a User Source.

• Select a user folder or user.

• Click Actions > Invite Users.