Files
Vangest/README.md
T
2026-05-22 10:14:38 +00:00

268 lines
6.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# <div align="center">Vangest Excel VBA Production Management Tool</div>
---
## <div align="center">Overview</div>
Vangest is a Microsoft Excel VBA-based management tool designed to support production monitoring, machine-hour control, reporting automation and KPI visualization.
The workbook uses VBA macros, UserForms, automated PDF exports, Outlook integration and Power BI access to simplify operational reporting across different production areas.
---
# <div align="center">Main Features</div>
## User Authentication
- Login system with user/password validation
- User registration form
- Restricted access to management menus
- Workbook auto-save on exit
---
## Production Area Management
The system organizes machines by production area:
| Area | Description |
|:---:|:---:|
| Small Moulds | Small mould production machines |
| Medium Moulds | Medium mould production machines |
| Large Moulds | Large mould production machines |
| DT2 / Automation | Automation and complementary production areas |
---
## Machine Hour Registration
The workbook allows the user to insert and manage weekly machine-hour values for several machines, including:
| Small Moulds | Medium Moulds | Large Moulds |
|:---:|:---:|:---:|
| Makino D500_1 | Makino F5_nova | DMU 160P |
| Makino D500_2 | Makino F8 | DMU 340 Gantry |
| Makino V33 | DMU 70 Evo CNC | Awea |
| Kern | DMU 50 Evo | FPT60 |
| Ingersoll CNC | DMC 100V | FPT80 |
| Makino U3 | Sodick AG100L | DMC 125 |
| GF Cut 2000S | Fanuc Robocut | Sodick AQ15L |
---
# <div align="center">VBA Automation</div>
## Main VBA Functionalities
| Module / Feature | Description |
|:---:|:---:|
| Login Form | Validates user access |
| Registration Form | Adds users to the workbook database |
| Menu Form | Central navigation interface |
| Weekly Hours Form | Inserts machine-hour values |
| PDF Export | Exports predefined Excel ranges to PDF |
| Outlook Automation | Creates and sends emails with reports attached |
| Power BI Shortcut | Opens the associated Power BI dashboard |
| Cache Cleaning | Clears temporary or calculated values |
| Sheet Creation | Creates yearly sheets based on templates |
---
# <div align="center">Report Generation</div>
The workbook can generate PDF reports for:
- Small Moulds
- Medium Moulds
- Large Moulds
- DT2 / Automation
- General listings
- Weekly machine-hour summaries
Generated reports are exported from predefined Excel ranges and can be automatically attached to Outlook emails.
---
# <div align="center">Outlook Integration</div>
The VBA macros include Microsoft Outlook automation for:
- Creating email messages
- Defining recipients
- Adding subjects
- Writing automatic message bodies
- Attaching generated PDF reports
- Sending weekly reports
Example report subjects include:
```txt
Small Mould Semana
Medium Mould Semana
Large Mould Semana
DT2 Mould Semana
```
---
# <div align="center">Power BI Integration</div>
The workbook includes a shortcut to open a Power BI dashboard file:
```txt
Vangest.pbix
```
This allows the user to access KPI visualizations linked to the Excel-based production data.
---
# <div align="center">Technologies Used</div>
| Technology | Purpose |
|:---:|:---:|
| Microsoft Excel | Main platform |
| VBA | Automation logic |
| UserForms | Graphical user interface |
| Outlook VBA Automation | Email reporting |
| Power BI | KPI visualization |
| PDF Export | Report generation |
| Excel Charts | Data visualization |
---
# <div align="center">Workbook Structure</div>
```txt
Vangest.xltm.xlsm
├── Registos
├── Gráficos
├── Small Moulds
├── Medium Moulds
├── Large Moulds
├── Automation / DT2
├── UserForms
└── VBA Modules
```
---
# <div align="center">Main Workflow</div>
```txt
User Login
Select Production Area
Choose Machine
Insert Weekly Values
Update Excel Records
Generate Reports
Export PDF
Send by Outlook
Open Power BI Dashboard
```
---
# <div align="center">Key Functional Areas</div>
## Data Registration
- Weekly machine-hour input
- Machine selection through ComboBoxes
- Area-based categorization
- Automatic workbook saving
## Reporting
- PDF report generation
- Weekly report exports
- Automatic file naming with date/time
## Dashboard Support
- Excel chart-based analysis
- Power BI file launching
- KPI reporting support
## User Management
- Login validation
- User registration
- Permission-based access logic
---
# <div align="center">Requirements</div>
| Requirement | Description |
|:---:|:---:|
| Microsoft Excel | Required to run the workbook |
| VBA Macros Enabled | Required for automation |
| Microsoft Outlook | Required for email automation |
| Power BI Desktop | Required to open `.pbix` dashboards |
| Windows OS | Recommended environment |
---
# <div align="center">How to Use</div>
1. Open the workbook.
2. Enable macros.
3. Login using a valid user.
4. Access the main menu.
5. Select the desired production area.
6. Insert machine-hour values.
7. Generate reports.
8. Export PDFs.
9. Send reports through Outlook.
10. Open Power BI dashboard if needed.
---
# <div align="center">Security Notes</div>
This workbook contains VBA macros and should only be used in a trusted environment.
Before execution:
- Verify the source of the file
- Enable macros only if trusted
- Review email recipients before sending reports
- Confirm PDF outputs before distribution
---
# <div align="center">Future Improvements</div>
- Replace hardcoded paths with dynamic configuration
- Add database integration
- Improve user authentication
- Add role-based permissions
- Create automatic backup system
- Improve error handling
- Add configuration sheet for email recipients
- Migrate reporting logic to Power BI or web dashboard
---
# <div align="center">Disclaimer</div>
This workbook was developed as an internal production management and reporting automation tool.
Users remain responsible for validating inserted data, exported reports and email recipients before official use.
---
# <div align="center">Author</div>
José Garcia
Data Scientist
Process Digitalization & Automation