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
spaces
attribute from global space property .ts file and append each entry into the respective space property .ts file - Remove
locales
andcurrentLocale
from global space property .ts file. Note: locale details are loaded viaindex.jsx
- Prepend
config
import 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 prettier
to correct/convert JSON to Type Script - Review and correct configuration type references:
- global theme
accent
attribute not longer supported - current space
value
,title
attributes not longer supported - current space
actions
attribute replaced withtxnActions
andjobActions
definitions - filter options
picker
type 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.jsx
to load required config and locale messages. - Set JM instance details in
.transact-auth
and usenpm run deploy
(oryarn deploy
) to deploy form. - Update Form Space
index.htm
to auto-redirect to Workspaces form:
<html> <head><meta http-equiv="Refresh" content="0;URL=/workspaces/app/workspaces"></head> </html>
- Update Form Space
logout.htm
to auto-redirect toindex.htm
:
<html> <head><meta http-equiv="Refresh" content="0;URL=/workspaces/index.htm"></head> </html>