FieldReference Element (ADF)

Provides a reference to a notification field for use in the protocol header.

Syntax

<NotificationClasses>
    <NotificationClass>
        ...
        <Protocols>
            <Protocol>
                ...
                <Fields>
                    <Field>
                        ...
                        <FieldReference>

Element Characteristics

Characteristic Description

Data type

string, between 1 and 128 characters in length.

Default value

None.

Occurrence

Optional once per Field element.

Updates

Can be modified, but not added or deleted, when updating the application.

Element Relationships

Relationship Elements

Parent element

Field Element for Protocol/Fields (ADF)

Child elements

None.

Remarks

The FieldReference value can be any notification field or computed field defined for the notification class in the application definition file (ADF) or any of the following built-in fields: DeliveryChannelName, SubscriberId, DeviceName, DeviceTypeName, DeviceAddress, SubscriberLocale.

If the parent Field element does not include a FieldReference element it must use a SqlExpression element instead.

Example

The following example shows a how to specify that the protocol field uses the value from the built-in DeviceAddress field.

<FieldReference>DeviceAddress</FieldReference>

The following example shows a how to specify that the protocol field uses the value from the StockSymbol notification field.

<FieldReference>StockSymbol</FieldReference>

See Also

Reference

SqlExpression Element for Protocol/Fields/Field (ADF)
Application Definition File Reference

Other Resources

Specifying the Delivery Protocol Name and Fields
Updating Instances and Applications

Help and Information

Getting SQL Server 2005 Assistance