1. How-TO Use STM module tool
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”
How-TO Use STM module tool

2. HOW-TO Use STM Module Tool
This HOW-TO describes how STM Module Tool can be used to test services and applications.

3. 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, if you don’t use one of the existing, e.g. need a special ship or a private instance.
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

4. STM Module Tool in technical context
VIS Instance, e.g. STM Validation Centre
STM Module Tool
Private side
Public side
SSC
SeaSWIM (internet)
Public side
SSC
Public side
SSC

5. Start the application Save all files on local disk
Execute the file: STM.StmModule.Simulator.exe

6. Configure the application
Specify MCP environment (Development|Staging|Production)
Specify instance (as named in serviceinstance url suffix)
Auto download messages to folder on disk if appropriate

7. Handle and publish your own Voyageplan
Handle and publish your own Portcall message
callService API
Get uploaded messages
Find and consume external VIS services
Show map
Notifications from your VIS
Select instance and environment
View service instance log

8. Overview – Voyageplans
Publish your route to your VIS, set access and select subscribers on your route
Retrieve all currently published voyage plans
Publish new voyage plan
List of published voyageplans
Selected RTZ content
Handle subscriptions on selected RTZ
Publish selected RTZ
Show selected RTZ on map
Delete selected RTZ from VIS
Handle access to selected RTZ

9. Overview PCM

10. Overview – Find Service
Find service instance in Service Registry and consume. Can find all services, but can only consume service instances based on VIS Design.
Service instance description as registered in MCP

11. Find Service ”rules”
Free text search cannot be combined with other fields. Free text will override all other search attributes
If all attributes are empty, all services will be listed
* can in some fields be used as wildcard (e.g. Keywords)
Area search Search for all services related to a graphical object. WKT format See HOW-TO Register service and HOW-TO Search along a route on PP for more information

12. Functions Search for service to consume
Get voyage plans from service (e.g. ship)
Upload voyage plan (RTZ) to service
Upload text message (TXT) to service
Upload area message (S124) to service
Request to be subscriber to voyage plans
Remove subscription

13. Functions Read Notifications Get received messages from VIS
Show on map
Get received messages from SPIS
Get messages from past (history)

14. Functions Publish voyage plan to VIS and subscribers Show on map
Load list of published voyage plans in VIS
Nominate actor to voyage plan
Authorize organisation/actor to voyage plan
Add service as subscriber on voyage plan
Remove subscriber on voyage plan
Remove access to voyage plan

15. Functions Test schema validity on RTZ (v1.1STM) Visualize RTZ on map
Test schema validity on TXT (v1.3)
Test schema validity on S124 (v0.0.7)
Test schema validity on PCM (v0.0.16)

16. Functions
Send PCM message to PortCDM

17. Functions Reply on message Receive message (RTZ,TXT,S124,PCM)
Copy and paste into editor or upload window
Edit message
Find service to upload to
Upload message

18. At the end – you could add text in black like ”Thank You !”