Files
Files is where your Tenant keeps the files its reports use: report templates, input data such as CSV files, images, forms, and the reports that Schedules produce. Schedules read from and write to Files, and Connections such as SharePoint appear here as folders too.
Files is an app of its own. To open it, choose Files in the app switcher (the grid of apps at the top of every page). Older links to Files inside ReportMagic still work and bring you here.
Who can use Files
To open Files you need Files Access in one of your roles; Tenant Administrators always have it. Inside Files you see the Tenant folders your roles grant, the Library, and your own My Files.
Finding your way around
Files works much like Windows File Explorer. The folder tree is on the left and the selected folder's contents are on the right, with an optional preview of the selected file beside them.
- Click a folder in the tree to open it
- Double-click a folder in the list to open it
- Double-click the .. row at the top of the list to go up a folder
A padlock beside a file or folder means you can open it but not change it.
The top-level folders
| Folder | What it holds |
|---|---|
| Your Tenant's folders | Files shared by everyone in your Tenant who can use Files |
| Library | Ready-made report templates to copy and adapt. Read-only |
| My Files | Your own files |
| User Files | Shown to Tenant Administrators only: each user's My Files, in a folder named after them |
| Connections | SharePoint, Git, SFTP, Azure Blob Storage and Amazon S3 Connections appear as folders of their own. Git Connections are read-only |
Opening files
Double-clicking a file does what suits its type.
| File | Double-clicking it |
|---|---|
| RMScript, text and HTML files | Opens it in Report Studio, to edit |
| Word documents, PDFs, images, Markdown, CSV and log files, and videos | Opens it in the viewer |
| NCalc files | Opens it in NCalc101 |
| Drawings | Opens it in Draw |
| Internet shortcuts (.url files) | Opens the link in a new browser tab |
| Anything else | Downloads it |
Right-click a file for the same choices, including opening it in a new tab.
Working with files and folders
The toolbar above the files has:
- New: create a file, a folder or a drawing in the open folder
- Upload: upload files from your computer. You can also drag files onto the list
- Edit File: open the selected file in Report Studio, or in NCalc101 for an NCalc file
- Open File: open the link in the selected .url file
- Download: download the selected files, or download them as a ZIP archive
- Delete: delete the selected files and folders
- Refresh and Preview: reload the folders and files, and show or hide the preview
In a narrow window, some buttons move into the More menu (the three dots).
Right-click a file or folder to rename, copy, cut, paste, download or delete it. Drag files and folders onto another folder to move them, or hold Ctrl while you drag to copy them. If the folder already has a file of the same name, you can overwrite it, keep both by renaming, or skip it.
Note: deleting a folder deletes everything in it, so you are asked first. A folder that a Schedule uses cannot be deleted.
Searching
Click Search files on the toolbar, or press Ctrl+Shift+F, to open the search above the files. Type at least two characters and press Enter.
- This Folder and Below or Everywhere: where to look
- Names or Names and Paths: find files and folders whose names contain the text, or also everything whose path contains it, such as everything inside a folder of that name
Results appear as each place finds them, up to 1,000 in all. Click Stop to stop searching and keep what has been found. Searches skip folders you are not allowed to open.
Click a result to show it in its folder, or double-click it to open it as you would in the list. Right-click a result to open it, show it in its folder, download it or copy its path. Use Filter Results to narrow the results to files or folders, to some types, or to those modified recently.
Esc hides the search without stopping it, and Search files on the toolbar then shows what you searched for and how many were found. Click it to bring the search back.
Tip: click the empty search box to see your recent searches and search again with a click.
Sources to Search
Your Tenant's folders, the Library and My Files are searched unless you turn them off. SharePoint, Git, SFTP, Azure Blob Storage and Amazon S3 Connections are slower to search, so they are off until you turn them on. The list says what to expect from each.
SFTP, Azure Blob Storage and Amazon S3 Connections are searched in every folder below the one searched, and each shows how many folders it has opened, or items it has checked, as it goes. A search of an SFTP Connection stops after 5,000 folders, and one of an Azure Blob Storage or Amazon S3 Connection after 100,000 items, and says so.
Search Settings
The gear in the search sets how it behaves. These settings are kept in this browser.
| Setting | What it does |
|---|---|
| Hide after opening a result | Folds the search away once a result's folder is open |
| Remember my sources | Starts with the sources you chose last time, rather than the defaults |
| Remember where and what | Starts with This Folder and Below or Everywhere, and Names or Names and Paths, as you left them |
| Remember the drawer's height | Opens the search at the height you last dragged it to |
| Remember recent searches | Lists your last 10 searches under the empty search box |
Files settings
The gear at the right of the toolbar holds the page's own settings, kept in this browser.
- Interface size: Standard, Relaxed or Large. Relaxed and Large make the toolbar, the search, the folders and the files larger
- Remember the preview: open Files with the preview shown or hidden, as you left it