Page Comparison

{anchor:top}
{toc: class=contents}

h2. Overview概要
{styleclass: Class=topLink}[topページトップ|#top]{styleclass}
To write freehand SQL reports you will need to be granted specific user access.  SQL reports require knowledge of 'Structured Query Language' and a sound knowledge of the data source that you wish to query.

If a requirements exists for a specific report, and no view of the database exists then an SQL query may be written to access the data directly.  To achieve this select 'Freehand SQL' when prompted for the report writing mechanism you wish to use.

SQLエディターを使用してレポートを作成するには、それを行えるアクセスレベルが必要です。また、SQL（Structured Query Language）に関する知識と、使用するデータベースに関する充分な理解も要求されます。


あるレポートが必要とされ、しかもそのデータベースに対するビューが存在しない場合、データに直接アクセスするためにSQLクエリーを書かなければなりません。そのためには、レポートの初期設定で作成方法に「SQLで作成」を選択してください。


!01selectSQL.png!



h2. Create a Freehand SQL ReportSQLエディターによるレポート作成
{styleclass: Class=topLink}[topページトップ|#top]{styleclass}
In select the SQL version all filters and conditions will have to be contained within the SQL. Type in your SQL statement into the text box provided.

この作成方法の場合、すべてのフィルターと条件がSQL文に含まれている必要があります。表示されるテキストボックスにSQL文を入力します。


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



h3. Databaseデータベーステーブル一覧
Table List
The list of database tables assists you to write your SQL.  By expanding the node next to a table name you display the fields for the table. The list also provides an indication if the element selected is a table or a database view.


データベースのテーブル一覧はSQL文の作成を補助するためのものです。テーブル名の左にあるアイコンをクリックするとその内容が表示されます。また、個々のエレメントがテーブルかビューであるかも示されます。


!03table.png|thumbnail,border=1!



h3. ValidatingSQLの実行チェック
SQL
You can test your SQL statement by clicking the Validate link. If the SQL statement fails you will receive a message back that may contain a description of the error (this is database dependent)

「テスト」をクリックすると作成したSQL文をテストすることができます。SQL文の実行でエラーが発生した場合、それを報告するエラーメッセージが表示されます（この内容はデータベースに依存します）。


!04sqlError.png!

If the SQL is successful the following message will be displayed:

SQL文の実行に成功すると以下のメッセージが表示されます。


!00.png!



h3. FormattingSQLレポートの書式設定
your
SQLSQLを作成しテストを済ませたら「→」をクリックして次に進みます。このページの使い方はドラッグ＆ドロップレポートライターのレポートデータページとほとんど同じです。
Report
Once you are happy with your SQL click the next icon to go to step 2 in the report builder wizard.  From here you will have the report data page similar to a standard drag and drop report.

You can add charts, drill through and co-display reports.  Some features such as filters and aggregations are not available since it is assumed that this will be contained within your freehand SQL.


ユーザーはレポートにグラフやドリルスルー、リンクレポートなどを追加できます。フィルターや集約などいくつかの機能は使用できません（それらはSQL文に記述されているものと見なされます）。


!05formattingSQL.png|thumbnail,border=1!



h3. User Promptsユーザープロンプトとソースフィルター
&
SourceSQLレポートにユーザープロンプトまたはソースフィルターを挿入するには、SQLクエリーにスクリプトを追加して、使用するカラム（列）を指定する必要があります。
Filters
To include user prompts or source filters into a SQL you will need to add script into your SQL query to indicate which columns to use.
# The inclusion of user prompt or source filter in your SQL reports is done by adding a # レポートにユーザープロンプトまたはソースフィルターを挿入するには、*{?}{* parameter. 
For example: }パラメーターを追加します。
例：{{select * from client where country = {?}}}
If inserting a *source filter* with multiple possible input parameters use: 複数の入力可能なパラメーターとともに{*}ソースフィルター{*}を入力する場合は、次のように使用します。{{select * from client where country in ({?})}} (（*Note* the additional Brackets)注意*：括弧を追加します）
# Clicking on "Validate" will inform you if the SQL syntax is valid, as well as the number of parameters present.
# The remaining steps from now on will be similar to generating a standard report with drag and drop, except that all of your SQL user prompt parameters go straight into the "Filters" stage of the report builder.
# At the "Report Filter" page, you will be able to set whether the filter is a user prompt or source filter.
「テスト」をクリックすると、SQLの構文が有効かどうかを知らせ、同時にパラメーター数が表示されます。
# 残りのステップは、すべてのSQLユーザープロンプトパラメーターがレポートビルダーの「フィルター」ステージに直行することを除いて、ドラッグ＆ドロップで標準的なレポートを作成するステップと似ています。
# 「レポートフィルター」ページで、フィルターをユーザープロンプトにするか、ソースフィルターにするかを設定できます。
 !06filterList.png!


\\
\\
{horizontalrule}
{styleclass: Class=topLink}[topページトップ|#top]{styleclass}