{% extends "admin/base_site.html" %} {% load i18n %} {% block extrahead %} {{ block.super }} {% endblock %} {% block breadcrumbs %}{% endblock %} {% block content %}

Aide de l'application

Cette page regroupe les informations sur l'utilisation de votre application de gestion de contacts GABNOR.

Sommaire

  1. Les données de l'application
    1. Différentes classes d'objet
    2. La classe de Auth
    3. Les classes de Contacts
    4. Les classes de References
  2. Appliquer des actions sur une sélection de contacts
    1. Le filtrage des listes de contacts
    2. Sélectionner des contacts et leur appliquer une action
      1. Sélectionner des contacts et les ajouter au panier
      2. Ajouter tous les contacts au panier
      3. Effectuer une action sur les contacts du panier
      4. Les différents paniers
  3. Notes particulières
    1. Particularité à noter dans la suppression d'un projet bio
  4. Crédits et technologies

Les données de l'application

Différentes classes d'objet

Cette application vous permet de gérer des contacts, ainsi que des données métiers des agriculteurs suivis. Pour cela, elle définit plusieurs classes d'objets dont vous voyez la liste sur le tableau de la page d'accueil.

Les classes d'objets sont réparties en trois catégories Auth, Contacts, et References :

Auth
Cette catégorie regroupe uniquement la classe des utilisateurs de l'applications, qui ne représente pas directement des données de l'application.
Contacts
Dans cette catégorie sont définies les classes les plus importantes de l'application qui représentent les contacts et leurs données associées.
Reference
Les classes de cette catégorie réprésentent des choix disponibles dans des listes déroulantes figurant dans les objets des classes principales.

La classe de Auth

La catégorie Auth se limite à la classe Utilisateurs qui définit les utilisateurs ayant le droit d'accès à l'application. Voici les informations à noter concernant ces utilisateurs:

Les classes de Contacts

Cette classe définit les objets les plus importants de l'application.

Comme le suggère ces descriptions des classes Structures, Agriculteurs, et Agriculteurs biologiques, il existe une relation d'héritage entre elles: un « Agriculteur » est également considéré comme un « Structure », et « Agriculteur biologique » est aussi considéré comme un « Agriculteur », ainsi qu'une « Structure ».

Il en découle que vous retrouverez tous les « Agriculteurs biologiques » dans la liste des « Agriculteurs », et tous les « Agriculteurs biologiques » et les « Agriculteurs » dans la liste des « Structures ».

Notez que dans les listes des « Structures », « Agriculteurs », et « Agriculteurs biologiques », la case « Rechercher » en haut de page permet de limiter l'affichage aux objets dont le mot saisi fait partie du nom de la structure (champ désignation), ou bien du nom d'une personne associée à cette structure, ou bien du nom de la commune associée à cette structure.

Il existe aussi d'autres classes annexes dans la catégorie Contacts:

Les classes de References

Ces classes représentent des données qui apparaissent dans les différentes classes de Contact.

Appliquer des actions sur une sélection de contacts

Pour effectuer une action sur un ensemble de contacts, il est nécessaire de les sélectionner dans une liste qui peut avoir été préalablement filtrée pour les ajouter à un panier (semblable à un panier d'achat) sur les éléments duquel sera effectuée l'action sélectionnée.

Le filtrage des listes de contacts

Les listes de contacts peuvent disposer de deux types de filtres qui permet de réduire la liste des contacts affichée :

Sélectionner des contacts et leur appliquer une action

Une fois le filtrage de la liste effectué, vous pouvez sélectionner tous ou une partie des contacts et leur appliquer une action.

Sélectionner des contacts et les ajouter au panier

Pour sélectionner manuellement certains contacts, cliquer la case à gauche de leur ligne, puis les ajouter au « panier » de contacts sélectionnés en choisisant l'action « Ajouter les éléments sélectionnées au panier » dans la liste déroulante « Action » en haut de la liste. Enfin, cliquer sur le bouton « Envoyer » pour les ajouter au panier.

Ajouter tous les contacts au panier

Si vous voulez ajouter au panier tous les contacts de la liste: cochez la case de gauche dans la barre des titres de la liste (la toute première case de sa colonne). Ceci sélectionnera toutes les cases de la page actuellement affichée. Si vous souhaitez sélectionner tous les contacts de toutes les pages, cliquez ensuite sur le lien « Sélectionner tous les 256 agriculteurs biologiques » (par exemple), sinon seuls les contacts de la page en cours seront ajoutés au panier. Choisissez ensuite normalement l'action « Ajouter les éléments sélectionnées au panier » dans la liste déroulante « Action » en haut de la liste, puis cliquez sur le bouton « Envoyer ».

Effectuer une action sur les contacts du panier

Lorsqu'au moins un élément est présent dans le panier, une ligne du haut de la liste signale le nombre d'éléments dans le panier, et fourni un lien permettant de visualiser le contenu du panier, un autre de le vider, et une liste déroulante permet de sélectionner une action à effectuer sur les éléments du panier qu'on lancera en cliquant sur le bouton « Lancer ».

Voici les actions possibles sur le contenu du panier :

Les différents paniers

Plusieurs paniers distincts sont utilisés par les différentes listes d'objets, car les actions s'effectuant sur tous les objets d'un panier, il est nécessaire que les objets soient tous d'un type compatible avec l'action choisie.

L'utilisation des différents paniers est entièrement transparente pour vous : lorsque vous ajoutez une sélection d'objets à un panier, ceux-ci sont automatiquement ajoutés au panier qui leur correspond. Lorsque vous lancez une action, celle-ci est effectuée sur la panier correspondant au type d'objet de la page utilisée. Voici les paniers existants et les objets qu'ils peuvent contenir. Lorsque vous

L'utilisation d'un panier commun à tous les objets représentant un contact permet d'effectuer une action à un mélange d'objets de types différent : dans une même sélection vous pouvez ainsi mélanger des personnes et des structures et générer des étiquettes ou envoyer un courriel à tous ces contacts en même temps.
Exception à noter : les listes de champs des objets « Personne » étant différentes de celles des objets « Structure », l'exportation complète en CSV doit différencier ces deux types d'objets, c'est pourquoi chacun dispose d'une action dédiée (décrite plus haut dans cette page).

Notes particulières

Particularité à noter dans la suppression d'un projet bio

Lors de la suppression d'un projet bio sur la page d'un agriculteur, il est nécessaire de supprimer auparavant tous les rendez-vous de suivi qui s'y rapportent (sinon une une page d'erreur s'affiche).

Pour cela, cochez les cases « Supprimer » des rendez-vous relatifs au suivi à supprimer, puis Cliquez sur le bouton « Enregistrer et continuer les modifications ». La page de l'agriculteur s'affiche à nouveau, et vous pouvez maintenant cocher la case « Supprimer » du projet bio concerné, puis cliquer sur le bouton « Enregistrer ».

Cette limitation n'est pas présente lorqu'on supprime un projet bio en passant par la liste des projets bio: en cliquant sur le lien en rouge « Supprimer » en bas de page, le projet et ses rendez-vous sont supprimés ensemble (après demande de confirmation).

Crédits et technologies

Cette application a été développée par Cliss XXI et utilise le language libre Python et le framework libre Django.

{% endblock content %}