Page cover image

Landscapes

What is a landscape?

A landscape is the parent object for:

  • The shared model (Domains, Objects and connections)

  • Set of diagrams

  • Tags & flows

Consider a landscape to be the world you work in, referencing everything that interacts with each other in the real world - These should all be in 1 landscape.

When to split a landscape

The power of a landscape is the shared model, diagrams that can be drawn from the model and syncing updates across the whole landscape.

There are, however, a few reasons you may want to split out your landscapes. For example:

  1. There is a clear separation of systems and they never/rarely interact

  2. Regulatory reasons - keeping teams/people separate

  3. Consultants - Separating customer-specific designs to share with them

  4. Sandbox - Duplicating to "play" with the design or play with the features of IcePanel

Objects in separate landscapes are not linked in any way, so if you reference a system from another landscape, we recommend that you use the "External system" setting, so people know not to add the main details here. Updates will not be reflected if you edit these referenced objects.

Large or complex systems?

If you are struggling to organize your model because of a large and complex architecture (e.g., hundreds of apps/stores, and many diagrams), we recommend using Domains to split out your systems into logical business areas.

These systems and child objects remain in a single model and can be shared and synced from other domains, but it reduces the amount you see on the diagrams and model view. This allows you to focus your conversations and sections of your model on business areas, logical system groupings, segregation of external and internal systems, etc., with the reusability of a model.

Overview section

The overview section helps you access important diagrams and flows in your landscape or domain. It also contains insights on diagram activity and action items to keep your model up to date.

In the overview section, you can:

  • View and manage pinned diagrams or flows

  • See your recently viewed or edited diagrams or flows

  • See most viewed or edited diagrams over time in the entire landscape or domain

  • See action items in Health check (inaccurate comments, questions, unresolved comments, recommendations)

Selecting a domain will filter the overview section to that specific domain.

How to pin a diagram or flow

You can pin items from the overview or diagrams/flows sections (see Diagrams section and Flows section).

To pin something from the overview section:

  1. Click on the ... menu beside the diagram or flow

  2. Click on Pin diagram or flow button

To remove a pin, click the pin icon on the top left of the item in the pinned section.

Pinning items in the overview section

Duplicating a landscape

For the most part, we recommend using 1 landscape - as explained above.

If you need to copy, here's how you can duplicate an existing landscape:

Duplicating a landscape in the same organization

If you want to copy your work in the same organization, follow these steps:

You need to be an admin to duplicate a landscape.

Duplicating a landscape in the same organization
  1. Navigate to the overview screen.

  2. Click the dropdown at the top left of the screen.

  3. Select the ... menu next to the landscape you want to duplicate.

  4. Select Duplicate landscape.

  5. You'll auto-navigate to the duplicated landscape.

  6. Your duplicate landscape name will have the word "Duplicate" at the end.

Duplicating a landscape to another organization

You need to be an admin user in both organizations to do this.

Duplicating landscape to another organization

If you want to move your work to someone else's organization, follow these steps:

  1. Be invited to the other organization to which you want to copy your work.

  2. Ensure you are an admin user in both organizations.

  3. From the home screen, click the dropdown at the top left.

  4. Select the ... menu next to the landscape you want to duplicate.

  5. Select Duplicate to organization.

  6. Select the other organization and click Duplicate.

  7. You'll auto-navigate to the duplicate landscape in the other organization.

  8. Your duplicated landscape name will have the word "Duplicate" at the end.

Copying to another landscape in the same organization

You need to be an admin user to copy to another landscape.

Copying model/diagrams to another landscape

If you want to move your work to another landscape in the same org, follow these steps:

  1. From the home screen, click the dropdown at the top left.

  2. Select the ... menu next to the landscape you want to duplicate.

  3. Select Copy model/diagram between landscapes.

  4. Select the landscape you wish to merge with.

  5. Click Copy.

This adds the landscape as a new Domain. You can then move the object(s) from this new domain to where they make sense in your merged landscape.

Merging landscapes across organizations

Copying object(s) to another landscape

Currently, we don't support single-object copying between landscapes, only landscape based copying. However, if you want to move a system to another landscape, including the objects inside, you can use this workaround.

  1. Navigate to the Model objects list.

  2. Select all objects (CMD + A or CTRL + A).

  3. De-select the objects you want to move.

  4. Use the ... menu to delete the remaining selected objects.

  5. Confirm the deletion (If it's a large model, this might take time).

  6. If you see some objects that should have been removed, try refreshing the browser and see if they're still there.

Last updated

Was this helpful?