Guide du l'utilisateur du logiciel Scoring

Présentation

Le logiciel Scoring est une application web destinée à construire des protocoles et à recueillir des données d'observation (scores, critères, données quantitatives discrètes, etc.). C'est un moteur d'évaluation générique : les exemples de cette documentation sont pris dans le domaine de la santé, mais l'outil s'applique à tout contexte où l'on procède à des évaluations.

L'interface fonctionne dans un navigateur web (développée et testée sous Mozilla Firefox). Le logiciel est écrit en HTML et PHP et s'appuie sur une base de données MySQL.

Fichier:Présentation-scoring.png

Cette documentation constitue le guide de l'utilisateur (saisie des scores et extraction des résultats). Un guide du développeur, consacré à l'élaboration des protocoles, pourra le compléter ultérieurement.

Guide de l'utilisateur

Le menu principal

Le menu principal, situé en haut de chaque page, se divise en cinq rubriques :

1. Présentation
2. Composants
3. Événements
4. Paramètres
5. Session

Chaque rubrique propose des sous-menus ; l'accès aux pages se fait ensuite par une liste de choix affichée dans le corps de la page. Un lien vers une aide contextuelle est disponible sur chaque page.

Les rôles des acteurs

Votre rôle (Administrateur, Investigateur Principal, Investigateur, Moniteur ou Sujet) détermine les actions autorisées. Les opérations de paramétrage et de saisie sont réservées aux investigateurs et administrateurs ; les rôles Moniteur et Sujet ont un accès restreint.

• Sujet — la personne (ou l'entité) évaluée.
• Moniteur — suit le bon déroulement d'une étude.
• Investigateur — peut construire des protocoles.
• Administrateur — responsable de l'utilisation du logiciel dans sa globalité.

La saisie effective des données est assurée par les acteurs autorisés.

Session, création et réinitialisation d'un compte

Ouvrir une session

Une session doit obligatoirement être ouverte pour accéder à la base de données.

Créer un compte

Pour une première utilisation, cliquer sur « Créer un compte », puis renseigner nom, prénom, adresse électronique et mot de passe (à confirmer).

1. Le mot de passe doit comporter entre huit et soixante-quatre caractères (lettres, chiffres ou symboles).
2. Valider le formulaire : un acteur est automatiquement créé et rattaché au compte, en rôle « Moniteur » par défaut (l'administrateur peut ensuite ajuster ce rôle).

   

Une fois le formulaire validé, un courriel de confirmation est envoyé automatiquement à l'adresse indiquée.

Le compte n'est utilisable qu'après avoir cliqué sur le lien d'activation reçu par courriel.

Réinitialiser son mot de passe

En cas d'oubli, le mot de passe peut être réinitialisé sans intervention de l'administrateur.

1. Sur la page d'identification, cliquer sur « Mot de passe oublié ? Réinitialiser mon mot de passe ».

2. Saisir l'adresse électronique du compte, puis valider. Un message confirme qu'un courriel a été envoyé si un compte correspond à cette adresse.

3. Ouvrir le courriel reçu et cliquer sur le lien (valable une heure).
4. Choisir un nouveau mot de passe (entre huit et soixante-quatre caractères), le confirmer, puis valider.

5. Se reconnecter avec le nouveau mot de passe.

Le lien de réinitialisation expire au bout d'une heure ; passé ce délai, il suffit de refaire une demande. Pour des raisons de confidentialité, le message affiché après la demande est identique, que l'adresse corresponde ou non à un compte existant.

Les composants

La rubrique « Composants » donne accès à trois types de composants.

Composants simples d'évaluation

Les « scores » au sens large : données discrètes (par exemple un niveau de douleur de 0 à 100) ou données modales (par exemple les items d'un questionnaire à choix multiple).

Protocoles

Un protocole associe plusieurs composants simples nécessaires à une évaluation. Exemple : un protocole de psychologie positive regroupant cinq scores et observations.

Journaux

Les journaux sont un type particulier de composant : ils correspondent à des fichiers (par exemple des fichiers « .pdf »).

Ajouter un fichier à un journal

Depuis la page « Journaux », le lien « Ajouter un fichier aux journaux » ouvre un formulaire permettant de déposer un fichier dans un dossier existant ou dans un nouveau dossier.

1. Choisir le dossier de destination dans la liste, ou saisir le nom d'un nouveau dossier à créer.
2. Sélectionner le fichier à ajouter (images, PDF, texte, CSV, documents bureautiques, ZIP).
3. Cliquer sur « Ajouter le fichier ».

Les paramètres

La rubrique « Paramètres » regroupe les acteurs, les questions, les réponses et les périodicités d'application d'un composant.

Acteurs

La liste des acteurs permet notamment d'affecter un sujet à un protocole (voir ci-dessous).

Affecter un sujet à un protocole

1. Dans la liste des acteurs, cliquer sur « Ajout » dans la colonne « Affectation protocole », sur la ligne du sujet voulu.
2. La fiche affiche la liste des protocoles auxquels le sujet est déjà rattaché.
3. Sélectionner un protocole dans la liste déroulante, puis valider.

   

Un même sujet peut être incorporé dans plusieurs protocoles.

Questions et réponses

Les questions et les réponses sont les jeux de données servant à construire les composants simples. On peut les saisir dans l'application ou, plus rapidement, importer des fichiers « .csv » préparés sous un tableur (Excel, par exemple). Des groupes travaillant sur des bases distinctes peuvent ainsi s'échanger des jeux de questions et de réponses.

Un lien permet de consulter un jeu existant, par exemple pour vérifier s'il est réutilisable.

Périodicités

La périodicité indique à quelle fréquence un composant est renseigné, par rapport à une date d'événement initiale. Elle sert aux suivis dans le temps.

Renseigner un événement

Un événement désigne le remplissage d'un protocole pour un sujet donné, à une période déterminée.

La liste des événements à renseigner est accessible par le sous-menu « Renseigner » de la rubrique « Événements » (recherche rapide avec Ctrl+F).

Pour saisir une observation :

1. Repérer la ligne du sujet et de la période concernés.
2. Cliquer sur le lien « Saisie » dans la colonne « Renseignement ».
3. Renseigner chaque item à l'aide des listes déroulantes, puis valider.

   

Pour un protocole, on peut aussi renseigner composant par composant : depuis la grille des sujets affectés au protocole, cliquer sur « Renseigner composant » sur la ligne du sujet, puis cliquer sur chaque ligne pour saisir le score correspondant.

Consulter les résultats

On peut consulter les résultats de façon groupée ou individuelle. L'accès se fait par la rubrique « Événements », sous-menu « Consulter » :

• le journal des événements donne accès aux données individuelles ;
• le journal des enregistrements donne accès aux données groupées.

Le journal des enregistrements restitue tous les enregistrements saisis — sous forme codée ou avec les libellés des champs — accompagnés des évaluations, et permet un export « .csv » en un clic, pour retraitement sous tableur.

Résultats groupés

1. Rubrique « Événements » → sous-menu « Consulter ».
2. Dans le corps de la page, cliquer sur « Journal des protocoles ».

   

3. Cliquer sur un protocole : la liste des composants qu'il contient s'affiche.

   

Les résultats peuvent être visualisés sous plusieurs formats, avec ou sans libellés.

Exemple de résultats groupés pour un composant simple :

Résultats individuels

1. Ouvrir la liste des acteurs (menu « Paramètres » → « Acteurs » → page « Liste »).

   

2. Pour le sujet voulu, cliquer sur « Liste affectations » dans la colonne « Protocoles affectés ».
3. Sélectionner le protocole dont on souhaite visualiser les composants évalués.

   

4. Cliquer sur le protocole : le nom du sujet apparaît en tête de page.

   

On peut choisir d'afficher les résultats avec ou sans les libellés des réponses ou des questions.