Gå til hovedindhold
Penneo status page
Læs mere
English (GB) Français Nederlands

Sådan opsættes printerkoder til massemail i Desktop App

Kim Reglin
  • Opdateret

Du kan oprette udskrivningskode på to måder.

  1. Brug URI-skema til at bygge det manuelt
  2. Brug det indbyggede værktøj til integrationskode i skrivebordsprogrammet. Vi anbefaler denne mulighed. 

Hvis du ønsker at bygge det manuelt, er her URI-skemaintegrationen. URI -skemaet er skrevet på et sprog kaldet JSON.

Den indbyggede integrationskode er bedst egnet, når du har:

  • et Microsoft Excel-ark med modtageroplysninger
  • et Microsoft Word-dokument beregnet til alle modtagere på Excel -arket.

For at bruge denne metode skal du downloade skrivebordsprogrammet og printerudvidelsen:

Denne metode kræver også Microsoft Word og Excel på grund af flette funktionen af mail.

Sådan opsættes printerkoder

For at starte en ny kode kan du bygge og skrive det hele selv. Den nemmeste måde at starte en ny kode på er imidlertid at åbne skrivebordsprogrammet og udfylde det som på en normal sagsfil ved hjælp af en skabelon. 

  1. Åbn Penneo applikationen.
  2. Hvis du har statiske felter, hvilket f.eks. betyder at du vil have det samme navn for hver forsendelse du opretter, skal du indtaste navnet på forsendelsen i det respektive felt. Ellers sætter du pladsholdernavne, der senere vil blive erstattet i koden. Du kan også gøre flisen delvist statisk. For eksempel kan du vælge, at sagsmappens navn skal være "Kontrakt", men at du vil tilføje underskriverens navn til sidst, dette behøver ikke tilføjes manuelt, blot tilføj et flettefelt efter den statiske tekst i den senere kode.
  3. Vælg indstillingerne for din sag i det første trin, som du normalt ville.
  4. Tilføj et pladsholderdokument. Selve dokumentet, PDF-filen, gemmes ikke.
  5. Tilføj et pladsholdertegn, for eksempel kan du navngive dem "SignerName" og indstille emailen til "mail@mail.com", SSN til "1234567890". Vi vil senere erstatte disse felter med flettefelter. Beslut også om indstillingerne for underskriveren, eks. påmindelser.
  6. Hvis du ønsker at vælge en bestemt email-skabelon til disse udsendelser, skal du gå til næste side.
  7. Din desktop-applikation kan nu se sådan ud.
  1. I den øverste menulinje skal du klikke på Udvikler og derefter Opret integrationskode. Kopier koden og indsæt den i det dokument, du ønsker at sende ud via Penneo. Hvis du vil vide mere om koden, kan du se ordlisten herunder.
  1. Mens du stadig er i Word, skal du klikke på fanen Udsendelser.
  2. Klik på Vælg modtagere, og vælg Brug en eksisterende liste i rullemenuen.
  3. Find og vælg dit forberedte Excel-ark, det kan se sådan ud:
  4. Når du klikker på Indsæt flettefelt, skal du have et udvalg af muligheder afhængigt af strukturen i dit Excel-ark.
  1. Hvis du har steder i dokumentet hvor oplysningerne fra Excel-arket skal vises, skal du blot placere musen på det sted, klikke på Indsæt flettefelt og vælge det tilsvarende, se eksemplet herunder.
  2. Nu skal den kode du indsatte i dette dokument ændres. Erstat pladsholdernavne i den kode, du indtastede Penneo applikationen. Hvis du ser tilbage på trin 5, og husker at du har gemt navnet på underskriveren som SignerName, skal du erstatte det. Se et eksempel herunder på hvor du finder det i koden med det tilsvarende flettefelt.
  1. Det sidste du skal gøre er at erstatte den lokale sti, den leder i øjeblikket til pladsholderdokumentets placering, men du ønsker jo at udskrive den fil, koden er i. Stien starter med noget i stil med denne C:\\Users\ \ [USERNAME] \\Documents\\Test%20dokument.pdf, erstat hele stien med #printfile#. Koden i dit dokument skal nu sige "localPath":"#printfile#". Se mer her.
  2. For at skjule koden i det endelige dokument skal du gøre den hvid og minimere skriftstørrelsen.
  3. Klik på Preview Results. Du kan bruge pilene i højre side af denne knap til at gå mellem underskriverne. Vælg først hvilken underskriftsanmodning du vil sende ud, og gå til det tilsvarende nummer.
  4. Inden det næste trin skal du sørge for, at din Penneo applikation er blevet ryddet. Hvis ikke, skal du klikke på Avancerede indstillinger og vælge Ryd felter.
  5. Gå til Fil i Word, og vælg derefter Udskriv.
  6. Vælg Penneo-printeren i rullemenuen, og klik derefter på Udskriv. I Penneo applikationen er dit dokument indlæst, og det er klar til afsendelse.
  7. Klik på Næste og derefter Send dokumenter.
  8. Gentag trin 17-21, og gå til den næste underskriver i forhåndsvisningsresultaterne.

Kodens ordliste

  • Mellemrum i koden: Koden bør ikke indeholde nogle mellemrum, så hvis du har noget tekst der indeholder mellemrum så skal du skrive %20 i stedet for at lave et mellemrum.
  • penneo: Bliver brugt til at “kalde” Penneo desktop applikationen. Dette skal altid være i starten af koden.
  • templateId: Dette er  ID’et til den forsendelsestype du ønsker at bruge.
  • name: Du vil se “name” flere forskellige steder i koden. Her bruges det til at navngive forsendelsen. Husk reglen for mellemrum. Der kan bruges flettefelt her.
  • language: Vælg det sprog du ønsker forsendelsen skal være. Muligheder er en = English, da = Dansk, sv = Svensk, no = Norsk
  • folderId: Sætter mappe ID’et til den mappe som du ønsker at gemme dine forsendelser i. Standard valg er din valgte standard mappe i arkivet.
  • signOnMeeting: Vælg dette for at aktivere funktionen, Underskriv dokumenterne på mødet. Variabler er true og false. Standard er false, så denne skal kun benyttes, hvis du ønsker den skal være true
  • sensitiveData: Tilføj denne hvis forsendelsen skal have personfølsomme data aktiveret og sæt som true. Variabler er, true og false. Standard er false, medmindre det er aktiveret på virksomhedsniveau. Spørg din administrator om dette.
  • visibilityMode: Sæt hvilke dokumenter underskriverne kan se. Der er 2 valg, all_documents og certain_documents. Standard er all_documents.
  • messageTemplate: Skriv navnet på den email skabelon du ønsker at bruge.
  • messageSubject: Skriv hvad der skal stå i emnefeltet i din email. Ikke nødvendig hvis du allerede har valgt en email skabelon. Husk reglen for mellemrum. Der kan bruges flettefelt her.
  • messageText: Skriv teksten du ønsker der skal stå i emailen der sendes ud til underskriverne. Ikke nødvendig hvis du allerede har valgt en email skabelon. Husk reglen for mellemrum. Der kan bruges flettefelt her.
  • documents: Den næste del handler om de dokumenter der tilføjes til forsendelsen.
  • name: Vi ser igen “name” men denne gang er til navngivning af dokumentet. Husk reglen for mellemrum. Der kan bruges flettefelt her.
  • order: Bestem den orden som dokumenterne skal vises til underskriverne i. Den tæller fra 0, så første dokument vil være 0, næste 1 og så videre.
  • type: Det ID som dokumenttypen har. Du kan kun vælge ID’er som er i den forsendelsestype du har valgt. Valget af ID er også afhængig af at der allerede er valgt en forsendelsestype.
  • localPath: Dette er til stien for den PDF du vil tilføje. Hvis dokumentet du skal tilføje er det dokument som denne kode er i, så skal du bruge stien #printfile# for at fortælle systemet det drejer sig om det dokument du er i.
  • signers: Denne del af koden omhandler underskriverne der tilføjes til forsendelsen i desktop applikationen.
  • name: Igen ser vi navn, men denne gang er det til navnet på underskriver. Husk reglen for mellemrum. Der kan bruges flettefelt her.
  • email: Email adressen på underskriveren. Der kan bruges flettefelt her.
  • onBehalfOf: Her indsættes tekst til feltet “på vegne af”. Husk reglen for mellemrum. Der kan bruges flettefelt her.
  • isPrivate: Slå adgangskontrol til for underskriveren. Er automatisk aktiveret hvis der er aktiveret personfølsomme data. Den kan sættes til enten false eller true.
  • enableTouch: Aktiver tilladelse af touch signering for underskriveren. Kan enten være false eller true.
  • roles: Sæt de ID’er til rollerne som underskriveren skal have. Disse er afhængige af hvilken dokumenttype der er valgt. Hvis der er flere roller, deles ID med et komma (,).
  • ssn: Sæt personnummer på underskriveren. Der kan bruges flettefelt her.
  • vatid: Sæt virksomhedsnummer på underskriveren. Dette er kun for danske underskrivere. Der kan bruges flettefelt her.
  • reminderInterval: Sæt det påmindelsesinterval du ønsker. Standard er 2, medmindre der er sat noget andet for din virksomhed. Spørg din administrator om dette.
  • copyRecipients: Du kan også oprette kopimodtagere hvis du har nogen af dem. De sættes op på samme måde som underskrivere, men har kun navn og email adresse. (Kan ikke bruges, hvis der er aktiveret personfølsomme data).
  • name: Sæt navnet på kopimodtageren. Husk reglen for mellemrum. Der kan bruges flettefelt her.
  • email: Email adressen på kopimodtageren. Der kan bruges flettefelt her.
  • sendAt: Sæt dato og tidspunkt for hvornår forsendelsen skal aktiveres. Hvis du ønsker at emails skal sendes med det samme, kan du blot ignorere denne. Husk at tage højde for sommertid. Hvis du ønsker at sætte datoen 31/12-2020, så skal formatet se sådan her ud: 2020-12-31T12:00:00+01:00. Den sidste del med +01:00 er når det ikke er sommertid. Hvis vi har sommertid skal der stå +02:00.
  • expireAt: Sæt dato og tidspunkt for hvornår forsendelsen skal udløbe. Kan ikke være tidligere end aktiveringsdatoen. Samme regler som sendAt gælder også her.
  • reference: Sæt den reference du ønsker. Husk reglen for mellemrum. Der kan bruges flettefelt her.

Relaterede artikler