Ak-ram / excel-processor

This script analyzes an Excel file, organizes data by a specified column, generates individual Excel files for each group, and produces a summary sheet.

Excel Processor 📊

This script processes an Excel file, groups data based on a specific column, and creates new Excel files for each group. It also generates a summary sheet.

Getting Started 🚀

Prerequisites

• Node.js installed on your machine 🌐
• npm package manager 📦

Installation

1. Clone the repository:

   git clone https://github.com/your-username/your-repo.git

2. Install dependencies:

   npm install

Usage

Run the script with the following command:

node excelProcessor.js /path/to/your/excel/file.xlsx

Replace /path/to/your/excel/file.xlsx with the actual path to your Excel file.

Showcase 📽️

Code Overview 🧐

The script uses Node.js and several npm packages, including XLSX and XlsxPopulate, to process Excel files. It performs the following steps:

1. Reads the Excel file.
2. Groups data based on a specified column (in this case, 'الجهة').
3. Creates a new workbook for each group, applying styling and adding a summary row.
4. Generates a summary sheet with information about each created sheet.

Folder Structure 📁

• js/: Contains utility functions and data used by the main script.
• excelProcessor.js: The main script for processing Excel files.

Customization ⚙️

• Modify the script to suit your specific Excel file structure.
• Adjust the path to the Excel file, column names, and other parameters as needed.

Important

• This script is specifically crafted to handle Excel sheets containing tables with a predefined header.
• The required headers are: [الاسم, الرقم القومى, الجهة, المبلغ, التوقيع], as illustrated in the accompanying image.

License 📜

This project is licensed under the MIT License - see the LICENSE file for details.