TODIS Route

Introduction 

Transportme allows users to import TODIS files in XML format to integrate route and stop data into the Transportme system.

The following route data can be imported from a TODIS file:

• Route Name
• Route Description
• Contract Number
• Departing Stop
• Route Stop List

Additionally, stop data can be imported from the TODIS file, including:

• Stop Name
• Reference Stop ID
• Longitude and Latitude Coordinates

Importing Routes

Step-by-Step Guide:

• Step 1: Prepare the XML File: 
  • Ensure the file follows the correct format and is validated. 
  • Once validated, compress the XML file into a .zip archive before proceeding.
    
• Step 2: Log in to the Transportme operator portal
• Step 3: Navigate to route import section 
  • From the top menu bar, select Routes.
  • Click the Upload Route File button.
  • Select the TODIS radio button to open the Add Route by TODIS form.
  

• Step 4: Upload XML File
  • Choose the appropriate Route Category to assign to the imported route.
  • Select the TODIS .zip file containing the XML data.
• Step 5: Import 
  • Click the Import button to begin the import process.
  • Wait for the Results of TODIS Import to be returned. The system will process the file and display a summary of the import results.

Results of TODIS Import 

When importing a TODIS file, the system will perform different actions depending on how the data from the TODIS file matches or differs from the existing route data in the Transportme system. Below are the possible outcomes:

Created 

If the TODIS Route ID does not match any existing route name in the Transportme system, a new route will be created.

Recreated 

If the TODIS Route ID matches a route name in the Transportme system, but there are significant differences, the route will be recreated. This happens when:

• The TME Route 'Imported from TODIS' is set to True, and:
  • The TODIS route has a stop that does not exist in the TME route (new stop added) OR
  • The TME route has a stop that does not exist in the TODIS route (stop removed) OR
  • The order of stops in the TODIS route is different from the TME route OR
  • The route includes changes in section travel or zone-to-zone compatibility.

Updated 

If the TODIS Route ID matches an existing route name in the Transportme system, the route will be updated. Updates occur when:

• The TME Route 'Imported from TODIS'' is set to True, and:
  • The TODIS route has a new route description OR
  • The TODIS route has a new contract number OR
  • The TODIS route has a new route category OR

No Changes 

If the data in the TODIS file matches exactly with the existing route data in the Transportme system, no changes will be made.

Deleted 

If the TME Route 'External Route Compatibility Flag' is set to True and the TME route name does not match any TODIS Route ID, the route will be deleted from the system.

Failed 

The import will fail if there are discrepancies that prevent the TODIS file from being correctly processed. 

---

Notes on Managing Routes Imported from TODIS Files 

• Important: For routes imported by TODIS, do not update the Route name, as it serves as a reference during the TODIS import process. Changing it may cause import issues.
• Important: The "Imported from TODIS" route option must be selected for the import to take effect.

• A route created by importing a TODIS file will have the Imported from TODIS option set to True. The following data will be imported from the TODIS file:
  
  • Route name
  • Route description
  • Contract number
  • Route stop list
• Other settings or data not included in the TODIS file will be assigned default values.
• After importing the route, it can be reviewed and updated as needed.
• Any updates made to the route after the TODIS import will be preserved, even if the route is later recreated or updated.