Word JavaScript API δίνει το σφάλμα "RichApi.Error: NotImplemented" με πρόσθετα του Office με χρήση στοιχείων ελέγχου περιεχομένου

Ισχύει για

Word για Microsoft 365 Word για Microsoft 365 για Mac

Τελευταία ενημέρωση: 31 Αυγούστου 2023

ΠΡΟΒΛΗΜΑ

Τα πρόσθετα που χρησιμοποιούν στοιχεία ελέγχου περιεχομένου μέσω Word JavaScript API ενδέχεται να εμφανίζουν σφάλματα "RichApi.Error: NotImplemented" σε ορισμένα σενάρια.

Αυτό παρατηρήθηκε για πρώτη φορά μετά την ενημέρωση Office.js στις 10 Αυγούστου 2023, ιδιαίτερα στο MacOS (Δομή 16.76).

ΑΙΤΙΑ

Η μέθοδος ContentControl.load() χρησιμοποιείται για τη φόρτωση όλων των ιδιοτήτων μιας παρουσίας στοιχείου ελέγχου περιεχομένου. Αυτή η μέθοδος φορτώνει εσωτερικά όλες τις ιδιότητες του στοιχείου ελέγχου περιεχομένου μία προς μία. Ωστόσο, αντί να συμπεριληφθούν μόνο όλα τα ακίνητα που κυκλοφόρησαν, περιλαμβάνονται επίσης νέες ιδιότητες που βρίσκονται ακόμη υπό ανάπτυξη ή δεν έχουν κυκλοφορήσει ακόμα.

Αυτό το πρόβλημα προκλήθηκε από μια νέα ιδιότητα που παρουσιάστηκε πρόσφατα, της οποίας η αρχική υλοποίηση επέστρεφε ένα σφάλμα "NotImplement" και, επομένως, προκάλεσε την αποτυχία ορισμένων κλήσεων στη μέθοδο load().

Ακολουθεί ένα παράδειγμα κώδικα που πιθανώς επηρεάζεται.

Word Παράδειγμα στιγμιότυπου οθόνης κώδικα JavaScript API

ΚΑΤΑΣΤΑΣΗ: ΔΙΟΡΘΩΘΗΚΕ

ΛΥΣΗ

Ενημερώστε το Word στην πιο πρόσφατη έκδοση.

Για προγραμματιστές ώστε να κάνουν τα πρόσθετά τους λειτουργικές σε επηρεαζόμενες δομές

Ο τρόπος για να αποφύγετε την πρόκληση προβλημάτων από άγνωστες ιδιότητες κατά τη φόρτωση ενός στοιχείου ελέγχου περιεχομένου είναι να καθορίσετε ρητά το σύνολο ιδιοτήτων που απαιτούνται σύμφωνα με την επιθυμητή λογική.

Ενημερώνοντας το προηγούμενο παράδειγμα του κώδικα που επηρεάζεται, ο παρακάτω κώδικας φορτώνει μόνο τις απαιτούμενες ιδιότητες των στοιχείων ελέγχου περιεχομένου.

Word Στιγμιότυπο οθόνης επίλυσης κώδικα API JavaScript

Δείτε επίσης:

ΕΠΊΛΥΣΗ

Word στο Web: Δεν επηρεάζεται.
Word στα Windows
- Κανάλι beta: Επηρεάζεται, αλλά δομές μετά την έκδοση 16.0.16815.20000 περιέχουν την επιδιόρθωση.
- Τρέχον κανάλι (Προεπισκόπηση): Επηρεάζεται, αλλά δομές μετά την έκδοση 16.0.16731.20170 περιέχουν την επιδιόρθωση.
- Μηνιαίο κανάλι: Δεν επηρεάζεται.
- MEC: Δεν επηρεάζεται.
Word σε Mac
- Beta: Επηρεάζεται, αλλά δομές μετά την έκδοση 16.77.23082006 περιέχουν την επιδιόρθωση.
- Παραγωγή: Επηρεάζεται, αλλά δομές μετά την έκδοση 16.76.23082301 περιέχουν την επιδιόρθωση.