Здравствуйте!

Вы знаете, что после входа пользователям становится доступно намного больше содержимого?

Импорт значений пользовательских атрибутов

Добавлено September 30, 2019 by Tekla User Assistance tekla.documentation@trimble.com

Версия программы: 
2019i

Импорт значений пользовательских атрибутов

Импорт значений пользовательских атрибутов

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

Значения атрибутов можно импортировать в объекты модели, чертежи и некоторые объекты опорных моделей 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 для атрибута не определен другой тип данных.

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

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

Ключевое поле

Пример

Операция

GUID

ID4FEAFC88-0000-0004-3133-​343038303031

Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, тому объекту модели, у которого значение свойства GUID равно ID4FEAFC88-0000-0004-3133-343038303031.

ASSEMBLY_POS

or

MARK

A3

Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, той сборке, у которой значение свойства ASSEMBLY_POS равно A3.

Повторите эту строку для каждой сборки, которую требуется включить в файл.

PHASE

2

Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, той сборке, у которой значение свойства PHASE равно 2.

При использовании этого ключевого поля следует дополнительно использовать в качестве ключевого поля свойство ASSEMBLY_POS.

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

Ключевое поле

Пример

Операция

TYPE NAME

A D4

Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, тому чертежу, у которого свойство TYPE имеет значение A, а свойство MARK  — значение D4.

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

ID

134

Tekla Structures назначает пользовательские атрибуты, содержащиеся в этой строке входного файла, объекту чертежа, у которого значение свойства ID равно 134.

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

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

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

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 представляет собой обычный текст. Его можно редактировать в любом стандартном текстовом редакторе, например Блокноте.

Каждая строка в файле — это определение поля, которое может содержать следующие атрибуты в следующем порядке:

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

Обработка входного файла

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

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

  1. Если требуется импортировать определенные пользователем атрибуты только в выбранную область модели Tekla Structures , выберите область в модели.
  2. В меню Файл выберите Импорт > Атрибуты .

    Откроется диалоговое окно Импорт атрибута.

  3. Нажмите кнопку ... рядом с полем Входной файл , чтобы выбрать входной файл для импорта.
  4. Выберите необходимые настройки для импорта.

    Формат

    Описание

    Разделители входного файла

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

    Разделять поля можно любыми символами ASCII, которые не присутствуют в именах или значениях импортируемых атрибутов.

    Область ввода

    • По умолчанию , Вся модель

      Tekla Structures назначает значения пользовательских атрибутов объектов во входном файле соответствующим объектам в модели.

    • Только выбранное

      Tekla Structures назначает значения пользовательских атрибутов объектов входного файла только соответствующим объектам в выбранной области модели.

      Этот вариант следует использовать для импорта пользовательских атрибутов в модели. Не используйте его для чертежей.

    • Опорные модели

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

    Создать файл журнала

    • Создать

      При каждом импорте пользовательских атрибутов в папке текущей модели создается новый файл журнала с именем attribute_import.log. Предыдущие файлы журнала импорта атрибутов, если они имеются, при этом перезаписываются.

    • Добавить

      При каждом импорте пользовательских атрибутов в файл журнала attribute_import.log в папке текущей модели добавляются записи. Если этот файл журнала не существует, Tekla Structures создает его.

    • Нет

      Файл журнала не создается.

    Показать файл журнала

    • Нет

      Файл журнала не отображается.

    • В диалоговом окне

      Файл журнала отображается после завершения импорта.

  5. Нажмите кнопку Создать , чтобы импортировать файл.

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

Quick feedback

The feedback you give here is not visible to other users. We use your comments to improve our content.
We use this to prevent automated spam submissions.
Рейтинг: 
Голосов еще нет