Dans ce tutoriel, vous apprendrez comment limiter l'autorisation d'un utilisateur à ne voir que les enregistrements liés à l'organisation pour laquelle il travaille. Pour ce faire, nous ajouterons un rôle avec un paramètre et une condition.
Avant de commencer
- Assurez-vous d'avoir déjà ajouté une base de données et
- Un rôle vous a été attribué avec les opérations « Gérer les rôles » et « Gérer les utilisateurs » autorisées.
- Sinon, vous pouvez utiliser le modèle de base de données Qui fait quoi où (3W) pour ajouter une nouvelle base de données.
Dans ce tutoriel, vous apprendrez comment limiter l'autorisation d'un utilisateur à ne voir que les enregistrements liés à l'organisation pour laquelle il travaille. Pour ce faire, nous ajouterons un rôle avec un paramètre et une condition.
Dans ce tutoriel, nous utiliserons l'exemple de la liaison des enregistrements et des autorisations aux organisations partenaires déclarantes, mais vous pouvez appliquer la même logique à n'importe quel champ de référence, tel que la province, la région ou le secteur.
Ajouter un formulaire Partenaire
Avant de commencer, nous avons besoin d'un formulaire qui contient la liste des partenaires auxquels un utilisateur peut être assigné.
- Allez dans les Paramètres de la base de données, puis dans la section Conception. Cliquez sur « Ajouter un formulaire ».
- Sur l'écran suivant, saisissez l'étiquette du formulaire comme « Organisation partenaire »
- Ajoutez un unique champ Texte appelé « Nom ». Rendez ce champ Obligatoire et un champ Clé.
- Enregistrez le formulaire.
- Vous devriez maintenant voir la vue en tableau de ce formulaire.
- Cliquez sur « Ajouter un enregistrement » pour ajouter le premier Partenaire. Dans cet exemple, nous utilisons le nom « GlobalCare », puis Enregistrer.
- Cliquez sur Ajouter un enregistrement pour ajouter chaque Partenaire, avec les noms « EduBright International », « FoodFirst Initiative », « AquaLife Foundation », « ShelterSphere », « TechAid », « EmpowerHer » et « SafeHaven Network » et après avoir ajouté ces noms de partenaires comme enregistrements, Enregistrez.
- Retournez aux Paramètres de la base de données.
Ajouter un formulaire pour les rapports de progression mensuels
Pour appliquer une autorisation conditionnelle sur les formulaires, il est important que chaque formulaire ait une référence à votre formulaire Partenaire. Cela aide à établir la relation entre chaque enregistrement et le partenaire auquel il appartient.
Allez dans les Paramètres de la base de données, puis dans la section Conception. Cliquez sur « Ajouter un formulaire ».
- Sur l'écran suivant, saisissez l'étiquette du formulaire comme « Rapport de progression »
- Ajoutez un champ Mois, rendez-le obligatoire
- Ajoutez un champ Partenaire, qui fait référence au formulaire Partenaire, rendez-le obligatoire.
- Ajoutez un champ Quantité appelé « Nombre de bénéficiaires » et rendez-le obligatoire
- Enregistrez le formulaire.
- Vous pouvez ajouter quelques enregistrements pour tous les partenaires ; « GlobalCare », « EduBright International », « FoodFirst Initiative », « AquaLife Foundation », « ShelterSphere », « TechAid », « EmpowerHer » et « SafeHaven Network »
Ajouter un rôle
Nous sommes maintenant prêts à ajouter un rôle qui empêche les utilisateurs de voir et d'ajouter uniquement les enregistrements liés au partenaire auquel ils ont été assignés.
- Pour configurer les rôles dans votre base de données, suivez ces étapes :
- Allez dans les paramètres de votre base de données. Trouvez et cliquez sur « Rôles ».
- Cliquez sur « Ajouter un rôle ».
- Saisissez le nom du rôle, tel que « Partenaire déclarant », et cliquez sur OK. Vous verrez le nouveau rôle dans une liste.
- Cliquez sur le nouveau rôle. Le rôle s'affichera dans le panneau latéral
Ajouter un paramètre de rôle
- Passez à l'onglet « Paramètres » et cliquez sur « Ajouter un paramètre »
- Remplissez l'ID du paramètre avec « partenaire » et l'Étiquette avec « Partenaire ». Sélectionnez le formulaire Partenaire que vous avez précédemment ajouté et qui contient la liste des partenaires.
- Cliquez sur Terminé.
- Le paramètre devrait apparaître dans la liste des paramètres.
Ajouter des conditions aux autorisations
L'ajout d'un paramètre seul n'a aucun effet sur les autorisations. Dans l'étape suivante, nous utiliserons le paramètre dans le cadre d'une condition pour limiter les autorisations associées au rôle.
Nous allons maintenant attribuer un ensemble d'opérations autorisées à ce rôle pour les formulaires « organisation partenaire » et « rapport de progression », qui, pour notre utilisation actuelle, constituent l'ensemble de la base de données.
Retournez à l'onglet « ressources ».
Cliquez sur « Accorder une ressource ».
Sélectionnez « Base de données entière » dans la première colonne et cliquez sur « Sélectionner la ressource »
Cochez les autorisations suivantes :
Voir
Lister
Ajouter un enregistrement
Modifier l'enregistrement
Supprimer l'enregistrement
Ensuite, en bas de la carte, cliquez sur « Gérer les conditions »
Dans la fenêtre modale qui apparaît, cliquez sur « Ajouter une règle »
- Dans la première colonne, sélectionnez « L'enregistrement est lié au paramètre »
- Dans la deuxième colonne de la règle, sélectionnez le paramètre « Partenaire » que vous venez d'ajouter
- Cliquez ensuite sur « Définir les conditions »
- Cliquez ensuite sur « Enregistrer » pour ajouter la nouvelle autorisation.
Vous avez maintenant ajouté un rôle, qui permet aux utilisateurs assignés à ce rôle de ne voir, ajouter, modifier ou supprimer que les enregistrements associés à leur partenaire.
Ajouter un utilisateur au nouveau rôle
Voyons à quoi cela ressemble pour un partenaire que vous pourriez inviter à contribuer à la progression de la base de données. Pour cette partie du tutoriel, vous pouvez vous inviter en utilisant une autre adresse e-mail, comme votre adresse e-mail personnelle, afin de voir à quoi cela ressemble pour un partenaire déclarant.
- Pour utiliser ce paramètre pour un utilisateur, allez à la section « Gestion des utilisateurs » dans les Paramètres de la base de données, puis cliquez sur « Ajouter un utilisateur »
- Ajoutez l'« e-mail » de l'utilisateur
- Ajoutez le « Nom » de l'utilisateur
- Sélectionnez le rôle « Partenaire déclarant »
- Sélectionnez la valeur spécifique pour le paramètre et
- Cliquez sur « Envoyer l'invitation » pour les inviter
Tester le rôle
Déconnectez-vous d'ActivityInfo.
En utilisant l'autre adresse e-mail que vous avez invitée, connectez-vous à l'application.
Allez à la base de données
Allez au formulaire Rapport de progression.
Vous ne devriez voir que les enregistrements appartenant au partenaire « GlobalCare ». En supposant que vous ayez défini la valeur du paramètre pour cet utilisateur sur « EduBright International », « FoodFirst Initiative », « AquaLife Foundation » ou tout autre nom de partenaire, il ne verrait que les enregistrements appartenant à ces partenaires.
Lorsque vous cliquez sur « Ajouter un enregistrement », le partenaire « Globalcare » devrait être pré-rempli, et vous ne devriez pas pouvoir sélectionner les autres partenaires.