> For the complete documentation index, see [llms.txt](https://docs.decisionrules.io/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decisionrules.io/doc/rules/common-rule-features/teamwork.md). # Teamwork Learn how Teamwork helps users coordinate changes with real-time presence, activity indicators, and save conflict warnings. ## Teamwork ### How it works Teamwork provides real-time information about other users working with the same rule version. It helps users coordinate their work and reduces the risk of accidentally overwriting someone else's changes. {% hint style="success" %} Teamwork **does not** lock the rule or automatically merge changes made by different users. {% endhint %} ### See who is viewing a rule When another user opens the same rule version, a colored avatar appears next to the rule name. The same presence indicator is also displayed next to affected rules in the rule overview. The indicator displays up to three user avatars. If more users are present, the remaining number is shown as **+N**. Hover over the indicator to see: * The number of users currently online. * Their email addresses. * Their current activity and editor, when available. * A summary of their unsaved Decision Table changes. The tooltip remains open while you interact with it, allowing you to select and copy email addresses. {% hint style="info" %} Presence is tracked for a specific rule version. Users working with another version of the same rule are not displayed. {% endhint %} ### Decision Table collaboration Decision Tables provide detailed real-time activity indicators. Each user is assigned a color that is used consistently throughout the editor. You can see: * The cell, range, rows, or columns selected by another user. * The cell another user is currently editing. * Cells changed by another user since their last save. * A preview of an unsaved value by hovering over its change marker. The Teamwork tooltip contains an **Unsaved changes** section with the number of changes made by each user. Click a user in this section to jump to their first marked change.
#### Saving while another user has unsaved changes If you try to save a Decision Table while another user is editing it or has unsaved cell changes, DecisionRules displays a warning. You can: * Cancel the save and allow the other user to finish. * Select **Save anyway** and continue, which may overwrite the other user's work. ### Decision Flow and Integration Flow collaboration Decision Flow and Integration Flow editors display live activity directly on the canvas. You can see: * Other users' cursors with their email addresses. * Nodes currently selected by other users. * A colored outline identifying which user selected each node.
### When another user saves the rule When another user saves a Decision Table, Decision Flow, or Integration Flow that you currently have open, DecisionRules displays the **Rule was saved by another user** dialog. You can: * Select **Load saved version** to reload the latest version from the server. Your local unsaved changes will be discarded. * Select **Ignore** to keep your current local state and continue working. Ignoring the notification does not merge the remote changes into your local version. Saving your local version later may overwrite the changes saved by the other user. ### Supported teamwork features | Rule type | Presence indicator | Detailed live activity | | ---------------- | ------------------ | ------------------------------------------------------------- | | Decision Table | Yes | Selections, editing cells, unsaved changes, and save warnings | | Decision Flow | Yes | Live cursors and selected nodes | | Integration Flow | Yes | Live cursors and selected nodes | | Other rule types | Yes | Presence information only | {% hint style="warning" %} Sessions signed in with the same account are treated as one user and do not appear to each other. The Teamwork indicator distinguishes between different user accounts. Teamwork provides awareness and conflict warnings, but it does not lock content or automatically merge concurrent changes. Coordinate with other users before saving when multiple people are editing the same rule version. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decisionrules.io/doc/rules/common-rule-features/teamwork.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.