Aliases – Bí danh

Bí danh
Bí danh là một tham chiếu đến một thực thể đơn lẻ hoặc một nhóm thực thể được sử dụng trong các widget. Bí danh có thể là tĩnh hoặc động.

Chúng có thể đơn giản như tham chiếu đến một thiết bị hoặc phức tạp như truy vấn tìm kiếm các tài sản cụ thể từ một danh sách.

Trong hướng dẫn này, bí danh sẽ được sử dụng trong hệ thống theo sơ đồ dưới đây. Tất cả các thiết bị truyền giá trị telemetry là “nhiệt độ”.

Hình ảnh

Điều kiện tiên quyết
Trước khi bắt đầu, bạn nên làm quen với hướng dẫn Bắt đầu với ESG IoT để hiểu về thiết bị, bảng điều khiển và widget của ESG IoT. Điều này sẽ nâng cao trải nghiệm học tập và giúp bạn nắm rõ các khái niệm được trình bày.

Tạo bí danh

Để tạo bí danh, bạn cần xác định các thực thể mà dữ liệu sẽ được trích xuất.

Thực hiện các bước sau:

1. Mở bảng điều khiển và vào chế độ chỉnh sửa;
2. Nhấp vào biểu tượng Bí danh thực thể ở góc trên bên phải;
3. Trong cửa sổ Bí danh thực thể, nhấp vào nút Thêm bí danh ở phía bên trái hộp thoại;
4. Trong cửa sổ Thêm bí danh, nhập tên bí danh và chọn loại bộ lọc. Điền tất cả các trường bắt buộc và nhấp Thêm ở góc dưới bên phải;
5. Bí danh mới đã được thêm. Trong cửa sổ này, bạn có thể xem, chỉnh sửa hoặc xóa bí danh. Nhấp Lưu ở góc dưới bên phải.

Sử dụng bí danh trong widget

Để sử dụng bí danh đã thêm trong một widget:

1. Nhấp vào nút Thêm widget ở đầu màn hình hoặc biểu tượng Thêm widget mới lớn ở giữa màn hình (nếu đây là widget đầu tiên);
2. Chọn nhóm widget, ví dụ: nhóm widget Môi trường trong nhà;
3. Chọn widget Thẻ nhiệt độ trong nhà với nền;
4. Trong cửa sổ Thêm Widget, chuyển đến tab Bí danh thực thể. Chỉ định bí danh đã tạo trước đó (ví dụ: Bí danh thực thể mới) trong trường Bí danh thực thể;
5. Chỉ định khóa dữ liệu trong trường Khóa dữ liệu, ví dụ: khóa nhiệt độ. Nhấp Thêm;
6. Bạn đã thêm một widget sử dụng bí danh đã cấu hình làm nguồn dữ liệu.

Các loại bí danh

Trong ESG IoT, có nhiều loại bí danh, mỗi loại cung cấp khả năng khác nhau để cấu hình widget: Thực thể đơn lẻ, Danh sách thực thể, Tên thực thể, Loại thực thể, Thực thể từ trạng thái bảng điều khiển, Loại tài sản, Loại thiết bị, Loại chế độ xem thực thể, Loại cạnh, Trạng thái sử dụng API, Truy vấn quan hệ, Truy vấn tìm kiếm tài sản, Truy vấn tìm kiếm thiết bị, Truy vấn tìm kiếm chế độ xem thực thể, và Truy vấn tìm kiếm cạnh.

Chúng mang lại sự linh hoạt và khả năng mạnh mẽ để cấu hình bảng điều khiển, cho phép người dùng tổ chức và trực quan hóa dữ liệu từ nhiều nguồn một cách hiệu quả.

Hãy xem xét từng loại:

Thực thể đơn lẻ

Bí danh này cho phép chọn một thực thể duy nhất, có thể là thiết bị, tài sản, chế độ xem thực thể, người thuê, khách hàng, người dùng, bảng điều khiển, cạnh, khách hàng hiện tại, người thuê hiện tại, người dùng hiện tại hoặc chủ sở hữu người dùng hiện tại.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Thực thể đơn lẻ, sau đó chọn loại thực thể và chỉ định thực thể cuối cùng.

Ví dụ: Bí danh lọc một thiết bị – Nhiệt kế A1.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Thực thể đơn lẻ trong trường Bí danh thực thể và khóa nhiệt độ trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị một thiết bị – Nhiệt kế A1 đã được thêm.

Danh sách thực thể

Bí danh này cho phép hiển thị nhiều thực thể, có thể là thiết bị, tài sản, chế độ xem thực thể, người thuê, khách hàng, bảng điều khiển, người dùng hoặc cạnh.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Danh sách thực thể, sau đó chọn loại thực thể và chỉ định các thực thể muốn hiển thị dữ liệu.

Ví dụ: Bí danh lọc danh sách các thiết bị: Nhiệt kế A1, Nhiệt kế A2, và Nhiệt kế A3.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Danh sách thực thể trong trường Bí danh thực thể và khóa nhiệt độ trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị danh sách các thiết bị Nhiệt kế A1, Nhiệt kế A2, và Nhiệt kế A3 đã được thêm.

Tên thực thể

Bí danh này cho phép hiển thị các thực thể có tên bắt đầu bằng biểu thức đã nhập, có thể là thiết bị, tài sản, chế độ xem thực thể, người thuê, khách hàng, người dùng, bảng điều khiển hoặc cạnh.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Tên thực thể, sau đó chọn loại thực thể và nhập biểu thức lọc tên của các thực thể hiển thị.

Ví dụ: Bí danh lọc các thiết bị có tên bắt đầu bằng “Máy nén”.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Tên thực thể trong trường Bí danh thực thể và khóa nhiệt độ trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể lọc các thiết bị có tên bắt đầu bằng “Máy nén” đã được thêm.

Loại thực thể

Bí danh này cho phép hiển thị tất cả thực thể của bạn và khách hàng theo loại được chỉ định, có thể là thiết bị, tài sản, chế độ xem thực thể, người thuê, khách hàng, người dùng, bảng điều khiển hoặc cạnh.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Loại thực thể, và chọn loại thực thể (ví dụ: Thiết bị). Nhấp Thêm.

Ví dụ: Bí danh hiển thị tất cả thiết bị của bạn và khách hàng.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Loại thực thể trong trường Bí danh thực thể và khóa nhiệt độ trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị tất cả thiết bị của bạn và khách hàng đã được thêm.

Thực thể từ trạng thái bảng điều khiển

Bí danh này cho phép chọn một hoặc nhiều thực thể từ trạng thái bảng điều khiển, có thể là thiết bị, tài sản, chế độ xem thực thể, người thuê, khách hàng, người dùng, bảng điều khiển, cạnh, khách hàng hiện tại, người thuê hiện tại, người dùng hiện tại hoặc chủ sở hữu người dùng hiện tại.

Ví dụ, nếu widget bảng thực thể được tạo trên trạng thái bảng điều khiển gốc với nhiều thực thể, và bạn muốn tạo trạng thái hiển thị widget với thực thể được nhấp, hãy sử dụng bí danh này.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Thực thể từ trạng thái bảng điều khiển, sau đó nhấp Thêm.

Bí danh này được sử dụng để lọc dữ liệu cho các trạng thái bảng điều khiển khác.

Ví dụ sử dụng: Cần hai bí danh: Loại thực thể và Thực thể từ trạng thái bảng điều khiển.

1. Tạo widget bảng thực thể hiển thị danh sách thực thể, sử dụng bí danh Loại thực thể làm nguồn dữ liệu.
2. Thêm trạng thái mới:
   • Nhấp vào biểu tượng lớp ở góc trên bên trái để tạo trạng thái mới. Trong cửa sổ, nhấp “+” để thêm trạng thái;
   • Nhập tên trạng thái. Để trạng thái được đặt tên theo thực thể, sử dụng ${entityName}. Nhấp Thêm;
   • Danh sách hiển thị hai trạng thái: trạng thái gốc và trạng thái mới. Nhấp Lưu.
3. Thêm hành động cho widget trên trạng thái gốc:
   • Trong trạng thái gốc, vào chế độ chỉnh sửa widget bằng cách nhấp vào biểu tượng bút chì;
   • Trong phần Hành động, nhấp Thêm hành động;
   • Trong cửa sổ Hành động, nhấp Thêm hành động, nhập tên hành động, chọn nguồn hành động (ví dụ: nhấp vào hàng), chọn loại hành động Chuyển đến trạng thái bảng điều khiển mới, và chỉ định trạng thái mới. Nhấp Thêm;
   • Nhấp Lưu và Áp dụng.
4. Chuyển đến trạng thái mới qua menu thả xuống ở góc trên bên trái;
5. Nhấp Thêm widget mới, chọn nhóm widget Môi trường trong nhà, chọn widget Thẻ nhiệt độ trong nhà với nền;
6. Trong cửa sổ thêm widget, chuyển đến tab Bí danh thực thể, chỉ định bí danh Thực thể từ trạng thái bảng điều khiển trong trường Bí danh thực thể và khóa nhiệt độ trong phần Cột. Nhấp Thêm;
7. Lưu tất cả thay đổi;
8. Trong trạng thái gốc, nhấp vào nút hành động bên cạnh bất kỳ thực thể nào. Bạn sẽ chuyển đến trạng thái nội bộ chứa widget với chi tiết của thực thể được chọn.

Loại tài sản

Bí danh này cho phép lọc tài sản theo hồ sơ tài sản được chỉ định (và tùy chọn theo tên bắt đầu bằng truy vấn đã nhập).

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Loại tài sản, chỉ định hồ sơ tài sản và tùy chọn nhập biểu thức lọc tên tài sản hiển thị.

Ví dụ: Bí danh lọc tài sản có hồ sơ tài sản “tòa nhà” và tên bắt đầu bằng “Tòa”.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Loại tài sản trong trường Bí danh thực thể. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị tài sản có hồ sơ “tòa nhà” và tên bắt đầu bằng “Tòa” đã được thêm.

Loại thiết bị

Bí danh này cho phép lọc thiết bị theo hồ sơ thiết bị được chỉ định (và tùy chọn theo tên bắt đầu bằng truy vấn đã nhập).

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Loại thiết bị, chỉ định hồ sơ thiết bị và tùy chọn nhập biểu thức lọc tên thiết bị hiển thị.

Ví dụ: Bí danh lọc thiết bị có hồ sơ thiết bị “nhiệt kế” và tên bắt đầu bằng “Nhiệt”.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Loại thiết bị trong trường Bí danh thực thể. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị thiết bị có hồ sơ “nhiệt kế” và tên bắt đầu bằng “Nhiệt” đã được thêm.

Loại chế độ xem thực thể

Bí danh này cho phép lọc thiết bị theo loại chế độ xem thực thể được chỉ định (và tùy chọn theo tên bắt đầu bằng truy vấn đã nhập).

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Loại chế độ xem thực thể, chỉ định loại chế độ xem thực thể và nhập biểu thức lọc tên chế độ xem thực thể hiển thị.

Ví dụ: Bí danh lọc chế độ xem thực thể có loại “Loại chế độ xem thực thể máy nén” và tên bắt đầu bằng “Máy nén”.

Ví dụ: Chế độ xem thực thể “Chế độ xem thực thể Máy nén BC-10” và “Chế độ xem thực thể Máy nén QA-32” được tạo với loại “Loại chế độ xem thực thể máy nén”, cung cấp quyền truy cập vào chuỗi thời gian ‘Công suất’ từ Máy nén BC-10 và Máy nén QA-32.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Loại chế độ xem thực thể trong trường Bí danh thực thể. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị chế độ xem thực thể có loại “Loại chế độ xem thực thể máy nén” và tên bắt đầu bằng “Máy nén” đã được thêm.

Loại cạnh

Bí danh này cho phép lọc thiết bị theo loại cạnh được chỉ định (và tùy chọn theo tên bắt đầu bằng truy vấn đã nhập).

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Loại cạnh, chỉ định loại cạnh và nhập biểu thức lọc tên cạnh hiển thị.

Ví dụ: Bí danh lọc các cạnh có loại “phiên bản cạnh” và tên bắt đầu bằng “Cạnh”.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Loại cạnh trong trường Bí danh thực thể. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị các cạnh có loại “phiên bản cạnh” và tên bắt đầu bằng “Cạnh” đã được thêm.

Trạng thái sử dụng API

Trong menu chính của nền tảng ESG IoT, có bố cục Sử dụng API hiển thị thống kê đầy đủ về nền tảng. Bí danh Trạng thái sử dụng API cho phép lấy chỉ dữ liệu bạn cần từ thống kê bảng điều khiển người dùng.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh và chọn loại bộ lọc Trạng thái sử dụng API.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Trạng thái sử dụng API trong trường Bí danh thực thể và thêm khóa dữ liệu trong phần Cột để lấy thống kê từ sử dụng API. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị thống kê sử dụng API đã được thêm.

Truy vấn quan hệ

Bí danh này cho phép hiển thị các thực thể có quan hệ với một nguồn gốc được chỉ định, đến một cấp độ và hướng cụ thể.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Truy vấn quan hệ, chọn loại thực thể và thực thể muốn hiển thị quan hệ. Đặt hướng là Từ hoặc Đến và cấp độ quan hệ tối đa.

Ví dụ: Bí danh hiển thị các thực thể có bất kỳ quan hệ nào với tài sản ‘Khu A’ đến cấp độ quan hệ 3.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Truy vấn quan hệ trong trường Bí danh thực thể và thêm khóa entityType trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị các thực thể và loại của chúng có quan hệ với tài sản “Khu A” đến cấp độ quan hệ 3 đã được thêm.

Truy vấn tìm kiếm tài sản

Bí danh này cho phép hiển thị tài sản của hồ sơ tài sản được chỉ định, có quan hệ với một thực thể được chỉ định đến một cấp độ và hướng cụ thể.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Truy vấn tìm kiếm tài sản, chọn loại thực thể và thực thể muốn hiển thị quan hệ. Đặt hướng là Từ hoặc Đến, cấp độ quan hệ tối đa và chỉ định hồ sơ tài sản để lọc tài sản.

Ví dụ: Bí danh hiển thị tài sản có hồ sơ “tòa nhà” và “khu vực” có quan hệ với thiết bị “Máy nén QA-32” với hướng Từ và cấp độ quan hệ 2.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Truy vấn tìm kiếm tài sản trong trường Bí danh thực thể, thêm khóa name và type trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị tài sản có quan hệ với thiết bị “Máy nén QA-32” đến cấp độ quan hệ 2 đã được thêm.

Truy vấn tìm kiếm thiết bị

Bí danh này cho phép hiển thị thiết bị của hồ sơ thiết bị được chỉ định, có quan hệ với một nguồn gốc được chỉ định đến một cấp độ và hướng cụ thể.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Truy vấn tìm kiếm thiết bị, chọn loại thực thể và thực thể muốn hiển thị quan hệ. Đặt hướng là Từ hoặc Đến, cấp độ quan hệ tối đa và chỉ định hồ sơ thiết bị để lọc thiết bị.

Ví dụ: Bí danh hiển thị thiết bị có hồ sơ “nhiệt kế” có quan hệ với tài sản “Tòa nhà A” với hướng Từ và cấp độ quan hệ 1.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Truy vấn tìm kiếm thiết bị trong trường Bí danh thực thể, thêm khóa name, type, và nhiệt độ trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị thiết bị có quan hệ với tài sản “Tòa nhà A” đến cấp độ quan hệ 1 đã được thêm.

Truy vấn tìm kiếm chế độ xem thực thể

Bí danh này cho phép hiển thị chế độ xem thực thể của loại được chỉ định, có quan hệ với một nguồn gốc được chỉ định đến một cấp độ và hướng cụ thể.

Ví dụ: Chế độ xem thực thể “Chế độ xem thực thể Máy nén BC-10” có quan hệ với thiết bị “Máy nén BC-10”, được tạo với loại “Loại chế độ xem thực thể máy nén”, cung cấp quyền truy cập vào chuỗi thời gian “nhiệt độ” từ Máy nén BC-10.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Truy vấn tìm kiếm chế độ xem thực thể, chọn loại thực thể và thực thể muốn hiển thị quan hệ. Đặt hướng là Từ hoặc Đến, cấp độ quan hệ tối đa và chỉ định loại chế độ xem thực thể để lọc.

Ví dụ: Bí danh lọc chế độ xem thực thể có loại “Loại chế độ xem thực thể máy nén” có quan hệ với tài sản “Tòa nhà A” với hướng Từ và cấp độ quan hệ 1.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Truy vấn tìm kiếm chế độ xem thực thể trong trường Bí danh thực thể, thêm khóa name, type, và nhiệt độ trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị chế độ xem thực thể có quan hệ với tài sản “Tòa nhà A” đến cấp độ quan hệ 1 đã được thêm.

Truy vấn tìm kiếm cạnh

Bí danh này cho phép hiển thị các cạnh của loại được chỉ định, có quan hệ với một nguồn gốc được chỉ định đến một cấp độ và hướng cụ thể.

Thêm bí danh: Trong cửa sổ Thêm bí danh, nhập tên bí danh, chọn loại bộ lọc Truy vấn tìm kiếm cạnh, chọn loại thực thể và thực thể muốn hiển thị quan hệ. Đặt hướng là Từ hoặc Đến, cấp độ quan hệ tối đa và chỉ định loại cạnh để lọc.

Ví dụ: Bí danh lọc các cạnh có loại “phiên bản cạnh” có quan hệ với tài sản “Tòa nhà A” với hướng Từ và cấp độ quan hệ 1.

Sử dụng trong widget: Trong nhóm widget Bảng, chọn widget Bảng thực thể. Chuyển đến tab Bí danh thực thể, chỉ định bí danh Truy vấn tìm kiếm cạnh trong trường Bí danh thực thể, thêm khóa name và type trong phần Cột. Nhấp Thêm và áp dụng thay đổi. Widget bảng thực thể hiển thị các cạnh có quan hệ với tài sản “Tòa nhà A” đến cấp độ quan hệ 1 đã được thêm.