Skip to main content

pswxdom2webapp

The pswxdom2webapp utility converts existing Browser Driver (pswxdom) configuration to JSON that can be used for web apps. The utility locates all Browser Driver access disclosure plugins, including ones created globally and those overridden in the managed system policy (MSP) level. A corresponding web app will be generated for each converted Browser Driver access disclosure by default. Browser Driver access disclosures used at the MSP level will not be converted if none of the disclosure attribute values are overridden.

The pswxdom2webapp utility can be found in the util directory.

The following Browser Driver disclosure attribute settings are converted:

  • checkboxdata

  • constfielddata

  • formatted username

  • passwordfieldids

  • settletime

  • submitbuttonids

  • url

  • usernamefieldids

The following Browser Driver disclosure attribute settings are not converted:

  • denypopups

  • formatted title

  • height

  • uicontrols

  • width

  • simulatekeypress

Notes:

  • simulatekeypress will be supported, but not in Phase 1. A warning message will be given when pswxdom2webapp finds a Browser Driver disclosure that has this setting enabled. A web app will be created, but running it may cause issues if the website relies on keypresses to log in.

  • If a semicolon is used as a submitbuttonids rather than an HTML tag, it will no longer work on web app. This will need to be replaced with an explicit HTML tag.

Usage
pswxdom2webapp.exe [-prefix] [-file] [-force]

Argument

Description

-prefix

Prefix the web app’s name with the specified value.

-file

Convert Browser Driver disclosure configuration to JSON files. This is added to <instance>/webappfiles. This does not commit changes to the database. The JSON files generated can be used to manually create web apps.

-force

Override existing changes made to the database or converted web app files.

Converted global-level Browser Driver disclosure plug-ins will be named: <disclosure plugin>. If the -prefix argument is used, they will be named: <prefix><disclosure-plugin>. Description of the web app will be: Webappjson generated for <disclosure plugin>.

Converted MSP-level Browser Driver disclosure plugins will be named: managed system policy -<disclosure plugin>. If the -prefix argument is used, they will be named: <prefix> managed system policy -<disclosure-plugin>. Description of the web app will be: Webappjson generated for managed system policy / <disclosure plugin>.

If a web app was already generated for a specific Browser Driver disclosure using pswxdom2webapp, it will not be generated again unless -force is used.

Examples

  1. To convert all browser driver disclosures to web app and adding it to the database, assuming none of the browser driver disclosures are converted previously:

    pswxdom2webapp.exe

  2. To convert all browser driver disclosures to web app and add them to the database, regardless if they have already been converted using pswxdom2webapp :

    pswxdom2webapp.exe -force

  3. To convert all browser driver disclosures to web app, but only create JSON configuration files instead of creating web app entries in the database:

    pswxdom2webapp.exe -file

  4. To convert all browser driver disclosures to web app, but only create JSON configuration files regardless if they have already been converted using pswxdom2webapp:

    pswxdom2webapp.exe -file -force
In this section: