After launching the DataSplice Remote Client for the first time a login screen is displayed.

• The user must specify the connection details, including the account information, the authentication system to use, and the DataSplice server instance to connect to.
• Users typically login with an account from an existing system - Maximo, ActiveDirectory, etc. Account information does not need to be duplicated or synchronized with DataSplice.
• The initial connection will take a while to initialize to allow the client to download the available views and other configuration settings for the user. In some cases, this might perform an offline synchronization and fetch offline data as well.

When the user has successfully connected a screen is displayed that lists the views that are available to the user. Views represent the functionality and work processes that are available to the user, and will be described in detail throughout this document.

• The list of views available to the user is determined by the roles the account is a member of. This allows a single DataSplice instance to support multiple mobile applications.
• Views are pushed out to the client when connecting, so administrators don't need to manually update individual handheld devices when configuration changes are made.
• Many of the views have multiple starting points, which provide tasks the user can perform if needed. Items can be accessed by double-clicking them, or using the cursor keys to select the item and pressing the enter key.
  

View Display

The view display control provides a consistent and flexible interface for users to interact with the various data available to the account. Each view can be displayed in three different modes:

• Search Mode - This displays the filter editor with the current query information, and allows the user to enter details about the data to work with. This can be accessed by clicking the magnifying glass icon in the toolbar.
  
• Grid Display Mode - Shows the results of the current query in a table display that will show multiple records on the screen. This can be accessed by selecting the grid icon in the toolbar to the right of the search mode icon.
  
• Record Display Mode - Shows the currently selected record in a vertical table that fits more information on the screen on a handheld device. This can be accessed by selecting the record icon in the toolbar to the right of the grid mode icon.
  

Search Mode	Grid Display Mode	Record Display Mode

Most of the actions are configured to select the appropriate mode by default, and various events can be configured to make it easier for the user to navigate through a work process in a streamlined manner that requires few, if any screen clicks.

Navigation Bar

The top portion of the view display control displays information about the current state of the application, such as the name of the current view and the number of records and position within the current results. In addition, this can be configured to display an additional message to the user to provide instructions or other details for using the view.

Clicking the view name will display a menu of the current navigation position and actions that are available given for the current context. The first section displays a hierarchy of the current navigation position, from the root view list up to the currently displayed view. Below this section is a list of available actions, and the actual items displayed here will depend on current view, the details of the selected record, and the permissions available to the active user.

By default the navigation menu will also be displayed by pressing the Enter key. This can be changed in the view configuration if desired to perform a specific action.

Filter Editor

The search screen uses a filter editor to specify the query to perform against the current view. The editor is also used in many other sections of the Administration client to define the queries used by the configuration. The editor displays the query items in a list, grouped by the level of indentation. The brackets on the left can be thought of as parentheses for combining the items, using either a logical AND or OR operator.

A complex filter showing multiple items and different levels of indentation.	Popup list for changing the search field.

• Items can be added and removed using the toolbar buttons
• The blue links can be clicked to change the search field or operator
• Items with empty values are ignored and removed from the query
• Multiple values can be searched for by separating them with commas
• Clicking the and/or labels on the left side will toggle the operators

Bar Code Scanning

The default views are designed to take advantage of bar code scanners integrated into the handheld devices to simplify data input and reduce errors. DataSplice supports most hardware vendors by default, along with several desktop USB scanner devices.

Scan work order 1006 -> updates the search field	Scan item XMP-3200 -> create new issue transaction for the item	Scan item again -> increments the transaction quantity

Using the event model, scan events can be configured to perform complex behavior depending on the label that is scanned:

• Patterns and other formats can be used to detect the type of label scanned (item number, work order, person code) and perform different actions
• Take action to search for a record, or insert a new record into the display
• Update fields with the scanned data
  

Managing Modifications

The view selection screen the drop list will have a Modification List option if there are pending changes that have not yet been committed to the server on the handheld.

This will display a list of each modified record for a view. Double-clicking one of the items will display the record in the view display.

Individual modifications can be reset if needed, and clicking the eraser icon will clear out the entire list of modifications. This can be useful in testing scenarios to reset a device back to the initial state.

Troubleshooting

If errors are encountered when connecting to the DataSplice Server, make sure you obtain the exact error message that is displayed. The message in question is very helpful in determining the underlying cause, which is essential to fix the issue.

These errors messages indicate issues connecting to the DataSplice server:

Invalid server address or name lookup failure.

The server name specified could not be resolved as a network address. This typically indicates problems with the DNS configuration or other network connectivity issues.

Failed to establish a connection with the server.

DataSplice could not open a network connection with the specified server. This can mean the server is not running, or a firewall, etc. is blocking the connection.

Authentication timeout!

The authentication process did not succeed in the allowed time period. This can indicate that the backend servers are overloaded, and can also be caused by network connectivity problems.

Other error messages mean a connection to the server was established, but a session could not be created for the specified account:

The server rejected the connection. Invalid authentication domain

The provided Domain value does not match a configured authentication domain.

The server rejected the connection. Authentication failure (or "User ID and password and not valid. Please try again.")

The authentication source rejected the provided User Name or Password.

The server rejected the connection. The account does not have permission to access any views. Please contact your system administrator.

The account authenticated properly, but is not configured to access to views. This typically means that the account is not a member of any roles in DataSplice that provide view permissions.

The server rejected the connection. No licenses are available for this user. Please contact your administrator or try again later.

All available licenses are in use. The Administration Client can be used to free stale licenses if any appear to be abandoned, or this could be an indication that not enough licenses are available to server the current usage patterns.

The server rejected the connection. Failed to load the the Maximo Plug-in

This indicates that a Maximo account is trying to authenticate with DataSplice and a connection to the Maximo application server could not be successfully established. Check the plug-in status to identify the underlying error message, and verify that the Maximo services are operational.