LESSON INFO

Audience

  • Users who sign in to Themis-Trace using the Web App.
  • Users who sign in to the Themis-Trace Mobile App.
  • Facility administrators who set up and maintain Mobile App devices.

Prerequisites

  • You have a Themis-Trace account.
  • You have a Themis-Trace username and password.
  • You know your tenant name, which identifies your organization’s Themis-Trace instance. If you’re unsure, please ask your administrator.
  • If you use the Mobile App:
    • The Mobile App is installed on the device. The app runs on handheld scanner devices, phones, and tablets.
    • You know which Facility you should work in (if your instance has more than one facility available in the app).

Skills you’ll build

  • You can log in to Themis-Trace using the Web App with one of the supported sign-in methods.
  • You can log in to the Mobile App using User ID and Password.
  • You can add your tenant as part of Mobile App login to connect to the correct Themis-Trace instance.
  • You can recognize when access is blocked because you are not logged in, or because the facility you selected is unavailable.

LESSON OUTLINE

Selecting your tenant

Before logging in for the first time, select your tenant so Themis-Trace connects to your organization’s instance. Use the tenant name provided by your administrator.

Once your tenant is set up, Themis-Trace automatically remembers it for next time, so you do not need to select it again each time you log in.

Logging In

  • Web App login is used to access the core Themis-Trace application in a browser.
  • Mobile App login is used to access mobile scanning workflows.
  • In both cases, you must log in before you can use the application.

Tenant vs. Facility in the Mobile App

  • Tenant: The server environment the app connects to (for example, your organization’s Themis-Trace instance). You add your tenant as part of login, not through a setup barcode. Themis-Trace automatically remembers it for next time.
  • Facility: The working context you log into (shown as a dropdown only when more than one facility is available).
  • Why this matters: Selecting the wrong facility can result in receiving or shipping in the wrong place, and selecting an unavailable facility can prevent login.

Logging in (Web App)

  1. Navigate to the Themis-Trace Web App home screen.
  2. Click the Login button.
    • If you are not logged in, the Login button is available by default on the home screen.
    • If you are logged in, Logout is available under [Username] → Logout.
  3. If prompted to select a tenant, enter your tenant name and select your organization’s tenant before entering your login details.
    • Once set up, Themis-Trace automatically remembers your tenant for next time.
  4. Enter your username & password and click Log In.
  5. Confirm you have been returned to the Themis-Trace main menu.

Logging in (Mobile App)

  1. Open the Mobile App. The Login screen is visible by default.
  2. If your tenant has not already been added, enter your tenant name and add your organization’s tenant as part of login.
    • Themis-Trace automatically remembers your tenant for next time, so you do not need to add it again each time you log in.
  3. Enter your username & password.
  4. Tap Login.
  5. Confirm you reach the Main Menu.

Change your password after your first login

If your administrator gave you a temporary password, expect to be asked to replace it at first login.

  1. Log in to Themis-Trace using your username and temporary password.
  2. If your administrator has set Force password change on your account, Themis-Trace prompts you for a new password before letting you continue.
  3. Enter and confirm your new password.
  4. Confirm you reach the Themis-Trace main menu.

If you want to change your password at any other time, you have two routes: ask an administrator to set Force password change on your account, or use Forgot Password on the login screen to reset it yourself by email.

COMMON ISSUES

    • Resolution: If you’re unsure of your tenant name, please contact your administrator. They can confirm the correct tenant name so you can connect to your organization’s Themis-Trace instance. If you need further help, please contact us at support@themis-trace.com.

  • If you need to connect to a different Themis-Trace instance, change the tenant name on the login screen. Please confirm the new tenant name with your administrator if you’re unsure.

    • Web App:

      1. On the login screen, click Switch in the tenant field.

      2. Enter the new tenant name and select the tenant you want to use.

      3. Log in using your username and password for that tenant.

    • Mobile App:

      1. On the login screen, replace the existing tenant name with the new one.

      2. Log in using your username and password for that tenant.

    Themis-Trace automatically remembers the newly selected tenant for next time.

    • What this means: Your Mobile App has not yet been configured by your administrator. The base URL is part of the app’s configuration and is separate from the tenant name you enter during login.

    • Resolution: Please ask your administrator to follow the steps on the Scanner App Setup page under Administration in Themis-Trace. Once the app has been configured, return to the login screen, enter your tenant name, and log in with your username and password.

    • Need more help? Please contact us at support@themis-trace.com.

    • Likely causes:

      • Server-side error during login.

      • The network is down.

      • The network is live, but cannot establish a connection to the Internet.

    • Checks:

      • Retry login.

    • Fix:

      • Try again later.

      • If it persists, escalate with time of error and device details.