Teamcenter 连接器的可选配置设置

DefaultArchitectureType 设置

DefaultArchitectureType 设置定义了 Teamcenter API 用于确定如何生成物料清单 (BOM) 结构的默认架构类型。

目的

当架构类型未在 pdmconnconfig.xml 文件中定义时，DefaultArchitectureType 设置将作为备用配置。DefaultArchitectureType 设置直接影响在与 Teamcenter 集成时 BOM 数据的结构和解释方式。

有效值

  • 2：两层 BOM 结构
  • 4：四层 BOM 结构（通常更详细）

示例配置

<DefaultArchitectureType>4</DefaultArchitectureType>
在这种情况下，默认应用四层 BOM 结构。

解析器配置

<Parsers> 部分将特定 PLMXML 标签映射到 Altair 产品使用的内部解析器组件。

这些映射指示系统在导入和转换过程中如何解释各种元素类型。

指南

  • 切勿重命名或更改 Parser 名称，这一点非常重要，因为它们与内部逻辑紧密相连。
  • 要添加对新 PLMXML 元素的支持，请联系 Altair 开发部。
  • 每个 Parser 都由以下内容定义：
    • 名称属性（Parser 模块标识符）
    • 一个或多个 <Value> 标签代表该 Parser 处理的 PLMXML 标签

示例配置

<Parsers>
  <!-- Maps multiple PLMXML types to the PartParser -->
  <Parser name="PartParser">
    <Value>DesignRevision</Value>
    <Value>ValidationCheckRevision</Value>
    <Value>ProductRevision</Value>
    <Value>OperationRevision</Value>
    <Value>ConnectionRevision</Value>
    <Value>ValidationCheckRevision</Value>
    <Value>GDE</Value>
    <Value>ConnectionRevision</Value>
  </Parser>
  <!-- Maps instance-based tags to the ProductInstanceParser -->
  <Parser name="ProductInstanceParser">
    <Value>ProductInstance</Value>
    <Value>ConnectionInstance</Value>
    <Value>Instance</Value>
    <Value>CompositionInstance</Value>
    <Value>ConnectionInstance</Value>
    <Value>GDEInstance</Value>
  </Parser>
</Parsers>
注： 更多解析器配置包含在完整的 pdmsyscfg.xml 文件中。这些配置包括额外的 PLMXML 元素，如User、Role、Form、Dataset 等

TransferContexts 配置

<TransferContexts> 部分定义了如何为各种集成工作流提取和映射产品结构和相关数据。

每个 <TransferContext> 部分都指定了与特定上下文相关的对象类型、关系逻辑和搜索优先级。

目的

<TransferContexts> 部分的目的是：
  • 控制 BOM 转换和数据导入的行为。
  • 针对不同的 CAD/CAE 工作流程或模式格式调整行为。
  • 确定哪些元素是原型、出现和结构根。

每个 TransferContext 的核心元素

名称
用于标识上下文的唯一标签（如 CUSTOM_CAE_ExternalProcess 或 Smaragd）。
<PrototypePart>
定义作为主项目或修订的对象类型。
此元素可选。
<OccurrencePart>
指定哪些对象类型代表 BOM 中的实例或子对象。
<RootIdSearchOrder>
确定用于标识结构根节点的优先级顺序。
<GeneralRelationTypes>
列出构建连接时应解析的关系标签。
此元素可选。

示例：CAE 外部过程上下文

该上下文专为涉及原型和出现零件解析的 CAE 工作流程而设计。它支持 Teamcenter 特定 (TC_*) 和通用 (CAE_*) 关系类型。
<TransferContext name="CUSTOM_CAE_ExternalProcess">
  <PrototypePart>
    <Value>ProductRevision</Value>
  </PrototypePart>
  <OccurrencePart>
    <Value>Occurrence</Value>
    <Value>ProductInstance</Value>
  </OccurrencePart>
  <RootIdSearchOrder>
    <Value>ProductView</Value>
    <Value>Header</Value>
  </RootIdSearchOrder>
  <GeneralRelationTypes>
    <Value>TC_CAE_Source</Value>
    <Value>TC_CAE_Target</Value>
    <Value>TC_CAE_Include</Value>
    <Value>CAE_Source</Value>
    <Value>CAE_Target</Value>
    <Value>CAE_Include</Value>
  </GeneralRelationTypes>
</TransferContext>

示例：PLMXML 可视化模式上下文

本示例是聚焦于可视化模式的最小化上下文。不需要原型零件；它依赖 InstanceGraph 来确定根。

<TransferContext name="PLMXMLTcVisSchema">
  <OccurrencePart>
    <Value>ProductInstance</Value>
  </OccurrencePart>
  <RootIdSearchOrder>
    <Value>InstanceGraph</Value>
  </RootIdSearchOrder>
</TransferContext>
注： 更多 TransferContext 配置包含在完整的 pdmsyscfg.xml 文件中。

数据集配置

<Dataset> 部分定义了在 Teamcenter 到 UDM 转换过程中，Teamcenter Item Revisions 如何与数据集关联。

<Dataset> 部分规定了考虑哪些数据集关系、如何处理嵌套数据集以及是否覆盖默认筛选规则。

关键元素

<Role>
指定用于将数据集与 Item Revisions 关联的 Teamcenter 关系名称。
  • 目的：筛选哪些数据集将包含在 UDM 转换中。
  • 要求：这些关系必须存在于您的 Teamcenter BMIDE 配置中。
  • 行为：除非启用 OverrideRoles，否则只处理通过这些关系连接的数据集。
Role 示例：
  • IMAN_Rendering：通常用于可视化或渲染文件。
  • IMAN_specification：一般规格链接。
  • IMAN_reference：通用参考数据链接。
    <Role>
  <Value>IMAN_Rendering</Value>
  <Value>IMAN_specification</Value>
  <Value>IMAN_reference</Value>
</Role>
<Nested>
决定嵌套数据集（数据集中的数据集）在 UDM 结构中的表示方式。
有效值：
  • UDMRepresentation：创建一个单独的 UDM 表示方法零件，并将其链接到原型零件。
  • UDMDataSourceFile：将嵌套数据集直接作为文件附加到父表示方法零件下。
选择指南：
  • 使用 UDMRepresentation 可实现更清晰的分离和可追溯性。
  • 使用 UDMDataSourceFile 可获得更扁平、更紧凑的结构。
示例：
<Nested>UDMRepresentation</Nested>
<OverrideRoles>
如果启用 (true)，系统将忽略 <Role> 列表，并改为处理 Teamcenter BMIDE 模型中定义的所有数据集关系。
  • 用例：当您的组织使用未在 <Role> 中明确列出的自定义关系类型时。
  • 警告：对于大型配置，可能会大大增加处理时间和内存使用量。
示例：
<OverrideRoles>false</OverrideRoles>

表格配置

<Form> 部分定义了如何解释链接到 Item Revisions 的 Teamcenter Form 对象并将其包含在 UDM 结构中。

<Form> 部分提供对结构关系（表格如何连接）和属性级数据传输（如果启用）的控制。

目的

<Form> 部分的目的是
  • 将 Teamcenter 中的 Form 对象解释和映射为 UDM 等效对象。
  • 定义 Form 属性在修订之间的传输方式。
  • 选择考虑纳入的关系类型。
  • 可选：使用 <ManageFormAttributes> 配置属性传播（目前默认已被注释掉）。

修订之间的属性映射 (ManageFormAttributes)

可选的 ManageFormAttributes 块可在源 Item Revision 和目标 Item Revision 之间进行属性传输。

注： 此块目前已在 XML 中被注释掉，必须取消注释并配置后才能激活。
配置详细信息：
<Source>
itemRevisionType：定义源 IR 类型（如 ItemRevision）。
productIdAttributeName：可选择将 PLMXML productId 映射到自定义 UDM 属性名。
<Value>：列出用于属性映射的特定 Form 子类型。
<Target>
itemRevisionType：目标 IR 类型（如 CAEModelRevision）。
attributeOverwrite：必须为 "true"，以允许更新现有属性。
productIdAttributeName：可选，反映源的映射逻辑。
示例（默认已注释）：
<!--
<ManageFormAttributes>
  <Source itemRevisionType="ItemRevision" productIdAttributeName="itemid">
    <Value>ItemRevision Master</Value>
    <Value>catia_model_attributes</Value>
  </Source>
  <Target itemRevisionType="CAEModelRevision" attributeOverwrite="true" productIdAttributeName="itemid"/>
</ManageFormAttributes

通过关系类型进行表格关联

<Role> 元素指定哪些 Teamcenter 关系类型用于关联 Forms 和 Item Revisions。
  • 除非启用 OverrideRoles，否则将只包括通过列出的关系类型链接的 Forms。
  • 这些角色必须存在于您的 BMIDE 配置中。
支持的关系值：
  • TC_Attaches
  • IMAN_master_form_rev
  • IMAN_specification
  • IMAN_manifestation
  • IMAN_reference
示例：
<Role>
  <Value>TC_Attaches</Value>
  <Value>IMAN_master_form_rev</Value>
  <Value>IMAN_specification</Value>
  <Value>IMAN_manifestation</Value>
  <Value>IMAN_reference</Value>
</Role>

OverrideRoles

OverrideRoles 元素决定是严格遵循 <Role> 列表，还是包含 BMIDE 中定义的所有 Form 类型。
  • false（默认值）：仅使用 <Role>中列出的关系类型。
  • true：忽略 <Role> 并包括所有 Form 对象，无论其关系如何。

目前不支持 HyperWorks 产品或 Inspire UI。启用可能会大大增加处理时间。

示例：
<OverrideRoles>false</OverrideRoles>

显示和导入配置

了解如何在 GUI 中显示属性（特别是“更多属性”面板）、如何显示 BOM 以及如何将 PLMXML 文件导入 Teamcenter。

DisplayAttributesFailingOrder（可选，已注释）

DisplayAttributesFailingOrder 元素决定在“获取更多属性”面板中检索属性数据的回退顺序。

有效来源：
  • PartMetadata：直接从零件检索元数据。
  • Relations：使用基于关系的属性数据。
重要： 如果同时包含这两个来源，请务必谨慎。来自多个来源的重复属性可能会导致数据冲突。
建议您定义单一首选来源，以确保一致性。
示例（目前已注释）：
<!--
<DisplayAttributesFailingOrder>
  <Value>PartMetadata</Value>
  <Value>Relations</Value>
</DisplayAttributesFailingOrder>
-->

DisplayAllProperties

DisplayAllProperties 元素控制是否在“更多属性”面板中显示空属性。
  • true：显示所有属性，包括没有值的属性。
  • false（默认值）：只显示有值的属性。
当前设置：
<DisplayAllProperties>false</DisplayAllProperties>
建议在大多数生产环境中使用 false，以减少杂乱并提高可读性。

BVRRevisionRule

BVRRevisionRule 元素定义用于生成浏览对话框中显示的 BOM 的修订规则。
  • BVRRevisionRule 元素必须与 Teamcenter 中配置的规则相匹配，例如：
    • 任何状态；工作
    • 仅发布
  • 将 BVRRevisionRule 元素留空，以使用系统默认值。
示例：
<BVRRevisionRule></BVRRevisionRule>

PLMXMLImport

PLMXMLImport 元素定义了系统如何处理直接导入到 Teamcenter 服务器的 PLMXML 数据。

TransferMode 元素指定数据导入方法。默认值为：ConfiguredDataImportDefault – 针对大多数场景进行了优化。

示例：
<PLMXMLImport>
  <TransferMode>
    	<Value>ConfiguredDataImportDefault</Value>
  </TransferMode>
</PLMXMLImport>

请联系您的 Teamcenter 管理员或 Altair 开发团队，根据需要配置其他传输模式。

DownloadFileTypes 配置

<DownloadFileTypes> 元素决定如何根据 BOM 结构或预定义文件扩展名从 Teamcenter 选择和下载文件类型。这对数据检索过程中的性能和用户体验都有影响。

通过属性进行行为控制

您可以使用 deepSearchLevel 或 extensionList 元素来控制下载逻辑，但不能同时使用这两个元素。建议使用 deepSearchLevel 元素。

如果同时定义了 deepSearchLevel 和 extensionList 元素，这两个元素都将被忽略，系统将默认为 deepSearchLevel=0。

如果两者都未定义，系统也将默认为 deepSearchLevel=0。

  • deepSearchLevel：
    • deepSearchLevel 元素定义了在查找关联文件类型时，需要遍历 BOM 层级的深度。
    • 值：
      • 0：仅限当前零件。
      • 数字越大：扫描越深；可能会影响性能。
  • extensionList：
    • extensionList 元素是一个空格分隔的文件扩展名列表，用于筛选用户界面中显示的文件类型。
    • 示例：extensionList="asm prt catpart"

FileType 映射

FileType 元素定义了受支持的 CAD 文件类型的父子文件扩展名关系。这样，装配文件就能与相关零件文件自动配对。

结构仿真：
  • parentType：装配或容器文件的文件扩展名（必须唯一）。
  • <ChildTypeList>：一个或多个文件扩展名，代表与父文件相关联的单个零件文件。
示例配置：
<DownloadFileTypes deepSearchLevel="2">
  <FileType parentType="CATProduct">
    <ChildTypeList>
      <Value>CATPart</Value>
    </ChildTypeList>
  </FileType>
  <FileType parentType="CATPart">
    <ChildTypeList>
      <Value>CATPart</Value>
    </ChildTypeList>
  </FileType>
  <FileType parentType="asm">
    <ChildTypeList>
      <Value>prt</Value>
    </ChildTypeList>
  </FileType>
</DownloadFileTypes>

推荐

在产品结构深度已知且可控的大多数配置中，使用 deepSearchLevel 元素。extensionList 元素仅用于需要硬编码符合条件的文件类型的严格控制数据集。

更多文件类型配置包含在完整的 pdmsyscfg.xml 文件中。

通过 UG Clone (InvokeUGClone) 下载 NX 装配

<InvokeUGClone> 元素允许系统使用 ug_clone 工具从 Teamcenter 下载基于 NX 的装配数据。

<InvokeUGClone> 元素目的

  • <InvokeUGClone> 元素用于处理需要专门文件检索逻辑的复杂 NX 装配。
  • <InvokeUGClone> 元素有助于确保按照 Teamcenter 配置解决 NX 零件依赖关系。

属性

  • locale（可选）：
    • locale 属性指定在调用 ug_clone 时使用的语言/语言版本。
    • 如果省略了 locale 属性，则使用系统默认值。
    • 支持的 locale 属性值包括：en_US、cs_CZ、de_DE、es_ES、fr_FR、it_IT、ja_JP、ko_KR、pl_PL、pt_BR、ru_RU、zh_CN 和 zh_TW。
  • revisionRule：保留供将来使用。目前，revisionRule 属性对功能没有影响。
注： 性能警告

启用该选项可能会大大增加处理时间。仅在集成需要时使用。

示例

<InvokeUGClone locale="en_US">true</InvokeUGClone>

CAE 与 CAD 的链接 (CAECAD)

<CAECAD> 块可使用 Teamcenter 中定义的关系类型在 CAE 和 CAD Item Revisions 之间建立链接。

<CAECAD> 块用途

  • <CAECAD> 块允许 CAE Item Revisions 通过 GeneralRelation 链接引用其 CAD 对应项。
  • <CAECAD> 块用于在 UDM 结构中建立可跟踪链接，并支持多域数据分析。

GeneralRelation 元素

  • enabled="true"：激活此链接行为。
  • <Value> 条目：按后退顺序列出关系类型。

    如果存在第一个关系类型，则使用它。否则，系统会依次检查下一个。

常见的 Teamcenter 关系类型

  • TC_CAE_Source
  • TC_CAE_Target

示例配置

<CAECAD>
  <GeneralRelation enabled="true">
    <Value>TC_CAE_Source</Value>
    <Value>TC_CAE_Target</Value>
  </GeneralRelation>
</CAECAD>

Teamcenter SSO 版本检查

TeamcenterSSOVersionCheck 设置控制在单点登录 (SSO) 身份验证期间是否执行严格的 Teamcenter 服务器版本验证。它有助于确保客户端和服务器面向服务架构 (SOA) 应用程序接口之间的兼容性。

  • 设置 enabled="true" 以执行严格的版本验证。
  • 设置 enabled="false" 可跳过版本验证。

示例配置

<TeamcenterSSOVersionCheck enabled="false"/>