入力ファイルの区切り文字

区切り文字は、同じ行の異なるフィールドを区切る文字です。

インポートする属性の名前や値には表示されない ASCII 文字を使用してフィールドを区切ることができます。同じ入力ファイルに複数の代替区切り文字を使用することができます。共通の区切り文字には、コンマ、タブ、セミコロン、およびスペースなどがあります。

入力ファイルのフィールドと値の定義

入力ファイルは、1 行目が見出しです。見出しは、入力ファイルの残りのフィールドを定義します。入力ファイルの他のすべての行には、1 行目で指定したフィールドの値が含まれます。

1 行目には、モデル オブジェクトや図面を特定する 1 つ以上のキー フィールド、および新しい値のインポート先となるユーザー定義情報のフィールドを特定する 1 つ以上のユーザー定義情報名が含まれている必要があります。フィールドの多くでは、その名前が、ユーザー インターフェイスに表示されるフィールドのラベルとは異なることに注意してください。ユーザー定義情報名は、モデルに適用される objects.inp ファイル で定義されます (ファイルの読み取り方法に関する項を参照してください)。

設定ファイル import_macro_data_types.dat (後述) は、属性インポートで使用できるフィールド、および各属性のデータ タイプを定義しています。キー フィールドは追加または変更できませんが、ユーザー定義情報のセットは編集できます。値は、import_macro_data_types.dat ファイルの属性に異なるデータ タイプが定義されている場合を除き、文字列 (テキスト) としてインポートされます。

入力ファイルの使用可能なキー フィールド

モデル オブジェクトのキー フィールドを以下に示します。

図面オブジェクトのキー フィールドを以下に示します。

入力ファイルの空の値

入力ファイルの行によっては、一部の属性フィールドの値が設定されていないことがあります。たとえば、値間に複数の連続する区切り文字が存在することがあります。

こうした空の値は、インポートの際にユーザー定義情報を一切変更することなくスキップするか、モデルの既存のユーザー定義情報の値を消去するために使用できます。デフォルトでは、空の値はスキップされます。一方、既存の値をクリアするには、ini ファイルで詳細設定 XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK を TRUE に設定します。

入力ファイルの読み込み順序

Tekla Structures では、1 行目から順番に入力ファイルが読み込まれます。続く行でキー フィールドに重複がある場合、最初に読み込まれたものだけがインポートされます。

データ ファイルの場所

デフォルトのデータ ファイルは、環境フォルダの system フォルダ (C:\ProgramData\Trimble\Tekla Structures\<version>\environments\common\system など) にあります。ご使用の環境に、ローカライズされたバージョンのファイルがある場合もあります。

デフォルト ファイルを変更しないでください。代わりに、ファイルのコピーを作成して、企業フォルダ や、モデル フォルダにある attributes フォルダなど、異なる場所に保存します。こうすることで、Tekla Structures を再インストールしたりアップグレードしたりしても、変更が上書きされません。同じファイルが複数の場所にある場合は、デフォルトのフォルダ検索順序 に従って、読み取られた最初のファイルのみが使用されます。

データ ファイルの内容

import_macro_data_types.dat ファイルはプレーン テキストです。ファイルは、メモ帳などの標準のテキスト エディタを使用して変更できます。

ファイルの各行はフィールドの定義であり、以下の属性を次の順序で記載します。

User-defined attribute name,Data type,Conversion factor,Comments

1. User-defined attribute name.objects.inp ファイルのフィールドに対して定義されたものと同じ内部フィールド名を書き込みます。

   たとえば、objects.inp 定義 attribute("USER_FIELD_1", "j_user_field_1", string, "%s", no, none, "0.0", "0.0") では、ユーザー定義情報名は USER_FIELD_1 です。

2. Data type.

   値として使用できるものは次のとおりです。INT (整数)、STRING (テキスト)、FLOAT (小数)、または DATE (カレンダー ウィジェットの日付フィールド)値が見つからないか、正しくない場合、値はデフォルトの STRING になります。

   値のタイプが一致していなくてもデータはインポートされますが、データやフィールドによっては、結果が正しいとは限らない場合があります。たとえば、データ タイプが DATE ではない場合、日付フィールドが正しく設定されないことがあります。ただし、整数型の番号をテキスト フィールドには問題なくインポートできます。

   オプション リストのフィールドは、INT 値タイプの数値フィールドとして定義されています。たとえば、オブジェクト ロックは [いいえ]、[はい]、[組織] (入力ファイルの数値 0、1、2 に対応) に設定できます。

3. Conversion factor (オプション、FLOAT のみ)。フィート・インチ環境において、フィート・インチ値をメートル値に変換する際に使用されます。

   注:

   変換係数の誤差が生じないように、FLOAT 値を確認することをお勧めします。

4. Comment (オプション)。前回の定義に従う文字は無視され、コメントを書くために使用できます。ただし、定義と同じ行にコメントを追加しないことをお勧めします。コメントを個々の行に書き込むと、ファイルが読みやすくなります。

Tekla Structures では、二重スラッシュ文字 (//) で始まる行はコメントと見なされ、ファイルの読み込み時には行全体が無視されます。

例:

//Regular attributes

R1_ISSUED_FOR_APPRL, STRING
R1_DATE_APPROVED, DATE

//Attribute with conversion factor and comment

shear1, FLOAT, 4448.2222, For kips

部材の入力ファイルの例

この入力ファイルは、タブ区切りです。

ASSEMBLY_POS と PHASE がキーフィールドです。ASSEMBLY_POS 列と PHASE 列に示されている値と一致する値を持つ製品に、ユーザー定義情報が Tekla Structures によっていくつか追加されます。

たとえば、ASSEMBLY_POS (製品マーク) が フェーズ 1 の B5 である製品には、以下のユーザー定義情報が設定されます。

STATUS:3

USER_PHASE:6

USER_ISSUE:3/25/2019

ASSEMBLY_POS  PHASE  STATUS  USER_PHASE  USER_ISSUE
B1  1  7  3  3/25/2019
B2  1  7  3  3/25/2019
B3  1  7  3  3/25/2019
B4  1  7  3  3/25/2019
B5  1  3  6  3/25/2019
B1  1  3  5  3/26/2019
B2  2  3  4  3/26/2019

この入力ファイルには、B1 のエントリが 2 つあります。この場合、Tekla Structures によってログ ファイルに「>入力ファイルに重複したデータがある。」というメッセージが書き込まれ、最初のエントリのみがファイルにインポートされます。したがってこの例では、B1 は属性インポート後、以下のユーザー定義情報を持つようになります。

STATUS:7

USER_PHASE:3

USER_ISSUE:3/25/2019

図面の入力ファイルの例

この入力ファイルは、タブ区切りです。

TYPE と NAME がキー フィールドです。TYPE 列と NAME 列に示されている値と一致する値を持つ図面に、ユーザー定義情報の値 User field 4 が、Tekla Structures によって追加されます。

たとえば、TYPE A (製品図) と NAME B.2 の図面には、User field 4 の値 4 が割り当てられます。

TYPE  NAME  DRAWING_USERFIELD_4
A  B.1  3
A  B.2  4
A  C.1  1
A  C.2  2