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:
- When printing is on for a resource, a single virtual printer appears inside the person's session. Its name is one you choose.
- The person prints to that printer from the application as usual.
- DartRelay turns the job into a PDF and sends it to the person's browser over the same connection as the session.
- A small panel appears in the session listing the finished job, with Open and Save buttons.
- 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.
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.
- Open the resource. In the console, go to Catalog → Desktops or Catalog → Remote Apps and open the desktop or app group for editing.
- Find the Printing card. It sits beside the File Transfer card.
- Switch printing on.
- 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. - 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
| Field | What it does | Default |
|---|---|---|
| Enable printing | Adds the virtual printer to sessions of this resource. | Off |
| Printer name | The 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.
- Open the app group that publishes the package and switch printing on.
- Set the printer name to
Accounts Printerand 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 printer you named appears in the application's print dialog. On a full desktop it also appears in the Windows printer list.
- After they print, a panel appears in the session with the finished job and Open and Save buttons.
- Open shows the PDF in a browser tab; Save downloads it. To get paper, they open the PDF and print it from their own computer.
The end-user guide Files and printing in a session walks through this in plain language and is written to be sent to staff.
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 only suits people who need paper copies or PDFs of reports but should not move files in and out.
- File transfer only suits people who exchange documents but never print.
- Both is common for office applications.
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 see | Likely cause and fix |
|---|---|
| The printer does not appear in the session | Printing 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 typed | Characters 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 appeared | The 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 nothing | The 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 printer | DartRelay does not share local printers with the host. Each job comes back as a PDF which they print from their own computer. |
Related pages
File transfer
A drive in the session and a file browser in the portal.
Files and printing in a session
The end-user guide you can send to staff.
Publishing applications
Create the app groups that printing is switched on for.
Host session options
Other settings that shape what a session can do.
