メインコンテンツまでスキップ
バージョン: v18

4D プロジェクトのアーキテクチャー

4D プロジェクトは、一つの親プロジェクトフォルダー (パッケージフォルダー) に格納された、複数のファイルやフォルダーから構成されています。 例:

  • MyProject
    • Components
    • Data
      • Logs
      • Settings
    • Documentation
    • Plugins
    • Project
      • DerivedData
      • Sources
      • Trash
    • Resources
    • Settings
    • userPreferences.username
    • WebFolder

バイナリデータベースから変換されたプロジェクトの場合には、追加のフォルダーが存在している場合があります (doc.4d.com にて "データベースをプロジェクトモードに変換する" 参照)。

Project フォルダー

典型的な Project フォルダーの構造です:

  • databaseName.4DProject ファイル
  • Sources
    • Classes
    • DatabaseMethods
    • Methods
    • Forms
    • TableForms
    • Triggers
  • DerivedData
  • Trash (あれば)

databaseName.4DProject ファイル

プロジェクトを定義し、起動するためのプロジェクト開発ファイルです。 このファイルを開くには次のいずれかが必要です:

注: 4D プロジェクトの開発は 4D Developer によっておこない、マルチユーザー開発はソース管理ツールによって管理します。 4D Server は .4DProject ファイルを開くことができますが、クライアントからの開発はおこなえません。

Sources フォルダー

内容説明形式
catalog.4DCatalogテーブルおよびフィールド定義XML
folders.json エクスプローラーフォルダー定義JSON
menus.jsonメニュー定義JSON
settings.4DSettingsストラクチャーデータベース設定。 ユーザー設定 または データファイル用のユーザー設定 が定義されている場合は、そちらの設定が優先されます。 警告: コンパイル済みアプリケーションの場合、ストラクチャー設定は読み取り専用の .4dz ファイルに格納されます。 運用時にカスタム設定を定義するには、ユーザー設定 または データファイル用のユーザー設定 を使う必要があります。XML
tips.json定義されたヘルプTipsJSON
lists.json定義されたリストJSON
filters.json定義されたフィルターJSON
styleSheets.cssCSS スタイルシートCSS
styleSheets_mac.cssMac用 CSS スタイルシート (変換されたバイナリデータベースより)CSS
styleSheets_windows.cssWindows用 CSS スタイルシート (変換されたバイナリデータベースより)CSS

DatabaseMethods フォルダー

内容説明形式
databaseMethodName.4dmデータベース内で定義されているデータベースメソッド (1つのデータベースメソッドにつき1ファイル)。text

Methods フォルダー

内容説明形式
methodName.4dmデータベース内で定義されているプロジェクトメソッド (1つのメソッドにつき1ファイル)。text

Classes フォルダー

内容説明形式
className.4dm特定のオブジェクトをインスタンス化するための、ユーザークラス用の定義メソッド。 1クラスにつき1ファイル。ファイル名がクラス名になります。text

Forms フォルダー

内容説明形式
formName/form.4DFormプロジェクトフォームの定義json
formName/method.4dmプロジェクトフォームメソッドtext
formName/Images/pictureNameプロジェクトフォームのスタティックピクチャーpicture
formName/ObjectMethods/objectName.4dmオブジェクトメソッド (1つのオブジェクトメソッドにつき1ファイル)text

TableForms フォルダー

内容説明形式
n/Input/formName/form.4DForm入力テーブルフォームの定義 (n: テーブル番号)json
n/Input/formName/Images/pictureName入力テーブルフォームのスタティックピクチャーpicture
n/Input/formName/method.4dm入力テーブルフォームのフォームメソッドtext
n/Input/formName/ObjectMethods/objectName.4dm入力テーブルフォームのオブジェクトメソッド (1つのオブジェクトメソッドにつき1ファイル)text
n/Output/formName/form.4DForm出力テーブルフォーム (n: テーブル番号)json
n/Output/formName/Images/pictureName出力テーブルフォームのスタティックピクチャーpicture
n/Output/formName/method.4dm出力テーブルフォームのフォームメソッドtext
n/Output/formName/ObjectMethods/objectName.4dm出力テーブルフォームのオブジェクトメソッド (1つのオブジェクトメソッドにつき1ファイル)text

Triggers フォルダー

内容説明形式
table_n.4dmデータベース内で定義されているトリガーメソッド ( 1つのテーブルにつき1ファイル;n: テーブル番号)text

注: 拡張子 .4dm のファイルは、4Dメソッドのコードをテキスト形式で格納しており、 ソース管理ツールに対応しています。

Trash フォルダー

プロジェクトから削除されたメソッドやフォームがあれば、Trash フォルダーにはそれらが格納されます。 たとえば、つぎのフォルダーが格納されている場合があります:

  • Methods
  • Forms
  • TableForms

削除された要素はファイル名に括弧が付いた形でフォルダー内に置かれます (例: "(myMethod).4dm")。 フォルダーの構成は Sources フォルダーと同じです。

DerivedData フォルダー

DerivedData フォルダーには、処理を最適化するため 4D が内部的に使用するキャッシュデーターが格納されます。 これらは必要に応じて自動的に生成・再生成されます。 このフォルダーは無視してかまいません。

Resources フォルダー

Resources フォルダーには、追加のカスタムデータベースリソースファイルやフォルダーが格納されます。 アプリケーションインターフェースの翻訳やカスタマイズに必要なファイルはすべてここに格納します (ピクチャー、テキスト、XLIFF ファイルなど)。 4D は自動のメカニズムによってフォルダー内のファイル (とくに XLIFF ファイルおよびスタティックピクチャー) を扱います。 リモートモードにおいては、サーバーとすべてのクライアントマシン間でファイルを共有することが Resources フォルダーによって可能です (4D Server リファレンスマニュアルリソースフォルダの管理 を参照ください)。

内容説明形式
itemデータベースリソースファイルとフォルダー様々
Images/Library/itemピクチャーライブラリの個別ピクチャーファイル(*)。 各アイテムの名称がファイル名となります。 名称が重複する場合には、名称に番号が追加されます。picture

(*) .4db バイナリデータベースから変換されたプロジェクトの場合のみ

Data フォルダー

Data フォルダーには、データファイルのほか、データに関わるするファイルやフォルダーがすべて格納されています。

内容説明形式
data.4dd(*)レコードとして入力されたデータと、レコードに属するデータが格納されたデータファイルです。 4D プロジェクトを開くと、アプリケーションはカレントデータファイルをデフォルトで開きます。 このファイルの場所や名称を変更した場合は、データファイルを開く ダイアログボックスが表示され、使用するデータファイルを選択するか、新しいデータファイルを作成できます。binary
data.journalデータベースがログファイルを使用する場合のみ作成されます。 ログファイルは2つのバックアップ間のデータ保護を確実なものにするために使用されます。 データに対して実行されたすべての処理が、このファイルに順番に記録されます。 つまりデータに対して操作がおこなわれるたびに、データ上の処理 (操作の実行) とログファイル上の処理 (操作の記録) という 2つの処理が同時に発生します。 ログファイルはユーザーの処理を妨げたり遅くしたりすることなく、独立して構築されます。 データベースは 1つのログファイルしか同時に使用できません。 ログファイルにはレコードの追加・更新・削除やトランザクションなどの処理が記録されます。 ログファイルはデータベースが作成される際にデフォルトで生成されます。binary
data.match(内部用) テーブル番号に対応する UUIDXML

(*) .4db バイナリデータベースからプロジェクトに変換した場合、データファイルは変換による影響を受けません。 このデータファイルの名称を変更して移動させることができます。

Settings フォルダー

Settings フォルダーには、データベースの管理に使用される データファイル用のユーザー設定 ファイルが格納されます。

この設定は ユーザー設定ストラクチャー設定 より優先されます。

内容説明形式
Backup.4DSettingsこのデータファイルを使ってデータベースが実行されている場合に使用する バックアップオプション を定義したデータベースバックアップ設定です。 バックアップ設定に使われるキーについての説明は バックアップ設定ファイル マニュアルを参照ください。XML
settings.4DSettingsデータファイル用のカスタムデータベース設定XML
directory.jsonこのデータファイルを使ってデータベースが実行されている場合に使用する 4D グループとユーザー、およびアクセス権の定義JSON

Logs フォルダー

Logs フォルダーには、プロジェクトが使用するすべてのログファイルが格納されます。 以下のログファイルが格納されます:

  • データベース変換
  • Webサーバーリクエスト
  • バックアップ/復元アクションのジャーナル (Backup Journal[xxx].txtバックアップジャーナル 参照)
  • コマンドデバッグ
  • 4D Serverリクエスト (クライアントマシンおよびサーバー上で生成)

データフォルダーが読み取り専用モードの場合やメンテナンスログファイルの保存には、システムのユーザー設定フォルダー (Active 4D Folder のこと、詳しくは Get 4D folder コマンド参照) 内にある Logs フォルダーが利用されます。

Settings フォルダー

このフォルダーにはデータベースの管理に使用される ユーザー設定 ファイルが格納されます。 必要に応じてこのフォルダーにファイルが追加されます。

Data フォルダーの Setting フォルダー内にデータファイル用のユーザー設定ファイルがある場合には、そちらが優先されます。

内容説明形式
directory.json4D グループとユーザー、およびアクセス権の定義JSON
BuildApp.4DSettingsアプリケーションビルダーのダイアログボックス、または BUILD APPLICATION コマンドを使ったときに自動的に作成されるビルド設定ファイルXML
Backup.4DSettingsバックアップ開始時に バックアップオプション を指定するためのデータベースバックアップ設定です。 このファイルは、バックアップジャーナル に保存する情報量などの追加オプションの確認や設定にも使用することができます。 バックアップ設定に使われるキーについての説明は バックアップ設定ファイル マニュアルを参照ください。XML
BuildApp.4DSettingsアプリケーションビルダーのダイアログボックス、または BUILD APPLICATION コマンドを使ったときに自動的に作成されるビルド設定ファイルXML

userPreferences.userName フォルダー

ブレークポイントやウィンドウの位置など、ユーザーの環境設定を定義するファイルを格納するフォルダーです。 このフォルダーは無視してかまいません。 格納されるファイルの例です:

内容説明形式
methodPreferences.jsonカレントユーザーのメソッドエディター環境設定JSON
methodWindowPositions.jsonカレントユーザーのメソッドのウィンドウポジションJSON
formWindowPositions.jsonカレントユーザーのフォームのウィンドウポジションJSON
workspace.json開かれているウィンドウのリスト;macOS ではタブウィンドウの順序JSON
debuggerCatches.jsonキャッチコマンドリストJSON
recentTables.json最近開かれたテーブルのリストJSON
preferences.4DPreferencesカレントデータパスおよび主なウィンドウの位置XML

Components フォルダー

プロジェクトデータベースが利用するコンポーネントを格納するフォルダーです。 このフォルダーは、Project フォルダーと同じ階層に置きます。

プロジェクトデータベースはコンポーネントとして利用することができます:

  • 開発においては、ホストデーターベースの Components フォルダーに .4dproject ファイルのエイリアスを置きます。
  • 運用時においては、コンポーネントをビルドし (プロジェクトパッケージのビルド)、生成された .4dz ファイルを .4dbase フォルダーに格納し、それをホストデータベースの Components フォルダーに置きます。

Plugins フォルダー

プロジェクトデータベースが利用するプラグインを格納するフォルダーです。 このフォルダーは、Project フォルダーと同じ階層に置きます。