Configuring a Today widget on iOS

You can configure your mobile app for iOS to display a Today widget with a list of work objects. By default, the Today widget displays the current user's worklist. You can configure the Today widget to display data from a data page of your choice. The Today widget is available only for offline-enabled mobile apps. Your certificate set must include a widget provisioning file.

1. Open your certificate set to check whether it includes a widget provisioning file. If it does not, upload a widget provisioning profile.
   For more information about opening a certificate set, see Opening an existing iOS certificate set. For more information, about uploading a widget provisioning profile, see Uploading a widget provisioning profile.
2. Enable offline support for a case type.
   For more information, see Enabling offline support for case types.
3. Open the mobile channel interface.
   For more information, see Navigating to the mobile channel.
4. In the Offline access section, select Access groups have been configured to allow offline use of this mobile app.
5. In the Widgets section, select Enable iOS Today widget.
6. Select the default data page to display the current user's worklist or configure your own data page populate the widget with data:
   1. If you want to display the current user's worklist, in the Data page for iOS widget autocomplete field, enter D_pyDefaultTodayWidgetSource and proceed to step 7.
   2. If you want to create a new data page record, next to the Data page for iOS widget field, click the Open icon to create a new data page record.
   3. In the Label field, enter a brief description of the data type.
   4. Enter an identifier that starts with D_.
   5. In the Apply to field, enter Data-Mobile-TodayWidget-Entry and click Create and Open.
   6. Configure the data page, click Save, and close the form.
   7. In the Data page for iOS widget autocomplete field, enter the identifier of the new data page.
7. Click Save.