一.スマート書き込み
1.応用シーン
スマート書き込みというのは、データの書き込みにおける挿入、更新、削除の3つの操作を統合したものです。書き込み時、バックエンドは挿入、更新、削除操作のいずれかを判断します。もし書き込み時に2種類以上の操作が必要な場合、スマート書き込みを選択することができます。
注意：モバイル端末もデータの挿入、更新、書き込みをサポートしています。
2.書き込みロジック
• ページ上で[行削除]によって削除されたデータを識別し、設定された[主キー]に基づいてデータベース内の該当するデータを削除します。
• 削除されたデータを除外した後、残りのデータを設定された[主キー]に基づいてデータベース内の該当するデータを探します。該当するデータがあれば更新を実行し、該当しない場合は挿入を実行します。
• [変更時のみ更新]を選択した場合、書き込み時にページ上で変更されていないデータは書き込みに参加しません。詳細については「書き込みにおける変更時のみ更新」を参照してください。
• データを更新または削除を行う必要がある場合、必ず[主キー]を選択してください。[主キー]を選択しない場合、すべて[挿入書き込み]となります。[主キー]はSQLのwhere文に相当し、データベースでの[主キー]と異なります。
• [行挿入]によって空白行が挿入され、その空白行を編集しなかった場合、それらのレコードの値はすべてnullとして認識されます。このようなレコードは書き込み時にフィルタリングされ、データベースに保存されません。
注意: データがデータベースに保存された後の順序は、ページ上の表示順序と一致することを保証できません。
3.効果プレビュー
1）書き込みテーブルを設計する時、テンプレートに既存するデータを表示します。以下の図を参照してください：
2）[帳票書き込み属性]で[書き込みタイプ]を[スマート書き込み]に設定した場合、以下の図のようになります：
3）同時にデータの追加、変更、削除の操作を行った場合、結果は以下の図のようになります：
二.削除書き込み
1.応用シーン
削除書き込みはデータの削除のみを行うことができます。削除データのみが必要な場合、[削除書き込み]を選択できます。
2.書き込みロジック
• 削除書き込みの削除ロジックはスマート書き込みの削除ロジックとは完全に逆です。削除書き込みでは、[行削除]によって削除されたデータを除外し、ページ上で残っているデータを設定された[主キー]に基づいてデータベース内の該当データを削除します。
• 削除書き込みでは、[主キー]フィールドを追加するだけで、その他の非主キーフィールドの追加は結果に影響を与えません。
• 必ず[主キー]フィールドを設定してください。[主キー]を設定しない場合、削除書き込みは実行されません。
3.効果プレビュー
1）書き込みテーブルを設計する時、テンプレートに既存するデータを表示します。以下の図を参照してください：
2）[帳票書き込み属性]で[書き込みタイプ]を[削除書き込み]に設定した場合、以下の図のようになります：
3）フロントエンドでの書き込み効果は以下の図のようになります。[書き込み]を実行すると、書き込み画面上に表示されているデータが削除され、[行削除]によって削除されたデータは保持されます。この削除ロジックは、[スマート書き込み]の削除ロジックとは完全に逆です。
三.挿入書き込み
1.応用シーン
挿入書き込みはデータの挿入のみを行うことができます。挿入データのみが必要な場合、[挿入書き込み]を選択できます。
2.書き込みロジック
• スマート書き込みの挿入ロジックと同じで、[行削除]の動作によって削除されたデータを除外した後、ページ上で残っているデータに対して挿入操作を行います。
• データの重複性については判断しません。つまり、重複したデータがデータベースに挿入される可能性があります。もしデータベース自体で重複データを許可しない場合、[書き込み]時にエラーが発生します。
• [行挿入]で空白行を挿入し、その空白行を編集しなかった場合、これらのレコードの値はすべてnullとして認識されます。このようなレコードは[書き込み]時にフィルタリングされ、データベースに挿入されません。
• [挿入書き込み]タイプでは、[主キー]の設定は[書き込み]結果に影響を与えません。[書き込み]時には[主キー]設定は読み込まれません。
3.効果プレビュー
1）書き込み帳票に原始の既存データは表示されません。以下の図のように：
2）[帳票書き込み属性]で[書き込みタイプ]を[挿入書き込み]に設定した場合、以下の図のようになります：
3）データを挿入した後、書き込みボタンをクリックすると、データが正常にデータベースに挿入されます。以下の図をご覧ください：
4）データベースでのテーブル情報を確認すると、テーブルに新しいデータが追加されていることがわかります。以下の図をご覧ください：
四.更新書き込み
1.応用シーン
更新書き込みはデータの更新のみを行うことができます。更新データのみが必要な場合、[更新書き込み]を選択できます。
2.書き込みロジック
• ページ上のデータに対して、設定された[主キー]を使用してデータベース内の該当データを更新します。同じ[主キー]を持つ複数のデータは、最後の1件を基に更新されます。
• 必ず[主キー]フィールドを設定してください。[主キー]が設定されていない場合、[更新書き込み]は実行されません。
• [行削除]動作は認識されません。つまり、削除された行のデータも、[書き込み]時には更新対象となります。
3.効果プレビュー
1）書き込みテーブルを設計する際、テンプレートに既存のデータを表示します。以下の図をご覧ください：
2）[帳票書き込み属性]で[書き込みタイプ]を[更新書き込み]に設定した場合、以下の図のようになります：
3）データを変更した後、[書き込み]ボタンをクリックすることで、データが正常に更新されます。以下の図をご覧ください：
前：書き込みボタン属性を設定