Actions.xml

In der Actions.xml-Datei können Aktionen definiert werden, welche vom IBI-aws WebCLI auf Anfrage ausgeführt werden. Die Grundstruktur der Actions.xml-Datei sieht wie folgt aus:

CODE

<?xml version="1.0" encoding="utf-8" ?>
<actions>

	<action id="">
		<processName></processName>
		<arguments></arguments>
	</action>

</actions>

<action>-Element: Definiert eine Aktion, welche vom WebCLI ausgelöst werden kann.
id-Attribut: Anhand des id-Attributs kann ein Client steuern, welche Aktion ausgelöst werden soll.
<processName>-Element: Name oder Pfad der Anwendung, die gestartet werden soll.
<arguments>-Element (optional): Wird angegeben, wenn die Anwendung mit Parametern gestartet werden soll. Über die arguments wird es den Clients auch ermöglicht, zusätzliche Inhalte anzugeben. Mehr dazu unter Verwendung von Parametern.

Verwendung von Parametern

Innerhalb der arguments kann der Platzhalter {%Parameters%} angegeben werden.

Die Argumente, die über den HTTP/S-Request-Body an die WebCLI übermittelt werden, werden an dieser Stelle kodiert und in Base64-Format eingefügt, wenn die Aktion ausgeführt wird. Dies ermöglicht die weitere Verarbeitung von Daten, beispielsweise durch PowerShell-Skripte.

Beispiel Actions.xml

In diesem Beispiel sind zwei Aktionen definiert, um mithilfe von PowerShell-Skripten IBI-aws Hinweise anzulegen. Beide Aktionen enthalten die folgenden Informationen:

Die zu startende Anwendung ist die PowerShell.
Als Parameter werden PowerShell-Skripte angegeben.
In den arguments werden die vom Client übermittelten Inhalte über den {%Parameters%}-Platzhalter Base64-kodiert eingeschleust. Diese Inhalte werden wiederum von den PowerShell-Skripten dekodiert und weiterverarbeitet.

XML

<?xml version="1.0" encoding="utf-8" ?>
<actions>

	<action id="CreateAwsMessage">
		<processName>powershell</processName>
		<arguments>-ExecutionPolicy Bypass "..\Scripts\create_aws_message.ps1" "{%Parameters%}"</arguments>
	</action>

	<action id="CreateAwsMessageByTemplate">
		<processName>powershell</processName>
		<arguments>-ExecutionPolicy Bypass "..\Scripts\create_aws_message_by_template.ps1" "{%Parameters%}"</arguments>
	</action>

</actions>