Getting Started
Create your first List View in a few simple steps
Step 1: Create a New List View
- Go to Workflows V2 in your Leena AI dashboard
- Click Applications in the left menu
- Click the Create New button
- Choose List View from the template options
- Enter a name for your List View (e.g., "Employee Directory")
- Add a description so others know what it's for
- Click Create
Your List View is now created with a basic workflow ready to configure.
Step 2: Understanding the List View Builder
The List View builder has 5 steps shown as tabs at the top:
| Step | Tab Name | What You Do Here |
|---|---|---|
| 1 | Customize Table | Add and configure table columns |
| 2 | Global Constants | Set up fixed values used across the List View |
| 3 | Set Workflows | Configure how data is fetched |
| 4 | Set Actions | Add buttons like Approve, View, Edit |
| 5 | Set Filters | Create filter options for users |
Step 3: Customize Your Table (Step 1)
This is where you define what columns appear in your table.
Adding Columns
- Click Add Column button
- Configure the column:
- Column Name: What users see (e.g., "Employee Name")
- Field: The data field this column shows
- Type: How it displays (text, date, status, etc.)
- Click Save
Managing Columns
- Reorder: Drag columns to change their order
- Edit: Click a column to change its settings
- Delete: Remove columns you don't need
- Manage Table: Click to see all columns and table settings
Layout Options
Click Customize Layout to adjust how the table looks, including column widths and visibility.
Step 4: Set Up Global Constants (Step 2)
Global constants are fixed values that can be used throughout your List View, such as:
- API endpoints
- Default values
- Configuration settings
Your administrator may set these up, or you can add them as needed.
Step 5: Configure the Workflow (Step 3)
This is where you tell the List View where to get its data. The workflow builder (Flow Canvas) lets you visually design how data flows.
Understanding the Default Workflow
When you create a List View, it comes with a basic workflow:
┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Trigger │ → │ Mapper │ → │ End │
└──────────────┘ └──────────────┘ └──────────────┘
| Node | Purpose |
|---|---|
| Trigger | Receives user inputs (search text, filters, page number) |
| Mapper | Transforms data to match your table columns |
| End | Completes the workflow |
Adding Data Fetching
To fetch data from external systems, you need to add nodes between the Trigger and Mapper:
- Open the Set Workflows tab
- In the Flow Canvas, click to add a new node
- Choose the type of node:
| Node Type | Use For |
|---|---|
| Action | Connect to external systems (HR, databases, APIs) via connectors |
| Function | Write custom logic to fetch or process data |
Using Action Nodes (Connectors)
Action nodes connect to external systems through Synapse connectors:
- Add an Action node to your workflow
- Select the connector (e.g., Workday, SAP, ServiceNow)
- Choose the connection (your organization's configured connection)
- Select the action (e.g., "Get Employees", "Search Records")
- Map the input parameters (pass search/filter values from the Trigger)
- Connect the node's output to the Mapper
Configuring the Mapper Node
The Mapper transforms the data from your Action node into the format your table needs:
- Click on the Mapper node
- For each table column, map the source field:
- Name column ← Employee Name field from API response
- Email column ← Email Address field from API response
- Department column ← Department field from API response
- Save the mappings
Example Workflow: Employee Directory
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ Trigger │ → │ Action │ → │ Mapper │ → │ End │
│ │ │ (Workday │ │ │ │ │
│ search, │ │ Get │ │ Map fields │ │ │
│ filters │ │ Employees) │ │ to columns │ │ │
└──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘
Step 6: Add Row Actions (Step 4)
Actions are buttons that appear on each row. See the Adding Actions guide for details.
Quick steps:
- Go to Set Actions tab
- Click Add Action
- Configure the action (name, type, what it does)
- Set conditions for when it appears
- Save
Step 7: Configure Filters (Step 5)
Filters help users narrow down the data:
- Go to Set Filters tab
- Use the Form Builder to add filter fields
- For each filter:
- Set the label (e.g., "Department")
- Choose the type (dropdown, date picker, etc.)
- Configure the options
- Save
The filter values are automatically passed to your workflow's Trigger node.
Step 8: Preview and Test
Before publishing:
- Click the Preview button
- Test on Desktop view
- Test on Mobile view
- Try searching and filtering
- Verify data displays correctly
- Test any action buttons
Step 9: Publish
When everything works:
- Click Publish
- Confirm the publish
- Your List View is now live
Where Users Find Your List View
Published List Views appear in:
- The List Views section of the Workflow dashboard
- Direct links you share
- Embedded locations (if configured)
Summary: How Data Flows
User opens List View
↓
Types search, selects filters
↓
Trigger node receives inputs
↓
Action node fetches data from external system
↓
Mapper node transforms data for table
↓
Table displays results
↓
User clicks action buttons
Updated about 13 hours ago
