Konfiguracja

Konfiguracja komponentu

Komponent Object Team Member można skonfigurować bezpośrednio w Lightning App Builder za pomocą następujących właściwości:

Właściwość	Typ	Domyślnie	Opis
Card Title	String	Team Members	Tytuł wyświetlany na karcie komponentu
Max Displayed Members	Integer	5	Maksymalna liczba członków zespołu wyświetlanych przed zwinięciem. Ustaw na 0, aby wyświetlić wszystkich

Gdy liczba członków zespołu przekroczy skonfigurowany limit, lista jest zwijana i wyświetla przycisk “Show all (X more)”. Kliknięcie go rozwija pełną listę, z przyciskiem “Show less”, aby zwinąć ją ponownie. Właściciel rekordu zawsze pojawia się jako pierwszy na liście, niezależnie od limitu wyświetlania.

Zachowanie limitu wyświetlania

Ustawienie	Zachowanie
Max Displayed Members = 5 (domyślnie)	Pokazuje pierwszych 5 członków, “Show X more” dla pozostałych
Max Displayed Members = 0	Wszyscy członkowie zespołu widoczni, bez zwijania/rozwijania
Max Displayed Members = 3 (niestandardowe)	Pokazuje pierwszych 3 członków, “Show X more” dla pozostałych

Role członków zespołu

Dodając użytkowników do zespołu, przypisujesz im jedną z następujących ról:

Rola	Opis	Możliwości
Owner	Właściciel rekordu	Automatycznie przypisywana przy tworzeniu rekordu. Nie można jej ręcznie przypisać ani usunąć. Ma pełny dostęp do zarządzania członkami zespołu. Usuwana automatycznie, gdy w zespole nie ma innych użytkowników.
Manager	Administrator zespołu	Może dodawać, edytować i usuwać członków zespołu. Użyj tej roli dla użytkowników, którzy muszą zarządzać składem zespołu.
User	Standardowy członek zespołu	Może przeglądać listę członków zespołu, ale nie może jej modyfikować. Użyj tej roli dla użytkowników, którzy potrzebują tylko dostępu do rekordu.

Synchronizacja zmiany właściciela

Gdy właściciel rekordu się zmienia (np. konto jest przypisane do innego przedstawiciela handlowego), członek zespołu Owner NIE jest automatycznie aktualizowany. System tworzy rekord Owner, gdy dodawany jest pierwszy członek zespołu, ale nie śledzi późniejszych zmian właściciela w rekordzie nadrzędnym.

Aby synchronizować właściciela zespołu z właścicielem rekordu, należy utworzyć Record-Triggered Flow.

Konfiguracja za pomocą Flow (zalecane)

Konfiguracja za pomocą triggera Apex

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);
  }
}

Wywołanie z kodu Apex (pojedynczy rekord)

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);
}

Obiekt wyniku

Pole	Typ	Opis
success	Boolean	Czy synchronizacja się powiodła
message	String	Komunikat wyniku lub szczegóły błędu
oldOwnerId	Id	Poprzedni User ID właściciela
newOwnerId	Id	Nowy User ID właściciela

Scenariusze błędów

Scenariusz	Wynik
Brak członków zespołu w rekordzie	success = false, “No Owner team member found”
Właściciel bez zmian	success = true, “Owner unchanged, no update needed”
Record ID null	success = false, “Record ID is required”
Nieprawidłowy record ID	success = false, komunikat błędu

Ważne ograniczenia

Właściciele w postaci kolejek nie są obsługiwani — Flexible Team Share nie obsługuje kolejek jako właścicieli zespołów. Gdy rekord jest własnością kolejki:

• System używa bieżącego użytkownika (osoby, która jako pierwsza dodaje członka zespołu) jako właściciela w zespole
• Jeśli później zmienisz właściciela rekordu z kolejki na użytkownika, uruchom akcję Sync Owner, aby zaktualizować zespół
• Jeśli zmienisz właściciela z użytkownika na kolejkę, właściciel zespołu pozostanie jako poprzedni użytkownik

Flow musi być utworzony dla każdego obiektu — należy utworzyć oddzielny Record-Triggered Flow dla każdego typu obiektu, dla którego chcesz synchronizacji właściciela. Invocable Action działa z dowolnym obiektem, ale Salesforce wymaga oddzielnych Record-Triggered Flows dla każdego obiektu.

Dostęp czasowy z datą końcową

Dodając członka zespołu, możesz opcjonalnie ustawić datę końcową, aby przyznać tymczasowy dostęp do rekordu. Jest to przydatne w przypadku:

• Współpracy projektowej z określonymi ramami czasowymi
• Konsultantów lub wykonawców tymczasowych
• Pokrycia urlopu lub delegowania odpowiedzialności
• Okresów audytu lub przeglądu

Jak to działa

Proces automatycznego czyszczenia

• Zaplanowane zadanie wsadowe uruchamia się codziennie (domyślnie o 2:00) w celu usunięcia wygasłych członków zespołu
• Gdy członek zespołu jest usuwany, jego rekord udostępnienia jest również usuwany, cofając dostęp do rekordu
• Zadanie czyszczenia można zarządzać z Configuration Wizard

Zaplanowane zadanie

Flexible Team Share zawiera automatyczne zadanie czyszczenia, które usuwa wygasłych członków zespołu. To zadanie jest automatycznie planowane podczas instalacji pakietu.

Weryfikacja zadania

Ręczne zarządzanie zadaniem

Administratorzy mogą zarządzać zadaniem czyszczenia z Configuration Wizard:

• Schedule Job — ręcznie zaplanuj, jeśli nie jest uruchomione
• Unschedule Job — zatrzymaj automatyczne czyszczenie
• Run Now — wykonaj czyszczenie natychmiast

Rozwiązywanie problemów

Ostrzeżenie “Configuration Not Found”

Objaw: pojawia się okno ostrzegawcze informujące, że nie istnieje konfiguracja dla tego obiektu.

Przyczyna: komponent Team Member został dodany do strony rekordu przed skonfigurowaniem obiektu w Configuration Wizard.

Rozwiązanie:

Błąd “No Access”

Objaw: komponent wyświetla komunikat “No Access” z ikoną kłódki zamiast członków zespołu.

Przyczyna: bieżący użytkownik nie ma przypisanego wymaganego Permission Set Group.

Rozwiązanie:

Błąd “This operation requires the FTS Admin permission set” nie znika

Objaw: podczas wdrażania konfiguracji w Configuration Wizard (po wybraniu obiektu i kliknięciu Deploy Settings) pojawia się błąd “This operation requires the FTS Admin permission set” — mimo że Permission Set Flexible Team Share - Admin został już przypisany użytkownikowi.

Przyczyna: jest to specyfika buforowania uprawnień w Salesforce. Po przypisaniu Permission Set, Salesforce czasami nadal ocenia uprawnienia na podstawie poprzedniego stanu uprawnień użytkownika w aktywnej sesji, przez co nowo przyznany dostęp nie jest rozpoznawany od razu.

Rozwiązanie:

Ostrzeżenie “Limit Reached”

Objaw: przycisk “Add Team Member” jest wyłączony i komunikat wskazuje, że osiągnięto limit.

Przyczyna: osiągnięto maksymalną dozwoloną liczbę członków zespołu.

Rozwiązanie: usuń nieaktywnych lub niepotrzebnych członków zespołu, aby zwolnić miejsca.

Członkowie zespołu w limicie	Członkowie zespołu poza limitem

Udostępnianie nie działa

Objaw: członkowie zespołu są pomyślnie dodawani, ale nie mogą uzyskać dostępu do rekordu.

Przyczyna: Organization-Wide Default (OWD) obiektu jest ustawione na Public Read/Write.

Rozwiązanie:

Wsparcie

W przypadku pytań lub problemów prosimy o kontakt na adres [email protected].