> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/fr/sonar/deploy-operate/productivity-module.md).

# Le module de productivité

Le service Windows installé avec l'agent qui enregistre l'activité des utilisateurs et applique les politiques d'accès : installation, contrôle, ce que voit l'utilisateur.

## Ce que c'est et quand l'utiliser

Le module de productivité est un service Windows que l'agent SONAR installe à côté de lui-même. Il remplit deux fonctions sur l'appareil :

* **Il enregistre l'activité des utilisateurs** : les applications et les sites web au premier plan, le temps d'inactivité, ainsi que l'ouverture et la fermeture de session de chaque utilisateur. Ce sont les données qui alimentent [Users Behavior](https://wiki.datadike.com/fr/sonar/administration/user-activity/users-behavior.md) et [Users Traces](https://wiki.datadike.com/fr/sonar/administration/user-activity/users-traces.md). Ce qu'il enregistre est détaillé dans [Users Behavior](https://wiki.datadike.com/fr/sonar/administration/user-activity/users-behavior.md#ce-que-le-module-de-productivite-enregistre).
* **Il applique les politiques d'accès** : il refuse une ouverture de session en dehors des heures autorisées, ferme la session à la fin de la plage, prévient l'utilisateur à l'avance et lui permet de demander du temps supplémentaire. Consultez [Politiques d'accès](https://wiki.datadike.com/fr/sonar/administration/access/access-policies.md) et [Demandes de prolongation](https://wiki.datadike.com/fr/sonar/administration/access/requests.md).

Sans lui, un appareil Windows reste géré par l'agent comme d'habitude, mais ne remonte aucune activité utilisateur et n'applique aucune politique d'accès.

Sur l'appareil, il se présente ainsi :

| Élément         | Valeur                                                                                                                                                                      |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Nom du service  | `SonarProductivityService`                                                                                                                                                  |
| Nom d'affichage | Sonar Productivity Service                                                                                                                                                  |
| Description     | Launches and supervises Sonar Productivity workers per active user session.                                                                                                 |
| Exécutable      | `C:\Program Files\Sonar\productivity.exe`                                                                                                                                   |
| Compte          | Local System                                                                                                                                                                |
| Processus       | Un `productivity.exe` pour le service, exécuté en tant que SYSTEM, et un `productivity.exe` dans chaque session utilisateur surveillée, exécuté en tant que cet utilisateur |

## Avant de commencer

* Un appareil **Windows 64 bits (x64)** conforme aux [prérequis des appareils](https://wiki.datadike.com/fr/sonar/deploy-operate/requirements.md). Le module n'est pas disponible sur Linux ni sur macOS.
* L'appareil joint l'adresse de l'API SONAR en 443/tcp, en HTTPS et par une connexion WebSocket sécurisée de longue durée. Consultez [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md).
* Pour la fenêtre de demande de prolongation sur l'appareil, le **Microsoft Edge WebView2 Runtime**.
* Pour affecter l'appareil à une politique d'accès, l'agent **4.2.0** ou une version ultérieure.

## Étapes

Le module est installé par l'agent, en même temps que lui. Il n'existe pas d'installateur distinct.

1. Ouvrez **Agents › Install Agent** et choisissez le client, le site et le type.
2. Dans les fonctionnalités optionnelles, laissez **Sessions** cochée. Elle est cochée par défaut dans **Install Agent** et décochée par défaut dans un nouveau lien de déploiement (voir [Déployer des agents à grande échelle](https://wiki.datadike.com/fr/sonar/deploy-operate/mass-deployment.md)).
3. Générez l'installateur et exécutez-le sur l'appareil comme décrit dans [Installer l'agent sur Windows](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-windows.md).
4. Pendant l'installation, l'agent télécharge le module depuis le serveur SONAR, enregistre `SonarProductivityService` et le démarre.

Le choix se fait à l'installation. Pour ajouter le module à un appareil installé sans **Sessions**, réinstallez l'agent avec l'option cochée.

Le module est retiré avec l'agent : le programme de désinstallation de l'agent arrête et supprime `SonarProductivityService`. Consultez [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md).

### Mettre à jour le module sur un appareil

Quand une nouvelle version du module est disponible sur le serveur SONAR, l'appareil la reçoit à la demande, sans réinstaller l'agent :

1. Ouvrez **Dashboard › Sysadmin** et sélectionnez l'appareil.
2. Ouvrez son menu d'actions et choisissez **Update productivity module**.
3. L'appareil télécharge le module depuis le serveur SONAR et redémarre le `SonarProductivityService`. L'icône **Sonar UEM** disparaît quelques secondes puis revient.

L'option n'apparaît que pour les appareils Windows et demande la permission de modifier les agents. Chaque demande est enregistrée dans l'audit. Quand l'appareil ne peut pas recevoir la mise à jour, la console indique pourquoi :

| Message                                                                                             | Signification                                                              |
| --------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
| "... is downloading the productivity module. It restarts on its own in a few seconds."              | La mise à jour a commencé                                                  |
| "The productivity module is not enabled on this device (the agent was installed without Sessions)." | Réinstallez l'agent avec **Sessions** coché                                |
| "An update of the productivity module is already running on this device."                           | Attendez une minute et vérifiez le service                                 |
| "Unable to contact the agent"                                                                       | L'appareil est hors ligne ou injoignable ; réessayez quand il est en ligne |

## Ce que vous devez voir

Sur l'appareil, `SonarProductivityService` dans la console Services de Windows, avec l'état **Running** (en cours d'exécution).

Pour l'utilisateur, dans chaque session surveillée, une icône dans la zone de notification de Windows. Le texte qui s'affiche au survol commence par **Sonar UEM** et indique l'état de la session : **acesso liberado até&#x20;*****HH:MM*** lorsqu'une politique d'accès s'applique (avec la fin de la plage autorisée), ou **sem restrição de horário** lorsqu'aucune ne s'applique. Son menu comporte :

* la même ligne d'état ;
* **Solicitar horário adicional de acesso...**, qui ouvre la fenêtre de demande décrite dans [Demandes de prolongation](https://wiki.datadike.com/fr/sonar/administration/access/requests.md) ;
* **Sobre o Sonar UEM**, qui affiche l'utilisateur, le numéro de session et l'état.

Lorsqu'une politique d'accès s'applique, l'utilisateur peut aussi voir :

| Quoi                                                                                                        | Quand                                                                                                          |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| Notification **Sessão próxima do encerramento** (« Sua sessão será encerrada em *n* minutos, às *HH:MM*. ») | 15 et 5 minutes avant la fin de la plage autorisée, lorsque les notifications sont activées dans la politique  |
| Écran plein **Acesso bloqueado**, avec les heures autorisées, l'utilisateur et le nom de l'ordinateur       | Une ouverture de session en dehors des heures autorisées, pendant 15 secondes avant la fermeture de la session |
| Notification **Horário de acesso atualizado**                                                               | Les heures autorisées de l'utilisateur ont changé, par exemple après une demande approuvée                     |
| Notification **Solicitação recusada**                                                                       | Une demande d'heures supplémentaires a été refusée                                                             |

L'icône, les notifications et les écrans de l'appareil sont en portugais. L'enregistrement de l'activité proprement dit n'affiche rien à l'utilisateur.

## Comment vérifier que cela a fonctionné

1. Sur l'appareil, dans PowerShell :

   ```powershell
   Get-Service SonarProductivityService
   ```

   L'état doit être `Running`.
2. Ouvrez une session avec un utilisateur et lancez une application. L'icône **Sonar UEM** doit se trouver dans la zone de notification.
3. Quelques minutes plus tard, dans la console, ouvrez **Observability › Users Traces** et choisissez le site de l'appareil et l'utilisateur : l'application doit figurer comme un événement **Application**, avec le nom d'hôte de l'appareil.

## Erreurs courantes

| Symptôme                                                   | Cause                                                                                                                                                        | Correction                                                                                                                             |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| `SonarProductivityService` n'existe pas                    | L'agent a été installé sans **Sessions**, ou l'appareil n'est pas un Windows 64 bits                                                                         | Réinstallez l'agent avec **Sessions** cochée                                                                                           |
| Le service existe mais il est arrêté                       | Il a été arrêté sur l'appareil, ou une mise à jour ne l'a pas relancé                                                                                        | Choisissez **Update productivity module** pour l'appareil, ou démarrez-le en administrateur : `Start-Service SonarProductivityService` |
| L'utilisateur n'a pas d'icône **Sonar UEM**                | La session est en dehors des heures autorisées d'une politique d'accès, ou le service ne s'exécute pas                                                       | Vérifiez les heures de la politique ; vérifiez le service                                                                              |
| L'activité de l'utilisateur n'apparaît pas dans la console | Le module envoie ses données à un intervalle d'une à deux minutes et demie, et les périodes au premier plan de moins de 10 secondes ne sont pas enregistrées | Patientez quelques minutes ; vérifiez que l'appareil joint l'adresse de l'API en 443/tcp                                               |
| **Solicitar horário adicional de acesso...** n'ouvre rien  | Le Microsoft Edge WebView2 Runtime est absent                                                                                                                | Installez le WebView2 Runtime sur l'appareil                                                                                           |
| L'appareil n'est pas proposé dans une politique d'accès    | L'agent est antérieur à la version 4.2.0                                                                                                                     | Mettez à jour l'agent ; consultez [Mettre à jour les agents](https://wiki.datadike.com/fr/sonar/deploy-operate/agent-updates.md)       |

## Pages associées

* [Installer l'agent sous Windows](https://wiki.datadike.com/fr/sonar/deploy-operate/install-agent-windows.md) : l'option **Sessions**
* [Politiques d'accès](https://wiki.datadike.com/fr/sonar/administration/access/access-policies.md) : ce que le module applique
* [Comportement des utilisateurs](https://wiki.datadike.com/fr/sonar/administration/user-activity/users-behavior.md) : ce que le module enregistre
* [Prérequis réseau](https://wiki.datadike.com/fr/sonar/deploy-operate/network-requirements.md)
* [Retirer des agents](https://wiki.datadike.com/fr/sonar/deploy-operate/remove-agents.md)
