Office 365 Users

Office 365 Users を使用すると、自分の Office 365 アカウントを使用して組織内のユーザー プロファイルにアクセスできます。 自分のプロファイル、別のユーザーのプロファイル、ユーザーの上司または直属の部下を確認するなど、さまざまな操作を行うことができます。

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

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

 

前提条件

接続を追加する

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

    Office 365 への接続

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

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

アプリでこの接続を使用する

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

  1. [挿入] メニューで [ラベル] を選択します。
  2. 関数バーで、Text プロパティに次のいずれかの式を設定します。

    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

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

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

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

    コントロール名の変更

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

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

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

      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

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

      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

ラベルに、指定したユーザーまたはそのユーザーの上司に関する入力した情報が表示されます。

: Common Data Service のエンティティに基づくアプリを開発する場合は、電子メール アドレスの代わりに ID でユーザーを指定できます。

たとえば、アプリを自動で作成し[ラベル] コントロールが含まれる画面を追加してから、このコントロールの Text プロパティを次の式に設定します。
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

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

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

  1. [挿入] メニューの [テキスト] から [Text input] (テキスト入力) を追加し、名前を InfoAbout に変更します。

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

  3. [挿入] メニューの [ギャラリー] から [テキスト付き] ギャラリーを追加し、Items プロパティに次の式を設定します。

    Office365Users.DirectReports(InfoAbout.Text)

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

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

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


    注: 実際には、1 番目のボックスはイメージ コントロールです。 イメージがない場合はこのイメージ コントロールを削除し、その場所にラベルを追加できます。 コントロールの追加および構成に関する記事をご覧ください。

ユーザーを検索する

  1. [挿入] メニューの [テキスト] から [Text input] (テキスト入力) を追加し、名前を SearchTerm に変更します。 検索対象の名前を入力します。 たとえば、姓を入力します。

  2. [挿入] メニューの [ギャラリー] から [テキスト付き] ギャラリーを追加し、Items プロパティに次の式を設定します。

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

    ギャラリーに、入力した検索テキストを含む名前のユーザーが表示されます。

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

  3. 2 番目のリストで、[メール] を選択します。 3 番目のリストで、[DisplayName] (表示名) を選択します。

    ギャラリーの 2 番目と 3 番目のラベルが更新されます。

使用可能な関数の確認

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

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

MyProfile

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

入力プロパティ

なし。

出力プロパティ

プロパティ名 種類 説明
Department string ユーザーの部署です。
DisplayName string ユーザーの表示名です。
GivenName string ユーザーの名です。
Id string ユーザー ID
JobTitle string ユーザーの役職です。
メール string ユーザーの電子メール ID です。
MailNickname string ユーザーのニックネームです。
Surname string ユーザーの姓です。
TelephoneNumber string ユーザーの電話番号です。
UserPrincipalName string ユーザー プリンシパル名です。
AccountEnabled ブール値 アカウントの有効化フラグです。

UserProfile

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

入力プロパティ

名前 データ型 必須 説明
Id string はい ユーザー プリンシパル名または電子メール ID

出力プロパティ

プロパティ名 種類 説明
Department string ユーザーの部署です。
DisplayName string ユーザーの表示名です。
GivenName string ユーザーの名です。
Id string ユーザー ID
JobTitle string ユーザーの役職です。
メール string ユーザーの電子メール ID です。
MailNickname string ユーザーのニックネームです。
Surname string ユーザーの姓です。
TelephoneNumber string ユーザーの電話番号です。
UserPrincipalName string ユーザー プリンシパル名です。
AccountEnabled ブール値 アカウントの有効化フラグです。

Manager

上司の取得: 指定したユーザーの上司のユーザー プロファイルを取得します。

入力プロパティ

名前 データ型 必須 説明
Id string はい ユーザー プリンシパル名または電子メール ID

出力プロパティ

プロパティ名 種類 説明
Department string ユーザーの部署です。
DisplayName string ユーザーの表示名です。
GivenName string ユーザーの名です。
Id string ユーザー ID
JobTitle string ユーザーの役職です。
メール string ユーザーの電子メール ID です。
MailNickname string ユーザーのニックネームです。
Surname string ユーザーの姓です。
TelephoneNumber string ユーザーの電話番号です。
UserPrincipalName string ユーザー プリンシパル名です。
AccountEnabled ブール値 アカウントの有効化フラグです。

DirectReports

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

入力プロパティ

名前 データ型 必須 説明
Id string はい ユーザー プリンシパル名または電子メール ID

出力プロパティ

プロパティ名 種類 説明
Department string ユーザーの部署です。
DisplayName string ユーザーの表示名です。
GivenName string ユーザーの名です。
Id string ユーザー ID
JobTitle string ユーザーの役職です。
メール string ユーザーの電子メール ID です。
MailNickname string ユーザーのニックネームです。
Surname string ユーザーの姓です。
TelephoneNumber string ユーザーの電話番号です。
UserPrincipalName string ユーザー プリンシパル名です。
AccountEnabled ブール値 アカウントの有効化フラグです。

SearchUser

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

入力プロパティ

名前 データ型 必須 説明
searchTerm string いいえ 文字列を検索します。 適用対象は、表示名、名、姓、メール、メールのニックネーム、およびユーザー プリンシパル名です。

出力プロパティ

プロパティ名 種類 説明
Department string ユーザーの部署です。
DisplayName string ユーザーの表示名です。
GivenName string ユーザーの名です。
Id string ユーザー ID
JobTitle string ユーザーの役職です。
メール string ユーザーの電子メール ID です。
MailNickname string ユーザーのニックネームです。
Surname string ユーザーの姓です。
TelephoneNumber string ユーザーの電話番号です。
UserPrincipalName string ユーザー プリンシパル名です。
AccountEnabled ブール値 アカウントの有効化フラグです。

便利なリンク