Word API JavaScript cung cấp lỗi "RichApi.Error: NotImplemented" với Các phần bổ trợ dành cho Office bằng cách sử dụng điều khiển nội dung

Cập nhật gần nhất: 31/08/2023

SỰ CỐ

Phần bổ trợ sử dụng kiểm soát nội dung Word API JavaScript có thể hiển thị lỗi "RichApi.Error: NotImplemented" trong một số trường hợp nhất định. 

Sự cố này được chú ý lần đầu tiên sau bản cập nhật Office.js vào ngày 10 tháng 8 năm 2023, đặc biệt là trên MacOS (Bản dựng 16.76).

NGUYÊN NHÂN

Phương pháp ContentControl.load() được sử dụng để tải tất cả các thuộc tính của một phiên bản kiểm soát nội dung. Phương pháp đó tải nội bộ tất cả các thuộc tính kiểm soát nội dung từng cái một. Tuy nhiên, thay vì chỉ bao gồm tất cả các thuộc tính phát hành, các thuộc tính mới vẫn đang được phát triển hoặc chưa được phát hành cũng được bao gồm. 

Sự cố này là do gần đây đã giới thiệu thuộc tính mới mà việc triển khai ban đầu đã trả về lỗi "NotImplemented" và do đó khiến một số lệnh gọi đến phương thức load() bị lỗi. 

Sau đây là ví dụ về mã có khả năng bị ảnh hưởng.

TRẠNG THÁI: ĐÃ KHẮC PHỤC

GIẢI PHÁP THAY THẾ

Cập nhật lên phiên bản mới nhất của Word.

Dành cho nhà phát triển giúp phần bổ trợ của họ hoạt động trên các bản dựng bị ảnh hưởng

Cách để tránh các thuộc tính không xác định gây ra bất kỳ rắc rối khi tải một kiểm soát nội dung là để xác định rõ ràng tập hợp các thuộc tính được yêu cầu theo logic mong muốn. 

Cập nhật ví dụ trước đó của mã bị ảnh hưởng, mã sau đây chỉ tải các thuộc tính bắt buộc của điều khiển nội dung.

Xem thêm:

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

GIẢI PHÁP

• Word web: Không bị ảnh hưởng.

• Word trên Windows

  • Kênh Beta: Bị ảnh hưởng nhưng các bản dựng sau 16.0.16815.20000 chứa bản sửa lỗi.

  • Kênh Hiện tại (Bản xem trước): Bị ảnh hưởng nhưng các bản dựng sau 16.0.16731.20170 chứa bản sửa lỗi.

  • Kênh Hàng tháng: Không bị ảnh hưởng.

  • MEC: Không bị ảnh hưởng.

• Word trên máy Mac

  • Beta: Bị ảnh hưởng nhưng các bản dựng sau bản dựng 16.77.23082006 chứa bản sửa lỗi.

  • Sản xuất: Bị ảnh hưởng nhưng các bản dựng sau bản dựng 16.76.23082301 chứa bản sửa lỗi.