Download presentation
Presentation is loading. Please wait.
1
While the audience is gathering. During breaks etc
While the audience is gathering. During breaks etc. Simple messages can be added in bold and white letters on the dark blue sea, eg. ”Welcome!”, ”Back at 15.15”
2
HOW-TO Test, Verify and Validate Your service
This HOW-TO describes how a VIS based service can be tested.
3
Test procedures Unit tests by each service implementer Internal test of API and functionality Technical integration tests between services (technical interoperability tests) External test of public API and interaction with other services Operational tests External test including application and logic behind the service.
4
Test Tools Various test tools have been developed and there are several tools online that can support in tests of the REST API. The most used tool in FAT and SAT is the STM Module Tool.
5
Test Tools SMA VIS SMA VIS STM Module Tool Browser CURL
Service to test Verification Service Application STM Module Tool SMA VIS VIS Private VIS Public Service to test SMA VIS VIS Public Swagger UI Browser VIS Private VIS Public Service to test CURL Service to test
6
STM Module Tool The STM Module Tool is a windows application that connects to the private side of a SMA VIS implementation. Thus, the tool requires a VIS instance with a private REST interface according to SMA implementation. An instance can be created by SMA on request. The private side follows the VIS Private REST Technical Design that can be found on Developer Forum. The source code for The STM Module Tool can be found in GitHub A Windows executable can be found at Project Place
7
STM Module Tool
8
Verification Service A VIS Verification service has been deployed in STAGING environment in its first version ( ). The service supports the following verifications: Sending voyage plan (RTZ) to another service Tests also <Tested Service> as client The Verification Service will return content in received certificate and make a lookup in Service Registry to return a text message. Receiving voyage plan (RTZ) The Verification Service uploads the received voyage plan back to the service Tests also <Tested Service> as server (host) Receiving text message (TXT) Sending text message (TXT) to another service Sending area message (S124) to another service Receiving different variants of voyage plans (RTZ) Receiving different variants of text messages (TXT) Receiving different variants of area messages (S124) Test Service Registration Client Certificate Server (Host) Certificate
9
Use Case 1 Test object VIS Appl Service Registry Identity Registry
Find service instance ID Appl VIS RTZ-1 STM VIS Verification “appl” uploadVoyagePlan STM VIS Verification Service notify getMessage RTZ-1 uploadVoyagePlan TXT-1 uploadText callService uploadArea S124-1
10
Use Case 2 Test object Service Registry Identity Registry TXT-C1
uploadText Verification Service Select Case command “check registry” “check certificate” “get test voyage plans” “get test text messages” “get test area messages” “get test port call messages” RTZ-2 uploadVoyagePlan TXT-2 uploadText uploadArea S124-2 Where TXT-C1 is <?xml version="1.0" encoding="UTF-8"?> <textMessage xmlns:xsi=" xmlns=" > <textMessageId>urn:mrn:stm:txt:sma: </textMessageId> <author>Mikael</author> <from>urn:mrn:stm:service:instance:sma:stmvalidation</from> <createdAt> T08:00:00Z</createdAt> <subject>execute_test</subject> <body>…command…</body> </textMessage> Present commands in body HELP RTZ TXT S124
11
Usage of Verification Service –UC1
Mode 1 (Use Case 1). The intention is to provide complete chains of tests from client application, to service provider and a reply back to the service client acting as host. Initiate test of RTZ Create/select a well-known voyage plan, text or area message Find the STM VIS Verification Service Send (upload) message to the service Check the following Received message from STM Verification Service is identical with sent message Received text with verification results and service registration information If no messages received, the following may be wrong Invalid message Certificates URL in Service Registry
12
Usage of Verification Service –UC2
Mode 2 (Use Case 2). The intention is to initiate reception of a set of variants of messages. Initiate test of RTZ Send a text message (TXT) with execute_test in <subject> and RTZ in <body> Check the following Received voyage plans from STM Verification Service can be displayed and handled Received text with verification results and service registration information If no messages received, the following may be wrong Certificates URL in Service Registry Same type of test can be made with S124, or TXT in the body. If you send help in the body, you get a descriptive text message in return. <?xml version="1.0" encoding="utf-8"?> <textMessage xmlns:xsi=" xmlns=" <textMessageId>urn:mrn:stm:txt:sma: </textMessageId> <author>author</author> <from>urn:mrn:stm:service:instance:sma:stmvalidation</from> <createdAt> T08:00:00Z</createdAt> <subject>execute_test</subject> <body>RTZ</body> </textMessage>
13
Swagger UI tbd
14
CURL tbd
15
HOW-TO Send voyage plan to a service Case 1
Tools Editor (such as Notepad++) STM Module Tool (or other tool to interact with VIS Public REST API) Step-by-step In Editor Select base route and open in editor Edit vesselName vesselIMO vesselMMSI Waypoint Schedule Save As New file or copy content Step-by-step In STM Module Tool* Choose upper menu Find services Select the instance Select lower menu Upload VP Either Load message and select save file Or Paste (Ctrl-V) copied message from editor Press Ok Check that 200 OK is given in response window *CURL, PostMan, Swagger UI and other tools can also be used to upload (POST) a voyage plan (RTZ) to a service.
16
Test Data Test Data for each format can be found on
17
Test Cases
18
At the end – you could add text in black like ”Thank You !”
Similar presentations
