SMDS Modernized Vessel UI Guide
- Vessel Roles & Azure Groups
- Vessel User Interface
- Prerequisites
- Login
- Logout
- Vessel User Roles Search
- Vessel Search Criteria
- Vessel Search Results
- Vessel Export
- Edit Vessel Data
- Create a new Vessel record
- Vessel Approver Workflow
- Quick links
Vessel Roles & Azure Groups
There are many Azure AD groups. Each Azure AD group has a one-to-one mapping with the vessel roles.
The users have to be added to the corresponding groups to get the relevant role privileges.
| Requestor Role Name | Description |
|---|---|
| VESSEL_READ_ACCESS | Vessel Reader Access |
| VESSEL_FLEETTECH_ROLE | Vessel Fleet Tech Role |
| VESSEL_POSTFIXTURE_ROLE | Vessel Post-Fixture Role |
| VESSEL_MARINEOPS_ROLE | Vessel Marine Ops Role |
| VESSEL_DELETE_ACCESS | Delete access role of the Vessel Carriers |
| VESSEL_CAPACITY_ROLE | Capacity access role in Vessel |
| VESSEL_REFERENCE_LIST | Reference List Creation/Updation roles |
| VESSEL_INSURANCE | Vessel Insurance access role |
| VESSEL_FINANCE_PART1 | Finance-1 role of Vessel |
| VESSEL_FINANCE_PART2 | Finance-2 role of Vessel |
| VESSEL_REQUESTOR | Vessel Requestor role |
The Approver roles are:
| Approver Roles | Description |
|---|---|
| Vessel Nautical Marine | Vessel Nautical Marine Approver role |
| Vessel Fleet Naval | FT Naval Arch Data Approver role |
| Vessel Fleet Machinery | Machinery data approver role |
| Vessel Fleet Electrical | Vessel Electrical Data Approver role |
| Vessel Data Owner | Second level Approver. Data Owner |
Vessel User Interface
Prerequisites
- The user should have an active Azure account.
- The user should have the Vessel role(s) to access the SMDS Vessel UI.
- If the user doesn’t have sufficient Vessel roles, they’ll see the following UI when trying to open the application, they can raise a SNOW ticket using the button given in the UI.
Login
-
The user has to give the Microsoft credentials to log in.
-
After the valid UserId and Password are provided, the User would be asked if they need to stay signed in
-
After that authorization and authentication will take place, and once it's a success, the User will see the Vessel landing page.
Logout
To log out from the application click on the user profile icon in the application header, and then click on the “Logout” option present in the drop-down. Once you log out of the system, it will ask you to log in again, as without signing in, the portal cannot be accessed. To refresh the roles assigned to the user, logging out and refreshing the window is important.
Vessel User Roles Search
The user can find the assigned roles by clicking the option “User Roles” from the dropdown that appears on clicking on the User Profile Icon in the header tab of the application.
The assigned roles of a user will be shown something like this:
Vessel Search Criteria
There are mainly two types of search criteria for the vessel.
- Active Vessels Search
- Pending Vessels Search
Active Vessels Search
This is the default Vessel Search page which portrays the Active Vessel records in the result set.
Pending Vessels Search
This is to find the Vessels that are currently in the pending state, i.e. the records which are still not yet approved by the Approvers.
Vessel Search Results
Based on the search criteria mentioned above the system will show the relevant records in a sub-screen like in the image below upon clicking on the ‘Search' button or hitting the 'Enter’ key on the keyboard while being on the search screen.
Note:
-
Users can paginate the results accordingly at their convenience. The pagination buttons can be found at the bottom of search results.
-
Upon clicking on the open icon present in the actions column in the search results table, the relevant Vessel record would be opened in a new sub-screen.
Vessel Export
Vessel Search Result table there would be a button to export the table data which are currently displayed. On clicking the button the table data would be exported into an Excel.
Edit Vessel Data
Firstly, User needs to click on the “View” button from the Search-Result table to open up a particular Vessel record.
e.g.,
Above is an example where the entire vessel data is being displayed and there exists many tabs.
Vessel: This tab contains the basic Vessel identifications, Hull Information and Retrofit Details.
Operators: This tab contains the Vessel Operators and their Carrier information details.
Vessel Specification:
Communications:
Cargo Capacity:
Ownership:
Machinery:
Vessel Insurance:
Vessel Financial Info:
Note:
- ‘Edit’ button will make the attributes editable.
- ‘Apply’ button can be clicked when there are no any errors in that particular tab.
- ‘Cancel’ button can be clicked to reset the form changes of that particular tab.
- If there is an red asterisk visible on any tab, that signifies that the corresponding tab data changes are not saved by clicking the ‘Apply’ button.
- If there is any cross validation or form data error, then the ‘Apply’ button will be disabled only & the relavant error message would be shown in the form.
- ‘Save’ button on the tab will be enabled only if there are no any form errors in any tab.
Create a new Vessel record
User can create a new Vessel record by clicking the link “Do you want to create a new one?”
https://vmd.maersk.com/create/vessel
The following screen will be opened up where user can add the Vessel data as required. The form looks similar as mentioned above in the ‘Edit a Vessel Data’ section.
Vessel Approver Workflow
Requestor Level
Send For Approval Functionality
Tasks Inbox
Resubmit/Withdraw functionality
View Process Details
Approver Level
Tasks Inbox
Approve/Reject Tasks
Audit Trails
Show Pending Changes and Comments
Vessel Reference List Creation/Updation/Activation/Deactivation
User should be having VESSEL_REFERENCE_LIST role to access this
User can find this section in the header menu.
The Vessel Reference List screen will be shown something like this mentioned below:
Vessel History
User can see the historical data of the vessel by clicking the “Record History” button
After clicking the button a new pop-up would be opened. User has to give the desired From and To date to for the same.
Note:
- Maximum up to 3 months date range cant be provided, or else the system will throw error.
- To Date will be by default selected as current date, but user can modify it.
- Current vessel snapshot will be shown by default always. On clicking on it, the current vessel data in non-editable mode would be opened in a new browser tab.
The historical data upon search will show it likewise as mentioned below:
Copy Vessel
With existing copy functionality most of the data gets populated in the new record which increased risk where user may overlook data & saved vessel record as it is or either has to remove & update the correct values which is double efforts.
Hence, Copy Vessel functionality allows to copy the existing vessel data and create a new one.
Below are the fields which will be copied when user click the button “Copy Vessel”.
To overcome with these challenges while creating record using copy functionality only specific data as specified below in the attached file should be auto populated/copy from the vessel.
Vessel Bulk Upload for Champs
As data maintainer, user should be able to load the vessel data collected in excel template as attached below (also called as questionnaire) and upload it to VMD to create a new vessel record and update existing.
- All available data in the template should be get uploaded in the VMD at the correct feilds
- In case if vessel record already exists in the VMD needs to be get append with latest information in the template.
User can find the “Vessel Bulk Upload” option in the header part.
The UI will be shown as below:
Please find a Questionnaire template attached below.
Please find the UI Regex Validation message attached below
Quick links
- Vessel CDT Portal : https://vmd-cdt.maersk.com/
- Vessel Stage Portal : https://vmd-stage.maersk.com/
- Vessel Prod Portal : https://vmd.maersk.com/