Download pdf - PTC Navigate Installations- und Konfigurationshandbuch · 1 PTC Navigate Installations- und Konfigurationshandbuch Dieses Handbuch ist das PDF-Format der Dokumentation für die folgenden

PTCNavigate Installations- undKonfigurationshandbuch

PTC Navigate Framework Extension 1.3PTC Navigate View PLM App Extension 1.4PTC Navigate View ALM App Extension 1.1

Copyright © 2017 PTC Inc. und/oder deren Tochtergesellschaften. Alle Rechtevorbehalten.

Die Benutzer- und Schulungshandbücher sowie zugehörige Dokumentation von PTC Inc. und derenTochtergesellschaften (gemeinsam als "PTC" bezeichnet) unterliegen den Urheberrechten der VereinigtenStaaten und anderer Staaten sowie einem Lizenzvertrag, der die Vervielfältigung, Veröffentlichung undVerwendung besagter Dokumentation einschränkt. PTC gewährt dem Lizenznehmer der Software hiermit dasRecht, diese auf Datenträgern bereitgestellte Dokumentation in gedruckter Form zu vervielfältigen, jedochausschließlich für den internen/persönlichen Gebrauch und in Übereinstimmung mit dem Lizenzvertrag, unterdem die jeweilige Software lizenziert ist. Jede angefertigte Kopie muss den urheberrechtlichen Hinweis vonPTC und sonstige von PTC bereitgestellte eigentumsrechtliche Hinweise enthalten. Schulungsmaterialiendürfen ohne ausdrückliche schriftliche Genehmigung von PTC nicht kopiert werden. Diese Dokumentationdarf ohne vorherige schriftliche Genehmigung von PTC nicht veröffentlicht, weitergegeben, geändert oder aufirgendeine Form reduziert werden, einschließlich elektronischer Datenträger, oder auf irgendeine Weiseübertragen oder öffentlich verfügbar gemacht werden, und zum Herstellen von Kopien zu solchen Zweckenwird keine Berechtigung erteilt. Die hierin enthaltenen Informationen dienen nur zur allgemeinenInformation; sie können ohne vorherige Bekanntgabe geändert werden und enthalten keinerleiGewährleistung oder Verpflichtung seitens PTC. PTC übernimmt keine Verantwortung oder Haftung füretwaige Fehler oder Ungenauigkeiten, die u.U. in diesem Handbuch auftreten.

Die im vorliegenden Handbuch beschriebene Software ist mit schriftlichem Lizenzvertrag erhältlich; sieenthält wertvolle Betriebsgeheimnisse und Eigentumsinformationen, die unter den Urheberrechten der USAund den Urheberrechten anderer Länder geschützt sind. Sie darf ohne vorherige schriftliche Genehmigungvon PTC in keiner Form und auf keinem Speichermedium vervielfältigt oder veröffentlicht, nicht an Dritteweitergegeben, und nur auf die im Software-Lizenzvertrag vorgesehene Weise verwendet werden.

UNBEFUGTE VERWENDUNG DER SOFTWARE ODER DER DAZUGEHÖRIGEN DOKUMENTATIONKANN SCHADENSERSATZFORDERUNGEN ZUR FOLGE HABEN UND ZU STRAFRECHTLICHERVERFOLGUNG FÜHREN.

PTC sieht Softwarepiraterie als Gesetzesbruch und behandelt Straftäter dementsprechend. Piraterie an PTCSoftwareprodukten wird nicht toleriert und wird sowohl zivil- als auch strafrechtlich mit allen rechtlichenMitteln, einschließlich von öffentlichen und privaten Überwachungsressourcen verfolgt. PTC verwendetDatenüberwachungs- und Beschaffungstechnologien als Teil dieser Bemühungen, um Daten von Benutzernillegaler Softwarekopien abzurufen und zu übermitteln. Diese Datensammlung wird bei legal lizenzierterSoftware von PTC und den autorisierten Händlern nicht eingesetzt. Wenn Sie eine illegale Kopie unsererSoftware benutzen, und mit der Sammlung und Übermittlung dieser Daten nicht übereinstimmen (auch in dieVereinigten Staaten), beenden Sie das Verwenden dieser Software und wenden Sie sich an PTC, um eineLizenz zu erwerben.

Wichtige Informationen zu Urheberrecht, Warenzeichen, Patenten und Lizenzen: Siehe Informationenzu Ihrer PTC Software oder den Copyright-Hinweis.

RECHTE VON US-BEHÖRDEN

Bei PTC Software-Produkte und Software-Dokumentation handelt es sich um "kommerzielle Gegenstände",gemäß der Definition dieses Begriffs unter 48 C.F.R. 2.101. PTC Software-Produkte und Software-Dokumentation werden der US-Regierung unter einer kommerziellen Lizenz zur Verfügung gestellt gemäßFederal Acquisition Regulation (Beschaffungsverordnung der US-Bundesbehörden, FAR) 12.212 (a)-(b)(Computer-Software) (MAY 2014) für zivile Behörden oder Defense Federal Acquisition RegulationSupplement (FAR-Ergänzung des US-Verteidigungsministeriums, DFARS) 227.7202-1(a) (Richtlinie) und

227.7202-3 (a) (Rechte bezüglich kommerzieller Computer-Software oder Computer-Software-Dokumentation) (FEB 2014) für das US-amerikanische Verteidigungsministerium. Die Nutzung,Vervielfältigung oder Offenlegung durch die Regierung der Vereinigten Staaten, unterliegt ausschließlich denBedingungen und Bestimmungen des entsprechenden PTC Software-Lizenzvertrags.

PTC Inc., 140 Kendrick Street, Needham, MA 02494 USA

Inhalt

PTC Navigate Installations- und Konfigurationshandbuch...............................................7

PTC Navigate – Übersicht............................................................................................9Voraussetzungen für PTC Navigate 1.4 ................................................................10Versionsaktualisierungen für PTC Navigate .......................................................... 11PTC Navigate installieren ....................................................................................12Upgrade-Übersicht .............................................................................................17Bekannte Probleme und Überlegungen für PTC Navigate......................................18Spracheinstellung ändern....................................................................................20

PTC Navigate View PLM App Extension .....................................................................21PTC Navigate View PLM App Extension – Produktüberblick ..................................22Voraussetzungen für PTC Navigate View PLM App Extension ...............................24PTC Navigate View PLM App Extension importieren .............................................25PTC Navigate View PLM App Extension konfigurieren...........................................26ThingWorx Einmalanmeldung beim Verbinden mit Windchill konfigurieren ..............31PTC Navigate View PLM App Extension anpassen ...............................................40

PTC Navigate View ALM App Extension .....................................................................63PTC Navigate View ALM App Extension Product Overview....................................64Voraussetzungen für PTC Navigate View ALM App Extension ...............................64Importing the PTC Navigate View ALM App Extension...........................................65Configuring PTC Navigate View ALM App Extension.............................................66Tailoring PTC Navigate View Requirements App ...................................................69Known Limitations in PTC Navigate View Requirements App .................................70

PTC Navigate – Referenzinformationen ......................................................................73Erweiterte Anpassung.........................................................................................74Beispielkonfiguration mit SSL für sichere Kommunikation ......................................89Architektur der Einmalanmeldung ........................................................................92

5

1PTC Navigate Installations- und

KonfigurationshandbuchDieses Handbuch ist das PDF-Format der Dokumentation für die folgendenProdukte:

• PTC Navigate Framework Extension 1.3.0• PTC Navigate View PLM App Extension 1.4• PTC Navigate View ALM App Extension 1.1Anweisungen zum Importieren von ThingWorx Utilities und Windchill Extensionsind ebenfalls eingeschlossen. Separate Dokumentation für diese Produkte wirdnicht benötigt.Jede PTC Navigate Version unterstützt bestimmte Versionen vonThingWorxWindchill, sowie andere Produkte. Stellen Sie sicher, dass Ihre SiteProdukte mit der notwendigen Versionsnummer verwendet. Lesen Sie hierzu diefolgenden Themen:• Voraussetzungen für PTC Navigate 1.4 auf Seite 10• Voraussetzungen für PTC Navigate View PLM App Extension auf Seite 24• Voraussetzungen für PTC Navigate View ALM App Extension auf Seite 64Um den PDF-Inhalt als Hilfe-Center anzuzeigen, siehe das PTC Navigate Hilfe-Center.

7

http://support.ptc.com/help/navigate/14/en/

http://support.ptc.com/help/navigate/14/en/

2PTC Navigate – Übersicht

Voraussetzungen für PTC Navigate 1.4.......................................................................10Versionsaktualisierungen für PTC Navigate................................................................. 11PTC Navigate installieren...........................................................................................12Upgrade-Übersicht ....................................................................................................17Bekannte Probleme und Überlegungen für PTC Navigate ............................................18Spracheinstellung ändern ..........................................................................................20

PTC Navigate stellt Anzeige-Apps zur Verfügung, mit denen Sie schnell undeinfach auf bestimmte Informationen zugreifen können, die in PTC Produktengespeichert sind. Welche Apps auf der Startseite von PTC Navigate angezeigtwerden, hängt von den importierten Produkterweiterungen ab. PTC NavigateFramework Extension stellt eine Plattform für die App-Erweiterungen bereit.Informationen zu den verfügbaren Apps finden Sie unter PTC Navigate ViewPLM App Extension – Produktüberblick auf Seite 22 und PTC Navigate ViewALM App Extension Product Overview auf Seite 64.

9

Voraussetzungen für PTC Navigate 1.4Diese Produkte müssen vor der Installation von PTC Navigate installiert werden.Informationen zu den App-spezifischen Produktanforderungen finden Sie unterVoraussetzungen für PTC Navigate View PLM App Extension auf Seite 24 undVoraussetzungen für PTC Navigate View ALM App Extension auf Seite 64.Gehen Sie nach der Überprüfung der Produktanforderungen zu PTC Navigateinstallieren auf Seite 12.

Unterstützte Serverplattformen• Nur ThingWorx 7.3

Anweisungen zum Installieren und Konfigurieren von ThingWorx finden Sieim englischen Handbuch Installing ThingWorx 7.3 (ThingWorx 7.3installieren).

• Datenbankoptionen:

○ H2○ PostgreSQL 9.4.x

◆ Mindestens 9.4.5◆ 9.5 wird nicht unterstützt

• Tomcat 8.0.38

○ Wurde mithilfe des Windows-Dienstinstallationsprogramm installiert.○ Wegen möglicher Sicherheitsschwachstellen ist mindestens die Version

8.0.33 erforderlich.• Unterstützte Serverbetriebssysteme

○ Windows Server 2012○ Windows Server 2008 R2 SP1○ Red Hat Enterprise Linux (RHEL) 7 Update 1

Unterstützte Client-Plattformen• Java 8• Unterstützte Browser

○ Internet Explorer 11 und höher

PTC Navigate unterstützt den Internet Explorer Kompatibilitätsmodusnicht.

○ Firefox 35 und höher○ Chrome 44 oder höher○ Safari 6.1.6 und höher

10 PTC Navigate Installations- und Konfigurationshandbuch

http://support.ptc.com/WCMS/files/172180/en/Installing_ThingWorx_7.3_1.0.pdf

Hinweis3D-Visualisierung wird nur auf Windows-Clients mit Firefox oder InternetExplorer unterstützt.

Weitere Informationen finden Sie im englischen Handbuch ThingWorx 7.3System Requirements.

Versionsaktualisierungen für PTCNavigateIn der folgenden Liste werden die in PTC Navigate 1.4 vorgenommenenAktualisierungen aufgeführt.• Nur Support für ThingWorx 7.3.• In vorherigen Versionen hat ein Administrator den Data Shape für eine App

mithilfe von ThingWorx Composer konfiguriert, um Attribute für die AppTeileliste anzeigen zu ändern. Die Seite Anpassungen für Teileliste anzeigenenthält jetzt den neuen Abschnitt Anzuzeigende Attribute auswählen.Administratoren können für jede Rolle Attribute, die in der Tabelle Teilelisteangezeigt werden, auswählen und umordnen. Außerdem wurden die FelderLink zu Zeichnungen einschließen? und Link zu Konstruktionsdateieneinschließen? aus der Anpassungsseite entfernt, da die Attribute Zeichnungund Konstruktionsdateien unter Anzuzeigende Attribute auswählen zurVerfügung stehen.

HinweisDie Anwendung Teileliste anzeigen ist erst verfügbar, wenn einAdministrator Attribute für die Anzeige auswählt.

PTC Navigate – Übersicht 11

http://support.ptc.com/WCMS/files/172182/en/ThingWorx_Core_7.3_System_Requirements_1.0.pdf

http://support.ptc.com/WCMS/files/172182/en/ThingWorx_Core_7.3_System_Requirements_1.0.pdf

PTC Navigate installierenIn dieser Übersicht wird das Verfahren zum Herunterladen der erforderlichenKomponenten für PTC Navigate beschrieben. Es wird davon ausgegangen, dassdie erforderlichen Produkte auf Seite 10 bereits installiert sind.Laden Sie die folgenden Produkte im Bereich PTC Smart Connected Applicationsder Seite PTC Software-Downloads herunter. Befolgen Sie anschließend dienachstehenden Verfahren in der angegebenen Reihenfolge.

Importieren Sie die Produkte in der folgenden Reihenfolge:

1. ThingWorx Utilities

Weitere Informationen finden Sie unter ThingWorx Utilities Dateienimportieren auf Seite 13.

2. Windchill Extension

Für Standorte, an denen PTC Navigate View PLM App Extension installiertwird. Wenn an Ihrem Standort nur PTC Navigate View ALM App Extensioninstalliert wird, können Sie diesen Schritt überspringen.

Importieren Sie die Erweiterungsdateien sowie Patches, die für die installierteVersion von Windchill spezifisch sind. Weitere Informationen finden Sie unterWindchill Extension importieren auf Seite 14.

3. PTC Navigate Framework Extension

Weitere Informationen finden Sie unter PTC Navigate Framework ExtensionDateien importieren auf Seite 16.

4. Produkt-App-Erweiterungen

• PTC Navigate View PLM App Extension


https://support.ptc.com/appserver/cs/software_update/swupdate.jsp

Weitere Informationen finden Sie unter PTC Navigate View PLM AppExtension importieren auf Seite 25.

• PTC Navigate View ALM App Extension

Weitere Informationen finden Sie unter Importing the PTC Navigate ViewALM App Extension auf Seite 65.

ThingWorx Utilities Dateien importieren1. Wie in PTC Navigate installieren auf Seite 12 beschrieben, laden Sie

ThingWorx-Utilities-{Version}.zip herunter.

Hinweis{Version} ist Versionsnummer, die Sie installieren.

2. Navigieren Sie in ThingWorx Composer zu Importieren/Exportieren ▶▶Importieren.

3. Das Fenster Erweiterungen importieren wird angezeigt.4. Navigieren Sie zu MED-61116-CD-073_SP1_ThingWorx-

Utilities-7-3-0-SP1.zip, und klicken Sie auf Importieren.


5. Klicken Sie auf Schließen. Wenn Sie zum Aktualisieren des Browsersaufgefordert werden, klicken Sie auf Ja.

6. Überprüfen Sie, ob die Erweiterung erfolgreich importiert wurde, indem Sienach dem Mashup-Typ PTC.ConvergeConsole suchen. Wählen Sie dasMashup aus, indem Sie auf den Namen oder das Anzeigesymbol klicken.Klicken Sie im Mashup-Editor auf Mashup anzeigen, und vergewissern Siesich, dass das Mashup angezeigt wird.

Windchill Extension importierenFür Sites, die PTC Navigate View PLM App Extension installieren, müssen Siedie Patches Windchill Extension und Windchill importieren, die der von Ihnenausgeführten Version von Windchill zugeordnet sind.

Windchill Extension Dateien importieren1. Laden Sie die folgende Datei herunter, und entpacken Sie sie: PTC-

Windchill-Extension-for-ThingWorx-{Version}.zip.


Hinweis{Version} ist Versionsnummer, die Sie installieren.

2. Wählen Sie im Menü Importieren/Exportieren in ThingWorx Composer dieBefehlsfolge ERWEITERUNGEN ▶▶ Importieren aus.

3. Klicken Sie im Fenster Erweiterungen importieren auf Durchsuchen, undwählen Sie ptc-windchill-extension-{Version}.zip aus.

Tipp{Version} ist Versionsnummer, die Sie installieren.

Bei den ZIP-Dateien mit Versionsnamen am Anfang des Dateinamenshandelt es sich um die im nächsten Abschnitt diskutierten WindchillPatches.

4. Klicken Sie auf Importieren.5. Sollte die Warnung angezeigt werden, dass infotableselector_Extension

übersprungen wurde, so kann diese ignoriert werden.

Aktualisieren Sie den Composer, falls Sie dazu aufgefordert werden.6. Wählen Sie Importieren/Exportieren ▶▶ Aus Datei aus.7. Navigieren Sie im Fenster Aus Datei importieren zu ptc-sample-mashup-

{Version}.xml, und klicken Sie auf Importieren.


PTC Windchill Patches installierenDas erforderliche PTC Windchill Patch fügt verschiedene Webdienst-Endpunktehinzu, die ThingWorx die Interaktion mit Windchill ermöglichen. Der Name derZIP-Datei identifiziert die Version, in der das Patch installiert werden muss.Installieren Sie beispielsweise auf einem System mit Version 10.2 M030 denPatch in 10.2-M030_WCTWXExtension_{Version}.zipJedes Patch enthält Anweisungen, die für die Version spezifisch sind. Um dasPatch zu installieren, entpacken Sie die Datei, und befolgen Sie die Anweisungenin der im Patch enthaltenen Readme-Datei.

PTC Navigate Framework Extension DateienimportierenUm die in PTC Navigate Framework Extension enthaltenen Erweiterungen zuimportieren, führen Sie die folgenden Schritte aus.1. Laden Sie die folgende Datei herunter, und entpacken Sie sie: PTC-

Navigate-Framework-{Version}.zip


3. Navigieren Sie im Fenster Erweiterungen importieren zu ptc-navigate-framework-extension-{Version}.zip.

4. Klicken Sie auf Importieren, und aktualisieren Sie das Fenster, wenn Sie dazuaufgefordert werden.


Um die Erweiterungen nach Abschluss des Imports anzuzeigen, wählen SieImportieren/Exportieren ▶▶ Verwalten aus.

5. Installieren Sie die App-Erweiterungen, die an Ihrem Standort verwendetwerden sollen.• PTC Navigate View PLM App Extension importieren auf Seite 25• Importing the PTC Navigate View ALM App Extension auf Seite 65

Upgrade-ÜbersichtPTC Navigate 1.4 unterstützt die folgenden Upgrades:• 1.3 bis 1.4• 1.2.x bis 1.4

Überlegungen für alle Upgrades auf 1.4• Lediglich für die App Teileliste werden an den Data Shapes vorgenommene

Konfigurationen bei einem Upgrade nicht migriert. Verwenden Sie die neueFunktion auf der Seite Anpassungen für Teileliste anzeigen, um die Attributeauszuwählen, die in der Tabelle Teileliste angezeigt werden sollen. WeitereInformationen finden Sie unter Versionsaktualisierungen für PTC Navigate aufSeite 11.

• Aktuelle Elemente werden nicht in die neue Version übertragen. Auf derRegisterkarte AKTUELL werden nur Elemente angezeigt, die seit derInstallation der neuen Version angezeigt wurden.

Überlegungen für Upgrades von 1.2.x auf 1.4• Beim Upgrade-Prozess werden Anpassungsoptionen und Berechtigungen

migriert und Einstellungen beibehalten, die die Einmalanmeldung mitWindchill ermöglichen.

• Vergewissern Sie sich, dass in PTC Navigate 1.4 das Feld WindchillNavigations-Link anzeigen? auf der allgemeinen Anpassungsseite auf Seite 41auf den Standardwert Ja festgelegt ist. Das Ändern des Werts kann Upgrade-Probleme verursachen.

• Lebenszyklusstatus aus Windchill werden in PTC Navigate 1.4 geladen.Wechseln Sie zur allgemeinen Anpassungsseite auf Seite 41, umLebenszyklusstatus auszuwählen. Vorherige Auswahlen werden beim Upgradenicht übertragen.

Fahren Sie nach Prüfung der Überlegungen für Ihr Upgrade mit Aktualisierungauf PTC Navigate 1.4 auf Seite 17 fort.

Aktualisierung auf PTC Navigate 1.4Lesen Sie die Anmerkungen zur Aktualisierung in Upgrade-Übersicht auf Seite 17bevor Sie mit den nachstehenden Anweisungen fortfahren.


1. Installieren Sie auf einem anderen Server als dem Server mit der vorherigenVersion eine neue Instanz von PTC Navigate 1.4 auf ThingWorx 7.3.

2. Exportieren Sie die Datei AllEntities aus der vorherigen Version vonPTC Navigate.

a. Wählen Sie in ThingWorx Composer Importieren/Exportieren ▶▶Exportieren ▶▶ In Datei aus.

Das Fenster In Datei exportieren wird geöffnet.b. Vergewissern Sie sich, dass auf der Registerkarte Entitäten die Option

Binär im Feld ExportType ausgewählt ist, und klicken Sie auf Exportieren.

Hierdurch werden alle Entitäten in die Datei AllEntities.twxexportiert.

3. Importieren Sie die Datei AllEntities in 1.4.

a. Wählen Sie in ThingWorx Composer Importieren/Exportieren ▶▶Importieren ▶▶ Aus Datei aus.

Das Fenster Aus Datei importieren wird geöffnet.b. Wählen Sie die Schaltfläche Entitäten aus.c. Navigieren Sie auf der Registerkarte Einzelne Datei zur Datei

AllEntities.twx, und klicken Sie auf Importieren.

TippWenn an Ihrem Standort benutzerdefinierte Gruppen in PTC Navigate erstelltund PLMAppsRolesTag wie in ThingWorx Berechtigungen ändern auf Seite 36beschrieben hinzugefügt wurde, wird diese Auszeichnung bei einem Upgradebeibehalten.

Bekannte Probleme und Überlegungenfür PTC NavigateIm Folgenden werden Gegebenheiten beschrieben, die ggf. in PTC Navigate undPTC Navigate View PLM App Extension auftreten können. SpezifischeInformationen für PTC Navigate View ALM App Extension finden Sie unterKnown Limitations in PTC Navigate View Requirements App auf Seite 70.

Ausgewählte Attribute auf der Seite Anpassungen für Teilelisteanzeigen• Problem: Auf der Seite Anpassungen für Teileliste anzeigen unter

Anzuzeigende Attribute auswählenkommt es zu einer Ausnahme, wenn diefolgenden Attribute ausgewählt sind:

○ ADW Zugriffssteuerungsdaten


○ ADW Letzte Änderung○ Aus CAD erstellt○ Ersatzstatus

• Lösung: Dieses Problem wird in einer zukünftigen Version von PTC Navigatebehoben.

Apostroph in Suchen• Problem: Bei Verwendung eines Apostrophs (') in einer App-Suche wird ein

Fehler ausgegeben.• Workaround: Fügen Sie einen zusätzlichen Apostroph hinzu. Geben Sie

beispielsweise anstelle von D'dorf D''dorf ein.• Lösung: Dieses Problem wird in einer zukünftigen Version von PTC Navigate

behoben.

Konstruktionsdateien anzeigenDas Verhalten der App Konstruktionsdateien anzeigen ist je nach Browserunterschiedlich. In einem Browser werden Sie beispielsweise gefragt, ob Dateiengeöffnet oder gespeichert werden sollen, während in einem anderen Browsereinige Dateien automatisch geöffnet werden.

Formularbasierte Authentifizierung• Problem: PTC Navigate funktioniert nicht, wenn der Windchill Server für die

Verwendung der formularbasierten Authentifizierung eingerichtet ist.• Workaround:

○ Verwenden Sie für Windchill Server die Tomcat-Authentifizierung.

1. Navigieren Sie zu $WT_HOME/tomcat/configAuth.2. Führen Sie den folgenden Befehl aus: ant –f authConfig.xml

enable

○ Wenn Sie die formularbasierte Authentifizierung mit einer anderenUnternehmenslösung verwenden, führen Sie die folgenden Schritte aus.

1. Navigieren Sie zu <WT_HOME>/codebase/WEB-INF/web.xml.2. Verschieben Sie diese Codezeile: <url-pattern>/

sslClientAuth/*</url-pattern>

aus dieser Sicherheitsbeschränkung: <web-resource-name>Authenticated resources</web-resource-name>

in diese Sicherheitsbeschränkung: <web-resource-name>Anonymously accessible resources</web-resource-name>

• Lösung: Dieses Problem wurde in Windchill 11.0 M010 gelöst.


Spracheinstellung ändernVerwenden Sie das folgende Verfahren, um Ihre Spracheneinstellung für PTCNavigate zu ändern.

1. Wechseln Sie in ThingWorx Composer zu SICHERHEIT ▶▶ Benutzer.2. Wählen Sie den Benutzer aus, und bearbeiten Sie ihn (in diesem Fall den

Administrator).

3. Führen Sie im Feld Sprachen die folgenden Schritte aus:

• Klicken Sie auf Bearbeiten, um ein Fenster zu öffnen, in dem Sie dieSpracheinstellungen mit Ziehen-und-Ablegen bearbeiten können.

oder• Geben Sie die Abkürzung für die bevorzugte Sprache ein, z.B. en für

Englisch oder ko für Koreanisch. Abkürzungen werden im FensterBearbeiten aufgeführt.


3PTC Navigate View PLM App

ExtensionPTC Navigate View PLM App Extension – Produktüberblick .........................................22Voraussetzungen für PTC Navigate View PLM App Extension ......................................24PTC Navigate View PLM App Extension importieren ....................................................25PTC Navigate View PLM App Extension konfigurieren .................................................26ThingWorx Einmalanmeldung beim Verbinden mit Windchill konfigurieren .....................31PTC Navigate View PLM App Extension anpassen ......................................................40

Mit den in PTC Navigate View PLM App Extension verfügbaren Apps können inWindchill gespeicherte Teile, Dokumente und CAD-Dokumente angezeigtwerden. In den Themen in diesem Abschnitt wird beschrieben, wie dieErweiterung installiert und konfiguriert wird und die Apps angepasst werden.

21

PTC Navigate View PLM App Extension –ProduktüberblickPTC Navigate View PLM App Extension stellt Anzeige-Apps zur Verfügung, mitdenen Sie schnell und einfach auf bestimmte Informationen zugreifen können, diein Windchill Produkten gespeichert sind. Die folgenden Apps sind in dieserVersion verfügbar.

Jede dieser Anzeige-Apps enthält ein Suchfeld, in dem Sie Kriterien für dasanzuzeigende Objekt eingeben können. Die verfügbaren Suchfelder und ihreFunktion können durch App-Anpassung geändert werden. Weitere Informationenfinden Sie unter Allgemeine Anpassungen für Apps durchführen auf Seite 41 undAnpassungen für bestimmte Apps durchführen auf Seite 46.Diese Startseite ist ein ThingWorx Mashup, das unter der folgenden URLverfügbar ist: http://<Host>:<Port>/Thingworx/Runtime/index.html#master=PTC.AccessApp.Master&mashup=LandingPageAccessAppMashup

Optimale Vorgehensweise• PTC Navigate Apps wurden für eine Bildschirmauflösung von 1280 x 1024

entwickelt. Bei anderen Auflösungen können die Ergebnisse variieren.• App-Suchläufe können länger dauern, wenn Windchill Daten abgerufen

werden. Weitere Informationen finden Sie unter Dingkonfigurationenbearbeiten auf Seite 39.

App-SammlungenApps sind in zugehörigen Sammlungen gruppiert, eine für Teile und eine fürDokumente. Die App-Sammlungen bieten die folgenden Vorteile:• Sie können mithilfe der Symbole auf den Detailseiten zu anderen Apps in der

Sammlung navigieren. Wenn Sie z.B. Teileeigenschaften anzeigen, können Siedas Symbol "Konstruktionsdateien anzeigen" auswählen und zu dieser Appwechseln.


• Administratoren können die App-Funktionen als Sammlung anpassen. WennSie z.B. entscheiden, nach welchem Attribut die Apps suchen sollen (Nameund/oder Nummer), legen Sie die Option einmal fest, anstatt jede App einzelnanzupassen. Weitere Informationen finden Sie unter Allgemeine Anpassungenfür Apps durchführen auf Seite 41.

Sitzungs-TimeoutWenn eine Meldung ähnlich der in der folgenden Abbildung angezeigt wird, istIhre Sitzungszeit abgelaufen. Klicken Sie auf Schließen, und aktualisieren Sie denBrowser, um zur aktuellen Sitzung zurückzukehren.

PTC Navigate View PLM App Extension 23

Voraussetzungen für PTC Navigate ViewPLM App ExtensionPTC Navigate View PLM App Extension erfordert die folgendeProduktunterstützung.

• Windchill in einer der folgenden Versionen:

○ 11.0 M020○ 11.0 M010○ 10.2 M032○ 10.2 M030 CPS 01 oder höher

HinweisInformationen zu den Windchill Systemanforderungen für Ihre spezifischeWindchill Version finden Sie auf der Seite Referenzdokumente.

• Windchill Extension 1.6, inklusive eines Patches, der der Windchill Versionentspricht, die Sie installiert haben. Weitere Informationen finden Sie unterPTC Navigate installieren auf Seite 12.

• Informationen zur Unterstützung weiterer Plattformen finden Sie unterVoraussetzungen für PTC Navigate 1.4 auf Seite 10.

Das folgende Diagramm zeigt eine ThingWorx Bereitstellung mit Windchill.


https://support.ptc.com/appserver/cs/doc/refdoc.jsp?p=browse_results&Product=Windchill+PDMLink&Release=&DocType=2872

PTC Navigate View PLM App ExtensionimportierenVoraussetzungenInstallieren Sie die erforderlichen Produkte, die unter PTC Navigate installierenauf Seite 12 beschrieben werden, bevor Sie PTC Navigate View PLM AppExtension installieren.

PTC Navigate View PLM App Extension Dateien importieren1. Laden Sie die folgende Datei herunter, und entpacken Sie sie: PTC-

Navigate-View-PLM-Apps-{Version}.zip


3. Navigieren Sie im Fenster Erweiterungen importieren zu PTC-Navigate-View-PLM-App-Extension-Bundle-{Version}.zip.

4. Klicken Sie auf Importieren, und aktualisieren Sie das Fenster, wenn Sie dazuaufgefordert werden.

5. Wählen Sie Importieren/Exportieren ▶▶ Aus Datei aus.6. Navigieren Sie zu PTCNavigate_Example-{Version}-

imports.xml, und klicken Sie auf Importieren.Um die Erweiterungen nach Abschluss des Imports anzuzeigen, wählen SieImportieren/Exportieren ▶▶ Verwalten aus.


PTC Navigate View PLM App ExtensionkonfigurierenDieses Abschnitt enthält Konfigurationsinformationen für ThingWorx undWindchill Systeme.Für Systeme mit PTC Navigate View ALM App Extension können dieseKonfigurationsschritte ausgeführt werden, um die SSO-Authentifizierungslösungen (Single Sign-On, Einmalanmeldung) zu verwenden,da Windchill als Identitätsanbieter (IdP) für ThingWorx verwendet wird.

Empfohlene KonfigurationenNicht alle Konfigurationsschritte sind für jede Produktinstallation erforderlich.Um die Installation und Konfiguration zu vereinfachen, empfiehlt PTCKonfigurationen für die folgenden Umgebungen, in denen nur die relevantestenOptionen konfiguriert werden.• Produktion• Entwicklung• DemoJede empfohlene Konfiguration enthält Links zu Abschnitten mit ausführlichenSchritten. Wählen Sie eine empfohlene Konfiguration, und folgen Sie den Links,um die Konfigurationsschritte auszuführen.

ProduktionskonfigurationDie empfohlene Produktionsumgebung weist die folgenden Merkmale auf:• Verschlüsselte Verbindung zwischen Windchill und ThingWorx. Die

verschlüsselte Kommunikation wird im nächsten Schritt als Teil derVerwendung von SSL zum Herstellen einer vertrauenswürdigen Beziehungkonfiguriert.

• Vertrauensstellung zwischen Windchill und ThingWorx auf Basis vonöffentlichen/privaten SSL-Schlüsseln. Führen Sie die Schritte in SSL fürsichere Kommunikation verwenden auf Seite 27 aus.

• Eine SSO-Eingabeaufforderung (Single Sign-On, Einmalanmeldung) fürBenutzer. Die Einmalanmeldung verwendet Windchill Anmeldeinformationen.Führen Sie die Schritte in ThingWorx Einmalanmeldung beim Verbinden mitWindchill konfigurieren auf Seite 31 aus.


EntwicklungskonfigurationDie empfohlene Entwicklungsumgebung weist die folgende Merkmale auf:• Unverschlüsselte Kommunikation zwischen Windchill und ThingWorx.• Vertrauensstellung zwischen Windchill und ThingWorx unter Verwendung

eines vertrauenswürdigen Hosts. Führen Sie die Schritte inVertrauenswürdigen Host verwenden auf Seite 31 aus.

• Einmalanmeldung ist nicht erforderlich, allerdings müssen für jeden Benutzerim System relevante Laufzeitberechtigungen festgelegt werden. Führen Sie dieSchritte in ThingWorx Berechtigungen ändern auf Seite 36 aus. AktualisierenSie außerdem die Datei web.xml, wie unter Servlet-Filter zur Tomcat-Konfiguration hinzufügen auf Seite 34 beschrieben.

DemokonfigurationDie empfohlene Demo-Umgebung weist die folgenden Merkmale auf:• Unverschlüsselte Kommunikation zwischen Windchill und ThingWorx.• Vertrauensstellung zwischen Windchill und ThingWorx unter Verwendung

eines vertrauenswürdigen Hosts. Führen Sie die Schritte inVertrauenswürdigen Host verwenden auf Seite 31 aus.

• Eine SSO-Eingabeaufforderung (Single Sign-On, Einmalanmeldung) fürBenutzer. Die Einmalanmeldung verwendet Windchill Anmeldeinformationen.Führen Sie die Schritte in ThingWorx Einmalanmeldung beim Verbinden mitWindchill konfigurieren auf Seite 31 aus.

SSL für sichere Kommunikation verwendenAn Ihrem Standort kann bidirektionales SSL verwendet werden, um dieKommunikation zwischen dem ThingWorx Server und der Windchill Anwendungzu sichern. PTC empfiehlt die Verwendung von SSL beim Arbeiten in einerProduktionsumgebung. Informationen zu Demo- und Entwicklungsumgebungenfinden Sie unter Vertrauenswürdigen Host verwenden auf Seite 31. DieErweiterung kann SSL zum einen verwenden, um die Server untereinander zuauthentifizieren, und zum anderen, um die Kommunikation selbst zu schützen.Für eine SSL-Verbindung müssen beide Systeme einander vertrauen; hierzu mussdie Dingvorlage WindchillConnector so konfiguriert werden, dass sie die auf demThingWorx Server gespeicherten Java-Schlüssel- und -Vertrauensspeicherreferenziert, die Schlüssel für die Transaktion bereitstellen. Der HTTP-Server aufdem Windchill Server muss so konfiguriert werden, das er diesen Schlüsselnvertraut.SSL-Konfigurationen unterscheiden sich erheblich, und dieses Handbuch versuchtnicht, alle Optionen zu beschreiben, die in einer SSL-Konfiguration verfügbarsind. Stattdessen geben die folgenden Schritte eine Übersicht über den Prozesszum Konfigurieren von SSL; ein detailliertes Beispiel ist in Beispielkonfigurationmit SSL für sichere Kommunikation auf Seite 89 verfügbar.


In diesem Verfahren wird vorausgesetzt, dass ThingWorx und Windchill sokonfiguriert sind, dass sie SSL für die Standardkommunikation verwenden.Außerdem beruht es auf Konfigurationsskripts, die in der neuesten Version vonPTC HTTP-Server enthalten sind. Die neueste Version von PTC HTTP-Server istim Lieferumfang von Windchill 11.0 und den aktuellen CPS-Versionen fürWindchill 10.2 enthalten.

HinweisEs ist nicht erforderlich, den gleichen SSL-Schlüssel für die primäre Windchilloder ThingWorx Kommunikation und die hier beschriebene Kommunikationzwischen ThingWorx und Windchill zu verwenden. Beispielsweise kann einkommerzielles vertrauenswürdiges Platzhalterzertifikat für Windchill und einselbstsigniertes Zertifikat zwischen ThingWorx und Windchill verwendetwerden.

ThingWorx konfigurierenThingWorx erfordert Java-Schlüssel- und -Vertrauensspeicher.• Erstellen Sie diese auf dem gleichen Server wie ThingWorx.• Erstellen Sie sie im lokalen Dateisystem.• Referenzieren Sie sie in der Konfiguration der Dingvorlage

WindchillConnector, die zum Verbinden von ThingWorx mit dem WindchillSystem verwendet wird, das gesichert wird.

1. Geben Sie für jeden der Speicher den Typ und das Passwort für den Zugriffauf den Speicher an.


HinweisEs wird empfohlen, den Typ JKS zu verwenden, dies ist jedoch nichtobligatorisch.

2. In den Schlüsselspeicher importieren Sie den von Windchill verwendetenprivaten Schlüssel.

3. In den Vertrauensspeicher importieren Sie die Zertifikate, die verwendetwerden, um vertrauenswürdige Anmeldeinformationen für diese Schlüsselfestzulegen.

Windchill konfigurierenKonfigurieren Sie auf dem Windchill Server die SSL-Authentifizierung in PTCHTTP-Server und PTC Embedded Servlet Engine so, dass dem ThingWorxSchlüssel und Zertifikat vertraut wird.

HinweisDie Codebeispiele wurden zur Anpassung an die Seitengröße umformatiertund enthalten unter Umständen Zeilennummern, verborgene Zeichen (wieTabulatoren und Zeilenendezeichen) sowie belanglose Leerzeichen. Wenn SieCode ausschneiden und einfügen, suchen Sie nach diesen Zeichen, undentfernen Sie sie, bevor Sie den Beispielcode in Ihrer Anwendung einzusetzenversuchen.

1. Aktualisieren Sie die Konfiguration von PTC HTTP-Server so, dass die CA-Zertifikatdatei referenziert wird.• Windchill 10.2 Versionen:

a. Navigieren Sie zu <HTTPSERVER_HOME>/conf/extra/httpd-ssl.conf, und bearbeiten Sie die Datei.

b. Heben Sie die Auskommentierung des EintragsSSLCACertificateFile auf, sodass er die Datei ca-bundle.crt referenziert. Notieren Sie den Speicherort der Dateica-bundle.crt.

c. Speichern Sie die Änderungen.• Windchill 11.0 Versionen:

a. Erstellen Sie eine Datei unter <APACHE_HOME>\conf\ca-bundle.crt. Dieser Speicherort wird empfohlen, ist jedoch nichtobligatorisch.

b. Fügen Sie den Inhalt der Datei Server.crt ein, die in HTTP-Serververwendet wird.

c. Speichern Sie ca-bundle.crt.


d. Erstellen Sie eine Datei sslclientauth.conf unter <APACHE_HOME>\conf\sslvhostconf.d.

e. Fügen Sie der Datei "SSLCACertificateFile <PATH_TO>\ca-bundle.crt" hinzu, sodass die Datei "ca-bundle.crt" referenziert wird.

f. Speichern Sie die Änderungen.2. Fügen Sie das ThingWorx Zertifikat der Liste vertrauenswürdiger CA-

Zertifikate von PTC HTTP-Server hinzu.a. Bearbeiten Sie die Datei ca-bundle.crt, auf die Sie zuvor im Eintrag

SSLCACertificateFile verwiesen haben.

HinweisWenn die Datei noch nicht vorhanden ist, erstellen Sie die Datei undalle erforderlichen Verzeichnisse.

b. Hängen Sie den Inhalt des im Vertrauensspeicher gespeichertenThingWorx Zertifikats an diese Datei an.

c. Speichern Sie die Änderungen.3. Konfigurieren Sie PTC HTTP-Server für die sslClientAuth-URL.

a. Suchen Sie den Windchill Web-App-Namen in <windchill-home>/codebase/wt.properties im Eintrag wt.webapp.name.

b. Öffnen Sie eine Shell oder eine Eingabeaufforderung, und geben SieFolgendes ein:cd <HTTPSERVER_HOME>ant -f webAppConfig.xml -DappName=[windchill-web-app]

-Dresource=sslClientAuth -DresourceAuthType=sslClientAuth addAuthResource

c. Konfigurieren Sie Windchill so, dass die Anwendung dem ThingWorxZertifikat vertraut.i. Bearbeiten Sie die Datei <windchill-home>/codebase/WEB-

INF/web.xml.ii. Suchen Sie nach <filter-name>TrustedSSLAuthFilter</

filtername>.iii. Fügen Sie ein zusätzliches <init-param>-Element nach dem

vorhandenen hinzu, wobei [thingworx-cert-name] der Name desThingWorx Zertifikats ist:<init-param><param-name>trustedSubjectPattern.1</param-name><param-value>

[thingworx-cert-name]</param-value></init-param>

d. Speichern Sie die Änderungen.


Vertrauenswürdigen Host verwendenWenn Sie eine Anwendung zur internen Verwendung (z.B. Entwicklung, Testsoder Demos) erstellen, können Sie die Kommunikation einfach nur mit einemvertrauenswürdigen Host konfigurieren. Informationen zuProduktionsumgebungen finden Sie unter SSL für sichere Kommunikationverwenden auf Seite 27.Vertrauenswürdige Hosts werden über die Eigenschaftwt.auth.trustedHosts in der Datei wt.properties auf dem WindchillSystem eingerichtet. Sie müssen sicherstellen, dass der Hostname des ThingWorxServers zu dieser Eigenschaft hinzugefügt wurde.Wenn die Eigenschaft wt.auth.trustedHosts vorhanden ist, können Sieden Parameter -d im Befehl xconfmanager verwenden, um die vorhandenenWerte der Eigenschaft anzuzeigen. Geben Sie z.B. einen Befehl ähnlich demfolgenden in einer Windchill Shell ein:xconfmanager -d wt.auth.trustedHosts=twxhost1 -t codebase/wt.properties

Bei Bedarf können Sie den Befehl "xconfmanager" in einer Windchill Shelleingeben, um den ThingWorx Hostnamen hinzuzufügen:• Wenn die Eigenschaft nicht in wt.properties festgelegt ist und der

Hostname twxhost1 lautet, geben Sie einen Befehl ähnlich dem folgendenein, um die Eigenschaft auf den Hostnamen festzulegen:xconfmanager --set wt.auth.trustedHosts=twxhost1 -t codebase/wt.properties -p

• Wenn die Eigenschaft bereits in wt.properties festgelegt wurde und derHostname twxhost1 lautet, geben Sie einen Befehl ähnlich dem folgendenein, um den Hostnamen hinzuzufügen:xconfmanager --add wt.auth.trustedHosts=twxhost1 -p

• Wenn mehrere Hosts vorhanden sind, geben Sie sie als einzelnen Wert ähnlichdem folgenden Beispiel ein:xconfmanager -s wt.auth.trustedHosts="hostname1 hostname2 hostname3"

Weitere Informationen finden Sie in der zugehörigen PTC Falllösung. https://support.ptc.com/appserver/cs/view/solution.jsp?n=CS182327

ThingWorx Einmalanmeldung beimVerbinden mit Windchill konfigurierenThingWorx Benutzer müssen über entsprechende Benutzeridentitäten in Windchillverfügen, um auf Mashups zuzugreifen, die die von dieser Erweiterungbereitgestellten Dienste verwenden. PTC empfiehlt, hierfür die Einmalanwendungzu verwenden.Die Einmalanmeldungslösung verwendet Windchill als Identitätsanbieter fürThingWorx. Ein Benutzer, der in einem Browser zu einem Mashup oder einerbeliebigen ThingWorx URL navigiert, wird zur Authentifizierung zu Windchillweitergeleitet. Nach erfolgter Authentifizierung wird der Browser zurück zumMashup oder zu einer anderen Seite in ThingWorx geleitet, und der Benutzer kann


als der in Windchill authentifizierte Benutzer auf ThingWorx oder das Mashupzugreifen. Technische Details finden Sie unter Architektur der Einmalanmeldungauf Seite 92.Damit die Einmalanmeldung funktioniert, muss der gleiche Benutzer sowohl inWindchill als auch in ThingWorx vorhanden sein. PTC Navigate bietet eineOption, um Benutzer automatisch in ThingWorx zu erstellen, sobald sie inWindchill authentifiziert wurden. Wenn diese Option nicht aktiviert ist oder dieEinmalanmeldung nicht verwendet wird, müssen die Benutzer unabhängig inWindchill und ThingWorx vorhanden sein.Führen Sie die Schritte in den folgenden Abschnitten aus, um dieEinmalanmeldung mit Windchill als Identitätsanbieter zu konfigurieren.1. PTC Identity Provider Authenticator konfigurieren auf Seite 332. Servlet-Filter zur Tomcat-Konfiguration hinzufügen auf Seite 343. ThingWorx Berechtigungen ändern auf Seite 364. Einmalanmeldung überprüfen auf Seite 39


PTC Identity Provider Authenticator konfigurierenIn den folgenden Schritten wird beschrieben, wie PTC Identity ProviderAuthenticator konfiguriert wird.1. Wählen Sie im linken Navigationsfenster unter SICHERHEIT den Eintrag

Authentifikatoren aus.2. Klicken Sie auf den Link ptc-identity-provider-authenticator, um die

allgemeinen Informationen zur Erweiterung anzuzeigen.

Die Seite Allgemeine Informationen wird geöffnet.3. Führen Sie auf der Seite Allgemeine Informationen die folgenden Schritte aus:

a. Aktivieren Sie das Kontrollkästchen Aktiviert.b. Geben Sie einen Wert in das Feld Priorität ein. Standardmäßig ist die

Priorität auf 1 festgelegt; dies zeigt an, dass dies der erste Authentifikatorist, der ausgeführt wird.

Der Wert im Feld Priorität ist wichtig, wenn Sie Prüfungen durch mehrereAuthentifikatoren implementieren möchten. Wenn der Authentifikator mitder Priorität 1 fehlschlägt, führt der nächste Authentifikator dieAuthentifizierungsprüfung durch usw.


4. Klicken Sie im linken Navigationsfenster unter ENTITÄTSINFORMATIONENauf Konfiguration:

Verwenden Sie die beiden Optionen CreateUserDynamically und HomeMashupmit Einmalanmeldung, sodass Benutzer, die in Windchill authentifiziert sind,automatisch als Benutzer zu ThingWorx hinzugefügt werden und ihnen einStart-Mashup zugewiesen wird. Wenn ein Benutzer zum ersten Mal in einemBrowser zu ThingWorx navigiert, wird er zur Authentifizierung zu Windchillweitergeleitet. Nach der Authentifizierung wird ein entsprechender Benutzerin ThingWorx erstellt, und dem Benutzer wird ein Start-Mashup zugewiesen.Anschließend wird der Browser zum angegebenen Start-Mashupweitergeleitet.

• CreateUserDynamically: Bei Auswahl dieser Option wird derAuthentifikator so konfiguriert, dass ein Benutzer automatisch inThingWorx erstellt wird, wenn der Benutzer noch nicht vorhanden ist undder Benutzer von Windchill authentifiziert wurde. Wenn derAuthentifikator nicht für die automatische Erstellung von Benutzernkonfiguriert ist, wird der Browser trotzdem zur Authentifizierung zuWindchill weitergeleitet; anschließend wird ThingWorx jedoch nichtgeöffnet, wenn die Benutzer nicht vorhanden sind.

• HomeMashup: Weist den neu erstellten Benutzern ein Start-Mashup zu.Wenn kein Start-Mashup angegeben ist, leitet ThingWorx den Browser zurSuchseite von ThingWorx weiter.

Legen Sie diese Option für PTC Navigate aufLandingPageAccessAppMashup fest.

5. Stellen Sie sicher, dass ein Start-Mashup-Wert festgelegt ist, entweder für alledynamisch erstellten Benutzer mit dem Feld HomeMashup (sieheBeschreibung im vorherigen Schritt) oder für vorhandene Benutzer (außerAdministratoren) auf der Seite Allgemeine Informationen der Benutzer. Wennfür einen allgemeinen Benutzer kein Start-Mashup festgelegt ist, wird dieserBenutzer zur Standardsuchseite von ThingWorx umgeleitet.

6. Klicken Sie auf Speichern.

Servlet-Filter zur Tomcat-Konfiguration hinzufügenMithilfe des Windchill IdP-Authentifizierungsfilters wird der nicht authentifizierteThingWorx Benutzer zum Windchill Anmeldeformular umgeleitet, umAnmeldeinformationen für die Authentifizierung einzugeben. Nach erfolgreicher


Authentifizierung empfängt die ThingWorx Anwendung einen Schlüssel undeinen Benutzernamen. Weitere Informationen finden Sie unter ThingWorxEinmalanmeldung beim Verbinden mit Windchill konfigurieren auf Seite 31.Der Filter wird auf der ThingWorx Seite in der Datei web.xml konfiguriert, dieim ThingWorx Tomcat-Installationsverzeichnis abgelegt ist. Gehen Sie hierzu wiefolgt vor:

1. Halten Sie Tomcat an.2. Kopieren Sie die Datei ptc-identity-provider-authentication-

filter-{Version}.jar in das Verzeichnis WEB-INF/lib unter demThingWorx Tomcat-Installationsverzeichnis.

HinweisDie JAR-Datei ist in den Erweiterungsdateien in Framework.zipenthalten.

3. Navigieren Sie zur Datei web.xml am folgenden Speicherort: <Tomcat-Installationsverzeichnis>\Apache Software Foundation\Tomcat 8.0\webapps\Thingworx\WEB-INF\web.xml.

4. Fügen Sie der ThingWorx Datei web.xml einen Codeblock hinzu.

HinweisBeachten Sie Folgendes im Hinblick auf die Codebeispiele:

• Die Codebeispiele in diesem Handbuch wurden möglicherweise zurAnpassung an die Seitengröße umformatiert und enthalten daher unterUmständen Zeilennummern, verborgene Zeichen (wie Tabulatoren undZeilenendezeichen) sowie belanglose Leerzeichen. Wenn Sie Code ausdiesem Handbuch ausschneiden und einfügen, suchen Sie nach diesenZeichen, und entfernen Sie sie, bevor Sie den Beispielcode in IhrerAnwendung einzusetzen versuchen.

• Sie müssen tatsächliche Werte angeben. Ersetzen Sie in jedemCodeblocks den durch [] identifizierten Inhalt durch Werte für IhreImplementierung.

Fügen Sie vor dem Block AuthenticationFilter den folgendenCodeblock hinzu:<filter>

<filter-name>IdentityProviderAuthenticationFilter</filter-name><filter-class>com.ptc.connected.plm.thingworx.wc.idp.client.filter.

IdentityProviderAuthenticationFilter</filter-class><init-param>

<param-name>idpLoginUrl</param-name><param-value>[http or https]://[windchill-host]:[windchill-port]/


[windchill-web-app]/wtcore/jsp/genIdKey.jsp</param-value></init-param>

</filter><filter-mapping>

<filter-name>IdentityProviderAuthenticationFilter</filter-name><url-pattern>/*</url-pattern>

</filter-mapping><filter>

<filter-name>IdentityProviderKeyValidationFilter</filter-name><filter-class>com.ptc.connected.plm.thingworx.wc.idp.client.filter.

IdentityProviderKeyValidationFilter</filter-class><init-param>

<param-name>keyValidationUrl</param-name><param-value>[http or https]://[windchill-host]:[windchill-port]/

[wndchill-web-app]/login/validateIdKey.jsp</param-value></init-param>

</filter><filter-mapping>

<filter-name>IdentityProviderKeyValidationFilter</filter-name><url-pattern>/*</url-pattern>

</filter-mapping>

5. Starten Sie Tomcat neu.

ThingWorx Berechtigungen ändernAdministratorenUm als PTC Navigate Administrator fungieren zu können, müssen Sie derThingWorx Gruppe "Administratoren" hinzugefügt werden. Diese Gruppe ist einSystemobjekt und wird im Menü Gruppen standardmäßig nicht angezeigt. Um aufdie Gruppe zuzugreifen, geben Sie Administratoren in das Suchfeld amoberen Rand des ThingWorx Composer Bildschirms ein.

Benutzer und GruppenErstellen Sie in ThingWorx Composer Benutzergruppen für jede Rolle, die IhrStandort in PTC Navigate einschließen möchte. Die Gruppen ermöglichen dierollenbasierte Anpassung und werden in der Liste Anzupassende Rolle auswählenauf allgemeinen auf Seite 41 und App-spezifischen auf Seite 46 Anpassungsseitenangezeigt.


1. Wechseln Sie in ThingWorx Composer zu SICHERHEIT ▶▶ Benutzergruppen.2. Erstellen Sie neue Gruppen, wie für Ihren Standort benötigt.3. Die Gruppen "Fertigung" und "Einkauf" sind standardmäßig in PTC Navigate

enthalten.

Fahren Sie mit dem Schritt fort, in dem Benutzer erstellt und diesen Gruppenhinzugefügt werden, oder löschen Sie diese Gruppen, falls sie an IhremStandort nicht relevant sind.

4. Damit neue Gruppen als Rollen auf Anpassungsseiten angezeigt werden,bearbeiten Sie jede Gruppe, indem Sie das folgende Tag hinzufügen:PLMAppsRolesTag unter AccessAppTags.

HinweisWenn das Tag PLMAppsRolesTag von einer Gruppe entfernt wird, wirddie Rolle auf allgemeinen auf Seite 41 und App-spezifischen auf Seite 46Anpassungsseiten nicht angezeigt.

5. Erstellen Sie Benutzer, und fügen Sie sie als Mitglieder in jeder Gruppe hinzu.Beachten Sie diese wichtigen Überlegungen:

• Benutzer müssen einer Gruppe zugewiesen werden, damit sie PTCNavigate Apps sehen können.

• Wenn eine Gruppe gelöscht wird, sehen die dieser Gruppe zugewiesenenBenutzer eine leere Seite ohne PTC Navigate Apps.

• Wenn Sie entscheiden, dass eine Gruppe für PTC Navigate nicht längerrelevant ist, führen Sie die folgenden Schritte aus:

a. Verwenden Sie in PTC Navigate die Optionen auf den allgemeinen aufSeite 41 Anpassungsseiten, um alle Apps für die Gruppe auszublenden.


b. Entfernen Sie in ThingWorx Composer das PLMAppsRolesTag vonder Gruppe.

HinweisWenn das Tag PLMAppsRolesTag von einer Gruppe entfernt wird,bevor Sie die Apps auf den allgemeinen auf Seite 41 Anpassungsseitenausblenden, bleiben die Apps für die Benutzer der Gruppe sichtbar.

• Fügen Sie Benutzer nur einer ThingWorx Benutzergruppe hinzu (außer zurgenerischen Gruppe "Benutzer"). Andernfalls funktioniert dierollenbasierte App-Sichtbarkeit nicht wie erwartet.

HinweisEinmalanmeldung muss konfiguriert sein; für andere alsProduktionskonfigurationen muss der Benutzer in Windchill vorhanden seinund Zugriff auf die Produkte haben, die über die PTC Navigate Appdurchsucht werden.

Berechtigungen für das SchulungsmenüDie in der oberen rechten Ecke des PTC Navigate Bildschirms verfügbarenSchulungsmenüoptionen werden durch Berechtigungen für die folgende Entitätverwaltet: PTC.AccessApp.TrainingMenu.

Standardmäßig verfügt die ThingWorx Gruppe "Benutzer" über dieLaufzeitberechtigungen "Lesen" und "Ausführen" für diese Entität. Wenn dieBerechtigungen entfernt werden, wird das Schulungsmenü für Benutzer, die keineAdministratoren sind, nicht angezeigt.


Einmalanmeldung überprüfenWindchill und ThingWorx müssen sich über den Namen des Administrators einigsein. Betrachten Sie die folgenden Optionen:• Wenn Sie keine Änderungen in Windchill vorgenommen haben, wurde bei der

Installation von Windchill ein Administratorbenutzer namens "Administrator"erstellt. Unter Verwendung eines für Einmalanmeldung konfiguriertenThingWorx Systems können Sie sich als dieser Benutzer authentifizieren undhaben volle Zugriffsrechte als Administrator in ThingWorx.

• Wenn Sie Windchill geändert haben und kein Benutzer namens"Administrator" vorhanden ist, müssen Sie sich für einen Benutzernamenentscheiden, der sowohl in Windchill als auch in ThingWorx existiert, unddiesen Benutzer zu ThingWorx und zur Benutzergruppe "Administratoren"hinzufügen.

Um die Konfiguration der Einmalanmeldung zu überprüfen, navigieren Sie ineinem Browser zur ThingWorx URL. Der Browser wird zur Authentifizierung zuWindchill weitergeleitet. Geben Sie die Windchill Anmeldeinformationen für denAdministrator an (oder für einen anderen Benutzer, der als ThingWorxAdministrator konfiguriert ist). Der Browser wird zurück zu ThingWorx geleitet,und ThingWorx Composer wird geöffnet. Überprüfen Sie, ob Sie ThingWorx nunals dieser Benutzer ausführen. Hierdurch wird die ordnungsgemäße Konfigurationdes Einmalanmeldung überprüft.Wenn Sie festgelegt haben, dass der Authentifikator Benutzer automatischerstellen soll, testen Sie dies als Nächstes. Um dies zu überprüfen, navigieren Siein einem Browser zur ThingWorx URL. Sie werden zur Authentifizierung zuWindchill weitergeleitet. Geben Sie die Windchill Anmeldeinformationen einesBenutzers an, der in ThingWorx nicht vorhanden ist. Der Browser wird zurück zuThingWorx geleitet, und zwar auf die als Start-Mashup angegebene Seite.Überprüfen Sie, ob Sie ThingWorx nun als richtiger Benutzer ausführen.

Dingkonfigurationen bearbeitenFühren Sie die folgenden Schritte aus, um die Konfiguration von ptc-windchill-demo-thing für PTC Navigate zu bearbeiten.

1. Navigieren Sie in ThingWorx Composer zu ptc-windchill-demo-thing.2. Wählen Sie unter ENTITÄTSINFORMATIONEN den Eintrag Konfiguration aus.3. Geben Sie Informationen in die folgenden Felder ein:

• baseURL: Die URL zum Windchill System. Wenn Sie eine https-URLverwenden, muss Windchill für SSL konfiguriert werden. WeitereInformationen finden Sie unter ThingWorx Einmalanmeldung beimVerbinden mit Windchill konfigurieren auf Seite 31.

• ServiceTimeout: Zeitspanne in Millisekunden, die bei Aufrufen anWindchill auf eine Antwort gewartet wird, bevor ein Timeout eintritt.Wenn die App-Suche keine Ergebnisse zurückgibt, kann das Problem


möglicherweise durch eine Erhöhung der Zeitspanne in diesem Feld gelöstwerden.

• restPath: Bearbeiten Sie dieses Feld nicht.

Die restlichen Felder werden nicht verwendet.4. Klicken Sie auf Speichern.

PTC Navigate View PLM App ExtensionanpassenAdministratoren können die Anzeige und Funktion von Apps ändern, die mit PTCNavigate View PLM App Extension bereitgestellt werden.Mithilfe allgemeiner Anpassungsseiten auf Seite 41 können Änderungen für eineSammlung von Apps vorgenommen werden, z.B. für alle teilebezogenen oder alledokumentbezogenen Apps. Klicken Sie auf das Symbol "Sammlung bearbeiten"

auf der Startseite.Einige Anpassungsoptionen stehen für einzelne Apps zur Verfügung, wie unterAnpassungen für bestimmte Apps durchführen auf Seite 46 beschrieben. Klicken

Sie auf das Symbol "Bearbeiten" für einzelne Apps auf der Startseite.Die Startseite steht unter der folgenden URL zur Verfügung: http://<Host>:<Port>/Thingworx/Runtime/index.html#master=PTC.AccessApp.Master&mashup=LandingPageAccessAppMashup

Erweiterte Anpassungsfunktionen, z.B. das Ändern von Eigenschaften und dasHinzufügen eines neuen Lebenszyklusstatus, werden unter Erweiterte App-Anpassung auf Seite 47 beschrieben.

HinweisUm als PTC Navigate Administrator fungieren zu können, müssen Sie derThingWorx Gruppe "Administratoren" hinzugefügt werden. WeitereInformationen finden Sie unter ThingWorx Berechtigungen ändern auf Seite 36.


Allgemeine Anpassungen für Apps durchführenMithilfe allgemeiner Anpassungsseiten können Änderungen für eine Sammlungvon Apps vorgenommen werden, z.B. für alle teilebezogenen oder alledokumentbezogenen Apps. Wenn Sie als Administrator auf die Startseite

zugreifen, klicken Sie auf das Symbol "Sammlung bearbeiten" rechts nebender App-Sammlung auf der Startseite auf Seite 40.

Rolle auswählenDie Liste Anzupassende Rolle auswählen enthält alle in ThingWorx Composerdefinierten Gruppen. Weitere Informationen zum Hinzufügen von Rollen findenSie unter ThingWorx Berechtigungen ändern auf Seite 36.Wählen Sie eine Rolle aus, und ändern Sie dann die Anpassungsoptionen und dieApp-Sichtbarkeit so, wie für Benutzer in der Rolle gewünscht.

AnpassungsoptionenDie Optionen auf den allgemeinen Anpassungsseiten werden unten beschrieben:

• Maximale Suchergebnisse: Maximale Anzahl an Objekten, die auf derRegisterkarte ERGEBNISSE für die Suche angezeigt werden.

Wenn das Feld Nach welchem Typ soll gesucht werden? so festgelegt ist, dasssowohl nach Teilen als auch nach CAD-Dokumenten gesucht wird, gilt derGrenzwert für Suchergebnisse pro Objekttyp. Beispiel: Wenn Sie denGrenzwert auf 10 festlegen, kann die Suche 10 Teile und 10 CAD-Dokumentezurückgeben, also insgesamt 20 Objekte.

• Maximale aktuelle Suchen: Maximale Anzahl an Objekten, die auf derSuchregisterkarte AKTUELL angezeigt werden.

• Data Shape für aktuelle Suchen: In ThingWorx Composer verwendeter DataShape, mit dem die Anzeige aktueller Suchen in der App gesteuert wird.Informationen zum Bearbeiten von Data Shapes finden Sie unter Attribute füraktuelle Suchen konfigurieren auf Seite 55.

• Windchill Navigations-Link anzeigen: Bei Festlegung auf "Ja" wird ein Link InWindchill anzeigen mit den Teiledetails angezeigt.

• Nach welchem Typ soll gesucht werden?: Wählen Sie aus, ob nach Teilen und/oder CAD-Dokumenten gesucht werden soll.

(Für die Dokument-App nicht verfügbar.)


• Teilweise Übereinstimmungen zurückgeben?: Hiermit können Sie festlegen,dass in den Suchergebnissen auch andere als exakte Übereinstimmungenzurückgegeben werden sollen.

• Nach welchem Attribut soll gesucht werden?: Wählen Sie aus, ob nachObjektnummer und oder -name gesucht werden soll.

• Suchfilter verwenden?:

Bei Festlegung auf "Nein" wird bei der Suche in den Apps der gespeicherteWindchill Standardfilter verwendet. Alternativ können Sie einen gespeichertenFilter im Feld Gespeicherter Standardfilter angeben. Weitere Informationenfinden Sie im Abschnitt unten: Optimale Vorgehensweisen für gespeicherteFilter.

(Für die Dokument-App nicht verfügbar.)

Bei Festlegung auf "Ja" wird das Feld Welcher Filter? angezeigt, in dem Sieeinen Filter auswählen können, der bei Suchen in den Apps verfügbar seinsoll.

○ Gespeicherter Filter: Wählen Sie mehrere Windchill Filter aus, die in denApps als Dropdown-Liste angezeigt werden sollen. Benutzer können ausden gespeicherten Filtern auswählen, wenn sie eine Suche durchführen.Weitere Informationen finden Sie im Abschnitt unten: OptimaleVorgehensweisen für gespeicherte Filter.

(Für die Dokument-App nicht verfügbar.)○ Gespeicherte Suche: Wählen Sie gespeicherte Windchill Suchen aus, die

in den Apps als Dropdown-Liste angezeigt werden sollen. Verwenden Siegespeicherte Suchen, die im Windchill Standortkontext verfügbar sind.Weitere Informationen finden Sie im Abschnitt unten: OptimaleVorgehensweisen für gespeicherte Suchen.

○ Neueste: Wählen Sie Lebenszyklusstatus und Ansichten aus, nach denenBenutzer ihre Suche filtern können. Sie können mehrere Optionen in derListe auswählen. Beachten Sie, dass die Suchergebnisse die neuestenIterationen aller Objektrevisionen zurückgeben. Um nur die neuesteIteration der neuesten Revision zurückgegeben, erstellen Sie einegespeicherte Suche. Weitere Informationen finden Sie im Abschnitt unten:Optimale Vorgehensweisen für gespeicherte Suchen.

○ Version: In der App-Suche wird das Feld Version angezeigt, damit Suchenauf Grundlage einer Objektversion gefiltert werden können, z.B. A.1.Außer einer Versionsnummer müssen Benutzer auch Informationen imSuchfeld eingeben.

○ Gültigkeitsdatum: Es werden ein Kalender und optional eine Liste mitAnsichtsnamen in der App-Suche angezeigt, sodass Benutzer auf Basis desGültigkeitsdatums suchen können. Beachten Sie dabei Folgendes:

◆ Wenn Sie keine Ansicht angeben, gibt die App-Suche nur Teile zurück,für die keine Ansicht angegeben ist.


◆ Wenn für ein Teil kein Gültigkeitsdatum festgelegt ist, wird es bei derSuche nicht zurückgegeben.

◆ Teile, die dem Gültigkeitsdatum entsprechen, werden in denSuchergebnissen zurückgegeben. Wenn mehrere Revisionen dasselbeGültigkeitsdatum haben, wird die neueste Revision zurückgegeben.

◆ Das Suchen auf Basis des Gültigkeitsdatums ist nur für Teileverfügbar.

Weitere Informationen finden Sie in der Windchill Hilfe zum ThemaGültigkeit. Beispielsweise Datumsgültigkeits-Konfigurationsspezifikationen auswählen.

Optimale Vorgehensweisen für gespeicherte FilterBeachten Sie bei der Verwendung gespeicherter Filter in PTC Navigate diefolgenden Informationen.• In Windchill:

○ Um einen Filter zu erstellen oder zu ändern, wechseln Sie zu einerObjektinformationsseite. Bearbeiten Sie den Filter auf der RegisterkarteStruktur nach Bedarf, und speichern Sie ihn. Notieren Sie den Namen, dader genaue Name in PTC Navigate erforderlich ist.

○ Stellen Sie sicher, dass die Filter auf Gemeinsam nutzen festgelegt sind.• In PTC Navigate:

○ Konfigurationsspezifikationsfilter wirken sich auf die Suchergebnisse ausund lösen Teilestrukturen. Andere Filter wie Attribut- oder räumlicheFilter lösen Teilestrukturen, werden aber in den Suchergebnisse nichtangewendet.

○ Geben Sie den Filternamen genau so ein, wie er in Windchill angezeigtwird. Vorzugsweise sollten Sie den Namen kopieren und einfügen.

○ Wenn Sie mehrere Filternamen eingeben, trennen Sie diese mit einemvertikalen Balken (|), nicht mit Leerzeichen.

Optimale Vorgehensweisen für gespeicherte SuchenBeachten Sie bei der Verwendung gespeicherter Suchen in PTC Navigate diefolgenden Informationen.• Um Probleme mit der Zugriffssteuerung zu vermeiden, verwenden Sie

gespeicherte Suchen aus dem Windchill Standortkontext. Andere Kontextewie Produkte oder Bibliotheken könnten den Benutzerzugriff auf diegespeicherte Suche einschränken.

• Wenn der Windchill Server so konfiguriert ist, dass Dokumentinhalte mit Solrindexiert werden, geben gespeicherte Suchen Ergebnisse zurück, dieindexierten Dokumentinhalten entsprechen.

• PTC Navigate Apps und einige Anpassungsoptionen filtern die Ergebnisseeiner gespeicherten Suche.


http://support.ptc.com/cs/help/windchill_hc/wc102_hc/index.jspx?id=PMConfigSpecEffectivityDate&action=show

http://support.ptc.com/cs/help/windchill_hc/wc102_hc/index.jspx?id=PMConfigSpecEffectivityDate&action=show

○ Wenn Sie einen Suchbegriff in einer PTC Navigate App-Suche eingeben,wird der Suchbegriff in der gespeicherten Suche überschrieben.

○ Gespeicherte Suchen funktionieren mit Nach welchem Typ soll gesuchtwerden? und Maximale Suchergebnisse, die anderen Optionen auf derallgemeinen Anpassungsseite werden allerdings nicht berücksichtigt.◆ Beispielsweise gibt die App Dokument anzeigen nur Dokumente

zurück, auch wenn die gespeicherte Suche zusätzliche Objekttypeneinschließt. Ein anderes Beispiel: Wenn das Feld Nach welchem Typsoll gesucht werden? auf der Anpassungsseite nur auf Teile festgelegtist, werden keine CAD-Dokumente zurückgegeben, selbst wenn sie inder gespeicherten Suche eingeschlossen sind.

◆ Die Anpassungsoption Maximale Suchergebnisse schränkt dieErgebnisse einer gespeicherten Suche ein. Legen Sie einen Grenzwertfest, der höher als das Ergebnis einer gespeicherten Suchabfrage ist,um sicherzustellen, dass alle Objekte zurückgegeben werden.

Als optimale Vorgehensweise wird die Erstellung gespeicherter Suchenempfohlen, die für den Objekttyp der einzelnen Apps spezifisch sind.Bei einer Suche nach mehreren Objekttypen ist die unter MaximaleSuchergebnisse definierte Anzahl schnell erreicht; dies kann dazuführen, dass weniger Suchergebnisse des gewünschten Objekttypszurückgegeben werden.

• Um nur nach der neuesten Revision eines Objekts zu suchen, verwenden Sieeine der folgenden Methoden:○ Erstellen Sie eine gespeicherte Suche in Windchill, die für Revision die

Option Neueste angibt. Sie können auch einen Lebenszyklusstatus für diegespeicherte Suche festlegen, um z.B. nur die neuesten freigegebenenRevisionen zurückzugeben, wie im folgenden Beispiel dargestellt.



○ Legen Sie die Windchill Einstellung Suche nach neuester Version auf Jafest.

Welche Apps sollen angezeigt werden?Verwenden Sie die Umschaltflächen oberhalb der einzelnen App-Symbole, um zubestimmen, welche Apps für die im Feld Anzupassende Rolle auswählenangegebene Rolle verfügbar sind.

HinweisDer Abschnitt Welche Apps sollen angezeigt werden? wird nicht angezeigt,wenn im Feld Anzupassende Rolle auswählen die Rolle "Administratoren"ausgewählt ist, da Administratoren alle Apps zur Verfügung stehen.

Anpassungen für bestimmte Apps durchführenOptionen, die nur für bestimmte Apps gelten, stehen auf den App-spezifischenAnpassungsseiten zur Verfügung. Wenn Sie als Administrator auf die PTCNavigate Startseite auf Seite 40 zugreifen, klicken Sie auf das Symbol

"Bearbeiten" in der rechten oberen Ecke der App.

Rolle auswählenDie Liste Anzupassende Rolle auswählen wird am oberen Rand aller App-spezifischen Anpassungsseiten angezeigt. Hierin werden alle in ThingWorxComposer definierten Gruppen aufgeführt. Weitere Informationen zumHinzufügen von Rollen finden Sie unter ThingWorx Berechtigungen ändern aufSeite 36. Wählen Sie eine Rolle aus, und ändern Sie dann die Anpassungsoptionenso, wie für Benutzer in der Rolle gewünscht.


Anpassungsoptionen• Attributanzeige ändern:

○ Anzuzeigende Attribute auswählen: Verfügbar für Teileliste anzeigen.Wählen Sie die Attribute, die in der Tabelle “Teileliste“ angezeigt werden,aus und ordnen Sie sie um.

Wird das Attribut Konstruktionsdateien angezeigt, können Sie im FeldWelche Konstruktionsdateibeziehungen sollen angezeigt werden?auswählen, welche Konstruktionsdateibeziehungen angezeigt werdensollen.

◆ Beschrieben von: Versionsspezifische Beziehung von Teilen undDokumenten. Für einige Produktdokumentationen wird eine Versioneines Teils durch eine einzige Version des Dokuments beschrieben.

Nicht für CAD-Dokumente.◆ Referenzdokumente: Versionsunabhängige Beziehung von Teilen und

Dokumenten. Für einige Produktdokumentationen muss die zuletztveröffentlichte Version des Dokuments mit dem Teil verbunden sein.

Nicht für CAD-Dokumente.◆ Anhang: Anhänge werden am besten dann verwendet, wenn Inhalt

direkt mit dem Hauptinhalt korreliert oder von ihm abgeleitet wird.Beispielsweise eine Bilddatei, die aus einer technischen Illustrationgeneriert wird. Oder auch, wenn Sie keine Revisionskontrolle, keineWorkflowprozesse oder keine benutzerdefiniertenZugriffssteuerungseinstellungen für den Inhalt benötigen.

◆ Darstellung: Darstellungen werden CAD-Dokumenten oder Teilenzugeordnet, wenn ein CAD-Dokument zur Publizierung eingereichtwird.

○ Data Shape: Listet den Data Shape auf, der in ThingWorx Composer zurSteuerung der Anzeige von Attributen in der App verwendet wird.Informationen zum Bearbeiten von Data Shapes finden Sie unter WindchillAttribute als App-Eigenschaften konfigurieren auf Seite 49.

• Formatfelder: Hinweistext ist auf den PTC Navigate Anpassungsseitenverfügbar und dient der Beschreibung der erforderlichen Informationen für dieDateiformatfelder der einzelnen Apps.

Erweiterte App-AnpassungWenn PTC Navigate an Ihrem Standort über die Optionen hinaus angepasstwerden soll, die auf den allgemeinen auf Seite 41 und App-spezifischen auf Seite46 Anpassungsseiten verfügbar sind, müssen Administratoren ThingWorxComposer verwenden, um die Apps zu konfigurieren. Erfahrung mit ThingWorxComposer wird empfohlen. In den folgenden Abschnitten werden einigeallgemeine erweiterte Anpassungsoptionen erläutert.


Zusätzliche Anpassungsdokumentation ist in der Referenzdokumentationverfügbar. Weitere Informationen finden Sie unter Erweiterte Anpassung auf Seite74.

App-EntitätsinformationenFür erweiterte Anpassungskonfigurationen sind die ThingWorxEntitätsinformationen für die Apps erforderlich.

App Mashup Data Shape Data Shape-Widget

Teileeigenschaftenanzeigen

PartPropertiesAc-cessAppMashup

Example1PartPro-pertiesAccessApp-DataShape

PartProperties

Teileliste anzeigen PartListAcces-sAppMashup

Example1PartsLis-tAccessAppDataS-hape

PartsList

Teilestrukturanzeigen

PartStructureAc-cessAppMashup

Ex1PartStructure-AccessAppDataS-hape

PartStructure

Dokumentanzeigen

DocumentAcces-sAppMashup

Example1Docu-mentAccessApp-DataShape

DocumentDetails

Eigenschaftenbeschriftungen für Standardattribute ändernUm die Attributbeschriftungen zu ändern, die standardmäßig in PTC Navigateenthalten sind, gehen Sie wie folgt vor. Informationen zum Ändern vonBeschriftungen für die an Ihrem Standort erstellten benutzerdefinierten Attributefinden Sie unter Eigenschaftenbeschriftungen für standortspezifische Attributeändern auf Seite 53.

1. Wählen Sie in ThingWorx Composer SYSTEM ▶▶ Lokalisierungstabellen aus.2. Für englische Beschriftungen wählen Sie die Lokalisierungstabelle Standard

aus, und bearbeiten Sie sie. Andernfalls wählen Sie die Lokalisierungstabellefür die Sprache aus, die Sie ändern möchten.

3. Suchen Sie die Beschriftung, und bearbeiten Sie den Text in der Spalte DieseSprache. Beispielsweise können Sie Letzte Änderung in Zuletztaktualisiert ändern.


4. Speichern Sie die Änderungen.

Windchill Attribute als App-Eigenschaften konfigurierenUm in der App angezeigte Windchill Attribute hinzuzufügen oder zu entfernen,gehen Sie wie folgt vor.Informationen zu anderen als Windchill Attributen finden Sie unter Andere alsWindchill Attribute als Eigenschaften von Navigate Apps konfigurieren auf Seite57.

HinweisBeachten Sie beim Konfigurieren von App-Eigenschaften die folgendenInformationen:

• Sie können die Eigenschaften hinzufügen oder entfernen, die vom App-Data Shape angezeigt werden. Die Standardattribute, die am oberen Randvon App-Seiten angezeigt werden, können nicht entfernt werden: Nummer,Name, Version und Lebenszyklusstatus. Sie können denBeschriftungsnamen für die Standardattribute ändern. WeitereInformationen finden Sie unter Eigenschaftenbeschriftungen fürStandardattribute ändern auf Seite 48.

• Für Teile-Apps verwenden Sie Attribute für Teil, Teil-Master oderTeileverwendungstypen.

In diesem Verfahren wird die App Teileliste anzeigen als Beispiel verwendet.1. Identifizieren Sie im Dienstprogramm Windchill Typ- und Attributverwaltung

den Anzeigenamen sowie den internen Namen für das Attribut, das in der Appangezeigt werden soll. Beide Angaben sind in den nachfolgenden Schrittenerforderlich. Einige Beispiele:• Wenn Sie Geändert von hinzufügen möchten, so ist Geändert von der

Anzeigename und iterationInfo.modifier der interne Name.• mySoftAttribute ist ein Beispiel für ein an Ihrem Standort

eindeutiges Attribut. Der Anzeigename und der interne Name sind gleich.


In diesem Beispiel wird mySoftAttribute verwendet.

2. Fügen Sie in ThingWorx Composer das Windchill Attribut als Felddefinitionin den erforderlichen Data Shapes hinzu.a. Wenn das Attribut an Ihrem Standort eindeutig ist, d.h., es ist nicht

standardmäßig in Windchill enthalten, fügen Sie es zu PTC.Resource.PLM.PartDataShape hinzu.i. Wählen Sie unter Entitätsinformationen den Eintrag Felddefinitionen

aus. Klicken Sie dann auf Hinzufügen.ii. Ein Fensterbereich Neues Feld wird angezeigt.

• Geben Sie unter Name den Anzeigenamen des Attributs ein.• Wählen Sie unter Basistyp die dem Attribut zugeordnete Option

aus.iii. Klicken Sie auf Fertig.

b. Fügen Sie das Attribut dem auf der App-spezifischen Anpassungsseite aufSeite 46 identifizierten Data Shape hinzu, z.B.Example1PartListAccessAppDataShape.


i. Wählen Sie unter Entitätsinformationen den Eintrag Felddefinitionenaus, und klicken Sie auf Hinzufügen.

ii. Ein Fensterbereich Neues Feld wird angezeigt.• Geben Sie unter Name den Anzeigenamen ein.• Wählen Sie unter Basistyp die dem Attribut zugeordnete Option

aus. Wenn Sie z.B. Menge eingeben, wählen Sie Nummer alsBasistyp aus.

iii. Klicken Sie auf Fertig.

TippWenn Sie eine andere Eigenschaftenbeschriftung als den in diesemVerfahren eingegebenen internen Namen verwenden möchten, lesenSie die Anweisungen unter Eigenschaftenbeschriftungen fürstandortspezifische Attribute ändern auf Seite 53.

3. Öffnen Sie in ThingWorx Composer das der App zugeordnete Mashup.Weitere Informationen finden Sie unter App-Entitätsinformationen auf Seite48.

Öffnen Sie für dieses Beispiel mit der App Teileliste anzeigen das MashupPartsListAccessAppMashup.

4. Wählen Sie das Widget DynamicColumnGrid aus, das die Anzeige für dieTabelle Teileliste in der App Teileliste anzeigen ändert.a. Aktualisieren Sie das Widget Raster mit den folgenden Schritten:

i. Löschen Sie die Bindung zwischen dem Widget DynamicColumnGridund dem Dienst GetleaftnodeDecendants, indem Sie auf das rote x-Symbol neben Daten klicken.

ii. Binden Sie das Widget DynamicColumnGrid und den DienstGetleaftnodeDecendants erneut, indem Sie Daten auswählen undmithilfe von Ziehen-und-Ablegen in das Widget DynamicColumnGridbewegen.

b. Wählen Sie Rasterspalten konfigurieren aus.c. Wählen Sie das Attribut mySoftAttribute in der Liste verfügbarer

Attribute aus, und führen Sie die folgenden Schritte nach Bedarf durch.


i. Ändern Sie durch Ziehen-und-Ablegen von Spalten die Reihenfolgeder Attribute.

ii. Erstellen Sie ein Lokalisierungs-Token, oder fügen Sie eins hinzu.iii. Geben Sie ein Format für die Daten an.

d. Vergewissern Sie sich, dass der Rest der ausgewählten Attribute mit denFelddefinitionen im Data Shape übereinstimmt und wie im vorherigenSchritt beschrieben konfiguriert ist.

5. Fügen Sie den internen Namen und den Anzeigenamen des Attributs demerforderlichen Ding hinzu, indem Sie die folgenden Schritte ausführen:a. Für Teileattribute bearbeiten Sie das Ding

WindchillDemoPartResourceProvider.

Für Dokumentattribute bearbeiten Sie das DingWindchillDocumentResourceProvider.

b. Wählen Sie Konfiguration aus, und fügen Sie das Attribut hinzu.• Normalisiert: Geben Sie den Anzeigenamen des Attributs ein.• Original: Geben Sie den internen Namen ein.

Wenn ein lokalisierter Wert angezeigt werden soll und das Attribut neuist, überprüfen Sie zuerst, wie der Attributwert in der App angezeigtwird. Für einige Attribute wird automatisch der lokalisierte Wertangezeigt.

Wenn der lokalisierte Wert nicht automatisch angezeigt wird, fügen Sie.displayValue am Ende des Werts im Feld Original hinzu.

6. Speichern Sie alle Änderungen.


Eigenschaftenbeschriftungen für standortspezifischeAttribute ändernDieses Verfahren beschreibt, wie der Text eines benutzerdefinierten Attributsgeändert wird, das von Ihrem Standort zu PTC Navigate hinzugefügt wurde.Informationen zum Ändern von Beschriftungen für die in PTC Navigateenthaltenen Standardattribute finden Sie unter Eigenschaftenbeschriftungen fürStandardattribute ändern auf Seite 48.1. Notieren Sie in App-Entitätsinformationen auf Seite 48 den Namen für das

Mashup und das Widget, die von der zu ändernden App verwendet werden.

In diesem Verfahren wird die App Teileliste anzeigen als Beispiel verwendet.2. Suchen Sie in ThingWorx Composer nach dem Mashup, z.B.

"PartsListAccessAppMashup".

3. Bearbeiten Sie das Mashup, und klicken Sie auf die Registerkarte Workspace.a. Navigieren Sie zu dem der App zugeordneten Widget, z.B. "PartList".b. Wählen Sie im Dropdown-Menü mit Aktionen für das Raster-Widget die

Option Rasterspalten konfigurieren aus.


4. Aktivieren Sie im Fenster Widget konfigurieren das Kontrollkästchen für dieEigenschaftenbeschriftung, die Sie ändern möchten. Wählen Sie für diesesBeispiel "LastModified" aus.

5. Klicken Sie auf das Zauberstabsymbol neben dem Spaltentitel.

TippWenn das Zauberstabsymbol nicht angezeigt wird, wurde dasLokalisierungs-Token für die Eigenschaft bereits festgelegt. Um das Tokenzu ändern, klicken Sie zum Löschen auf das "x". Das Zauberstabsymbolwird angezeigt.

6. Klicken Sie auf Lokalisierungs-Token.


7. Geben Sie im Fenster Neues Lokalisierungs-Token die folgendenInformationen ein:• Token-Name: Interner Platzhalter für Zeichenfolgen, die zur Laufzeit zur

Lokalisierung ersetzt werden.• Zeichenfolgenwert: Beschriftung, die in der App angezeigt wird.

8. Klicken Sie auf Lokalisierungs-Token hinzufügen.9. Speichern Sie das Mashup.Weitere Informationen finden Sie unter Beschriftungen und Feldern in einerAnwendung lokalisieren auf Seite 78.

Attribute für aktuelle Suchen konfigurierenUm die Attribute zu ändern, die für Elemente auf der Registerkarte AKTUELLangezeigt werden, gehen Sie wie folgt vor.


Neue Attribute hinzufügen1. Bearbeiten Sie den Data Shape "Aktuelle Suchen", um das Attribut

hinzuzufügen:

• Für Teileattribute bearbeiten Sie WindchillDemoRecentSearchesPerUser.• Für Dokumentattribute bearbeiten Sie DocumentRecentSearchesPerUser.

2. Bearbeiten Sie den Data Shape "Ressource", um das Attribut hinzuzufügen:

• Für Teileattribute bearbeiten Sie PTC.Resource.PLM.PartDataShape.• Für Dokumentattribute bearbeiten Sie PTC.Resource.PLM.

DocumentTemplateDataShape.3. Wenn der interne Name und der Anzeigename verschieden sind, bearbeiten

Sie das Ressourcen-Anbieter-Ding, um das Attribut hinzuzufügen:

a. Für Teileattribute bearbeiten Sie das DingWindchillDemoPartResourceProvider.

Für Dokumentattribute bearbeiten Sie das DingWindchillDocumentResourceProvider.

b. Wählen Sie Konfiguration aus, und fügen Sie das Attribut hinzu.

• Normalisiert: Geben Sie den Anzeigenamen des Attributs ein.• Original: Geben Sie den internen Namen ein.

4. Bearbeiten Sie RecentItemTileAccessAppMashup.

a. Fügen Sie das Widget Wertanzeige zur Schaltfläche hinzu.b. Wählen Sie in der Dropdown-Liste des neu hinzugefügten Widgets

Bindungen konfigurieren aus.c. Klicken Sie im Fenster Widget konfigurieren auf Bindende Quellen.d. Wählen Sie im Fenster Datenbindung hinzufügen das neue Attribut aus,

das Sie in den vorherigen Schritten hinzugefügt haben.e. Klicken Sie auf Fertig.

5. Überprüfen Sie, ob die Attribute wie erwartet angezeigt werden. In derBildschirmabbildung unten besteht z.B. eine Bindung zwischen ValueDisplayund LastModified.


Attribute entfernen1. Bearbeiten Sie RecentItemTileAccessAppMashup.2. Entfernen Sie die Bindung für das Widget Wertanzeige.3. Speichern Sie die Änderungen.

Andere als Windchill Attribute als Eigenschaften vonNavigate Apps konfigurierenIn diesem Abschnitt wird beschrieben, wie Sie die in PTC Navigate Appsangezeigten Daten mit Daten aus einem anderen Unternehmenssystem ergänzen.Beispielsweise können Felder aus einem ERP- oder MES-System zu PTCNavigate Apps hinzugefügt werden, um die Windchill Daten neben Daten ausdiesen anderen Systemen anzuzeigen.Im folgenden Beispiel wird ERPDemoPartResourceProvider verwendet.Führen Sie die in den folgenden Abschnitten beschriebenen Schritte aus:1. Data Shapes aktualisieren2. Zugehörige Mashups aktualisieren3. Composite Provider konfigurieren


Data Shapes aktualisieren1. Aktualisieren Sie PTC.Resource.PLM.PartDataShape, um neue Datenattribute

hinzuzufügen, die von den sekundären Ressourcen-Anbietern beigetragenwerden. In diesem Beispiel ist ERPDemoPartResourceProvider derRessourcen-Anbieter, und die folgenden neuen Attribute werden hinzugefügt:InProcess, MaterialCost, InStock, Supplier.

2. Damit in den Apps die Attribute des zweiten Ressourcen-Anbieters angezeigtwerden, aktualisieren Sie die Data Shapes, um Felder hinzuzufügen. EineListe der Data Shapes für die einzelnen Apps finden Sie in App-Entitätsinformationen auf Seite 48.

Im folgenden Beispiel werden diese Felder zuEx1PartStructureAccessAppDataShape hinzugefügt: InProcess, MaterialCost,InStock, Supplier.


Zugehörige Mashups aktualisierenPTC Navigate nutzt die Widget-Konfiguration, um die neuen Attribute in der Appsichtbar zu machen.

1. Bearbeiten Sie PartPropertiesAccessAppMashup.

a. Aktualisieren Sie das Widget WEITERE ATTRIBUTE mithilfe der folgendenSchritte:

i. Löschen Sie die Bindung zwischen dem WidgetDynamicPropertyDisplay und dem Dienst GetPartProperties, indem Sieauf das rote x-Symbol neben Daten klicken.

ii. Binden Sie das Widget DynamicPropertyDisplay und den DienstGetPartProperties erneut, indem Sie Daten auswählen und mithilfe vonZiehen-und-Ablegen in das Widget DynamicPropertyDisplay bewegen.


b. Klicken Sie auf den Dropdown-Pfeil von WEITERE ATTRIBUTE, undwählen Sie Widget konfigurieren aus.

c. Wählen Sie im Fenster Widget konfigurieren die Attribute vonERPDemoPartResourceProvider aus, die in der App sichtbar seinsollen.

d. Klicken Sie auf Fertig, und speichern Sie das Mashup.e. Ein bekanntes Problem in dieser Version besteht darin, dass nach einer

erneuten Bindung des Widgets DynamicPropertyDisplay und des DienstsGetPartProperties die Lokalisierungs-Token in allen Widget-Spaltenverloren gehen. Weisen Sie die einzelnen Lokalisierungs-Token im FensterWidget konfigurieren anhand der Informationen in der folgenden Tabellezu. Weitere Informationen finden Sie unter Beschriftungen und Feldern ineiner Anwendung lokalisieren auf Seite 78.

Spaltenname Lokalisierungs-Token fürSpaltentitel

Zuletzt geändert von PTC.AccessApp.LastModifiedByBeschreibung PTC.AccessApp.DescriptionEinheit PTC.AccessApp.UnitName PTC.AccessApp.NameErstellt PTC.AccessApp.CreatedLetzte Änderung PTC.AccessApp.LastModified


Spaltenname Lokalisierungs-Token fürSpaltentitel

Nummer PTC.AccessApp.NumberVersion PTC.AccessApp.VersionMenge PTC.AccessApp.QuantityAnsichtsname PTC.AccessApp.ViewNameLebenszyklusstatus PTC.AccessApp.StateVerwendungsname PTC.AccessApp.UsageName

2. Bearbeiten Sie PartsListAccessAppMashup.

a. Wählen Sie das Widget PartsList aus, klicken Sie auf den Dropdown-Pfeil,und wählen Sie Rasterspalten konfigurieren aus.

b. Wählen Sie im Fenster Widget konfigurieren die Attribute vonERPDemoPartResourceProvider aus, die in der App sichtbar seinsollen.

c. Klicken Sie auf Fertig, und speichern Sie das Mashup.3. Bearbeiten Sie PartStructureAccessAppMashup.

a. Wählen Sie das Widget TEILESTRUKTUR aus, klicken Sie auf denDropdown-Pfeil, und wählen Sie Configure Tree Table Columns aus.

b. Wählen Sie im Fenster Widget konfigurieren die Attribute vonERPDemoPartResourceProvider aus, die in der App sichtbar seinsollen.

c. Klicken Sie auf Fertig, und speichern Sie das Mashup.

Composite Provider konfigurierenDie Option Composite Provider verwenden ist auf den App-Anpassungsseitenstandardmäßig ausgeblendet. Ein Administrator muss auf diese Option zugreifenkönnen, damit die Attribute aus ERPDemoPartResourceProvider in derApp angezeigt werden.


1. Wählen Sie in jedem der folgenden Mashups die Beschriftung CompositeProvider verwenden aus, und aktivieren Sie in der linken unteren Ecke desBildschirms das Kontrollkästchen Sichtbar.

• PartPropertiesTailoringContainedMashup

• PartsListTailoringContainedMashup

• PartStructureTailoringContainedMashup

2. Wechseln Sie zur Anpassungsseite für eine beliebige der betroffenen Apps,und aktivieren Sie das Kontrollkästchen Composite Provider verwenden.

• Teileeigenschaften anzeigen

• Teileliste anzeigen

• Teilestruktur anzeigen


4PTC Navigate View ALM App

ExtensionPTC Navigate View ALM App Extension Product Overview ..........................................64Voraussetzungen für PTC Navigate View ALM App Extension .....................................64Importing the PTC Navigate View ALM App Extension .................................................65Configuring PTC Navigate View ALM App Extension....................................................66Tailoring PTC Navigate View Requirements App..........................................................69Known Limitations in PTC Navigate View Requirements App........................................70

The View Requirements app, a PTC ALM app enables you to view various typesof Integrity documents. A case insensitive text search and the ability to configuremetadata is also provided with this app.

63

PTC Navigate View ALM App ExtensionProduct OverviewPTC Navigate View ALM App Extension provides an app that allows users toquickly and easily access specific information stored in PTC Integrity LifecycleManager. The View Requirements app is available with this release.

This app provides a search field in which you enter document ID of the documentyou want to view. The document type that can be viewed in the app can bemodified through app tailoring. For more information, see Tailoring PTC NavigateView Requirements App auf Seite 69.This landing page is a ThingWorx mashup available at the following URL:http://<host>:<port>/Thingworx/Runtime/index.html#master=PTC.AccessApp.Master&mashup=LandingPageAccessAppMashup

Optimale VorgehensweisePTC Navigate apps were designed for a screen resolution of 1280x1024.Results on other resolutions may vary.

Voraussetzungen für PTC Navigate ViewALM App ExtensionDer Abschnitt bietet Details zur Produktunterstützung für PTC Navigate ViewALM App Extension:• Integrity 10.8 oder höher• Informationen zur Unterstützung weiterer Plattformen finden Sie unter

Voraussetzungen für PTC Navigate 1.4 auf Seite 10.


Importing the PTC Navigate View ALMApp ExtensionTo install the extensions included with the PTC Navigate View ALM AppExtension, complete the following steps:1. Download the PTCNavigateViewALMAppextension.zip file from the PTC Smart

Connected Applications section of the PTC Software Downloads page andunzip the contents to a folder on your machine.

2. From ThingWorx Composer, navigate to Import/Export ▶▶ Import:

3. In the Import Extensions window, navigate to TWX_Integrity_ILM_Connector_ExtensionPackage.zip.

HinweisThis release of PTC Navigate View Requirements 1.1 is compatible onlywith ILM Connector Extension 2.0, which is a part of the installationpackage of this release.

Before you import this extension, ensure that you uninstall previousversions of PTC Navigate View ALM App Extension and ILM ConnectorExtension.

If the PTC Integrity Extension for ThingWorx needs to be imported, it isrecommended to be done on a separate ThingWorx installation differentfrom the one used for PTC Navigate to avoid possible compatibility issues.

4. Click Import and refresh the window if prompted.

PTC Navigate View ALM App Extension 65

5. Again select Import/Export ▶▶ Import.6. Navigate to PTC_Navigate_View-ALM_App_Extension.zip and

click Import.To view the extensions after the import is complete, select Import/Export ▶▶Manage.

Configuring PTC Navigate View ALM AppExtensionThis chapter contains configuration information for ThingWorx and PTC IntegrityLifecycle Manager. The configuration steps explained here are also useful whensingle sign-on authentication is used.

Configuring ThingWorx for AuthenticationYou can sign into ThingWorx using either single sign-on authentication solutionor ThingWorx-based authentication.If you are using a single sign-on authentication solution, Windchill is used as theidentity provider for ThingWorx. Hence, to access a ThingWorx URL, youridentity must exist in ThingWorx, Windchill, and Integrity. For more information,see Configuring Single Sign-On when Connecting to Windchill auf Seite 31.In absence of single sign-on, you need to use ThingWorx-based authentication. Inthis case, your user identity must exist in both ThingWorx and Integrity. If usersare in LDAP, you must configure LDAP for authentication. For details, see thetopic Directory Services Authentication in the ThingWorx Help Center.

Configuring for ImpersonationOnce you are logged into PTC Navigate, authentication to Integrity is done byimpersonation where administrator permissions are required for impersonation. Inthis case, the Integrity Connector retrieves documents from Integrity byimpersonating the logged in ThingWorx user. Hence, the user specified in theConnector properties must have impersonation permissions in order toimpersonate the current user.Carry out the following steps using the Integrity Administration Client to provideimpersonation rights to all users:1. In Integrity Administration Client, and select Permissions ▶▶ All. A complete

tree view of all ACLs on the server is displayed.2. Select ACL ▶▶ Create ACL. The Select ACL Entries to Add window opens.3. In the ACL Name field, type mks:impersonate:group:everyone.4. From the Principal list, select Administrator.5. In the Permissions list, click the Impersonate checkbox.6. Click OK to accept the changes.


Configuring the PTC Integrity Server PropertiesCarry out the following steps in ThingWorx Composer to configure the IntegrityServer properties:1. In ThingWorx Composer, click the IntegrityServer thing.2. Under ENTITY INFORMATION, select Properties.3. Enter appropriate information in the following fields:

• port• hostname• username• password

4. Restart the Tomcat web server.

Configuring PTC Integrity Lifecycle ManagerThis configuration involves running the UpdateConnectorConfiguration service,which ensures proper display of rich text fields in the View Requirements app.You must run this service only once and the ThingWorx user executing thisservice must have administrative rights in Integrity.Complete the following steps to configure the ILM Connector:1. In the ThingWorx Composer, click the IntegrityServer thing.2. Under ENTITY INFORMATION, select Services.3. Click Test to run UpdateConnectorConfiguration service.4. Close the IntegrityServer thing.

Configuring the TimerThing for Deleting MediaEntitiesMedia entities are images or OLE objects contained within a document. When youload a document for viewing in the View Requirements app, all images and OLEobjects in the document are stored in ThingWorx.The administrator can configure the TimerThing such that all media entitiescreated while loading a document are deleted by default after a specified timeinterval. This time interval in milliseconds is set for the Update Rate field asfollows:1. In the ThingWorx Composer, under Things, click the

PTCRODocViewMediaEntityCleanUpTimerThing thing. The mashup for thething opens.

2. Under Configuration, enter a value in milliseconds in the Update Rate field.

Based on the interval in Update Rate, media entities that are created by loadinga document are deleted.

3. Click Save.


Modifying ThingWorx Run Time PermissionsConfiguring for Role-based PermissionsBy default, permissions for View Requirements app non-administrative users areset to read only. To manage user access, modify the permissions in Run Time forentities in ThingWorx.The following procedure describes the permissions to set in order to make theView Requirements app visible to a given group.

1. Create user group (treated as user role) and add specific users to this group.2. Under Run Time permission, give Property Read and Service Execute access to

each thing that corresponds to the View Requirements app for which you wantthe user to have access.

3. Set all needed permissions for entities as described in the table below. Thedescendent things and thing templates related to View Requirements appinherit the permission setting.

Entity Permission Permission TypePTCRODocViewAccessAppNavigate-Thing

Run Time Property ReadService Execute

AppCollectionsConsolidator Run Time Property ReadService Execute

PTCRODocViewAppCollectionProvider-Thing

Run Time Property ReadService Execute

Configuring the Access to Administrator TailoringTailoring options enable administrators to configure the type of content that isdisplayed while viewing a document in the View Requirements page. In order toperform this configuration, the edit icon for the app on the PTC Navigate productpage must be visible to administrators to gain access to tailoring options.Administrators can also grant permissions to user groups for accessing tailoringoptions. Once permissions are granted, all users in the group can see the edit iconfor the View Requirements app on the PTC Navigate product page.To grant permissions to user groups, the administrator must configure thePTCRODocViewAccessAppThing in ThingWorx as follows:1. In the ThingWorx Composer, under Things, click the

PTCRODocViewAccessAppThing thing. The mashup for the thing opens.2. Under Permissions, select Run Time type of permission.3. Grant Allow permissions to Property Read and Service Execute.4. In Group or User, add the required user group.5. Click Save.


Tailoring PTC Navigate ViewRequirements AppBasic App TailoringPTC Navigate provides administrators basic tailoring capabilities related to theapp display and function. When you access the landing page as an administrator,edit icons appear for the apps. This page is available at the following URL:http://<host>:<port>/Thingworx/Runtime/index.html#master=PTC.AccessApp.Master&mashup=LandingPageAccessAppMashup

An administrator can use options on the following tailoring page to customize thedisplay of document fields in the View Requirements app interface:

To customize the display in the View Requirements app page, complete thefollowing steps:


1. In the Document Type list, select the type of document you want to view from.For example, you can select a Design Document type. Selecting the documenttype is mandatory.

2. In the Document Field list, select the field that represents the main content ofyour document. For example, you can select a field that stores the designdetails in a design document.

3. Optionally, in the Sections Field list select the field that you can view in theSections view of the document.

4. Click Save Configuration to accept the changes. The saved configurations areadded to the CONFIGURATIONS table.

HinweisYou can save only a single configuration for a document type.

The columns in this table indicate the following:

• Document Type: Indicates the type of document you have selected.• Item Type: Indicates the item type node.• Document Field: Indicates the type of content that is displayed in the

Document view of the document.• Sections Field: Indicates the type of content that is displayed in the

Sections view of the document.

HinweisIf you are upgrading from PTC Navigate View ALM App Extension 1.0 toPTC Navigate View ALM App Extension 1.1, ensure that the Administratortakes note of the existing configuration table from the existing server andmanually updates it on the new server.

Removing a ConfigurationSelect the configuration you want to delete, and click Remove. The configurationis deleted from the CONFIGURATIONS table.

Known Limitations in PTC Navigate ViewRequirements AppThe following notes describe known limitations for the View Requirements app.


Entity Not Found ErrorEmbedded OLE objects are created on loading a document. These objects aredeleted through a timer-based service after every specified time interval that isdefined by an administrator. Sometimes, when viewing documents in the ViewRequirements app, you may get the error Entity Not Found : [<name of the entity>]on clicking an embedded Word document, PDF file, or an OLE object.This occurs only when you are viewing a document when OLE objects are beingdeleted in the background by a timer-based service.You can resolve this issue by reloading the page so that all the OLE objects getcreated again.

Requirement to Update Configuration TableConfigurations in the tailoring page do not get updated automatically, if youmodify the Integrity host details on IntegrityServer thing. This may lead to errorsas these configurations do not correspond to the updated server document fields.To resolve this issue update the CONFIGURATIONS table in the tailoring page sothat updated configurations map correctly to the fields that exist on the newIntegrity Server.

Non-English Locales Not SupportedCurrently, you can configure only English locale Integrity Servers with the ViewRequirements app.

Performance Issues with Large DocumentsWhen you load a document with more than 10,000 nodes, the performance of theView Requirements app is slower than expected.

Large Documents Loading Slowly with Internet Explorer 11.0When working with the View Requirements app in Internet Explorer 11.0, largedocuments may take long to load as compared to other browsers.

FVA Field Issues with Integrity ServerWhen you have a ALM solution installed Integrity Server, where the FVA fieldhas the Text attribute prefixed with ALM (For example, ALM_Text), the IntegrityServer may not work as expected in View Requirements App 1.0 version.

Table Background Color IssueThe background color of tables is not visible while viewing documents in theView Requirements app.

Non-numeric Document ID not SupportedYou cannot type a non-numeric document ID the Search field while trying toaccess documents from PTC Intehrity Lifecycle Manager.


5PTC Navigate –

ReferenzinformationenErweiterte Anpassung ...............................................................................................74Beispielkonfiguration mit SSL für sichere Kommunikation.............................................89Architektur der Einmalanmeldung...............................................................................92

Dieser Abschnitt enthält erweiterte Anpassungsinformationen, einKonfigurationsbeispiel und eine Übersicht über die Architektur derEinmalanmeldung.

73

Erweiterte AnpassungIn diesem Abschnitt werden erweiterte Anpassungsfunktionen beschrieben; errichtet sich an PTC Windchill Systemadministratoren und Anwendungsentwickler,die ThingWorx Composer zum Erstellen von ThingWorx Anwendungenverwenden, die eine Verbindung zu Windchill herstellen.Bei der Anpassung wird Folgendes vorausgesetzt:• Praktische Erfahrung mit der Windchill Instanz• Praktische Erfahrung mit ThingWorx Composer• Kenntnisse im Schreiben von Java-Skripts

Apps zur Navigate Zielseite hinzufügenIn den folgenden Abschnitten werden wichtige Komponenten, die für dasHinzufügen von Apps zur Zielseite erforderlich sind, beschrieben. Am Ende desThemas finden Sie ein Beispiel mit den auszuführenden Schritten.

Data ShapesDas Framework definiert zwei Data Shapes:

• PTC.NavigateApps.AppDataShape: Enthält die zum Identifizieren einer Appals Navigate App erforderlichen Attribute.

○ thingName: Der Name des Dings, das eine Navigate App identifiziert. Diefür dieses Ding festgelegten Berechtigungen steuern den Zugriff auf dieApp für einen bestimmten Benutzer. Hat dieser Benutzer keineZugriffsberechtigungen, wird für diesen Benutzer keine App auf derZielseite angezeigt.

○ mashup: Der Name des Mashup für die App.○ url: Die relative URL zum Starten der App. Beispiel:

index.html#mashup=CommonSearchAccessAppMashup&configEntity=Example1AccessAppConfigThing&...

○ tailoringMashup: Der Name des Anpassungs-Mashups für die App, fallsvorhanden.

○ tailoringUrl: Die relative URL, falls vorhanden. Beispiel:index.html#mashup=DrawingTailoringAccessAppMashup&accessAppConfigThingName=Example1DrawingAccessAppConfigThing&...

○ displayName: Anzeigename der App.○ appIcon: Das auf der Zielseite angezeigte Symbol für die App.

• PTC.NavigateApps.CollectionDataShape: Enthält die zum Identifizieren einerSammlung von Navigate Apps erforderlichen Attribute.

○ Eine Informationstabelle mit Apps, wobei jede Zeile eine App darstellt, diePTC.NavigateApps.AppDataShape entspricht.


○ Ein Name für die Sammlung: Der Name des Anpassungs-Mashups, fallsvorhanden.

○ Die relative URL, falls relevant für die Sammlung. Beispiel: index.html#mashup=PartAppsCollectionTailoringMashup.

○ Anzeigerang: Sammlungen werden auf der Zielseite in aufsteigenderReihenfolge des Rangs angezeigt.

DingformPTC.NavigateApps.AppCollectionProviderThingShape: Diese Dingform stellt denDienst GetAppCollections zur Verfügung. Alle App-Sammlungs-Anbieter müssendeklarieren, dass sie diese Dingform implementieren. Der Sammlungs-Konsolidator des Framework benötigt diese Deklaration, um alle Anbieter zuidentifizieren, von denen Navigate Apps-Sammlungen für die Anzeige auf derZielseite zu sammeln sind. Außerdem ist DefaultAppCollectionProvider verfügbar.Diese Klasse implementiert einen Service-Handler für den Dingform-Dienst.

Klassen, Schnittstellen• INavigateApp: Eine Schnittstelle, die von einem Navigate App-Ding

implementiert werden sollte. Dieses Ding enthält eine Definition, was eineNavigate App ist. Diese Schnittstelle ist eine Ergänzung zur Definition PTC.NavigateApps.AppDataShape und zwingt die Dinge, welche die Schnittstelleimplementieren, die für diesen Data Shape erforderlichen Attributebereitzustellen. Darüber hinaus steuern die Berechtigungen, die für die Dingefestgelegt wurden, welche die Schnittstelle implementieren, den Zugriff aufdie App für jeden Benutzer. Hat ein Benutzer keine Zugriffsberechtigungen,wird für diesen Benutzer keine App auf der Zielseite angezeigt.

• AbstractAppCollectionProvider: Eine abstrakte Klasse, die auf Dinge in einerErweiterung (App-Sammlungs-Anbieter) ausgedehnt werden sollte, die eineSammlung von INavigateApps beitragen. Diese Klasse definiert den DienstGetAppCollections, den jeder App-Sammlungs-Anbieter implementierensollte. Der Zweck dieses Dienstes ist es, eine Logik dafür zu definieren, wieeine Erweiterung eine Satz von Navigate Apps sammelt, die zu einemFramework beigetragen werden sollen. Neben der Implementierung diesesDienstes, müssen die App-Sammlungs-Anbieter deklarieren, dass sie PTC.NavigateApps.AppCollectionProviderThingShape implementieren, um denApp-Sammlungs-Konsolidator des Framework dabei zu unterstützen, dieAnbieter, welche diesen Dienst bereitstellen, zu finden.

• AppCollectionsConsolidator: Diese Klasse ist hauptsächlich dafürverantwortlich, die App-Sammlungs-Anbieter zu finden und diese um eineKonsolidierung der App-sammlungen zu ersuchen. Darüber hinaus stellt dieseKlasse den Dienstprogramm-Dienst addAppCollectionRow bereit. DieAnbieter können diesen Dienst nutzen, um einen Satz von Apps mithilfe einesSuchkriterium für Apps (TagLink) zu bündeln. Beispiel: INavigateApp Appssind als PTC.AccessApp.PartApps gekennzeichnet. In diesem Fall kannaddAppCollectionRow aufgerufen werden, indem (neben anderen Attributen)

PTC Navigate – Referenzinformationen 75

PTC.AccessApp.PartApps TagLink als Suchkriterium bereitgestellt wird.Dieses Suchkriterium wird dazu verwendet, die Apps zu sammeln sowie eineInstanz der Informationstabelle, zu der eine neue Sammlungszeile hinzugefügtwerden soll.

Das nachfolgende Beispiel erläutert die mindestens erforderlichen Schritte, dievon einer Erweiterung ausgeführt werden müssen, um Apps auf der Zielseiteanzuzeigen. Diese Schritte ermöglichen es einer Erweiterung, App-Sammlungenzu einem Framework beizutragen.

1. Fügen Sie in Ihrem Erweiterungspaket Abhängigkeit für die Artefakte TWX_Converge_Core_ExtensionPackage und PTCNavigate_FrameworkExtensionPackage hinzu. Siehe das folgende Beispiel zurErläuterung:<dependency>

<groupId>com.ptc.cpm.core</groupId><artifactId>TWX_Converge_Core_ExtensionPackage</artifactId><version>7.0.1-1133</version>

</dependency><dependency>

<groupId>com.ptc.converge.apps.access</groupId><artifactId>PTCNavigate_FrameworkExtensionPackage</artifactId><version>1.0.0-SNAPSHOT</version>

</dependency>

2. Erstellen Sie Navigate App-Dinge, welche INavigateApp implementieren.Kennzeichnen Sie diese Dinge entsprechend, um festzulegen, zu welcherSammlung diese Apps gehören. Siehe das folgende Beispiel zur Erläuterung:public class AccessAppConfig extends Thing implements INavigateApp

3. Erstellen Sie ein Navigate App-Sammlungs-Anbieter-Ding, welchesAbstractAppCollectionProvider erweitert und eineImplementierung für GetAppCollections bereitstellt. Verwenden SieDienstprogramm-Methode addAppCollectionRow inAppCollectionsConsolidator, um Apps in Sammlungen zu bündeln.Siehe das folgende Beispiel zur Erläuterung:public class MasterAccessApp extends AbstractAppCollectionProvider/* (non-Javadoc)

* @see com.ptc.converge.apps.access.AbstractAppCollectionProvider#GetAppCollections()*/@Overridepublic InfoTable GetAppCollections() throws Exception {InfoTable consolidatedAppCollections = InfoTableInstanceFactory

.createInfoTableFromDataShape("PTC.NavigateApps.CollectionDataShape");// collect part appsappCollectionConsolidator.addAppCollectionRow(consolidatedAppCollections, "Part Apps",

"index.html#mashup=PartAppsCollectionTailoringMashup","PartAppsCollectionTailoringMashup",

new TagLink(VOCAB_PTC, PART_APPS_TAG), 1);// collect doc appsappCollectionConsolidator.addAppCollectionRow(consolidatedAppCollections,

"Document Apps", null, null,new TagLink(VOCAB_PTC, DOCUMENT_APPS_TAG), 2);

return consolidatedAppCollections;}

4. Deklarieren Sie, dass das Navigate App-Sammlungs-Anbieter-Ding PTC.NavigateApps.AppCollectionProviderThingShape implementiert. VergleichenSie das nachfolgenden Beispiel für eine ThingWorx Ding-Konfiguration:


<?xml version ="1.0" encoding="UTF-8" standalone="no"?><Entities build="b456" majorVersion="6" minorVersion="0"

revision="2" schemaVersion="803"><Things>

<Thing aspect.isEditableExtensionObject="true"description="" documentationContent=" "

effectiveThingPackage="PTC.Converge.App.MasterAccessAppPackage"enabled="true" homeMashup="" identifier=""lastModifiedDate="2015-08-05T23:40:58.139-04:00"

name="MasterAccessAppThing"published="false" tags="PTC:PLM;PTC:PTC.AccessApp.Master"thingTemplate="PTC.Converge.App.MasterAccessAppTemplate" valueStream=""><ImplementedShapes>

<ImplementedShape name="PTC.NavigateApps.AppCollectionProviderThingShape"type="ThingShape" />

<ImplementedShape name="PTC.Capability.ResourceServiceProvider"type="ThingShape" />

</ImplementedShapes></Thing>

</Things></Entities>

5. Bündeln Sie PTCNavigate_FrameworkExtensionPackage.zip mitIhrer Zip-Datei für das App-Erweiterungspakets, damit beide Zip-Dateien inThingWorx importiert werden.

6. Importieren Sie das Bündel und starten Sie LandingPageAccessAppMashup,um Ihre App auf der Zielseite anzuzeigen.

EntitätsübersichtWindchill Extension enthält eine Entität namens WindchillConnector. DieseEntität ist eine Dingvorlage, die eine Schnittstelle zu einem Windchill Systemdarstellt. Sie enthält Dienste zum Zugreifen auf Windchill Daten und dieRechenleistung des Windchill Systems.Nach Abschluss von Installation und Konfiguration können Sie sich ausführlicherüber die Dingvorlage WindchillConnector informieren, indem Sie ThingWorxComposer öffnen und die Liste der Dienste anzeigen. Wie in der folgendenBildschirmabbildung dargestellt, können Sie mit der Maus auf einen Dienstzeigen, um weitere Informationen zum Dienst einzublenden.


Beschriftungen und Feldern in einer AnwendunglokalisierenThingWorx unterstützt die Lokalisierung der Laufzeit-Benutzeroberfläche IhrerThingWorx Anwendung. Sie können z.B. Elemente wie Beschriftungen undFelder lokalisieren, die Sie beim Verwenden von Windchill Extension Entitätenerstellen.Um Elemente in Entitäten zu lokalisieren, müssen Sie ein Token für jedes Elementeinschließen. Klicken Sie auf das Lokalisierungs-Umschaltersymbol, um nacheinem vorhandenen Token zu suchen und es auszuwählen oder ein neues Tokenfür ein Feld zu erstellen.

Alle Token, die Sie erstellen, werden den Lokalisierungstabellen hinzugefügt, dievon ThingWorx verwaltet werden. Indem Sie Lokalisierungstabellen erstellen undfüllen, können Sie Laufzeitelemente in verschiedenen Sprachen anzeigen.Einzelheiten zum Erstellen und Füllen von Lokalisierungstabellen finden Sie unterdem Suchbegriff "Lokalisierungstabellen" im ThingWorx Hilfe-Center. Das Hilfe-Center steht auf der PTC Hilfe-Center-Seite zur Verfügung.Weitere Informationen zum Lokalisieren von Beschriftungen finden Sie imfolgenden Lernprogrammvideo:http://youtu.be/3bo6HtXSqRAUm lokalisierten Text für zahlreiche Elemente bereitzustellen, exportieren Sie eineLokalisierungstabelle, fügen Sie lokalisierten Text zur exportierten XML-Dateihinzu, und importieren Sie die Datei.

Gespeicherte Filter zum Mashup hinzufügenIn Windchill können Sie Filter für Teile, Dokumente oder EPM-(CAD-)Dokumente erstellen und speichern. Sie können diese gespeicherten Filterverwenden, um gefilterte Strukturen in einem ThingWorx Mashup anzuzeigen.Das Erstellen und Speichern von Filtern für Teile, Dokumente oder CAD-Dokumente kann auf der entsprechenden Informationsseite des Objektsvorgenommen werden. Um gespeicherte Filter in einer ThingWorx Anwendung zuverwenden, halten Sie sich an diese optimalen Vorgehensweisen:• In einem Teilestruktur-Mashup kann ein Filter nur nach Name angegeben

werden. Stellen Sie sicher, dass alle Filter, die Sie in einer ThingWorxAnwendung verwenden möchten, eindeutige Namen aufweisen.

• In den meisten Fällen sollen gespeicherte Filter mit dem jeweiligen Objekttypverwendet werden, für den sie erstellt wurden. Stellen Sie sicher, dass dieausgewählten Filter für die Objektstruktur funktionieren, die Sie in derThingWorx Anwendung anzeigen möchten.


https://support.ptc.com/appserver/cs/help/help.jsp

http://youtu.be/3bo6HtXSqRA

PTC NavigateOptionen für Gespeicherter Filter stehen auf den App-Anpassungsseiten zurVerfügung. Weitere Informationen finden Sie im Abschnitt "AllgemeineAnpassungen für Apps durchführen".

Windchill ExtensionSie können Ihre ThingWorx Composer Anwendung so codieren, dass derBenutzer zur Eingabe des gespeicherten Filters aufgefordert wird. Beispielsweiseenthält der von PTC bereitgestellte Mashup-Beispielcode für eine Teilestruktur einDropdown-Widget neben dem Feld PLM Part Number mit einem Eintrag (Latest):

Sie können den Code für dieses Dropdown-Widget ändern, um eine beliebigeAnzahl gespeicherter Filter aufzulisten.Die Ausgabe des Diensts GetConfigurationChoices ist an die Eingabe diesesDropdown-Widgets gebunden. GetConfigurationChoices ist ein Dienst von ptc-windchill-demo-thing. Sie können das Dienstskript GetConfigurationChoicesbearbeiten, um die Elemente zu ändern, die im Dropdown-Widget angezeigtwerden, und einen oder mehrere Namen von gespeicherten Filtern einzuschließen.Bei Auswahl wird ein gespeicherter Filter an Windchill übergeben.Der Dienst GetConfigurationChoices gibt einen Infotable mit zwei Feldern zurück:• label ist der Wert, der im Dropdown-Widget angezeigt wird.• value ist der Name des gespeicherten Filters, der an Windchill übergeben

wird.

Creo View Extension verwendenCreo View Extension ist in Windchill Extension enthalten und ermöglicht esIhnen, 3D-Daten aus Windchill innerhalb einer ThingWorx Anwendung visuelldarzustellen. Creo View Extension stellt die folgenden Funktionen bereit:• Mit den Creo View 3D-Daten aus Windchill interagieren. Sie können

beispielsweise die 3D-Grafiken zoomen, schwenken und rotieren.• Ereignisse auslösen, wenn Creo View Teile ausgewählt werden.• Die Transparenz und die Farbe der Creo View Teile ändern.• Die Hintergrundfarbe des Creo View Plugins ändern.

Eigenschaften und EreignisseCreo View Extension verfügt über die folgenden Eigenschaften und Ereignisse:

• ProductToView: Diese Eigenschaft ermöglicht es Ihnen, 3D-Daten ausWindchill in Creo View Extension visuell darzustellen. Es handelt sich dabeium die URL zur Creo View Datendatei. Füllen Sie die EigenschaftProductToView, um die Daten visuell darzustellen. Windchill Beispiel-


Mashups, die in der Installation enthalten sind, veranschaulichen dieVerwendung von Beispieldiensten zum Füllen dieser Eigenschaft.

• BackgroundStyle: Diese Eigenschaft ermöglicht es Ihnen, dieHintergrundfarbe des 3D-Arbeitsbereichs von Creo View zu ändern.

• Data: Diese Eigenschaft ermöglicht es Ihnen, Creo View Teile auszuwählenund ihre Farbe und Transparenz zu ändern. Sie müssen diese Eigenschaft aneine Datentabelle binden. Die Datentabelle muss eine Spalte enthalten, die dieVorkommen-ID des Teils angibt. Dies ist die eindeutige ID des Teils in denCreo View 3D-Daten.

• DataFormatter: Mit dieser Eigenschaft können Sie Regeln angeben, dieverwendet werden müssen, um Farbe und Transparenz auf die Creo ViewTeile anzuwenden. Geben Sie eine Spalte für diese Regeln aus derDatentabelle an, die an die Eigenschaft Data gebunden ist.

• OccurrenceField: Diese Eigenschaft ermöglicht es Ihnen, die Spalteauszuwählen, die als Vorkommen-ID verwendet werden muss. Die Spalte wirdaus der Datentabelle ausgewählt, die an die Eigenschaft Data gebunden ist.

• selectedOccurrencePath: Diese Eigenschaft gibt die Vorkommen-IDdes in den 3D-Daten ausgewählten Teils an.

• selectionChanged: Dieses Ereignis gibt eine Änderung der Auswahl von3D-Daten an.

Info*Engine Aufgaben beim Entwickeln vonAnwendungen verwendenPTC enthält den allgemeinen Dienst ExecuteTask in der DingvorlageWindchillConnector. Der Dienst ExecuteTask ermöglicht es Ihnen, eine beliebigeAufgabe in der Windchill Aufgaben-Codebasis aufzurufen.• Geben Sie die aufzurufende Aufgabe anhand des URI an.• Definieren Sie die Eingabeparameter.• Optional: Definieren Sie eine Infotable, in der Zeilendaten in Info*Engine

Gruppenelemente konvertiert werden und die als Eingabegruppe der Aufgabeverwendet wird.


Um den Dienst ExecuteTask zu verwenden, erstellen Sie ein Ding mithilfe derDingvorlage WindchillConnector. Sie können beispielsweise einen neuen Dienst inptc-windchill-demo-thing hinzufügen, wie in der folgenden Bildschirmabbildungdargestellt.

In den folgenden Abschnitten werden einige allgemeine Anwendungsfunktionenbeschrieben, die Sie mithilfe von Info*Engine Aufgaben einschließen können:WTParts nach Name abfragen auf Seite 81 und Benutzerdefinierte Berichte ausWindchill verwenden auf Seite 84.

WTParts nach Name abfragenIn diesem Beispiel wird der Dienst ExecuteTask aufgerufen, der in derDingvorlage WindchillConnector bereitgestellt wird, um Teile nach Nameabzufragen.Im Beispiel wird davon ausgegangen, dass Sie bereits einen kompatible DataShape erstellt haben, der WTParts darstellt. Außerdem wird davon ausgegangen,dass Sie einen neuen Dienst aus dem Ding heraus implementieren, das zumAusführen der Abfrage verwendet wird. Außerdem haben Sie die folgendeInfo*Engine Aufgabe erstellt und im Windchill Installationsverzeichnisgespeichert:$WT_HOME/tasks/com/ptc/windchill/example/queryPartByName.xml

<%@page language="java" access="http"%>

<%@taglib uri="http://www.ptc.com/infoengine/taglib/core" prefix="ie"%>

<ie:webject name="Query-Objects" type="OBJ">

<ie:param name="INSTANCE" data="$(@FORM[]supporting-adapter[*])"

delim="!" valueSeparator="!"

default="<%=com.infoengine.au.NamingService.getVMName()%>"/>

<ie:param name="TYPE" data="wt.part.WTPart"/>


<ie:param name="WHERE" data="name = '${@FORM[]name[]}'"/>

</ie:webject>

Führen Sie die folgenden Schritte aus, um einen ThingWorx Dienst zu erstellen,mit dem Teile nach Name abgefragt werden können. Verwenden Sie das vonIhnen erstellte Ding, das die Dingvorlage WindchillConnector verwendet.1. Geben Sie im neu hinzugefügten Dienst Dienstinformationen (wie Name und

Beschreibung) sowie die Eingabe- und Ausgabeparameter ein:• Eingabeparameter:

STRING-Name

• Ausgaben:Basistyp: INFOTABLEData Shape: my.wt.part.WTPart


Ersetzen Sie den Wert für Data Shape durch den Namen Ihres Data Shape:

2. Geben Sie das folgende Skript ein, das die AufgabequeryPartByName.xml ausführt:

HinweisDie Codebeispiele wurden zur Anpassung an die Seitengröße umformatiertund enthalten unter Umständen Zeilennummern, verborgene Zeichen (wieTabulatoren und Zeilenendezeichen) sowie belanglose Leerzeichen. WennSie Code ausschneiden und einfügen, suchen Sie nach diesen Zeichen, undentfernen Sie sie, bevor Sie den Beispielcode in Ihrer Anwendungeinzusetzen versuchen.

/*

* The ExecuteTask service takes as arguments an InfoTable of IEProperty

* DataShape defining the tasks parameters, a String defining the URI of

* the task to execute, and an optional InfoTable defining objects to use as

* the tasks input group. For this task, define the parameters and the task URI

*/

/* construct the InfoTable defining the parameters */

var params = {

infoTableName : "InfoTable",

dataShapeName : "IEProperty"

};

var inputParams = Resources["InfoTableFunctions"].

CreateInfoTableFromDataShape(params);

/* IEProperty DataShape has the fields name and value */

inputParams.AddRow({

name: 'name', //this is the name of the parameter

value: name //and it's value - which is the argument to this service

});


/* now call the ExecuteTask service */

var params = {

params: inputParams,

dataShape: 'my.wt.part.WTPart', //replace with name of your data shape

uri: 'com/ptc/windchill/example/queryPartByName.xml', //task to invoke

objects: undefined //task does not take input group of objects; leave undefined

};

var result = me.ExecuteTask(params);

3. Speichern Sie den Dienst.

Benutzerdefinierte Berichte aus Windchill verwenden

HinweisWeitere Informationen zu benutzerdefinierten Berichten finden Sie imWindchill Help Center oder imWindchill Customization Guide (WindchillAnpassungshandbuch) auf ptc.com.

ÜbersichtIn diesem Beispiel wird auch der Dienst ExecuteTask aufgerufen, der in derDingvorlage WindchillConnector bereitgestellt wird. Er verwendet dieInfo*Engine Aufgabe ExecuteReportTemplate zum Ausführen einesbenutzerdefinierten Berichts. In diesem Beispiel erstellen Sie eine neueDienstmethode, die den Bericht ausführt und den Bericht als Infotable zurückgibt.Allgemein führt die neue Dienstmethode die folgenden Vorgänge aus:1. WindchillConnector Dienst Query verwenden, um den Kontext abzufragen, in

dem die Berichtvorlage vorliegt.2. WindchillConnector Dienst Query verwenden, um die Berichtvorlage des

Berichts abzufragen, der ausgeführt werden soll.3. WindchillConnector Dienst ExecuteTask verwenden, um die Info*Engine

Aufgabe namens ExecuteReportTemplate auszuführen, die dieBerichtergebnisse generiert.


https://support.ptc.com/appserver/cs/portal/

VorbereitungBevor Sie diesen Dienst schreiben können, erstellen Sie die Data Shapes, die derDienst benötigt.1. Verwenden Sie den WindchillConnector Dienst CreateDataShapes, um die

Form für das Windchill Kontextobjekt mit dem Typwt.inf.container.WTContainer zu erstellen.

2. Verwenden Sie den WindchillConnector Dienst CreateDataShapes, um dieForm für das Windchill Berichtvorlagenobjekt mit dem Typwt.query.template.ReportTemplate zu erstellen.

HinweisInfo*Engine kann das Berichtvorlagenobjekt nicht abrufen, da es BLOB-XML-Daten enthält. Entfernen Sie alle Felder aus dem Data Shape, dieXML- oder QML-Daten enthalten.

3. Erstellen Sie einen Data Shape, der den Feldern des benutzerdefiniertenBerichts entspricht.

Dienst implementierenJetzt können Sie den Dienst implementieren, der den benutzerdefinierten Berichtausführt und den Bericht als Infotable zurückgibt.1. Fragen Sie den Kontext ab, in dem die Berichtvorlage vorliegt. Mit diesem

Code wird beispielsweise der Kontext "Drive System" abgefragt:var containers = Things["ptc-windchill-demo-thing"].Query({

criteria:"name = 'Drive System'",

dataShape: 'demo.wt.inf.container.WTContainer',

type: 'WCTYPE|wt.inf.container.WTContainer'

});

if(containers.getRowCount() > 0) {

var containerUfid = containers.getRow(0).ufid;

logger.debug("Using container UFID " + containerUfid);

}

2. Fragen Sie die Berichtsvorlage nach Name und Kontext ab. Mit diesem Codewird beispielsweise die Berichtvorlage namens "Part Assembly" abgefragt.var reportTemplates = Things["ptc-windchill-demo-thing"].Query({

criteria: "name = 'Part Assembly'",

dataShape: 'demo.wt.query.template.ReportTemplate',

type: 'WCTYPE|wt.query.template.ReportTemplate',

containerUfid: containerUfid

});

if(reportTemplates.getRowCount() > 0) {

var reportTemplateUfid = reportTemplates.getRow(0).ufid;

logger.debug('Using report template UFID ' + reportTemplateUfid);


}

3. Rufen Sie die Info*Engine Aufgabe ExecuteReportTemplate ab. Indiesem Beispiel erfordert der Bericht die Parameter "Name "und "Version",daher werden diese als Eingabe übergeben. Beachten Sie, dass der Data Shapedes resultierenden Berichts "AssemblyReport" ist.var properties = Resources["InfoTableFunctions"].

CreateInfoTableFromDataShape({

infoTableName : "InfoTable",

dataShapeName : "IEProperty"

});

properties.AddRow({

name : 'object_ref',

value: reportTemplateUfid

});

properties.AddRow({

name : 'input',

value: "name='" + partName + "'" + "," + "version='" + partRevision + "'"

});

var result = Things["ptc-windchill-demo-thing"].ExecuteTask({

params: properties,

dataShape: 'AssemblyReport',

uri: 'com/ptc/windchill/enterprise/report/ExecuteReportTemplate.xml',

objects: undefined /* INFOTABLE */

});

Windchill für die Verwendung des Diensts ändernBevor Sie den Dienst verwenden können, müssen Sie Windchill so ändern, dassHTTP-Zugriff auf die Aufgabe ExecuteReportTemplate zulässig ist. FügenSie hierzu access=http zu den .delegateInfo Dateien hinzu. Fügen Siediese Datei zum Aufgabenordner tasks\com\ptc\windchill\enterprise\report oder einem beliebigen übergeordneten Ordner hinzu.

Windchill REST-Webdienste beim Entwickeln vonAnwendungen verwendenIn Windchill stehen verschiedene REST-Webdienste zur Verfügung, die in einemMashup verwendet werden können. Diese Dienste ermöglichen das Zugreifen aufWindchill Daten und die Rechenleistung des Windchill Systems. WindchillExtension enthält die Dingvorlage WindchillConnector, die den DienstprocessJSONRequest zur Verfügung stellt, mit dem Windchill REST-Webdiensteaufgerufen werden können.Um einen Windchill REST-Dienst aufzurufen, können Sie den DienstprocessJSONRequest aus der Dingvorlage WindchillConnector verwenden.Beispielsweise ruft der folgende Codeausschnitt aus ptc-windchill-demo-thing denWindchill Dienst /structure/objects auf und übergibt Parameter, die dieListe der Eigenschaften, eine Nummer und den Namen navigationCriteriaangeben:var params = {


headers: {

'Accept': "application/json",

'Content-Type': 'application/json'

},

type: 'GET',

data: undefined,

url: me.getRestUrl() + "/structure/objects",

queryParams: {

'$select': encodeURIComponent(properties),

'$filter': "number+eq+'" + encodeURIComponent(number) + "'",

'navigationCriteria': encodeURIComponent(navigationCriteria)

},

timeout: 15000

};

// result: JSON

var jsonResult = me.processJSONRequest(params);

Eine ausführliche Dokumentation zu Windchill REST-Diensten steht über dieWindchill Benutzeroberfläche zur Verfügung. Die Dokumentation enthältBeschreibungen der Ressourcen, Endpunkte, Parameter sowie Darstellungen undihrer Struktur. Um auf die Dokumentation zuzugreifen, klicken Sie auf dasAnpassungssymbol im Navigator, und wählen Sie dann Dokumentation aus.


Die Dokumentation ist verfügbar, wenn die Einstellung Client-Anpassung in derWindchill Benutzeroberfläche auf Ja festgelegt ist:

Informationen zum Festlegen der Einstellung finden Sie unter "CustomizationTools Overview" im Windchill Help Center.

ServiceTimeout-EigenschaftDie Eigenschaft ServiceTimeout steuert die Zeitspanne (in Millisekunden), dieThingWorx standardmäßig auf den Abschluss eines REST-Aufrufs an Windchillwartet, bevor Windchill einen Fehler an die Mashup-Benutzeroberflächezurückgibt. Dieser Standardwert kann für einen einzelnen Aufruf überschriebenwerden, indem das timeout-Argument im Aufruf an Windchill angegeben wird.Beispielsweise ruft der folgende Code den Windchill REST-Endpunkt auf, umeine gespeicherte Suche auszuführen, und gibt ein Timeout von 10 Sekunden an.Wenn dieser Aufruf das timeout-Argument nicht angibt, wird das inServiceTimeout angegebene Timeout verwendet.var params = {

queryParams: {'$select': 'name,number,version'

},data: {

keyword: undefined},type: 'POST',url: me.getRestUrl() + "/search/saved-searches/" + encodeURIComponent(oid) + "/results",timeout: 10000

};var jsonResult = me.processJSONRequest(params);

Die folgende Bildschirmabbildung zeigt die Verwendung von ServiceTimeout inder Konfiguration von Demodaten:


Beispielkonfiguration mit SSL für sichereKommunikationDas folgende Beispiel veranschaulicht eine Möglichkeit, Windchill undThingWorx für vertrauenswürdige SSL-Kommunikation zu konfigurieren. Indiesem Beispiel wird ein selbstsigniertes Zertifikat verwendet, um dieKommunikation zwischen Windchill und ThingWorx zu sichern; diese Methodeist für Umgebungen geeignet, in denen die Kommunikation innerhalb derfirmeneigenen Firewall stattfinden. Bei Datenverkehr über das Internet wird dieVerwendung eines kommerziellen vertrauenswürdigen Zertifikats empfohlen.

Hinweis• Diese Anweisungen beruhen auf Konfigurationsskripts, die in der neuesten

Version von PTC HTTP-Server enthalten sind. Die neueste Version von PTCHTTP-Server ist im Lieferumfang von Windchill 11.0 und den aktuellen CPS-Versionen für Windchill 10.2 enthalten.

• In diesem Beispiel wird vorausgesetzt, dass Windchill bereits für dieVerwendung von SSL konfiguriert ist.

• Der hier verwendete Schlüssel muss nicht mit dem für die Windchill oderThingWorx Weboberfläche verwendeten identisch sein.

• Die Codebeispiele wurden zur Anpassung an die Seitengröße umformatiertund enthalten unter Umständen Zeilennummern, verborgene Zeichen (wieTabulatoren und Zeilenendezeichen) sowie belanglose Leerzeichen. Wenn SieCode ausschneiden und einfügen, suchen Sie nach diesen Zeichen, undentfernen Sie sie, bevor Sie den Beispielcode in Ihrer Anwendung einzusetzenversuchen.


1. Erstellen Sie einen Vertrauensspeicher für ThingWorx, und importieren Siedas Windchill Zertifikat:

2. Erstellen Sie einen Schlüsselspeicher für ThingWorx.3. Konfigurieren Sie Windchill so, dass die Anwendung ThingWorx vertraut.

HinweisWenn sich ThingWorx und Windchill auf verschiedenen Systemenbefinden, können die Schritte 3 a, b und c auf dem Windchill Serverausgeführt werden. Kopieren Sie dann die JKS-Dateien auf denThingWorx Server.

a. Aktualisieren Sie die Konfiguration von PTC HTTP-Server so, dass dieCA-Zertifikatdatei referenziert wird.

i. Navigieren Sie zu <HTTPSERVER_HOME>/conf/extra/httpd-ssl.conf, und bearbeiten Sie die Datei.

ii. Heben Sie die Auskommentierung des EintragsSSLCACertificateFile auf, sodass er die Datei ca-bundle.crt referenziert. Notieren Sie den Speicherort der Dateica-bundle.crt.

iii. Speichern Sie die Änderungen.b. Fügen Sie das ThingWorx Zertifikat der Liste vertrauenswürdiger CA-

Zertifikate von PTC HTTP-Server hinzu.

i. Bearbeiten Sie die Datei ca-bundle.crt, auf die Sie zuvor imEintrag SSLCACertificateFile verwiesen haben.

HinweisWenn die Datei noch nicht vorhanden ist, erstellen Sie die Dateiund alle erforderlichen Verzeichnisse.

ii. Hängen Sie den Inhalt des im Vertrauensspeicher gespeichertenThingWorx Zertifikats ("servercert.pem" aus Schritt 2 a oben) an dieseDatei an.

iii. Speichern Sie die Änderungen.c. Konfigurieren Sie PTC HTTP-Server so, dass die Zertifikatinformationen

nach Windchill exportiert werden.

i. Bearbeiten Sie die Datei <HTTPSERVER_HOME>/conf/extra/httpd-ssl.conf.

ii. Suchen Sie die Zeile mit SSLOptions.


iii. Heben Sie die Auskommentierung der Zeile mit SSLOptions+ExportCertData auf.

Zum Beispiel:

SSLOptions +FakeBasicAuth +ExportCertData +StrictRequire

<FilesMatch "\.(cgi|shtml|phtml|php)$">

SSLOptions +StdEnvVars

/FilesMatch>

<Directory "C:/ptc/Windchill_10.2/HTTPServer/cgi-bin">

SSLOptions +StdEnvVars

</Directory>

iv. Speichern Sie die Änderungen.d. Konfigurieren Sie PTC HTTP-Server für die sslClientAuth-URL.

i. Suchen Sie den Windchill Web-App-Namen in <windchill-home>/codebase/wt.properties im Eintragwt.webapp.name.

ii. Öffnen Sie eine Shell oder eine Eingabeaufforderung, und geben SieFolgendes ein:

cd <HTTPSERVER_HOME>ant -f webAppConfig.xml -DappName=[windchill-web-app]

-Dresource=sslClientAuth -DresourceAuthType=sslClientAuth addAuthResource

iii. Konfigurieren Sie Windchill so, dass die Anwendung dem ThingWorxZertifikat vertraut.

1) Bearbeiten Sie die Datei <windchill-home>/codebase/WEB-INF/web.xml.

2) Suchen Sie nach <filter-name>TrustedSSLAuthFilter</filtername>.

3) Fügen Sie ein weiteres <init-param>-Element nach demvorhandenen hinzu, wobei [thingworx-cert-name] der Name desThingWorx Zertifikats ist. Bei einem selbstsignierten Zertifikat istder Zertifikatsname der Besitzerwert des Zertifikats beiAusführung von keytool -list -v -keystore <path-to-ThingWorxKeyStore.jks>:

<init-param><param-name>trustedSubjectPattern.1

</param-name><param-value>[thingworx-cert-name]</param-value></init-param>

iv. Speichern Sie die Änderungen.4. Konfigurieren Sie ThingWorx für SSL.

a. Bearbeiten Sie in ThingWorx Composer die DingvorlageWindchillConnector, die die Verbindung zum Windchill System darstellt,das konfiguriert wird.

b. Geben Sie den Pfad zu ThingWorxKeyStore.jks an, und geben Sieauch das Passwort an.


c. Geben Sie den Pfad zu ThingWorxTrustStore.jks an, und gebenSie auch das Passwort an.

d. Geben Sie die Windchill https-Adresse und den SSL-Port an.e. Speichern Sie das Ding.f. Zeigen Sie das ThingWorx Anwendungsprotokoll an, um zu verifizieren,

dass keine Konfigurationsfehler vorhanden sind.5. Starten Sie ptc-connected-demo-mashup, um die vertrauenswürdige SSL-

Konfiguration zwischen ThingWorx und Windchill zu überprüfen.

Architektur der EinmalanmeldungVerwenden Sie den von PTC bereitgestellten Authentifizierungsfilter und dieAuthentifikatorerweiterung, um die Einmalanmeldung für Benutzer zuimplementieren, die auf eine mit Windchill verbundene ThingWorx Anwendungzugreifen.In dieser Übersicht ist der Windchill Server der Remote-Identitätsanbieter (IdP).Der Authentifizierungsfilter und die Authentifikatorerweiterung sind inThingWorx installiert.Die Architektur besteht aus zwei Komponenten:

• PTC Identity Provider Authentication Filter: Tomcat-Filter für dieAuthentifizierung; der Filter leitet nicht authentifizierte Benutzer zum IdP umund validiert den Schlüssel.

• PTC Identity Provider Authenticator Extension: ThingWorx Erweiterung fürdie Authentifizierung; die Erweiterung enthält dynamische Benutzererstellungund Festlegung des Start-Mashups.

Design des AuthentifizierungsfiltersDer Zweck dieses Filters ist es, die ThingWorx Authentifizierung an den Remote-Authentifizierungsdienst zu delegieren. Der Authentifizierungsfilter entspricht derStandardarchitektur der Einmalanmeldung.


Das folgende Diagramm zeigt den Ablauf der Authentifizierung:

Die folgenden Authentifizierungsschritte erweitern die im Diagramm dargestelltenSchritte. Jeder nummerierte Schritt entspricht der gleichen Nummer imDiagramm:

1. Benutzer versucht, auf die ThingWorx Anwendung zuzugreifen.2. PTC Identity Provider Authentication Filter fängt die ThingWorx

Benutzeranfrage ab und leitet diese zur Anmeldung an den IdP um.

Benutzer sieht das Windchill Anmeldeformular anstelle des ThingWorxAnmeldeformulars.

3. Benutzer gibt Benutzernamen und Passwort in das Anmeldeformular ein.Windchill authentifiziert den Benutzer.

4. Nach erfolgreicher Anmeldung leitet der Windchill Server die Anfrage mitdem generierten Schlüssel zurück an ThingWorx.

5. Der Validierungsfilter für den PTC Identitätsanbieterschlüssel liest denSchlüssel und validiert ihn.

6. Der Validierungsfilter übergibt den Windchill Benutzernamen alsAnfrageattribut an den nächsten Filter. Im Einmalanmeldungsprozess ist dernächste Filter der ThingWorx Authentifizierungsfilter.


Die Authentifizierung ist abgeschlossen.7. Die Benutzeranzeige wird mit einem ThingWorx Fenster aktualisiert. Die

Authentifikatorkonfiguration bestimmt das anfängliche Fenster für einenauthentifizierten Benutzer (wie im nächsten Abschnitt beschrieben).

Design der AuthentifikatorerweiterungZweck von PTC Identity Provider Authenticator Extension ist es, ThingWorxBenutzer zu authentifizieren und ihnen den Zugriff auf verschiedene Teile einerThingWorx Anwendung zu gewähren.Der Ablauf der Authentifizierung wird im folgenden Prozess beschrieben:

1. Nachdem der Remote-IdP die Authentifizierung abgeschlossen und denWindchill Benutzernamen übergeben hat, ruft der vorhandene ThingWorxAuthentifizierungsfilter PTC Identity Provider Authenticator Extension auf.

2. PTC Identity Provider Authenticator Extension führt die folgenden Schritteaus:

a. Der Benutzernamen wird aus dem Anfrageattribut gelesen.b. Wenn der Benutzer nicht im ThingWorx System vorhanden ist, erstellt die

Erweiterung den Benutzer in ThingWorx.

HinweisDie Option zum Erstellen neuer Benutzer ist konfigurierbar. WeitereInformationen finden Sie unter PTC Identity Provider Authenticatorkonfigurieren auf Seite 33.

c. Optional: Wenn Sie ein Start-Mashup konfiguriert haben, wird das Start-Mashup für neu erstellte Benutzer festgelegt, und dem Benutzer wirdLesezugriff auf das Mashup gewährt.

Wenn der Benutzer in ThingWorx vorhanden ist, wird das Start-Mashupdes Benutzers nicht festgelegt.

3. Nach einer erfolgreichen Authentifizierung leitet der interne Controller vonThingWorx die Benutzer an das jeweilige Start-Mashup oder an dieStandardsuchseite von ThingWorx weiter.

Einzelheiten zur Konfiguration und weitere Informationen zum Konfigurieren vonBenutzern finden Sie unter PTC Identity Provider Authenticator konfigurieren aufSeite 33.
