UC_CRLF

Verwenden Sie die Script-Funktion UC_CRLF, um einen Zeilenumbruch einzufügen und so den Anfang einer neuen Zeile zu kennzeichnen.

Hinweis: Ab v24 sind CR (Wagenrücklauf) und LF (Zeilenvorschub) ein einziges Zeichen statt wie vorher zwei Zeichen, wenn Sie sie im Kontext von STR_LEN() verwenden. Diese Änderung geht auf die Einführung von UTF-8 zurück. Weitere Informationen zum Ableiten von CR und LF als einzelne Zeichen finden Sie unter HEX_2_STRING.

Syntax

UC_CRLF ()

Beispiele

• Das folgende Script fügt einen Zeilenumbruch zwischen zwei Strings ein:

  : SET   &NL# = UC_CRLF ()
  : SET   &STRING# = "AE &NL#System"
  

  Dadurch wird das Wort "System" hinter dem Wort AE in einer neuen Zeile angezeigt:
  AE
  System

• Im folgenden Beispiel werden zwei Methoden zum Anzeigen einer Benachrichtigungsmeldung mit zwei Textzeilen erläutert. Das Ergebnis ist das gleiche, obwohl Methode 1 eine Script-Anweisung verwendet, um die Script-Funktion newline anzufügen, und Methode 2 eine Script-Variable dafür verwendet.

  Methode 1:

  : PUT_ATT CALL_TEXT = "The workflow MM.DAY is blocked."
  : PUT_ATT_APPEND CALL_TEXT = UC_CRLF ()
  : PUT_ATT_APPEND CALL_TEXT = "Escalation in 10 Minutes."

  Methode 2:

  : SET   &NL# = UC_CRLF ()
  : PUT_ATT CALL_TEXT = "Der Workflow MM.DAY ist blockiert.&NL#Escalation in 10 Minuten."

• Im folgenden Beispiel wird die Script-Funktion UC_CRLF verwendet, um einen Zeilenumbruch in den Text einzufügen, der per E-Mail gesendet werden soll.

  : SET &NL# = UC_CRLF ()
  : SET &TEXT# = "The workflow MM.DAY is blocked.&NL#Escalation in 10 Minutes."
  : SET &RET# = SEND_MAIL ( "smith@automic.at" ,, "A task could not start!" , &TEXT# )

• Das folgende Beispiel erklärt den Unterschied bei der CRLF-Behandlung mit UTF-8 ab v24; Sie können jetzt die neue Script-Funktion HEX_2_STRING verwenden, um CR und LF jeweils als ein einziges Zeichen abzuleiten:

  : SET   &cr# = HEX_2_STRING ( "0D" )
  : SET   &lf# = HEX_2_STRING ( "0A" )

  Das folgende Beispiel kann für Versionen vor v24 verwendet werden. Ab v24 schlägt es mit einem Laufzeitfehler fehl:

  : SET   &crlf# = UC_CRLF ()
  :SET &cr# = substr(&cr#,1,1)
  :SET &lf# = substr(&cr#,2,1)
  

  U00020305 Runtime error in object 'xxx', line '00003'. The start column for the sub-string statement ('002') is not within the string (length '0001').

Siehe auch: