npm package: @growthzilla/piece-proma
Description: A comprehensive integration piece for [Proma.ai](https://proma.ai) that enables automation workflows with datasets, user management, time tracking, biometric access control, and more.
Latest version: 0.0.61

# Proma.ai Piece for Activepieces

A comprehensive integration piece for [Proma.ai](https://proma.ai) that enables automation workflows with datasets, user management, time tracking, biometric access control, and more.

## Overview

This piece provides seamless integration between Activepieces and Proma.ai, allowing you to automate workflows involving:

- **Dataset Management**: Create, read, update, and delete records in your Proma datasets
- **User Management**: Invite, update, and manage users in your organization
- **Time Tracking**: Start and stop timers for project and task management
- **Biometric Integration**: Connect with Anviz access control systems for fingerprint and card enrollment
- **Automation Triggers**: React to dataset changes, imports, and biometric events
- **Utility Functions**: JSON manipulation, date formatting, and data processing helpers


## Available Actions

### Dataset Operations
- **Insert Row**: Add new records to your datasets
- **Update Row**: Modify existing records
- **Delete Row**: Remove records from datasets
- **Get Row**: Retrieve specific records or search for data
- **Update Selected Rows**: Batch update multiple records at once
- **Row Lock**: Lock records to prevent concurrent modifications

### User Management
- **Invite User**: Send invitations to new users
- **Update User**: Modify user information and permissions
- **Remove User**: Deactivate or remove users from the organization

### Time Tracking
- **Time Tracking**: Start or stop timers for records to track work hours and productivity

### Biometric Access Control (Anviz)
- **Enroll Fingerprint**: Register user fingerprints in the biometric system
- **Add Anviz Employee**: Create employee profiles in the access control system
- **Add Anviz Device**: Register new access control devices
- **Enroll Card**: Register access cards for users

### Communication
- **Send Email**: Send automated emails through Proma

### Utility Functions
- **JSON Stringify**: Convert objects to JSON strings
- **JSON Extract**: Parse and extract data from JSON
- **Array Helper**: Manipulate arrays and perform bulk operations
- **Date/Time Operations**: Get current date/time and format dates
- **AI Block**: Leverage AI capabilities for data processing
- **Debounce**: Prevent action spam with configurable delays

### Organization Management
- **Get Spaces**: List all available spaces in your organization
- **Get Sheets**: Retrieve datasets within a specific space
- **Get Sheet Columns**: Get column information and types
- **Get Organization Info**: Retrieve organization details and settings

## Available Triggers

### Dataset Events
- **Record Updated**: Triggers when existing records are updated
- **Record Inserted**: Triggers when new records are added
- **Cell Updated**: Triggers when specific cells are modified
- **Import Data**: Triggers when data is imported into datasets

### Biometric Events
- **Fingerprint Event**: Triggers on fingerprint authentication events

### Automation
- **Run Automation Trigger**: Manual trigger for testing automation flows

## Features

### Advanced Filtering & Conditions
- Configure trigger conditions with logical operators
- Set up filter logic for precise event detection
- Enable trigger debouncing to prevent spam

### Real-time Webhook Support
- Instant notifications for dataset changes
- Configurable webhook endpoints
- Automatic webhook management

### Data Processing
- Rich data transformation capabilities
- JSON parsing and manipulation
- Array operations for bulk data handling
- Date and time formatting utilities

## Use Cases

### Project Management
- Track time spent on tasks and projects
- Send notifications when tasks are completed
- Update project status based on team activities

### Access Control Integration
- Automate employee onboarding with biometric enrollment
- Monitor access events and generate reports
- Sync user data between systems

### Data Automation
- Process incoming data and transform it automatically
- Generate reports from dataset changes
- Send alerts based on specific data conditions

### User Lifecycle Management
- Automate user invitations and onboarding
- Update user permissions based on role changes
- Manage user access and security settings

## Building

Run `nx build pieces-proma` to build the library.

## Requirements

- Activepieces version 0.30.0 or higher
- Valid Proma.ai account and workspace
- Appropriate permissions for the operations you want to perform

## Support

For issues and questions about this piece, please contact Proma.ai support or check the [Activepieces documentation](https://activepieces.com/docs).