Az ONLYOFFICE 9.4-es verziója jelentős frissítéseket hoz az API-jában, javítva az integrációs lehetőségeket, a testreszabott bővítményeket és a táblázatkezelő automatizálást. A legfontosabb fejlesztések közé tartozik a horvát nyelv támogatása, a szerepkör-tudatos űrlapkitöltéshez szükséges eseményparaméterek javítása, új kurzorvezérlési módszerek, valamint a Office JavaScript API kibővített funkciói, amelyek megkönnyítik a fejlesztők számára a hatékonyabb és lokalizált alkalmazások létrehozását.

• Hozzáadták a horvát nyelv támogatását a lokalizált alkalmazásokhoz.
• Az onStartFilling esemény új szerepkör-paramétere javítja az űrlapkitöltést.
• A bővítményparancsok naplózása egyszerűsíti a fejlesztők számára a hibakeresést.
• Bevezették a dokumentumok egyesítésének képességét az automatizálási forgatókönyvekhez.

Az ONLYOFFICE 9.4-es verziója jelentős API-fejlesztéseket hoz az integrációk, a testreszabott bővítmények és a táblázatkezelő automatizálás terén. Ez a cikk kiemeli a legfontosabb frissítéseket az ONLYOFFICE Docs API, a Plugins és Macros API, valamint az Office JavaScript API területén, és elmagyarázza, mit jelentenek ezek a fejlesztők számára.

ONLYOFFICE Docs API 9.4

Horvát nyelv támogatása

A horvát (

hr

) felkerült a támogatott felhasználói felület nyelvek listájára. Ha horvátul beszélő felhasználók számára készít lokalizált alkalmazásokat, akkor ezt közvetlenül beillesztheti a nyelvi konfigurációjába, anélkül, hogy kerülőutakat kellene alkalmaznia.

Szerepkör és felhasználói adatok az onStartFilling eseményben

Az onStartFilling esemény mostantól tartalmaz egy

roles

paramétert, amely a szerepkör- és felhasználói információkat hordozza. Ez jelentősen megkönnyíti a szerepkör-tudatos űrlapkitöltési élmények kialakítását, például a felhasználók irányítását a felelősségi körükbe tartozó mezőkhöz, vagy a feltételes logika aktiválását attól függően, hogy ki tölti ki az űrlapot és milyen minőségben.

function onStartFilling(event) {
const roles = event.data;
console.log("Szerepkörök:", roles);
}

const config = {
// ...
events: {
onStartFilling,
},
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

Memóriaszivárgás javítása a destroyEditor-ben

A destroyEditor metódusban egy memóriaszivárgást javítottak. Korábban a

destroyEditor

hívása nem tisztította meg teljesen az allokált erőforrásokat. Ha az alkalmazása gyakran hoz létre és töröl szerkesztő példányokat, például egyoldalas alkalmazásokban vagy dokumentumelőnézeti munkafolyamatokban, ez a javítás közvetlenül javítja az integráció memóriahasználatát az idő múlásával.

Eltávolított mező

A

editorConfig.customization.commentAuthorOnly

elavult mezőt eltávolították. Ha az integrációja még mindig hivatkozik erre a paraméterre, itt az ideje eltávolítani, hogy elkerülje a váratlan viselkedést.

Bővítményparancsok naplózása a könnyebb hibakeresés érdekében

A bővítményfejlesztők számára az egyik legpraktikusabb újdonság a bővítményparancsok naplózása. Engedélyezheti a bővítményparancsok közvetlen naplózását a böngésző konzoljában. Ha időt töltött a bővítmény viselkedésének hibakeresésével azzal, hogy kitalálta, mely parancsok aktiválódnak, ez a funkció jelentősen csökkenti ezt a nehézséget. Közvetlen rálátást biztosít a bővítmény végrehajtási folyamatára anélkül, hogy saját naplózást kellene beépítenie.

Specifikus bővítmények betöltésének blokkolása

Az új editorConfig.plugins.disable paraméter lehetővé teszi, hogy megakadályozza bizonyos bővítmények betöltését a szerkesztő inicializálásakor. Ez hasznos, ha a szerkesztőt egy ellenőrzött környezetben ágyazza be, és szeretné korlátozni a funkciókat a felhasználói igényeknek megfelelően, anélkül, hogy módosítania kellene a bővítményfájlokat. Ez egy tisztább, konfigurációs szintű megközelítést kínál a bővítmények kezelésére.

ONLYOFFICE Bővítmények és Makrók API 9.4

Új kurzorvezérlési módszerek

Két új módszert adtak hozzá a

window.Asc.plugin.executeMethod

metódushoz a Dokumentum API-ban:

• MoveCursorToField: a kurzort egy adott űrlapmezőre helyezi;
• MoveCursorOutsideField: a kurzort a jelenlegi mezőn kívüli pozícióra helyezi.

Asc.plugin.executeMethod("MoveCursorToField", [fieldId, true]);

Asc.plugin.executeMethod("MoveCursorOutsideField", [fieldId, false]);

Ezek különösen hasznosak olyan bővítmények számára, amelyek útmutatást adnak a felhasználóknak az űrlap kitöltésében vagy automatizálják a mezők közötti navigációt dokumentumokban. Ahelyett, hogy a felhasználói interakcióra támaszkodna a mezők közötti előrehaladáshoz, a bővítménye programozottan irányíthatja a kurzor elhelyezését.

Fejlettebb StartAction és EndAction vezérlés

A StartAction metódus két új paramétert fogad el:

lockScroll

és

keepSelection

. Az EndAction metódus a

scrollToTarget

és

cancel

paramétereket kapja. Ezek együtt finomabb vezérlést biztosítanak a bővítmények számára a szerkesztő állapotának kezelésében a makró végrehajtása során. Megtarthatja a felhasználó kiválasztását, megakadályozhatja a nem kívánt görgetést automatizált műveletek során, vagy tisztán törölheti egy akciósorozatot — mindez hozzájárul a stabilabb és kiszámíthatóbb bővítményélményhez.

Office JavaScript API 9.4

Ez a 9.4-es kiadás legszélesebb része. Az Office JavaScript API új képességeket kap a dokumentum műveletek, táblázatkezelési adatok, űrlapvezérlők és egyebek terén. Nézze meg az új módszerek teljes listáját

Dokumentumok egyesítése

Új

Api/MergeDocuments

metódust adtak hozzá a Dokumentum API-hoz. Ez lehetővé teszi több dokumentum egyesítését egyetlen dokumentummá — ez egy gyakori kérés az automatizálási forgatókönyvekben, mint például jelentéskészítés, szerződés összeállítás és tömeges dokumentumfeldolgozás.

Egységes Szín API minden szerkesztő számára

A

Api/Color

metódus elérhető a Dokumentum, Táblázatkezelő, Prezentáció és PDF API-kban. Az egységes színfelület minden négy szerkesztő típushoz egyszerűsíti a kódot, amelynek stílusokat kell alkalmaznia különböző dokumentumformátumokban. Már nem szükséges formátum-specifikus színkezelési logikát alkalmazni a gyakori műveletekhez.

Aláírási űrlap támogatás

A 9.4-es verzió bevezeti az

ApiSignatureForm

osztályt, amely elérhető a Dokumentum API-ban és az Űrlap API-ban. Ezzel együtt érkezik a

GetValue

és

SetValue

metódus az aláírási mező adatok olvasására és írására. Ez lehetővé teszi az aláírási mezők programozott kezelését, ami hasznos olyan munkafolyamatokhoz, amelyek előre kitöltést, érvényesítést vagy aláírási adatok kinyerését igénylik egy nagyobb dokumentumfeldolgozási folyamat részeként.