4D 変換タグ

4D v15.4

4D 変換タグ

4Dでは、参照を4D変数や式に挿入したり、異なる種類の処理をソーステキストに対して実行したりするための変換タグのセットを用意しています。これは別名”テンプレート”とも呼ばれます。これらのタグはソーステキストが実行されてアウトプットテキストが生成されたときに解釈されます。

これらの原理は特に4D Web サーバーにおいてセミダイナミックページを生成するのに使用されます。

これらのタグはHTMLコメント( )として挿入される必要があります。しかしながら、  などの他のコメントも使用可能です。

以下の4D変換タグを使用できます:

4DTEXT: 4D変数や4D式を挿入する為に使用します。
4DHTML: HTMLコードを挿入するために使用します。
4DEVAL: 4D式を評価するために使用します。
4DSCRIPT: 指定された4Dメソッドを実行します。またメソッドの戻り値を挿入します。
4DINCLUDE: ページに他のページを挿入するために使用します。
4DBASE: 4DINCLUDEで使用されるデフォルトフォルダーを変更します。
4DIF, 4DELSE, 4DELSEIF そして 4DENDIF: HTMLコードに条件分岐を挿入するために使用します。
4DLOOP と 4DENDLOOP: HTMLコードでループを行うために使用します。

複数のタイプのタグを混用することも可能です。例えば、以下のHTML構造は、何の問題もなく実行可能です:

<HTML>
...
<BODY>
<!--#4DSCRIPT/PRE_PROCESS-->         (メソッド呼び出し)
<!--#4DIF (myvar=1)-->               (If 条件)
   <!--#4DINCLUDE banner1.html-->   (サブページ挿入)
<!--#4DENDIF-->                     (End if)
<!--#4DIF (mtvar=2)-->
   <!--#4DINCLUDE banner2.html-->
<!--#4DENDIF-->

<!--#4DLOOP [TABLE]-->               (カレントセレクションでのループ)
<!--#4DIF ([TABLE]ValNum>10)-->         (If [TABLE]ValNum>10)
   <!--#4DINCLUDE subpage.html-->   (サブページの挿入)
<!--#4DELSE-->                     (Else)
   <B>Value: <!--#4DTEXT [TABLE]ValNum--></B><BR>
                              (フィールド表示)
<!--#4DENDIF-->
<!--#4DENDLOOP-->                  (End for)
</BODY>
</HTML>

テンプレートの実行について

"テンプレート"ページの中身をパースするのは、二通りのやり方があります:

PROCESS 4D TAGS コマンドを使用する方法: このコマンドは"テンプレート"に加えて引数(任意)をを入力として受付け、処理の結果のテキストを返します。

4Dの統合されたHTTPサーバーを使用する: WEB SEND FILE(.htm, .html, .shtm, .shtml)、WEB SEND BLOB (text/html型BLOB)、または WEB SEND TEXT コマンド、またはURLの呼び出しを使用して送信されたセミダイナミックページを使用して解析を行います。URLの呼び出しを使用する場合、最適化のために、 “.htm” と “.html” で終わるページに関しては解析されません。この場合においてHTMLページを強制的に解析させるためには、終わりに“.shtm” または“.shtml”にする必要があります(例 http://www.server.com/dir/page.shtm)。この点についての詳細に関しては、Webサーバ内のセミダイナミックページの章を参照して下さい。

4DTEXT

シンタックス:  または

タグ  を使用して4D変数や値を返す式への参照を挿入します。例えば(HTMLページ内にて)以下のように記述すると:

<P>Welcome to !</P>

4D変数 vtSiteName の値がHTMLページに送信時に挿入されます。値はテキストとして挿入されます。">"のようなHTMLの特殊文字は、自動的にエスケープされます。

4DTEXT タグを使用して、変数だけでなく4D式も挿入できます。フィールドの値を直接挿入できますし (例 ) 、または配列要素の値も挿入できますし (例 ) 、値を返すメソッドも使用できます ()。

式の変換は変数のそれと同じルールが適用されます。さらに式は4Dのシンタックスルールに適合していなければなりません。

注: Webリクエストからの 4DTEXT での4Dメソッドの実行は、メソッドプロパティの“4DHTMLタグとURL (4DACTION) で利用可能”属性の設定に基づきます。詳細は接続セキュリティを参照してください。

式に4D関数への呼び出しを直接含めることができますが、これはローカライズの観点から推奨されません。例えば  は英語バージョンの4Dでは正しく解釈されますが、フランス語バージョンの4Dでは解釈されません。同じことが実数値にも言えます (小数点は言語により異なります)。どちらの場合にもプログラムを使用して変数値を割り当てることを強くお勧めします。

使用する4Dランゲージやバージョンに関係なく式が正常に評価される事を保証するためには、異なるバージョン間で名前が変化する可能性のある要素(コマンド、テーブル、フィールド、定数)に対してトークンシンタックスを使用することが推奨されます。例えば、[#cmd id="178"/]コマンドを挿入するためには、'Current time:C178' と入力します。この点の詳細な情報に付いては、フォーミュラ内でのトークンの使用を参照して下さい。

解釈エラーの場合、“ : ## error # error code” のように表示されます。

注:

プロセス変数を使用できます。
セキュリティ上の理由から、悪意あるコードの侵入・挿入を防ぐために、アプリケーション外から導入されたデータを処理するときにはこのタグを使用する事が推奨されます(以下の[#title id="2850" anchor="2626211"/]の章を参照して下さい)。
ピクチャ-ーフィールドの内容を表示できます。しかしピクチャー配列の項目内容を表示することはできません。
4D式を使用して、オブジェクトフィールドの中身を表示させることができます。例えば、以下の様に記述します。
通常はテキスト変数を使用します。しかしBLOB変数を使用することもできます。この場合長さ情報なしのテキストBLOBを使用します。

4DHTML

シンタックス:  または

4DTEXTタグ同様、この4DHTMLタグを使用すると、変数や値を返す4D式をHTML式として挿入できます。4DTEXTタグとは異なり、このタグはHTML特殊文字をエスケープしません。

例えば4Dのテキスト変数 myvar を4Dタグを使用して処理した結果は以下の様になります:

myvar 値	タグ	Webページに挿入されるテキスト
myvar:="<B>"	<!--#4DTEXT myvar-->	<B>
myvar:="<B>"	<!--#4DHTML myvar-->	<B>

解釈エラーの場合、“ : ## エラー # エラーコード”のように表示されます。

注:

Webリクエスト経由の 4DHTMLでの4Dメソッドの実行は、メソッドプロパティの“4D HTMLタグおよびURL (4DACTION) で利用可能”属性の設定に基づきます。詳細は接続セキュリティを参照してください。
セキュリティ上の理由から、悪意あるコードの侵入・挿入を防ぐために、アプリケーション外から導入されたデータを処理するときには4DTEXTタグを使用する事が推奨されます(以下の[#title id="2850" anchor="2626211"/]の章を参照して下さい)。

4DEVAL

シンタックス:  または 

4DEVALタグを使用すると、変数や4D式を挿入できます。既存の4DHTMLタグのように、4DEVALタグはテキストを返す際にHTML特殊文字をエスケープしません。しかしながら、4DHTMLや4DTEXTと異なり、4DEVALは有効な4D宣言であればどれでも実行することができます(値を返さない割り当てや式も含まれます)。

例えば、以下の様なコードを実行することができます:

 $input:="<!--#4DEVAL a:=42-->" //割り当て

 $input:=$input+"<!--#4DEVAL a+1-->" //計算

 PROCESS 4D TAGS($input;$output)

  //$output = "43"

解釈エラーの場合、“ : ## エラー # エラーコード”のように表示されます。

注:

Webリクエスト経由の 4DHTMLでの4Dメソッドの実行は、メソッドプロパティの“4D HTMLタグおよびURL (4DACTION) で利用可能”属性の設定に基づきます。詳細は接続セキュリティを参照してください。
セキュリティ上の理由から、悪意あるコードの侵入・挿入を防ぐために、アプリケーション外から導入されたデータを処理するときには4DTEXTタグを使用する事が推奨されます(以下の[#title id="2850" anchor="2626211"/]の章を参照して下さい)。

4DSCRIPT/

シンタックス:

4DSCRIPT タグを使用して、スタティックなHTMLページを処理する際に4Dメソッドを実行することを可能にします。 タグがHTMLコメントとしてページに現れると、MyMethodメソッドが$1引数に Param を受け取って実行されます。

注: タグがWebプロセスのコンテキストにおいて呼び出された場合、Webページがロードされると、4Dは On Web Authenticationデータベースメソッドを (存在すれば) 呼び出します。このメソッドがTrueを返すと、4Dはメソッドを実行します。

メソッドは$0にテキストを返す必要があります。文字列がコード1から始まっていると、それは　HTMLソースとして扱われます (4DHTMLのときと同じ原則)。

注: 4DSCRIPTでの4Dメソッドの実行は、メソッドプロパティの“4D タグおよびURL (4DACTION) で利用可能”属性の設定に基づきます。詳細は接続セキュリティを参照してください。

例えば、以下のコメントをセミダイナミックWebページに挿入したとしましょう “Today is ” 。ページをロードする際、4Dは On Web Authenticationデータベースメソッドを (存在すれば) 呼び出し、そして MYMETH メソッドの$1引数に文字列 “/MYPARAM” を渡して呼び出します。

メソッドは$0にテキストを返します (例えば “14/12/31”)。コメント “Today is ” は結果 “Today is 14/12/31” となります。

MYMETHメソッドは以下のとおりです:

 C_TEXT($0)\\This parameter must always be declared

 C_TEXT($1)\\This parameter must always be declared

 $0:=String(Current date)

警告: $0 と $1 引数を宣言しなければなりません。

注: 4DSCRIPTから呼び出されるメソッドはインタフェース要素 (DIALOG, ALERT...) を呼び出してはいけません。

4Dはメソッドを見つけた順に実行するので、ドキュメント中で離れて参照される変数の値を設定するメソッドを呼び出すことも可能です。モードは関係ありません。テンプレートには必要なだけ  コメントを記述できます。

4DINCLUDE

シンタックス:

このタグは主に、このコメントを使用して、(path引数で指定された) 他のHTMLページを、これから送信するHTMLに含めるためにデザインされました。デフォルトでHTMLのボディー部、つまり<body> と</body>タグの間の内容だけが統合されます (bodyタグは含められません)。これによりヘッダーに含まれるメタタグ関連の衝突が回避されます。しかしpathで指定されたHTML中に<body></body>タグが含まれない場合、ページ全体が統合されます。この場合メタタグの整合性を管理するのは開発者の役割です。

コメントは、テスト () やループ () と使用するととても便利です。条件に基づきあるいはランダムにタグを含める便利な方法です。
このタグを使用してページをインクルードするとき、拡張子にかかわらず、4Dは呼び出されたページを解析してから、内容を4DINCLUDE呼び出し元のページに挿入します。

コメントで挿入されたページはロードされ、URLで呼ばれてWEB SEND FILEコマンドで送信されたファイルと同じように、Webサーバーキャッシュに格納されます。

pathには、含めるドキュメントへのパスを記述します。

警告: 4DINCLUDE呼び出しの場合、パスは解析される親ドキュメントからの相対パスです。フォルダ区切り文字にはスラッシュ (/) を使用し、レベルをさかのぼるには2つのドットを使用します (HTMLシンタックス)。

注:

PROCESS 4D TAGSコマンドで4DINCLUDEタグを使用する場合、デフォルトフォルダはデータベースストラクチャを含むフォルダーです。
4DINCLUDE タグで使用されるデフォルトフォルダーをタグを使用して変更できます (後述)。

ページ内の数に制限はありません。しかしの呼び出しは１レベルのみ有効です。つまり、例えばmydoc1.html内ので呼ばれるmydoc2.htmlページのボディに、 を含めることはできません。

さらに、4Dは組み込み呼び出しが再帰的でないか確認します。

エラーの場合、“ : ドキュメントを開けません”のように表示されます。

例題

<!--#4DINCLUDE subpage.html-->
<!--#4DINCLUDE folder/subpage.html-->
<!--#4DINCLUDE ../folder/subpage.html-->

4DBASE

シンタックス:

タグはタグで使用されるワーキングディレクトリを指定します。
Webページ内でこのタグが使用されると、 タグはこのページ内でそのあとに続くすべての 呼び出しのディレクトリを変更します。組み込まれたファイル内でフォルダーが変更されると、親のファイルから元となる値を取得します。

folderPath 引数には現在のページに対する相対パスを指定し、パスは"/"で終わっていなければなりません。指定するフォルダーはWebフォルダー内になければなりません。
WEBFOLDER キーワードを渡すと、デフォルトパスに戻されます (そのページに対して相対)。

4D v12では以下のように各呼び出しごとに相対パスをしていなければなりませんでした:

<!--#4DINCLUDE subpage.html--> 
<!--#4DINCLUDE folder/subpage1.html-->
<!--#4DINCLUDE folder/subpage2.html-->
<!--#4DINCLUDE folder/subpage3.html-->
<!--#4DINCLUDE ../folder/subpage.html-->

タグを使用すれば以下のように記述できます:

<!--#4DINCLUDE subpage.html--> 
<!--#4DBASE folder/-->
<!--#4DINCLUDE subpage1.html-->
<!--#4DINCLUDE subpage2.html-->
<!--#4DINCLUDE subpage3.html-->
<!--#4DBASE ../folder/-->
<!--#4DINCLUDE subpage.html-->
<!--#4DBASE WEBFOLDER-->

Example

 タグを使用してホームページのディレクトリを設定する:

/* Index.html */
<!--#4DIF LangFR=True-->
    <!--#4DBASE FR/-->
<!--#4DELSE-->
    <!--#4DBASE US/-->
<!--#4DENDIF-->
<!--#4DINCLUDE head.html-->
<!--#4DINCLUDE body.html-->
<!--#4DINCLUDE footer.html-->

head.html ファイル内でカレントフォルダーがを使用して変更されているが、index.html内では変更されない:

/* Head.htm */
/* ここでのワーキングディレクトリはインクルードされるファイルに対して相対的 (FR/ または US/) */
<!--#4DBASE Styles/-->
<!--#4DINCLUDE main.css-->
<!--#4DINCLUDE product.css-->
<!--#4DBASE Scripts/-->
<!--#4DINCLUDE main.js-->
<!--#4DINCLUDE product.js-->

4DIF, 4DELSE, 4DELSEIF and 4DENDIF

シンタックス:  {...} {} 

 (オプション),  (オプション) と  コメントと共に使用することで、 コメントはコードの一部に条件分岐を実行させることを可能にします。

expression 引数はブール値を返す有効な4D式です。式は括弧の中に記述され、4Dのシンタックスルールに準拠していなければなりません。

...  を複数レベルでネストできます。4Dのようにそれぞれの  は とマッチしなければなりません。

解釈エラーの場合、 と “の間のコンテンツの代わりに、: ブール式が必要です”が挿入されます。

同様に、が同じ数ので閉じられていない場合、“: 4DENDIFが必要です” が と の間のコンテンツの代わりに挿入されます。

タグを使用すると、条件テストの記述が容易になります。最初にTrueと判定されたブロック内にあるコードだけが実行されます。Trueブロックがない場合、文は実行されません (がなければ)。
最後のの後にタグを記述できます。すべての条件がFalseの場合、ブロックの文が実行されます。

以下の2つのコードは同等です

4DELSEのみを使用する場合:

<!--#4DIF Condition1-->
  /* Condition1 is true*/
<!--#4DELSE-->
    <!--#4DIF Condition2-->
        /* Condition2 is true*/
    <!--#4DELSE-->
        <!--#4DIF Condition3-->
            /* Condition3 is true */
        <!--#4DELSE-->
            /*None of the conditions are true*/
        <!--#4DENDIF-->
    <!--#4DENDIF-->
<!--#4DENDIF-->

同じ内容を4DELSEIFタグを使用して記述した場合:

<!--#4DIF Condition1-->
     /* Condition1 is true*/
<!--#4DELSEIF Condition2-->
     /* Condition2 is true*/
<!--#4DELSEIF Condition3-->
    /* Condition3 is true */
<!--#4DELSE-->
    /* None of the conditions are true*/
<!--#4DENDIF-->

例題 1

この例題は接続したユーザーに基づき異なるページを返します:

<!--#4DIF LoggedIn=False-->
    <!--#4DINCLUDE Login.htm -->
<!--#4DELSEIF User="Admin"-->
    <!--#4DINCLUDE AdminPanel.htm -->
<!--#4DELSEIF User="Manager"-->
    <!--#4DINCLUDE SalesDashboard.htm -->
<!--#4DELSE-->
    <!--#4DINCLUDE ItemList.htm -->
<!--#4DENDIF-->

例題 2

スタティックなHTMLページに書かれたこの例題のコードは、vname#"" 式の結果に応じ、異なるラベルを表示します:

<BODY>
...
<!--#4DIF vname#""-->
Names starting with <!--#4DVAR vname-->.
<!--#4DELSE-->
No name has been found.
<!--#4DENDIF-->
...
</BODY>

4DLOOP と 4DENDLOOP

シンタックス:  

このコメントを使用して、条件を満たす間、コードの一部を繰り返すことができます。繰り返し部のコードは と で挟まれます。

...  ブロックはネストできます。4Dと同様、それぞれの は同じ数の で閉じられていなければなりません。

条件には5種類あります:


このシンタックスは、指定された table のカレントプロセスのカレントセレクションに基づき、レコードごとにループします。2つのコメントの間のコードはカレントセレクションレコード毎に繰り返されます。

注: 4DLOOPタグがテーブルを条件として使用されると、レコードが読み込みのみでロードされます。

以下のコードは:

<!--#4DLOOP [People]-->
<!--#4DTEXT [People]Name--> <!--#4DTEXT [People]Surname--><BR>
<!--#4DENDLOOP-->

4Dランゲージで表すと以下のとおりです:

 FIRST RECORD([People])

 While(Not(End selection([People])))

  // ...

    NEXT RECORD([People])

 End while


このシンタックスは、配列項目ごとにループします。2つのコメントの間のコードが繰り返されるたびに、配列のカレント項目がインクリメントされます。

注: このシンタックスで二次元配列を使用することはできません。この場合、ネストしたループでメソッドを条件に使用します。

以下のコードは:

<!--#4DLOOP arr_names-->
<!--#4DTEXT arr_names{arr_names}--><BR>
<!--#4DENDLOOP-->

4Dランゲージで表すと以下のとおりです:

 For($Elem;1;Size of array(arr_names))

    arr_names:=$Elem

  //...

 End for


このシンタックスでは、メソッドがTrueを返す間ループが行われます。メソッドは倍長整数タイプの引数を受け取ります。まずメソッドは引数0を渡されます。これは (必要に応じて) 初期化ステージとして使用できます。その後、Trueが返されるまで1, 2, 3と渡される引数値がインクリメントされます。

セキュリティのため、Webプロセス内では、On Web Authenticationデータベースメソッドが初期化ステージ (引数に0が渡されて実行される) の前に一度呼び出されます。認証されると、初期化に進みます。

警告: コンパイルのため、C_BOOLEAN($0) とC_LONGINT($1) が宣言されていなければなりません。

例題以下のコードは:

<!--#4DLOOP my_method-->
<!--#4DTEXT var--> <BR>
<!--#4DENDLOOP-->

4Dランゲージで表すと以下のとおりです:

 If(AuthenticationWebOK)

    If(my_method(0))

       $counter:=1

       While(my_method($counter))

  //...

          $counter:=$counter+1

       End while

    End if

 End if

my_method は以下のようになります:

 C_LONGINT($1)

 C_BOOLEAN($0)

 If($1=0)

  `Initialisation

    $0:=True

 Else

    If($1<50)

  //...

       var:=...

       $0:=True

    Else

       $0:=False `Stops the loop

    End if

 End if


このシンタックスでは、4DLOOPタグは4D式がTrueを返す間ループが行われます。式は有効なブール式であれば問題はなく、無限ループを防ぐために、毎ループごとに評価されるための変数部分を含んでいる必要があります。
例えば以下のコードは:

<!--#4DEVAL $i:=0-->
<!--#4DLOOP ($i<4)-->
<!--#4DEVAL $i-->
<!--#4DEVAL $i:=$i+1-->
<!--#4DENDLOOP-->

以下の結果を生成します:

使用する4Dランゲージやバージョンに関係なく式が正常に評価される事を保証するためには、異なるバージョン間で名前が変化する可能性のある要素(コマンド、テーブル、フィールド、定数)に対してトークンシンタックスを使用することが推奨されます。例えば、[#cmd id="178"/]コマンドを挿入するためには、'Current time:C178' と入力します。この点の詳細な情報に付いては、フォーミュラ内でのトークンの使用を参照して下さい。


この場合、4DLOOPタグは配列のときと同じように振るまいます:ポインターによって参照された配列の要素ごとにループを繰り返します。カレントの配列要素は、コードの部分が繰り返される度に増加していきます。
このシンタックスは PROCESS 4D TAGS コマンドの引数に対して配列ポインターを渡した場合に有用です
例えば:

 ARRAY TEXT($array;2)

 $array{1}:="hello"

 $array{2}:="world"

 $input:="<!--#4DEVAL $1-->"

 $input:=$input+"<!--#4DLOOP $2-->"

 $input:=$input+"<!--#4DEVAL $2->{$2->}--> "

 $input:=$input+"<!--#4DENDLOOP-->"

 PROCESS 4D TAGS($input;$output;"elements = ";->$array)

  // $output = "elements = hello world "

解釈エラーの場合、“: エラーの説明” が と の間のコンテンツの代わりに挿入されます。

以下のメッセージが表示されます:
- 予期しない式のタイプ (標準のエラー);
- テーブル名が正しくありません (テーブル名のエラー);
- 配列が必要です (変数が配列でないか、二次元配列が指定された);
- メソッドが存在しません;
- シンタックスエラー (メソッド実行時);
- アクセス権エラー (テーブルやメソッドにアクセスする権限がない)。
- 4DENDLOOP が必要です (が対応するで閉じられていない)。

使用上の注意

再起的処理

4D タグは繰り返し解釈されます。4Dは常に変換の結果を解釈しようとし、もし新しい変換が起きた際にはそれに伴い新しく解釈が実行され、取得した結果がこれ以上変換の必要がなくなるまで繰り返されます。例えば、以下のような宣言が合った場合:

<!--#4DHTML [Mail]Letter_type-->

もし[Mail]Letter_type text テキストフィールドにタグ(例えば など)が含まれていた場合、このタグは4DHTMLタグの解釈の後、それに伴って評価されます。

この強力な原則はテキスト変換に関連するほとんどの需要を満たす事ができます。しかしながら、これは場合に寄っては悪意のあるコードの侵入を許す事になる可能性があるという点に注意して下さい。この点についてのより詳細な情報については、以下の章を参照して下さい。

悪意あるコードの侵入を防止

4D変換タグは様々なタイプのデータを引数として受け入れます。テキスト、変数、メソッド、コマンド名、etc...。これらのデータが自分で書いたコードから提供される場合、そのインプットを自分でコントロールできるので、悪意あるコードの侵入のリスクは無いと言っていいでしょう。しかしながら、データベースのコード扱うデータは、多くの場合外部ソース(ユーザー入力、読み込み、等)を通じて導入されたものです。
この場合、4DEVALや4DSCRIPTなどの変換タグを使用しない事が賢明です。なぜならこれらのタグはこういったデータを直接使って変数を評価するからです。
これに加え、繰り返しの原則(前章参照のこと)に従い、悪意あるコード自信が変換タグを含んでいる可能性もあります。この場合、4DTEXT タグを使用する必要があります。
例として、"Name"という名前のWebフォームフィールドがあり、ユーザーがそこに名前を入力しなければならない場合を考えてみましょう。この名前は タグを使用してページ内に表示されます。もし"" 型のテキストが名前の代わりに入力されたとしたら、このタグを解釈するとアプリケーションは終了してしまいます。
このリスクを避けるため、この場合にはシステム全体で4DTEXT タグを使用します。このタグは特殊HTML文字をエスケープするため、挿入された悪意ある再起的コードは、再解釈されることはありません。前の例でいうと、"Name"フィールドにはこの場合"" が含まれ、これは変換されません。

参照

4DオブジェクトをHTMLオブジェクトにバインドする
 PROCESS 4D TAGS
URLとフォームアクション
 セミダイナミックページ