[OutSystems] 意外と認識されていない OutSystems の JavaScript の話

OutSystems Developer Day Tokyo 2025 のセッション発表で使用したスライドです。
スライドの内容に対応する解説は、下記で公開しています。

[OutSystems] 意外と認識されていない OutSystems の JavaScript の話 #outsystems - Qiita
https://qiita.com/moriya-takasi/items/ec4e8064b0a1657b2e21

イベント情報：
[OutSystems Developer Day Tokyo 2025]
https://usergroups.outsystems.com/events/details/outsystems-inc-tokyo-presents-developer-day-tokyo-2025/

Transcript

1. 意外と認識されていない OutSystems の JavaScript の話 [Developer Day Tokyo 2025] 2025-04-24 Thu 守谷 崇 ＠伊藤忠テクノソリューションズ
2. About Me https://www.outsystems.com/profile/wyd1ajex5p
3. このセッションの概要 OutSystems で、クライアントアクションフローに配置 した JavaScript 要素に書いたスクリプトから、別のクラ イアントアクションを呼び出すことができるのは、良く 知られています。 ですが、そのときの戻り値や制御順序、エラー処理に関 する注意点については、意外と認識されていない気がし ます。 このセッションは、そのあたりについて、少しだけ深掘 りした、ちょっとタメになるかも？なお話です。
4. アクションフローの JavaScript 要素 • 入出力パラメーターで前後のフローとデータやりとり • 同じスクリーンのアクションを $actions.MyAction1() で • Logic タブのクライアントアク ションを $actions.MyAction2() で 呼べる
5. アクションフローの JavaScript 要素 • 入出力パラメーターで前後のフローとデータやりとり • 同じスクリーンのアクションを $actions.MyAction1() で • Logic タブのクライアントアク ションを $actions.MyAction2() で 呼べる 同じ形式
6. 返り値はどうなる？
7. 返り値はどうなる？ 1: Hello 2: {GreetingText:'Hello'} 3: これだけじゃ確定できない
8. 返り値はどうなる？（こたえ） 3: これだけじゃ確定できない もあるが になること もある。
9. 返り値はどうなる？（こたえ） 3: これだけじゃ確定できない もあるが になること もある。 Promise になる例
10. 返り値が Promise になるアクション 呼び先アクションが下記のいずれかを含む場合 • サーバーアクション呼び出し • アグリゲイトやデータアクションのリフレッシュ • ローカルアグリゲイト • ローカルエンティティアクション呼び出し • $resolve() を含む JavaScript 要素
11. 返り値が Promise になるアクション 時間差で完了 する処理のとき 呼び先アクションが下記のいずれかを含む場合 • サーバーアクション呼び出し • アグリゲイトやデータアクションのリフレッシュ • ローカルアグリゲイト • ローカルエンティティアクション呼び出し • $resolve() を含む JavaScript 要素
12. 期待した返り値を受け取るには .then() の関数パラメーターで受けて $resolve() 実行
13. 期待した返り値を受け取るには 忘れずに付ける！ .then() の関数パラメーターで受けて $resolve() 実行
14. $resolve() を忘れると起こること JS 要素の出力パラメーター値が初期値で終了する （値が入ったときフローの JS 要素の処理は終了ずみ） $resolve() の役割 アクションフローにおいて JS 要素の実行完了を待つ
15. $resolve() を忘れると起こること JS 要素の出力パラメーター値が初期値で終了する （値が入ったときフローの JS 要素の処理は終了ずみ） $resolve() の役割 アクションフローにおいて JS 要素の実行完了を待つ 注意！
16. 「アクションフローにおいて」？ $resovle() な JS 要素を含むアクション（Ａ）を、別の JS 要素から単に呼ぶと、Ａの完了は待たれない。 $resolve() まで待って くれそうに見える
17. 「アクションフローにおいて」？ $resovle() な JS 要素を含むアクション（Ａ）を、別の JS 要素から単に呼ぶと、Ａの完了は待たれない。 完了を待つには…
18. エラーはどうなる？ SayHello 内でエラーが起きると？ 1: Exception Handler で処理される 2: 行方不明になる
19. エラーはどうなる？（こたえ） 2: 行方不明になる .catch で受けて $reject() を使うと拾える
20. エラー処理を書かなくてよいケース エラー発生を想定する必要がないようなとき
21. まとめ JS 要素から $actions.Xxx() でアクションを呼ぶと… • 処理完了を待たずに Promise が返ってくることがある • 呼び先が「時間差で完了する処理のとき」に Promise が返る（$resolve() を忘れずに） • Promise が返るときのエラー処理は適切に書かないと 行方不明になる（$reject() を使う） 楽しい開発を！