messagebox

beasscript-logo-small

Displays a message box or message  in the foot line.

 

messagebox=<typ>$$<text>

 

Error message in Tool bar

BeasScript: messagebox=error$$Hello World

 

message-error

 

Info message in Tool bar

BeasScript: messagebox=info$$Hello World

message-info

Ok message in Tool bar

BeasScript: messagebox=ok$$Hello World

 

message-ok

OK message

BeasScript: messagebox=ok$ok

 

message-okok

Simple popup message

BeasScript: messagebox=hello world

 

message-simple

Messagebox with Placeholder

Beas Script:

string ls_name

ls_name=James Bond

messagebox=Hello <ls_name> Today is <today,dddd dd mmmm yyyy>, <now,hh:mm am/pm>

 

 

message-placeholder

Question

Simple Variant: use command question

BeasScript:

question=Is this correct?=yesfunction()=nofunction()

function yesfunction

messagebox=Thank you

end function

function nofunction

messagebox=Sorry. Next time i'll be better

end function

 

 

question-message

 

 

Extended Messagebox

In follow variant you can create a complex messagebox

Beas Script

messagebox=<typ>$popup=true<tab><parameter><tab><parameter><tab> ....

messagebox({"popup"=true,"parameter"="...","parameter"="..."})

 

 

message-extented

You have many properties. Use the Script assistant to generate the source code

message-assistant

 

 

hmtoggle_plus1Properties

 

Follow properties are available

 

Property

Description

type

First Parameter is the type of window

messagebox=<type>$<properties>

 

 

Type

Description

error

Error message in foot-line (popup=false)

or with ERROR Icon (popup=true)

sql

SQL message

(SQL-Code and SQL-Errtext) in foot line

info

Blue message in foot-line (pupup=false)

Or with INFO Icon (popup=true)

ok

ok message in the foot line (popup=false)
or with OK Icon (popup=true)

question

With a Yes / No Question.

Insert automatically Button 1 and Button 2

 

Return value beas Script

if <messagereturnvalue> n= 1 then

 // yes script

end if

if <messagereturnvalue> n= -1 then

 // no script

end if

 

Example

 

messagebox=question$id=**<tab>&

text=Can i help you<tab>&

modal=true<tab>popup<tab>&

title=Question Message

 

if <messagereturnvalue> n= 1 then

 // Script clicking first button

end if

if <messagereturnvalue> n= -1 then

 // Script for second button

end if

 

message-question

 

Return value PowerScript

No  = -1, Yes = 1

questino-no

Like Question but default = No

text

Return the translated Text in variable value

none

Remove existing message into SBO status bar. This type only applies to SBO status bar.

It is mandatory to set a value into test

message=None$XXX

id=xx

Id of Message

Use this, to define unique ID (Better support) and for translation in other language

text

Errortext of Message

 

Line Feed

Normal text: <cr_lf>, html: <br />)

 

if you insert the placeholder <html><body> then beas will display the text in html-format

if you don't set a <style> between <html> and <body> then beas will insert a standard-style

 

Example

messagebox=info$<body>hello<br/>world</body>

or

messagebox=info$id=2442324<tab>text=<body>hello <i>world</i></body>

 

if you work with html, please use HTML syntax

messagebox=info$<body>10 &gt; 5</body> // display 10 > 5

 

double quotes, single quotes

only double and single quotes converted autoamtically.

messagebox=info$<body>hello "world"/body> // working fine

 

if you don't want to send html-tags, example item description, you can convert this with tohtml function

messagebox=info$<body>Item Name: <b><dw_1.item.itemname.value,tohtml></body> 

With this concept the system convert all html tags to visible text finromation.

 

popup=true

Use a separat Window for output the Message

Standard: off

if you set the placeholder "<body>" in the text, beas will be set the popup-Value to true

shared

Display Message and continue the program

otherwise the current program is waiting (modal - only for current window)

noalert

title

Title of the popup window

button1 ... button4

Set button 1 (the second button)

with button1command you can set the function to execute

linefeeds=<linefeed>

 

You need command "form.close" to close the message

 

Example

messagebox=info$popup=true<tab>text=Button Click Test<tab>&

button1=Hello world<tab>&

button1command=message=click on hello world<linefeed>form.close

topic

Link to help (topic id)

only beas own documentation. For link to another documentation or internet pages, use button command

setup

link to configuration wizzard

bitmap

Bitmap of the left top side

Error: bmp/gfx/big_cancel

info:   bmp/gfx/big_ok

question: bmp/gfx/big_question

 

Example

messagebox=info$bitmap=bmp\gfx\big_advertising.png<tab>&

popup=true<tab>text=Hello, important message!

 

message-bitmap

yes / no

set value for messagereturnaction

 

Example Beas Script

messagebox=question$popup=true<tab>text=Is this ok<tab>yes=yesanswer<tab>no=nowanswer

messagebox=Answer =  <messagereturnaction> : <messagereturnvalue>

 

Result is

Button Yes: yesanswer :  1
Button No:   noanswer : -1

yestext

notext

you can overwrite the text for button "OK" and  "Cancel"

 

messagebox=question$popup=true<tab>text=Is this ok<tab>yestext=All ok<tab>notext=Not ok

readcheck=id

Use this, if you give the user the possibility to ignore this message in future

The id must be unique and can be same number as id property

 

Beas Script: messagebox=info$popup=true$text=This is my warning message$readcheck=beas0001

 

message-readid

 

if the User click on "do not show anymore", then beas don't open the message again

This is user-database related.

 

If you want that the User see all messages again:

- open SAP User - Setup

- choose the User

- right click

- show disabled messages

message-user

 

Info

Don't use beas as prefix. Use own company name as prefix for the id

 

 

 

hmtoggle_plus1Working with HTML Messages

 

if keyword "<html>" or "<body> inside the message text, beas display the text in an internet explorer window

if you don't define <body>, beas use HTML Standard format
if you define only <body>, beas use own CSS Style

 

Note: Don't use escape signes in the Text

 

messagebox=info$popup=true<tab>text=<body>Hello world</body>

 

message-html1

 

You can use every html style and can create html tables

 

// Define First line of HTML ad variable htmltext

// with #define we don't need the & sign for define next row.

// it's simple to define in this way

#define htmltext
<i>Hello</i>, this is a <b>good</b> example<br />
<small>I like this type of messages</small>
<table border=2>
<tr><td>ItemCode</td><td>Description</td></tr>
#end
 
// Create a datastore and read first 10 items
// add this with table attributes to the variable htmltext
declare=d=ue_datastorevalues
d.select top 10 "ItemCode","ItemName" from "OITM" order by "ItemCode"
for ll_loop=1 to <d.rowcount>
  d.setrow=<ll_loop>
  addvar=htmltext=<tr><td><d.itemcode,tohtml></td><td><d.itemname,tohtml></td></tr>
next
destroy=d
// add end of table
addvar=htmltext=</table>
// and display this. Use keyword <body>
messagebox=info$popup=true<tab>text=<html><body><htmltext></body></html>

 

message-html2

 

Escape signs

The system convert escape signs automatically!

Correct: text=Hello "World". Result: Hello "World"

Wrong: text=Hello /"World/".  Result: Hello /"World/"

 

If you want to display a HTML 1:1 with escape signs you can open the used window directly:

openchild=system_message.psr<tab>as_typ=info<tab>modal=true<tab>as_content=<body>Hello /"World/"</body>

 

Working with pictures

 

In Background we don't have a WEB Server. All is files based

We need always full path form local system or complete network path

 

Attribute to display pictures

<img src="pic_trulli.jpg">

 

setvar=htmltext=&

Example with picture<br/>&

<img src="<system.homefolder>bmp\gfx\big_time.png">

 

messagebox=info$popup=true<tab>text=<body><htmltext></body>

 

message-html3

 

hmtoggle_plus1Translation concept

 

With the message id  you can define every message as unique id

In translation system you can define the translation per language and id

 

Standard messages:

in file [homefolder]\program\language_e.src you can find the complete translation table

in area "M:[id]" you can see the message id's and on right side the Text

 

Example: M:feinb1 = Item <art_id> does not exist!
 
You can use it with

string art_id
art_id=Sofa001
messagebox=info$feinb1$

 

But for better reading of source code

messagebox=info$feinb1$Item <art_id> does not exist

 

Own translation

 

For customizing multilanguage you can define own translation table

AddOn Administration (beas) -> Edit -> Language -> Edit Message -> Define Language, Meessage No and Message text

 

message-translation

 

Now you can use it
As example we use german text and user interface is current english

 

string ls_itemcode

ls_itemcode=Sofa001

messagebox=info$id=beas0001<tab>popup<tab>text=Verwende nicht den Artikel <ls_itemcode>

 

message-translation-example

 

or as simple variant - in bottom line

 

messagebox=info$beas0001$Verwende nicht den Artikel <ls_itemcode>

 
hmtoggle_plus1Message with Protocol

 

with (properties) after message type you can define additional log entries

 

message=error(propertie,propertie2)$messageid$message

 

shortprotocol

beas create a short protocoll in extra / system / protocoll and a short version in help/suport

longprotocol

beas create a short protocoll in extra / system / protocoll and a long version in help/suport

errorprotocol

beas create a protocoll as error-protocoll in help/support / report

 

Example

messagebox=error(shortprotocol)$$This is my next with copy in shortprotocol