Power Apps から Office 365 Users への接続

Office 365 ユーザーを使用すると、Office 365 アカウントを使用して組織内のユーザー プロファイルにアクセスできます。 プロファイルの取得、ユーザーのプロファイル、ユーザーの上司、直属の部下の取得など、さまざまなアクションを実行できます。

この情報は、アプリのラベルに表示できます。 1 つの関数、複数の関数を表示したり、異なる関数を組み合わせたりすることもできます。 たとえば、ユーザー名と電話番号を組み合わせた式を作成し、アプリにこの情報を表示できます。

この記事では、Office 365 ユーザーを接続として追加し、Office 365 ユーザーをデータ ソースとしてアプリに追加し、ギャラリー コントロールでテーブル データを使用する方法について説明します。

[前提条件]

• Power Apps へのアクセス
• 接続を追加する
• テンプレート、データ、またはゼロからアプリを作成する

接続を追加する

1. データ接続を追加 し、[ Office 365 ユーザー] を選択します。

   

2. [ 接続] を選択し、サインインを求められたら職場アカウントを入力します。

Office 365 Users 接続が作成され、アプリに追加されました。 これで、使用する準備ができました。

アプリで接続を使用する

現在のユーザーに関する情報を表示する

1. [挿入] メニューの [ラベル] を選択します。

2. 関数バーで、 Text プロパティを次のいずれかの数式に設定します。

   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

ラベルには、現在のユーザーに関して入力した情報が表示されます。

別のユーザーに関する情報を表示する

1. [ 挿入 ] メニューの [ テキスト] を選択し、[ テキスト入力] を選択します。 InfoAbout の名前を変更します。

   

2. InfoAbout で、組織内のユーザーのメール アドレスを入力するか貼り付けます。 たとえば、「 yourName@yourCompany.com」と入力します。

3. [ラベル] ([挿入] メニュー) を追加し、その Text プロパティを次のいずれかの数式に設定します。

   • 別のユーザーに関する情報を表示するには:

     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

ラベルには、指定したユーザーまたはユーザーのマネージャーに関して入力した情報が表示されます。

たとえば、 アプリを自動的に作成し、 Label コントロールを含む画面を追加し、コントロールの Text プロパティを次の数式に設定できます。
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser)。DisplayName

連絡先を作成し、アプリの参照画面でその連絡先を選択すると、 ラベル コントロールに表示名が表示されます。

別のユーザーの直属の部下を表示する

1. テキスト入力コントロール ([挿入] メニュー >Text) を追加し、InfoAbout の名前を変更します。

2. InfoAbout に、組織内のユーザーのメール アドレスを入力します。 たとえば、yourManagersName@ を入力します yourCompany.com

3. With テキスト ギャラリー ([挿入] メニュー >Gallery) を追加し、その Items プロパティを次の式に設定します。

   Office365Users.DirectReports(InfoAbout.Text)

   ギャラリーには、入力したユーザーの直属の部下に関する情報が表示されます。

   ギャラリーを選択すると、右側のウィンドウにそのギャラリーのオプションが表示されます。

4. 2 番目の一覧 で [JobTitle] を選択します。 3 番目の一覧で [ DisplayName] を選択します。 ギャラリーが更新され、これらの値が表示されます。

ユーザーを検索する

1. テキスト入力コントロールを追加します ([挿入] メニュー>テキスト入力)。

2. [ 挿入>Vertical ギャラリーを選択します。

3. 垂直ギャラリーのレイアウトを タイトル、サブタイトル、本文に変更します。

4. ギャラリー内の最初の行から矢印アイコンを選択し、削除します。

5. 垂直ギャラリーの数式を次のように更新します。

   Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).value
   

   上の数式では、検索用語はテキスト入力コントロールに入力されたテキストを参照します (この例では "TextInput1")。検索結果は上位 5 件に制限されます。

6. ギャラリータイトルに DisplayName 、サブタイトルに JobTitle 、本文に Department を表示するように垂直ギャラリーフィールドを更新します。

   

7. アプリを再生し、テキスト入力ボックス内にテキストを入力します。 テキストを入力すると、入力文字列の変更に基づいて結果が変わります。

   

使用可能な関数を表示する

この接続には、次の関数が含まれます。

MyProfile

自分のプロファイルを取得する: 現在のユーザーのプロファイルを取得します。

入力プロパティ

なし。

出力プロパティ

UserProfile

ユーザー プロファイルの取得: 特定のユーザー プロファイルを取得します。

入力プロパティ

出力プロパティ

マネージャー

マネージャーの取得: 指定されたユーザーのマネージャーのユーザー プロファイルを取得します。

入力プロパティ

出力プロパティ

DirectReports

直属の部下を取得する: 直属の部下を取得します。

入力プロパティ

出力プロパティ

SearchUser

ユーザーの検索: ユーザー プロファイルの検索結果を取得します。

入力プロパティ

出力プロパティ

こちらも参照ください

• 使用可能なすべての接続を表示します。
• アプリに 接続を追加 する方法について説明します。