Windchill REST Webdienste zum Entwickeln von Aufgaben verwenden

In Windchill stehen verschiedene REST-Webdienste (Representational State Transfer) zur Verfügung, die in einem Mashup verwendet werden können. Diese Dienste ermöglichen das Zugreifen auf Windchill Daten und die Rechenleistung des Windchill Systems. PTC Windchill Extension enthält die Dingvorlage WindchillSwaggerConnector, welche die Windchill REST-Webdienste startet. Die Instanz des Konnektors für ThingWorx Navigate ist ptc-windchill-integration-connector.

Windchill stellt außerdem die OData-basierten Windchill REST-Dienste bereit. In zukünftigen Versionen wird ThingWorx Navigate diese Dienste verwenden.

Wir empfehlen, dass Sie diese Änderung beim Anpassen von ThingWorx Navigate berücksichtigen.

Ausführliche Informationen und Anweisungen zum Konfigurieren von OData-Diensten für Windchill Daten finden Sie im englischen Handbuch Windchill REST Services User's Guide (Windchill REST Services Benutzerhandbuch).

Windchill REST Dienste sind integriert mit Windchill Audit Protokollierung. Ab dieser Version der PTC Windchill Extension werden die folgenden Ereignisse protokolliert:

Verwenden Sie die nachfolgenden Ressourcen, um mehr Informationen zum Aufrufen der REST-Dienste in Ihren Aufgaben zu erhalten:

• Die ThingWorx Hilfe enthält ein umfassendes Kapitel zu Integrationskonnektoren wie z.B. dem WindchillSwaggerConnector. In diesem Kapitel finden Sie Hintergrundinformationen sowie Informationen dazu, wie Konnektoren verwendet werden. Beginnen Sie mit dem Thema "Integration Connectors".

• Das Thema "Using WindchillSwaggerConnector" enthält Informationen zur Installation des erforderlichen Windchill Patch sowie eine Liste der unterstützten Windchill Endpunkte, die Sie zum Abrufen von Daten verwenden können.

• Die Windchill Dokumentation enthält Beschreibungen der Ressourcen, Endpunkte, Parameter sowie Darstellungen und ihrer Struktur. Um auf die Dokumentation zuzugreifen, klicken Sie auf das Anpassungssymbol im Navigator, und wählen Sie dann Dokumentation aus.

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

Die Eigenschaft ServiceTimeout steuert die Zeitspanne (in Millisekunden), die ThingWorx standardmäßig auf den Abschluss eines REST-Aufrufs an Windchill wartet, bevor Windchill einen Fehler an die Mashup-Benutzeroberfläche zurückgibt. Sie können diesen Standardwert für einen einzelnen Aufruf überschreiben, indem Sie das timeout-Argument im Aufruf an Windchill angeben. Beispielsweise ruft der folgende Code den Windchill REST-Endpunkt auf, um eine gespeicherte Suche auszuführen, und gibt ein Timeout von 10 Sekunden an. Wenn dieser Aufruf das timeout-Argument nicht angibt, wird das in ServiceTimeout 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);