This article describes the process of migrating Journey Workspaces v19.11 configuration to v20.05.
- Request a CI/CD Maven project for Workspaces v20.
- Install Node.JS (min. install), Yarn and Git in local developer environments.
- Migrate Space properties (global, process, etc.) by:
- Create TypeScript .ts files per property.
- Remove the
spacesattribute from global space property .ts file and append each entry into the respective space property .ts file - Remove
localesandcurrentLocalefrom global space property .ts file. Note: locale details are loaded viaindex.jsx - Prepend
configimport declaration to each .ts file:import { Config } from '@transact-open-ux/workspaces/dist/types'; - Append default export declaration to each .ts file:
export default helpdeskConfig; - Wrap JSON with export declaration:
export const helpdeskConfig = ({ date, currentUser }: any): Config => ( {'my json':'is here'} ); - Run
yarn prettierto correct/convert JSON to Type Script - Review and correct configuration type references:
- global theme
accentattribute not longer supported - current space
value,titleattributes not longer supported - current space
actionsattribute replaced withtxnActionsandjobActionsdefinitions - filter options
pickertype replaced withdaterangepicker,datepicker - icon attribute no longer supported for
listExtended,tableExtended - un-escape date function declarations, e.g.: from this:
to this:taskCreated: ["{{ date('1 year ago') }}", "{{ date('1 week ago') }}"]$taskCreated: [date('1 year ago'), date('1 week ago')] - etc... Also refer to included default & springboard configuration examples.
- global theme
- Update
index.jsxto load required config and locale messages. - Set JM instance details in
.transact-authand usenpm run deploy(oryarn deploy) to deploy form. - Update Form Space
index.htmto auto-redirect to Workspaces form:
<html> <head><meta http-equiv="Refresh" content="0;URL=/workspaces/app/workspaces"></head> </html> - Update Form Space
logout.htmto auto-redirect toindex.htm:
<html> <head><meta http-equiv="Refresh" content="0;URL=/workspaces/index.htm"></head> </html>