starface-mail2fax/README.md

2.1 KiB

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_v54.sfm) verwenden möchtest:

# 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_v54.sfm

Fertig! Weiter mit der Konfiguration.

Option 2: Selbst kompilieren (für Entwickler)

Wenn du den Code ändern möchtest:

# 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_v54.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 für die Anleitung zur Integration im Module Designer.