Configurazione per Teamcenter PLM

Parent page: Integrazione PLM

L'integrazione PLM Siemens Teamcenter® richiede una configurazione aggiuntiva che non viene gestita automaticamente dal programma di installazione dell'istanza di Enterprise Server. In sostanza, sono necessari due livelli di configurazione, a seconda delle funzionalità di integrazione richieste. Il primo livello abilita la sincronizzazione delle parti ed è anche un prerequisito per il secondo livello, che abilita i processi PLM di pubblicazione/inizializzazione del progetto. Tuttavia, si consiglia di eseguire entrambi i livelli di configurazione.

Sincronizzazione delle parti con Teamcenter

Per abilitare la sincronizzazione delle parti di libreria è necessario installare il software Siemens Teamcenter^® EDA (Electronic Design Automation) Gateway sul computer che ospita Enterprise Server. Questo documento presuppone che Enterprise Server e il server Teamcenter siano già installati su macchine separate: consigliamo questo approccio per garantire la separazione tra le due installazioni, anche se potrebbero essere installati sulla stessa macchina.

Installazione e configurazione di Teamcenter EDA

L'intera procedura di installazione e configurazione di EDA Gateway è descritta in dettaglio nella EDA Integrationdocumentazione specifica per la versione disponibile nel Siemens Support Center. Seguire attentamente tale documentazione. Le istruzioni qui riportate coprono solo le differenze rispetto alla documentazione Siemens oppure specificano dettagli lato Altium che nella documentazione Siemens sono indicati come requisiti.

Scegliere una versione di EDA Gateway che supporti la versione del server Teamcenter in uso: le informazioni sulla compatibilità dovrebbero essere disponibili nei corrispondenti TcEDA<version>_README.pdffileTcEDA<version>_README.pdf di Gateway presenti nel centro download. È quindi necessario consultare la documentazione Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (il link di esempio è per la versione EDA 5.1), sull'argomento Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management, per essere guidati nella configurazione:

Come parte dell'installazione e della configurazione dell'interfaccia Enterprise Server/Teamcenter, è inoltre necessario installare (e concedere in licenza, ecc. secondo necessità) le seguenti funzionalità Teamcenter – fare riferimento a 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

Inoltre, eseguire Install and set up Common Integration Services per supportare la pubblicazione del progetto.

Successivamente, seguire i passaggi e installare EDA Gateway CLIENT sulla macchina Enterprise Server. Per semplificare il processo, suggeriamo di utilizzare la cartella C:\Siemens\TeamcenterEDA2.

Configurare EDA Gateway per la gestione della libreria parti

Come sopra, anche per questa sezione è necessario consultare la documentazione Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (il link di esempio è per la versione EDA 5.1), sull'argomento Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Fare riferimento a questo insieme di istruzioni quando si raggiungono capitoli specifici nella documentazione Teamcenter. Le sezioni seguenti fanno riferimento a tali capitoli per nome.

Capitolo: 'Configure the EDA client for part library management'

Durante quel passaggio verrà richiesto di preparare un library gateway configuration file, ma utilizzare invece quello fornito da Altium. È possibile scaricarlo con un pacchetto di file di configurazione dall'interfaccia browser del Workspace di Enterprise Server: aprire Admin » PLM Integration, usare il pulsante Add Configuration per aprire la vista Add New Instance, scegliere Teamcenter EDA dal menu a discesa Driver, quindi selezionare il collegamento Download Teamcenter EDA client definition files associato al campo URL – vedere esempio.

All'interno del file PLMClientConfigurationFiles.zip scaricato sarà presente un file altiumLibrary_edadef.xml: inserire questo file nella directory indicata dalla variabile d'ambiente di sistema: %TCEDAECAD_ROOT%. Aggiungere inoltre a tale directory il file altiumPcb_edadef.xml fornito.

Capitolo: 'Setting up Teamcenter server for part library management'

Aprire Teamcenter Rich Client come utente infodba oppure come un altro utente con privilegi di amministrazione.
► Vedere le informazioni su Teamcenter Rich Client.

Le schermate seguenti illustrano i passaggi descritti in Create external applications for your ECAD tool in Teamcenter. Nel nostro caso aggiungeremo altiumLibrary,15 alla preferenza EDALIB_External_Applications:

Fare clic sul comando per aggiungere il nuovo valore, quindi su Save, e infine chiudere la preferenza. Disconnettersi e quindi accedere nuovamente a Teamcenter Rich client.

• Aprire l'applicazione Organization.
• Passare alla sezione External Applications e aggiungere un'applicazione altiumLibrary come mostrato di seguito:

• Selezionare Create.

Capitolo: 'Mapping ECAD part attributes to Teamcenter attributes'

Tramite il prompt dei comandi di Teamcenter, eseguire l'utilità export_attr_mappings per esportare la mappatura in un file, ad esempio:

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

Modificare il file mappings.txt in base alle proprie esigenze per mappare gli attributi reali di Teamcenter sui componenti. Un esempio di mappatura funzionante, aggiunto al contenuto di mappings.txt esportato:

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

Dopo aver completato la mappatura, importarla nuovamente in Teamcenter:

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

Per risolvere i problemi di mappatura degli attributi è possibile attivare log dettagliati includendo la riga rootLogger.level= DEBUG nel file C:\Program Files\Siemens\TeamcenterEDA2\eda\log4j2.properties.

I log dell'esecuzione di Teamcenter EDA si trovano in C:\Windows\TEMP\eis_eda_log.log.

Capitolo: 'Creating classification mapping for ECAD parts with Teamcenter classes' (opzionale)

La mappatura della classificazione è un requisito di configurazione opzionale e potrebbe non essere utilizzata o necessaria per l'installazione PLM Teamcenter in uso. Si noti che, per utilizzare gli attributi di classificazione, questi devono essere inclusi nella configurazione/file di mappatura degli attributi durante il completamento della precedente sezione 'Mapping ECAD part attributes to Teamcenter attributes'.

Prima di iniziare questa fase di configurazione, assicurarsi di avere la funzionalità di classificazione abilitata. Quindi seguire le istruzioni per configurare la mappatura della classificazione.

Assicurarsi che _eda2tc.csv abbia le colonne nell'ordine category,classId e che _tc2eda.csv abbia le colonne nell'ordine classId,category. Se necessario, scambiare i nomi dei file.

Per utilizzare gli attributi di classificazione è necessario includerli nella mappatura degli attributi. Un esempio di mappatura degli attributi di classificazione è:

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

Dove il numero -60262 può essere trovato con lo strumento Classification Admin in Teamcenter.

Mappatura della classificazione in Enterprise Server

Le informazioni di classificazione possono essere inviate con uno speciale attributo Classification incluso nel file di configurazione XML del PLM (typically dm-config.xml o simile). Ad esempio:

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

Il valore di questo attributo deve essere un percorso separato da virgole nell'albero di classificazione, ad esempio: “Components,SMT,Capacitor”.

Analogamente, è possibile fare riferimento agli attributi di classificazione tramite il nome configurato nella mappatura degli attributi sul server Teamcenter, ad esempio:

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

Definire la libreria in Enterprise Server

Prima che la sincronizzazione sia possibile con Enterprise Server, è necessario creare una libreria con il comando eda_cli.bat (situato nella directory di %TCEDAECAD_ROOT% sulla macchina Enterprise Server), e assicurarsi inoltre che i file creati siano accessibili a Enterprise Server:

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

A questo punto dovrebbe essere possibile eseguire un processo di Component Sync di Enterprise Server e un processo di Part Request with PLM Part Create di Enterprise Server.

Informazioni aggiuntive sulla sincronizzazione delle parti di libreria:

• Synchronization of Released/Unreleased Teamcenter parts – Per impostazione predefinita, solo i componenti contrassegnati con release_status_list.name = ‘TCM Released’ verranno sincronizzati da Teamcenter ad Altium. Questo può essere modificato in Teamcenter Query Builder modificando la query utilizzata da Teamcenter per selezionare i componenti (vedere esempio).

Il nome della query è memorizzato nella preferenza EDALIB_Sync_FindNewParts. La query predefinita è __EDALIB_find_newparts ed è mostrata di seguito.

L'ultima condizione può essere rimossa per sincronizzare componenti che non sono ancora “TCM Released”.

► Fare riferimento alla relativa documentazione Siemens Teamcenter per ulteriori informazioni.

• Multisite synchronization – È anche possibile utilizzare Teamcenter come fonte di informazioni sui componenti per più siti (uno dei quali è Enterprise Server). Si noti che ciò richiede una configurazione speciale descritta nella documentazione.
• Unit-of-measure parameter synchronization – L’integrazione Workspace Teamcenter supporta la mappatura dei parametri con riconoscimento delle unità tramite le colonne dati aggiuntive Data Type e SiPrefix nella tabella Component Parameter Mapping dell’interfaccia utente. Utilizzare le opzioni del menu a discesa di una voce per selezionare un tipo di dati adatto (vedi opzioni) e un prefisso di unità (vedi opzioni).

• Destination folder for parts – La cartella di destinazione per le parti sincronizzate da Altium a Teamcenter può essere impostata per sito/utente tramite la preferenza Teamcenter EDALIB_SaveAsFolderDefault.
• Current Part Synchronization limitations:
  • I numeri parte PLM vengono generati solo lato Enterprise Server.
  • La cartella di destinazione non può essere specificata per i componenti nel file di configurazione: sul lato Teamcenter è presente un’impostazione globale. Un’impostazione della cartella di destinazione nel file PLM XML Configuration (dm-config.xml) verrà ignorata senza avviso. La cartella di destinazione viene ricavata dall’opzione a livello utente di Teamcenter, oppure dall’opzione a livello sito EDALIB_SaveAsFolderDefault per tutti i tipi di componente.
  • La selezione di parti native (Approved Manufacturer/Vendor List, o AML/AVL) non è supportata. Come in precedenza, sono supportate solo le selezioni di parti basate sui parametri del componente.

Pubblicazione del progetto con Teamcenter EDA

La pubblicazione del progetto da Altium a Teamcenter è possibile solo tramite Altium Designer. Per abilitare la pubblicazione del progetto è necessario installare Teamcenter EDA (Electronic Design Automation) Gateway sul computer in cui è installato Altium Designer . Sarà inoltre necessario avere accesso sia all’Enterprise Server sia al server Teamcenter.

La procedura di installazione e configurazione di EDA Gateway è descritta in dettaglio nella EDA Integrationdocumentazione specifica per la versione disponibile nel Siemens Support Center. Seguire attentamente tale documentazione. Le istruzioni qui riportate coprono solo le differenze rispetto alla documentazione Siemens oppure specificano dettagli lato Altium che nella documentazione Siemens sono indicati come requisiti.

Scegliere una versione di EDA Gateway che supporti la versione del server Teamcenter in uso: le informazioni sulla compatibilità dovrebbero essere disponibili nei file TcEDA<version>_README.pdf corrispondenti di Gateway presenti nel centro download. Consultare quindi la documentazione Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (il link di esempio è per la versione EDA 5.1), sull’argomento Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for design management, per essere guidati nella configurazione:

Se deve essere supportata la creazione di componenti durante la pubblicazione del progetto, una parte della configurazione della libreria deve essere eseguita sul server. Questo vale per la strategia di sezione predefinita <pt:BomStrategy>CreateNewAndLink</pt:BomStrategy> nel template di pubblicazione.

La cartella di destinazione per i progetti può essere impostata tramite le opzioni sito/utente: EDA_SaveAsFolderDefault.

Mappatura degli attributi della riga BOM

Gli attributi della riga BOM Reference Designator e Quantity vengono gestiti automaticamente, ma devono essere inclusi nella sezione <BOM> del file 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>

Per utilizzare altri attributi della riga BOM è necessario includerli nella sezione di mappatura degli attributi della riga BOM del file altiumPcb_edadef.xml. Ad esempio, la voce seguente aggiunge la mappatura dell’attributo Altium part_source all’attributo della riga BOM di Teamcenter bl_part_source:

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

Quando tale mappatura viene aggiunta, è possibile definirne il valore nella sezione <BOMAttributes> del file 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>

Configurazione per la pubblicazione delle parti alternative della BOM

L’ActiveBOM di Altium Designer supporta l’aggiunta di parti alternative agli elementi della BOM (scopri di più). Per supportare tali parti alternative durante la pubblicazione di un progetto nel PLM Teamcenter , è necessario eseguire un’ulteriore configurazione di Teamcenter EDA come descritto di seguito (nella terminologia Teamcenter, questi componenti alternativi nell’ambito di una specifica BOM sono chiamati componenti sostitutivi). Questo abiliterà i callback Altium con logica di trasferimento dei sostitutivi.

1. Individuare il file soa_client.zip nei file di installazione della versione del server Teamcenter attualmente in uso.

2. Individuare i seguenti file all’interno di questo file zip:

   soa_client\java\libs\TcSoaStructureManagementStrong*.jar

   soa_client\java\libs\TcSoaBomStrong*.jar

3. Copiare questi due file nella directory %TCEDAECAD_ROOT% sul PC che ospita Teamcenter EDA Gateway e Altium Designer.

4. Aprire il file %TCEDAECAD_ROOT%\setup_eda.bat e individuare le seguenti righe:

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

5. Aggiungere le seguenti righe sotto:

   
   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
   

   Prestare attenzione al numero di versione (cioè 14000.3.0 nell’esempio sopra). Deve corrispondere al numero di versione incluso nel nome del file copiato nel passaggio precedente.

6. Aprire il file %TCEDAECAD_ROOT%\altiumPcb_edadef.xml. Aggiungere le seguenti voci <callback …/> all’interno della sezione <CallbackDefs> (già esistente nel file):

   
   <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"/>
   

   Le voci sopra sono già presenti nel file altiumPcb_edadef.xml, in un commento su più righe all’interno della sezione <CallbackDefs>. È possibile spostare queste voci fuori dal commento (ad esempio, spostandole subito sotto la parte --> in questa sezione).
7. Riavviare il PC per assicurarsi che Teamcenter EDA carichi le nuove librerie.

Notes:

• Teamcenter EDA deve essere configurato per essere eseguito su Java 11.
• Se si utilizza Teamcenter 13, assicurarsi di usare le versioni delle librerie aggiuntive provenienti dall’installazione di Teamcenter 13.
• Assicurarsi di aggiornare i file CustomEDACallbacks.jar e altiumPcb_edadef.xml nella directory %TCEDAECAD_ROOT%.
• In Altium Designer, tutte le varianti di progetto condividono lo stesso insieme di sostitutivi, cioè non è possibile avere sostitutivi diversi definiti per lo stesso elemento BOM tra varianti diverse.
• L’elenco dei componenti sostitutivi in Teamcenter è un elenco di revisioni di componenti. Le voci dei componenti sostitutivi non creano righe BOM e non possono avere proprietà di riga BOM assegnate. In Altium Designer è possibile avere una colonna BOM con un valore diverso per i sostitutivi, ma solo le proprietà del componente base verranno trasferite alle proprietà della riga BOM di Teamcenter.
• Se un progetto con sostitutivi nella BOM è stato pubblicato in Teamcenter e successivamente un sostitutivo della BOM del progetto è stato rimosso e il progetto è stato pubblicato di nuovo, anche il sostitutivo verrà rimosso dalla BOM in Teamcenter.
• Se un progetto con sostitutivi nella BOM è stato pubblicato in Teamcenter e successivamente la BOM è stata modificata manualmente in Teamcenter, la BOM in Teamcenter verrà sovrascritta alla successiva pubblicazione di questo progetto, cioè le modifiche apportate manualmente andranno perse.

• I componenti usati come sostituti in ActiveBOM devono essere sincronizzati con Teamcenter. Questa condizione viene verificata dal callback preSave. Se sono presenti componenti che non sono stati sincronizzati con Teamcenter, verrà visualizzato un messaggio di errore e l’operazione verrà interrotta, quindi non verrà apportata alcuna modifica in Teamcenter.

Configurazione di Business Modeler IDE (BMIDE) per i dataset derivati

Dopo aver creato una configurazione dei dati derivati (vedere i riferimenti nel file altiumPcb_edadef.xml), è possibile specificare il nome della configurazione nella preferenza EDA_DerivedDataConfigDefault.

1. In BMIDE, aprire la cartella Extensions.
2. Nella cartella Extensions, fare clic con il pulsante destro del mouse su EDA Derived Data e scegliere New EDA Derived Data. Verrà visualizzata la procedura guidata New EDA Derived Data.
3. Nella finestra di dialogo EDA Derived Data, immettere le informazioni e fare clic su Next.
4. Per il dataset PCB derivato, aggiungere una nuova voce sotto ‘Configure datasets’.

Percorso: $TEMP\Altium\TcEda\Project\pcb\*.*

5. Per il dataset schematico derivato, aggiungere una nuova voce sotto ‘Configure datasets'.

Percorso: $TEMP\Altium\TcEda\Project\schematic\*.*

6. Un altro dataset derivato per i dataset Variants:

Percorso: $TEMP\Altium\TcEda\Project\$VARIANT\pcb\*.*

7. Per salvare le modifiche al modello dati, scegliere File » Save Data Model oppure fare clic sul pulsante Save Data Model nella barra degli strumenti principale.
8. Distribuire le modifiche sul server di test. Scegliere Deploy Template nella barra dei menu oppure selezionare il progetto e quindi fare clic sul pulsante Deploy Template nella barra degli strumenti principale.
9. Nel Rich Client, impostare la preferenza EDA_DerivedDataConfigDefault in modo che punti alla configurazione dei dati derivati EDA appena creata.
10. Scegliere Edit » Options, fare clic sul collegamento Search nella parte inferiore della finestra di dialogo Options, individuare la preferenza EDA_DerivedDataConfigDefault e modificarne il valore con la nuova configurazione.

Informazioni aggiuntive sulla pubblicazione del progetto

Current Project Publishing Limitations:

• Il riferimento a revisioni specifiche dei componenti ('Precise BOM') non è supportato dal Siemens EDA Gateway.
• ECO non è attualmente supportato.