rails-bulk-xl

Generate XLSX templates and parse XLSX/CSV files with per-row validation.

Updated Oct 12, 2024
One-click install
npx skills add https://github.com/samrocks03/shuttle-office-service --skill rails-bulk-xl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: rails-bulk-xl
Source: https://github.com/samrocks03/shuttle-office-service/tree/main/.claude/skills/rails-bulk-xl
Command: npx skills add https://github.com/samrocks03/shuttle-office-service --skill rails-bulk-xl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bulk Excel imports and exports in Rails apps are error-prone and labor-intensive. This skill standardizes templates, parsing, and per-row validation, reducing manual data handling and improving data quality.

Core Features & Use Cases

  • Template generation using caxlsx to produce XLSX templates with headers and a sample row.
  • Spreadsheet parsing via Roo to read .xlsx and .csv files into Ruby objects.
  • Per-row validation with aggregate error reporting for all problematic rows.
  • Service-based processing and type-parameterized endpoints to support multiple resources.
  • Common workflows: download template, fill data, and bulk_create to import; export data in bulk as needed.

Quick Start

Generate a template via bulk_template for your resource, fill in the data, and upload it to bulk_create to import records with per-row feedback.

Frequently Asked Questions about rails-bulk-xl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I handle bulk Excel imports in Rails with per-row validation?▼

Bulk Excel imports in Rails are handled by parsing spreadsheets with Roo, validating each row individually, and collecting aggregate row-level errors. This automated workflow standardizes data handling and improves import data quality.

How do I generate an XLSX export template in Rails for bulk data entry?▼

XLSX export templates in Rails are generated using caxlsx to create structured files with predefined headers and a sample row. This provides a standardized format for users to fill in data before uploading it for bulk processing.

Can I parse both XLSX and CSV files for bulk operations in Rails?▼

Yes, both XLSX and CSV files are parsed for bulk operations using the Roo gem in Rails. The spreadsheet data is read into Ruby objects, enabling consistent service-based processing and validation across both file formats.

What is the best way to report errors during Rails spreadsheet imports?▼

The best way to report spreadsheet import errors in Rails is through per-row validation with aggregate error reporting. This method identifies all problematic rows and returns detailed row-level feedback rather than failing on the first error encountered.

Does Rails bulk import support multiple resources with different data types?▼

Yes, Rails bulk import supports multiple resources through type-parameterized endpoints and service-based processing. This design allows a single workflow to handle different resource types while maintaining consistent parsing and per-row validation logic.