Skip to main content

Version: 21.11

Form deployment and security

Prerequisites​

Before deploying Workspaces as an Open UX form, be sure to address the following in your project.

  1. Ensure the index file for the configuration is updated with all the defined spaces required in the application.
  2. Ensure the application's transact-config.json is updated to point to the correct configuration path.
  3. Ensure the application's locale setting is defined correctly in the index file.

Deployment​

Before deploying your form, make sure you have a .transact-auth file at the root of your project with the following details relating to your TJM environment.

tmHost=https://tm.workspaces.avoka-transact.com
username=<your JM username>
password=<your JM password>

Then, run the following command to deploy to that environment:

npm run build:deploy

If JM is sitting behind a proxy, use the following command instead, inserting the relevant details for your environment:

npm run build:deploy -- --proxy-host=<host> --proxy-port=<port> --proxy=username=<username> --proxy-password=<password>
tip

If you're deploying your form to a local instance of JM, make sure the URL does not contain /secure/.

thumb_up Like this: http://localhost:9080/workspaces/app/FORM_CODE/FORM_VERSION

thumb_down Not this: http://localhost:9080/workspaces/secure/app/FORM_CODE/FORM_VERSION

Security​

When you first deploy your form, JM will deploy it, by default, to all the Form Spaces that belong to your Organization with the Authenticated and Anonymous modes enabled. This behavior is expected for normal Open UX forms, but for a Workspaces Form we need to restrict access to the Space where the Workspaces WAR file is deployed to Authenticated mode only.

To achieve this, follow these steps:

  1. Select Forms > Forms.
  2. Search for your Form Name and click it.
  3. Select the Spaces tab. Make sure that only the Workspaces Form Space is in the list. If there are more spaces, remove them.
  4. Click the Edit icon and clear the Anonymous Access checkbox, ensuring only Authenticated Access is enabled.
info

If you have renamed the Workspaces form space to a different name, make sure you associate the correct form space with the Workspaces form in the steps above.

Finally, the Workspaces WAR file comes with default index.htm and logout.htm files that need to be updated with the new form URL, so that all default routes redirect to the new Workspaces Form.

  1. In Journey Manager, select Forms > Form Spaces.

  2. In the list of form spaces, locate the Workspaces form space that you want to edit and click the Edit icon for that space.

  3. Select the Pages tab, and copy the following template into index.htm and logout.htm.

    <html>
      <head>
        <meta http-equiv="Refresh" content="0;URL=/workspaces/app/FORM_CODE/FORM_VERSION" />
      </head>
    </html>

    Replace FORM_CODE and FORM_VERSION with appropriate values for your form.

You're all set now!

We have built-in standard components, mock data, hot module reloading, state management, i18n, and more. Continue exploring this documentation to learn about these topics.