getBarcodeValue (Client API reference)

Applies to Dynamics 365 for Customer Engagement apps version 9.x

Invokes the device camera to scan the barcode information, such as a product number.

Syntax

Xrm.Device.getBarcodeValue().then(successCallback, errorCallback)

Parameters

Parameter Name Type Required Description
successCallback Function Yes A function to call when the barcode value is returned as a String.
errorCallback Function Yes A function to call when the operation fails. An error object with the message property (String) will be passed that describes the error details.

Return Value

On success, returns a string containing the scanned barcode value.

Remarks

This method is supported only for the mobile clients.

Example

Xrm.Device.getBarcodeValue().then(
    function success(result) {
        Xrm.Navigation.openAlertDialog({ text: "Barcode value: " + result });
    },
    function (error) {
        Xrm.Navigation.openAlertDialog( {text: error.message} );
    }
);

Xrm.Device