Cài đặt cho Teamcenter PLM

Parent page: Tích hợp PLM

Tích hợp Siemens Teamcenter® PLM yêu cầu cấu hình bổ sung mà trình cài đặt instance Enterprise Server không tự động quản lý. Về cơ bản, có hai mức cấu hình cần thiết, tùy theo các tính năng tích hợp bạn cần. Mức đầu tiên kích hoạt Đồng bộ hóa Linh kiện và cũng là điều kiện tiên quyết cho mức thứ hai, mức này kích hoạt các quy trình PLM Xuất bản/Khởi tạo Dự án. Tuy nhiên, bạn nên thực hiện cả hai mức cấu hình.

Đồng bộ hóa Linh kiện với Teamcenter

Để kích hoạt đồng bộ hóa linh kiện thư viện, bạn cần cài đặt phần mềm Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway trên máy đang lưu trữ Enterprise Server. Tài liệu này giả định rằng Enterprise Server và máy chủ Teamcenter đã được cài đặt trên hai máy riêng biệt – chúng tôi khuyến nghị cách này để đảm bảo tách biệt giữa hai cài đặt, mặc dù chúng cũng có thể được cài trên cùng một máy.

Cài đặt và cấu hình Teamcenter EDA

Toàn bộ quy trình cài đặt và cấu hình cho EDA Gateway được mô tả chi tiết trong EDA Integrationtài liệu theo từng phiên bản có tại Siemens Support Center. Hãy làm theo tài liệu đó một cách đầy đủ. Các hướng dẫn ở đây chỉ đề cập đến những điểm khác với tài liệu của Siemens, hoặc nêu rõ các chi tiết phía Altium được nhắc đến như những yêu cầu trong tài liệu Siemens.

Hãy chọn phiên bản EDA Gateway hỗ trợ phiên bản máy chủ Teamcenter của bạn – bạn sẽ tìm thấy thông tin tương thích trong các TcEDA<version>_README.pdftệpTcEDA<version>_README.pdf tương ứng của Gateway có trong trung tâm tải xuống. Sau đó, bạn nên tham khảo tài liệu Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (liên kết ví dụ dành cho phiên bản EDA 5.1), tại chủ đề Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management để được hướng dẫn trong quá trình thiết lập:

Là một phần của quá trình cài đặt và cấu hình giao diện Enterprise Server/Teamcenter, bạn cũng phải cài đặt (và cấp phép, v.v. nếu cần) các tính năng Teamcenter sau – tham khảo Setting up EDA Gateway for ECAD applications:

• Extensions » Mechatronics Process Management » EDA Server Support
• Extensions » Mechatronics Process Management » EMPS-Foundation
• Extensions » Mechatronics Process Management » ECAD Library Management
• Extensions » Mechatronics Process Management » EDA for Business Modeler IDE
• Extensions » Supplier Relationship Management » Vendor Management
• Base Install » Active Workspace » Server Extensions » EDA Server Support for Active Workspace
• Base Install » Active Workspace » Client » Electronic Design Automation for Active Workspace

Ngoài ra, hãy thực hiện Install and set up Common Integration Services để hỗ trợ Design Publishing.

Tiếp theo, làm theo các bước và cài đặt EDA Gateway CLIENT trên máy Enterprise Server. Để đơn giản hóa quá trình, chúng tôi đề xuất sử dụng thư mục C:\Siemens\TeamcenterEDA2.

Cấu hình EDA Gateway cho Quản lý Thư viện Linh kiện

Như ở trên, với phần này bạn cũng nên tham khảo tài liệu Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (liên kết ví dụ dành cho phiên bản EDA 5.1), tại chủ đề Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Vui lòng quay lại bộ hướng dẫn này khi bạn đến các chương cụ thể trong tài liệu Teamcenter. Các phần bên dưới sẽ tham chiếu đến các chương đó theo tên.

Chương: 'Configure the EDA client for part library management'

Trong bước đó, bạn sẽ được yêu cầu chuẩn bị một library gateway configuration file – thay vào đó, hãy dùng tệp do Altium cung cấp. Bạn có thể tải tệp này cùng gói tệp cấu hình từ giao diện trình duyệt của Enterprise Server Workspace: Mở Admin » PLM Integration, dùng nút Add Configuration để mở chế độ xem Add New Instance, chọn Teamcenter EDA từ menu thả xuống Driver, rồi chọn liên kết Download Teamcenter EDA client definition files liên quan đến trường URL – xem ví dụ.

Bên trong tệp PLMClientConfigurationFiles.zip đã tải xuống sẽ có một tệp altiumLibrary_edadef.xml – hãy đặt tệp này vào thư mục được chỉ ra bởi biến môi trường hệ thống: %TCEDAECAD_ROOT%. Đồng thời thêm tệp altiumPcb_edadef.xml được cung cấp vào thư mục đó.

Chương: 'Setting up Teamcenter server for part library management'

Mở Teamcenter Rich Client dưới tài khoản người dùng infodba, hoặc dưới một người dùng khác có quyền quản trị.
► Xem thông tin về Teamcenter Rich Client.

Các ảnh chụp màn hình bên dưới minh họa các bước được mô tả trong Create external applications for your ECAD tool in Teamcenter. Trong trường hợp của chúng tôi, chúng tôi sẽ thêm altiumLibrary,15 vào tùy chọn EDALIB_External_Applications:

Nhấp lệnh để thêm giá trị mới, sau đó chọn Save, rồi đóng tùy chọn. Đăng xuất rồi đăng nhập lại vào Teamcenter Rich client.

• Mở ứng dụng Organization.
• Đi tới phần External Applications và thêm một ứng dụng altiumLibrary như minh họa bên dưới:

• Chọn Create.

Chương: 'Mapping ECAD part attributes to Teamcenter attributes'

Thông qua dấu nhắc lệnh Teamcenter, chạy tiện ích export_attr_mappings để xuất ánh xạ ra một tệp, ví dụ:

export_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Chỉnh sửa tệp mappings.txt theo yêu cầu của bạn để ánh xạ các thuộc tính Teamcenter thực tế trên các linh kiện. Ví dụ về một ánh xạ hoạt động được thêm vào nội dung của mappings.txt đã xuất:

{ Item type="EDAComPart"
    Cost : Item.GRM(IMAN_master_form).object_desc /description="Cost"
    Tolerance : ItemRevision.GRM(IMAN_master_form).object_desc /description="Tolerance"}

Sau khi hoàn tất ánh xạ, hãy nhập lại vào Teamcenter:

import_attr_mappings.exe -file=mappings.txt -u=infodba -p=infodba

Để khắc phục sự cố ánh xạ thuộc tính, bạn có thể bật log chi tiết bằng cách thêm dòng rootLogger.level= DEBUG vào tệp C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties.

Log từ quá trình thực thi Teamcenter EDA có thể được tìm thấy trong C:\Windows\TEMP\eis_eda_log.log.

Chương: 'Creating classification mapping for ECAD parts with Teamcenter classes' (tùy chọn)

Ánh xạ phân loại là một yêu cầu thiết lập tùy chọn và có thể không được sử dụng hoặc không cần thiết cho cài đặt Teamcenter PLM của bạn. Lưu ý rằng để sử dụng các thuộc tính phân loại, chúng cần được đưa vào cấu hình/tệp ánh xạ thuộc tính khi hoàn tất phần 'Mapping ECAD part attributes to Teamcenter attributes' trước đó ở trên.

Trước khi bắt đầu giai đoạn cấu hình này, hãy bảo đảm chức năng phân loại đã được bật. Sau đó làm theo hướng dẫn để thiết lập ánh xạ phân loại.

Đảm bảo rằng _eda2tc.csv có các cột theo thứ tự category,classId và _tc2eda.csv có các cột theo thứ tự classId,category. Nếu cần, hãy hoán đổi tên tệp.

Để sử dụng các thuộc tính phân loại, bạn cần đưa chúng vào ánh xạ thuộc tính. Ví dụ về ánh xạ thuộc tính phân loại là:

"SMT attribute" : ItemRevision.ICS(-60262) /description="SMT"

Trong đó số -60262 có thể được tìm bằng công cụ Classification Admin trong Teamcenter.

Ánh xạ phân loại trong Enterprise Server

Thông tin phân loại có thể được gửi bằng một thuộc tính đặc biệt Classification được đưa vào tệp cấu hình XML PLM của bạn (typically dm-config.xml hoặc tương tự). Ví dụ:

<common:Attribute>
    <common:Key>Classification</common:Key>
    <common:Value>${parameter.Classification}</common:Value>
</common:Attribute>

Giá trị của thuộc tính này phải là một đường dẫn phân tách bằng dấu phẩy trong cây phân loại, ví dụ: “Components,SMT,Capacitor”.

Tương tự, các thuộc tính phân loại có thể được tham chiếu theo tên đã được cấu hình trong phần ánh xạ thuộc tính trên máy chủ Teamcenter, ví dụ:

<common:Attribute>
    <common:Key>SMT attribute</common:Key>
    <common:Value>smt attr value</common:Value>
</common:Attribute>

Định nghĩa Thư viện trên Enterprise Server

Trước khi có thể đồng bộ với Enterprise Server, cần tạo một thư viện bằng lệnh eda_cli.bat (nằm trong thư mục của %TCEDAECAD_ROOT% trên máy Enterprise Server), đồng thời bảo đảm các tệp được tạo có thể được Enterprise Server truy cập:

edacli.bat -configureLibrary -application altiumLibrary -status %userprofile%\status.xml

Ở giai đoạn này, bạn sẽ có thể thực hiện quy trình Enterprise Server Component Sync và quy trình Enterprise Server Part Request with PLM Part Create.

Thông tin bổ sung về Đồng bộ Linh kiện Thư viện:

• Synchronization of Released/Unreleased Teamcenter parts – Theo mặc định, chỉ các linh kiện được đánh dấu bằng release_status_list.name = ‘TCM Released’ mới được đồng bộ từ Teamcenter sang Altium. Điều này có thể được thay đổi trong Teamcenter Query Builder bằng cách sửa truy vấn mà Teamcenter dùng để chọn linh kiện (xem ví dụ).

Tên của truy vấn được lưu trong tùy chọn EDALIB_Sync_FindNewParts. Truy vấn mặc định là __EDALIB_find_newparts và được hiển thị bên dưới.

Điều kiện cuối cùng có thể được loại bỏ để đồng bộ các linh kiện chưa được “TCM Released”.

► Tham khảo tài liệu Siemens Teamcenter liên quan để biết thêm thông tin.

• Multisite synchronization – Teamcenter cũng có thể được dùng làm nguồn thông tin linh kiện cho nhiều site (một trong số đó là Enterprise Server). Lưu ý rằng điều này đòi hỏi một cấu hình đặc biệt được mô tả trong tài liệu.
• Unit-of-measure parameter synchronization – Tích hợp Teamcenter của Workspace hỗ trợ ánh xạ tham số có nhận biết đơn vị thông qua các cột dữ liệu bổ sung Data Type và SiPrefix trong bảng Component Parameter Mapping của giao diện người dùng. Sử dụng các tùy chọn trong menu thả xuống của một mục để chọn kiểu dữ liệu phù hợp (xem các tùy chọn) và tiền tố đơn vị (xem các tùy chọn).

• Destination folder for parts – Thư mục đích cho các part được đồng bộ từ Altium sang Teamcenter có thể được thiết lập theo từng site/người dùng bằng tùy chọn EDALIB_SaveAsFolderDefault Teamcenter.
• Current Part Synchronization limitations:
  • Số part PLM chỉ được tạo ở phía Enterprise Server.
  • Không thể chỉ định thư mục đích cho các component trong tệp cấu hình – có một thiết lập toàn cục ở phía Teamcenter. Thiết lập thư mục đích trong tệp PLM XML Configuration (dm-config.xml) sẽ bị bỏ qua mà không có cảnh báo. Thư mục đích được lấy từ tùy chọn cấp người dùng của Teamcenter, hoặc tùy chọn cấp site EDALIB_SaveAsFolderDefault cho mọi loại component.
  • Các lựa chọn native part (Approved Manufacturer/Vendor List, hoặc AML/AVL) không được hỗ trợ. Như trước đây, chỉ hỗ trợ các lựa chọn part dựa trên tham số component.

Xuất bản thiết kế với Teamcenter EDA

Việc xuất bản thiết kế từ Altium sang Teamcenter chỉ có thể thực hiện thông qua Altium Designer. Để bật tính năng xuất bản thiết kế, bạn cần cài đặt Teamcenter EDA (Electronic Design Automation) Gateway trên máy cài Altium Designer . Bạn cũng sẽ cần quyền truy cập vào cả Enterprise Server và máy chủ Teamcenter.

Quy trình cài đặt và cấu hình EDA Gateway được mô tả chi tiết trong tài liệu EDA Integration theo từng phiên bản có sẵn tại Siemens Support Center. Vui lòng làm theo tài liệu đó một cách đầy đủ. Các hướng dẫn tại đây chỉ đề cập đến những điểm khác với tài liệu của Siemens, hoặc nêu rõ các chi tiết phía Altium được nhắc đến như là yêu cầu trong tài liệu Siemens.

Chọn phiên bản EDA Gateway hỗ trợ phiên bản máy chủ Teamcenter của bạn – bạn sẽ tìm thấy thông tin tương thích trong các tệp TcEDA<version>_README.pdf tương ứng của Gateway có trong trung tâm tải xuống. Sau đó, bạn nên tham khảo tài liệu Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (liên kết ví dụ dành cho EDA phiên bản 5.1), tại chủ đề Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management để được hướng dẫn trong quá trình thiết lập:

Nếu cần hỗ trợ tạo component trong khi xuất bản dự án, thì một phần cấu hình thư viện phải được thực hiện trên máy chủ. Điều này áp dụng cho chiến lược section mặc định <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> trong publish template.

Thư mục đích cho các thiết kế có thể được thiết lập bằng các tùy chọn cấp site/người dùng: EDA_SaveAsFolderDefault.

Ánh xạ thuộc tính dòng BOM

Các thuộc tính Reference Designator và Quantity của dòng BOM được xử lý tự động, nhưng cần phải được đưa vào phần <BOM> của tệp PLM connector XML Configuration:

<BOM>
    <BOMAttributes>
        <!-- "Reference Designator" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Reference Designator</common:Key>
        <common:Value>${parameter.LogicalDesignator}</common:Value>
        </common:BOMAttribute>
        <!-- "Quantity" attribute is mandatory for Teamcenter EDA connector -->
        <common:BOMAttribute>
        <common:Key>Quantity</common:Key>
        <common:Value>${parameter.Quantity}</common:Value>
        </common:BOMAttribute>
    </BOMAttributes>
</BOM>

Để sử dụng các thuộc tính dòng BOM khác, cần phải đưa chúng vào phần ánh xạ thuộc tính dòng BOM của tệp altiumPcb_edadef.xml. Ví dụ, mục bên dưới thêm ánh xạ của thuộc tính Altium part_source tới thuộc tính dòng BOM Teamcenter bl_part_source:

<RdnAttrMapDefs>
    <RdnAttrDesign cadAttrName="part_source" tcAttrName="bl_part_source"/>
</RdnAttrMapDefs>

Khi ánh xạ như vậy được thêm vào, có thể định nghĩa giá trị của nó trong phần <BOMAttributes> của tệp PLM connector XML Configuration:

<!-- You can add any other custom attributes, but these need to be mapped to Teamcenter attribute in altiumPcb_edadef.xml file -->
<common:BOMAttribute>
    <common:Key>part_source</common:Key>
    <common:Value>${parameter.MakeOrBuy}</common:Value>
</common:BOMAttribute>

Cấu hình để xuất bản BOM Alternate Parts

ActiveBOM của Altium Designer hỗ trợ thêm alternate part vào các mục BOM (tìm hiểu thêm). Để hỗ trợ các alternate part như vậy khi xuất bản một thiết kế sang Teamcenter PLM, cần thực hiện thêm cấu hình cho Teamcenter EDA như mô tả bên dưới (theo thuật ngữ của Teamcenter, các component thay thế này trong phạm vi của một BOM cụ thể được gọi là substitute component). Điều này sẽ cho phép Altium callback với logic chuyển substitute.

1. Xác định vị trí tệp soa_client.zip trong các tệp cài đặt cho phiên bản máy chủ Teamcenter bạn đang sử dụng.

2. Xác định vị trí các tệp sau bên trong tệp zip này:

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Sao chép hai tệp này vào thư mục %TCEDAECAD_ROOT% trên PC đang chạy Teamcenter EDA Gateway và Altium Designer.

4. Mở tệp %TCEDAECAD_ROOT%\setup_eda.bat và tìm các dòng sau:

   
   rem
   rem Add customer callbacks
   rem
   if exist CustomEDACallbacks.jar (
   	SET EDA_CP=%EDA_CP%;CustomEDACallbacks.jar
   )
   

5. Thêm các dòng sau bên dưới:

   
   rem Added for Altium support of BOM substitutes
   set EDA_CP=%EDA_CP%;TcSoaStructureManagementStrong_14000.3.0.jar
   set EDA_CP=%EDA_CP%;TcSoaBomStrong_14000.3.0.jar
   

   Hãy chú ý đến số phiên bản (ví dụ: 14000.3.0 trong ví dụ ở trên). Số này phải khớp với số phiên bản có trong tên tệp đã được sao chép ở bước trước.

6. Mở tệp %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Thêm các mục <callback …/> sau vào trong phần <CallbackDefs> (đã có sẵn trong tệp):

   
   <callback type="java" operation="preSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="preSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:checkSubstitutes"/>
   <callback type="java" operation="postSave" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   <callback type="java" operation="postSaveAs" command="com.altium.eis.teamcenter.eda.callback.SubstituteCallbacks:updateSubstitutes"/>
   

   Các mục ở trên đã có sẵn trong tệp altiumPcb_edadef.xml, trong một chú thích nhiều dòng bên trong phần <CallbackDefs>. Bạn có thể di chuyển các mục này ra khỏi chú thích đó (ví dụ: đặt chúng ngay bên dưới phần --> trong mục này).
7. Khởi động lại PC để bảo đảm Teamcenter EDA tải các thư viện mới.

Notes:

• Teamcenter EDA phải được cấu hình để chạy trên Java 11.
• Nếu bạn sử dụng Teamcenter 13, hãy bảo đảm sử dụng các phiên bản của những thư viện bổ sung từ bản cài đặt Teamcenter 13 của bạn.
• Hãy chắc chắn cập nhật các tệp CustomEDACallbacks.jar và altiumPcb_edadef.xml trong thư mục %TCEDAECAD_ROOT%.
• Trong Altium Designer, tất cả biến thể thiết kế dùng chung cùng một tập substitute, tức là không thể định nghĩa các substitute khác nhau cho cùng một mục BOM giữa các biến thể.
• Danh sách substitute component trong Teamcenter là danh sách các phiên bản sửa đổi component. Các mục substitute component không tạo ra dòng BOM và không thể được gán các thuộc tính dòng BOM. Trong Altium Designer, có thể có một cột BOM với giá trị khác nhau cho các substitute, nhưng chỉ các thuộc tính từ component cơ sở mới được chuyển sang các thuộc tính dòng BOM của Teamcenter.
• Nếu một dự án có substitute trong BOM đã được xuất bản sang Teamcenter và sau đó một substitute trong BOM của dự án bị xóa rồi dự án được xuất bản lại, thì substitute đó cũng sẽ bị xóa khỏi BOM trong Teamcenter.
• Nếu một dự án có substitute trong BOM đã được xuất bản sang Teamcenter và sau đó BOM đã bị chỉnh sửa thủ công trong Teamcenter, thì BOM trong Teamcenter sẽ bị ghi đè ở lần xuất bản tiếp theo của dự án này, tức là các thay đổi thực hiện thủ công sẽ bị mất.

• Các linh kiện được dùng làm linh kiện thay thế trong ActiveBOM phải được đồng bộ với Teamcenter. Điều kiện này được kiểm tra bởi preSave callback. Nếu có linh kiện chưa được đồng bộ với Teamcenter, một thông báo lỗi sẽ được hiển thị và thao tác sẽ bị hủy, vì vậy sẽ không có thay đổi nào được thực hiện trong Teamcenter.

Cấu hình Business Modeler IDE (BMIDE) cho các tập dữ liệu dẫn xuất

Sau khi tạo cấu hình dữ liệu dẫn xuất (xem các tham chiếu trong tệp altiumPcb_edadef.xml), bạn có thể chỉ định tên của cấu hình trong tùy chọn EDA_DerivedDataConfigDefault.

1. Trong BMIDE, mở thư mục Extensions.
2. Trong thư mục Extensions, nhấp chuột phải vào EDA Derived Data và chọn New EDA Derived Data. Trình hướng dẫn New EDA Derived Data sẽ được hiển thị.
3. Trong hộp thoại EDA Derived Data, nhập thông tin và nhấp vào Next.
4. Đối với tập dữ liệu PCB dẫn xuất, thêm một mục mới bên dưới ‘Configure datasets’.

Đường dẫn: $TEMP\Altium\TcEda\Project\pcb\*.*

5. Đối với tập dữ liệu sơ đồ nguyên lý dẫn xuất, thêm một mục mới bên dưới ‘Configure datasets'.

Đường dẫn: $TEMP\Altium\TcEda\Project\schematic\*.*

6. Một tập dữ liệu dẫn xuất khác cho các tập dữ liệu Biến thể:

Đường dẫn: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

7. Để lưu các thay đổi vào mô hình dữ liệu, chọn File » Save Data Model, hoặc nhấp nút Save Data Model trên thanh công cụ chính.
8. Triển khai các thay đổi của bạn lên máy chủ kiểm thử. Chọn Deploy Template trên thanh menu, hoặc chọn dự án rồi nhấp nút Deploy Template trên thanh công cụ chính.
9. Trong Rich Client, đặt tùy chọn EDA_DerivedDataConfigDefault để trỏ đến cấu hình dữ liệu dẫn xuất EDA mà bạn vừa tạo.
10. Chọn Edit » Options, nhấp liên kết Search ở cuối hộp thoại Options, tìm tùy chọn EDA_DerivedDataConfigDefault và đổi giá trị của tùy chọn này thành cấu hình mới.

Thông tin bổ sung về phát hành thiết kế

Current Project Publishing Limitations:

• Siemens EDA Gateway không hỗ trợ tham chiếu đến các revision linh kiện cụ thể ('Precise BOM').
• ECO hiện chưa được hỗ trợ.