> ## 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の部門コンポーネントの機能と活用シーンを解説します。複数選択・すべて選択・クリアボタン・完全な部門パス表示などの設定方法や、プレミアムクエリ機能の利用手順を紹介します。

## 1. 部門コンポーネント

### 1.1 部門コンポーネントとは

ユーザーが所属する部門を選択できるコンポーネントです。

部門コンポーネントを追加

### 1.2 活用シーン

ユーザーが所属する部門を取得します。デフォルトでは、現在ログイン中のユーザーの部門を表示します。

### 1.3 プレミアムクエリ機能

* DingTalkのデスクトップクライアントまたはWebブラウザでYiDAの部門コンポーネントを使用する場合、新しいプレミアムクエリ機能を利用できます。連絡先のツリー構造に基づく選択や、組織のドリルダウン機能に対応しています。
* プレミアムユーザーピッカーのエントリは、デスクトップクライアントでデフォルトでオンになっています。クリックするとモーダルが開き、完全な部門選択ページが表示されます。

#### 1.3.1 活用シーン

* 社内連絡先の階層構造に基づき、ツリー構造をドリルダウンして対象の部門を検索・選択します。

## 2. 属性

### 2.1 複数選択

複数選択モードはデフォルトでオフです。オンにすると、以下のように複数の部門を選択できます。

複数選択モード

### 2.2 すべて選択

すべて選択モードをオンにすると、送信ページに「すべて選択」トグルが追加され、以下のように現在のドロップダウンリスト内のすべての部門を選択できます。

すべて選択をオンにする

### 2.3 クリアボタン

以下のように、`x`をクリックすると、入力したコンテンツをワンクリックでクリアできます。

ワンクリッククリアボタンを許可

### 2.4 完全な部門パスを表示

「完全な部門パスを表示」をオンにすると、部門コンポーネントの値に、親から子へ、左から右へと完全な部門パスが表示されます。例えば、「製品部門」が「製品部門1」の親である場合、「製品部門1」を選択すると「製品部門 - 製品部門1」と表示されます。

**備考：最上位の部門はデフォルトで表示されます。**

完全な部門パスを表示

### 2.5 データソースを検索

社内に独自の組織構成データソースがある場合、こちらのリクエストURLをデータソースのHTTP URLに置き換えることができます。以下をご覧ください。

また、HTTP URLの要件に合わせたリクエストハンドラ関数を記述することもできます。

関数の入力パラメータ`data`はユーザーの検索入力値であり、その戻り値がリクエストのクエリパラメータとして使用されます。以下をご覧ください。

リクエストハンドラ関数

HTTP URLが返すデータ構造がYiDAの部門クエリHTTP URLと異なる場合は、データハンドラ関数を変更する必要があります。

関数の戻り値は、以下のようにオブジェクトの配列形式に従う必要があります。

```javascript theme={"theme":{"light":"github-light","dark":"github-dark"}}
[{
    "text": {
      en_US: "Document",
      pureEn_US: "Document",
      type: "i18n",
      zh_CN: "文档"
    },
    "value": "622760468"
  }]
```

データハンドラ関数

## 3. プレミアム

### 3.1 操作設定

以下のように、このコンポーネントの操作にJSコードを設定する必要がある場合。

操作設定 - 値の変更

## 4. FAQ

### 4.1 現在ログイン中のユーザーの部門を取得する方法

数式を使用する必要があります。推奨される方法は、一行テキストとメンバーコンポーネントを使用し、デフォルトを数式編集に切り替えることです。メンバーコンポーネントの数式を`USER()`に設定し、一行テキストの数式を`DEPTNAME(メンバーコンポーネント)`に設定します。

### 4.2 部門コンポーネント内で社内の他の部門を検索できない

デフォルトでは、部門コンポーネントは現在ログイン中のユーザーが所属する部門のみを表示します。

以下のように、他の部門情報を入力するには、部門名を入力して検索してください。

### 4.3 部門コンポーネントを介して現在の部門のマネージャーを取得する方法

現時点では直接の取得はサポートされていません。ただし、YiDAで部門とマネージャーの関連テーブルを設定し、部門が選択された後にワークフローフォームが対応する部門のマネージャー情報を自動的に関連付けるようにし、そのマネージャー情報変数を承認ノードにバインドすることができます。