Esempio Stock

Data aggiornamento: 17 luglio 2006

L'esempio Stock è un'applicazione di Microsoft SQL Server 2005 Notification Services che utilizza sottoscrizioni guidate dagli eventi e sottoscrizioni pianificate per generare notifiche sulla base dei dati del mercato azionario. I sottoscrittori ricevono notifiche se il prezzo delle azioni supera il valore di trigger specificato.

Questo esempio illustra inoltre come ospitare il motore di Notification Services in un'applicazione personalizzata invece di utilizzare un servizio Microsoft Windows creato da Notification Services.

Scenario

Gli investitori sottoscrivono notifiche relative ai prezzi delle azioni. Ogni sottoscrizione include il simbolo dell'azione ed è guidata dagli eventi o pianificata.

Nel caso delle sottoscrizioni guidate dagli eventi, quando arriva un evento relativo alle azioni Notification Services genera una notifica se vengono soddisfatte tutte le condizioni seguenti:

• Il simbolo dell'azione nell'evento corrisponde a quello nella sottoscrizione.
• Il nuovo prezzo dell'azione è superiore al valore di trigger della sottoscrizione.
• Il prezzo più alto precedente dell'azione, incluso in una cronologia eventi delle azioni, è inferiore al valore di trigger della sottoscrizione. In questo modo il sottoscrittore non riceve più notifiche per la stessa azione.

Se il nuovo prezzo dell'azione è superiore al prezzo incluso nella cronologia, oppure se il simbolo dell'azione non è incluso nella cronologia, Notification Services aggiorna la cronologia.

Le notifiche per le sottoscrizioni guidate dagli eventi vengono recapitate una alla volta.

Nel caso delle sottoscrizioni pianificate, Notification Services fa corrispondere i dati della cronologia dei prezzi dell'azione con le sottoscrizioni pianificate. Si ottiene una corrispondenza quando il simbolo dell'azione nella sottoscrizione corrisponde a quello nella cronologia.

Per ogni corrispondenza Notification Services produce una notifica. Il server di distribuzione combina più notifiche per un sottoscrittore in una singola notifica che fornisce i dati relativi al portafoglio titoli del sottoscrittore.

Linguaggi

XML, XSD, XSLT e Microsoft Visual C# o Microsoft Visual Basic.

Funzionalità

Area di applicazione	Funzionalità
Classe di evento	Una classe di evento e una cronologia eventi.
Classe di sottoscrizione	Due classi di sottoscrizione, una per le sottoscrizioni guidate dagli eventi e una per le sottoscrizioni pianificate.
Classe di notifica	Due classi di notifica, una per le notifiche guidate dagli eventi e una per le notifiche pianificate. Per le notifiche pianificate viene utilizzato il recapito digest.
Provider di eventi	Un provider di eventi di monitoraggio del file system e un provider di eventi non hosted personalizzato.
Formattatori del contenuto	Formattatore del contenuto XSLT di Notification Services. Ogni classe di notifica specifica il file XSLT per il formattatore di contenuto.
Protocolli di recapito	Protocolli di recapito File e SMTP.
Motore di Notification Services	Ospitato in un'applicazione console.

Prerequisiti

Prima di eseguire questo esempio, verificare che siano installati i prodotti software seguenti:

• SQL Server 2005, con i componenti seguenti:
  • Motore di database.
  • Notification Services.
  • SQL Server Management Studio.
  • Gli esempi di Notification Services, inclusi in SQL Server 2005. È possibile scaricare la versione più recente degli esempi dal sito Web per gli sviluppatori di SQL Server.
  • .NET Framework SDK 2.0 o Microsoft Visual Studio 2005. .NET Framework SDK è disponibile gratuitamente. Vedere Installazione di .NET Framework SDK.

Generazione della soluzione

Se non è stato ancora creato un file di chiave con nome sicuro, generare il file di chiave seguendo le istruzioni seguenti.

Per generare un file di chiave con nome sicuro

1. Aprire il prompt dei comandi di Microsoft Visual Studio 2005. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.

   -- oppure --

   Aprire il prompt dei comandi di Microsoft .NET Framework. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK 2.0, quindi SDK Command Prompt.

2. Utilizzare il comando CD (change directory) per passare dalla directory corrente della finestra del prompt dei comandi alla cartella in cui sono stati installati gli esempi.

   [!NOTA] Per determinare la cartella in cui si trovano gli esempi, fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft SQL Server 2005, Documentazione ed esercitazioni, quindi Samples. Se è stato utilizzato il percorso di installazione predefinito, gli esempi si troveranno in <unità_sistema>:\Programmi\Microsoft SQL Server\100\Samples.

3. Al prompt dei comandi digitare il comando seguente per generare il file di chiave:

   sn -k SampleKey.snk

   Importante:
   Per ulteriori informazioni sulla coppia di chiavi con nome sicuro, vedere l'argomento relativo ai nomi sicuri e alla protezione in .NET Framework nel centro per sviluppatori di .NET su MSDN.

Generare la soluzione in modo da poter avviare l'istanza al termine della creazione.

Generazione della soluzione Visual Studio

• Se si utilizza .NET Framework SDK, eseguire le operazioni seguenti:

  1. Fare clic sul pulsante Start, scegliere Tutti i programmi, Microsoft .NET Framework SDK v2.0 e quindi SDK Command Prompt.
  2. Passare alla cartella principale dell'esempio Stock. Digitare il comando seguente per il percorso predefinito:
     cd C:\Programmi\Microsoft SQL Server\90\Samples\Notification Services\Stock
  3. Digitare la sintassi seguente per generare la soluzione:
     [C#] 
     msbuild Stock.sln
     [Visual Basic] 
     msbuild Stock_VB.sln

• In alternativa, se si utilizza Visual Studio 2005, eseguire le operazioni seguenti:

  1. Aprire il file della soluzione desiderato (Stock.sln o Stock_VB.sln).
  2. Generare la soluzione.

Distribuzione dell'istanza di Notification Services

Per distribuire l'istanza di Notification Services, eseguire le operazioni seguenti:

• Creare l'istanza di Notification Services.
• Registrare l'istanza di Notification Services.
• Concedere le autorizzazioni per SQL Server, database e cartelle.

Di seguito è illustrato come eseguire queste operazioni.

Passaggio 1: creazione dell'istanza di Notification Services

1. Aprire SQL Server Management Studio e connettersi a un'istanza di SQL Server.

2. In Esplora oggetti fare clic con il pulsante destro del mouse sulla cartella Notification Services e scegliere Nuova istanza di Notification Services.

3. Nella finestra di dialogo Nuova istanza di Notification Services fare clic su Sfoglia e selezionare il file InstanceConfig.xml nella cartella principale dell'esempio Stock.

4. In Parametri specificare i valori per i tre parametri:

   • SampleDirectory è il percorso della cartella principale dell'esempio Stock. Il percorso predefinito è C:\Programmi\Microsoft SQL Server\90\Samples\Notification Services\Stock.
   • NotificationServicesHost è il nome del server locale.
   • SQLServer è il nome dell'istanza di SQL Server.

5. Selezionare la casella di controllo Attiva istanza dopo la creazione.

6. Fare clic su OK.

7. Al termine della creazione dell'istanza, fare clic su Chiudi.

Passaggio 2: registrazione dell'istanza di Notification Services

1. In SQL Server Management Studio espandere il nodo Notification Services, fare clic con il pulsante destro del mouse su StockInstance, scegliere Attività e quindi Registra.

   Non selezionare alcuna opzione. Poiché il motore verrà ospitato in un'applicazione personalizzata, non è necessario creare il servizio Windows.

2. Fare clic su OK.

3. Al termine della registrazione dell'istanza, fare clic su Chiudi.

[!NOTA] Se si distribuisce un esempio di Notification Services utilizzando l'account del proprietario del database o di un amministratore del sistema, non sarà necessario concedere autorizzazioni per SQL Server a tale account. Se si concedono tali autorizzazioni verrà visualizzato un errore, che può essere ignorato. Quando si distribuiscono applicazioni personalizzate, per migliorare la protezione è consigliabile utilizzare account con privilegi inferiori.

Passaggio 3: concessione delle autorizzazioni per SQL Server, per Windows e per la cartella

1. In Esplora oggetti espandere il nodo Protezione.

2. Se è necessario creare un nuovo account di accesso al database, fare clic con il pulsante destro del mouse su Account di accesso, scegliere Nuovo account di accesso e creare l'account:

   • Per utilizzare l'autenticazione di Windows, selezionare Autenticazione di Windows e immettere lo stesso account di Windows specificato durante la registrazione dell'istanza.
   • Se è necessario utilizzare l'autenticazione di SQL Server, selezionare Autenticazione di SQL Server e quindi immettere lo stesso account di accesso e la stessa password di SQL Server specificati durante la registrazione dell'istanza.

3. Se l'account di accesso utilizzato per eseguire l'esempio dispone già dell'accesso a SQL Server, fare clic con il pulsante destro del mouse e scegliere Proprietà.

4. Nel riquadro sinistro della finestra di dialogo Proprietà account di accesso selezionare Mapping utenti.

5. Concedere le autorizzazioni per il database StockInstanceNSMain:

   1. In Utenti mappati all'account di accesso seguente selezionare StockInstanceNSMain.
   2. In Appartenenza a ruoli del database per: StockInstanceNSMain selezionare NSRunService.

6. Concedere le autorizzazioni per il database StockInstanceStock:

   1. In Utenti mappati all'account di accesso seguente selezionare StockInstanceStock.
   2. In Appartenenza a ruoli del database per: StockInstanceStock selezionare NSRunService.

7. Fare clic su OK per concedere le autorizzazioni per SQL Server.

8. Configurare la protezione per la cartella Events:

   1. In Esplora risorse passare alla cartella Events dell'esempio Stock.
   2. Fare clic con il pulsante destro del mouse sulla cartella Events, scegliere Condivisione e protezione e quindi selezionare la scheda Protezione.
   3. Fare clic su Aggiungi e aggiungere l'account utilizzato per eseguire l'esempio.
   4. In Utenti e gruppi selezionare l'account aggiunto.
   5. In Autorizzazioni per selezionare le autorizzazioni Lettura e Modifica.
   6. Fare clic su OK per rendere effettive le modifiche.

9. Configurare la protezione per la cartella Notifications:

   1. Passare alla cartella Notifications dell'esempio Stock.
   2. Fare clic con il pulsante destro del mouse sulla cartella Notifications, scegliere Condivisione e protezione e quindi selezionare la scheda Protezione.
   3. Fare clic su Aggiungi e aggiungere l'account utilizzato per eseguire l'esempio.
   4. In Utenti e gruppi selezionare l'account aggiunto.
   5. In Autorizzazioni per selezionare Scrittura.
   6. Fare clic su OK per rendere effettive le modifiche.

Esecuzione dell'esempio

Per eseguire l'esempio, procedere come segue:

• Avviare l'istanza.
• Aggiungere sottoscrittori e sottoscrizioni.
• Inoltrare gli eventi.

Dopo aver eseguito queste attività, Notification Services genera le notifiche. Di seguito è illustrato come eseguire queste operazioni e quindi visualizzare le notifiche risultanti.

Passaggio 1: avvio del motore hosted

1. Verificare che l'account con cui si esegue il motore hosted sia membro del gruppo di Windows SQLServer2005NotificationServicesUser$NomeComputer, che dispone di autorizzazioni per la lettura e l'esecuzione di file binari di Notification Services, o che l'account disponga di autorizzazioni per la lettura e l'esecuzione di file nella cartella C:\Programmi\Microsoft SQL Server\90\Notification Services.

2. In Esplora risorse passare alla cartella HostableExecutionEngine\linguaggio\HostableExecutionEngine\bin\Debug dell'esempio Stock.

3. Fare doppio clic su HostableExecutionEngine.exe per eseguire l'applicazione console che ospita il motore di Notification Services.

   Importante   Non premere INVIO. Affinché l'applicazione di Notification Services possa produrre notifiche, il motore deve essere in esecuzione.

Passaggio 2: aggiunta di sottoscrittori, sottoscrizioni ed eventi

1. Eseguire AddSubscribers.exe.

   Il file con estensione exe è incluso nella sottocartella AddSubscribers\linguaggio\AddSubscribers\bin\Debug della cartella dell'esempio Stock.

   Dopo aver aggiunto i sottoscrittori, premere INVIO per chiudere l'applicazione console.

2. Eseguire AddSubscriptions.exe.

   Il file con estensione exe è incluso nella sottocartella AddSubscriptions\linguaggio\AddSubscriptions\bin\Debug della cartella dell'esempio Stock.

   Dopo aver aggiunto le sottoscrizioni, premere INVIO per chiudere l'applicazione console.

3. Eseguire NonHostedEventProvider.exe.

   Il file con estensione exe è incluso nella sottocartella NonHostedEventProvider\linguaggio\NonHostedEventProvider\bin\Debug della cartella dell'esempio Stock.

   Verranno aggiunti eventi all'applicazione tramite un provider di eventi non hosted eseguito esternamente all'applicazione. Il passaggio seguente illustra come inviare eventi a un provider di eventi di monitoraggio del file system hosted.

[!NOTA] Per le applicazioni di produzione, o se si esegue l'applicazione con un account con limitazioni, aggiungere l'account di accesso di SQL Server dell'applicazione al ruolo del database NSSubscriberAdmin nei database dell'istanza e dell'applicazione.

Passaggio 3: inoltro degli eventi tramite la copia di un file di eventi

1. In Esplora risorse individuare la cartella principale dell'esempio Stock e copiare il file EventData.xml nella sottocartella Events.

   [!NOTA] Poiché in precedenza sono stati inviati eventi tramite un provider di eventi non hosted, questo passaggio è facoltativo. Se non si desidera inviare altri eventi e generare notifiche aggiuntive, considerare il passaggio successivo per la visualizzazione delle notifiche.

   Dopo la copia del file, il provider di eventi di monitoraggio del file system legge i dati contenuti nel file, li inoltra all'applicazione e quindi modifica l'estensione del file in done.

   Se durante la lettura o l'inoltro dei dati si verifica un errore, il provider di eventi modifica l'estensione del file in err. Per ulteriori informazioni sugli errori, vedere il registro applicazioni nel Visualizzatore eventi di Windows.

Passaggio 4: visualizzazione delle notifiche

1. Attendere circa un minuto affinché Notification Services produca le notifiche.

2. In Esplora risorse passare alla cartella Notifications dell'esempio Stock. La cartella contiene un file denominato FileNotifications.txt che include tutte le notifiche inviate dall'applicazione.

3. Passare alla cartella dove vengono spostati i messaggi di posta elettronica. Si tratta in genere di una delle cartelle in C:\Inetpub\mailroot. Le notifiche dovrebbero essere contenute nella cartella Pickup o nella cartella Queue, in base allo stato del server SMTP. Se il servizio SMTP è in esecuzione, i messaggi potrebbero essere spostati nella cartella Badmail.

[!NOTA] Se si desidera generare un'altra notifica senza rigenerare o modificare l'esempio, eseguire la query seguente: USE [StockInstanceStock] DELETE FROM [StockInstanceStock].[dbo].[StockEventsChron]

Interruzione del motore

Dopo aver inoltrato gli eventi e visualizzato le notifiche risultanti, interrompere il motore di Notification Services.

Per interrompere il motore

• Nella finestra della console HostableExecutionEngine premere INVIO per interrompere il motore.

Rimozione dell'esempio

Eseguire la procedura seguente per rimuovere l'esempio Stock.

Per rimuovere l'esempio Stock

1. In Esplora oggetti espandere Notification Services.

2. Fare clic con il pulsante destro del mouse su StockInstance, scegliere Attività e quindi Annulla registrazione.

3. Fare clic con il pulsante destro del mouse su StockInstance, scegliere Attività e quindi Elimina.

Vedere anche

Altre risorse

Hosting del motore di Notification Services
Esempi di SQL Server Notification Services
Protezione di Notification Services

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione	Cronologia
17 luglio 2006	Contenuto aggiunto: Aggiunta di informazioni sulla possibilità di inviare eventi tramite il provider di eventi non hosted e il provider di eventi di monitoraggio del file system nei passaggi 3 e 4 della sezione Esecuzione dell'esempio. Aggiunta di una nota sull'utilizzo del ruolo del database NSSubscriberAdmin.
14 aprile 2006	Contenuto aggiunto: Aggiunta di una nota sull'esecuzione degli esempi utilizzando le autorizzazioni del proprietario del database.
5 dicembre 2005	Contenuto modificato: Modifica delle istruzioni per la generazione di un file di chiave, inclusi il nome e il percorso del file di chiave. Aggiornamento della sezione relativa alle autorizzazioni per illustrare meglio quale account necessita di autorizzazioni.