Start With the Basics
      Back to home
      1. Home
      2. 3: Create Your First App
      3. Start With the Basics

      4 Steps to Build an App in Rayven.io

      By following these steps, you can build a fully functional app in Rayven.io. From defining your data structure with a primary table to configuring workflows, user access, and white-labeling.

      Steps to Build an App in Rayven.io

      Building an app on Rayven.io involves several key steps, from structuring your data to creating workflows, defining customer access, and customizing the user interface. This guide will walk you through each step to help you successfully build your app.

      1. Creating Your Primary Table

      The Primary Data Table serves as the foundation of your app. It contains structured data that is central to your solution, with key attributes (or labels) that will be used throughout your workflows and interfaces.

      Steps:

      • Navigate to the Rayven Workspace.
      • Select Tables and create a new primary table. This table will store critical data, such as devices, customers, or any other entities relevant to your app.
      • Define the fields for the table, such as:
        • Device ID
        • Building Name
        • Energy Consumption
        • Timestamp
      • Add labels to your data. Labels categorize your data and help with filtering and grouping later in workflows and dashboards.
        • Example Labels: Location, Device Type, Department.

      2. Creating Your Workflow

      Workflows in Rayven.io allow you to define how data is ingested, processed, and visualized. They are created using a drag-and-drop interface, enabling you to automate processes and connect data across various systems.

      Key Components of a Workflow:

      1. Connecting Data Sources:

        • Use input nodes to connect to your data sources, such as APIs, IoT devices, or external databases. Supported connectors include HTTP, Modbus, MQTT, and more.
        • Ensure the data is normalized and mapped correctly to your primary table fields for consistency.

      2. Adding Triggers:

        • Triggers activate specific actions in your workflow based on conditions. For example, a trigger could be set when a device exceeds a temperature threshold, sending an alert to the operator.

      3. Business Logic:

        • Add logic nodes to define how your data is processed. This includes filtering data by labels (e.g., filtering by location) and grouping it (e.g., grouping data by building for energy aggregation).
        • You can also apply calculation nodes to perform advanced calculations on the data.

      4. Automation for Alerts and Notifications:

        • Use output nodes to send alerts or notifications via email or SMS when specific conditions are met. For example, notify maintenance staff if a machine shows signs of malfunction.

      5. Define Dashboard Widgets:

        • Add visualization nodes to define how data is displayed in dashboards. You can choose from various widgets, such as tables, charts, gauges, and maps, depending on the data and insights you want to present.

      6. Push Data to Other Systems:

        • If needed, configure output connectors to push processed data to other systems or external applications.

      3. Defining Customer Groups and Customers

      Once your workflows are set up, you may want to allow specific users or customers to access your dashboards and interfaces. This is done by defining User Groups and Customers in Rayven.

      Steps:

      • Navigate to User Management.
      • Create Customer Groups based on their roles or access levels (e.g., "Electricians," "Managers").
      • Assign Users to their respective groups, ensuring each customer only has access to the dashboards and data relevant to them.
        • Example: An electrician might only see energy consumption data, while managers can access both energy and financial data.

      By setting up user groups, you can control which users have access to specific data or interfaces, ensuring proper data security and relevance.

      4. Configuring Widgets on Dashboards

      Now that your workflow is processing data and user groups are defined, it’s time to configure your dashboards. Dashboards in Rayven allow users to visualize data and interact with it through widgets.

      Steps:

      • Navigate to Dashboards in the Rayven Workspace.
      • Create or edit a dashboard and define which widgets (charts, tables, maps, etc.) should be displayed.
      • Assign widgets to specific user groups based on their roles.
        • Example: In an energy monitoring app, building managers might have access to energy consumption charts, while maintenance staff might have access to real-time equipment status tables.

      You can also configure the dashboard’s navigation type:

      • Permanent Dashboards: Always visible as a tab.
      • Drill-Down Dashboards: Only accessible through a specific action, such as clicking on a device or widget.

      Final Thoughts

      By following these steps, you can build a fully functional app in Rayven.io. From defining your data structure with a primary table to configuring workflows, user access, and white-labeling, Rayven provides a flexible, low-code platform to create custom solutions tailored to your business needs. Make sure you continuously test your app to ensure all workflows, triggers, and dashboards work seamlessly for your users.