デスクトップセッション

概要

A desktop session is a user-related execution context on 4D Server, 4D remote, or 4D single-user that does not result from any web or REST access.

デスクトップセッションには以下のような種類が含まれます:

• Remote user sessions: In client/server applications, remote users have their own sessions, managed from the client and from the server.
• ストアドプロシージャーセッション: クライアント/サーバーアプリケーションにおいては、サーバー上で実行される全てのストアドプロシージャーを管理する固有のバーチャルユーザーセッション。
• スタンドアロンセッション: シングルユーザーアプリケーション内で返されるローカルセッションオブジェクト(クライアント/サーバーアプリケーションの開発およびテストフェーズにおいて有用です)。

以下の図は、異なるセッションの種類とそれらがどのように関連するかを表しています:

Web ユーザーセッション 同様、デスクトップセッションで実行されたコードはSession オブジェクトへのアクセスが可能で、これによって提供される関数やプロパティによって(例えばsession.storage オブジェクトを使用することによって)セッションの値を保存したりユーザープロセス間で共有することが可能になります。

しかしながら、Web ユーザーセッション内で実行されたコードとは違い、デスクトップセッション内で実行されたコードはロールと権限によっては管理されません。 It can access any parts of the 4D application, including ORDA and data model classes (on 4D Server, users and groups feature can manage user accesses). Note also that desktop sessions do not require scalable sessions to be enabled.

You can nevertheless share a remote session with a web session so that desktop application users can access your 4D application through a web interface, using in particular Qodly pages and Web areas.

リモートユーザーセッション

In client/server applications, when a user connects to the server, a remote user session object is created and available on both the server and the client. It is returned by the Session command on both machines.

このオブジェクトを扱うには、Session クラス の関数とプロパティを使用します。

Comparing server-side and client-side user session objects

Depending on where the code is executed, a server-side or a client-side user session object is available. Both objects are similar, except that:

• their .storage properties are not the same object. A value stored in the .storage of the user session on the server will not be available in the .storage of the user session on the client and conversely.
• for security reasons, the client-side session cannot execute functions that modify privileges (setPrivileges(), clearPrivileges(), promote(), demote(), restore()). Calling these functions on a client generates an error.

注

Functions that read privileges can be called on both client and server sides (getPrivileges(), hasPrivilege(), isGuest())

効果

You use the remote user session object to manage and share session data.

Within each environment, a session storage object is shared across all processes of the same user session. For example on the server, you can launch a user authentication and verification procedure when a client connects to the server, involving entering a code sent by e-mail or SMS into the application. 次に、ユーザー情報をセッションの storage に追加し、サーバーがユーザーを識別できるようにします。 この方法により、4Dサーバーはすべてのクライアントプロセスのユーザー情報にアクセスできるため、ユーザーの役割に応じてカスタマイズされたコードを用意することができます。

Within each environment, you can use the remote user session object to create an OTP and share the remote session for web accesses.

On the server, you can also assign privileges to a remote user session to control access when the session comes from Qodly pages running in web areas.

注

On the client side, two distinct local storage objects are available:

• the Storage object of the client machine,
• the session.storage object of the user remote session (also returned by the Session storage command).

関連したblog 記事

• クライアント/サーバー接続とストアドプロシージャーに対応した新しい 4Dリモートセッションオブジェクト。
• Client / server – Handle a session when working on a 4D client.

Sharing a remote session for web accesses

Remote user sessions can be used to handle web accesses to the application by the same user and thus, manage their privileges. これは、リモートマシン上で実行中の、 Qodly pages がインターフェースとして使用されているクライアント/サーバーアプリケーションにおいて特に有用です。 この構成では、アプリケーションは現代的なCSS ベースのWeb インターフェースを持ちながらも、統合されたクライアント/サーバーのパワーと単純さの恩恵に預かることができます。 このようなアプリケーションでは、Qodly ページは標準の4D Web エリア内で実行されます。

このような構成を製品において管理するためには、リモートユーザーセッションが必要です。 実は、リモート4D アプリケーションとWeb エリアにロードされたQodly ページの両方からリクエストが来る場合には、これらは同じセッション内で動作する必要があります。 You just have to share the session on the server between the remote client and its web pages so that you can have the same session storage and client license, wherever the request comes from (web or remote 4D).

Privileges should be set in the session before executing a web request, so that the user automatically gets their privileges for web access (see example). Keep in mind that privileges only apply to requests coming from the web.

注

Privileges can only be set from the remote user session on the server. For security reasons, they cannot be modified from the remote user session on the client (see Comparing server-side and client-side user session objects).

共有セッションは OTPトークン を通して管理されます。 After you created an OTP token for the remote session, you add the token (through the $4DSID parameter value) to web requests sent from Web areas containing Qodly pages (or from any web browser) so that the user session on the server is identified and shared. Web サーバー側では、Web リクエストが $4DSID パラメーター内に OTP id を格納していた場合、そのOTP トークンに対応したセッションが使用されます。

注

You can execute the OTP creation code from the server or directly from the client (on the server you can use for example the On Server Open Connection database method). However, keep in mind that the web session .storage is shared with the server-side user session .storage that and privileges can only be set from the user session on the server.

tip

For development and testing purposes, you can use a standalone session to code and test all features related to web access sharing, whether your application is intended for single-user or client/server deployment.

関連したblog 記事

Embed Qodly pages in a 4D web area without extra cost

例題

フォーム内において、OTP を取得し、Web エリア内にQodly ページを開きます:

Form.otp:=getOTP

Form.url:="http://localhost/$lib/renderer/?w=Products&$4DSID="+Form.otp

WA OPEN URL(*; "QodlyPage"; Form.url)

getOTP プロジェクトメソッド(クライアント/サーバーでサーバー上で実行 付き):

// クライアント サーバー:
// ----------------
// セッションオブジェクトはサーバー上にあるため、メソッドはサーバー上で実行する必要がある
// セッションオブジェクトはクライアントでは常にNull
//

#DECLARE() : Text

return Session.createOTP()

"viewProducts" セッションに権限を付与するために使用されるコードは以下の通りになります:

// クライアント サーバー:
// ----------------
// セッションオブジェクトはサーバー上にあるため、メソッドはサーバー上で実行する必要がある
// セッションオブジェクトはクライアントでは常に Null 

Session.clearPrivileges() // セッションから古い権限を消去する
Session.setPrivileges("viewProducts")

ストアドプロシージャーセッション

サーバー上では、全てのストアドプロシージャー は同じバーチャルユーザーセッションを共有します。

効果

ストアドプロシージャーセッションのすべてのプロセス間でデータを共有するには、Session.storage 共有オブジェクトを使用できます。

利用可能性

ストアドプロシージャーの session オブジェクトは、次のいずれかから利用できます:

• Execute on Server コマンドで呼び出されたプロジェクトメソッド
• ストアドプロシージャーから呼び出されたORDA データモデル関数
• On Server Startup と On Server Shutdownなどのデータベースメソッド。

スタンドアロンセッション

スタンドアロンセッションとは、4D をローカルに使用している際に実行されるシングルユーザーセッションのことです。

効果

スタンドアロンセッションでも、Web セッションと OTP 共有を使用することでクライアント/サーバーアプリケーションの開発とテストを行うことができます。 スタンドアロンセッション内のコードでも、リモートセッションにおける session オブジェクトと同じように session オブジェクトを使用することができます。

利用可能性

スタンドアロンの session オブジェクトは4D アプリケーション上で実行される全てのメソッドとコードから利用することが可能です。