--- title: "Instellingen" weight: 20 description: "Instelling van de module DoliPDF: conversiemodus, externe server, lokale opdracht en opties." source_hash: "e45450a4" --- # Instellingen De instellingen van de module vindt u in **Home > Instellingen > Modules > Dolipdf**, tabblad **Instellingen**. ![Instellingenpagina van de module DoliPDF met de conversie-instellingen](screenshots/configuration-dolipdf.webp) ## Conversiemodus DoliPDF biedt twee conversiemodi, die afzonderlijk kunnen worden gebruikt. ### Externe modus (standaard) Het ODT-bestand wordt naar een DoliPDF-server gestuurd, die het naar PDF omzet. Deze modus is het eenvoudigst in te stellen. | Instelling | Beschrijving | |------------|--------------| | Adres van de DoliPDF-server | URL van de conversieserver. De standaardwaarde is `https://pdf.cap-rel.fr`. | | E-mailadres van uw account | E-mailadres dat aan uw account op de DoliPDF-server is gekoppeld. | | API-sleutel op de DoliPDF-server | Authenticatiesleutel van de dienst. Ze wordt automatisch opgeslagen wanneer u uw account opent via het tabblad **Account openen**. Voorbeeld van het formaat: `1\|lUr8Tj4fHZZZmpwAAAMpBBBDb8KCCC5Iw5DDD2sH`. | ### Uw account openen vanuit Dolibarr Nog geen DoliPDF-account? Open het zonder Dolibarr te verlaten en zonder iets te kopiëren: 1. Open het tabblad **Account openen** van de module-instellingen. Het toont de gegevens van uw bedrijf die worden verstuurd (bedrijfsnaam, e-mail, land, SIREN, adres), gelezen uit **Home > Instellingen > Bedrijf/Organisatie** 2. Klik op **Mijn account openen op pdf.cap-rel.fr** en daarna op **Verder naar betaling**: de bestelpagina opent in een nieuw tabblad, met deze gegevens al ingevuld. Kies uw abonnement, corrigeer wat nodig is en betaal 3. Ga terug naar het tabblad **Account openen**: het vernieuwt zichzelf zodra de betaling is ontvangen, en de API-sleutel wordt opgeslagen in de module-instellingen. De knop **Ik heb betaald, nu controleren** dwingt de controle af als dat nodig is Er wordt een e-mail naar het adres van de bestelling gestuurd om het wachtwoord van uw account op de DoliPDF-server te kiezen. Daar vindt u uw facturen en uw API-sleutels. Hoort het e-mailadres van de bestelling al bij een account, dan wordt het abonnement aan dat account toegevoegd en wordt er geen nieuwe sleutel aangemaakt: vul dan de bestaande sleutel van dat account in. Hebt u al een account? Maak een sleutel aan via het menu **API-tokens** en dan **Nieuw** in uw account op de DoliPDF-server, en plak hem in het veld **API-sleutel** van het tabblad **Instellingen**. ### De verbinding testen De knop **Verbinding testen**, onder de instellingen van het tabblad **Configuratie**, controleert in enkele seconden of de externe conversie zal werken, zonder een document te converteren of uw abonnement te verbruiken. Hij controleert het serveradres (volledig en met https), de aanwezigheid en de vorm van de API-sleutel, en raadpleegt daarna de DoliPDF-server. Het resultaat verschijnt bovenaan de pagina: - **Verbinding OK**: de server antwoordt en accepteert de sleutel. Het bericht vermeldt het gebruikte account en, als de server dat doorgeeft, het aantal nog beschikbare conversies - **Waarschuwing**: de sleutel is geldig, maar er is geen abonnement actief of het abonnement is opgebruikt. Een link leidt naar de bestelpagina - **Fout**: het bericht noemt de oorzaak (ontbrekend of http-adres, ontbrekende of onvolledige sleutel, server onbereikbaar met de netwerkdetails, sleutel geweigerd, account geblokkeerd, serverfout) en wat u moet doen ### Lokale modus (LibreOffice) Als LibreOffice op uw server is geïnstalleerd, kunt u lokaal converteren zonder uw documenten naar een externe server te sturen. | Instelling | Beschrijving | |------------|--------------| | LibreOffice gebruiken dat lokaal op uw server is geïnstalleerd | Schakelt de lokale conversiemodus in. | | Lokale opdracht om de PDF uit het ODT-bestand aan te maken | Systeemopdracht die voor de conversie wordt uitgevoerd. Vul dit veld alleen in als u de lokale modus inschakelt. | > **Let op**: Als de lokale modus is uitgeschakeld, verhindert DoliPDF automatisch elke lokale uitvoering van LibreOffice, ook als de Dolibarr-constante `MAIN_ODT_AS_PDF` is ingesteld. Zo worden onbedoelde lokale conversies vermeden. ## Opties ### Meldingen | Instelling | Beschrijving | |------------|--------------| | Meldingen rechtsboven tonen bij het aanmaken van PDF-bestanden | Toont na elke conversie een bevestigings- of foutmelding. | ### Bestandsbeheer | Instelling | Beschrijving | |------------|--------------| | ODT-bestand verwijderen wanneer de PDF correct is aangemaakt | Verwijdert het ODT-bronbestand automatisch zodra de PDF-conversie is geslaagd, zodat alleen het uiteindelijke PDF-bestand overblijft. | ### Prestaties | Instelling | Beschrijving | |------------|--------------| | Het aanmaken van de PDF uitschakelen bij elke toevoeging of wijziging van een productregel | Voorkomt dat de PDF automatisch opnieuw wordt aangemaakt wanneer u een regel in een document (factuur, offerte, bestelling) toevoegt of wijzigt. De PDF wordt dan alleen aangemaakt wanneer u het document uitdrukkelijk aanmaakt. | | DoliPDF alleen uitvoeren op gevalideerde documenten | Beperkt de PDF-conversie tot documenten met de status "Gevalideerd". Concepten starten geen conversie. Deze optie bespaart gebruik van de externe DoliPDF-dienst. | ## Verstuurde gegevens en privacy Om zijn dienst te leveren, verstuurt de module de volgende informatie. ### Bij elke conversie in de externe modus - De inhoud van het te converteren ODT-bestand, verstuurd naar de ingestelde DoliPDF-server (standaard `https://pdf.cap-rel.fr`), samen met uw API-sleutel en het e-mailadres van uw account - Een technische installatie-ID (`DOLIPDF_UUID`): een willekeurige ID die eenmalig wordt aangemaakt en in de Dolibarr-database wordt opgeslagen, en die twee installaties onderscheidt zonder hun identiteit prijs te geven - De naam van uw bedrijf zoals ingevuld in de Dolibarr-instellingen (menu **Home > Instellingen > Bedrijf/Organisatie**), verstuurd in het veld User-Agent van het HTTP-verzoek - De taal van uw Dolibarr, zodat de DoliPDF-server zijn berichten in die taal opstelt De lokale conversiemodus (LibreOffice) doet geen enkel verzoek naar buiten: uw documenten blijven op uw server. ### Bij een verbindingstest - Uw API-sleutel, verzonden naar de geconfigureerde DoliPDF-server, met de naam van uw bedrijf (veld User-Agent) en de taal van uw Dolibarr. Er wordt geen document verzonden ### Bij het openen van een account - De gegevens van uw bedrijf die het tabblad **Account openen** toont (bedrijfsnaam, e-mail, land, SIREN, adres), verstuurd naar de ingestelde DoliPDF-server om de bestelpagina vooraf in te vullen. Er wordt niets verstuurd voordat u op **Mijn account openen** klikt ### Bij het zoeken naar updates Zoals elke Dolibarr-module met een adres voor versiecontrole raadpleegt de module `https://cap-rel.fr/dolibarr/ver.php` en verstuurt daarbij: - De geïnstalleerde versie van de module - De Dolibarr-versie (`DOL_VERSION`) - Een niet-omkeerbare vingerafdruk (`md5`) van de Dolibarr-datamap, die alleen dient om installaties te onderscheiden in de downloadstatistieken Als uw privacybeleid dat vereist, kunt u deze controle blokkeren in uw uitgaande firewall: de module blijft werken.