Product Documentation


Jul 26, 2016

WorxTasks lets users manage their Microsoft Outlook tasks on their mobile devices. WorxTasks syncs with Exchange Server so that tasks, flagged messages, and categories that users create in Outlook appear in WorxTasks. Users can also create tasks within the app itself.

For Android users, WorxTasks syncs with Exchange via WorxMail. For iOS users, WorxTasks syncs directly with Exchange. You can configure WorxTasks to be pushed to users' devices automatically when the devices enroll in Worx Home, or users can add the app from the Worx Store.

As part of the Worx suite of apps, WorxTasks benefits from single sign-on (SSO) compatibility with Worx Home. After users sign on to Worx Home, they can move seamlessly into WorxTasks without having to reenter their user names and passwords.

To begin, download WorxTasks and other XenMobile components from

System Requirements for WorxTasks

WorxTasks requires Microsoft Exchange Server versions 2007, 2010, or 2013, and is supported for any device that runs one of the following operating systems:

iOS: 8 – 1-

Note: WorxTasks is not supported on iPad.

Android: 4.4.x, 5.x, 6.x, and 7.

In Android, a valid WorxMail account, 10.0.7 or higher, is required. WorxTasks accesses flagged mail from the WorxMail database, so Citrix strongly recommends rolling out WorxTasks together with WorxMail to avoid potential conflicts. If users have an earlier version of WorxMail, they will follow in-app instructions for upgrading and resetting their accounts.

WorxTasks is not compatible with Lotus Notes.

Citrix has tested WorxTasks on the following devices. Not all supported devices are listed.

  • iPhone 5 – iPhone 6 Plus
  • Nexus
  • Samsung Note
  • Samsung Galaxy
  • Samsung Galaxy Tab
  • HTC One

Integrating and Delivering WorxTasks

To integrate and deliver WorxTasks with XenMobile, follow these general steps:

  1. You can integrate WorxTasks for iOS with an Exchange Server. (WorxTasks for Android uses the WorxMail for Android account to sync Exchange tasks.) The configuration uses Active Directory credentials to authenticate to Exchange. For details, see Integrating Exchange Server or IBM Notes Traveler Server.
  2. WorxTasks for iOS syncs directly with Exchange and consumes one Exchange Active Sync (EAS) device ID position on the server. Citrix recommends increasing the number of EAS partnerships to 20, so that users don't exceed the maximum number of devices allowed. If users exceed the maximum, WorxTasks does not sync. To increase EAS partnerships, update the EASMaxDevices property of the Exchange Server throttling policy. For details on managing EAS partnerships, see this blog post.

    Alternatively, users can delete devices they are not using. To do this, they must sign on to Outlook Web App and go to Options > Phone > Mobile Phones. From there, they can remove devices from the list, as shown in the following figure.

  3. Download and wrap WorxTasks. For details, see About the MDX Toolkit.
  4. Add WorxTasks to XenMobile and configure MDX policies, as described in the next section.

Adding WorxTasks to XenMobile

Add WorxTasks to XenMobile using the same steps as for other MDX apps. For details, see To add an MDX app to XenMobile. When adding WorxTasks, be aware of the following MDX policies that are specific to WorxTasks.

iOS-only WorxTasks policies:

  • WorxTasks Exchange Server. Fully qualified domain name (FQDN) for Exchange Server. Default value is empty.
  • WorxTasks user domain. Default Active Directory domain name for Exchange users. Default value is empty.

Important: Please be sure to update the WorxMail Allowed URLs policy to include +^ctxtasks:. WorxTasks for Android uses the WorxMail for Android account to sync Outlook tasks.

WorxTasks policies for Android and iOS:

  • Background network services. Comma-separated list of service addresses and ports that are permitted for background network access. Each service should be of the form fqdn:port. Default value is empty, implying background network services are not available.
  • Background services ticket expiration. Time period that a background network service ticket should remain valid. After expiration, an enterprise logon is required to renew the ticket. Default value is 168 hours (7 days).
  • Google analytics. If On, Citrix collects anonymous data to improve product quality. If Off, no data is collected. Default value is On.
  • Background network service gateway. Alternate gateway address to use for background network services in the form fqdn:port. Default value is empty, implying that there is no alternate gateway.
  • Accept all SSL certificates. If On, WorxTasks accepts all SSL certificates (valid or not) and allows access. If Off, WorxTasks blocks access when a certificate error occurs and displays a warning. Default value is Off.


WorxTasks Features

Users can populate their task list in several ways: by creating tasks in Outlook or within WorxTasks itself by tapping the + icon, or by flagging messages in Outlook or Worxmail.

Users can see their tasks in WorxTasks when they tap, respectively, the Tasks and Flagged Mail icons at the bottom of the screen. There are also icons for completed tasks and all tasks.

When the task list includes tasks, users can perform several functions:

  • Prioritize. They can label tasks as High, Normal, or Low priority.
  • Apply categories. They can create categories in the app or sync categories with Outlook to help organize their tasks. Uncategorized tasks go into No Categories.
  • Filter by category. Users can view and manage only the tasks within the categories they select.

  • Search and sort. Users can search the tasks on their task lists, and they can sort tasks by due date and priority.

  • Set due dates. Users can set a due date for each task. When sorted, tasks are sectioned into No Due date, Overdue, Today, This week, This Month, and Other.
  • Set repeating tasks. Users can set tasks to repeat every day, week, weekday, month, or year.
    Note: Although users will see a Custom setting for repeating tasks, that feature isn't available for this tech preview.
  • Reply to/forward flagged mail.This feature makes it convenient to reply to a flagged mail and then immediately complete the task.
  • View tasks offline. When users have no Internet connectivity, they can still view tasks on their devices. They can also create, edit, and delete tasks; the changes apply when connectivity is restored and WorxTasks is synced.
  • Set reminders. Notifications appear at the time the user sets.
  • Google analytics. You can integrate data-collection programs, such as Google Analytics, to send Citrix data to help improve Citrix products. All data collected is anonymous. You can opt out of data collection by setting the UsageAnalytics policy to Off.

Sync Behavior

By default, WorxMail syncs flagged mail only from the Inbox. If Android users want to see flagged messages from other folders, they need to turn on syncing for those folders in WorxMail. To do so, they select the folder to be synced and then tap the three dots in the upper right-hand corner to bring up Sync options. Then they tap Sync options, and select how often the flagged messages should sync.

The length of time that flagged mail and tasks are synced and stored on the device varies according to operating system:

  Flagged Mail Tasks
iOS One month Unlimited
Android WorxMail settings Unlimited

To change the sync window in Android, go to Sync options for the relevant folder, tap Days to sync and then select the sync window.