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?

ルーチンおよびインクルード・ファイルを使用した作業

ルーチンは、Caché サーバ内での実行の単位です。Caché サーバで動作するすべてのアプリケーション・ロジックは、ルーチンおよびルーチン内のエントリ・ポイントを呼び出すことによって実行されます。ルーチンは、Caché サーバ環境に組み込まれた仮想マシンで実行されます。ルーチンは、Caché でサポートされているすべてのプラットフォームへ移植可能であり、Caché 環境で自動的に共有されます。

インクルード・ファイル (.inc ファイル) は、マクロ定義 (またはその他のインクルード・ファイル) を含み、.mac ルーチンまたはクラス定義にインクルードできます。マクロの詳細は、"Caché ObjectScript の使用法" の “マクロの使用” のセクションを参照してください。

ルーチン・エディタ

ルーチン・エディタでは、ルーチンまたはインクルード・ファイルのソースを直接作成したり、編集することができます。クラス定義がコンパイルされるとき、クラス・コンパイラでは、そのクラスの実装が含まれた一連のルーチンが生成されます。[生成されたソース・コードを保存] ([ツール]→[オプション] ダイアログの [コンパイラ]→[一般フラグ] タブ) にチェックが付いている場合は、この生成されたソース・コードを表示し、編集することもできます。

ルーチン・エディタでは、構文のカラー表示がサポートされており、構文エラーは赤い波線で示されます。

ルーチン・ソース形式

Caché には、数種類のルーチン・ソース形式 (ファイル) があります。ルーチン・エディタでは、これらすべての形式に対して構文のカラー表示がサポートされています。形式には以下のものがあります。

  • BAS —.bas 拡張子を持つ Basic ソース・ファイル。

  • MAC —.mac 拡張子を持つマクロ・ソース・ファイル。このファイルは、マクロ、埋め込み SQL 文、および埋め込み HTML を解決するために Caché マクロ・プリプロセッサで処理されます。処理の結果、.int ファイルが生成されます。

  • INT — 中間ソース・ファイル。このファイルは実行可能な Caché オブジェクト (OBJ) コードに直接コンパイルされます。

  • INC — インクルード・ファイル。本質的にはルーチンではありません。.inc ファイルには、マクロ定義があり、その定義は .mac ルーチンによるインクルードが可能です。

既定では、新規の ObjectScript ルーチンを作成するとき、そのルーチンは .mac ルーチンとして保存されます。このルーチンを異なるタイプのルーチンとして保存するには、[ファイル]→[名前を付けて保存] を選択します (例えば、拡張子を .mac から .int に変更します)。

[ビュー] → [他の表示] を使用すると、.int コードを対応する .mac ファイルで表示でき、その逆も可能です。

新規のルーチンまたはインクルード・ファイルの作成

新規のルーチンまたはインクルード・ファイルを作成するには、[ファイル]→[新規作成] を選択します。ダイアログに、選択可能なテンプレートが表示されます。ルーチンとしては、ObjectScript ルーチンまたは Caché Basic ルーチンを選択できます。インクルード・ファイルとしては、[ObjectScript] を選択します。これにより、Untitled などの既定名が付いた新規のルーチン・エディタ・ウィンドウが表示されます。これは、[ファイル]→[名前を付けて保存] を使用すると、異なる名前を付けて保存できます。

既存のルーチンまたはインクルード・ファイルを開く

既存のルーチンを開くには、[ファイル]→[開く] を使用します。[ファイルの種類] ドロップダウン・リストで、必要なファイル拡張子を選択し (.mac.int、または全ファイルなど)、ルーチンを選択します。

以前に保存したルーチンまたはインクルード・ファイルを開くときは、[開く] ダイアログで、* や ? を使用したワイルドカード・マッチングによって、使用可能なルーチンまたはインクルード・ファイルのリストを表示できます。* (アスタリスク) は任意の文字列と一致し、? (疑問符) は任意の 1 文字と一致します。BAS、MAC、INT、INC というルーチン・タイプは、ワイルドカード・マッチングのためのファイル拡張子として使用されています。

ルーチン・テンプレート・ファイル

新規のルーチンをスタジオで作成するとき、スタジオでは新規のルーチン・エディタ・ウィンドウが開かれます。ルーチン・テンプレート・ファイルが存在する場合は、それが新しいファイルにコピーされます。ルーチン・テンプレート・ファイルを作成するには、テンプレートに含めるコンテンツを使用してファイルを作成します。ファイルをスタジオの実行可能ファイル (CStudio.exe) と同じディレクトリに Default.mac として保存します。

ルーチンの保存、コンパイル、および削除

ルーチンをデータベースに保存するには、[ファイル]→[保存] または [ファイル]→[名前を付けて保存] を選択します。既定では、ルーチンを保存しても自動的にコンパイルは行われません。この動作を変更するには、[ツール]→[オプション] ダイアログの [コンパイル]→[動作] で [保存時にルーチンをコンパイル] にチェックを付けます。

ルーチンを直接コンパイルするには、[ビルド]→[コンパイル] を使用します (これにより、ルーチンは保存されます)。

ルーチンを削除するには、ワークスペース・ウィンドウで、ルーチンをハイライト表示して、[編集]→[削除] を選択します。ルーチンと生成されたすべてのファイルが削除されます。

ルーチン、インクルード、および CSP ファイルのバックアップの自動保存

既存のルーチン (またはインクルードまたは CSP ファイル) を保存する際、スタジオでは自動的にバックアップ・ファイルを作成します。最大 5 つのバックアップ・ファイルを、;# (セミコロンと数字) 接尾語を使用した名前を付けて保存します。例えば、setup.MAC という名前のファイルを 6 回保存した場合は、次のように名前が付けられた 5 つのバックアップ・ファイルがあります。

setup.MAC;1
setup.MAC;2
setup.MAC;3
setup.MAC;4
setup.MAC;5

特に、次の拡張子を持つファイルは、自動的にバックアップされます。.BAS.INC.INT.MAC.OBJ.MVB.MVI.CSP

どのバックアップ・ファイルが存在するかを確認するには、[ファイル]→[開く] オプションの検索フィールドにセミコロンを使用します。使用できる構文例は以下のとおりです。

*.*;* は、このフォルダ内のすべてのバックアップ・ファイルを表示します。

*.mac;* は、.MAC 拡張子を持つすべてのバックアップ・ファイルを表示します。

setup.*;* は、setup という名前を持つすべてのバックアップ・ファイルをリストします。

これらのバックアップ・ファイルは、管理ポータルのシステム, ルーチン ページの [ルーチンおよびインクルード・ファイル] ボックスでこの構文を使用して検索することもできます。

FeedbackOpens in a new tab