Frequently Asked Questions

Common questions and answers about the Trimble n8n automation platform. Can’t find what you’re looking for? Check our Community or reach out to support.

Getting Started

How do I get access to n8n?

Navigate to Trimble Okta at Trimble Okta. Search for n8n App using the search function to find the N8N—Stage application. Click to launch the app directly from Okta. Access Staging Environment where you’ll be redirected to the staging instance of n8n at http://flows.stage.trimble-ai.com/.

What are the prerequisites for using n8n?

You need to be an active Trimble employee with Okta SSO credentials, have a basic understanding of workflow automation concepts, and comply with Trimble data security policies.

Is there a cost to use the platform?

Currently, n8n is provided free of chargebacks to Trimble internal teams for prototyping and development purposes. Resource limits may apply based on usage.

Can I use this for production workloads?

Yes, but this is not recommended due to cost, performance and UX considerations. Production deployments require additional approval and must comply with enterprise security and governance policies. Contact the Agentic AI Platform team for production readiness assessment.

Technical Questions

What integrations are available?

n8n provides 400+ pre-built integrations. Popular External Services include Salesforce, HubSpot, Marketo, Slack, Microsoft Teams, Email, AWS, Azure, Google Cloud, GitHub, GitLab, Jira, and Databases (PostgreSQL, MySQL, MongoDB).

Don’t see what you need? n8n supports HTTP requests and custom webhooks for any API.

How secure is the platform?

The Trimble n8n application includes enterprise-grade security with Authentication through Trimble SSO integration with MFA, Authorization using role-based access controls, Data Protection with encryption at rest and in transit, Audit Logging for complete execution and access logging, Network Security provides private network access and Compliance with SOC 2, GDPR, and internal security standards.

Can I import/export workflows?

Yes! You can export workflows as JSON files, import workflows from other n8n instances, share templates with the community, version control workflows with Git integration, and backup and restore entire projects.

How do I handle sensitive data like API keys?

Use n8n’s built-in credential management to store credentials securely with encryption, implement role-based access to sensitive credentials, enable automatic credential rotation (where supported), maintain audit logging of credential usage, and ensure environment-specific credential isolation.

Workflow Development

What programming knowledge do I need?

n8n is designed for no-code/low-code users with no coding required through visual drag-and-drop interface. There are optional code nodes for Javascript or Python based coding. Code nodes are typically used for things like advanced data transformations.

How do I debug workflow issues?

n8n provides comprehensive debugging tools including manual execution to run workflows step-by-step, debug mode to inspect data at each node, error handling to configure retry policies and error notifications, execution history to review past runs and errors, and logging with detailed execution logs with timestamps.

Can workflows run on a schedule?

Yes! n8n supports multiple trigger types including:

Schedule triggers to run at specific times/intervals
Webhook triggers to trigger from external systems
Manual triggers to run on-demand
File Watchers to trigger on file changes
Database triggers to trigger on data updates

How do I handle errors in workflows?

Implement robust error handling with Try-Catch Blocks to handle errors gracefully, Retry Logic for automatic retries with backoff, Error Notifications to alert teams when workflows fail, Fallback Actions for alternative paths for failures, and Manual Intervention to pause for human review when needed.

Several sharing options are available including Project Teams to add team members to your n8n project, Workflow Export to share workflow files directly, Template Library to publish templates for organization use, Documentation to include setup and usage instructions, and Version Control to track changes and collaborate on updates.

What are n8n Projects?

Projects in n8n help streamline resource management, enhance collaboration, and improve security through structured organization and access control.

Separation and Organization: Projects allow you to group workflows, variables, and credentials into separate collections, making it easier to manage and organize resources, especially in larger or more complex environments.
Collaboration: Projects facilitate team collaboration by enabling sharing and compartmentalization of related resources. This means teams can work together on specific sets of workflows and credentials without interfering with other projects.
Access Control: With Role-Based Access Control (RBAC), you can assign different roles (Admin, Editor, Viewer) to users within each project, giving fine-grained control over who can view, edit, or manage resources in each project. A single user can have different roles in different projects, allowing for flexible access management RBAC Projects.
Resource Management: Projects make it easier to move workflows and credentials between groups or users, and to manage the lifecycle of these resources (such as transferring or deleting them when a project is removed) RBAC Projects.
Security and Compartmentalization: By isolating resources in projects, you reduce the risk of accidental changes or unauthorized access to unrelated workflows and credentials RBAC Projects.

How to create a project in n8n

What are the different user roles?

Three main roles with different permissions:

Viewer: View workflows and executions, access documentation, monitor performance, and download execution data.
Editor: Create and modify workflows, run test executions, access credentials, and deploy to dev/staging.
Admin: Full project management, add/remove team members, configure settings, and approve production deployments.

Data and Integration

What data formats are supported?

n8n handles multiple data formats including JSON as primary format for data exchange, XML with parsing and generation support, CSV with import/export capabilities, Binary for file processing and manipulation, and Databases with direct SQL query support.

How do I handle large datasets?

For large data processing use Pagination to process data in chunks, Streaming for real-time data processing, Batch Processing scheduled during off-peak hours, Data Filtering to process only necessary data, and External Tools to integrate with specialized data platforms.

Can I connect to external APIs?

Yes! n8n provides flexible API connectivity with HTTP Request Node to connect to any REST API, Authentication Support for OAuth2, API keys, basic auth, Custom Headers to add required headers and parameters, Response Handling to parse and transform API responses, and Error Handling to manage API rate limits and errors.

Monitoring and Analytics

How do I monitor workflow performance?

Built-in monitoring features include Execution Dashboard for real-time status overview, Performance Metrics for response times and success rates, Resource Usage tracking CPU, memory, and storage consumption, Error Tracking for failed executions and error patterns, and Custom Alerts for notifications for specific conditions.

What metrics are available?

Key metrics include Execution Count for number of workflow runs, Success Rate for percentage of successful executions, Average Runtime for execution time statistics, Error Rate for frequency and types of errors, and Resource Usage for system resource consumption.

Security and Compliance

How is data handled and stored?

Data security measures include Encryption with AES-256 encryption at rest and TLS in transit, Access Controls using role-based permissions, Audit Logging with complete access and execution logs, Data Residency on Trimble-controlled infrastructure, and Retention Policies with configurable data retention periods.

What compliance standards are met?

Current compliance includes SOC 2 Type II for security and availability controls, GDPR for data protection and privacy compliance, Internal Standards for Trimble security and governance policies, and Industry Standards including ISO 27001, NIST frameworks.

Troubleshooting

My workflow is failing. How do I diagnose the issue?

Debugging steps: Check Execution History to review recent failed runs, Enable Debug Mode to step through workflow execution, Review Error Messages to understand specific failure points, Test Individual Nodes to isolate problematic components, Check Credentials to verify authentication and permissions, and Review Logs to examine detailed execution logs.

Workflows are running slowly. How can I optimize?

Performance optimization: Reduce Data Volume to process only necessary data, Optimize Queries to improve database query efficiency, Use Caching to cache frequently accessed data, Parallel Processing to run independent tasks concurrently, and Review Node Configuration to optimize node settings.

I’m hitting rate limits. What should I do?

Rate limit management: Implement Delays to add pauses between API calls, Use Batch Processing to group requests efficiently, Check API Documentation to understand provider limits, Consider Alternatives using different endpoints or services, and Contact Support to request limit increases if needed.

How do I recover from a failed workflow?

Recovery strategies: Manual Retry to re-run failed executions, Partial Recovery to resume from failure point, Data Restoration to restore from backups if needed, Rollback Changes to revert to previous workflow version, and Error Analysis to understand and fix root cause.

Support and Resources

Where can I get help?

Direct Support: Community GChat at Agentic AI Platform - Community for support and collaboration.

Important: Support is community-driven with no official SLA. The Agentic AI Platform team has limited resources, so responses are provided on a best-effort basis through community collaboration.

Are there training resources available?

Not from Trimble, but never fear! There is a vibrant community of n8n enthusiasts that have tutorials on YouTube, as well as training resources and documentation from n8 themselves. Here are some good YouTube channels to get you started: