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.