Bỏ qua, tới nội dung chính
BaoPeak

Điều hướng chính

Giới hạn nền tảng và điều kiện cần có của Office Scripts

Nguồn: https://learn.microsoft.com/en-us/office/dev/scripts/testing/platform-limits Tiêu đề gốc: Platform limits, requirements, and error messages for Office Scripts - Office Scripts | Microsoft Learn Ngôn ngữ gốc: tiếng Anh · Ngày tải: 2026-09-05 Phạm vi dịch: toàn văn trang ở tab "For business and education" (bản lưu ngày 2026-09-05 chỉ bắt được nội dung của tab này; phần riêng của tab "For personal and family" không có trong bản lưu); bỏ menu điều hướng, băng yêu cầu đăng nhập và khối góp ý cuối trang Link sau chuyển hướng khi tải: https://learn.microsoft.com/en-us/office/dev/scripts/testing/platform-limits?tabs=business

Tóm tắt 30 giây

Có một số giới hạn của nền tảng mà bạn nên biết khi viết Office Scripts. Bài này trình bày trình duyệt được hỗ trợ, giới hạn dữ liệu và thông báo lỗi có thể gặp khi dùng Office Scripts.

Nền tảng được hỗ trợ

Để dùng Office Scripts, bạn cần những thứ sau.

Ghi chú người dịch: trang gốc chia mục này thành hai tab: For business and education (cho doanh nghiệp và giáo dục) và For personal and family (cho cá nhân và gia đình). Nội dung dưới đây là của tab For business and education.

  1. Excel on the web, Excel for Windows (phiên bản 2210 trở lên), hoặc Excel for Mac.
  2. OneDrive for Business.
  3. Một trong các license thuê bao Microsoft 365 sau:
    • Office 365 Business
    • Office 365 Business Premium
    • Office 365 ProPlus
    • Office 365 ProPlus for Devices
    • Office 365 A3
    • Office 365 A5
    • Office 365 Enterprise E1
    • Office 365 Enterprise E3
    • Office 365 Enterprise E5
    • Office 365 F3
  4. Có kết nối internet và đã bật connected experiences — các trải nghiệm cần kết nối.

Lưu ý: nếu bạn đủ các điều kiện trên mà vẫn không thấy tab Automate, có thể quản trị viên đã tắt tính năng này, hoặc môi trường của bạn có vấn đề khác. Hãy làm theo các bước trong mục Automate tab not appearing or Office Scripts unavailable để bắt đầu dùng được Office Scripts.

Quan trọng: để dùng Office Scripts trong Power Automate, bạn phải có license bản business của Microsoft 365. Hai license Office 365 Enterprise E1 và Office 365 F3 dùng được Scripts với Power Automate, nhưng không có phần tích hợp Power Automate ngay trong Excel.

Giới hạn dữ liệu

Excel giới hạn lượng dữ liệu chuyển trong một lần. Power Automate giới hạn số giao dịch bạn chạy được.

Excel

Excel on the web có những giới hạn sau khi script gọi vào workbook.

Khi bạn vượt một trong các giới hạn dữ liệu của Excel, bạn nhận thông báo lỗi sau:

"The response payload size has exceeded the limit." (Kích thước dữ liệu phản hồi đã vượt giới hạn.)

Nếu bạn gặp lỗi khi làm việc với tập dữ liệu lớn, hãy thử dùng nhiều range nhỏ thay cho một range lớn. Xem ví dụ ở mẫu Write a large dataset. Bạn cũng có thể dùng các API như Range.getSpecialCells để nhắm đúng những ô cần lấy thay vì quét cả range lớn.

Những giới hạn của Excel không riêng cho Office Scripts nằm trong bài Excel specifications and limits.

Power Automate

Dưới đây là những giới hạn của nền tảng Power Automate mà bạn dễ gặp nhất.

Các giới hạn sử dụng khác của nền tảng Power Automate nằm trong những bài sau.

Các hạn chế riêng khi chạy trong Power Automate

Chạy script trong ứng dụng Excel và chạy script như một phần của flow Power Automate có vài khác biệt quan trọng.

Script không gọi được ra ngoài

Lệnh gọi API ra ngoài sẽ thất bại khi script chạy qua Power Automate. Một lệnh fetch sẽ cho thông báo lỗi "Runtime error: Line X: fetch is not defined". Hãy kiểm tra script xem có chỗ nào gọi kiểu đó không, trước khi đưa script vào một flow.

Bạn sẽ phải dùng HTTP with Azure AD hoặc các action tương đương để nhận hoặc gửi dữ liệu tới dịch vụ bên ngoài.

Cảnh báo: các lệnh gọi ra ngoài đi qua Excel Online connector của Power Automate bị chặn, nhằm giữ nguyên hiệu lực của các chính sách chống rò rỉ dữ liệu hiện có. Tuy vậy, script chạy qua Power Automate là chạy bên ngoài tổ chức của bạn, và bên ngoài tường lửa của tổ chức. Để bảo vệ thêm trước người dùng có ý xấu trong môi trường bên ngoài đó, quản trị viên có thể kiểm soát việc dùng Office Scripts. Quản trị viên hoặc tắt Excel Online connector trong Power Automate, hoặc tắt hẳn Office Scripts cho Excel qua phần điều khiển dành cho quản trị viên của Office Scripts.

Một số API hành xử khác đi

Một số API hành xử khác khi chạy qua Power Automate. Một số khác thì lỗi hẳn vì chúng dựa vào giao diện Excel. Danh sách đầy đủ nằm trong bài Troubleshoot Office Scripts running in Power Automate.

Không hỗ trợ workbook định dạng ISO strict Open XML

Action Run script của connector Excel Business (Online) không hỗ trợ workbook lưu ở định dạng ISO strict của Excel Workbook. Flow dùng loại workbook này sẽ trả lỗi "BadGateway" khi chạy script. Nguyên nhân là các hạn chế về đồng tác giả (coauthoring). Hãy lưu workbook ở định dạng Excel Workbook tiêu chuẩn khi dùng với Power Automate.

Hỗ trợ trong Teams

Quan trọng: khi dùng Excel trong Teams, Office Scripts chỉ chạy được trên Teams bản web (không chạy trên Teams cho Windows, Mac, iOS hay Android).

Hỗ trợ trên đám mây của chính phủ

Office Scripts không được hỗ trợ trên GCC High trở lên. Trên những đám mây chính phủ khác, thiết lập tường lửa có thể ảnh hưởng tới lệnh gọi ra ngoài của script.

Trình duyệt của bạn cần bật cookie bên thứ ba thì tab Automate mới hiện trong Excel on the web. Hãy kiểm tra thiết lập trình duyệt nếu không thấy tab này. Nếu bạn đang dùng phiên duyệt web riêng tư, có thể bạn phải bật lại thiết lập này mỗi lần mở.

Lưu ý: một số trình duyệt gọi thiết lập này là "all cookies" (toàn bộ cookie) thay vì "third-party cookies" (cookie bên thứ ba).

Conditional Access

Các chính sách Conditional Access hạn chế quyền truy cập SharePoint và OneDrive từ thiết bị không được quản lý. Nếu thiết bị không do tenant quản lý, bạn có thể không truy cập được một số script hoặc chỉ truy cập qua trình duyệt.

Tenant đã thêm thiết lập authentication context cùng với Conditional Access thì không hỗ trợ Office Scripts trong Excel on the web. Tenant của bạn có thiết lập authentication context, và bạn gặp lỗi khi tạo, ghi hoặc chạy một Office Script trong Excel on the web? Hãy dùng Excel for Windows hoặc Excel for Mac thay thế.

Nếu script của bạn bị chính sách Conditional Access chặn, bạn nhận một trong hai thông báo lỗi sau. Hai thông báo này cũng xuất hiện trong Power Automate nếu flow chạy từ thiết bị không được quản lý.

Quan trọng: quản trị viên nên cân nhắc chặn hẳn mọi truy cập vào Power Automate từ thiết bị không được quản lý. Cách làm được nêu chi tiết trong bài blog Control Access to Power Apps and Power Automate with Azure AD Conditional Access Policies.

Hỗ trợ API trên các bản Excel cũ

Một số API của Office Scripts có thể không được Excel for Windows hoặc Excel for Mac hỗ trợ, nhất là các bản build cũ. Nhóm này gồm các API mới và các API dành cho tính năng chỉ có trên bản web. Nếu script chứa API không được hỗ trợ, Code Editor sẽ hiện cảnh báo.

Nếu bạn cố chạy script đó, nó sẽ không chạy. Thay vào đó, khung Script Run Status hiện cảnh báo: "This script currently must be run on Excel for the web. Open the workbook in the browser then try again, or contact the script owner for help. (Hiện script này phải chạy trên Excel bản web. Hãy mở workbook trong trình duyệt rồi thử lại, hoặc liên hệ chủ script để được giúp.)

Mở một workbook có script chia sẻ bằng bản Excel cũ không ảnh hưởng gì tới bản thân script.

Xem thêm

Ghi chú người dịch: cuối trang gốc là khối mời góp ý và đóng góp qua GitHub — nguồn của trang nằm tại kho office-scripts-docs. Trang gốc ghi cập nhật lần cuối ngày 10/24/2024 theo lối viết Mỹ, tức ngày 24 tháng 10 năm 2024.