MZ Platformエクセル連携導入チュートリアル

ファイル選択画面作成

1. 以下のコンポーネントを追加します。

コンポーネント名	必要数	カテゴリー	ｺﾝﾎﾟｰﾈﾝﾄｷｰ
フレーム	1	画面構成部品＞ウィンドウ	派遣管理一覧
ラベル	２	画面構成部品＞テキスト
テキストフィールド	２	画面構成部品＞テキスト	ファイル名 シート名
ボタン	１	画面構成部品＞ボタン
パネル	１	画面構成部品＞パネル
ファイル選択	１	画面構成部品＞ダイアログ

1. 画面編集画面に入り、パネルを配置します。
2. 画面編集画面の左側ツリー領域の［パネル］をクリックします。
   編集領域がパネルの領域に変化します。
3. ［ファイル選択］以外のコンポーネントをパネル上に横方向整列で配置します。
4. 画面編集画面を終了し、［実行（設定可）］ボタンで実行します。
   ラベルのテキストを「ファイル名」と「シート名」に、ボタンのテキストを［選択」に変更します。

1. ファイル選択ダイアログで選択したファイル名を［テキスト フィールド］に設定する
1. 【接続1-1】［ボタン（接続）］を押したら［ファイル選択］を表示します。
2. 【接続2-1】ファイル名が選択されたら、［テキストフィールド］に設定します。
   ［ファイル選択］のファイルを「開く」ボタンが押されたときのみ処理を行い、「取消」ボタンが押されたときは処理を行わない よう に、イベント番号１を設定します。

検索結果の取得・設定

1. エクセルファイルの検索
1. 【接続3-3】文字列格納変数にSelect文の前半部分を設定します。
   引数に「Select ID, 氏名, 派遣先, 開始日, 終了日, 伝票番号 from 」と設定します。
   「from」の後ろにも半角スペースを入れてください。
2. 【接続3-4】変数内でシート名をSelect文字列に連結します。
   シート名は予め［テキストフィールド（シート名）］に入力しておきます。
   実行すると「Select ID, 氏名, 派遣先, 開始日, 終了日, 伝票番号, from plan2」という文字列ができます。
3. 【接続3-5】Select文を実行します。
   ［文字列格納変数］内の文字列を引数とします。
   イベント番号は１を設定しておきます。


※【接続3-2】のデータベースとの切断処理は一番最後になるようにドラッグして処理の順番を入れ替えます。
2. 検索データの設定
1. 【接続4-1】検索結果を［テーブル］に設定します。
   結果の返るSQLの実行が行われるとデータ生成イベントが発生します。
   データ生成ベントの接続先に［テーブル］を設定します。

ガントチャートへのデータ設定

1. 以下のコンポーネントを追加します。

   コンポーネント名	必要数	カテゴリー	テキスト
   ボタン	１	画面構成部品＞ボタン	ガントチャート化
   ガントチャート	１	画面構成部品＞グラフ
   グラフデータ作成	１	複合コンポーネント追加＞グラフ

2. グラフデータ作成複合コンポーネントの追加の仕方
   アプリケーションビルダー編集画面で右クリック＞[複合コンポーネント追加]＞[グラフ]＞[グラフ化モジュール.mzcx]を選び ます。
   

1. 画面編集画面で［ボタン］と［ガントチャート］を配置します。
2. 「実行（設定可）」ボタンで実行し、ボタンのテキストを『ガントチャート化』に変更します。

1. ガントチャート用データの作成
［グラフデータ作成］に引数としてテーブル データを設定し、項 目、系列、開始日時、終了日時に列 名または列番号を指定することでガントチャート用に整理したテーブルデータを作成できます。

1. 【接続5-1】ガントチャート用テーブルデータを複合コンポーネント内で作成します。
   （引数設定例）

   	説明	取得方法	コンポーネント	メソッド／値
   引数０	テーブルデータ	メソッド戻り値	テーブル	テーブルデータを取得する
   引数１	系列列	固定値	ー	氏名
   引数２	項目列	固定値	ー	派遣先
   引数３	開始日時列	固定値	ー	開始日
   引数４	終了日時列	固定値	ー	終了日

2. 【接続5-2】タスク名用のテーブル デー タを複合コンポーネント内で作成します。
   タスク名はテーブル型のデータによって一括で設定することができます。
   先にガントチャート用データ作成を行っていることが必要です。
2. ガントチャートへデータ設定
1. 【接続5-3】作成されたテーブルデータをガントチャートに設定します。
2. 【接続5-4】作成されたタスク名データをガントチャートに設定します。
3. 全系列の色を設定する
同系列は同じ色で 表示されるように色のリストを設定します。
1. 【接続5-5】系列色のリストを設定します。

更新されたデータの取得

1. 以下のコンポーネントを追加します。

   コンポーネント名	必要数	カテゴリー	コンポーネントキー
   テーブル格納変数	１	処理部品＞変数	ガントチャート用分類テーブル
   リスト格納変数	１	処理部品＞変数	選択された受注データ

1. 分類テーブルの設定
接続元は［ボタン（ガントチャート化）］です。
1. 【接続5-6】ガントチャート用に分類されたテーブルを変数に格納します。
2. 【接続5-7】第0列目を削除します。
   分類テーブルは第０列目が項目名列でデータ列ではないため、系列インデクスで指定したときに位置が合うように削除します。
2. ガントチャート更新時のデータ取得
1. 【接続7-1】ガントチャート用分類テーブルからセルの値を取得します。
   引数に現在選択されている項目のインデックスを使用して、分類テーブルからデータを取得します。
   取得したデータはリスト型のデータです。
   （例［1,本郷猛,ヨタヨタ自動車,2023/3/2,2023/3/6,a12］）
2. 【接続7-2】取得したデータをリスト格納変数に格納します。

日付データ文字列変換機能作成

1. １.［カレンダー］コンポーネント　
日付や時刻の演算処理を行うコンポーネントです。
日時の加算、減算や経過時間の取得などができます。
設定するデータの型はCalenderまたはDate型ですが、日 付書式を指定して文字列で設定も可能です。
また、日付データを書式を指定して文字列として取得することもできます。
2. ２.［ファンクション］コンポーネント
［ファンクション］には任意の数の引数を呼び出し時、または事前に設定することができます。
この引数は他のコンポーネントのメソッド実行の引数として利用することができ、処理の呼び出しとデータ（引数）の受け渡しを一連の処理に まと められます。

メソッド「ファンクションの呼び出し」を実行すると、［ファンクション］からは｢処理要求イベント｣が発生します。
処理要求イベントは最後に接続されているメソッドの戻り値を取得するようになっていて、この値が「ファンクションの呼び出し」の戻り値と なり ます。
ファンクションの処理要求イベントの接続先処理が済んだ後で、ファンクションの処理の結果を戻り値として利用できます。

1. 以下のコンポーネントを追加します。

   コンポーネント名	必要数	カテゴリー	ｺﾝﾎﾟｰﾈﾝﾄｷｰ
   ファンクション	１	処理部品＞変数	日付文字列取得
   カレンダー	１	処理部品＞システム　 またはユーティリティー

1. 日付データの設定
1. 【接続8-1】日付データをカレンダーに設定します。
   引数にはファンクションの第1引数を指定します。
   （後でファンクション呼び出し時にガントチャートの選択されている開始日または終了日のデータを設定します。）
2. 【接続8-2】書式を指定して、日付文字列を取得します。
   引数０（日付書式）は「yyyy/MM/dd HH:mm:ss」とします。
   ここで取得した日付文字列は、後でファンクションを呼び出したときの戻り値となります。

更新SQL文の作成

1. 以下のコンポーネントを追加します。

   コンポーネント名	必要数	カテゴリー	ｺﾝﾎﾟｰﾈﾝﾄｷｰ
   サブルーチン	１	処理部品＞サブルーチン	エクセル更新と読込
   文字列格納変数	１	処理部品＞変数	データ変更用SQL

1. 更新SQLの雛形設定
1. 【接続9-1】雛形文字列を変数に設定します。
   「Update plan2 set 開始日='START', 終了日='END' where ID=NO」を設定します。
   
2. 開始日を取得して雛形文更新
1. 【接続9-2】ガントチャートの選択データの開始日を取得します。
   引数は選択されている項目インデックスと選択されている系列インデックスです。
2. 【接続9-3】日付を書式指定で文字列に変換します。
   先に接続処理を設定しておいた［ファンクション（日付文字列取得）］を呼び出します。
3. 【接続9-4】雛形の文字列の「START」と日付データを置換えます。
3. 終了日を取得して雛形文更新
1. 【接続9-5】ガントチャートの選択データの終了日を取得します。
2. 【接続9-6】日付を書式指定で文字列に変換します。
3. 【接続9-7】雛形の文字列の「START」と日付データを置換えます。
   引数の取得方法は「メソッド処理結果」です。
   メソッド処理結果選択窓には同名の選択候補が現れますが、2番目の候補を選択します。
4. ID列のデータを取得して雛形文更新
1. 【接続9-8】ガントチャートの選択データのIDを取得します。
   事前にリストに格納してあるリストデータ（例［1,本郷猛,ヨタヨタ自動車,2023/3/2,2023/3/6,a12］）か ら0番目のID番号データを取得します
2. 【接続9-9】雛形の文字列の「NO」とID番号を置換えます。
5. ガントチャートを更新したら、雛形文を更新する

接続元コンポーネントは［ガントチャート］です。
1. 【接続7-3】ガントチャートが更新されたら、［サブルーチン］を呼び出します。

 更新の実行

1. データベースに接続する
接続9-10、9-12、9-13は接続3-1、3-5、3-2をコピーすると簡単です。
1. 【接続9-10】データベースに接続します。
2. 【接続9-11】更新SQLを実行します。
   イベント番号は２です。
   （※ここまでで一旦実行して、ガントチャートを変更してエラーが起こらないことを確認するとよいでしょう）
3. 【接続9-12】検索SQLを実行します。
   変更された結果を再検索します。
   テーブルにデータが再設定されます。
4. 【接続9-13】データベースとの接続を切断します。