Power Appsには、テナントに所属している人の情報を取得出来るOffice365ユーザーコネクタというコネクタがあります。
この記事では、
- Office365ユーザーコネクタのSearchUserV2の構文、取得できるデータ
- コンボボックスでのユーザーの検索・選択する方法
- ギャラリーでの検索結果の一覧表示
を紹介します。
Office365ユーザーコネクタの追加方法
左側のデータタブから、データの追加を選択します。
![](https://powerplatformnikki.com/wp-content/uploads/2021/05/image-23.png)
Office365ユーザーコネクタが追加されます。
![](https://powerplatformnikki.com/wp-content/uploads/2021/05/image-24.png)
SearchUserV2 | ユーザーを検索する
ユーザーを検索できます。
構文
Office365ユーザー.SearchUserV2({searchTerm:Text, isSearchTermRequired:Boolean, skipToken:number})
レコード型の引数を渡します。
searchTerm | 検索するテキスト |
isSearchTermRequired | falseにした場合はsearchTermが空白の場合に全ての結果を返します。 |
skipToken | 何件取得するか |
取得できる項目(よく使用する項目のみ)
Department | 所属部署 |
DisplayName | Teamsなどでの表示名 |
Id | ユーザーのid |
メールアドレス |
UserProfileV2と同様の出力が得られますが、列名の先頭が大文字です。
使用する時の注意
![](https://powerplatformnikki.com/wp-content/uploads/2021/05/image-25.png)
取得される項目はvalue内に格納されていますので、
Office365ユーザー.SearchUserV2(~).value
とすることで検索したユーザーの情報(テーブル型)が得られます。
コンボボックスで検索する方法
簡単コピペ
コピペの方法は以下の記事をご確認ください。
![](https://powerplatformnikki.com/wp-content/uploads/2024/07/image-82.png)
![](https://powerplatformnikki.com/wp-content/uploads/2024/07/image-83.png)
作り方
コンボボックスを画面に追加し、以下の数式を入力します。
Office365ユーザー.SearchUserV2({searchTerm:Self.SearchText}).value
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/4e99c8b3e8bfe04acc34f3d17d0e39e8.png)
プロパティ→フィールド→編集より、以下の通り設定します。
レイアウト | 二重線 |
主要なテキスト | DisplayName |
副次的なテキスト | Department |
SearchField |
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/b31b4e6cccc6e114fdf09ab98f17ba06.png)
InputTextPlaceholderを"ユーザーの検索"に、
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/7e3e7640a627130c2c7eb8af81bd5a0c.png)
複数選択の許可、検索の許可がオンになっていることを確認します。
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/328c56d5aca54986c83e0c8b655d66f6.png)
これでコンボボックスの検索欄に入力したテキストでユーザー検索・選択ができるようになりました。
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/d20d8eb03aa02b209ab85a7a2ba96a41.png)
検索対象列の変え方・増やし方
検索対象の列を変更するには、プロパティ→フィールド→編集より検索対象にしたい列を選択します。
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/3287ed5f2a0898848857ef8dc167ba55.png)
UI上では単一選択しかできませんが、SearchFieldsプロパティに列を,区切りで入力することで複数列での検索が可能になります。
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/1c6d98b4a0a5218d105887da5004e914.png)
ギャラリーで検索結果を一覧表示する方法
テキスト入力とギャラリーコントロールを配置し、ギャラリーコントロールのItemsプロパティを以下の通り設定します。
Office365ユーザー.SearchUserV2({searchTerm:TextInput1.Text,isSearchTermRequired:false}).value
テキスト入力に入力したテキストでユーザーを検索することができました。
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/89489252e47b92fffee4a4535f3c7d2e.png)
isSearchTermRequiredをfalseにすると、searchTermが空白の場合には全ての結果を返すようになります。
![](https://powerplatformnikki.com/wp-content/uploads/2023/10/cbf40e51e6db070798a3e39059cafe63.png)
コメント