70 lines
2.1 KiB
Markdown
70 lines
2.1 KiB
Markdown
# Mail2Fax für STARFACE
|
|
|
|
Custom Block für den STARFACE Module Designer - E-Mails abrufen und PDF-Anhänge als Fax versenden.
|
|
|
|
## Quick Start
|
|
|
|
### Option 1: Fertig-Modul verwenden (Empfohlen für Endbenutzer)
|
|
|
|
Wenn du das fertige Modul (`fax2Mail_v53.sfm`) verwenden möchtest:
|
|
|
|
```bash
|
|
# 1. JavaMail auf STARFACE installieren
|
|
./install-javamail.sh <starface-ip>
|
|
|
|
# 2. STARFACE neustarten
|
|
ssh root@<starface-ip> 'systemctl restart tomcat'
|
|
|
|
# 3. Modul importieren
|
|
# STARFACE Admin → Module → Module Designer → "Modul importieren"
|
|
# Datei auswählen: fax2Mail_v53.sfm
|
|
```
|
|
|
|
**Fertig!** Weiter mit der [Konfiguration](v8-9-10/INSTALLATION.md#teil-2-modul-konfiguration).
|
|
|
|
### Option 2: Selbst kompilieren (für Entwickler)
|
|
|
|
Wenn du den Code ändern möchtest:
|
|
|
|
```bash
|
|
# 1. Java 21 installieren (falls nötig)
|
|
./install-java21.sh
|
|
|
|
# 2. STARFACE APIs holen (inkl. JavaMail-Installation)
|
|
./fetch-starface-libs.sh <starface-ip>
|
|
|
|
# 3. Block kompilieren
|
|
cd v8-9-10
|
|
./build-block.sh
|
|
```
|
|
|
|
## Projektstruktur
|
|
|
|
```
|
|
mail2fax/
|
|
├── fax2Mail_v53.sfm # Fertig-Modul (zum Importieren)
|
|
├── install-javamail.sh # Installiert NUR JavaMail (für Fertig-Modul)
|
|
├── fetch-starface-libs.sh # Holt STARFACE APIs + JavaMail (für Entwickler)
|
|
├── install-java21.sh # Installiert Java 21 (für Entwickler)
|
|
├── README.md
|
|
└── v8-9-10/ # Für STARFACE 8/9/10
|
|
├── Mail2FaxBlock.java # Custom Block Quellcode
|
|
├── Mail2FaxCleanup.java # Cleanup Block
|
|
├── build-block.sh # Kompilier-Script
|
|
├── libs/starface/ # STARFACE JARs (nach fetch)
|
|
├── README.md # Technische Dokumentation
|
|
├── INSTALLATION.md # Schritt-für-Schritt Handbuch
|
|
└── docu/ # Screenshots
|
|
```
|
|
|
|
## Funktionsweise
|
|
|
|
1. Block ruft E-Mails per IMAP/POP3 ab
|
|
2. Ziel-Faxnummer wird aus dem Betreff gelesen
|
|
3. PDF-Anhänge werden als Fax gesendet
|
|
4. E-Mails werden als gelesen markiert oder gelöscht
|
|
|
|
## Installation
|
|
|
|
Siehe [v8-9-10/README.md](v8-9-10/README.md) für die Anleitung zur Integration im Module Designer.
|