You open this page by clicking an individual plan in the plans overview. It consists of two areas: the plan details and the plan versions (its own tab/sub-page).
Who can see and edit this page
Viewing requires the "Plan management" read permission in your project role. Editing the title/tags/notes requires the "Edit plan details" write permission, uploading new versions requires "Create plan version", activating a version requires "Activate plan version", and deleting requires "Delete plan file". You can compare two versions with the "Plan management" read permission. Aligning a version requires the same permission as activating it ("Activate plan version"), and excluding zones from the comparison requires "Edit plan details". If you lack a permission, the respective action is disabled or hidden and additionally refused on the server.
Layout of the page
On larger screens you see a split view: on the left the detail sidebar with the tabs "Plan details" and "Plan versions", on the right a zoomable plan preview. On small screens (smartphone) you only see one of the two areas at a time.
Tab "Plan details"
Here you see the plan's title, a preview image of the active version, assigned tags and notes. The pencil icon in the top right opens the edit dialog with the following fields:
Title: required, must be unique within the project.
Tags: multi-select from the tags defined in your project.
Notes: multi-line free text field.
Effect on others: changes to title, tags or notes are distributed to all project members immediately. They see the new values without reloading, including in the plans overview and its tag filtering.
Plan preview
The preview shows the currently active plan version, zoomable, with all ticket markers pinned to it. This lets you see at a glance where tickets have already been created on the plan.
Tab/sub-page "Plan versions"
Here you manage this plan's version history: newest version first, each with a preview image, creation date and original file name.
Upload a new version directly: the upload button lets you upload a single PDF, image or IFC file as a new version of this plan.
Activate a version: Every non-active version shows an "activate" button; the currently active version instead carries an "Active" badge. If no ticket is pinned on the plan, the version becomes active immediately. The same applies if there is no active version yet or if one of the two versions is an IFC model, because there is nothing to convert. If at least one ticket is pinned on the plan (a single one is enough), the dialog "Update ticket location" opens first. In it you place blue and yellow markers at the same spots in the previous and in the new plan, and the positions of all tickets are recalculated onto the new version, so the markers remain in the correct place. With "Apply" you activate the version and save this recalculation. How the markers work is described in the section "Align a plan version".
Compare versions: With the "Compare" button above the tiles you lay two versions over each other, side by side, or as a difference. Details are in the section "Compare two versions".
Delete a version: with a confirmation prompt. The active version itself cannot be deleted. You need to activate a different version first. If you delete the version you're currently viewing, the view automatically jumps to the active version.
Download a version: downloads the original file of that specific version.
Effect on others: as soon as you activate a version, it becomes the new active version for every project member: everywhere in the app where this plan is shown. If the newest version of a plan is not the active one, the plan tile in the tile view of the plans overview shows a red warning icon at the bottom right. Clicking it opens the notice "The latest plan version is not activated" with the button "To the plan versions". The detail view has no such icon. Deleting a version only affects that one version and its file; the other versions and the plan itself remain untouched.
Compare two versions
The comparison shows you what has changed between two versions of a plan. You start it in the "Plan versions" tab.
Tap "Compare" above the tiles. The button only appears if the plan has at least two comparable versions.
Select two versions with the checkboxes at the top left of the tiles. If you select a third one, it replaces the oldest selection. The bar at the bottom shows which two versions are selected.
Tap "Compare" in the bar at the bottom. With "Cancel" you leave the selection without changing anything.
It is quicker with the active version: open a version that is not active from the list and tap the compare icon at the top right ("Compare to the active version"). The comparison then starts with this version and the active version.
The version with the lower number is always the reference and is called "Old" in the comparison, the other one is called "New", regardless of the order in which you selected them. Raster plans (PDF or image) and IFC models cannot be compared with each other; the app then reports "This version cannot be compared." Two IFC versions are compared in the BIM viewer, see the article BIM viewer. If you are offline, you need a connection for the comparison as long as one of the two versions is not available offline. A notice in the dialog points this out.
Effect on others: The comparison is a view only. It changes neither versions nor tickets and is not visible to other project members. Only aligning and excluding zones (see below) save anything.
The view modes
At the top of the comparison dialog you switch between the modes. On small screens (smartphone) "Side by side" is not available.
Overlay: Both versions lie on top of each other. With the "New version opacity" slider you fade smoothly between Old and New.
Swipe: A separator bar divides the area; on the left you see "Old", on the right "New". Drag the separator bar with your finger or the mouse, or move it with the arrow keys.
Side by side: Both versions appear next to each other in two views. With the link icon in the bar at the bottom you choose "Views linked" (zooming and panning affect both) or "Views separate" (you move each view on its own). With the icon "Fit only version X" on a view you fit only that view to the sheet.
Flash: The view switches automatically between Old and New, and the label shows which one you are currently seeing. If your system requests reduced motion, the switching stops and a notice explains why.
Difference: The app highlights the differences in colour, see the next section.
With the "View full plan" icon in the bar at the bottom you reset the view to the whole sheet in any mode. In all modes except Difference you can link or separate the two views.
Important: If the two versions are not aligned or are rotated differently, a notice appears. An offset in the overlay may then come from the position of the sheets and does not have to be a real change.
Show the difference
In the "Difference" mode the server calculates from both versions what has changed and colours it. The legend explains the colours:
New (green): This was added in the new version.
Removed (magenta): This no longer exists in the new version.
Unchanged: There is no difference here.
Not compared: These are the zones you have excluded from the comparison.
The evaluation states the number of change areas and the share of the compared area that has changed. Each area is listed with its number and type: "New", "Removed" or "Deleted and new". If you tap an area, the view jumps to it. If there are more areas than the app shows, it says "x of y areas displayed". On a very large sheet the app calculates more coarsely than usual and points this out. If it finds nothing, it says "No differences found".
The calculation takes a moment. As long as "The difference is being calculated." is shown, you can keep using the other modes; the result appears by itself. If it fails, tap "Try again". If excluded zones or the alignment change, the app recalculates the difference automatically. Offline you only see a difference that already exists for this version pair; otherwise the app reports that there is no calculated difference for this pair offline.
Effect on others: The difference for a version pair is calculated on the server and is then available to all project members. Because it depends on the excluded zones and the alignment, the result changes for everyone as soon as someone changes them.
Exclude areas from the comparison
Some areas change with every version, for example the title block with the date and index. You can exclude such zones from the comparison so that they do not fill the difference. This only works in the "Difference" mode and only with the "Edit plan details" permission.
Apply the suggestion: If you have not created a zone yet, the app asks whether the text field in the bottom right corner should be excluded from the comparison. With "Apply" you create the zone, with "Discard" you hide the suggestion.
Create a zone yourself: Under "Excluded from the comparison" tap "Draw zone". Then press and hold the first corner of the zone and afterwards press and hold the opposite corner. With "Cancel" you stop.
Change or delete a zone: Each zone is listed as "Zone 1", "Zone 2" and so on. With the pencil icon you change it, with the trash icon you delete it.
Effect on others: Excluded zones apply to all version pairs of this plan and to all project members. The difference is then recalculated; until then the notice that it is outdated may appear.
Align a plan version
When you align, you tell the app which spots are the same in two versions. From that it calculates how the new version lies relative to the other one (scale and offset). This makes the comparison congruent and the difference more reliable. Aligning is separate from activating: you can align a version without making it the active version.
You reach the dialog "Align plan versions" in the comparison. Either tap "Align" in the notice "These versions are not aligned", or tap the ruler icon in the bar at the bottom ("Align", or "Align again" for an already aligned version). Both require the "Activate plan version" permission. After closing it you return to the comparison.
On the left you see the plan "Previously", on the right the plan "New". Place the blue marker at the same spot in both plans and the yellow marker at a second shared spot.
Choose two points that are as far apart as possible. The scale is calculated from them. If the two markers of one version lie on top of each other, nothing can be measured; the app shows a warning and disables the button until you pull them apart.
Tap "Align" to save the measurement.
The markers start at the two tickets that are pinned on the plan and furthest apart. If there are none, for example because only one ticket is pinned, they start at the corners of the sheet.
Do not confuse this with "Calibrate plan" in the toolbar, which sets the scale of the plan (see the article "Plans: Measure, Draw, Calibrate, and Georeference").
Important: Only two versions of the same plan can be aligned, and no version against itself. IFC models have no sheet and cannot be aligned. The app cannot compensate for a rotation between the versions.
Effect on others: The active plan version remains unchanged. The measurement is saved for all project members on the aligned version and replaces an earlier alignment of this version. If tickets are pinned on the plan, they then appear in a different place on this version; the app points this out in the dialog.
Set markers automatically
Instead of placing the markers by hand, tap "Set markers automatically" in the alignment dialog. The app then searches both plans for matching spots and places the four markers itself. The result is only a suggestion: nothing is saved until you tap "Align".
Found: The markers are set. Check their position and adjust them where necessary.
Not found: The app finds no reliable match, for example because the versions are very different. The markers stay where they are and you place them by hand.
Rotated: If the two versions are rotated relative to each other, the app suggests nothing, because a rotation cannot be aligned.
Failed: The search failed. You can try again or align by hand.
During the search "Searching for matching points…" is shown and the button is disabled. You also find the button in the dialog "Update ticket location" when activating.
Activate a new version without aligning
Activating a version is separate from aligning. The version becomes active immediately, without an alignment being written, if no ticket is pinned on the plan, if there is no active version yet, or if one of the two versions is an IFC model. An existing alignment of the version stays untouched. If at least one ticket is pinned, the dialog "Update ticket location" opens when you activate, in which you confirm that the tickets sit in the right places on the new version.
Measure, draw, calibrate and georeference
There is a toolbar on the plan preview. How it works in detail is described in the article Plans: Measure, Draw, Calibrate, and Georeference. The essentials:
Location: The toolbar appears on the plan preview of this page. You set its position (top, left, right or bottom) and further options in the settings under "Plans & BIM".
Tools and operation: You find "Select", "Plan link", "Draw", "Shapes", "Text", "Symbol" and "Measure" (distance, polyline, area, angle). The "Measure" menu also contains "Calibrate plan" and "Georeference plan". Pick a tool, then click or tap in the plan; a hint names the next step. With "Calibrate plan" you set two points with a known distance and enter the actual distance so that the measured values are correct. "Georeference plan" is only possible after calibrating ("Calibrate first, then georeference"): you overlay the plan semi-transparently on the map and move and rotate it until it matches its footprint. In the "Style" menu you set colour, line width and opacity; "New markings private" makes new drawings visible only to you.
Permissions: Without the write permission "Create plan drawings" all tools except "Select" are disabled. "Calibrate plan" and "Georeference plan" additionally require "Activate plan version".
When you activate a plan version, the dialog "Scale found" may open if upmesh has recognised a scale in the text of the PDF. You accept or discard the suggestion; the plan only counts as calibrated after "Calibrate plan". Both require the "Activate plan version" permission.
Effect on others: An accepted scale and a calibration apply to all project members. Drawings and measurements are also visible to everyone, unless you created them as private.
