Newsletter サンプル
更新 : 2006 年 7 月 17 日
Newsletter サンプルでは、簡単な Web ベースのサブスクリプション管理アプリケーションの作成方法を示します。このサンプルは、HTML ベースのインターフェイス層とサブスクリプション管理中間層を含む、n 層デザインを持ちます。Microsoft Visual Studio Web プロジェクトでは、Web プロジェクトの実行時に Visual Web Developer Web Server が作成されるため、より簡単にサンプルを使用することができます。このサンプルは IA64 ではサポートされていません。
シナリオ
Adventure Works Cycles は、顧客指向のニュースレターをパブリッシュし、プロモーション イベントを提供します。このアプリケーションを使用して、顧客はニュースレターとプロモーション イベントに関する通知の受け取りをサブスクライブすることができます。
顧客は Web ページを使用して任意の種類の情報 (ニュースレターまたはプロモーション) のサブスクリプションを作成し、いつ配信されるか (イベント ドリブンまたは定期的) を選択します。
Adventure Works Cycles では、ニュースレター データおよびプロモーション イベント データを含んでいるファイルは監視対象フォルダにドロップされます。ジェネレータが実行されると、イベント記録ルールが実行されて定期的なサブスクリプションに使用される記録が更新され、未処理のイベント バッチに対してイベント ドリブン ルールが実行されます。次に、処理される予定のすべての定期的なサブスクリプションに対して、定期的なサブスクリプション ルールが実行されます。定期的なサブスクリプション ルールが実行されると、各サブスクリプションの最終通知生成がいつ行われたかの追跡に使用されるサブスクリプション記録が更新されます。この情報は、通知が重複しないことを確認するために使用されます。
通知は以下の条件を満たすときに生成されます。
- イベントのドキュメントの種類 (ニュースレターまたはプロモーション) が、サブスクリプションのドキュメントの種類と一致する。
- ニュースレターまたはイベントのカテゴリが、サブスクリプションのカテゴリと一致する。
- サブスクリプションが定期的なサブスクリプションである場合、前回のジェネレータ ルール実行と現在のジェネレータ ルール実行までの間にスケジュールされている。
- サブスクリプションが定期的なサブスクリプションである場合、イベントがデータベースにコミットされた時間が、サブスクリプションが前回通知を生成した時間よりも長い。
生成された通知は XSLT コンテンツ フォーマッタを使用してフォーマットされ、それから File 配信プロトコルを使用して送信されます。
言語
XML、XSD、XSLT、および Microsoft Visual C# または Microsoft Visual Basic。
機能
Newsletter サンプルは、Microsoft SQL Server Notification Services の次の機能を使用します。
| アプリケーション エリア | 機能 |
|---|---|
イベント クラス |
基本イベント クラス (イベント ドリブン サブスクリプションの場合) およびイベント記録 (定期的なサブスクリプションの場合) |
サブスクリプション クラス |
イベント ドリブン サブスクリプションおよび定期的なサブスクリプション |
通知クラス |
ダイジェスト配信 |
イベント プロバイダ |
ファイル システム監視イベント プロバイダ |
コンテンツ フォーマッタ |
XSLT コンテンツ フォーマッタ |
配信プロトコル |
ファイルおよび SMTP 配信プロトコル |
サブスクリプション管理アプリケーション |
Visual Web Developer Web Server を使用する Microsoft ASP.NET |
前提条件
このサンプルを実行する前に、次のソフトウェアがインストールされていることを確認してください。
- Microsoft SQL Server 2005 (次のコンポーネントを含む)
- データベース エンジン。
- Notification Services。
- SQL Server Management Studio。
- Notification Services サンプル。これらのサンプルは SQL Server 2005 に含まれています。これらの最新バージョンは、SQL Server デベロッパー Web サイトからダウンロードできます。
- Visual Web Designer を含む Microsoft Visual Studio 2005
サンプルのビルド
サンプルをビルドするには、次の手順を行う必要があります。
- Notification Services のインスタンスの作成
- Notification Services のインスタンスの登録
- SQL Server およびデータベースの権限の許可
Newsletter サンプルのこれらのタスクを行う方法は、次の手順のとおりです。
手順 1: Notification Services のインスタンスの作成
SQL Server Management Studio を起動して、SQL Server のインスタンスに接続します。
オブジェクト エクスプローラで Notification Services フォルダを右クリックして、[新しい Notification Services インスタンス] をクリックします。
[新しい Notification Services インスタンス] ダイアログ ボックスで [参照] をクリックして、Newsletter サンプルのルート フォルダで InstanceConfig.xml ファイルをクリックします。
[パラメータ] ボックスで、次の 3 つのパラメータの値を入力します。
- SampleDirectory は Newsletter サンプルのルート フォルダのパスです。既定の場所は C:\Program Files\Microsoft SQL Server\90\Samples\Notification Services\Newsletter です。
- NotificationServicesHost はローカル サーバー名です。
- SQLServer は SQL Server インスタンスの名前です。
[インスタンスの作成後にインスタンスを有効にする] チェック ボックスをオンにします。
[OK] をクリックします。
Notification Services がインスタンスの作成を完了したら、[閉じる] をクリックします。
手順 2: Notification Services のインスタンスの登録
SQL Server Management Studio で Notification Services ノードを開いて [NewsletterInstance] を右クリックし、[タスク] をポイントして [登録] をクリックします。
[登録] ダイアログ ボックスで、[Windows サービスを作成する] チェック ボックスをオンにします。Windows サービスによって、このコンピュータで Notification Services のインスタンスが実行されます。
[サービス ログオン] の下で、Windows アカウントとパスワードを入力します。これは、サービスを実行する Windows アカウントです。Windows 認証を使用して SQL Server へアクセスしている場合、Windows サービスはこのアカウントも使用して SQL Server に接続します。
SQL Server 認証を使用して SQL Server へアクセスする必要がある場合、[認証] の下の [SQL Server 認証] をクリックしてから SQL Server のログイン名とパスワードを入力します。
Windows 認証を使用することを推奨します。
[OK] をクリックします。
Notification Services がインスタンスの登録を完了したら、[閉じる] をクリックします。
.gif "ms160957.note(ja-jp,SQL.90).gif") メモ : |
|---|
| データベース所有者またはシステム管理者のアカウントを使用して Notification Services サンプルを配置する場合、そのアカウントに SQL Server の各権限を許可する必要はありません。これらの権限を許可するとエラーが発生する可能性があります (そのエラーは無視できます)。独自のアプリケーションを配置するときは、セキュリティを向上させるため、できる限り低い権限を持つアカウントを使用する必要があります。 |
手順 3: SQL Server、データベース、およびフォルダ権限の許可
オブジェクト エクスプローラで、[セキュリティ] ノードを展開します。
Windows サービスに新しいデータベース ログイン アカウントを作成する必要がある場合、[ログイン] を右クリックして [新しいログイン] をクリックし、ログイン アカウントを作成します。
- Windows 認証を使用するには、[Windows 認証] をクリックし、インスタンスを登録するときに指定したものと同じ Windows アカウントを入力します。
- SQL Server 認証を使用する必要がある場合は、[SQL Server 認証] をクリックし、インスタンスを登録するときに指定したものと同じ SQL Server ログインとパスワードを入力します。
Windows サービスで使用されるログインで既に SQL Server へアクセスできる場合、そのログインを右クリックして [プロパティ] を選択します。
[ログイン] ダイアログ ボックスの左側のペインで、[ユーザー マッピング] をクリックします。
NewsletterInstanceNSMain データベースへの権限を許可します。
- [このログインにマップされたユーザー] ボックスで [NewsletterInstanceNSMain] をクリックします。
- [NewsletterInstanceNSMain のデータベース ロール メンバシップ] ボックスで [NSRunService] をクリックします。
NewsletterInstanceNewsletter データベースへの権限を許可します。
- [このログインにマップされたユーザー] ボックスで [NewsletterInstanceNewsletter] をクリックします。
- [NewsletterInstanceNewsletter のデータベース ロール メンバシップ] ボックスで [NSRunService] をクリックします。
[OK] をクリックして、SQL Server 権限を適用します。
Windows エクスプローラを使用して、Events フォルダのセキュリティを構成します。
- Newsletter サンプルの Events フォルダに移動します。
- Events フォルダを右クリックして [共有とセキュリティ] をクリックし、[セキュリティ] タブを選択します。
- [追加] をクリックして、Windows サービスで使用されるアカウントを追加します。
- [グループ名またはユーザー名] ボックスで、追加したアカウントをクリックします。
- [アクセス許可] ボックスで、[読み取り] 権限および [変更] 権限を選択します。
- [OK] をクリックして、変更を適用します。
Notifications フォルダのセキュリティを構成します。
- Newsletter サンプルの Notifications フォルダに移動します。
- Notifications フォルダを右クリックして [共有とセキュリティ] をクリックし、[セキュリティ] タブを選択します。
- [追加] をクリックして、Windows サービスで使用されるアカウントを追加します。
- [グループ名またはユーザー名] ボックスで、追加したアカウントをクリックします。
- [アクセス許可] ボックスで、[書き込み] 権限を選択します。
- [OK] をクリックして、変更を適用します。
サンプルの実行
このサンプルを実行するには、次の手順を行う必要があります。
- インスタンスの開始
- Web アプリケーションを使用してのサブスクライバおよびサブスクリプションの追加
- イベントを含む XML ファイルの送信
これらのタスクを行う方法と、結果の通知を表示する方法は、次の手順のとおりです。
手順 1: インスタンスの開始
オブジェクト エクスプローラで、Notification Services フォルダを開きます。
[NewsletterInstance] を右クリックして [開始] を選択します。
手順 2: サブスクライバおよびサブスクリプションの追加
Visual Studio 2005 を開きます。
[ファイル] メニューの [開く] をポイントし、[Web サイト] をクリックします。
[Web サイトを開く] ダイアログ ボックスで、Newsletter サンプルの SubscriptionManagementWeb\cs\SubscriptionManagementWeb フォルダに移動して [開く] をクリックします。
F5 キーを押して、Web アプリケーションを実行します。
Web ページを使用して、サンプル ユーザーのサブスクリプションを Newsletter アプリケーションに追加します。既定のサブスクリプション値が通知されます。
| メモ : |
|---|
| 運用アプリケーションの場合、またはこのアプリケーションを制限付きのアカウントで実行している場合は、インスタンス データベースとアプリケーション データベースの NSSubscriberAdmin データベース ロールにこのアプリケーションの SQL Server ログインを追加してください。 |
手順 3: イベントの送信
Windows エクスプローラで、Newsletter サンプルのルート フォルダに移動し、EventData.xml ファイルを Events サブフォルダにコピーします。
ファイルをコピーすると、ファイル システム監視イベント プロバイダがデータをファイルから読み取り、そのデータをアプリケーションに送信して、ファイルの拡張子を .done に変更します。
データの読み取り時や送信時にエラーが発生した場合、イベント プロバイダはファイルの拡張子を .err に変更します。エラーの詳細については、Windows イベント ビューアを参照してください。
手順 4: 通知の表示
Notification Services が通知を作成するまで約 1 分間待機します。
Windows エクスプローラを使用して、Newsletter サンプルの Notifications フォルダへ移動します。FileNotifications.txt という名前のファイルを探します。このファイルには通知が含まれています。
電子メール メッセージがドロップされるフォルダへ移動します。これは通常 C:\Inetpub\mailroot にあるフォルダのいずれかにあります。SMTP サーバーの状態によって、通知は Pickup フォルダまたは Queue フォルダのいずれかにあります。SMTP サービスが実行されている場合、メッセージが Badmail フォルダに移動していることもあります。
サンプルの削除
次の手順に従って、Newsletter サンプルを削除します。
Newsletter サンプルを削除するには
オブジェクト エクスプローラで、Notification Services フォルダを開きます。
[NewsletterInstance] を右クリックし、[停止] をクリックします。
[NewsletterInstance] を右クリックして [タスク] をポイントし、[登録解除] をクリックします。
[NewsletterInstance] を右クリックして [タスク] をポイントし、[削除] をクリックします。
参照
その他の技術情報
SQL Server Notification Services サンプル
Notification Services のセキュリティの設定
ヘルプおよび情報
変更履歴
| リリース | 履歴 |
|---|---|
2006 年 7 月 17 日 |
|
2006 年 4 月 14 日 |
|