Gérer les invitations d'utilisateurs

Dokos vous permet d'inviter de nouveaux utilisateurs à rejoindre votre instance via une interface dédiée. Ce guide explique comment utiliser le composant InviteUser pour envoyer des invitations par email, attribuer des rôles et suivre le statut des invitations.

Fonctionnement général

Le composant InviteUser est un bloc réutilisable qui permet :

• D'inviter un ou plusieurs utilisateurs par email
• D'attribuer des rôles spécifiques à chaque utilisateur invité
• De suivre les invitations en attente et de les annuler ou renvoyer si nécessaire
• D'exclure automatiquement les utilisateurs déjà invités ou existants

      
flowchart TD
    A[Ouvrir le composant InviteUser] --> B[Saisir les emails]
    B --> C[Attribuer des rôles]
    C --> D[Envoyer l'invitation]
    D --> E{Succès ?}
    E -->|Oui| F[Invitation envoyée]
    E -->|Non| G[Afficher l'erreur]
    F --> H[Suivre les invitations en attente]
    H --> I[Annuler ou renvoyer]

    

Utilisation du composant

Intégration dans une interface

Le composant InviteUser peut être intégré dans n'importe quelle page de votre instance Dokos. Voici un exemple d'utilisation avec les données de démonstration :

1. Ouvrir le composant : Le composant est généralement accessible depuis une page de gestion des utilisateurs ou un tableau de bord administratif.
2. Saisir les adresses email :
   • Utilisez le champ de saisie pour entrer une ou plusieurs adresses email.
   • Le composant propose une autocomplétion pour les utilisateurs existants (ex: jean@maison-verte.com).
   • Exemple : Invitez paul@bureau-moderne.fr et sophie@maison-verte.com.
3. Attribuer des rôles :
   • Sélectionnez un ou plusieurs rôles dans la liste déroulante.
   • Les rôles disponibles dépendent de votre configuration (ex: "Vendeur", "Comptable", "Administrateur").
4. Envoyer l'invitation :
   • Cliquez sur le bouton "Envoyer l'invitation".
   • Les utilisateurs reçoivent un email avec un lien pour créer leur compte.

Personnalisation du composant

Le composant InviteUser offre plusieurs options de personnalisation pour s'adapter à vos besoins :

Personnalisation des champs

Vous pouvez modifier les libellés, les messages d'erreur ou le style des champs email et rôles :

<InviteUser
  :emailProps="{
    label: 'Adresse email (obligatoire)',
    placeholder: 'ex: utilisateur@domaine.com'
  }"
  :rolesProps="{
    label: 'Rôles attribués',
    placeholder: 'Sélectionnez un rôle'
  }"
/>

Utilisation des slots

Pour une personnalisation avancée, vous pouvez remplacer entièrement le rendu des champs ou du bouton d'envoi :

<InviteUser>
  <template #email="{ emails, addEmail, removeEmail, error }">
    <div class="custom-email-field">
      <label>Adresses email personnalisées</label>
      <input
        v-for="email in emails"
        :key="email"
        :value="email"
        @input="addEmail($event.target.value)"
      />
      <button @click="removeEmail(email)">Supprimer</button>
      <div v-if="error" class="error-message">{{ error }}</div>
    </div>
  </template>
</InviteUser>

Gestion des invitations

Suivi des invitations en attente

Une fois les invitations envoyées, vous pouvez suivre leur statut :

• En attente : L'utilisateur n'a pas encore créé son compte.
• Acceptée : L'utilisateur a créé son compte.

Pour les invitations en attente, vous avez deux options :

1. Renvoyer l'invitation : Cliquez sur le bouton "Renvoyer" pour envoyer un nouvel email.
2. Annuler l'invitation : Cliquez sur le bouton "Annuler" pour supprimer l'invitation.

Exemple avec les données de démonstration

Imaginons que vous souhaitez inviter un nouveau comptable pour Maison Verte SARL :

1. Ouvrez le composant InviteUser depuis le tableau de bord administratif.
2. Saisissez l'email comptable@maison-verte.com.
3. Attribuez le rôle "Comptable".
4. Cliquez sur "Envoyer l'invitation".

Si l'invitation n'est pas acceptée sous 48h, vous pouvez la renvoyer ou l'annuler.

Bonnes pratiques

• Vérifiez les emails : Assurez-vous que les adresses email saisies sont correctes pour éviter les erreurs d'envoi.
• Attribuez les bons rôles : Limitez les rôles attribués aux besoins réels de l'utilisateur pour maintenir la sécurité.
• Surveillez les invitations en attente : Annulez les invitations non utilisées pour garder une liste propre.

Dépannage

Erreurs courantes

Support

Si vous rencontrez des problèmes avec le composant InviteUser, consultez les logs du serveur ou contactez votre administrateur système.