Integrazione PLM tramite file XML
A colpo d'occhio
- Scopri come adattare i file XML di esempio o generare una configurazione di base a partire dal modello di dati del tuo Workspace.
- Comprendi come i modelli di pubblicazione controllano la creazione e il collegamento dei componenti e gli output di rilascio inviati al PLM.
- Scopri come la convalida della connessione identifica errori e avvisi di configurazione prima di utilizzare l'integrazione.
Connessione all'istanza PLM
La connessione all'istanza PLM viene effettuata dalla pagina Admin – PLM Integration dell'interfaccia browser del Workspace. La procedura prevede il caricamento del file di configurazione basato su XML e del modello di pubblicazione appropriati, nonché l'abilitazione e la configurazione della sincronizzazione dei componenti PLM con quelli del Workspace.
L'installazione include file di configurazione e modelli di pubblicazione di esempio. Espandi le sezioni seguenti per maggiori informazioni:
File di configurazione di esempio
I file di configurazione di esempio sono disponibili nella vista Add new instance: nella scheda Configuration, fai clic sul collegamento Download sample configuration per ottenere il file zip ConfigurationSamples.zip. Questo archivio zip contiene i file di configurazione iniziali per i sistemi PLM Windchill, Arena, Aras e Agile:
- dm-Windchill-config-basic.xml
- dm-Arena-config-basic.xml
- dm-Agile-config-basic.xml
-
dm-Aras-config-basic.xml
I file di configurazione di esempio sono forniti per l'utilizzo nell'istanza del Workspace.
Le configurazioni fornite includono un paio di sezioni rappresentative delle entità componente (ad esempio, Capacitors e Diodes), ciascuna delle quali contiene una sottosezione di base per la mappatura di attributi/parametri ToPLM e ToAltium. Integra e modifica un file di esempio in base all'istanza PLM e ai requisiti della tua azienda, crea un file personalizzato oppure utilizza il Generatore di configurazione per creare un file di configurazione di base corrispondente al modello di dati del Workspace.
Modelli di pubblicazione di esempio
I modelli di pubblicazione di esempio sono disponibili nella vista Add new instance: fai clic sul pulsante
nella scheda Publish Template, quindi sul collegamento Download sample configuration nella finestra Publish Template per ottenere il file zip PublishTemplateSamples.zip. Questo archivio zip contiene i seguenti file:
- dm-Windchill-publish-template-basic.xml
- dm-Arena-publish-template-basic.xml
- dm-Agile-publish-template-basic.xml
-
dm-Aras-publish-template-basic.xml
I modelli di pubblicazione di esempio sono forniti per l'utilizzo nell'istanza del Workspace.
Modificali in base all'istanza PLM e ai requisiti della tua azienda oppure crea modelli personalizzati.
Nei file di pubblicazione di esempio sono configurati i seguenti aspetti importanti:
-
La modalità di gestione della creazione e del collegamento dei componenti sul lato PLM durante un processo di pubblicazione (la «strategia BOM»). Sono disponibili le seguenti opzioni:
- LinkExistingOnly – collega i componenti già presenti nel PLM, ma non crea quelli mancanti.
- CreateNewAndLink – collega i componenti già presenti nel PLM e crea e collega quelli mancanti.
- LinkIfAllExists – non crea i componenti mancanti sul lato PLM; esegue il collegamento solo se tutti i componenti sono presenti nel PLM.
-
Insiemi di regole che definiscono come e dove vengono pubblicati nel PLM gli output di rilascio:
- Regole per elaborare i dati del progetto (padre).
- Regole per elaborare i dati sorgente.
- Regole per elaborare i dati di assemblaggio.
- Regole per elaborare i dati di fabbricazione.
Quando aggiungi una nuova voce PLM tramite il pulsante
, utilizza il pulsante
per individuare e applicare una configurazione PLM opportunamente salvata/modificata.
Analogamente, un modello di pubblicazione compatibile viene aggiunto tramite il pulsante
nella scheda Publish Template. Nella successiva finestra di dialogo Publish Template, utilizza il pulsante
per individuare e selezionare il file del modello corretto.
Flusso di lavoro degli ordini di modifica (ECO)
I file di configurazione delle istanze PLM Windchill, Agile e Arena supportano anche il flusso di lavoro formalizzato Change Order (ECO), che viene abilitato nel file XML del modello di pubblicazione e definito nel file XML di configurazione nella sezione dell'entità altiumType="ProjectChangeOrder" – vedi esempio.
A seconda dell'istanza PLM, le definizioni di configurazione includono lo schema per l'identificazione dell'ordine di modifica (numerazione, posizione, ID, ecc.), attributi specifici dell'ordine di modifica, quali Nome/Titolo, Descrizione e Complessità della modifica (solo Windchill), e impostazioni delle opzioni, quali la strategia di creazione dell'ordine di modifica (nessuno, nuovo o riutilizzo di uno esistente) e l'avanzamento dello stato Lifecycle (solo Windchill e Agile). L'ordine di modifica definito viene abilitato durante la pubblicazione dichiarando il relativo riferimento publishId nel modello di pubblicazione associato – vedi esempio.
Una volta definiti nei file XML di configurazione e del modello di pubblicazione del server, gli ordini di modifica sono disponibili nei flussi di lavoro PLM di creazione del progetto e del processo di pubblicazione avviati da Altium Designer o tramite l'interfaccia dell'Enterprise Workspace. Durante il flusso viene presentato un modulo associato all'ordine di modifica, nel quale specificarne le impostazioni e le opzioni.
► Per informazioni sull'utilizzo della funzionalità degli ordini di modifica PLM (ECO) per le istanze PLM Windchill, Agile e Arena, consulta i commenti nei rispettivi file XML di configurazione e file XML dei modelli di pubblicazione di esempio, scaricabili dall'Enterprise Workspace.
Anziché utilizzare i file di configurazione forniti per creare una nuova istanza del sistema aziendale, è possibile utilizzare il generatore di configurazione interno del Workspace per creare una configurazione adattata, la cui struttura deriva dal modello di dati del Workspace. Il generatore richiede le informazioni di connessione (tipo di PLM e URL), quindi interroga i dati del Workspace per individuare i tipi di componenti registrati (condensatori, diodi, ecc.) e i relativi modelli di componente, così da creare un file di configurazione di base. Fai clic sulla seguente sezione espandibile per maggiori informazioni:
Generatore di configurazione
Una funzione di configurazione adattiva è disponibile tramite il collegamento Genera configurazione nella pagina Add new instance, accessibile dal pulsante
nel Workspace.
Nella finestra di dialogo Generate Configuration, seleziona il tipo di sistema aziendale a cui connetterti, scegliendo uno dei tipi di PLM disponibili (Windchill, Arena, ecc.), quindi il relativo URL remoto. Seleziona il pulsante
per creare un nuovo file dm-configuration.xml, che potrà essere salvato e poi aggiunto alla nuova istanza PLM tramite il pulsante
.
Il generatore crea la configurazione in modo che corrisponda al modello di dati dell'istanza corrente del Workspace. Ad esempio, i tipi di componenti registrati nel Workspace vengono aggiunti come tipi di entità nel file di configurazione (dm-configuration.xml). Ogni sezione di entità include le corrispondenti sezioni ToPlm e ToAltium e i parametri mappati ricavati dal relativo modello di componente (se disponibile). Sono incluse anche sezioni per la pubblicazione dei progetti, che consentono di mappare gli elementi del pacchetto di rilascio al sistema aziendale.
Tutte le sezioni della configurazione generata includono commenti TODO che evidenziano le aree da integrare o modificare per garantire la compatibilità con la configurazione del Workspace/PLM. Per maggiori informazioni su come modificare il file di configurazione affinché funzioni con il tuo ambiente Workspace/PLM, consulta i commenti esplicativi inclusi nei file di configurazione di esempio forniti.
Supporto per PLM di terze parti
Il Workspace Altium 365 offre ulteriore supporto per le configurazioni di sistemi PLM "non nativi" sviluppate da terze parti. Questo supporto è abilitato da Generic Connector di Altium, che richiede la licenza Altium 365 PLM Generic Connector Addon.
Quando si aggiunge un'istanza PLM del Workspace per un sistema di questo tipo, i file XML preconfigurati forniti dalla terza parte vengono caricati nella configurazione di tale istanza PLM, come descritto sopra.
Convalida della connessione
Il Workspace offre un controllo completo di convalida della connessione all'istanza PLM, disponibile tramite il pulsante
nella pagina Add/Edit Instance. Questo esegue una serie di controlli di compatibilità della configurazione e ne riporta immediatamente i risultati.
Quando viene eseguito il report di convalida della connessione, il Workspace analizza la configurazione corrente e le impostazioni del modello di pubblicazione per verificarne la compatibilità sia con l'istanza del Workspace sia con i dati del sistema aziendale di destinazione. I problemi di configurazione, come errori nei percorsi, definizioni dei tipi di componenti e parametri senza corrispondenza o impostazioni del ciclo di vita o delle revisioni non valide, vengono rilevati e segnalati nella successiva finestra di dialogo Configuration Validation Report.
Se vengono segnalati errori di configurazione, con un conseguente stato complessivo ERROR (Status), sarà necessario risolverli prima di poter creare la nuova istanza. Lo stato WARNING, che indica problemi quali tipi di componenti del Workspace non inclusi nella configurazione o attributi specificati non disponibili nel sistema aziendale, consente comunque di salvare e utilizzare l'istanza configurata.
Gli errori e gli avvisi segnalati possono quindi essere corretti nei file di configurazione/pubblicazione applicati e/o modificando le impostazioni del Workspace o del sistema aziendale. Assicurati di fare clic sul pulsante
dopo aver definito correttamente l'istanza. L'istanza apparirà nell'elenco corrente delle istanze connesse, tornando alla pagina principale PLM Integration dell'interfaccia.
Sincronizzazione dei componenti
La sincronizzazione dei componenti tra il Workspace Altium 365 e l'istanza del sistema aziendale connesso, o più precisamente dei relativi dati parametrici, si basa sul LibSync flusso di lavoro del processo. Il processo LibSync è predefinito nel Workspace e non è accessibile (né modificabile) dalla pagina Admin - Processes. Tuttavia, trattandosi di un processo basato su un flusso di lavoro, è possibile visualizzare i risultati della sincronizzazione e gestire eventuali errori.
L'utilizzo del processo di sincronizzazione prevede quanto segue:
-
Definizione delle impostazioni di sincronizzazione per ciascun tipo di componente, che in pratica consiste nel:
- Determinare la direzione della sincronizzazione (verso il Workspace o verso il PLM).
- Determinare quali tipi di componenti sono coinvolti e dove creare i nuovi componenti.
- Configurare la mappatura o gli attributi dei parametri.
- Configurazione della mappatura dei dati delle scelte dei componenti, se applicabile.
- Esecuzione della sincronizzazione.
I primi due gruppi di attività sopra indicati vengono gestiti nel file di configurazione utilizzato per l'istanza del sistema aziendale connesso (ad esempio un PLM). La sincronizzazione vera e propria può essere eseguita su richiesta dalla pagina PLM Integration dell'interfaccia del Workspace e/o può essere pianificata, ossia eseguita automaticamente a intervalli periodici definiti durante la configurazione della connessione all'istanza PLM.
Configurazione della sincronizzazione
All'interno del file di configurazione, la connettività con l'istanza del sistema aziendale è definita tra i tag Instance mediante un tipo di driver specificato e un URL di destinazione. Se per creare il file di configurazione è stato utilizzato il Generatore di configurazione, i riferimenti al driver e all'URL inclusi sono quelli inseriti nella finestra di dialogo Generate Configuration durante il processo di generazione.
<Instance>
<Driver>[Driver Type]</Driver>
<Url>[PLM API URL]</Url>
</Instance>
Nella successiva sezione Schema del file di configurazione, si definisce una sezione per la mappatura della sincronizzazione per ciascun tipo di parte dedicato. Sul lato Workspace, si tratta del componente di tipo altiumType: il suo valore è una delle opzioni dei parametri del tipo visibili nella pagina Gestione dati - Tipi di componenti della finestra di dialogo Preferences in Altium Designer. Sul lato PLM, viene creata una parte di tipo plmType, determinato dal relativo valore nell'ambiente PLM.
La sezione viene dichiarata come Entity nel file; un esempio, per i condensatori, potrebbe essere:
<Entity altiumType="Capacitor" plmType="Capacitor">
.
.
</Entity>
All'interno di Entity, vengono utilizzate due sezioni per controllare e configurare la sincronizzazione dal Workspace all'istanza PLM e dall'istanza PLM al Workspace, consentendo una sincronizzazione unidirezionale o bidirezionale. Per ulteriori informazioni, consulta le sezioni seguenti insieme ai commenti presenti nei file di configurazione di esempio. In definitiva, quanto definito nel file di configurazione varierà in base alle tue esigenze specifiche e agli attributi (PLM) definiti nell'istanza del sistema aziendale collegata.
ToPlm
Questa sezione viene utilizzata per controllare e configurare la sincronizzazione dal Workspace all'istanza PLM nella forma:
<ToPlm sync="true">
.
.
</ToPlm>
All'interno della sezione ToPlm, sono definite le seguenti sezioni:
- Modalità di creazione dei nuovi componenti nell'istanza PLM, tra i tag <CreateInfo> e </CreateInfo>. Un esempio potrebbe essere la scelta di uno schema di denominazione degli elementi definito nel sistema aziendale di destinazione e la specifica di un prefisso per la numerazione degli elementi:
<CreateInfo>
<Numbering name="Electrical">
<Fields>
<Field name="Code" value="120"/>
</Fields>
</Numbering>
</CreateInfo>
-
Filtri per limitare i componenti del Workspace da sincronizzare con il PLM, tra i tag <SourceCriteria> e </SourceCriteria>. La propagazione dei dati di origine può essere limitata utilizzando combinazioni logiche booleane degli attributi dei parametri, in cui più insiemi di attributi possono produrre un risultato di filtraggio specifico mediante la semplice applicazione di clausole logiche AND, OR e NOT. Per ulteriori informazioni, consulta le relative note su
SourceCriterianei file XML di configurazione di esempio.
Questa funzionalità è estremamente utile se, ad esempio, nel Workspace sono presenti 6000 condensatori, ma desideri sincronizzare soltanto una determinata cartella contenente 85 condensatori ceramici. In questo caso, è sufficiente specificare il percorso della cartella all'interno della coppia di tag SourceCriteria (<Folder>Components/Capacitors/Ceramic</Folder>) e, facoltativamente, qualsiasi altro attributo dei parametri necessario per restringere ulteriormente i dati di origine, ad esempio il tipo di package 0603. La relazione tra i criteri raggruppati è un operatore logico AND implicito; pertanto, l'esempio seguente sincronizzerà dal Workspace al PLM i condensatori ceramici con package 0603.
<SourceCriteria>
<Folder>Components/Capacitors/Ceramic</Folder>
<common:Attribute>
<common:Key>Case/Package</common:Key>
<common:Value>0603</common:Value>
</common:Attribute>
</SourceCriteria>
Sono inoltre disponibili coppie di tag dedicate alla logica OR (<Or>…</Or>) e coppie di tag di esclusione con logica NOT (<Not>…</Not>), che possono essere aggiunte all'interno della sezione del nodo SourceCriteria. Con queste opzioni, la logica OR si applica agli insiemi di attributi dei parametri aggiunti all'interno dei tag <Or></Or>, mentre la logica NOT si applica all'insieme di attributi dei parametri all'interno dei tag <Not>…</Not>. Un esempio potrebbe essere il requisito aggiuntivo di uno stato del ciclo di vita pari a Approved oppure Released, escludendo però (NOT) gli elementi con un valore del parametro Classification pari a SpecialOrder. In questo caso, la logica di filtraggio completa sarebbe:
<SourceCriteria>
<Folder>Components/Capacitors/Ceramic</Folder>
<common:Attribute>
<common:Key>Case/Package</common:Key>
<common:Value>0603</common:Value>
</common:Attribute>
<Or>
<common:Attribute>
<common:Key>Lifecycle</common:Key>
<common:Value>Released</common:Value>
</common:Attribute>
<common:Attribute>
<common:Key>Lifecycle</common:Key>
<common:Value>Approved</common:Value>
</common:Attribute>
</Or>
<Not>
<common:Attribute>
<common:Key>Classification</common:Key>
<common:Value>SpecialOrder</common:Value>
</common:Attribute>
</Not>
</SourceCriteria>
- Elenco degli attributi (parametri) da trasferire per i componenti dal Workspace al PLM, tra i tag <Attributes> e </Attributes>. Un esempio è:
<Attributes>
<!-- Name/Comment from Workspace will be passed to PLM field Name 'as is' -->
<common:Attribute>
<common:Key>name</common:Key>
<common:Value>${parameter.Name}</common:Value>
</common:Attribute>
<!-- Number generated on PLM side will be propagated to workspace -->
<!-- as PlmPartNumber parameter (note: any parameter name can be used)-->
<common:Attribute attributeType="item" primaryKeyOrdinal="1">
<common:Key>number</common:Key>
<common:Value>${parameter.PlmPartNumber}</common:Value>
</common:Attribute>
<!-- Workspace component description will go to PLM field Description. Value will be prefixed with 'Extended' -->
<!-- Description on Workspace side is a revision level parameter -->
<common:Attribute attributeType="revision">
<common:Key>description</common:Key>
<common:Value>Extended ${parameter.Description}</common:Value>
</common:Attribute>
<!-- This attribute will not be pushed to PLM component as part of library synchronization -->
<!-- It is being used to pass values during project publish with BOM -->
<common:Attribute>
<common:Key>refDes</common:Key>
<common:Value>${parameter.LogicalDesignator}</common:Value>
</common:Attribute>
<!-- RoHS field in PLM will be set to 'YES' -->
<common:Attribute>
<common:Key>RoHS</common:Key>
<common:Value>YES</common:Value>
</common:Attribute>
</Attributes>
ToAltium
Questa sezione viene utilizzata per controllare e configurare la sincronizzazione dall'istanza PLM al Workspace nella forma:
<ToAltium sync="true" mode="createAndUpdate">
.
.
</ToAltium>
L'istruzione facoltativa
mode determina la modalità di sincronizzazione dei dati dei componenti dal sistema aziendale al Workspace. La modalità predefinita (createAndUpdate) consente sia di creare nuovi componenti nel Workspace sia di aggiornare i componenti già presenti, mentre la modalità alternativa updateExisting consente soltanto di aggiornare i componenti già presenti nel Workspace.
All'interno della sezione ToAltium, sono definite le seguenti sezioni:
- Modalità e posizione di creazione dei nuovi componenti nel Workspace, tra i tag <CreateInfo> e </CreateInfo>.
<CreateInfo>
<!-- <ComponentTemplate>TODO component template Revision ID</ComponentTemplate> -->
<RevisionNamingScheme>1-Level Revision Scheme</RevisionNamingScheme>
<LifecycleDefinition>Component Lifecycle</LifecycleDefinition>
<Folder>Components/Inbox/Capacitors</Folder>
</CreateInfo>
Quando viene creata una voce componente nel Workspace, viene utilizzato il modello di componente associato alla cartella di destinazione del Workspace (Components/Inbox/Capacitors nell'esempio precedente), se specificato. Questo definirà anche lo schema di denominazione degli elementi utilizzato per il componente creato, sostituendo quello eventualmente specificato nella cartella di destinazione del Workspace; viceversa, se la cartella non definisce né un modello né uno schema di denominazione, la sincronizzazione non riuscirà.
Nota inoltre che nelle configurazioni di esempio sono definiti uno schema predefinito di denominazione delle revisioni (1-Level Revision Scheme) e una definizione del ciclo di vita (Component Lifecycle) da utilizzare: questi vengono sostituiti se alla cartella di destinazione del Workspace è associato un modello di componente.
Se nella configurazione viene aggiunto un riferimento a un modello di componente specifico (ad esempio, CMPT-00001), verrà utilizzato questo modello al posto di quello associato alla cartella di destinazione del Workspace. Le sue impostazioni avranno la precedenza su qualsiasi impostazione dei parametri nel file di configurazione (come la definizione del ciclo di vita e così via), ad eccezione di una cartella di destinazione definita.
<CreateInfo>
<!-- A specified Template overrules other CreateInfo settings, except the target Folder -->
<ComponentTemplate>CMPT-00001</ComponentTemplate>
<RevisionNamingScheme>1-Level Revision Scheme</RevisionNamingScheme>
<LifecycleDefinition>Component Lifecycle</LifecycleDefinition>
<!-- A specified target Folder overrules that defined in an applied Template -->
<Folder>Components/Inbox/Capacitors</Folder>
</CreateInfo>
Nota che il modello specificato verrà applicato solo ai componenti del Workspace appena creati. Questo approccio è particolarmente utile per gestire l'importazione o la sincronizzazione nel Workspace di parametri proprietari dei componenti provenienti da un sistema esterno. In questo caso, è possibile applicare un modello di componente personalizzato per interpretare i dati dei parametri in ingresso, impostare valori predefiniti appropriati, specificare i tipi di dati delle unità e definire il ciclo di vita e lo schema di denominazione delle revisioni per i componenti del Workspace appena creati.
- Filtraggio dei dati recuperati dall'istanza del sistema aziendale (PLM), tra i tag <SourceCriteria> e </SourceCriteria>. Un'istruzione di filtro può limitare i dati dei componenti ricevuti dal PLM a quelli creati da un autore specifico (come illustrato nella configurazione di esempio fornita) oppure agli elementi componente che presentano un determinato valore di attributo (Business Unit = Engineering_RD), come mostrato di seguito.
<SourceCriteria>
<ns2:Attribute>
<ns2:Key>Business Unit</ns2:Key>
<ns2:Value>Engineering_RD</ns2:Value>
</ns2:Attribute>
</SourceCriteria>
- Elenco degli attributi (parametri) da trasferire per i componenti dal PLM al Workspace, tra i tag <Attributes> e </Attributes>. Un esempio è:
<Attributes>
<!-- Name field from PLM will be passed to name/comment field in Workspace-->
<common:Attribute attributeType="revision">
<common:Key>name</common:Key>
<common:Value>${attribute.name}</common:Value>
</common:Attribute>
<!-- Description field from PLM will be passed to Description field in Workspace on revision level -->
<!-- Revision level attributes will cause new revision to be created in case parameter value is changed -->
<common:Attribute attributeType="revision">
<common:Key>Description</common:Key>
<common:Value>${attribute.description}</common:Value>
</common:Attribute>
<!-- Number field from PLM will be passed to PlmPartNumber field in Workspace on revision level -->
<!-- Note: any attribute name can be used -->
<common:Attribute attributeType="revision" primaryKeyOrdinal="1">
<common:Key>PlmPartNumber</common:Key>
<common:Value>${attribute.Number}</common:Value>
</common:Attribute>
<common:Attribute attributeType="item">
<common:Key>DynamicCONTS</common:Key>
<common:Value>Will not cause revision update if changed ${attribute.LastModified}</common:Value>
</common:Attribute>
</Attributes>
La sezione per definire la mappatura dei dati delle scelte dei componenti si trova alla fine del file di configurazione di esempio o di un file di configurazione generato.
Scelte dei componenti
Oltre alle dichiarazioni delle entità, lo schema di configurazione include una sezione aggiuntiva per definire la mappatura dei dati delle scelte dei componenti tra il sistema aziendale (PLM) e il Workspace. La sezione consente di mappare parametri specifici degli attributi delle scelte dei componenti per la maggior parte dei sistemi PLM supportati e le relazioni dei dati dell'elenco dei produttori approvati (AML) per i sistemi PLM Aras, Windchill e Arena. Si tratta di una definizione bidirezionale esclusiva, ovvero valida per entrambe le direzioni, ma non contemporaneamente, che specifica gli attributi relativi al produttore e al codice del componente utilizzati per la propagazione dei dati delle scelte dei componenti.
Quando la sincronizzazione delle scelte dei componenti è abilitata nel file di configurazione (sync="true"), il valore degli attributi specificati viene trasferito al sistema di destinazione. La direzione di propagazione dei dati è determinata dall'espressione "To", dove ToAltium specifica che i dati parametrici del componente PLM vengono applicati al componente creato o aggiornato nel Workspace, mentre ToPlm fa sì che i dati delle scelte dei componenti associati al componente del Workspace vengano trasferiti al sistema PLM. La configurazione abilitata si applica a tutte le entità componente definite, pertanto i dati delle scelte dei componenti verranno trasferiti alla destinazione specificata ogni volta che viene rilevato un set di dati di un componente.
Una voce di esempio per una mappatura ToAltium delle scelte dei componenti in un file di configurazione, in cui gli attributi del sistema PLM sono MFR1 (nome del produttore) e MPN1 (codice componente del produttore), potrebbe essere:
<PartChoices>
<ToAltium sync="true">
<MfrMappings>
<MfrMapping>
<MfrName>MFR1</MfrName>
<MfrPartNumber>MPN1</MfrPartNumber>
</MfrMapping>
</MfrMappings>
</ToAltium>
</PartChoices>
La sincronizzazione dei dati delle scelte dei componenti supporta anche più voci di dati. Questi attributi aggiuntivi devono essere specificati nella mappatura del file di configurazione come un'ulteriore coppia di definizioni degli attributi, ad esempio: MFR2 e MPN2, come mostrato di seguito:
<MfrMappings>
<MfrMapping>
<MfrName>MFR1</MfrName>
<MfrPartNumber>MPN1</MfrPartNumber>
</MfrMapping>
<MfrMapping>
<MfrName>MFR2</MfrName>
<MfrPartNumber>MPN2</MfrPartNumber>
</MfrMapping>
</MfrMappings>
I sistemi aziendali che dispongono di funzionalità native o integrate per la scelta dei componenti del produttore, come Manufacturer Parts in Windchill e Vendor Parts in Arena, non richiedono parametri mappati nel file di configurazione. In questo caso, è sufficiente abilitare l'accettazione dei dati delle scelte dei componenti nella relativa sezione di configurazione.
<PartChoices>
<ToAltium sync="true"/>
</PartChoices>
Oppure, laddove sia supportato il trasferimento dei dati al sistema aziendale:
<PartChoices>
<ToPlm sync="true"/>
</PartChoices>
Supporto di PTC Windchill PartsLink
Il sistema PLM PTC Windchill offre un modulo opzionale PartsLink che consente ai componenti di essere classified in gruppi. Le classificazioni dei componenti specificate in Windchill possono anche includere coppie attributo/valore associate per fornire un'ulteriore definizione all'interno della classificazione. Il sistema PartsLink consente di individuare facilmente e rapidamente tipi specifici di componenti ed è supportato dall'integrazione PLM del Workspace per la sincronizzazione bidirezionale e l'accesso in lettura/scrittura.
In un'istanza di configurazione del Workspace per Windchill, una classificazione PartsLink viene creata in Windchill specificando un attributo di associazione nella sezione ToPLM, nel formato mostrato nell'esempio seguente:
<common:Attribute>
<common:Key>Classification</common:Key>
<common:Value>102-Capacitor</common:Value>
</common:Attribute>
Nel caso precedente, la coppia chiave/valore definisce una classificazione denominata 102-Capacitor. Questa può avere un attributo di classificazione associato, creato in Windchill specificando un parametro di nome e valore (qui, Capacitance); si noti che a una singola classificazione possono essere applicati più attributi:
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>${parameter.Value}</common:Value>
</common:Attribute>
Nella sezione di sincronizzazione ToAltium della configurazione, i dati provenienti da Windchill possono essere filtrati in base alla classificazione desiderata dei componenti all'interno del gruppo di tag <SourceCritera>, specificando il relativo ClassificationName.
<SourceCriteria>
<ClassificationName>102-Capacitor</ClassificationName>
</SourceCriteria>
Per recuperare tutti i componenti che corrispondono a un determinato valore dell'attributo di classificazione (ad esempio, tutti i condensatori da 10 µF), la sezione <SourceCriteria> deve includere impostazioni degli attributi di configurazione che definiscano un ClassificationName e la chiave e il valore dell'attributo di classificazione associato.
<SourceCriteria>
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>10uF</common:Value>
</common:Attribute>
</SourceCriteria>
Per estrarre un valore specifico di un attributo di classificazione da Windchill, ricavare il parametro Value dal nome dell'attributo specifico associato a un ClassificationName.
<common:Attribute attributeType="revision">
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Value</common:Key>
<common:Value>${attribute.Capacitance}</common:Value>
</common:Attribute>
All'interno di Windchill, una classificazione PartsLink viene definita creando un binding attribute che può essere applicato a un tipo di componente. Un attributo di classificazione del componente viene quindi aggiunto a una classe di classificazione definita.
Le voci dei componenti in Windchill includeranno la classificazione definita e gli eventuali parametri degli attributi di classificazione specificati, che saranno a loro volta disponibili per il processo di sincronizzazione dei componenti PLM del Workspace.
Quando una voce di componente viene sincronizzata da Windchill al Workspace e nella configurazione PLM del Workspace è stata specificata l'interazione con PartsLink, gli attributi di configurazione di Windchill per quel componente verranno propagati al componente sul lato Altium.
Esecuzione della sincronizzazione dei componenti
La sincronizzazione dei componenti (di libreria) può essere eseguita come processo manuale o pianificato, rispettivamente tramite il pulsante Sync action di una voce di istanza PLM nella pagina PLM Integration del Workspace oppure come ciclo automatizzato specificato nella configurazione dell'istanza. Fare clic su
controllo associato all'istanza PLM che desideri sincronizzare. Il processo di sincronizzazione proseguirà attraverso il flusso di lavoro LibSync, in conformità con le impostazioni definite nel file di configurazione associato.
Il controllo cambia in
. Se desideri interrompere il processo di sincronizzazione, fai clic su questo controllo. Verrà visualizzata una finestra di conferma, nella quale puoi fare clic su
per annullare la sincronizzazione: tutti i componenti già sincronizzati rimarranno tali, ma da quel momento non verranno eseguite ulteriori sincronizzazioni.
Sincronizzazione dei componenti in corso tra il Workspace e l'istanza PLM indicata.
Quando viene eseguita la sincronizzazione dei componenti, il processo LibSync avanza attraverso il flusso di lavoro predefinito fino al completamento o al verificarsi di un errore. Aggiorna il browser (F5) per visualizzare lo stato attuale del processo di sincronizzazione. Per monitorare o esaminare il processo LibSync, seleziona la scheda Synchronization status e scegli l'opzione di elenco Closed: se un processo è ancora in esecuzione, verrà visualizzato nell'elenco Active. Il pulsante
, disponibile per gli amministratori, consente di scaricare un registro dettagliato di tutte le attività di sincronizzazione elencate in un file CSV con valori separati da virgole (Synchronisation status.csv).
Le sottoschede della vista forniscono le seguenti informazioni:
-
Diagram – una rappresentazione grafica del flusso di lavoro del processo, con evidenziata la fase corrente (completato o stato di errore/insuccesso).
-
Data – un riepilogo informativo dell'azione del processo, che include l'esito positivo o negativo delle relative fasi e un collegamento al report del processo registrato; vedi sotto.
-
History – un registro cronologico dei principali eventi di sincronizzazione del Workspace, elencati in sequenza.
I risultati del processo LibSync sono disponibili anche nella pagina Process Management (Admin » Processes), nella scheda Browser.
I dettagli dell'evento LibSync selezionato, visualizzati nella sottoscheda Data, includono un collegamento al file di registro di sistema (PLM [date-number].log) relativo all'evento.
Sincronizzazione pianificata
È inoltre possibile pianificare la sincronizzazione automatica. A tale scopo, modifica l'istanza PLM (dalla pagina principale PLM Integration, fai clic sul suo nome o sul controllo associato), seleziona la scheda Component Synchronisation e abilita l'opzione Synchronize PLM Components with server on schedule. Utilizza i controlli Synchronize every per configurare la pianificazione della sincronizzazione automatica in base alle tue esigenze. Il sistema è molto flessibile e consente di:
- Impostare una sincronizzazione pianificata ogni 15/30/45/60/75/90 minuti.
- Impostare una sincronizzazione pianificata ogni x ore.
- Impostare una sincronizzazione giornaliera pianificata, da eseguire a un orario specificato.
La pianificazione definita verrà riportata nella pagina principale PLM Integration, nella colonna Sync scheduled.
Configurazione di una pianificazione della sincronizzazione.
Puoi anche eseguire il processo di sincronizzazione su richiesta. Fai clic sul pulsante
e scegli la modalità di sincronizzazione desiderata:
-
Incremental – in questa modalità, verranno inclusi nella sincronizzazione only i componenti modificati dall'ultima sincronizzazione (ovvero quelli con una marca temporale successiva alla data dell'ultima sincronizzazione) e che soddisfano i criteri di sincronizzazione definiti nel file di configurazione, propagando le modifiche di conseguenza. Questa è la modalità predefinita ed è la stessa che viene eseguita facendo clic sul controllo
di un'istanza PLM nella pagina principale PLM Integration.
- Full – questa modalità forza una sincronizzazione completa. Tutti i componenti che soddisfano i criteri di sincronizzazione definiti nel file di configurazione verranno inclusi nella sincronizzazione, propagando le modifiche di conseguenza.
Flussi di lavoro dei processi
Le seguenti definizioni di processo (e i relativi flussi di lavoro) sono disponibili tramite il Workspace a supporto dell'integrazione PLM:
-
Part Requests Categoria di processi:
- Part Request with PLM Part Create – supporta la creazione automatica di un componente nell'istanza PLM e la successiva propagazione del codice articolo generato al componente del Workspace. Il diagramma del flusso di lavoro è riportato di seguito.
È importante notare che, quando modifichi questa definizione di esempio per crearne una personalizzata, devi specificare l'istanza PLM in cui creare gli articoli. Seleziona l'entità Create Part in PLM nel diagramma del flusso di lavoro e scegli l'istanza PLM dal menu a discesa associato al campo PLM Instance. Questo menu elenca tutte le istanze PLM attualmente definite (come specificato nella pagina PLM Integration dell'interfaccia).
► Consulta Creazione e gestione dei processi per ulteriori informazioni sull'utilizzo dei flussi di lavoro dei processi.
- Project Activities Categoria di processi:
- Publish to PLM (User selects) – pubblicazione degli output rilasciati di un progetto gestito nell'istanza PLM integrata, con la possibilità per l'utente di selezionare esattamente quali output pubblicare. Il diagramma del flusso di lavoro è riportato di seguito.
- Project Releaser with Publish – pubblicazione nell'istanza PLM integrata come fase aggiuntiva del Project Releaser. Il diagramma del flusso di lavoro è riportato di seguito.
-
Project Creations Categoria di processi:
- Project with initialise in PLM – supporta la creazione automatica di codici articolo nell'istanza PLM e la loro successiva propagazione come parametri del progetto di progettazione del Workspace. Il diagramma del flusso di lavoro è riportato di seguito.
Accesso ai processi relativi al PLM
Le sezioni seguenti illustrano dove accedere ai processi attivati relativi al PLM. Poiché gli esempi non possono essere utilizzati direttamente così come vengono forniti, a scopo illustrativo sono stati creati a partire da essi i seguenti processi:
- PR with PLM Part Create – creato dalla definizione di processo di esempio: Part Request with PLM Part Create.
- Publish to Company PLM – Choose Data – creato dalla definizione di processo di esempio: Publish to PLM (User selects).
- Project Releaser with Publish to Company PLM – creato dalla definizione di processo di esempio: Project Releaser with Publish.
- Create Project with PLM Initialise – creato dalla definizione di processo di esempio: Project with Initialise in PLM.
Richieste di componenti
Accesso da Altium Designer tramite il pannello Explorer, dopo aver eseguito una ricerca, dal riquadro Details del pannello Manufacturer Part Search, oppure dal collegamento in fondo all'elenco dei componenti nel pannello Components.
Dall'interfaccia del Workspace, è possibile accedere alla definizione di processo attivata dalla pagina Part Requests, facendo clic sul pulsante
in alto a destra nella pagina.
Esempio di richiesta di un componente
L'esempio seguente illustra brevemente la creazione di un nuovo componente nel Workspace, seguita dalla creazione automatica di un componente corrispondente nell'istanza PLM. Il codice componente generato viene quindi trasferito dall'istanza PLM al componente nel Workspace, come parametro a livello di Item: ciò significa che non è necessario rilasciare una nuova revisione del componente del Workspace. In questo esempio, la definizione di processo utilizzata è Part Request with PLM Part Create, derivata dalla definizione di esempio Part Request with PLM Part Create.
- Avviare il processo di richiesta di un componente e compilare il modulo successivo, specificando i dettagli della richiesta iniziale secondo necessità. Nell'immagine seguente, la richiesta viene inviata tramite la pagina Part Requests dell'interfaccia del Workspace e riguarda un singolo componente.
- La nuova richiesta di un componente verrà visualizzata come processo attivo nella pagina Part Requests, con lo stato corrente riportato sia nella voce principale sia nel diagramma del flusso di lavoro sottostante.
-
Una volta che l'utente previsto ha preso in carico l'attività relativa alla richiesta, o gli è stata assegnata, procede alla creazione dei componenti richiesti. Ogni componente creato e/o scelto per soddisfare la richiesta viene aggiunto al campo Components dell'attività. I componenti aggiunti verranno creati automaticamente nel PLM. Nell'immagine seguente è stato creato e aggiunto un singolo componente, CMP-007-00004. Assicurarsi che il campo Next step sia impostato su Completed e fare clic sul pulsante
.
Potrebbe essere richiesto di fornire le credenziali di accesso al sistema PLM specificato nel flusso di lavoro del processo di richiesta di un componente.
- Il flusso di lavoro del processo proseguirà con la creazione del componente specificato nell'istanza PLM. Al termine del processo, è possibile visualizzare il codice componente PLM generato nella scheda Data dei processi. Assicurarsi di impostare il filtro in alto a sinistra in modo da visualizzare i processi Closed.
- Tornare in Altium Designer, individuare il componente creato nel pannello Explorer e passare alla relativa scheda Preview . Nell'area dei parametri, si noterà che è stato aggiunto un parametro, PlmPartNumber, il cui valore è il codice del componente corrispondente creato nel PLM.
Si noti che il parametro è stato aggiunto al componente, ma la revisione è rimasta invariata: il componente non è stato rilasciato nuovamente. Questo perché il parametro è a livello di Item: viene aggiunto direttamente all'Item del componente ed è disponibile in tutte le sue revisioni.
Attività di progetto
I dati di progettazione del progetto rilasciati da Altium Designer nel Workspace possono essere trasferiti al PLM in modo controllato tramite i processi di pubblicazione su PLM del Workspace. I processi del Workspace definiscono l'interfaccia e la metodologia per l'attività di pubblicazione, mentre il modello di pubblicazione XML specificato definisce le modalità di trasferimento dei dati dei file al sistema PLM di destinazione.
Supporto delle cartelle di pubblicazione per Windchill PLM
Quando si configura un processo di pubblicazione su PLM per Windchill® PLM, è anche possibile specificare e creare una cartella Windchill di destinazione per i documenti pubblicati dal Workspace.
I parametri relativi alla cartella Windchill sono definiti nel file XML del modello di pubblicazione applicato alla voce di integrazione con Windchill PLM nel Workspace. I nodi di definizione delle cartelle utilizzano il formato di tag <pt:Folder>xxx</pt:Folder>, dove pt è lo spazio dei nomi corrente e xxx è il percorso completo della cartella, e vengono inseriti come regola di pubblicazione nella sezione FileDistribution per ciascun tipo di documento, ad esempio un output di fabbricazione PCB.zip.
Un esempio della gerarchia della struttura XML di pubblicazione è il seguente:
<pt:EntityRule id="FAB">
<pt:FileDistributions>
<pt:FileDistribution archiveName="PCB.zip">
<pt:Folder>PRODUCT/Projects/${project.name}/FAB data</pt:Folder>
L'ultima riga specificherebbe o creerebbe una cartella di destinazione per la pubblicazione dell'output di fabbricazione PCB.zip, con la struttura di cartelle Windchill seguente (dove il nome del progetto è MyProject):
PRODUCT
Projects
MyProject
FAB data
Si noti che il percorso della cartella definito nel file XML di pubblicazione è assoluto, anziché relativo, e può includere altre proprietà del progetto, come il nome del progetto (${project.name}) e il numero di assemblaggio (${project.PLM_ASSEMBLY_NUMBER}).
Processo di pubblicazione standard
Sul lato progettazione, è possibile accedere al processo standard di pubblicazione su PLM da Altium Designer, tramite il sottomenu Project » Project Activities del progetto attivo.
Dall'interfaccia del Workspace, è possibile accedere alle definizioni di processo attive dalla vista Project Management, facendo clic sul pulsante
.
Pubblicazione con Project Releaser
Il processo di pubblicazione su un'istanza PLM nell'ambito di Project Releaser è accessibile da Altium Designer tramite il sottomenu Project » Project Releaser del progetto attivo.
Verrà visualizzato Project Releaser, con una fase aggiuntiva: 7: Publish to PLM. Inoltre, nel menu associato al pulsante
è disponibile il comando Prepare & Release & Publish to PLM, che consente di eseguire Project Releaser senza fermarsi a esaminare i dati generati e il report di esecuzione.
Definizione del nome della fase
Se si utilizza la definizione di processo di esempio, Project Releaser with Publish, per creare una definizione personalizzata, il nome della fase visualizzato nel client di progettazione è Publish to PLM per impostazione predefinita. Anche il comando composito nel menu a discesa del pulsante Project Releaser
include questo nome: Prepare & Release & Publish to PLM.
Tuttavia, puoi modificare il modo in cui questo elemento (e il suggerimento descrittivo associato alla fase) viene presentato agli utenti. I campi per farlo sono disponibili nel flusso di lavoro sottostante del processo, quando è selezionato l'elemento Start (di tipo Start Release). Questi campi sono:
- Action name – il nome dell'azione successiva al rilascio del progetto, che corrisponde al nome della fase presentata come fase 7 in Project Releaser. La compilazione di questo campo è obbligatoria se nel flusso di lavoro del processo sono definite delle attività. Questo nome verrà utilizzato anche per il comando di menu, nel formato Prepare & Release & <Action name>.
- Action description – descrizione dell'azione successiva al rilascio del progetto, presentata all'utente in Project Releaser come suggerimento per la voce della fase 7.
Impostazioni predefinite per l'elemento Start in un flusso di lavoro basato sulla definizione di processo di esempio Project Releaser with Publish e relativa presentazione in Project Releaser.
L'immagine seguente mostra questi campi modificati nel flusso di lavoro sottostante e l'effetto risultante sulle voci in Project Releaser.
Impostazioni modificate per l'elemento Start quando viene utilizzato in un flusso di lavoro per la pubblicazione nel PLM tramite Project Releaser.
Se esegui Project Releaser con il comando standard Prepare , dopo la revisione e il rilascio dei dati, nella fase Execution Report verrà visualizzato il pulsante
. Fai clic su questo pulsante per proseguire con il flusso di lavoro sottostante del processo ed effettuare la pubblicazione nel PLM. Verrà visualizzata la finestra di dialogo Login Credentials. Inserisci Username e Password per la tua istanza PLM e seleziona il modello PLM che desideri utilizzare (visualizzato nel formato <PLMInstance>:<PublishingTemplate>).
Fai clic sulla scheda Diagram per visualizzare il flusso di lavoro sottostante del processo.
Fai clic sul pulsante
per procedere con la pubblicazione in base a tale flusso di lavoro.
Verifica lo stato del processo di pubblicazione nel PLM tramite l'interfaccia del Workspace selezionando la vista Activities all'interno della vista dettagliata del progetto, dopo aver aperto il progetto dalla vista Projects. Seleziona l'opzione di visualizzazione Opened per vedere lo stato durante l'esecuzione del processo e l'opzione delle attività Closed per accedere alle informazioni sullo stato una volta completato il processo.
Creazione di progetti
Sul lato progettazione, accedi da Altium Designer tramite il sottomenu principale File » New » Project in <workspace>.
Dall'interfaccia del Workspace, puoi accedere alla definizione di processo attivata dalla vista Projects facendo clic sul pulsante
.
Puoi accedervi anche durante la clonazione di un progetto, tramite il pulsante di menu
nella vista Projects.
Il flusso di lavoro del processo proseguirà mostrando una finestra di dialogo che consente di definire il nome, la descrizione e il tipo di progetto, nonché l'eventuale elemento modello di progetto da utilizzare per crearlo. Dopo aver fatto clic su Start, verrà visualizzata la finestra di dialogo Login Credentials. Inserisci Username e Password per la tua istanza PLM e seleziona il modello PLM che desideri utilizzare (visualizzato nel formato <PLMInstance>:<PublishingTemplate>). Quindi fai clic su Submit per proseguire con il flusso di lavoro.
Esempio di creazione di un progetto
L'esempio seguente illustra brevemente la creazione di un nuovo progetto con inizializzazione nel PLM. Il processo viene avviato da Altium Designer utilizzando la definizione Create Project with PLM Initialise, derivata dalla definizione di esempio Project with Initialise in PLM.
- Dopo aver avviato il processo (File » New » Project in <workspace> » Create Project with PLM Initialise), viene visualizzata una finestra di dialogo (con lo stesso nome della definizione di processo) che consente di definire il progetto. In questo esempio, chiameremo semplicemente il progetto Example_Project_with_PLM_Init, gli assegneremo una descrizione e lasceremo invariati tutti gli altri campi, compresi quelli nella scheda Advanced .
-
Una volta definito il progetto, fai clic sul pulsante
. Viene visualizzata la finestra di dialogo Login Credentials. Poiché si tratta di un nuovo progetto, devi fornire le tue credenziali di accesso al PLM e specificare l'istanza PLM e il modello di pubblicazione associato da utilizzare. Questo esempio utilizza un file di configurazione e il relativo modello di pubblicazione (come richiesto) per un PLM Arena.
Dopo aver fornito le credenziali e scelto l'istanza PLM e il modello di pubblicazione, fai clic sul pulsante
.
-
Il processo proseguirà fino al completamento (a condizione che non si verifichino errori), come si può vedere nel pannello Tasklist, nell'elenco dei processi Activities chiusi: seleziona l'opzione Show closed dal menu del pulsante
associato. Seleziona la voce dell'attività per ulteriori informazioni sul processo completato e sul relativo set di dati.
Il processo completato e le relative informazioni possono essere visualizzati anche nell'interfaccia del Workspace selezionando la vista Activities all'interno della vista dettagliata del progetto, dopo aver aperto il progetto dalla vista Projects. Seleziona l'opzione delle attività Closed (in alto a destra) per accedere alle informazioni sullo stato del processo completato.
-
In Altium Designer, il nuovo progetto è visibile nel pannello Projects, in attesa del commit nel repository di progettazione Versioned Storage basato su Git nel Workspace: per eseguirlo, fai clic con il pulsante destro del mouse sulla voce del progetto e utilizza il comando Save to server. Puoi quindi aggiungere i documenti sorgente e iniziare a progettare. Al momento della pubblicazione, il progetto è già collegato alle parti pertinenti nell'istanza PLM.
Dalla scheda Server Parameters della finestra di dialogo Project Options, oppure nell'elenco dei parametri del progetto nel pannello Explorer, puoi vedere i codici parte assegnati nell'istanza PLM e associati alle rispettive entità del progetto che possono essere rilasciate/pubblicate.
La corrispondenza tra i nomi dei parametri PLM e i pacchetti di rilascio del progetto è specificata nel file di configurazione PLM, a sua volta definito in base agli attributi di denominazione e numerazione richiesti dal sistema PLM.
Quando inserisci una stringa di testo nello schema elettrico, i parametri PLM associati al progetto saranno disponibili come stringhe speciali:













































