Note:
For most of the flags, it's not really clear to me
what exactly they do. I have endeavoured to find a suitable translation, but I am not sure that I have succeeded
everywhere. If in doubt, please use the linked original reference.
The ActionType specifies which action is triggered with the Intent:
The intents for the OnClick event can be differentiated using the ID property. If you want to use the OnClick event for a notification with action buttons, a different UrsIntent instance, which at least differs in ID, must be applied to the actual notification and to each action button. The ID of the associated UrsIntent instance is published by the OnClick event.
The other fields are only evaluated for ActionType Screen or Launcher. The column S marks fields that are relevant for the ActionType Screen, the column L those for the ActionType Launcher.
For the flags, see also: About the BackStack (Activity Stack)
Name | Type | S | L | Functionality | Default |
---|---|---|---|---|---|
ActionType | choice (Designer only) |
X | X | Specifies the type of action. Possible values are None, Screen, Launcher, Event or GoBack. Different fields are evaluated depending on the ActionType. | None |
ActivityAction | text | - | X | Specifies the action that will be used to start the Activity. | -none- |
ActivityClass | text | - | X | Specifies the class part of the specific component that will be started. ActivityPackage and ActivityClass define the Activity to be started when the notification is tapped. |
-none- |
ActivityPackage | text | - | X | Specifies the class part of the specific component that will be started. ActivityPackage and ActivityClass define the Activity to be started when the notification is tapped. |
-none- |
DataType | text | - | X | Specifies the MIME type to pass to the Activity. | -none- |
DataUri | text | - | X | Specifies the data URI that will be used to start the activity. | -none- |
Extras | List of Pairs | - | X | Adds extended data to the intent (see below). | -none- |
FlagClearTask | boolean | X | X | This flag will cause any existing task that would be associated with the activity to be cleared before the activity is started. | false |
FlagClearTop | boolean | X | X | If set, and the Activity being launched is already running in the current Task, then instead of launching a new instance of that Activity, all of the other activities on top of it will be closed and this Intent will be delivered to the (now on top) old Activity as a new Intent. | false |
FlagExcludeFromRecent | boolean | X | X | If set, the new Activity is not kept in the list of recently launched activities. | false |
FlagNewTask | boolean | X | X | If set, this Activity will become the start of a new Task on this history stack. | false |
FlagNoAnimation | boolean | X | X | This flag will prevent the system from applying an Activity transition animation to go to the next activity state. | false |
FlagNoHistory | boolean | X | X | If set, the new Activity is not kept in the history stack. As soon as the user navigates away from it, the activity is finished. | false |
FlagPreviousIsTop | boolean | X | X | If set and this Intent is being used to launch a new Activity from an existing one, the current Activity will not be counted as the top Activity for deciding whether the new Intent should be delivered to the top instead of starting a new one. The previous Activity will be used as the top, with the assumption being that the current Activity will finish itself immediately | false |
FlagReorderToFront | boolean | X | X | This flag will cause the launched Activity to be brought to the front of its task's history stack if it is already running. | false |
FlagResetTaskIfNeeded | boolean | X | X | If set, and this Activity is either being started in a new Task or bringing to the top an existing Task, then it will be launched as the front door of the Task. This will result in the application of any affinities needed to have that Task in the proper state (either moving activities to or from it), or simply resetting that task to its initial state if needed. | false |
FlagSingleTop | boolean | X | X | If set, the Activity will not be launched if it is already running at the top of the history stack. | false |
FlagTaskOnHome | boolean | X | X | This flag will cause a newly launching task to be placed on top of the current home activity task (if there is one). That is, pressing back from the task will always return the user to home even if that was not the last activity they saw. This can only be used in conjunction with FLAG_ACTIVITY_NEW_TASK. | false |
ID | text | X | X | Unique ID of this Intent. | -none- |
ScreenStartValue | text | X | - | The start value to be transferred to the Screen to be opened. Available via Control.getStartValue . | -none- |
ScreenToOpen | text | X | - | The name of the Screen to open when you tap the notification. | "Screen1" |
The Extra values are a list of pairs. The first value is the key for the pair (e.g. ‘Extra1’) and the second value is the associated value (e.g. ‘Value1’).