Impostazione del nome e dei campi del protocollo di recapito
Ogni classe di notifica può utilizzare uno o più protocolli di recapito per il recapito delle notifiche. Nella definizione dell'applicazione è necessario configurare tutti i protocolli di recapito supportati da una classe di notifica. Notification Services utilizza queste informazioni per determinare i protocolli di recapito validi per un insieme di notifiche. In questo argomento viene illustrato come definire i protocolli di recapito.
Definizione di un protocollo di recapito
Quando si definisce un protocollo di recapito, è necessario specificarne il nome. Se il protocollo di recapito richiede ulteriori informazioni, è inoltre necessario definire i campi che contengono tali informazioni.
Inoltre, Notification Services supporta numerose impostazioni di esecuzione per i protocolli di recapito, che consentono di configurare la ripetizione dei tentativi e la gestione degli errori e dei timeout per il recapito. Per ulteriori informazioni, vedere Specificazione delle impostazioni di esecuzione del protocollo di recapito.
Per definire un protocollo di recapito
- Se si desidera definire un'applicazione tramite XML, definire i singoli protocolli di recapito in Protocol Element (ADF).
- Se l'applicazione viene definita a livello di programmazione, è necessario definire i singoli protocolli di recapito in oggetti NotificationClassProtocol e aggiungerli a un oggetto NotificationClassProtocolCollection in un oggetto NotificationClass tramite la proprietà NotificationClassProtocols.
Nome del protocollo di recapito
Ogni protocollo di recapito ha un nome predefinito. I nomi dei protocolli di recapito standard sono SMTP e File. I nomi dei protocolli di recapito personalizzati sono documentati nella configurazione dell'istanza. Il nome specificato nella classe di notifica deve corrispondere a quello del protocollo di recapito.
Per definire il nome del protocollo
- Se si desidera definire un'applicazione tramite XML, definire il nome del protocollo in ProtocolName Element (ADF).
- Se l'applicazione viene definita a livello di programmazione, utilizzare la proprietà Name dell'oggetto NotificationClassProtocol (NMO).
Campi di un protocollo
Alcuni protocolli di recapito richiedono dati di configurazione. Ad esempio, un messaggio inviato tramite SMTP deve includere le informazioni dei campi Oggetto, Da e A. I nomi e i valori dei campi per i dati di configurazione vengono definiti durante la definizione dei protocolli di recapito per una classe di notifica.
- Il nome del campo corrisponde semplicemente al nome del campo di configurazione. Se ad esempio il protocollo richiede un valore per l'oggetto del messaggio, il nome del campo sarà Oggetto.
- Il valore del campo è il nome di un campo di una notifica che contiene il valore richiesto o un'espressione Transact-SQL che lo calcola. È possibile utilizzare qualsiasi espressione Transact-SQL che può essere valutata come parte di un'istruzione SELECT. Come in tutte le stringhe Transact-SQL, è necessario racchiudere la stringa tra virgolette singole. Se la stringa è Unicode, aggiungere una N prima della virgoletta di apertura, ad esempio N'miaStringa'.
Se, ad esempio, sono necessari i campi Oggetto, Da e A, è possibile definire i campi seguenti per il protocollo di recapito:
| Nome campo | Espressione Transact-SQL | Campo notifica |
|---|---|---|
Oggetto |
|
Titolo |
Da |
'prova@example.com' |
|
A |
DeviceAddress |
|
Il campo Oggetto corrisponde al valore di un campo della notifica denominato Titolo. Il valore del campo Da è un'espressione Transact-SQL corrispondente a una costante stringa racchiusa tra virgolette singole. Il valore del campo A è un riferimento a un campo predefinito contenente l'indirizzo di posta elettronica del sottoscrittore.
[!NOTA] Se si desidera definire un'applicazione in un file XML, è necessario sostituire i caratteri XML riservati, ad esempio '<', con i rispettivi riferimenti a entità. Per ulteriori informazioni, vedere XML Reserved Characters.
Quando il server di distribuzione passa i dati delle notifiche al protocollo di recapito, include i valori di tutti i campi del protocollo definiti.
Per definire i campi del protocollo
- Se si desidera definire un'applicazione tramite XML, definire i singoli campi di intestazione del protocollo in Field Element for Protocol/Fields (ADF).
- Se l'applicazione viene definita a livello di programmazione, è necessario definire i singoli campi di intestazione del protocollo in oggetti ProtocolField e aggiungerli all'oggetto ProtocolFieldCollection in un oggetto NotificationClassProtocol tramite la proprietà ProtocolFields.
Vedere anche
Concetti
Distribuzione delle notifiche
Specificazione delle impostazioni di esecuzione del protocollo di recapito
Altre risorse
Configurazione dei protocolli di recapito
Definizione delle classi di notifica
Definizione di applicazioni di Notification Services