Document Bí danh cho Nhà cung cấp dữ liệu của Widget

Bí danh cho Nhà cung cấp dữ liệu của Widget

Sử dụng bí danh trong các nhà cung cấp dữ liệu widget để khắc phục lỗi ánh xạ phát sinh do thay đổi ID nhà cung cấp khi các symbol được tái sử dụng trên trang web của bạn.

Table of content

TL;DR / Tổng quan

Nilead hiện hỗ trợ bí danh cho nhà cung cấp dữ liệu widget nhằm nâng cao tính nhất quán khi ánh xạ dữ liệu. Tính năng mới này đặc biệt hữu ích khi bạn tái sử dụng widgets dưới dạng symbol trong nhiều ngữ cảnh khác nhau. Thay vì dựa vào các ID nhà cung cấp không ổn định, bạn có thể tạo một điểm tham chiếu nhất quán cho việc ánh xạ dữ liệu nhờ bí danh – giúp tiết kiệm thời gian, giảm lỗi và đơn giản hóa chuỗi widget phức tạp.


alias

Điều kiện cần

  • Quyền truy cập vào chức năng Visual Website Builder

  • Hiểu về widgets, symbolsnhà cung cấp dữ liệu

  • Quyền admin hoặc editor

  • Cấu trúc widget có sử dụng liên kết dữ liệu giữa nhiều nhà cung cấp

Hướng dẫn chi tiết

Bí danh giải quyết vấn đề gì?

Khi bạn chuyển một widget thành symbol, nó sẽ hoạt động như một thành phần dùng lại được. Tuy nhiên, mỗi lần bạn sử dụng symbol đó ở nơi khác, ID nhà cung cấp dữ liệu có thể thay đổi – khiến ánh xạ dữ liệu bị gián đoạn.

Trước khi có Bí danh:
Việc ánh xạ dữ liệu phụ thuộc vào ID nhà cung cấp → ID thay đổi ở nhiều phiên bản → ánh xạ bị lỗi.

Giờ đây với Bí danh:
Gán một bí danh nhất quán cho mỗi nhà cung cấp → tất cả ánh xạ dữ liệu tham chiếu đến bí danh này → ánh xạ giữ được sự nhất quán.

Cách hoạt động

1. Gán Bí danh

  • Khi cấu hình nhà cung cấp dữ liệu trong widget, bạn sẽ thấy trường Bí danh tuỳ chọn.

  • Nhập một chuỗi định danh duy nhất (ví dụ: productList, headerData, testimonialSource).

  • Bí danh này sẽ thay thế ID nhà cung cấp trong mọi ánh xạ dữ liệu.

Mẹo: Sử dụng chữ thường, không khoảng trắng và đặt tên có ý nghĩa để dễ quản lý hơn.

2. Sử dụng Symbol với Bí danh

  • Khi lưu widget làm symbol, bí danh được giữ nguyên.

  • Khi symbol được dùng ở vị trí khác trên website, hệ thống sẽ ánh xạ dữ liệu dựa vào bí danh thay vì ID mới của nhà cung cấp.

Kết quả: Việc ánh xạ dữ liệu xuyên suốt các trang hoặc môi trường trở nên liền mạch – không cần sửa thủ công.

3. Làm việc với nhiều nhà cung cấp

Nếu widget của bạn sử dụng chuỗi nhà cung cấp như sau:

Nhà cung cấp A → Nhà cung cấp B → Nhà cung cấp C

Chiến lược đặt bí danh phụ thuộc vào vị trí bạn ánh xạ dữ liệu:

  • Ánh xạ một nhà cung cấp: Chỉ cần gán bí danh cho nhà cung cấp C.

  • Ánh xạ nhiều nhà cung cấp: Gán bí danh cho cả A, B, và C tuỳ theo nhu cầu.

4. Nhà cung cấp trong suốt là gì?

Trước đây transparent provider cho phép người dùng đổi tên nhà cung cấp để dễ nhận biết khi ánh xạ. Còn với bí danh, trường hợp này phần lớn không còn cần thiết.

Chỉ nên sử dụng transparent provider khi:

  • Bạn có nhiều symbol trong cùng một ngữ cảnh, lấy dữ liệu từ cùng một nhà cung cấp nhưng cần có tên bí danh khác nhau.

  • Bạn cần tổng hợpđặt lại tên dữ liệu từ nhiều nguồn về cùng một nhà cung cấp hợp nhất.

5. Nâng cao: Cấu hình Transparent Provider

Loại nhà cung cấp đặc biệt này có thể:

  • Kết hợp nhiều dữ liệu đầu ra thành một.

  • Dùng tên khóa tuỳ chỉnh để tổ chức dữ liệu đầu vào.

  • Vẫn tận dụng được ưu điểm bí danh để tăng rõ ràng và dễ dùng lại.


Câu hỏi thường gặp

1. Tôi có bắt buộc sử dụng bí danh cho mọi nhà cung cấp không?
Không. Bí danh là tuỳ chọn – nhưng rất nên dùng khi bạn sử dụng symbol ở nhiều trang hoặc cấu trúc widget phức tạp.

2. Có thể có hai nhà cung cấp cùng bí danh không?
Không. Bí danh phải là duy nhất trong cùng một ngữ cảnh để tránh xung đột.

3. Nếu tôi quên gán bí danh khi chuyển widget thành symbol thì sao?
Hệ thống sẽ quay lại sử dụng ID nhà cung cấp, điều này có thể gây lỗi ánh xạ nếu dùng lại ở nơi khác.

4. Tôi có thể đổi bí danh sau không?
Có, nhưng nếu bí danh đã được dùng để ánh xạ dữ liệu, bạn sẽ cần cập nhật lại các ánh xạ liên quan.

5. Bí danh có ảnh hưởng đến tốc độ hay hiệu suất không?
Không. Bí danh chỉ là tham chiếu logic, không làm ảnh hưởng tới hiệu suất hệ thống.

Discord chat

We're available Monday–Friday, security and critical bug fixes are available 24/7.

Facebook page

Get the latest news and updates regarding Nilead platform and services.