MODULE 9: LOGON EXTENSIBILITY SAMPLE AND

HOW-TO
Module Overview
In this module we will learn how to extend POS Logon functionality and support
for using any external device for logon like Biometric devices.

Objectives

Understand how to extend POS Logon functionality.

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement

9-1

Microsoft Dynamics AX 2012 R2 For Retail in Brick and Mortar Stores Development and Customization

Logon Extensibility
This lesson provides brief information about the POS Logon extensibility feature
using some external devices or any other mediums.

Extending Logon by using Biometric devices:

Dynamics AX Retail 2012 R2 POS allows ISVs to use biometric device for logon.
Following interface must be implemented by POS plugin:

FIGURE 9.1: BIOMETRIC DEVICE FOR LOGON INTERFACE

Following the typical sequence for POS logon follow and call into the biometric
plugin

9-2

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement

Module 9: Logon Extensibility Sample and How-To

FIGURE 9.2: SEQUENCE FOR BIOMETRIC PLUGIN

Steps to implement biometric logon:
1.

Implement following interface in a new POS logon plugin assembly.

Microsoft.Dynamics.Retail.Pos.Contracts.Services.IBiometricDevice

2.

Copy the POS plugin and related assemblies to the \Extensibility

directory under your POS directory.

3.

Launch POS

4.

Go to Extended Log on operation and click assign on any staff to

enroll for biometric logon.

The sample provides information on how to extend the logon functionality in POS
to use Biometric devices.

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement

9- 3

Microsoft Dynamics AX 2012 R2 For Retail in Brick and Mortar Stores Development and Customization
Biometric Plugin
The below code provides the abstract for implementing the Biometric plugin. We
can extend this code to implement biometric login in POS.
public sealed class BiometricPlugin : IBiometricDevice
{
public event BiometricDeviceDataEventHandler DataReceived;
public event BiometricDeviceStatusEventHandler StatusUpdate;
public void Load()
{
// Init the biometric device
}
public void Unload()
{
// Cleanup
}
public string DeviceName
{
get { return string.Empty; }
}
public string DeviceDescription
{
get { return string.Empty; }
}
public bool IsActive
{
get { return true; }
}
public void BeginEnrollCapture()
{
// Create worker thread for enroll capture and return
}
public void BeginVerifyCapture()
{
// Create worker thread for verify capture and return
}
public void EndCapture()
{
// close the thread.
}

9-4

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement

Module 9: Logon Extensibility Sample and How-To

public string Identify(IExtendedLogOnInfo captureData,
ICollection<byte[]> candidates)
{
string logOnKey = null;
// Identify the give capture data from given cadidates and
return hash (e.g. MD5 HASH) of found cadidate.
return logOnKey;
}
}

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement

9- 5

Microsoft Dynamics AX 2012 R2 For Retail in Brick and Mortar Stores Development and Customization

Module Review
Module Review and Takeaways

Understand how to extend Log on functionality in POS

Test Your Knowledge

Test your knowledge with the following questions.
1.

9-6

What Services project used for Logon functionality extension?

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement

Module 9: Logon Extensibility Sample and How-To

Test Your Knowledge Solutions

MODEL ANSWER:
1.

LogOn

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement

9- 7

Microsoft Dynamics AX 2012 R2 For Retail in Brick and Mortar Stores Development and Customization

9-8

Microsoft Official Training Materials for Microsoft Dynamics

Your use of this content is subject to your current services agreement