4D Japan
テクニカルサポートブログ-
新しいORDAメソッドを使ってエンティティ・セレクションをソートする
前のブログ投稿で、ORDA クエリーの中で式を適用して、洗練された複雑な検索条件をどのように構築するかを説明しました。さらに完全で強力な開発ツールを使って提供できるのが、新しいORDA メソッドのorderByFomula() です。formulas の助けによって、プロジェクト・メソッドあるいは4D式の中で複雑な条件を使ってエンティティ・セレクションのソートができます。
ソート条件は、式がストリングあるいは Formula オブジェクトとしてorderByFormula() メソッドに与えられた時に評価されます。
Stringとして式をソートする
ここにデータクラス、Companiesがあります。これからこの企業を収益（収益 = 収入 - 支出）を基にソートします。
エンティティはThis コマンドでアクセスすることに注意しましょう。
C_OBJECT($companies;$orderedCompanies;$formula)
$formula:= Formula(This.revenue - This.costs)
$companies:=ds.Companies.all()
$orderedCompanies:=$companies.orderByFormula ($formula;dk descending)Formulaオブジェクトを使ったソート
では同じ条件を使って企業をソートしますが、ストリングの代わりに、Formula オブジェクトを使い、降順でソートします。
C_OBJECT($companies;$orderedCompanies;$formula)
$formula:= Formula(This.revenue - This.costs)
$companies:=ds.Companies.all()
$orderedCompanies:=$companies.orderByFormula ($formula;dk descending)Formula オブジェクトを使うことで、式をストリングとして使うよりもいくつかの利点（自動補完、コードエディター内の色指定、など）があります。
orderByFomula() メソッドはさらに多くのオプションがあります。詳しくはドキュメントをチェックし、上記のサンプルデータベース (HDI)をダウンロードしてください。
エンティティ・セレクションのソートについて
query() メンバーメソッド自体の内部にorder by ステートメントを挿入することができます。これはクラアント/サーバー・モードで使う場合には大きな利点で、クエリーとソートアクションを同じリクエスト中に組み合わせることができ、サーバーとネットワークトラフィックに送られるリクエストの数を減らします。
C_OBJECT($companies)
$companies:=ds.Companies.query("revenue> :1 order by costs desc";5000)
-
クイックレポート - コールバックメソッドと小計スペースの管理
クイックレポートは64ビットで完全に再作成され、継続的に新しい機能が統合されています。前回のRリリースのUI（ユーザーインターフェイス）の改良に加えて、4D v17 R6はスタンドアロンレポート中のイベントを捉える機能と、小計スペースを管理する機能を追加しました。
QR REPORTコマンドのコールメソッド
QR REPORT コマンドに”methodName”パラメータを設定できるようになりました。このメソッドは管理されたイベントごとに起動するコールバックです：
- qr cmd open
- qr cmd save
- qr cmd save as
- qr cmd generate
- qr cmd page setup
- qr cmd print preview
以下はコールのサンプルです：
QR REPORT([My Table];Char(1);"qrCallbackMethod")コールバックメソッドでは、管理されたイベントすべてを途中でやめて、やるべきことをやり、QR EXECUTE REPORT コマンドでイベントを実行できます。
下記はコールバックメソッドのサンプルで、文書を生成する前にフッターに現在のタイムスタンプを設定し、プレビューイベントにフィルターをかけます：
C_LONGINT($1;$2)
C_LONGINT($zone;$event)
$zone:=$1
$event:=$2
Case of
: ($event=qr cmd generate)
QR SET HEADER AND FOOTER($zone;2;"";Timestamp;"";100)
QR EXECUTE COMMAND($zone;$event)
: ($event=qr cmd print preview)
Else
QR EXECUTE COMMAND($zone;$event)
End caseリマインダー
- もしQR REPORT コマンドにコールバックメソッドが設定されなければ、イベントは自動で管理されます。
- もしQR REPORT コマンドにコールバックメソッドが設定されたら、イベントを実行する/しないはあなた次第です。これは本質的なイベントをスタンドアロンレポートとしてあなたが管理できることを意味します。
小計スペース
それぞれのブレイク（小計）に対して、ページブレークあるいは異なる行高を設定できるようになりました。異なる行高の場合、違いはポイント(pt)とパーセンテージ(%)で表示できます。
-
CSS表記で色指定を簡単に
既存のコマンドが改良され，さらに便利になりました。フォームオブジェクトのカラーは，数値だけでなく，直感的なCSS文字列でも指定することができます。従来のような4バイトの倍長整数（0x00RRGGBB）では，すぐに色がイメージできなかったかもしれません。255（0xFF）とではなく，単純に”blue”と記述できれば良いのに，と感じていたデベロッパーには朗報です。17r6では，CSS文字列がサポートされるようになりました！
CSS文字列がサポートされるようになったコマンドは，OBJECT SET RGB COLORS, LISTBOX SET ROW COLOR, LISTBOX SET GRID COLOR です。
コマンドの改良により，下記の要領でオブジェクトの色指定ができるようになりました。
$color:="blue"
$color:="#0000FF" // または #FF
$color:="RGB(0,0,255)"使用例
OBJECT SET RGB COLORS コマンドには，前景色と背景色がそれぞれ文字列で渡せるようになりました。コードを記述するのが簡単になるだけでなく，可読性も向上します。
OBJECT SET RGB COLORS(*;"text";"red";"Yellow")
// 従来の表記 OBJECT SET RGB COLORS(*;"text";0xFF0000;0xFFFF00)それだけではありません。OBJECT GET RGB COLORS コマンドからも文字列でCSSカラーが返されるようになりました。
C_TEXT($front;$back)
OBJECT GET RGB COLORS(*;"rectangle";$front;$back)
ALERT($front+"/"+$back) // #0000FF/#90EE90 が返されるリストボックスのコマンドも同じように改良されていますが，注意点があります。LISTBOX SET ROW COLOR にCSS文字列が渡された場合，リストボックスや列のカラーを制御するための配列には，数値に変換された値が代入されることに留意してください。
サポートされているCSSカラーネームの一覧はドキュメントに掲載されています。
早速，HDIをダウンロードして，改良コマンドを試してみるのはいかがでしょうか。
-
SQLユーザーとCurrent userの関係
SQLでログインする場合，
On SQL AuthenticationデータベースメソッドでCHANGE CURRENT USERコマンドを実行し，SQLセッションのアクセス権を明示的に付与することが必要です（データベースメソッドが存在する場合）。v11では，SQLの実行コンテキスト（たとえばトリガ）で
Current userを使用することができませんでした。返されるのは，直近のOn SQL Authenticationデータベースメソッドで付与されたユーザー名であり，カレントSQLセッションのユーザー名であるとは限らなかったからです。SQLセッションはOn SQL Authenticationデータベースメソッドで付与されたアクセス権で実行されていますが，そのアクセス権をCurrent userで取得できるとは限りません。v12以降，SQLの実行コンテキストで
Current userを使用した場合，SQLセッションのアクセス権がそのまま返されるようになりました。ただし，SQLの実行コンテキスト（たとえばトリガ）でCHANGE CURRENT USERコマンドを実行した場合，4Dのカレントユーザーが変更され，Current userとSQLセッションのアクセス権が一致しないことになります。いずれにしても，On SQL AuthenticationデータベースメソッドでSQLセッションに付与されたアクセス権は，ログアウトするまで有効であり，途中，CHANGE CURRENT USERコマンドに影響されることはありません。
-
WindowsでCourierは印刷できない
Courierは，定番のクロスプラットフォーム等幅フォントですが，Windows版はビットマップフォントであることに注意する必要があります。Mac版であれば，Courierフォントが設定されたフォームオブジェクトを印刷することができますが，Windows版は，印刷にDirect2Dが使用されているため，別のフォントが出力されることになります。これは仕様です。