Skip to main content

This is documentation for Caché & Ensemble. See the InterSystems IRIS version of this content.Opens in a new tab

For information on migrating to InterSystems IRISOpens in a new tab, see Why Migrate to InterSystems IRIS?

REST サービス向けの Ensemble の構成

この付録では、Ensemble の CSP ポートを通じて REST サービスを使用できるようにシステムを構成する方法を簡単に説明します。ここで紹介する情報は、これらのサービス用の開発システムやテスト・システムをセットアップするのに役立ちます。これらのトピックに関する包括的な情報は、Caché ドキュメントに記載されています。詳細は、"Caché システム管理ガイド" の “Caché の構成” を参照してください。

Ensemble の開発システムまたはテスト・システムを REST サービス向けにセットアップするには、以下の手順を実行します。

  1. ロックダウンされたインストール環境に Ensemble をインストールした場合は、スタジオへのアクセスは無効になっています。管理ポータルを開いてスタジオへのアクセスを有効にします。

    1. Ensemble キューブから管理ポータルを開始します。管理ポータルにアクセスするには、_system ではなく Windows のログイン・ユーザ名を使用する必要があります。インストール時に指定したパスワードを入力します。

    2. [システム管理][セキュリティ][サービス] の順に選択して、[サービス] ポータル・ページを表示します。

    3. デフォルトでは、%Services_Bindings サービスは無効になっています。このサービス名を選択して、[サービス有効] チェックボックスにチェックを付けて、設定を保存します。

  2. 既存の Ensemble ネームスペースを使用しない場合は、新しいネームスペースを作成します。

    1. [システム管理][構成][システム構成][ネームスペース] の順に選択して、[ネームスペース] ポータル・ページを表示します。

    2. [新規ネームスペース作成] ボタンをクリックして、ネームスペースの名前を指定します (例 : SERVICESNS)。

    3. グローバル用データベースについて [新規データベース作成] ボタンをクリックします。

    4. データベース・ウィザードで、グローバル用データベースの名前を入力します (例 : SERVICES_GDB)。ウィザードはこの名前を使用して、このデータベース用のディレクトリを作成します。

    5. [次] ボタンを 2 回クリックして、[データベースリソース] フォームを表示します。[新規リソース作成] ラジオ・ボタンを選択します。ウィザードで [新規リソース作成] フォームが表示されます。表示されている名前 (%DB_SERVICES_GDB など) をそのまま使用して、[パブリック許可] の [読み込み] と [書き込み] というチェックボックスのチェックが外れていることを確認します。[データベースリソース] フォームの [保存] ボタンをクリックして、[データベースウィザード] フォームの [完了] ボタンをクリックします。

    6. ルーチン用データベースについて手順 c から e を繰り返します。

    7. [保存] ボタンをクリックして、ネームスペースの作成を完了します。

    8. [閉じる] をクリックしてログを閉じます。

  3. 空のロールを作成して、このロールを不明ユーザに割り当てます。

    1. [システム管理][セキュリティ][ロール] の順に選択して、[ロール] ポータル・ページを表示します。

    2. [新規ロール作成] ボタンをクリックして、ロールに名前を付けて (例 : Services_Role)、[保存] ボタンをクリックします。

    3. [メンバ] タブを選択して、[不明ユーザ] を選択し、右矢印をクリックして、[割り当てる] ボタンをクリックします。

  4. Ensemble の CSP ポートへの呼び出しを処理する Web アプリケーションを定義します。この Web アプリケーションの名前によって、サービスを呼び出す URL のルートが指定されます。単一の Web アプリケーションは複数のビジネス・サービスをサポートできますが、これらのビジネス・サービスはすべて、同じクラスを持っているか、その Web アプリケーションのディスパッチ・クラスのサブクラスを持っている必要があります。

    1. [システム管理][セキュリティ][アプリケーション][Web アプリケーション] の順に選択して、[Web アプリケーション] ポータル・ページを表示します。[新規 Web アプリケーション作成] ボタンをクリックします。

    2. この Web アプリケーションに名前を付けます (例 : /weatherapp/math/sum)。名前の先頭には / (スラッシュ) を付加する必要があります。

    3. [ネームスペース] で、当該プロダクションが実行されているネームスペースを指定します (例 : SERVICESNS)。[ネームスペースのデフォルト・アプリケーション] チェックボックスのチェックは外したままにします。

    4. [アプリケーション]、[CSP/ZEN]、および [受信 Web サービス] の各チェックボックスにはチェックを付けてもかまいません。

    5. [必須リソース] フィールドと [ID でグループ分け] フィールドは空白のままにします。

    6. [許可された認証方法] 行の [認証なし] チェックボックスにチェックを付けます。

    7. [ディスパッチ・クラス] でコンポーネント・クラスを指定します (例 : EnsLib.REST.ServiceOpens in a new tab)。

    8. [保存] をクリックします。

    9. [マッチングロール] タブを選択します。

    10. [マッチングロールを選択:] フィールドで、前の手順で作成したロールを選択します。

    11. [選択されたマッチングロールに対して追加するターゲットロールを選択] フィールドで、当該ネームスペースのグローバルとルーチンに関連付けられた 1 つまたは複数のロールを選択します。これらのグローバルとルーチンは、同じデータベース内にあっても別々のデータベース内にあってもかまいません。お使いのサービスが別の Caché データベースにアクセスする場合は、そのデータベースのロールも選択する必要があります。例えば、ENSDEMO 内の Demo.REST.DirectoryServiceOpens in a new tab クラス向けの Web アプリケーションを定義する場合は、%DB_SAMPLES ロールも選択する必要があります。複数のロールを選択するには、Ctrl キーを押しながら選択します。

      Note:

      グローバル用データベースには、二次データベースおよび対応するロールも存在する場合があります (例 : %DB_GDBSECONDARY)。この二次データベースにはパスワードが保管されます。パススルー・サービスとパススルー・オペレーションのためにこのデータベースにアクセスする必要はありませんが、パスワード・アクセスを使用するカスタム Web サービスを作成する場合は、二次データベースのロールをターゲット・データベースに追加する必要もあります。

    12. 選択したロールがハイライト表示された状態で、右矢印をクリックしてこれらのロールを [選択済み] テキスト・ボックスに移動します。

    13. [割り当てる] ボタンをクリックします。

これで、システム構成が完了しました。

FeedbackOpens in a new tab