FileMan ファイルの InterSystems IRIS クラスへの変換

生成される子テーブル名の形式を指定します。この設定の場合、次のキーワードと、テーブル名として有効な任意の文字を使用する文字列を指定します。

• <FILENAME> — FileMan ファイルの名前に置き換えられます

• <FILENUMBER> — ファイル番号に置き換えられます

• <PARFILENAME> — 親ファイルの名前に置き換えられます

• <PARFILENUMBER> — 親ファイルのファイル番号に置き換えられます

<FILENAME> または <PARFILENUMBER> を使用する場合、ファイル番号の小数点以下の文字はアンダースコア文字に変換されます。

この設定の例をいくつか示します。

• SUB_<FILENAME> — この例では、子テーブルのテーブル名は文字列 SUB_ の後ろにファイル名を付けたものです。例 ： SUB_ACCESSIBLE_FILE

• f<PARFILENUMBER>c<FILENUMBER> — この例では、子テーブルのテーブル名は文字列 f の後ろに親ファイルの番号、c、このファイルの番号を付けたものです。例 ：f200c200_032

• <FILENAME> — この例では、子テーブル名はファイル名と同じです。

OS オブジェクトのクラス・パラメータと値を JSON 形式で指定します。

クラスの作成後にコンパイルするかどうかを指定します。許可される値は、以下のとおりです。

• 1 — クラスをコンパイルします。

• 0 — クラスをコンパイルしません。

任意のクラス・コンパイラ修飾子やフラグを指定します。

FileMan DATE フィールドのマッピングで使用するデータ型を指定します。既定値は %Library.FilemanDateOpens in a new tab です。

FileMan DATE/TIME フィールドのマッピングで使用するデータ型を指定します。既定値は %Library.FilemanTimeStampOpens in a new tab です。

VA サイトのステーション ID を格納するために、テーブルに新しいフィールド VA_SITE を作成します。このフィールドは、複数の VA または FileMan サーバのデータを結合する際に、データのソースを指示するのに便利です。許可される値は、以下のとおりです。

• 1 — VA_SITE フィールドを作成します。

• 0 — VA_SITE フィールドを作成しません。

任意のクラス削除修飾子やフラグを指定します。

結果の表示方法を制御します。許可される値は、以下のとおりです。

• 0 — 表示しない。

• 1 — 最小表示。

• 2 — 全画面表示。これが既定値です。

ユーティリティが、ポインタ・フィールドを拡張するために追加の計算プロパティを作成するかどうかを指定します。許可される値は、以下のとおりです。

• 0 — ユーティリティは、ポインタ・フィールドを拡張するために計算プロパティを追加しません。

• 1 — ユーティリティは、ポインタ・フィールドを拡張する、参照先ファイルの NAME (.01) フィールドと等しい計算プロパティを追加します。

• 2 — ユーティリティは、ポインタ・フィールドを拡張する、参照先ファイルの NAME (.01) フィールドと等しい計算プロパティを追加します。このオプションに使用される命名規則では、ポインタ・フィールドは参照先ファイルの名前を取って命名され、フィールド名に “_ID” が追加されます。

• 3 – このオプションは、参照フィールドの名前が <Field>_f<pointed-to-file-id#>ID である点を除き 2 と同じです。

マップされる Set Of Codes フィールドごとに、拡張 SOC (SetOfCodes) テーブルを定義するかどうかを指定します。許可される値は、以下のとおりです。

• 1 — クラスにマップされる Set Of Codes フィールドごとに、ユーティリティは Set Of Codes の CODE と MEANING にマップされる読み取り専用のクラス/テーブルを生成します。テーブルの名前は <tablename>_SOC_<fieldname> です。SOC テーブルには 2 つのフィールドがあります。CODE は CODE の名前にマップされ、MEANING は CODE の外的意味です。このテーブルは ^DD グローバルに直接マップされるため、^DD グローバルの定義に対する更新は、テーブルから返される値に直ちに反映されます。

• 2 — これらの SOC クラス/テーブルは作成されません。これが既定値です。

拡張マッピングのために、マップ定義のグローバル名に挿入される文字列を指定します。例えば、["SD"] を指定すると、グローバルは ^LR(...) ではなく ^["SD"]LR(...) としてマップされます。

拡張グローバル・マッピングに使用できる任意の有効な文字列を指定できます。また、[...] または |...| 括弧を含める必要があります。

ユーティリティが SQL フィールド名を生成する方法を指定します。許可される値は、以下のとおりです。

• Exact — SQL フィールド名は、FileMan フィールド名とまったく同じ大文字/小文字を使用します。例えば、FileMan フィールド 'DEA EXPIRATION DATE' は SQL フィールド名 'DEA_EXPIRATION_DATE' になります。

• Upper — FileMan フィールド名の文字が大文字に変換されて、SQL フィールド名が生成されます。 例えば、FileMan フィールド 'DEA expiration date' は SQL フィールド名 'DEA_EXPIRATION_DATE' になります。

• Lower — FileMan フィールド名の文字が小文字に変換されて、SQL フィールド名が生成されます。 例えば、FileMan フィールド 'DEA EXPIRATION DATE' は SQL フィールド名 'dea_expiration_date' になります。

• Pascal — 識別子の最初の文字と、それに続く各連結語の最初の文字が大文字で表示されます。また、スペースとアンダースコアは削除されます。例えば、FileMan フィールド 'DEA EXPIRATION DATE' は SQL フィールド名 'DeaExpirationDate' になります。

• Camel — 識別子の最初の文字は小文字で表示され、それに続く各連結語の最初の文字は大文字で表示されます。また、スペースとアンダースコアは削除されます。 例えば、FileMan フィールド 'DEA EXPIRATION DATE' は SQL フィールド名 'deaExpirationDate' になります。

IEN フィールドの名前を指定します。既定値は IEN です。

JSON アダプタ機能をマップされたクラスで使用できるようにします。JSONAdaptor の値は、クラスのパラメータと値の JSON 形式文字列です。許可されるパラメータは、以下のとおりです。

• %JSONENABLED

• %JSONIGNOREVALIDFIELD

• %JSONNULL

• %JSONIGNORENULL

• %JSONREFERENCE

• ComputedAlwaysJSONINCLUDE

JSONAdaptor パラメータの詳細は、クラス・リファレンスの "%JSON.AdaptorOpens in a new tab" を参照してください。

ComputedAlwaysJSONINCLUDE では、Calculated および SqlComputed として定義されたプロパティの %JSONINCLUDE プロパティ・パラメータを指定できます。

最適な結果を得るには、次の設定にすることをお勧めします。

• %JSONEREFERENCE を ID に設定します。

• ComputedAlwaysJSONINCLUDE を OUTPUTONLY に設定します。

ユーティリティが出力をログ記録するファイルの名前を指定します。ファイル名を入力します。

このユーティリティが作成するプロパティ名、外部キー名、トリガ名の最大文字数を指定します。既定値は 180 です。これは、最新リリースでの InterSystems IRIS クラス・メンバ名の文字数の増加に対応しています。 これらのアイテムの名前を、以前の短い最大文字数 (31 文字) のときのままにするには、このオプションを使用します。

作成されたクラスの所有者として使用するユーザ名を指定します。既定値は、$Username の現在の値です。

クラスを作成するパッケージの名前を指定します。

生成されたクラスを読み取り専用にするかどうかを指定します。許可される値は、以下のとおりです。

• 1 — 読み取り専用クラスを生成します。

• 0 — 読み込み/書き込みクラスを生成します。

サブファイルとポインタもマップするかどうかを指定します。許可される値は、以下のとおりです。

• 0 — 再帰なし。このファイルのみがマップされます。サブファイルやポインタはマップされません。

• 1 — 部分再帰。ファイルは、1 レベルのサブファイルおよびポインタと共にマップされます。

• 2 — 完全再帰。ファイルは、すべてのサブファイルおよびポインタと共にマップされます。これが既定値です。

どの必須 FileMan フィールドを必須プロパティとして定義するかを制御します。許可される値は、以下のとおりです。

• 1 — 必須とマークされる FileMan フィールドが、必須プロパティとして定義されます。これが既定値です。

• 0 — 必須識別子として定義される FileMan フィールドのみが、必須プロパティとして定義されます。

クラスが既に存在する場合、クラス全体を再作成するかどうかを指定します。許可される値は、以下のとおりです。

• 0 — ユーティリティはクラスを削除して再作成します。つまり、SQL 特権およびクラスへのアドオンは失われます。

• 1 — ユーティリティはクラス全体ではなく、プロパティ、ストレージ、インデックス、外部キーなどを再作成します。注 ：

  Note:

  • 独自のアイテムをクラス定義に手動で追加する前に、InterSystems IRIS 2010.2 以降で少なくとも 1 回、FM2Class ユーティリティを実行しておく必要があります。以前のバージョンでは、この機能に必要な必須メタデータが保存されないためです。

  • クラスをマップした後、クラスを別のネームスペースまたは別のシステムに移動して、RetainClass を 1 に設定して新しい場所から再びマッピングを試みる場合は、^oddFMD グローバルも手動で移動/コピーする必要があります。このグローバルには、RetainClass 設定で必要なメタデータが格納されているためです。

  • RetainClass 設定は、expandSetOfCodes を 1 に設定した場合に作成される SOC クラスと連携するようにはなっていません。つまり、独自のパラメータ、プロパティ、インデックスなどをこれらのクラスに追加した場合、RetainClass を 1 に設定してもそれらの変更は保持されません。

Set Of Codes フィールドのマッピングで使用するデータ型を指定します。オプションは %Library.EnumStringOpens in a new tab (既定値) と %Library.StringOpens in a new tab です。

%Library.EnumStringOpens in a new tab を使用すると、OdbcToLogical() メソッドと LogicalToOdbc() メソッドが提供され、xDBC クライアント・アプリケーションのコード値ではなく、Set Of Codes の意味を利用できるというメリットが得られます。

生成されるクラスで %Library.FilemanDateOpens in a new tab および %Library.FilemanTimeStampOpens in a new tab 型のプロパティの定義に STRICTDATA=1 を含めるかどうかを指定します。

この STRICTDATA パラメータは、これらのデータ型の LogicalToOdbc() メソッドと LogicalToDisplay() メソッドに影響します。STRICTDATA=0 の場合 (既定値)、メソッドには以前と同じコードが含まれます。STRICTDATA=1 の場合、LogicalToFormat() メソッドの無効な論理日付値および時刻値を処理するコードは削除されます。データベースに無効な、または不完全な日付値または時刻値が含まれていて、正しいデータを想定したくない場合は、STRICTDATA=1 を使用します。

マップされるクラスごとにスーパークラス・リストを指定します。クラス名のコンマ区切りリストを含む文字列を指定します。

生成されるテーブル名の形式を指定します。この設定の場合、次のキーワードと、テーブル名として有効な任意の文字を使用する文字列を指定します。

• <FILENAME> — FileMan ファイルの名前に置き換えられます

• <FILENUMBER> — ファイル番号に置き換えられます

<FILENAME> を使用する場合、ファイル番号の小数点以下の文字はアンダースコア文字に変換されます。

childTableNameFormat の例を参照してください。

変数ポインタ・フィールドを処理する方法を指定します。許可される値は、以下のとおりです。

• 1 — マップされる変数ポインタ・フィールドごとに、FM2Class は、変数ポインタ・フィールド値を拡張する、参照先ファイルの .01 フィールドと等しい計算プロパティも作成します。 このフィールドには、<Variable_Pointer_Field_VALUE> という名前が付けられます。

  例えば、FM 変数ポインタ・フィールド WHO は、EMPLOYEE ファイルまたは PATIENT ファイルを指すように定義されます。既定では、FM2Class は 2 つのフィールドを作成します (EMPLOYEE ファイルを指すフィールドと PATIENT ファイルを指すフィールド)。これらのフィールドのうち 1 つのみが NULL 以外になります。WHO が EMPLOYEE の場合、WHO_EMPLOYEE フィールドには EMPLOYEE の ID/IEN が含まれます。WHO が PATIENT の場合、WHO_PATIENT には PATIENT の ID/IEN が含まれます。

  FM2Class は 3 つ目のフィールド WHO_VALUE も作成します。このフィールドは、WHO が EMPLOYEE を指す場合は EMPLOYEE レコードの .01 フィールドに計算され、WHO が PATIENT を指す場合は PATIENT レコードの .01 フィールドに計算されます。

• 0 — FM2Class はこの 3 つ目のフィールドを作成しません。

ワード・プロセッシング・フィールドのマップ方法を指定します。許可される値は、以下のとおりです。

• 0 — 子テーブルとして変換します。

• 1 — リスト・コレクションとして変換します。

• 2 — リスト・コレクションと子テーブルの両方として変換します。

• 3 — 単一の長い文字列フィールドとして変換します。