Sage X3 Mobile Automation

Prerequisites

To configure Sage X3 Mobile Automation, you need to install Sage X3 Services. For further information, consult the Sage X3 Installation documentation.

Configure Mobile Automation

Navigate to the handheld application

Open the handheld page: https://loginUrl/handheld/

Example: https://syracuseserver:8124/handheld/

Resize the handheld application on a PC

Note: This section is relevant only if you open the handheld application on a PC.

You need to size the screen correctly to replicate a width between 3.5 and 6 inches.

  1. In your Chrome browser, go to Customize and control Google Chrome > Install Sage X3.
  2. A confirmation window pops up. Click Install.
  3. The following screen displays.
  4. You can resize the window manually to a size similar to the one of a portable device.
  5. A shortcut has been created on your desktop.

Chrome is the recommended browser for Sage X3 Services because the web view embedded in the web application uses Chrome for scanning and the camera.

Chrome is the only browser that works well if you use a scanner. You can use other browsers such as Edge for demo purposes as long as you do not use the scanner since it is not supported outside of Chrome (Settings and more > Applications > Install the site).

Portable devices configuration

Note: Sage does not provide the devices.

The required operating system is Android version ≥ 8.0.

Screen size:

  • Handheld scanners: 3 to 4 inches
  • Rugged mobiles embedding a scanner: 4 to 6.4 inches

Scanner: 2D image scanning decoding both 2D (QR code, Datamatrix simple code) and 1D (barcode) codes. The browser required to connect to Sage X3 Services is Chrome version ≥ 45.

Types of codes

Type of code Symbology Handheld scanner Smartphone

1D barcode - linear code (1 level)

  • EAN/UPC

  • Code 128

  • Code 39

  • Code 93

 Example of 1D linear barcode

2D barcode:

  • QR code

 Example of 2D QR barcode *

2D barcode:

  • Datamatrix code

 Example of 2D Datamatrix code *

1D barcode - stacked (2 levels)

  • GS1 Databar

 Example of 1D 2 GS1 Databar (2 levels) *

1D barcode - stacked (3 levels)

  • GS1 Databar

 Example of 1D 2 GS1 Databar (3 levels) *
1D barcode - stacked (more than 3 levels)  
RFID tag reading Example of RFID tag *
NFC data capture   *

To be read
Out of scope
*only if available in the device capabilities



Composite code

Type of code for composite code Symbology Handheld scanner Smartphone

1D barcode - linear code (1 level)

  • Code 128
  • GS1-128 (UCC/EAN-128)
 Examples of 1D linear barcodes

*

2D barcode:

  • QR code

  • GS1 QR code

 Example of 2D QR barcode *

2D barcode:

  • Datamatrix code

 Example of 2D Datamatrix code *

To be read
Out of scope
*only if available in the device capabilities


Application identifier managed Code On the Mobile Automation purchase receipt

GTIN - Global Trade Item Number

 01

The product is a reference field. You can use the GTIN code to search for a Sage X3 product.

Expiration date

 17 The expiration date is a date field. It can be a calculated date. The expiration date is 6 characters long.

Batch or lot number

 10 The lot number is a filter selection field. The lot field is 15 characters long.
Serial number 21 The serial number is a free numeric field.


Handheld scanners

Select or scan the URL on first use and add it to the Home screen to easily access the web application login page the next time.

Transactions have been tested using:

  • Honeywell CK65-LON-BSC210E
  • Zebra MC339R-GF2HG4EU
  • Zebra MC330K- GE2HG4RW
  • Zebra MC930B-GSEEG4NA
  • Zebra MC930P-GSCDG4RW

For more information, consult the Zebra support documentation.

MC33 limitation: On the physical keyboard, it is possible to select the first letter but not the second and the third. To manage that, you need to scan or use the virtual keyboard.

Add the application to your portable device's home screen

  1. In your Chrome browser, open the handheld page: https://loginUrl/handheld/
    Example: https://syracuseserver:8124/handheld/
  2. Log into the application:
  3. Next to the URL, tap the ellipses (Customize and control Google Chrome).
  4. Select Add to home screen:
  5. Tap Add to confirm:
  6. The icon displays on your device’s home screen:
  7. You can now tap the icon to log into Mobile Automation directly from your device’s home screen:

Smartphones

Note: Sage does not provide the devices.

Since release 2023 R1/V12.0.33, you can use Mobile Automation on smartphones, respecting the portable devices configuration described above.

Transactions have been tested using:

  • Nexus 5X, Androïd v8.1
  • Samsung Galaxy A51 – SM-A515F, Androïd v13
  • Samsung Galaxy A6 – SM-A600FN, Androïd v8
  • Samsung Galaxy A40 – SM-A405FN, Androïd v11


Add the application to your smartphone's home screen

  1. Get the file:
    The component is available at the same time as the release package from the local knowledge base, at the usual place where you retrieve the components of a release.
  2. Install the Android Package Kit (APK) file:
    1. Got to Settings > Security.
    2. Enable unknown sources.
    3. Search for the APK on your phone.
    4. Launch the APK file and follow the instructions.
    5. You can disable unknown sources again for more security.

  3. Configure the first server
    For the first connection, accept the terms and conditions andconfigure the server URL.
  4. Give access to the camera, select the "server" and get started.
  5. The icon displays on your smartphone’s home screen.
  6. You can now tap the icon to log into Mobile Automation directly from your smartphone’s home screen.

    Note: When you use the application on your smartphone for V12, do not select Remember me on this computer.

  7. Here is an example of the way the scan button appears. When you select the field, it appears on the top right of the screen. You can tap on it and scan.

  8. To log out of Mobile Automation:
    1. Log out from your account
    2. Swipe up the page from the multi-page display to reset your application history and empty your cache.