Testing a URL variable

Before using a newly created URL variable in your App Builder project, it is a good idea to test it to verify that it uses an inbound variable value as expected.

To test a URL variable, use this procedure:

  1. Set up a component in your project to use the URL variable.
    See Using a URL variable.
  2. Save your project.
  3. Launch the project (using the launch icon on the toolbar).
    Your app opens in a new browser tab/window.
  4. Copy the entire URL from the browser Address field.
    The URL should be structured something like this: https://serverNameAndPath:2443/WSWebClient/PlainForm.aspx?page=FormOnly&notitle=1&Form=AppBuilder(SETVARVALUES(arbitraryValue))

    where:

    • serverNameAndPath is the root URL.
    • arbitraryValue is a string that App Builder inserts when the project is launched.
  5. Paste the copied URL into your favorite text editor.
  6. Replace the arbitraryValue part of the URL with a string that uses this syntax:
    URLname=URLtestValue

    where:

    • URLname is the name of the URL variable you want to test.
    • URLtestValue is the value you want that variable to use in your project.
  7. Copy the altered URL to the clipboard.
  8. In your browser, paste the altered URL into the Address field and click Enter.
    The browser launches App Builder using the inbound variable value (URLtestValue) you set. App Builder opens to the Projects dashboard.
  9. Open your project.
When your project opens, the component using the URL variable displays/uses the value you provided in the URL.
Related topics