Word JavaScript API memberikan kesalahan "RichApi.Error: NotImplemented" dengan Add-in Office menggunakan kontrol konten

Terakhir Diperbarui: 31 Agustus 2023

MASALAH

Add-in yang menggunakan kontrol konten melalui Word API JavaScript dapat memperlihatkan kesalahan "RichApi.Error: NotImplemented" dalam skenario tertentu. 

Hal ini pertama kali terlihat setelah pembaruan Office.js pada 10 Agustus 2023, khususnya di MacOS (Build 16.76).

PENYEBAB

Metode ContentControl.load() digunakan untuk memuat semua properti instans kontrol konten. Metode tersebut secara internal memuat semua properti kontrol konten satu per satu. Namun, alih-alih hanya menyertakan semua properti yang dirilis, properti baru yang masih dalam pengembangan atau belum dirilis juga disertakan. 

Masalah ini disebabkan oleh properti baru yang baru saja diperkenalkan yang implementasi awalnya mengembalikan kesalahan "NotImplemented", dan oleh karena itu menyebabkan beberapa panggilan ke metode load() gagal. 

Berikut ini adalah contoh kode yang berpotensi terpengaruh.

STATUS: DIPERBAIKI

SOLUSI

Perbarui ke versi terbaru Word.

Agar pengembang dapat membuat add-in mereka berfungsi pada build yang terpengaruh

Cara untuk menghindari properti yang tidak diketahui menyebabkan masalah ketika memuat kontrol konten adalah dengan menentukan kumpulan properti yang diperlukan secara eksplisit sesuai dengan logika yang diinginkan. 

Memperbarui contoh kode yang terpengaruh sebelumnya, kode berikut hanya memuat properti kontrol konten yang diperlukan.

Lihat juga:

• load(options)

• load(propertyNames)

• load(propertyNamesAndPaths)

RESOLUSI

• Word di web: Tidak terpengaruh.

• Word di Windows

  • Saluran Beta: Terpengaruh tetapi build setelah 16.0.16815.20000 berisi perbaikan.

  • Saluran Saat Ini (Pratinjau): Build yang terpengaruh setelah 16.0.16731.20170 berisi perbaikan.

  • Saluran Bulanan: Tidak terpengaruh.

  • Tidak terpengaruh.

• Word di Mac

  • Beta: Terpengaruh tetapi build setelah 16.77.23082006 berisi perbaikan.

  • Produksi: Terpengaruh tetapi build setelah 16.76.23082301 berisi perbaikan.