ネームスペースの構成

相互運用対応ネームスペースの作成

InterSystems IRIS インスタンスでネームスペースを作成する場合、[ネームスペースを相互運用プロダクション対応にする] チェック・ボックスが [新規ネームスペース] ページの最下部に表示され、自動的にチェックが付きます。相互運用対応でないネームスペースを作成するには、このチェック・ボックスをクリアしてから [保存] をクリックします。

このチェック・ボックスをクリアせずに相互運用対応のネームスペースを作成すると、以下のように、システムにより自動的にこの新規ネームスペース用の追加構成タスクが実行されます。

• このネームスペースの既定グローバル・データベースが既存のデータベースである場合、そのデータベースで一部のクラスのアップグレードとリコンパイルが実行されます。

  Caution:

  他のネームスペースでもこのデータベースを使用している場合、この変更が適切でないことがあります。InterSystems IRIS インスタンスで新規ネームスペースを作成する場合は、既存データベースの再使用がこのネームスペースに対して適切であるかどうか注意深く検討してください。

• これにより、グローバル・マッピング、ルーチン・マッピング、およびパッケージ・マッピングが定義され、InterSystems IRIS システムのクラスおよびデータがこのネームスペースで使用可能になります。

• ノードが ^%SYS グローバルに追加されます。

• InterSystems IRIS で必要となるアプリケーション名 /csp/namespace を使用して、このネームスペースの Web アプリケーションが作成されます。

医療用途の相互運用性向けの Foundation ネームスペースの作成

医療用途の相互運用性向けに Foundation ネームスペースと Foundation プロダクションを作成するには、InterSystems IRIS for Health™ のインストーラ・ウィザードまたは HealthShare® HealthConnect のインストーラ・ウィザードを使用します。[新規ネームスペース] ページは使用しません。インストーラ・ウィザードで Foundation ネームスペースを有効にしておくと、後でルーチン・データベースなどのオプションの変更が必要になった場合でも [ネームスペース] ページを使用して処理できます。

グローバル・マッピング

グローバルおよびグローバル・サブスクリプト・レベルで、ネームスペースに新規グローバルのマッピングを追加し、そのマッピングをそのネームスペースのグローバルに対する既定のデータベース・マッピングよりも優先させるようにできます。

1. [ネームスペース] ページに移動して ([システム管理]→[構成]→[システム構成]→[ネームスペース])、グローバルをマッピングするネームスペースの行で [グローバルマッピング] をクリックします。

2. [グローバルマッピング] ページで、[新規] をクリックします。

3. グローバルが配置されるデータベースの [グローバル・データベースの位置] を選択します。

4. [グローバル名] を入力します。ABC* のようにグローバル名の一部として * 文字を使用すると、複数のグローバルを指定できます。

5. [マップするグローバルサブスクリプト] を入力します。添え字参照は開き括弧で始まる必要があります。以下はその例です。

   (1)
   ("A")
   (1):(5)
   ("A"):("Z")
   ("B",23,"m"):("E",5)
   (BEGIN):("X")
   ("Y"):(END)
   

   Note:

   範囲 (例 ： ("A"):("Z")) を指定する場合、指定された添え字の範囲は “～から、～以内” ではなく “～から、～未満” になります。つまり、定義された添え字範囲の下限は含まれますが、上限は含まれないことになります。例えば、Name (1):(10) の場合、Name (1) は含まれますが、Name (10) は含まれません。範囲の上限を除外することによって、添え字の範囲を Name ("a"):("b") のように指定して処理すると、Name ("aa") および Name ("aaaaa") を含め Name ("b") の直前までを有効範囲とする上限境界を指定できます。

   予約語 BEGIN および END を使用して、使用可能な先頭および最後の添え字を示すことができますが、グローバルの添え字は個別にマッピングする必要があるため、添え字のあるグローバルで アスタリスク (*) を使用することはできません。

   添え字レベル・マッピング (SLM) の範囲に関する詳細は、"グローバルの使用法" の “グローバル構造” の章の "グローバル・マッピングの設定" を参照してください。

6. [詳細] をクリックすると、以下のオプションが表示されます。

   1. [照合] を選択します。照合は新規添え字レベルのマッピング・グローバルのみに適用されます。

   2. [ロックデータベース位置] を選択します。詳細は、"構成パラメータ・ファイル・リファレンス" の “[Map]” セクションの "Global" を参照してください。

7. [OK] をクリックします。

   Note:

   新規のマッピング行の最初の列に表示される [>>] は、マッピングを編集可能で開いていることを示します。

8. マッピングを cpf ファイルに保存するには、[変更を保存] をクリックします。

ルーチン・マッピング

ルーチン・レベルでネームスペースにマッピングを追加すると、そのマッピングでそのネームスペースのルーチンに対する既定のデータベース・マッピングをオーバーライドできます。

1. [ネームスペース] ページに移動して ([システム管理]→[構成]→[システム構成]→[ネームスペース])、グローバルをマッピングするネームスペースの行で [ルーチンマッピング] をクリックします。

2. [ルーチンマッピング] ページで、[新規] をクリックします。

3. ルーチンが配置される [ルーチン・データベースの場所] のデータベースを選択します。

4. [ルーチン名] を入力します。このルーチンは、マッピングの際に存在していなくてもかまいません (つまり、作成を計画しているルーチンの名前を使用できます)。

5. [OK] をクリックします。

   Note:

   新規のマッピング行の最初の列に表示される [>>] は、マッピングを編集可能で開いていることを示します。

6. マッピングを cpf ファイルに保存するには、[変更を保存] をクリックします。

例えば、前出のテスト・ネームスペース・マッピングを例にして考えてみましょう。airports データベース (FlightSchedule ネームスペース内) でスケジュール・ルーチン (例えば BOSZZairline) を作成し、TravelAgent ネームスペースのユーザに利用を許可する計画がある場合、[ルーチンマッピング] ページ (TravelAgent ネームスペース行) に移動して、[新規ルーチンマッピング] をクリックします。下図の [ルーチン・マッピング] ダイアログ・ボックスに情報を入力します。

パッケージ・マッピング

クラス・パッケージ・マッピングを追加すると、特定のデータベースのパッケージにあるすべてのクラス (および、それらのクラスの生成されたすべてのルーチン) を、別のネームスペースから認識できるようになります。

1. [ネームスペース] ページに移動して ([システム管理]→[構成]→[システム構成]→[ネームスペース])、パッケージをマッピングするネームスペースの行で [パッケージマッピング] をクリックします。

2. [パッケージマッピング] ページで、[新規] をクリックします。

3. パッケージが配置される [パッケージデータベース位置] のデータベースを選択します。

4. [パッケージ名] を選択します。このパッケージは、マッピングの際に存在していなくてもかまいません (つまり、作成を計画しているパッケージの名前を使用できます)。新規パッケージ名を指定する手順は以下のとおりです。

   1. [新規パッケージ] をクリックします。

   2. [新規パッケージ名] テキスト・ボックスに名前を入力します。

5. [OK] をクリックします。

   Note:

   新規のマッピング行の最初の列に表示される [>>] は、マッピングを編集可能で開いていることを示します。

6. マッピングを cpf ファイルに保存するには、[変更を保存] をクリックします。

パッケージの説明とそのマッピング手順は、"クラスの定義と使用" の “パッケージ” の章の "パッケージ・マッピング" のセクションを参照してください。

すべてのネームスペースへのデータのマッピング

グローバル、ルーチン、およびパッケージは、特定のネームスペースにマッピングされるだけではなく、すべてのネームスペースにマッピングすることもできます。この形式のマッピングを有効にするには、以下を行います。

1. まず、%ALL という名前のネームスペースを作成します ("ネームスペースの作成/変更" のセクションを参照)。

   Note:

   %ALL は、データのマッピング時以外は表示されません。つまり、これは現実のネームスペースではなく、すべてのネームスペースにデータをマッピングするための機能です。

2. 次に、%ALL ネームスペースで目的のマッピングを行います ("ネームスペースへのグローバル、ルーチン、およびパッケージ・マッピングの追加" のセクションを参照)。

これらの %ALL マッピングは、すべてのネームスペースに適用されます。%ALL ネームスペースでマップされているリソースに対する、ネームスペース固有のマッピングを作成することはできません。%ALL のマッピングが、同じリソースへのすべてのネームスペース固有のマッピングをオーバーライドするためです。

%ALL ネームスペースに添え字レベルのマッピングを作成する場合、ルート・グローバルのマッピングが %DEFAULTDB に自動的に作成されます。%DEFAULTDB 変数は、任意のネームスペースの既定のデータベースを表します。