Configuration

Configuration du composant

Le composant Object Team Member peut être configuré directement dans Lightning App Builder avec les propriétés suivantes :

Propriété	Type	Par défaut	Description
Card Title	String	Team Members	Le titre affiché sur la carte du composant
Max Displayed Members	Integer	5	Nombre maximum de membres d’équipe affichés avant réduction. Définir à 0 pour tout afficher

Lorsque le nombre de membres d’équipe dépasse la limite configurée, la liste se réduit et affiche un bouton “Show all (X more)”. En cliquant dessus, la liste complète s’affiche, avec un bouton “Show less” pour la réduire à nouveau. Le propriétaire de l’enregistrement apparaît toujours en premier dans la liste, quelle que soit la limite d’affichage.

Comportement de la limite d’affichage

Paramètre	Comportement
Max Displayed Members = 5 (par défaut)	Affiche les 5 premiers membres, “Show X more” pour le reste
Max Displayed Members = 0	Tous les membres d’équipe visibles, pas de réduction/expansion
Max Displayed Members = 3 (personnalisé)	Affiche les 3 premiers membres, “Show X more” pour le reste

Rôles des membres d’équipe

Lors de l’ajout d’utilisateurs à une équipe, vous leur attribuez l’un des rôles suivants :

Rôle	Description	Capacités
Owner	Le propriétaire de l’enregistrement	Attribué automatiquement lors de la création d’un enregistrement. Ne peut pas être attribué ou supprimé manuellement. A un accès complet pour gérer les membres d’équipe. Supprimé automatiquement lorsqu’il n’y a plus d’autres utilisateurs dans l’équipe.
Manager	Administrateur d’équipe	Peut ajouter, modifier et supprimer des membres d’équipe. Utilisez ce rôle pour les utilisateurs qui doivent gérer la composition de l’équipe.
User	Membre d’équipe standard	Peut voir la liste des membres d’équipe mais ne peut pas la modifier. Utilisez ce rôle pour les utilisateurs qui n’ont besoin que d’accéder à l’enregistrement.

Synchronisation du changement de propriétaire

Lorsque le propriétaire de l’enregistrement change (par exemple, un compte est réattribué à un autre commercial), le membre d’équipe Owner n’est PAS automatiquement mis à jour. Le système crée l’enregistrement Owner lorsque le premier membre d’équipe est ajouté, mais il ne suit pas les changements de propriétaire ultérieurs sur l’enregistrement parent.

Pour maintenir le propriétaire de l’équipe synchronisé avec le propriétaire de l’enregistrement, vous devez créer un Record-Triggered Flow.

Configuration via Flow (recommandé)

Configuration via Apex Trigger

trigger AccountOwnerSync on Account(after update) {
  List<tucariofts.SyncOwnerInvocable.SyncOwnerRequest> requests =
    new List<tucariofts.SyncOwnerInvocable.SyncOwnerRequest>();

  for (Account acc : Trigger.new) {
    Account oldAcc = Trigger.oldMap.get(acc.Id);
    if (acc.OwnerId != oldAcc.OwnerId) {
      tucariofts.SyncOwnerInvocable.SyncOwnerRequest req =
        new tucariofts.SyncOwnerInvocable.SyncOwnerRequest();
      req.recordId = acc.Id;
      requests.add(req);
    }
  }

  if (!requests.isEmpty()) {
    tucariofts.SyncOwnerInvocable.syncOwners(requests);
  }
}

Appel depuis le code Apex (enregistrement unique)

tucariofts.SyncOwnerInvocable.SyncOwnerRequest request =
    new tucariofts.SyncOwnerInvocable.SyncOwnerRequest();
request.recordId = accountId;

List<tucariofts.SyncOwnerInvocable.SyncOwnerResult> results =
    tucariofts.SyncOwnerInvocable.syncOwners(
        new List<tucariofts.SyncOwnerInvocable.SyncOwnerRequest>{ request }
    );

if (results[0].success) {
    System.debug('Owner synced: ' + results[0].oldOwnerId +
                 ' → ' + results[0].newOwnerId);
} else {
    System.debug('Sync failed: ' + results[0].message);
}

Objet de résultat

Champ	Type	Description
success	Boolean	Si la synchronisation a réussi
message	String	Message de résultat ou détails d’erreur
oldOwnerId	Id	ID utilisateur du propriétaire précédent
newOwnerId	Id	ID utilisateur du nouveau propriétaire

Scénarios d’erreur

Scénario	Résultat
Aucun membre d’équipe sur l’enregistrement	success = false, “No Owner team member found”
Propriétaire inchangé	success = true, “Owner unchanged, no update needed”
Record ID null	success = false, “Record ID is required”
Record ID invalide	success = false, message d’erreur

Limitations importantes

Propriétaires de file d’attente non pris en charge — Flexible Team Share ne prend pas en charge les files d’attente en tant que propriétaires d’équipe. Lorsqu’un enregistrement est détenu par une file d’attente :

• Le système utilise l’utilisateur actuel (la personne qui ajoute le premier membre d’équipe) comme propriétaire dans l’équipe
• Si vous changez ultérieurement le propriétaire de l’enregistrement d’une file d’attente à un utilisateur, exécutez l’action Sync Owner pour mettre à jour l’équipe
• Si vous changez le propriétaire d’un utilisateur à une file d’attente, le propriétaire de l’équipe restera l’utilisateur précédent

Le Flow doit être créé par objet — Vous devez créer un Flow séparé pour chaque type d’objet sur lequel vous souhaitez une synchronisation du propriétaire. L’Invocable Action fonctionne avec n’importe quel objet, mais Salesforce nécessite des Record-Triggered Flows séparés par objet.

Accès temporaire avec date de fin

Lors de l’ajout d’un membre d’équipe, vous pouvez optionnellement définir une End Date pour accorder un accès temporaire à un enregistrement. Ceci est utile pour :

• Les collaborations basées sur des projets avec des calendriers définis
• Les consultants ou entrepreneurs temporaires
• La couverture des vacances ou les responsabilités déléguées
• Les périodes d’audit ou de révision

Comment ça fonctionne

Processus de nettoyage automatique

• Une tâche batch planifiée s’exécute quotidiennement (par défaut à 2h00 du matin) pour supprimer les membres d’équipe expirés
• Lorsqu’un membre d’équipe est supprimé, son enregistrement de partage est également supprimé, révoquant l’accès à l’enregistrement
• La tâche de nettoyage peut être gérée depuis l’assistant de configuration

Tâche planifiée

Flexible Team Share inclut une tâche de nettoyage automatique qui supprime les membres d’équipe expirés. Cette tâche est automatiquement planifiée lors de l’installation du package.

Vérifier la tâche

Gestion manuelle de la tâche

Les administrateurs peuvent gérer la tâche de nettoyage depuis l’assistant de configuration :

• Schedule Job — Planifier manuellement si non en cours d’exécution
• Unschedule Job — Arrêter le nettoyage automatique
• Run Now — Exécuter le nettoyage immédiatement

Dépannage

Avertissement “Configuration Not Found”

Symptôme : Une fenêtre modale d’avertissement apparaît indiquant qu’aucune configuration n’existe pour cet objet.

Cause : Le composant Membre d’équipe a été ajouté à une page d’enregistrement avant de configurer l’objet dans l’assistant de configuration.

Solution :

Erreur “No Access”

Symptôme : Le composant affiche un message “No Access” avec une icône de cadenas au lieu des membres d’équipe.

Cause : L’utilisateur actuel n’a pas le groupe d’ensemble de permissions requis attribué.

Solution :

L’erreur “This operation requires the FTS Admin permission set” persiste

Symptôme : Lors du déploiement d’une configuration dans le Configuration Wizard (sélection d’un objet et clic sur Deploy Settings), l’erreur “This operation requires the FTS Admin permission set” apparaît — alors même que l’ensemble de permissions Flexible Team Share - Admin a déjà été attribué à l’utilisateur.

Cause : Il s’agit d’une particularité de mise en cache des permissions Salesforce. Après l’attribution d’un ensemble de permissions, Salesforce continue parfois d’évaluer l’état de permissions précédent de l’utilisateur pour la session active, de sorte que le nouvel accès accordé n’est pas reconnu immédiatement.

Solution :

Avertissement “Limit Reached”

Symptôme : Le bouton “Add Team Member” est désactivé et un message indique que la limite a été atteinte.

Cause : Vous avez atteint le nombre maximum de membres d’équipe autorisés.

Solution : Supprimez les membres d’équipe inactifs ou inutiles pour libérer des emplacements.

Membres d’équipe dans la limite	Membres d’équipe au-delà de la limite

Le partage ne fonctionne pas

Symptôme : Les membres d’équipe sont ajoutés avec succès mais ils ne peuvent pas accéder à l’enregistrement.

Cause : Le paramètre de partage Organization-Wide Default (OWD) de l’objet est défini sur Public Read/Write.

Solution :

Support

Pour toute question ou problème, veuillez contacter [email protected].