gn:act setFormat

gn:act_setFormat

Description

Action used to set format to a target when the target is printed out as string.

i.e. gn:act_sendEmail converts values to string values before sending them via email. If we would like to send gps location in some url and not as raw value then we would format the target which holds gps before using email action.

Action returns

void

Action signatures

[gn:act_setFormat]|[target, format]

Parameter	Description
target	target target to which format will be set. Valid target: email GPS number phoneNumber
format	format Format which will be set on target. Format needs to be stored into a text datatype or a string resource. Valid source: text Valid formats: default keyword. If set the format will be reset to internal default format. for email use formatting rules default format: %1$s : %2$s (name,email) for GPS use formatting rules default format: %1$s:%2$s (latitude,longitude) for number use formatting rules default format: 0.00 for phoneNumber use formatting rules default format: %1$s : %2$s : %3$s (name,info,phonenumber) for banking use formatting rules default format: %1$s : %2$s : %3$s (IBAN,BIC,bank)

Example

initial format

@variable/medicalAlert_phone_serialNumber = 0.00

initial value outputed as string

273743762924508.00

variables.xml

<variable id="medicalAlert_phone_serialNumber" type="number" defaultValue=""></variable>

strings.xml

<string name="formatNumber">#</string>

screen.xml

<FrameLayout
    android:id="@+id/exampleFrame"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:visibility="gone"
    gn:act_set="[gn:act_setFormat]|[@variable/medicalAlert_phone_serialNumber,@string/formatNumber];" />

after action execution format

@variable/medicalAlert_phone_serialNumber = #

after action execution value outputed as string

273743762924508

---