Σύνοψη API: Οι τελευταίες ενημερώσεις για το ONLYOFFICE Docs

Έχουμε εφαρμόσει μια σειρά από ενημερώσεις API για το ONLYOFFICE Docs, με στόχο την ενίσχυση της συμβατότητας, της προσαρμογής και της ασφάλειας. Είτε δημιουργείτε προσαρμοσμένες ροές εργασίας, ενεργοποιείτε ασφαλή συνεργασία σε έγγραφα ή ενσωματώνετε προηγμένα API, αυτές οι βελτιώσεις προσφέρουν απεριόριστες δυνατότητες. Ακολουθεί μια ανάλυση των τελευταίων προσθηκών και βελτιώσεων.

Εκτεταμένη υποστήριξη μορφών αρχείων

Το Docs API υποστηρίζει τώρα πρόσθετες μορφές αρχείων, προσφέροντας ευρύτερη συμβατότητα, για να διασφαλίσει μια απρόσκοπτη εμπειρία για χρήστες που εργάζονται με διάφορους τύπους αρχείων. Μεταξύ αυτών είναι οι μορφές Apple iWork και Hancom Office:

• pages
• key
• numbers
• hwp
• hwpx

Αυτές οι μορφές μπορούν να καθοριστούν χρησιμοποιώντας την ιδιότητα documentType, για παράδειγμα:

const config = {
  documentType: "pages",

Βελτιωμένες επιλογές προσαρμογής

Οι προγραμματιστές έχουν τώρα περισσότερο έλεγχο στη συμπεριφορά και την εμφάνιση του επεξεργαστή. Οι κύριες ενημερώσεις περιλαμβάνουν:

• Απόκρυψη συμβουλών χαρακτηριστικών

Η παράμετρος editorConfig.customization.features.featuresTips επιτρέπει την ενεργοποίηση ή απενεργοποίηση συμβουλών σχετικά με τα νέα χαρακτηριστικά κατά την πρώτη φόρτωση του επεξεργαστή μετά την ενημέρωση. Η προεπιλεγμένη τιμή είναι true.

• Εμφάνιση γραμμών κύλισης υπολογιστικών φύλλων

Από την έκδοση 8.3, είναι δυνατό να οριστεί εάν η οριζόντια/κατακόρυφη κύλιση εμφανίζεται αυτόματα ή κρύβεται κατά τη φόρτωση του επεξεργαστή υπολογιστικών φύλλων. Ελέγξτε τις παραμέτρους editorConfig.customization.showHorizontalScroll και editorConfig.customization.showVerticalScroll για να ελέγξετε αυτές τις παραμέτρους.

• Φόντο παρουσίασης διαφανειών

Χρησιμοποιήστε την παράμετρο editorConfig.customization.slidePlayerBackground για να ορίσετε το χρώμα φόντου της παρουσίασης σε μορφές HEX, RGB ή RGBA. Για παράδειγμα, #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).

showHorizontalScroll: true,
      showVerticalScroll: true,
      slidePlayerBackground: "#000000",

• Χρώματα επικεφαλίδων εγγράφων

Προσαρμόστε τα στυλ επικεφαλίδων στον επεξεργαστή εγγράφων με την παράμετρο editorConfig.customization.wordHeadingsColor, η οποία επιτρέπει τον καθορισμό χρωμάτων HEX.

• Κουμπί Πληροφοριών για κινητά

Εναλλαγή εμφάνισης του κουμπιού Πληροφορίες Εγγράφου για επεξεργαστές κινητών χρησιμοποιώντας την παράμετρο editorConfig.customization.mobile.info. Η προεπιλεγμένη τιμή είναι false.

• Λειτουργία δείκτη

Προσαρμόστε τη λειτουργία δείκτη (επιλογή ή χέρι) στον προβολέα παρουσιάσεων χρησιμοποιώντας την παράμετρο editorConfig.customization.pointerMode. Η προεπιλεγμένη τιμή είναι select.

• Συμπαγής γραμμή εργαλείων για τον προβολέα

Η παράμετρος editorConfig.customization.compactToolbar υποστηρίζει τώρα τη λειτουργία προβολής, επιτρέποντας εναλλαγή μεταξύ πλήρους και συμπαγούς γραμμής εργαλείων. Η προεπιλεγμένη τιμή για τη λειτουργία προβολής είναι true.

Βελτιωμένα χαρακτηριστικά ασφάλειας

Το Docs API εισάγει χειρισμό αρχείων με κωδικό πρόσβασης με το προστιθέμενο συμβάν events.onUserActionRequired. Η συνάρτηση καλείται όταν απαιτείται μια ενέργεια από τον χρήστη για να ανοίξει ένα έγγραφο στις ακόλουθες περιπτώσεις:

• όταν ο χρήστης χρειάζεται να εισάγει έναν κωδικό πρόσβασης για να ανοίξει το προστατευμένο έγγραφο.
• όταν ο χρήστης χρειάζεται να επιλέξει μια κωδικοποίηση για το αρχείο TXT.
• όταν ο χρήστης χρειάζεται να επιλέξει μια κωδικοποίηση και ένα διαχωριστικό για το αρχείο CSV.

Ακολουθεί ένα παράδειγμα του πώς λειτουργεί το συμβάν:

function onUserActionRequired() {
  console.log("Εισάγετε έναν κωδικό πρόσβασης")
};
const config = {
  events: {
    onUserActionRequired,
  },
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

Επιπλέον, τώρα μπορείτε να χρησιμοποιήσετε την εντολή drop για να απαγορεύσετε την επεξεργασία εγγράφων σε συγκεκριμένους χρήστες:

{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}

Το πλήρες αρχείο καταγραφής αλλαγών του Docs API είναι διαθέσιμο εδώ.

ΚΑΝΤΕ ΛΗΨΗ ΤΩΡΑ

Νέες μέθοδοι Office API

Το Office API λαμβάνει σημαντικές ενημερώσεις για καλύτερη διαχείριση εγγράφων, συγκεκριμένα:

• Σελιδοδείκτες
• Στοιχεία ελέγχου περιεχομένου
• Τμήματα
• Αυτόματοι φίλτροι
• Επιλογή
• Και άλλα

Αυτές οι βελτιώσεις επιτρέπουν πιο πλούσιες αλληλεπιδράσεις και εμπειρίες επεξεργασίας. Για μια λεπτομερή ανάλυση των εντολών, συμβουλευτείτε το αρχείο καταγραφής αλλαγών του Office API.

Ενημερώσεις Plugins API

Αρκετές νέες μέθοδοι και ιδιότητες επεκτείνουν τις δυνατότητες των προσθηκών:

• Ανάκτηση περιεχομένου

Η μέθοδος GetSelectedContent ανακτά το επιλεγμένο περιεχόμενο σε μια καθορισμένη μορφή.

expression.GetSelectedContent(prop);

• Μηνύματα σφάλματος

Η μέθοδος ShowError επιτρέπει στις προσθήκες να εμφανίζουν μηνύματα σφάλματος ή προειδοποιήσεων.

expression.ShowError(error, level);

• Βελτιωμένες ιδιότητες Στοιχείων Ελέγχου Περιεχομένου

Οι νέες ιδιότητες Shd (σκίαση φόντου) και Border ενισχύουν το αντικείμενο ContentControlProperties για καλύτερη οπτική προσαρμογή.

• Ενεργοποίηση πίνακα

Η παράμετρος isActivated σας επιτρέπει να καθορίσετε εάν ένας δημιουργημένος πίνακας προσθήκης είναι αναπτυγμένος (true) ή συμπτυγμένος (false) κατά τη φόρτωση.

Ελέγξτε την πλήρη λίστα των ενημερώσεων του plugin API.