Element Chmura powiązań pokazuje listę obiektów powiązanych z bieżącym obiektem w mechanizmie chmury. Umożliwia również dodawanie i usuwanie takich wskazań. Jest to lista wyboru i odnośników, a nie automatyczny diagram wszystkich relacji zapisanych w programie.
1. Chmura a zwykłe pole powiązania #
Pole powiązania należy do konkretnej klasy i wskazuje określony rodzaj danych. Chmura może grupować wskazania do różnych klas, na przykład klienta, projektu i zadania.
Nie każde pole relacyjne jest automatycznie pozycją chmury. Dodanie wskazania do chmury nie ustawia samo z siebie wszystkich pól powiązań obiektu. Trzeba zdecydować, do czego ma służyć każdy z tych mechanizmów.
2. Dostępność i kontekst formularza #
Element jest przeznaczony do zwykłego interfejsu bs4 core. Nie jest oferowany analogicznie dla portalu i publicznej strony WWW. formularz musi mieć obiekt, którego powiązania można pokazać. Na stronie bez kontekstu obiektu element nie jest wyświetlany.
Najpierw przygotuj i sprawdź wariant dla istniejącego obiektu. formularz dodawania ma dodatkową obsługę tymczasowych wyborów i zapisuje je przy tworzeniu obiektu.
3. Konfiguracja elementu #
- Otwórz formularz i włącz tryb konstruktor.
- W konfiguracji strony przejdź do Elementy formularza.
- Dodaj element o Typ: Chmura powiązań.
- Uzupełnij Nazwa, na przykład „Powiązane obiekty”.
- W polu Selectory z kartoteki wskaż kartoteki dostarczające strony wyboru obiektów.
- Ustaw szerokość i sprawdź uprawnienia do elementu.
- Zapisz konfigurację i otwórz obiekt.
Lista Selectory z kartoteki jest zawężana do kartotek bez przypisanej klasy obiektu i o zastosowaniu zgodnym ze stroną. Nie jest listą wszystkich kartotek edycji poszczególnych klientów czy zleceń. Wskaż kartotekę z przygotowanymi stronami selektorów potrzebnych klas.
4. Dodawanie i usuwanie wskazań #
W elemencie widoczne są nazwy klas i obiektów. Przy dostępie do edycji obok listy pojawia się przycisk Powiąż lub wybrana ikona. Przycisk korzysta ze stron kartotek wskazanych w konfiguracji.
Po wybraniu istniejącego obiektu powstaje wpis chmury i lista jest aktualizowana. Usunięcie wartości z listy istniejącego obiektu jest obsługiwane podczas zmiany kontrolki i może od razu usunąć odpowiedni wpis powiązania. Nie czeka zawsze na ogólny zapis formularza.
Usunięcie wskazania nie usuwa powiązanego klienta, projektu ani zadania. Nie czyści również automatycznie zwykłych pól relacyjnych, które niezależnie wskazują ten sam obiekt.
5. Podgląd bez możliwości zmiany #
Do samego przeglądania przyznaj dostęp do podglądu. Przycisk dodawania jest tworzony przy dostępie do edycji. Można też użyć atrybutu Tylko podgląd zawartości (wyłącz edycję).
Sprawdź uprawnienia do samego elementu, stron wyboru oraz danych docelowych. Widoczna nazwa powiązanego obiektu nie jest automatycznym przyznaniem prawa do wszystkich jego stron.
6. Dodatkowe wskazania wynikające z konfiguracji pól #
Dodanie obiektu do chmury może rozszerzyć listę o kolejne powiązanie. Zależy to od atrybutu pola obiektu docelowego: Wstawiaj dla powiązanego obiektu dodatkowy wpis w chmurze powiązań.
Ten atrybut jest udostępniany dla pól będących jednokrotnym powiązaniem z obiektem. Nie jest ogólną opcją dowolnego pola tekstowego ani powiązania wielokrotnego.
Przykładowo wybrane zadanie może wskazywać projekt. Jeżeli właściwe pole zadania ma ten atrybut, przy dopisaniu zadania może pojawić się także projekt. To skutek konfiguracji pola, a nie przypadkowe zdublowanie wyboru. Zmianę atrybutu należy rozważyć w kontekście innych miejsc używających tej samej klasy.
7. formularz dodawania #
Podczas dodawania nowego obiektu chmura może zaproponować powiązanie z obiektem kartoteki wywołującej. Program sprawdza przy tym, czy odpowiedniego powiązania nie przewidziano już w dedykowanym polu wypełnianym z kontekstu dodawania.
Wskazania nowego obiektu są utrwalane przy jego utworzeniu. Przetestuj ten wariant oddzielnie od edycji istniejącego rekordu, w tym przeładowanie formularza przed pierwszym zapisem.
8. Przykład: wiadomość dotycząca klienta i projektu #
Wiadomość ma dotyczyć zarówno konkretnego klienta, jak i projektu. Na jej formularzu umieść Chmura powiązań oraz udostępnij selektory klientów i projektów. Użytkownik wybiera oba obiekty i może później otwierać je z listy powiązań.
Sprawdź ponowne otwarcie wiadomości, usunięcie jednego wskazania oraz ewentualne dodatkowe wpisy wynikające z atrybutów pól. Nie oczekuj automatycznego, identycznego widoku odwrotnego w każdej kartotece — element odczytuje wskazania wychodzące od bieżącego obiektu. Widoki korespondencji przy kliencie wymagają odpowiedniej konfiguracji wyszukiwania.
