Импорт значений пользовательских атрибутов
В модель можно импортировать значения пользовательских атрибутов из текстового файла. Например, можно импортировать список изготовленных или проверенных сборок. Также путем импорта атрибутов можно удалить существующие значения пользовательских атрибутов.
Значения атрибутов можно импортировать в объекты модели Tekla Structures, чертежи и некоторые объекты опорных моделей (если атрибуты настроены; см. раздел Добавление пользовательских атрибутов в опорных моделях). Помимо задания критериев соответствия для импортируемых атрибутов во входном файле, можно также ограничить область импорта выбранными в модели объектами или объектами опорных моделей.
Входной файл может быть:
-
экспортирован из другого программного обеспечения;
-
создан вручную с помощью любого стандартного текстового редактора, например Блокнота;
-
создан в Microsoft Excel путем сохранения файла с помощью команды Сохранить как в формате Текст с разделителями-символами табуляции (.txt);
-
создан как простой отчет Tekla Structures, содержащий идентификаторы GUID и пользовательские атрибуты деталей.
Существуют альтернативные способы импорта данных в пользовательские атрибуты. Например, можно заполнять пользовательские атрибуты при импорте объектов IFC и преобразовании их в оригинальные объекты Tekla Structures. Кроме того, на сервисе Tekla Warehouse есть несколько расширений, позволяющих изменять данные пользовательских атрибутов.
Структура входных файлов для импорта значений в пользовательские атрибуты
Импортировать значения пользовательских атрибутов в модели Tekla Structures можно из входных файлов, которые представляют собой текстовые файлы с разделителями.
Разделители во входных файлах
Разделитель — это символ, разделяющий разные поля в одной и той же строке.
Разделять поля можно любыми символами ASCII, которые не присутствуют в именах или значениях импортируемых атрибутов. В одном и том же входном файле можно использовать несколько альтернативных разделителей. К обычным символам-разделителям относятся запятая, табуляция, точка с запятой и пробел.
Определения полей и значений во входных файлах
Во входном файле первая строка — это заголовок, который определяет поля для остальной части входного файла. Все остальные строки входного файла содержат значения для полей, указанных в первой строке.
Первая строка должна содержать хотя бы одно ключевое поле, которое определяет объекты модели или чертежи, и хотя бы одно имя пользовательского атрибута, которое определяет поле пользовательского атрибута, куда будут импортироваться новые значения. Обратите внимание, что имена многих полей отличаются от подписей полей, отображаемых в пользовательском интерфейсе. Имена пользовательских атрибутов определены в файлах objects.inp, относящихся к данной модели (см. инструкции по чтению этих файлов).
Файл конфигурации import_macro_data_types.dat, который будет рассмотрен ниже, определяет, какие поля можно использовать при импорте атрибутов, и какой тип данных имеет каждый из атрибутов. Добавлять или изменять ключевые поля нельзя, однако можно редактировать набор пользовательских атрибутов. Значения импортируются как строки (текст), если в файле import_macro_data_types.dat для атрибута не определен другой тип данных.
Доступные ключевые поля для входных файлов
Ключевые поля для объектов модели следующие:
Ключевое поле |
Пример |
Действие |
---|---|---|
|
|
Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, тому объекту модели, у которого значение свойства |
или |
|
Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, той сборке, у которой значение свойства Повторите эту строку для каждой сборки, которую необходимо включить в файл. |
|
|
Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, той сборке, у которой значение свойства При использовании этого ключевого поля следует дополнительно использовать в качестве ключевого поля свойство |
Ключевые поля для объектов чертежей следующие:
Ключевое поле |
Пример |
Действие |
---|---|---|
|
|
Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, тому чертежу, у которого свойство Во входном файле необходимо использовать оба ключевых поля. |
|
|
Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, объекту чертежа, у которого значение свойства |
Пустые значения во входных файлах
В некоторых строках входного файла могут отсутствовать значения для всех полей атрибутов. Например, между значениями может быть два или более последовательных символов-разделителей.
Эти пустые значения можно либо пропустить во время импорта без внесения каких-либо изменений в пользовательские атрибуты, либо использовать эти пустые значения для стирания существующих значений пользовательских атрибутов в модели. По умолчанию пустые значения пропускаются. Чтобы удалить существующие значения, установите расширенный параметр XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK в значение TRUE
в файле .ini.
Порядок считывания входных файлов
Tekla Structures считывает входной файл по порядку начиная с первой строки. Если в последующих строках есть повторяющиеся ключевые поля, импортируется только первое вхождение.
Файлы данных (import_macro_data_types.dat) для импорта значений в пользовательские атрибуты
Для импорта значения в пользовательский атрибут имя поля и тип данных должны быть правильно заданы в файле данных import_macro_data_types.dat. Можно добавлять, редактировать и удалять поля пользовательских атрибутов, в которые импортируются данные
Не следует редактировать раздел ключевых полей файла. Добавлять новые ключевые поля невозможно.
Местоположение файлов данных
Файл данных по умолчанию находится в папке system внутри папки среды, такой как C:\ProgramData\Trimble\Tekla Structures\<version>\environments\common\system. В используемой вами среде может также быть локализованная версия этого файла.
Не вносите изменения в файлы, существующие по умолчанию. Вместо этого создайте копию файла и сохраните ее в другом месте, например в папке компании или в папке attributes внутри папки модели. Так внесенные вами изменения не будут перезаписаны при переустановке или обновлении Tekla Structures. Когда один и тот же файл существует в нескольких местах, используется только тот его экземпляр, который был считан первым при использовании стандартного порядка поиска в папках.
Содержимое файлов данных
Файл import_macro_data_types.dat представляет собой обычный текст. Его можно изменять в любом стандартном текстовом редакторе, таком как Блокнот Microsoft.
Каждая строка в файле — это определение поля, которое может содержать следующие атрибуты в следующем порядке:
User-defined attribute name,Data type,Conversion factor,Comments
-
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. Data type
.Возможные значения:
INT
(целое число),STRING
(текст),FLOAT
(десятичное число) илиDATE
(поля дат с календарем). Если значение отсутствует или является неверным, считается, что тип данных —STRING
.Несовпадение типов значений не препятствует импорту данных, однако результаты могут не всегда быть правильными, в зависимости от данных и от поля. Например, поля дат могут быть заданы неправильно, если тип данных отличается от
DATE
. Тем не менее, число с типом данных Целое число можно импортировать в текстовое поле без проблем.Поля со списками вариантов определяются как числовые поля с типом данных
INT
. Например, блокировка объектов может иметь значения Нет, Да и Организация, которые во входном файле будут представлены цифрами 0, 1 и 2.-
Conversion factor
(необязательно, толькоFLOAT
). Для преобразования значений в британских единицах измерения в метрические в средах с британскими единицами.Прим.:Рекомендуется проверять значения типа
FLOAT
во избежание ошибок, связанных с коэффициентами преобразования. 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
Обработка входного файла для импорта значений в пользовательские атрибуты
По умолчанию пустые значения пропускаются. Чтобы удалить существующие значения, установите расширенный параметр XS_ERASE_UDA_VALUE_WITH_ATTRIBUTE_IMPORT_NULL_AND_BLANK в значение TRUE
в файле .ini.