OData-Konnektor konfigurieren
ThingWorx Navigate unterstützt die Verwendung des OData-Konnektors mit Windchill REST Services, um auf Daten für Ihre benutzerdefinierte Aufgabe zuzugreifen.
 |
WindchillConnector(ptc-windchill-demo-thing) ist veraltet und wird in der Version nach ThingWorx Navigate 9.1 entfernt. Für einen reibungslosen Übergang empfehlen wir, Ihre benutzerdefinierten Aufgaben so zu aktualisieren, dass der OData-Konnektor verwendet wird.
|
Voraussetzungen
ThingWorx Integration Runtime muss konfiguriert sein, bevor der OData-Konnektor verwendet werden kann. Im Allgemeinen wird ThingWorx Integration Runtime mit dem ThingWorx Navigate Installationstool im Rahmen des Installationsprozesses konfiguriert.
Konnektor erstellen
Für die Einrichtung des OData-Konnektor stehen 2 Optionen zur Verfügung: Sie können entweder eine neue Instanz des Konnektors erzeugen oder den vordefinierten Konnektor ptc-windchill-OData-connector verwenden. Wählen Sie die beste Option für Ihren Anwendungsfall.
Für benutzerdefinierte Aufgaben, die Info*Engine Aufgaben verwenden, wird empfohlen, den vordefinierten Konnektor ptc-windchill-OData-connector zu verwenden. Der Grund hierfür ist, dass die Info*Engine Dienste im vordefinierten Konnektor bereits verfügbar sind.
Führen Sie die folgenden Schritte aus, um eine neue Instanz des OData-Konnektors zu erstellen:
1. Navigieren Sie in ThingWorx Composer zu Modellierung > Integrations-Konnektoren, und klicken Sie anschließend auf Neu.
2. Wählen Sie im Fenster Vorlage wählen die ODataConnector Dingvorlage aus, und klicken Sie auf OK.
3. Geben Sie einen Namen und ein Projekt für den Konnektor ein.
Jetzt können Sie den Konnektor konfigurieren.
Konnektor konfigurieren
1. Öffnen Sie den erstellten Konnektor in Composer oder suchen Sie nach ptc-windchill-OData-connector, und öffnen Sie ihn. Die Seite Allgemeine Informationen wird geöffnet.
2. Klicken Sie auf die Registerkarte Konfiguration. Die Seite Konfiguration wird geöffnet.
Ihre Konfiguration hängt von der Authentifizierungsmethode ab: Single Sign-On, Windchill Authentifizierung oder feste Authentifizierung.
Single Sign-On
Führen Sie die nachfolgenden Schritte aus, wenn Sie Single Sign-On verwenden:
1. Wählen Sie unter Verbindungseinstellungen für allgemeinen Konnektor für Authentifizierungstyp die Option SSO aus.
2. Geben Sie unter Autorisierungsserver-ID den Wert für AuthorizationServerSettingsID ein, den Sie in sso-settings.json angegeben haben, z.B. PingFed1.
3. Klicken Sie unter Bereichseinstellungen für den Autorisierungsserver auf Hinzufügen. Das Fenster AuthorizationServerScopesSettings wird geöffnet.
4. Geben Sie unter Bereich den Windchill Bereich ein, den Sie in PingFederate registriert haben, z.B. WINDCHILL.
5. Klicken Sie auf Hinzufügen.
6. Geben Sie unter CSRF-Einstellungen die folgenden Informationen ein:
◦ Relative URL für CSRF-Get-Anforderung – /servlet/odata
◦ CSRF-Token-Name: CSRF_NONCE
7. Geben Sie unter Verbindungseinstellungen für HTTP-Konnektor die folgenden Informationen ein:
◦ Basis-URL: Die Windchill URL. Die URL muss in /oauth enden. Verwenden Sie dieses Format:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/oauth
Dieses Format gibt an, dass die Verbindung den OAuth-Standard verwendet und aktiviert Datenanfragen im Ressourcen-Anbieter.
◦ Relative URL – /servlet/odata
Benutzername und Passwort müssen nicht eingegeben werden.
8. Klicken Sie auf Speichern. Der OData-Konnektor ist jetzt für die Verwendung in Ihrer Single Sign-On-Umgebung konfiguriert.
Windchill Authentifizierung
Führen Sie die nachfolgenden Schritte aus, wenn Sie die Windchill Authentifizierung konfiguriert haben:
1. Wählen Sie unter Verbindungseinstellungen für allgemeinen Konnektor für Authentifizierungstyp die Option None aus.
2. Geben Sie unter CSRF-Einstellungen die folgenden Informationen ein:
◦ Relative URL für CSRF-Get-Anforderung – /servlet/odata
◦ CSRF-Token-Name: CSRF_NONCE
3. Geben Sie unter Verbindungseinstellungen für HTTP-Konnektor die folgenden Informationen ein:
◦ Basis-URL: Der Windchill Server, der die Info*Engine Anfrage vom ODataConnector erhält. Verwenden Sie dieses Format:
[https]://[Windchill Host]:[port]/[Windchill-web-app]/sslClientAuth
◦ Relative URL – /servlet/odata
◦ Verbindungs-URL: /servlet/WindchillGW/wt.httpgw.HTTPServer/ping
Benutzername und Passwort müssen nicht eingegeben werden.
4. Klicken Sie auf Speichern. Der OData-Konnektor ist jetzt für Windchill Authentifizierungs-Umgebung konfiguriert.
Feste Authentifizierung
Führen Sie die nachfolgenden Schritte aus, wenn Sie die feste Authentifizierung verwenden:
1. Wählen Sie unter Verbindungseinstellungen für allgemeinen Konnektor für Authentifizierungstyp die Option Fixed aus.
2. Geben Sie unter CSRF-Einstellungen die folgenden Informationen ein:
◦ Relative URL für CSRF-Get-Anforderung – /servlet/odata
◦ CSRF-Token-Name: CSRF_NONCE
3. Geben Sie unter Verbindungseinstellungen für HTTP-Konnektor die folgenden Informationen ein:
◦ Benutzername: Ihr Administrator-Benutzername für Windchill
◦ Passwort: Ihr Administrator-Passwort für Windchill
◦ Basis-URL: Der Windchill Server, der die Info*Engine Anfrage vom ODataConnector erhält. Verwenden Sie dieses Format:
[https]://[Windchill Host]:[port]/[Windchill-web-app]
◦ Relative URL – /servlet/odata
4. Klicken Sie auf Speichern. Der OData-Konnektor ist jetzt für die Umgebung mit fester Authentifizierung konfiguriert.
Dienste auf dem Konnektor bereitstellen
Nach der Konfiguration des Konnektors hängen die nächsten Schritte von Ihren benutzerdefinierten Aufgaben ab:
• Für benutzerdefinierte Aufgaben, die keine Info*Engine Aufgaben verwenden, müssen die erforderlichen Dienste auf dem Konnektor bereitgestellt werden. Informationen zum Bereitstelen von Diensten finden Sie in den Themen Dienste in Integrations-Konnektoren bereitstellen und Neue API-Zuordnungen für Dienste erstellen im Hilfe-Center.
• Fahren Sie für benutzerdefinierte Aufgaben, die Info*Engine Aufgaben verwenden, mit dem Thema Info*Engine Dienste mit OData-Konnektor ausführen fort.