Excelライクなリストビューでの編集②～サーバサイドコマンド設定編～

サーバサイドコマンドの設定

新規登録・更新兼用のサーバサイドコマンドの作成

【全般タグ】
　名前、説明を入力する。説明については、「テンプレート付き」コメントを書く時のコツを参考にしてください。（ここでは省略）

---

【パラメータ】タグ
パラメータの名前に「更新データ」と入力する。今回のパラメータはリストビューデータのため、パラメータの種類は「配列型」を選択してください。
編集列の鉛筆マークをクリックして、パラメータの詳細を設定します。

リストビューの更新データ（新規追加行、更新があった行）のみを新規登録、更新したいので、左上の「変更データのみを送信」にチェックを入れ、主キーフィールドにリストビューに設定しているテーブルまたはビューの主キーを入力します。複合キーの場合は、「,（カンマ）」区切りで入力します。

配列項目は新規登録および更新に必要な項目のみを設定します。説明列の「説明項目を追加...」をクリックすることで各項目の説明も追加することができますので、可能な限り設定しましょう。（ここでは省略）

すべて設定出来れば、「OK」ボタンをクリックしましょう。

今回は、処理結果をリターンコード、リターンメッセージで確認するため、【戻り値】タブの設定は省略させてもらいます。

---

【コマンド】タグ
　ここのコマンドでは、新規追加された行は「テーブルデータの更新（追加）」でレコード追加、更新された行は「テーブルデータの更新（更新）」でレコードを更新します。

詳細なコマンドの説明

例外処理：エラーが発生した場合に、エラーコードとエラーメッセージを設定する必要があるため、「例外処理」コマンドを選択します。
Try～Catchの間でエラーが発生した場合には、エラー発生箇所の次のコマンドがCatch内のコマンドとなるため、そこでリターンコード、リターンメッセージを設定します。
　リターンコード：=ExceptionCode
　リターンメッセージ：=ExceptionMessage

今回は複数レコードを繰り返しの中で新規登録、更新を行っていくため、エラーが発生した場合には新規登録・更新の取り消しが必要になります。そのため、トランザクションコマンドも使用しています。

繰り返しコマンドで、「繰り返し回数、または繰り返し配列」で「=更新リスト.AddRows」を選択します。「更新リスト」には、更新・新規登録のデータが　含まれています。「AddRows」は新規登録行のことを指します。繰り返し配列オブジェクト名（繰り返しの中で各行のデータが格納される先）は今回はItem（任意でも問題なし）を設定します。

新規登録行データ（更新データ.AddRows）の繰り返し内で、「テーブルデータの更新（追加）」コマンドを設定します。値は、フィールド毎に、Item.xxxxxxx、数式、固定値を設定します。更新者の設定方法は複数あるのですが、更新日は現在日時（=now()）、更新者は固定値を今回は設定しています。

繰り返しコマンドで、「繰り返し回数、または繰り返し配列」で「=更新リスト.EditRows」を選択します。「EditRows」は更新行のことを指します。繰り返し配列オブジェクト名（繰り返しの中で各行のデータが格納される先）は今回はItem（任意でも問題なし）を設定します。

更新行データ（更新データ.EditRows）の繰り返し内で、「テーブルデータの更新（更新）」コマンドを設定します。値は、フィールド毎に、Item.xxxxxxx、数式、固定値を設定します。

リターンコード、リターンメッセージに下記を設定します。
　リターンコード：=ExceptionCode
　リターンメッセージ：=ExceptionMessage

Catchに入った場合は、ここでコマンドを終了します。
※Finallyにコマンドを追加した場合には、Finally内のコマンド実行後に終了します。

正常に終了した場合のリターンコードのみを設定します。ここでは、「1」を設定します。