バージョン: 20 R5 BETA

Qodly Studio for 4D

デベロッパー・プレビュー

Qodly Studio for 4D is currently in the Developer Preview phase. 本番環境で使用すべきではありません。

Qodly Studio は Webアプリケーション用のインターフェースビルダーです。 Webブラウザーやスマートフォンで動作するアプリケーションを設計するためのグラフィカルなフォームエディターをデベロッパーに提供します。 Qodly Studio は ORDAオブジェクトをネイティブにサポートします。

4D環境 から直接 Qodly Studio を使用して、モダンで洗練されたインターフェースをビルドし、既存の 4Dプロジェクトに簡単に統合して、オンプレミス で運用することができます。

Qodly Studioは、Webビジネスアプリケーションの開発に特化した Qodly Cloud Platform でも使用できます。

Qodly Studio では、全く新しい WebUI を使い、データソースの概念に慣れ、次の操作を学ぶことができます:

ページ上にコンポーネントを配置して Qodlyフォームを作成する
コンポーネントをデータにマッピングする
イベントを設定して 4Dコードをトリガーする
さらに沢山のことが可能です

info

The development with Qodly Studio for 4D requires at least a 4D Silver Partner license. ライセンスが有効化されていない場合、Qodly Studio に関するオプションやメニュー項目は表示されません。

設定

要件

ブラウザー

Qodly Studio は、以下の Webブラウザーをサポートしています:

Chrome
Edge
FireFox

推奨解像度は 1920x1080 です。

4Dアプリケーション

開発: 4D v20 R2 以上
運用: 4D Server v20 R2 以上
Qodly Studio は 4Dプロジェクトでのみ動作します (バイナリデータベースはサポートされていません)。

Qodly Studio へのアクセスを有効化する

デフォルトでは、Qodly Studio へのアクセスは許可されていません。

Qodly Studioは、WebAdmin Webサーバーによって提供され、表示される 4Dプロジェクトのデータは 4D Webサーバーによって処理されます。

Qodly Studio へのアクセスを有効化するには、2つのレベルで明示的に許可する必要があります:

4Dレベルで (4D または 4D Server)
プロジェクトレベルで

2つのレベルのいずれか (または両方) が有効でない場合、Qodly Studio　へのアクセスは拒否されます (403ページが返されます)。

4Dレベルで

最初のセキュリティレベルとして、WebAdmin Webサーバーで Qodly Studio へのアクセスを許可する必要があります。この設定は、ホストマシンの 4Dアプリケーション (4D または 4D Server) が対象となります。つまり、その 4Dアプリケーションで開くすべてのプロジェクトで、この設定が適用されます。

アプリケーション上で Qodly Studio へのアクセスを許可しない場合は、このオプションをオフにします。このオプションにチェックを入れると、Qodly Studio にアクセスできるようになります。さらに、各プロジェクトのレベルでも許可が必要です。

さらに、WebAdmin Webサーバーの HTTP/HTTPS ポートを設定することもできます。

注

これらの設定を変更した後、新しい設定を有効にするには、WebAdmin Web サーバーを再起動する必要があります。

プロジェクトレベルで

4Dレベルで Qodly Studio へのアクセスを有効にした後、アクセスできるプロジェクトをそれぞれ明示的に指定する必要があります。 Qodly Studio へのアクセスを有効化する オプションは、プロジェクト設定の Web機能ページで有効にする必要があります。

ユーザー設定はいくつかのレベルで定義でき、優先順位が適用されることに留意してください。

認証を有効化する

WebAdmin Webサーバーでの認証には、アクセスキーを使用します。詳しくは、アクセスキーを参照ください。

プロジェクト管理

4Dプロジェクトの管理上、以下の使用法のみがサポートされます:

Qodly Studio での開発は 4D (シングルユーザー) でおこなう必要があります。
Qodlyフォームを利用した 4Dアプリケーションの運用は、4D Server でおこなう必要があります。

Qodly Studio を開く

Qodly Studio ページは、WebAdmin Webサーバーが起動されており、認証が有効化されている場合に使用できます (上述参照)。

Qodly Studio にアクセスするには 2つの方法があります:

4Dシングルユーザーアプリケーションから、デザイン > Qodly Studio... を選択します。 WebAdmin Webサーバーがすでに起動されている場合は、その設定に応じて、デフォルトのブラウザーが IPaddress:HTTPPort/studio または IPaddress:HTTPSPort/studio を開きます。それ以外の場合は、最初に WebAdmin Webサーバーを起動するかどうかを尋ねるメッセージが表示されます。
4D または 4D Server から WebAdmin Webサーバーが起動されている状態で、ブラウザーに次のアドレスを入力します:

IPaddress:HTTPPort/studio

または:

IPaddress:HTTPSPort/studio

たとえば、ポート7080 でローカルWebサーバーを起動した後、ブラウザーに次のアドレスを入力します:

localhost:7080/studio

すると、Qodly Studio にアクセスするためのアクセスキーの入力を求められます。

Qodly Studio を使う

Documentation

公式の Qodly Studio ドキュメントは、Qodly ドキュメント Webサイトから入手できます。

Qodlyフォームを利用した Webアプリケーションを開発するには、このドキュメントとその関連リソースを参照ください。ただし、実装の段階に応じて、4Dデベロッパーは Qodly Studio または 4D IDE を使用します (機能の比較参照)。

コードの例は QodlyScript で提供されていますが、QodlyScript は 4Dランゲージから継承しているため、困ることはありません。詳細については、QodlyScript から 4Dランゲージへを参照ください。

info

4D で実装されたアプリと Qodly で実装されたアプリの間に直接の互換性はありません。

機能の比較

	4D IDE を使用する 4Dデベロッパー向けの Qodly Studio	Qodlyデベロッパー向けの Qodly Studio
テーブル (データクラス)、フィールド (属性)、リレーションの表示および編集	4Dストラクチャーエディター(1)	Qodly Studio Model Editor
Qodlyフォーム	Qodly Studio Webform Editor	Qodly Studio Webform Editor
デスクトップフォーム	4D IDE	サポートされていません
プログラミング言語	4Dランゲージ (ORDA を使用)	QodlyScript (ORDA含)
コーディング IDE	4D IDE コードエディター / VS Code と 4D拡張機能 (2)	Qodly Studio コードエディター
デバッガー	4D IDE デバッガー	Qodly Studio デバッガー
REST/Web ロールとアクセス権	roles.json の直接編集 / Qodly Studio ロールとアクセス権エディター	Qodly Studio ロールとアクセス権エディター

(1) Qodly Studio で Model ボタンをクリックしても、何も起こりません。 (2) Qodly Studio で 4Dコードを開くと、シンタックスの配色がサポートされておらず、"Lsp not loaded" という警告が表示されます。

ランゲージ

以下のコマンドとクラスは、Qodlyフォームのサーバーサイド管理に特化しています:

Web Form コマンド: Qodlyフォームをオブジェクトとして返します。
Web Event コマンド: Qodlyフォームのコンポーネント内でトリガーされたイベントを返します。
WebForm クラス: レンダリングされた Qodlyフォームを管理する関数とプロパティを持ちます。
WebFormItem クラス: Qodlyフォームのコンポーネントを管理する関数とプロパティを持ちます。

プロジェクトメソッドを使用する

推奨される方法は、プロジェクトメソッドではなく、クラス関数を使用することです。コンポーネントから呼び出すことが可能なのは、クラス関数のみです。それでも、次の 2つの方法で、Qodly Studio でもプロジェクトメソッドを使用できます:

クラス関数からメソッドを呼び出すことができます。
Qodly Explorer から直接メソッドを実行できます。

オフラインでの使用

コンピュータがインターネットに接続されていない状態でも、Qodly Studio を使って開発することができます。ただしこの場合、以下の機能は使用できません:

テンプレート: テンプレートライブラリは空です。
UI Tips: アイコンをクリックしても表示されません。

運用

レンダリングを有効化する

Qodly Studio は Qodlyフォームを (含まれるレイアウト、データの紐付け、イベント駆動ロジック情報とともに) 構造化された JSONファイルにカプセル化します。この JSONファイルは Qodly レンダラー によって即座に処理され、完全に機能する Webページを提供します。

info

Qodly で Qodlyフォームをレンダリングする方法の詳細についてはこのページを参照ください。

Qodlyフォームのレンダリングを有効にするには、以下のオプションを設定する必要があります。

4Dプロジェクトの設定 > Web > Web機能 > RESTサーバーとして公開 オプションを有効にする必要があります。
4D Webサーバーを起動しておく必要があります。

注

設定オプションが有効になっていない場合、レンダラーボタンは使用できません。

Qodlyフォームのスコープ

Qodly Studio で Qodlyフォームをレンダリングする際、レンダラーは設定により、4D WebAdmin Webサーバーと同じ HTTP/HTTPS 接続パターンに従って、HTTP または HTTPS で 4D Webサーバーに接続します。 URLスキームとライセンスの使い方については、この段落も参照ください。

Qodly Studio は、4D WebAdmin Webサーバーを通して動作することに留意してください。デベロッパーとして Qodly Studio を使用する場合、Qodlyフォームをプレビューするには、4D WebAdmin Webサーバーを使用することになります。これにより、たとえば RESTリソースとして公開されていないデータクラス、関数、属性を (グレーアウトされた状態で) 見ることができます。

しかし、実際のフォームのレンダリングは Qodly Studio の外でおこなわれ、標準の 4D Webサーバーによって処理されます。このような状況では、Webアプリケーションは RESTリソースとして公開されていないデータにアクセスできません。公開vs非公開関数およびテーブルの公開を参照ください。

Qodlyフォームへのアクセス

運用には、WebAdminサーバーは必要ありません。 Qodly Studio で作成された Webアプリケーションへのエンドユーザーアクセスは、4D RESTプロトコルに基づいているため、従来の 4Dリモートアプリケーションと同様に動作します。

Qodlyフォームは以下の URL からダウンロードできます:

IP:port/$lib/renderer/?w=QodlyFormName

IP:port は Webサーバーのアドレスを表し、QodlyFormName は Qodlyフォームの名前です。

例:

https://www.myWebSite.com/$lib/renderer/?w=welcome

強制ログイン

With Qodly Studio for 4D, you can use the "force login" mode to control the number of opened web sessions that require 4D Client licenses. You can also logout the user at any moment to decrement the number of retained licenses.

強制ログインモードの設定

You can set the "force login" mode for your 4D application in the Roles and Privileges page, using the Force login option:

alt-text

注

You can also set this option directly in the roles.json file.

When the "force login" mode is disabled (default mode), any REST request, including the rendering of an authentication Qodly form, creates a web session on the server and gets a 4D Client license, whatever the actual result of the authentication. When the "force login" mode is enabled, a simple authentication Qodly form can be rendered without consuming any license. You just need to implemented the authentify() function in the datastore class and call it from the Qodly form. この場合、ユーザーが実際にログインした場合にのみライセンスが消費されます。

info

For more information, refer to this blog post that tells the full story.

例題

In a simple Qodly form with login/password inputs, a "Submit" button calls the following authentify() function we have implemented in the DataStore class:

exposed Function authentify($credentials : Object) : Text
    
var $salesPersons : cs.SalesPersonsSelection
var $sp : cs.SalesPersonsEntity
    
$salesPersons:=ds.SalesPersons.query("identifier = :1"; $credentials.identifier)
$sp:=$salesPersons.first()
    
If ($sp#Null)
    If (Verify password hash($credentials.password; $sp.password))
            
        Session.clearPrivileges()
        Session.setPrivileges("") //guest session
            
        return "Authentication successful"
    Else 
        return "Wrong password"
    End if
Else 
    return "Wrong user"
End if 

This call is accepted and as long as the authentication is not successful, Session.setPrivileges() is not called, thus no license is consumed. Once Session.setPrivileges() is called, a 4D client licence is used and any REST request is then accepted.

ログアウト

When the "force login" mode is enabled, Qodly Studio for 4D allows you to implement a logout feature in your application.

To logout the user, you just need to execute the Logout standard action from the Qodly form. Qodly Studio では、この標準アクションをボタンなどに関連付けることができます:

alt-text

Webユーザーセッションからログアウトアクションをトリガーすると、次のような効果があります:

the current web user session loses its privileges, only descriptive REST requests are allowed,
関連する 4Dライセンスが解放されます。
the Session.storage is kept until the web session inactivity timeout is reached (at least one hour). During this period after a logout, if the user logs in again, the same session is used and the Session.storage shared object is available with its current contents.

レンダリングのためのライセンス消費について

QodlyフォームのレンダリングはプロジェクトデータベースのメインWebサーバーを対象とするため、デフォルトモードではあらゆるフォームがレンダリングされるとき、また、"強制ログイン" モードではデータ処理や関数を実行するフォームがレンダリングされるときに、利用可能なライセンスが必要です。

URLスキーム

Qodly Studio の URLスキーム設定 (HTTP および HTTPS) によって、Qodlyフォームのレンダリング時に使用されるライセンスの数が決まります。適切な設定により、不要なライセンスの使用を回避できます。

設定セクションで説明したように、WebAdmin Webサーバーは Qodly Studio へのセキュアな Webアクセスを提供します。一方、レンダラーは RESTリクエストを使用してデータベースの 4D Webサーバーと通信します。そのため、従来の 4Dクライアントと同じように動作します。そのため、従来の 4Dクライアントと同じように動作します。

Qodly Studio からレンダラーを実行する際、これら 2つの Webサーバーに同じ URLスキーム (HTTP または HTTPS) 経由でアクセスしていない場合には、ライセンスのカウントが正しくおこなわれない可能性があります。

例題

Qodly Studio を HTTPS URLスキームで実行します (例: https://127.0.0.1:7443/studio/)
データベースの Webサーバーは HTTPポート上でのみ起動します。

alt-text

Qodly Studioで、Preview アイコンをクリックします。 2つの Webサーバーが異なるスキームで起動されていることを警告されますが、それにもかかわらず、Confirm ボタンをクリックします。

結果、2つのライセンスが使用されます。

注

Qodly Studio のユーザー設定で、レンダラーのポップオーバーについて表示/非表示を切り替えることができます。

SameSite 属性

先に説明したふるまいは、4D Webサーバーのセッションcookie によるものです。このセッションcookie には、SameSite 属性があり、セッションcookie が Webサーバーに送信されるかどうかを決定します。

SameSite 属性の値が Strict (デフォルト) の場合、セッションcookie は Webサーバーに送信されないため、ページが表示されたり更新されたりするたびに新しいセッションが開かれます。

SameSite 属性の詳細については、このブログ記事を参照ください。

推奨事項

必要以上のライセンスを使用しないため、次のいずれかをお勧めします:

別のブラウザータブでレンダラーを実行します (Qodlyフォームがレンダリングされた URL IP:port/$lib/renderer/?w=QodlyFormName を入力します)。
Qodly Studio とデータベースが同じ URLスキームでアクセスされていることを確認します。
プロジェクトデータベースの Webサーバーのセッションcookie には、Lax の値を使用してください。

Hello, World

この 5分間のビデオでは "Hello World" の例を説明します。まず、Qodly Studio へのアクセスを有効にし、基本的なインターフェースを作成して、ユーザー名を使って挨拶をするイベントを設定します。

設定​

要件​

ブラウザー​

4Dアプリケーション​

Qodly Studio へのアクセスを有効化する​

4Dレベルで​

プロジェクトレベルで​

認証を有効化する​

プロジェクト管理​

Qodly Studio を開く​

Qodly Studio を使う​

Documentation​

機能の比較​

ランゲージ​

プロジェクトメソッドを使用する​

オフラインでの使用​

運用​

レンダリングを有効化する​

Qodlyフォームのスコープ​

Qodlyフォームへのアクセス​

強制ログイン​

強制ログインモードの設定​

例題​

ログアウト​

レンダリングのためのライセンス消費について​

URLスキーム​

例題​

SameSite 属性​

推奨事項​

Hello, World​

設定

要件

ブラウザー

4Dアプリケーション

Qodly Studio へのアクセスを有効化する

4Dレベルで

プロジェクトレベルで

認証を有効化する

プロジェクト管理

Qodly Studio を開く

Qodly Studio を使う

Documentation

機能の比較

ランゲージ

プロジェクトメソッドを使用する

オフラインでの使用

運用

レンダリングを有効化する

Qodlyフォームのスコープ

Qodlyフォームへのアクセス

強制ログイン

強制ログインモードの設定

例題

ログアウト

レンダリングのためのライセンス消費について

URLスキーム

例題

SameSite 属性

推奨事項

Hello, World