Docs/Sessions & files/Open and save on your own computer
DartRelay 2.5 documentation
Sessions & files

Open and save on your own computer

New in DartRelay 2.5. When a published program shows its Windows Open or Save As dialog, the browser takes over: people pick a file on their own computer, and what the program saves arrives in their browser's downloads. There is no drive to find, no folder to upload into first, and the program needs no changes. This page explains how it works, how to switch it on, and what people see.

A DartRelay first

Other browser-based remote app platforms make people upload a file to a server folder first, then find it again from inside the program. With Open and save in the browser, the program's own Open and Save As go straight to the person's own computer, the way a locally installed program would.

How it works

Every program that opens or saves a file through the standard Windows dialog can use it: Office, accounting and practice-management software, line-of-business programs, Notepad. Nothing is changed in the program.

One file: Open goes to the user's own file browser; Save As arrives in Downloads.
One file: Open goes to the user's own file browser; Save As arrives in Downloads.
Several files in, and a folder export out as one ZIP file.
Several files in, and a folder export out as one ZIP file.

The file travels inside the remote session itself, on a private channel that DartRelay opens only for resources with the setting on. No drive is mapped, no port is opened, and no code is injected into any program.

Note

Up to 200 MB per file. Several files work wherever the program's own dialog allows several files, or asks for a folder. For files a program writes by itself without any dialog, or programs with their own non-Windows file pickers, use the virtual drive and file browser. Both can be on for the same resource.

Before you begin

Switch it on for a desktop or app group

  1. Open the resource. Go to Catalog → Remote Apps or Catalog → Desktops and open the app group or desktop for editing.
  2. Find the Files card. It holds both ways files can move between people's computers and the session.
  3. Tick Open and save in the browser (marked recommended).
  4. App groups only: choose how several files download. When a program sends several files at once decides what happens when a program exports into a folder: Ask each time (ZIP or separate files), Always download one ZIP file or Always download separate files. The ZIP is made in the user's browser, so nothing extra is written on the host. A single file always downloads as itself.
  5. App groups only: decide about the server's files. Also let users open and save files on the server keeps the Use the server's files and Save on the server buttons. Untick it and the program's own dialog is cancelled rather than shown, so files only ever come from and go to the person's computer.
  6. Optionally keep the virtual drive. Virtual drive and file browser is a separate tick on the same card. With only browser file dialogs on, people see no extra drive and no folder button.
  7. Click Save. DartRelay installs the Files Agent on the resource's hosts if it is not there yet.

Files card reference

SettingWhat it doesDefault
Open and save in the browserThe program's Windows Open and Save As dialogs are handled by the browser, as described above.Off
When a program sends several files at once (app groups)Ask each time: the browser offers Download as ZIP or Download separately. Always one ZIP: one download, no prompt per file. Always separate files: each file downloads on its own.Ask each time
Also let users open and save files on the server (app groups)Keeps the buttons that bring back the program's own dialog. Off: the dialog is cancelled instead of shown.On
Virtual drive and file browserA drive in the session and the folder button in the portal. See File transfer.Off

The DartRelay Files Agent

Browser file dialogs need one small helper on each host that runs the resource: the DartRelay Files Agent. You do not install it by hand. DartRelay installs it, with the host's management account, when a desktop or app group on that host is saved with the setting on, and checks it again every time the host is saved. Every other DartRelay feature stays agentless, and hosts that never use browser file dialogs never get it.

Check or install it from the host page

  1. Open the host under Catalog → Hosts.
  2. Scroll to the DartRelay Files Agent card. It shows the version on the host, the version this DartRelay carries, and the result of the last attempt.
  3. Click Install now to install or update it straight away.

Install it manually

For a host DartRelay cannot reach with its management account, copy DartRelayFilesAgentSetup.exe from the web\HostAgent\ folder of your DartRelay installation to the host and run it as an administrator. The same file installs, upgrades and repairs.

DartRelayFilesAgentSetup.exe                 install or upgrade, with a result window
DartRelayFilesAgentSetup.exe /quiet          the same, no windows (exit code 0 = done)
DartRelayFilesAgentSetup.exe /remove         remove it

What people see

Nothing new to learn: people use their program exactly as before, and the browser asks at the moment the program needs a file.

In the programIn the browser
File → Open, Import, AttachA box “… is asking for a file” with a drop area, Choose file…, Use the server's files and Cancel. Progress is shown while the file is sent, then “Sent … to …”.
Attach files, Import (several files)A box “… is asking for a file” saying “Choose one or more files”, with Choose files…. Pick or drop several files; the program receives them all at once.
File → Save As, Export“Save … ?” with Save to my computer, Save on the server and Cancel. The file then arrives in the browser's downloads.
Export into a folder (folder picker or Browse For Folder)“… is asking for a folder” with Save to my computer, Use the server's folders and Cancel. Then, depending on the app group's setting, “… sent N files” with Download as ZIP and Download separately, or the downloads start straight away.
Save on a file opened from the computer“Save … to your computer?”, offering to send the updated file to the downloads, or Not now.

The end-user steps are in Files and printing in a session, which you can send to your staff. All of the wording is in the language packs, so it follows the portal's language.

Security and privacy

If something goes wrong

What you seeLikely cause and fix
The Windows dialog appears as usual, no browser boxThe setting is off for that resource, or the Files Agent is not on that host. Check the Files card, then the DartRelay Files Agent card on the host and click Install now. Sessions that were already open pick the agent up at their next sign-in.
The Windows dialog comes back after a few secondsThe browser did not answer within 6 seconds, for example because the tab was in the background or the connection dropped. The program's own dialog returns so the person is never stuck; they can pick the file there or cancel and try again.
“… is too large”The file is over the 200 MB limit. Use the virtual drive and file browser for larger files.
“… did not reach …”The program never confirmed the file. Close the dialog in the program and try again.
Install now reports a problemThe management account cannot reach the host, or lacks administrator rights. Use Connect on the host page to check it, or install the agent manually as above.
Anything elseThe agent writes a log per user on the host: %LOCALAPPDATA%\DartRelay\FileAgent\agent.log. Send it to support with the time it happened.
Still stuck? Email support@dartinnovations.com with what you were doing, what you expected and what you saw. A screenshot helps.