Variablen

Durch Verwendung des Filters jq kann der extrahierte Teil als JSON weiterverarbeitet werden. Er ersetzt den ehemaligen Filter FromJSON. 

Enthält z. B. eine Variable als Wert mehrere Objekte mit Ortsnamen und dessen Geopositionsdaten, so können Sie mittels des jq-Filters gezielt die Orte oder die einzelnen Geopositionsdaten als JSON String extrahieren und anschließend weiterverarbeiten.

Beispiel:Werte eines Objekts

{
   "Objects": [
      {
         "id": "47441",
         "value": "Moers",
         "lattitude": 51.4463,
         "longitude": 6.6396
      },
      {
         "id": "47798",
         "value": "Krefeld",
         "lattitude": 51.3311,
         "longitude": 6.5616
      }
   ]
}

Abb.: Beispiel Verwendung von Variablenfilter

Das Beispiel im Bild initialisiert zunächst eine Variable Test (1. Action). In dieser sind 2 Objekte definiert:

{"Objects":[{"id":"47441","value":"Moers","lattitude":51.4463,"longitude":6.6396},{"id":"47798","value":"Krefeld","lattitude":51.3311,"longitude":6.5616}]}

Mit der 2. Aktion wird ein neues Ticket angelegt. Sowohl in dessen Titel als auch im Artikeltext werden die Variablenwerte ausgegeben. Dazu werden unter Verwendung des Filters jq Teilwerte der Objekte extrahiert und ausgegeben. Durch Angabe von |jq wird dem auswertenden Code mitgeteilt, dass der Wert von Test als JSON betrachtet und somit als Liste mit Objekten verarbeitet werden soll.

Artikeltext:

Test: ${Test|jq(.Objects[]::select(.id=="47441").value)} 
Test2: ${Test|jq(.Objects[]::select(.id == "47798").value)}

Titel:

Test: ${Test|jq(.Objects[]::select(.id == "47441").value)} // Test2: ${Test|jq(.Objects[]::select(.id=="47798").value)}

Bei Ausführung der Aktion werden die angegebenen IDs selektiert und deren unter value definierte Werte im Titel und im Artikeltext des neuen Tickets ausgegeben.

Im Ergebnis entsteht folgendes Ticket:

Abb.: Das resultierende Ticket

Weiterführende Infos finden Sie bspw. unter:

Der Variablenfilter XMLUtil.FromXML ermöglicht die Verwendung von XML-Strukturen als Eingabewerte für Macro Actions (z. B. für XML-Transformation oder Macro Actions mit strukturierten Eingangsparametern) . Voraussetzung ist ein wohlgeformtes XML.

Damit kann bspw. der über die Macro Action "Webhook extended" empfangene XML-String oder der Inhalt einer XML-Datei im E-Mail-Anhang in einer Macro Action weiterverarbeitet werden.

Syntax-Beispiel: ${VariablenName|XMLUtil.FromXML}

Mit dem Filter "DateUtil" können Datums-/Zeit-Angaben extrahiert werden, um sie für automatisierte Berechnungen zu verwenden. Basieren die Ausgangswerte auf Dynamischen Feldern vom Typ Date oder DateTime, können bspw. Termine für Wiedervorlagen oder für die nächste Regelprüfung eines Assets automatisiert berechnet werden. Ein Beispiel dazu finden Sie unter Zeitberechnung mit Macro Actions.

Für die Berechnungen unterstützt der Filter die in der nachfolgenden Tabelle aufgeführten Parameter. Erhalten die Funktionen einen ungültigen Wert (falsches Format oder Fehleingaben), bleibt der Eingabewert unverändert. 

Syntax-Beispiel: ${VariablenName|DateUtil.bob}

Platzhalter für Systemzeiten

Für die Ermittlung von Zeitpunkten können Sie nachfolgende KIX-Platzhalter verwenden. Die Platzhalter sind aktuell nur im Backend verfügbar und dienen dem Auslesen der Systemzeiten. Sie können nicht vom Frontend z. B. in Textbausteinen verwendet werden. 

Die von den Platzhaltern gelieferten Werte müssen zuvor in eine Variable geschrieben werden, um damit anschließend rechnen zu können. 

Platzhalter	Beschreibung	Beispiel
KIX_NOW	liefert den aktuellen (lokalen) Zeitpunkt als TimeStamp	2022-05-30 13:28:08
KIX_NOW_DateTime	liefert vom Zeitstempel das aktuelle (lokale) Datum und die Zeit (analog KIX_NOW)	2022-05-30 13:28:08
KIX_NOW_Date	liefert vom Zeitstempel nur das aktuelle (lokale) Datum	2022-05-30
KIX_NOW_Time	liefert vom Zeitstempel nur die aktuelle (lokale) Zeit	13:28:08

Der Variablenfilter FromBase64 liefert in einer Macro Action den Inhalt einer Base64 codierten Variable decodiert zurück.

Beispiel: Ein Drittsystem liefert ein PDF in Form eines Base64-Strings. Der Filter decodiert den Base64-String, sodass daraus wiederum ein PDF generiert wird. Das PDF kann danach bspw. als Anhang an einem Artikel gespeichert werden.

Syntax-Beispiel: ${VariablenName|FromBase64}

Der Variablenfilter ToBase64 in einer Macro Action codiert den Inhalt einer Variable in einen Base64-String. Es ist damit möglich, bspw. Artikelanhänge in Binärform in Drittsysteme (z. B. DMS "D3") zu übertragen. 

Syntax-Beispiel: ${VariablenName|ToBase64}