--- title: "Konfiguration" weight: 20 description: "Einrichtung des Moduls DoliPDF: Umwandlungsmodus, entfernter Server, lokaler Befehl und Optionen." source_hash: "e45450a4" --- # Konfiguration Die Konfiguration des Moduls erreichen Sie unter **Start > Einstellungen > Module > Dolipdf**, Registerkarte **Konfiguration**. ![Konfigurationsseite des Moduls DoliPDF mit den Umwandlungseinstellungen](screenshots/configuration-dolipdf.webp) ## Umwandlungsmodus DoliPDF bietet zwei Umwandlungsmodi, die getrennt verwendet werden können. ### Fernmodus (Standard) Die ODT-Datei wird an einen DoliPDF-Server gesendet, der sie in PDF umwandelt. Dieser Modus ist am einfachsten einzurichten. | Einstellung | Beschreibung | |-------------|--------------| | Adresse des DoliPDF-Servers | URL des Umwandlungsservers. Der Standardwert ist `https://pdf.cap-rel.fr`. | | E-Mail-Adresse Ihres Kontos | Die mit Ihrem Konto auf dem DoliPDF-Server verknüpfte E-Mail-Adresse. | | API-Schlüssel auf dem DoliPDF-Server | Authentifizierungsschlüssel des Dienstes. Er wird automatisch gespeichert, wenn Sie Ihr Konto über die Registerkarte **Konto eröffnen** eröffnen. Formatbeispiel: `1\|lUr8Tj4fHZZZmpwAAAMpBBBDb8KCCC5Iw5DDD2sH`. | ### Ihr Konto aus Dolibarr eröffnen Sie haben noch kein DoliPDF-Konto? Eröffnen Sie es, ohne Dolibarr zu verlassen und ohne etwas zu kopieren: 1. Öffnen Sie die Registerkarte **Konto eröffnen** der Modulkonfiguration. Sie zeigt die Daten Ihres Unternehmens, die übermittelt werden (Firmenname, E-Mail, Land, SIREN, Adresse), gelesen aus **Start > Einstellungen > Unternehmen/Organisation** 2. Klicken Sie auf **Mein Konto auf pdf.cap-rel.fr eröffnen** und dann auf **Weiter zur Zahlung**: Die Bestellseite öffnet sich in einem neuen Tab, mit diesen bereits ausgefüllten Daten. Wählen Sie Ihren Tarif, korrigieren Sie, was nötig ist, und bezahlen Sie 3. Kehren Sie zur Registerkarte **Konto eröffnen** zurück: Sie aktualisiert sich selbst, sobald die Zahlung eingegangen ist, und der API-Schlüssel wird in der Modulkonfiguration gespeichert. Die Schaltfläche **Ich habe bezahlt, jetzt prüfen** erzwingt die Prüfung bei Bedarf An die Adresse der Bestellung wird eine E-Mail gesendet, damit Sie das Passwort Ihres Kontos auf dem DoliPDF-Server wählen können. Dort finden Sie Ihre Rechnungen und Ihre API-Schlüssel. Gehört die E-Mail-Adresse der Bestellung bereits zu einem Konto, wird der Tarif diesem Konto hinzugefügt und kein neuer Schlüssel erstellt: Geben Sie dann den bestehenden Schlüssel dieses Kontos ein. Sie haben bereits ein Konto? Erstellen Sie einen Schlüssel über das Menü **API-Token** und dann **Neu** in Ihrem Konto auf dem DoliPDF-Server, und fügen Sie ihn in das Feld **API-Schlüssel** der Registerkarte **Konfiguration** ein. ### Verbindung testen Die Schaltfläche **Verbindung testen** unter den Parametern der Registerkarte **Konfiguration** prüft in wenigen Sekunden, ob die Fernumwandlung funktionieren wird, ohne ein Dokument umzuwandeln oder Ihren Tarif zu belasten. Sie prüft die Serveradresse (vollständig und mit https), das Vorhandensein und das Format des API-Schlüssels und fragt dann den DoliPDF-Server ab. Das Ergebnis wird oben auf der Seite angezeigt: - **Verbindung OK**: Der Server antwortet und akzeptiert den Schlüssel. Die Meldung nennt das verwendete Konto und, sofern der Server sie mitteilt, die Zahl der noch verfügbaren Umwandlungen - **Warnung**: Der Schlüssel ist gültig, aber kein Tarif ist aktiv oder der Tarif ist aufgebraucht. Ein Link führt zur Bestellseite - **Fehler**: Die Meldung nennt die Ursache (fehlende oder http-Adresse, fehlender oder unvollständiger Schlüssel, Server mit Netzwerkdetail nicht erreichbar, Schlüssel abgelehnt, Konto gesperrt, Serverfehler) und was zu tun ist ### Lokaler Modus (LibreOffice) Wenn LibreOffice auf Ihrem Server installiert ist, können Sie lokal umwandeln, ohne Ihre Dokumente an einen externen Server zu senden. | Einstellung | Beschreibung | |-------------|--------------| | LibreOffice verwenden, das lokal auf Ihrem Server installiert ist | Aktiviert den lokalen Umwandlungsmodus. | | Lokaler Befehl zum Erzeugen des PDFs aus der ODT-Datei | Systembefehl, der für die Umwandlung ausgeführt wird. Füllen Sie dieses Feld nur aus, wenn Sie den lokalen Modus aktivieren. | > **Achtung**: Ist der lokale Modus deaktiviert, verhindert DoliPDF automatisch jede lokale Ausführung von LibreOffice, auch wenn die Dolibarr-Konstante `MAIN_ODT_AS_PDF` gesetzt ist. So werden ungewollte lokale Umwandlungen vermieden. ## Optionen ### Benachrichtigungen | Einstellung | Beschreibung | |-------------|--------------| | Benachrichtigungen oben rechts anzeigen, wenn PDF-Dateien erzeugt werden | Zeigt nach jeder Umwandlung eine Bestätigungs- oder Fehlermeldung an. | ### Dateiverwaltung | Einstellung | Beschreibung | |-------------|--------------| | ODT-Datei löschen, wenn das PDF erfolgreich erzeugt wurde | Löscht die ODT-Quelldatei automatisch, sobald die PDF-Umwandlung gelungen ist, sodass nur die endgültige PDF-Datei erhalten bleibt. | ### Leistung | Einstellung | Beschreibung | |-------------|--------------| | Automatische PDF-Erstellung bei jedem Hinzufügen oder Ändern einer Artikelzeile deaktivieren | Verhindert die automatische Neuerzeugung des PDFs, wenn Sie eine Zeile in einem Dokument (Rechnung, Angebot, Auftrag) hinzufügen oder ändern. Das PDF wird dann nur erzeugt, wenn Sie das Dokument ausdrücklich erzeugen. | | DoliPDF nur für validierte Dokumente ausführen | Beschränkt die PDF-Umwandlung auf Dokumente mit dem Status "Validiert". Entwürfe lösen keine Umwandlung aus. Diese Option spart Nutzung des entfernten DoliPDF-Dienstes. | ## Übermittelte Daten und Datenschutz Um seinen Dienst zu erbringen, übermittelt das Modul die folgenden Informationen. ### Bei jeder Umwandlung im Fernmodus - Der Inhalt der umzuwandelnden ODT-Datei, gesendet an den konfigurierten DoliPDF-Server (standardmäßig `https://pdf.cap-rel.fr`), zusammen mit Ihrem API-Schlüssel und der E-Mail-Adresse Ihres Kontos - Eine technische Installationskennung (`DOLIPDF_UUID`): eine einmal erzeugte Zufallskennung, in der Dolibarr-Datenbank gespeichert, die zwei Installationen unterscheidet, ohne ihre Identität preiszugeben - Der Name Ihres Unternehmens, wie in der Dolibarr-Konfiguration angegeben (Menü **Start > Einstellungen > Unternehmen/Organisation**), übermittelt im Feld User-Agent der HTTP-Anfrage - Die Sprache Ihres Dolibarr, damit der DoliPDF-Server seine Meldungen in dieser Sprache verfasst Der lokale Umwandlungsmodus (LibreOffice) stellt keine Anfrage nach außen: Ihre Dokumente bleiben auf Ihrem Server. ### Bei einem Verbindungstest - Ihr API-Schlüssel, an den konfigurierten DoliPDF-Server gesendet, mit dem Namen Ihres Unternehmens (Feld User-Agent) und der Sprache Ihres Dolibarr. Es wird kein Dokument übermittelt ### Bei der Eröffnung eines Kontos - Die Daten Ihres Unternehmens, die die Registerkarte **Konto eröffnen** anzeigt (Firmenname, E-Mail, Land, SIREN, Adresse), gesendet an den konfigurierten DoliPDF-Server, um die Bestellseite vorauszufüllen. Es wird nichts gesendet, bevor Sie auf **Mein Konto eröffnen** klicken ### Bei der Suche nach Aktualisierungen Wie jedes Dolibarr-Modul mit einer Adresse zur Versionsprüfung fragt das Modul `https://cap-rel.fr/dolibarr/ver.php` ab und übermittelt dabei: - Die installierte Version des Moduls - Die Dolibarr-Version (`DOL_VERSION`) - Einen nicht umkehrbaren Fingerabdruck (`md5`) des Dolibarr-Datenverzeichnisses, der nur dazu dient, Installationen in der Download-Statistik zu unterscheiden Wenn Ihre Datenschutzrichtlinie es verlangt, können Sie diese Prüfung an Ihrer ausgehenden Firewall sperren: Das Modul funktioniert weiterhin.