Launch Collect Mobile

<< Click to Display Table of Contents >>

Navigation:  Collect > Collect Mobile >

Launch Collect Mobile

On the EQuIS Collect Mobile Login Screen, enter the required credentials: Server, Username, and Password. Enter a URL for the EQuIS Collect Enterprise site. This is a secure website and requires user credentials to login. Collect Mobile also supports server IP address format (e.g., http://192.168.0.1/equis/). For the selected server, enter the Username and Password provided by the database administrator.

 

Note: Collect Mobile usernames cannot contain special characters, such as : / ’ \ ã ü. The app accepts the standard English alphabet characters, numbers, and email addresses assigned to user profiles, as long as the email address does not contain non-English alphabet characters. Hyphens and underscores are accepted as part of an email address.

 

If enabled, basic authentication users may also be authenticated with Multi-Factor Authentication (MFA) via an authentication app (such as the Microsoft Authenticator App) that generates time-based one-time passcodes (TOTP). See the MFA Login section below for more details.

 

If configured, Collect users may be authenticated with Microsoft Entra ID (see Enterprise Azure Configuration Options). A "Sign in with Microsoft" button will be visible on the Collect Login Screen. Microsoft Entra ID authentication in EQuIS should work with both Azure Application Proxy and Active Directory Federation Services (AD FS) (for more information, see AD FS Overview).

 

If configured, Collect users may be authenticated with an external, third party identity provider using OpenID Connect. A "Sign in with OpenID" button will be visible on the Collect Login Screen. Clicking that button will redirect the browser to the identity provider login screen, where the user will authenticate with the identity provider (including any additional verification steps, such as 2FA/MFA). Upon successful login, the user will be automatically redirected back to the EQuIS Enterprise site as an authenticated user.

 

If configured, Collect users on the Universal Windows Platform may be authenticated with Lightweight Directory Access Protocol (LDAP). A "Sign in with Windows" button will be visible on the Collect Login Screen and the option to authenticate using basic credentials will not be available.

 

Note: When authenticating with LDAP, the "Remember my credentials" option is automatically turned on and the current user will remain logged in until explicitly logged out.

 

Col-Mobile-Login-AAD-OpenID

 

To see the password as typed, touch the Show Password Col-Mobile_Login_See_Password icon next to the password box. To have the app remember the login information, tap or move the slider to the right. Tap the Login button to open the app. If the Remember my credentials option is turned on, then the next time the app is run, the login screen will be skipped. The current user can be changed by logging out of the app from the options menu.

 

Note: Collect Mobile is able to work without Location services enabled on the mobile device(s), however, Location services must be enabled if a template or form contains a geography field designed to capture the user’s current location.

 

 

Login with PIN

 

Users have the option to establish a Personal Identification Number (PIN) to use for Collect Mobile login. Setting up a PIN allows users to login to Collect Mobile without internet connectivity (aka offline). To initially setup a PIN, users must be able to connect to the Enterprise site via normal username/password login or Microsoft Entra ID authentication. To setup a PIN, either use the Security tab on the Settings menu or tap the PIN Col-Mobile-Login-PIN-Icon icon on the Login screen. See the Settings menu article for more details.

Col-Mobile-Login-PIN-Message

 

Note: When using the PIN login option and working offline, upon reconnecting if the user previously logged in using Microsoft Entra ID authentication, password confirmation will be required to go back online.

 

 

Saved Credentials

 

Collect will store the server and usernames after every successful login in the buttons beside each field. Users may tap on these and select any previous entry to save time logging in.

 

When the "Remember my credentials" toggle is turned on, a user is logged into the last used server.

 

 

MFA Login

 

Multi-Factor Authentication can be added by individual users in the User Profile Editor or be required by organizations that want to enforce MFA for all users by setting options in the ST_CONFIG table. For Collect only EQuIS users, MFA can be enabled on the Collect Mobile app when required on the Enterprise site.

 

Users enter their Username (or email address) and Password in the Collect Login Screen and Tap the Login button. After the username and password credentials have been verified, the MFA dialog window will open and users will need to enter the one-time 6-digit passcode from their MFA app.

 

COL_MFA-AlreadyEnabled

 

If the TOTP-MFA passcode is entered incorrectly, an error message is displayed and the wrong passcode is cleared from the MFA dialog window. Users should enter a passcode again. Once the TOTP-MFA passcode has been verified, the user will be logged into the Collect Mobile app for the designated Enterprise site.

 

If the "Remember my credentials" option is turned on and MFA is enabled, then MFA dialog window will display after the Collect Mobile app has been opened.

 

If MFA is enabled/required but not yet setup by the user, the MFA dialog window will include a QR code (and associated character string). The user must read the QR code with their MFA app on another device (or copy/paste the character string associated with the QR code) and then enter the one-time 6-digit passcode from their authentication app. Tap the Copy Code button to copy the code to the device's clipboard, if necessary. Once the TOTP-MFA code has been verified, the user will be logged into the Collect Mobile app for  the designated Enterprise site.

 

COL_MFA-NotConfigured

 

Collect Mobile Set to Offline

 

When Collect Mobile has been used offline and the user switches to online, the MFA dialog window will open. Users must either enter the one-time 6-digit passcode from their MFA app or logout of Collect Mobile. Users will not be able to close the MFA dialog. This also applies when a PIN has been configured.

 

COL_MFA-OfflineToOnline

 

 

Launching Collect Mobile Via a URI

 

The URI feature works by sending out a link to users with the ability to launch Collect Mobile with a specified server address. The link should be formatted using the following syntax (all lowercase): equiscollect://url (e.g. equiscollect://collectsite.net). The server address should be placed following the equiscollect:// syntax and should also not contain https notation.

 

Collect Mobile must also be installed on the device and the applications used to launch the Collect Mobile application must support URI on their respective platforms: iOS, Android and UWP. The supported platform applications are listed below.

iOS – Mail, Safari, SMS

Android – Mozilla Firefox

UWP – Outlook, Mozilla Firefox, Google Chrome

 

 

Troubleshooting Login Errors

 

Errors may be displayed when attempting to log into Collect Mobile if information is entered incorrectly. The error messages, followed by the steps to attempt to remedy the issues, are listed below:

Error Message: "Your request cannot be completed because the server is not reachable."

oConfirm the username is entered correctly.

oConfirm the server is entered correctly.

Error Message: "You have entered an invalid server, username, or password."

oConfirm the server is entered correctly.

oConfirm the username is entered correctly.

oConfirm the password is entered correctly. To see the password as typed, touch the Show Password Col-Mobile_Login_See_Password icon next to the password box.