Excel JavaScript object model di componenti aggiuntivi di Office

• 09/03/2020
• 4 minuti a leggere
• • o
  • R
  • Un
  • l
  • m
  • +4

in Questo articolo viene descritto come utilizzare microsoft Excel JavaScript API per la creazione di add-in per Excel 2016 o poi. Introduce concetti fondamentali che sono fondamentali per l’utilizzo dell’API e fornisce indicazioni per l’esecuzione di attività specifiche come la lettura o la scrittura su un ampio intervallo, l’aggiornamento di tutte le celle nell’intervallo e altro ancora.

Ufficio.API js per Excel

Un componente aggiuntivo di Excel interagisce con gli oggetti in Excel utilizzando l’API JavaScript di Office, che include due modelli di oggetti JavaScript:

• API JavaScript di Excel: introdotta con Office 2016, l’API JavaScript di Excel fornisce oggetti fortemente tipizzati che è possibile utilizzare per accedere a fogli di lavoro, intervalli, tabelle, grafici e altro ancora.

• API comuni: introdotta con Office 2013, l’API comune può essere utilizzata per accedere a funzionalità quali interfaccia utente, finestre di dialogo e impostazioni client comuni a più tipi di applicazioni Office.

Mentre probabilmente utilizzerai l’API JavaScript di Excel per sviluppare la maggior parte delle funzionalità nei componenti aggiuntivi destinati a Excel 2016 o versioni successive, utilizzerai anche gli oggetti nell’API comune. Ad esempio:

• Contesto: l’oggetto Context rappresenta l’ambiente di runtime del componente aggiuntivo e fornisce l’accesso agli oggetti chiave dell’API. È costituito da dettagli di configurazione della cartella di lavoro come contentLanguage e officeTheme e fornisce anche informazioni sull’ambiente di runtime del componente aggiuntivo come hoste platform. Inoltre, fornisce il metodo requirements.isSetSupported(), che è possibile utilizzare per verificare se il set di requisiti specificato è supportato dall’applicazione Excel in cui è in esecuzione il componente aggiuntivo.
• Documento: L’oggetto Document fornisce il metodo getFileAsync(), che è possibile utilizzare per scaricare il file Excel in cui è in esecuzione il componente aggiuntivo.

L’immagine seguente illustra quando è possibile utilizzare l’API JavaScript di Excel o le API comuni.

Modello a oggetti specifico di Excel

Per comprendere le API di Excel, è necessario comprendere in che modo i componenti di una cartella di lavoro sono correlati tra loro.

• Una cartella di lavoro contiene uno o più fogli di lavoro.
• Un foglio di lavoro contiene raccolte di oggetti dati presenti nel singolo foglio e consente l’accesso alle celle tramite oggetti Intervallo.
• Un intervallo rappresenta un gruppo di celle contigue.
• Gli intervalli vengono utilizzati per creare e posizionare tabelle, grafici, forme e altri oggetti di visualizzazione o organizzazione dei dati.
• Le cartelle di lavoro contengono raccolte di alcuni di questi oggetti dati (come le tabelle) per l’intera cartella di lavoro.

Intervalli

Un intervallo è un gruppo di celle contigue nella cartella di lavoro. B3 per la singola cella nella colonna B e nella riga 3 o C2: F4 per le celle dalle colonne C a F e dalle righe da 2 a 4) per definire gli intervalli.

Gli intervalli hanno tre proprietà principali: values, formulas e format. Queste proprietà ottengono o impostano i valori delle celle, le formule da valutare e la formattazione visiva delle celle.

Campione intervallo

Il seguente esempio mostra come creare record di vendita. Questa funzione utilizza Range oggetti per impostare i valori, formule e formati.

Questo esempio crea i seguenti dati nel foglio di lavoro corrente:

Per ulteriori informazioni, vedere Lavorare con gli intervalli utilizzando l’API JavaScript di Excel.

Grafici, tabelle e altri oggetti dati

Le API JavaScript di Excel possono creare e manipolare le strutture dati e le visualizzazioni in Excel. Tabelle e grafici sono due degli oggetti più comunemente utilizzati, ma le API supportano tabelle pivot, forme, immagini e altro ancora.

Creazione di una tabella

Creazione di tabelle utilizzando intervalli pieni di dati. I controlli di formattazione e tabella (come i filtri) vengono applicati automaticamente all’intervallo.

Il seguente esempio crea una tabella utilizzando gli intervalli dell’esempio precedente.

L’utilizzo di questo codice di esempio nel foglio di lavoro con i dati precedenti crea la seguente tabella:

Per ulteriori informazioni, vedere Utilizzo delle tabelle utilizzando l’API JavaScript di Excel.

Creazione di un grafico

Creazione di grafici per visualizzare i dati in un intervallo. Le API supportano decine di varietà di grafici, ognuno dei quali può essere personalizzato in base alle proprie esigenze.

Il seguente esempio crea un semplice istogramma per tre elementi e lo posiziona 100 pixel sotto la parte superiore del foglio di lavoro.

L’esecuzione di questo esempio sul foglio di lavoro con la tabella precedente crea il seguente grafico:

Per ulteriori informazioni, vedere Utilizzo dei grafici utilizzando l’API JavaScript di Excel.

Vedi anche