Power Appsには、テナントに所属している人の情報を取得出来るOffice365ユーザーコネクタというコネクタがあります。
この記事では、
- Office365ユーザーコネクタで利用できるアクションと構文
- Office365ユーザーコネクタのアクションでよく利用するもの、あまり利用しないもの
を紹介します。
Office365ユーザーコネクタの追加方法
左側のデータタブから、データの追加を選択します。
Office365ユーザーコネクタが追加されます。
UserProfileV2 | ユーザーのプロフィールを取得する
ユーザーの情報を取得出来ます。よく使います。
構文
Office365ユーザー.UserProfileV2(id,{'$select':field1,field2,...})| id | ユーザーidまたはメールアドレス |
| field | 後述する項目をカンマ区切りで入力すれば、入力した項目のみが返されます。 |
fieldは省略可能です。
取得できる項目(よく使用する項目のみ)
| department | 所属部署 |
| displayName | Teamsなどでの表示名 |
| id | ユーザーのid |
| メールアドレス |
Office365ユーザー.UserProfileV2(メールアドレス).departmentとラベルに入力することで、入力したメールアドレスのユーザーの所属部署を表示出来ます。
MyProfileV2 | ログインしているユーザーのプロフィールを取得する
ログインしているユーザーのプロフィールを取得します。よく使います。
構文
Office365ユーザー.UserProfileV2(id,{'$select':field1,field2,...})| field | 取得できる項目をカンマ区切りで入力すれば、入力した項目のみが返されます。 |
fieldは省略可能です。
SearchUserV2 | ユーザーを検索する
ユーザーを検索できます。よく使います。
構文
Office365ユーザー.SearchUserV2({searchTerm:Text, isSearchTermRequired:Boolean, skipToken:number})レコード型の引数を渡します。
| searchTerm | 検索するテキスト |
| isSearchTermRequired | falseにした場合はsearchTermが空白の場合に全ての結果を返します。 |
| skipToken | 何件取得するか |
取得できる項目(よく使用する項目のみ)
| Department | 所属部署 |
| DisplayName | Teamsなどでの表示名 |
| Id | ユーザーのid |
| メールアドレス |
UserProfileV2と同様の出力が得られますが、列名の先頭が大文字です。
使用する時の注意
取得される項目はvalue内に格納されていますので、
Office365ユーザー.SearchUserV2(~).valueとすることで検索したユーザーの情報(テーブル型)が得られます。
詳しい使い方
UserPhotoV2 | ユーザーのプロフィール画像を取得する
ユーザーのメールアドレス（正確にはプリンシパル名・ID）からユーザーのプロフィール画像を更新することができます。まあまあ使います。
構文
Office365ユーザー.UserPhotoV2(id)レコード型の引数を渡します。
| id | ユーザー プリンシバル名または ID。 |
詳しい使い方
ほとんど使わない有象無象アクション
システム管理者が設定していない・アプリでの利用頻度が低いことからほとんど使用しないアクションを羅列します。
UpdateMyPhoto | ユーザーのプロフィール画像を更新する
ユーザーのプロフィール画像を更新することができます。
UserPhotoMetadata
プロフィール画像のメタデータを取得できます。
HasPhotoプロパティは使用するかもしれません。
DirectReportsV2
自分の部下を取得できます。
ManagerV2
自分の上司を取得できます。
MyTrendingDocuments
自分が最近操作したファイルを取得できます。Delveなどで表示されるやつです。
TrendingDocuments
入力で指定したユーザーが最近操作したファイルを取得できます。Delveなどで表示されるやつです。
RelevantPeople
入力で指定したユーザーに関連するユーザーを取得できます。Delveなどで表示されるやつです。
コメント