B.2 DTD Description

31.2203GPPCharacteristics of the Contact Manager for 3GPP UICC applicationsRelease 17TS

This sub-clause describes the elements of the User Actions Document Type Definition as defined in B.1.

<Action>: This is the root element of the Groups Definition XML body. It shall always be present. The version described in the present document is 1.

<Label>: A text string, which contains the Label to be displayed to the user. This Label is displayed to the user as part of the actions that may be performed using the selected contact information.

<ActionCode>: Contains a text string representing an integer defining the mobile application to be launched when the user selects this action menu.

<Parameter>: Describes an input parameter passed to the application when the action is launched. The number of parameters depends on the mobile application to launch. The table below defines for each application the expected parameters and their corresponding names and values.

<Name>: Contains a text string, which represents the name of an input parameter. It allows the mobile application to recognize the parameter. If the Name field begins with the character "@", the corresponding value shall be input by the user. The string text following the "@" shall be used as a label to prompt the user.

<Value>: Contains a text string, which represents the value of a parameter. The parameter value can mix constant text and references to variables. The references to variables are placed between curly brackets ({}) and encoded as a vCard Property. The ME shall replace the variable references with the vCard Property value of the selected contact. If the vCard property value is a concatenation of several fields, the value inside the curly brackets could be suffixed with "-x", where x is the field number (e.g. {N-2} will refer to the second field of N property which is the given name; {ADR;HOME-3} will refer to the third field of ADR property, which is the street name).

<GroupUID>: Contains the unique identifier of a group, which is encoded as a text string representing an integer value. If this element is present in the action description, the corresponding action shall only be applied to the contacts that belong to this group (i.e. to the contacts with a vCard containing a X-3GPP-GroupUID that is set to the same integer value as the GroupUID).

Table 1: Action codes and parameters

Action Code	Mobile application to launch	Expected Parameter(s)
		Name(s)	Value(s)
1	Browser	"url"	url to browse
2	Application to send an SMS	"Phone number", "text"	Phone number and text to send.
3	Application to send an MMS	"Phone number", "subject", "text", "multimedia"	Phone number, subject, text to send, local url(s) of multimedia elements to attach to the MMS.
4	Instant messaging	"Phone number", "text", "multimedia"	Phone number, text to send, local url(s) of multimedia elements to attach to the Instant Message.
5	Application to send an email	"TO", "CC", "BCC", "subject", "text", "multimedia"	Email destination address, subject, text to send, local url(s) of multimedia elements to attach to the EMAIL

Annex C (normative):
Groups definition DTD