File page

The file page shows one document: a preview of the file, the twins it's linked to, the twins it mentions, and its details. In a PDF, you can pick a twin and the preview goes to it and highlights it on the page. Use it to find where a unit, room or system appears in a drawing, schedule or manual, without reading the whole file.

File page for a mechanical schedule, with the Twins panel open and air handling unit AC-3-1 highlighted in the schedule

 

Opening a file

  • From Files. Search for the file and select its name.
  • From a twin page. Open the twin's Files tab. Files under References open at the first page that mentions the twin, with the twin highlighted. See Open a file from a twin.
  • From Copilot or a briefing. Select a document link in the answer or the briefing.

Select Files at the top of the page to go back to your search, with your search terms and filters kept.

 

The page at a glance

  • Header. The file name, its category (such as Drawing or Product Data) and Download File.
  • Tabs. Preview, Links, References and Information.
  • Summary panel. The file's name, category, kind, size, who uploaded it and when, the number of twins it references, and a summary written by Willow AI. Close it with >|. Open it again with the button in the header.

The summary panel is hidden on the Information tab, which shows the same details in full, and when the window is narrow.

 

How twins are connected to a file

A twin can be connected to a file in two ways.

What it means Where you see it
Linked The file is attached to the twin, such as an operations and maintenance manual for an air handling unit. Links tab, relationship Is document of
Referenced The twin is mentioned in the file, such as a unit tag in a schedule or a room on a floor plan. Willow records the page, and where possible the position on the page. References tab, the Twins panel in the preview, and the Links tab, relationship References

Only referenced twins can be highlighted, because only they have a position in the file.

Files are added and linked to twins outside the Willow App, by Willow or your administrator.

Twin references come from Willow onboarding. Willow reads PDF drawings, schedules and manuals, and matches the names and tags it finds to twins in your portfolio. A reference appears once Willow has checked the match, so a new file can take a while to show its twins. Not every mention is matched. See If a twin isn't in the Twins panel.

 

Highlight a twin in a file

  1. Open a PDF. The page opens on the Preview tab.
  2. Select Show Twins, the twin icon at the top right of the preview. The Twins panel opens. It lists every twin reference in the file, grouped by page.
  3. Select a twin. The preview goes to its page, zooms in and highlights it.
  4. To clear the highlight, select the twin again.

The highlight is a box over the twin's name or tag: a row or cell in a schedule, or the label beside the equipment on a drawing.

Floor plan with the Twins panel open and VAV-10-11 highlighted on the drawing

One twin is highlighted at a time. The highlight stays when you close the panel, so you can read round it.

For some references, Willow knows the page but not the position on it. The preview goes to the page but can't mark the spot.

Preview in a list of files, such as search results or a twin's Files tab, opens a quick preview without Show Twins. Select the file name to open the file page instead.

The page address updates as you select a twin. Copy it to share the file with that twin highlighted.

 

Find a twin in the Twins panel

  • Search Twins. Type part of the twin's name.
  • Match current page only. Show only the twins on the page you're looking at.
  • < and >. Step to the previous or next reference. At the end of the list it starts again from the top.

The count at the top, such as 160 Twin references, counts every place a twin appears. A twin that's mentioned twice counts twice. Twin References in the summary panel counts twins, so it's usually lower.

Press Esc to close the panel.

 

If a twin isn't in the Twins panel

  • Check the search. Search Twins looks at twin names, not the tag printed in the file. Check Match current page only isn't ticked.
  • Check the Links tab. If the file is attached to the twin, the twin is on the Links tab but can't be highlighted.
  • Check the file type. Twins can only be highlighted in PDFs.
  • Willow may not have matched it yet. Some names and tags aren't matched, for example when the tag in the file is written differently from the twin's name. Others appear only once Willow has checked the match. To report it, select your initials at the top right, then Contact Us. Give the file name and the twin.

 

Open a twin from a file

From the References tab. It lists every twin the file mentions, with its category, how many times it's mentioned and the pages it's on.

  • Select a page link, such as Page 1, to open the preview at that page with the twin highlighted. Up to five pages are listed per twin.
  • Select More options (⋮) at the end of the row, then Go To Twin, to open the twin's page.
  • Use Search and Category to narrow the list. Select a column heading to sort.

References tab listing the twins mentioned in the file, with their category, number of references and page links

From the Links tab. It lists every twin connected to the file. Select Go to Twin on a row to open it. Use Relationship Type to show only attached twins (Is document of) or only mentioned twins (References).

Links tab listing the twins connected to the file, each with Go to Twin

 

Open a file from a twin

  1. Open the twin's page and select the Files tab.
  2. Files attached to the twin are listed first. Files that mention the twin are under References, with a line such as AC-3-1 appears on 1 page.
  3. Select a file under References. It opens at the first page that mentions the twin, with the twin selected in the Twins panel and highlighted.

Files tab on a twin page, with two attached files and a References section showing the schedule that mentions the twin

 

Use the preview

Previews work for PDF, JPG, PNG and TXT files. For other files, the page shows No preview available and a Download button. Twin highlighting works in PDFs only.

PDF controls, from left to right:

Control What it does
Show thumbnails Shows page thumbnails down the left. Select one to go to that page.
Page settings (gear) Continuous scroll, Single page or Two pages. Rotate clockwise or Rotate counter-clockwise. Full screen.
Zoom level Choose a zoom, or Fit page or Fit width. Use - and + to zoom out and in.
Toggle pan mode (hand) Drag to move round the page. Select it again to select text.
Page number Type a page number, or use < and > to move a page at a time.
Show search (magnifier) Search the text of the file. Options: Case sensitive and Whole word. Results are grouped by page.
Show Twins (twin icon) Opens the Twins panel. See Highlight a twin in a file.

Keyboard shortcuts (use Cmd on a Mac):

  • Ctrl + and Ctrl - zoom in and out.
  • Ctrl 0 resets the zoom.
  • Ctrl F opens search.

 

Read a file's details

The Information tab shows everything Willow knows about the file:

  • Its name, category, kind, size, who uploaded it and when, and its summary.
  • Custom tags.
  • Details Willow AI read from the file, such as the document type, manufacturer, models, equipment type, discipline, location and dates, and whether Copilot can use the file.

 

Download a file

Select Download File in the header or the summary panel. The file opens in a new browser tab. If you don't see Download File, you don't have permission to download files. Ask your administrator.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.