パーマリンクの変数パラメータ
フィールドまたはフィールドの表示名、およびパラメータで変数パラメータを適用できます。
(注) |
URL で指定されたフィルタを使用したパーマリンク(可変パーマリンクともいう)はレポートに対してデフォルトで認証されます。 チェックボックスをオフにして、可変パーマリンクの認証を解除できます。可変パーマリンクは Excel と XML の形式をサポートしていません。 |
(注) |
パーマリンクには、フィールドとパラメータの両方を同時に含めることはできません。 |
パーマリンクのフィールドまたはパラメータを使用してフィルタリング条件を明示的に指定し、変更されたレポートデータを表示できます。
パーマリンクのパラメータとフィールドの形式
次の形式を使用して、デフォルトのパーマリンクに変数パラメータを含めることができます。
< variable_param_name > または < field name > = < operator > < space > < value > < space > < value >
<variable_param_name> は、レポートのレポート定義で設定されているフィールド名またはパラメータ名のいずれかになります。
<value> は、設定されたフィールドの有効な値です。
パーマリンク URL に複数の変数パラメータを含めるには、2 つの変数パラメータの間に &(アンパサンド)を使用します。
(注) |
変数パラメータを使用したパーマリンクは 1 つの URL です。異なる行に分割しないでください。この例では、変数パラメータの概念を説明するために URL が分割されています。演算子と値の間にのみスペースを含めることができます。 |
仕様
変数パラメータは、匿名ブロックベースおよびストアドプロシージャベースのレポートのパラメータ名にのみ適用できます。
パラメータはストアドプロシージャまたは匿名ブロックから作成されます。
- 例:パラメータを使用したパーマリンク
-
次の例では、@start_date、@end_date、および @agent_list パラメータを使用して、これらのパラメータに渡される値に基づいて、デフォルトのパーマリンクに表示されるレポートデータを変更する方法を示します。
- デフォルトのパーマリンク
-
//localhost:8444/cuicui/permalink/?
viewId=5BC22D1C1000013C61E3571D0A4E5AF5&linkType=htmlType&viewType=Grid
- パラメータ名 1:
-
&@start_date=ABSDATE 11-01-2012 00:00:00
- パラメータ名 2:
-
&@end_date=ABSDATE 01-21-2013 23:59:59
- パラメータ名 3:
-
&@agent_list=14527,14537
フィールド
データベースクエリベースのレポートのフィールド名または表示名に変数パラメータを適用できます。
フィールドはデータベースクエリから作成されます。
- 例:フィールドを使用したパーマリンク
-
次の例では、EventTime とユーザのフィールドに基づくパーマリンク URL に変数パラメータを含めることで、これらのフィールドに渡される値に基づいて、デフォルトのパーマリンクによって表示されるレポートデータを変更する方法を示します。
- デフォルトのパーマリンク
-
//localhost:8444/cuicui/permalink/?
viewId=5BC22D1C1000013C61E3571D0A4E5AF5&linkType=htmlType&viewType=Grid
- フィールド名 1:
-
&EventTime=ABSDATE 11-01-2012 01-21-2013 00:00:00-23:59:59 MON,WED
- フィールド名 2:
-
&User=VL CUIC%5Cadministrator
EventTime フィールドは、ABSDATE 11-01-2012 01-21-2013 00:00:00-23:59:59 MON,WED という絶対日付値に基づいてレポートデータを取得します。
ユーザフィールドは、&User=VL CUIC%5Cadministrator という値に基づいてレポートデータを取得します。
-
& は、2 つの変数パラメータを区切る区切り文字です。
-
[ユーザ(User)] は 2 番目のフィールドです。
-
VL は、CUIC%5Cadministrator という値で作用する 2 番目の演算子です。
-
CUIC%5Cadministrator は、[ユーザ(User)] フィールドに渡される値です。