JavaScript-objektmodel i Office-tilføjelsesprogrammer

• 09/03/2020
• 4 minutter at læse
• • o
  • R
  • a
  • l
  • m
  • +4

denne artikel beskriver, hvordan du bruger JavaScript API til at oprette tilføjelsesprogrammer til 2016 eller nyere. Det introducerer kernekoncepter, der er grundlæggende for at bruge API ‘ en og giver vejledning til at udføre specifikke opgaver såsom læsning eller skrivning til et stort interval, opdatering af alle celler inden for rækkevidde og mere.

Kontor.js API ‘ er

et tilføjelsesprogram interagerer med objekter ved hjælp af Office JavaScript API, som indeholder to JavaScript-objektmodeller:

• JavaScript API: introduceret med Office 2016 indeholder JavaScript API stærkt indtastede objekter, som du kan bruge til at få adgang til regneark, intervaller, tabeller, diagrammer og meget mere.

• fælles API’ er: introduceret med Office 2013 kan den fælles API bruges til at få adgang til funktioner som brugergrænseflade, dialoger og klientindstillinger, der er almindelige på tværs af flere typer Office-applikationer.

mens du sandsynligvis bruger JavaScript API til at udvikle størstedelen af funktionaliteten i tilføjelsesprogrammer, der er målrettet mod 2016 eller nyere, bruger du også objekter i den fælles API. For eksempel:

• kontekst: objektet Context repræsenterer runtime-miljøet i tilføjelsesprogrammet og giver adgang til nøgleobjekter i API ‘ en. Den består af projektmappekonfigurationsoplysninger som contentLanguage og officeTheme og indeholder også oplysninger om tilføjelsens runtime-miljø som hostog platform. Derudover giver den requirements.isSetSupported()-metoden, som du kan bruge til at kontrollere, om det angivne kravsæt understøttes af det program, hvor tilføjelsesprogrammet kører.
• dokument: objektet Document indeholder metoden getFileAsync(), som du kan bruge til at hente den fil, hvor tilføjelsesprogrammet kører.

følgende billede illustrerer, hvornår du kan bruge JavaScript API eller de almindelige API ‘ er.

objektmodel

for at forstå API ‘ erne skal du forstå, hvordan komponenterne i en projektmappe er relateret til hinanden.

• en projektmappe indeholder et eller flere regneark.
• et regneark indeholder samlinger af de dataobjekter, der findes i det enkelte ark, og giver adgang til celler gennem områdeobjekter.
• et område repræsenterer en gruppe sammenhængende celler.
• intervaller bruges til at oprette og placere tabeller, diagrammer, figurer og andre datavisualiserings-eller organisationsobjekter.
• projektmapper indeholder samlinger af nogle af disse dataobjekter (f.eks. tabeller) for hele projektmappen.

intervaller

et område er en gruppe af sammenhængende celler i projektmappen. Tilføjelsesprogrammer bruger typisk A1-stil notation (f.eks. B3 for enkeltcellen i kolonne B og række 3 eller C2:F4 for cellerne fra kolonne C til F og rækker 2 til 4) for at definere intervaller.

intervaller har tre kerneegenskaber: values, formulasog format. Disse egenskaber får eller indstiller celleværdier, formler, der skal evalueres, og den visuelle formatering af cellerne.

Områdeprøve

følgende prøve viser, hvordan du opretter salgsposter. Denne funktion bruger Range objekter til at indstille værdier, formler og formater.

denne prøve opretter følgende data i det aktuelle regneark:

du kan finde flere oplysninger i arbejde med intervaller ved hjælp af JavaScript API.

diagrammer, tabeller og andre dataobjekter

JavaScript-API ‘ erne kan oprette og manipulere datastrukturer og visualiseringer. Tabeller og diagrammer er to af de mere almindeligt anvendte objekter, men API ‘ erne understøtter pivottabeller, figurer, billeder og meget mere.

oprettelse af en tabel

Opret tabeller ved hjælp af datafyldte intervaller. Formatering og tabelkontroller (f.eks. filtre) anvendes automatisk på området.

følgende prøve opretter en tabel ved hjælp af intervallerne fra den foregående prøve.

brug af denne prøvekode på regnearket med de tidligere data opretter følgende tabel:

du kan finde flere oplysninger i arbejde med tabeller ved hjælp af JavaScript API.

oprettelse af et diagram

Opret diagrammer for at visualisere dataene i et interval. API ‘ erne understøtter snesevis af diagramvarianter, som hver kan tilpasses til dine behov.

følgende prøve opretter et simpelt kolonnediagram for tre elementer og placerer det 100 billedpunkter under toppen af regnearket.

hvis du kører denne prøve på regnearket med den forrige tabel, oprettes følgende diagram:

du kan finde flere oplysninger i arbejde med diagrammer ved hjælp af JavaScript API.

Se også