How can I test my scripts safely before deploying them?

    TestRun is the primary feature for safely testing sync scripts before deployment. This functionality lets you select specific work items from your connected systems and run your draft configuration against them in a simulation environment. You can review exactly how your scripts will transform data, which fields will sync, and what the resulting work items will look like without affecting live data or active synchronization.

    Validate Both Outgoing and Incoming Scripts

    The TestRun process shows you the outcome of both outgoing and incoming scripts for selected test cases. You can identify issues like incorrect field mappings, missing data transformations, or logic errors before they impact production work items. If results don't match expectations, you modify the scripts and run additional tests until the configuration behaves correctly.

    Review how the sync configuration will be applied to your items, preview the replica, and verify that field mappings look correct. Deploy only when you're confident everything works as expected.

    Draft Versions Isolate Configuration Changes

    Draft versions provide another layer of safety by isolating configuration changes from active connections. When you need to modify an existing connection's sync rules, you create a new draft version rather than editing the live configuration directly. This draft exists independently, allowing you to develop and test changes without disrupting ongoing synchronization. Changes in the draft save automatically. Only when you're satisfied with test results do you publish the draft to make it the active version.

    Rollback When Issues Arise

    Versioning enables rollback if deployed changes cause unexpected issues. The platform maintains a complete history of all configuration versions for each connection. If a newly deployed script creates problems, you can quickly revert to a previous working version while you investigate and fix the issue. This safety net reduces risk when making configuration changes to production integrations, ensuring you maintain full script and operational control over your sync.

    Aida Identifies Potential Problems

    Aida also helps identify potential problems before deployment by analyzing your scripts and suggesting improvements. When Aida finishes drafting your script, review the suggested changes—green highlights indicate new lines that will be added, while red highlights show lines that will be removed. You can choose to "Insert" or "Discard" Aida's suggestions. When you describe changes to Aida, it can flag logic that might cause errors or recommend better approaches based on the context of your connected systems.