WhiteLabel manual
Gapp White Label is an Xtended version built upon the standard Gapp Self-Service application, offering additional features and an enriched user experience for end-users, technicians, and managers. You’ll enjoy all the functionalities of the free self-service version.
Login & Settings
Login
The login screen presents the authentication methods enabled for the app. The GLPI server URL is preconfigured; no server address needs to be entered.
1. Email and password
Native GLPI authentication. Enter the username or email and the password, then tap the submit button.
2. Sign in with Google
SSO via Google Workspace, implemented with Firebase Auth. On Android the flow is native; on other platforms a WebView handles the authentication. The flavor can restrict access to specific email domains.
3. Sign in with Microsoft 365
SSO via Microsoft 365, also using Firebase Auth. The authentication opens in a WebView provided by the Firebase plugin.
Settings
The Settings screen groups every preference for the app instance: interface language, notification behaviour, log housekeeping, and session maintenance. It opens from the gear icon in the side menu (or from the login screen when no session is active).
The set of options depends on the session state: the Preferences and Diagnosis sections are always visible; the Security section appears only after a successful sign-in.
1. Preferences
The Preferences card groups the options tied to the current session.
- Language sets the interface language. The default follows the system language; changing it prompts a re-login so the new strings load on every screen.
- Do not disturb silences every app notification while it stays on. Notifications are logged silently instead of producing sound or vibration. The toggle is OFF by default; tap it to enable or disable. When Time tracking is active, the option turns on automatically outside the workday and turns off when the workday starts. The manual toggle always overrides the automatic one.
- Notification log maintenance controls how often the in-app notification history is cleaned up. The subtitle shows the current cleanup rule, for example Never clean read notifications. Tapping the row opens a dialog with preset intervals and a custom interval in days.
- Timeline order switches the order in which timeline entries appear on ticket and task detail screens between Natural (oldest first) and the alternative order.
2. Set the notification log cleanup interval
The dialog that opens from Notification log maintenance lists preset intervals. Pick one, or open the custom interval to type a value in days.
- Set interval to clean logs pop-up title of the dialog.
- Interval options list preset choices (for example 1 day, 7 days, 30 days, never). Pick one to apply it immediately.
3. Use a custom cleanup interval
When none of the presets fit, the custom interval accepts a number of days.
- Set custom interval to clean logs pop-up title of the custom dialog.
- Input for interval (in days) the only field; enter a positive integer.
- Accept and confirm button applies the typed value and closes the dialog.
4. Security
The Security card holds the integration with the GLPI Passwords plugin. It is only visible after a successful sign-in.
- Passwords 2FA pairs the app with the Passwords plugin on the GLPI server. After pairing, two-factor codes for entries stored in GLPI Passwords appear in the app.
5. Diagnosis
The Diagnosis card groups troubleshooting information and the tools used by support.
- Clean cache renews the local user session. Use it to apply profile, entity, or plugin changes without logging out and back in.
- Installation ID the unique identifier of the app instance on this device. Share it with support when reporting a problem.
- Remote Config the timestamp of the last successful fetch of the remote configuration. A stale value usually means the device could not reach the server.
- Gapp Version the build number of the app installed on the device. Tap it for more information (visual coverage pending).
6. Open Settings
The path is the same in every section.
- From the main screen open the side menu.
- Tap the gear icon Settings opens.
- From the login screen tap the gear icon. Settings opens with Preferences and Diagnosis; Security stays hidden because it depends on the authenticated session.
7. Settings with or without an active session
The screen layout is the same; only the Security card and the live values change.
- Not logged Preferences (Language, Do not disturb is hidden because no notifications can arrive yet, Notification log maintenance, Timeline order) plus Diagnosis (Clean cache, Installation ID, Gapp Version). The Security card is not shown.
- Logged Preferences (all four options, including Do not disturb) plus Security (Passwords 2FA) plus Diagnosis (Clean cache, Installation ID, Gapp Version, Remote Config).
Planning
Planning calendar
The calendar view of your scheduled tasks, one day, week or month at a time.
1. Header
The header is the same on every Planning view. It shows whose calendar you are viewing and lets you move between dates.
- Back arrow (top-left) goes back to the previous screen.
- Title (center) shows the name of the screen, "Planning".
- Subtitle shows the user whose calendar you are viewing.
- Refresh icon (top-right) reloads the events for the current period.
- Calendar icon (top-right) opens a date picker to jump to a specific date.
2. View selector
The view selector switches between the three Planning views: Day view, Week view and Month view. The active view appears highlighted in the list.
- Day view shows the events of a single day on an hourly timeline (section 3).
- Week view shows seven days side by side (section 4).
- Month view shows the whole month as a grid (section 5).
- Tap a view to apply it immediately; the calendar redraws behind the selector.
3. Day view
The Day view shows the events of one day on a vertical timeline, with the hours on the left edge.
- Hours are listed on the left, one row per hour.
- Events appear as blocks on the timeline, from their start time to their end time.
- Event title shows the ticket number and a short description of the task.
- A line marks the current time across the timeline, so you can see where the day is at a glance.
- Tap an event to open its ticket, at the timeline entry where the task is planned.
4. Week view
The Week view shows seven days side by side, with the same hourly timeline.
- Day headers on top show the day of the week and the day number; tap one to open that day in the Day view.
- Events appear in the column of their day, from their start time to their end time.
- Tap an event to open its ticket, at the timeline entry where the task is planned.
5. Month view
The Month view shows the whole month as a grid, one cell per day.
- Days with events show a small dot under the day number.
- Tap a day to select it; the summary card below shows the events of that day.
- The selected day is highlighted, and a chip below the grid shows its full date.
- The summary card shows the title, description and time range of the event, or one card per event when the day has several.
- Tap the card to open the event's ticket, at the timeline entry where the task is planned.
6. What you can do from this screen
From the Planning calendar you can:
- Move between dates with the arrows in the date navigation bar.
- Jump to a specific date with the calendar icon in the header.
- Switch between the Day view, Week view and Month view with the view selector.
- Tap a day in the Month view to see the events of that day in the summary card.
- Tap a day header in the Week view to open that day in the Day view.
- Tap an event in any view to open its ticket, at the timeline entry where the task is planned.
Asset Handover
Asset handover
The Asset Handover section reads the assets a user has and assigns new ones. It opens from the side menu.
1. Choose how to assign
The screen offers two options:
- Read QR code scans a QR code to identify the user.
- Select user opens the user list to pick the user who receives the asset.
2. Select the user
The user list opens. Tap the user who receives the asset.
3. User profile
Tapping a user opens their profile, where the assets of that person can be read and new ones assigned. Two actions are available:
- Add new assets opens the asset list to assign a new asset.
- Asset list shows the assets the user already has.
4. Pick the asset
The asset list opens with the available assets. Tap the asset to assign.
Assign an item to a ticket
Items (assets) are linked to a ticket from the GLPI web interface. Once linked, they appear in the Items tab of the ticket inside the app.
1. Link an item from GLPI
Open the ticket in the GLPI web interface and switch to the Items tab. Select the item type and the device, then click Add.
⚠ CAPTURA NECESARIA (SCREENSHOT NEEDED): Captura del tab Items del ticket en GLPI web con un item añadido.
2. View items in the app
Once the item is linked, it shows up in the Items tab at the bottom of the ticket detail screen. Tapping an item opens its full detail: raw information, linked tickets, and available quick actions.
⚠ CAPTURA NECESARIA (SCREENSHOT NEEDED): Captura del tab Items del ticket dentro de la app con el item enlazado.
ActualTime
ActualTime
ActualTime is the plugin that times the work on a task. The timer counts the time from when the task is started until it is paused.
1. Start the timer
The first option of the ticket actions menu is the timer. The ActualTime timer starts with this option. Once active, it looks like this:
2. Notifications
Notification permissions must be enabled on the device. ActualTime relies on them to track time in the background and to alert when a task is running.
3. Running task in the ticket view
The ticket view shows which task is running and for how long.
- Tapping the running task from another screen moves the view to it automatically.
- With the counter running the task can be opened to pause it or mark it as done.
- Start and pause the task can be started and paused as many times as needed.
4. Finish a task
Finishing a task shows an alert asking for confirmation.
5. Edit the time
ActualTime has a wide range of customization options; the most important ones related to the app:
- Clock edits the ActualTime.
- Pencil edits the task fields.
Geolocation
Geolocation
The Geolocation section of the app.
⚠ CAPTURAS Y CONTENIDO PENDIENTES: la página de referencia del user guide está vacía, no hay contenido verificado. Hacer capturas de la pantalla de Geolocalización (mapa, posiciones de técnicos o de assets, según muestre la app) y describir sus elementos.