Sharperlightにおいては、データソース（データベース、Excelワークシート、APIエンドポイント等）からデータを抽出するというのが原則ですが、書き戻し(Writeback)許可を設定することでデータソースへのデータの書き戻し(Writeback)を行うことができます。
今回は、Excelアドインを使用して、シート上のデータをデータベースに書き戻してみようと思います。

データベース／テーブルの準備

既存の試験データベースにLedger（帳簿）テーブルなるものを作成しました。このテーブルに対してExcelワークシートのデータを書き込んでいきたいと思います。

データモデルの準備

まずSharperlightがデータソースと対話できるようにデータモデルを作成します。
この試験データベースに対しては既にデータモデルを作成していたので、今回追加したテーブルの情報だけを反映させたいと思います。
Sharperlightアプリケーションメニューからスタジオを起動します。
フォルダアイコンで対象データモデルを探します。

ToolsメニューのサブメニューStudio Connectionメニューを選び、正しく対象データベースに接続されているかを確認します。

確認が済んだら'Schema'メニューのImport Tablesメニューを選択します。

Get Tablesボタンをクリックすると、接続しているデータベースからスキーマ情報が読み込まれます。既にデータモデルに読み込まれているテーブルについては赤色で表示され、まだ読み込まれていない新しいテーブルについては黒色で表示され、チェックも入った状態になります。

OKボタンを押すと、チェックの入ったテーブルの情報がデータモデルにインポートされます。

新しくインポートされたテーブルは、All Tablesノードの下に表示されています。

このままでは、クエリビルダ等からは見えない設定なので、新しいテーブルLedgerテーブルをTable Displayノードへ移動させます。ドラッグ＆ドロップで移動できます。
Table Displayノードに移動したLedgerテーブルを選択すると、右側にテーブルのプロパティ一覧が表示されます。その中からAllow Table Writebackプロパティを探し出し、Trueを設定します。

これでこのテーブルにはデータの書き戻しを行うことができるようになりました。これは単にこのテーブルには書き戻しができるよ～っていう許可であり、他にもユーザー単位で許可／未許可の設定を行うこともできます。
あとDescriptionプロパティに帳簿と日本語で記入します。

今度は、Ledgerテーブルをダブルクリックすると中央にはフィールド一覧が表示され、そのフィールドを選択するとそのフィールドのプロパティが右側に表示されるようになります。それぞれのフィールドのDescriptionプロパティを日本語に置き換えます。

全て終わったらOKボタンでデータモデルを保存します。

データの準備

Excelワークシート上にこのようなデータを準備します。

列名は、データモデルのフィールドDescriptionと合わせておくといいですよ。

書き戻し定義の作成

では書き戻しの定義を行います。Sharperlight Excelアドインのリボンから書き戻しを選択します。

書き戻し定義ダイアログが表示されます。製品には先ほどのデータモデルを、テーブルには先ほどの帳簿テーブルを選びます。
下部フィールドタブに帳簿テーブルのフィールド一覧が表示されます。ここでExcelシート上のデータとフィールドのマッピングを行います。

コードフィールドの入力テキストフィールドを選択した状態で、Excelシートのテーブル内をダブルクリックします。すると自動マッピング機能が働き、このようなメッセージが表示されます。Yesボタンを押して先に進みます。

データテーブルの列名とデータモデルのDescriptionが一致する場合のみマッピングが設定されます。

マッピングが設定されていないフィールド、たとえば請求に対しては、その入力テキストフィールドを選択した状態で、Excelシート上の請求額列をダブルクリックします。すると先ほどと同じメッセージが表示されるので、今度はNoボタンを選択します。そうすることで個々のフィールドのマッピングを行うことができます。

Idフィールドは、IDENTITYフィールドなのでIdがデータベースによって自動算出されるのでマッピングは不要です。
Idの左横に星印が付いていますね。これはSharperlightエンジンがこの列のデータをガイドとして使用し、どの行までデータが存在するかをチェックするためのものです。しかし、この機能はマッピングがされていないフィールドには設定できません。よって今回はコードフィールドにこの機能を設定します。コードフィールドを選択して右クリックメニューからドライバーを選択します。

最後に書き戻し名に帳簿と入力します。閉じるボタンで定義を保存すると、この名前で保存されます。

これで定義は完了。

検証

プレビューボタンを押して、マッピングの設定どおりエンジンが正しくデータを拾っているかチェックしてみます。

プレビューとログが表示されます。ログをみると分かりますが、書き込みは行われていません。この機能はあくまでも正しくデータが拾われているかのチェックのみです。

検証ボタンは、プレビューなしのデータ収集チェックです。ログだけが表示されます。

以上で上手くデータが拾えていることが確認できたので、実行ボタンで書き戻しを実行します。

ログが表示され、正しく実行されたことが分かりました。

データベーステーブルを確認してみます。正常に書き込みが行われていました。

データの更新と追加

Excelシート上のデータを更新します。
最下行にコード S011 という新しいレコードを追加します。またコード S006 のレコードの入金額と残高を更新します。

この状態で再度書き戻しを実行すると、新しいレコードは追加され、変更があったレコードは更新されます。

書き戻しボタンの作成

今回は、書き戻しダイアログを開いて実行ボタンを押すのではなく、ボタンを追加して書き戻しを実行します。
ボタンを配置したい位置のセルを選択した状態でSharperlightリボンのボタン->書き戻し->mdWriteBackを選択します。

書き戻し定義一覧が表示されるので、今回作成した定義帳簿を選択し、OKボタンを押します。

書き戻し専用のボタンが追加されました。

ではこのボタンを押して書き戻しを実行します。
早速データベースをチェック、正しく更新することができました。

では、失礼します。