Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
{anchor:top}
{toc: class=contents}

h2. Overview概要
{styleclass: Class=topLink}[topページトップ|#top]{styleclass}
The default filter value is USER PROMPT.  If this setting is not changed the user that runs the report will be prompted to fill in the filter data at the time of running the report. This is useful when the type of interest that a user may have in the report data varies based upon a context. The figure below shows the effect of selecting User Prompt.

フィルター値の初期値は「ユーザープロンプト」となっています。これを変更しなければユーザーはレポートを実行する際にパラメーターの入力を促されます。この機能は表示すべきデータが状況によって変化するような場合に有効です。下の図はこの指定とそれがユーザーに表示するプロンプトを示したものです。


!01userprompt.png!


# The user selects USER PROMPT for the filter data type on the filters edit page of the report builder.
# When the report is run the user is prompted to insert a division.  No data is displayed until the user has inserted a division and clicks the GO button.
# Once the user has clicked the result set is returned and the filter is used to ensure that only the relevant data is returned.
# The user running the report chooses how to filter the report, based upon the prompt provided.

bq. See [User Prompt Reportsレポートビルダーのフィルター設定ページで、フィルターの種類に「ユーザープロンプト」を選択します。
# レポートが実行されると、ユーザーにプロンプトと入力欄が示されます。値が入力され「→」ボタンがクリックされるまでレポートは表示されません。
# ユーザーが「→」ボタンをクリックすると、フィルターによって絞り込まれたデータのみが読み出されレポートに表示されます。
# つまりユーザーはこのプロンプトによってレポートに表示されるデータの内容を変更できるわけです。





bq. 詳細については、[ユーザープロンプトレポート|User Prompt Reports] for further information.

を参照してください。
h2. Promptプロンプトアイコン
Values
{styleclass: Class=topLink}[topページトップ|#top]{styleclass}
Byプロンプトアイコンをクリックすると、そのフィルターに対して指定可能なすべての値が表示されます。Yellowfinは指定された値にしたがってすべてのフィルターをクエリーに適用します。
clicking
the prompt values button you can see all the values available in your filter.  Yellowfin will take into account any additional filters you may have to limit the amount of data returned.

!02promptvalues.png|thumbnail,border=1!

h3. Promptプロンプトの種類:ドロップダウン、In Types -List、日付、検索
drop
down, in list, date and search
With Yellowfin you can set up a number of different prompt types.  These can include standard text entry fields, drop down selections, in list grouped selections, and date fields as seen in the example below.
 
プロンプトとして以下の図のように通常のテキスト入力フィールド、ドロップダウンメニュー、In Listグループ化メニュー、日付入力フィールドが使用可能です。

!03promptTypes.png!

# The text field allows the user to type in the desired value to filter by. 
# The filter icon allows the user to view all the available filter values and select one to use. If the filter were an aggregate there would be no prompt to allow the user to search the database.
# The date filters allow the user to manually type dates into the fields, or use the calendar to search for, and select a date. There is an option in the filter Entry Style menu to Allow Prompt which will enable the user to select from a list of dates (as in point 2.).
# When setting a date to the 'between' operand, and then formatting it to be a dropdown using pre-defined date ranges, you get the following options: 
テキストフィールドには任意のフィルター値を入力できます。
# フィルターアイコンをクリックすると、使用可能なすべてのフィルター値が表示されます。使用するものを1つ選択してください。そのフィルターが集計フィルターである場合は、データベースを検索するためのプロンプトは表示されません。
# 日付フィルターを使用する場合は、フィールドに日付を手動で入力するか、カレンダーから日付を選択します。フィルターの「入力スタイル」メニューを使用して、日付一覧から日付を選べるプロンプトを表示することができます(ステップ2と同様)。
# 「between」オペランドに日付を設定し、定義済みの日付範囲を用いてその書式を設定する場合は、次のようなオプションが表示されます:
!04between.png!
# When日付を「equal setting a date to the 'equal to' operand, and formatting it to use pre-defined filter ranges, you get these options:
to」オペランドに設定し、定義済みのフィルター範囲を用いてその書式を設定する場合は、次のようなオプションが表示されます:
{color:#C00000#c00000}{*Note:}注意:*{color} If you wish to base these dates on the last update date of your view or excel spreadsheet then go to the Filters Action menu and set the Filter Date Reference to View Update Date.ビューまたはExcelのスプレッドシートの最終更新日に基づいてこれらの日付を設定する場合は、フィルターアクションのメニューを開き、「フィルター日付参照(Filter Date Reference)」を「ビュー更新日」に設定します。
!05equalTo.png!
# The Gender dropdown uses cached values from the database to generate a list the user can select one value from.
# The Last Name list uses cached values from the database to generate a list that the user can select multiple values from.

h3. Cascading User Prompts
If multiple user prompt filters exist on a report then Yellowfin will treat these as cascading filters.  What this means is that as a user starts to fill in possible values when they click the prompt icon to search for possible values the values displayed will be further filtered based on the previous selections of the user.  Therefore, when writing a report with multiple filters place them in an order that will make sense for a user if cascading prompts are likely to be used.
For example if you have both a region and a country filter on the same report then the region filter should be placed before the country filter so that any countries displayed are only those that equal the pre-selected region.

h3. Dependant User Prompts
If multiple filters are used on a report filter dependencies can be set up so that the child filter will not be displayed until the parent filter has a value. This can be useful for sets of cached filters. When the user selects a value for the parent filter, the dependant filter will be displayed and it will have its values filtered by the previous selection, making the filters cascading and dependant.
For example, if you have an In List filter on Camp Region and a dependant Camp Name filter, before you select a value for Region it would look like:

!06mail.png!
 
Once the user picks 'Australia' in the main filter, it will look like this:

「性別」ドロップダウンにはデータベースからキャッシュされた値が使用され、このリストからユーザーは値を選択することができます。
# 「姓(Last Name)」リストにはデータベースからキャッシュされた値が使用され、ユーザーはこのリストから複数の値を選択することができます。

h3. 段階的フィルタリング

レポートにユーザープロンプトフィルターが複数存在する場合、Yellowfinはそれらを段階的フィルターとして扱います。これはあるフィルターのプロンプトアイコンによって表示される選択肢が、その前のフィルターに入力された値によって限定されるという意味です。ですから複数のフィルターを使ったレポートを作成する場合、それらはユーザーにとって意味のある順番でなくてはいけません。
たとえば地域と国名を指定するフィルターをレポートに使用する場合、地域のフィルターは国名のフィルターの前に置かれる必要があります。国名が選ばれれば地域はおのずと決まってしまうわけで、地域のフィルターは意味がなくなるからです。


h3. フィルターの従属性

1つのレポートに複数のフィルターが使用されている場合、親フィルターが値を持つまで子フィルターが表示されないように、フィルターの従属性を設定することができます。この機能はキャッシュされているフィルター群がある場合に便利です。ユーザーが親フィルターの値を選択すると、従属フィルターが表示されます。従属フィルターの値は前の選択によってフィルタリングされ、フィルターの階層と従属性が表示されます。
たとえば、「Camp Region」にIn Listフィルターを使用し、従属フィルターとして「Camp Name」を使用する場合、「Region」の値を選択する前には次のように表示されます:


!06mail.png!

メインフィルターに「Australia」を設定すると、次のように表示されます:


!07dependantFilter.png!





bq. See 詳細については、[キャッシュされた依存フィルター|Cached Dependent Filters] for more information.

を参照してください。
h2. Advanced高度なフィルター
Filter Types
{styleclass: Class=topLink}[topページトップ|#top]{styleclass}
There are a number of special filter types that you need to be aware of when using the data filter option.  They have a number of various rules associated with them.  These are:
# In List Filters for Reference Codes Filtering
# Date Filters
# Between Type Filters

h3. In List Filter Type
If the operant type 'In List' or 'Not In List' is chosen then you will be able to select from multiple options.   The 'in list' is only available for specific types of variables such as codes. 

フィルターオプションを使用する際に知っておくべきいくつかの特別なフィルターがあり、それぞれに特別なルールが存在します。特別なフィルターは以下の通りです:

# 参照コードをフィルタリングする一覧に含む、In Listフィルター
# 日付フィルター
# 範囲フィルター

h3. 一覧に含む、In Listフィルター

オペランドに「一覧に含む、In List」あるいは「一覧に含まない、Not In List」を選択したものが「In Listフィルター」で、複数のフィルター値を設定できます。これらのオペランドは区分コードのような特別なタイプの値にしか適用されません。 


!08inList.png|thumbnail,border=1!


# Set the values for the user, click on the filter prompt icon on the filter page of the report builder. Select all the variables that you wish to add to your list then click Submit to save your changes and close the popup window.
レポートビルダーのフィルター設定ページで、フィルタープロンプトアイコンをクリックし、値を設定します。一覧に追加したいすべての変数を選択し、「送信・実行」をクリックして変更を保存してウインドウを閉じます。
!09inListSelected.png!
# To select multiple options from the list box hold down the control key and click on the values you wish with your mouse.  As shown above.

複数のフィルター値の設定を行うためには、「変更」をクリックします。上図のように表示されます。

h3. Between範囲フィルター
Filter
Types
If the operant type is set to 'Between' or 'Not Between' then the filter values popup will display two value text boxes.  You must insert a value into both of these.  In addition you must ensure that the lower end value is inserted in the top box and the higher value in the lower box for the filter to work effectively.
# Insert a value in both the top and bottom text boxes.
# Click Submit to save your changes and close the popup window
オペランドに「の間(~)、Between」あるいは「の間でない、Not Between」を選択したものが「範囲フィルター」で、範囲を示す2つの値が必要となります。また、上のフィールドの値が下のフィールドよりも小さくなければなりません。逆の場合、フィルターは機能しません。

# 最小値、最大値を入力します。
# 「送信・実行」をクリックして変更を保存し、ウインドウを閉じます。
!10between.png|thumbnail,border=1!


h3. Date日付フィルター
Filter Types
When editing a Date filter type you will have three selection options.  These are to either insert a fixed date or a variable date.  
# The *fixed date* option is defined by inserting a single date. 
# The *variable date* is set by selecting the current date option with either the + or - option.  This will filter the data based on the system date when ever a report is run.  For example if the filter set is Current date - 10 and the report run on February 11 then the filter date will be Feb 1.  However, if the report is run Feb 21 then the filter date in the report will change automatically to Feb 11.
# The *Pre-defined date period* provides the user with a list of date range choices.


日付フィルターの設定では、挿入、固定、可変という3つのオプションが選択できます。 

# *固定{*}の場合、1つの日付を指定します。
# *可変{*}の場合、現在の日付を基準にして過去(-)、あるいは未来(+)とその日数を指定します。この場合の現在とはフィルターが実行された日付です。たとえば「現在の日付 - 10」という設定として、フィルターが2月11日に実行されると、フィルター値は2月1日となり、次にレポートが2月21日に実行されると、フィルター値は自動的に2月11日に変更されます。
# *定義済み日付期間{*}の場合、日付範囲の一覧から選択することができます。

!11dateFilter.png|thumbnail,border=1!
\\
\\
{horizontalrule}
{styleclass: Class=topLink}[topページトップ|#top]{styleclass}