「業務アプリ共通部品機能」仕様書 · 1 「業務アプリ共通部品機能」...

1

「業務アプリ共通部品機能」

仕様書

（第 1.01 版）

2011 年 1月 19 日

Trust system Co.,Ltd.

2

目次

目次目次目次目次 ................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 2222

変更履歴変更履歴変更履歴変更履歴 .................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................... 6666

１．ユーザコントロール一覧１．ユーザコントロール一覧１．ユーザコントロール一覧１．ユーザコントロール一覧 ............................................................................................................................................................................................................................................................................................................................................................................................................................................................................................ 9999

２．ファイルアップローダー２．ファイルアップローダー２．ファイルアップローダー２．ファイルアップローダー(FILEUPLODER)(FILEUPLODER)(FILEUPLODER)(FILEUPLODER) ....................................................................................................................................................................................................................................................................................................................................................................................................10101010

2222---- 1111 概要概要概要概要 ............................................................................................................................................................... 10

2222---- 2222 機能一覧機能一覧機能一覧機能一覧 ........................................................................................................................................................ 10

2222---- 3333 プロパティ一覧プロパティ一覧プロパティ一覧プロパティ一覧 ................................................................................ エラーエラーエラーエラー!!!! ブックマークが定義されていません。ブックマークが定義されていません。ブックマークが定義されていません。ブックマークが定義されていません。

2222---- 4444 メソッド一覧メソッド一覧メソッド一覧メソッド一覧 .................................................................................................................................................... 10

2222---- 4444---- 1111 GetFilePathGetFilePathGetFilePathGetFilePath ................................................................................................................................. 10

2222---- 4444---- 2222 GetFileNameGetFileNameGetFileNameGetFileName ................................................................................................................................. 12

2222---- 4444---- 3333 SetControlEnabledSetControlEnabledSetControlEnabledSetControlEnabled ...................................................................................................................... 12

2222---- 5555 使用方法使用方法使用方法使用方法 ........................................................................................................................................................ 12

2222---- 5555 イメージ図イメージ図イメージ図イメージ図 ...................................................................................................................................................... 13

３．３．３．３．メニューバー表示コントロール（メニューバー表示コントロール（メニューバー表示コントロール（メニューバー表示コントロール（MENUBARMENUBARMENUBARMENUBAR）））） ................................................................................................................................................................................................................................................................................................................................................................................14141414

3333---- 1111 概要概要概要概要 ............................................................................................................................................................... 14


3333---- 3333 プロパティ一覧プロパティ一覧プロパティ一覧プロパティ一覧 ............................................................................................................................................... 14

3333---- 4444 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明 ............................................................................................................................................. 15

3333---- 4444---- 1111 DispSubMenuItemDispSubMenuItemDispSubMenuItemDispSubMenuItem ........................................................................................................................ 15

3333---- 4444---- 2222 NoNoNoNodispSubMenuItemdispSubMenuItemdispSubMenuItemdispSubMenuItem .................................................................................................................... 15

3333---- 4444---- 3333 NodispAllSubMenuItemNodispAllSubMenuItemNodispAllSubMenuItemNodispAllSubMenuItem .............................................................................................................. 15

3333---- 4444---- 4444 DispSubMenuItemExDispSubMenuItemExDispSubMenuItemExDispSubMenuItemEx .................................................................................................................... 15


４．４．４．４．ページャコントロール（ページャコントロール（ページャコントロール（ページャコントロール（PAGERPAGERPAGERPAGER）））） ....................................................................................................................................................................................................................................................................................................................................................................................................................................................17171717

4444---- 1111 概要概要概要概要 ............................................................................................................................................................... 17



4444---- 4444 イベントイベントイベントイベント .......................................................................................................................................................... 17

4444---- 4444---- 1111 btnTop_ClickbtnTop_ClickbtnTop_ClickbtnTop_Click ............................................................................................................................. 17

4444---- 4444---- 2222 btnPrev_ClickbtnPrev_ClickbtnPrev_ClickbtnPrev_Click ........................................................................................................................... 17

4444---- 4444---- 3333 btnNext_ClickbtnNext_ClickbtnNext_ClickbtnNext_Click ........................................................................................................................... 17

4444---- 4444---- 4444 btnLast_ClickbtnLast_ClickbtnLast_ClickbtnLast_Click ........................................................................................................................... 18

4444---- 4444---- 5555 ddlPage_SelectedIndexChangedddlPage_SelectedIndexChangedddlPage_SelectedIndexChangedddlPage_SelectedIndexChanged ................................................................................................ 18

4444---- 4444---- 6666 ddlListLine_SelecddlListLine_SelecddlListLine_SelecddlListLine_SelectedIndexChangedtedIndexChangedtedIndexChangedtedIndexChanged ........................................................................................ 18

3

4444---- 5555 イベント設定例イベント設定例イベント設定例イベント設定例 ............................................................................................................................................... 18


５．５．５．５．コード名称取得コントロール（コード名称取得コントロール（コード名称取得コントロール（コード名称取得コントロール（GETCODENAMECTRLGETCODENAMECTRLGETCODENAMECTRLGETCODENAMECTRL）））） ....................................................................................................................................................................................................................................................................................................................................20202020

5555---- 1111 概要概要概要概要 ............................................................................................................................................................... 20



5555---- 4444 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明 ............................................................................................................................................. 23

5555---- 4444---- 1111 GetCodeGetCodeGetCodeGetCode ...................................................................................................................................... 23

5555---- 4444---- 2222 SetCodeSetCodeSetCodeSetCode ...................................................................................................................................... 23

5555---- 4444---- 3333 GetNameGetNameGetNameGetName ...................................................................................................................................... 23

5555---- 4444---- 4444 SetNameSetNameSetNameSetName ...................................................................................................................................... 23

5555---- 4444---- 5555 SetControlEnabledSetControlEnabledSetControlEnabledSetControlEnabled .................................................................................................................... 24

5555---- 4444---- 6666 SetErrorBackColorSetErrorBackColorSetErrorBackColorSetErrorBackColor .................................................................................................................... 24

5555---- 4444---- 7777 SetNormalBackColorSetNormalBackColorSetNormalBackColorSetNormalBackColor .................................................................................................................. 24

5555---- 4444---- 8888 FocusFocusFocusFocus .......................................................................................................................................... 24

5555---- 4444---- 9999 SetCustomControlAttributeSetCustomControlAttributeSetCustomControlAttributeSetCustomControlAttribute ..................................................................................................... 25

5555---- 5555 使用方法使用方法使用方法使用方法 ........................................................................................................................................................ 25

６．６．６．６．パンくずリストパンくずリストパンくずリストパンくずリスト(BREADCRUMBSLIST.ASP(BREADCRUMBSLIST.ASP(BREADCRUMBSLIST.ASP(BREADCRUMBSLIST.ASPX)X)X)X) ................................................................................................................................................................................................................................................................................................................................................................................29292929

6666---- 1111 概要概要概要概要 ............................................................................................................................................................... 29




6666---- 4444---- 1111 BreadcrumbsList_HideBreadcrumbsList_HideBreadcrumbsList_HideBreadcrumbsList_Hide ................................................................................................................ 33

6666---- 4444---- 2222 BreadcrumbsList_ShowBreadcrumbsList_ShowBreadcrumbsList_ShowBreadcrumbsList_Show ................................................................................................................ 33

6666---- 4444---- 3333 CreateBreadcrumbsListCreateBreadcrumbsListCreateBreadcrumbsListCreateBreadcrumbsList .............................................................................................................. 33


７．７．７．７．メニューツリーメニューツリーメニューツリーメニューツリー(MENUTREE.ASCX)(MENUTREE.ASCX)(MENUTREE.ASCX)(MENUTREE.ASCX) ................................................................................................................................................................................................................................................................................................................................................................................................................................35353535

7777---- 1111 概要概要概要概要 ............................................................................................................................................................... 35




7777---- 4444---- 1111 ReDisplayReDisplayReDisplayReDisplay ................................................................................................................................... 35

7777---- 4444---- 2222 OpenTreeAllOpenTreeAllOpenTreeAllOpenTreeAll ............................................................................................................................... 35

7777---- 4444---- 3333 CloseTreeAllCloseTreeAllCloseTreeAllCloseTreeAll ............................................................................................................................. 36

7777---- 5555 補足説明補足説明補足説明補足説明 ........................................................................................................................................................ 36


８．８．８．８．ページツリーページツリーページツリーページツリー(PAGETREE.ASCX)(PAGETREE.ASCX)(PAGETREE.ASCX)(PAGETREE.ASCX) ........................................................................................................................................................................................................................................................................................................................................................................................................................................37373737

8888---- 1111 概要概要概要概要 ............................................................................................................................................................... 37

4


8888---- 3333 プロパプロパプロパプロパティ一覧ティ一覧ティ一覧ティ一覧 ............................................................................................................................................... 37


8888---- 5555 補足説明補足説明補足説明補足説明 ........................................................................................................................................................ 37


９．９．９．９．プログレスカーソルプログレスカーソルプログレスカーソルプログレスカーソル(PROGRESSCURSOR.ASCX(PROGRESSCURSOR.ASCX(PROGRESSCURSOR.ASCX(PROGRESSCURSOR.ASCX)))) ........................................................................................................................................................................................................................................................................................................................................................40404040

9999---- 1111 概要概要概要概要 ............................................................................................................................................................... 40



9999---- 4444 使用上の注意使用上の注意使用上の注意使用上の注意 ................................................................................................................................................ 40


１０．１０．１０．１０．汎用ページ一覧汎用ページ一覧汎用ページ一覧汎用ページ一覧 ....................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................42424242

１１．１１．１１．１１．汎用メニューページ汎用メニューページ汎用メニューページ汎用メニューページ(MASTERMENU.ASPX)(MASTERMENU.ASPX)(MASTERMENU.ASPX)(MASTERMENU.ASPX) ........................................................................................................................................................................................................................................................................................................................................................................43434343

11111111---- 1111 概要概要概要概要 ............................................................................................................................................................. 43

11111111---- 2222 機能一覧機能一覧機能一覧機能一覧 ...................................................................................................................................................... 43

11111111---- 3333 使用方法使用方法使用方法使用方法 ...................................................................................................................................................... 43

11111111---- 4444 イメージ図イメージ図イメージ図イメージ図 .................................................................................................................................................... 43

１２．１２．１２．１２．マスターページコントローマスターページコントローマスターページコントローマスターページコントロールルルル(MASTERBASEPAGE.MAST(MASTERBASEPAGE.MAST(MASTERBASEPAGE.MAST(MASTERBASEPAGE.MASTERERERER、、、、MASTERBASE.VB)MASTERBASE.VB)MASTERBASE.VB)MASTERBASE.VB) ............................................................................................................................................................................44444444

12121212---- 1111 概要概要概要概要 ............................................................................................................................................................. 44


12121212---- 3333 プロパティ一覧プロパティ一覧プロパティ一覧プロパティ一覧((((マスターベースページマスターベースページマスターベースページマスターベースページ)))) ......................................................................................................... 44

12121212---- 4444 プロパティ一覧プロパティ一覧プロパティ一覧プロパティ一覧((((基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス)))) .................................................................................................... 45

12121212---- 5555 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明((((マスターベースページマスターベースページマスターベースページマスターベースページ)))) ...................................................................................................... 46

12121212---- 5555---- 1111 AddMessageAddMessageAddMessageAddMessage ................................................................................................................................. 46

12121212---- 5555---- 2222 DeleteMessageDeleteMessageDeleteMessageDeleteMessage ........................................................................................................................... 46

12121212---- 5555---- 3333 CheckOverduePasswordCheckOverduePasswordCheckOverduePasswordCheckOverduePassword .............................................................................................................. 46

12121212---- 5555---- 4444 SystemMaintenanceTermCherckSystemMaintenanceTermCherckSystemMaintenanceTermCherckSystemMaintenanceTermCherck .................................................................................................. 47

12121212---- 6666 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明((((基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス)))) .................................................................................................. 47

12121212---- 6666---- 1111 AllHideHeaderAllHideHeaderAllHideHeaderAllHideHeader ........................................................................................................................... 47

12121212---- 6666---- 2222 AllHideFooterBaseButtonAllHideFooterBaseButtonAllHideFooterBaseButtonAllHideFooterBaseButton ......................................................................................................... 47

12121212---- 6666---- 3333 HideMenuBarHideMenuBarHideMenuBarHideMenuBar ............................................................................................................................... 48

12121212---- 6666---- 4 4 4 4 ShowMenuBarShowMenuBarShowMenuBarShowMenuBar ............................................................................................................................... 48

12121212---- 6666---- 5 5 5 5 HideAllMenuBarHideAllMenuBarHideAllMenuBarHideAllMenuBar ......................................................................................................................... 48

12121212---- 6666---- 6666 ShowShowShowShowMenuBarExMenuBarExMenuBarExMenuBarEx ........................................................................................................................... 48

12121212---- 7777 イメージ図イメージ図イメージ図イメージ図 .................................................................................................................................................... 49

12121212---- 7777---- 1111 パスワード有効期限制御パスワード有効期限制御パスワード有効期限制御パスワード有効期限制御 ........................................................................................................... 49

12121212---- 7777---- 2222 システムメンテナンス期間制御システムメンテナンス期間制御システムメンテナンス期間制御システムメンテナンス期間制御 ................................................................................................ 50

１３．１３．１３．１３．ログインページログインページログインページログインページ(LOGIN.ASPX)(LOGIN.ASPX)(LOGIN.ASPX)(LOGIN.ASPX) ....................................................................................................................................................................................................................................................................................................................................................................................................................................51515151

5

13131313---- 1111 概要概要概要概要 ............................................................................................................................................................. 51


13131313---- 3333 処理フロー図処理フロー図処理フロー図処理フロー図 ................................................................................................................................................ 52

１４．１４．１４．１４．パスワード変更ページパスワード変更ページパスワード変更ページパスワード変更ページ(PASSWORDCHANGE.ASPX(PASSWORDCHANGE.ASPX(PASSWORDCHANGE.ASPX(PASSWORDCHANGE.ASPX)))) ............................................................................................................................................................................................................................................................................................................................53535353

14141414---- 1111 概要概要概要概要 ............................................................................................................................................................. 53



14141414---- 3333---- 1 1 1 1 システムメンテナンス期間直前システムメンテナンス期間直前システムメンテナンス期間直前システムメンテナンス期間直前 ..................................................... 54

14141414---- 3333---- 2 2 2 2 システムメンテナンス期間中システムメンテナンス期間中システムメンテナンス期間中システムメンテナンス期間中 ..................................................................................................... 54

6

変更履歴変更履歴変更履歴変更履歴

版数年月日変更内容担当承認

0.0 2009.10.30 初版園田

0.01 2009.11.17 コード名称取得機能追加園田

0.10 2009.11.26 ベータ版リリース園田

0.11 2009.11.30 Base.Master メソッド追加

ActiveReportBase.Master の追加

上原

0.12 2009.12.22 GetCodeNameCtrl 仕様変更(取得項目追加) 上原

0.13 2009.12.29 ActiveReportBase.Master の仕様変更上原

0.13 2010.01.08 ActiveReportBase.Master の仕様変更(ファイル保

存機能追加)

上原

0.13 2010.01.13 MenuBar の仕様変更(表示非表示メソッド使用方

法)

上原

0.13 2010.01.15 ActiveReporBase.Master の削除

レポート出力用基底クラスを作成した為

上原

0.13 2010.01.28 Base.Master プロパティの削除と追加メソッド追

加

上原

1.01 2010.02.03 Base.Masterを MasterBasePage.Masterに名称を変

更

上原

1.01 2010.02.05 ExcelCreatorRead のメソッドを「システム共通パッ

ケージクラス仕様」に移行

園田

1.03 2010.02.19 GetCodeNameControl にメソッド

SetErrorBackColor と SetNormalBackColor 追加

上原

1.03 2010.02.19 PagerEx の追加上原

1.04 2010.02.25 MasterBasePage.Master プロパティ修正

MenuBar メソッド説明修正

上原

1.05 2010.03.03 GetCodeNameControl にプロパティ

“CodeMaxLength”を追加

上原

1.05 2010.03.05 PagerEx の仕様変更のため内容修正上原

1.06 2010.03.11 GetCodeNameContorol のメソッド Focus を追加上原

1.06 2010.03.11 PagerEx 削除上原

1.07 2010.03.19 GetCodeNameControl にプロパティ“CodeClientID”

と“NameClientID”を追加

上原

1.07 2010.03.19 MasterBasePage.Master 機能追加(右クリック禁止

機能追加)

上原

1.07 2010.03.19 ログインページ機能説明新規追加上原

1.08 2010.03.26 FileUploader にプロパティ“SubFolder”を追加上原

7

1.10 2010.04.05 GetCodeNameContorol のポップアップ画像の張り

替え。表示件数説明追加

上原

1.11 2010.04.12 MasterBasePage.Master に

CheckOverduePassword（パスワードの有効期限切れ

チェック＆メッセージ表示処理）メソッドを追加

園田

1.11 2010.04.12 マスターページクラスに AllHideHeader メソッドを

追加（コンテンツページで Me.AllHideHeader で使用可）

園田

1.11 2010.04.12 マスターページクラスに AllHideFooterBaseButton

メソッドを追加（コンテンツページで Me.

AllHideFooterBaseButton で使用可）

園田

1.11 2010.04.12 マスターページクラスに HideMenuBarメソッドを追加

（コンテンツページで Me. HideMenuBar で使用可）

園田

1.11 2010.04.12 マスターページクラスに ShowMenuBarメソッドを追加

（コンテンツページで Me. ShowMenuBar で使用可）

園田

1.11 2010.04.12 パスワードの有効期限のチェックを行い有効期限

が切れていた場合、パスワード変更画面を強制的に

表示する機能を追加

園田

1.13 2010.04.27 マスターページクラスに HideAllMenuBar メソッドを

追加（コンテンツページで Me. HideAllMenuBar で使用

可）

上原

1.16 2010.05.28 FileUploader にコントロール活性設定するプロパ

ティ (ControlEnabled) とメソッド

(SetContorlEnabled)を追加

上原

1.26 2010.08.03 汎用メニューページ(Menu_Ctrl)を新メニューテー

ブル使用に伴い修正

パンくずリストユーザーコントロール新規追加

上原

1.261 2010.08.09 パンくずリストプロパティ説明修正上原

1.30 2010.09.02 GetCodeNamectrl にプロパティ[ControlVisible]

追加

インタフェースメソッド

[SetCustomControlAttribute]の追加

上原

1.32 2010.09.14 GetCodeNamectrl に検索についての補足説明を追

加

上原

1.35 2010.10.14 GetCodeNamectrl の自動名称取得のコード変換に

ついての補足説明を追加

上原

1.38 2010.11.05 ProgressCursor 新規追加上原

1.39 2010.11.08 GetCodeNameCtrl の検索処理についての補足説明

を修正

上原

8

1.50 2010.02.02 FileUploder に結果表示ラベルの表示非表示設定

メソッド(SetLabelVisible)追加

上原

1.51 2010.02.10 FileUploder にクライアント側でファイルサイズ

チェックを行う処理追加

ログイン画面にユーザーIDをCookieに登録するた

めのチェックボックスコントロールと処理を追加

上原

1.56 2010.03.22 マスターページコントロール機能一覧に、BasePage

クラスの機能を追加

上原

9

１．１．１．１．ユーザコントロール一覧ユーザコントロール一覧ユーザコントロール一覧ユーザコントロール一覧

No. コントロール名機能名説明

１ FileUploader ファイルアップローダーサーバへのファイルアップロード

２ MenuBar メニューバー画面上部のメニューバー

３ Pager ページャーページ制御コントロール

４ GetCodeNameCtrl コード名称取得コード値＆名称取得ポップアップ表示処理

５ ProgressCursor プログレスカーソル UpdatePanel 内の処理中画面に表示するプログ

レスカーソル

６ MenuTree メニューツリーメニュー表示用ツリービュー

７ PageTree ページツリーページ表示用ツリービュー

10

２２２２．フ．フ．フ．ファイルアップローダーァイルアップローダーァイルアップローダーァイルアップローダー(FileUploder)(FileUploder)(FileUploder)(FileUploder)

2222---- 1 1 1 1 概要概要概要概要

サーバーへファイルアップロードする機能を提供するコントロール

2222---- 2 2 2 2 機能一覧機能一覧機能一覧機能一覧

1 ASP.NETが提供するSystem.Web.UI.WebControls.FileUploadを拡張してコーディングレスでサーバ

ーへファイルアップロードする機能を提供。

2 アップロード時の実行状態表示機能。

3 アップロードファイルのサイズ上限チェック機能。(4M 以上のファイルを設定して、フォーカスを

別の場所に移そうとすると、ワーニングメッセージダイアログを出力後、入力内容を削除しフォー

カスを入力テキストボックスに当てる。)

この機能を使用する為には、ブラウザに対して以下の設定を行うことが必須条件となる。

①ツール→インターネットオプション→セキュリティのタブ選択→ローカルイントラネット選択

→レベルのカスタマイズを選択

②セキュリティ設定ダイアログが表示されるので、以下のように項目の設定を行う。

・「スクリプトを実行しても安全だとマークされていない ActiveX コントロールの初期化とスクリ

プトの実行」→有効

・「サーバーにファイルをアップロードするときにローカルディレクトリパスを含める」→有効

2222---- 3 3 3 3 プロパティ一覧プロパティ一覧プロパティ一覧プロパティ一覧

No. プロパティ型 R/W 設定値説明

１ SubFolder String R/W 文字列アップロードファイル格納先サブ

フォルダ名称

※アップロード先基底フォルダの

下に個別に格納するために設定

２ [ContorlEnabled] Boolean R/W True/False コントロール全体の活性・非活性属

性設定

※[]付きのプロパティは設定の省略が可能であることを表す。

2222---- 4444 メソッドメソッドメソッドメソッド一覧一覧一覧一覧

2222---- 4444---- 1111 GetFilePathGetFilePathGetFilePathGetFilePath

メソッド名 GetFilePath

Public Function GetFilePath() As String

概要アップロード先フォルダのフルパス情報を取得する

説明アップロード先フォルダのフルパス情報を webconfig（単体テスト時）またはシステム

構成情報（本番時等）から取得したパス情報とアップロードで選択したファイル名とで

11

結合した文字列を返す。

パラメータなし

戻り値アップロード先フォルダのフルパス情報

例）

c:\skitt\upload\test.xls

使用例 Dim path As String = Me.FileUploder1.GetFilePath

12

2222---- 4444---- 2222 GetFileNameGetFileNameGetFileNameGetFileName

メソッド名 SetControlEnabled

Public Function GetFileName() As String

概要アップロードファイルの名称を取得する

説明アップロードファイル名称を、アップロード時に選択したクライアント PC のファイル

パス情報から抽出して取得

パラメータなし

戻り値アップロードファイルの名称

例）

Test.xls

使用例 Dim name As String = Me.FileUploder1.GetFileName

2222---- 4444---- 3333 SetControSetControSetControSetControlEnabledlEnabledlEnabledlEnabled


Public Sub SetControlEnabled(ByVal setflg As Boolean)

概要コントロールの Enabled を設定する

説明 Enabled の設定を行う

パラメータ Setflg：コントロールの有効無効(True：有効、False：無効)

戻り値無し

使用例 Me.FileUploder1.SetControlEnabled (True)

2222---- 4444---- 4444 SetSetSetSetLabelVisibleLabelVisibleLabelVisibleLabelVisible

メソッド名 SetLabelVisible

Public Sub SetLabelVisible(ByVal setflg As Boolean)

概要結果表示ラベルコントロールの Visible を設定する

説明 Visible の設定を行う

パラメータ Setflg：コントロールの表示非表示(True：表示、False：非表示)

戻り値無し

使用例 Me.FileUploder1.SetLabelVisible (False)

2222---- 5555 使用方法使用方法使用方法使用方法

プロパティ[SubFolder]の設定が必須である。

アップロードされるパスはWeb.Configのキー[UploadFolderName]の value値＋プロパティ[SubFolder]にて設

定される。

例：

WebConfig

<add key="UploadFolderName" value="C:\files\skitt\Upload" />

プロパティ「SubFolder」＝ “uploadfolder”

13

上記の様な設定になっていると、アップロードしたものは「C:\files\skitt\Upload\uploadfolder」以下に格

納される。

2222---- 5555 イメージ図イメージ図イメージ図イメージ図

送信完了

14

３．３．３．３．メメメメニューバー表示コントロールニューバー表示コントロールニューバー表示コントロールニューバー表示コントロール（（（（MenuBarMenuBarMenuBarMenuBar））））

3333---- 1 1 1 1 概要概要概要概要

画面上部にメニューバーを表示する

※このコントロールは、基本的に個別業務処理からは直接使用せず、「マスターページコントロール」

経由で制御される。


１メニューバー表示機能を提供する

※ロールにより表示・非表示を制御する(メニュー表示に関連するロールの登録は、運用画面「メ

ニュー設定」で行う。)

※メニューテーブルデータとメニュー画面についての補足説明は別紙

「メニューテーブルとメニュー画面との関連についての補足説明.xls」を参照

3333---- 3 3 3 3 プロパティプロパティプロパティプロパティ一覧一覧一覧一覧


１ TopMenuKbn String R/W 文字列トップメニュー区分

※ M_MENU.MENU_KB と

M_MENU_CTRL.MENU_KBの値

がここで設定した値と関

連つけられる

設定値：”T”このプロパティに“”

空値を設定することにより、メニュ

ー項目を非表示にする。

２ SubMenuKbn String R/W 文字列サブメニュー区分

※ M_MENU.MENU_KB と

M_MENU_CTRL.MENU_KBの値

がここで設定した値と関

連つけられる

設定値：”S” このプロパティに“”

空値を設定することにより、サブメ

ニュー項目を非表示にする。

※画面配置を行う際は、マスターベースページに以下の様に設定する。

設定例：<uc1:MenuBar ID="MenuBar1" runat="server" TopMenuKbn="T" SubMenuKbn="S" />

15

3333---- 4 4 4 4 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明

3333---- 4444---- 1111 DDDDispSubMenuItispSubMenuItispSubMenuItispSubMenuItemememem

メソッド名 DispSubMenuItem ()

Public Sub DispSubMenuItem()

概要メニューバーを全て表示する

説明 -

パラメータ無し

戻り値無し

使用例 'メニューバー表示設定

baseMaster.MenuBarObj.DispSubMenuItem()

※コンテンツページでそのまま使用できるMe.ShowMenuBarを追加したので以降こちらを使

用。

3333---- 4444---- 2222 NoNoNoNodispSdispSdispSdispSubMenuItemubMenuItemubMenuItemubMenuItem

メソッド名 NodispSubMenuItem ()

Public Sub NoDispSubMenuItem()

概要メニューバーを非表示にする（ログアウトボタンは表示）

説明 -


戻り値無し

使用例 'メニューバー非表示設定

baseMaster.MenuBarObj.NoDispSubMenuItem()

※コンテンツページでそのまま使用できる Me. HideMenuBar を追加したので以降こちらを使

用。

3333---- 4444---- 3333 NoNoNoNodispdispdispdispAllAllAllAllSubMenuItemSubMenuItemSubMenuItemSubMenuItem

メソッド名 NodispAllSubMenuItem ()

Public Sub NoDispAllSubMenuItem()

概要メニューバーを全て非表示にする

説明 -


戻り値無し

使用例 'メニューバー非表示設定

baseMaster.MenuBarObj.NoDispAllSubMenuItem()

※コンテンツページでそのまま使用できる Me. HideAllMenuBar を追加したので以降こちら

を使用。

3333---- 4444---- 4444 DDDDispSubMenuItemispSubMenuItemispSubMenuItemispSubMenuItemExExExEx

メソッド名 DispSubMenuItemEx ()

Public Sub DispSubMenuItemEx()

概要メニューバーを表示する（ログアウトボタンは非表示）

説明 -

16


戻り値無し

使用例 'メニューバー表示設定

baseMaster.MenuBarObj.DispSubMenuItem()

※コンテンツページでそのまま使用できる Me. ShowMenuBarEx を追加したので以降こちらを

使用。

3333---- 5 5 5 5 イメージ図イメージ図イメージ図イメージ図

・メニューバー表示例

・メニューバー非表示例

※ 他の画面に遷移させたくない場合に使用。

17

４．４．４．４．ページャコントロール（ページャコントロール（ページャコントロール（ページャコントロール（PagerPagerPagerPager））））

4444---- 1 1 1 1 概要概要概要概要

ページ制御用コントロール


１ページ制御用コントロール

4444---- 3 3 3 3 プロパティプロパティプロパティプロパティ一覧一覧一覧一覧


１ Width Integer R/W 数値 Pager 全体の横幅の指定

4444---- 4 4 4 4 イベントイベントイベントイベント

4444---- 4444---- 1111 btnTop_ClickbtnTop_ClickbtnTop_ClickbtnTop_Click

イベント名 btnTop_Click

Protected Sub btnTop_Click(ByVal sender As Object, ByVal e As EventArgs) Handles

btnTop.Click

概要先頭頁ボタン押下

説明 -

使用例「4-5 イベント設定例」参照

4444---- 4444---- 2222 btnPrev_ClickbtnPrev_ClickbtnPrev_ClickbtnPrev_Click

イベント名 btnPrev_Click

Protected Sub btnPrev _Click(ByVal sender As Object, ByVal e As EventArgs) Handles

btnTop.Click

概要前頁ボタン押下

説明 -


4444---- 4444---- 3333 btnNext_ClickbtnNext_ClickbtnNext_ClickbtnNext_Click

イベント名 btnNext_Click

Protected Sub btnNext _Click(ByVal sender As Object, ByVal e As EventArgs) Handles

btnTop.Click

概要次頁ボタン押下

説明 -


18

4444---- 4444---- 4444 btnLast_ClickbtnLast_ClickbtnLast_ClickbtnLast_Click

イベント名 btnLast_Click

Protected Sub btnLast _Click(ByVal sender As Object, ByVal e As EventArgs) Handles

btnTop.Click

概要最終頁ボタン押下

説明 -


4444---- 4444---- 5555 ddlPage_SelectedIndexChangedddlPage_SelectedIndexChangedddlPage_SelectedIndexChangedddlPage_SelectedIndexChanged

イベント名 ddlPage_SelectedIndexChanged

Protected Sub ddlPage_SelectedIndexChanged(ByVal sender As Object, ByVal e As

EventArgs) Handles ddlPage.SelectedIndexChanged

概要ﾍﾟｰｼﾞ遷移処理

説明 -


4444---- 4444---- 6666 ddlListLineddlListLineddlListLineddlListLine_SelectedIndexChanged_SelectedIndexChanged_SelectedIndexChanged_SelectedIndexChanged

イベント名 ddlListLine_SelectedIndexChanged

Protected Sub ddlListLine_SelectedIndexChanged(ByVal sender As Object, ByVal e As

EventArgs) Handles ddlListLine.SelectedIndexChanged

概要表示行数変更処理

説明 -


4444---- 5555 イベントイベントイベントイベント設定設定設定設定例例例例

・Page_Init でイベントを登録

Protected Sub Page_init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Init

AddHandler Me.Pager1.Top_Click, AddressOf Top_Click

AddHandler Me.Pager1.Prev_Click, AddressOf Prev_Click

AddHandler Me.Pager1.Next_Click, AddressOf Next_Click

AddHandler Me.Pager1.Last_Click, AddressOf Last_Click

AddHandler Me.Pager1.Page_SelectedIndexChanged, AddressOf Page_SelectedIndexChanged

AddHandler Me.Pager1.ListLine_SelectedIndexChanged, AddressOf ListLine_SelectedIndexChanged

End Sub

・各イベントを定義して実装

Protected Sub Top_Click(ByVal sender As Object, ByVal e As System.EventArgs)

'処理を実装する

End Sub

Protected Sub Prev_Click(ByVal sender As Object, ByVal e As System.EventArgs)

19


End Sub

Protected Sub Next_Click(ByVal sender As Object, ByVal e As System.EventArgs)


End Sub

Protected Sub Last_Click(ByVal sender As Object, ByVal e As System.EventArgs)


End Sub

Protected Sub Page_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs)


End Sub

Protected Sub ListLine_SelectedIndexChanged(ByVal sender As Object, ByVal e As System.EventArgs)


End Sub


20

５５５５．．．．コード名称取得コントロール（コード名称取得コントロール（コード名称取得コントロール（コード名称取得コントロール（GetCodeNameCtrlGetCodeNameCtrlGetCodeNameCtrlGetCodeNameCtrl））））

5555---- 1111 概要概要概要概要

コード名称取得コントロール

5555---- 2222 機能一覧機能一覧機能一覧機能一覧

１入力されたコードから名称を取得、またはコード選択用ダイアログ画面を表示し選択されたレコー

ドの情報を取得(コードと名称以外に 5項目の取得項目を追加できる。)

5555---- 3333 プロパティプロパティプロパティプロパティ一覧一覧一覧一覧


１ [TitleLabel]※1 String R/W 文字列コントロール側でコード

入力項目の前に、項目の

タイトルを表示したい場

合に設定。

２ ItemName String R/W 文字列エラー時に表示するコー

ド入力項目名称

３ [ButtonTabIndex] Short R/W 数値ボタンタブインデックス

４ [CodeItemIndex] Short R/W 数値コード入力項目タブイン

デックス

５ [ContorlEnabled] Boolean R/W True/False コントロール全体の活

性・非活性設定

６ [SourceTable] ※2 String R/W 文字列取得対象テーブル名

例）

M_PORT

７ DataCodeField String R/W 文字列取得対象テーブルのコー

ドに対応する項目名

８ DataNameField String R/W 文字列取得対象テーブルの名称

に対応する項目名

９ [DataKanaNameField] String R/W 文字列取得対象テーブルのカナ

名称に対応する項目名

１０ [WhereExpression] String R/W 文字列取得対象テーブル検索条

件

例）‘TRUE_FG = 0’

１１ [CodeWidth] Integer R/W 数値コード入力項目の横幅

１２

[NameWidth] Integer R/W 数値名称出力項目の横幅

１３ CodeRequired Boolean R/W True/False True：必須入力検証コン

21

トロール有効化

False：必須入力検証コン

トロール無効化

１４ [OptDataItem1] ※3 String R/W 文字列オプション取得項目 1

１５ [OptDataItem2] ※3 String R/W 文字列オプション取得項目 2

１６ [OptDataItem3] ※3 String R/W 文字列オプション取得項目 3

１７ [OptDataItem4] ※3 String R/W 文字列オプション取得項目 4

１８ [OptDataItem5] ※3 String R/W 文字列オプション取得項目 5

１９ [OptDataItem1SetControlID]

※3

String R/W 文字列オプション取得項目 1 設

定コントロール ID

２０ [OptDataItem2SetControlID]

※3



２１ [OptDataItem3SetControlID]

※3



２２ [OptDataItem4SetControlID]

※3



２３ [OptDataItem5SetControlID]

※3



２４ [OptJoinExpression]※2 String R/W 文字列テーブル結合条件

例）

M_PORT MP Left Outer

Join M_SENPAKK MS On

MP.PORT_ADDRESS =

MS.SENMEI_CD

２５ [CodeMaxLength] Integer R/W 数値コード入力項目の

MaxLength

２６ CodeClientID String R 文字列コードテキストボックス

の ClientID

※クライアントサイド

(javascript)で値を取得

するために使用

２７ NameClientID String R 文字列名称テキストボックスの

ClientID

※クライアントサイド

(javascript)で値を取得

するために使用

２８ [ContorlVisible] Boolean R/W True/False コントロール全体の可

視・不可視設定

２９ [RelatedControlID] String R/W 文字列関連する入力項目の値を

22

抽出条件としたい場合

RelatedControlID で当該

項目のClientIDを設定し

WhereExpression には抽

出条件を次のように指定

する。

“PORT_CODE = {0}”この

場合、指定した ClientID

の取得値が{0}部分に置

き換わって、データ抽出

が行われる。

※※※※GetCodeNameGetCodeNameGetCodeNameGetCodeName のコントのコントのコントのコント

ロールを指定する場合、ロールを指定する場合、ロールを指定する場合、ロールを指定する場合、

「コントロール名称「コントロール名称「コントロール名称「コントロール名称

+_txtCode+_txtCode+_txtCode+_txtCode」を設定」を設定」を設定」を設定

※[]付きのプロパティは設定の省略が可能であることを表す。

※1 デザインのバランスを取るために使用。コントロールの前にデザイン時に見出しをつけている場合は

設定不要。

※2 SourceTable 、OptJoinExpression はいずれかが設定されている必要がある。

※3 ダイアログ画面で行を選択するか、コード入力して取得したレコードセットから OptDataItem1～5 で

設定された項目を SourceTable または OptJoinExpression から取得して、OptDataItem1SetControlID~

OptDataItem5SetControlID にセットする。セットするコントロール ID は各個別ページに配置済みコント

ロール IDを指定する。

23

5555---- 4444 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明

5555---- 4444---- 1111 GetCodeGetCodeGetCodeGetCode

メソッド名 GetCode

Public Function GetCode() As String

概要コード値フィールドの値を取得する

説明トリミングした値を返す


戻り値コード値フィールドの値

使用例 'コード値を取得

Me.GetCodeNameCtrl1.GetCode

5555---- 4444---- 2222 SetCodeSetCodeSetCodeSetCode

メソッド名 SetCode

Public Sub SetCode(ByVal Code As String)

概要コード値フィールドに値を設定する

説明引数の値をコントロールに設定する

パラメータ Code：設定コード

戻り値無し

使用例 'コード値を設定

Me.GetCodeNameCtrl1.SetCode(“9999”)

5555---- 4444---- 3333 GetNameGetNameGetNameGetName

メソッド名 GetName

Public Function GetName() As String

概要名称値フィールドの値を取得する

説明トリミングした値を返す


戻り値名称値フィールドの値

使用例 '名称値を取得

Me.GetCodeNameCtrl1.GetName

5555---- 4444---- 4444 SetNameSetNameSetNameSetName

メソッド名 SetName

Public Sub SetName(ByVal Name As String)

概要名称値フィールドに値を設定する

説明引数の値をコントロールに設定する

パラメータ Name：設定名称

戻り値無し

使用例 '名称値を取得

Me.GetCodeNameCtrl1.SetName(“AAAA”)

24

5555---- 4444---- 5555 SetControlEnabledSetControlEnabledSetControlEnabledSetControlEnabled


Public Sub SetControlEnabled(ByVal setflg As Boolean)

概要コントロールの活性・非活性を設定する

説明コントロールの活性・非活性を設定する

パラメータ Setflg：コントロールの有効無効(True：有効、False：無効)

戻り値無し

使用例 Me.GetCodeNameCtrl1.SetControlEnabled (True)

5555---- 4444---- 6666 SetSetSetSetErrorBackColorErrorBackColorErrorBackColorErrorBackColor

メソッド名 SetErrorBackColor

Public Sub SetErrorBackColor()

概要背景色の設定を行う

説明コード、名称コントロールをエラー時背景色に設定する(CostomValidator と併用)


戻り値無し

使用例 'エラー背景色の設定

GetCodeNameCtrl1.SetErrorBackColor()

5555---- 4444---- 7777 SetSetSetSetNormalBackColorNormalBackColorNormalBackColorNormalBackColor

メソッド名 SetNormalBackColor

Public Sub SetNormalBackColor()

概要背景色の設定を行う

説明コード、名称コントロールを通常時背景色に設定する(CostomValidator と併用)


戻り値無し

使用例 '通常背景色の設定

GetCodeNameCtrl1.SetNormalBackColor()

5555---- 4444---- 8888 FocusFocusFocusFocus

メソッド名 Focus

Public Overrides Sub Focus()

概要フォーカスの設定を行う

説明コードコントロールにフォーカスを当てる


戻り値無し

使用例 GetCodeNameCtrl1.Focus()

25

5555---- 4444---- 9999 SetCustomControlAttributeSetCustomControlAttributeSetCustomControlAttributeSetCustomControlAttribute

メソッド名 SetCustomControlAttribute

Public Sub SetCustomControlAttribute()

Implements WebControlLib.ICsSetCustomControlAttribute.SetCustomControlAttribute

概要属性設定処理を行う

説明 M_ROLE テーブルを読んでコントロールの不可視または非活性の設定を行う


戻り値無し

使用例 BasePage から呼び出されるものであり、直接使用しない

5555---- 5 5 5 5 使用方法使用方法使用方法使用方法

使用方法１：単一テーブルからの値の取得(プロパティ[SourceTable]を使用)

サンプル：

<uc1:GetCodeNameCtrl ID="GetCodeNameCtrl2" runat="server" Master="PORT"

CodeWidth="55" NameWidth="120" CodeRequired="True" TitleLabel="港"

SourceTable="M_PORT" DataCodeField="PORT_CD" DataNameField="PORT_NM"

DataKanaNameField="PORT_K_NM"

OptDataItem1="KN_EG_CD" OptDataItem1SetControlID="txtitem1"

OptDataItem2="PORT_ADDRESS" OptDataItem2SetControlID="txtitem11" />

・上記の設定を行うと、下記のコントロールが生成される

・コントロール上の参照ボタンを、押下すると出力されるダイアログ

26

※1 プロパティで DataKanaNameField 項目に値をセットしなかった場合、抽出対象項目は「～名称」項目とな

る。

※2 デフォルト表示件数は 50件

使用方法 2：結合テーブルからの値の取得(プロパティ[OptJoinExpression]を使用)

サンプル：

<uc1:GetCodeNameCtrl ID="GetCodeNameCtrl2" runat="server" Master="PORT"

CodeWidth="55" NameWidth="120" CodeRequired="True" TitleLabel="港"

DataCodeField="MP.PORT_CD" DataNameField="MP.PORT_NM" DataKanaNameField="MP.PORT_K_NM"

OptDataItem1="MP.KN_EG_CD" OptDataItem1SetControlID="txtitem1"

OptDataItem2="MP.PORT_ADDRESS" OptDataItem2SetControlID="txtitem11"

OptDataItem3="MS.SENMEI_CD" OptDataItem3SetControlID="txtitem21"

OptDataItem4="MS.SENMEI_NM" OptDataItem4SetControlID="txtitem31"

OptDataItem5="MS.SENMEI_K_NM"OptDataItem5SetControlID="txtitem41"

OptJoinExpression="M_PORT MP Left Outer Join M_SENPAKU MS On MP.PORT_ADDRESS = MS.SENMEI_CD"

WhereExpression="MP.PORT_CD > 0" />

表示するコントロールとダイアログは、単一テーブルの時と一緒なので省略。

27

結合テーブル使用時の注意点：

取得項目名は正しく記述してください(テーブル名を修飾する等、サンプルを参照)

結合テーブルから値を取得するときは、以下のように SQL 文を生成している。

プロパティ設定時に以下を考慮して設定すること。

SELECT

DataCodeField, DataNameField,

[OptDataItem1], [OptDataItem2], [OptDataItem3], [OptDataItem4], [OptDataItem5]

FROM

OptJoinExpression

WHERE

[WhereExPression]

サンプル設定で生成される SQL 文

SELECT

MP.PORT_CD, MP.PORT_NM, MP.KN_EG_CD, MP.PORT_ADDRESS, MS.SENMEI_CD,

MS.SENMEI_NM, MS.SEMMEI_K_NM

FROM

M_PORT MP Left Outer Join M_SENPAKK MS On MP.PORT_ADDRESS = MS.SENMEI_CD

WHERE

MP.PORT_CD > 0

名称自動設定についての補足説明

入力されたコードから名称を自動取得して、名称コントロールにセットする。

処理は Web サービスを用いて処理を行っている。

Web サービス：GetNameService.asmx 内 GetNameService

サービス内メソッド

メソッド名 GetCodeName

<WebMethod(True)> _

Public Function GetCodeName(ByVal argSetCD As String, ByVal argMeCtrlName As String)

As String

概要名称を取得して返す

説明与えられたコードから名称を取得して返す

パラメータ argSetCD：入力されたコード値

argMeCtrlName：名称を取得するために必要な情報が設定されている Session 名称

28

戻り値無し

使用例サービスから使用するものなので直接使用しない。

検索処理についての補足説明

検索を行う際の入力値仕様は以下の表とする。

プロパティ入力文字カナ

カナフィールド名※設定あり

全角の場合半角の場合

漢字フィールド='%入力文字%' or

カナフィールド=半角変換('%入力文

字%')

漢字フィールド=全角変換('%入力文字%')

or

カナフィールド='%入力文字%'

カナフィールド名※設定なし漢字フィールド='%入力文字%' 漢字フィールド=全角変換('%入力文字%')

プロパティ入力文字その他

カナフィールド名※設定あり

漢字フィールド='%入力文字%'

カナフィールド名※設定なし漢字フィールド='%入力文字%'

※カナフィールド名：プロパティ[DataKanaNameField]

自動名称取得についての補足説明

入力コードはフォーカスが外れると自動で英字小文字から英字大文字に変換され、そのコードで名称を

検索する。

例：入力コード[0k87] → [0K87]と変換される。

29

６６６６．．．．パンくずリストパンくずリストパンくずリストパンくずリスト((((BreadcrumbsLBreadcrumbsLBreadcrumbsLBreadcrumbsListististist.aspx).aspx).aspx).aspx)

6666---- 1 1 1 1 概要概要概要概要

パンくずリスト機能を提供する


１パンくずリストを MasterBasePage に表示する。

6666---- 3333 プロパティ一覧プロパティ一覧プロパティ一覧プロパティ一覧


１ MenuCD String R/W 文字列カレントのページまたは

メニューの MENU_CD の設

定または値を取得する。

※1 戻るボタンでの戻り先やリンクの飛び先がメニュー画面でない場合、このプロパティに行き先ページの

メニューコードを個別設定する。当該ケースの場合、個別に設定してやらないとパンくずリストの表示が正し

く行われない。これはパンくずリスト表示時のベースとなる MENU_CD の更新はメニュー画面内で自動設定処理

を行っているが、個別のページ遷移時では更新されないため。

※1 の実装例

Protected Sub btnReturn_Click(ByVal sender As Object, ByVal e As EventArgs) Handles btnReturn.Click

'戻り先が別メニュー階層のページの場合は、そのページの MENU_CD をパンくずリストに設定する

Dim master As MasterBasePage = CType(Me.Page.Master, MasterBasePage)

master.BreadcrumbsListObj.MenuCD = "40B"

'個別ページに戻る

Response.Redirect("~/X90/DouseiMain.aspx")

End Sub

30

※1 の場合の図(実装が無い場合) 戻り先が個別ページ

↓戻るボタン押下

前のページで表示していたものを

そのまま表示してしまう。

31

※1 の場合の図(実装を行った場合) 戻り先が個別ページ


戻り先の個別ページの、パン

くずリストを再生成して表示

を行う

32

※2 の場合の図戻り先がメニューページ


メニューページ側で、パンく

ずリストの再生成を行う。

実装の変更は必要ない。

33


6666---- 4444---- 1111 BreadcrumbsList_HideBreadcrumbsList_HideBreadcrumbsList_HideBreadcrumbsList_Hide

メソッド名 BreadcrumbsList_Hide

Public Sub BreadcrumbsList_Hide ()

概要パンくずリストの非表示

説明パンくずリストを非表示にする

※MasterBase.vb でしか使用しない


戻り値無し

使用例 baseMaster.BreadcrumbsListObj.BreadcrumbsList_Hide()

6666---- 4444---- 2222 BreadcrumbsList_ShowBreadcrumbsList_ShowBreadcrumbsList_ShowBreadcrumbsList_Show

メソッド名 BreadcrumbsList_Show

Public Sub BreadcrumbsList_Show ()

概要パンくずリストの表示

説明パンくずリストを表示する

※MasterBase.vb でしか使用しない


戻り値無し

使用例 baseMaster.BreadcrumbsListObj.BreadcrumbsList_Show()

6666---- 4444---- 3333 CreateBreadcrumbsListCreateBreadcrumbsListCreateBreadcrumbsListCreateBreadcrumbsList

メソッド名 CreateBreadcrumbsList

Private Sub CreateBreadcrumbsList(ByVal parent As String)

概要パンくずリストの生成

説明パンくずリストを生成する

※当クラス内でしか使用しない


戻り値無し

使用例 CreateBreadcrumbsList(CommonPrc.IsNullCnv(Session("BreadcrumbsList.MenuCD"), ""))

34


色つきの文字はリンク

35

７７７７．．．．メニューツリーメニューツリーメニューツリーメニューツリー(MenuTree.ascx)(MenuTree.ascx)(MenuTree.ascx)(MenuTree.ascx)

7777---- 1 1 1 1 概要概要概要概要

メニュー(M_MENU)の一覧を表示する機能を提供する。


１ TreeView にメニュー(M_MENU)の一覧を表示する。



１ SelectedMenu String R/W 文字列選択されたメニュー情報

※1

２ UseJavaScript Boolean R/W True 選択したメニューの URL

を返すJavaScriptを使用

する

False 表示のみを行う

３ MenuCategory String R/W 文字列 M_KUBUN の

KBNCATID=10105 の設定値

に対応して振り分ける

※1:以下の形式でプロパティに情報が格納されている。

「M_MENU.MENU_CD | M_MENU.PARENTMENU_CD | M_MENU.MENU_KB | M_MENU.LINK_PARENT_MENU_CD」

「“|”(パイプ文字)」で情報が区切られている。


7777---- 4444---- 1111 ReDisplayReDisplayReDisplayReDisplay

メソッド名 ReDisplay

Public Sub ReDisplay()

概要ツリーの再表示を行う

説明ツリーの再表示を行う(開閉状態の再設定も行う)


戻り値無し

使用例 Me.MenuTree1.ReDisplay()

7777---- 4444---- 2222 OpenTreeAllOpenTreeAllOpenTreeAllOpenTreeAll

メソッド名 OpenTreeAll

Public Sub OpenTreeAll()

概要ツリーの展開を行う

説明ツリーの全ノードの展開を行う


36

戻り値無し

使用例 MenuTree1.OpenTreeAll()

7777---- 4444---- 3333 CloseTreeAllCloseTreeAllCloseTreeAllCloseTreeAll

メソッド名 CloseTreeAll

Public Sub CloseTreeAll ()

概要ツリーを閉じる

説明ツリーの全ノードを閉じる


戻り値無し

使用例 MenuTree1. CloseTreeAll()

7777---- 5555 補足説明補足説明補足説明補足説明

メニューツリーを使用したい画面でメニュー選択イベントの登録を行う。

登録方法

①Init 内で AddHandler を用いてイベントを追加する。

Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Init

AddHandler Me.MenuTree1.TreeView_SelectedNodeChanged, AddressOf TreeView_SelectedNodeChanged

End Sub

②実際に①で追加したイベントを定義する

Protected Sub TreeView_SelectedNodeChanged(ByVal sender As Object, ByVal e As System.EventArgs)

'選択したメニューの情報取得方法は以下

Dim selectItem As String = Me.MenuTree1.SelectedMenu

あとは個別処理を記述する。

End Sub

37


８８８８．．．．ページツリーページツリーページツリーページツリー(PageTree.ascx)(PageTree.ascx)(PageTree.ascx)(PageTree.ascx)

8888---- 1 1 1 1 概要概要概要概要

ページ(aspx ファイル)の一覧を表示する機能を提供する。


１ TreeView に業務ページ(aspx ファイル)の一覧を表示する



１ SelectedPage String R/W 文字列選択されたページファイ

ル名称(XXXX.aspx)

２ UseJavaScript Boolean R/W True 選択したページの URL を

返すJavaScriptを使用す

る

False 表示のみを行う


無し

8888---- 5555 補足説明補足説明補足説明補足説明

メニューツリーを使用したい画面でメニュー選択イベントの登録を行う。

登録方法

①Init 内で AddHandler を用いてイベントを追加する。

Protected Sub Page_Init(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Init

AddHandler Me.PageTree1.TreeView_SelectedNodeChanged, AddressOf TreeView_SelectedNodeChanged

38

End Sub

②実際に①で追加したイベントを定義する

Protected Sub TreeView_SelectedNodeChanged(ByVal sender As Object, ByVal e As System.EventArgs)

'選択したページの情報取得方法は以下

Dim selectPage As String = Me.PageTree1.SelectedPage

あとは個別処理を記述する。

End Sub

39


40

９９９９．．．．プログレスカーソルプログレスカーソルプログレスカーソルプログレスカーソル(ProgressCursor.ascx)(ProgressCursor.ascx)(ProgressCursor.ascx)(ProgressCursor.ascx)

9999---- 1 1 1 1 概要概要概要概要

プログレスカーソル機能を提供する。


１指定された UpdatePanel 内の処理中に画面にプログレスカーソルを表示する



１ TargetUpdatePanel String R/W 文字列対象となる UpdatePanel

の ID

使用条件

① プログレスカーソルを使用したいイベントを持つコントロールに UpdatePanel を使用する

設定例：

<asp:UpdatePanel ID="UpdatePanel2UpdatePanel2UpdatePanel2UpdatePanel2" runat="server" UpdateMode="Conditional">

<ContentTemplate>

<uc1:PageTree ID="PageTree1" runat="server" />

</ContentTemplate>

</asp:UpdatePanel>

② ①で設定した UpdatePanel の ID を ProgressCursor のプロパティ TargetUpdatePanel に設定する

設定例：

<uc2:ProgressCursor ID="ProgressCursor1" runat="server" TargetUpdatePanel="UpdatePanel2UpdatePanel2UpdatePanel2UpdatePanel2" />

9999---- 4444 使用上の注意使用上の注意使用上の注意使用上の注意

プログレスカーソル表示中でもボタンを押下することは可能なため、ボタンの２度押し防止を行いたい場合は

「WebUI パッケージクラス仕様」の「ボタンコントロール」のプロパティ「DoubleClickCheck」を使用する。

41


42

１０１０１０１０．．．．汎用ページ一覧汎用ページ一覧汎用ページ一覧汎用ページ一覧

No. ページファイル名ページ名説明

１ MasterMenu.aspx 汎用メニューページ M_KUBUN テーブルの内容に基づき、標準的な

メニュー画面を生成する。

２ MasterBasePage.Master マスターページシステムのベースとなるページ

３ Login.aspx ログインページシステムログイン用ページ

４ PassWordChange.aspx パスワード変更ページパスワード変更用ページ

43

１１１１１１１１．．．．汎用メニューページ汎用メニューページ汎用メニューページ汎用メニューページ((((MasterMenuMasterMenuMasterMenuMasterMenu.aspx.aspx.aspx.aspx))))

11111111---- 1 1 1 1 概要概要概要概要

メニュー画面を生成する


１メニュー画面を生成する

11111111---- 3 3 3 3 使用方法使用方法使用方法使用方法

M_MENU テーブルに必要データ（下記サンプル参照）をセットして以下のページを呼び出すとメニューが表

示される

MasterMenu.aspx?MenuID=22 ←（親メニューCD(PARENT_MENU_CD)）

例

MENU_CD PARENT_MENU_CD MENU_TITLE_NM DIRECT_URL MENU_KB KBSORT NUMBER_OF_COLUMNS

22 2 マスタ管理 S 0 3

220 22 船舶明細マスタ入力～.aspx B 1 0

221 22 精算マスタ入力略 B 2 0

222 22 標準値港間距離マスタ略 B 3 0

11111111---- 4 4 4 4 イメージ図イメージ図イメージ図イメージ図

メニューの横

方向繰り返し

数を設定

44

１１１１２２２２．．．．マスターページコントロールマスターページコントロールマスターページコントロールマスターページコントロール(MasterBasePage.Master(MasterBasePage.Master(MasterBasePage.Master(MasterBasePage.Master、、、、MasterBase.vbMasterBase.vbMasterBase.vbMasterBase.vb))))

11112222---- 1 1 1 1 概要概要概要概要

システムのベースとなるデザインと既定ページからの継承機能を提供する


１マスタ画面(MasterBasePage.Master)が提供する機能

・共通表示領域（ヘッダー部、エラーメッセージ領域）

・メッセージエリアの表示制御処理

２マスタ画面の画面定義クラス(MasterBase.vb)が提供する機能

・マスター画面の各共通コントロール（メニューバー、画面モード、更新者情報、共通ボタン等）

へのアクセサを提供

MasterBase クラス内では BasePage クラスが継承されているので、以下の機能も提供される。

・リスト系コントロールのデータバインド機能

・検証コントロール自動生成機能

・エラーチェック時の標準的な振る舞い

１．項目チェック内容に応じたエラーメッセージの編集

２．エラーコントロールの背景色設定

３．エラー発生項目の先頭へのカーソル設定

３パスワード有効期限制御機能

・パスワードの有効期限（１８０日）のチェックを行い有効期限が切れていた場合、パスワード変

更画面を強制的に表示する。※パスワード有効期限の１４日前からログイン直後にアラートメッセ

ージが表示される。

４システムメンテナンス期間制御処理機能

11112222---- 3 3 3 3 プロパティプロパティプロパティプロパティ一覧一覧一覧一覧((((マスタマスタマスタマスターーーーベースページベースページベースページベースページ))))


１ MessageArea_Visible Boolean W True/False メッセージエリアの表示非

表示を制御

(True：表示,False：非表示)

２ MessageArea_Width Integer W 数値メッセージエリアの横幅

３ MessageArea_Height Integer W 数値メッセージエリアの縦幅

４ MenuBarObj MenuBar R MenuBar オブジ

ェクト

マスターページにあるメニ

ューバーオブジェクト

45

11112222---- 4 4 4 4 プロパティプロパティプロパティプロパティ一覧一覧一覧一覧((((基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス))))


１ ShowGamenMode Boolean W True/False 画面モード、状態の表示設定

２ ShowUpdateInfo Boolean W True/False 更新者情報の表示設定

※マスタ画面の画面定義クラスを継承することで、マスタ画面コントロールにカレントページのコントロ

ールのようにアクセスが可能。

例)

Me.lblDisplayMode.Text = “XXXXXX”

Me.btnSearch.Visible = True

46

11112222---- 5 5 5 5 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明((((マスターベースページマスターベースページマスターベースページマスターベースページ))))

11112222---- 5555---- 1111 AddMessageAddMessageAddMessageAddMessage

メソッド名 AddMessage

Public Sub AddMessage(ByVal message As String)

概要メッセージエリアにメッセージを追加する

説明メッセージと改行コードを表示エリアに追加する

パラメータ message：追加メッセージ

戻り値無し

使用例 baseMaster.AddMessage("Message1")

baseMaster.AddMessage("Message2")

baseMaster.AddMessage("Message3")

11112222---- 5555---- 2222 DeleteMessageDeleteMessageDeleteMessageDeleteMessage

メソッド名 DeleteMessage

Public Sub DeleteMessage()

概要メッセージエリアのメッセージを削除する

説明メッセージエリアのメッセージを削除する


戻り値無し

使用例 baseMaster.DeleteMessage()

11112222---- 5555---- 3333 CheckOverduePasswordCheckOverduePasswordCheckOverduePasswordCheckOverduePassword

メソッド名 CheckOverduePassword

Public Sub CheckOverduePassword()

概要パスワードの有効期限切れチェック＆メッセージ表示

説明ログイン後に最初のページ表示処理で期限切れ間近の場合、警告メッセージを出力

※MasterBasePage でしか使用しない


戻り値無し

使用例 baseMaster. CheckOverduePassword ()

47

12121212---- 5555---- 4444 SystemMaintenanceTermCherckSystemMaintenanceTermCherckSystemMaintenanceTermCherckSystemMaintenanceTermCherck

メソッド名 SystemMaintenanceTermCherck

Private Sub SystemMaintenanceTermCherck ()

概要システムメンテナンス期間制御処理

説明システムメンテナンス警告期間中にアラートを表示したり、システムメンテナンス期間中は

ロール=’manager’しかログインできないように制御する

※MasterBasePage でしか使用しない


戻り値無し

使用例 SystemMaintenanceTermCherck ()

12121212---- 6666 メソッド詳細説明メソッド詳細説明メソッド詳細説明メソッド詳細説明((((基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス基底ページの派生クラス))))

11112222---- 6666---- 1111 AllHideHeaderAllHideHeaderAllHideHeaderAllHideHeader

メソッド名 AllHideHeader

Protected Sub AllHideHeader ()

概要マスターページページのログオフボタンを除くヘッダー部分を非表示にする

説明マスターページのログオフボタンを除くヘッダー部分（メニューバー、画面モード、更新者

情報）を非表示にする


戻り値無し

使用例 Me. AllHideHeader()

11112222---- 6666---- 2222 AllHideFooterBaseButtonAllHideFooterBaseButtonAllHideFooterBaseButtonAllHideFooterBaseButton

メソッド名 AllHideFooterBaseButton

Protected Sub AllHideFooterBaseButton ()

概要マスターページの基本実装ボタンを非表示にする

説明マスターページの基本実装ボタンを非表示にする


戻り値無し

使用例 Me. AllHideFooterBaseButton ()

48

11112222---- 6666---- 3333 HideMenuBarHideMenuBarHideMenuBarHideMenuBar

メソッド名 HideMenuBar

Protected Sub HideMenuBar ()

概要マスターページのメニューボタンを非表示にする

説明マスターページのメニューボタンを非表示にする(ログアウトを除く)


戻り値無し

使用例 Me. HideMenuBar ()

11112222---- 6666---- 4444 ShowMenuBarShowMenuBarShowMenuBarShowMenuBar

メソッド名 ShowMenuBar

Protected Sub ShowMenuBar ()

概要マスターページのメニューボタンを表示する

説明マスターページのメニューボタンを表示する


戻り値無し

使用例 Me. ShowMenuBar ()

11112222---- 6666---- 5555 HideHideHideHideAllAllAllAllMenuBarMenuBarMenuBarMenuBar

メソッド名 HideAllMenuBar

Protected Sub HideAllMenuBar ()

概要マスターページのメニューボタン（ログアウトボタンを含む）を全て非表示にする

説明マスターページのメニューボタン（ログアウトボタンを含む）を全て非表示にする


戻り値無し

使用例 Me. HideAllMenuBar ()

11112222---- 6666---- 6666 ShowShowShowShowMenuBarMenuBarMenuBarMenuBarExExExEx

メソッド名 ShowMenuBarEx

Protected Sub ShowMenuBarEx()

概要マスターページのメニューボタン（ログアウトボタンは非表示）を表示する

説明マスターページのメニューボタン（ログアウトボタンは非表示）を表示する


戻り値無し

使用例 Me. ShowMenuBarEx ()

49


12121212---- 7777---- 1111 パスワード有効期限パスワード有効期限パスワード有効期限パスワード有効期限制御制御制御制御

・パスワード期限切れの場合、強制的にパスワード更新画面を表示する。

※ パスワード有効期限日数（CommonConst.PASSWORD_EXPIRE_DAYS）

50

・パスワード期限切ｎ日前には、警告メッセージを表示する。

※ ｎ：警告表示日数（CommonConst.PASSWORD_EXPIRE_WARNING_START_DAYS）

12121212---- 7777---- 2222 システムメンテナンス期間制御システムメンテナンス期間制御システムメンテナンス期間制御システムメンテナンス期間制御

・システムメンテナンス期間 60 分前には警告メッセージを表示し、期間中は強制的にログイン画面を表示す

る。但し、マネージャ権限のユーザは処理続行可能。

51

１１１１３３３３．．．．ログインページログインページログインページログインページ(login.aspx)(login.aspx)(login.aspx)(login.aspx)

11113333---- 1 1 1 1 概要概要概要概要

ログイン機能を提供する


１入力されたユーザ ID とパスワードで M_USER を参照し、パスワードが適合したら次画面へ遷移する

※パスワードは SHA1 で暗号化後に照合する。

２ユーザマスターのユーザコードは半角英数大文字だが、ログイン時に大文字入力しづらい為、入力

時のユーザコードを内部的に大文字変換処理してユーザマスターと照合する。

３ログイン後は、ロール単位に設定された初期表示ページを表示する。ロール単位の初期表示ページ

が設定されていない場合、構成情報のデフォルト初期表示ページを表示する。

４ログイン時にラストログイン日付を再設定する（M_USER テーブル）

５システムメンテナンス期間はマネージャ権限のロールユーザしかログインさせない。また、システ

ムメンテナンス期間前及び期間中はアラートメッセージを表示する。

６「ID を Cookie に登録」チェックボックスにチェックをつけてログインを行うと、入力したユーザ

ID が Cookie に登録され、次回ログイン画面表示時に自動でユーザ IDが設定され、カーソルの初期

設定位置はパスワード入力欄となる。

52

13131313---- 3333 処理フロー図処理フロー図処理フロー図処理フロー図

ブラウザサーバーサイド

ページ要求

ログイン画面

表示

ユーザＩＤ＆

パスワード

入力

ログイン

画面表示

(ｴﾗｰ表示)

初期ページ

表示処理

実行ﾓｰﾄﾞ=単体試験でクエリー

ストリングでユーザ ID＆

パスワード指定あり

Yes

No

ﾒﾝﾃﾅﾝｽ期間前

ｱﾗｰﾄ表示

入力フィールド書式

チェックｴﾗｰ

ﾒﾝﾃﾅﾝｽ期間中

か？

認証ｴﾗｰ

ログインチェック処

理＆セッションにユ

ーザ情報を設定

Yes

No

Yes

Yes

No

No

53

１１１１４４４４．．．．パスワード変更ページパスワード変更ページパスワード変更ページパスワード変更ページ(PassWordChange.aspx)(PassWordChange.aspx)(PassWordChange.aspx)(PassWordChange.aspx)

11114444---- 1 1 1 1 概要概要概要概要

パスワード変更機能を提供する


１入力されたパスワードを SHA1 で暗号化して格納する

２既存パスワードとの同一チェック及び書式チェックを行う

※8桁以上 20桁未満の特定文字種の特殊記号を含む英数文字

３パスワードを変更した日付を再設定する（M_USER テーブル）

54


14141414---- 3333---- 1 1 1 1 システムメンテナンス期間直前システムメンテナンス期間直前システムメンテナンス期間直前システムメンテナンス期間直前

・警告メッセージを表示する。

14141414---- 3333---- 2 2 2 2 システムメンテナンス期間中システムメンテナンス期間中システムメンテナンス期間中システムメンテナンス期間中

・システムメンテナンス期間中はメッセージを表示し、ログインできないように制御する。但し、マネージャ

権限のユーザはログイン可能。

「業務アプリ共通部品機能」 仕様書 · 1 「業務アプリ共通部品機能」...

Documents

「業務アプリ共通部品機能」仕様書 · 1 「業務アプリ共通部品機能」...