# Créez et peuplez une liste

***

## Créer une liste

{% embed url="<https://youtu.be/5sN4rtr5CZo>" %}

Avant de pouvoir exploiter tous vos précieuses informations, il faut commencer par **créer une liste**. C'est au sein de ces listes que seront stockées toutes vos données.

**1 -** On se rend dans l'onglet **Listes** dans le menu de gauche.

**2 -** On clique sur le bouton **Ajouter une liste** et on la nomme. Dans notre exemple, on l'appellera **liste-des-membres**. On valide avec le bouton vert **Ajouter la liste**.

{% hint style="warning" %}
**Attention :** le nom d'une liste ne doit pas comporter d'espaces, de majuscules ou de caractères spéciaux.
{% endhint %}

**3 -** On clique sur la **liste** que l'on vient de créer.

**4 -** On clique sur **Ajouter une colonne**, à droite des champs déjà présents.

{% hint style="info" %}

#### c\_at, u\_at, ID du créateur <a href="#c_at-u_at-id-du-createur" id="c_at-u_at-id-du-createur"></a>

Ces 3 champs seront toujours présents dans les tables de données.

**c\_at** = Date de création de la donnée

**u\_at** = Date de dernière mise à jour de la donnée

**ID du créateur** = L'identifiant unique (ID) du compte utilisateur qui a créé cette donnée
{% endhint %}

**5 - On choisit le nom** de la colonne. Pour plus de clarté, allons au plus court.

**6 -** On sélectionne le **format de la colonne** :

* Texte ;
* Nombre : choisir ce format uniquement si on veut faire des calculs avec ce champ) ;
* Vrai/Faux : qui correspond à une case à cocher ;
* Image : pour téléverser des images dans votre base de données (par exemple, la photo d'un membre de votre organisation) ;
* Document : pour téléverser des fichiers importants et autres pièces justificatives ;
* Date ;
* Date avec heure.

**7 -** Si besoin, choisir éventuellement une **valeur par défaut**.

**8 -** On valide en cliquant sur **Ajouter**.

{% hint style="success" %}
Maintenant, répétez ces étapes autant de fois que de colonnes nécessaires. Le nombre de colonnes dépend de la structure de votre base de données externe et des données spécifiques que vous souhaitez utiliser.
{% endhint %}

***

## Peupler une liste&#x20;

{% embed url="<https://youtu.be/VMoT3mKWjrc>" %}

Pour faire apparaître de la donnée dans Kis, il est nécessaire de peupler notre liste.&#x20;

**1 -** Dans la liste que l'on vient de créer, on clique sur **Import CSV**. Deux étapes s'affichent.

**2 -** On commence sur **télécharger le modèle**. On reçoit alors un modèle CSV dans lequel on pourra ajouter nos données ou formater notre fichier de la même manière.

**3 -** Une fois le template CSV remplit avec nos données, **on dépose ou on importe le fichier** dans la fenêtre dédiée.

{% hint style="warning" %}
**Format du CSV :**&#x20;

Il faut vous assurer de formater votre fichier de la même manière que le modèle sinon Kis ne pourra le reconnaitre et donc l'exploiter.&#x20;

Téléchargez le modèle et assurez vous de :&#x20;

* Supprimer les lignes vides&#x20;
* Faire attention au format des dates. Bon format : **AAAA-MM-JJ**
* Sélectionner toute la liste et la mettre en format “texte”
  {% endhint %}

**4 -** Lorsque le fichier est téléversé, on clique sur **Mettre à jour les données**. Elles apparaissent maintenant dans notre liste. Prenez le temps de vérifier directement dans le tableau que tout s'est bien passé.

{% hint style="info" %}
**A savoir :**&#x20;

* Si des données sont déjà présentes dans la base de données, elles viendront s'ajouter.&#x20;
* Si l'on veut remplacer des données existantes, il faut préalablement supprimer les données de la liste en question.&#x20;
* S'il reste encore une ou quelques lignes de vides, les supprimer une par une.&#x20;
  {% endhint %}