Änderungen von Dokument Entwicklung eines ACMP Connectors für die ISS

Zusammenfassung

• Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
• Anhänge (0 geändert, 2 hinzugefügt, 0 gelöscht)
  • Assettyp_ISS Connector.png
  • Benutzerdefinierte Felder_ISS Connector.png

Details

Seiteneigenschaften

Inhalt

...	...	@@ -44,8 +44,60 @@
44	44
45	45	= Aufgabenteilung =
46	46
	47	+Das Ziel der Aufgabenteilung ist es, die Hauptaufgabe auf kleinere Services aufzuteilen und damit zu modularisieren. Jeder Service soll dabei nur eine spezifische Funktion übernehmen. Somit wird gewährleistet, dass die verschiedenen Services unabhängig voneinander laufen.
	48	+
	49	+Die Hauptaufgabe des ACMP Connector für die ISS ist es, die aktuellen Informationen zur Internationalen Raumstation (ISS) aus der öffentlichen REST API [[https:~~/~~/wheretheiss.at>>url:https://wheretheiss.at/]] abzurufen und über die ACMP Public API als Asset in dem ACMP anzulegen bzw. zu aktualisieren. Anhand dieser kurzen Projektdefinition lässt sich in diesem Beispiel erkennen, dass es zwei Teilaufgaben gibt: Erstens das Abrufen der Daten von der REST API und zweitens die Integration der bereitgestellten Daten in ACMP. Für jede Teilaufgabe wird ein eigener Service bzw. Microservice definiert:
	50	+
	51	+1. **Microservice 1: Datenabruf von der REST API**
	52	+Der erste Service ruft die ISS-Daten (z.B. Position, Höhe, Geschwindigkeit) von der API ab und sendet diese an den zweiten Microservice.
	53	+1. **Microservice 2: Integration in ACMP**
	54	+Der zweite Service liest die vom ersten Service bereitgestellten Daten und überträgt sie mithilfe der Public API an den ACMP. Dabei wird entweder ein neues Asset für die ISS erstellt oder ein bestehendes Asset aktualisiert.
	55	+
	56	+[[Schematische Darstellung der aufgeteilten Services für den ACMP Connector für ISS-Daten>>image:Schema_ISS Connector_Microservices.png||alt="Schematische Darstellung der aufgeteilten Services für den ACMP Connector für ISS-Daten" data-widget="image" data-xwiki-image-style-alignment="center" height="360" width="800"]]
	57	+
	58	+= Vorbereitungen =
	59	+
	60	+Nachdem die Hauptaufgabe aufgeteilt und die modularen Microservices für die einzelnen Aufgaben definiert wurden, ist es ggf. notwendig, das bestehende System vorzubereiten. In diesem Beispiel müssen für ACMP als das bestehende System, in das die Daten integriert werden sollen, einige Ressourcen neu angelegt werden. Das ist notwendig, damit Sie bei der anschließenden Entwicklung der Microservices direkt auf die Ressourcen zugreifen können.
	61	+
	62	+Die Daten für die ISS sollen in ACMP im Asset Management einem Asset hinzugefügt werden. Da es bislang allerdings keinen Assettypen für eine Raumstation gibt, muss dieser erst angelegt werden. Außerdem werden für die Daten der Raumstation neue benutzerdefinierte Felder benötigt, die ebenfalls erst angelegt werden müssen. So können Sie die Datenfelder dann direkt bei der Erstellung des neuen Assettypen hinzufügen.
	63	+
	64	+=== Benutzerdefinierte Felder erstellen ===
	65	+
	66	+Für die Erfassung von den Daten der Raumstation werden vier neue benutzerdefinierte Felder benötigt: //Latitude, Longitude, Altitude// und //Velocity//. Gehen Sie folgendermaßen vor, um das benutzerdefinierte Feld //Latitude// anzulegen:
	67	+
	68	+1. Öffnen Sie die ACMP Console und navigieren Sie zur Solution //System > Einstellungen > Benutzerdefinierte Felder > Assets.//
	69	+1. Klicken Sie mit einem Rechtsklick auf den Ordner //Custom Fields //und wählen Sie den Eintrag //Tabelle hinzufügen// aus (Umschalt+Alt+N).
	70	+1. Ändern Sie den Namen der neuen Tabelle zu //Spacestation //und bestätigen Sie die Erstellung mit dem Button //Fertig//.
	71	+1. Klicken Sie mit einem Rechtsklick auf die Tabelle //Spacestation// und wählen Sie den Eintrag //Feld hinzufügen// aus (Strg+N).
	72	+1. Ändern Sie den Namen in //Latitude //und klicken Sie auf den Button //Weiter.//
	73	+1. Legen Sie als Feldtyp die Option //Text// fest und ändern Sie den Wert der Feldgröße auf 50.
	74	+1. Bestätigen Sie die Erstellung des Feldes mit dem Button //Fertig.//
	75	+1. Wiederholen Sie Schritt 4 bis Schritt 7 für die weiteren Datenfelder.
	76	+1. Klicken Sie abschließend in der Ribbonleiste auf den Button //Speichern.//
	77	+
	78	+[[Benutzerdefinierte Felder für die ISS-Daten>>image:Benutzerdefinierte Felder_ISS Connector.png||alt="Benutzerdefinierte Felder für die ISS-Daten"]]
	79	+
	80	+=== Assettypen erstellen ===
	81	+
	82	+Nun können Sie den benötigten Assettypen erstellen:
	83	+
	84	+1. Navigieren Sie in der ACMP Console zur Solution //Asset Management > Hardware Assets.//
	85	+1. Klicken Sie in der Ribbonleiste auf den Button //Assettypen.//
	86	+1. Klicken Sie im Dialogfenster auf den Button //Assettypen hinzufügen.//
	87	+1. Wählen Sie im Dialogfenster als Zielordner //Hauptebene// aus und ändern Sie den Namen in //Spacestation.//
	88	+1. Klicken Sie zwei Mal auf den Button //Weiter//, um Schritt 3 //Benutzerdefinierte Felder //zu öffnen.
	89	+1. Öffnen Sie den Ordner //Custom Fields// und ziehen Sie die Tabelle //Spacestation// per Drag-and-Drop in das rechte Fenster.
	90	+1. Klicken Sie auf den Button //Fertig//.
	91	+
	92	+Der Assettyp //Spacestation //ist nun in der Liste verfügbar und hat die entsprechenden benutzerdefinierten Felder.
	93	+
	94	+(% style="width: 500px;" %)
	95	+[[Neuer Assettyp mit benutzerdefinierten Feldern für die ISS-Daten>>image:Assettyp_ISS Connector.png||alt="Neuer Assettyp mit benutzerdefinierten Feldern für die ISS-Daten" data-xwiki-image-style-alignment="center"]]
	96	+
47	47	= Entwicklung der Microservices =
48	48
	99	+
	100	+
49	49	= Fehlerbehandlung =
50	50
51	51	= Orchestrierung =

Assettyp_ISS Connector.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.jklein

Größe

...	...	@@ -1,0 +1,1 @@
	1	+20.7 KB

Inhalt

Benutzerdefinierte Felder_ISS Connector.png

Author

...	...	@@ -1,0 +1,1 @@
	1	+XWiki.jklein

Größe

...	...	@@ -1,0 +1,1 @@
	1	+60.1 KB

Inhalt