Introduction to Workspaces

Estimated Reading Time:  10 minutes

Overview

Workspaces is your entry point to the Unqork Designer Platform. The Workspaces page lets you create workspaces to group and organize all your applications and app elements. This organization lets you easily find all your modules, workflows, or reference data.

What You'll Learn

In this article, you'll learn about Workspaces, how to navigate your company environment in Workspaces, the four levels of architecture in Workspaces, and key Workspace terms.

About Workspaces

NOTE  You’ll see the terms app and application used throughout Workspaces. Both words refer to an Unqork application.

Workspaces is your entry point to the Unqork Designer Platform. Unqork Workspaces lets you group and organize all your applications and app elements. This organization lets you easily find all your modules, workflows, or reference data.

Workspaces makes collaboration easy. You can share modules and reference data across workspaces and applications. You can also mark these elements as shared so your collaborators know the elements are in use by multiple apps.

TIP  To learn more about shared Library Elements, see our Unqork Library Elements article.

WARNING  Users assigned to other workspaces can update or access sharedmodules and reference data.

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. You'll see 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.

Navigating Your Company Environment

When you log in to the Unqork Designer Platform, Workspaces is your environment's Environment Level default page. Use this page to create workspaces to group applications and collaborate with your team. Each workspace displays as a tile and lists the apps you added to it.

Here's a preview of an active Environment Level:

A static image of all the settings, options, and attributes you'll find on the Workspaces page of your environment.

Below is a description of links and drop-downs:

  Attribute Description

1

Global Search Icon (Global Search)

Global Search lets you search your company environment at any time, from any navigation level. You can search for workspaces, apps, and app elements. You'll find the Search field at the top right of the page. You must enter at least three characters for results to display.

2

Workspaces

This is your default landing page where you'll organize and build applications. You'll also organize and manage your app elements in Workspaces. App elements are modules, workflows, and reference data.

3

Library ▾

This drop-down lets you view shared Library Elements and Marketplace snippets and templates.A static image displaying the Library Elements and Templates options from the Library drop-down.

  • Library Elements: This is where you'll find a library of shared elements. Shared elements are modules and data collections that you can share and connect to more than one application. Depending on your RBAC (role-based access control) permissions, you can view, edit, and even remove shared elements.

  • Templates: This is where you'll find local snippets and module and workflow templates. Snippets and templates come with preconfigured components to help you get started on your applications. For instance, if you want your application to send an email, you can use the API Specification snippet.

4

Marketplace

Takes you to the Unqork Marketplace. The marketplace offers application blueprints in preconfigured packages, including assets that knock out common configurations all applications need.

5

Help

This link takes you to our Documentation Hub. You can browse documentation to learn more about Unqork, Administration, Workspaces, Release Notes, and more.

TIP  The Documentation Hub is our resource center where you can search all our documentation by topic. Unqork Academy is where you'll find structured, sequential learning.

6

Settings ▾

This drop-down opens the following options:A static image displaying the UDLC Toolkit, Profile, Administration, and Logout options in the Settings drop-down.

  • UDLC Toolkit: Takes you to the Unqork Development Life Cycle Toolkit home page.
  • Profile: Takes you to your Unqork User Profile.
  • Administration: Takes you to our Administration page. This is where you can manage Roles and Permissions, Designer Access, Integrations, Environment settings, and more.
  • Logout: Logs you out of the Unqork Designer Platform.

7

+ Create Workspace

Clicking this button creates a new workspace. You can have a collaborative workspace for a team or create a personal workspace.

8

Recently Modified

Choosing a drop-down option arranges your workspaces, apps, or app elements. You can arrange by Recently Modified, Least Recently Modified, Newest, and Oldest. You can also sort in ascending order (A to Z) or descending order (Z to A).

9

Default Workspace

All new environments come with a prebuilt Default Workspace. This workspace holds all applications until you assign them to a workspace. By default, you cannot remove the Default Workspace.

10

Workspace Tiles

Each workspace has its own tile. Workspace tiles contain the following:

  • The workspace name in the banner at the top of the tile. Clicking the workspace name opens the workspace.

  • When a workspace is modified, the user that modified it and the last time it was modified (in hours, days, or years) displays below the workspace name.

  • The names of up to four applications in the workspace. Clicking an application's name opens that app.

11

(WSRBAC)

The WSRBAC (Workspaces Role-Based Access Control) icon indicates how many users can access the workspace.

TIP  To learn more about WSRBAC, see our Workspaces Role-Based Access Control (WSRBAC) article.

12

... (Ellipsis)

Clicking the ... (ellipsis) button in the banner at the top of the tile displays the following options:A static image displaying the Settings, Workspace Users, and Delete option when clicking a tile's ellipsis.

  • Settings: Lets you modify the Workspace Name* and add a Workspace Description to make it easier to onboard team members or hand off projects.

  • Workspace Users: Opens the the WSRBAC (Workspaces Role-Based Access Control) modal to the right of the Workspaces page. Here you add users and modify workspace permissions.

TIP  To learn more about WSRBAC, see our Workspaces Role-Based Access Control (WSRBAC) article.

  • Delete: Removes the workspace from your environment.

13

Create App

Clicking this button lets you create a new module or workflow-type app in your workspace.

14

Apps

The total number of applications in the workspace.

15

View Workspace

Opens the workspace.

NOTE  You'll learn more about each of these navigation pages in future articles. For now, let's focus on the Workspaces page.

Submitting Feedback

As you navigate the new Workspaces view, you see a icon at the bottom-right corner of your page. Clicking this icon opens a feedback modal A modal is a window that appears on top of the content you are currently viewing.. If at any time you notice an issue or have an idea for an enhancement, submit your feedback using the modal. We're always striving to improve our platform.

A static image displaying the General Platform Feedback option when clicking the blue question mark in the bottom-right corner of the Workspaces page.

Resources