> ## 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.

# ユーザー

> DingTalk連絡先と連携するYiDAのユーザーコンポーネントの使い方を解説。複数選択モード、デフォルトユーザー、社員番号の表示、詳細検索、数式との組み合わせ、注意事項、FAQまで、フォーム作成に役立つ情報を紹介します。

## 1. ユースケース

ユーザーコンポーネントはDingTalk連絡先からユーザーを取得する機能で、出張申請者、資産管理者、メンテナンス担当者の指定など、人を選択する場面で利用します。[**数式**](/ja/yida/form/vwncwe)と組み合わせれば、作業フローフォーム上で承認者を指定する用途にも活用でき、たとえば申請者が承認者を手動で選択するケースなどに利用できます。

<Note>
  コンポーネントの属性、使い方、例については[**こちら**](/ja/open/yida/components/interface)をご覧ください。
</Note>

## 2. 基本機能

### 2.1 複数選択モード

複数のユーザーを選択できます。1人のみに限定する場合は、このトグルをオフにしてください。

複数選択モード

### 2.2 デフォルトユーザー

特定のユーザーをデフォルト値として設定すると、送信ページに自動的に表示されます。

デフォルト値の設定

ユーザーのステータスが標準の場合、デフォルトユーザーをクリアして別のユーザーを検索・選択できます。

ユーザーのステータスが閲覧のみに設定されている場合、コンポーネントではユーザーを選択できず、表示専用となります。

### 2.3 社員番号の表示

各ユーザー名の後に社員番号を表示するかどうかを選択できます。ここに表示される社員番号は、デフォルトで社員のUserIDです。

社員番号の表示

### 2.4 詳細検索モード（新しいユーザーコンポーネント）

DingTalkデスクトップクライアントまたはWebブラウザーでYiDAのユーザーコンポーネントを使用する場合、新しい詳細検索機能により、連絡先のツリー構造に基づいてユーザーを選択し、組織階層を掘り下げて検索できます。

詳細ユーザー選択エントリは、デスクトップクライアントでデフォルトで有効になっています。クリックすると、フルユーザー選択ページを提供するダイアログが開きます。

#### 2.4.1 ユースケース

* 組織連絡先のツリー階層を掘り下げて、対象ユーザーを検索・選択します。

## 3. 数式との組み合わせ

申請者の名前、社員番号、部門を自動的に取得するなど、さまざまな使い方があります。詳細は[**高度な使い方**](/ja/yida/form/vwncwe)のドキュメントをご覧ください。

### 3.1 現在ログイン中のユーザー名を取得

[**GETUSERNAME**](/ja/yida/form/vwncwe)数式をご覧ください。

### 3.2 現在ログイン中のユーザーまたはその上司を取得

[**USER**](/ja/yida/form/vwncwe)数式をご覧ください。

## 4. 注意事項

1. ユーザーコンポーネントは企業全体からユーザーを選択できますが、デフォルトでは現在の部門のユーザーのみが表示されます。他部門のユーザーを選択するには、検索機能をご利用ください。
2. コンテナーの制限により、DingTalkモバイルクライアントでこのコンポーネントをiframe内で使用すると、コンテナーがiframeにJSAPIを注入しないため、ユーザーを選択できません。このような場面での利用は避けてください。

## 5. FAQ

<AccordionGroup>
  <Accordion id="q1" title="5.1 一括インポート時にユーザーコンポーネントに名前を入力すると、空の項目が表示されるのはなぜですか？">
    形式が正しくないことが原因です。一括インポートに必要な形式に従ってください。詳細は[**一括インポート**](/ja/yida/form/andrke)をご覧ください。
  </Accordion>

  <Accordion id="q2" title="5.2 部門コンポーネントで特定の部門を選択し、ユーザーコンポーネントではその部門のユーザーのみを選択できるように制限したいです。どうすればよいですか？">
    ユーザーコンポーネントには、選択範囲を直接制限する設定オプションが現時点でありません。回避策として、部門とそのユーザーを含む中間テーブルを作成し、データ連動を通じて取得してください。
  </Accordion>

  <Accordion id="q3" title="5.3 ユーザーコンポーネントへの一括インポートが失敗し、インポート後にデータが表示されません。どうすればよいですか？">
    ユーザーコンポーネントへ一括インポートする際は、「名前 + \[社員UserID]」の形式に従ってください。括弧は必ず半角の角括弧 \[] を使用してください。以下のスクリーンショットをご覧ください：
  </Accordion>
</AccordionGroup>