• Dinge

• Dingvorlagen

• Dingformen

• Ressourcen

• Authentifikatoren

• Definieren Sie Benennungskonventionen für Ihre Dienste. Beachten Sie die folgenden Punkte:

◦ Geben Sie einen logischen, aussagekräftigen Namen und eine Beschreibung für den Dienst an.

◦ Verwenden Sie eine Standardnomenklatur für Dienste. Beispiel: Verwenden Sie als Präfix für den Dienstnamen ein Verb und eine Beschreibung des Dienstes. Einige Beispiele für Verben finden Sie nachfolgend:

◦ Vermeiden Sie mehrdeutige Namen.

◦ Vermeiden Sie lange Dienstnamen, wenn möglich.

• Gruppieren Sie allgemeine Eigenschaften und Dienste in einer einzelnen Entität, vorzugsweise in einer Dingform.

• Wenn möglich, implementieren Sie Dienste in Dingformen.

• Entwerfen Sie Dienste für verschiedene Ebenen, z.B. Benutzeroberfläche, Geschäftslogik und Datenabruf. Die Dienste auf den verschiedenen Ebenen haben unterschiedliche Zuständigkeiten. Die folgende Abbildung enthält ein Beispiel für die Zuständigkeiten auf verschiedenen Ebenen:

• Versuchen Sie beim Schreiben eines Dienstes, die verfügbaren Ausschnitte aus der ThingWorx Codeausschnitt-Bibliothek wiederzuverwenden. Wenn Sie nicht sicher sind, wie Sie die Codeausschnitte verwenden, testen Sie sie, bevor Sie sie in Ihrem Dienst verwenden.

• Beachten Sie beim Erstellen des Diensts mit JSON-Ausgabe Folgendes:

◦ Wenn die Eigenschaften die Werte null oder undefined haben, werden sie nicht im Ergebnis zurückgegeben.

◦ Wenn die Eigenschaft ein JSON-Objekt und auf null festgelegt ist, wird sie im Ergebnis zurückgegeben.

• Wenn Sie erwarten, dass Ihr Dienst viel Zeit in Anspruch nimmt, stellen Sie sicher, dass der Benutzer den Dienst nicht mehrmals gleichzeitig auslösen kann.

• Wenn der Dienst auf einem Ereignis-Trigger in einem Mashup basiert, verwenden Sie das ServiceInvokeCompleted-Ereignis, um den Datenfluss in einer Lösung zuzulassen.

• Um Daten in Mashups zu aktualisieren, wird empfohlen, das Widget "Automatisch aktualisieren" oder den GetProperties-Dienst zu verwenden.

• Für einfache Konvertierungen zur Laufzeit wird empfohlen, das Widget "Ausdruck" anstatt Diensten zu verwenden.

• Fügen Sie dem Code Prüfungen hinzu, um zu vermeiden, dass der Endbenutzer einen Fehler erhält.

• Wenn die Lösung lokalisiert wird und Text in den Benutzeroberflächenelementen vorhanden ist, der sich dynamisch auf Grundlage des Ergebnisses von Diensten ändert, stellen Sie sicher, dass Sie keine Textwerte in Ihren Diensten hartcodieren, die im Mashup angezeigt werden. Dies liegt daran, dass das Ergebnis der Dienste, die den Text zurückgeben, lokalisiert werden muss. Auf diese Weise können Sie den UI-Text auch in Zukunft einfacher verwalten und ändern.

• Beim Erstellen von benutzerdefinierten Diensten müssen Sie entscheiden, welche Benutzer oder Benutzergruppen über die Berechtigungen zum Aufrufen dieses Diensts verfügen sollen. Weitere Informationen finden Sie unter Auf der ThingWorx Platform erstellte Lösungen mithilfe von Sichtbarkeit und Berechtigungen sichern.

• Ein mögliches Ergebnis der Ausführung von Diensten kann die Erstellung von Ghost-Entitäten sein. Ghost-Entitäten werden dynamisch über Code/Skripterstellung erstellt und nicht über ThingWorx Composer. Das Erstellen von Ghost-Entitäten ist nicht ratsam. Weitere Informationen finden Sie unter Ghost-Entitäten erstellen und löschen.

• Die Standardeinstellung für das Skript-Timeout auf ThingWorx Platform ist 30 Sekunden. Wenn die Ausführung eines Skripts länger dauert als die Standardeinstellung, beendet ThingWorx Platform die Ausführung. Der ThingWorx Administrator kann das Skript-Timeout im Abschnitt "Basic Settings" der Datei platform-settings.json konfigurieren.

• Testen Sie Ihren Dienst inkrementell, während Sie ihn erstellen. Verwenden Sie ggf. Skript-Protokollierer-Meldungen.

• Prüfen Sie beim Testen eines Dienstes die Protokolle auf Fehlermeldungen. Dies ist besonders nützlich für Dienste in Abonnements. Die folgenden Protokolldateien sind hilfreich:

◦ ErrorLog.log – Bietet detaillierte Stapel-Ablaufverfolgung für Fehler

◦ ScriptErrorLog.log – Bietet Dienstkontextinformationen (Stapelfehler-Zeilennummer)

• Wenn der Dienst aus einem Mashup aufgerufen wird, testen Sie ihn in Composer und im Mashup.

• Wenn Benutzereingaben erforderlich sind, damit der Dienst ausgeführt werden kann, können Sie die Funktion "Validierer" verwenden.

• Verwenden Sie die Entwicklertools, die in Browsern zur Verfügung stehen, um das Ergebnis eines Dienstes zu prüfen. Dies ist hilfreich, wenn Sie eine Sequenz von Diensten debuggen möchten, die in einem Mashup ausgeführt wird. Dieses Tool zeigt die Dienstergebnisse im Kontext dieser spezifischen Ausführung an.

• Wenn Sie nach Diensten suchen möchten, öffnen Sie die Entität nicht im Bearbeitungsmodus. Verwenden Sie den Vorschaulink links neben dem Namen der Entität, um die Entität im Ansichtsmodus zu öffnen.

• Sicherheit: Verwenden Sie für mehr Sicherheit Dienstüberschreibungen, um Berechtigungen für wichtige Dienste zu verweigern, die auf ThingWorx Platform verfügbar sind.

• Upgrades: Verwenden Sie gute Codierungsmethoden, und erstellen Sie keine großen monolithischen Dienste.

• Parallelitätsmuster – ThingWorx Dingdienste werden nicht isoliert von der Anwendungs-Engine ausgeführt. Daher sind Änderungen an Dingmodell-Eigenschaften, die für einen Dienst vorgenommen wurden, sofort in allen anderen gleichzeitig ausgeführten Diensten sichtbar. Wenn zwei Dienste gleichzeitig versuchen, dieselbe Eigenschaft zu schreiben, werden beide Schreibvorgänge erfolgreich ausgeführt. Der Eigenschaftswert hat schließlich den Status, der zuletzt ausgeführt wurde, und kann sich von der Reihenfolge unterscheiden, in der die Schreibvorgänge an den Server gesendet wurden. Im Allgemeinen wird beim gleichzeitigen Zugriff auf die meisten Daten und Ressourcen innerhalb von ThingWorx Platform der Ansatz "Last-Write-Wins" verfolgt. Anwendungsentwickler und Architekten sollten diese Verhaltensweisen beim Erstellen von Anwendungen berücksichtigen.