Hiểu tích hợp biểu mẫu SharePoint

Bài viết
03/14/2023

Giờ đây, bạn có thể dễ dàng tùy chỉnh biểu mẫu thư viện Microsoft Lists hoặc SharePoint bất kỳ trong Power Apps. Trong bài viết này, chúng tôi sẽ giới thiệu chi tiết về cách hoạt động của các biểu mẫu này và cách bạn có thể tùy chỉnh chúng.

Nếu đã tùy chỉnh biểu mẫu cho danh sách, bạn có thể nhận thấy rằng biểu mẫu được tạo mặc định hoạt động với tất cả thao tác, chẳng hạn như tạo, hiển thị hoặc chỉnh sửa mục. Tất cả là nhờ có các công thức được tạo và tùy chọn kiểm soát SharePointIntegration.

Tìm hiểu biểu mẫu được tạo mặc định

Biểu mẫu được tạo mặc định bao gồm các tùy chọn kiểm soát sau và giá trị mặc định tương ứng:

FormScreen1 - Đây là màn hình chứa biểu mẫu.
SharePointForm1 - Đây là biểu mẫu được dùng để tạo, hiển thị hoặc chỉnh sửa mục danh sách.
- Nguồn dữ liệu - Danh sách mà biểu mẫu được tùy chỉnh.
- Mục - Mục đã chọn từ danh sách. Tùy chọn này được đặt thành mục First() trong danh sách để thuận tiện cho bạn khi làm việc trong Power Apps Studio.
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  Mẹo
  
  Mẫu công thức trên (sử dụng ... SharePointDatasourceName.Selected) hiệu quả cho thuộc tính Item của một biểu mẫu. Xem phần bên dưới cho một mẫu công thức để đặt giá trị của một bản ghi SharePoint.
OnSuccess - Sau khi mục được tạo hoặc lưu thành công, biểu mẫu sẽ được đặt lại và SharePoint sẽ ẩn biểu mẫu.
```
ResetForm(SharePointForm1); RequestHide()
```
SharePointIntegration - Tùy chọn kiểm soát chịu trách nhiệm truyền đạt hành động của người dùng giữa SharePoint và Power Apps.
- Nguồn dữ liệu - Danh sách mà biểu mẫu được tùy chỉnh.
  
  'YourListName'
- OnNew - Đặt SharePointForm1 ở chế độ mới.
  
  NewForm(SharePointForm1)
- OnView - Đặt SharePointForm1 ở chế độ xem.
  
  ViewForm(SharePointForm1)
- OnEdit - Đặt SharePointForm1 ở chế độ chỉnh sửa.
  
  EditForm(SharePointForm1)
- OnSave - Gửi các thay đổi cho SharePointForm1. Khi gửi thành công biểu mẫu, công thức SharePointForm1.OnSuccess sẽ được thực thi.
  
  SubmitForm(SharePointForm1)
- OnCancel - Đặt lại các thay đổi cho SharePointForm1. SharePoint luôn ẩn biểu mẫu khi người dùng chọn Hủy trong SharePoint.
  
  ResetForm(SharePointForm1)

Các giá trị mặc định này đảm bảo rằng biểu mẫu hoạt động khi chạy trong SharePoint - giá trị mặc định sẽ thay đổi chế độ biểu mẫu Power Apps khi người dùng tương tác với biểu mẫu đó trong SharePoint, đồng thời đảm bảo rằng những thay đổi này được gửi tới SharePoint.

Tìm hiểu tùy chọn kiểm soát SharePointIntegration

Tùy chọn kiểm soát SharePointIntegration truyền đạt hành động của người dùng giữa SharePoint và Power Apps.

Đối tượng tích hợp SharePoint.

Lưu ý

Bạn chỉ có thể truy nhập vào các thuộc tính của tùy chọn kiểm soát SharePointIntegration khi biểu mẫu đang chạy trong SharePoint, chứ không phải khi bạn tùy chỉnh biểu mẫu trong Power Apps Studio. Những thuộc tính này có thể không có sẵn trong OnStart hoặc OnVisible.

Tùy chọn kiểm soát SharePointIntegration có các thuộc tính sau:

Đã chọn – Mục đã chọn từ danh sách.

OnNew - Các hành động cần thực hiện khi người dùng chọn nút Mới hoặc mở biểu mẫu Tạo mục trong SharePoint.

OnView - Các hành động cần thực hiện khi người dùng chọn một mục hoặc mở biểu mẫu Chi tiết khoản mục trong SharePoint.

OnEdit - Các hành động cần thực hiện khi người dùng chọn nút Chỉnh sửa tất cả hoặc mở biểu mẫu Chỉnh sửa mục trong SharePoint.

OnSave - Các hành động cần thực hiện khi người dùng chọn nút Lưu trong SharePoint.

OnCancel - Các hành động cần thực hiện khi người dùng chọn nút Hủy trong SharePoint.

SelectedListItemID – ID mục của mục đã chọn trong danh sách.

Data Source - Danh sách chứa bản ghi mà biểu mẫu sẽ hiển thị, chỉnh sửa hoặc tạo. Nếu bạn thay đổi thuộc tính này, các thuộc tính Selected và SelectedItemID có thể ngừng hoạt động.

Tùy chỉnh biểu mẫu mặc định

Bây giờ, bạn đã hiểu rõ hơn về biểu mẫu được tạo mặc định và tùy chọn kiểm soát SharePointIntegration, bạn có thể thay đổi công thức để tùy chỉnh biểu mẫu hơn nữa. Dưới đây là một số điều cần lưu ý khi bạn tùy chỉnh biểu mẫu:

Sử dụng công thức OnSave của tùy chọn điều khiển SharePointIntegration để tùy chỉnh những gì sẽ xảy ra khi người dùng chọn Lưu trong SharePoint. Nếu bạn có nhiều biểu mẫu, hãy đảm bảo chỉ gửi các thay đổi cho biểu mẫu hiện đang sử dụng.

Mẹo

Đặt các giá trị khác nhau cho biến trong công thức OnNew, OnView và OnEdit. Bạn có thể sử dụng biến này trong công thức OnSave để xác định biểu mẫu nào đang được sử dụng.
Nhớ thêm RequestHide() vào công thức OnSuccess của tất cả biểu mẫu. Nếu bạn quên điều này, SharePoint sẽ không biết khi nào cần ẩn biểu mẫu. Ngoài ra, tránh chạy mã quan trọng sau khi gọi RequestHide(), để tất cả mã chạy trong khi biểu mẫu vẫn hiển thị và có thể chạy logic.
Bạn không thể kiểm soát việc ẩn biểu mẫu khi người dùng chọn Hủy trong SharePoint, vì vậy hãy đảm bảo rằng bạn đặt lại biểu mẫu của mình trong công thức OnCancel của tùy chọn điều khiển SharePointIntegration.
Các thuộc tính của tùy chọn kiểm soát SharePointIntegration có thể không khả dụng trong OnStart hoặc OnVisible và những sự kiện đó chỉ thực hiện một lần khi danh sách được tải. Bạn có thể sử dụng công thức OnNew, OnView hoặc OnEdit để chạy logic trước mỗi lần biểu mẫu hiển thị với người dùng.

Các sự cố thường gặp với đối tượng SharePointIntegration

Khi giá trị của SharepointIntegration.Selected được đặt thành một bộ sưu tập trên thuộc tính OnView, nó không hiển thị giá trị mới nhất. Cách nên dùng để khắc phục sự cố này là sử dụng SharepointIntegration.SelectedListItemID, và sau đó thực hiện tra cứu trên bảng để lấy Bản ghi đã chọn.

Ví dụ: đối với thuộc tính OnView:
- Thay vì:
```
Set( selectedItem,
    SharePointIntegration.Selected );
```
- Sử dụng:
```
Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );
```
Các biến tập hợp không được đặt lại khi đóng biểu mẫu Power Apps và trạng thái vẫn tồn tại trong toàn bộ phiên. Đó là lý do tại sao, nếu có bất kỳ trường hợp sử dụng nào cần đặt lại các biến, hãy xóa các biến trong thuộc tính OnView của đối tượng SharePointIntegration.
Không nên dùng các hàm mệnh lệnh như Launch() trong các thuộc tính SharePointIntegration properties (chẳng hạn như OnNew và OnView). Việc sử dụng này có thể gây ra hành vi không mong muốn vì các sự kiện vòng đời của SharePointIntegration (chẳng hạn như thay đổi các lựa chọn) có thể kích hoạt trong nền ngay cả khi biểu mẫu không hiển thị.

Xem thêm

Các hàm EditForm, NewForm, SubmitForm, ResetForm và ViewForm - hàm biểu mẫu trong Power Apps
Hàm RequestHide
Các kịch bản tích hợp SharePoint

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 khoản về quyền riêng tư).

Chia sẻ qua