Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Sv translation
languageen

Report filters are used to modify the content of the whole report. Multiple filters can be displayed in the sidebar or directly in the report as a special type of view. Each filter can have different functionality and appearance.

Creating Filters

Note

Only report author or report editor can create report filters and set their default values. Every other user that has access to the report, can only change report filter values.

To create a new filter, open the Variables sidebar.

You can use 2 approaches when creating filters:

  • Quick filters - Filters are created with the default layout of multi-select boxes. Read more.

  • Creating filtering components - The layout of every filter is configured separately. See below.

Creating filter component

  1. Click on Edit button to enter Variables dialog.
  2. Select which type of component you would like to create. To create a filter component, select Filter. 
  3. Optionally, change the identifier.
  4. Click on Add.
  5. Select which type attribute to use for filtering
  6. Select the condition (ContainsDoesn't contain, Greater than, Greater than or equal to, Lower than, Lower than or equal to)
  7. Optionally, select default value. See below.
  8. Optionally, edit the Advanced settings to change the appearance and functionality of the filter. See below.
  9. Save the filter.

Setting default value

To set one or more default values, click on Default values and select values which should be used as default. These values will be preselected when the user opens the report for the first time or when the user resets the filters.

Defining the default values via formula

Note

Available since BellaDati 2.9.11.

It is possible to dynamically calculate the default value. Expected return type is Array or single value, e.g.: [ 'abc', 'def' ] or 'abc'.

Example


Code Block
languagegroovy
linenumberstrue
def array = []
array << 'East'
array << 'South'

Setting default value for date attribute

For date attributes, it is possible to configure the date value as day, week, month, quarter or year.

Using relative dates

By enabling the option Use relative dates, the users can set the default value dynamically by using relative dates. Following relative dates are available:

Relative dateActual value
nowCurrent day
actualDayCurrent day

actualWeek

Current week (first day of week)

For example, actualWeek selected on 21.9.2010 represents date 20.9.2010 (Monday of this week in calendar)

actualMonth

Current month (first day of month)

For example, actualMonth selected in 21.9.2010 represents date 1.9.2010

actualQuarter

Current quarter (first day of quarter)

For example, actualQuarter selected on 21.9.2010 represents date 1.7.2010

actualYear

Current year (1st January of current year)

For example, actualYear selected on 21.9.2010 represents date 1.1.2010

availableFrom, availableTo

Represents the first and last available date entry

Relative and absolute date can be adjusted by operators using this syntax: date +|- n[d|w|m|q|y], where n is integer, d represents day, w represents week, m represents month q represents quarter and y represents year. We can for example define time in this way:  actualyear + 2m -4d. Today is 21.9.2010, so this value represents 1.1.2010 + 2 months - 4 days, which means date 25.2.2010.

ModifierValue
ddays
wweek
mmonth
qquarter
yyear


Advanced settings

Basic settings

Basic settings allow you to change filter Name, Code, and Description.

  • Name and Description will be displayed next to the filter.
  • Code is an identifier of the filter
Note
Available since BellaDati 2.9.19

It is possible to manage if the filters are mandatory to have values to display the data. If the option Required is on, no data will be displayed in the reports till the filter value is NULL. 

Appearance

  • Filter display method allows you to define how will filter look and which values will be displayed. Available options are:
    • .Default - default filter layout is used (filtering components cannot be applied)
    • Show preset values - only preset values are displayed in the filter
    • Show available values - all available values are displayed in the filter. When filter on datetime is selected, output format can be defined in format.
  • Display mode defines filter layout (layout is applied only when filter display methods Show preset values or Show available values are applied). Available options are:
    • Multiselect
    • Select
    • Checklist
    • Radio
  • Date Units defines type of date and time settings and allows to define output format (settings is applied only when filter display method is Show available values on date or time attribute).
    • Available types are: Year, Quarter, Month, Week, Day
    • Available sorting types are: ascending, descending
    • Available Formats can be found here
  • Limit defines how many attribute members will be displayed
  • Order by name - defines how attribute members in filter will be ordered (ascending or descending)
  • Size defines height filtering components (how many attributes will be displayed without scrolling)
  • Don't show all values - when selected, option All is not displayed
  • Autosubmit form after selection - report is automatically refreshed after changing selection in the filter

Additional filters

Section Additional filters allows you to create multi structure filters - if user selects one option in top level filter, additional filter will display only values which are available (associated) with previously selected value. You can continue to section dedicated to Additional filters.

Additional filters can be also displayed in Discovery mode - associations between selected attribute members are marked directly in filters.

Reordering filters

Icon

Available since BellaDati 2.9.11.

Users can change the order of filters by clicking on the small arrows next to the edit icon.

RESETTING FILTERS

Selected values can be reseted by clicking on the button Reset. This will reset all filters in the report.

Since BellaDati 2.9.11, it is also possible to reset individual filters by clicking on reset icon next to the filter name.

Sv translation
languagede

Reportfilter werden verwendet, um den Inhalt des gesamten Reports zu ändern. Mehrere Filter können in der Sidebar oder direkt im Report als besondere Art der Ansicht angezeigt werden. Jeder Filter kann unterschiedliche Funktionalität und Aussehen haben.

Erstellen von Filtern

Note

Nur der Reportautor oder der Reporteditor kann Reportfilter erstellen und deren Standardwerte festlegen. Jeder andere Benutzer, der Zugriff auf den Report hat, kann nur die Werte der Reportfilter ändern.

Um einen neuen Filter zu erstellen, öffnen Sie die Sidebar Variablen.

Sie können beim Erstellen von Filtern 2 Ansätze verwenden:

  • Schnellfilter - Filter werden mit dem Standardlayout von Mehrfachauswahlfeldern erstellt. Lesen Sie mehr dazu.

  • Creating filtering components - Layout of every filter is configured separately. See below.

Filterkomponente anlegen

  1. Klicken Sie auf die Schaltfläche Bearbeiten, um in den Dialog Variablen zu gelangen.
  2. Wählen Sie aus, welche Art von Komponente Sie erstellen möchten. Um eine Filterkomponente zu erstellen, wählen Sie Filter.

  3. Optional können Sie den Identifikator ändern.
  4. Klicken Sie auf Hinzufügen.
  5. Wählen Sie das Typattribut aus, das für die Filterung verwendet werden soll.
  6. Wählen Sie die Bedingung aus (enthält oder nicht enthält).
  7. Wählen Sie optional den Standardwert aus. Siehe unten.
  8. Bearbeiten Sie optional die erweiterten Einstellungen, um das Aussehen und die Funktionalität des Filters zu ändern. Siehe unten.
  9. Speichern Sie den Filter.

Standardwert einstellen

Um einen oder mehrere Standardwerte festzulegen, klicken Sie auf Standardwerte und wählen Sie Werte aus, die als Standard verwendet werden sollen. Diese Werte werden vorgewählt, wenn der Benutzer den Report zum ersten Mal öffnet oder wenn der Benutzer die Filter zurücksetzt.

Definition der Vorschlagswerte über die Formel

Note

Verfügbar seit BellaDati 2.9.11.11.

Es ist möglich, den Standardwert dynamisch zu berechnen. Erwarteter Rückgabetyp ist Array oder Einzelwert, z.B: [ 'abc', 'def' ] oder 'abc'.

Beispiel

 

Code Block
languagegroovy
linenumberstrue
def array = []
array << 'East'
array << 'South'

Standardwert für das Datumsattribut einstellen

Für Datumsattribute ist es möglich, den Datumswert als Tag, Woche, Monat, Quartal oder Jahr zu konfigurieren.

Verwendung von relativen Daten

Durch Aktivieren der Option Relative Daten verwenden können die Benutzer den Standardwert dynamisch über relative Daten einstellen. Folgende relative 

Relatives DatumActual value
jetztAktueller Tag
aktuellerTagAktueller Tag

aktuelleWoche

Aktuelle Woche (erster Tag der Woche)

Beispielsweise repräsentiert die am 21.9.2010 ausgewählte aktuelleWoche das Datum 20.9.2010 (Montag dieser Woche im Kalender).

aktuellerMonat

Aktueller Monat (erster Tag des Monats)

Beispielsweise repräsentiert aktuellerMonat, ausgewählt am 21.9.2010, das Datum 1.9.2010.

aktuellesQuartal

Aktuelles Quartal (erster Tag des Quartals)

Beispielsweise entspricht das am 21.9.2010 ausgewählte aktuellesQuartal dem Datum 1.7.2010.

aktuellesJahr

Aktuelles Jahr (1. Januar des laufenden Jahres)

Beispielsweise entspricht das am 21.9.2010 ausgewählte aktuellesJahr dem Datum 1.1.2010.

availableFrom, availableTo

Represents the first and last available date entry

Relatives und absolutes Datum können von Operatoren mit dieser Syntax angepasst werden: Datum +|- n[d|w|m|m|q|y], wobei n eine ganze Zahl ist, d Tag, w Woche, m Monat, q Quartal und y Jahr. Wir können zum Beispiel die Zeit auf diese Weise definieren: aktuellesJahr + 2m -4d. Heute ist der 21.9.2010, also entspricht dieser Wert dem 1.1.2010 + 2 Monaten - 4 Tagen, also dem Datum 25.2.2010.

ModifikatorWert
ddays/Tage
wweek/Woche
mmonth/Monat
qquarter/Quartal
yyear/Jahr

 

Erweiterte Einstellungen

Grundeinstellungen

Im Basisbereich können Sie den Filternamen ändern. Dieser Name wird neben den Werten angezeigt, die gefiltert werden können.

Erscheinungsbild

  • Die Filteranzeigemethode ermöglicht es Ihnen, festzulegen, wie der Filter aussehen soll und welche Werte angezeigt werden sollen. Verfügbare Optionen sind:
    • Standard - Standardfilterlayout wird verwendet (Filterkomponenten können nicht angewendet werden).
    • Presetwerte anzeigen - im Filter werden nur Presetwerte angezeigt.
    • Verfügbare Werte anzeigen - alle verfügbaren Werte werden im Filter angezeigt.
  • Der Anzeigemodus definiert das Filterlayout (das Layout wird nur angewendet, wenn die Filteranzeigemethoden Show preset values oder Show available values angewendet werden). Verfügbare Optionen sind:
    • Multiselect
    • Select
    • Checklist
    • Radio
  • Limit definiert, wie viele Attributelemente angezeigt werden
  • Nach Name sortieren - definiert, wie die Attributmitglieder im Filter sortiert werden (aufsteigend oder absteigend).
  • Größe definiert Höhenfilterkomponenten (wie viele Attribute ohne Scrollen angezeigt werden).
  • Nicht alle Werte anzeigen - wenn ausgewählt, wird die Option Alle nicht angezeigt.
  • Formular nach Auswahl automatisch versenden - Report wird nach Änderung der Auswahl im Filter automatisch aktualisiert.

Zusätzliche Filter

Abschnitt Zusätzliche Filter ermöglicht die Erstellung von Multistrukturfiltern - wenn der Benutzer eine Option im Top-Level-Filter auswählt, zeigt der zusätzliche Filter nur Werte an, die dem zuvor ausgewählten Wert verfügbar (zugeordnet) sind. Sie können mit dem Abschnitt fortfahren, der folgenden Themen gewidmet ist Zusätzliche Filteronal.

Zusätzliche Filter können auch im Discovery-Modus angezeigt werden - Assoziationen zwischen ausgewählten Attributelementen werden direkt in Filtern markiert.

Filter neu anordnen

Icon

Verfügbar seit BellaDati 2.9.11.11.

Benutzer können die Reihenfolge der Filter ändern, indem sie auf die kleinen Pfeile neben dem Bearbeitungssymbol klicken.

FILTER ZURÜCKSETZEN

Ausgewählte Werte können durch Anklicken der Schaltfläche Reset zurückgesetzt werden. Dadurch werden alle Filter im Report zurückgesetzt.

Seit BellaDati 2.9.11 ist es auch möglich, einzelne Filter durch Anklicken des Reset-Symbols neben dem Filternamen zurückzusetzen.

Sv translation
languageja

レポートフィルターは、レポート全体の内容を変更するために使用されます。複数のフィルターをサイドバーに表示したり、特別なタイプのビューとしてレポートに直接表示したりできます。各フィルターは、異なる機能と外観を持つことができます。

フィルターの作成

Note

レポート作成者または レポートエディターのみがレポートフィルターを作成し、デフォルト値を設定できます。レポートにアクセスできる他のすべてのユーザーは、レポートフィルター値のみを変更できます。

新しいフィルターを作成するには、サイドバーにある[変数]を開きます。

フィルターを作成する際、2つのアプローチを使用できます:

  • クイックフィルター - フィルターは、複数選択ボックスのデフォルトレイアウトで作成されます。続きを読む

  • フィルタリングコンポーネントの作成 - すべてのフィルターのレイアウトは個別に構成されます。下記を参照。


フィルターコンポーネントの作成

  1. [編集]ボタンをクリックして、[変数]ダイアログに入ります。
  2. 作成するコンポーネントのタイプを選択します。フィルターコンポーネントを作成するには、[フィルター]を選択します。
  3. オプションで、識別子を変更します。
  4. 追加をクリックします。
  5. フィルタリングに使用するタイプ属性を選択します。
  6. 条件を選択します(含むまたは含まない)。
  7. オプションで、デフォルト値を選択します。下記参照。
  8. オプションで、詳細設定を編集して、フィルターの外観と機能を変更します。下記参照。
  9. フィルターを保存します。

デフォルト値の設定

1つ以上のデフォルト値を設定するには、[デフォルト値]をクリックして、デフォルトとして使用する値を選択します。これらの値は、ユーザーが初めてレポートを開いた時、またはユーザーがフィルターをリセットした時に事前に選択されます。

数式を使用してデフォルト値を定義する

Note

BellaDati 2.9.11以降で使用可能です。

デフォルト値を動的に計算することが可能です。期待される戻り値の型は、配列または単一の値です(例: [ 'abc', 'def' ] または 'abc')。


Code Block
languagegroovy
linenumberstrue
def array = []
array << 'East'
array << 'South'

日付属性のデフォルト値の設定

日付属性の場合、日付の値を日、週、月、四半期、年として構成できます。

相対日付の使用

[相対日付を使用する]オプションを有効にすることにより、ユーザーは相対日付を使用してデフォルト値を動的に設定できます。次の相対日付が利用可能です:

相対日付
実際の値
now当日
actualDay当日

actualWeek

当週 (週の最初の日)

例えば、2010.9.21で選択されたactualWeekは、日付2010年9月20日(この週の月曜日)を表します

actualMonth

当月 (月の最初の日)

例えば、2010.9.21で選択されたactualMonthは、日付2010年9月1日を表します。

actualQuarter

当四半期 (四半期の最初の日)

例えば、2010.9.21で選択されたactualQuarterは、日付2010年7月1日を表します。

actualYear

当年 (当年の1月1日)

例えば、2010.9.21で選択されたactualYearは、日付2010年1月1日を表します。

availableFrom, availableTo

使用可能な最初と最後の日付エントリを表します。

相対日付と絶対日付は、次の構文を使用して演算子で調整できます: date +|- n[d|w|m|q|y]nは整数、dは日、wは週、mは月、qは四半期、 yは年を表します。例えば、次のように時間を定義できます: actualyear + 2m -4d。今日が2010年9月21日だとすると、この値は2010年1月1日 + 2か月 - 4日、つまり日付2010年2月25日を表します。

修飾子
d
w
m
q四半期
y

高度な設定

基本設定

基本設定では、フィルターの名前コード説明を変更できます。

  • 名前と説明はフィルターの横に表示されます。
  • コードはフィルターの識別子です。
Note
Available since BellaDati 2.9.19

フィルターがデータを表示するための値を持つことが必須であるかどうかを管理することが可能です。 [必須]オプションがオンの場合、フィルター値がNULLになるまでデータはレポートに表示されません。

外観

  • フィルター表示方法を使用すると、フィルターの外観と表示する値を定義できます。利用可能なオプションは、以下の通りです:
    • デフォルト - デフォルトのフィルターレイアウトが使用されます(フィルターコンポーネントは適用できません)
    • プリセット値を表示 - プリセット値のみがフィルターに表示されます
    • 利用可能な値を表示 - 利用可能なすべての値がフィルターに表示されます
  • 表示モードは、フィルターレイアウトを定義します(レイアウトは、フィルター表示方法[プリセット値を表示]または[使用可能な値を表示]が適用されている場合にのみ適用されます)。利用可能なオプションは、以下の通りです:

    • 複数選択
    • 選択
    • チェックリスト
    • ラジオボタン
  • 日付単位は、日付と時刻の設定の種類を定義し、出力形式を定義できるようにします (設定は、フィルターの表示方法が、日付または時刻の属性に使用可能な値を表示する場合にのみ適用されます)。
    • 使用可能な種類: 年、四半期、月、週、日
    • 使用可能な並べ替えの種類: 昇順、降順
    • 利用可能な形式: こちら
  • 制限は、表示される属性メンバーの数を定義します
  • 名前順 - フィルター内の属性メンバーの順序付け方法(昇順または降順)を定義します
  • サイズは、高さフィルタリングコンポーネントを定義します(スクロールせずに表示される属性の数)
  • すべての値を表示しない - 選択すると、[すべて]オプションが表示されません
  • 選択後にフォームを自動送信 - フィルターで選択を変更すると、レポートが自動的に更新されます

追加のフィルター

追加フィルターセクションを使用すると、マルチ構造フィルターを作成できます - ユーザーが最上位フィルターでオプションを1つ選択すると、追加フィルターには、以前に選択した値に使用可能な(関連付けられた)値のみが表示されます。Additional filters専用のセクションに進むことができます。

追加フィルターは、Discovery modeでも表示できます - 選択した属性メンバー間の関連付けは、フィルターで直接マークされます。

フィルターの再順序設定

BellaDati 2.9.11以降で使用可能です。

ユーザーは、編集アイコンの横にある小さな矢印をクリックして、フィルターの順序を変更できます。

フィルターのリセット

選択した値は、「リセット」ボタンをクリックしてリセットできます。これにより、レポート内のすべてのフィルターがリセットされます。

BellaDati 2.9.11以降、フィルター名の横にあるリセットアイコンをクリックして、個々のフィルターをリセットすることもできます。