Gapp White Label User Manual

Gapp White Label logo
Gapp Xtended

About Gapp

Gapp White Label: The mobility solution for your GLPI

Exploring Gapp

Essentially, Gapp is a GLPI-based mobile application.

Gapp has evolved significantly as a solution for convenient mobile access to GLPI, particularly for self-service users.

It has proved critical for technicians who are frequently away from their desks. Its unique features, some not found in the standard GLPI, and its portability make it an exceptional resource for technical staff and a powerful tool for real-time data collection for management.

What’s the difference between Gapp Self-Service & White Label?

Gapp Self-Service: A free, ready-to-download mobile app for standard GLPI use, ideal for smaller organizations or everyday usage needs.

Gapp White Label: An Xtended, customizable mobile app tailored to an organization’s specific GLPI management needs and branding, suited for larger organizations or more complex usage scenarios.

Gapp White Label Setup

Configuring your Gapp White Label variant is straightforward and consistently supported by TICGAL’s experts. In contrast to Gapp Self-Service, you only need to set up the GLPI Backend, as the applications are ready to use straight out of the box!

  • Server Side Configuration.
    1. Enable API: Configure your server to enable the GLPI API (Application Programming Interface). The GLPI API is a set of rules that allows Gapp to communicate with the GLPI (Gestionnaire Libre de Parc Informatique) system. Enabling the GLPI API establishes a secure and standardized channel for data exchange between the server and the Gapp application. We have written a specific how-to regarding this issue. Please click on it and follow the instructions: How to set up GLPI API.
    2. Install and configure Gapp Xtended: TICGAL should have made the plugin available or installed it upon request. Initial parameters have been set up. If not, install it as any other plugin and follow the KB article on TICGAL’s Service Desk.

Once GLPI and Gapp Xtended are properly configured, you must download your particular flavor from the Play Store or App Store.

USER MANUAL

Login & Settings

login

Login

The login for your app is customized according to the preferences of the app owner. Various authentication methods can be made available, depending on their requirements.

  1. User. This field prompts users to enter their account’s unique username or email address.
  2. Password. The password field is where users input their confidential password.
  3. Submit button. Users must press this button after entering their username and password.
  4. Settings. This option allows users to modify their account and application settings.
  5. Sign in with Google.
  6. Sign in with Microsoft 365.

Note: Sign-in with AppleID is supported on demand and only on Apple Devices.

settings-not-logged.png

Settings (Not logged)

In the Settings section of our application, a set of fundamental options is displayed to personalize the user experience.

  1. Language. Here you can change the language in which the application is shown.
  2. Installation ID. The Installation ID is a unique identifier for the app instance installed on a user’s device. It can be useful for troubleshooting or support purposes.
  3. Gapp Version. You can see more information by clicking on it.
new-settings

Settings (Logged)

If the user is authenticated, more options will be displayed in the Settings section.

  1. Language.
  2. Do not disturb. Enabling this feature will suppress app notifications, ensuring uninterrupted focus during specific activities.
  3. Notification log maintenance. This new button allows you to delete the notification history from time to time. When you press it, a pop-up window will be displayed in which you must indicate the interval.
  4. Clean cache. This function renews the user session. It is useful to apply changes without having to log in again in case of changing profiles or entities.
  5. Installation ID. 
  6. Gapp Version. 

Note: Go back to the previous screen by clicking on the top left arrow.

new-settings-clean-logs

Settings (Interval to delete notification logs)

This pop-up shows several intervals. If none suits the user’s needs, a custom one can be added

  1. Set interval to clean logs pop-up.
  2. Interval options list.
new-settings-clean-logs-custom

Settings (Custom interval to delete notification logs)

This pop-up shows several intervals. If none suits the user’s needs, a custom one can be added

  1. Set custom interval to clean logs pop-up.
  2. Input for interval (in days).
  3. Accept and confirm button.
  4. Cancel button.

Home & Main menu

home-screen-1
home-screen-2

Home

This is the home screen in Gapp. Let’s explore the features integrated into this interface:

  1. Menu with access to more features of the application.
  2. Search and access a ticket by ID.
  3. Do not disturb. This feature allows you to temporarily silence notifications, ensuring uninterrupted focus when needed.
  4. Tickets. Easily navigate through all tickets assigned to the logged-in user. This section provides a quick overview of your current workload.
  5. Create ticket.  This button allows users to initiate the ticket creation from the home screen.
  6. Assets. You can quickly access your assets and open issues on them if you need to use the QR reader. This button also shows all the user’s assets in a dropdown without the need to scan QR codes.
  7. TAM. The TAM plugin controls the attendance, vacations, and leave of your employees.
  8. Running timers. This feature keeps track of the time spent on your ticket tasks.
  9. Forms. Forms use the Formcreator plugin that allows the creation of custom forms for easy access.
  10. Planning provides users with a clear view of their daily or weekly schedules, allowing for effective time management and task organization.
  11. Credits. This feature assigns credits to tasks, responses, and follow-ups. Ideal for managing hour bonuses, credits are subtracted based on the actual time spent on tasks.

Note: You will only be able to access these functions if you have the Gapp White Label version and the respective plugins: TAM, Forms, Running, Timers and Credits.

left-menu

Main menu

This menu allows access to several of the functions discussed in the previous section, but also others:

  1. Settings button.
  2. User.
  3. Current profile. This will not be enabled for a one-authorization user.
  4. Current entity. This will not be enabled for a one-authorization user.
  5. Assigned tickets.
  6. Create a new ticket.
  7. Assets.
  8. TAM.
  9. Running timers.
  10. Forms.
  11. Planning.
  12. Credits.
  13. Notification log.
  14. About. App version, links, and contact. The usual stuff.
  15. Logout button.

Note: You will only be able to access these functions if you have the Gapp White Label version and the respective plugins: TAM, Forms, Running, Timers and Credits.

Ticket creation

add-ticket-1
add-ticket-2

New ticket

This screen will appear if you click on a new ticket from the home screen, the main menu, or the yellow (+) icon in the main ticket view.

  1. The entity where you are creating the ticket.
  2. Ticket type. Request or Incident.
  3. Category of the ticket.
  4. Location of the request/incident (optional).
  5. Title of the ticket.
  6. Description of the ticket.
  7. Urgency of the ticket.
  8. Observers.
  9. Assign tech.
  10. Create ticket. Press this button to create the ticket.
  11. Assign group.
  12. Documents upload. You can choose from your local files or take photos with your phone’s camera (optional).

Note: In the Gapp White Label version, exclusive features include the ability to assign a technician or group, enhancing task allocation efficiency. Additionally, this release allows users to configure optional fields as mandatory through the GLPI backend for a more tailored and structured ticket creation process.

Ticket list

tickets

Main tickets view

This is the ticket window in Gapp.

  1. On the top left is the burger menu icon.
  2. On the top right is the filter menu.
  3. Now, on each card, we have on top the ticket title.
  4. In the bottom left of each ticket, we have a small icon telling us the ticket priority.
  5. In the top left of each ticket, we have a ticket status indicator. Just like GLPI:
    • New
    • Processing (Assigned)
    • Processing (Planned)
    • Waiting
    • Solved
    • Closed
  6. In the top right of each ticket, we have an indicator of the ticket type:
    • Incident
    • Request
  7. Also in the top right of each ticket, next to the ticket type, we have the ticket number.
  8. Just below the ticket title appears the ticket’s last update.
  9. Finally, there is a New ticket button.

Note: All tickets are sorted using the last update from newer to older.

filter-desplegable

Filters menu

With access to the Filter Menu, the following screen is shown.

  1. Your opened tickets (My tickets).
  2. You can reach all tickets based on your permissions (All tickets).
  3. Your solved tickets pending to close (Tickets to close).
  4. The content filter allows you to make a text-based fast search on the ticket title or description.
  5. Sort tickets by last update.
  6. Sort tickets by creation date.
  7. Sort tickets by priority.
  8. Sort tickets by the SLE due date.
  9. Show tickets created from a date.
  10. This button allows you to use custom searches for tickets, which must be previously configured (tickets from a group or in a specific state, for example).
  11. From here you can also directly access a ticket by its ID.

Ticket view

ticket-view-1

Main ticket view

This section displays a summary of the ticket.

  1. The entity where the ticket is located.
  2. A toolbar that allows users to change ticket status and category.
  3. Three small icons show:
    • Number of the ticket and if it is an Incident(!) or a Request(?).
    • Ticket status.
    • Ticket priority.
  4. Dates related to the ticket. The creation date and the last update date.
  5. Category of the ticket.
  6. Location of the ticket. If a location has the coordinates saved in GLPI, it will appear highlighted in a different color in the app and when you click it will open your navigation application with the coordinates. The navigation applications currently supported are the following:
    1. Google Maps
    2. Apple Maps (iOS only)
    3. Google Maps GO (Android only)
    4. Baidu Maps
    5. Amap (Gaode Maps)
    6. Waze
    7. Yandex Maps
    8. Yandex Navigator
    9. Citymapper
    10. Maps.me (iOS only)
    11. OsmAnd
    12. OsmAnd+ (Android only)
    13. 2GIS
    14. Tencent (QQ Maps)
    15. HERE WeGo
    16. Petal Maps (Android only)
    17. TomTom Go
    18. TomTom Go Fleet
    19. CoPilot
    20. Flitsmeister (Android only)
    21. Truckmeister (Android only)
    22. Sygic Truck
    23. Naver Map
    24. KakaoMap
    25. TMAP
    26. Mapy.cz
  7. Ticket requesting source.
  8. Icons where you can find and modify (only actors) the following information about the ticket:
    • Service levels.
    • Actors (users or groups).
    • Other tickets are linked to this ticket.
  9. Title and description of the ticket.
  10. Ticket view selector.
share-button

Main ticket view – Toolbar

  1. Change ticket status button.
  2. Modify ticket category button.
  3. Share ticket button.
ticket-service-levels

Service Levels

Here you can see the ticket’s Service Levels.

  1. The button you have to click on “Ticket View” to see the Service Levels.
  2. TTO (Time to own).
  3. TTR (Time to resolve).
  4. Internal TTO (Internal time to own).
  5. Internal TTR (Internal time to resolve).
ticket-actors

Actors

Here you can see and modify the ticket’s actors.

  1. Ticket’s Requesters.
  2. Ticket’s Observers.
  3. Add yourself as an observer.
  4. Ticket’s Assigned Technicians.
  5. Add other users, groups, or yourself as an assignee.

Note: In Gapp White Label you also can remove added users/groups by clicking on them.

ticket-linked-tickets

Linked tickets

Here you can see and access the ticket’s linked tickets.

  1. The button you have to click in to see the Linked Tickets.
  2. List of the linked tickets.
Diseño sin título

Ticket view selector

  1. Request / Incident – Main view.
  2. Processing – Conversation view.
  3. Assets  –Linked assets.
  4. Historical view of the ticket.
  5. KB – Knowledge base
  6. Contracts.
ticket-processing

Processing

You can find the following elements on a ticket.

  1. In every task, follow-up, or solution, you will see first the following information:
    • Profile picture.
    • Creator.
    • Date.
  2. In a followup you will see:
    • Follow-up description.
    • Private lock (if the follow-up is private).
  3. In a task you will see:
    • A small icon that tells you if the task is done or not.
    • The Task Assigned Tech.
    • Task description.
    • Private lock (if the task is private).
  4. Actualtime functions (An additional plugin is needed).
  5. In a validation request you will see the following:
    • The user asked for the validation.
  6. Main ticket information:
    • Title of the ticket.
    • Description of the ticket.
  7. Ticket actions. This button allows you to change the ticket status or category.
ticket-view-item

Items (I)

You can find all the items linked to a ticket.

  1. Ticket information.
  2. Item name.
  3. Item information.
  4. Item manufacturer. In this section, more or fewer details will be shown depending on the item (model, type…).
  5. Link to see more details and options of the item.
items-with-actualtime

Items (II)

This screen shows more options, some of them not available without the corresponding plugins.

  1. Ticket information.
  2. Open new incident with Actualtime (requires Actualtime plugin).
  3. Open new incident without Actualtime.
  4. List of pending tickets associated with the item.
  5. Pending ticket.
item-raw-info

Item raw info

From the list of items in the ticket view, the raw information of the item can be accessed by clicking on “See raw info” in the menu shown above.

  1. Item name.
  2. Item raw information.
ticket-historical

Historical

This is a function only available in Gapp White Label.

  1. Ticket information.
  2. The user who made the change/update.
  3. Description of change/update.
  4. Date of change/update.

Ticket actions

ticket-actions

If you push the button in the bottom-right in the Ticket Process view you will see.

  1. Add a new validation.
  2. Add a new solution.
  3. Add a new task.
  4. Add a new document.
  5. Add a new followup.

Note: This represents the essential functionality of the application and is also available in Gapp Self-service. If you are a technician, you will have access to all of these features. For self-service users, the button will directly open the “New followup” tab.

ticket-new-task

Add a task

  1. Ticket information.
  2. Mention another tech. 
  3. Formatting options for task description.
  4. Task description.
  5. Properties. You can choose to send a private task if logged as a technician. Also, you can set the task status, and category, and mark it as pending or done.
  6. Documents upload area. You can see a counter of uploaded documents. You can also upload photos directly from your smartphone camera in addition to your local files.
  7. Create task.

Note: You can only mention another tech if you have the Gapp White Label version.

ticket-new-followup

Add a followup

  1. Ticket information.
  2. Mention another user.
  3. Formatting options for follow-up content.
  4. Follow-up content.
  5. Properties. You can choose to send a private follow-up or set the ticket to pending if logged as a technician.
  6. Documents upload area. You can see a counter of uploaded documents. You can also upload photos directly from your smartphone camera in addition to your local files.
  7. Send a follow-up.

Note: You can only mention another user if you have the Gapp White Label version.

headings-selector (1)

Add a document (I)

The application allows you to attach images taken with the phone’s camera or files already existing on the device.

1. Open the camera.
2. Select a file that already exists on the device.

headings-search

Add a document (II)

When the file to be attached to the ticket has already been indicated, the header can be indicated by selecting it from the following drop-down menu.

1. Search window.
2. List of available headings.

ticket-new-solution

Add a solution

  1. Ticket information.
  2. Mention another user.
  3. Formatting options for solution content.
  4. Solution type.
  5. Properties of the solution.
  6. Documents upload area. You can see a counter of uploaded documents. You can also upload photos directly from your smartphone camera in addition to your local files.
  7. Use and solution template.
  8. Add ticket solution.

Note: You can only access the following functions if you have the Gapp White Label version: mention a user and use solution templates.

ask-for-validation

Ask for validation

This is a function only available in Gapp White Label.

  1. The selected user will be asked for validation.
  2. Dropdown for selecting a user.
  3. Validation message (Optional).
  4. Send validation.
solution-approval.png

Ticket approval (I)

When you create an approval request, you will see in the ticket processing view:

  1. Validation requester.
  2. User or group you are requesting the approval from.
  3. Approve validation button.
  4. Refuse the validation button.
ticket-approval-2

Ticket approval (II)

Whether you approve or refuse a validation, this menu will pop up.

  1. The icon shows whether you are making an approval or a rejection.
  2. Message of the approval or rejection. If you approve a validation request, the message is optional, but in a rejection, it is mandatory.
  3. Send approval or rejection button.
ticket-approval-3

Ticket approval (III)

After you approve or reject a validation, the processing view will look like this.

  1. The user who approved or rejected the validation request.
  2. Answer to the validation request.
  3. Validation requester.
  4. User or group you are requesting the approval from.
  5. Approval description.
ticket-solution-approval

Solution approval

  1. Ticket information.
  2. Refuse solution.
  3. Approve solution.
  4. Solution tech and date.
  5. Solution description.
ticket-satisfaction

Ticket satisfaction

When a solution is approved, it will pop up.

  1. Rating of the ticket solution (1 to 5 stars).
  2. Comments about the satisfaction.
  3. Send the satisfaction survey.

Changes

changes-all-changes

Changes list

All changes are shown in this view, although various filters can be applied.

  1. Change status.
  2. Change title.
  3. Change date.
  4. Change priority.
  5. Change ID.
  6. Change filter.
changes-filters

Filter changes

With filters, users can select and display changes based on a variety of attributes: content, status, date…

  1. Default filters.
  2. Filter by content.
  3. Filter by status.
  4. FIlter by date.
  5. Go to change link (by id).
changes-shorcut-go-to-change

Go to change

By clicking on the Go to change button you can access a change by entering the ID.

  1. Go to change pop-up.
  2. Change ID input.
  3. Cancel button.
  4. Go to change button.
changes-change

Main change view

This is the main view of a change, which is subdivided into 3 others: actors, analysis and plans.

  1. Change ID.
  2. Change status.
  3. Change priority.
  4. Change opening date and last update.
  5. Change status.
  6. Change views.
  7. Change summary.
changes-actors

Change actors

The change actors section in GLPI identifies and defines the roles and responsibilities of the people involved in the change process. This can include users or groups.

  1. Actors view.
  2. Requester.
  3. Observer/s.
  4. Assigned user/group.
  5. Assign group.
  6. Assign user.
changes-analysis

Change analysis

The GLPI change analysis section provides a detailed evaluation of the effects and consequences of the proposed change. It includes two main components:

  1. Impact. This part of the analysis examines both the positive and negative outcomes of the change, considering how it will affect different areas of the system and users.
  2. Checklist. Describes a structured approach to monitoring critical elements of change. This includes a checklist of key factors that must be considered to ensure successful implementation of the change.
changes-plans

Change plans

This plan contains deployment plans, backup plans and check-listsGLPI change plans are detailed documents that contain essential information to implement changes effectively and safely. They include a deployment plan with specific steps, a backup plan to protect data, and a checklist to ensure all necessary tasks are completed.

  1. Plans list.
  2. Deployment plan.
  3. Backup plan.
  4. Checklist.
changes-status

Change status

The states section of a change refers to the different states that a change can have throughout its life cycle. These statuses indicate what stage the change is in and what actions may be required next.

  1. Choose a new change status pop-up.

Notifications

whitelabel-push-notifications

Push notifications

Some notifications are displayed outside the app (new incident, request, follow-up…).

  1. Notification not displayed.
  2. Notification displayed.
do-not-disturb

New notifications (I)

Clicking the link in the main view of the application will display the notifications that the user received while Do not disturb mode was activated.

  1. Do not disturb icon (if activated).
  2. New notifications link.

Note: If this mode is not activated, notifications will be displayed and added to the notification history automatically.

whitelabel-dnd-notifications-swipe

New notifications (II)

Users can review or delete notifications from here.

  1. New notifications view.
  2. Left swipe to delete notification.
  3. Notification.

Note: Deleting a notification will also delete other notifications associated with the same ticket from this section.

notification-log

Notifications log (I)

All notifications are stored in the notification history. You can show those that have not been read, those that have been read, or all of them together.

notification-log

Notifications log (II)

Notifications are displayed in a list.

  1. Option menu.
  2. Notification ID.
  3. Notification content.
  4. Red dot to indicate that the notification is also in the Do Not Disturb list.

Alerts

alert

Alerts

If you have the Alerts plugin installed on the GLPI server, the application will display the alerts that have been configured when appropriate.

Planning

planning (2)

Planning view

Planning allows you to quickly view calendar tasks.

  1. Date
  2. Planning with tasks for the selected day, week or month.

New widget

whitelabel-widget

Summary widget

The new version adds a widget that shows a summary of tickets without having to open the application.

  1. Widget.
  2. Number of new tickets.
  3. Number of assigned tickets.
  4. Number of planned tickets.
  5. Number of waiting tickets.
  6. Number of closed tickets.
  7. Widget last update.
  8. Update widget.

Note: This feature is available only on Android.

Update available popup

update-available

Update available

When a new version of the application is available, the user is notified to access the Store and update it.

  1. Pop-up.
  2. Cancel button.
  3. Go to store and update link.

Gapp White Label Manual

Gapp White Label logo

Main Manual Page

barcodeplus

Assets - Barcode - QR Scanner

ActualTime: The time tracking plugin for GLPI

ActualTime - Waypoint - Vehicle

Charge Plugin

Credit vouchers - Charge

formcreator-alternative

Form Creator

Asset Handover GLPI Plugin

Asset Handover - Gapp Sign