Entwicklung eines ACMP Connectors für die ISS

In diesem Best Practice möchten wir Ihnen anhand der Entwicklung eines ACMP Connectors aufzeigen, wie Sie PowerShell-Microservices für Ihre eigenen Projekte entwickeln und nutzen können. Als Beispiel-Projekt wird zur Veranschaulichung ein Connector entwickelt, mit dem die aktuellen Informationen zur Internationalen Raumstation (ISS) aus der öffentlichen REST API [[https:~~/~~/wheretheiss.at>>url:https://wheretheiss.at/]] abgerufen und über die ACMP Public API als Asset im ACMP angelegt bzw. aktualisiert werden. Ziel ist es, die Positions- und Statusdaten der ISS regelmäßig zu synchronisieren und damit immer auf die aktuellen Informationen im System zugreifen zu können.

4

5

6

Am Ende des Best Practice finden Sie das Verzeichnis ISSACMPConnector.zip mit allen Dateien dieses ACMP Connectors zum Herunterladen.

7

8

9

= Entwicklungsumgebung =

10

11

Als Entwicklungsumgebung für die Umsetzung dieses Beispiel-Projekts benötigen Sie:

12

13

* Eine aktuelle Version von Visual Studio Code

14

* Eine installierte PowerShell-Erweiterung in Visual Studio Code

15

* Eine installierte AESB Shell

16

* Eine erreichbare AESB Console

17

18

== Entwicklungsumgebung einrichten ==

19

20

Sofern Sie Visual Studio Code mit der PowerShell-Erweiterung noch nicht installiert haben, befolgen Sie zunächst [[die Installationsanleitung von Microsoft>>https://learn.microsoft.com/de-de/powershell/scripting/dev-cross-plat/vscode/using-vscode?view=powershell-7.4#install-vs-code-and-the-powershell-extension]].

21

22

Wenn Sie Visual Studio Code mit der PowerShell-Erweiterung installiert haben, können Sie die AESB Shell in Visual Studio Code einrichten:

23

24

1. Legen Sie einen neuen Ordner mit dem Namen //ISSACMPConnector// im Datei-Explorer an.

25

1. Klicken Sie mit einem Rechtsklick auf den neuen Ordner, um das Kontextmenü zu öffnen.

26

1. Wählen Sie im Kontextmenü den Eintrag //Mit Code öffnen //aus, damit direkt das richtige Verzeichnis geöffnet wird.

27

1. Erstellen Sie eine neue Datei mit der Endung **//.psm1 //**(z.B. Modul.psm1). Bei dieser Datei handelt es sich um ein PowerShell-Modul, in dem nun die Businesslogik implementiert werden kann.{{aagon.infobox}}Das Erstellen dieser Datei ist notwendig, damit eine PowerShell-Session mit dem Terminal in Visual Studio Code geöffnet wird.{{/aagon.infobox}}

28

1. Geben Sie im Terminal den Befehl //{{code language="PowerShell"}}code $profile{{/code}} //ein und bestätigen Sie mit der Eingabetaste. Nun öffnet sich die Datei //Microsoft.VSCode_profile.ps1//,// //mit der Sie das verwendete PowerShell-Profil anpassen können.

29

1. Fügen Sie den nachfolgenden Code in die Datei //Microsoft.VSCode_profile.ps1// ein. Beachten Sie, dass der angegebene Pfad für die AESB Shell korrekt ist.

30

1. Drücken Sie Strg + S, um die Datei zu speichern.

31

1. Starten Sie Visual Studio Code anschließend neu.

32

33

{{code language="PowerShell" layout="LINENUMBERS" title="**Code für Microsoft.VSCode_profile.ps1**"}}

34

try {

35

$aesbShellPath = "C:\Program Files (x86)\Aagon\AESB Shell"

36

[System.Environment]::CurrentDirectory = $aesbShellPath

37

Import-Module "$aesbShellPath\Aagon.Shell.Core.dll", "$aesbShellPath\Aagon.Sis.Sics.Powershell.Cmdlets.dll" -Prefix AESB -Force -Global

New-AESBShell

}

catch {

Write-Error "No AESBShell installed!"

}

[[AESB Shell in Visual Studio Code einrichten>>image:Visual Studio Code einrichten.png||alt="AESB Shell in Visual Studio Code einrichten"]]

46

47

Als Ergebnis wird in Visual Studio Code im Terminal-Bereich nun direkt die AESB Shell geladen. So können Sie ab jetzt einfach und effektiv neue Module entwickeln, um diese später in den Microservices zu nutzen.

48

49

[[Geladene AESB Shell in Visual Studio Code>>image:Visual Studio Code_AESB Shell.png||alt="Geladene AESB Shell in Visual Studio Code"]]

= Aufgabenteilung =

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.

55

56

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:

57

58

1. **Microservice 1: Datenabruf von der REST API **

59

Der erste Service ruft die ISS-Daten (z.B. Position, Höhe, Geschwindigkeit) von der API ab und sendet diese an den zweiten Microservice.

60

1. **Microservice 2: Integration in ACMP**

61

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.

62

63

[[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-xwiki-image-style-alignment="center" height="360" width="800"]]

= Vorbereitungen =

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.

68

69

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.

70

71

== Benutzerdefinierte Felder erstellen ==

72

73

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:

74

75

1. Öffnen Sie die ACMP Console und navigieren Sie zur Solution //System > Einstellungen > Benutzerdefinierte Felder > Assets.//

76

1. Klicken Sie mit einem Rechtsklick auf den Ordner //Custom Fields //und wählen Sie den Eintrag //Tabelle hinzufügen// aus (Umschalt+Alt+N).

77

1. Ändern Sie den Namen der neuen Tabelle zu //Spacestation //und bestätigen Sie die Erstellung mit dem Button //Fertig//.

78

1. Klicken Sie mit einem Rechtsklick auf die Tabelle //Spacestation// und wählen Sie den Eintrag //Feld hinzufügen// aus (Strg+N).

79

1. Ändern Sie den Namen in //Latitude //und klicken Sie auf den Button //Weiter.//

80

1. Legen Sie als Feldtyp die Option //Text// fest und ändern Sie den Wert der Feldgröße auf 50.

81

1. Bestätigen Sie die Erstellung des Feldes mit dem Button //Fertig.//

82

1. Wiederholen Sie Schritt 4 bis Schritt 7 für die weiteren Datenfelder.

83

1. Klicken Sie abschließend in der Ribbonleiste auf den Button //Speichern.//

84

85

[[Benutzerdefinierte Felder für die ISS-Daten>>image:Benutzerdefinierte Felder_ISS Connector.png||alt="Benutzerdefinierte Felder für die ISS-Daten"]]

86

87

== Assettypen erstellen ==

88

89

Nun können Sie den benötigten Assettypen erstellen:

90

91

1. Navigieren Sie in der ACMP Console zur Solution //Asset Management > Hardware Assets.//

92

1. Klicken Sie in der Ribbonleiste auf den Button //Assettypen.//

93

1. Klicken Sie im Dialogfenster auf den Button //Assettypen hinzufügen.//

94

1. Wählen Sie im Dialogfenster als Zielordner //Hauptebene// aus und ändern Sie den Namen in //Spacestation.//

95

1. Klicken Sie zwei Mal auf den Button //Weiter//, um Schritt 3 //Benutzerdefinierte Felder //zu öffnen.

96

1. Öffnen Sie den Ordner //Custom Fields// und ziehen Sie die Tabelle //Spacestation// per Drag-and-Drop in das rechte Fenster.

97

1. Klicken Sie auf den Button //Fertig//.

98

99

Der Assettyp //Spacestation //ist nun in der Liste verfügbar und hat die entsprechenden benutzerdefinierten Felder.

100

101

(% style="width: 500px;" %)

102

[[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"]]

103

104

= Entwicklung der Microservices =

105

106

Die Entwicklung der PowerShell-Microservices stellt den umfangreichsten Teil bei der Entwicklung dieses ACMP Connectors dar. Für die Entwicklung wird die eingangs beschriebene [[Entwicklungsumgebung >>doc:||anchor="HEntwicklungsumgebung"]]benötigt. Zur Sicherstellung eine sauberen, modularen und effizienten Umsetzung, wird für die Entwicklung von PowerShell-Microservices folgende Vorgehensweise empfohlen:

107

108

1. Erstellen der PowerShell-Module

109

1. Testen der PowerShell-Module

110

1. Erstellen der PowerShell-Microservices in AESB

111

1. Integrieren der PowerShell-Module in die PowerShell-Microservices

112

113

== PowerShell-Module erstellen ==

114

115

Zu Beginn werden die einzelnen PowerShell-Module entwickelt, welche die benötigte Logik für die Microservices enthalten. Für den ACMP Connector in diesem Beispiel werden folgende Module benötigt:

116

117

* ISSRestConnector - Modul zum Abfragen der ISS-Daten

118

* ISSAssetImporter - Modul zum Speichern des Assets und der zugehörigen Custom Fields

119

120

=== **ISSRestConnector** ===

121

122

Das Modul zum Abfragen der ISS-Daten besteht aus einer einfachen Funktion, welche die REST API aufruft und das Ergebnis in ein PSCustomObject konvertiert.

123

124

1. Klicken Sie mit einem Rechtsklick auf den Ordner //ISS_ACMP_Connector//, um das Kontextmenü zu öffnen.

125

1. Wählen Sie im Kontextmenü den Eintrag //Mit Code öffnen //aus, damit direkt das richtige Verzeichnis geöffnet wird.

126

1. Erstellen Sie einen neuen Unterordner mit dem Namen //Modules.//

127

1. Erstellen Sie im Unterordner //Modules //eine neue Datei mit dem Namen //ISSRestConnector.psm1//. Alternativ können Sie auch die anfangs erstellte, leere Datei //Modul.psm1// umbenennen und in den Ordner verschieben.

128

1. Fügen Sie den nachfolgenden Code in die Datei ein.

129

1. Drücken Sie Strg + S, um die Datei zu speichern.

130

131

{{code language="PowerShell" layout="LINENUMBERS" title="**ISSRestConnector.psm1**"}}

132

function Get-ISSData {

133

<#

134

.SYNOPSIS

135

Queries the "Where the ISS at?" API to retrieve satellite data.

136

137

.DESCRIPTION

138

This function fetches the data for the International Space Station (ISS) from the REST API endpoint

139

https://api.wheretheiss.at/v1/satellites/25544 and returns the parsed response.

140

141

.OUTPUTS

142

[PSCustomObject] - A custom object containing the ISS data.

.EXAMPLE

Get-ISSData

# Retrieves the current data for the ISS.

#>

param (

[string]$ApiUrl = "https://api.wheretheiss.at/v1/satellites/25544"

)

try {

# Perform the API request

155

$response = Invoke-RestMethod -Uri $ApiUrl -Method Get

156

157

# Convert the response into a PowerShell object

158

$result = [PSCustomObject]@{

159

Name = $response.name

160

Latitude = $response.latitude.ToString()

161

Longitude = $response.longitude.ToString()

162

Altitude = $response.altitude.ToString()

163

Velocity = $response.velocity.ToString()

}

return $result

} catch {

Write-Error "Failed to fetch ISS data: $_"

}

}

=== **ISSAssetImporter** ===

174

175

Das Modul zum Speichern des Assets und der zugehörigen Custom Fields erstellt das Asset für die ISS, falls es noch nicht vorhanden ist. Außerdem konvertiert es das PSCustomObject zurück in ein integrierbares Datenformat.

176

177

1. Erstellen Sie im Unterordner //Modules //eine neue Datei mit dem Namen //ISSAssetImporter.psm1//.

178

1. Fügen Sie den nachfolgenden Code in die Datei ein.

179

1. Drücken Sie Strg + S, um die Datei zu speichern.

180

181

{{code language="PowerShell" layout="LINENUMBERS" title="**ISSAssetImporter.psm1**"}}

182

function Get-AssetTypeId {

183

param (

184

[string] $AssetTypeName

185

)

186

$assetTypesResult = Acmp-GetAssetTypeList_V1

187

if ($assetTypesResult.ResultCode -ne 0) {

188

Throw "Error while fetching asset types: $($assetTypesResult.ResultMessage)"

189

}

190

$assetType = $assetTypesResult.AssetTypes | Where-Object { $_.Name -eq $assetTypeName }

191

$id = [guid]::Parse($assetType.Id).ToString()

Write-Output $id

}

function New-ISSAsset {

196

param (

197

[PSCustomObject] $Data,

198

[string] $AssetTypeId,

199

[string] $AssetTypeName,

200

[string] $AssetStateId

201

)

202

$newAsset = New-TAsset_V4

203

$newAsset.Id = [guid]::NewGuid().ToString()

204

$newAsset.Name = $Data.Name

205

$newAsset.AssetType = $AssetTypeName

206

$newAsset.AssetTypeId = $AssetTypeId

207

$newAsset.AssetStateId = $AssetStateId

208

209

Write-Output $newAsset

210

}

211

212

function Get-ISSAsset {

213

param(

214

[string] $AssetTypeId,

215

[string] $AssetTypeName,

216

[string] $AssetStateId,

217

$ISS

218

)

219

$assetListResult = Acmp-GetAssetList_V3 -AssetTypeId $AssetTypeId -FilterText "iss"

220

if ($assetListResult.ResultCode -ne 0) {

221

Throw "Error while fetching the asset: $($assetListResult.ResultMessage)"

222

}

223

$assetInfo = $assetListResult.Assets | Where-Object { $_.Name -eq $ISS.Name }

224

if ($null -eq $assetInfo) {

225

$asset = New-ISSAsset -Data $ISS -AssetTypeName $AssetTypeName -AssetTypeId $AssetTypeId -AssetStateId $AssetStateId

226

}

227

else {

228

$assetResult = Acmp-GetAsset_V4 -Id $assetInfo.Id

229

if ($assetResult.ResultCode -ne 0) {

230

Throw "Error while fetching the asset: $($assetResult.ResultMessage)"

231

}

232

$asset = $assetResult.Asset

}

Write-Output $asset

}

function New-CustomField {

param (

[string] $Id,

[string] $Value

)

$customfield = New-TCustomFieldValue_V1

243

$customfield.FieldId = $Id

244

$customfield.Value = $Value

245

246

Write-Output $customfield

247

}

248

249

function Save-CustomFieldList {

param (

$AssetId,

$CustomFieldList

)

$customFieldResult = Acmp-SaveSingleCustomFieldValues_V1 -QueryBase AssetManagement -ObjectId $AssetId -FieldValues $CustomFieldList

255

if ($customFieldResult.ResultCode -ne 0) {

256

Throw "Error while fetching the asset: $($customFieldResult.ResultMessage)"

257

}

258

Write-Host "Success!"

259

}

260

261

function ConvertTo-AssetV1 {

262

param (

263

[PSCustomObject] $AssetV4

264

)

265

$assetv1 = New-TAsset_V1

266

$assetv1.Id = $AssetV4.Id

267

$assetv1.Name = $AssetV4.Name

268

$assetv1.AssetType = $AssetV4.AssetType

269

$assetv1.AssetTypeId = $AssetV4.AssetTypeId

270

$assetv1.AssetStateId = $AssetV4.AssetStateId

271

272

Write-Output $assetv1

273

}

274

275

function Save-ISSAsset {

276

param(

277

[PSCustomObject] $ISSAsset

278

)

279

$convertedAsset = ConvertTo-AssetV1 -AssetV4 $ISSAsset

280

$saveAssetResult = Acmp-SaveAssets_V1 -Assets $convertedAsset

281

if ($saveAssetResult.ResultCode -ne 0) {

282

Throw "Error while saving the asset: $($saveAssetResult.ResultMessage)"

283

}

284

Write-Host "Success!"

}

== PowerShell-Module testen ==

289

290

Die Funktionalität des erstellten Moduls können Sie mithilfe von Pester (dem Standard-Framework für Unit-Testing in PowerShell) oder eines dedizierten PowerShell Scripts verifizieren. So stellen Sie sicher, dass die Logik fehlerfrei und robust ist. In diesem Beispiel wird das Modul //ISSRestConnector.psm1// mit Pester 5.5.0 getestet.

291

292

293

Beachten Sie, dass Sie Pester für diesen Test ggf. vorher installieren oder updaten müssen. Weitere Informationen dazu finden Sie in der __[[Dokumentation von Pester>>https://pester.dev/docs/introduction/installation||rel="noopener noreferrer" target="_blank"]]__.

294

295

296

Sie können das PowerShell-Modul folgendermaßen testen:

297

298

1. Erstellen Sie im Unterordner //Modules //einen neuen Unterordner mit dem Namen //Tests.//

299

1. Erstellen Sie im Unterordner //Tests// eine neue Datei mit dem Namen //ISSRestConnectorTests.ps1//.

300

1. Fügen Sie den nachfolgenden Code in die Datei ein.

301

1. Drücken Sie Strg + S, um die Datei zu speichern.

302

1. Führen Sie das Script aus

303

304

{{code language="PowerShell" layout="LINENUMBERS" title="**ISSRestConnectorTest.ps1**"}}

305

Import-Module -Name Pester -MinimumVersion 5.5.0

306

Remove-Module ".\Modules\ISSRestConnector.psm1" -Force -ErrorAction SilentlyContinue

307

Import-Module -Name ".\Modules\ISSRestConnector.psm1" -Force

308

309

Describe "Get-ISSData Function Tests" {

310

BeforeAll {

311

# Mock the API response

312

$global:MockApiResponse = @{

Name = "iss"

Id = 25544

Latitude = 12.34

Longitude = 56.78

Altitude = 408.5

Velocity = 27600

Visibility = "daylight"

320

Timestamp = [datetime]::Now.ToUniversalTime().Subtract([datetime]::UnixEpoch).TotalSeconds

}

}

Context "When the API responds successfully" {

325

BeforeEach {

326

# Mock the API call

327

Mock -CommandName Invoke-RestMethod -ParameterFilter { $Method -eq 'GET' } -MockWith {

328

return $global:MockApiResponse

329

} -ModuleName "ISSRestConnector"

330

}

331

332

It "Should return a PSCustomObject with expected properties" {

333

$result = Get-ISSData

334

$result | Should -BeOfType PSCustomObject

335

$result.Name | Should -Not -BeNullOrEmpty

336

$result.Latitude | Should -Not -BeNullOrEmpty

337

$result.Longitude | Should -Not -BeNullOrEmpty

338

$result.Altitude | Should -Not -BeNullOrEmpty

339

$result.Velocity | Should -Not -BeNullOrEmpty

340

}

341

342

It "Should correctly map the API response to the output object" {

343

$result = Get-ISSData

344

$result.Name | Should -Be "iss"

345

$result.Latitude | Should -Be "12,34"

346

$result.Longitude | Should -Be "56,78"

347

$result.Altitude | Should -Be "408,5"

348

$result.Velocity | Should -Be "27600"

}

}

Context "When the API fails" {

353

354

It "Should log an error when the API fails" {

355

# Mock a failure in the API call

356

Mock -CommandName Invoke-RestMethod -ParameterFilter { $Method -eq 'GET' } -MockWith {

357

throw "API error"

358

} -ModuleName "ISSRestConnector"

359

360

$error.Clear() # Clear any pre-existing errors

361

Get-ISSData

362

$error[1].Exception.Message | Should -Contain "API error"

}

}

}

(% class="wikigeneratedid" %)

369

Da in diesem Test kein Abruf der tatsächlichen API stattfindet, sondern die API-Daten simuliert werden, wird Ihnen als Ergebnis der beabsichtigte Error //Failed to fetch ISS data: API error //angezeigt. Darüber hinaus sollten die drei Tests erfolgreich gewesen sein.

370

371

(% class="wikigeneratedid" %)

372

[[image:Output_Pester Testing.png||alt="Ergebnis des Modul-Tests mit Pester" data-xwiki-image-style-alignment="center"]]

373

374

== PowerShell-Microservices erstellen ==

375

376

Da die benötigten PowerShell-Module nun erstellt und getestet sind, kann mit der Erstellung der Microservices begonnen werden.

377

378

1. Öffnen Sie die AESB Console und navigieren Sie zum Workspace //Creator - PowerShell//.

379

1. Klicken Sie in der Ribbonleiste im Bereich //Ordner //auf den Button //Hinzufügen// und erstellen Sie den Ordner// ISS ACMP Connector.//

380

1. Wählen Sie den Ordner aus und klicken Sie in der Ribbonleiste im Bereich //PowerShell-Vorlagen //auf den Button //Hinzufügen.//

381

1. Erstellen Sie die Vorlage// ISSRestConnector. //Klicken Sie in der Ribbonleiste auf den Button //Speichern.//

382

1. Wiederholen Sie Schritt 3 und Schritt 4 für die Erstellung der Vorlage //ISSAssetImporter//.

383

384

== PowerShell-Module implementieren ==

385

386

Die Implementierung der Module in die PowerShell-Microservices erfolgt an zwei Stellen: In der Modul-Verwaltung und im Skript-Editor.

387

388

=== PowerShell-Module in der Modul-Verwaltung hochladen ===

389

390

Zunächst müssen Sie den einzelnen PowerShell-Vorlagen die jeweiligen Module zuweisen:

391

392

1. Wählen Sie die PowerShell-Vorlage //ISSRestConnector //aus und klicken Sie in der Ribbonleiste auf den Button //Module//.

393

1. Klicken Sie auf //DLL-/PSM1-/Public API-Module hinzufügen //und geben Sie bei //Dateipfad //den Pfad der Modul-Datei //ISSRestConnector.psm1// an, indem Sie die Datei im Datei-Explorer öffnen.{{aagon.infobox}}Bei korrekter Ordnerstruktur, sollte der Pfad 0000 angegeben werden.{{/aagon.infobox}}

394

1. Klicken Sie auf den Button //Hinzufügen//, um das Modul hochzuladen und klicken Sie in der Modul-Verwaltung auf //OK//, um die Modul-Verwaltung zu schließen.

395

1. Wiederholen Sie die Schritte für den Microservice ISSAssetImporter mit den Modulen //ISSAssetImporter.psm1 //und //ACMP Public API// (Änderung des Modul-Typs erforderlich).

396

397

[[PowerShell-Modul implementieren>>image:PowerShell-Modul implementeren.png||alt="PowerShell-Modul implementieren"]]

398

399

=== PowerShell-Module in Microservice-Skripten aufrufen ===

400

401

Die PowerShell-Module sind nun in der Modul-Verwaltung hochgeladen und können aus Microservice-Skripten heraus aufgerufen werden. Dafür werden nun die Skripte im Skript-Editor angepasst.

402

403

404

In diesem Beispiel werden nur die Event-Skripte angepasst, bei denen für dieses Beispiel eine Anpassung notwendig ist. Die nicht erwähnten Event-Skripte bleiben unverändert. Für allgemeine Informationen zu den Event-Skripten, lesen Sie den Abschnitt [[Aufbau des Skript-Editors>>doc:AESB.110.Workspaces.Powershell.Skript-Editor.WebHome]].

405

406

407

(% class="wikigeneratedid" %)

408

**ISSRestConnector**

409

410

(% class="wikigeneratedid" %)

411

Der ISSRestConnector soll zu einstellbaren Zeiten die Daten von der Rest API holen. Daher werden die Skript-Events //.OnStart// und //.OnExecute //entsprechend angepasst.

412

413

1. Wählen Sie den Microservice //ISSRestConnector //aus und klicken Sie in der Ribbonleiste auf den Button //Skript//.

414

1. Wechseln Sie in den Skript-Tab //OnStart //und fügen Sie den nachfolgenden Code in die Datei ein.

415

1. Wechseln Sie in den Skript-Tab //OnExecute //und fügen Sie den nachfolgenden Code in die Datei ein.

416

417

(% class="wikigeneratedid" %)

418

**ISSAssetImporter**