Der Enterprise Server Workspace kann mit einer oder mehreren PLM-Instanzen verbunden werden, mit direkter Unterstützung für Windchill®, Arena®, Oracle® Agile™, Aras Innovator® und Siemens Teamcenter® (mit zusätzlicher Einrichtung). Die Konfiguration der Schnittstelle erfolgt über die Browser-Oberfläche des Workspace, wobei die meisten Einstellungen in einer XML-basierten Konfigurationsdatei definiert werden (die über den Workspace hochgeladen wird). Wenn die Schnittstelle eingerichtet ist und funktioniert, stehen beim Arbeiten in den folgenden klar abgegrenzten Bereichen Features und Funktionen zur Verfügung:
-
Library (Komponenten) – für die unidirektionale oder bidirektionale Synchronisierung Ihrer Komponenten, Komponentenparameter und Teileauswahlen zwischen Ihrem Workspace und Ihrer PLM-Instanz. In der Konfiguration können Sie festlegen, welche Parameter in welchem System führend sind. Darüber hinaus ermöglichen Artikelparameter, Eigenschaften auf der Workspace-Seite zu aktualisieren (pro Feld konfigurierbar), ohne dass dafür formell eine neue Revision dieses Component Item freigegeben werden muss. Außerdem steht ein spezieller Part Request-Workflow zur Verfügung, der die automatische Erstellung einer Komponente in Ihrer PLM-Instanz unterstützt sowie die Rückübertragung generierter PLM-Teilenummern an Komponenten im Workspace.
-
Design (Projekte) – ein spezieller Workflow für Projekterstellungen steht zur Verfügung, der die automatische Erstellung von Teilenummern in Ihrer PLM-Instanz und anschließend deren Übertragung als Parameter des Altium Designer-Projekts unterstützt. Solche Parameter können in speziellen Strings verwendet werden (z. B. für Blattumrandungs-Anmerkungen). Sie können Ihr Design in Ihre PLM-Instanz veröffentlichen, indem Sie den Project Releaser in Altium Designer ausführen. Der Veröffentlichungsvorgang verwendet eine Veröffentlichungsvorlage – definiert als Teil der Integrationskonfiguration der PLM-Instanz –, um zu steuern, wie Daten an das PLM übertragen werden sollen. Und wenn Sie zum ersten Mal veröffentlichen und Teilenummern (auf der PLM-Seite) noch nicht mit dem Projekt verknüpft sind, werden diese Teilenummern im PLM erstellt und im Rahmen dieser ersten Veröffentlichung mit dem Projekt verknüpft. Sie können außerdem Komponenteneinträge für Workspace-Bibliothekskomponenten in der PLM-Instanz als Teil des Veröffentlichungsvorgangs definieren (optional, abhängig von der Konfiguration). Und Sie können jederzeit genau sehen, was erstellt wurde, etwa Teilenummern in der PLM-Instanz, als Teil des Verlaufs des Prozess-Workflows (History Registerkarte).
PLM-Unterstützung
Der Enterprise Server Workspace bietet direkte Unterstützung für die folgenden PLM-Systeme:
-
PTC Windchill® PLM Version 12
-
Arena® PLM
-
Oracle® Agile™ PLM
-
Aras Innovator® Release 12.0 SP18
Additional Setup for Aras Innovator
Um die PLM-Integration mit Aras Innovator zu erreichen, muss Ihr Altium-Server bei der Aras Authentication setup registriert werden, indem ein neuer Knotenabschnitt zur Client-Registry hinzugefügt wird. Nach der Registrierung wird Ihrem verbundenen Server ein eindeutiges OAuth-Token zugewiesen, um den Zugriff zu authentifizieren.
Die erforderlichen Änderungen an der Aras Innovator-Konfiguration werden durch Bearbeiten der OAuth-Client-Registry-Datei vorgenommen:
-
Öffnen Sie auf dem Aras-Host-Rechner die Datei
\OAuthServer\OAuth.config zur Bearbeitung.
-
Suchen Sie den Abschnitt IOMApp und kopieren Sie ihn – von der Zeile
<clientRegistry id="IOMApp" enabled="true"> bis zur Zeile </clientRegistry>.
-
Fügen Sie den kopierten IOMApp-Abschnitt direkt danach ein, um einen neuen (duplizierten) Abschnitt zu erstellen.
-
Benennen Sie in diesem neuen Knotenabschnitt
IOMApp in NEXUS um – das Ergebnis ist <clientRegistry id="NEXUS" enabled="true">. Siehe Beispiel
.
-
Speichern Sie die Datei und starten Sie anschließend den Aras-Rechner neu.
In Situationen, in denen keine Verbindung zwischen dem Enterprise Server Workspace und einem Unternehmenssystem hergestellt werden kann, können aus diesem System exportierte Komponentendaten mithilfe des mitgelieferten
CSV Import command line tool in den Workspace importiert werden.
Verbindung zu Ihrer PLM-Instanz herstellen
Die Verbindung zu Ihrer PLM-Instanz wird auf der Seite Admin – PLM Integration der Browser-Oberfläche des Workspace hergestellt. Dazu gehören das Hochladen der entsprechenden XML-basierten Konfigurationsdatei und Veröffentlichungsvorlage sowie das Aktivieren/Konfigurieren der Synchronisierung Ihrer PLM-Komponenten mit denen im Workspace.
Zum Erstellen einer neuen PLM-Schnittstelleninstanz klicken Sie auf die Schaltfläche

. Es können beliebig viele Instanzen definiert werden, um Ihren Workspace mit verschiedenen PLM-Instanzen zu verbinden. Beispielsweise könnten sich Ihre Komponenten in einer PLM-Instanz befinden, während die generierten Ausgaben freigegebener Designprojekte in einer anderen liegen, oder verschiedene Abteilungen verwenden unterschiedliche Instanzen (desselben oder unterschiedlicher PLM-Systeme). Jede Instanz muss einen eindeutigen Namen haben, eine Konfigurationsdatei sowie eine oder mehrere definierte Veröffentlichungsvorlagen besitzen. Um die Verbindung für eine definierte Instanz zu testen, klicken Sie auf die Schaltfläche

– siehe
Verbindungsvalidierung unten.
Beispiel-Konfigurationsdateien und Veröffentlichungsvorlagen werden als Teil der Installation bereitgestellt – erweitern Sie die folgenden Abschnitte für weitere Informationen:
Sample Configuration Files
Beispiel-Konfigurationsdateien werden über die Ansicht Add new instance bereitgestellt – klicken Sie auf der Registerkarte Configuration auf den Link Download sample configuration, um die ZIP-Datei ConfigurationSamples.zip zu erhalten. Diese ZIP-Datei enthält anfängliche Konfigurationsdateien für Windchill-, Arena-, Aras- und Agile-PLM-Systeme:
-
dm-Windchill-config-basic.xml
-
dm-Arena-config-basic.xml
-
dm-Agile-config-basic.xml
-
dm-Aras-config-basic.xml
-
dm-Teamcenter-config-basic.xml (verfügbar, wenn die Teamcenter PLM Addon license zum Workspace hinzugefügt wurde.)
Beispiel-Konfigurationsdateien werden zur Verwendung als Teil der Enterprise Server-Installation bereitgestellt.
Die mitgelieferten Konfigurationen enthalten einige repräsentative Abschnitte für Komponentenentitäten (zum Beispiel Capacitors und Diodes), von denen jeder einen grundlegenden Unterabschnitt für die Attribut-/Parameterzuordnung ToPLM und ToAltium enthält. Ergänzen und bearbeiten Sie eine Beispieldatei passend zu den Anforderungen und der PLM-Instanz Ihres Unternehmens, erstellen Sie eine eigene oder verwenden Sie den Configuration Generator, um eine Basis-Konfigurationsdatei zu erstellen, die zu Ihrem Workspace-Datenmodell passt.
Die Beispiel-Konfigurationsdateien enthalten ausführliche Kommentare, die Ihnen als Leitfaden dienen, was und wie zu konfigurieren ist.
Sample Publishing Templates
Beispiel-Veröffentlichungsvorlagen werden über die Ansicht Add new instance bereitgestellt – klicken Sie auf der Registerkarte Publish Template auf die Schaltfläche
und dann im Fenster Publish Template auf den Link Download sample configuration, um die ZIP-Datei PublishTemplateSamples.zip zu erhalten. Diese ZIP-Datei enthält die folgenden Dateien:
-
dm-Windchill-publish-template-basic.xml
-
dm-Arena-publish-template-basic.xml
-
dm-Agile-publish-template-basic.xml
-
dm-Aras-publish-template-basic.xml
-
dm-Teamcenter-publish-template-basic.xml (verfügbar, wenn die Teamcenter PLM Addon license zum Workspace hinzugefügt wurde.)
Beispiel-Veröffentlichungsvorlagen werden zur Verwendung als Teil der Enterprise Server-Installation bereitgestellt.
Passen Sie diese an die Anforderungen und die PLM-Instanz Ihres Unternehmens an oder erstellen Sie eigene Vorlagen.
Beachten Sie, dass in den Beispiel-Dateien für die Veröffentlichung die folgenden wichtigen Bereiche konfiguriert sind:
-
Wie die Erstellung und Verknüpfung von Komponenten auf der PLM-Seite während eines Veröffentlichungsvorgangs gehandhabt wird (die „BOM Strategy“). Die folgenden Optionen sind verfügbar:
-
LinkExistingOnly – Komponenten verknüpfen, die bereits im PLM vorhanden sind, aber keine Komponenten erstellen, die dort nicht vorhanden sind.
-
CreateNewAndLink – Komponenten verknüpfen, die bereits im PLM vorhanden sind, und diejenigen erstellen und verknüpfen, die dort nicht vorhanden sind.
-
LinkIfAllExists – keine Komponenten erstellen, die auf der PLM-Seite nicht vorhanden sind; nur dann verknüpfen, wenn alle Komponenten im PLM vorhanden sind.
Standardmäßig geben die Beispieldateien die Option LinkExistingOnly an. Wenn nichts angegeben ist, wird CreatNewAndLink verwendet.
-
Regelsätze, die definieren, wie und wo Freigabeausgaben im PLM veröffentlicht werden:
-
Regeln zur Verarbeitung von (übergeordneten) Projektdaten.
-
Regeln zur Verarbeitung von Quelldaten.
-
Regeln zur Verarbeitung von Baugruppendaten.
-
Regeln zur Verarbeitung von Fertigungsdaten.
-
Für jede PLM-Instanz können mehrere Veröffentlichungsvorlagen definiert werden. Wenn eine Vorlage als Teil eines Veröffentlichungsvorgangs ausgewählt wird, wird sie zur weiteren Verwendung mit dem Projekt gespeichert (verknüpft).
-
Die Beispiel-Veröffentlichungsdateien enthalten ausführliche Kommentare, die Ihnen als Leitfaden dienen, was und wie zu konfigurieren ist.
Wenn Sie über die Schaltfläche
einen neuen PLM-Eintrag hinzufügen, verwenden Sie die Schaltfläche
, um zu einer passend gespeicherten/geänderten PLM-Konfiguration zu navigieren und diese anzuwenden.
Ebenso wird eine kompatible Veröffentlichungsvorlage über die Schaltfläche
unter der Registerkarte Publish Template hinzugefügt. Verwenden Sie im folgenden Dialogfeld Publish Template die Schaltfläche
, um zur richtigen Vorlagendatei zu navigieren und sie auszuwählen.
Fügen Sie die Schnittstelle zu dem PLM-System Ihres Unternehmens hinzu und konfigurieren Sie sie. Bei einer gültigen Verbindung können Sie dann Projekt-Freigabedaten gemäß einer aktiven Veröffentlichungsvorlage für die Instanz im PLM-System veröffentlichen (unter Verwendung definierter Prozessdefinitionen) und außerdem die Synchronisierung von Komponenten zwischen diesem PLM und dem Workspace planen.
Die Setup-Dateien für Windchill-, Agile- und Arena-PLM-Instanzen unterstützen auch den formalisierten Change Order(ECO)-Workflow, der in der Publishing Template XML-Datei aktiviert und in der Configuration XML-Datei im Abschnitt der Entität altiumType="ProjectChangeOrder" definiert wird – siehe Beispiel
.
Je nach PLM-Instanz umfassen die Konfigurationsdefinitionen ein Schema für die Identifizierung von Change Orders (Nummerierung, Speicherort, ID usw.), spezifische Change-Order-Attribute wie Name/Titel, Beschreibung und Change Complexity (nur Windchill) sowie Optionseinstellungen wie die Strategie zur Erstellung von Change Orders (keine, neu oder vorhandene wiederverwenden) und die Promotion des Lifecycle-Status (nur Windchill und Agile). Die definierte Change Order wird beim Publishing durch die Deklaration ihrer publishIdReferenz im zugehörigen Publishing Template aktiviert – siehe Beispiel
.
Nachdem sie in den XML-Dateien Configuration und Publishing Template des Servers definiert wurde, stehen Change Orders während der PLM-Workflows Projekterstellung und Publishing-Prozess zur Verfügung, die aus Altium Designer oder über die Enterprise-Server-Schnittstelle aufgerufen werden. Während des Ablaufs wird ein zugehöriges Change-Order-Formular angezeigt, in dem die Einrichtung und Optionen der Change Order festgelegt werden.
►Informationen zur Arbeit mit der PLM-Change-Order-(ECO)-Funktionalität für Windchill-, Agile- und Arena-PLM-Instanzen finden Sie in den Kommentarhinweisen in deren Beispiel-Configuration XML-Dateien und Publishing Template XML-Dateien, die mit der Enterprise-Server-Installation bereitgestellt werden.
Anstatt die mitgelieferten Konfigurationsdateien zum Erstellen einer neuen Enterprise-Systeminstanz zu verwenden, kann der interne Konfigurationsgenerator des Workspace genutzt werden, um eine angepasste Konfiguration zu erstellen, deren Struktur aus dem Datenmodell des Workspace abgeleitet wird. Der Generator fordert Verbindungsinformationen an (PLM-Typ und URL) und fragt dann den Workspace nach registrierten Komponententypen (Kondensatoren, Dioden usw.) und deren passenden Komponentenvorlagen ab, um eine Basis-Konfigurationsdatei zu erstellen – klicken Sie auf den folgenden aufklappbaren Abschnitt, um weitere Informationen zu erhalten:
Configuration Generator
Eine adaptive Konfigurationsfunktion ist über den Link Konfiguration generieren auf der Seite Add new instance verfügbar, die über die Schaltfläche
im Workspace geöffnet wird.
Wählen Sie im Dialogfeld Generate Configuration den Typ des Enterprise-Systems aus, mit dem eine Verbindung hergestellt werden soll – einen der verfügbaren PLM-Typen (Windchill, Arena usw.) – und anschließend dessen Remote-URL. Wählen Sie die Schaltfläche
, um eine neue Datei dm-configuration.xml zu erstellen, die dann gespeichert und anschließend über die Schaltfläche
zur neuen PLM-Instanz hinzugefügt werden kann.
Der Generator erstellt die Konfiguration passend zum Datenmodell der aktuellen Enterprise-Server-Installation. So werden beispielsweise im Workspace registrierte Komponententypen als Entitätstypen in die Konfigurationsdatei aufgenommen (dm-configuration.xml). Jeder Entitätsabschnitt enthält passende Abschnitte ToPlm und ToAltium sowie zugeordnete Parameter, die aus der passenden Komponentenvorlage stammen (falls verfügbar). Ebenfalls enthalten sind Projekt-Publishing-Abschnitte, um die Elemente des Release-Pakets dem Enterprise-System zuzuordnen.
Alle Abschnitte in der generierten Konfiguration enthalten TODOKommentare, die Bereiche hervorheben, die für die Kompatibilität mit Ihrer Workspace-/PLM-Konfiguration ergänzt oder geändert werden müssen. Weitere Informationen zum Bearbeiten der Konfigurationsdatei für Ihre Workspace-/PLM-Einrichtung finden Sie in den erläuternden Kommentaren in den mitgelieferten Beispiel-Konfigurationsdateien.
Wenn eine Konfigurationsdatei bearbeitet und anschließend erneut in die PLM-Instanz hochgeladen wurde, stellen Sie sicher, dass Sie die Verbindung testen (validieren), um eventuell eingeführte Probleme zu erkennen – siehe unten.
Verbindungsvalidierung
Der Workspace bietet eine umfassende Validierungsprüfung der Verbindung zur PLM-Instanz, die über die Schaltfläche
auf der Seite Add/Edit Instance verfügbar ist. Dabei wird eine Reihe von Kompatibilitätsprüfungen der Konfiguration durchgeführt und die Ergebnisse werden sofort gemeldet.
Wenn der Bericht zur Verbindungsvalidierung ausgeführt wird, analysiert der Workspace die aktuellen Einstellungen der Konfiguration und des Publishing Template auf Kompatibilität sowohl mit dem Workspace als auch mit den Daten des Ziel-Enterprise-Systems. Konfigurationsprobleme wie Pfadfehler, nicht übereinstimmende Definitionen und Parameter von Komponententypen sowie ungültige Lifecycle- oder Revision-Einstellungen werden erkannt und im folgenden Dialogfeld Configuration Validation Report gemeldet.
Wenn Konfigurationsfehler gemeldet werden – was zu einem Gesamtstatus ERROR (Status) führt – müssen diese behoben werden, bevor die neue Instanz erstellt werden kann. Ein Status WARNING, der auf Probleme wie im Workspace vorhandene Komponententypen hinweist, die nicht in der Konfiguration enthalten sind, oder auf angegebene Attribute, die auf Seiten des Enterprise-Systems nicht verfügbar sind, erlaubt es, die konfigurierte Instanz zu speichern und zu verwenden.
Die gemeldeten Fehler und Warnungen können anschließend in den verwendeten Konfigurations-/Publishing-Dateien und/oder durch Änderungen in den Einstellungen des Workspace oder des Enterprise-Systems korrigiert werden. Klicken Sie unbedingt auf die Schaltfläche
, sobald Ihre Instanz erfolgreich definiert wurde. Diese Instanz erscheint dann in der aktuellen Liste der verbundenen Instanzen, zurück auf der Hauptseite PLM Integration der Oberfläche.
Wenn eine Konfigurationsdatei bearbeitet und anschließend erneut in die neue Instanz hochgeladen wurde, verwenden Sie die Schaltfläche

erneut, um eventuell eingeführte Probleme zu erkennen.
Komponentensynchronisierung
Die Synchronisierung von Komponenten zwischen dem Workspace und der verbundenen Enterprise-Systeminstanz – oder genauer gesagt deren parametrischen Daten – basiert auf dem Workflow LibSync process. Der Prozess LibSync ist im Workspace vordefiniert und auf der Seite Admin - Processes des Workspace weder zugänglich noch bearbeitbar. Als workflowbasierter Prozess können jedoch die Ergebnisse seiner Synchronisierungsaktion angezeigt und etwaige Fehler behandelt werden.
Die Verwendung des Synchronisierungsprozesses umfasst Folgendes:
-
Konfigurieren der Synchronisierungseinrichtung für jeden Komponententyp, was in der Praxis Folgendes bedeutet:
-
Festlegen der Synchronisierungsrichtung (zum Workspace oder zum PLM).
-
Festlegen, welche Komponententypen beteiligt sind und wo neue Komponenten erstellt werden sollen.
-
Konfigurieren der Zuordnung bzw. der Parameterattribute.
-
Konfigurieren der Datenzuordnung für Part Choices, falls zutreffend.
-
Durchführen der Synchronisierung.
Die ersten beiden oben genannten Punktgruppen werden in der Konfigurationsdatei behandelt, die für die verbundene Enterprise-Systeminstanz (z. B. ein PLM) verwendet wird. Die Synchronisierung selbst kann bei Bedarf über die Seite PLM Integration der Workspace-Oberfläche durchgeführt und/oder geplant werden – automatisierte Synchronisierung in regelmäßigen Intervallen, definiert bei der Konfiguration der Verbindung zur PLM-Instanz.
Synchronisierung konfigurieren
Innerhalb der Konfigurationsdatei wird die Konnektivität mit der Enterprise-Systeminstanz zwischen den Tags Instance als angegebener Driver-Typ und Ziel-URL definiert. Wenn der Configuration Generator zum Erstellen der Konfigurationsdatei verwendet wurde, entsprechen die enthaltenen Driver- und URL-Referenzen denjenigen, die während des Generierungsprozesses im Dialogfeld Generate Configuration eingegeben wurden.
<Instance>
<Driver>[Driver-Typ]</Driver>
<Url>[PLM-API-URL]</Url>
</Instance>
-
Wenn in der Konfigurationsdatei der Arena® PLM-Treiber angegeben ist, steht ein zusätzlicher Eintrag zur Verfügung, um die Arena workspaces zu berücksichtigen, die für ein Arena-Benutzerkonto verfügbar sind. Das optionale mehrstellige ID-Referenzattribut wird dem Abschnitt
Instance zwischen den Tags context hinzugefügt, wie im folgenden Beispiel gezeigt.
-
<Instance>
<Driver>Arena</Driver>
<Url>https://api.arenasolutions.com/v1/</Url>
<Context>12345678</Context>
<!-- Wenn keine Workspace-ID definiert ist, arbeitet die PLM-Instanz mit dem Standard-Workspace von Arena für dieses Konto. -->
<!-- Der Server meldet einen Fehler, wenn eine andere PLM-Synchronisierungssitzung versucht, einen zweiten Workspace aus dem Arena-Benutzerkonto zu verwenden. -->
</Instance>
-
Wenn das verbundene System PTC Windchill PLM ist, kann es erforderlich sein, eine Konfigurationszeile hinzuzufügen, um die Maßeinheiten für Value-Auslesungen zu aktivieren.
Im folgenden Abschnitt Schema der Konfigurationsdatei definieren Sie für jeden dedizierten Bauteiltyp einen Abschnitt für das Synchronisierungs-Mapping. Im Workspace ist dies die Komponente vom Typ altiumType – ihr Wert ist eine der Optionen der Typparameter, die auf der Seite Data Management - Component Types page des Dialogfelds Preferences in Altium Designer zu sehen sind. Auf der PLM-Seite wird ein Teil vom Typ plmType erstellt, wie durch seinen Wert im PLM-Bereich bestimmt.
Der Abschnitt wird in der Datei als Entity deklariert; ein Beispiel dafür könnte für Kondensatoren wie folgt aussehen:
<Entity altiumType="Capacitor" plmType="Capacitor">
.
.
</Entity>
Der Wert plmType kann je nach verwendeter PLM-Instanz variieren.
Innerhalb des Entity werden zwei Abschnitte verwendet, um die Synchronisierung vom Workspace zur PLM-Instanz und von der PLM-Instanz zum Workspace zu steuern und zu konfigurieren – wodurch eine unidirektionale oder bidirektionale Synchronisierung möglich ist. Verwenden Sie die folgenden Abschnitte zusammen mit den Kommentaren in den Beispielkonfigurationsdateien, um mehr zu erfahren. Letztlich hängt das, was in der Konfigurationsdatei definiert wird, von Ihren spezifischen Anforderungen sowie von den (PLM-)Attributen ab, die in der verbundenen Instanz des Enterprise-Systems definiert wurden.
ToPlm
Dieser Abschnitt wird verwendet, um die Synchronisierung vom Workspace zur PLM-Instanz in folgender Form zu steuern und zu konfigurieren:
<ToPlm sync="true">
.
.
</ToPlm>
Zum Deaktivieren der Synchronisierung in diese Richtung setzen Sie sync="false".
Innerhalb des Abschnitts ToPlm sind die folgenden Unterabschnitte definiert:
-
Wie neue Komponenten in der PLM-Instanz erstellt werden – zwischen dem Tagset <CreateInfo> und </CreateInfo>. Ein Beispiel wäre die Auswahl eines im Ziel-Enterprise-System definierten Benennungsschemas für Elemente und die Angabe eines Präfixes für die Elementnummerierung:
<CreateInfo>
<Numbering name="Electrical">
<Fields>
<Field name="Code" value="120"/>
</Fields>
</Numbering>
</CreateInfo>
-
Filterung zur Einschränkung, welche Komponenten im Workspace mit dem PLM synchronisiert werden – zwischen dem Tagset <SourceCriteria> und </SourceCriteria>. Die Weitergabe von Quelldaten kann mithilfe boolescher Logikkombinationen von Parameterattributen eingeschränkt werden, wobei mehrere Attributsätze durch die grundlegende Anwendung der Logikklauseln AND, OR und NOT zu einem bestimmten Filterergebnis aufgelöst werden können.
Diese Funktion ist äußerst nützlich, wenn Sie beispielsweise 6000 Kondensatoren in Ihrem Workspace haben, aber nur einen bestimmten Ordner mit 85 Keramikkondensatoren synchronisieren möchten. In diesem Fall geben Sie einfach diesen Ordnerpfad innerhalb des Tagsets SourceCriteria an und optional weitere Parameterattribute, die für eine noch engere Einschränkung der Quelldaten erforderlich sind – beispielsweise den Gehäusetyp 0603. Die Beziehung zwischen gruppierten Kriterien ist implizit ein logischer AND-Operator, sodass das folgende Beispiel die Keramikkondensatoren im 0603-Gehäuse vom Workspace zum PLM synchronisiert.
<SourceCriteria>
<Folder>Components/Capacitors/Ceramic</Folder>
<common:Attribute>
<common:Key>Case/Package</common:Key>
<common:Value>0603</common:Value>
</common:Attribute>
</SourceCriteria>
Außerdem stehen dedizierte OR-Logik-Tagsets (<Or>…</Or>) und NOT-Logik-Ausschluss-Tagsets (<Not>…</Not>) zur Verfügung, die innerhalb des Knotenabschnitts SourceCriteria hinzugefügt werden können. Bei diesen Optionen gilt die OR-Logik für die innerhalb der Tags <Or></Or> hinzugefügten Parameterattributsätze und die NOT-Logik für den Parameterattributsatz innerhalb der Tags <Not>…</Not>. Ein Beispiel hierfür wäre eine zusätzliche Anforderung für einen Lifecycle-Status von Approved oder Released, jedoch unter Ausschluss (NOT) von Elementen mit einem Classification-Parameterwert von SpecialOrder. Die vollständige Logikfilterung würde in diesem Fall wie folgt aussehen:
<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>
-
Eine Auflistung von Attributen (Parametern), die für die Komponenten vom Workspace an PLM übergeben werden sollen – zwischen dem Tagset <Attributes> und </Attributes>. Ein Beispiel hierfür ist:
<Attributes>
<!-- Name/Comment from Altium Server 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 Altium Server -->
<!-- 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>
<!-- Altium Server component description will go to PLM field Description. Value will be prefixed with 'Extended' -->
<!-- Description on Altium Server 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>
-
Die auf der PLM-Seite erstellte Teilenummer (PlmPartNumber) ist der Primärschlüssel für die Verknüpfung der Komponenten auf beiden Seiten und wird an die Bibliothekskomponente im Workspace zurückübertragen.
-
Parameter wie Komponenten-Referenzkennzeichen (
refDes) gelten nur, wenn ein Projekt mit einem BOM-Dokument veröffentlicht wird, da der Designator-Parameter nicht an der Komponentensynchronisierung beteiligt ist.
-
Beachten Sie, dass es das Konzept von Item Parametern (attributeType="item") gibt. Diese Parameter, wie beispielsweise der oben genannte Parameter PlmPartNumber, werden dem übergeordneten Component Item im Workspace hinzugefügt und stehen dessen Revisionen zur Verfügung. Sie führen nicht dazu, dass eine neue Revision eines Component Item erstellt wird, wenn ihr Wert geändert wird. Dies steht im Gegensatz zu Revision Parametern (attributeType="revision"). Diese Parameter, wie beispielsweise der oben genannte Parameter Description , führen dazu, dass eine neue Revision eines Component Item erstellt wird, wenn ihr Wert geändert wird.
ToAltium
Dieser Abschnitt wird verwendet, um die Synchronisierung von der PLM-Instanz zum Workspace in folgender Form zu steuern und zu konfigurieren:
<ToAltium sync="true" mode="createAndUpdate">
.
.
</ToAltium>
Die optionale Anweisung
mode bestimmt, wie Komponentendaten vom Enterprise-System zum Workspace synchronisiert werden. Der Standardmodus (
createAndUpdate) erlaubt das Erstellen neuer Komponenten im Workspace sowie das Aktualisieren vorhandener Workspace-Komponenten, während der alternative Modus
updateExisting nur das Aktualisieren vorhandener Workspace-Komponenten erlaubt.
Zum Deaktivieren der Synchronisierung in diese Richtung setzen Sie sync="false".
Innerhalb des Abschnitts ToAltium sind die folgenden Unterabschnitte definiert:
-
Wie und wo neue Komponenten im Workspace erstellt werden – zwischen dem Tagset <CreateInfo> und </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>
Wenn ein Komponenteneintrag im Workspace erstellt wird, wird die dem Ziel-Workspace-Ordner zugeordnete Component Template verwendet (Components/Inbox/Capacitors im obigen Beispiel), sofern eine angegeben wurde. Dadurch wird auch das für eine erstellte Komponente verwendete Item Naming Scheme festgelegt und ein im Ziel-Workspace-Ordner angegebenes Schema überschrieben – umgekehrt schlägt die Synchronisierung fehl, wenn der Ordner weder eine Vorlage noch ein Benennungsschema definiert.
Beachten Sie außerdem, dass in den Beispielkonfigurationen ein standardmäßiges Revision Naming Scheme (1-Level Revision Scheme) und eine Lifecycle Definition (Component Lifecycle) zur Verwendung definiert sind – diese werden überschrieben, wenn dem Ziel-Workspace-Ordner eine Component Template zugeordnet ist.
Ein im Konfigurationsfile angegebener Komponenten-Zielordner überschreibt die Einstellung Default Folder in einer Component Template.
Wenn in der Konfiguration ein spezifischer Verweis auf eine Component Template hinzugefügt wird (zum Beispiel: CMPT-00001), wird diese Vorlage anstelle einer dem Ziel-Workspace-Ordner zugeordneten Vorlage verwendet. Ihre Einstellungen überschreiben alle Parametereinstellungen in der Konfigurationsdatei (wie z. B. die Lifecycle Definition usw.), mit Ausnahme eines definierten Zielordners.
<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>
Beachten Sie, dass die angegebene Vorlage nur auf neu erstellte Workspace-Bibliothekskomponenten angewendet wird. Dieser Ansatz ist besonders nützlich, um den Import bzw. die Synchronisierung proprietärer Komponentenparameter aus einem externen System in den Workspace zu verwalten. In diesem Fall kann eine angepasste Component Template angewendet werden, um eingehende Parameterdaten zu interpretieren, geeignete Standardwerte festzulegen, Einheiten-Datentypen anzugeben sowie die Lifecycle Definition und das Revision Naming Scheme für die neu erstellten Workspace-Bibliothekskomponenten festzulegen.
Wenn ein Parameter in der Konfigurationsdatei mit einem Attributtyp item (dynamisch) angegeben ist und dieser Parameter in der angewendeten Component Template vorhanden ist, wird der Wert des Komponentenparameters während der Komponentensynchronisierung nicht aktualisiert. Damit sich dieser Parameter während der Komponentensynchronisierung „dynamisch“ verhält (wobei eine Aktualisierung des Werts keine neue Revision verursacht), muss der Parameterverweis aus der angewendeten Component Template entfernt werden.
-
Filterung der aus der Enterprise-System-Instanz (PLM) abgerufenen Daten – zwischen den Tags <SourceCriteria> und </SourceCriteria>. Eine Filteranweisung kann die vom PLM empfangenen Komponentendaten auf diejenigen beschränken, die von einem bestimmten Autor erstellt wurden (wie in der mitgelieferten Beispielkonfiguration dargestellt), oder auf Komponentenobjekte, die einen bestimmten Attributwert haben (Business Unit = Engineering_RD, wie unten gezeigt).
<SourceCriteria>
<ns2:Attribute>
<ns2:Key>Business Unit</ns2:Key>
<ns2:Value>Engineering_RD</ns2:Value>
</ns2:Attribute>
</SourceCriteria>
-
Eine Auflistung von Attributen (Parametern), die für die Komponenten vom PLM an den Workspace übergeben werden sollen – zwischen den Tags <Attributes> und </Attributes>. Ein Beispiel dafür ist:
<Attributes>
<!-- Name field from PLM will be passed to name/comment field in Altium Server -->
<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 Altium Server 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 Altium Server 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>
Beachten Sie, dass die Teilenummer auf der PLM-Seite (PlmPartNumber) der Primärschlüssel für die Verknüpfung der Komponenten auf beiden Seiten ist und zurück an die Workspace-Bibliothekskomponente übertragen wird.
Beachten Sie außerdem, dass es das Konzept „dynamischer“ Parameter gibt (attributeType="item"). Diese Parameter, wie der Parameter DynamicCONTS oben, sind Parameter auf Item-Ebene. Sie werden dem übergeordneten Component Item im Workspace hinzugefügt und stehen dessen Revisionen zur Verfügung. Sie führen nicht dazu, dass eine neue Revision eines Component Item erstellt wird, wenn ihr Wert geändert wird. Dies steht im Gegensatz zu „starken“ Parametern (attributeType="revision"). Diese Parameter, wie der Parameter Description oben, sind Parameter auf Revisionsebene. Sie führen dazu, dass eine neue Revision eines Component Item erstellt wird, wenn ihr Wert geändert wird.
Der Abschnitt zur Definition des Datenmappings für Part Choices befindet sich am Ende der Beispielkonfigurationsdatei (oder einer generierten Konfigurationsdatei).
PTC Windchill PartsLink Support
Das PTC Windchill PLM-System stellt ein optionales PartsLink-Modul bereit, mit dem Teile in Gruppen classified klassifiziert werden können. In Windchill angegebene Teileklassifizierungen können außerdem zugehörige Attribut-/Wert-Paare enthalten, um innerhalb dieser Klassifizierung eine genauere Definition bereitzustellen. Das PartsLink-System ermöglicht es, bestimmte Komponententypen einfach und schnell gezielt auszuwählen, und wird von der PLM-Integration des Workspace für bidirektionale Synchronisierung sowie Lese-/Schreibzugriff unterstützt.
In einer Workspace-Konfigurationsinstanz für Windchill wird eine PartsLink-Klassifizierung in Windchill erstellt, indem im Abschnitt ToPLM ein Bindungsattribut im unten gezeigten Format angegeben wird:
<common:Attribute>
<common:Key>Classification</common:Key>
<common:Value>102-Capacitor</common:Value>
</common:Attribute>
Im obigen Fall definiert das Schlüssel-/Wert-Paar eine Klassifizierung mit dem Namen 102-Capacitor. Dafür kann in Windchill ein zugehöriges Klassifizierungsattribut erstellt werden, indem ein Namens- und Wertparameter angegeben wird (hier Capacitance) – beachten Sie, dass mehrere Attribute auf eine einzelne Klassifizierung angewendet werden können:
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>${parameter.Value}</common:Value>
</common:Attribute>
Im Synchronisierungsabschnitt ToAltium der Konfiguration können die aus Windchill stammenden Daten innerhalb des Tag-Sets <SourceCritera> nach einer gewünschten Teileklassifizierung gefiltert werden, indem deren ClassificationName angegeben wird.
<SourceCriteria>
<ClassificationName>102-Capacitor</ClassificationName>
</SourceCriteria>
Um alle Teile zu beziehen, die einem passenden Klassifizierungsattributwert entsprechen (zum Beispiel alle 10uF-Kondensatoren), sollte der Abschnitt <SourceCriteria> Konfigurationsattributeinstellungen enthalten, die eine ClassificationName sowie den zugehörigen Schlüssel und Wert des Klassifizierungsattributs definieren.
<SourceCriteria>
<common:Attribute>
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Capacitance</common:Key>
<common:Value>10uF</common:Value>
</common:Attribute>
</SourceCriteria>
Um einen bestimmten Wert eines Klassifizierungsattributs aus Windchill zu extrahieren, beziehen Sie den Parameter Value aus dem spezifischen Attributnamen, der einer ClassificationName zugeordnet ist.
<common:Attribute attributeType="revision">
<common:ClassificationName>102-Capacitor</common:ClassificationName>
<common:Key>Value</common:Key>
<common:Value>${attribute.Capacitance}</common:Value>
</common:Attribute>
In Windchill selbst wird eine PartsLink-Klassifizierung definiert, indem eine binding attribute erstellt wird, die auf einen Teiletyp angewendet werden kann. Anschließend wird einer definierten Klassifizierungsklasse ein Teileklassifizierungsattribut hinzugefügt.
Komponenteneinträge in Windchill übernehmen ihre definierte Klassifizierung und alle angegebenen Parameter für Klassifizierungsattribute, die wiederum dem PLM-Komponentensynchronisierungsprozess des Workspace zur Verfügung stehen.
Wenn ein Komponenteneintrag von Windchill mit dem Workspace synchronisiert wird und die PartsLink-Interaktion in der PLM-Konfiguration des Workspace angegeben wurde, werden die Konfigurationsattribute von Windchill für dieses Teil an Altium Designer weitergegeben.
PTC Windchill SSO Support
Die Möglichkeit, bei der Verbindung zu einem Windchill-PLM-System die Single-Sign-On-Autorisierung (SSO) zu verwenden, ist ebenfalls verfügbar und wird über die Workspace-Oberfläche eingerichtet. Dies bietet eine vereinfachte und sichere Methode zur Verbindungsautorisierung bei der Ausführung von Workspace-PLM-Prozessen wie Projekterstellung und Publish to PLM. In der Praxis ermöglicht diese Anordnung, den Zugriff auf Windchill mithilfe des OAuth-Delegationsstandards über einen Dienst eines Identitätsanbieters wie PingFederate zu gewähren.
Der Zugriff auf die SSO-Einrichtung ist auf der Workspace-Seite PLM Management unter der Registerkarte OAuth verfügbar (Admin - PLM Integration), wo mehrere OAuth-Provider-Instanzen hinzugefügt werden können.
Verwenden Sie die Registerkarte OAuth auf der Seite PLM Management, um auf die Einrichtung des OAuth-Providers zuzugreifen.
Die Einrichtung der OAuth-Provider-Autorisierung wird anhand der Daten abgeschlossen, die von Ihrem konfigurierten Identitätsanbieter verfügbar sind. Geben Sie die vom Workspace benötigten Informationen – IDs, Tokens, URLs usw. – in die Felder der Seite ein und speichern Sie anschließend die vollständige Konfiguration.
Die Informationen, die zum Einrichten einer neuen SSO-OAuth-Instanz erforderlich sind, stammen aus der vorhandenen OAuth-Provider-Konfiguration.
Zum Abschluss der Einrichtung aktivieren Sie die neue OAuth-Provider-Instanz in der Windchill-XML-Konfigurationsdatei – weitere Informationen finden Sie in den Kommentaren der Windchill-Beispielkonfigurationsdatei.
<Instance>
<Driver>Windchill</Driver>
<Url>https://MyWindchill.company.com</Url>
<OAuthProvider>Windchill-PingFederate</OAuthProvider>
</Instance>
Wenn Sie die neue Einrichtung zum ersten Mal während eines Workspace-Prozesses wie Publish to PLM verwenden, wird Ihr ausgewählter OAuth-Provider geöffnet, um die Verbindung zu autorisieren. Sobald diese Validierung abgeschlossen ist, ist dieser Schritt bei nachfolgenden PLM-Veröffentlichungen nicht mehr erforderlich.
-
Bei den in einer Konfigurationsdatei enthaltenen Parameters, Attributes und Values wird zwischen Groß- und Kleinschreibung unterschieden.
-
Abgesehen von der üblichen Einbindung eines primären Synchronisierungsschlüssels (wie
PlmPartNumber) wird nicht empfohlen, dieselben Komponentenattribute/-parameter sowohl in den Abschnitten ToAltium als auch ToPlm einer Konfigurationsdatei aufzunehmen. Die bidirektionale Synchronisierung erfolgt in dieser Reihenfolge (zuerst von PLM zu Altium), sodass in diesem Fall die PLM-Daten immer Vorrang haben.
-
Informationen zum Einrichten der Integration mit Ihrem Unternehmenssystem finden Sie in den Beispielkonfigurations- und Veröffentlichungsdateien.
Der Enterprise Server unterstützt die Aktualisierung vorhandener Arena-PLM-Elemente bei der Verwendung der Prozesse Project Releaser und Component Sync von Altium. Dadurch können neu freigegebene Projekt- und Komponentendaten auf der Altium-Seite in Arbeitsrevisionen von Arena-BOM-Teilelementen (PCBA-, FAB- und Komponentendaten) übertragen werden.
Bei der Freigabe eines Altium-Projekts an Arena PLM – mithilfe des Prozesses Project Release with Publish to PLM – wird die zuvor freigegebene Arena-Projekt-BOM-Revision aktualisiert und die zusätzlichen Aktualisierungen untergeordneter Teile mit diesem übergeordneten Element verknüpft. In diesem Fall enthält das PLM-Protokoll eine Warnung, die darauf hinweist, dass eine Arbeitsrevision aktualisiert und wirksame Revisionen zur entsprechenden BOM in Arena hinzugefügt wurden.
Durchführen der Komponentensynchronisierung
Die Synchronisierung von Komponenten (Bibliotheken) kann entweder manuell oder zeitgesteuert erfolgen – entweder über die Schaltfläche Sync action eines PLM-Instanzeintrags auf der Workspace-Seite PLM Integration oder als im Instanz-Setup angegebener automatisierter Zyklus. Klicken Sie auf das
-Steuerelement, das der PLM-Instanz zugeordnet ist, die Sie synchronisieren möchten. Der Synchronisierungsprozess durchläuft den Workflow LibSync entsprechend den in der zugehörigen Konfigurationsdatei definierten Einstellungen.
Das Steuerelement wechselt zu
. Wenn Sie den Synchronisierungsprozess stoppen möchten, klicken Sie auf dieses Steuerelement. Es erscheint ein Bestätigungsfenster, in dem Sie auf
klicken können, um die Synchronisierung abzubrechen – alle bereits synchronisierten Komponenten bleiben erhalten, aber es erfolgt keine weitere Synchronisierung über diesen Punkt hinaus.
Komponentensynchronisierung zwischen dem Workspace und der angegebenen PLM-Instanz läuft.
Bei der Synchronisierung werden nur only die Komponenten einbezogen, die seit dem letzten Synchronisierungslauf geändert wurden (d. h. deren Zeitstempel später ist als das Datum der letzten Synchronisierung) und die die Synchronisierungskriterien in der Konfigurationsdatei erfüllen. Dies wird als Incremental Synchronization bezeichnet.
Wenn die Komponentensynchronisierung ausgeführt wird, durchläuft der Prozess LibSync seinen vordefinierten Workflow, bis er abgeschlossen ist oder auf einen Fehler stößt. Aktualisieren Sie den Browser (F5), um den aktuellen Status des Synchronisierungsprozesses anzuzeigen. Um den Prozess LibSync zu überwachen oder zu prüfen, wählen Sie die Registerkarte Synchronization status und dann die Listenoption Closed – wenn ein Prozess noch läuft, wird er in der Liste Active angezeigt. Die Schaltfläche
, die Administratoren zur Verfügung steht, kann verwendet werden, um einen detaillierten Datensatz aller aufgeführten Synchronisierungsaktivitäten im kommagetrennten CSV-Dateiformat herunterzuladen (Synchronisation status.csv).
Die Unterregisterkarten der Ansicht bieten die folgenden Informationen:
-
Diagram – eine Grafik, die den Prozess-Workflow darstellt, wobei die aktuelle Schrittposition hervorgehoben ist (abgeschlossen oder Fehler-/Ausfallstatus).
-
Data – eine Informationszusammenfassung der Prozessaktion, einschließlich des Erfolgs oder Fehlschlags ihrer Schritte sowie eines Links zum protokollierten Prozessbericht – siehe unten.
-
History – ein Zeitprotokoll der wichtigsten Synchronisierungsereignisse des Workspace, in der Reihenfolge ihres Auftretens aufgeführt.
Die LibSync Prozessergebnisse sind auch auf der Seite Process Management (Admin » Processes) auf der Registerkarte Browser verfügbar.
Die Details des ausgewählten LibSync-Ereignisses, die auf der Unterregisterkarte Data angezeigt werden, enthalten einen Link zur Systemprotokolldatei (PLM [date-number].log) für das Ereignis.
Wenn ein LibSync-Prozess fehlschlägt, wird eine Handle errors-Aufgabe mit zugehörigen Fehlerdaten erstellt, einschließlich Zusammenfassungsinformationen und Prozessdiagramm. Aktuelle Aktionsaufgaben sind auf der Seite Tasks Management verfügbar, die über die Option Tasks im Hauptmenü aufgerufen wird.
Geplante Synchronisierung
Sie können auch eine automatisierte Synchronisierung planen. Bearbeiten Sie dazu die PLM-Instanz (klicken Sie auf der Hauptseite PLM Integration auf ihren Namen oder das zugehörige Steuerelement), wählen Sie die Registerkarte Component Synchronisation und aktivieren Sie die Option Synchronize PLM Components with server on schedule. Verwenden Sie die Steuerelemente Synchronize every, um den Zeitplan für die automatische Synchronisierung nach Bedarf einzurichten. Das System ist sehr flexibel und ermöglicht Ihnen Folgendes:
-
Eine geplante Synchronisierung alle 15/30/45/60/75/90 Minuten einrichten.
-
Eine geplante Synchronisierung alle x Stunden einrichten.
-
Eine tägliche geplante Synchronisierung einrichten, die zu einer festgelegten Uhrzeit ausgeführt wird.
Der von Ihnen definierte Zeitplan wird auf der Hauptseite PLM Integration in der Spalte Sync scheduled angezeigt.
Einrichten eines Synchronisierungszeitplans.
Für das Einrichten einer geplanten Synchronisierung müssen Sie gültige Benutzeranmeldedaten (für Ihr PLM-System) angeben. Die Anmeldedaten sollten bereits beim Einrichten der PLM-Instanz registriert worden sein; falls nicht, klicken Sie auf die Schaltfläche

und geben Sie Ihren
User name und Ihr
Password im daraufhin angezeigten Fenster
PLM Credentials ein. Ohne gültige Anmeldedaten bleibt die geplante Synchronisierung im Status OFF. Eine bedarfsgesteuerte Synchronisierung ist dann ebenfalls nicht möglich.
Sie können den Synchronisierungsprozess auch bedarfsgesteuert ausführen. Klicken Sie auf die Schaltfläche
und wählen Sie den benötigten Synchronisierungsmodus:
-
Incremental – in diesem Modus werden only diejenigen Komponenten, die seit der letzten Synchronisierung geändert wurden (d. h. deren Zeitstempel später ist als das Datum der letzten Synchronisierung) und die die Synchronisierungskriterien in der Konfigurationsdatei erfüllen, in die Synchronisierung einbezogen, wobei die Änderungen entsprechend übernommen werden. Dies ist der Standardmodus und derselbe Modus, der durch Klicken auf das Steuerelement
für eine PLM-Instanz auf der Hauptseite PLM Integration ausgeführt wird.
-
Full – dieser Modus erzwingt eine vollständige Synchronisierung. Alle Komponenten, die die Synchronisierungskriterien in der Konfigurationsdatei erfüllen, werden in die Synchronisierung einbezogen, wobei die Änderungen entsprechend übernommen werden.
Prozess-Workflows
Die folgenden Prozessdefinitionen (und zugrunde liegenden Workflows) sind im Workspace zur Unterstützung der PLM-Integration verfügbar:
Diese Prozessdefinitionen können nicht unverändert aktiviert und verwendet werden. Jede davon ist daher eher als „Vorlage“ zu verstehen – bearbeiten Sie sie entsprechend den Anforderungen Ihres Unternehmens, benennen Sie sie um und speichern Sie sie als neue Prozessdefinition, die Sie can dann aktivieren und verwenden, zusammen mit allen anderen Definitionen im jeweiligen Prozessthema.
-
Part Requests Prozessthema:
-
Part Request with PLM Part Create – unterstützt die automatische Erstellung einer Komponente in Ihrer PLM-Instanz und anschließend die Rückübertragung der generierten Teilenummer an die Komponente im Workspace. Das Workflow-Diagramm ist unten dargestellt.
Wichtig ist, dass Sie beim Ändern dieser Beispieldefinition zur Erstellung Ihrer eigenen Definition die PLM-Instanz angeben müssen, in der Teile erstellt werden sollen. Wählen Sie die Entität Create Part in PLM im Workflow-Diagramm aus und wählen Sie die PLM-Instanz aus dem Dropdown-Menü aus, das dem Feld PLM Instance zugeordnet ist. Dieses Menü listet alle derzeit definierten PLM-Instanzen auf (wie auf der Seite PLM Integration der Benutzeroberfläche definiert).
► Weitere Informationen zur Arbeit mit Prozess-Workflows finden Sie unter Creating and Managing Processes.
-
Project Activities Prozessthema:
-
Publish to PLM (User selects) – Veröffentlichung freigegebener Workspace-Projektausgaben in der integrierten PLM-Instanz, wobei der Benutzer genau auswählen kann, welche Ausgaben veröffentlicht werden. Das Workflow-Diagramm ist unten dargestellt.
-
Project Releaser with Publish – Veröffentlichung in der integrierten PLM-Instanz als zusätzliche Stufe des Project Releaser. Das Workflow-Diagramm ist unten dargestellt.
-
Project Creations Prozessthema:
-
Project with initialise in PLM – unterstützt die automatische Erstellung von Teilenummern in Ihrer PLM-Instanz und anschließend deren Übertragung als Parameter des Workspace-Designprojekts. Das Workflow-Diagramm ist unten dargestellt.
Zugriff auf PLM-bezogene Prozesse
Die folgenden Abschnitte zeigen, wo aktivierte PLM-bezogene Prozesse aufgerufen werden können. Und da die Beispiele nicht direkt wie geliefert verwendet werden können, wurden zu Illustrationszwecken die folgenden daraus erstellt:
-
PR with PLM Part Create – erstellt aus der Beispiel-Prozessdefinition: Part Request with PLM Part Create.
-
Publish to Company PLM – Choose Data – erstellt aus der Beispiel-Prozessdefinition: Publish to PLM (User selects).
-
Project Releaser with Publish to Company PLM – erstellt aus der Beispiel-Prozessdefinition: Project Releaser with Publish.
-
Create Project with PLM Initialise – erstellt aus der Beispiel-Prozessdefinition: Project with Initialise in PLM.
Beachten Sie, dass Workspace-Administratoren eine neue Instanz jeder aktivierten Prozessdefinition direkt über die entsprechende Registerkarte des Prozessthemas im Bereich
Processes der Workspace-Benutzeroberfläche starten können, indem sie auf das Steuerelement

klicken.
Teileanfragen
Zugriff innerhalb von Altium Designer über das Fenster Explorer, nach Durchführung einer Suche, innerhalb des Bereichs Details des Fensters Manufacturer Part Search oder über den Link am unteren Rand der Komponentenliste im Fenster Components.
Über die Workspace-Benutzeroberfläche kann auf die aktivierte Prozessdefinition über die Seite Part Requests zugegriffen werden, indem Sie oben rechts auf der Seite auf die Schaltfläche
klicken.
Part Request Example
Das folgende Beispiel zeigt kurz die Erstellung eines neuen Teils im Workspace, gefolgt von der automatischen Erstellung eines entsprechenden Teils in der PLM-Instanz. Die generierte Teilenummer wird dann aus der PLM-Instanz zurück an die Komponente im Workspace als Item-Parameter übertragen – das bedeutet, dass keine neue Revision der Workspace-Bibliothekskomponente freigegeben werden muss. Für dieses Beispiel wird die Prozessdefinition PR with PLM Part Create verwendet – abgeleitet von der Beispieldefinition Part Request with PLM Part Create.
Die hier bereitgestellten Informationen sind für die verschiedenen unterstützten PLM-Systeme ähnlich. Unterschiede gibt es bei der Konfigurationsdatei, die Sie an die Anforderungen Ihres Unternehmens anpassen können, sowie dann, wenn Sie den Workflow der Prozessdefinition geändert haben, die zum Erstellen des Teils verwendet wird.
-
Starten Sie den Prozess für die Teileanfrage und füllen Sie das nachfolgende Formular – mit den Details der ursprünglichen Anfrage – nach Bedarf aus. Im folgenden Bild wird die Anfrage über die Seite Part Requests der Workspace-Benutzeroberfläche eingereicht, und es wird ein einzelnes Teil angefordert.
-
Die neue Teileanfrage wird als aktiver Prozess auf der Seite Part Requests angezeigt, wobei ihr aktueller Status sowohl im Haupteintrag als auch im Diagramm des zugrunde liegenden Workflows dargestellt wird.
-
Sobald der erforderliche Benutzer die Aufgabe zur Bearbeitung der Anfrage übernommen hat (oder ihm diese zugewiesen wurde), erstellt er schließlich das/die angeforderte(n) Teil(e). Jede erstellte (und/oder ausgewählte) Komponente zur Erfüllung der Anfrage wird dem Feld Components der Aufgabe hinzugefügt. Die hinzugefügten Komponenten werden automatisch im PLM erstellt. Im folgenden Bild wurde eine einzelne Komponente – CMP-007-00038 – erstellt und hinzugefügt. Stellen Sie sicher, dass das Feld Next step auf Completed gesetzt ist, und klicken Sie auf die Schaltfläche
.
Möglicherweise werden Sie aufgefordert, Anmeldedaten für das im Workflow der Teileanfrage angegebene PLM-System einzugeben.
-
Der Prozess-Workflow wird fortgesetzt, wobei die angegebene Komponente in der PLM-Instanz erstellt wird. Sobald der Prozess vollständig abgeschlossen ist, können Sie die generierte PLM-Teilenummer auf der Registerkarte Data des Prozesses sehen. Stellen Sie sicher, dass Sie den Filter (oben links) auf die Anzeige von Prozessen Closed umstellen.
Administratoren können die Schaltfläche

verwenden, um einen detaillierten Datensatz aller aufgelisteten Teileanfragen im kommagetrennten CSV-Format herunterzuladen.
-
Zurück in Altium Designer navigieren Sie im Fenster Explorer zu der erstellten Komponente und wechseln zur Registerkartenansicht Preview . Im Parameterbereich sehen Sie, dass ein zusätzlicher Parameter hinzugefügt wurde – PlmPartNumber – dessen Wert die Nummer des entsprechend im PLM erstellten Teils ist.
Beachten Sie, dass der Parameter zur Komponente hinzugefügt wurde, ihre Revision jedoch unverändert bleibt – die Komponente wurde nicht erneut freigegeben. Das liegt daran, dass der Parameter ein Parameter auf Item-Ebene ist – er wird dem Component Item selbst hinzugefügt und ist in all seinen Revisionen verfügbar.
Projektaktivitäten
Aus Altium Designer in den Enterprise Server Workspace freigegebene Projektdesigndaten können kontrolliert mit den Publish-to-PLM-Prozessen des Workspace an PLM übertragen werden. Die Workspace-Prozesse definieren die Schnittstelle und Methodik für die Veröffentlichungsaktivität, und die angegebene XML Publishing Template definiert, wie die Dateidaten an das Ziel-PLM-System übertragen werden.
Publishing Folder Support for Windchill PLM
Beim Konfigurieren eines Publish to PLM process für Windchill® PLM können Sie auch einen Zielordner in Windchill für aus dem Workspace veröffentlichte Dokumente angeben (und erstellen).
Die zugehörigen Windchill-Ordnerparameter sind in der Publishing Template XML file definiert, die auf Ihren Windchill-PLM-Integrationseintrag im Workspace angewendet wird. Ordnerdefinitionsknoten haben das Tag-Format <pt:Folder>xxx</pt:Folder> – wobei pt der aktuelle Namespace und xxx der vollständige Ordnerpfad ist – und werden als Publishing-Regel innerhalb des Abschnitts FileDistribution für jeden Dokumenttyp platziert (zum Beispiel für eine PCB.zip Fabrication-Ausgabe).
Ein Beispiel für die Hierarchie der Publishing-XML-Struktur wäre:
<pt:EntityRule id="FAB">
<pt:FileDistributions>
<pt:FileDistribution archiveName="PCB.zip">
<pt:Folder>PRODUCT/Projects/${project.name}/FAB data</pt:Folder>
Die letzte Zeile des Eintrags würde einen Zielordner für die Veröffentlichung der PCB.zip Fabrication-Ausgabe mit der Windchill-Ordnerstruktur angeben (oder erstellen) (wobei der Projektname MyProject ist):
PRODUCT
Projects
MyProject
FAB data
Beachten Sie, dass der im Publishing-XML-Datei definierte Ordnerpfad absolut ist (und nicht relativ) und andere Projekteigenschaften wie den Projektnamen (${project.name}) und die Baugruppennummer (${project.PLM_ASSEMBLY_NUMBER}) enthalten kann.
Beachten Sie außerdem, dass die Möglichkeit, einen Zielordner create, für Windchill-REST-API-Services 1.3 und höher unterstützt wird. Bei älteren REST-Versionen muss der angegebene Zielordnerpfad vorhanden sein, kann jedoch nicht erstellt werden.
Standard-Publishing-Prozess
Auf der Design-Seite kann der standardmäßige Publish-to-PLM-Prozess in Altium Designer über das Untermenü Project » Project Activities für das aktive Projekt aufgerufen werden.
Projektbezogene Prozesse sind auch über das Kontext-Untermenü
Project Activities zugänglich, das durch Rechtsklick auf den Eintrag des Designprojekts im
Projects panel geöffnet wird.
Über die Workspace-Oberfläche kann auf die aktiven Prozessdefinitionen in der Ansicht Project Management durch Klicken auf die Schaltfläche
zugegriffen werden.
Publishing mit dem Project Releaser
Der Prozess zum Veröffentlichen in eine PLM-Instanz als Teil des Project Releaser kann in Altium Designer über das Untermenü Project » Project Releaser für das aktive Projekt aufgerufen werden.
Release-bezogene Prozesse sind auch über das Kontext-Untermenü
Project Releaser zugänglich, das durch Rechtsklick auf den Eintrag des Designprojekts im
Projects panel geöffnet wird.
Das Project Releaser wird angezeigt, mit einer zusätzlichen Phase – 7: Publish to PLM. Außerdem ist im Menü der Schaltfläche
ein Befehl verfügbar – Prepare & Release & Publish to PLM –, falls Sie das Project Releaser ausführen möchten, ohne zur Überprüfung der generierten Daten und des Ausführungsberichts anzuhalten.
Defining the Stage Name
Wenn Sie die Beispiel-Prozessdefinition – Project Releaser with Publish – verwenden, um Ihre eigene Definition zu erstellen, lautet der auf der Altium Designer-Seite angezeigte Phasenname standardmäßig Publish to PLM. Der zusammengesetzte Befehl im Dropdown-Menü der Schaltfläche Project Releaser
enthält diesen Namen ebenfalls: Prepare & Release & Publish to PLM.
Sie können jedoch ändern, wie dies (und der mit der Phase verknüpfte Beschreibungstipp) den Benutzern angezeigt wird. Die entsprechenden Felder sind im zugrunde liegenden Workflow für den Prozess verfügbar, wenn das Element Start (vom Typ Start Release) ausgewählt ist. Diese Felder sind:
-
Action name – der Name der Aktion nach dem Projekt-Release; dies ist der Name der Phase, die als Phase 7 im Project Releaser angezeigt wird. Ein Eintrag für dieses Feld ist erforderlich, wenn im Prozess-Workflow Aufgaben definiert sind. Dieser Name wird auch für den Menübefehl im Format Prepare & Release & <Action name> verwendet.
-
Action description – Beschreibung der Aktion nach dem Projekt-Release; diese wird dem Benutzer im Project Releaser als Tooltip für den Eintrag der Phase 7 angezeigt.
Standardeinstellungen für das Element Start in einem Workflow, der auf der Beispiel-Prozessdefinition Project Releaser with Publish basiert, sowie die Darstellung im Project Releaser.
Die folgende Abbildung zeigt diese Felder, nachdem sie im zugrunde liegenden Workflow geändert wurden, und die daraus resultierenden Auswirkungen auf die Einträge im Project Releaser.
Geänderte Einstellungen für das Element Start, wenn es in einem Workflow zum Publishing in PLM über den Project Releaser verwendet wird.
Wenn Sie das Project Releaser mit dem Standardbefehl Prepare ausführen, wird nach der Überprüfung und Freigabe der Daten in der Phase Execution Report die Schaltfläche
angezeigt. Klicken Sie darauf, um den zugrunde liegenden Workflow des Prozesses fortzusetzen und in das PLM zu veröffentlichen. Das Dialogfeld Login Credentials wird angezeigt. Geben Sie den Username und das Password für Ihre PLM-Instanz ein und wählen Sie das PLM-Template aus, das Sie verwenden möchten (dies erscheint in der Form <PLMInstance>:<PublishingTemplate>).
Wenn Sie den Befehl
Prepare & Release & Publish to PLM verwenden, wird Ihnen letztlich direkt das Dialogfeld
Login Credentials angezeigt. Das
Project Releaser hält dann nicht bei der Phase
Execution Report an, und es wird keine Schaltfläche

angezeigt.
Beachten Sie, dass die Anmeldedaten für Ihre PLM-Instanz nur beim ersten Publishing in diese Instanz erforderlich sind. Danach werden sie mit dem Workspace gespeichert. Anschließend erfolgt jedes Publishing dieses Projekts in dieselbe PLM-Instanz direkt gemäß dem definierten Workflow und dem gewählten Publishing-Template.
Klicken Sie auf die Registerkarte Diagram , um den zugrunde liegenden Workflow für den Prozess anzuzeigen.
Klicken Sie auf die Schaltfläche
, um den Publishing-Prozess gemäß diesem Workflow fortzusetzen.
Wenn Sie zum ersten Mal veröffentlichen und Teilenummern (auf der PLM-Seite) noch nicht mit dem Workspace-Projekt verknüpft sind, werden diese Teilenummern im PLM erstellt und im Rahmen dieser ersten Veröffentlichung mit dem Projekt verknüpft. Sie können außerdem Komponenteneinträge für Workspace-Bibliothekskomponenten in der PLM-Instanz definieren, als Teil des Publishing-Vorgangs – um eine Stückliste der Komponenten im PLM zu erhalten (optional, abhängig vom definierten und verwendeten Publishing-Template beim Veröffentlichen des Projekts in die PLM-Instanz).
Überprüfen Sie den Status des Publish-to-PLM-Prozesses über die Workspace-Oberfläche, indem Sie in der Detailansicht dieses Projekts die Ansicht Activities auswählen -- wenn das Projekt aus der Ansicht Projects geöffnet wurde. Wählen Sie die Ansichtsoption Opened, um den Status während der Ausführung des Prozesses zu sehen, und die Option Closed activities, um nach Abschluss des Prozesses auf Statusinformationen zuzugreifen.
Sie können unter der Registerkarte Data des Prozess-Workflows genau sehen, was erstellt wurde, z. B. Teilenummern in der PLM-Instanz.
Projekterstellungen
Auf der Design-Seite erfolgt der Zugriff in Altium Designer über das Haupt-Untermenü File » New » Project in <Workspace>.
Über die Workspace-Oberfläche kann auf die aktivierte Prozessdefinition in der Ansicht Projects durch Klicken auf die Schaltfläche
zugegriffen werden.
Und auch beim Klonen eines Projekts, aufgerufen über die Menüschaltfläche
in der Ansicht Projects.
Der Prozess-Workflow wird fortgesetzt, mit einem Dialogfeld, in dem Sie das Projekt hinsichtlich Name, Beschreibung, Typ und eines eventuell bei seiner Erstellung zu verwendenden Project Template Item definieren können. Nach dem Klicken auf Start wird das Dialogfeld Login Credentials angezeigt. Geben Sie den Username und das Password für Ihre PLM-Instanz ein und wählen Sie das PLM-Template aus, das Sie verwenden möchten (dies erscheint in der Form <PLMInstance>:<PublishingTemplate>). Klicken Sie dann auf Submit , um mit dem Workflow fortzufahren.
Die relevanten Teilenummern werden automatisch für das Projekt in Ihrer PLM-Instanz erstellt und anschließend als Workspace-Projektparameter zurück in den Workspace übertragen. Diese Parameter stehen zur Verwendung als spezielle Strings zur Verfügung – Zugriff über das Bedienfeld
Properties, wenn im Design-Editor eine platzierte Textzeichenfolge ausgewählt ist. Für das Projekt definierte Workspace-Parameter können auch auf der Registerkarte
Parameters tab des Dialogfelds
Project Options angezeigt werden (
Project » Project Options).
Project Creation Example
Das folgende Beispiel zeigt kurz die Erstellung eines neuen Projekts mit Initialisierung im PLM. Der Prozess wird in Altium Designer über die Definition Create Project with PLM Initialise aufgerufen – abgeleitet von der Beispieldefinition Project with Initialise in PLM.
Die hier bereitgestellten Informationen sind für die verschiedenen unterstützten PLM-Systeme ähnlich. Unterschiede gibt es bei der Konfigurationsdatei und den Publishing-Templates, die Sie möglicherweise an die Anforderungen Ihres Unternehmens anpassen, bei der Konfiguration des Ziel-PLM und auch dann, wenn Sie den Workflow für die zur Projekterstellung verwendete Prozessdefinition geändert haben.
-
Nach dem Starten des Prozesses (File » New » Project in <Workspace> » Create Project with PLM Initialise) erscheint ein Dialogfeld (benannt nach der Prozessdefinition), in dem das Projekt definiert wird. Für dieses Beispiel nennen wir das Projekt einfach Example_Project_with_PLM_Init, geben ihm eine Beschreibung und lassen alle anderen Felder – einschließlich derjenigen auf der Registerkarte Advanced – unverändert.
-
Nachdem das Projekt definiert wurde, klicken Sie auf die Schaltfläche
. Das Dialogfeld Login Credentials wird angezeigt. Da es sich um ein neues Projekt handelt, müssen Sie Ihre PLM-Anmeldedaten angeben und die zu verwendende PLM-Instanz sowie das zugehörige Publishing-Template auswählen. Das Beispiel hier verwendet eine Konfigurationsdatei und ein zugehöriges Publishing-Template (wie angefordert) für ein Arena-PLM.
Nachdem die Anmeldedaten eingegeben und die PLM-Instanz sowie das Publishing-Template ausgewählt wurden, klicken Sie auf die Schaltfläche
.
-
Der Prozess wird bis zum Abschluss fortgesetzt (sofern keine Fehler auftreten), wie im Tasklist panel unter dem geschlossenen Eintrag Activities zu sehen ist – prüfen Sie die Option Show closed im zugehörigen Menü der Schaltfläche
. Wählen Sie den Aktivitätseintrag aus, um weitere Informationen über den abgeschlossenen Prozess und seinen Datensatz zu erhalten.
Beachten Sie, dass die Registerkarte Data relevante Daten bereitstellt, darunter die für die verschiedenen Projektentitäten erstellten Teilenummern. Die PLM-Teilenummern entsprechen den in PLM erstellten Items, die mit Freigabedaten befüllt werden, wenn das Projekt in PLM veröffentlicht wird – beispielsweise wenn ein Project Releaser with Publish-Prozess (nach PLM) ausgeführt wird.
Der abgeschlossene Prozess und die zugehörigen Informationen können auch in der Workspace-Oberfläche angezeigt werden, indem Sie in der Detailansicht dieses Projekts die Ansicht Activities auswählen – sofern das Projekt über die Ansicht Projects geöffnet wurde. Wählen Sie die Option Closed activities (oben rechts), um auf Statusinformationen für den abgeschlossenen Prozess zuzugreifen.
-
In Altium Designer ist das neue Projekt im Bereich Projects sichtbar und für das Commit in das Git-basierte Design-Repository Versioned Storage im Workspace vorgesehen – klicken Sie mit der rechten Maustaste auf den Projekteintrag und verwenden Sie dazu den Befehl Save to server. Anschließend können Sie Quelldokumente hinzufügen und mit dem Design beginnen. Wenn Sie das Projekt später veröffentlichen, ist es bereits mit den entsprechenden Teilen in der PLM-Instanz verknüpft.
Auf der Registerkarte Parameters des Dialogs Project Options oder unter dem Eintrag Parameters des Projekts im Bereich Explorer können Sie die in der PLM-Instanz zugewiesenen Teilenummern sehen, die sich auf die relevanten Projektentitäten beziehen, die freigegeben/veröffentlicht werden können.
Wie die Namen der PLM-Parameter den Projektfreigabepaketen zugeordnet sind, wird in der PLM-Konfigurationsdatei festgelegt, die wiederum durch die vom PLM-System geforderten Namens- und Nummerierungsattribute bestimmt wird.
Wenn Sie einen Schaltplan-Textstring platzieren, stehen die dem Projekt zugeordneten PLM-Parameter als spezielle Strings zur Verfügung: