Power Apps から Office 365 ユーザー接続に接続する
Office 365 ユーザーを使用すると、自分の Office 365 アカウントを使用して組織内のユーザー プロファイルにアクセスできます。 プロファイル、ユーザーのプロファイル、ユーザーの上司または直属の部下を取得するなど、さまざまなアクションを実行できます。
この情報を、アプリのラベルに表示できます。 1 つの機能、複数の機能、または異なる機能の組みわせを表示できます。 たとえば、ユーザー名と電話番号を組み合わせる式を作成してから、この情報をアプリに表示できます。
この記事では、Office 365 ユーザーを接続として追加する方法、アプリに Office 365 ユーザーをデータ ソースとして追加する方法、およびギャラリー コントロールでテーブルのデータを使う方法について説明します。
前提条件
- Power Apps へのアクセス
- 接続を追加する
- テンプレートから、データから、または新規にアプリを作成する
接続を追加する
データ接続を追加 して、Office 365 ユーザーを選択します:
接続を選択し、サインインを求めるメッセージが表示されたら、職場アカウントを入力します。
Office 365 ユーザー接続が作成され、アプリに追加されました。 これにより、接続を使用できるようになりました。
アプリで接続を使用する
現在のユーザーに関する情報を表示する
挿入メニューで、ラベルを選択します
関数バーで、テキスト プロパティに次のいずれかの式を設定します:
Office365Users.MyProfile().City
Office365Users.MyProfile().CompanyName
Office365Users.MyProfile().Country
Office365Users.MyProfile().Department
Office365Users.MyProfile().DisplayName
Office365Users.MyProfile().GivenName
Office365Users.MyProfile().Id
Office365Users.MyProfile().JobTitle
Office365Users.MyProfile().Mail
Office365Users.MyProfile().MailNickname
Office365Users.MyProfile().mobilePhone
Office365Users.MyProfile().OfficeLocation
Office365Users.MyProfile().PostalCode
Office365Users.MyProfile().Surname
Office365Users.MyProfile().TelephoneNumber
Office365Users.MyProfile().UserPrincipalName
Office365Users.MyProfile().AccountEnabled
ラベルには、現在のユーザーに関する入力した情報が表示されます。
別のユーザーに関する情報を表示する
挿入メニューで、テキストを選択してから、テキスト入力を選択します。 名前を InfoAbout に変更します:
InfoAbout に、組織内のユーザーの電子メール アドレスを入力するか貼り付けます。 たとえば、yourName@yourCompany.com を入力します。
ラベル (挿入メニュー) を追加し、テキスト プロパティに次のいずれかの式を設定します:
別のユーザーに関する情報を表示する場合:
Office365Users.UserProfile(InfoAbout.Text).City
Office365Users.UserProfile(InfoAbout.Text).CompanyName
Office365Users.UserProfile(InfoAbout.Text).Country
Office365Users.UserProfile(InfoAbout.Text).Department
Office365Users.UserProfile(InfoAbout.Text).DisplayName
Office365Users.UserProfile(InfoAbout.Text).GivenName
Office365Users.UserProfile(InfoAbout.Text).Id
Office365Users.UserProfile(InfoAbout.Text).JobTitle
Office365Users.UserProfile(InfoAbout.Text).Mail
Office365Users.UserProfile(InfoAbout.Text).MailNickname
Office365Users.UserProfile(InfoAbout.Text).mobilePhone
Office365Users.UserProfile(InfoAbout.Text).OfficeLocation
Office365Users.UserProfile(InfoAbout.Text).PostalCode
Office365Users.UserProfile(InfoAbout.Text).Surname
Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
Office365Users.UserProfile(InfoAbout.Text).AccountEnabled
Office365Users.UserProfile(InfoAbout.Text).BusinessPhones別のユーザーの上司に関する情報を表示する場合:
Office365Users.Manager(InfoAbout.Text).City
Office365Users.Manager(InfoAbout.Text).CompanyName
Office365Users.Manager(InfoAbout.Text).Country
Office365Users.Manager(InfoAbout.Text).Department
Office365Users.Manager(InfoAbout.Text).DisplayName
Office365Users.Manager(InfoAbout.Text).GivenName
Office365Users.Manager(InfoAbout.Text).Id
Office365Users.Manager(InfoAbout.Text).JobTitle
Office365Users.Manager(InfoAbout.Text).Mail
Office365Users.Manager(InfoAbout.Text).MailNickname
Office365Users.Manager(InfoAbout.Text).mobilePhone
Office365Users.Manager(InfoAbout.Text).OfficeLocation
Office365Users.Manager(InfoAbout.Text).PostalCode
Office365Users.Manager(InfoAbout.Text).Surname
Office365Users.Manager(InfoAbout.Text).TelephoneNumber
Office365Users.Manager(InfoAbout.Text).UserPrincipalName
Office365Users.Manager(InfoAbout.Text).AccountEnabled
Office365Users.Manager(InfoAbout.Text).BusinessPhones
ラベルに、指定したユーザーまたはそのユーザーの上司に関する入力した情報が表示されます。
注意
Microsoft Dataverse のテーブルに基づくアプリを開発する場合は、メール アドレスではなく ID でユーザーを指定できます。
たとえば、アプリを自動で作成 し、ラベル コントロールが含まれる画面を追加し、コントロールのテキスト プロパティを次の式に設定できます:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName
連絡先を作成して、アプリの閲覧画面でその連絡先を選択すると、ラベル コントロールに表示名が表示されます。
別のユーザーの直属の部下を表示する
テキスト入力 コントロール (挿入メニュー > テキスト) を追加し、名前を InfoAbout に変更します。
InfoAbout に、組織内のユーザーの電子メール アドレスを入力します。 たとえば、yourManagersName@yourCompany.com を入力します
テキスト付き ギャラリー (挿入メニュー > ギャラリー) を追加し、項目 プロパティに次の式を設定します:
Office365Users.DirectReports(InfoAbout.Text)ギャラリーに、入力したユーザーの直属の部下に関する情報が表示されます。
ギャラリーを選択すると、右側のウィンドウにそのギャラリーのオプションが表示されます。
2 番目のリストで、JobTitle を選択します。 3 番目のリストで、DisplayName を選択します。 ギャラリーが更新され、これらの値が表示されます。
注意
1 番目のボックスは、実際にはイメージ コントロールです。 画像がない場合、画像コントロールを削除し、その場所にラベルを追加できます。 コントロールの追加および構成 は優れたリソースです。
ユーザーを検索する
テキスト入力 コントロール (挿入メニュー > テキスト入力) を追加します。
挿入 > 垂直ギャラリー を選択します。
垂直ギャラリーのレイアウトをタイトル、サブタイトル、ボディに変更します。
ギャラリー内の最初の行から矢印アイコンを選択し、削除します。
垂直ギャラリー式を次のように更新します。
Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).value上記の式では、検索語はテキスト入力コントロール (この例では "TextInput1") に入力されたテキストを参照し、検索結果は上位 5 つまでに制限されます。
ギャラリー タイトルに DisplayName、サブ タイトルに JobTitle、本文に Department を表示するよう、垂直ギャラリーフィールドを更新します。
アプリを再生し、テキスト入力ボックス内にテキストを入力します。 テキストを入力すると、入力文字列の変化に基づいて結果が変化します。
使用可能な関数を表示する
この接続には、次の関数が含まれています:
| 関数名 | 内容 |
|---|---|
| DirectReports | 指定したユーザーの直属の部下を返します。 |
| 管理者 | 指定したユーザーの上司のユーザー プロファイルを取得します。 |
| MyProfile | 現在のユーザーのプロファイルを取得します。 |
| SearchUser | ユーザー プロファイルの検索結果を取得します。 |
| UserProfile | 特定のユーザー プロファイルを取得します。 |
MyProfile
プロファイルの取得: 現在のユーザーのプロファイルを取得します。
入力プロパティ
ありません。
出力プロパティ
| プロパティ名 | 種類 | 内容 |
|---|---|---|
| 市区町村 | string | ユーザーの市区町村。 |
| CompanyName | string | ユーザーの会社。 |
| 国 | string | ユーザーの国/地域。 |
| 課 | string | ユーザーの部署。 |
| DisplayName | string | ユーザーの表示名。 |
| GivenName | string | ユーザーの名前。 |
| ID | string | ユーザー ID。 |
| JobTitle | string | ユーザーの役職。 |
| string | ユーザーの電子メール ID。 | |
| MailNickname | string | ユーザーのニックネーム。 |
| mobilePhone | string | ユーザーの携帯電話。 |
| OfficeLocation | string | ユーザーの勤務先所在地。 |
| PostalCode | string | ユーザーの郵便番号。 |
| 姓 | string | ユーザーの姓。 |
| TelephoneNumber | string | ユーザーの電話番号。 |
| UserPrincipalName | string | ユーザー プリンシパル名。 |
| AccountEnabled | boolean | アカウントの有効化されたフラグ。 |
| BusinessPhones | string | ユーザーの会社の電話番号。 |
UserProfile
ユーザー プロファイルの取得: 特定のユーザー プロファイルを取得します。
入力プロパティ
| 件名 | データの種類 | 必要な領域 | 内容 |
|---|---|---|---|
| ID | string | はい | ユーザー プリンシパル名または電子メール ID。 |
出力プロパティ
| プロパティ名 | 種類 | 内容 |
|---|---|---|
| 市区町村 | string | ユーザーの市区町村。 |
| CompanyName | string | ユーザーの会社。 |
| 国 | string | ユーザーの国/地域。 |
| 課 | string | ユーザーの部署。 |
| DisplayName | string | ユーザーの表示名。 |
| GivenName | string | ユーザーの名前。 |
| ID | string | ユーザー ID。 |
| JobTitle | string | ユーザーの役職。 |
| string | ユーザーの電子メール ID。 | |
| MailNickname | string | ユーザーのニックネーム。 |
| 姓 | string | ユーザーの姓。 |
| TelephoneNumber | string | ユーザーの電話番号。 |
| UserPrincipalName | string | ユーザー プリンシパル名。 |
| AccountEnabled | boolean | アカウントの有効化されたフラグ。 |
| BusinessPhones | string | ユーザーの会社の電話番号。 |
マネージャー
上司の取得: 指定したユーザーの上司のユーザー プロファイルを取得します。
入力プロパティ
| 件名 | データの種類 | 必要な領域 | 内容 |
|---|---|---|---|
| ID | string | はい | ユーザー プリンシパル名または電子メール ID。 |
出力プロパティ
| プロパティ名 | 種類 | 内容 |
|---|---|---|
| 市区町村 | string | ユーザーの市区町村。 |
| CompanyName | string | ユーザーの会社。 |
| 国 | string | ユーザーの国/地域。 |
| 課 | string | ユーザーの部署。 |
| DisplayName | string | ユーザーの表示名。 |
| GivenName | string | ユーザーの名前。 |
| ID | string | ユーザー ID。 |
| JobTitle | string | ユーザーの役職。 |
| string | ユーザーの電子メール ID。 | |
| MailNickname | string | ユーザーのニックネーム。 |
| mobilePhone | string | ユーザーの携帯電話。 |
| OfficeLocation | string | ユーザーの勤務先所在地。 |
| PostalCode | string | ユーザーの郵便番号。 |
| 姓 | string | ユーザーの姓。 |
| TelephoneNumber | string | ユーザーの電話番号。 |
| UserPrincipalName | string | ユーザー プリンシパル名。 |
| AccountEnabled | boolean | アカウントの有効化されたフラグ。 |
| BusinessPhones | string | ユーザーの会社の電話番号。 |
DirectReports
直属の部下の取得: 直属の部下を取得します。
入力プロパティ
| 件名 | データの種類 | 必要な領域 | 内容 |
|---|---|---|---|
| ID | string | はい | ユーザー プリンシパル名または電子メール ID。 |
出力プロパティ
| プロパティ名 | 種類 | 内容 |
|---|---|---|
| 市区町村 | string | ユーザーの市区町村。 |
| CompanyName | string | ユーザーの会社。 |
| 国 | string | ユーザーの国/地域。 |
| 課 | string | ユーザーの部署。 |
| DisplayName | string | ユーザーの表示名。 |
| GivenName | string | ユーザーの名前。 |
| ID | string | ユーザー ID。 |
| JobTitle | string | ユーザーの役職。 |
| string | ユーザーの電子メール ID。 | |
| MailNickname | string | ユーザーのニックネーム。 |
| mobilePhone | string | ユーザーの携帯電話。 |
| OfficeLocation | string | ユーザーの勤務先所在地。 |
| PostalCode | string | ユーザーの郵便番号。 |
| 姓 | string | ユーザーの姓。 |
| TelephoneNumber | string | ユーザーの電話番号。 |
| UserPrincipalName | string | ユーザー プリンシパル名。 |
| AccountEnabled | boolean | アカウントの有効化されたフラグ。 |
| BusinessPhones | string | ユーザーの会社の電話番号。 |
SearchUser
ユーザーの検索: ユーザー プロファイルの検索結果を取得します。
入力プロパティ
| 件名 | データの種類 | 必要な領域 | 内容 |
|---|---|---|---|
| searchTerm | string | 無効 | 検索文字列。 適用対象: 表示名、名、姓、電子メール、メールのニックネーム、およびユーザー プリンシパル名。 |
出力プロパティ
| プロパティ名 | 種類 | 内容 |
|---|---|---|
| 市区町村 | string | ユーザーの市区町村。 |
| CompanyName | string | ユーザーの会社。 |
| 国 | string | ユーザーの国/地域。 |
| 課 | string | ユーザーの部署。 |
| DisplayName | string | ユーザーの表示名。 |
| GivenName | string | ユーザーの名前。 |
| ID | string | ユーザー ID。 |
| JobTitle | string | ユーザーの役職。 |
| string | ユーザーの電子メール ID。 | |
| MailNickname | string | ユーザーのニックネーム。 |
| mobilePhone | string | ユーザーの携帯電話。 |
| OfficeLocation | string | ユーザーの勤務先所在地。 |
| PostalCode | string | ユーザーの郵便番号。 |
| 姓 | string | ユーザーの姓。 |
| TelephoneNumber | string | ユーザーの電話番号。 |
| UserPrincipalName | string | ユーザー プリンシパル名。 |
| AccountEnabled | boolean | アカウントの有効化されたフラグ。 |
| BusinessPhones | 文字列 | ユーザーの会社の電話番号。 |
関連項目
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示