Use a shared project for organization-wide collaboration
Organizations often manage process documentation across multiple layers, from high-level strategic models to detailed operational workflows. Process landscape visualization streamlines this complexity by supporting different levels of abstraction, enabling seamless collaboration across teams, and providing tailored insights for various stakeholders.
About this guide
This guide shows how you can consolidate these perspectives into a single shared project, ensuring clarity, reusability, and governance within your organization’s efforts.
Teams can use shared projects to:
- Prevent duplicate work.
- Maintain a single source of truth.
- Enable cross-project navigation and transparency.
- Govern access to organization resources effectively.
Create a shared project
To create a shared project as a repository for your organization's resources:
Open Modeler, and select Create new project to create a new project to store resources in.
Invite collaborators to a shared project
If you want to invite collaborators to your shared project, you must also ensure you assign them the correct permissions and roles.
Add user to organization
First, you must add your colleague as a user to the organization:
- Click your account name, and select Organization Management.
- Select Users > Add New User.
- Add your colleague's email and assign an appropriate role.
- For example, the Developer role is typically a good default option to provide the user with full access to Console, Operate, and Tasklist without deletion privileges.
- Click Add.
- An email is sent to the email you provided.
- Your colleague must click Join to join the organization.
To learn more about available roles and associated permissions, see roles and permissions.
Add a user to a shared project
Once your colleague has joined the organization, you can add them to a shared project:
- Open Modeler, navigate to your project, and open the Collaborators panel.
- Click Add user and find the colleague you added to your organization.
You can also use the All users in the organization option to send a bulk invitation to all colleagues. - Assign a role, and click Send invites to send an invitation to the selected user(s).
- Once your colleague clicks Accept invitation, they can access the shared project with the assigned role and permissions.
Add resources to a shared project
You can share a specific version of a file or process application within the shared project.
- In the versions list, hover over the version you want to add to the shared project.
- Select the three vertical dots to open the actions menu.
- Select Copy to..., choose the shared project you want to store the shared resource in, and select Copy here to make it available for all project members.
Browse the process landscape of shared organization resources
The process landscape view offers a visual map of BPMN files and their interfile connections (e.g., call activities).
You can open the process landscape view by clicking View landscape from any of the following views:
- Project view
- Folder view
- Process application view
Landscape view interaction
-
Select a BPMN File: Click on any node to see the BPMN file’s information including the latest version of the process on the sidebar.
noteFor process applications, version tags represent a unified "versioned" snapshot of all process application files rather than separate versions for each file as with simple BPMN files.
-
Search: Press
Ctrl+F
or⌘+F
to search. Enter the name or identifier of a BPMN file to quickly find, highlight, and jump to the corresponding node. -
Highlight Paths: Click on a node or connection to highlight the entire chain of related connections.
README Documentation
To access the associated README file for a process within the shared project:
- Open the process landscape view.
- Click on a node in the landscape.
- The README file (if one is associated) is displayed in the sidebar, providing a high-level overview of the process.
Reuse resources from a shared project
Users can reuse published resources by copying them into their own projects:
- Open the shared project and navigate to the file.
- In the versions list, choose the version to reuse and select the three vertical dots to open the actions menu.
- Select Copy to....
- Select the target project and click Copy.