Especificar el nombre y los campos de un protocolo de entrega
Cada clase de notificación puede utilizar uno o varios protocolos de entrega para la entrega de notificaciones. En la definición de la aplicación, debe configurar cada protocolo de entrega admitido por una clase de notificación. Notification Services utiliza esta información para determinar qué protocolos de entrega son válidos para un conjunto de notificaciones. En este tema se explica cómo definir protocolos de entrega.
Definir un protocolo de entrega
Al definir un protocolo de entrega, debe proporcionar el nombre del protocolo. Si el protocolo de entrega requiere información adicional, también se definen los campos que proporcionan dicha información.
Además, Notification Services admite varias configuraciones de ejecución para los protocolos de entrega, lo que permite configurar el control de los reintentos de entrega, los errores y el tiempo de espera. Para obtener más información, vea Especificar configuraciones de ejecución de protocolo de entrega.
Para definir un protocolo de entrega
- Si está definiendo una aplicación mediante XML, defina los protocolos de entrega individuales en el Protocol Element (ADF).
- Si está definiendo una aplicación mediante programación, defina los protocolos de entrega individuales en los objetos NotificationClassProtocol y, a continuación, agréguelos a un objeto NotificationClassProtocolCollection de un objeto NotificationClass mediante la propiedad NotificationClassProtocols.
Nombre del protocolo de entrega
Cada protocolo de entrega tiene un nombre predefinido. Los nombres de los protocolos de entrega estándar son SMTP y File. Los nombres de los protocolos de entrega personalizados están documentados en la configuración de la instancia. El nombre que proporcione en la clase de notificación debe coincidir con el nombre dado al protocolo de entrega.
Para definir el nombre de un protocolo
- Si está definiendo una aplicación mediante XML, defina el nombre del protocolo en el Protocol Element (ADF).
- Si está definiendo una aplicación mediante programación, utilice la propiedad Name del objeto NotificationClassProtocol (NMO).
Campos de un protocolo
Algunos protocolos de entrega requieren datos de configuración. Por ejemplo, un mensaje enviado mediante SMTP debe proporcionar los datos Asunto, De y Para. Los nombres y los valores de los campos para los datos de configuración se definen al definir los protocolos de entrega de una clase de notificación.
- El nombre del campo es simplemente el nombre del campo de configuración. Por ejemplo, si el protocolo requiere un valor Asunto, el nombre del campo es Asunto.
- El valor del campo es el nombre de un campo de notificación que contiene el valor requerido o una expresión Transact-SQL que calcula el valor. Puede utilizar cualquier expresión Transact-SQL que se pueda evaluar como parte de una instrucción SELECT. Al igual que en todas las cadenas Transact-SQL, incluya una cadena entre comillas simples. Si la cadena es Unicode, agregue una N antes de las primeras comillas, por ejemplo N'myString'.
Por ejemplo, si debe proporcionar los campos Asunto, De y Para, puede definir los campos siguientes para el protocolo de entrega:
| Nombre del campo | Expresión Transact-SQL | Campo de notificación |
|---|---|---|
Asunto |
|
Titular |
De |
'someone@example.com' |
|
Para |
DeviceAddress |
|
El Asunto es el valor de un campo de notificación denominado Titular. El valor De es una expresión Transact-SQL que es una constante de cadena incluida entre comillas simples. El valor Para es una referencia a un campo integrado que contiene la dirección de correo electrónico del suscriptor.
[!NOTA] Si está definiendo una aplicación en un archivo XML, debe reemplazar los caracteres XML reservados, como '<', por sus referencias a entidades. Para obtener más información, vea XML Reserved Characters.
Cuando el distribuidor pasa los datos de las notificaciones al protocolo de entrega, incluye los valores de todos los campos del protocolo definidos.
Para definir los campos de un protocolo
- Si está definiendo una aplicación mediante XML, defina los campos individuales de encabezado del protocolo en el Field Element for Protocol/Fields (ADF).
- Si está definiendo una aplicación mediante programación, defina los campos de encabezado individuales en los objetos ProtocolField y, a continuación, agréguelos al objeto ProtocolFieldCollection de un objeto NotificationClassProtocol mediante la propiedad ProtocolFields.
Vea también
Conceptos
Distribución de notificaciones
Especificar configuraciones de ejecución de protocolo de entrega
Otros recursos
Configurar protocolos de entrega
Definir clases de notificación
Definir aplicaciones de Notification Services