PowerApps から Office 365 ユーザーの接続に接続するConnect to Office 365 Users connection from PowerApps

Office 365 Users

Office 365 Users を使用すると、自分の Office 365 アカウントを使用して組織内のユーザー プロファイルにアクセスできます。Office 365 Users lets you access user profiles in your organization using your Office 365 account. 自分のプロファイル、別のユーザーのプロファイル、ユーザーの上司または直属の部下を確認するなど、さまざまな操作を行うことができます。You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

こうした情報を、アプリのラベルに表示できます。You can display this information in a label on your app. 1 つまたは複数の機能を表示したり、異なる機能を組みわせたりすることも可能です。You can display one function, multiple functions, or even combine different functions. たとえば、ユーザー名と電話番号を組み合わせる式を作成し、組み合わせた情報をアプリに表示できます。For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

このトピックでは、Office 365 Users を接続として追加する方法、アプリに Office 365 Users をデータ ソースとして追加する方法、およびギャラリー コントロールでテーブル データを使用する方法について説明します。This topic shows you how to add Office 365 Users as a connection, add Office 365 Users as a data source to your app, and use table data in a gallery control.

 

What you need to get started

接続を追加するAdd a connection

  1. データ接続を追加して、[Office 365 Users] を選択します。Add a data connection and select Office 365 Users:

    Office 365 への接続

  2. [接続] を選択します。サインインが求められた場合は、職場アカウントを入力します。Select Connect, and if prompted to sign in, enter your work account.

Office 365 Users 接続が作成され、アプリに追加されます。The Office 365 Users connection has been created and added to your app. これで、この接続を使用できるようになりました。Now, it's ready to be used.

アプリでこの接続を使用するUse the connection in your app

現在のユーザーに関する情報を表示するShow information about the current user

  1. [挿入] メニューで [ラベル] を選択します。On the Insert menu, select Label
  2. 関数バーで、Text プロパティに次のいずれかの式を設定します。In the function bar, set its Text property to any of the following formulas:

    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    Office365Users.MyProfile().Surname
    Office365Users.MyProfile().TelephoneNumber
    Office365Users.MyProfile().UserPrincipalName
    Office365Users.MyProfile().AccountEnabled

ラベルに、現在のユーザーに関する入力した情報が表示されます。The label shows the information that you entered about the current user.

別のユーザーに関する情報を表示するShow information about another user

  1. [挿入] メニューで、[テキスト][Text input] (テキスト入力) の順に選択します。On the Insert menu, select Text, and then select Text input. 名前を InfoAbout に変更します。Rename it InfoAbout:

    コントロール名の変更

  2. InfoAbout に、組織内のユーザーの電子メール アドレスを入力するか貼り付けます。In InfoAbout, type or paste an email address of a user in your organization. たとえば、「ユーザー名@yourCompany.com」と入力します。For example, type in yourName@yourCompany.com.
  3. [挿入] メニューで [ラベル] を追加し、Text プロパティに次のいずれかの式を設定します。Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • 別のユーザーに関する情報を表示する場合:To show information about another user:

      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).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled

    • 別のユーザーの上司に関する情報を表示する場合:To show information about another user's manager:

      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).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled

ラベルに、指定したユーザーまたはそのユーザーの上司に関する入力した情報が表示されます。The label shows the information that you entered about the user you specified or that user's manager.

: Common Data Service のエンティティに基づくアプリを開発する場合は、電子メール アドレスの代わりに ID でユーザーを指定できます。Note: If you're developing an app based on an entity in the Common Data Service, you can specify a user based on ID instead of email address.

たとえば、アプリを自動で作成し[ラベル] コントロールが含まれる画面を追加してから、このコントロールの Text プロパティを次の式に設定します。For example, you can create an app automatically, add a screen that contains a Label control, and set the control's Text property to this formula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayNameOffice365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

連絡先を作成しアプリのブラウズ画面でその連絡先を選択すると、[ラベル] コントロールに連絡先の表示名が表示されます。If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

別のユーザーの直属の部下を表示するShow the direct reports of another user

  1. [挿入] メニューの [テキスト] から [Text input] (テキスト入力) を追加し、名前を InfoAbout に変更します。Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. InfoAbout に、組織内のユーザーの電子メール アドレスを入力します。In InfoAbout, enter the email address of a user in your organization. たとえば、「上司の名前@yourCompany.com」と入力します。For example, enter yourManagersName@yourCompany.com
  3. [挿入] メニューの [ギャラリー] から [テキスト付き] ギャラリーを追加し、Items プロパティに次の式を設定します。Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    ギャラリーに、入力したユーザーの直属の部下に関する情報が表示されます。The gallery shows information about the direct reports of the user you entered.

    ギャラリーを選択すると、右側のペインにそのギャラリーのオプションが表示されます。With the gallery selected, the right-hand pane shows options for that gallery.

  4. 2 番目のリストで、[JobTitle] (役職) を選択します。In the second list, select JobTitle. 3 番目のリストで、[DisplayName] (表示名) を選択します。In the third list, select DisplayName. ギャラリーが更新され、これらの値が表示されます。The gallery is updated to show these values.


    注: 実際には、1 番目のボックスはイメージ コントロールです。NOTE The first box is actually an image control. イメージがない場合はこのイメージ コントロールを削除し、その場所にラベルを追加できます。If you don't have an image, you can delete the image control, and add a label in its place. コントロールの追加および構成に関する記事をご覧ください。Add and configure controls is a good resource.

ユーザーを検索するSearch for users

  1. [挿入] メニューの [テキスト] から [Text input] (テキスト入力) を追加し、名前を SearchTerm に変更します。Add a Text input control (Insert menu > Text), and rename it SearchTerm. 検索対象の名前を入力します。Enter a name to search. たとえば、姓を入力します。For example, enter your first name.
  2. [挿入] メニューの [ギャラリー] から [テキスト付き] ギャラリーを追加し、Items プロパティに次の式を設定します。Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.SearchUser({searchTerm: SearchTerm.Text})

    ギャラリーに、入力した検索テキストを含む名前のユーザーが表示されます。The gallery shows users whose name contains the search text you entered.

    ギャラリーを選択すると、右側のペインにそのギャラリーのオプションが表示されます。With the gallery selected, the right-hand pane shows options for that gallery.

  3. 2 番目のリストで、[メール] を選択します。In the second list, select Mail. 3 番目のリストで、[DisplayName] (表示名) を選択します。In the third list, select DisplayName.

    ギャラリーの 2 番目と 3 番目のラベルが更新されます。The second and third labels in the gallery are updated.

使用可能な関数の確認View the available functions

この接続には、次の関数が含まれています。This connection includes the following functions:

関数名Function Name 説明Description
MyProfileMyProfile 現在のユーザーのプロファイルを取得しますRetrieves the profile for the current user
UserProfileUserProfile 特定のユーザー プロファイルを取得しますRetrieves a specific user profile
ManagerManager 指定したユーザーの上司のユーザー プロファイルを取得しますRetrieves user profile for the manager of the specified user
DirectReportsDirectReports 指定したユーザーの直属の部下を返しますReturns the direct reports for the specified user
SearchUserSearchUser ユーザー プロファイルの検索結果を取得しますRetrieves search results of user profiles

MyProfileMyProfile

自分のプロファイルの取得: 現在のユーザーのプロファイルを取得します。Get my profile: Retrieves the profile for the current user.

入力プロパティInput properties

なし。None.

出力プロパティOutput properties

プロパティ名Property Name 種類Type 説明Description
DepartmentDepartment stringstring ユーザーの部署です。Department of the user.
DisplayNameDisplayName stringstring ユーザーの表示名です。Display name of user.
GivenNameGivenName stringstring ユーザーの名です。Given name of user.
IdId stringstring ユーザー IDUser id
JobTitleJobTitle stringstring ユーザーの役職です。Job Title of the user.
メールMail stringstring ユーザーの電子メール ID です。Email id of user.
MailNicknameMailNickname stringstring ユーザーのニックネームです。Nickname of user.
SurnameSurname stringstring ユーザーの姓です。Surname of user.
TelephoneNumberTelephoneNumber stringstring ユーザーの電話番号です。Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring ユーザー プリンシパル名です。User Principal Name.
AccountEnabledAccountEnabled ブール値boolean アカウントの有効化フラグです。Account enabled flag.

UserProfileUserProfile

ユーザー プロファイルの取得: 特定のユーザー プロファイルを取得します。Get user profile: Retrieves a specific user profile.

入力プロパティInput properties

名前Name データ型Data Type 必須Required 説明Description
IdId stringstring はいyes ユーザー プリンシパル名または電子メール IDUser principal name or email id

出力プロパティOutput properties

プロパティ名Property Name 種類Type 説明Description
DepartmentDepartment stringstring ユーザーの部署です。Department of the user.
DisplayNameDisplayName stringstring ユーザーの表示名です。Display name of user.
GivenNameGivenName stringstring ユーザーの名です。Given name of user.
IdId stringstring ユーザー IDUser id
JobTitleJobTitle stringstring ユーザーの役職です。Job Title of the user.
メールMail stringstring ユーザーの電子メール ID です。Email id of user.
MailNicknameMailNickname stringstring ユーザーのニックネームです。Nickname of user.
SurnameSurname stringstring ユーザーの姓です。Surname of user.
TelephoneNumberTelephoneNumber stringstring ユーザーの電話番号です。Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring ユーザー プリンシパル名です。User Principal Name.
AccountEnabledAccountEnabled ブール値boolean アカウントの有効化フラグです。Account enabled flag.

ManagerManager

上司の取得: 指定したユーザーの上司のユーザー プロファイルを取得します。Get manager: Retrieves user profile for the manager of the specified user

入力プロパティInput properties

名前Name データ型Data Type 必須Required 説明Description
IdId stringstring はいyes ユーザー プリンシパル名または電子メール IDUser principal name or email id

出力プロパティOutput properties

プロパティ名Property Name 種類Type 説明Description
DepartmentDepartment stringstring ユーザーの部署です。Department of the user.
DisplayNameDisplayName stringstring ユーザーの表示名です。Display name of user.
GivenNameGivenName stringstring ユーザーの名です。Given name of user.
IdId stringstring ユーザー IDUser id
JobTitleJobTitle stringstring ユーザーの役職です。Job Title of the user.
メールMail stringstring ユーザーの電子メール ID です。Email id of user.
MailNicknameMailNickname stringstring ユーザーのニックネームです。Nickname of user.
SurnameSurname stringstring ユーザーの姓です。Surname of user.
TelephoneNumberTelephoneNumber stringstring ユーザーの電話番号です。Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring ユーザー プリンシパル名です。User Principal Name.
AccountEnabledAccountEnabled ブール値boolean アカウントの有効化フラグです。Account enabled flag.

DirectReportsDirectReports

直属の部下の取得: 直属の部下を取得します。Get direct reports: Get direct reports

入力プロパティInput properties

名前Name データ型Data Type 必須Required 説明Description
IdId stringstring はいyes ユーザー プリンシパル名または電子メール IDUser principal name or email id

出力プロパティOutput properties

プロパティ名Property Name 種類Type 説明Description
DepartmentDepartment stringstring ユーザーの部署です。Department of the user.
DisplayNameDisplayName stringstring ユーザーの表示名です。Display name of user.
GivenNameGivenName stringstring ユーザーの名です。Given name of user.
IdId stringstring ユーザー IDUser id
JobTitleJobTitle stringstring ユーザーの役職です。Job Title of the user.
メールMail stringstring ユーザーの電子メール ID です。Email id of user.
MailNicknameMailNickname stringstring ユーザーのニックネームです。Nickname of user.
SurnameSurname stringstring ユーザーの姓です。Surname of user.
TelephoneNumberTelephoneNumber stringstring ユーザーの電話番号です。Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring ユーザー プリンシパル名です。User Principal Name.
AccountEnabledAccountEnabled ブール値boolean アカウントの有効化フラグです。Account enabled flag.

SearchUserSearchUser

ユーザーの検索: ユーザー プロファイルの検索結果を取得します。Search for users: Retrieves search results of user profiles

入力プロパティInput properties

名前Name データ型Data Type 必須Required 説明Description
searchTermsearchTerm stringstring いいえno 文字列を検索します。Search string. 適用対象は、表示名、名、姓、メール、メールのニックネーム、およびユーザー プリンシパル名です。Applies to: display name, given name, surname, mail, mail nickname, and user principal name

出力プロパティOutput properties

プロパティ名Property Name 種類Type 説明Description
DepartmentDepartment stringstring ユーザーの部署です。Department of the user.
DisplayNameDisplayName stringstring ユーザーの表示名です。Display name of user.
GivenNameGivenName stringstring ユーザーの名です。Given name of user.
IdId stringstring ユーザー IDUser id
JobTitleJobTitle stringstring ユーザーの役職です。Job Title of the user.
メールMail stringstring ユーザーの電子メール ID です。Email id of user.
MailNicknameMailNickname stringstring ユーザーのニックネームです。Nickname of user.
SurnameSurname stringstring ユーザーの姓です。Surname of user.
TelephoneNumberTelephoneNumber stringstring ユーザーの電話番号です。Telephone number of user.
UserPrincipalNameUserPrincipalName stringstring ユーザー プリンシパル名です。User Principal Name.
AccountEnabledAccountEnabled ブール値boolean アカウントの有効化フラグです。Account enabled flag.