# BONNES PRATIQUES

## Avant de créer votre application

#### Préparez vos données

* Identifiez dès le départ les **colonnes essentielles de votre** [**table de données**](https://doc.kis.work/documentation/guide-de-demarrage/importez-vos-donnees-dans-kis/creez-et-peuplez-une-liste).
* Choisissez des **noms courts et explicites**.
* Respectez les règles de rédaction : **pas d'espace, pas de majuscule, pas de caractères spéciaux**. Utilisez des tirets, par exemple, "liste-des-membres".
* Vérifiez que vous avez sélectionné les **bons formats** : texte, nombre, date, oui/non, etc.

{% hint style="warning" %}
Soyez vigilants lors de la création des colonnes : vous ne pourrez pas les modifier ensuite.

**Vous devrez les supprimer puis les recréer en cas d’erreur**.
{% endhint %}

#### Si vous importez des données via CSV

* Téléchargez d'abord le **modèle CSV fourni par Kis**.
* Supprimez toutes les **lignes vides** de votre fichier.
* Vérifiez le **format des dates** (AAAA-MM-JJ).

{% hint style="success" %}
Côté utilisateur, il est également possible d'importer des fichiers CSV dans Kis. En tant qu'administrateur, pensez à leur fournir le bon modèle de fichier.
{% endhint %}

## Pendant la création de votre application

#### Enregistrez régulièrement

* Enregistrez après chaque **modification importante**.
* Enregistrez d'abord sur **le bouton situé en haut de la colonne des composants.** Dans un second temps, pour plus de sécurité, vous pouvez également enregistrer via **le bouton en haut, à droite de votre page**.

{% hint style="warning" %}
Pour éviter toute mauvaise surprise, **ne prenez pas de risques** : un clic de plus ne coûte rien !
{% endhint %}

### Travaillez étape par étape

* Créez d’abord une **version “simple”** de votre page.
* Ajoutez ensuite les **fonctionnalités plus avancées**.
* Pensez à **dupliquer vos pages fonctionnelles** si vous souhaitez **expérimenter et tester** des modifications importantes.

#### Facilitez la navigation entre vos pages

* **Nommez clairement** vos pages.
* **Regroupez-les par thèmes :** utilisez des titres de menu pour séparer les grandes sections de votre page.
* **Masquez les pages qui n'ont pas besoin d'être visibles dans le menu :** par exemple, des pages contenant des formulaire de modifications, accessibles depuis un bouton d’action dans une autre page.

### Reliez correctement vos données

Pour que vos pages et composants affichent les bonnes informations :

* Créez d'abord la **source de données** dans l'onglet **Données** de votre page.
* **Nommez votre source de données clairement** (ex : "Liste des adhérents", "Postes des salariés").
* Liez votre **source de données** à la votre **table de données**.
* Dans vos composants, **liez vos champs à la bonne colonne** de votre table de données.
* **Vérifiez bien vos actions** : une erreur de liaison, ce sont des données qui n'apparaissent pas.

{% hint style="warning" %}
Attention à ne pas confondre table de données et source de données.

La table sert à stocker les données qui seront renseignées. Pour la nommer, vous ne pouvez pas utiliser d'espaces, de majuscules ou caractères spéciaux.

La source de données se crée dans votre page et permet de faire le lien entre vos composants et la table de données. Vous pouvez la nommer librement, de manière explicite.
{% endhint %}

### Différenciez Création et Édition de données

* **Création de données :** sélectionnez ce mode quand vous voulez ajouter de nouvelles entrées dans votre table de données.
* **Édition de données :** sélectionnez ce mode quand vous voulez modifier des données existantes. Pensez à utiliser la [**balise \[data\_in: ...\]**](https://doc.kis.work/documentation/guide-de-demarrage/donnees-dynamiques/balises) pour récupérer les valeurs actuelles de la page précédente.

## Après la création de votre application

### Testez systématiquement côté utilisateur

Avant de partager votre application :

* Connectez-vous sur [**app.kis.work**](https://app.kis.work) avec un compte utilisateur test.
* **Vérifiez** [**tous les composants**](https://doc.kis.work/documentation/composants) **:** créez, modifiez, supprimez des données.
* **Testez tous les boutons :** les redirections fonctionnent-elles correctement ?

### Vérifiez vos tables de données

Après avoir testé votre application :

* Retournez dans **Kis Data** (onglet **Données**) pour vérifier que les **données sont bien enregistrées**.
* **Supprimez les lignes vides** qui auraient pu se créer.
* **Vérifiez les formats :** les dates, les cases cochées, les nombres sont-ils corrects ?

### Utilisez les attributs pour personnaliser l'expérience

Offrez à chaque utilisateur une vue adaptée :

* **Créez des** [**attributs d'utilisateurs**](https://doc.kis.work/documentation/gestion-des-droits-dacces/tags) **pertinents :** poste, équipe, zone géographique, niveau d'accès.
* **Filtrez les données :** chacun ne voit que ce qui le concerne.
* **Renforcez la sécurité :** limitez l'accès aux informations sensibles.

{% hint style="success" %}
Conseillez aux utilisateurs d’utiliser les **filtres des tableaux** en choisissant un **opérateur** (“égal à…”, “supérieur à…”) et une **valeur**.
{% endhint %}

### Ajoutez des onboardings

Facilitez la prise en main des utilisateurs :

* **Ajoutez des** [**onboardings**](https://doc.kis.work/documentation/gestion-des-droits-dacces/gestion-des-utilisateurs#onboarding) sur les pages pour guider les nouveaux utilisateurs.
* **Soyez concis :** un titre clair et quelques lignes d'explication suffisent.
* **Pensez aux cas d'usage :** expliquez pourquoi cette page existe et comment l'utiliser.

## Quelques petites astuces supplémentaires

### Personnalisez vos apps au maximum

* **Ajoutez des icônes** à vos pages pour une navigation plus intuitive.
* **Renseignez les descriptions de vos applications**, elles apparaîtront dans l'interface utilisateur.
* Personnalisez vos applications avec vos **photos, images ou logos** pour renforcer l'identité de votre organisation.
* Adaptez les **textes des boutons d’action** pour qu'ils soient explicites.

### Évitez les erreurs courantes

* **Ne confondez pas le composant Tableau et les tables de données :** le premier est un composant graphique qui affiche vos données alors que la table stocke toutes vos précieuses informations.
* N'oubliez pas de [**créer vos utilisateurs**](https://doc.kis.work/documentation/gestion-des-droits-dacces/gestion-des-utilisateurs#creez-vos-utilisateurs) **puis de leur** [**donner accès aux applications**](https://doc.kis.work/documentation/gestion-des-droits-dacces/gestion-des-utilisateurs#attribuer-les-acces-aux-applications) : ce sont deux étapes distinctes.

{% hint style="danger" %}
**Attention aux suppressions :** supprimer une table de données ou une application est **irréversible**.
{% endhint %}