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, or, for Tenant Administrators, add a Connection
  • Upload: upload files from your computer. You can also drag files onto the list
  • Edit File: open the selected file in Report Studio, in Draw for a drawing, or in NCalc101 for an NCalc file. Its tooltip says which
  • 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.

Adding a Connection

Tenant Administrators can add an Amazon S3, Azure Blob Storage, Git, SFTP or SharePoint Connection without leaving Files. Choose New, then New Connection, and follow the steps:

  1. Choose a Connection Type: pick the kind of storage to connect to
  2. Settings: fill in the type's settings. Help opens the type's help page beside them
  3. Name and Credentials: give the Connection a name, which is also the name of its folder, and fill in the URL and the sign-in details the type asks for. Read Only stops files in it being added, changed or deleted, and Git Connections are always read-only
  4. Test and Save: the Connection is tested as soon as the step opens. If the test fails, the result says why: go Back to fix it, or save it as it is

Once it is saved, the Connection's folder appears at the top of Files and opens. Its name cannot contain a forward slash, or be the name of a folder already at the top of Files.

Note: an SFTP private key is not entered here. To sign in with one, add it to the Connection on the Admin app's Connections page once it is saved.

Tip: closing the steps before you save adds nothing.

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

More information

Reconnection

Reconnection

Reconnection

timed out

timed out

Attempt of

Reload
An unhandled error has occurred. Reload 🗙