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 di compatibilità dovrebbero essere disponibili nei corrispondenti file TcEDA<version>_README.pdfTcEDA<version>_README.pdf disponibili 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), 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 è opportuno consultare la documentazione Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (il link 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 nuovamente 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 di esempio dall'interfaccia browser del Workspace di Enterprise Server: aprire Admin » PLM Integration, usare il pulsante Add Instance per aprire la finestra Add new instance, selezionare la scheda Configuration e quindi Download sample configuration.

All'interno del file 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, 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 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”.

Analogamente, gli attributi di classificazione possono essere richiamati con 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 Component Sync di Enterprise Server e un processo 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, da Teamcenter ad Altium verranno sincronizzati solo i componenti contrassegnati con release_status_list.name = ‘TCM Released’ . Questo comportamento può essere modificato nel 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 origine delle 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 Teamcenter EDALIB_SaveAsFolderDefault.
• Current Part Synchronization limitations:
  • I codici 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 di configurazione XML PLM (dm-config.xml) verrà ignorata senza alcun avviso. La cartella di destinazione viene ricavata dal livello utente di Teamcenter, oppure dall'opzione a livello di sito EDALIB_SaveAsFolderDefault per tutti i tipi di componente.
  • Le scelte di parti native (Approved Manufacturer/Vendor List, o AML/AVL) non sono supportate. Come in precedenza, sono supportate solo le scelte 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 indicati come requisiti nella documentazione Siemens.

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.pdffile di Gateway presenti nel centro download. Consultare quindi la documentazione Installing and Configuring EDA Gateway for (Non-Mentor) ECAD Applications (il collegamento 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 modello 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 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 al 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 da Siemens EDA Gateway.
• ECO non è attualmente supportato.