Knowledge Base
About DataloyRelease NotesAPI DocumentationJava VMS Documentation
Release 8.5
Release 8.5
  • Knowledge Base
  • Voyage Management System
    • VMS: Step-By-Step Guides
      • Vessels
        • Create Vessels
        • Copy Vessel
        • Find Vessels
        • Voyages & Port Calls
        • Main Vessel Description
        • Speed & Consumption
        • Load & Discharge Rates
          • Manage Load And Discharge Rates
        • Internal Data
        • AIS & Weather Reports
        • AIS-subscription
        • View Vessel Route from Previous Port to Next Port
      • Voyages
        • Create New Voyages
          • Create Voyage Charterer
          • Create Time Charter Out
          • Create Voyage From Template
          • Create Voyage Without Cargo
        • Find Voyages
        • Maintain Voyages
          • Overview
            • Vessel
            • Cargo
            • TC
            • Schedule
            • Profit/Loss Summary
              • Analysis
            • Speed & Consumption
          • Cargo
          • Bunkers
          • Various Cost/Revenue
          • Organisational Data
          • Invoices
          • Downtimes
          • Related
          • Voyage Functionalities
            • Converting Voyage to Template
            • Change Voyage Status
            • Swap Vessel
            • Configure Voyage as a “Last TC Voyage”
            • Change Voyage Reference Number/Voyage Number and Voyage Starting Year
            • Voyage Comparison
        • TC Voyages
        • Create Laytime Calculations
        • Delete Voyages
        • Voyage Map
        • Voyage Schedule
        • Voyage Edit Schedule
        • Voyage Alternative Routes
        • Voyage Functions
          • Sensitivity Analysis
          • Intake Calculation
        • Long Time Charter (TC) Voyage
        • Voyage Bunkers
        • Voyage full-screen
          • Data grid
            • Port Calls Grid
            • Cargoes Grid
            • Cargo Ports Grid
            • Various Grid
      • Cargoes
        • Create New Cargoes
          • Create Cargo
          • Create Cargo From CoA Template
          • Create Cargo on TC Voyages
          • Create Cargo by Importing from Excel
          • Create Cargo From Existing Cargo
        • Find Cargoes
        • Maintain Cargoes
          • Cargo drawer
            • Main Details
            • Sub-cargoes
            • Various Cost/Revenue
            • Commissions
            • Freight Rate Tiers
            • Payment Terms
            • Comments
            • Cargo Drawer Actions
              • Allocate Cargo
              • Change Cargo Status
              • Delete Cargo
              • Relet Cargo
              • Convert Cargo to Relet/Non-Relet
              • Transship and Preship Cargo
              • Transfer Cargo
              • Connect Cargo to CoA
              • Remove CoA from Cargo
        • Template Cargoes
        • Capacity Plan
        • Sub-cargo
        • View Cargo History
      • Port Calls
        • Find Port Calls
        • Maintain Port Calls
          • Days Extra In Port
          • Speed Order
        • Port Call Drawer
          • Overview (And Bunkers)
            • Use Port Cost from Service Orders
              • Automating the Use (Port) Cost from Service order
            • Use Handling Cost from Service Orders
          • Service Orders
          • Bunker Orders
          • Vessel Reports
          • Port Log
            • Stoppages
        • Register Reports
          • Register Noon Reports
          • Register Arrivals
          • Register Berths
          • Register Unberths
          • Register In Port Reports
          • Register Departures
        • Custom Port Calls: 'At Sea'
      • Port Costs
        • Find Port Costs
        • Maintain Port Costs
        • View Service Orders of Port Costs
      • Contracts of Affreightment
        • Find a CoA
        • Create a CoA
        • Maintain a CoA
        • Contract of Affreightment Lines
          • Find CoA Lines
          • Create CoA Lines
          • Maintain CoA Lines
            • Template Cargoes
              • Find Template Cargoes
              • Create Template Cargoes
              • Maintain Template Cargoes
      • Time Charter Contracts
        • Create Time Charter Contracts
        • Maintain Time Charter Contracts
          • Duration and Rates
            • Create Duration and Rates
          • Notices
          • Comissions
          • Payment Terms
          • View Speed & Consumption
          • View Voyages
        • Print Statement of Account
      • Broker Commissions
        • Create Commissions
        • Find Broker Commission
        • Maintain Broker Commission
      • Bunker Orders
        • Create Bunker Orders
          • Create from a port call
          • Create bunker order from scratch
        • Maintain Bunker Orders
        • Stem Bunker Orders
        • Register Delivery Against a Bunker Order
        • Cancel Bunker Order
        • Delete Bunker Order
      • Service Orders
        • Create a Service Order
        • Maintain Service Orders
        • Handling Cost Allocation
        • Delete Service Order
      • Laytime Calculations
        • Create Laytime Calculation
        • Find Laytime Calculation
        • Delete Laytime Calculation
        • Maintain Laytime Calculation
          • Status
          • Drawer Fields
          • Manage Cargo Ports
            • Cargo Port Fields
            • Statement Of Facts
              • Event
            • Timesheet
      • Bills of Lading
        • Create Bills of Lading
        • Attachments
        • Edit Bills of Lading
        • Delete Bills of Lading
        • Print Bills of Lading
        • Print Sea Waybills
      • Downtimes
        • Create Downtime
        • Find Downtime
        • Maintain Downtime
          • Status
          • Overview
          • Various Cost/Revenue
          • Delete Downtime
      • Vessel Reports
        • Find Vessel Reports
        • Create Vessel Reports
      • Voyage Analysis Dashboard
        • Log In
        • Viewing and Managing Deviated Voyages
          • Viewing and Managing Deviated Voyages
          • Viewing Post Voyage Analysis Detail
          • No Freight Received
      • Invoices
        • Invoices List
        • Pending Invoices
        • Assembling Invoices
        • Invoice Drawer
        • Printing Invoices
        • Reversing an Invoice
      • Bunker Transactions
      • Accruals
        • Accruals
          • Batch Post Accruals
          • Generate Accruals
          • Find Accruals
          • Maintain Accruals
        • Bunker Stock Adjustments List
          • Batch Post Bunker Stock Adjustments
          • Bunker Stock Adjustment Drawer
        • Actuals list
        • Time Correction list
      • Status Transitions
      • Webhook Subscriptions
        • Create Webhook Subscription
        • Find Webhook Subscription
        • Maintain Webhook Subscription
          • Overview
          • Notification
      • Setup
        • Users
          • Create Users
            • Create a Vessel Master user
          • Maintain Users
            • Change User Passwords
          • Find Users
          • Disable Users
          • Multi-Factor Authentication (MFA)
            • Guardian Multi-Factor Authentication (MFA)
        • Security Roles
          • Find Security Roles
          • Create Security Role
          • Maintain Security Roles
        • Security Groups
          • Security Group Aliases
          • Find Security Groups
          • Create Security Group
          • Maintain Security Groups
        • System Settings
          • General
          • Invoicing Preferences
        • Data Control
        • Widgets
      • Master Data
        • Banks
        • Bunker Categories
        • Bunker Types
        • Business Partners
          • Manage Business Partners
        • Companies
          • Manage Companies
        • Events
        • Ice Class
        • Individuals
        • Port
        • Restricted Areas
        • Taxes
        • Various Costs and Revenues
        • Vessel Types
        • Commodities
      • EU ETS Compliance
      • Fuel EU
      • Attachments
      • Audit Log
      • Comments
      • Notifications
      • Field Validations
      • Sorting and Filtering Lists
      • Customising List Columns
      • Export to Excel Sheet
      • Widgets
    • Oracle Database Compatibility
  • Fleet Allocation & Scheduling
    • FAS: Step-By-Step Guides
      • Capacity Plan
      • Fleet Plans
        • Open Positions Board
        • Scheduler Board
        • Cargo Management Board
          • Cargo Actions
        • FAS Voyages List
        • FAS Cargoes List
        • Voyage Actions
      • Scenarios
        • Find Scenario
        • Create Scenario
        • Maintain Scenario
        • Copy Scenario
      • Budgets
        • Create Budget Scenario
        • Template Voyages
          • Create Template Voyages
          • Find Template Voyages
          • Maintain Template Voyages
        • Budgeted Voyages
          • Find Budgeted Voyages
          • Bulk Updating Budgeted Voyages
    • Create Voyages (JVMS)
      • Create Commitment
      • Create Commitment from CoA
      • Create Commitment from Voyage Estimate
  • Dataloy Distance Table (DDT)
    • About Dataloy Distances
    • Routing and routing options
    • Custom Point using Latitude and Longitude
    • High-Risk Area (HRA) / Piracy Routing
    • Distances API
    • Distances Change Log
  • Dataloy Systems AS
    • Privacy Policy
    • GDPR Statement
    • Release Notes
Powered by GitBook
On this page
  • Validation behavior in drawers
  • Validation behavior in create-type modals
  • Configuring field validations
  • Key fields in the validation dialogue
  • Example: Setting a range validation
  • Managing existing validations

Was this helpful?

Export as PDF
  1. Voyage Management System
  2. VMS: Step-By-Step Guides

Field Validations

PreviousNotificationsNextSorting and Filtering Lists

Was this helpful?

Field validations in VMS allows administrators to set rules for most input fields, ensuring data aligns with customer requirements. Validations alert users or restrict data that doesn't comply with these rules.

When field validations are configured, fields in the interface visually change to provide feedback to the user regarding their current status:

  • Correct Input: When fields are filled out correctly according to the validation rules, they will display normally without visual indicators.

  • Warnings: If a field violates a warning-level validation rule, it will display with an orange outline, but users can still proceed with their actions.

  • Errors: If a field violates an error-level validation rule, it will display with a red outline and a light red background, sometimes preventing the user from submitting or saving the data.

Validation behavior in drawers

When a field in a drawer triggers a warning or error, a notification will be displayed within the application. This notification provides additional context, helping users identify and resolve the issue quickly, but the user is not prevented from filling in the data.

Validation behavior in create-type modals

In create-type modals, field validation errors will block the user from completing the "Create" action until all errors are resolved. Warnings in these dialogues will not block the creation process but will encourage the user to review the input.

Configuring field validations

To configure a new or existing field validation, you can right-click almost any input field and click Field Validation in the menu that opens. When creating a field validation, you will see a configuration dialog, like the one below.

Key fields in the validation dialogue

  1. Field Path: This is the unique identifier of the field for which the validation is being set. It is pre-filled based on the input field you right-clicked and cannot be changed.

  2. Field Validation Level:

    • Error: Prevents the user from saving invalid data in create-type modals.

    • Warning: Allows saving but alerts the user to potential issues.

  3. Field Validation Type: Determines the kind of rule to apply. The available options are:

    • Condition: Validates numerical ranges (e.g., between specific values).

    • Length: Sets limits on the character length of the input.

    • List: Restricts inputs to a predefined comma-separated list of values.

    • Mandatory: Requires the field to have a value.

  4. Field Validation Rule: This option appears when the "Condition" type is selected, allowing you to specify if the input must be between two values or greater than or less than a specific value.

  5. When the validation type is "Condition" and the rule is "Between," "Less Than," or "Greater Than," the fields specify the numerical range. In the example provided, the range is set from 1.00 to 6000.00.

  6. Field Validation Description (Optional): Enter a custom message to display to users when validation fails. This helps provide clear guidance about what is expected.


Example: Setting a range validation

Let’s walk through an example of setting a numeric range validation for a field:

  1. Open the Voyages -> Create Voyage Charter dialogue.

  2. Right-click on the Cargo Quantity input field.

  3. Select Field Validation from the context menu.

  4. In the Field Validation Type dropdown, choose Condition.

  5. Set the Field Validation Rule to Between.

  6. Enter 1.00 as the From Value and 6,000.00 as the To Value.

  7. Add an optional description like: “Cargo quantity must be between 1 and 6,000.”

  8. Click Create to finalise the validation.

  9. To apply the validation, close and reopen the Create Voyage Charter dialogue.

This ensures that users are warned if they enter values outside the specified range, helping maintain data integrity.

Managing existing validations

To modify existing validations, right-click a field with field validation applied. This displays almost the same dialogue as creation. Additionally, it has a "status" switch at the top – turning it off disables the validation.

To adjust field validations without going through right-clicking a field, navigate to Setup -> Field Validations. Here, you can view all validations, check their statuses, and edit the rules as needed.

A warning and an error field validation