フィールドとウィジェット¶
フィールドは、データベースの:doc:`モデル <models_modules_apps>`を構造化します。モデルをテーブルやスプレッドシートと考えると、フィールドは列であり、レコードは個々の行です。フィールドはまた、その中に格納されるデータの種類も定義します。フィールドのデータが:abbr:`UI(ユーザインターフェース)`上でどのように表示およびフォーマットされるかは、そのウィジェットによって制御されます。
ワンルームでは、次のことが可能です:
データベースに:ref:`新しいフィールドを追加 <studio/fields/add-new>`できます。技術的な観点から、Odooには15の:ref:`フィールドタイプ <studio/fields/field-types>`があります。ただし、一部のフィールドタイプは異なるデフォルトウィジェットで複数回利用できるため、ワンルームでは21のフィールドタイプから選択できます。
add existing fields, i.e., fields that already exist on a model, to any view of that model;
:ref:`フィールドの物件を変更 <studio/fields/modify>`する、または
:ref:`ビューからフィールドを削除 <studio/fields/remove>`する。
ワンルームフィールドと物件フィールド
ワンルームを使用して作成されたフィールドは、Odooデータベースの列として保存されます。一方、:doc:`物件フィールド <../essentials/property_fields>`は疑似フィールドとして機能します。これらは同じ親レコードにリンクされているすべてのレコード（たとえば、タスクの場合はプロジェクト、プロダクトの場合はプロダクトカテゴリ）で共有されますが、データベースの列としては保存されません。
フィールドの種類¶
フィールドは大きく2つのカテゴリに分けられます。
文字列、数値、ファイルなどの基本的な値を含む:ref:
シンプルフィールド <studio/fields/simple-fields>。別のモデル上のレコードからデータをリンクして表示するために使用される:ref:
リレーショナルフィールド <studio/fields/relational-fields>。
シンプルフィールド¶
注釈
デフォルト以外のウィジェットは、対応可能な場合、箇条書きまたはサブ見出しとして表示されます。
テキスト (char)¶
テキストフィールドは、任意の文字を含む短いテキストに使用されます。フィールドに入力する際、1行のテキスト行が表示されます。
バッジ：タグのような丸い形状の中に値を表示します。UIで値を編集することはできませんが、デフォルト値を設定できます。
クリップボードにコピー：ユーザはボタンをクリックして値をコピーできます。
Eメール：値がクリック可能な*mailto*リンクになります。
画像：URLを使用して画像を表示します。値を手動で編集することはできませんが、デフォルト値を設定できます。
電話：値がクリック可能な*tel*リンクになります。
ちなみに
Odooのフィールドの横からSMSを直接送信するオプションを追加するには、:guilabel:`SMSを有効にする`にチェックを入れます。
URL: 値がクリック可能なURLになります。
Example
複数行テキスト (text)¶
:guilabel:`複数行テキスト`フィールドは、あらゆる種類の文字を含む長いテキストに使用されます。フィールドに入力する際、UIには2行のテキスト行が表示されます。
クリップボードにコピー：ユーザはボタンをクリックして値をコピーできます。
Example
整数 (integer)¶
整数`フィールドは、すべての整数(:dfn:`正、負、またはゼロで、小数点なし)に使用されます。
パーセンテージ円グラフ: 通常は計算値に対して、値をパーセンテージの円の中に表示します。UIで値を編集することはできませんが、デフォルト値を設定することができます。
プログレスバー: 通常は計算値に対して、値をパーセンテージバーの横に表示します。フィールドを手動で編集することはできませんが、デフォルト値を設定することができます。
ハンドル: :ref:`リストビュー <studio/views/multiple-records/list>`でレコードを手動で並べ替えるためのドラッグハンドルアイコンを表示します。
Example
小数 (float)¶
小数`フィールドは、すべての小数(:dfn:`正、負、またはゼロで、小数点あり)に使用されます。
注釈
小数はUIでは小数点以下2桁で表示されますが、データベースにはより高い精度で保存されます。
金額: :ref:`金額フィールド <studio/fields/simple-fields-monetary>`の使用に似ています。後者の方がより多くの機能を提供するため、そちらを使用することをお勧めします。
パーセンテージ: 値の後にパーセント記号
%を表示します。パーセンテージ円グラフ: 通常は計算値に対して、値をパーセンテージの円の中に表示します。フィールドを手動で編集することはできませんが、デフォルト値を設定することができます。
プログレスバー: 通常は計算値に対して、値をパーセンテージバーの横に表示します。フィールドを手動で編集することはできませんが、デフォルト値を設定することができます。
時刻: 値は hh:mm 形式に従う必要があり、最大59分です。
Example
HTML (html)¶
:guilabel:`HTML`フィールドは、Odoo HTMLエディタで編集できるテキストを追加する際に使用されます。
複数行テキスト: Odoo HTMLエディタを無効化し、生のHTMLを編集できるようにします。
Example
金額 (monetary)¶
:guilabel:`金額`フィールドは、すべての金額値に使用されます。
注釈
:guilabel:`金額`フィールドを初めて追加する際、モデルに:guilabel:`通貨`フィールドがまだ存在しない場合、追加するように求められます。Odooは:guilabel:`通貨`フィールドの追加を提案します。追加されたら、:guilabel:`金額`フィールドを再度追加してください。
Example
Date (date) and Datetime (datetime)¶
The Date field is used to select a date on a calendar. The Datetime field is used to select a date on a calendar and a time on a clock; if no time is set, the time of the user's local device is automatically used.
Date Range: displays a period of time defined by a start date and an end date in a single line. A date range can have a mandatory start and end date, e.g., for a multi-day event, or allow an optional start or end date, e.g., for a field service intervention or a project task. If the field is a Datetime field, a start time and end time are also displayed.
Remaining Days: displays the remaining number of days before the selected date (e.g., In 5 days), based on the current date and time. This field should be set to Readonly.
Example
ちなみに
As well as general properties, some specific properties are available for Date and Datetime fields.
期間 (daterange)¶
Adding a date range requires two fields:
a Date or Datetime field with the Date Range widget set
another field that is selected as the start date or end date. This underlying field can be an existing Date or Datetime field, or one created specifically for this purpose.
期間を追加するには:
Identify the existing Date or Datetime field to use as the underlying start/end date field, or add a new one. If the date range:
必須の開始日と終了日があり、このフィールドは開始日または終了日のいずれかになります。結果は同じです。
オプションの開始日または終了日を許可します。このフィールドはそれぞれ開始日または終了日です。
Add a Date or Datetime field and set the Widget field to Date Range.
適切な:guilabel:`ラベル`を入力します。
:guilabel:`開始日フィールド`または:guilabel:`終了日フィールド`ドロップダウンから、関連する基になる開始日/終了日フィールドを選択します。
If the date range should always have a start and end date, enable Always range.
Update any other general properties or specific properties for Date and Datetime fields as needed, then click Close in the upper right corner of the screen.
チェックボックス（boolean）¶
:guilabel:`チェックボックス`フィールドは、チェックボックスのオン/オフで示される真または偽の値のみを持つ場合に使用されます。
ボタン：ラジオボタンを表示します。このウィジェットは編集モードに切り替えることなく機能します。
トグル：トグルボタンを表示します。このウィジェットは編集モードに切り替えることなく機能します。
Example
選択（selection）¶
:guilabel:`選択`フィールドは、ユーザーが事前定義された値のグループから単一の値を選択する必要がある場合に使用されます。
バッジ：タグのような丸い形状の中に値を表示します。UIで値を編集することはできませんが、デフォルト値を設定できます。
バッジ：選択可能なすべての値を長方形の形状で水平に整理して同時に表示します。
優先度：値の代わりに星のシンボルを表示します。これは、例えば重要度や満足度レベルを示すために使用できます。これは:ref:`優先度フィールド <studio/fields/simple-fields-priority>`を選択した場合と同じ効果がありますが、後者の場合は4つの優先度値がすでに事前定義されています。
ラジオボタン: 選択可能なすべての値をラジオボタンとして同時に表示します。
ちなみに
デフォルトでは、ラジオボタンは縦に配置されます。:guilabel:`横に表示`を有効にすると、表示方法が切り替わります。
ステータスバー: 選択可能なすべての値を矢印の進行状況バーとして同時に表示します。
ちなみに
デフォルトでは、ステータスバーの値は選択可能です。:guilabel:`クリック可能`を無効にすると、UI上で値が編集されなくなります。
Example
ファイル (binary)¶
The File field is used to upload any type of file.
画像: ユーザーは画像ファイルをアップロードでき、:ref:`フォームビュー <studio/views/general/form>`に表示されます。これは:ref:`画像フィールド <studio/fields/simple-fields-image>`を使用するのと同じ効果があります。
PDFビューア: ユーザーはPDFファイルをアップロードでき、:ref:`フォームビュー <studio/views/general/form>`から閲覧できます。
Example
Image (image)¶
画像`フィールドは、画像をアップロードして:ref:`フォームビュー <studio/views/general/form>`に表示するために使用されます。このフィールドタイプは、デフォルトで:guilabel:`画像`ウィジェットが選択された:ref:`ファイルフィールド <studio/fields/simple-fields-file>`です。そのため、:guilabel:`ファイル、PDFビューア、:guilabel:`署名`ウィジェットは、:ref:`ファイル <studio/fields/simple-fields-file>`で説明したものと同じ効果があります。
ちなみに
アップロードした画像の表示サイズを変更するには、サイズ`オプションで:guilabel:`小、中、または:guilabel:`大`を選択します。
優先度 (selection)¶
優先度`フィールドは、重要度や満足度を示すために使用できる3段階の星評価システムを表示するために使用されます。このフィールドタイプは、デフォルトで:guilabel:`優先度`ウィジェットが選択され、4つの優先度値が事前定義された:ref:`選択フィールド <studio/fields/simple-fields-selection>`です。そのため、:guilabel:`バッジ、バッジ(複数)、ラジオボタン、:guilabel:`選択`ウィジェットは、:ref:`選択 <studio/fields/simple-fields-selection>`で説明したものと同じ効果があります。
ちなみに
利用可能な星の数を変更するには、値を追加または削除して:guilabel:`値を編集`をクリックします。最初の値は0個の星(つまり、選択されていない状態)に相当するため、4つの値がある場合は3段階の星評価システムになることに注意してください。
Example
Signature (signature)¶
The Signature field is used to sign the form electronically. This field type is a File field with the Signature widget selected by default. Consequently, the File, Image, and PDF Viewer widgets have the same effects as described under File.
ちなみに
To give users the Auto option when having to draw their signature, select one of the available Prefill with fields (Many2One, and Related Field on the model only). The signature is then automatically generated using the data from the selected field.
Example
AIフィールド¶
An AI Field is essentially a standard Odoo field with added AI capabilities that allow its values to be generated automatically through prompts.
ちなみに
It is also possible to add AI capabilities to a newly added field via the field properties.
リレーションフィールド¶
注釈
デフォルト以外のウィジェットは、対応可能な場合、箇条書きまたはサブ見出しとして表示されます。
Lines (one2many)¶
:guilabel:`Lines`フィールドは、行と列を持つテーブルを作成するために使用されます(例: 販売オーダ上のプロダクトの明細行)。
ちなみに
列を変更するには、:guilabel:`Lines`フィールドをクリックしてから:guilabel:`Edit List View`をクリックします。ユーザが:guilabel:`Add a line`をクリックしたときに表示されるフォームを編集するには、代わりに:guilabel:`Edit Form View`をクリックします。
Example
One2Many (one2many)¶
:guilabel:`One2Many`フィールドは、現在のモデルのレコードと別のモデルの複数のレコード間の既存のリレーションを表示するために使用されます。
Many2One (many2one)¶
:guilabel:`Many2One`フィールドは、(別のモデルから)別のレコードを編集中のレコードにリンクするために使用されます。編集中のレコードには、他のモデルからのレコード名が表示されます。
Example
*Sales Order*モデルでは、:guilabel:`Customer`フィールドは*Contact*モデルを参照する:guilabel:`Many2One`フィールドです。これにより、**多数**の販売オーダを**1つ**の連絡先(顧客)にリンクできます。
ちなみに
リンクされたモデルで新しいレコードをユーザが作成できないようにするには、:guilabel:`Disable creation`にチェックを入れます。
ポップアップウィンドウでレコードをユーザが開けないようにするには、:guilabel:`Disable opening`にチェックを入れます。
ユーザが適切なレコードのみを選択できるようにするには、:guilabel:`Domain`をクリックしてフィルターを作成します。
リンクされたレコードの検索を最小文字数入力後にのみトリガーするには、:guilabel:`Typeahead search`フィールドに希望する文字数を入力します。データセットが大きい場合、これにより検索の関連性とパフォーマンスの両方が向上します。
Badge: タグと同様に、丸みを帯びた形状内に値を表示します。UI上で値を編集することはできません。
ラジオボタン: 選択可能なすべての値をラジオボタンとして同時に表示します。
Many2Many (many2many)¶
Many2Many`フィールドは、別のモデルの複数のレコードを現在のモデルの複数のレコードにリンクするために使用されます。Many2Manyフィールドは、:ref:`Many2Oneフィールド <studio/fields/relational-fields-many2one>`と同様に、:guilabel:`作成の無効化、開くことの無効化、:guilabel:`ドメイン`を使用できます。
Example
*タスク*モデルでは、:guilabel:`担当者`フィールドは*連絡先*モデルを指す:guilabel:`Many2Many`フィールドです。これにより、1人のユーザが**複数**のタスクに割り当てられ、**複数**のユーザが1つのタスクに割り当てられることが可能になります。
ちなみに
リンクされたレコードの検索を最小文字数入力後にのみトリガーするには、:guilabel:`Typeahead search`フィールドに希望する文字数を入力します。データセットが大きい場合、これにより検索の関連性とパフォーマンスの両方が向上します。
チェックボックス:ユーザはチェックボックスを使用して複数の値を選択できます。
タグ:ユーザは丸みを帯びた形状で表示される複数の値を選択できます。これは*タグ*とも呼ばれます。これは:ref:`タグフィールド <studio/fields/relational-fields-tags>`を選択するのと同じ効果があります。
タグ(many2many)¶
:guilabel:`タグ`フィールドは、別のモデルから取得した複数の値を丸みを帯びた形状(いわゆる*タグ*)で表示するために使用されます。このフィールドタイプは、デフォルトで:guilabel:`タグ`ウィジェットが選択された:ref:`Many2Manyフィールド <studio/fields/relational-fields-many2many>`です。したがって、:guilabel:`チェックボックス`および:guilabel:`Many2Many`ウィジェットは、:ref:`Many2Many <studio/fields/relational-fields-many2many>`で説明されているものと同じ効果があります。
ちなみに
異なる背景色でタグを表示するには、:guilabel:`色を使用`にチェックを入れます。
Example
ビューにフィールドを追加¶
ワンルームでは、次のことが可能です。
モデルの:ref:`フォーム <studio/views/general/form>`または:ref:`リストビュー <studio/views/multiple-records/list>`に:ref:`新しいフィールド <studio/fields/add-new>`を追加
:doc:`モデル <models_modules_apps>`上に既に存在するフィールド、つまり:ref:`既存のフィールド <studio/fields/add-existing>`を、そのモデルの*任意の*ビューに追加
ちなみに
フォームまたはリストビューに新しいフィールドを追加すると、モデルに保存され、同じモデルの他のビューで既存のフィールドとして使用できるようになります。
新しいフィールドの追加¶
ちなみに
新しいフィールドを追加する*前に*:ref:`開発者モード <developer-mode>`を有効にすると、設定中にフィールドの技術名を確認し、編集できるようになります。
新しいフィールドを追加するには、以下の手順に従います。
関連するフォームまたはリストビューに移動し、右上隅の (ワンルームを切り替え) アイコンをクリックします。または、任意のアプリを開いた状態で (ワンルームを切り替え) アイコンをクリックし、関連するフォームまたはリストビューに移動します。
追加 タブで、新規フィールド セクションから該当する フィールドタイプ をドラッグし、目的の位置にドロップします。新しいフィールドが リレーショナルフィールド の場合は、ポップアップで関連する相互フィールド、モデル、または関連フィールドを選択します。
物件 タブで、フィールドの プロパティ を設定します。
UI上でフィールド名として表示される ラベル を入力します。これはフィールドのデフォルトの技術名を生成するためにも使用されます。
ラベル フィールドの外側をクリックすると、技術名 がデフォルトの技術名で更新されます。
注釈
新しいフィールドの 技術名 は、設定プロセス中にワンルームで編集できます。それ以外の場合、フィールドの技術名は データベースの技術設定から変更 することのみ可能です。
ワンルームを使用して追加された新しいフィールドの技術名は、デフォルトで
x_studio_がプレフィックスとして付けられます。
オプションで、ドロップダウンから別の ウィジェット を選択します。フィールドタイプ のデフォルトウィジェットがデフォルトで選択されています。
オプションで、その他の フィールドプロパティ を設定します。
右上隅の 閉じる をクリックして、ワンルームを閉じます。
既存のフィールドを追加¶
モデルに存在するが現在のビューには表示されていないフィールドを追加するには、以下の手順に従います。
関連するビューに移動し、右上隅の (ワンルームを切り替え) アイコンをクリックします。または、任意のアプリを開いた状態で (ワンルームを切り替え) アイコンをクリックし、関連するビューに移動します。
追加 タブで、左パネルの 既存のフィールド をクリックすると、現在ビューに表示されていないモデルのすべてのフィールドのリストが表示されます。
該当するフィールドをドラッグし、目的の位置にドロップします。
物件 タブで、現在のビューにおけるフィールドの関連する プロパティ を設定します。
注釈
必要に応じて、ラベル、ウィジェット、特定のユーザグループに対するフィールドの公開設定、フィールドが 非表示、必須、または 読み取り専用 かどうかなど、さまざまなプロパティを異なるビューごとに独立して設定できます。
右上隅の 閉じる をクリックして、ワンルームを閉じます。
フィールドのプロパティ¶
:ref:`一般的なプロパティ <studio/fields/properties-general>`のシリーズは、ほとんどの:ref:`フィールドタイプとウィジェット <studio/fields/field-types>`の組み合わせで設定できます。選択した特定のフィールドタイプとウィジェットに応じて、追加のプロパティが利用可能です。たとえば、:guilabel:`日時`フィールドで:guilabel:`日時`または:guilabel:`日付範囲`ウィジェットを使用する場合、設定可能なさまざまな:ref:`固有のプロパティ <studio/fields/properties-date-datetime>`があります。
一般的な物件¶
クラス: `Bootstrap <https://getbootstrap.com/docs/5.3/examples/cheatsheet/>`_またはOdooで定義されている他のカスタムクラスを使用して、UIでのフィールドのスタイルと表示方法をカスタマイズします。
非表示:UIでフィールドを表示する必要がない場合は、この物件を有効にします。これにより、特定の状況に応じて必要不可欠なフィールドのみを表示し、UIをすっきりさせることができます。
必須:先に進む前にユーザが常にフィールドを入力する必要がある場合は、この物件を有効にします。
読み取り専用:ユーザがフィールドを変更できないようにする場合は、この物件を有効にします。
ちなみに
ラベル: これはUI上のフィールド名です。ラベルはフィールドの技術名を生成するために使用されます。
ヘルプツールチップ:フィールドの目的を説明するには、説明を追加します。フィールドのラベルの横にある疑問符にマウスを重ねると、ツールチップボックス内にテキストが表示されます。
AI: To add AI capabilities allowing the value of the field to be generated automatically through a prompt, enable AI. When the browser page reloads, click the Prompt field that appears and enter a prompt; type
/to open the AI prompt tools and use the Field Selector to tell Odoo AI which fields to check for context. Click Save & Generate.ちなみに
It is also possible to add a new AI field directly to a form or list view.
技術名: Studioでフィールドの技術名を表示する(および新しいフィールドの設定中に必要に応じて編集する)には、:ref:`開発者モード <developer-mode>`を有効にします。
ちなみに
このフィールドを更新する必要があるがStudio経由では編集できなくなった場合、技術名は:ref:`データベースの技術設定から変更 <studio/fields/properties-technical-name-change>`できます。
ウィジェット:フィールドのデフォルトの外観や機能を変更するには、利用可能なウィジェットの1つを選択します。
プレースホルダー: フィールドの入力方法の例を示すには、固定のプレースホルダーテキストを追加します。テキストは値が入力されるまで薄いグレーで表示されます。
動的プレースホルダー: 選択したフィールドの値をフィールドの入力方法の例として提供します。テキストは値が入力されるまで薄いグレーで表示されます。
Default value: To display a default value in a field when a record is created, enter a value.
グループへの公開設定の許可:フィールドを表示できるユーザを制限するには、1つ以上のユーザアクセス:ref:`グループ <access-rights/groups>`を選択します。
グループへの公開を禁止: 特定のユーザがこのフィールドを見られないようにするには、1つ以上のユーザアクセス:ref:`グループ <access-rights/groups>`を選択します。
Properties for Date and Datetime fields¶
For Date fields using the Date or Date Range widget and Datetime fields using the Date & Time or Date Range widget, some specific properties are available:
Minimal precision: Determine the smallest date unit that must be selected in the date selector. The possible values are
Days,Decades,MonthsandYears. If no value is selected, the user must select a day in the date or datetime selector.Maximal precision: Determine the largest date unit that can be used to navigate the date selector. The possible values are
Days,Decades,MonthsandYears. If no value is selected, the user can navigate the date selector by decade.Date format: By default the date will be shown as e.g.,
Jan 31, 2026(or the equivalent for the user's language/regional settings). Select the all-numeric date format, e.g., 31/01/2026, if desired.Warning for future dates: Enable this property to warn the user that a future date has been selected by displaying the date in red.
最も早い受付可能日付: 日付選択で選択できる最も早い日付をISO形式(
YYYY-MM-DD)で入力します。現在の日付が常に最も早い受付可能日付である場合は、`today`と入力します。日付選択では、最も早い受付可能日付より前の日付はグレー表示されます。最も遅い受付可能日付: 日付選択で選択できる最も遅い日付をISO形式(
YYYY-MM-DD)で入力します。現在の日付が常に最も遅い受付可能日付である場合は、`today`と入力します。日付選択では、最も遅い受付可能日付より後の日付はグレー表示されます。
For Date or Datetime fields using the Date Range widget, additional properties are available:
Start date field and End date field: These properties are used to define a start or end date for a date range or date and time range; only one of these properties can be populated.
Show date: This property is enabled by default for Datetime fields. Disable this property to show only the time.
時刻を表示: このプロパティは:guilabel:`日付&時刻`フィールドでデフォルトで有効になっています。読み取り専用フィールドでこのプロパティを無効にすると、日付のみが表示されます。これにより、例えばリストビューをすっきりと保つことができます。
Show seconds: This property is disabled by default for Datetime fields. Enable the property to show the seconds.
時間間隔: 値を入力して、時刻選択で表示される分の間隔を決定します。例えば、15分間隔を許可するには15と入力します。デフォルト値は5分に設定されています。
フィールドのプロパティを変更¶
フィールドのプロパティを変更するには、次の手順に従います:
関連するビューに移動し、右上隅の (ワンルームを切り替え) アイコンをクリックします。または、任意のアプリを開いた状態で (ワンルームを切り替え) アイコンをクリックし、関連するビューに移動します。
該当するフィールドをクリックします。
:guilabel:`プロパティ`タブで、:ref:`フィールドプロパティ <studio/fields/properties>`に必要な変更を加えます。
ちなみに
さまざまなプロパティは、ラベル、ウィジェット、特定のユーザーグループに対するフィールドの公開設定、およびフィールドが:guilabel:
非表示、必須、または:guilabel:`読み取り専用`であるかどうかなど、異なるビューに対して個別に設定できます。右上隅の 閉じる をクリックして、ワンルームを閉じます。
フィールドの技術名を変更¶
フィールドの技術名を変更するには、:ref:`開発者モード <developer-mode>`を有効にしてから、次の手順に従います:
ワンルームでフィールドを開いた状態で、フィールドの技術名をコピーします。
ワンルームで*すべて*のビューから:ref:`フィールドを削除 <studio/fields/remove>`してから、:guilabel:`閉じる`をクリックしてワンルームを閉じます。
:menuselection:`設定アプリ --> 技術 --> フィールド`に移動します。
コピーした技術名を検索バーに貼り付けてから、該当するフィールドを開きます。
必要に応じて:guilabel:`フィールド名`を変更します。
フィールドの技術名が更新されたら、既存のフィールドのリストから、該当するビューに:ref:`フィールドを(再度)追加 <studio/fields/add-existing>`できます。
重要
フィールドの技術名を更新する際は、少なくとも x_ プレフィックスを保持してください。これはカスタムフィールドに必要です。ワンルームを使用して作成されたフィールドの場合は、x_studio_ プレフィックスを保持することで、そのようなフィールドをより簡単に識別できるようになります。
ビューからフィールドを削除¶
ビューからフィールドを削除するには、次の手順に従います: