ONLYOFFICE 10.0 για προγραμματιστές: Τι νέο υπάρχει

Το ONLYOFFICE 10.0 φέρνει ένα σταθερό σύνολο ενημερώσεων για προγραμματιστές που χτίζουν πάνω από τους editors. Λαμβάνετε νέα endpoints που κάνουν πιο εύκολη τη διαχείριση αρχείων, την επεξεργασία PDF στο Document Builder και ένα εκσυγχρονισμένο API προσθηκών με ασύγχρονες μεθόδους. Η έκδοση προσθέτει επίσης νέα στοιχεία ελέγχου για λειτουργίες AI και ασφαλέστερες προεπιλογές σε ολόκληρο τον διακομιστή.

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

Εργαλεία AI, επιλογές προσαρμογής AI & διαχείριση AI από την πλευρά του διακομιστή

Το ONLYOFFICE Docs 10.0 φέρνει τα AI Tools σε κάθε επεξεργαστή. Περισσότερα από απλή παραγωγή κειμένου, κατανοούν τη δομή του εγγράφου, αναγνωρίζουν στοιχεία, συνδέουν περιεχόμενο μεταξύ ενοτήτων και δημιουργούν συνδέσμους με δυνατότητα κλικ για ευκολότερη πλοήγηση. Μπορείτε να συνδέσετε οποιοδήποτε μοντέλο AI, συμπεριλαμβανομένων τοπικών μοντέλων για περιπτώσεις χρήσης με ευαισθησία στην ιδιωτικότητα, και να αναθέσετε διαφορετικά μοντέλα σε διαφορετικές εργασίες.

Στις εμπορικές εκδόσεις του ONLYOFFICE Docs 10.0, οι διαχειριστές μπορούν να ρυθμίσουν παρόχους AI μία φορά στο Admin Panel. Μόλις γίνει η ρύθμιση, οι χρήστες των επεξεργαστών αποκτούν έτοιμα προς χρήση εργαλεία AI χωρίς να χρειάζεται να εισαγάγουν τα δικά τους API keys. Οι διαχειριστές μπορούν να αναθέτουν διαφορετικά μοντέλα σε συγκεκριμένες εργασίες, να συνδέουν MCP servers για πρόσβαση σε εξωτερικά εργαλεία και να ελέγχουν αν είναι διαθέσιμη η αναζήτηση στον ιστό. Μόλις αποθηκευτεί μια διαμόρφωση από την πλευρά του διακομιστή, οι χρήστες περιορίζονται στους εγκεκριμένους παρόχους και μοντέλα – δεν μπορούν πλέον να προσθέτουν τα δικά τους κλειδιά ή να αλλάζουν το μοντέλο που χρησιμοποιείται. Μάθετε περισσότερα

Εσείς αποφασίζετε αν τα εργαλεία AI θα εμφανίζονται στο προϊόν σας. Η έκδοση 10.0 σάς δίνει δύο επίπεδα ελέγχου:

• Ανά παρουσία επεξεργαστή: Χρησιμοποιήστε το editorConfig.customization.ai με την παράμετρο disabled για να αποκρύψετε τις λειτουργίες AI σε μια συγκεκριμένη διαμόρφωση επεξεργαστή.
• Σε επίπεδο διακομιστή: Χρησιμοποιήστε τη ρύθμιση διακομιστή aiSettings.enable για να απενεργοποιήσετε τις λειτουργίες AI και να εξαιρέσετε τα AI Tools από το /plugins.json.

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

Αρθρωτές εφαρμογές

Το ONLYOFFICE Docs 10.0 εισάγει τις αρθρωτές εφαρμογές – έναν νέο τρόπο επέκτασης των επεξεργαστών χωρίς αλλαγή του πυρήνα τους. Εφαρμογές όπως AI agents, Forms, Rooms και Files συνδέονται με το ONLYOFFICE Docs και προσθέτουν νέα λειτουργικότητα από πάνω.

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

Βελτιώσεις ασφάλειας και αρχιτεκτονικής

Η έκδοση 10.0 μεταφέρει αρκετές προστασίες στο «ενεργές από προεπιλογή», ώστε οι νέες ενσωματώσεις να ξεκινούν από ασφαλέστερη βάση.

• JWT ενεργό από προεπιλογή. Το JWT είναι πλέον ενεργό στο default.json.
• Αυστηρότερος χειρισμός token. Αν ένα secret είναι κενό ή δεν έχει οριστεί, συμπεριλαμβανομένων των tenant secrets, το ONLYOFFICE Docs πλέον απορρίπτει το token αντί να το επαληθεύει ή να το υπογράφει.
• Tokens με περιορισμένο πεδίο για API υπηρεσιών. Τα /converter, /docbuilder και /command δεν δέχονται πλέον token από τη διαμόρφωση του επεξεργαστή. Ένα νέο πεδίο operation στο token είναι προαιρετικό για αυτά τα αιτήματα και απαιτείται για τα /converter/from-file και /docbuilder/from-file.
• Επαλήθευση ακεραιότητας για ληφθέντα αρχεία. Όταν η ενσωμάτωσή σας στέλνει headers ακεραιότητας, ο διακομιστής ελέγχει τα ληφθέντα αρχεία με βάση αυτά. Υποστηριζόμενα headers περιλαμβάνουν Content-Digest, Repr-Digest, x-amz-checksum-* και WOPI SHA256. Αυτό ελέγχεται από το services.CoAuthoring.requestDefaults.checksumVerification, το οποίο είναι true από προεπιλογή.
• Ρητοί WOPI hosts. Οι WOPI hosts πρέπει πλέον να επιτρέπονται από κανόνα φίλτρου IP. Ο κανόνας μπαλαντέρ allow: * δεν αρκεί πλέον, οπότε καθορίστε κάθε host ρητά.
• Έλεγχοι πρόσβασης API. Χρησιμοποιήστε τα services.CoAuthoring.server.convertServiceEnable και services.CoAuthoring.server.docbuilderEnable για να απενεργοποιήσετε τα δημόσια API μετατροπής και Document Builder. Και τα δύο είναι true από προεπιλογή.
• Αυστηρότερη διαμόρφωση runtime. Μόνο το επίπεδο καταγραφής log4js μπορεί πλέον να αλλάξει μέσω runtime.json.

Μια πιο προσεκτική ματιά στις τελευταίες διορθώσεις ασφάλειας

Επεξεργασία PDF στο Document Builder

Το Document Builder μπορεί πλέον να επεξεργάζεται PDF, κάτι που ανοίγει τον δρόμο για πολλά νέα σενάρια αυτοματισμού:

• OpenFile χειρίζεται έξυπνα τα PDF. Οι φόρμες PDF που δημιουργήθηκαν στο ONLYOFFICE ανοίγουν στον επεξεργαστή εγγράφων. Τα άλλα PDF ανοίγουν στον επεξεργαστή PDF με πλήρη πρόσβαση στο PDF API.
• PDF με προστασία κωδικού. Η νέα παράμετρος m_sPassword στο OpenFile σάς επιτρέπει να ανοίγετε προστατευμένα αρχεία.
• Δημιουργία φόρμας PDF. Καλέστε το CreateFile με τον τύπο pdf για να δημιουργήσετε φόρμες PDF.

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

Alexander Trofimov, Επικεφαλής της Ομάδας Ανάπτυξης Επεξεργαστή στο ONLYOFFICE:

Με το ONLYOFFICE Docs 10.0, κάναμε τους επεξεργαστές ακόμη πιο ασφαλείς για τις ενσωματώσεις σας. Επιπλέον, αυτή η έκδοση φέρνει πλήρη υποστήριξη PDF στο Document Builder, ώστε τόσο οι προγραμματιστές όσο και οι τελικοί χρήστες να μπορούν να δημιουργούν, να επεξεργάζονται και να διαχειρίζονται PDF απευθείας από το Builder χωρίς να βασίζονται σε λύσεις παράκαμψης ή εργαλεία τρίτων.

Ενημερώσεις ανάπτυξης και διαχείρισης

Η εκτέλεση του ONLYOFFICE Docs σε παραγωγή έγινε επίσης ευκολότερη:

• Το Admin Panel ξεκινά με τον διακομιστή. Στις εμπορικές εκδόσεις, το Admin Panel εκκινεί πλέον αυτόματα από προεπιλογή. Περιλαμβάνει επίσης ενότητες για προβολή του JWT secret και κουμπιά για άνοιγμα και εκκίνηση ή διακοπή του δοκιμαστικού παραδείγματος.
• Δημιουργία διαχειριστή μέσω CLI. Πλέον δημιουργείτε τον πρώτο διαχειριστή μέσω του CLI host documentserver-admin, χρησιμοποιώντας create-admin και reset-admin-password. Αυτό αντικαθιστά την παλιά ιστοσελίδα που βασιζόταν σε bootstrap logs.
• Αυτόματη ανάκτηση μη αποθηκευμένων αλλαγών. Αν ο διακομιστής τερματιστεί, οι μη αποθηκευμένες αλλαγές ανακτώνται αυτόματα σε «forgotten files». Το ξεχωριστό script changes2forgotten έχει αφαιρεθεί.
• Νέα προεπιλεγμένη θύρα. Οι εγκαταστάσεις DEB και RPM χρησιμοποιούν πλέον τη θύρα 8083 από προεπιλογή. Ενημερώστε τους κανόνες proxy και firewall αν χρειάζεται.
• Καλύτερη παρακολούθηση. Το νέο metric coauth.connections περιλαμβάνει ετικέτες mode (edit, liveview, view) και replica.
• Σημαία ενημέρωσης Desktop. Στα Windows, η σημαία γραμμής εντολών --prefer-alternate-url επιτρέπει στους Desktop Editors να κατεβάζουν ενημερώσεις από εναλλακτική πηγή.
• Ανανεωμένη σελίδα υποδοχής. Η σελίδα υποδοχής του διακομιστή έχει νέο σχεδιασμό.

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

Η έκδοση 10.0 προσθέτει δύο ενημερώσεις μορφών που σάς βοηθούν να χειρίζεστε περισσότερα έγγραφα με λιγότερη προσαρμοσμένη εργασία:

• Προβολή και μετατροπή OFD. Μπορείτε να ανοίξετε και να μετατρέψετε αρχεία ofd. Όπως τα xps, ανοίγουν σε λειτουργία μόνο προβολής.
• Μετατροπή σε XLS. Μπορείτε να μετατρέψετε οποιαδήποτε μορφή υπολογιστικού φύλλου στην κλασική μορφή xls. Αυτό είναι χρήσιμο όταν οι χρήστες ή οι συνεργάτες σας εξαρτώνται ακόμη από παλιά συστήματα.

Multipart endpoints για άμεση μεταφόρτωση αρχείων

Μέχρι τώρα, οι υπηρεσίες μετατροπής και Document Builder κατέβαζαν τα αρχεία προέλευσης από ένα URL. Αυτό σήμαινε ότι έπρεπε να φιλοξενήσετε το αρχείο κάπου όπου ο διακομιστής μπορούσε να το προσεγγίσει. Η έκδοση 10.0 προσθέτει δύο νέα endpoints που αφαιρούν αυτό το βήμα:

• POST /converter/from-file
• POST /docbuilder/from-file

Και τα δύο δέχονται δεδομένα σε μορφή multipart/form-data. Μπορείτε να στείλετε ένα αρχείο ή ένα script απευθείας στο αίτημα, ώστε να μην χρειάζεται να το εκθέσετε μέσω προσωρινού URL.

Αυτή είναι μια καθαρότερη επιλογή για πολλές ροές εργασίας. Για παράδειγμα, μια υπηρεσία backend μπορεί να μετατρέπει τις μεταφορτώσεις χρηστών άμεσα ή να εκτελεί ένα script Document Builder χωρίς να αποθηκεύει πρώτα τα αρχεία σε ενδιάμεσο χώρο.

Παράδειγμα αιτήματος: μετατροπή TXT σε DOCX

curl -f -X POST "https://documentserver/converter/from-file" \
  -F 'params={"filetype":"txt","outputtype":"docx","title":"Example Document Title.txt"}' \
  -F 'file=@example.txt' \
  -o "Example Document Title.docx"

Εκσυγχρονισμός Plugin API

Το Plugins and Macros API δέχτηκε τη μεγαλύτερη ανανέωσή του εδώ και καιρό.

Ένα νέο καθολικό αντικείμενο Editor

Οι μέθοδοι καλούνται πλέον ως κανονικές συναρτήσεις που επιστρέφουν ένα Promise. Αντί να δρομολογείτε κάθε κλήση μέσω window.Asc.plugin.executeMethod, μπορείτε να γράφετε καθαρό async κώδικα:

const text = await Editor.GetSelectedText();

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

Νέες μέθοδοι και συμβάντα

Η έκδοση 10.0 προσθέτει επίσης νέα εργαλεία για τη δημιουργία πλουσιότερων plugins:

• Μέθοδοι: Editor.RunMacro, GetRestrictions, SetButtonDisabled, GetOFormRole
• Συμβάντα: onFloatActionButtonClick, onSelectionEnd, onSelectionCancel

Για παράδειγμα, τα συμβάντα επιλογής επιτρέπουν στο plugin σας να αντιδρά τη στιγμή που ο χρήστης ολοκληρώνει ή ακυρώνει μια επιλογή.

Δείτε την πλήρη λίστα αλλαγών για το Plugins API

Ξεκινήστε να δημιουργείτε με το ONLYOFFICE 10.0

Η έκδοση 10.0 σάς δίνει καθαρότερα API, περισσότερη δύναμη αυτοματισμού και ασφαλέστερες προεπιλογές. Ακολουθεί ένα γρήγορο πλάνο για να την αξιοποιήσετε στο έπακρο:

• Ελέγξτε τις αλλαγές συμπεριφοράς. Ελέγξτε τη χρήση token, τους κανόνες φίλτρου IP για WOPI και τη νέα προεπιλεγμένη θύρα.
• Ενημερώστε τα plugins σας. Μεταβείτε στο καθολικό αντικείμενο Editor και αντικαταστήστε τυχόν μετονομασμένες ή αφαιρεμένες μεθόδους.
• Δοκιμάστε τα νέα endpoints. Δοκιμάστε τα /converter/from-file και /docbuilder/from-file στις ροές εργασίας μετατροπής σας.
• Αποφασίστε για το AI. Διαμορφώστε το editorConfig.customization.ai ή το aiSettings.enable ώστε να ταιριάζει με τις ανάγκες του προϊόντος σας.

ΛΗΨΗ ΕΚΔΟΣΕΩΝ ΓΙΑ ΠΡΟΓΡΑΜΜΑΤΙΣΤΕΣ

Χρησιμοποιείτε την cloud έκδοση του ONLYOFFICE Docs; Δοκιμάστε το Docs Connect για ευκολότερο τρόπο σύνδεσης των επεξεργαστών με εξωτερικές πλατφόρμες και υπηρεσίες. Σε αντίθεση με την self-hosted έκδοση του ONLYOFFICE Docs, η οποία απαιτεί να αναπτύξετε και να συντηρήσετε τους επεξεργαστές στους δικούς σας διακομιστές, το Docs Connect αναλαμβάνει τη φιλοξενία, τη συντήρηση και τις τακτικές ενημερώσεις για εσάς.

Δείτε το πλήρες changelog για κάθε λεπτομέρεια και μοιραστείτε τα σχόλιά σας στο φόρουμ κοινότητας του ONLYOFFICE. Ανυπομονούμε να δούμε τι θα δημιουργήσετε!