Kết nối với Người dùng Office 365 từ Power Apps
Người dùng Office 365 cho phép bạn truy cập hồ sơ người dùng trong tổ chức của mình bằng cách sử dụng tài khoản Office 365. Bạn có thể thực hiện các hành động khác nhau như nhận hồ sơ, hồ sơ người dùng, người quản lý người dùng hoặc báo cáo trực tiếp.
Bạn có thể hiển thị thông tin này trong một nhãn trên ứng dụng của bạn. Bạn có thể hiển thị một hàm, nhiều hàm hoặc thậm chí kết hợp các hàm khác nhau. Ví dụ: bạn có thể tạo một biểu thức kết hợp Tên người dùng và Số điện thoại, sau đó hiển thị thông tin này trong ứng dụng của mình.
Bài viết này cho bạn biết cách thêm Người dùng Office 365 dưới dạng kết nối, thêm Người dùng Office 365 dưới dạng nguồn dữ liệu vào ứng dụng và dùng dữ liệu bảng trong điều khiển thư viện.
Điều kiện tiên quyết
- Truy cập vào Power Apps
- Thêm kết nối
- Tạo ứng dụng từ một mẫu, từ dữ liệu, hoặc từ đầu
Thêm kết nối
Thêm kết nối dữ liệu và chọn Người dùng Office 365:
Chọn Kết nối và nếu được nhắc đăng nhập, hãy nhập tài khoản công việc của bạn.
Kết nối Người dùng Office 365 đã được tạo và thêm vào ứng dụng của bạn. Bạn đã có thể sử dụng.
Sử dụng kết nối trong ứng dụng của bạn
Hiển thị thông tin về người dùng hiện tại
Trên menu Chèn, chọn Nhãn
Trong thanh hàm, đặt thuộc tính Văn bản của bất kỳ công thức nào sau đây:
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
Nhãn hiển thị thông tin mà bạn đã nhập về người dùng hiện tại.
Hiển thị thông tin về người dùng khác
Trên menu Chèn, chọn Văn bản rồi chọn Nhập văn bản. Đổi tên thành InfoAbout:
Trong InfoAbout, nhập hoặc dán địa chỉ email của người dùng trong tổ chức của bạn. Ví dụ: nhập tenban@tencongty.com.
Thêm Nhãn (menu Chèn) và đặt thuộc tính Văn bản thành bất kỳ công thức nào sau đây:
Để hiển thị thông tin về người dùng khác:
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Để hiển thị thông tin về người quản lý của người dùng khác:
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
Nhãn hiển thị thông tin mà bạn đã nhập về người dùng bạn đã chỉ định hoặc người quản lý của người dùng đó.
Lưu ý
Nếu đang phát triển ứng dụng dựa trên một bảng trong Microsoft Dataverse, bạn có thể chỉ định người dùng dựa trên ID thay vì địa chỉ email.
Ví dụ, bạn có thể tự động tạo ứng dụng, thêm màn hình có chứa tùy chọn điều khiển Nhãn và thiết lập thuộc tính Văn bản của tùy chọn điều khiển theo công thức sau:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName
Nếu bạn tạo một liên hệ và chọn liên hệ đó trong màn hình duyệt của ứng dụng, thì tùy chọn điều khiển Nhãn sẽ hiển thị tên hiển thị của bạn.
Hiển thị các báo cáo trực tiếp của người dùng khác
Thêm điều khiển Nhập văn bản (menu Chèn > Văn bản) và đổi tên thành InfoAbout.
Trong InfoAbout, nhập địa chỉ email của người dùng trong tổ chức của bạn. Ví dụ: nhập tenquanly@tencongty.com
Thêm bộ sưu tập Có văn bản (menu Chèn > Bộ sưu tập) và đặt thuộc tính Mục thành công thức sau:
Office365Users.DirectReports(InfoAbout.Text)Bộ sưu tập hiển thị thông tin về báo cáo trực tiếp của người dùng bạn đã nhập.
Với bộ sưu tập được chọn, ngăn bên phải hiển thị các tùy chọn cho bộ sưu tập đó.
Trong danh sách thứ hai, chọn Tiêu đề công việc. Trong danh sách thứ ba, chọn Tên hiển thị. Bộ sưu tập được cập nhật để hiển thị những giá trị này.
Lưu ý
Hộp đầu tiên thực ra là một điều khiển hình ảnh. Nếu bạn không có hình ảnh, bạn có thể xóa điều khiển hình ảnh và thêm nhãn vào vị trí của nó. Thêm và định cấu hình điều khiển là một tài nguyên tốt.
Tìm kiếm người dùng
Thêm điều khiển Nhập văn bản (menu Chèn > Nhập văn bản).
Chọn Chèn > Thư viện dọc.
Thay đổi bố cục của thư viện dọc thành Tiêu đề, phụ đề và nội dung.
Chọn biểu tượng mũi tên từ hàng đầu tiên trong thư viện và xóa.
Cập nhật giá trị thư viện dọc vào công thức sau.
Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).valueTrong công thức trên, cụm từ tìm kiếm tham chiếu đến văn bản được nhập trong điều khiển nhập văn bản ("TextInput1" trong ví dụ này); và kết quả tìm kiếm được giới hạn ở top 5.
Cập nhật các trường thư viện dọc để hiển thị DisplayName trong tiêu đề thư viện, JobTitle trong phụ đề và Phòng trong nội dung.
Phát ứng dụng và nhập văn bản bên trong hộp nhập văn bản. Khi bạn nhập văn bản, kết quả thay đổi dựa trên sự thay đổi của chuỗi đầu vào.
Xem các hàm có sẵn
Kết nối này bao gồm các hàm sau:
| Tên Chức năng | Mô tả |
|---|---|
| DirectReports | Trả về các báo cáo trực tiếp cho người dùng được chỉ định. |
| Người quản lý | Truy xuất hồ sơ người dùng cho người quản lý của người dùng được chỉ định. |
| MyProfile | Truy xuất hồ sơ của người dùng hiện tại. |
| SearchUser | Truy xuất kết quả tìm kiếm hồ sơ người dùng. |
| UserProfile | Truy xuất hồ sơ người dùng cụ thể. |
MyProfile
Tải hồ sơ của tôi: Truy xuất hồ sơ của người dùng hiện tại.
Thuộc tính đầu vào
Không.
Thuộc tính đầu ra
| Tên thuộc tính | Loại | Mô tả |
|---|---|---|
| Thành phố | string | Thành phố của người dùng. |
| CompanyName | string | Công ty của người dùng. |
| Quốc gia | string | Quốc gia của người dùng. |
| Bộ phận | string | Bộ phận người dùng. |
| DisplayName | string | Tên hiển thị của người dùng. |
| GivenName | string | Họ tên của người dùng. |
| ID | string | ID người dùng. |
| JobTitle | string | Chức danh công việc của người dùng. |
| Thư | string | ID email của người dùng. |
| MailNickname | string | Biệt danh của người dùng. |
| mobilePhone | string | Điện thoại di động của người dùng. |
| OfficeLocation | string | Vị trí văn phòng của người dùng. |
| PostalCode | string | Mã bưu điện của người dùng. |
| Surname | string | Họ của người dùng. |
| TelephoneNumber | string | Số điện thoại của người dùng. |
| UserPrincipalName | string | Tên chính của người dùng. |
| AccountEnabled | boolean | Cờ kích hoạt tài khoản. |
| BusinessPhones | string | Số điện thoại của công ty người dùng. |
UserProfile
Tải hồ sơ người dùng: Truy xuất hồ sơ người dùng cụ thể.
Thuộc tính đầu vào
| Tên | Loại dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| ID | string | có | Tên chính hoặc id email của người dùng. |
Thuộc tính đầu ra
| Tên thuộc tính | Loại | Mô tả |
|---|---|---|
| Thành phố | string | Thành phố của người dùng. |
| CompanyName | string | Công ty của người dùng. |
| Quốc gia | string | Quốc gia của người dùng. |
| Bộ phận | string | Bộ phận người dùng. |
| DisplayName | string | Tên hiển thị của người dùng. |
| GivenName | string | Họ tên của người dùng. |
| ID | string | ID người dùng. |
| JobTitle | string | Chức danh công việc của người dùng. |
| Thư | string | ID email của người dùng. |
| MailNickname | string | Biệt danh của người dùng. |
| Surname | string | Họ của người dùng. |
| TelephoneNumber | string | Số điện thoại của người dùng. |
| UserPrincipalName | string | Tên chính của người dùng. |
| AccountEnabled | boolean | Cờ kích hoạt tài khoản. |
| BusinessPhones | string | Số điện thoại của công ty người dùng. |
Người quản lý
Tải người quản lý: Truy xuất hồ sơ người dùng cho người quản lý của người dùng được chỉ định.
Thuộc tính đầu vào
| Tên | Loại dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| ID | string | có | Tên chính hoặc id email của người dùng. |
Thuộc tính đầu ra
| Tên thuộc tính | Loại | Mô tả |
|---|---|---|
| Thành phố | string | Thành phố của người dùng. |
| CompanyName | string | Công ty của người dùng. |
| Quốc gia | string | Quốc gia của người dùng. |
| Bộ phận | string | Bộ phận người dùng. |
| DisplayName | string | Tên hiển thị của người dùng. |
| GivenName | string | Họ tên của người dùng. |
| ID | string | ID người dùng. |
| JobTitle | string | Chức danh công việc của người dùng. |
| Thư | string | ID email của người dùng. |
| MailNickname | string | Biệt danh của người dùng. |
| mobilePhone | string | Điện thoại di động của người dùng. |
| OfficeLocation | string | Vị trí văn phòng của người dùng. |
| PostalCode | string | Mã bưu điện của người dùng. |
| Surname | string | Họ của người dùng. |
| TelephoneNumber | string | Số điện thoại của người dùng. |
| UserPrincipalName | string | Tên chính của người dùng. |
| AccountEnabled | boolean | Cờ kích hoạt tài khoản. |
| BusinessPhones | string | Số điện thoại của công ty người dùng. |
DirectReports
Tải báo cáo trực tiếp: Tải báo cáo trực tiếp.
Thuộc tính đầu vào
| Tên | Loại dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| ID | string | có | Tên chính hoặc id email của người dùng. |
Thuộc tính đầu ra
| Tên thuộc tính | Loại | Mô tả |
|---|---|---|
| Thành phố | string | Thành phố của người dùng. |
| CompanyName | string | Công ty của người dùng. |
| Quốc gia | string | Quốc gia của người dùng. |
| Bộ phận | string | Bộ phận người dùng. |
| DisplayName | string | Tên hiển thị của người dùng. |
| GivenName | string | Họ tên của người dùng. |
| ID | string | ID người dùng. |
| JobTitle | string | Chức danh công việc của người dùng. |
| Thư | string | ID email của người dùng. |
| MailNickname | string | Biệt danh của người dùng. |
| mobilePhone | string | Điện thoại di động của người dùng. |
| OfficeLocation | string | Vị trí văn phòng của người dùng. |
| PostalCode | string | Mã bưu điện của người dùng. |
| Surname | string | Họ của người dùng. |
| TelephoneNumber | string | Số điện thoại của người dùng. |
| UserPrincipalName | string | Tên chính của người dùng. |
| AccountEnabled | boolean | Cờ kích hoạt tài khoản. |
| BusinessPhones | string | Số điện thoại của công ty người dùng. |
SearchUser
Tìm kiếm người dùng: Truy xuất kết quả tìm kiếm hồ sơ người dùng.
Thuộc tính đầu vào
| Tên | Loại dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| searchTerm | string | không | Chuỗi tìm kiếm. Áp dụng cho: tên hiển thị, họ tên, họ, thư, biệt danh trong thư và tên chính của người dùng. |
Thuộc tính đầu ra
| Tên thuộc tính | Loại | Mô tả |
|---|---|---|
| Thành phố | string | Thành phố của người dùng. |
| CompanyName | string | Công ty của người dùng. |
| Quốc gia | string | Quốc gia của người dùng. |
| Bộ phận | string | Bộ phận người dùng. |
| DisplayName | string | Tên hiển thị của người dùng. |
| GivenName | string | Họ tên của người dùng. |
| ID | string | ID người dùng. |
| JobTitle | string | Chức danh công việc của người dùng. |
| Thư | string | ID email của người dùng. |
| MailNickname | string | Biệt danh của người dùng. |
| mobilePhone | string | Điện thoại di động của người dùng. |
| OfficeLocation | string | Vị trí văn phòng của người dùng. |
| PostalCode | string | Mã bưu điện của người dùng. |
| Surname | string | Họ của người dùng. |
| TelephoneNumber | string | Số điện thoại của người dùng. |
| UserPrincipalName | string | Tên chính của người dùng. |
| AccountEnabled | boolean | Cờ kích hoạt tài khoản. |
| BusinessPhones | string | Số điện thoại của công ty người dùng. |
Xem thêm
- Xem tất cả các kết nối hiện có.
- Tìm hiểu cách thêm kết nối vào ứng dụng của bạn.
Lưu ý
Bạn có thể cho chúng tôi biết bạn thích dùng ngôn ngữ nào cho tài liệu không? Làm một cuộc khảo sát ngắn. (xin lưu ý, khảo sát này bằng tiếng Anh)
Cuộc khảo sát sẽ mất khoảng bảy phút. Không có dữ liệu cá nhân nào được thu thập (điều khoản về quyền riêng tư).
Phản hồi
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem: https://aka.ms/ContentUserFeedback.
Gửi và xem ý kiến phản hồi dành cho