4D Write Proドキュメントを4Dオブジェクトフィールドに保存する

4D Write Proドキュメントを自動的に4Dデータファイルに保存できるようになりました。フォーム内に4D Write Proエリアを作成し、そのエリアの中身を保存するオブジェクトフィールドを作成すれば、エリア内に入力したテキストはレコードが評価されるごとにそれぞれのレコードへと自動的に保存されます。その後QUERY BY ATTRIBUTEコマンドを使用して内部属性の値に基づいてレコードを選択する事ができます。また独自の属性を4D Write Proエリアに追加しクエリすることができます。

この章では以下の機能について説明しています:

• フォーム内の4D Write Proエリアを4D オブジェクトフィールドへと結びつける
• 標準のオブジェクトコマンドOB SET、OB GetおよびQUERY BY ATTRIBUTEを使用して、保存されている4D Write Proドキュメントのカスタムの属性を設定、取得、そしてクエリする

4D Write Proエリアを4Dオブジェクトフィールドに割り当てるためには、エリアの変数名プロパティにフィールド名を入力するだけです。

データベースのストラクチャー内において、4Dオブジェクトフィールドであればどれでも4D Write Proドキュメントを保存するのに使用する事ができます。他のオブジェクトフィールドと同様、必要に応じて以下のフィールドの標準のプロパティを定義する必要があります:

• フィールド名
• "4D Mobile Serviceに公開"などの属性とインデックス
• 保存オプション(詳細についてはをデータをデータファイル外に保存参照して下さい)

4D Write Proドキュメントを保存するオブジェクトフィールドを決めたら、あとはそのエリアを含んでいるフォーム内で参照するだけです。どのようなテーブルフォームもプロジェクトフォームも使用する事ができます。フォームエディター内において、4D Write Proエリアのプロパティリスト内の、変数名の欄に標準の"[Table]Field"表記を使用してフィールド名を入力して下さい:

これで4D Write Proエリアはフィールドと関連付けがなされ、エリアの中身はレコード毎に自動的に保存されるようになりました。4D自動アクションボタンを使用しない場合、4Dコマンドを使用してエリアを手動で保存しなければならない点に注意して下さい。

4D Write Proエリアがオブジェクトフィールド内に保存されているとき、4D Write Proドキュメントにはカスタムの属性を保存または読み出しすることができます。例えば作者名、ドキュメントのカテゴリーなど、どんな追加情報でも有用だと思えるものは使用する事ができます。そしてカスタムの属性をクエリし、条件に合致したレコードを選択することができます

カスタムの属性は WP EXPORT DOCUMENT または WP EXPORT VARIABLE コマンドで書き出されます。カスタムの属性はJSON Stringifyコマンドを使用して4D Write Pro オブジェクトフィールドをJSONに変換する際にも書き出されます(同時に4D Write Pro のメインドキュメント属性も書き出されます)。

カスタムの属性を設定または取得するためには、標準のOB Get と OB SETコマンドを使用するだけです。

たとえばフォームメソッドにおいて、以下のように書くことがでカスタムの属性を設定できます:

また、以下のように書いて、ドキュメントのカスタムの属性を読み出すことができます:

カスタムの4D Write Pro属性をデータファイルに保存していた場合、これらの属性をクエリして適切な属性の値を含むレコードのセレクションを作成することができます。以下の例では、レコードを選択するためにオブジェクトフィールドを含んでいるテーブルをクエリします:

カスタム属性の名前についての注意: カスタム属性は4D Write Pro内部属性と同じ名前空間を共有するため、内部属性とカスタム属性との衝突を避けるために、独自の属性を定義するときには必ず接頭辞をつけた名前を定義する事が強く推奨されます。接頭辞がついていない名前は4D Write Proの内部属性のために予約されているからです。接頭辞であればどのような独自の接頭辞であっても使用する事ができます(上記の例では"myatt_" を接頭辞として使用しました)。

注: 4D v15 R4以降、4D Write Pro内部属性は、標準のQUERY BY ATTRIBUTEとOB GetとOB SETコマンドだけではなく、WP SET ATTRIBUTES、WP GET ATTRIBUTES、WP RESET ATTRIBUTESコマンドを使用してもプログラムでアクセスする事ができるようになりました。詳細な情報については、4D Write Pro属性の章を参照して下さい。