Introduction to Workspaces

 

Estimated Reading Time:  5 minutes

Overview

A workspace is where you create, store, and organize elements Elements are are what you use to build Unqork applications. Elements include modules, workflows, Data Collections, Data Schema, and Record Collections., like applications and record collections. In a workspace, you can create module and workflow-type applications, view other team member's workspaces, add descriptions, and so on. Workspaces are organized on your UDesigner homepage with all other Workspaces elements. Your and your team's workspaces also display on the All Workspaces page. By default, they are organized by last modified, placing them at the top of the grid for easier access. You can also star Starring elements stores them in the Starred tab of your UDesigner homepage for quick access. You can star any element, regardless if it's yours or belongs to another team member. your most important workspaces to locate them faster and continue building.

TIP  To learn more about the UDesigner homepage, view our Navigating the Homepage article.

Workspaces Levels

The architecture of Workspaces consists of four levels:

  • Environment Level: The Environment Level is the highest level in the architecture and is where your workspaces exist.
  • Workspace Level: At the Workspace Level, you can access any applications that are part of that workspace.
  • Application Level: The Application Level is where you access the app elements in your application. The application level displays the number of App and Library Elements associated with that application.
  • Application Element Level: App elements are modules, workflows, and reference data. The App Element Level is where you edit a module, workflow, or data collection.

Here's a high-level overview of the layout of Workspaces:

A static image displaying Unqork's environment, app, and app element level architecture.

Workspaces Terms

Here are some key terms and concepts for Workspaces:

Term

Description

Workspaces

The name of Unqork's approach to building applications. For example, logging into the Workspaces page of your environment.

workspace

The container where creators can group applications and shared elements. You can have a collaborative workspace for a team,or create a personal workspace.

App Element

An element used when building an application. Modules, workflows, and reference data are all app elements.

Library Elements

App elements available (shared) across a level. Library Elements at the Environment Level are available to all workspaces. Library Elements at the Workspace Level are available to applications in that workspace. You can connect Library Elements to any of your applications.

Environment Stage

Environment stages (or levels) support each phase of building and rendering applications. Generally, there are three environmental stages for each environment:

  • Customer Staging: Where most of the application building and testing occurs.

  • UAT (User Acceptance Testing): Where creators and the client can view the application with complete or near-complete content.

  • Production: Where the application goes live after testing is complete.

Some applications move through five environment stages. These additional environment stages include dedicated QA (Quality Assurance) and Pre-production stages. In place of dedicated QA environment stages, many teams use the UAT or Customer Staging level.

Creating a Workspace

To begin building Unqork applications, you first need to create a workspace.

To create a workspace:

1. Log into UDesigner using your login credentials.
2. At the top right of the UDesigner homepage, click + Create New.
3. From the drop-down, click Workspace.
4. In the Workspace Name* field, enter a unique name for your workspace.

TIP  It's best practice to choose a name that helps you and your team identify who owns the workspace or its function.

5. (Optional) In the Workspace Description field, add a description of the workspace.

TIP  Adding descriptions makes it easier for you and your team to understand the workspace's function.

6. Click Create Workspace

By default, any new workspace created displays at the top of the My Recents grid on your UDesigner homepage.

Viewing a Workspace

After creating your workspace, open it to begin building Unqork applications. The workspace view displays all your app elements Elements are are what you use to build Unqork applications. Elements include modules, workflows, Data Collections, Data Schema, and Record Collections.. You can search for or filter by an element, sort the grid, and view any of the elements. The elements that display depend on your configuration. They can include modules, workflows, Data Collections, and Data Schema.

Viewing Your Workspaces

The UDesigner homepage only displays workspaces created by you.

To view your workspace from the UDesigner homepage:

1. On the UDesigner homepage, locate the workspace you want to view. You can access your workspaces from the My Recents or Starred tabs.
2. In the row of that workspace, click the application's name, or click View. Your workspace opens in a new tab.

A static image displaying UDesigner homepage, in the my recents list, the Workspace's name and View button are highlighted.

Viewing a Workspace Page From All Workspaces

Accessing the All Workspaces page lets you view all workspaces in your environment. Here you can locate and view your workspaces or another team member's workspace.

TIP  To learn more about navigating the All Workspaces page, view our Navigating All Workspaces article.

To view a workspace from the All Workspaces page:

1. At the top of the UDesigner homepage, click Workspaces.
2. On  the Workspaces page, locate the workspace you want to view.
3. Click View Workspace. Your workspace opens in a new tab.

A static image displaying the View Workspace button to view a workspace from the All Workspaces page.

Resources