Cách sử dụng API JavaScript của Excel

Tải xuống các khóa học và học mọi lúc, mọi nơi

Xem các khóa học trên thiết bị di động của bạn mà không cần kết nối internet. Tải xuống các khóa học bằng ứng dụng LinkedIn Learning trên iOS hoặc Android của bạn

Tìm hiểu các loại đối tượng chính trong API JavaScript của Excel và cách sử dụng chúng để xây dựng phần bổ trợ cho Excel

16/02/2022

vượt trội

cao

Bài viết này mô tả cách sử dụng API Excel JavaScript để xây dựng phần bổ trợ cho Excel 2016 trở lên. Nó giới thiệu các khái niệm cốt lõi cơ bản để sử dụng API và cung cấp hướng dẫn để thực hiện các tác vụ cụ thể như đọc hoặc ghi vào một phạm vi lớn, cập nhật tất cả các ô trong phạm vi, v.v.

[. QUAN TRỌNG] Xem Sử dụng mô hình API dành riêng cho ứng dụng để tìm hiểu về bản chất không đồng bộ của API Excel và cách chúng hoạt động với sổ làm việc

Văn phòng. js API cho Excel

Phần bổ trợ Excel tương tác với các đối tượng trong Excel bằng cách sử dụng API JavaScript của Office, bao gồm hai mô hình đối tượng JavaScript

• API JavaScript của Excel. Được giới thiệu với Office 2016, API JavaScript của Excel cung cấp các đối tượng được nhập mạnh mà bạn có thể sử dụng để truy cập trang tính, phạm vi, bảng, biểu đồ, v.v.

• API phổ biến. Được giới thiệu với Office 2013, Common API có thể được sử dụng để truy cập các tính năng như giao diện người dùng, hộp thoại và cài đặt máy khách phổ biến trên nhiều loại ứng dụng Office

Mặc dù bạn có thể sẽ sử dụng API JavaScript của Excel để phát triển phần lớn chức năng trong phần bổ trợ nhắm mục tiêu Excel 2016 trở lên, nhưng bạn cũng sẽ sử dụng các đối tượng trong API chung. Ví dụ

• Định nghĩa bài văn. Đối tượng Context đại diện cho môi trường thời gian chạy của phần bổ trợ và cung cấp quyền truy cập vào các đối tượng chính của API. Nó bao gồm các chi tiết cấu hình sổ làm việc, chẳng hạn như contentLanguage và officeTheme, đồng thời cung cấp thông tin về môi trường thời gian chạy của phần bổ trợ, chẳng hạn như host và platform. Ngoài ra, nó cung cấp phương pháp requirements.isSetSupported() mà bạn có thể sử dụng để kiểm tra xem bộ yêu cầu đã chỉ định có được hỗ trợ bởi ứng dụng Excel nơi phần bổ trợ đang chạy hay không
• Tài liệu. Đối tượng Document cung cấp phương thức await Excel.run(async (context) => { let sheet = context.workbook.worksheets.getActiveWorksheet(); sheet.tables.add("B2:E5", true); await context.sync(); });0 mà bạn có thể sử dụng để tải xuống tệp Excel nơi phần bổ trợ đang chạy

Hình ảnh sau đây minh họa khi bạn có thể sử dụng Excel JavaScript API hoặc Common APIs

Mô hình đối tượng dành riêng cho Excel

Để hiểu các API Excel, bạn phải hiểu các thành phần của sổ làm việc có liên quan với nhau như thế nào

• Một Workbook chứa một hoặc nhiều Worksheet
• Một Worksheet chứa các tập hợp các đối tượng dữ liệu có trong từng sheet riêng lẻ và cấp quyền truy cập vào các ô thông qua các đối tượng Range
• Một Range đại diện cho một nhóm các ô liền kề
• Phạm vi được sử dụng để tạo và đặt Bảng, Biểu đồ, Hình dạng và các đối tượng tổ chức hoặc trực quan hóa dữ liệu khác
• Sổ làm việc chứa các tập hợp của một số đối tượng dữ liệu đó (chẳng hạn như Bảng) cho toàn bộ Sổ làm việc

[. bao gồm lưu ý phạm vi và ô Excel]

Các dãy

Một phạm vi là một nhóm các ô liền kề trong sổ làm việc. Phần bổ trợ thường sử dụng ký hiệu kiểu A1 (e. g. B3 cho một ô trong cột B và hàng 3 hoặc C2. F4 cho các ô từ cột C đến F và hàng từ 2 đến 4) để xác định phạm vi

Phạm vi có ba thuộc tính cốt lõi. await Excel.run(async (context) => { let sheet = context.workbook.worksheets.getActiveWorksheet(); sheet.tables.add("B2:E5", true); await context.sync(); });1, await Excel.run(async (context) => { let sheet = context.workbook.worksheets.getActiveWorksheet(); sheet.tables.add("B2:E5", true); await context.sync(); });2 và await Excel.run(async (context) => { let sheet = context.workbook.worksheets.getActiveWorksheet(); sheet.tables.add("B2:E5", true); await context.sync(); });3. Các thuộc tính này nhận hoặc đặt giá trị ô, công thức sẽ được đánh giá và định dạng trực quan của ô

phạm vi mẫu

Mẫu sau đây cho biết cách tạo hồ sơ bán hàng. Hàm này sử dụng đối tượng await Excel.run(async (context) => { let sheet = context.workbook.worksheets.getActiveWorksheet(); sheet.tables.add("B2:E5", true); await context.sync(); });4 để đặt giá trị, công thức và định dạng

await Excel.run(async (context) => { let sheet = context.workbook.worksheets.getActiveWorksheet(); // Create the headers and format them to stand out. let headers = [ ["Product", "Quantity", "Unit Price", "Totals"] ]; let headerRange = sheet.getRange("B2:E2"); headerRange.values = headers; headerRange.format.fill.color = "#4472C4"; headerRange.format.font.color = "white"; // Create the product data rows. let productData = [ ["Almonds", 6, 7.5], ["Coffee", 20, 34.5], ["Chocolate", 10, 9.56], ]; let dataRange = sheet.getRange("B3:D5"); dataRange.values = productData; // Create the formulas to total the amounts sold. let totalFormulas = [ ["=C3 * D3"], ["=C4 * D4"], ["=C5 * D5"], ["=SUM(E3:E5)"] ]; let totalRange = sheet.getRange("E3:E6"); totalRange.formulas = totalFormulas; totalRange.format.font.bold = true; // Display the totals as US dollar amounts. totalRange.numberFormat = [["$0.00"]]; await context.sync(); });

Mẫu này tạo dữ liệu sau trong trang tính hiện tại

Để biết thêm thông tin, hãy xem Đặt và nhận giá trị phạm vi, văn bản hoặc công thức bằng cách sử dụng API Excel JavaScript

Biểu đồ, bảng và các đối tượng dữ liệu khác

API JavaScript của Excel có thể tạo và thao tác cấu trúc dữ liệu và trực quan hóa trong Excel. Bảng và biểu đồ là hai trong số các đối tượng được sử dụng phổ biến hơn nhưng API hỗ trợ PivotTable, hình dạng, hình ảnh, v.v.

Tạo bảng

Tạo bảng bằng cách sử dụng phạm vi chứa đầy dữ liệu. Định dạng và điều khiển bảng (chẳng hạn như bộ lọc) được tự động áp dụng cho phạm vi

Mẫu sau đây tạo một biểu đồ cột đơn giản cho ba mục và đặt nó 100 pixel bên dưới đầu trang tính

Làm cách nào để tích hợp Excel với JavaScript?

Tôi có thể sử dụng API với Excel không?

Tôi có thể chạy JavaScript trong Excel không?

Bạn có thể tự động hóa Excel bằng JavaScript không?