目次モクジ タスクタイプ(概要ガイヨウ)へ タスクタイプ(一覧イチランヒョウ)へ タスクタイプベツ 設定セッテイ項目コウモク比較ヒカクヒョウ タスクタイプ共通キョウツウ
dbSheetClient ドキュメント種類シュルイ タスクタイプ仕様書シヨウショ   対応タイオウバージョン V5.4.2.2
更新日コウシンビ 2015/1/19
タスクタイプ名称メイショウ 204 検索付データ照会画面 EXCELの
同等ドウトウ機能キノウ
 
 ノウ クエリー定義で定義されたSQL文を実行し、取得したデータを検索付データ照会画面に表示します。
検索付データ照会では、複数の選択されたデータをExcelシートに展開することができます。

※受注明細テーブルから目的の受注コードに対応した受注明細を全てExcelに展開するときなどに利用できます。







@{空白クウハク
A拡張カクチョウ
使ツカ
ヨウ
ウエ

チュウ

テン
@V2では照会ショウカイ画面ガメン表示ヒョウジマエ採用サイヨウにはツネ再計算サイケイサンをおこなっていましたが、V3からは汎用ハンヨウパラメータ20の指定シテイシタガって再計算サイケイサンをおこなう/おこなわないを判断ハンダンします。
A一度イチドに照会できる最大データサイズは2GBまでです。ただし、ネットワークの回線スピードが遅い場合には、タイムオーバなどで途中でエラーになることがあります。
BV3.0.4.2 《機能追加》:タスクタイプ属性ゾクセイ を A拡張カクチョウ にすることにより検索ケンサク条件ジョウケンで「前方ゼンポウ一致イッチ」などの指定シテイができます。
CV3.0.8.0 《機能追加》:
検索ケンサク条件ジョウケンをシートジョウ展開テンカイすることができます。(なお、選択センタクした件数ケンスウについては、V2.2.1.0以降イコウ、クエリー定義テイギの「取得シュトクデータ件数ケンスウセル」にセットされます。)
DV3.0.8.1 《機能追加》:フィールド
メイ変更ヘンコウできなくする「変更ヘンコウ不可フカ」の設定セッテイ検索ケンサク条件ジョウケンのシートへの展開テンカイ、「採用サイヨウ文字モジ変更ヘンコウ可能カノウにしました
 また、
検索ケンサク結果ケッカをExcelシートジョウ展開テンカイした件数ケンスウをシートジョウ展開テンカイすることができます。
EV3.0.10.0 《機能追加》:検索条件で「前方一致」などの指定のない
従来ジュウライ画面ガメンでも、フィールドメイの「変更ヘンコウ不可フカ」を可能カノウにしました。
FV3.0.12.5 《機能追加》:汎用パラメータ19で画面上部の検索条件設定エリアを表示/非表示に設定
することができるようにしました。※非表示に設定することにより、ちょうど、203.データ照会画面で複数のデータを選択することができるようなデータ照会画面の設定が可能になります。
Gオートフィルタを設定している領域にデータを展開すると、正常にデータが展開されないことがあります。V3.0.22.0以降はタスクタイプ430.Excelコマンドに35.データ_オートフィルタ設定、36.データ_オートフィルタ解除 を追加していますので、事前にデータの展開範囲のオートフィルタを解除してください。
HV4.0.33.1《機能追加》: 汎用パラメータ15に改行表示の有り/なし の指定ができるようにした。
サダム





F.No 使用シヨウする定義テイギフィールド 必須ヒッス セル
指定シテイ
内容ナイヨウ  (青色アオイロ文字モジ選択肢センタクシ選択センタクできる文字モジアラワします) 省略ショウリャク処理ショリ 特記事項
5 タスクタイプNO   204    
6 タスクタイプ名   検索付データ照会画面    
7 タスクタイプ属性     @{空白} A拡張   ※6 V3.0.4.2以降イコウ
8 BKNO   ブックファイル定義に定義されているBKNOを選択                
9 ブック名   8のBKNOが入力されると自動表示                
10 シート名   処理対象となるシートを指定 開始時のシート名              
  重要ジュウヨウ※ 11.シート保護ホゴ有無ウム、12.シート保護ホゴPW、18.処理ショリ条件ジョウケン判定ハンテイセル、19.定義テイギ有効ユウコウ無効ムコウフラグ、22.セル指定シテイ属性ゾクセイ、57〜70の開始カイシメッセージ、エラーメッセージ、キャンセルメッセージなどは、必要ヒツヨウオウじて設定セッテイしてください。 設定セッテイ方法ホウホウは、『タスクタイプ共通』に記載キサイしています。→
また、セルメイ(アドレス)を指定シテイする設定セッテイ項目コウモク背景色ハイケイショクがピンクイロについては、セル指定シテイ属性ゾクセイが「間接カンセツ」のトキには「間接カンセツアドレス」の動作ドウサ変化ヘンカしますので注意チュウイしてください。
タスクタイプ共通キョウツウ
               
15 QNO   クエリー定義に定義されたクエリーNO を指定。 ※1 エラー ※3
16 クエリー名   15のQNOが入力されると自動表示    
17 DNO   展開テンカイ定義に定義されたDNO を指定    
             
21 画面名称   検索ケンサクデータ照会画面のタイトルを入力。 クエリー名を表示  
             
23 汎用パラメータ1 検索条件1として、区切り文字として「 | 」を使用し、フィールドメイ開始カイシ条件ジョウケン終了シュウリョウ条件ジョウケンの3項目コウモク および、フィールドメイ変更ヘンコウ不可フカ指定シテイを  フィールドメイ|開始条件|終了条件|変更ヘンコウ不可フカ の形式で指定。   ※4 区切クギ文字モジは 半角ハンカク |
※7 V3.0.10.0以降
      検索条件1として、区切り文字として「 | 」を使用し、フィールドメイ開始カイシ条件ジョウケン終了シュウリョウ条件ジョウケン検索ケンサク方式ホウシキ の4項目コウモク および、フィールド名と検索ケンサク方式ホウシキの変更不可 の指定を  フィールド|開始条件|終了条件|検索ケンサク方式ホウシキ変更ヘンコウ不可フカ の形式で指定。   ※6 タスクタイプ属性ゾクセイが「拡張カクチョウ」のとき
V3.0.4.2以降イコウ
※7 V3.0.10.0以降
24 汎用パラメータ2 検索条件2    〃    
25 汎用パラメータ3 検索条件3    〃    
26 汎用パラメータ4 検索条件4    〃    
27 汎用パラメータ5 検索条件5    〃    
28 汎用パラメータ6 検索条件6    〃    
29 汎用パラメータ7 検索条件7    〃    
30 汎用パラメータ8 検索条件8    〃    
31 汎用パラメータ9 検索条件9    〃    
32 汎用パラメータ10 検索条件10    〃    
33 汎用パラメータ11 検索条件11    〃    
34 汎用パラメータ12 検索条件12    〃    
             
35 汎用パラメータ13 照会画面の横幅を、ピクセルで指定。 580  
36 汎用パラメータ14 照会画面の縦幅を、ピクセルで指定。 500  
37 汎用パラメータ15 【最大化】 と入力すると、照会画面を最大化表示。    
        改行カイギョウなし: データ照会ショウカイ画面ガメン表示ヒョウジ改行カイギョウコードを無視ムシします。
改行カイギョウあり: データ照会ショウカイ画面ガメン表示ヒョウジ改行カイギョウコードを有効ユウコウにし、改行カイギョウ表示ヒョウジします。
最大化サイダイカ データ照会ショウカイ画面ガメン最大化サイダイカ表示ヒョウジします・
最大化サイダイカ改行カイギョウ データ照会ショウカイ画面ガメン最大化サイダイカ表示ヒョウジしたうえで、改行カイギョウコードを有効ユウコウにし、改行カイギョウ表示ヒョウジします。
  ※11 V4.0.33.1以降イコウ
38 汎用パラメータ16 【選択解除不可】 と入力すると「選択」チェックボックスが無効。    
             
39 汎用パラメータ17 検索ケンサク条件ジョウケン展開テンカイするセルメイ左上ヒダリウエ開始カイシセル)を指定シテイ 展開テンカイしない ※8 V3.0.8.0以降
             
40 汎用パラメータ18 採用サイヨウ」ボタンの表示ヒョウジ文字モジ を指定シテイ (※ OK などに変更ヘンコウすることが可能カノウ 採用サイヨウ ※9 V3.0.8.0以降
             
41 汎用パラメータ19 画面上部の検索条件設定エリアを 「表示」 / 「非表示」 にするかを指定シテイ 表示ヒョウジ ※10 V3.0.12.5以降
             
42 汎用パラメータ20 ホンタスクタイプの実行ジッコウ前後ゼンゴの 再計算サイケイサン の設定セッテイ可能カノウ 再計算サイケイサンしない ※5
        マエ再計算サイケイサン: ホンタスクタイプを実行ジッコウする直前チョクゼン再計算サイケイサン実行ジッコウ    
        アト再計算サイケイサン: ホンタスクタイプを実行ジッコウする直後チョクゴ再計算サイケイサン実行ジッコウ    
        前後ゼンゴ再計算サイケイサン: ホンタスクタイプを実行ジッコウする直前チョクゼン直後チョクゴ再計算サイケイサン実行ジッコウ    
        シートマエ再計算サイケイサン: 10.シートメイのシートのみ、ホンタスクタイプを実行ジッコウする直前チョクゼン再計算サイケイサン実行ジッコウ   V3.0.22.0以降
        シートアト再計算サイケイサン: 10.シート名のシートのみ、ホンタスクタイプを実行ジッコウする直後チョクゴ再計算サイケイサン実行ジッコウ   V3.0.22.0以降
        シート前後ゼンゴ再計算サイケイサン: 10.シート名のシートのみ、ホンタスクタイプを実行ジッコウする直前チョクゼン直後チョクゴ再計算サイケイサン実行ジッコウ   V3.0.22.0以降
             
45 空白文字処理方法   データの前後の空白文字の処理方法を指定 何もしない  
         「空白」(何もしない)、「左削除(LTRIM)」、「右削除(RTRIM)」、「左右削除(TRIM)」 のいずれかを指定  
             

トク

コト
コウ 
※1 汎用パラメータで指定されているExcelシート上のセルにデータをサイには、セルに保護がかかっているときは、11,12 の保護の解除指定が必要です。
   
※2 【セル位置(アドレス)の指定方法】
  1)アドレスはA1形式でもR1C1形式でもどちらの指定も可能です。
  2)アドレスは、A1形式、R1C1形式のいずれも、相対指定(A1、R[-1]C[1])、絶対指定($A$1、R1C1)が可能です。 
  3)シートを明示したいときにはアドレスの前に 「シート名!」 をつけて、シート名!A1、シート名!$A$1、シート名!R[-1]C[1]、シート名!R1C1 といった指定が可能です。
  4)範囲に名前が定義されているときには、定義名を指定することができます。 (→他のタスクタイプでもセル位置の指定のときは同様の指定ができます)
   
※3 データベースからデータを取得するためのSQL文やデータをEXCELシートに展開するための設定は、クエリー定義、展開定義で指定シテイします。
   
※4 絞込み検索条件はAND条件として検索します。
   
※5 ホンタスクタイプの実行ジッコウマエ実行ジッコウ再計算サイケイサン実行ジッコウしたいときに指定シテイしてください。
  アト再計算サイケイサンについては展開テンカイ定義テイギ自動ジドウ計算ケイサン方法ホウホウ再計算サイケイサンしてもオナ動作ドウサとなります。
   
※6 タスクタイプ属性「A拡張」 を指定すると、検索方式として、「範囲指定」、「前方一致」、「中間一致」、「後方一致」、「完全一致」 を定義および、画面での設定ができます。
※7 「変更不可」を設定すると、フィールドメイと検索方式ホウシキのコンボボックスを 変更不可フカ にすることができます。
   
※8 @12検索ケンサク条件ジョウケン内容ナイヨウを、指定シテイしたセルを左上ヒダリウエ開始カイシセルとして、シートジョウ展開テンカイします。
AFNO.10のシートメイとはチガうシートに展開テンカイしたいときにはカナラず、セルに名前ナマエ定義テイギして、その定義テイギメイ指定シテイする必要ヒツヨウがあります。
B展開テンカイするレツ順序ジュンジョは、NO、フィールドメイ、開始条件、終了条件、検索方式 になります。
C検索ケンサク条件ジョウケン設定セッテイされていない場合バアイでも、カナラず、12出力シュツリョクされるので、展開テンカイサキには、5レツ×12ギョウ のエリアが必要ヒツヨウになります。
   
※9 採用サイヨウボタンの表示ヒョウジ文字モジを 「採用サイヨウ」 ではなく 「OK」などの文字モジ変更ヘンコウすることができます。ボタンサイズの関係カンケイで、表示ヒョウジできる文字数モジスウは4〜5文字モジ程度テイドまでです。
   
※10 非表示ヒヒョウジ」にすると、検索ケンサク条件ジョウケン設定セッテイエリアが非表示ヒヒョウジになります。※非表示に設定すると検索ケンサク条件ジョウケン変更ヘンコウできなくなりますが、ちょうど、203.データ照会画面で複数のデータを選択することができるようなデータ照会画面の設定が可能になります。
   
※11 画面ガメン表示ヒョウジされるデータナイに、「改行コード」が含まれているデータが存在するときでも、デフォルトでは「改行カイギョウコード」を除外ジョガイして、一行イチギョウ表示ヒョウジしますが、ホン設定セッテイで、「改行あり」を選択センタクすると、「改行カイギョウ表示ヒョウジ」された状態ジョウタイ表示ヒョウジします。

なお、データの文字数が多いときには、列幅は文字数にあわせて大きく広がってしまうため、
「改行表示をおこなわないとき」には、列幅は最大200ピクセルの幅以上には広がらないようにしました。

また、301.
起動キドウモード 21.改行カイギョウ表示ヒョウジ の設定セッテイよりも、ホン設定セッテイ優先ユウセンします。
【注意】「改行あり」にするとレコード数が多い場合には、レスポンスが2倍近く遅くなります。
   
クエリー定義テイギシートで定義テイギするフィールド  
サダム





F.No 使用シヨウする定義テイギフィールド 必須ヒッス セル
指定シテイ
内容ナイヨウ  【 】ナイ文字モジ動作ドウサ制御セイギョ文字モジアラワ 空白クウハク処理ショリ 特記事項
1 QNO   クエリー管理番号 エラー  
2 クエリー名   クエリーの名称が自動ジドウ表示ヒョウジ    
3 クエリータイプ   クエリータイプを指定。  照会 が自動表示。    
4 クエリー属性   Query が自動設定。    
             
5 DBNO   DB運用定義で登録したDBNOを指定シテイ。     
6 エイリアス名   DBNOによりエイリアス名(データベースの参照名)を表示。    
             
8 BKNO   ブック運用定義のBKNOを選択もしくは入力。    
9 ブック名   BKNOによりブック名を表示。    
             
10 取得データ件数セル   検索ケンサクデータ照会ショウカイ画面ガメンから、最終的サイシュウテキ選択センタクしたデータ件数を展開テンカイするセルを指定。    
        展開テンカイするシートメイがタスク定義テイギ定義テイギされているシートメイチガ場合バアイには、名前ナマエ定義テイギする必要ヒツヨウがあります。
 また、シート保護ホゴパスワードは、タスク定義テイギ定義テイギされているパスワードが使用シヨウされるので注意チュウイしてください。
   
11 SQL文   SQL文を指定。※データベースシステム(MSSQLやORACLEなど)に対応したSQL文を入力。   ※1
           SELECT文でのデータ取得のみが実行可能    
             
12 排他制御タイプ   同時ドウジ実行ジッコウ制御セイギョ方式ホウシキ選択センタク可能カノウ 楽観ラッカンロック ※2
        1:{空白}、2:楽観ロック → 取得シュトクしたサーバガワのレコードの DBS_STATUSフィールドは 1 のままにしておく。    
          ※サーバガワのデータ更新時には、楽観ロック制御で更新をおこなう。    
        3:悲観ロック →  取得したサーバガワのレコードの DBS_STATUSフィールドは  変更ヘンコウし、レコードロックをけます。   排他ハイタ制御セイギョモード
          ※他ユーザはサーバガワのDBS_STATUSフィールドが3のデータについては照会ショウカイはおこなえるが、書込はできない。    
        4:悲観ロック解除カイジョ →  取得したサーバガワのレコードの DBS_STATUSフィールドを  に変更ヘンコウし、レコードロックを解除します。    
             

トク

コト
コウ 
※1 データベースシステム(MSSQLやORACLEなど)に対応したSQL文を入力してください。
※2 排他ハイタ制御セイギョタイプは、タスクタイプ属性が @照会 のときと、CSQL更新のとき のみ有効ユウコウです。
  悲観ヒカンロックがけられたレコードについては、悲観ヒカンロックをけたユーザが更新コウシン完了カンリョウするか、悲観ヒカンロック解除カイジョ実行ジッコウするまで、レコードロックがかかったままになります。
  参考サンコウ悲観ヒカンロックがけられたレコードについては、レコードロックの解除カイジョ指定シテイされなかった場合バアイには、@悲観ロックを掛けたユーザが実行を終了してログイン画面に戻ったとき、A3時間経過したのちオナじレコードが参照サンショウされたとき、には自動的ジドウテキ解除カイジョされます。
   
展開テンカイ定義テイギシートで定義テイギするフィールド                                                                                                  
                                                                                                 
サダム





F.No 使用シヨウする定義テイギフィールド 必須ヒッス セル
指定シテイ
内容ナイヨウ  【 】ナイ文字モジ動作ドウサ制御セイギョ文字モジアラワ 空白クウハク処理ショリ 特記事項
2 DNO   展開テンカイ管理カンリ番号バンゴウ入力ニュウリョクする。タスク定義テイギの17.DNOから参照サンショウ エラー  
3 データ展開名   DNOが入力ニュウリョクされると自動ジドウ表示ヒョウジされる。展開テンカイ定義テイギ名称メイショウ    
4 処理順NO   複数フクスウ数式スウシキorアタイ展開テンカイしたいときには、展開テンカイ定義テイギナイ処理ショリジュンNOを入力ニュウリョク    
5 定義区分   クエリー定義テイギ自動ジドウ表示ヒョウジ    
6 タイプ   クエリータイプメイ照会ショウカイ)が自動ジドウ表示ヒョウジ    
7 タスク・展開属性   1:Query、2:データ、3:数式スウシキ、4:アタイ、5:全選択ゼンセンタクデータ一括イッカツ からExcelシートへの展開テンカイ方式ホウシキ選択センタク Query ※1
        1:Query → 取得シュトクしたゼンデータを14.セル範囲ハンイ基点キテンとしてExcelシートジョウ展開テンカイする。(5:全選択データ一括と同等ドウトウ    
        2:データ → 「8.データ項目コウモクメイ」で指定シテイしたフィールドのデータを、14.セル範囲ハンイ のセルに展開テンカイ    
        3:数式スウシキ → 「9.数式スウシキORアタイ」に指定シテイした数式スウシキを、14.セル範囲ハンイ  のセルに展開テンカイ    
        4:アタイ → 「9.数式OR値」に指定したアタイを、14.セル範囲  のセルに展開。    
        5:全選択ゼンセンタクデータ一括イッカツ → 取得した全データを14.セル範囲を基点としてExcelシート上に展開。
  
※展開前に、展開テンカイサキ範囲ハンイ(15.セル展開範囲定義名の範囲)をクリア
  ※4
        6:全選択ゼンセンタクデータ一括イッカツ保持ホジ → 取得した全データを14.セル範囲を基点としてExcelシート上に展開。
  
※展開前に、展開先の範囲(15.セル展開範囲定義名の範囲)はクリアしないでアタイ保持ホジ
   
8 データ項目名   Excelジョウ展開テンカイしたいデータベースのテーブルのフィールドメイ直接チョクセツ指定シテイ
   ※タスク・展開属性が「2:データ」のときに有効ユウコウ
  ※2
        全選択ゼンセンタクデータ一括イッカツトキには、取得シュトクしたデータのゼンフィールドを展開テンカイ    
             
9 数式OR値   Excelシートジョウ展開テンカイしたい 数式スウシキ or アタイ 指定シテイする。タスク・展開属性が「3:数式」「4:値」のときに有効ユウコウ   ※3
             
12 シート名   取得シュトクしたデータや数式スウシキorアタイ展開テンカイするシートを指定。 タスク定義テイギのシート  
13 セル指定属性   14.セル範囲ハンイの設定の仕方を、「直接」、「間接」、「間接アドレス」 から指定。    
14 セル範囲 データや数式スウシキorアタイ展開テンカイするセル(または開始カイシセル)のアドレスを指定シテイ 処理ショリしない  
15 セル展開範囲定義名   データを展開テンカイした範囲ハンイ定義テイギする名前ナマエ指定シテイする。タスク・展開属性が「1:Query」と「5:全選択データ一括」のときに有効ユウコウ dbS_{シートメイ ※4
        ※なるべく省略ショウリャクしないで、かりやすい名称メイショウ設定セッテイしてください。    
             
18 自動計算方法   処理ショリ直前チョクゼン直後チョクゴ再計算サイケイサン実行ジッコウしたいときにはマエ再計算サイケイサンアト再計算サイケイサン前後ゼンゴ再計算サイケイサン指定シテイ 実行ジッコウしない  
        マエ再計算サイケイサン: データを展開テンカイする直前チョクゼン再計算サイケイサン実行ジッコウ    
        アト再計算サイケイサン: データを展開テンカイする直後チョクゴ再計算サイケイサン実行ジッコウ    
        前後ゼンゴ再計算サイケイサン: データを展開テンカイする直前チョクゼン直後チョクゴ再計算サイケイサン実行ジッコウ    
        シートマエ再計算サイケイサン: 12.シートメイのシートのみ、ホンタスクタイプを実行ジッコウする直前チョクゼン再計算サイケイサン実行ジッコウ   V3.0.22.0以降
        シートアト再計算サイケイサン: 12.シート名のシートのみ、ホンタスクタイプを実行ジッコウする直後チョクゴ再計算サイケイサン実行ジッコウ   V3.0.22.0以降
        シート前後ゼンゴ再計算サイケイサン: 12.シート名のシートのみ、ホンタスクタイプを実行ジッコウする直前チョクゼン直後チョクゴ再計算サイケイサン実行ジッコウ   V3.0.22.0以降
19 行列方向   取得シュトクしたデータを展開テンカイする方向ホウコウとして ギョウ or レツ 指定シテイする。タスク・展開属性が「1:Query」と「5:全選択データ一括」のときに有効 ギョウ  
        ギョウ: 取得シュトクしたレコードをそのまま、ギョウ方向ホウコウ展開テンカイ    
        レツ: 「取得シュトクしたレコードをレツ方向ホウコウ変換ヘンカンして展開テンカイする。1ギョウのレコードをタテ展開テンカイしたいときに利用リヨウ    

トク

コト
コウ 
※1 タスク・展開テンカイ属性ゾクセイ にオウじて、定義テイギフィールドに設定セッテイする項目コウモク設定セッテイ方法ホウホウわりますので注意チュウイしてください。
※2 テーブルのフィールドメイは、「F4」キーをすと選択センタクされているテーブルメイオウじてテーブルのフィールドメイ選択センタクできます。
※3 数式を展開するときには、通常の数式と同じように = からはじめてください。
※4 省略ショウリャクしたときには、自動的ジドウテキに、dbS_{シートメイ}が範囲ハンイ定義テイギメイとして設定セッテイされますが、のクエリー定義テイギで、オナじ、シートにデータを展開テンカイすると、定義テイギメイ範囲ハンイわってしまうので注意チュウイしてください。
  また、「5.全選択データ一括」で展開するときには、最初に展開範囲の内容を自動的にクリアします。これは、前回の照会で100行のデータを展開していたところに、こんどはデータ件数が10行だけの時には、以前のデータがそのまま残ってしまうためです。クリアしたくないときには、「6.全選択データ一括保持」を指定してください。