Guide du l'utilisateur

Documentation « Scoring »

Le logiciel Scoring est une application informatique, destinée à construire des protocoles et recueillir des données d’observations (scores, critères, données quantitatives discrètes,…). L’interface de l’utilisateur fonctionne dans un navigateur Web (elle a été travaillée sous Mozilla Firefox). Le logiciel a été développé en html, php, et nécessite l’utilisation d’une base de données de type MySQL.

Nous trouverons dans le logiciel d’aide proposé, un guide de l’utilisateur : pour la saisie des scores, et des extractions de résultats en particulier, ainsi qu’un guide du développeur : nécessaire à l’élaboration de protocoles. Ils seront complétés par un travail épistémologique sur la méthode employée.

Guide de l'utilisateur

Le menu principal de l’application, situé en haut de la page web se scinde en cinq parties.

On retrouvera pour chaque menu une structure en sous-menus, les accès aux pages webse faisant par une liste de choix située dans le corps principal de la page.

Nous retrouvons un lien vers une aide contextuelle sur chaque accès. L’image ci-dessus renseigne la liste de choix de pages accessibles par le sous-menu « Protocoles » du menu Composants.

Le menu

Si nous reprenons l’analyse du menu, il se divise dans les rubriques :

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

Présentation

Donne accès aux fonctions de l'application.

Composants

Offre l’accès à trois types de composants d’observation.

On désigne par composants simples d’évaluation : les scores au sens large du terme, qui représenteront des données discrètes comme pour situer un niveau de douleur entre zéro et dix, ou bien des données de type modales à l’instar de celles nécessaires pour remplir un questionnaire à choix multiple.

Les protocoles sont l’association de plusieurs composants simples d’observation nécessaire à la réalisation d’une évaluation. Voici ci-dessous l’exemple d’un protocole de psychologie positive qui regroupe cinq scores et observations.

Les journaux sont un type particulier de composants simples, puisqu’ils représentent des fichiers textes, par exemple de fichiers «. pdf ».

Les événements

Désignent le remplissage d’un protocole pour un sujet donné, à une période déterminée.

La consultation des événements offre l’accès à des données individuelles ou groupées, en utilisant respectivement le journal des événements ou le journal des enregistrements.

Le journal des événements retrace tous les événements enregistrés dans la base :

  Le journal des événements par protocole les détaille suivant les protocoles, pour isoler un protocole en particulier.

Le journal des enregistrements renvoie sous une forme codée ou avec les libellés des champs tous les enregistrements saisis, avec les évaluations. Export sous format ‘.csv’ en un clic.

Renseigner La liste complète des événements à renseigner est accessible par ce sous-menu, il suffit de rechercher un élément par Ctrl+F3, et de cliquer sur le lien « saisie » dans la colonne « Renseignement ».

Les paramètres

Ils représentent les acteurs, les questions, les réponses et les périodicités d’applications d’un composant.

Les acteurs sont de plusieurs sortes, suivant leur rôle relativement à l’application. On distinguera : les sujets, les opérateurs de saisie, les moniteurs, les investigateurs, et l’administrateur. Ils posséderont des privilèges particuliers relativement aux droits des utilisateurs. Si les opérateurs de saisie sont responsables du recueil effectif des données dans l’application, les moniteurs suivront le bon déroulement d’une étude, tandis que les investigateurs auront la possibilité de monter des protocoles. L’administrateur étant le responsable de l’utilisation du logiciel dans sa globalité.

Par cette liste d’acteur, il est possible d’affecter un sujet à un protocole d’évaluation. Il suffit de cliquer sur le lien « Ajout » dans la colonne « Affectation protocole ».

En procédant ainsi, l’utilisateur se trouve dirigé vers une fiche où est indiquée la liste des protocoles pour lesquels le sujet est pris en compte.

En sélectionnant dans la boîte de liste le protocole et en validant, on procède à une nouvelle affectation. Un sujet peut donc être incorporé dans plusieurs protocoles d’évaluation. Les questions et réponses sont des jeux de données qui serviront à mettre en place des composants simples d’observation. L’avantage du logiciel est d’une part de pouvoir importer des jeux de questions, et de réponses directement dans la base via des fichiers « .csv » (sous un tableur comme Excel par exemple) pour pouvoir les utiliser sans procéder à une saisie par l’applicatif. Ainsi des groupes d’utilisateurs travaillant sur des bases de données distinctes, auront la possibilité d’exporter pour d’autres groupes des jeux de questions et de réponses.

Le jeu des questions-réponses est accessible via un lien, on vérifiera par ce moyen l’existence d’un jeu à réutiliser par exemple.

L’import de fichiers de questions déjà travaillé sur un tableur (Excel par exemple) accélère le traitement.

La périodicité est un paramètre pour certains suivis. Elle stipule à quelle périodicité un composant est renseigné rapporté à une date d’événement initial.

Session

Elle doit être nécessairement ouverte pour avoir un accès à la base de données. 

Il convient de procéder à la création d’un compte, pour une première utilisation. Un rôle leur sera attribué par l’administrateur. Pour valider la création d’un compte cela nécessite deux opérations : D’une part vous devez avoir été enregistré en tant qu’acteur de l’application par une personne possédant les droits. Ensuite vous devez utiliser le logiciel, en cliquant que « Créer un compte »

Indiquez vos : nom, prénom, adresse électronique et mot de passe. Il faudra confirmer ce dernier. Une fois validé, un mail de confirmation vous sera envoyé automatiquement.

Si vous n’avez pas réalisé la première étape, l’administrateur pourra finaliser l’ouverture du compte, une fois l’activation effectuée de votre part.

Renseigner un événement

Pour remplir la fiche d’observation, il suffit alors de sélectionner les items en ouvrant les boîtes de liste déroulantes.

Evaluation

L’accès se fait par :

Il est possible d’évaluer un composant pour un sujet donné en cliquant sur « Journal des événements ».

Où d’extraire l’ensemble des résultats pour un (groupe) de sujets en cliquant sur « Journal des enregistrements » pour un retraitement sous un tableur.

Aller à la liste des acteurs pour voir l’identifiant de l’acteur. Nous allons associer le sujet Lambda ARTEMIS, identifié au n° de référence 226 à un protocole.

Puis après avoir édité la fiche « Liste de protocoles », par le menu Composants, et le sous menu « Protocoles », nous sélectionnons la page « Liste » dans le corps principal de la page.

On sélectionne le protocole retenu par son identifiant, et l’on valide en cliquant sur la touche « Envoyer ». Il s’ouvre la page correspondant au protocole : « Edition d’un protocole », qui se décompose en trois parties, on se positionne sur la troisième partie, où l’on voit que l’acteur n’est pas inclus dans la liste des sujets affectés au protocole. Il est nécessaire de l’ajouter à la liste en indiquant son identifiant et en cliquant sur la touche « Envoyer ».

En appuyant, après la validation sur la touche page arrière du navigateur et en rafraîchissant, on vérifie que le sujet est dans la base.

Associer un sujet à un protocole

On a plusieurs possibilités pour associer un sujet à un protocole. Cela dépend du volume de sujets affectés et de la fréquence des insertions.

Via la liste des protocoles

==== Renseigner un protocole ou un composant simple d’un protocole pour un sujet donné====. Il suffit de cliquer sur le lien « Renseigner composant » sur la ligne du sujet concerné, dans la grille renseignant les sujets affectés au protocole. Nous arrivons pour la patient Lambda Artemis à la fiche ci-dessous Où quatre scores ont été liés au protocole « Bipolarité ».

Il suffit de cliquer sur chacune des lignes pour procéder à la saisie du score.