TLEX Interchange Quick Start Guide
Estimated time: 30-45 minutes
Goal: Set up your first actor and start exchanging data
Prerequisites
Before starting, ensure you have:
- Basic understanding of data publishing/subscribing concepts
- Your personalized TLEX URL and activation email
Need help? Contact our support team for guidance.
Step 1: Access Your TLEX Tenant
- Go to your personalized URL from the deployment email:
https://<your-subdomain>.tlex.cloud - Log in with your email address and the password from your activation email
- Forgot password? Use the "Forgot password" link or contact support
Step 2: Key Concepts
| Concept | Definition | Example |
|---|---|---|
| Actors | Systems that publish or subscribe to data | Your traffic management system |
| Capabilities | Data streams with defined metadata constraints | SPAT messages from a specific publisher and region |
| Policies | Rules defining which actors can consume which capabilities | Traffic management actors can consume intersection SPAT data |
Need more detail? Read our Key Concepts Explained guide
Step 3: Create Your First Actor
- Navigate to TLEX Interchange Admin > Local Actors
- Click "Create New"
- Enter the Common Name (CN):
- Must contain at least one "." (period)
- Maximum 64 characters, alphanumeric/hyphens/periods only
- Example:
traffic-mgmt.downtownorcam.publisher.cityname
- Click "Create" to generate the actor
- Download the certificate bundle and store securely
Important: Share certificates only with authorized contacts via encrypted channels.
Step 4: Define a Data Capability
- Go to Own Capabilities
- Click on your actor from the list
- Click "Create New"
- Choose Simple View (recommended for getting started)
- Fill in the details:
| Field | Example |
|---|---|
| Publisher ID | UK12345 |
| Publication ID Postfix | DEV_CAM_02 |
| Message Type | CAM |
| Protocol Version | CAM:1.4.1 |
- Press "Create" to save and close the dialog
- Click "Show Data" on your new capability to review the JSON structure
Step 5: Configure Access Policies
Set up your actor to consume the capability you just created (enables testing).
- Navigate to Policies
- Click on your actor from the list
- Click "Add Capability"
- Find your capability (Publisher ID "UK12345", Postfix "DEV_CAM_02")
- Click the "+" button next to it
- Click "Done"
Why this setup? Your actor can now both publish and consume the same capability, allowing you to test message flow.
Step 6: Set Up Data Flow
Choose how to create endpoints for publishing and consuming data:
| Option 1: Static Endpoints (Start Here) | Option 2: Dynamic Endpoints (Production) |
|---|---|
Description: Best for:
Limitations:
| Description: Best for:
Advantages:
|
Recommendation: Start with Static for learning, migrate to Dynamic for production.
Step 7: Monitor Your System
Open the TLEX Interchange Dashboard to monitor:
- Message Metrics: Published and consumed messages by actor and capability
- Policy Visualization: Current policies in place
- System Health: Overall data flows and status
Congratulations!
You've successfully set up TLEX Interchange!
Your actor can now publish and consume data. Check the dashboard to see message flow when you start sending test messages.
Ready for production? Consider migrating to dynamic endpoints for higher volumes and better resilience.
Pricing & Support
Pricing: View TLEX pricing tiers
Get Help
Need assistance?
Troubleshooting
| Issue | Solution |
|---|---|
| Can't access tenant URL | Check email for correct subdomain, verify account activation |
| Certificate bundle not downloading | Disable popup blockers, try different browser, ensure Common Name is RFC-compliant |
| API endpoints not generating | Wait 5 minutes, refresh page, contact support if persistent |
| Data not flowing | Verify capability is created, check policy allows consumption, confirm endpoints are configured |
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article