Office 365 Users

Office 365 Users 可讓您使用 Office 365 帳戶,存取組織中使用者的設定檔。 您可以執行各種動作,例如取得設定檔、使用者設定檔、使用者的經理或直屬員工。

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

本主題說明如何將 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. 在 [插入] 功能表上,選取 [文字],然後選取 [文字輸入]。 將它重新命名為 InfoAbout

    重新命名控制項

  2. InfoAbout 中,輸入或貼上您組織使用者的電子郵件地址。 例如,輸入 yourName@*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 中的實體為基礎,您可以依據識別碼 (而非依據電子郵件地址) 指定使用者。

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

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

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

  1. 新增文字輸入控制項 ([插入] 功能表 > [文字]),並將它重新命名為 InfoAbout

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

  3. 新增 With text 資源庫 ([插入] 功能表 > 資源庫),並將其 Items 屬性設定為下列公式︰

    Office365Users.DirectReports(InfoAbout.Text)

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

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

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


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

搜尋使用者

  1. 新增文字輸入控制項 ([插入] 功能表 > [文字]),並將它重新命名為 SearchTerm。 輸入要搜尋的名稱。 例如,輸入您的名字。

  2. 新增 With text 資源庫 ([插入] 功能表 > 資源庫),並將其 Items 屬性設定為下列公式︰

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

    資源庫會顯示其名稱包含所輸入搜尋文字的使用者。

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

  3. 在第二個清單中,選取 Mail。 在第三個清單中,選取 DisplayName

    資源庫中的第二個和第三個標籤已更新。

檢視可用的函式

此連線包含下列函式︰

函式名稱 說明
MyProfile 擷取目前使用者的設定檔
UserProfile 擷取特定的使用者設定檔
Manager 擷取指定使用者經理的使用者設定檔
DirectReports 傳回指定使用者的直屬員工
SearchUser 擷取使用者設定檔的搜尋結果

MyProfile

取得我的設定檔:擷取目前使用者的設定檔。

輸入屬性

無。

輸出屬性

屬性名稱 類型 說明
Department 字串 使用者的部門。
DisplayName 字串 使用者的顯示名稱。
GivenName 字串 使用者的名字。
識別碼 字串 使用者識別碼
JobTitle 字串 使用者的職稱。
郵件 字串 使用者的電子郵件識別碼。
MailNickname 字串 使用者的暱稱。
姓氏 字串 使用者的姓氏。
TelephoneNumber 字串 使用者的電話號碼。
UserPrincipalName 字串 使用者主體名稱。
AccountEnabled 布林值 帳戶啟用旗標。

UserProfile

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

輸入屬性

名稱 資料類型 必要 說明
識別碼 字串 使用者主體名稱或電子郵件識別碼

輸出屬性

屬性名稱 類型 說明
Department 字串 使用者的部門。
DisplayName 字串 使用者的顯示名稱。
GivenName 字串 使用者的名字。
識別碼 字串 使用者識別碼
JobTitle 字串 使用者的職稱。
郵件 字串 使用者的電子郵件識別碼。
MailNickname 字串 使用者的暱稱。
姓氏 字串 使用者的姓氏。
TelephoneNumber 字串 使用者的電話號碼。
UserPrincipalName 字串 使用者主體名稱。
AccountEnabled 布林值 帳戶啟用旗標。

經理

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

輸入屬性

名稱 資料類型 必要 說明
識別碼 字串 使用者主體名稱或電子郵件識別碼

輸出屬性

屬性名稱 類型 說明
Department 字串 使用者的部門。
DisplayName 字串 使用者的顯示名稱。
GivenName 字串 使用者的名字。
識別碼 字串 使用者識別碼
JobTitle 字串 使用者的職稱。
郵件 字串 使用者的電子郵件識別碼。
MailNickname 字串 使用者的暱稱。
姓氏 字串 使用者的姓氏。
TelephoneNumber 字串 使用者的電話號碼。
UserPrincipalName 字串 使用者主體名稱。
AccountEnabled 布林值 帳戶啟用旗標。

DirectReports

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

輸入屬性

名稱 資料類型 必要 說明
識別碼 字串 使用者主體名稱或電子郵件識別碼

輸出屬性

屬性名稱 類型 說明
Department 字串 使用者的部門。
DisplayName 字串 使用者的顯示名稱。
GivenName 字串 使用者的名字。
識別碼 字串 使用者識別碼
JobTitle 字串 使用者的職稱。
郵件 字串 使用者的電子郵件識別碼。
MailNickname 字串 使用者的暱稱。
姓氏 字串 使用者的姓氏。
TelephoneNumber 字串 使用者的電話號碼。
UserPrincipalName 字串 使用者主體名稱。
AccountEnabled 布林值 帳戶啟用旗標。

SearchUser

搜尋使用者:擷取使用者設定檔的搜尋結果

輸入屬性

名稱 資料類型 必要 說明
searchTerm 字串 搜尋字串。 適用於︰顯示名稱、名字、姓氏、郵件、郵件暱稱和使用者主體名稱

輸出屬性

屬性名稱 類型 說明
Department 字串 使用者的部門。
DisplayName 字串 使用者的顯示名稱。
GivenName 字串 使用者的名字。
識別碼 字串 使用者識別碼
JobTitle 字串 使用者的職稱。
郵件 字串 使用者的電子郵件識別碼。
MailNickname 字串 使用者的暱稱。
姓氏 字串 使用者的姓氏。
TelephoneNumber 字串 使用者的電話號碼。
UserPrincipalName 字串 使用者主體名稱。
AccountEnabled 布林值 帳戶啟用旗標。

有用連結