> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# カスタムフィールド

> 得意先、アイテム、受注などの主要なレコードに、自社独自のフィールドを追加します。定義方法、対応するレコード、値の保存先を説明します。

管理者はカスタムフィールドを使って、Alforse が標準では管理していない情報を記録します。たとえば、部品の輸出分類や、得意先の主要アカウント担当者などです。各フィールドは一度定義するだけで、以降はそのレコードタイプのフォームに表示され、標準フィールドと一緒に保存され、API から読み取れます。データベースの変更は不要です。

## フィールドを追加する

1. **設定 → カスタムフィールド**を開きます。対象となる各レコードタイプが 1 行ずつ表示され、**テーブル**、**モジュール**、すでにある**フィールド**数が確認できます。
2. レコードタイプの行メニューを開き、**新しいフィールド**を選択します。**カスタムフィールドを表示**を選択してそのタイプの既存のフィールドを確認し、そこから追加することもできます。**新しいカスタムフィールド**フォームが開きます。
3. 以下の設定を入力し、**保存**を選択します。

レコードタイプのフィールド一覧では、ハンドルをドラッグしてフィールドの表示順を変更したり、フィールドを編集または削除したりすることもできます。

Alforse screenshot**設定 → カスタムフィールド：テーブル、モジュール、フィールドの列を持つエンティティカタログと、名前・データ型・タグを持つフィールドフォーム**

対象エンティティごとに 1 行。フィールドフォームでは、作成後にデータ型がロックされます。

### フィールド設定

FieldType

<details>
  <summary>**名前**required`text`</summary>

  ユーザーに入力欄のラベルとして表示されます。会社内の同じテーブルで、2 つのフィールドが同じ名前を持つことはできません。
</details>

<details>
  <summary>**データ型**required`enum`</summary>

  ユーザーが使う入力欄を決めます。次のセクションの 9 種類から選びます。**保存後は固定されます**。変更するには、フィールドを削除して新しく追加する必要があります。
</details>

<details>
  <summary>**リストオプション**`text[]`</summary>

  タイプが**リスト**の場合にのみ表示されます。ドロップダウンの選択肢をここに 1 つずつ入力します。リストが空の場合や、空白の選択肢が含まれている場合、フォームは受け付けません。
</details>

<details>
  <summary>**必須**`boolean`</summary>

  値が入力されるまで、レコードを保存できないようにします。このフラグは**はい/いいえ**フィールドには効果がありません。
</details>

<details>
  <summary>**タグ**`text[]`</summary>

  同じタグが付いたレコードにフィールドを限定します。空欄のままにすると、そのテーブルのすべてのレコードにフィールドが適用されます。この設定を使えるのは、部品、材料、工具、消耗品、治具、サービス、製造指図だけです。
</details>

### データ型

| タイプ | ユーザーが入力するもの |
| - | - |
| **はい/いいえ**（Yes/No） | ブール値のスイッチ |
| **日付**（Date） | 日付 |
| **リスト**（List） | **リストオプション**からの 1 つの選択 |
| **数値**（Numeric） | 数値 |
| **テキスト**（Text） | 自由入力のテキスト |
| **ユーザー**（User） | Alforse ユーザーへの参照 |
| **得意先**（Customer） | 得意先への参照 |
| **仕入先**（Supplier） | 仕入先への参照 |
| **ファイル**（File） | 定義はされていますが、レコードフォームにはまだ入力欄がありません |

**ユーザー**、**得意先**、**仕入先**を選ぶと、入力欄はピッカーになります。保存される値は、入力されたテキストではなく、既存のレコードへの参照です。

NOTE

**データ型は慎重に選んでください**

最初の保存後は、タイプを編集する方法はありません。別のタイプが必要な場合は、正しいタイプで新しいフィールドを追加し、古いフィールドに保存されていた値を入力し直してください。

## カスタムフィールドに対応するレコード

カスタムフィールドは、すべてのレコードではなく、固定されたレコードタイプの一覧で利用できます。設定ページが正式な一覧です。そのページに行がないレコードタイプは、まだカスタムフィールドを持てません。

| モジュール | レコードタイプ |
| - | - |
| **販売** | 得意先、見積、受注、売上請求書、RFQ。それぞれの連絡先、ロケーション、明細を含みます |
| **購買** | 仕入先、発注書、仕入先見積、購買 RFQ。それぞれの明細と連絡先を含みます |
| **請求** | 仕入請求書、支払い、メモ |
| **アイテム** | 部品、工具、材料、消耗品、治具、サービス。それぞれの原価計算と計画のレコードも含みます（[アイテム](https://docs.alforse.com/ja/docs/reference/items.md)を参照） |
| **リソース** | 従業員の職務、作業区、部門、ロケーション、プロセス、シフト |
| **在庫** | 入荷、出荷、倉庫移動、ピッキングリスト、棚 |
| **生産** | 製造指図 |
| **品質** | 測定器、問題 |
| **会計** | 勘定科目、支払条件、仕訳 |

## 値の保存先

レコードのフォームでは、カスタム入力欄は標準の入力欄の後に表示されます。ユーザーが入力した内容は、そのレコードの `customFields` JSON 列に保存されます。

この列は API のレスポンスに含まれ、フィルターとして使用できます。ユーザーに表示されるラベルではなくフィールド ID をキーとしているため、解釈する前に、各キーを設定カタログの定義に対応付けてください。

HEADS UP

**CSV のインポートとエクスポートではカスタムフィールドは無視されます**

CSV が扱うのは標準フィールドだけです。インポートで `customFields` 列が入力されることはなく、テーブルのダウンロードにも含まれません。カスタムフィールドの値には、レコードフォームまたは API を使用してください。CSV が扱う内容は[インポートとエクスポート](https://docs.alforse.com/ja/docs/reference/import-export.md)で確認できます。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.