MZ Platform工程管理作成チュートリアルⅡ

1.この章での完成画面

1. プロジェクト表（projectテーブルからの検索結果）
　
1. 「データベースに接続」ボタンを押すと、受注番号列に選択リストが設定され、受注番号を選択で きるようになります。
2. 受注番号を選択すると、その番号の品名と納期が表示されます。
2. 工程表（taskテーブルからの検索結果）
プロジェクト表で受注番号が選択されたことをきっかけに、その受注番 号を持つ工程データを検索して表示されます。

１.projectテーブル表示機能の作成

1. 複合コンポーネント内に以下のコンポーネントを追加し、コンポーネントキーを変更します。

コンポーネント名	必要数	カテゴリー	コンポーネントキー
テーブル格納変数	２	処理部品＞変数	プロジェクト検索 プロジェクト作業用
リスト格納変数	１	処理部品＞変数	受注番号リスト

1. メソッドを公開する
複合コンポーネント内部で以下のメソッドを公開します。
上位の階層で検索した結果を変数に設定できるようにします。


コンポーネント	メソッド	変更メソッド名
テーブル格納変数（プロジェクト検索）	テーブルを設定する(PFObjectTable)	プロジェクトテーブルを設定する

2. 上位の階層の処理を変更する
チュートリアル１で作成した上位階層の接続を変更します。
1. 【上位接続1-1】変更なし。
   
2. 【上位接続1-2】データベースのprojectテーブルの検索を実行します。
   SQL文を「select label, product, delivery from project」に変更します。
   
3. 【上位接続1-5】検索結果を取得し、複合コンポーネント内の変数に設定します。
   
4. 【上位接続1-3】と【上位接続1-4】は不要なので削除します。
［編集画面図1］ ※右側の接続先コンポーネントをクリックすると、起動メソッド情報の画像が表示されます。
起動メ ソッド情報設定画面図を下に表示

3. project検索結果が設定されたら、テーブル表示の準備をする
［GUI複合コンポーネント（テーブル表示部）］内に入ります。
変数にデータが設定され、データ設定イベントが発生するのをきっかけに処理を設定します。
1. 【接続1-1】変数に設定された検索結果を作業用テーブル格納変数に設定します。
   ※変数からデータを取得して、別の変数に設定した場合、一方の変数のデータを変更するともう一方の変数も変更される場合があります。
   データ取得にメソッド「テーブルの完全な複製を作成する（PFObjectTable）」を使うと、変数同士でデータの変更の影響を 受けません。
2. 【接続1-2】［テーブル（プロジェクト）］の 全行を削除します。
   列名の部分だけ残し、新しい行を追加できるように、一旦全行削除します。
3. 【接続1-3】［テーブル（プロジェクト）］に行を追加します。
   新規に空白行を一行追加します。
［編集画面図2］ 起動メソッド情報設定画面図を下に表示

4. projectテーブル受注番号選択機能の作成
1. 【接続1-4】［テーブル格納変数（プロジェクト作業用）］から受注番号列のデータを取得します。
   取得したデータはリスト形式になります。
2. 【接続1-5】 取得した列データを［リスト格納変数］に設定します。
   後の処理でも使用するので、一旦変数に設定します。
3. 【接続1-6】工程テーブルの受注番号列に選択項目としてリストデータを設定します。
   リスト格納変数からソートしたデータを取得しています。
4. 【接続1-7】行高さを調整します。
5. 【接続1-8】工程テーブルを全行削除します。
   データベースに接続したタイミングで表示更新するよう、工程テーブルの行を削除します。
   
確認　ここまでの処理で列データリストが選択できるようになり ます。
まだプロジェクトデータは表示されません。
［編集画面図3］ 起動メソッド情報設定画面図を下に表示

1.列リスト選択によるデータ表示機能

1. 複合コンポーネント内に以下のコンポーネントを追加し、コンポーネントキーを変更します。

コンポーネント名	必要数	カテゴリー	コンポーネントキー
文字格納変数	１	処理部品＞変数	更新文字列
等価演算（＝）	１	処理部品＞条件制御	列位置判定

1. テーブルの更新文字列を変数に格納する
テーブルの更新イベントはセル以外の更新、行や列の削除、追加でも発生します。
「セルの値が更新されたとき」のみ処理が行われるように「イベント番 号：0」を設定します。
1. 【接続2-1】更新されたセルの文字列を変数に格納します。
   受注番号を記憶するために、テーブルのセルデータが変更されたら、そのデータの文字列を変数に格納します。
2. 更新列が0列目（受注番号列）かどうか判定する。
1. 【接続2-2】テーブルの更新列番号が０かどうか演算します。
   【接続2-1】の時点では受注番号列以外の更新データも変数に格納されています。
   受注番号列が更新されたときのみ次の処理が行われるように、［等価演算（＝）］を使って列位置が「０」かどうか演算を行います。
［編集画面図4］ 起動メソッド情報設定画面図を下に表示

3. 更新列が０番目の場合、選択された受注番号の行データを表示する。
［等価演算（＝）］の処理完了のイベント番号「true：１」「false：０」により、次に行う処理を場合分けすることができます。
演算結果が「true」（＝0列目が更新された）のとき行われるよう、以下の処理にはイベント番号１を設定します 。
［Shift］キーを押しながら、接続先を選択するとイベント番号を一度に設定できます。


［選択された受注番号に該当するデータを取得の考え方］



1. 【接続3-1】選択された受注番号のリスト内での位置を取得します
   メソッド「indexOf(Object)」で、引数に指定された要素の［リスト格納変数（受注番号）］内での位置番号を取得することが で きます。
   
2. 【接続3-2】選択された受注番号の行データを取得します。
   【接続3-1】で取得した位置番号で行を指定して、［テーブル格納変数（プロジェクト作業用）］から該当の受注データを取得します。
   取得した行データはリスト形式になります。
3. 【接続3-3】取得した行データをプロジェクトテーブルに設定します。
   リスト形式の行データをプロジェクトテーブルの0行目に設定します。
   
確認ここまで設定すると、選択された受注番号のプロジェクトデータが表示さ れます。
［編集画面図5］ 起動メソッド情報設定画面図を下に表示

close

2.検索機能の作成

コンポーネント追加

1. 複合コンポーネント内に以下の必要なコンポーネントを追加し、コンポーネントキーを変更します。

コンポーネント名	必要数	カテゴリー	コンポーネントキー
サブルーチン	1	処理部品＞サブルーチン	工程検索
文字列格納変数	１	処理部品＞変数	工程SQL
イベント生成	１	処理部品＞イベント	工程検索

1. サブルーチンの処理を呼び出す
1. 【接続3-4】［サブルーチン］に繋がるSQL文置換えの処理を呼び出します。
   接続元コンポーネントは［等価演算（＝）（列位置判定）］です。
   イベント番号：１（演算結果が「true」のとき＝受注番号列が更新されたとき）を設定します。
2. 検索文字列を置き換える
   
   1. 【接続4-1】文字列格納変数にSQL雛形を設定する。
      SQL文の雛形「select id,process,workingTime,dateStart, dateEnd,isCompleted from task where projectLabel='RABERU' 」を変数に設定します。
   2. 【接続4-2】雛形の文字列を置き換えます。
      「RABERU」の部分を［文字列格納変数（更新文字列）］内の受注番号と置き換えます。
      例えば『select id,process,workingTime,dateStart, dateEnd,isCompleted from task where projectLabel=’A03'』といった文字列になります。
      プロジェクトテーブルで選択した受注番号のデータをtaskテーブルから検索するSQL文です。
3. イベントを発生させる
1. 【接続4-3】文字列格納変数内の文字列を引数として処理要求イベントを発生させます。
   SQL文を他の階層に伝えるために、イベントを発生させます。
   引数０に文字列格納変数の文字列を設定します。
   引数1（イベント番号）に「1」を設定します。
4. イベントを伝播させる
1. 【接続5-1】イベントを伝播させます。
   複合コンポーネントを接続先として発生させたイベントを伝播します。
   イベントに内包されるデータは【接続4-3】で設定した内容となります。
   工程検索のSQL文がイベント番号１で伝播されます。
［編集画面図6］ 【接続3-4】の接続元コンポーネントは［等価演算（＝）（列位置判定）］です。
起動メ ソッド情報設定画面図を下に表示

3.上位階層での検索結果をテーブルに設定する

1. 複合コンポーネント内に以下のコンポーネントを追加し、コンポーネントキーを変更します。

コンポーネント名	必要数	カテゴリー	コンポーネントキー
テーブル格納変数	２	処理部品＞変数	工程 工程作業用

タスクテーブルを検索したデータをテーブルに設定します。
先に複合コンポーネント内部の処理を作成します。
1. テーブルにデータを設定する準備
1. 【接続6-1】作業用テーブル格納変数にテーブルデータを設定します。
   上位階層でデータベース検索したtaskテーブルの検索結果が［テーブル格納変数（工程）］に設定されたら作業用のテーブル格納変数 にデータ設定します。
2. 【接続6-2】0行目（id列）の列を削除します。
   データベースのtaskテーブルからid列も検索していますが、表示は不要なので、id列はテーブルデータから削除します。
3. 【接続6-3】工程テーブルの全行を削除します。
   テーブルデータを設定する前に、一旦全行削除します。
2. テーブルにデータを設定する
1. 【接続6-4】テーブルにテーブルデータを追加します。
   行データとして変数内のテーブルデータを追加します。
2. 【接続6-5】テーブルの行の高さを変更します。
   見やすいようにテーブル行高さを調整します。
［編集画面図7］ 起動メソッド情報設定画面図を下に表示

3. メソッドを公開する
複合コンポーネント内の以下のメソッドを公開します。
次の４．での検索結果を複合コンポーネント内に設定できるようにします。

コンポーネント	メソッド	変更メソッド名
テーブル格納変数（工程）	テーブルを設定する(PFObjectTable)	工程テーブルを設定する

4. 上位階層でタスクテーブルを検索し、結果を取得する
   上位の階層に移動し、データベースの検索結果をテーブルに設定します。
   検索SQLは処理要求イベントに内包データとして含まれています。
   （既に作成した処理をコピーして使うと簡単です。引数や接続先は変更が必要です。）
1. 上位階層【接続4-1】データベースに接続します。
2. 上位階層【接続4-2】検索SQLを実行します。
   引数はイベント内包の処理要求データです。
3. 上位階層【検索4-3］検索結果を複合コンポ―ネントに設定します。
   取得方法：メソッド処理結果でテーブルデータを取得します。
4. 上位階層【検索4-4】データベースから切断します。
接続処理設定 ここまで設定すると、［テーブル（プロジェクト）］で受注 番号を選択すると［テーブル（工程）］に工程データが表示されます。
［編集画面図8］ 起動メソッド情報設定画面図を下に表示

1. 複合コンポーネント内に以下の必要なコンポーネントを追加し、コンポーネントキーを変更します。

コンポーネント名	必要数	カテゴリー	コンポーネントキー
サブルーチン	1	処理部品＞サブルーチン	終了処理

1. テーブル行を削除する
1. 【接続7-1】プロジェクトテーブルの全行を削除する
2. 【接続6-2】工程テーブルの全行を削除する
［編集画面図9］ 起動メソッド情報設定画面図を下に表示

2. メソッドを公開する
   以下のメソッドを公開します。
   

   コンポーネント	メソッド	変更メソッド名
   サブルーチン（終了処理）	処理を呼び出す（）	終了処理を呼び出す

3. アプリケーション終了時に終了処理を行う
上位階層に戻り、アプリケーション終了イベントの「全行を削除する()」の代わりに、サブルーチンの終了処理を繋げ ます。

1. 【接続3-4】終了処理を行う
［編集画面図10］ 接続元イベントはアプリケーション終了イベントです。
起 動メ ソッド情報設定画面図を下に表示

1.この章での完成画面

1. 項目・系列選択コンボボックス　
   「ガントチャート表示」ボタンを押すと有効になり、この［コンボボックス］が選択されたのをきっかけに、taskテーブルから工程データを検 索します。
   選択を変更すると、［ガントチャート］に表示される項目と系列が入れ変わり、「プロジェクト」を項目とするグラフと「工程」を項目とするグラ フの2通りで表示されます。
2. 期間選択コンボボックス　
   選択することで、3日から3か月まで表示期間を変更して表示できるようにします。
3. ガントチャート
　チュートリアル１から大きく変更はありません。
　工程テーブル表示とは別個にデータを検索してtaskテーブル内のデータをグラフ表示しています。

２.ガントチャート表示サブルーチンの作成

1. GUI複合コンポーネント内に以下のコンポーネントを追加し、コンポーネントキーを変更します。

コンポーネント名	必要数	カテゴリー	コンポーネントキー
テーブル格納変数	2	処理部品＞変数	検索結果 ガントチャート用データ
イベント生成	１	処理部品＞イベント	項目選択
サブルーチン	１	処理部品＞サブルーチン	ガントチャートデータ設定
グラフデータ作成複合コンポーネント	１	複合コンポーネント追加＞グラフ

1. コンボボックスを有効にする
［テーブル格納変数（検索結果）］にデータが設定されたタイミングで処理を行います。
1. 【接続1-1】コンボボックスを有効にします。
   ［コンボボックス（項目選択）］はアプリケーション終了時には無効にし、「ガントチャート表示」ボタンが押され、複合コンポ―ネント 内に 工程データが設定された後には有効にするようにします。
2. 【接続1-2】コンボボックスの要素を選択します
   後の処理でコンボボックスのデータ選択イベントにガントチャート表示の処理を繋げます。
   まずは位置番号０の要素を選択し、データ選択イベントが発生するようにします。
［編集画面図11］ 起動メソッド情報設定画面図を下に表示

2. コンボボックスの選択位置により、作成するガントチャートデータを選択する
［コンボボックス］の選択位置により項目と系列を替えたガントチャートデータを作成するために、［イベント生成］コンポーネントを使ってアク ショ ンイベントを発生させ、イベント番号により行う処理を選択します。

1. 【接続2-1】コンボボックスの要素の選択位置を取得して、アクションイベントを発生させます。
   引数にコンボボックスの選択位置を設定します。
   この引数が、アクションイベントの内包するイベント番号になります。
2. 【接続2-2】ガントチャートへデータ設定する処理を呼び出します。
   （このサブルーチンの接続先処理は【接続４】で設定します）
3. ガントチャート用データの作成
1. 【接続3-1】ガントチャート用のデータを作成します。
   項目（引数１）に「projectLabel」列、系列（引数２）に「process」列を指定します。
   イベント番号：0（コンボボックスの0番目の要素が選択されたとき）を設定します。
2. 【接続3-2】タスク名データを作成します。
   タスク名に「process」列を指定します。
   イベント番号：0を設定します。
3. 【接続3-3】ガントチャート用のデータを作成します。
   項目（引数１）に「process」列、系列（引数２）に「projectLabel」列を指定します。
   イベント番号：1（コンボボックスの1番目の要素が選択されたとき）を設定します。
4. 【接続3-4】タスク名データを作成します。
   タスク名に「projectLabel」列を指定します。
   イベント番号：1を設定します。
5. 【接続3-5】ガントチャート用データを格納します。
   後で使うので、変数に設定しておきます。
   イベント番号設定の必要はありません。
［編集画面図12］ 起動メソッド情報設定画面図を下に表示

4. ガントチャートデータ設定
ガントチャートデータ、タスク名、系列色を設定します。
また、表示項目数をデータに合わせて自動的に変更するようにします。

1. 【接続4-1】ガントチャート用データをガントチャートに設定します。
2. 【接続4-2】タスク名を設定します
3. 【接続4-3】系列色リストを設定します。
4. 【接続4-4】表示項目数を設定します。
   ガントチャート用テーブルデータの行数が項目数となります。
［編集画面図13］ 起動メソッド情報設定画面図を下に表示

5. メソッドを公開する
複合コンポーネント内の以下のメソッドを公開します。
上位階層での検索結果を複合コンポーネント内に設定できるようにします。

コンポーネント	メソッド
テーブル格納変数（検索結果）	テーブルを設定する(PFObjectTable)

6. 上位階層での検索処理の作成
上位階層【接続4】の処理がDB接続→検索→結果設定→切断と同じ流れなので、コピーして利用することにします。
1. 上位階層に戻り、［ボタン（ガントチャート表示）］のアクションイベントの接続処理を変更します。
   アクションイベントの接続処理を全て選択して右クリック＞［削除］します。
   ［テーブル表示部］複合コンポーネントの処理完了イベント赤丸上で右クリック＞［コピー］で、【接続4】の接続処理を全てコ ピーします。
   コピーした処理を［ボタン（ガントチャート表示）］のアクションイベントの上で右クリック＞［貼り付け］で貼り付けます。
2. 【接続5-1】データベースに接続する
3. 【接続5-2】メソッド「検索SQLを実行する（Object）」の引数を「select id, dateStart, dateEnd, projectLabel, process from task」に変更します。
4. 【接続5-3】接続先コンポーネントを変更します。
   接続先［テーブル表示部］GUI複合コンポーネントを右クリックし、［接続コンポーネント選択］で「ガント チャート表示部」複合コンポー ネントを選びます。
   メソッド「テーブルを設定する（Object)」と引数（取得方法：メソッド処理結果、メソッド／値：検索SQLを実行する）を設定しま す。
5. 【接続5-4】データベースとの接続を切断する


確認 ここまで進めると、「ガントチャート表示」ボタンを押すとガント チャートが表示されます。
［編集画面図14］ 起動メソッド情報設定画面図を下に表示

３.期間コンボボックスの選択による表示変更

［イベント生成］を使用し、［コンボボックス］の選択位置をイベント番号としてイベントを発生させることにより、イベント番号による条件分 けが 可能になります。
期間に合わせて、大目盛間隔、小目盛間隔を調整します。

1. GUI複合コンポーネント内に以下のコンポーネントを追加し、コンポーネントキーを変更します。
   ※サブルーチンは後でコピーして計4つ追加になりますが、初めに1つだけ追加します。

コンポーネント名	必要数	カテゴリー	コンポーネントキー
イベント生成	１	処理部品＞イベント	期間選択
サブルーチン	１	処理部品＞サブルーチン	3か月

1. コンボボックスの選択位置を取得する
1. 【接続5-1】コンボボックスの選択位置を取得し、イベント番号としてアクションイベントを発生させます。
［編集画面図15］ 起動メソッド情報設定画面図を下に表示

2. 表示期間設定処理を作成する
サブルーチンを先頭にして、表示期間とそれに合わせた大目盛間隔、小目盛間隔を設定します。
期間の単位は［ガントチャート］から取得できます。
1. 【接続6-1】表示期間を3か月に設定します。
2. 【接続6-2】大目盛間隔を2週間に設定します。
3. 【接続6-3】小目盛間隔を1週間に設定します。
4. 【接続6】の［サブルーチン（3か月）］コンポーネントをコピーして、接続処理ごと編集画面上に3回貼り付けます。
5. コピーしたサブルーチンのコンポーネントキーをそれぞれ「１か月」、「1週間」、「3日」に変更します。
6. 【接続7-1～3】［サブルーチン（1か月）］の接続先の引数を変更します。
   表示期間：1か月、大目盛間隔：1週間、小目盛間隔：1日に変更します。
7. 【接続8-1～3】［サブルーチン（1週間）］の接続先の引数を変更します。
   表示期間：1週間、大目盛間隔：1日、小目盛間隔：6時間に変更します。
8. 【接続9-1～3】［サブルーチン（3日）］サブルーチンの接続先の引数を変更します。
   表示期間：3日、大目盛間隔：1日、小目盛間隔：2時間に変更します。
［編集画面図16］ ］ 起動メソッド情報設定画面図を下に表示

3. サブルーチンを呼び出す
作成した表示期間設定のサブルーチンの処理を［イベント生成］を先頭にして、呼び出します。
設定するイベント番号は［コンボボックス（期間選 択）］の項目位置と同じですので、項目名に合わせて各接続先にイベント番号を設定します。
1. 【接続10-1～4】サブルーチンの処理を呼び出す
［編集画面図17］ 起動メソッド情報設定画面図を下に表示

1. 複合コンポーネント内に以下の必要なコンポーネントを追加し、コンポーネントキーを変更します。

コンポーネント名	必要数	コンポーネントキー
サブルーチン	1	終了処理

1. 画面構成部品のデータをクリアする
1. 【接続11-1】ガントチャートのデータをクリアします。
2. 【接続8-2】［コンボボックス（項目選択）］の選択をクリアします。
3. 【接続8-3】［コンボボックス（項目選択）］を無効にします。
   ［コンボボックス（期間選択）］は有効のままでも問題ありません。
4. 【接続8-4】グラフ作成複合コンポーネントの終了処理をします。
［編集画面図18］ 起動メソッド情報設定画面図を下に表示

2. メソッドを公開する
   以下のメソッドを公開します。
   

   コンポーネント	メソッド	変更メソッド名
   サブルーチン（終了処理）	処理を呼び出す（）	終了処理を呼び出す
   複合コンポーネント（グラフ作成）	初期化処理（）	ー

3. アプリケーション開始時に初期化処理を行う
上位階層に戻り、アプリケーション開始イベントのグラフ作成複合コンポーネント「初期化処理（）」の代わりに、複合コンポーネントの初期化処 理を 繋げます。
1. 【接続0-1-3】初期化処理を行う
4. アプリケーション終了時に終了処理を行う
上位階層に戻り、アプリケーション終了イベントの「ガントチャートをクリアする()」の代わりに、複合コンポーネントの終了処理を繋 げま す。
1. 【接続3-5】終了処理を行う
［編集画面図7］※他コンポーネント接続処理省略
起 動メソッド情報設定画面図を下に表示