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

# USERFIELD

> YiDAのUSERFIELD関数の使い方を解説。フォームやワークフロー設計で指定したメンバーコンポーネントから、選択された社員のユーザー名・userId・社員番号を取得する構文、属性、活用例を詳しく紹介します。

**USERFIELD** 関数は、指定したメンバーコンポーネントで選択された社員の情報を取得します。

## 対応する製品シナリオ

USERFIELD 関数は、以下の YiDA シナリオで利用できます。

* フォーム（メインフォームフィールド）
* フォーム（業務関連ルール）
* フォーム（バリデーション）
* ワークフロー設計（バリデーションルール）
* ワークフロー設計（関連アクション）

## 構文

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
USERFIELD(member component, field)
```

## 属性の説明

| **属性**           | **必須** | **説明**                                                                                                                                                              |
| ---------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| member component | はい     | 情報を取得するメンバーコンポーネントフィールド。<br />メンバーコンポーネントの複数選択モードには対応していません。複数選択を使用した場合、最初に選択されたユーザーの情報のみ取得されます。                                                                    |
| field            | はい     | 取得するユーザー情報のタイプ。有効な値は以下のとおりです。<br />• **name**：ユーザー名。<br />• **userId**：社員の userId。現在の組織内で社員を一意に識別するIDで、システムによって自動生成されます。<br />• **businessWorkNo**：社員番号。管理者が指定できます。 |

## 戻り値

| **戻り値のタイプ** | **説明**      |
| ----------- | ----------- |
| テキスト        | 返されるユーザー情報。 |

## 例

以下の図に示すように、`USERFIELD()` 関数を使用して、現在サインインしているユーザーのユーザー名、社員番号、および userId を取得します。