Testanvisningar

Meddelandet skickas i två faser. Lägg först till eventuella bilagor till meddelandet genom att använda attachments-slutpunkten. Därefter kan ni skicka det elektroniska meddelandet antingen via det flerkanaliga messages-slutpunkten eller via  messages/electronic-slutpunkten, som används enbart för att skicka elektroniska meddelanden. Koden för den fil som ska bifogas matas in som en del av förfrågningsmeddelandet i det meddelande som ska skickas.

Om den flerkanaliga messages-slutpunkten används för att skicka meddelandet, ska som mottagare väljas en slutanvändare som tar emot meddelanden elektroniskt. Använd alltså det testpersonnummer som ni tagit emot och vars elektroniska postlåda ni har tagit i bruk.

Granskning av notifikationen

Kontrollera hur notifikationen om ett nytt meddelande ser ut för slutanvändaren för det meddelande ni skickat. En notifikation skickas till den e-postadress som ni har angett i den elektroniska postlådan när den togs i bruk. Ni kan också kontrollera eller byta e-postadress i Suomi.fi-webbtjänstens testmiljö under Inställningar för Suomi.fi-meddelanden.

Det är särskilt viktigt att kontrollera formuleringen av notifikationen om ni har skräddarsytt dess innehåll.

Om ni inte läser meddelandet ni skickat till testmiljön inom en timme skickas ett notifikation till er e-postadress om att meddelandet är oläst. På så sätt kan ni också testa att ta emot olästa meddelanden.

Granskning av elektroniska meddelanden

Kontrollera hur det elektroniska meddelandet som ni skickat ser ut i Suomi.fi-meddelanden ur slutanvändarens synvinkel:

1. Logga in i Suomi.fi-webbtjänstens testmiljö. Ni har fått adressen till testmiljön och de koder som krävs för att komma in i miljön av MDB i samband med ibruktagningsprocessen.
2. Efter inloggningen ska ni identifiera er i Suomi.fi-webbtjänsten. Välj "Testidentifikator" som identifieringssätt och använd den personbeteckning till vars postlåda ni skickade det elektroniska meddelandet.
3. Gå till avsnittet om Suomi.fi-meddelanden i Suomi.fi-webbtjänsten.
4. Öppna meddelandet ni skickat i Inkorgen. Observera att det kan ta en stund innan meddelandet syns i mottagarens elektroniska brevlåda efter att ni skickat det.

Nedan beskrivs instruktionen för testning av papperspost samt den process som er organisation ska följa om ni vill ha feedback på er testförsändelse från utskrifts-, kuverterings- och distributionstjänstens leverantör.

Test av sändning av papperspost

Lägg först till den bilaga som ska skickas med pappersposten med hjälp av attachments-slutpunkten. Ni kan skicka meddelandet efter att bilagan har lagts till. Ett meddelande som ska levereras som papperspost skickas antingen via den flerkanaliga messages-slutpunkten eller via paper-mail-without-id-slutpunkten, som används enbart för papperspost.

Om den flerkanaliga messages-slutpunkten används för att skicka meddelandet, ska som mottagare väljas en slutanvändare som endast tar emot meddelanden per papperspost. Använd därför för testningen den testpersonnummer som ni fått, vars brevlåda ni inte har tagit i bruk eller som ni har inaktiverat.

Observera att meddelanden i QA-miljön som standard inte skrivs ut och skickas per post även om de styrs till papperskanalen. Testerna får inte heller Track-and-Trace-kvitteringar. I produktionsmiljön skrivs meddelanden som styrs till papperskanalen i regel ut och postas. Om man vill avvika från det ovan nämnda ska detta avtalas med utskriftsleverantören.

Granskning av meddelanden som skickats till papperspost

Om ni vill få respons på er testförsändelse som skickats till papperspost ska er organisation skicka en begäran om testning till Posti Messaging Oy:s kundtjänst. Aktuella kontaktuppgifter finns på Posti Messaging Oy:s webbsida. Servicebegäran registreras i Posti Messaging Oy:s stödtjänstsystem. Rubriken för begäran om testning ska vara "iPost TKJ-testningsbegäran" och ange följande uppgifter  i begäran:

• använd miljö, som vid testningen är "stage"
• meddelandekod (messageId) som skickats tillbaka av sändningsslutpunkten och som används för att skapa ZIP-filen som skickas till Posti Messaging Oy och fältet SenderLetterId
• meddelandets exakta sändningstidpunkt
• Kundnummer som ni fått av Posti Messaging Oy och som ni till exempel placerar som värde för "username"-objektet "printingAndEnvelopingService" i försändelsemeddelandet.

Berätta utöver ovan nämnda uppgifter vilka av följande åtgärder ni önskar att Posti Messaging Oy ska vidta för meddelandet som testas:

• Meddelandet körs till testbehandling i en miljö som motsvarar produktionen, men det postas inte fysiskt.
• Brevet i PDF-format samt XML-filen skickas till er organisation per e-post.

Nedan beskrivs ett exempel på ett e-postmeddelande där man ber om en begäran om testning enligt anvisningarna:

Mottagare: [Posti Messaging Oy:s e-postadress]
Rubrik: iPost begäran om TKJ-testning

Vi ber er köra materialet nedan i testmiljön utan postning och returnera utskriften och XML-filen per e-post till avsändaren.

Miljö: stage
Materialets namn: [messageId för det meddelande ni skickat].zip
Sändningstidpunkt: [meddelandets sändningstidpunkt, i formatet tt.mm, dd.mm.åååå]
SenderLetterId: [messageId för det meddelande ni skickat].zip
Kundnummer: [Kundnummer som ni fått av Posti Messaging Oy]

Utan begäran om testning förvaras testmaterialet i utskriftsleverantörens omgivning i 24 timmar, varefter materialet försvinner. Beakta detta i tidtabellen för testningen.

För att er organisation ska kunna testa sökningen av meddelandenas statusmeddelanden, skicka först några elektroniska meddelanden enligt de instruktioner som beskrivs i punkten "Elektronisk sändning av meddelanden".

Efter att några meddelanden skickats kan ni söka deras status med hjälp av events-slutpunkten. Att hämta en status bygger på registreringsnycklar. Vid den första sökningen ska registreringsnyckeln inte ges, varvid tjänsten returnerar statusen för alla meddelanden som er organisation skickat till Suomi.fi-meddelanden samt registreringsnyckeln för det sist uppdaterade meddelandets status. Vid nästa söktillfälle kan ni ge en registreringsnyckel och få som svar endast statusuppdateringar som gjorts efter föregående sökomgång.

Ni kan ändra det elektroniska meddelandets status till exempel genom att läsa det som slutanvändare i Suomi.fi-webbtjänsten. För att läsa meddelandet, följ processen för att öppna det elektroniska meddelandet som beskrivs i punkten ”E-sändning av meddelanden”.

Om er organisation ämnar tillåta slutanvändarna att börja kommunicera med er, testa sökning av slutanvändarnas meddelanden. Skicka först åtminstone ett meddelande till er organisation enligt följande:

1. Logga in i Suomi.fi-webbtjänstens testmiljö. Ni har fått adressen till testmiljön och de koder som krävs för att komma in i miljön av MDB i samband med ibruktagningsprocessen.
2. Efter inloggningen ska ni identifiera er i Suomi.fi-webbtjänsten. Välj ”Testidentifikator” som identifieringsmetod och använd den personbeteckning vars brevlåda ni har tagit i bruk.
3. Gå till avsnittet om Suomi.fi-meddelanden i Suomi.fi-webbtjänsten.
4. Skicka ett nytt meddelande till er organisation via Skriv meddelande eller svara på ett meddelande som ni tidigare skickat till slutanvändaren genom att öppna meddelandet och klicka på knappen där det står "Svara på meddelandet". Bifoga åtminstone en bilaga till meddelandet så att ni också kan testa att ta emot bilagor.

När ni som slutanvändare har skickat meddelandet till er organisation, testa sökningen så här:

1. Hämta koderna för de meddelanden ni tagit emot genom events-slutpunkten.
2. Hämta meddelandets innehåll genom att i fas 1 mata in meddelandets kod i messages/{id}-slutpunkten.
3. Hämta meddelandets bilagor från attachments/{id}-slutpunkten med hjälp av koderna för de bilagor som erhölls i fas 2.

Er organisation kan kontrollera om en specificerad slutanvändarens postlåda är i bruk via REST-gränssnittet. Kontrollen görs via mailboxes-active-slutpunkten. Vid testningen kan ni använda valfritt testpersonnummer av de ni tagit emot.