HowToUseBlankDotNet_ver2.1 - TERASOLUNA Framework Wiki - TERASOLUNA Framework

Server/Client Framework for .NET 2.1
テンプレート 導入手順

概要

これはTERASOLUNA Server/Client Framework for .NETのテンプレートを導入する手順書です。
テンプレートには以下の2種類があります。

• プロジェクトテンプレート
• 項目テンプレート

前提条件

導入環境には、あらかじめ以下のものが用意されている必要があります。

Visual Studio 2005の場合

• Microsoft Visual Studio 2005 Team Edition for Software Developers
• .NET Framework 2.0、.NET Framework 2.0 SP1、または.NET Framework 2.0 SP2
• WebAPサーバ：IIS 6.0(TERASOLUNA Server Framework for .NETを利用する場合)

Visual Studio 2008の場合

• Microsoft Visual Studio Team System 2008 Development Edition
• .NET Framework 2.0 SP2、または.NET Framework 3.5 SP1
• WebAPサーバ：IIS 6.0(TERASOLUNA Server Framework for .NETを利用する場合)

併記されているバージョンを元に動作確認を行っていますが、このバージョン以外の環境での動作を制限するものではありません。
また、これらのインストール及び設定の手順については、別途Web上の利用ガイド等を参照してください。

なお、TERASOLUNA Server/Client Framework for .NETが提供する入力値検証機能では、内部でEnterprise Library 3.1を利用しています。以下に、Enterprise Library 3.1の導入手順を示します。

Enterprise Library 3.1の導入

1. Enterprise Library 3.1にアクセスし、Enterprise Library 3.1をダウンロードします。Enterprise Library 3.1の詳細については、patterns & practices Enterprise Libraryを参照してください。
2. ダウンロードしたEnterprise Library May 2007.msiを実行し、Enterprise Library 3.1をインストールします。

インストーラの実行

1. terasoluna-server-client4n-installer_(バージョン番号)）.zipを任意のフォルダに展開します。
2. 展開して得られたTERASOLUNA-(バージョン番号).msiを実行し、TERASOLUNA Server/Client Framework for .NETのDLLファイルをインストールします。

プロジェクトテンプレートの導入

1. terasoluna-server-client4n-template_(バージョン番号).zipを任意のフォルダに展開します。
2. 展開して得られたプロジェクトテンプレートファイルをフォルダごと「マイ ドキュメント\Visual Studio 2005(or 2008)\Templates\ProjectTemplates」にコピーします。

• 各テンプレートファイルの概要を以下に示します。

  フォルダ	テンプレートファイル名	概要
  Visual C#	Terasoluna Windows Application	TERASOLUNA Client Framework for .NET のプロジェクトテンプレート（C#）
  	Terasoluna Server Application Rich	TERASOLUNA Server Framework for .NET Rich版 のプロジェクトテンプレート（C#）
  	Terasoluna Server Application Web	TERASOLUNA Server Framework for .NET Web版 のプロジェクトテンプレート（C#）
  Visual Basic	Terasoluna Windows Application	TERASOLUNA Client Framework for .NET のプロジェクトテンプレート（VB）
  	Terasoluna Server Application Rich	TERASOLUNA Server Framework for .NET Rich版 のプロジェクトテンプレート（VB）
  	Terasoluna Server Application Web	TERASOLUNA Server Framework for .NET Web版 のプロジェクトテンプレート（VB）

プロジェクトテンプレートの利用

C#の場合

1. Visual Studioにて、「ファイル」＞「新規作成」＞「プロジェクト」を選択します。
2. 「プロジェクトの種類」にて「Visual C#」を選択します。「マイテンプレート」から利用したいテンプレート（例：Terasoluna Windows Application）を選択し「OK」をクリックします。
3. 「ソリューション エクスプローラ」にて「TerasolunaWindowsApplication1プロジェクト」のノードを展開します。
4. 「参照設定」のノードを右クリックし、「参照の追加」を選択します。
5. 「.NET」タブにて、以下のコンポーネントを選択し、「OK」をクリックします。

• Enterprise Library Shared Library
• Enterprise Library Validation Application Block

VBの場合

1. Visual Studioにて、「ファイル」＞「新規作成」＞「プロジェクト」を選択します。
2. 「プロジェクトの種類」にて「Visual Basic」を選択します。「マイテンプレート」から利用したいテンプレート（例：Terasoluna Windows Application）を選択し、「OK」をクリックします。
3. 「ソリューション エクスプローラ」にて「TerasolunaWindowsApplication1プロジェクト」を右クリックし、「プロパティ」を選択します。
4. 「参照」タブにて「追加」をクリックします。
5. 「.NET」タブにて、以下のコンポーネントを選択し、「OK」をクリックします。

• Enterprise Library Shared Library
• Enterprise Library Validation Application Block

ツールボックスへのアイテムの追加

※この手順は、TERASOLUNA Client Framework for .NET導入済後、一度だけ実施する必要があります。

1. Visual Studioにて「ツールボックス」タブをクリックし、ツールボックスを表示します。
2. ツールボックスを右クリックし、「タブの追加」を選択します。タブの名前に「TERASOLUNA」と入力します。
3. 作成した「TERASOLUNA」タブを右クリックし、[アイテムの選択]を選択します。
4. 「.NET Framework コンポーネント」タブにて以下のコンポーネントにチェックを入れ、「OK」をクリックします。他のコンポーネントのチェックを操作する必要はありません。Windows フォーム（例：Form1.cs）をデザイナで開き、ツールボックスタブの「TERASOLUNA」タブに追加したコンポーネントが表示されることを確認します。

• アセンブリ名：TERASOLUNA.Fw.Client (バージョン番号)
  • EventController
  • FormForwarder

項目テンプレートの導入

1. terasoluna-server-client4n-template_(バージョン番号).zipを任意のフォルダに展開します。
2. 展開して得られた項目テンプレートファイルを「マイ ドキュメント\Visual Studio 2005(or 2008)\Templates\ItemTemplates\Visual C#」と「マイ ドキュメント\Visual Studio 2005(or 2008)\Templates\ItemTemplates\Visual Basic」にコピーします。

• 各テンプレートファイルの概要を以下に示します。

  テンプレートファイル名	概要
  ClientBLogicConfiguration	TERASOLUNA Client Framework for .NET のビジネスロジック設定ファイルです。
  ConverterConfiguration	TERASOLUNA Client Framework for .NET のデータセット変換設定ファイルです。
  ExceptionCodeConfiguration	TERASOLUNA Server Framework for .NET のエラーコード設定ファイルです。
  ExceptionTransitionConfiguration	TERASOLUNA Server Framework for .NET のエラー画面遷移設定ファイルです。
  PageConfiguration	TERASOLUNA Server Framework for .NET のページ設定ファイルです。
  ServerBLogicConfiguration	TERASOLUNA Server Framework for .NET のビジネスロジック設定ファイルです。
  SqlConfiguration	TERASOLUNA Server Framework for .NET のSQL文設定ファイルです。
  ValidationConfiguration	TERASOLUNA Server/Client Framework for .NET の入力値検証設定ファイルです。
  ViewConfiguration	TERASOLUNA Client Framework for .NET の画面遷移設定ファイルです。

項目テンプレートの利用

1. Visual Studioにて、「表示」＞「ソリューション エクスプローラ」を選択します。
2. 「ソリューション エクスプローラ」中の任意のプロジェクト、フォルダにて右クリックをして、「追加」＞「新しい項目」を選択します。
3. 「新しい項目の追加」にて、下部にある「マイ テンプレート」から任意のテンプレートを選択して、「OK」をクリックします。