Slik sender du kvittering ifm signering
Følg stegene i denne guiden for å sette opp meldingstjenesten til å sende signeringskvittering
Før du starter
Sett opp en app med signering
Denne guiden tar utgangspunkt i en eksisterende app med signeringsoppgave.
Maskinporten-klient
Du trenger en maskinporten-klient med tilgang til følgende scopes:
altinn:serviceowneraltinn:correspondence.write
Er du usikker kan du følge veiledningen for oppsett av meldingstjeneste under, der beskrives også oppsett av maskinporten-klient med nødvendige scopes.
1. Sett opp en meldingstjeneste
Du trenger en meldingstjeneste i Altinn Melding for å kunne sende signeringskvittering.
Følg steg 4-6 i hurtigstartsguiden for Altinn Melding for å sette opp en meldingstjeneste som kan brukes til å sende kvittering ifm signering. Stegene 1-3 er kun nødvendig om du ikke allerede har gjort dette i andre sammenhenger. Du trenger ikke å utføre stegene som omhandler å integrere mot meldingstjenesten, dette gjør appen automatisk i forbindelse med signeringssteget.
2. Registrer maskinporten-klienten i appen
Følg denne guiden for å ta i bruk maskinporten-klienten din i appen.
3. Legg til en meldingsressurs
- Naviger til appen din, og gå til Prosess i toppmenyen.
- Klikk på signeringsoppgaven i prosess-visningen og se at du får opp konfigurasjonsmuligheter i panelet på høyre side.
- Klikk på “Oppgi en ressurs for å sende ut meldinger”
- Legg inn navnet på meldingstjenesten i feltet
- Klikk på “Del dine endringer” og knappen “Del endringer”.
- Publiser tjenesten til testmiljø og verifiser at kvitteringen sendes.
Legg inn
altinn:correspondenceResourceunderaltinn:signatureConfigpå signeringsoppgaven (i filenApp/config/process/process.bpmn) Se eksempel under:App/config/process/process.bpmn<bpmn:task id="SigningTask" name="Signering"> <bpmn:extensionElements> <altinn:taskExtension> <altinn:taskType>signing</altinn:taskType> <altinn:actions> <altinn:action>sign</altinn:action> <altinn:action>reject</altinn:action> </altinn:actions> <altinn:signatureConfig> <!-- De faktiske dataene som skal signeres. Kan være vedlegg, skjemadata i xml, eller PDF fra tidligere steg. --> <altinn:dataTypesToSign> <altinn:dataType>ref-data-as-pdf</altinn:dataType> </altinn:dataTypesToSign> <!-- Signature-datatypen brukes for å lagre signaturene. --> <altinn:signatureDataType>signatures</altinn:signatureDataType> <!-- ... ev. annen konfigurasjon knyttet til signering her --> <!-- Her oppgis en meldingsressurs, som brukes for å si fra til de som skal signere --> <!-- om at de må inn og signere, samt signeringskvittering. Påkrevd. --> <altinn:correspondenceResource>app-correspondence-resource</altinn:correspondenceResource> </altinn:signatureConfig> </altinn:taskExtension> </bpmn:extensionElements> <bpmn:incoming>SequenceFlow_1oot28q</bpmn:incoming> <bpmn:outgoing>SequenceFlow_1if1sh9</bpmn:outgoing> </bpmn:task>Konfigurer miljøspesifikke meldingsressurser (valgfritt)
Hvis du ønsker å bruke forskjellige meldingsressurser i forskjellige miljøer, kan du legge til en env-attributt
på oppsettet. Se eksempel under:
App/config/process/process.bpmn<altinn:signatureConfig>
...
<altinn:correspondenceResource env="Development">app-correspondence-resource-1</altinn:correspondenceResource>
<altinn:correspondenceResource env="Staging">app-correspondence-resource-2</altinn:correspondenceResource>
<altinn:correspondenceResource env="Production">app-correspondence-resource</altinn:correspondenceResource>
...
</altinn:signatureConfig>
Env-attributten godtar en rekke verdier, men kategoriserer disse til slutt i tre kategorier som vist i tabellen under. Det skilles ikke mellom store og små bokstaver i verdiene.
| Miljø | Aliaser |
|---|---|
| Lokal test | development, dev, local, localtest |
| Test | staging, test, at22, at23, at24, tt02, yt01 |
| Produksjon | production, prod, produksjon |