# 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**](/documentation/guide-de-demarrage/importez-vos-donnees-dans-kis/creez-et-peuplez-une-liste.md). * 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: ...\]**](/documentation/guide-de-demarrage/donnees-dynamiques/balises.md) 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**](/documentation/composants/fil-dariane.md) **:** 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**](/documentation/gestion-des-droits-dacces/tags.md) **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**](/documentation/gestion-des-droits-dacces/gestion-des-utilisateurs.md#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. ### Utilisez les onglets * Ouvrez autant d'onglets que vous le souhaitez en haut de votre page. * Naviguez facilement entre vos différentes applications, par exemple, entre le mode administrateur et utilisateur pour voir le rendu de vos créations. ### Sélectionnez vos applications favorites * Cochez ou décochez la petite étoile à côté du titre de l’application pour ajouter cette dernière (ou la retirer) de vos favoris. * Sélectionnez rapidement une de vos applications en favoris : elles se trouvent dans le menu latéral de gauche. ### Masquez les menus latéraux pour gagner de la place sur l’écran * Cliquez sur la flèche située à la bordure du menu pour masquer ou faire apparaître la liste de toutes les pages. * Appuyez sur l’icône située en haut de la colonne de gauche pour réduire ou étendre le menu où se situent toutes vos apps et les fonctionnalités pour les administrateurs. ### É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**](/documentation/gestion-des-droits-dacces/gestion-des-utilisateurs.md#creez-vos-utilisateurs) **puis de leur** [**donner accès aux applications**](/documentation/gestion-des-droits-dacces/gestion-des-utilisateurs.md#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 %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://doc.kis.work/documentation/bonnes-pratiques.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.