Docs/Sessions & files/Printing
DartRelay 2.1 documentation
Sessions & files

Printing

Printing lets people print from inside a published application or desktop. Each job is turned into a PDF and sent to their browser, where they can open it, save it or print it on whatever printer their own computer uses. This page explains how it works and how to switch it on.

How printing works

A published application runs on a host, so its Print command can only see printers that the host knows about. Sharing every user's own printer with the host means drivers, queues and support calls. DartRelay takes a simpler route:

  1. When printing is on for a resource, a single virtual printer appears inside the person's session. Its name is one you choose.
  2. The person prints to that printer from the application as usual.
  3. DartRelay turns the job into a PDF and sends it to the person's browser over the same connection as the session.
  4. A small panel appears in the session listing the finished job, with Open and Save buttons.
  5. From there the person can keep the PDF, or open it and print it on their own local printer.

Nothing is installed on the host, no physical printer is shared with it, and print output is not written to the host's disk.

Note

Printing is off for every resource until you switch it on, and resources that existed before you upgraded stay off. Turning it on for one resource does not affect any other.

Why the PDF does not open by itself

Browsers block a page from opening a new window unless the person has just clicked something. A print job arrives on its own, with no click behind it, so an automatic window would be blocked as a pop-up. The panel's Open and Save buttons supply that click. If someone prints several jobs, they queue in the panel one under another rather than replacing each other.

Switch printing on for a resource

Printing is set per desktop and per app group, on the same edit page as file transfer.

  1. Open the resource. In the console, go to Catalog → Desktops or Catalog → Remote Apps and open the desktop or app group for editing.
  2. Find the Printing card. It sits beside the File Transfer card.
  3. Switch printing on.
  4. Optionally set the printer name. This is the name people will pick in the application's print dialog. Leave it blank to use DartRelay Printer.
  5. Click Save. The printer appears in the next session opened for this resource. Sessions already open are not changed; the person needs to close the resource and open it again.

Printing card reference

FieldWhat it doesDefault
Enable printingAdds the virtual printer to sessions of this resource.Off
Printer nameThe name of the printer inside the session. Only letters, digits, spaces, hyphens and underscores are kept; any other character is removed when the session starts. If nothing usable is left, the name falls back to the default.DartRelay Printer

Example: an application that prints to a named printer

Some older line-of-business applications print to a printer by name, and fail if that exact printer is missing. Suppose an accounts package always prints to a printer called Accounts Printer.

  1. Open the app group that publishes the package and switch printing on.
  2. Set the printer name to Accounts Printer and save.

The application now finds the printer it expects, and every report arrives in the person's browser as a PDF. Remember the character rule: a name such as Accounts (Main)! would become Accounts Main, so choose a name made of letters, digits, spaces, hyphens and underscores if the application must match it exactly.

What people see

For the people using the portal, printing looks like this:

The end-user guide Files and printing in a session walks through this in plain language and is written to be sent to staff.

Tip

The print panel appears inside the session that printed. If someone prints from one tab and then switches to another before the job finishes, the panel waits in the first tab. Tell people to switch back to the tab they printed from if a job seems not to arrive.

Printing and file transfer together

Printing and file transfer are independent switches. You can turn on either, both or neither for each resource:

Printing needs no share, folder or account; it only needs the switch. See File transfer for the drive and file browser.

If something goes wrong

What you seeLikely cause and fix
The printer does not appear in the sessionPrinting is not switched on for that resource, or the session was opened before you saved. Check the Printing card, then close the resource in the portal and open it again.
The printer has a different name from the one typedCharacters other than letters, digits, spaces, hyphens and underscores were removed. Choose a name made only of those characters.
The job was sent but no panel appearedThe panel is in another tab: the one the job was printed from. Switch back to it. If it still does not appear, check the DartRelay log for that session.
Open does nothingThe browser blocked the new tab. Ask the person to allow pop-ups for the portal's address, or to use Save instead.
People ask to print straight to their office printerDartRelay does not share local printers with the host. Each job comes back as a PDF which they print from their own computer.
Still stuck? Email support@dartinnovations.com with what you were doing, what you expected and what you saw. A screenshot helps.