OutSystems 11の頃にConsume REST APIのカスタマイズを試してみるでみた方法で、Consume REST APIの通信にカスタマイズを加えられる。
ここでは、その中でもBase URLの書き換えについて見ていく。

環境情報

ODC Studio(Version 1.4.11)

実行時にBase URLを書き換える方法

Consume REST APIのOn Before Requestを使う。作成するには、Consume REST APIのOn Before Request右のドロップダウンリストを展開し、「New OnBeforeRequest」を選択する。

OnBeforeRequest Actionでは、Output ParameterのCustomizedRequestを編集することで、対応するHTTPS通信内容の書き換えを行える。

デフォルトでは、CustomizedRequestにRequestをAssignしてある。後続処理で、CustomizedRequestを書き換えればよい。

書き換えるのは主に以下のAttribute。

Base URL: 「https://<ホスト名>/<App名>/rest/<REST API名>」が入っている
URLPath: 「/<REST API Method>」

サンプル実装

ホスト名部分を書き換えるなら、OnBeforeRequestの実装を以下のようにする。
Ifの部分でクエリストリングの特定パラメータをチェックし、特定の値のときだけBase URLを書き換える流れ。

ホスト名書き換えには、標準APIのHTTP/Http_RequestDomainを利用している。第1引数で指定した変換対象URLのホスト部分を第2引数（ここでは私のブログのホスト）で置き換えたものを返す。
なお、ポート番号を含むURLの書き換えにはこのActionは使えず、自分で変換ロジックを書かないといけない点に注意。

動作確認

ホスト名書き換えのリクエストを行ったあとで、TracesでConsume REST APIのHTTPリクエストを確認した。以下のように元のリクエストのホスト部分を書き換えたURLにアクセスしている（適当なホストに書き換えているので、該当パスがなくHTTP Statusは404）。

用途

例えば、接続先のREST APIが同質のものが複数あり、入力条件やSettingに応じて接続先を切り替えたいときに使える。

なお、接続先の数が固定的であれば、この方法よりは、アーキテクチャパターンのTransparency Patternを使ったほうが良いだろう。