Workspaces

IBM Financial Services Workbench 3.1-Preview introduces a new way to organize your work. You can now create Workspaces based on your work items and add the projects you are working on to this workspace.

This allows you to focus on certain projects and reduces the time spent on searching for projects. You could for example create a workspace for an application composition project you are currently working on and add also the service projects you need to develop to this workspace. This way you have all pieces in one place that will belong together later. You could also group projects into workspaces that have a common topic or are simply the ones you are interested in.

Introduction

Workspaces can help you organize your work by grouping the projects you are working on into different views. Therefore, you can create as many workspaces as you need. You can add as many projects to a workspace as you want and these can be of any project type. This means you can add any number of application composition projects or service projects to a workspace. The projects in a workspace don't need to have any relation to each other. It is totally up to you how you define your workspaces.

Every workspace has a name that you can change at any time and also a short description that you can use to give a brief overview of the projects inside the workspace. This can help you organise when you have multiple workspaces and will be displayed on a workspace's card in the overview. Furthermore, a workspace also has a dedicated description area providing a WYSIWYG text editor that you can use to document or describe information related to the projects inside this workspace. This can be your personal notes, implementation hints, requirements or just anything you want to have in reach when working on these projects. You can edit this description as soon as the workspace is created.

Note: Workspaces do not have any effect on the projects they contain. It is a means of organisation and does not offer any project-related configuration or similar. If you create a project inside a workspace it will still be visible on the All projects page for all users who have at least read access to the Git repository in which the project resides.

Create a workspace

To create a new workspace visit the My workspaces page in Solution Designer by using the Workspaces link in the navigation bar and click on the Create button. If this will be your first workspace you can also click on the dummy workspace card to create a new workspace.

You then have to give this workspace a name (can be changed at any time) and optionally put a short description in the Notes field that will be displayed on the card of the workspace in the My workspaces overview.

The dialog also lets you quickly add projects to the new workspace by selecting existing projects from the table. Every selected project will be added directly, but you can still add projects later on.

Add projects to a workspace

You can add projects to a workspace at any time by clicking on the Add project button. This will open a dialog where you can choose if you want to

  • add one or more existing project(s) to this workspace

  • create a new project from scratch and add it to this workspace

  • create a new project from a template and add it to this workspace

Add existing project(s)

By clicking on Add existing project(s) you can add any kind of existing project to this workspace. You can add multiple projects at once by selecting them from the list of all available projects. When you are done with the selection, click on Save.

Create project from scratch

By clicking on Create project from scratch you can create a new project and add it to this workspace. This can be any project type and any implementation language no matter if low-code, pro-code or application composition.

If you need to create multiple new projects simply repeat this step.

Create project from template

By clicking on Create project from template you can select a template from the list of available templates and create a new project and add it to this workspace based on the model and implementation of the template project.

If you need to create multiple new projects simply repeat this step.

Edit details of a workspace

By clicking on the Edit details button you can edit the name of the workspace and also the notes that are displayed on the workspace's card in the My workspaces overview.

Edit description of a workspace

By clicking on the Edit description button you open the WYSIWIG text editor. This editor takes Markdown input and also allows you to draw plantUML diagrams in order to add some notes or important information to a workspace. See documentation for further details on how to use the text editor.

Delete a workspace

Use the Delete workspace button in the top right corner of a workspace's page to delete the workspace. You will have to confirm this action.