Auto-Links

Mit Auto-Links lassen sich Expressions konfigurieren, um Texte in Tickets zu finden, die automatisch mit einem Link aktualisiert werden sollen. Dies kann nützlich sein, wenn innerhalb von Tickettexten in der Anwendung Tickets schnell auf andere Tickets oder externe Seiten verwiesen werden soll.

Ausdruck

Der Ausdruck nutzt einen regulären Ausdruck, um die gewünschten Texte zu finden. Hierbei gilt als Sonderregel, dass der Ausdruck mindestens eine Gruppe enthalten muss (ein Paar Klammern). Diese muss die erste Gruppe des Ausdrucks sein und markiert die ID, auf welche die Verlinkung dann angewendet wird (z.B. eine Ticket-ID).

Im Beispiel "#((\d[\.\,]?)*\d)" werden die Ziffern, sowie ggf. Tausendertrennzeichen, durch die Klammern eingeschlossen, die Raute aber nicht. In der Verlinkung werden diese Ziffern dann als {id_int} in der URL verwendet.

Siehe https://www.regular-expressions.info/quickstart.html für weitere Informationen, wie reguläre Ausdrücke funktionieren.

Verlinkung und Platzhalter

Die Verlinkung stellt die URL dar, auf die verlinkt werden soll. Folgende Platzhalter können verwendet werden:

  • {id}: dies ist die im Ausdruck markierte ID, ohne Konvertierungen und kann beliebige Zeichen enthalten.
  • {id_int}: dies ist die im Ausdruck markierte ID, umgewandelt in eine ganze Zahl. Mögliche Tausendertrennzeichen sind dadurch entfernt. Bedenken Sie, dass "," oder "." immer als Tausendertrennzeichen interpretiert werden, nicht als Dezimalzeichen. Wenn keine Umwandlung möglich ist, wird dieser Platzhalter nicht ersetzt.
  • {serverurl}: die Basis URL dieses Servers. Diese endet nie mit einem Slash. So muss nicht verwendet, wenn die Verlinkung auf eine externe Seite erstellt wird.

Beispiele

Vordefinierte Verlinkung:

  • Ausdruck #((\d[\.\,]?)*\d)
    • Hiermit werden Text gefunden, bei der auf eine Raute eine oder mehrere Ziffern folgen. Die Ziffern können Tausender-Trennzeichen "." oder "," enthalten.
  • Verlinkung {serverurl}/ticketlist/ticket/{id_int}
    • Der gefundene Ausdruck wird als Verlinkung angezeigt und zeigt auf ein Ticket mit der jeweiligen ID ({id})

Weiteres Beispiel:

  • Ausdruck inv-([a-zA-Z0-9]+)
    • Hiermit werden Ausdrücke gefunden, in denen auf inv- eine Zeichenfolge bestehend aus Buchstaben und Ziffern folgt.
  • Verlinkung https://department.company.com/inventory/{id}/view
    • In der Verlinkung wird die Zeichenfolge benutzt, um entsprechendes Gerät aufzurufen.

Weitere Hinweise

  • Der Ausdruck wird automatisch erweitert, damit keine Treffer innerhalb von HTML-Tags oder bestehender Links gefunden werden.
  • Es wird dringend abgeraten, sogenannte Wildcard-Ausdrücke, wie ".*" oder ".+", zu verwenden. Diese Ausdrücke matchen beliebige Zeichen, wie auch HTML-Steuerungszeichen (<, >, ") und es besteht die Gefahr, dann plötzlich den gesamten Text zu matchen.
  • Der Text des gerenderten Links ist immer der mit dem Ausdruck gefundene originale Text, z.B. "#12.234".
  • Wenn Sie HTML-Zeichen ", <, >, & oder andere Unicode-Zeichen abbilden wollen, dann muss die Unicode-Notation verwendet werden. Z.B. um ein & gefolgt von einem ä zu finden, könnte der Ausdruck so aussehen: &amp;&#228;(\d*).