Power Apps から Office 365 ユーザー接続に接続する

Office 365 ユーザー。

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

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

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

前提条件

接続を追加する

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

    Office 365 に接続。

  2. 接続を選択し、サインインを求めるメッセージが表示されたら、職場アカウントを入力します。

Office 365 ユーザー接続が作成され、アプリに追加されました。 これにより、接続を使用できるようになりました。

アプリで接続を使用する

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

  1. 挿入メニューで、ラベルを選択します

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

    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. ラベル (挿入メニュー) を追加し、テキスト プロパティに次のいずれかの式を設定します:

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

      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

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

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

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

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

  3. テキスト付き ギャラリー (挿入メニュー > ギャラリー) を追加し、項目 プロパティに次の式を設定します:

    Office365Users.DirectReports(InfoAbout.Text)

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

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

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

注意

1 番目のボックスは、実際にはイメージ コントロールです。 画像がない場合、画像コントロールを削除し、その場所にラベルを追加できます。 コントロールの追加および構成 は優れたリソースです。

ユーザーを検索する

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

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

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

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

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

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

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

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

    選択したギャラリー フィールド。

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

    検索の例。

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

この接続には、次の関数が含まれています:

関数名 内容
DirectReports 指定したユーザーの直属の部下を返します。
管理者 指定したユーザーの上司のユーザー プロファイルを取得します。
MyProfile 現在のユーザーのプロファイルを取得します。
SearchUser ユーザー プロファイルの検索結果を取得します。
UserProfile 特定のユーザー プロファイルを取得します。

MyProfile

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

入力プロパティ

ありません。

出力プロパティ

プロパティ名 種類​​ 内容
市区町村 string ユーザーの市区町村。
CompanyName string ユーザーの会社。
string ユーザーの国/地域。
string ユーザーの部署。
DisplayName string ユーザーの表示名。
GivenName string ユーザーの名前。
ID string ユーザー ID。
JobTitle string ユーザーの役職。
Mail 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 ユーザーの役職。
Mail 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 ユーザーの役職。
Mail 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 ユーザーの役職。
Mail 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 ユーザーの役職。
Mail string ユーザーの電子メール ID。
MailNickname string ユーザーのニックネーム。
mobilePhone string ユーザーの携帯電話。
OfficeLocation string ユーザーの勤務先所在地。
PostalCode string ユーザーの郵便番号。
string ユーザーの姓。
TelephoneNumber string ユーザーの電話番号。
UserPrincipalName string ユーザー プリンシパル名。
AccountEnabled boolean アカウントの有効化されたフラグ。
BusinessPhones 文字列 ユーザーの会社の電話番号。

関連項目

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。