2021年11月30日にアップデートしたSPIRAL ver.2.18の新機能 / 機能改善の概要をご紹介します。
SPIRERSナレッジ向上チームのメンバーが実際に機能を試した感想もお伝えします。

今回、新機能「PHP実行環境」「認証API」「DBトリガ」の実装により、
今まで以上に、複雑な処理を実行するWebアプリケーションの開発やCMS連携がしやすくなりました！

アップデート内容の概要

新機能：3件

・ページ表示時のプログラム（PHP）実行/PHP環境変数

・認証API

・DBトリガ（レコードアクション/非同期アクション対応）

その他機能：54件

・フリーコンテンツブロック

・検索フォームブロック

・認証エリア 機能拡張

　ーレコード照合ブロック
　ーパスワード任意化対応

・フォームブロック 機能拡張

　ーURLパラメータのレコード値反映
　ーステップ情報のURLパラメータ追加

不具合修正：76件

・スケジュールトリガの設定において、実行タイミングを「指定日」にした場合にタイムゾーンが表示されない不具合を修正など

ver.2.18 アップデートについて、詳しくは以下のURLをご確認ください。
https://support.spiral-platform.com/news/6709.html

アップデート概要 ー 新機能：ページ表示時のプログラム（PHP）実行 / PHP環境変数

新機能の1つ目は「ページ表示時のプログラム（PHP）実行 / PHP環境変数」です。

SPIRAL ver.2（以下、ver.2）に、新たにPHPの実行環境が提供されます。
また、PHP環境変数という機能が実装されました。

下図は本節を理解する参考としてご覧ください。

ver.2は「ページ（図でいう白背景の枠部分）」を作成し、そこに「ブロック（背景色付きの部分）」を埋め込んで画面を作成します。そしてPHPは「ページ」に記述し、「ページ」内の body や「ブロック」に値を渡して出力します。
色分けしている部分ごとに記述箇所が分かれており、プログラム担当とデザイン担当の作業が分担できます。

また、ver.2には、テスト環境と本番環境が存在します。色分けされている要素単位で本番リリースができます。
たとえば「ページ」のPHPプログラムを修正しつつ、「ブロック」内の文言のみ反映することなどもできます。

さらにPHP環境変数を使用することで、PHPを使用する際に、テスト環境と本番環境で変数の値を切り替えることが可能です。 たとえばテスト環境と本番環境でAPIキー/エンドポイントを切り替えたい場合、PHP環境変数を設定しておくことで、環境ごとに変数の値が切り替わるため、反映時の書き換えが不要になります。

今回のアップデートのメリット

・保守性が高い

・作業分担しやすい、かつ、分担した範囲ごとでリリースが可能

UI部分とプログラム部分が分かれているため、変更箇所を把握しやすく、UIの修正を行う際にプログラム側を意識せずに操作できるので、テスト工数を削減することができます。
UI部分とプログラム部分の担当が、お互いが干渉することなく作業を進めることができます。

SPIRAL ver.2のPHPについて、詳しくは以下のURLをご確認ください。
https://support.spiral-platform.com/function/function-site-manage/6898.html

アップデート概要 ー 新機能:認証API

認証APIとは

認証エリアに対して、ログイン/ログアウトのリクエストやセッション状況を確認できるAPIです。

1.ログイン・ログアウト

ログインのセッション管理をver.2の認証APIが担うため、セッション管理をする必要がなくなります。
そのため、認証関連の実装をver.2のみで完結できます。

2.セッション確認・延長

CMS側で構築したページへのアクセス時に使うことでセッションを維持できます。
CMSのページを擬似的に認証エリア内のページとして扱えます。

3.ワンタイムURL発行

APIでログインした場合にCMS側のページから認証エリア内のページに遷移する際に、遷移先URLを取得できます。
CMSからver.2内の認証エリアのページに遷移する際もログイン画面を挟まずに遷移できます。

今回のアップデートのメリット

・ログイン処理実装時、cookieとURLパラメータの考慮が不要

・ver.2とCMSの連携でサイトの利便性と安全性を両立

・グループ設定に合わせてAPIエージェントの権限設定が可能

ver.2では、APIでログインする場合、セッションIDをURLパラメーターに付与する必要がありません。
また、認証APIの実行を許可するAPIエージェントの権限設定を細かく制限できます。

サイト認証APIについて、詳しくは以下のURLをご確認ください。
https://support.spiral-platform.com/function/function-site-manage/6995.html

アップデート概要 ー 新機能：DBトリガ

新機能の3つ目はDBトリガです。レコードの登録時/更新時/削除時に、
レコードアクションと非同期アクションの2種類のアクションが設定可能となっています。

レコードアクション

レコードアクションでは自DB（トリガを設定したDB）に対しての更新と、他DBに対しての登録/更新/削除が可能です。
トリガを複数組み合わせることで、複数DBへの登録や更新登録のような動作も設定できます。
演算/関数処理は今後のアップデートで実装予定です。

非同期アクション

非同期アクションは、ver.2.18提供時点ではメールアクションでの設定が可能です。
メールアクションでは、レコードの登録時/更新時/削除時にレコード内のメールアドレスか、
固定のメールアドレスにメール送信するトリガを設定できます。

活用例

1.操作ログDBを作成して、登録/変更/削除のログを格納

操作ログDBを作成して、登録/変更/削除のログを取るような設定をすることが出来ます。
ver.2の管理画面（アプリの利用画面）からの操作や、APIからの操作ログも取得することができます。
くわえて、トリガが動作する条件として登録経路の設定も可能であるため、
APIでのレコード操作はログを取らないといった設定もできます。

2.お問い合わせに対する回答内容を登録したタイミングでお客様へ自動で回答メールを送信

問い合わせ管理のようなアプリケーションで、オペレーターが回答内容を登録したタイミングで、
お客様への回答メールを自動で送信できます。これまでフォームでのメールアクションでは、
ver.2の管理画面からのデータの操作による自動メール配信を設定することはできませんでしたが、
トリガのメールアクションによって実現が可能になりました。
もちろん、APIからのデータ操作をトリガにメール配信することもできます。

メリット

・メンテナンス性が高く、仕様変更や追加改修に強い

・管理画面やAPIからのデータ操作をきっかけにメールを送信できる

DBトリガについて、詳しくは以下のURLをご確認ください。
https://support.spiral-platform.com/function/function-app-manage/6889.html

アップデート概要 ー その他機能

既存機能に追加された内容をご紹介します。

フリーコンテンツブロック

ブロックの機能にHTMLの知識がなくてもページを作成できる機能が追加されました。
WYSIWYG（ウィジウィグ）でWebページを作成可能です。

フリーコンテンツブロックについて、詳しくはURLをご確認ください。
https://support.spiral-platform.com/function/function-site-manage/6972.html

認証エリア機能拡張（レコード照合フォームブロックの追加）

・クリックログインフローの実装が可能

認証エリアの機能拡張ではレコード照合ブロックというブロックが追加されたのと合わせて
パスワードフィールドが任意に設定できるようになったので、クリックログインフローが実装できるようになりました。

レコード照合フォームブロックについて、詳しくは以下のURLをご確認ください。
https://support.spiral-platform.com/function/function-site-manage/7024.html

フォームブロック機能拡張（パラメータ付与の追加）

・URLパラメータをレコード値に反映

・ステップ情報のURLパラメータ追加

これまでJavascriptで対応を行う必要があったURLパラメータのレコード値反映が標準設定できるようになります。
くわえて、ステップ情報のURLパラメータが追加されるので、Google Analyticsなどのアクセス解析ツールを使用して、どこで離脱したのかがわかるようになります。

パラメータ付与について、詳しくは以下のURLをご確認ください。
https://support.spiral-platform.com/function/function-site-manage/3949.html

最後に

SPIRAL ver.2.18でアップデートした新機能 / 機能改善の概要は以上になります。

いかがでしたでしょうか。
是非、新機能をお試していただき、ご活用いただければと思います！