Everest icon

Everest

Interact with Everest TMS (Transport Management System)

Mission → Set Status

AI-generated

Overview

The node operation 'Set Status' under the 'Mission' resource allows users to update the status of one or multiple missions in the Everest Transport Management System. This is useful for tracking the progress or state changes of missions, such as marking them as completed, in progress, or any other defined status. Users can specify mission references (IDs) as a comma-separated list and set a new status along with optional details like comments, a base64-encoded signature image, and GPS coordinates (latitude and longitude) for the status update.

Use Case Examples

  1. Updating the status of a single mission to 'Completed' with a comment and GPS location.
  2. Setting the status of multiple missions at once by providing their references and a new status.

Properties

Name Meaning
Mission References Comma-separated list of mission references (IDs) to update.
Status The new status to assign to the specified mission(s).
Status Details Additional details for the status update, including comment, signature image (base64), latitude, and longitude.

Output

JSON

  • missionReference - The reference ID of the mission updated.
  • status - The new status assigned to the mission.
  • statusDetails
    • comment - Optional comment provided for the status change.
    • signature - Optional base64 encoded signature image associated with the status update.
    • lat - Optional GPS latitude coordinate of the status update.
    • lng - Optional GPS longitude coordinate of the status update.

Dependencies

  • Everest TMS API with an API key credential for authentication.

Troubleshooting

  • Ensure mission references are correctly formatted as comma-separated values; invalid references may cause errors.
  • Verify that the status value is valid and available in the system; invalid statuses will be rejected.
  • If using GPS coordinates, ensure they are in the correct format (string representation of latitude and longitude).
  • Common errors may include authentication failures if the API key is missing or invalid, or network issues when connecting to the Everest TMS API.

Links

Discussion