https://github.com/digipost/printability-validator

Library for validating 'printability' of documents.
https://github.com/digipost/printability-validator

Last synced: about 1 month ago
JSON representation

Library for validating 'printability' of documents.

• Host: GitHub
• URL: https://github.com/digipost/printability-validator
• Owner: digipost
• License: apache-2.0
• Created: 2015-01-16T15:16:00.000Z (over 10 years ago)
• Default Branch: main
• Last Pushed: 2024-04-29T16:16:53.000Z (about 1 year ago)
• Last Synced: 2025-03-23T22:34:21.452Z (about 2 months ago)
• Language: Java
• Size: 4.78 MB
• Stars: 2
• Watchers: 16
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/no.digipost/printability-validator/badge.svg)](https://maven-badges.herokuapp.com/maven-central/no.digipost/printability-validator)

![](https://github.com/digipost/printability-validator/workflows/Build%20and%20deploy/badge.svg)

[![License](https://img.shields.io/badge/license-Apache%202-blue)](https://github.com/digipost/printability-validator/blob/main/LICENCE)

# Digipost Printability Validator

Formålet med dette biblioteket er å gi avsendere mulighet til å validere om et PDF dokument kan skrives ut av Digiposts utskriftstjeneste. Følgende valideringsregler eksisterer i biblioteket:

* Det må eksistere en venstremarg på 15mm i PDF dokumentet.

* Maks sideantall på PDF dokumentet er 20 sider.

* Fonter som ikke er standard fonter må embeddes i PDF dokumentet.

* PDF versjon må være fra 1.0 til 1.5

Biblioteket er veldig enkelt å benytte. Flyten består av å instansiere et PdfValidator object, sende inn konfigurasjon for hvilke regler som skal valideres og til slutt kjøre valideringen. Du får tilbake et PdfValidationResult object som inkluderer:

* Antall sider

* Liste med eventuelle valideringsfeil

* Om PDF dokumentet er ok for print

* Om PDF dokumentet er ok for digital distribusjon

Pseudo-kode eksempel:

```java

PdfValidator pdfValidator = new PdfValidator();

// Alle valideringsregler er slått på.

PdfValidationSettings printValideringsinnstillinger = new PdfValidationSettings (true, true, true, true);

PdfValidationResult pdfValidationResult =  pdfValidator.validate(pdf, printValideringsinnstillinger);

```

Krav til PDF dokumenter er tilgjengelig på https://www.digipost.no/plattform/annet/print

Biblioteket er også tilgjengelig på [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22printability-validator%22).

Feil ved validering av dimensjoner medfører `PdfValidationError` av typen `UNSUPPORTED_DIMENSIONS`.

Den tilhørende meldingen inneholder variable parametre for margin og bleed. Fra og med versjon 3.3

tilbyr `PdfValidationResult` en `formattedValidationErrorMessage`-metode for å kunne formatere denne

feilmeldingen med riktig verdier. Denne formateringen skjedde tidligere kun i `PdfValidationResult`

sin `toString`-metode. Den nevnte hjelpemetoden kan benyttes i sammenhenger det er er uønsket å

benytte `toString`.

## For avsendere som sender til utskrift via offentlig Sikker Digital Post (SDP) meldingsformidlertjeneste.

I SDP utskriftstjenesten er det satt opp en felles valideringskonfigurasjon. Den er som følger:

```java

PdfValidationSettings printValideringsinnstillinger = new PdfValidationSettings(false, true, false, true);

```

## Releasing (kun for medlemmer av Digipost organisasjonen)

Se docs/systemer/open-source-biblioteker.md