Altinn Studio Referanse Brukergrensesnitt PDF

PDF

Hvordan konfigurere generering av PDF

Ny PDF-generering

Aktivere ny PDF-generering

Fra og med versjon 7.5 av nuget-pakkene (Altinn.App.Api og Altinn.App.Core) er det lansert en ny måte å generere PDF-er på. Denne nye måten kan skrus av og på ved å legge til følgende seksjon og innstilling i appsettings.json.

  "FeatureManagement": {
    "NewPdfGeneration": true
  }

Dette vil sørge for at den nye PDF-tjenesten kalles. Denne aksepterer en URL som peker tilbake til en automatisk generert side i appen. Siden bygges opp og danner grunnlaget for PDF-en. Grensesnittet IPdfFormatter som dokumentert nedenfor er fortsatt relevant hvis du trenger spesiallogikk for å skjule komponenter/sider fra PDF-en.

Innstillinger

Selv om standardinnstillingene for den nye tjenesten skal være nok for de fleste applikasjoner, kan de overstyres ved å legge til en PdfGeneratorSettings-seksjon i appsettings.json (standardinnstillinger vises under).

  "PdfGeneratorSettings": {
    "ServiceEndpointUri": "https://{org}.apps.{hostName}/{appId}/#/instance/{instanceId}",
    "AppPdfPageUriTemplate": "https://{org}.apps.{hostName}/{appId}/#/instance/{instanceId}?pdf=1",
    "WaitForSelector": "#readyForPrint",
    "WaitForTime": 5000
  }

Hvis WaitForSelector er satt så blir WaitForTime ignorert. WaitForSelector sikrer at siden er ferdig oppbygd og presentert før PDF-en genereres.

Det er to ulike måter å konfigurere PDF-genereringen på:

Automatisk basert på skjema-sidene dine
Manuelt basert på en egendefinert PDF-side

Det er også mulig å se en forhåndsvisning av hvordan PDF-en kommer til å se ut i nettleseren imens du jobber med den (kun v7.5+).

Automatisk konfigurasjon

Denne metoden brukes som standard dersom du ikke har spesifisert en egendefinert PDF-side. Denne metoden trekker ut alle sidene og komponentene i den rekkefølgen de vises, og tar de med i PDF-dokumentet.

Ekskludering av sider og komponenter

Som regel har man behov for å ekskludere visse sider og komponenter som ikke er relevant for PDF-dokumentet. Dette kan konfigureres på to ulike måter:

Ved å modifisere Settings.json-filen for layout-settet.
Programmatisk ved å implementere det i kode. Dette åpner for dynamisk ekskludering basert på skjemadataen.

Avhengig av hvilken versjon du kjører setter man opp den programmatiske metoden litt forskjellig, men logikken er helt lik. Oversikten under viser hvordan det settes opp for versjonen du kjører:

Opprett en klasse som implementerer IPdfFormatter-grensesnittet som ligger i Altinn.App.Core.Features-navnerommet.
Du kan navngi og plassere filene i den mappestrukturen du selv ønsker i prosjektet ditt. Men vi anbefaler at du benytter meningsfulle navnerom som i et hvilket som helst annet .Net-prosjekt.
Registrér din implementering i Program.cs-klassen.
```
services.AddTransient<IPdfFormatter, PdfFormatter>();
```
Dette sørger for at din kode er kjent for applikasjonen og at koden blir kjørt når den skal.

Endre PdfHandler.cs-filen under App/logic/Print-mappen.

Vis/skjul innhold Ekskludere sider

1. Settings.json

Legg til en liste med sidenavn som skal eksluderes på excludeFromPdf under pages:

{
   "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layoutSettings.schema.v1.json",
   "pages": {
      "order": ["side1", "side2"],
      "excludeFromPdf": ["side2"]
   }
}

2. Programmatisk

public async Task<LayoutSettings> FormatPdf(LayoutSettings layoutSettings, object data)
{
  if (data.GetType() == typeof(Skjema))
  {
    layoutSettings.Pages.ExcludeFromPdf.Add("side2");
  }
  return await Task.FromResult(layoutSettings);
}

NB: Du trenger kun å velge én av disse metodene.

Vis/skjul innhold Ekskludere komponenter

1. Settings.json

Legg til en liste over komponent-ID-er som skal ekskluderes på excludeFromPdf under components:

{
   "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layoutSettings.schema.v1.json",
   "pages": {
      "order": ["side1"]
   },
   "components": {
      "excludeFromPdf": ["bilde-komponent-id"]
   }
}

2. Programmatisk

public async Task<LayoutSettings> FormatPdf(LayoutSettings layoutSettings, object data)
{
  if (data.GetType() == typeof(Skjema))
  {
    layoutSettings.Components.ExcludeFromPdf.Add("bilde-komponent-id");
  }
  return await Task.FromResult(layoutSettings);
}

NB: Du trenger kun å velge én av disse metodene.

Vis/skjul innhold Ekskludere komponenter fra en spesifikk rad i en repeterende gruppe

Dersom du trenger å ekskludere en komponent fra en spesifikk rad i en repeterende gruppe må du spesifisere radnummeret i tillegg til komponent-ID-en.

Formatet er: komponentID-<rad-nummer>.

1. Settings.json

{
   "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layoutSettings.schema.v1.json",
   "pages": {
      "order": ["side1"]
   },
   "components": {
      "excludeFromPdf": ["komponent-i-gruppe-1"]
   }
}

2. Programmatisk

public async Task<LayoutSettings> FormatPdf(LayoutSettings layoutSettings, object data)
{
  if (data.GetType() == typeof(Skjema))
  {
    layoutSettings.Components.ExcludeFromPdf.Add("komponent-i-gruppe-1");
  }
  return await Task.FromResult(layoutSettings);
}

NB: Du trenger kun å velge én av disse metodene.

Egendefinert konfigurasjon

Denne metoden er kun tilgjengelig i versjon 7.5 og høyere.

Denne metoden lar deg spesifisere en helt egendefinert PDF ved å definere en layout-fil som bestemmer hva den skal inneholde.

For å ta i bruk denne metoden må du opprette en ny layout-fil for PDF-en og sette pdfLayoutName i Settings.json til å peke til den filen:

{
   "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layoutSettings.schema.v1.json",
   "pages": {
      "order": ["side1"],
      "pdfLayoutName": "minPdfLayout"
   }
}

Denne layout-filen konfigureres på akkurat samme måte som andre layout-filer, bortsett fra at ikke alle komponenttyper er tilgjengelig. Komponenttypene som kan brukes i en PDF-layout er følgende:

Summary
Group
InstanceInformation
Header
Paragraph
Image
Panel

Vis/skjul innhold Inkludere instans-informasjon

Den automatiske PDF-layouten inkluder en forside med instans-informasjon som avsender, mottaker, dato, og referansenummer. Dette bør du også inkludere i din egendefinerte PDF-layout. Eksempelet under viser hvordan du kan inkludere denne informasjonen på akkurat samme måte som i den automatiske metoden:

{
   "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layout.schema.v1.json",
   "data": {
      "layout": [
         {
            "id": "pdf-instance",
            "type": "InstanceInformation",
            "elements": {
               "dateSent": true,
               "sender": true,
               "receiver": true,
               "referenceNumber": true
            },
            "pageBreak": {
               "breakAfter": "always"
            }
         },
         ...
      ]
   }
}

Vis/skjul innhold Legge til sideskift

Du kan spesifisere at en komponent skal starte på en ny side eller at et sideskift skal komme rett etter en komponent ved å bruke pageBreak-egenskapen. Denne egenskapen er tilgjengelig på alle komponenter. I eksempelet under brukes det på en overskrift for å sørge for at den starter på en ny side:

{
   "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layout.schema.v1.json",
   "data": {
      "layout": [
         {
            "id": "pdf-header",
            "type": "Header",
            "textResourceBindings": {
               "title": "Dette er en ny seksjon"
            },
            "size": "L",
            "pageBreak": {
               "breakBefore": "always",
               "breakAfter": "avoid"
            }
         }
      ]
   }
}

NB: Verdien av breakBefore og breakAfter kan enten være auto (standard), always, avoid, eller ett uttrykk som returnerer en av disse verdiene.

Vis/skjul innhold Ekskludere komponenter inne i en gruppe

Det er mulig å ekskludere enkeltkomponenter inne i en gruppe ved å bruke excludedChildren-egenskapen på en Summary-komponent som refererer til en Group-komponent. Dette gjøres ved å legge ID-en til komponenten i listen over ekskluderte komponenter som i eksempelet under:

{
   "$schema": "https://altinncdn.no/toolkits/altinn-app-frontend/4/schemas/json/layout/layout.schema.v1.json",
   "data": {
      "layout": [
         {
            "id": "pdf-group-summary",
            "type": "Summary",
            "componentRef": "en-gruppe-komponent",
            "excludedChildren": [
               "en-komponent-i-gruppen"
            ]
         }
      ]
   }
}

Forhåndsvisning i nettleseren

Forhåndsvisningen gjelder kun dersom du bruker ny PDF generering (v7.5+). Se ovenfor for mer informasjon.

Det er mulig å se en forhåndsvisning av hvordan den genererte PDF-en kommer til å se ut i nettleseren imens du jobber. Følg instruksjonene nedenfor:

Viktig: Bruk Google Chrome til å forhåndsvise PDF.
PDF-generatoren bruker en variant av Chrome til å generere PDF-en, så andre nettlesere vil ikke produsere et korrekt resultat ved forhåndsvisning.
Kjør opp appen din lokalt eller åpne appen din i testmiljøet, og start en instans.
Åpne utviklerverktøyet ved å trykke på knappen nederst i høyre hjørne, eller bruk hurtigtasten Ctrl+Shift+K/⌘+Shift+K.
Trykk på Forhåndsvis PDF-knappen i utviklerverktøyet.

Denne funksjonaliteten er kun tilgjengelig i versjon 8.3.8 og høyere.

Forutsetninger

For å bruke PDF footer-funksjonaliteten må applikasjonen din støtte tidssoner. Dette gjøres ved å legge til følgende linjer i Dockerfile:

  # Add globalization timezone support
  RUN apk add --no-cache icu-libs tzdata
  ENV DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=false

Linjene må legges til etter “FROM”-seksjonen som ender på “AS final”

Configuration

Di kan legge til en footer i den genererte PDF-en ved å legge til "DisplayFooter": true i PdfGeneratorSettings-seksjonen i appsettings.json-filen.

  "PdfGeneratorSettings": {
    "DisplayFooter": true
  }

Innhold

Footeren vil inneholde følgende informasjon:

Navnet på appen
Navnet på organisasjonen
Dato og tid for når PDF-en ble generert
Altinn referanse-ID
Sidenummer