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と異なる場合は、データハンドラ関数を変更する必要があります。
関数の戻り値は、以下のようにオブジェクトの配列形式に従う必要があります。
3. プレミアム
3.1 操作設定
以下のように、このコンポーネントの操作にJSコードを設定する必要がある場合。 操作設定 - 値の変更4. FAQ
4.1 現在ログイン中のユーザーの部門を取得する方法
数式を使用する必要があります。推奨される方法は、一行テキストとメンバーコンポーネントを使用し、デフォルトを数式編集に切り替えることです。メンバーコンポーネントの数式をUSER()に設定し、一行テキストの数式をDEPTNAME(メンバーコンポーネント)に設定します。