Разделители

Разделитель — это символ, разделяющий разные поля в одной и той же строке. Разделять поля можно любыми символами ASCII, которые не присутствуют в именах или значениях импортируемых атрибутов. В одном и том же входном файле можно использовать несколько альтернативных разделителей. К обычным символам-разделителям относятся запятая, табуляция, точка с запятой и пробел.

Определения полей и значений

Во входном файле первая строка — это заголовок, который определяет поля для остальной части входного файла. Все остальные строки входного файла содержат значения для полей, указанных в первой строке.

Первая строка должна содержать хотя бы одно ключевое поле, которое определяет объекты модели или чертежи, и хотя бы одно имя пользовательского атрибута, которое определяет поле пользовательского атрибута, куда будут импортироваться новые значения. Обратите внимание, что имена многих полей отличаются от подписей полей, отображаемых в пользовательском интерфейсе. Имена пользовательских атрибутов определены в файлах objects.inp, относящихся к данной модели (см. инструкции по чтению этих файлов).

Файл конфигурации import_macro_data_types.dat, который будет рассмотрен ниже, определяет, какие поля можно использовать при импорте атрибутов, и какой тип данных имеет каждый из атрибутов. Добавлять или изменять ключевые поля нельзя, однако можно редактировать набор пользовательских атрибутов. Значения импортируются как строки (текст), если в файле import_macro_data_types.dat для атрибута не определен другой тип данных.

Доступные ключевые поля

Ключевые поля для объектов модели следующие:

Ключевые поля для объектов чертежей следующие:

Пустые значения

Некоторые строки входного файла могут не иметь значений для всех полей атрибутов (между значениями может быть два или более символа-разделителя подряд). Эти пустые значения можно либо пропустить во время импорта без внесения каких-либо изменений в пользовательские атрибуты, либо использовать эти пустые значения для стирания существующих значений пользовательских атрибутов в модели. По умолчанию пустые значения пропускаются. Чтобы удалить существующие значения, установите расширенный параметр XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK в INI-файле в значение TRUE.

Порядок считывания

Tekla Structures считывает входной файл по порядку начиная с первой строки. Если в последующих строках есть повторяющиеся ключевые поля, импортируется только первое вхождение.

Местоположение файлов

Файл данных по умолчанию находится в папке 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.

   Например, в определении attribute("USER_FIELD_1", "j_user_field_1", string, "%s", no, none, "0.0", "0.0") в файле objects.inp имя пользовательского атрибута — это 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 — ключевые поля. Tekla Structures добавляет несколько пользовательских атрибутов к сборкам, у которых значения совпадают со значениями в столбцах ASSEMBLY_POS и PHASE.

Например, сборка, у которой номер сборки (ASSEMBLY_POS) равен B5 и которая находится на стадии 1, получает следующие пользовательские атрибуты:

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. В этом случае Tekla Structures записывает в файл журнала сообщение «>Повторяющаяся запись во входном файле.» и импортирует только первую запись в файле. Поэтому в этом примере после импорта атрибутов сборка B1 будет иметь следующие пользовательские атрибуты:

STATUS: 7

USER_PHASE: 3

USER_ISSUE: 3/25/2019

Пример входного файла для чертежей

В качестве разделителя в этом входном файле используются символы табуляции.

TYPE и NAME являются ключевыми полями. Tekla Structures добавляет значение определенного пользователем атрибута User field 4 в чертежи со значениями, которые соответствуют значениям, указанным в столбцах TYPE и NAME.

Например, у чертежа с типом 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