GET_ATT_SUBSTR

Verwenden Sie die Script-Funktion GET_ATT_SUBSTR, um einen Teil des Meldungstexts eines Benachrichtigungsobjekts abzurufen. Sie können sie nur auf der Seite Prozess des entsprechenden Benachrichtigungsobjekts verwenden.

Hinweis: Wenn -sie eine :PUT_ATT_APPEND-Script-Anweisung vor dieser Script-Funktion verwenden, wird der Teil dem erweiterten Meldungstext entnommen. Weitere Informationen finden Sie unter :PUT_ATT_APPEND.

Syntax

GET_ATT_SUBSTR (CALL_TEXT, Anfang, Länge)

Parameter

• GET_ATT_SUBSTR
  Ruft einen Teil des Meldungstexts einer Benachrichtigung ab
• CALL_TEXT
  Name des Attributs, dessen Wert teilweise gelesen werden soll
  Format: AE Name oder Script-Variable
  Zulässiger Wert: CALL_TEXT
• Anfang
  Startposition für den Lesevorgang
  Format: Zahl oder Script-Variable
  Wichtig! Mit der Einführung von UTF-8 bezieht dieser Parameter sich auf die Zeichenposition und nicht auf die Byteposition. Beispielsweise gibt der Wert „7“ das 7. Zeichen und nicht zwangsläufig das 7. Byte an.
• Länge
  Anzahl von Zeichen, die gelesen werden sollen
  Format: Zahl oder Script-Variable
  Wichtig! Mit der Einführung von UTF-8 bezieht dieser Parameter sich auf die Anzahl der Zeichen und nicht auf die Anzahl der Byte. Beispielsweise gibt der Wert „10“ Zeichen an, es kann jedoch zehn oder mehr Bytes enthalten.
  

  Hinweis: Wenn Sie ab v11 eine Länge angeben, die größer ist als die tatsächliche Länge des Meldungstextes, erhalten Sie eine Fehlermeldung.

Rückgabewerte

Die Script-Funktion hat die folgenden Rückgabewerte:

• Teil des Meldungstextes
• " "
  Der angegebene Bereich liegt nicht innerhalb des Meldungstextes.

Beispiel

Im Beispiel werden die ersten 20 Zeichen des Meldungstextes gelesen.

: SET   &SECTION# = GET_ATT_SUBSTR (CALL_TEXT,1,20)

Siehe auch: