Việc xem tài liệu nhúng nên cảm giác như một phần của ứng dụng, không phải là việc chuyển giao cho một tiện ích mở rộng trình duyệt cũ hoặc chương trình máy tính để bàn được cài đặt cục bộ. Đối với các dự án ASP.NET và .NET trên Windows, Doconut cung cấp SDK trình xem tài liệu có thể render các tài liệu doanh nghiệp ngay trong ứng dụng web của bạn.

Hướng dẫn này giải thích kiến trúc của trải nghiệm xem không cần plugin mà không tiết lộ mã nguồn Doconut chưa được tài liệu hoá.

Tài liệu đi qua dịch vụ render .NET vào trình xem nhúng không cần plugin

Ý Nghĩa của “Không Cần Plugin”

Một trình xem không cần plugin không yêu cầu người dùng cuối cài đặt các công nghệ như ActiveX, Flash, Silverlight, hoặc một tiện ích mở rộng trình duyệt tùy chỉnh trước khi mở tài liệu.

Điều này giảm bớt một số nguồn gây ma sát:

Người dùng không cần quyền cài đặt cục bộ.
Các đội IT không cần phân phối và cập nhật plugin phía máy khách.
Ứng dụng giữ quy trình xem trong giao diện của chính nó.
Các phụ thuộc plugin lạc hậu không trở thành điều kiện để mở tệp.

Không cần plugin không đồng nghĩa với không có phụ thuộc. Máy chủ vẫn cần SDK, runtime, phông chữ, quyền truy cập lưu trữ, cấu hình và giấy phép phù hợp. Ứng dụng cũng vẫn chịu trách nhiệm về xác thực, ủy quyền, lưu trữ và giám sát.

Tại Sao Render Tài Liệu Bên Máy Chủ Giúp Đỡ

Tài liệu doanh nghiệp phức tạp hơn nội dung web thông thường. Các tệp Office, bản vẽ CAD, tin nhắn email và hình ảnh độ phân giải cao mỗi loại đều yêu cầu xử lý nhận thức định dạng.

Một thành phần .NET phía máy chủ có thể thực hiện xử lý đó trong khi ứng dụng web trình bày trải nghiệm xem kết quả. Điều này tránh việc yêu cầu mỗi người dùng phải cài đặt phần mềm tạo tài liệu gốc.

Doconut được thiết kế cho vai trò này. Thông tin sản phẩm hiện tại mô tả hỗ trợ các loại tài liệu bao gồm PDF, tài liệu Office, bản vẽ CAD, tệp email và hình ảnh. Xác nhận các định dạng và tính năng chính xác mà ứng dụng của bạn yêu cầu trên trang Trình xem Doconut.

Lập Kế Hoạch Quy Trình Xem

Yêu cầu tài liệu an toàn thường tuân theo các bước sau:

Người dùng chọn một tài liệu bằng cách sử dụng định danh ứng dụng.
ASP.NET xác thực yêu cầu.
Máy chủ kiểm tra quyền truy cập vào tài liệu cụ thể đó.
Ứng dụng xác định vị trí lưu trữ được bảo vệ.
Tài liệu được chuyển tới lớp xem bằng phương pháp tích hợp được hỗ trợ.
Ứng dụng ghi lại kết quả và giải phóng tài nguyên tạm thời.

Máy khách không bao giờ nên nhận được thông tin đăng nhập lưu trữ, đường dẫn máy chủ không giới hạn, hoặc nhiều thông tin tài liệu hơn mức mà phiên được ủy quyền yêu cầu.

Sử Dụng Ranh Giới Bảo Mật ASP.NET Tiêu Chuẩn

Trang xem nên được bảo vệ giống như bất kỳ tài nguyên nhạy cảm nào khác.

Các cơ chế .NET tiêu chuẩn có thể bao gồm:

Middleware xác thực
Thuộc tính [Authorize]
Chính sách và claim ủy quyền
Ủy quyền dựa trên tài nguyên
Tiêm phụ thuộc cho các dịch vụ lưu trữ và xem
Ghi log có cấu trúc với lọc dữ liệu nhạy cảm

Ủy quyền phải được đánh giá trên máy chủ. Ẩn một hành động thanh công cụ hoặc route trong giao diện người dùng không ngăn được một máy khách quyết tâm yêu cầu trực tiếp.

Giữ Truy Cập SDK Đằng Sau Dịch Vụ Ứng Dụng

Tránh lan truyền các lời gọi đặc thù cho trình xem khắp các controller và trang. Một dịch vụ ứng dụng chuyên dụng có thể:

Xác định định danh tài liệu đã được ủy quyền
Mở một Stream được kiểm soát
Áp dụng cấu hình cho phiên bản SDK đã cài đặt
Giải phóng tài nguyên tệp và stream
Chuyển đổi lỗi kỹ thuật thành lỗi ứng dụng an toàn
Ghi lại thời gian và chẩn đoán đã được làm sạch

Ranh giới này giúp ứng dụng dễ kiểm thử hơn và giảm tác động của các bản nâng cấp SDK trong tương lai.

Sử dụng tài nguyên tải xuống và tài liệu chính thức của Doconut để cài đặt gói và hướng dẫn API theo phiên bản.

Xây Dựng Host Trình Xem Hữu Ích

Container trình xem thuộc sở hữu ứng dụng cần đủ không gian cho các tài liệu thực. Tránh các thẻ hẹp và độ rộng cố định cho desktop.

.viewer-workspace {
  display: grid;
  grid-template-rows: auto minmax(0, 1fr);
  width: 100%;
  min-height: 36rem;
  height: calc(100dvh - 4rem);
}

.viewer-host {
  min-width: 0;
  min-height: 0;
  overflow: hidden;
}

Đây là CSS tiêu chuẩn cho trang bao quanh, không phải cấu hình Doconut. Không nhắm vào các selector nội bộ chưa được tài liệu hoá hoặc tự tạo các tùy chọn SDK.

Trang cũng nên cung cấp:

Trạng thái tải rõ ràng
Thông báo lỗi an toàn
Tiêu đề tài liệu hiển thị
Cách quay lại quy trình cha
Các điều khiển ứng dụng có thể truy cập
Đủ không gian cho bảng tính rộng và bản vẽ chi tiết

Xác Thực Tài Liệu Trước Khi Render

Nếu người dùng tải lên tệp, hãy kiểm tra:

Kích thước tệp
Phần mở rộng và chữ ký tệp
Định dạng được hỗ trợ
Yêu cầu mật khẩu hoặc mã hoá
Các hạn chế riêng theo doanh nghiệp
Tên lưu trữ do máy chủ tạo

Không tạo đường dẫn máy chủ trực tiếp từ tên tệp gốc. Lưu một định danh ứng dụng an toàn và giải quyết nó thông qua dịch vụ phía máy chủ đã được ủy quyền.

Chuẩn Bị Máy Chủ Windows

Hành vi render có thể phụ thuộc vào môi trường máy chủ. Xác nhận:

Các phiên bản Windows và .NET được hỗ trợ
Phông chữ cần thiết
Vị trí lưu trữ tạm thời và quyền truy cập
CPU, bộ nhớ và dung lượng đĩa khả dụng
Kích thước tài liệu tối đa và số phiên đồng thời
Cấu hình giấy phép
Quy trình dọn dẹp

Kiểm tra các tài liệu khách hàng tiêu biểu trên môi trường phù hợp với môi trường sản xuất.

Danh Sách Kiểm Tra Bảo Mật và Quyền Riêng Tư

Trước khi phát hành:

Xác thực các yêu cầu xem khi cần.
Ủy quyền cho người dùng đối với tài liệu cụ thể.
Giữ đường dẫn lưu trữ và thông tin đăng nhập trên máy chủ.
Hạn chế quyền truy cập tệp tạm thời.
Xác định thời gian lưu trữ cho bản gốc, dữ liệu tạm thời và xuất khẩu.
Làm sạch các lỗi hiển thị cho người dùng.
Loại trừ nội dung tài liệu và bí mật khỏi log.
Áp dụng giới hạn tải lên và đồng thời.
Giữ SDK và các phụ thuộc của ứng dụng luôn cập nhật.

Các tuyên bố về tuân thủ nên phản ánh toàn bộ hệ thống đã triển khai và quy trình của tổ chức, không chỉ một thành phần UI duy nhất.

Kiểm Thử Ngoài Các Trường Hợp Thành Công

Thư viện kiểm thử của bạn nên bao gồm:

PDF đa trang
Bảng tính lớn
Bản vẽ CAD chi tiết
Bản trình bày với phông chữ hiếm
Tệp email có đính kèm
Hình ảnh lớn
Tệp hỏng và không được hỗ trợ
Yêu cầu không được ủy quyền
Các phiên xem đồng thời
Yêu cầu bị gián đoạn và khởi động lại ứng dụng

Xác nhận rằng các lỗi không tiết lộ đường dẫn máy chủ, stack trace hoặc URL lưu trữ.

Vị Trí Của Doconut

Doconut cung cấp khả năng xem tài liệu nhúng trong một ứng dụng web .NET. Ứng dụng của bạn cung cấp bảo mật, lưu trữ, quy trình làm việc, bố cục đáp ứng và các điều khiển vận hành bao quanh.

Sự tách biệt này cho phép các đội thay thế các quy trình phụ thuộc vào plugin lạc hậu mà không giả vờ rằng việc xử lý tài liệu trở nên dễ dàng hoặc không có trách nhiệm.

Khám phá SDK trình xem tài liệu .NET của Doconut đã được xác minh, sau đó sử dụng trang tải xuống chính thức để xem hướng dẫn phù hợp với phiên bản bạn đã chọn.

Kết Luận

Trải nghiệm tài liệu không cần plugin giảm bớt ma sát cài đặt và giữ người dùng trong ứng dụng của bạn. Xây dựng nó trên quy trình tài liệu được máy chủ ủy quyền, cô lập truy cập SDK, cung cấp một host trình xem rộng rãi, và kiểm thử các tệp thực tế dưới tải giống môi trường sản xuất.

Đối với các ứng dụng ASP.NET và .NET trên Windows, Doconut có thể cung cấp lớp xem tài liệu trong khi đội của bạn vẫn kiểm soát vòng đời ứng dụng và tài liệu.