從 Power Apps 連線到 Office 365 Users 連線

Office 365 使用者。

Office 365 Users 讓您使用 Office 365 帳戶存取貴組織的使用者基本資料。 您可以執行各種動作如取得基本資料、使用者基本資料、使用者的經理或直屬員工。

您可以在您應用程式的標籤中顯示此資訊。 您可以顯示一個函數、多個函數,或甚至結合不同的函數。 例如,您可以建立運算式結合使用者名稱和電話號碼,然後在您的應用程式中顯示此資訊。

本文說明如何將 Office 365 Users 新增為連線、將 Office 365 Users 新增至您的應用程式中做為資料來源,並使用資源庫控制項中的資料表資料。

先決條件

新增連線

  1. 新增資料連線 和選取 Office 365 Users

    連線至 Office 365。

  2. 選取 Connect,如果系統提示您登入,請輸入工作帳戶。

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

標籤顯示您所輸入的指明使用者或該使用者的經理資訊。

注意

如果您開發的應用程式是以 Microsoft Dataverse 中的資料表為基礎,您可以依據識別碼 (而非依據電子郵件地址) 指定使用者。

例如,您可以 自動建立應用程式、新增包含標籤控制項的畫面控制項,並將控制項的 Text 屬性設定為下列公式︰
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

如果您建立連絡人,並在應用程式的瀏覽畫面控制項中選取該連絡人,標籤控制項就會顯示您的顯示名稱。

顯示另一個使用者的直屬員工

  1. 新增文字輸入控制項 (Insert menu > Text),並將它重新命名為 InfoAbout

  2. InfoAbout 中,輸入貴組織使用者的電子郵件地址。 例如,輸入 yourManagersName@yourCompany.com

  3. 新增包含文字資源庫 (插入功能表 > 資源庫),並將其 Items 屬性設定為下列公式︰

    Office365Users.DirectReports(InfoAbout.Text)

    資源庫顯示與您輸入的使用者直屬員工的資訊。

    選取資源庫後,右窗格會顯示該資源庫的選項。

  4. 在第二個清單中,選取 JobTitle。 在第三個清單中,選取 DisplayName。 資源庫會更新顯示這些值。

注意

第一個方塊實際上是圖像控制項。 如果您沒有圖像,您可以刪除圖像控制項,並在其位置中新增標籤。 新增並設定控制項 是不錯的資源。

搜尋使用者

  1. 新增文字輸入控制項 (插入功能表>文字輸入)。

  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 使用者識別碼。
JobTitle string 使用者的職稱。
郵件 string 使用者的電子郵件識別碼。
MailNickname string 使用者的暱稱。
mobilePhone string 使用者的行動電話號碼。
OfficeLocation string 使用者的辦公地點。
PostalCode string 使用者的郵遞區號代碼。
姓氏 string 使用者的姓氏。
TelephoneNumber string 使用者的電話號碼。
UserPrincipalName string 使用者主體名稱。
AccountEnabled boolean 帳戶啟用旗標。
BusinessPhones string 使用者公司的電話號碼。

UserProfile

取得使用者設定檔:擷取特定的使用者設定檔。

輸入屬性

姓名 資料類型 出席者 描述
ID string 使用者主體名稱或電子郵件識別碼。

輸出屬性

屬性名稱 類型​​ 描述
城市 string 使用者所在城市。
CompanyName string 使用者的公司。
國家/地區 string 使用者所在國家/地區。
部門 string 使用者的部門。
DisplayName string 使用者的顯示名稱。
GivenName string 使用者的已知名字。
ID string 使用者識別碼。
JobTitle string 使用者的職稱。
郵件 string 使用者的電子郵件識別碼。
MailNickname string 使用者的暱稱。
姓氏 string 使用者的姓氏。
TelephoneNumber string 使用者的電話號碼。
UserPrincipalName string 使用者主體名稱。
AccountEnabled boolean 帳戶啟用旗標。
BusinessPhones string 使用者公司的電話號碼。

經理

取得經理:擷取指定使用者經理的使用者設定檔。

輸入屬性

姓名 資料類型 出席者 描述
ID string 使用者主體名稱或電子郵件識別碼。

輸出屬性

屬性名稱 類型​​ 描述
城市 string 使用者所在城市。
CompanyName string 使用者的公司。
國家/地區 string 使用者所在國家/地區。
部門 string 使用者的部門。
DisplayName string 使用者的顯示名稱。
GivenName string 使用者的已知名字。
ID string 使用者識別碼。
JobTitle string 使用者的職稱。
郵件 string 使用者的電子郵件識別碼。
MailNickname string 使用者的暱稱。
mobilePhone string 使用者的行動電話號碼。
OfficeLocation string 使用者的辦公地點。
PostalCode string 使用者的郵遞區號代碼。
姓氏 string 使用者的姓氏。
TelephoneNumber string 使用者的電話號碼。
UserPrincipalName string 使用者主體名稱。
AccountEnabled boolean 帳戶啟用旗標。
BusinessPhones string 使用者公司的電話號碼。

DirectReports

取得直屬員工︰取得直屬員工。

輸入屬性

姓名 資料類型 出席者 描述
ID string 使用者主體名稱或電子郵件識別碼。

輸出屬性

屬性名稱 類型​​ 描述
城市 string 使用者所在城市。
CompanyName string 使用者的公司。
國家/地區 string 使用者所在國家/地區。
部門 string 使用者的部門。
DisplayName string 使用者的顯示名稱。
GivenName string 使用者的已知名字。
ID string 使用者識別碼。
JobTitle string 使用者的職稱。
郵件 string 使用者的電子郵件識別碼。
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 使用者識別碼。
JobTitle string 使用者的職稱。
郵件 string 使用者的電子郵件識別碼。
MailNickname string 使用者的暱稱。
mobilePhone string 使用者的行動電話號碼。
OfficeLocation string 使用者的辦公地點。
PostalCode string 使用者的郵遞區號代碼。
姓氏 string 使用者的姓氏。
TelephoneNumber string 使用者的電話號碼。
UserPrincipalName string 使用者主體名稱。
AccountEnabled boolean 帳戶啟用旗標。
BusinessPhones 字串 使用者公司的電話號碼。

請參閱

注意

是否能請您告知您偏好的慣用文件語言? 請填寫問卷。 (請注意,本問卷為英文版)

完成問卷大約需要七分鐘。 本問卷將不會收集個人資料 (隱私權聲明)。