マークアップ構文の理解

5.13 マークアップ構文の理解

次の構文を使用して、Webシート・ページ、ページ・セクション、外部URL、データ・グリッドにリンクを追加したり、SQLまたはSQLVALUE構文を含めたりできます。

ヒント:

各Webシート・ページの右上隅に「ヘルプ」ボタンが表示されています。ヘルプ・ページ「マークアップ構文」には、この項で説明するすべての構文オプションがリストされています。

ページへのリンク
Webシート内の他のページへのリンクをページ・セクションに含めるには、次の構文を使用します。
セクションへのリンク
ページ・セクションへのリンクを含めるには、次の構文を使用します。
外部URLへのリンク
ページ・セクションに外部URLへのリンクを含めるには、次の構文を使用します。
データ・グリッドへのリンク
ページ・セクション内にデータ・グリッドへのリンクを含めるには、次の構文を使用します。
SQLおよびSQLVALUE構文の使用
SQLまたはSQLVALUE構文を使用して、データ・グリッドまたは表やビューに対する問合せからの単一値や表形式の結果をページのセクションに含めることができます。
高度なデータ・グリッド問合せルール

5.13.1 ページへのリンク

Webシート内の他のページへのリンクをページ・セクションに含めるには、次の構文を使用します。

そのページが存在する場合は、リンクが表示されます。そのページが存在しない場合は、ページを作成するためのリンクが表示されます。 page:識別子の使用はオプションであることに注意してください。

構文:

[[ page: <page alias> | <link name> ]]
[[ <page alias> | <link name> ]]

構文例:

[[page: home]] 
[[mypage | My Page]]

コンテキスト内の例:

One of the most colorful fish is the [[ clownfish | Clown fish]].

親トピック: マークアップ構文の理解

5.13.2 セクションへのリンク

ページ・セクションへのリンクを含めるには、次の構文を使用します。

セクションが存在する場合は、リンクが表示されます。セクションが存在しない場合は、セクションを作成するためのリンクが表示されます。セクションの前にページがない場合、そのセクションはカレント・ページにあるとみなされることに注意してください。

構文:

[[ section: <page alias> . <page section> | <link name> ]]
[[ section: <page section> | <link name> ]]

カレント・ページ内でリンクする構文の例:

[[section: clownfish | Clown Fish]]

異なるページにリンクする構文の例:

[[section: fish.clownfish | Clown Fish]]

コンテキスト内の例:

One of the most colorful fish is the [[ section: clownfish | Clown fish]].
Visit or fish page to see the [[ section: fish . clownfish | Clown fish]], also known as Nemo.

親トピック: マークアップ構文の理解

5.13.3 外部URLへのリンク

ページ・セクションに外部URLへのリンクを含めるには、次の構文を使用します。

url:識別子の使用はオプションであることに注意してください。新しいブラウザ・ウィンドウでリンクを開くには、ポップアップ接頭辞を使用します。

構文:

[[ url: <url> | <link name> ]]
[ popupurl: <url> | <link name> ]]
[[ <url> | <link name> ]]

構文例:

[[url: http://www.company.com/store | commpanystore]]
[[popupurl: http://www.company.com/store | commpanystore]]
[[http://www.searchengine.com | searchengine]] 
[[http://www.searchengine.com ]]

コンテキスト内の例:

You can buy Company software on the [[http://www.company.com/store | Company Store]] website.

親トピック: マークアップ構文の理解

5.13.4 データ・グリッドへのリンク

ページ・セクション内のデータ・グリッドへのリンクを含めるには、次の構文を使用します。

これらのリンクを使用して、データ・グリッドを表示したり、新しいデータを作成することができます。

ヒント:

データ・グリッドは、1ワードまたは2ワードであることに注意してください。

構文:

[[ data grid: <datagrid alias | <link name> ]]
[[ datagrid: <datagrid alias | <link name> ]]
[[ datagrid: <datagrid alias . <saved report name (may not be private)> | <link name> ]]

構文例:

[[ data grid: todo list | To Do List ]]
[[ data grid: todo list . open todo items | To Do List ]]
[[ datagrid: todo list | To Do List ]]

コンテキスト内の例:

Please review the [[ data grid: todo list | To Do List ]] and ensure your tasks can be accomplished by Friday.

親トピック: マークアップ構文の理解

5.13.5 SQLおよびSQLVALUE構文の使用

SQLまたはSQLVALUE構文を使用して、データ・グリッドまたは表やビューに対する問合せからの単一値や表形式の結果をページのセクションに含めることができます。

SQLVALUEタグには、SQL問合せで戻される最初の行の最初の列が表示されます。この構文を使用すると、文中にデータを埋め込むことができます(例: There are currently 5 types of cats.)。表形式の結果に対しては、SQLタグを使用します。SQLタグを使用すると、検索可能なレポートを作成できます。ただし、NOSEARCH構文を使用すると、この検索オプションは無効にできます。

データ・グリッドを操作する場合、(「構文」の下に表示される)いくつかの追加オプションとルールがあります。データ・グリッド問合せを作成する際の基本的なルールは次のとおりです。

データ・グリッド名またはデータ・グリッドの別名は中カッコで囲みます。次に例を示します。
```
{Cat Facts}
```
データ・グリッド列名は二重引用符で囲みます。次に例を示します。
```
"Type of Cat"
```

5.13.6 高度なデータ・グリッド問合せルール

高度なデータ・グリッド問合せには、次のルールがあります。

行の編集または行の追加リンクを含めるには、問合せがデータ・グリッドを1回のみ参照している必要があります(つまり、問合せ内でデータ・グリッドをそれ自体に結合することはできません)。
行の編集リンクを含めるには、最初の列がデータ・グリッドの主キー(つまり、データの行を一意に識別する列)である必要があります。"edit_row"オプションが含まれ、かつ問合せに単一のselect文がある場合、主キー列が自動的に含められます。問合せに複数のselect文が含まれる場合、行の編集リンクを含めるために、"APXWS_DATA_GRID_PK"置換(常に二重引用符で囲みます)をSELECT文の最初の列として使用して、主キーを含めることができます。
レポートの列名がデータ・グリッドの列名になりますが、標準SQLの列の別名指定構文を使用して変更できます。たとえば、次の例では、Minimum Number列からのデータが表示されますが、ヘッダーはMinとして表示されます。
```
select "Minimum Number" "Min" from ...
```
列名が30文字を超える場合、名前として最初の30文字のみを含めます。たとえば、次のように使用します。
```
"% of Estimated Lions per Regio"
```
次の例は使用しません。
```
"% of Estimated Lions per Region"
```
実行される問合せを表示するには、"show_sql"オプションを含めます。このオプションを含めることで、含まれたレポートの上部に問合せが表示されます。これはデバッグには優れた方法ですが、本番アプリケーションに対する"show_sql"はお薦めしません。

親トピック: マークアップ構文の理解