Excel JavaScript object model în Office Add-ins

• 09/03/2020
• 4 minute de citit
• • o
  • R
  • A
  • l
  • m
  • +4

acest articol descrie modul de utilizare a Excel JavaScript API pentru a construi programe de completare pentru Excel 2016 sau o versiune ulterioară. Acesta introduce concepte de bază care sunt fundamentale pentru utilizarea API și oferă îndrumări pentru îndeplinirea sarcinilor specifice, cum ar fi citirea sau scrierea într-o gamă largă, actualizarea tuturor celulelor din gamă și multe altele.

birou.API-uri js pentru Excel

un program de completare Excel interacționează cu obiectele din Excel utilizând API-ul JavaScript Office, care include două modele de obiecte JavaScript:

• Excel JavaScript API: introdus cu Office 2016, Excel JavaScript API oferă obiecte puternic tastate pe care le puteți utiliza pentru a accesa foi de lucru, intervale, tabele, diagrame și multe altele.

• API-uri comune: introdus cu Office 2013, API-ul comun poate fi utilizat pentru a accesa caracteristici precum UI, dialoguri și setări client care sunt comune în mai multe tipuri de aplicații Office.

deși probabil veți utiliza API-ul JavaScript Excel pentru a dezvolta majoritatea funcționalităților din programele de completare care vizează Excel 2016 sau versiuni ulterioare, veți utiliza, de asemenea, obiecte în API-ul comun. De exemplu:

• Context: obiectul Context reprezintă mediul de rulare al programului de completare și oferă acces la obiectele cheie ale API-ului. Se compune din detalii de configurare registru de lucru, cum ar fi contentLanguage și officeTheme și oferă, de asemenea, informații despre mediul de rulare add-in, cum ar fi host și platform. În plus, oferă metoda requirements.isSetSupported(), pe care o puteți utiliza pentru a verifica dacă setul de cerințe specificat este acceptat de aplicația Excel în care rulează programul de completare.
• Document: obiectul Document furnizează metoda getFileAsync(), pe care o puteți utiliza pentru a descărca fișierul Excel în care se execută programul de completare.

următoarea imagine ilustrează când puteți utiliza Excel JavaScript API sau API-urile comune.

model de obiect specific Excel

pentru a înțelege API-urile Excel, trebuie să înțelegeți modul în care componentele unui registru de lucru sunt legate între ele.

• un registru de lucru conține una sau mai multe foi de lucru.
• o foaie de lucru conține colecții ale acelor obiecte de date care sunt prezente în foaia individuală și oferă acces la celule prin obiecte de gamă.
• un interval reprezintă un grup de celule contigue.
• intervalele sunt utilizate pentru a crea și plasa tabele, diagrame, forme și alte obiecte de vizualizare sau organizare a datelor.
• registrele de lucru conțin colecții ale unora dintre aceste obiecte de date (cum ar fi tabele) pentru întregul registru de lucru.

intervale

un interval este un grup de celule contigue din registrul de lucru. Add-in-urile folosesc de obicei notație în stil a1 (de exemplu, B3 pentru celula unică din coloana B și rândul 3 sau C2:F4 pentru celulele din coloanele C până la F și rândurile 2 până la 4) pentru a defini intervale.

intervalele au trei proprietăți de bază: values, formulasși format. Aceste proprietăți obțin sau setează valorile celulei, formulele care trebuie evaluate și formatarea vizuală a celulelor.

eșantion de gamă

următorul eșantion arată cum să creați înregistrări de vânzări. Această funcție utilizează obiecte Range pentru a seta valorile, formulele și formatele.

acest eșantion creează următoarele date în foaia de lucru curentă:

pentru mai multe informații, consultați Lucrul cu intervale utilizând API-ul JavaScript Excel.

diagrame, tabele și alte obiecte de date

API-urile JavaScript Excel pot crea și manipula structurile de date și vizualizările din Excel. Tabelele și diagramele sunt două dintre obiectele mai frecvent utilizate, dar API-urile acceptă tabele pivotante, forme, imagini și multe altele.

crearea unui tabel

crearea tabelelor utilizând intervale pline de date. Formatarea și controalele tabelului (cum ar fi filtrele) sunt aplicate automat intervalului.

următorul eșantion creează un tabel folosind intervalele din eșantionul anterior.

utilizarea acestui exemplu de cod în foaia de lucru cu datele anterioare creează următorul tabel:

pentru mai multe informații, consultați Lucrul cu tabelele utilizând API-ul JavaScript Excel.

crearea unei diagrame

creați diagrame pentru a vizualiza datele dintr-un interval. API-urile acceptă zeci de soiuri de diagrame, fiecare dintre acestea putând fi personalizate pentru a se potrivi nevoilor dvs.

următorul eșantion creează o diagramă coloană simplă pentru trei elemente și o plasează cu 100 de pixeli sub partea de sus a foii de lucru.

rularea acestui eșantion pe foaia de lucru cu tabelul anterior creează următoarea diagramă:

pentru mai multe informații, consultați Lucrul cu diagrame utilizând API-ul Excel JavaScript.

a se vedea, de asemenea,