.. note::
Cette documentation est en cours de redaction. Pour toutes questions n'hésitez pas à nous envoyer un email sur `community@risefor.org `_
ou à ouvrir un ticket `directement sur git `_
**********************
5. Gestion des élues
**********************
.. warning::
Seule les adresses présente dans cette la liste "Approuved emails" seront utilisé comme **destinataire des emails au sein d'une action**.
Quand vous ajoutez de nouveaux élues, pensez à mettre la liste à jour !
.. admonition:: Evolution en préparation
La fédération de la base de données des élues sera bientôt fédéré; Vous pourrez vous connecter directement à la base d'une autre instance
.. contents:: Table des matières
:local:
:depth: 2
==============
Description de la section
==============
La base de données d'élues vous permet d'associer vos actions à des cibles. Si aucun élues n'est en ligne, vous n'aurez pas de cibles dans vos actions.
==============
Retrouver les élues de mon instance
==============
1. Connectez vous à la section "Admin"
2. Recherchez le terme "Representatives"
.. image:: https://git.risefor.org/installation/readthedocs/-/raw/main/docs/images/admin/Screenshot%202024-03-25%20at%2016.34.08.png
:width: 100%
:alt: Alternative text
3. Cliquez dessus
.. image:: https://git.risefor.org/installation/readthedocs/-/raw/main/docs/images/admin/Screenshot%202024-03-25%20at%2016.35.11.png
:width: 100%
:alt: Alternative text
Vous êtes maintenant sur la page affichant tous les élues présent sur l'instance.
D'ici vous pouvez ajouter, modifier, filtrer ou supprimer les élues.
==============
Modifier un élu
==============
.. warning::
doc a faire
==============
Ajouter des élues
==============
Pour ajouter des élues vous avez 2 options
1. Ajouter 1 élue à la fois
2. Téléverser des élues par csv
Ajouter 1 élue manuellement
----------------
.. warning::
doc a faire
Téléverser une liste d'élues
----------------
.. warning::
Pour les utilisateurices de l'instance **agir.risefor.org**, veuillez nous contacter avant de charger une liste d'élues !
.. list-table::
* - Format du fichier
- csv
* - Séparateur utilisé
- ``,``
* - Colonnes nécessaires
- `Retrouvez un exemple de fichier ici `_
Vous pouvez uploader une liste d'élues directement depuis un fichier csv.
Pour ce faire, depuis la page listant les élues, cliquez sur le bouton ``Importer des élues avec un CSV`` situé en haut à droite de votre écran
Vous serez redirigé sur la page suivante :
.. image:: https://git.risefor.org/installation/readthedocs/-/raw/main/docs/images/admin/Screenshot%202024-03-25%20at%2016.36.08.png
:width: 100%
:alt: Alternative text
Il vous reste à :
1. Cliquez sur le bouton ``Choose file`` (ou choisir le fichier)
2. Selectionner votre ficher, et valider
3. Cliquez sur 'Charger les élues'
Une fois que vous avez cliquer sur "charger les élues", le chargement commence. Si vous avez accès aux logs, vous pouvez les observer pour voir le détails du chargement.
Dans le cas contraire, vous pouvez retourner sur la page précédente, vous y verrez le total d'élues.
Si vous rafraichissez, vous verrez le total augmenter :)
.. warning::
Vous voyez une erreur "Server Time Out" s'afficher au bout d'un moment.
Pas d'inquiétude, le chargement continue ! Si vous allez sur la page de listing des élues, et rafraichissez, vous verrez le total augmenter.
----------------
Erreurs connues
----------------
**413 Request Entity Too Large**
.. image:: https://git.risefor.org/installation/readthedocs/-/raw/main/docs/images/admin/Screenshot%202024-03-18%20at%2018.51.24.png
:width: 100%
:alt: Alternative text
Nginx vous dis que le fichier que vous cherchez à téléverser est trop gros.
Dans ce cas :
1. Connectez vous à votre serveur
2. Ouvrez le fichier ``/etc/nginx/sites-available/votre-site.conf``
3. Ajouter la ligne ``client_max_body_size 20M;`` (vous pouvez augmenter à plus de 20M si vous le souhaitez)
**Server Time Out**
Une page bien moche s'affiche avec un code peu comprehensible mais qui dit globalement qu'il y a eu un "time out"
Dans ce cas, **aucun soucis !**, les élues sont en cours de création.
Vous pouvez retourner vers la page de listing des élues, une fois fini vous aurez un message de confirmation qui s'affichera.
.. tip::
Pour suivre le chargement, le total des élues en visible au pied du tableau. Vous pouvez rafraichir l'onglet afin de vous assurer que le nombre augmente bien |:smile:|
**Key Error at ....**
.. image:: https://git.risefor.org/installation/readthedocs/-/raw/main/docs/images/admin/Screenshot%202024-03-18%20at%2018.50.33.png
:width: 100%
:alt: Alternative text
Une autre page bien moche s'affiche avec un code peu comprehensible mais le premier mot en haut à droite est 'KeyError'
Dans ce cas, à priori votre fichier csv n'est pas bien formaté, vérifiez si :
1. Les colonnes nécessaires sont bien présentes
2. Vous utilisez le bon séparateur de colonnes (``,``)
Si votre problème persiste, n'hésitez pas à nous contacter sur community@risefor.org
==============
Mise à jour des emails approuvés
==============
.. important::
Seule les adresses présente dans cette liste pour être utilisé comme **destinataire des emails au sein d'une action**
.. list-table::
* - Disponible depuis
- Octobre 2023
Si vous avez mis à jours votre base d'élues, vous devez vous assurez que les emails associés sont dans la liste d'emails validés.
Pour ceci, naviguez à la page ``Approved emails`` :
1. Depuis l'acceuil en cliquant sur "Approved emails"
2. En tapant directement l'url, en ajoutant ``/admin/risefor_lobbying/approvedemail/`` après votre nom de domaine
.. image:: https://git.risefor.org/installation/readthedocs/-/raw/main/docs/images/admin/Screenshot%202024-03-18%20at%2017.59.59.png
:width: 100%
:alt: Alternative text
Une fois sur cette page, cliquez sur le bouton ``METTRE À JOUR LA LISTE APPROUVÉE D'EMAIL`` en haut à droite
Vous serez redirigé vers une page avec :
1. La confirmation de la mise à jour
2. Le nombre d'email mis à jour, ou ce message si aucun email n'a été ajouté
.. image:: https://git.risefor.org/installation/readthedocs/-/raw/main/docs/images/admin/Screenshot%202024-03-25%20at%2016.40.13.png
:width: 100%
:alt: Alternative text