Last modified by jklein on 2025/02/13 13:15
From version 22.1
edited by jklein
on 2025/02/06 14:18
Change comment: There is no comment for this version
To version 27.1
edited by jklein
on 2025/02/10 14:58
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -392,9 +392,9 @@
392 392  1. Wählen Sie die PowerShell-Vorlage //ISSRestConnector //aus und klicken Sie in der Ribbonleiste auf den Button //Module//.
393 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 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 der Public API
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 396  
397 --> Bild einfügen
397 +[[PowerShell-Modul implementieren>>image:PowerShell-Modul implementeren.png||alt="PowerShell-Modul implementieren" data-xwiki-image-style-alignment="center" height="355" width="800"]]
398 398  
399 399  === PowerShell-Module in Microservice-Skripten aufrufen ===
400 400  
... ... @@ -401,12 +401,128 @@
401 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 402  
403 403  {{aagon.warnungsbox}}
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.
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 405  {{/aagon.warnungsbox}}
406 406  
407 407  (% class="wikigeneratedid" %)
408 +**ISSRestConnector**
409 +
410 +(% class="wikigeneratedid" %)
411 +Der ISSRestConnector soll zu einstellbaren Zeiten die Daten von der Rest API holen. Dafür 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 +1. Drücken Sie Strg + S, um die Datei zu speichern.
417 +1. Schließen Sie den Skript-Editor.
418 +
419 +{{code language="PowerShell" layout="LINENUMBERS" title="**ISSRestConnector.OnStart**"}}
420 +#
421 +# This gets executed once the Microservice has started.
422 +#
423 +
424 +$message = "Starting ISS2ACMP.REST"
408 408  
426 +Write-Host $message
427 +Write-BusinessLog $message
409 409  
429 +# Registering Alias
430 +Set-AESBSelfAsAlias -Alias $configuration.Alias -RemoveExistingAlias
431 +{{/code}}
432 +
433 +{{code language="PowerShell" layout="LINENUMBERS" title="**ISSRestConnector.OnExecute**"}}
434 +#
435 +# This gets executed perpetually by the scheduler. Main business logic should go here.
436 +#
437 +
438 +try {
439 + # Trying to fetch new data
440 + Write-Host "Fetching new data from the api."
441 + $result = Get-ISSData -ApiUrl $configuration.ApiUrl
442 +
443 + # Converting the data to icql
444 + $icql = ConvertTo-AESBIcql $result
445 +
446 + # Sending the data to the next microserice
447 + Publish-AESBMessage -Alias $configuration.Target -Message $icql
448 +}
449 +catch {
450 + Write-Error $_
451 +}
452 +{{/code}}
453 +
454 +(% class="wikigeneratedid" %)
455 +**ISSAssetImporter**
456 +
457 +(% class="wikigeneratedid" %)
458 +Der ISSAssetImporter soll eingehende Nachrichten des ISSRestConnectors in ein gültiges Asset umwandeln und dieses mit den definierten Custom Fields in das Asset Management von ACMP eintragen. Dafür werden die Skript-Events //.OnStart// und //.OnMessage //entsprechend angepasst.
459 +
460 +1. Wählen Sie den Microservice //ISSAssetImporter //aus und klicken Sie in der Ribbonleiste auf den Button //Skript//.
461 +1. Wechseln Sie in den Skript-Tab //OnStart //und fügen Sie den nachfolgenden Code in die Datei ein.
462 +1. Wechseln Sie in den Skript-Tab //OnMessage //und fügen Sie den nachfolgenden Code in die Datei ein.
463 +1. Drücken Sie Strg + S, um die Datei zu speichern.
464 +1. Schließen Sie den Skript-Editor.
465 +
466 +{{code language="PowerShell" layout="LINENUMBERS" title="**ISSAssetImporter.OnStart**"}}
467 +#
468 +# This gets executed once the Microservice has started.
469 +#
470 +
471 +$message = "Starting ISS2ACMP.ACMPImporter"
472 +
473 +Write-Host $message
474 +Write-BusinessLog $message
475 +
476 +# Registering Alias
477 +Set-AESBSelfAsAlias -Alias $configuration.Alias -RemoveExistingAlias
478 +{{/code}}
479 +
480 +{{code language="PowerShell" layout="LINENUMBERS" title="**ISSAssetImporter.OnMessage**"}}
481 +#
482 +# This gets executed when a message is received.
483 +#
484 +# The received message can be accessed via $msg
485 +# To retrieve only the body from the message use $body
486 +#
487 +
488 +# Getting msg data
489 +$msg = New-Message -Args $args
490 +$body = New-MessageBody -Args $args
491 +
492 +# Converting from icql to PSCustomObject
493 +$data = ConvertFrom-AESBIcql -Icql $body
494 +Write-Host $data
495 +
496 +# Getting the AssetTypeId
497 +$assetTypeId = Get-AssetTypeId -AssetTypeName $configuration.Acmp.AssetTypeName
498 +
499 +# Trying to get the asset if it is already present in acmp
500 +$asset = Get-ISSAsset -AssetTypeId $assetTypeId -AssetTypeName $configuration.Acmp.AssetTypeName -AssetStateId $configuration.Acmp.AssetStateId -ISS $data
501 +
502 +# Saving the asset
503 +Save-ISSAsset -ISSAsset $asset
504 +
505 +# Creating the custom fields
506 +$customFieldList = @()
507 +$customFieldList += New-CustomField -Id $configuration.Acmp.CustomFields.Latitude -Value $data.Latitude
508 +$customFieldList += New-CustomField -Id $configuration.Acmp.CustomFields.Longitude -Value $data.Longitude
509 +$customFieldList += New-CustomField -Id $configuration.Acmp.CustomFields.Altitude -Value $data.Altitude
510 +$customFieldList += New-CustomField -Id $configuration.Acmp.CustomFields.Velocity -Value $data.Velocity
511 +
512 +# Saving the custom fields
513 +Save-CustomFieldList -AssetId $asset.Id -CustomFieldList $customFieldList
514 +{{/code}}
515 +
410 410  = Fehlerbehandlung =
411 411  
518 +Die Fehlerbehandlung unterscheidet sich je nach System, in welches die Daten integriert werden sollen. Abhängig vom Zeitpunkt der Entwicklung, an dem ein Fehler auftritt, gibt es in diesem Beispiel mehrere Ansätze zur Fehlerbehandlung. Außerdem ist es immer hilfreich, die Informationen aus dem Logging der AESB Console zu beachten.
519 +
520 +|=(% style="width: 715px;" %)Fehler|=(% style="width: 724px;" %)Ansätze zur Fehlerbehandlung
521 +|(% style="width:715px" %)Die AESB Shell lässt sich nicht in Visual Studio Code einrichten.|(% style="width:724px" %)Überprüfen Sie die Korrektheit des Pfads der AESB Shell, der in der Datei //Microsoft.VSCode_profile.ps1 //angegeben ist.
522 +|(% style="width:715px" %)Der Test der PowerShell-Module schlägt fehl.|(% style="width:724px" %)Beachten Sie den Fehlercode in Visual Studio Code. Überprüfen Sie ggf. die eingestellte Sprache in Visual Studio Code, da bei falscher Spracheinstellung möglicherweise Syntaxfehler auftreten können.
523 +|(% style="width:715px" %)Die Verbindung zur ACMP Console kann nicht hergestellt werden.|(% style="width:724px" %)Überprüfen und testen Sie die [[Konfiguration der SICS-Verbindung und die Zugriffsberechtigung in ACMP>>doc:AESB.110.AESB installieren, konfigurieren und aktualisieren.SICS-Verbindung konfigurieren.WebHome]]. Prüfen Sie außerdem, ob die SICS-Verbindung möglicherweise ausgefallen ist.
524 +|(% style="width:715px" %)Die Werte wurden nicht in die benutzerdefinierten Felder importiert.|(% style="width:724px" %)Überprüfen Sie das Logging in der AESB Console. Möglicherweise wurden die benutzerdefinierten Felder nicht gefunden, da sie fehlerhaft angelegt wurden.
525 +
412 412  = Orchestrierung =
527 +
528 +
PowerShell-Modul implementeren.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Size
... ... @@ -1,0 +1,1 @@
1 +29.6 KB
Content
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community