Title: カスタマイズ版プロジェクトのフォームの部品の定義や設定

カスタマイズ版プロジェクトの投稿/編集フォームの作成方法 では、投稿/編集フォーム全体の定義を行いました。

ここでは、フォームで使用する(フォームに配置する、フォームに表示する)部品の定義や設定について解説します。



フォームで使用する部品の指定



schema_elements= による指定



フォームの定義ファイルの中の schema_elements= に部品(フィールド)の名前を半角カンマ記号で並べ、「このフォームでは、このような名前の部品を使います」という指定をしました。

それぞれの部品がどのようなものなのか(テキスト入力欄なのか、ドロップダウン式のタグ選択欄なのか…など)は、別途 config/data/field/props フォルダで定義します。

それぞれの部品に対応する定義ファイルを config/data/field/props に設置します。ファイル名は、部品名.properties です。



このプラグイン「製品保守案件」の schema_elements= では次の 16 個の部品が指定されていますが、

  1. project ... 投稿先スペースの選択欄
  2. title ... タイトル記入用テキスト入力欄(実際にはここにはタイトルは記入しません)
  3. property_due ... 締切日の日付入力欄
  4. status ... プロジェクトの「オープン」と「完了」のドロップダウンリスト(「todo」タグと「done」タグの切り替え)
  5. color ... 色の選択欄
  6. content ... 本文の記入欄(リッチテキストエディタ)
  7. tags ... タグの選択欄
  8. attachments ... 添付ファイルの選択欄
  9. property_owners ... ユーザー(プロジェクトのオーナー)の選択欄
  10. property_members ... ユーザー(プロジェクトのメンバー)の選択欄
  11. property_goal_dashboard_milestones_max ... 表示するマイルストーンの最大数の入力欄
  12. property_edit_desc ... 編集するときの変更理由の記入用テキスト入力欄
  13. property_maintprod_subject ... 件名を記入するためのテキスト入力欄
  14. property_maintprod_price ... 料金を記入するためのテキスト(数値)入力欄
  15. property_maintprod_contract_date ... 契約日ための日付選択欄
  16. maintprod_category ... カテゴリーを選択するためのドロップダウンリスト


このプラグインの config/data/field/props フォルダに設置する定義ファイルは、上記の 13 〜 16 の、次の 4 つだけです。



これらの部品は TeamPage に予め用意されておらず、この「製品保守案件」プラグイン用に独自に用意(定義)する必要があります。

TeamPage に用意されている部品



他の部品は TeamPage に予め用意されているので、プラグイン内に定義ファイルを用意する必要はありません。TeamPage がインストールされた server フォルダ下の、config/data/field/props フォルダを確認してください。



部品の定義の書き方



テキスト入力欄 (property_maintprod_subject)



「件名」のテキスト入力欄の部品を定義します。

詳しくは 部品の定義:テキスト入力欄 を参照してください。

テキスト(数値)入力欄 (property_maintprod_price)



「料金」の数値入力欄の部品を定義します。

詳しくは 部品の定義:テキスト入力欄(数値) を参照してください。

日付選択欄 (property_maintprod_contract_date)



「契約日」を選択・入力するための日付入力欄の部品を定義します。

詳しくは 部品の定義:日付の入力欄 を参照してください。

タグ選択欄 (maintprod_catetory)



「カテゴリー」を選択するためのタグ用ドロップダウンリストの部品を定義します。

詳しくは 部品の定義:管理者が設定するドロップダウン式のタグ選択欄 を参照してください。

その他の種類



部品には、ここで紹介するテキスト入力欄、日付入力欄、タグ選択ドロップダウンの他にもいくつかの種類があります。

これらの種類は、server フォルダ下の config/data/field/types の中で定義されています。





Attachments:
image02.png
image03.png
image_props.png
関連記事
Article: DocSDK404 (permalink)
Date: 2020/05/03; 14時46分09秒 JST
Author Name: TeamPage サポート
Author ID: jpbo