Gałąź unikalna - distinctChildren

Wstęp

Gałąź unikalna służy do wyświetlania unikalnych wartości indeksów dokumentów. Gałąź może służyć do grupowania dokumentów w drzewie ze względu na wartość danego indeksu. Możliwe jest podanie wielu indeksów z różnych klas dokumentów, co jest przydatne, gdy w wielu klasach dokumentów istnieje indeks mający dokładnie to samo zastosowanie np. Klasa 1 posiada indeks Autor oraz Klasa 2 posiada indeks Autor. Gałąź ta nie daje możliwości modyfikacji wartości indeksu. Lista gałęzi dla danej konfiguracji jest zawsze równa liczbie znalezionych unikalnych wartości dla podanych indeksów. Aby stworzyć gałąź powiązaną, należy użyć parametru distinctChildren, którego wartością jest obiekt zawierający poniższe parametry konfiguracyjne.

Parametry konfiguracyjne

• showNullValues (boolean) - określenie, czy puste wartości indeksów mają również zostać wyświetlone. Domyślnie są ignorowane
• nullValuesPlaceholder (string) - tekst, który zostanie wyświetlony, jeżeli indeks jest pusty (powiązane z powyższym parametrem). Domyślnie pusty tekst
• separator (string) - separator tekstowy, jeżeli wartość ma być traktowana jak lista wartości oddzielona separatorem np. "Stanowisko 1;Stanowisko 2;Stanowisko 3". Parametr działa tylko, jeżeli indeks jest typu tekstowego
• indexes (array[object]) - lista indeksów, których mają zostać wyświetlone unikalne wartości. Przykład:

"indexes": [{
    "indexId": 24
}, {
    "indexId": 37
}, {
    "indexId": 47
}]

Przykłady

Prosta konfiguracja

{
    "staticChildren": [
        {
            "text": "Wartości indeksów o id 1 i 3",
            "distinctChildren": {
                "indexes": [{
                    "indexId": 1
                }, {
                    "indexId": 3
                }]
            }
        }
    ]
}

Wynik

Dzięki temu, że gałęzie dziedziczą filtry "rodziców", można ze sobą mieszać różne typy gałęzi. Np. aby wyciągnąć dalej osobno dokumenty z Klasa 1 i Klasa 2, można wykorzystać poniższą konfigurację.

{
    "staticChildren": [
        {
            "text": "Wartości indeksów o id 1 i 3",
            "distinctChildren": {
                "indexes": [{
                    "indexId": 1
                }, {
                    "indexId": 3
                }],
                "staticChildren": [{
                    "text": "Klasa 1",
                    "filteredChildren": {
                        "documentClassId": 1,
                        "textFormatter": "{1}"
                    }
                }, {
                    "text": "Klasa 2",
                    "filteredChildren": {
                        "documentClassId": 2,
                        "textFormatter": "{3}"
                    }
                }]
            }
        }
    ]
}

Wynik

Wartości puste

Domyślnie gałąź unikalna pomija wartości puste i nulle, lecz można to zmienić za pomocą parametru showNullValues. Jeżeli jego wartość to true i indeks będzie przyjmować wartości puste, wyświetli się dodatkowa gałąź reprezentująca wartość pustą indeksu. Parametrem nullValuesPlaceholder można dostosować tekst, jaki ma zostać wyświetlony w jej miejscu.

Przykład konfiguracji

{
    "staticChildren": [
        {
            "text": "Wartości indeksów o id 1 i 3",
            "distinctChildren": {
                "showNullValues": true,
                "nullValuesPlaceholder": "(Brak wartości)",
                "indexes": [{
                    "indexId": 1
                }, {
                    "indexId": 3
                }]
            }
        }
    ]
}

Wynik