apps
2024.10
true
- Getting Started
- Before You Begin
- How To
- Notifications
- Using VB Expressions
- Designing your App
- Events and Rules
- Rule: If-Then-Else
- Rule: Open a Page
- Rule: Open URL
- Rule: Close Pop-Over/Bottom Sheet
- Rule: Show Message
- Rule: Show/Hide Spinner
- Rule: Set Value
- Rule: Start Process
- Rule: Reset Values
- Rule: Upload File to Storage Bucket
- Rule: Download File From Storage Bucket
- Rule: Create Entity Record
- Rule: Update Entity Record
- Rule: Delete Entity Record
- Rule: Add to Queue
- Rule: Trigger workflow
- Leveraging RPA in your App
- Leveraging Entities in Your App
- Leveraging Queues in Your App
- Leveraging Media in your app
- Leveraging Actions in your app
- Application Lifecycle Management (ALM)
- Basic Troubleshooting Guide
Set External Context
Apps User Guide
Last updated Nov 11, 2024
Set External Context
You can set up an external context when launching your application. This is especially helpful when starting an app from somewhere else, for example a robotic process automation (RPA) process.
To try setting the external content yourself, use the demo app or follow the procedure.
-
Run the demo app. All the expressions using the
App.QueryParam
function should display their default values. -
To reset expressions to their default values, click the Next page button.
-
Copy the following syntax and append it in the app URL after the
el=vb
part:&intv=3200&guidv="81a130d2-502f-4cf1-a376-63edeb000e9f"&sv=queryparam&bv=true&dv=1000000.222&datetimev="2/1/2022 11:00:00 AM"&datetimeoffv="4/2/2007 7:23:57 PM"&listv={"data":["apps","engineering","team"]}&file={"Name":"image","FileSize":25}
&intv=3200&guidv="81a130d2-502f-4cf1-a376-63edeb000e9f"&sv=queryparam&bv=true&dv=1000000.222&datetimev="2/1/2022 11:00:00 AM"&datetimeoffv="4/2/2007 7:23:57 PM"&listv={"data":["apps","engineering","team"]}&file={"Name":"image","FileSize":25} -
To display an image in the document viewer, add
URL="https://my-public-image-URL"
in thefile
parameter. For example:file={"Name":"image","FileSize":25, URL="https://my-public-image-URL"}
file={"Name":"image","FileSize":25, URL="https://my-public-image-URL"} -
Press Enter and watch the values being updated.
Note:
To reference the external context using VB expressions, use the
App.QueryParam()
function.
Query parameters are case sensitive For example,
intv
and INTV
are treated differently.
- Add a Textbox control.
-
For the Text property, open the Expression editor.
-
Bind the query parameter function to the Text property by using the
App.QueryParam()
function:App.QueryParam(Of Integer)("intv", 100).ToString
App.QueryParam(Of Integer)("intv", 100).ToStringImportant:Inside theApp.QueryParam()
brackets, specify the data type of the value you are passing in the URL. For example, if the value is an integer, you need to specifyApp.QueyParam(Of Integer)
. - Publish the app. At the initial runtime, you should see the default value specified using the
App.QueyParam()
function, which is100
. -
Add query parameters after the
el=vb
part in the runtime URL by using the&
character, then press Enter. For example,el=vb&intv=250
.The textbox should display250
.