A list containing the majority of Citrix Workspace app for iOS (formerly Receiver for iOS) support articles collated to make this page a one stop place for you to search for and find information regarding any issues you have with the product and its related dependencies.
The page is updated daily with new support articles and information. Articles will change from time and if information here is outdated or incorrect please let me know using the comments. Links may also expire or change so if you find broken links, please again let me know. For each issue, known product versions affected are recorded however that does not mean product versions that aren’t listed are not affected.
My iPad is running 12.4.1 at mo and whilst I can connect to my corporate citrix desktop using Safari WebVPN and then the Citrix Workspace app for some reason, if I use your Workaround and set up an account with it set to Web Interface, I am unable to launch my desktop. Put this information directly into Citrix Workspace and Epic should launch. Once Epic launches something that helps is to change your screen size based on your preference and iPad size. The way to do that is to click the overlying top arrow within the Citrix app. When you do this, a pull down menu appears, and you click on “display”. Citrix Workspace app is the easy-to-install client software that provides seamless, secure access to everything you need to get work done. With this free download, you easily and securely get instant access to all applications, desktops and data from any device, including smartphones, tablets, PCs and Macs.
There is a search box that you can use if looking for a specific fault. For example if you have an error code or error message, use that to perform a search. You can also use your browsers search feature which will perform a search against the whole page based on the words you enter.
Receiver for iOS / Workspace app for iOS:
Citrix Workspace App Ipad
|wdt_ID||Brief Description of Issue||Brief Description of Fix||Applicable Product Versions Affected (if known)||Link to supplemental Support Article(s)|
|1||When launching any application you receive error 'Server error.; The server disconnected the session..'.||This could be caused by firewall port blockage either internally or externally via NetScaler. It could also be down to STA servers either not configured on NetScaler or down.||https://support.citrix.com/article/CTX225834|
|2||As you type into an application such as Word or Notepad, the virtual keyboard appears on screen. Eventually after several lines of text some of that text will begin to dissapear underneath the keyboard.||Citrix are aware of this issue and a solution is under investigation.||https://support.citrix.com/article/CTX223986|
|3||The keyboard does not automatically display and users have to manually select it to open.||Check the 'Automatic keyboard display' policy within Citrix Studio is set to 'Allowed'.||https://support.citrix.com/article/CTX220263|
|4||When logging on to NetScaler Gateway through Receiver for iOS you receive error 'The Gateway has Epa Enabled, which is not supported on iOS devices'.||Disable PNAgent Legacy Mode on the relevant StoreFront store by unchecking 'Enable XenApp Services support'.||https://support.citrix.com/article/CTX218712|
|5||When your password has expired and you change it through NetScaler Gateway, you receive error 'Incorrect Credentials'.||Ignore the error message as the password has been changed. This is a known issue and current limitation in Receiver for iOS 6.1.1.||Receiver for iOS 6.1.1.||https://support.citrix.com/article/CTX202427|
|6||You receive the error message 'You have chosen not to trust ..., the issuer of the server's security certificate' when connecting to NetScaler Gateway.||Stricter certificate validation checks have been included in Receiver for iOS 7.2.2 and above versions. You must make sure that NetScaler provides the complete certificate chain to clients and that none of the certificates in that chain have expired.||Citrix Receiver for iOS 7.2.2.||https://support.citrix.com/article/CTX223949|
|7||When using Receiver for iOS 7.3 or earlier on iOS 11, when authenticating to NetScaler or StoreFront with a Smart Card you receive error “Your smart card does not have a valid certificate”. Users running iOS 9 and 10 do not experience the same.||There is no workaround as yet. Citrix recommend you do not upgrade yet to iOS 11 if you use Smart Cards for authentication.||iOS 11.||https://support.citrix.com/article/CTX227952|
|8||Smart Card users running Receiver for iOS 7.2.3 are unable to connect to VDA 7.13 applications and receive error “The operation couldn’t be completed (HdxSdkErrorDomain_Sessionerror 8)”.||Enable “Enhanced Desktop Experience” via Citrix policies.||https://support.citrix.com/article/CTX227966|
|9||Pinch and zoom does not work on iPad.||Disable the 'Citrix MultiTouch Redirection' service on the VDA.||https://support.citrix.com/article/CTX216604|
|10||When you have Citrix Policy 'HDX Adaptive Transport' set to 'Preferred' and are connecting through NetScaler Gateway, you may experience your session disconnecting or the session launch displaying an SSL error when you try to disconnect and reconnect a session.||This is a known issue. Either disable SmartControl and HDXInsight on NetScaler, set disable HDX Adaptive Transport or upgrade to NetScaler 12.x.||Citrix Receiver for iOS 7.5 and Citrix NetScaler 11.1.51.x, 52.x, 53.x, 54.x, 55.x, 56.x.||https://support.citrix.com/article/CTX231557|
Yes, I know what you’re thinking. You’ve been able to “use” Epic on your iPad for years now using the Citrix app. But you clearly have not been able to use Epic in a functional way. You could pull up patient charts, review labs and phone calls, but the process was cumbersome, complicated, and painful. You probably ride to use Epic’s own native apps, but those aren’t the most functional for charting. If you made any attempt to actually document using the Citrix app — good luck, that was near impossible.
My at home set up is a Mac desktop and an iPad. I don’t like carrying around a laptop. For years I dreamed of the ability to pull out my iPad to finish a patient chart or see how a patient was doing in a quick way. If I was at home, I’d have to go to my desktop. Not a big deal, but not the ideal workflow. I gave up on being able to do this on my iPad years ago. That all changed when Apple recently updated iPad OS and gave it trackpad support. Trackpad and mouse support is critical because clicking on screens in Epic via touch is nearly impossible. There are some additional caveats and tips you’ll need if you want to use your iPad to chart in Epic.
The most important caveat to all of this. You can only use this set up if your hospital IT team has given you the ability to remote access your electronic health record using Citrix, something most providers have access to.
What you need:
iPad: Any iPad that supports iPad OS 13.4 or later
Bluetooth mouse and keyboard: You can use a generic bluetooth mouse or trackpad, and bluetooth keyboard. I use Apple’s Magic Keyboard since it allows me to easily remove my iPad easily because of the magnets built in. It also has a great trackpad built right into the keyboard.
Citrix app: Citrix has several iPad apps, you need to make sure you get the right one. You need to use Citrix Workspace, the app with the blue icon. iPad app link
Steps and Tips on how to use this setup:
If your hospital makes you use two factor authentication, do not use safari. I have found that downloading the Citrix file using safari doesn’t work well at this time. Instead, when I use Chrome on my iPad I haven’t had any issues downloading the unique Citrix file through two factor authentication. Important note here, when the file gets downloaded on your iPad, you will need to click the “open in” button. If you don’t see Citrix Receiver showing up automatically, scroll the icons to the right until you see the “more” icon. When you click this, you should be able to add “Workspace”. The below pictures are examples:
If you don’t have two factor authentication, use the same credentials that you hospital IT team has given you for a remote setup on your computer at home. Put this information directly into Citrix Workspace and Epic should launch.
Once Epic launches something that helps is to change your screen size based on your preference and iPad size. The way to do that is to click the overlying top arrow within the Citrix app. When you do this, a pull down menu appears, and you click on “display”. Epic is now optimized for a 17 inch screen. If you want the same 17 inch experience you get at work or at home, you’ll need to go with auto-fit medium (1770 x 1230). Personally, that is too small for me. I opt for the 15 inch experience at 1400 x 900 (custom resolution option). The below pictures show how this looks.
Once you have optimized the screen size to your liking, login to Epic and you’re ready to go. You will find the trackpad / mouse option to be a game changer. I’m not going to show screenshots of my actual Epic hyperspace environment as Epic does not allow people to do that unsanctioned.
The below are some tips as well as limitations I’ve found in my experience with this setup.
* Instead of using the trackpad to scroll down, use the arrow keys, much faster
* Keyboard shortcuts like Control Z or Control B don’t work. You need to use the note editor options that Epic has built in
* You don’t have the ability to use the microphone of your iPad, which is puzzling to me. You can use your home microphone on your desktop or laptop Citrix Workspace but can’t on the iPad. This was the biggest limitation to me because I use Dragon dictation heavily when documenting, and I’m hoping in a future upgrade this is enabled.
Citrix Workspace App Ipados
It’s nice to be able to quickly spin up Epic at home with my iPad. For me I’m still missing the microphone support so I can use dragon dictation. However, for checking up on patients and completing a few charts I have found this setup to be useful. Don’t hesitate to reach out on twitter if you have any questions on this setup.