ルーティング設定（画面のURL）
ここでは、画面コンテンツのルーティング設定（画面のURL）に関する基本的な操作について説明します。
ルーティング定義と認可設定
ルーティング定義の認可とは、画面コンテンツにアクセスできるユーザを制御する仕組みです。具体的には、画面を呼び出す入り口であるURIにアクセスした際に、ユーザが実行権限を持っているかどうかをチェックします。
ルーティングの設定では、画面コンテンツを安全に呼び出すために次のような認可設定を行います。
(1) 認可URIの設定
認可URIは、画面へのアクセス権限を判定するための「リソースURI」として利用されます。主な用途は、ルーティングから呼び出される画面を表示できるかどうかを判定することです。認可URI自体は、あくまで「この画面にアクセス可能かどうか」を示すラベルのような役割を持ち、実際のアクセス制御はルーティングの認可設定など別の仕組みで行われます。
(2) ルーティング定義自体の認可設定
画面ルーティングの認可設定は、画面表示用のURL（ルーティング登録時に作成されるURL）を対象としています。この設定の主な用途は、誰がこのURLにアクセスできるかを制御することです。認可設定は「画面を表示するための入り口」に対するアクセス権限を管理するものであり、画面上の操作権限や内部処理の実行権限とは別である点に注意してください。
ルーティングでは、IM-Authzを用いて認可判断を行います。IM-Authzとは、intra-mart Accel Platformにおける認可（Authorization）機能であり、「誰がどのAPIにアクセスできるか」を制御・管理する仕組みです。詳細は「認可仕様書」を参照してください。
基本操作
ルーティングの基本的な操作を説明します。
ルーティングを新規登録する
ルーティングカテゴリの設定
ルーティングを格納するカテゴリを選択します。
- 「カテゴリ」にある［検索］をクリックします。
└ 「ルーティングカテゴリ検索」画面が表示されます。- 設定したいカテゴリを選択します。
└ 右側にカテゴリ情報が表示されます。- ［決定］をクリックします。
└ 「確定確認」ダイアログで［決定］をクリックします。
対象コンテンツ情報の設定
ルーティング設定の対象となるコンテンツを選択し、最新または固定のバージョンを指定します。
- 「コンテンツ」にある［検索］をクリックします。
└ 「コンテンツ検索」画面が表示されます。- 設定したいコンテンツを選択します。
└ 右側にコンテンツ基本情報が表示されます。- ［決定］をクリックします。
└ 「確定確認」ダイアログで［決定］をクリックします。- 「コンテンツ」に設定した画面コンテンツのバージョン番号を指定します。
└ 「最新バージョンを利用する」は、常に最新のバージョンを利用するときに選択します。
└ 「利用するバージョンを指定する」は、特定のバージョンを利用するときに選択します。利用するバージョン番号も入力してください。コラムバージョンの指定方法によって、それぞれ以下のような違いがあります。
- 最新バージョンを利用する：
「対象フロー」に設定したフローの中から、常に最新のバージョンを利用します。呼び出し時に都度検証が行われるため、フローの更新が自動で反映されます。常に最新の処理を利用したい場合に適しています。- 利用するバージョンを指定する：
「対象フロー」に設定したフローの中から、特定のバージョンを利用します。呼び出し時にフローが固定されるため、更新の影響を受けず安定した動作が期待できます。ただし、対象のバージョンが更新・削除された場合には、その影響を受ける点に留意してください。
ルーティング定義情報の設定
ルーティングの基本情報を設定し、画面の用途に応じてHTTPメソッドを選択します。
- 「ルーティングID」に、任意のIDを入力します。
└ 入力したIDは、認可URIに自動で反映されます。- 「メソッド」から利用したいHTTPメソッドを選択します。
└ 「GET」または「POST」を選択します。コラムルーティング定義で設定するHTTPメソッドは、画面での操作内容や画面から送信されるリクエストの種類に応じて選択します。
- GET：画面でデータを取得する際に使用します。
- POST：画面から新規作成や登録操作を行う際に使用します。
- 「URL」に画面のURLを入力します。
└ 使用できる文字は、以下のとおりです。
【半角英数字】 a b c d e... A B C D E... 0 1 2 3 4 5...
【半角記号】 { } - _ / . *参考ルーティング定義でURLを設定する際の代表的なパターンを以下にまとめています。用途に応じて使い分けてください。
URL種別 設定例 説明 静的URL foo/bar/baz固定のパスのみで構成されたURL。常に同じ画面や処理にアクセスする場合に利用 動的URL foo/bar/{URLパラメータ}foo/{URLパラメータ1}/{URLパラメータ2}foo/{URLパラメータ}/bar/{URLパラメータ}一部に変数（URLパラメータ）を含むURL。パラメータ値によって表示するデータや処理内容を切り替える場合に利用 ワイルドカード foo/bar/*指定したパス配下の任意のURLにマッチさせる形式。幅広いURLパターンを1つのルーティングで処理したい場合に利用 ※ foo, bar, bazは、構造を示すためのダミー文字列です。
なお、動的URLに指定したURLパラメータは、アプリケーション画面の入力値としても利用できます。詳細は「CookBook - IM-BloomMaker 実行画面のURLの一部を入力値に割り当てる方法」を参照してください。
注意ルーティング定義でURLを設定する際には、以下の制約があります。
- 特殊な文字（
?, #, =, &, %, +）は利用できません。- URLの先頭は
/から始めず、相対的に指定してください。- URLはURLパラメータ
{ }から始めず、固定のパス要素を置いてください。- ワイルドカードから指定する形式
*/fooは利用できません。- 最初の要素をパラメータで指定する形式
{foo}/barは利用できません。- すべての要素をパラメータで指定する形式
{foo}/{bar}は利用できません。
- 「ルーティング名」にある「標準」の欄に名称を入力します。
└ 多言語対応では、「標準」以外の欄にも入力してください。- 必要に応じて、「備考」にある「標準」の欄に説明を入力します。
└ 多言語対応では、「標準」以外の欄にも入力してください。
ルーティング定義の登録
最後に、ルーティング定義の設定内容を保存します。
- ［登録］をクリックします。
└ 「アプリケーション管理」画面が表示されます。
└ 「公開URL」タブに画面のURLが追加されます。
ルーティング定義の認可を設定する
画面のURLに対して、画面を表示する側のユーザがアクセスできるかどうかを判定するために認可設定を行います。
- ［権限設定］をクリックします。
└ 権限設定メニューが表示されます。 - ［認可設定］をクリックします。
└ 「認可設定」画面が表示されます。
- 権限を変更したいセルをクリックします。
└
（許可）：権限が付与されている状態です。
└
（禁止）：権限がはく奪されている状態です。 - ［更新］をクリックします。
└ 「アプリケーション認可変更確認」ダイアログで［更新］をクリックします。
「ゲストユーザ」とは、intra-martにログインしていないユーザを指します。また、「認証済みユーザ」とは、intra-martにログインしているユーザを指します。「認証済みユーザ」に認可を設定することで、ログイン可能なすべてのユーザがルーティングを利用できるようになります。
アプリケーションを確認する
画面URLをコピーし、Webブラウザに貼り付けて表示内容を確認します。
- ［画面URLをコピー］または［
］をクリックします。
└ クリップボードにURLがコピーされます。 - WebブラウザのアドレスバーにURLを貼り付けます。
- アプリケーションの表示を確認します。
ここまでで、アプリケーション作成の基本的な流れを説明しました。アプリケーションの初期設定から始まり、データベース・ビジネスロジック・画面コンテンツを設定し、最後に画面のURL（ルーティング）を登録することで、実際にアクセス可能なアプリケーションを構築できました。「基本操作」を一通り体験することで、アプリケーション作成の基礎を理解できたのではないでしょうか。
次のステップとして、「応用操作」にも取り組んでみましょう。それぞれの場面で活用できる操作を取り入れることで、より柔軟で効率的にアプリケーションを構築できるようになります。
さらに、画面やロジックでは、「 【参考】基本設計」もあわせて確認すると、実際に開発するイメージが付きやすくなります。保存した設定は後から修正できるため、さまざまな操作を試してみてください。
本マニュアルで学んだ内容を土台として、応用操作にも挑戦し、開発の幅をさらに広げていきましょう。