Configurazione per Teamcenter PLM

Parent page: Integrazione PLM

L'integrazione PLM con 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 della 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 file TcEDA<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 collegamento di esempio è per la versione EDA 5.1), nell'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 collegamento di esempio è per la versione EDA 5.1), nell'argomento Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications for part library management.

Fare riferimento a questa serie 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 – utilizzare invece quello fornito da Altium. È possibile scaricarlo insieme a un pacchetto di file di configurazione dall'interfaccia browser di Enterprise Server Workspace: aprire Admin » PLM Integration, utilizzare 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 l'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 o come 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, quindi 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'

Dal 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 del file 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 i 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 quando si completa la precedente sezione 'Mapping ECAD part attributes to Teamcenter attributes' sopra.

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”.

Allo stesso modo, gli attributi di classificazione possono essere richiamati 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 su Enterprise Server

Prima che la sincronizzazione con Enterprise Server sia possibile, è 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

In questa fase dovrebbe essere possibile eseguire un processo Enterprise Server Component Sync e un processo Enterprise Server Part Request with PLM Part Create.

Informazioni aggiuntive sulla sincronizzazione delle parti di libreria:

• Synchronization of Released/Unreleased Teamcenter parts – Per impostazione predefinita, da Teamcenter ad Altium verranno sincronizzati solo i componenti contrassegnati con release_status_list.name = ‘TCM Released’ . Questo comportamento può essere modificato in Teamcenter Query Builder modificando la query utilizzata da Teamcenter per selezionare i componenti (vedere l'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 – È inoltre 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.
• 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 di Teamcenter. EDALIB_SaveAsFolderDefault I numeri di parte PLM vengono generati solo lato Enterprise Server.
• Current Part Synchronization limitations:
  • La cartella di destinazione non può essere specificata per i componenti nel file di configurazione: sul lato Teamcenter esiste un'impostazione globale. Un'impostazione della cartella di destinazione nel file di configurazione XML PLM (dm-config.xml) verrà ignorata senza alcun 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 sulla macchina 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 documentazione specifica per versione EDA Integration 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 indicati come requisiti nella documentazione Siemens.

Scegliere una versione di EDA Gateway che supporti la versione del server Teamcenter in uso: le informazioni di compatibilità dovrebbero essere disponibili nei corrispondenti file TcEDA<version>_README.pdf 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 EDA versione 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 di configurazione XML del connettore PLM:

<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 di configurazione XML del connettore PLM:

<!-- 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 di parti alternative della BOM

L'ActiveBOM di Altium Designer supporta l'aggiunta di parti alternative agli elementi della BOM (per saperne 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 di Teamcenter, questi componenti alternativi nell'ambito di una specifica BOM sono chiamati componenti sostitutivi). Questo abiliterà i callback di Altium con logica di trasferimento dei sostituti.

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à presente 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 posizionandole 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 dalla propria 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 sostituti, cioè non è possibile definire sostituti diversi per lo stesso elemento della 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 sostituti, ma solo le proprietà del componente base verranno trasferite alle proprietà della riga BOM di Teamcenter.
• Se un progetto con sostituti nella BOM è stato pubblicato in Teamcenter e poi un sostituto della BOM del progetto è stato rimosso e il progetto è stato pubblicato nuovamente, anche il sostituto verrà rimosso dalla BOM in Teamcenter.
• Se un progetto con sostituti nella BOM è stato pubblicato in Teamcenter e poi 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 utilizzati 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à mostrato un messaggio di errore e l'operazione verrà interrotta, quindi non verrà apportata alcuna modifica in Teamcenter.

Configurazione di Business Modeler IDE (BMIDE) per 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, fai clic con il pulsante destro del mouse su EDA Derived Data e scegli New EDA Derived Data. Viene visualizzata la procedura guidata New EDA Derived Data.
3. Nella finestra di dialogo EDA Derived Data, inserisci le informazioni e fai clic su Next.
4. Per il dataset PCB derivato, aggiungi una nuova voce sotto ‘Configure datasets’.

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

5. Per il dataset schematico derivato, aggiungi 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, scegli File » Save Data Model oppure fai clic sul pulsante Save Data Model nella barra degli strumenti principale.
8. Distribuisci le modifiche al server di test. Scegli Deploy Template nella barra dei menu oppure seleziona il progetto e poi fai clic sul pulsante Deploy Template nella barra degli strumenti principale.
9. Nel Rich Client, imposta la preferenza EDA_DerivedDataConfigDefault in modo che punti alla configurazione dei dati derivati EDA appena creata.
10. Scegli Edit » Options, fai clic sul collegamento Search nella parte inferiore della finestra di dialogo Options, individua la preferenza EDA_DerivedDataConfigDefault e modifica il relativo 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.