For the complete documentation index, see llms.txt. This page is also available as Markdown.

Working time consultation

The working time data stored in the Mobilic API can be viewed by the users concerned.

The API provides three consultation operations:

  • for a mission

  • for a mobile worker

  • for a company

Consultation of mission data

L'accès aux données de temps de travail d'une mission n'est autorisée que pour les membres de l'entreprise concernée par la mission.

query {
    mission(id: Int!) {
        name
        activities {
            id
            type
            startTime
            endTime
            userId
        }
        expenditures {
            id
            type
            userId
        }
    }
}

The query returns the list of activities associated with the mission (possibly involving several users).

Data consultation for a mobile worker

Full access to working time data is only allowed for company managers or for the user himself.

In the example above, subject to an appropriate level of authorisation, the API will return the list of missions on which the worker has recorded working time.

If you only want to retrieve the activities without having a grouping by missions, it is possible to query directly the activities field :

It is also possible to recover the working time already calculated per day.

Consultation of company data

This operation provides access to all company-specific working time data, that is, all assignments that have been performed by company employees.

Full access to all missions requires being attached as a manager to the company.

It is also possible to retrieve the list of current members of the company.

Just like consulting the data of a mobile worker, it is possible to recover the working time already aggregated by day.

Case of multi-company management

It is possible to retrieve in a single query the list of all companies on which the user has management rights, via the adminedCompanies field.

Choice of the retrieved history period

The three fields for retrieving working time data take optional arguments to restrict the history period :

  • the activities (fromTime: TimeStamp, untilTime: TimeStamp) field at a mobile worker level

  • the missions(fromTime: TimeStamp, untilTime: TimeStamp) field at mobile worker or company level

  • the workDays(fromDate: Date, untilDate: Date) field at mobile worker or company level

On the company fields there is also a limit parameter which defines a maximum number of returned jobs, in addition to the date filter. The most recent assignments (within the selected period) will be returned.

Last updated