Labels, combined with filters and user groups, provide tremendous flexibility and control, allowing you to customize how data is presented, processed, and accessed based on specific user roles or organizational needs.
What Are Labels?
In Rayven.io, Labels are attributes that categorize and tag data in a structured way, allowing you to efficiently filter, group, and manage data across workflows, dashboards, and user interfaces. Labels help organize data into meaningful categories, enabling you to slice and dice data based on specific criteria such as location, device type, or department.
Labels can be applied to various data entities, including devices, data streams, or even primary data tables in the structured MySQL database. These labels make it easier to control data access, apply filters, and display data in a tailored way to different user groups.
How Labels Work
Labels are generally associated with attributes that define key aspects of the data. These attributes can represent almost any form of information that helps describe the data point—such as the location of a device, the department using the data, or the type of device generating the data.
Examples of common label types include:
- Location (e.g., 'Building Name', 'City')
- Device Type (e.g., 'Energy Meter', 'Sensor')
- Department (e.g., 'Electrical', 'Finance')
- Asset Type (e.g., 'Bus', 'Truck')
Once data is labeled, these labels can be used throughout the platform to create customized filters, group data, and control user access to specific information.
Using Labels for Data Grouping and Filtering
One of the most powerful features of labels in Rayven.io is their ability to filter and group data. By applying labels to your data, you can control what information is presented in your workflows and dashboards.
Data Grouping
Labels allow you to group data in meaningful ways. For instance:
- Group energy consumption data by Building Name to analyze energy usage for each building separately.
- Group devices by Device Type to show trends and patterns across different types of sensors.
Example: If your primary data table has a label for Building Name, you can group the data by building in your workflow and display aggregated metrics for each building in your dashboards.
Data Filtering
Labels also enable filtering, allowing you to focus on specific subsets of data. Filters use labels to narrow down the dataset, ensuring users only see the information that is relevant to them.
Example: If you have a label for Department, you can create a filter that only shows data from the Electrical Department, hiding data from other departments like Finance.
Labels in the Context of Workflows
In Rayven.io, labels play an essential role within workflows by providing flexible ways to manage and control data processing. When data is ingested into a workflow from the unstructured Cassandra database, it can be linked to specific labels defined in the Primary Data Table (stored in MySQL).
Label-based Filtering in Workflow Nodes:
- Within each node in the workflow, you can filter data by any of the labels that have been defined in the primary data table. This ensures that only the labeled data relevant to that part of the workflow is processed or visualized.
- You can also use these labels to group data at different stages of the workflow, allowing for detailed insights and data summaries.
For example:
- You could set up a workflow that groups data by Building Name to pre-process and aggregate energy consumption data for each building before visualizing it on a dashboard.
- In another node, you could filter the workflow to display only devices labeled as Energy Meters from the Sydney location.
Example Use Case: Building Energy Management
Scenario: A company wants to monitor and analyze energy consumption across multiple buildings and ensure different user groups see only the relevant data.
Labels in Use:
- Building Name (e.g., "Sydney HQ", "New York Office")
- Device Type (e.g., "Energy Meter", "HVAC Sensor")
- Department (e.g., "Electrical", "Finance")
Steps:
-
Applying Labels:
- Devices are labeled with Building Name and Device Type.
- Data from each device is tagged with these labels as it is ingested into the workflow.
-
Filtering Data:
- The workflow filters data by Building Name so that users in the Sydney HQ group see only data from Sydney.
- A second filter based on Device Type ensures that Electrical Department users only see energy meter data, while Finance Department users can access financial reports.
-
Grouping Data:
- Labels are used to group energy consumption data by Building Name, providing aggregated metrics for each building on the dashboard.
- A further breakdown by Device Type is used to display specific trends for different types of devices.
Labels and User Groups
The concept of Labels in Rayven.io is closely tied to User Groups. By applying labels to data and devices, you can control which users see specific types of information based on their group membership.
For example:
- An Electricians user group might only have access to data labeled as Energy Meter and Electrical Department, while a Finance Managers user group sees data labeled as Finance and Building Costs.
This label-based control allows organizations to tailor data visibility and access, ensuring that each user only sees the relevant data they need, while protecting sensitive or irrelevant information.
Conclusion
In Rayven.io, Labels are a powerful way to categorize and organize your data. By applying labels to data in the Primary Data Table, you can easily group and filter data within workflows, control what data users see in their dashboards, and ensure that workflows are processing only the relevant data.
Labels, combined with filters and user groups, provide tremendous flexibility and control, allowing you to customize how data is presented, processed, and accessed based on specific user roles or organizational needs.