Lista zawartości

Będąc użytkownikiem firmowym, można używać składnika "lista zawartości", który dynamicznie wyświetla elementy zawartości konkretnego typu.

Na przykład, składnika "lista elementów zawartości" można użyć na stronie szczegółów, a gdy użytkownik kliknie na łączu, aby uzyskać bardziej szczegółowe informacje o danym elemencie zawartości, zostanie automatycznie załadowany widok szczegółów powiązanego elementu zawartości. Na przykład, jeśli strona zawiera kilka artykułów, każdy z nagłówkiem i obrazem, to gdy użytkownik kliknie na konkretnym artykule, na stronie szczegółów zostanie wyświetlony pełny artykuł.

Aby dodać składnik "lista zawartości" do strony, należy:

  1. Przejść do strony, która ma być edytowana, i upewnić się, że przełącznik Przełącznik edycji jest ustawiony w pozycji Edytuj.
  2. Dodać składnik do strony.
  3. Aby edytować składnik i jego wygląd, kliknąć na ikonie menu składnika Ikona "Menu składnika", po czym wybrać opcję Ustawienia.
  4. Korzystając z karty "Ogólne", zmodyfikować ustawienia, odstępy i inne opcje prezentacji.
  5. Wybrać odpowiednie opcje, aby określić dodatkowe ustawienia domyślne wyświetlanej zawartości.

    • Typ zawartości: Wybrać jeden z dostępnych typów zawartości. Typami zawartości są typy elementów zawartości dostępnych w kolekcji serwisu. Obejmują niestandardowe typy zasobów cyfrowych.

    • Maksymalna liczba elementów i Zacznij od elementu: Określić maksymalną liczbę wyświetlanych elementów oraz określić początek wyświetlania. Dodatkowe elementy nie będą wyświetlane.

    • Podział na strony: Określić, czy do listy mają zostać dołączone opcje podziału strony. Jeśli opcja ta zostanie wybrana, można będzie dostosować sposób wyświetlania podziału stron z użyciem przycisków lub numerów stron oraz różnych etykiet.

    • Data: Użyć dostępnych opcji w celu wybrania elementów zawartości do wyświetlenia (na podstawie daty utworzenia elementu, przypadającej przed, po, między lub w wybranym przedziale dat).

    • Kategorie: Wybrać kategorie do przefiltrowania listy elementów zawartości, tak aby były wyświetlane tylko elementy z konkretnej kategorii lub poszczególnych kategorii. Aby otworzyć wysuwany panel, za pomocą którego będzie można wybrać kategorie z repozytorium serwisów, nacisnąć przycisk Wybierz kategorie. Jeśli zostanie wybrana więcej niż jedna kategoria w tej samej taksonomii, to tylko jedna z wybranych kategorii musi być przypisana do wyświetlanych elementów. Jeśli zostanie wybrana więcej niż jedna kategoria z różnych taksonomii, to wszystkie wybrane kategorie muszą być przypisane do wyświetlanych elementów. Na przykład, jeśli zostaną wybrane kategorie Miasta i Parki z taksonomii Miejsce docelowe, zostaną wyświetlone elementy, które są miastami lub parkami. Jeśli zostanie wybrana kategoria Miasta z taksonomii Miejsce docelowe i kategoria Europa z taksonomii Regiony, zostaną wyświetlone elementy, które są miastami w Europie.

      Domyślnie wszystkie podrzędne wybranej kategorii będą dostępne. Aby ograniczyć listę do elementów w określonym węźle kategorii, należy wybrać węzeł, a następnie wyczyścić pole wyboru Uwzględniaj kategorie podrzędne.

    • Język: Wybrać język spośród powiązanych z repozytorium.

    • Dodatkowy napis-zapytanie (opcjonalne): Określić dodatkowe parametry zapytania w celu uszczegółowienia listy wyświetlanych elementów, używając następującej składni: field.dept eq "Finance". W poniższej tabeli przedstawiono listę dostępnych operatorów.

    • Uporządkuj wg: Posortować elementy według nazwy lub daty w porządku rosnącym lub malejącym. Jeśli typ zawartości zawiera inne pola daty, liczbowe lub dziesiętne, można także sortować według tych pól.

      Można również wybrać opcję Niestandardowe, po czym podać wyrażenie niestandardowe. Na przykład, aby posortować wg numeru działu w porządku rosnącym, należy wpisać: fields.deptno:asc. Do sortowania można też zdefiniować parametr adresu URL. Na przykład można wpisać {{URLParams.sortBy}}, po czym dodać na końcu adresu URL serwisu następujący parametr: ?sortBy=fields.deptno:asc.

    • Widok elementu: Wybrać układ używany do wyświetlania elementu zawartości. Udostępniany układ Domyślny pokazuje wszystkie pola elementu zawartości. Jeśli dla elementu zawartości istnieją inne układy niestandardowe, można wybrać dowolny dostępny układ. Jeśli zostanie wybrany układ niestandardowy, dla którego jest włączona opcja Dodaj obsługę ustawień niestandardowych, gdy są one używane w serwisach, można dodać dane niestandardowe do układu, klikając na ikonie Ikona "Dalej", następnie wprowadzając właściwe dane do pola Dane niestandardowe, po czym wracając do karty "Ogólne" za pomocą przycisku Wstecz.

    • Strona do wyświetlania indywidualnego elementu: Jeśli na strony szczegółów zostało wyznaczonych kilka stron (lub jedna), to są one tutaj wyświetlane. Wybrać stronę, na której — gdy użytkownik kliknie na łączu dla elementu zawartości, służącym do wyświetlania szczegółowych informacji — zostaną wyświetlone szczegółowe informacje.

      Uwaga:

      Jeśli strona szczegółów nie zostanie utworzona, to (w układzie domyślnym) łącze do wyświetlania szczegółów elementu zawartości nie będzie pokazywane.

    • Widok listy: Wybrać układ sekcji do rozmieszczenia elementów. Ta lista może zawierać układy niestandardowe. Omówiono tu następujące układy:

      • Poziomy: Rozmieszcza elementy jeden po drugim, w poziomie.

      • Pionowy: Rozmieszcza elementy jeden po drugim, w pionie. Jeśli nie został wybrany żaden układ, jest to ustawienie domyślne.

      • Dwie kolumny: Rozmieszcza po dwa elementy w wielu rzędach.

      • Trzy kolumny: Rozmieszcza po trzy elementy w wielu rzędach.

      Aby zmodyfikować układu, kliknąć na strzałce skierowanej w prawo obok wybranego elementu.

    • Widok pustej listy: Wybrać, w jaki sposób ma być wyświetlana pusta lista.

    • Opcje: Określić, czy ma być używane automatyczne odświeżanie zapytania wyszukiwania w składniku "wyszukiwanie zawartości".

    • Odstęp: Określić, w jaki sposób będą wyświetlane elementy.

  6. Korzystając z karty "Styl", sformatować ramkę zawierającą składnik; można użyć predefiniowanych stylów lub swoich własnych wyborów.

Tabela 10-1 Operatory zapytań

Operator Przykład Obsługiwane typy danych Opis
eq ?q=name eq "John"

?q=type eq "DigitalAsset"

?q=type eq "Employee" and fields.DOB eq "1994/09/26T16:23:45.208"

?q=type eq "Employee" and fields.DOB eq "1994/09/26T16:23:45.208"

 tekstowe, odwołanie, liczbowe, liczba dziesiętna, wartość logiczna, data-godzina Operator "równa się" (eq) uzgadnia dokładną wartość podaną w zapytaniu. Operator ten nie ma zastosowania dla wielowartościowych typów danych. W wartości podanej przy użyciu tego operatora nie jest uwzględniana wielkość liter, z wyjątkiem pól standardowych. Operator ten uwzględnia w wartości nawet znaki specjalne.
co ?q=(type eq "Employee" AND name co "john alex")

?q=(type eq "Car" AND fields.features co "manual")

 tekstowe, odwołanie, liczbowe, liczba dziesiętna, data-godzina, duży tekst Operator "zawiera" (co) uzgadnia każde słowo podane w kryterium. Słowa te są tworzone poprzez podzielenie wartości według znaków specjalnych. Daje to wyniki, które zawierają przynajmniej jeden z wyrazów (w tym przykładzie będzie to "john" lub "alex" lub oba te wyrazy). Podczas wyszukiwania operator ten nie uwzględnia w wartości znaków specjalnych. Nie przeprowadza wyszukiwania dla wyrazów niedozwolonych. Więcej informacji o wyrazach niedozwolonych można znaleźć w dokumentacji "Apache Lucene".

Operator ten jest stosowany w przypadku atrybutów jednowartościowych tekstowych i w formacie dużego tekstu; dla atrybutów wielowartościowych ma zastosowanie dla typu danych: tekstowe, odwołanie, liczbowe, liczba dziesiętna, data-godzina, duży tekst. Objaśnienie możliwych formatów daty-godziny zawarto w poniższej tabeli Obsługiwane formaty daty/daty-godziny (24 godz.). W wartości podanej przy użyciu tego operatora nie jest uwzględniana wielkość liter.
sw ?q=type eq "Employee" AND name sw "Joh"

?q=type eq "Employee" AND fields.city sw "Los"

 tekstowe Operator "zaczyna się od" (sw) uzgadnia tylko początkowe wartości znaku podane w warunku pola. Operator ten nie ma zastosowanie dla wielowartościowych typów danych. W wartości podanej przy użyciu tego operatora nie jest uwzględniana wielkość liter.
ge ?q=(type eq "Employee" AND fields.age ge "40")

?q=type eq "DigitalAsset" AND updatedDate ge "20171026"

 liczbowe, liczba dziesiętna, data-godzina Operator "większe niż lub równe" (ge) uzgadnia tylko wartości liczbowe oraz datę-godzinę. Objaśnienie możliwych formatów daty-godziny zawarto w poniższej tabeli Obsługiwane formaty daty/daty-godziny (24 godz.). Operator ten nie ma zastosowanie dla wielowartościowych typów danych.
le ?q=(type eq "Employee" AND fields.weight le "60.6") liczbowe, liczba dziesiętna, data-godzina Operator "mniejsze niż lub równe" (le) uzgadnia tylko wartości liczbowe oraz datę-godzinę. Objaśnienie możliwych formatów daty-godziny zawarto w poniższej tabeli Obsługiwane formaty daty/daty-godziny (24 godz.). Operator ten nie ma zastosowanie dla wielowartościowych typów danych.
gt ?q=(type eq "Employee" AND fields.age gt "20") liczbowe, liczba dziesiętna, data-godzina Operator "większe niż" (gt) uzgadnia tylko wartości liczbowe oraz datę-godzinę. Objaśnienie możliwych formatów daty-godziny zawarto w poniższej tabeli Obsługiwane formaty daty/daty-godziny (24 godz.). Objaśnienie możliwych formatów daty-godziny zawarto w poniższej tabeli Obsługiwane formaty daty/daty-godziny (24 godz.). Operator ten nie ma zastosowanie dla wielowartościowych typów danych.
lt ?q=(type eq "Employee" AND fields.age lt "20")

?q=type eq "Employee" AND createdDate lt "1994/09/26T16:23:45.208"

 liczbowe, liczba dziesiętna, data-godzina Operator "mniejsze niż" (lt) uzgadnia tylko wartości liczbowe oraz datę-godzinę. Objaśnienie możliwych formatów daty-godziny zawarto w sekcji Obsługiwane formaty daty/daty-godziny (24 godz.). Operator ten nie ma zastosowanie dla wielowartościowych typów danych.
mt ?q=(type eq "Car" AND fields.review mt "petrol 20KMPL")

?q=(type eq "Employee" AND name mt "Jo?n")

?q=(type eq "Employee" AND name mt "Jo*")

?q=(type eq "Employee" AND fields.role mt "senior*")

 tekstowe, duży tekst Operator zapytania frazowego lub wyszukiwania wg sąsiedztwa (mt) umożliwia wyszukiwanie wyrazów, które dzieli pewna odległość odległości. Wyniki są sortowane według najlepszego uzgodnienia. Jest przydatny do wyszukiwania elementów zawartości, gdy wartości, podane w kryterium "petrol 20kmpl", mają zostać użyte do wyszukania faktycznej zawartości typu "petrol fuel mileage runs 20KMPL in the speed way".

W operatorze zgodności można używać wieloznaczników — w obrębie jednej wartości jest obsługiwany wieloznacznik jednoznakowy (reprezentujący zarówno jeden znak), jak i wieloznakowy (reprezentujący więcej niż jeden znak). Wieloznacznikiem jednoznakowym jest "?" (znak zapytania), a wieloznakowym — "*" (gwiazdka). Na przykład imiona "John" i "Joan" można wyszukiwać jako "Jo?n", używając wieloznacznika jednoznakowego, lub jako "Jo*", używając wieloznacznika wieloznakowego.

Operator ten ma zastosowanie dla jedno- i wielowartościowych typów danych. Nie przeprowadza wyszukiwania dla wyrazów niedozwolonych. Więcej informacji o wyrazach niedozwolonych można znaleźć w dokumentacji "Apache Lucene". W wartości podanej przy użyciu tego operatora nie jest uwzględniana wielkość liter.
sm ?q=(type eq "Employee" And fields.city sm "Rome") tekstowe, duży tekst Operator podobieństwa. Umożliwia wyszukiwanie wartości podobnych do podanego kryterium. Wyszukiwanie to jest nazywane również wyszukiwaniem rozmytym (ang. fuzzy search), które — w celu uzgodnienia wyniku — używa domyślnie maksymalnie dwóch edycji. Angielskie słowo "Rome" jest zbliżone do słowa "Dome". Operator ten ma zastosowanie dla jedno- i wielowartościowych typów danych. W wartości podanej przy użyciu tego operatora nie jest uwzględniana wielkość liter.
AND ?q=(type eq "Employee" AND name eq "John" AND fields.age ge "40") ND Operatora AND można używać do wstawiania warunku AND między różnymi warunkami zapytania. Operator ten ma pierwszeństwo przed operatorem OR.
OR type eq "Employee" AND name eq "John" OR fields.age ge "40" ND Operatora OR można używać do wstawiania warunku OR między różnymi warunkami zapytania.
( ) ?q=type eq "Employee" AND (name eq "John" AND fields.age ge "40")

?q=type eq "Employee" AND ( (name eq "John" AND fields.age ge "40") OR fields.weight ge 60)

 ND Nawiasy — obejmując operatory — służą do grupowania warunków w kryteria. Kryterium ujęte w nawias ma najwyższy priorytet; następne w kolejności wyznacza operator AND, a po nim operator OR.