Unqork Library Elements

Overview

Library Elements are shared modules and Data Collections available to one or more applications in an environment. Creators Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. assign access and usage to a shared element by specifying if it's available to the entire environment, a specific workspace or application.

Library elements are not available with versioned applications.

To learn more about Library Elements, click on the buttons below:

Accessing and Navigating the Library Element Ellipsis Menus

Accessing the Library

You can access the Library from any page of your Unqork environment. Click the Library link in the top menu bar and click Library Elements.

Static image displaying the Library settings menu expanded with the Library Elements setting highlighted in UDesigner.

Navigating the Library

The Library Elements page displays a list of elements shared in the environment. From this page, Creators can view shared modules or Data Collections, and access each shared element's settings.

Library Elements have purple tiles, versus the traditional gray.

A static image displaying the Library Elements page.

  Setting Description

1

+ Create New

Create a shared module or Data Collection. Learn how to create shared elements in the Creating and Sharing a New Element section.

2

Elements

Displays elements of the chosen type. Elements include:

  • Modules: Modules that have been shared with the environment or workspaces.

  • Data Collections: Data Collections that have been shared with the environment or workspaces.

3

Filter Tags & Recently Modified

Click Filter Tags to display a search field. Enter a value to search for the Shared Elements list. Search results are sorted by the Recently Modified value.

Click Recently Modified to display a drop-down list of sorting methods. Sort Methods include:

  • Recently Modified: Sorts elements in the list by their most recently modified date .

  • Least Recently Modified: Sorts elements in the list by their least recently modified date.

  • Newest: Sorts elements in the list by their most recently modified date

  • Oldest: Sorts elements in the list by their least recently modified date.

  • A-Z: Sorts items in the list in descending order by the first letter of the module name. Numerical and non-standard letters come before the letter A.

  • Z-A: Sorts the list in descending order by the first letter of the module name.

4

Shared Element List

Displays a list of element cards. Each card contains an element shared with the environment or workspaces.

5

(ellipsis)

(Shared Element Settings)

Click to display a list of options. See the following sections for a detailed list of options:

6

Access & Usage

Opens the Access & Usage settings modal for the shared element.

Navigating the Module Library Elements Ellipsis Menu

In the Library Elements page, click the Modules tab to the left. Open the ellipsis (···) menu to find the following settings:

Static image displaying the module ellipsis menu settings for library elements in UDesigner.

Option

Description

Settings

Lets you update the module's name, path, ID, and tags. These changes take effect everywhere you reference the module in your environment.

 Preview

Opens your module in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.. Express View displays your application as your end-user sees it.

 Duplicate

Creates a copy of the module with all its information and settings.

 Access & Usage

Displays a pop-up modal A modal is a window that appears on top of the content you are currently viewing. where you control your element's shared location(s).

Set Element Access & Usage

A drop-down where you select where to share your element:

  • Share to Select Workspaces: Lets you limit which of your environment's workspaces you want to share your Library Element.

  • Share to Environment: Your element is available to all current and future workspaces in your environment.

  • Unshare from Library: Removes your element from the Library. You can only unshare an element if no more than one app connects to and uses it. Your element still shows in the environment anywhere you reference it.

Edit

To make any changes, set to  (ON). By default, this setting is set to (OFF) to prevent accidental changes.

This setting only displays if the Creator has permission to manage the element.

Share To

A list of all the workspaces available in your environment. If you select Share to Select Workspaces, use the checkboxes to select which workspaces you want to share you element. If you select Share to Environment, all workspaces are automatically selected.

Used By

The number of apps in a workspace that currently use your Library Element.

 Delete

Delete a Library Element, removing it from the environment. You can only delete an element if no application uses that element.

Navigating the Data Collections Library Elements Ellipsis Menu

In the Library Elements page, click the  Data Collections tab to the left. Open the ellipsis (···) menu to find the following settings:

Static image displaying the Data Collections ellipsis menu settings for library elements in UDesigner.

Option

Description

 Reload

Refreshes the Data Collection you're in. This is a good way to update changes to your Data Collection without refreshing the entire page.

 Export

Downloads your Data Collection as a .csv file.

 Access & Usage

Displays a pop-up modal where you control your element's shared location(s).

Set Element Access & Usage

A drop-down where you select where to share your element:

  • Share to Select Workspaces: Lets you limit which of your environment's workspaces you want to share your Library Element.

  • Share to Environment: Your element is available to all current and future workspaces in your environment.

  • Unshare from Library: Removes your element from the Library. You can only unshare an element if no more than one app connects to and uses it. Your element still shows in the environment anywhere you reference it.

Edit

A toggle to allow or disallow edits. To make any changes, set this toggle to  (ON). By default, the toggle is set to (OFF) to prevent accidental changes.

This toggle only displays if the creator has permission to manage the element.

Share To

A list of all the workspaces available in your environment. If you select Share to Select Workspaces, use the checkboxes to select which workspaces you want to share you element. If you select Share to Environment, all workspaces are automatically selected.

Used By

The number of applications in a workspace that currently use your Library Element.

 Delete

Delete a Library Element, removing it from the environment. You can only delete an element if no application uses that element.

Creating and Sharing a New Module Element

Static image displaying the Create Library Module modal UDesigner which displays after creating a new library element.

If you don't have an existing module, you can create one from scratch in the Library. You can even share the Library Element as you create it.

To create and share a new module:

1. From the Library drop-down, select Library Elements.
2. In the top-right corner of the page, click + Create New.
3. Enter a Module Name,Module Path, and Module Type. Module Description, Tags, and Data Models are optional.
4. Click Next.
5. Select where you want to share your element.
6. Click Create.

Now your new module displays in the Library Elements under Modules.

Creating and Sharing a New Data Collection Element

Just like modules, you can also create and share new Data Collections from the Library.

To create and share a new Data Collection:

1. From the Library drop-down, select Library Elements.
2. To the left of the page, click  Data Collections.
3. In the top-right corner of the page, click + Create New. The Create Data Collection page displays.
4. Configure your new Data Collection and its settings.
5. Close the window and return to the  Data Collections page.
6. Refresh the page.

Now your new Data Collection displays in the Library Elements under Data Collections.

Share an Existing Element

If you know which element you want to share, it's simple to do from your workspace.

To add an element to the Library:

1. Open the workspace that contains your element.
2. From the Elements list, navigate to the element you want to add to the Library.
3. From the element tile's ellipsis (···) menu, select Share to Library. The Share To Library modal A modal is a window that appears on top of the content you are currently viewing. displays.

Static image displaying the Library Modules menu with the Add button highlighted to add a shared library element to an application.

4. Select the environment or workspaces where you want to share the element.
5. Click Share.

When you open the Library Elements page, your element is now in the list of Library Elements.

Sharing and Unsharing a Library Element

At any time, you can control your Library Elements at the workspace and environment level. But, ensure you have the correct RBAC RBAC (Role-Based Access Control) is a method to control system access for authorized users. The role in RBAC refers to the levels of access employees have to a network. permission. You need the correct permission to make edits in the Access & Usage pop-up modal.

It's always important to be careful when changing or promoting Library Elements. Because you can add Library Elements to other workspaces and applications, changes can break those applications.

Sharing a Library Element

To edit an element's shared locations:

1. From the Library drop-down, select Library Elements.
2. Locate your Library Element.
3. In the element's tile, click Access & Usage.
4. Set Edit to  (ON).
5. Select the workspace where you want to share your element.

Static image displaying the Access & Usage tile of the Library Elements settings modal.

6. Click Save.

Unsharing a Library Element

If you no longer want to share a Library Element, you can remove it from the Library. But, ensure you disconnect your Library Element from your applications before unsharing. If the element is only connected to one application, it lives there when you unshare it. If it's connected to more, you need to unshare it and choose where it should exist.

To unshare a Library Element from the Library:

1. From the Library drop-down, select Library Elements.
2. Locate the element that you want to unshare.
3. Click Access & Usage in the element tile.
4. Set Edit to  (ON).
5. From the Set Element Access & Usage drop-down, select Unshare from Library.
6. From the Set Destination Workspace drop-down, select the workspace where you want the element to exist.
7. From the Set Destination App drop-down, select the application where you want the element to exist.

Static image displaying the settings configuration that unshares a library element from an application.

8. Click Save.

Deleting a Library Element

Sometimes, you might want to delete a Library Element if it becomes outdated or irrelevant. You can only delete an element if no application uses that element. Deleting a Library Element removes it from the environment.

To delete an element, unshare it from your applications. Then, follow these steps:

1. From the Library drop-down, select Library Elements.
2. Locate the element that you want to delete.
3. From the element tile's ellipsis (···) menu, select  Delete.
4. Enter the element's full name to confirm you want to delete it.
5. Click Yes, Delete.

Overview

Library Elements are shared modules and Data Collections available to one or more applications in an environment. Creators Also known as Unqork Users, or Designer Users; is anyone who is inside the Unqork platform. assign access and usage to a shared element by specifying if it's available to the entire environment, a specific workspace or application.

Library elements are not available with versioned applications.

To learn more about Library Elements, click on the buttons below:

Accessing and Navigating the Library Element Ellipsis Menus

Accessing the Library

You can access the Library from any page of your Unqork environment. Click the Library link in the top menu bar and click Library Elements.

Static image displaying the Library settings menu expanded with the Library Elements setting highlighted

Navigating the Library

The Library Elements page displays a list of elements shared in the environment. From this page, Creators can view shared modules or data collections, and access each shared element's settings.

Library Elements have purple tiles, versus the traditional gray.

A static image displaying the Library Elements page.

  Setting Description

1

+ Create New

Create a shared module or Data Collection. Learn how to create shared elements in the Creating and Sharing a New Element section.

2

Elements

Displays elements of the chosen type. Elements include:

  • Modules: Modules that have been shared with the environment or workspaces.

  • Data Collections: Data Collections that have been shared with the environment or workspaces.

3

Filter Tags & Recently Modified

Click Filter Tags to display a search field. Enter a value to search for the Shared Elements list. Search results are sorted by the Recently Modified value.

Click Recently Modified to display a drop-down list of sorting methods. Sort Methods include:

  • Recently Modified: Sorts elements in the list by their most recently modified date .

  • Least Recently Modified: Sorts elements in the list by their least recently modified date.

  • Newest: Sorts elements in the list by their most recently modified date

  • Oldest: Sorts elements in the list by their least recently modified date.

  • A-Z: Sorts items in the list in descending order by the first letter of the module name. Numerical and non-standard letters come before the letter A.

  • Z-A: Sorts the list in descending order by the first letter of the module name.

4

Shared Element List

Displays a list of element cards. Each card contains an element shared with the environment or workspaces.

5

(ellipsis)

(Shared Element Settings)

Click to display a list of options. See the following sections for a detailed list of options:

6

Access & Usage

Opens the Access & Usage settings modal for the shared element.

Navigating the Module Library Elements Ellipsis Menu

In the Library Elements page, click the Modules tab to the left. Open the ellipsis (···) menu to find the following settings:

Static image displaying the module ellipsis menu settings for library elements in UDesigner.

Option

Description

Settings

Lets you update the module's name, path, ID, and tags. These changes take effect everywhere you reference the module in your environment.

 Preview

Opens your module in Express View Express View is how your end-user views your application. Express View also lets you preview your applications to test your configuration and view the styling. This is also the view your end-users will see when interacting with your application. After configuring a module, click Preview in the Module Builder to interact with the module in Express View.. Express View displays your application as your end-user sees it.

 Duplicate

Creates a copy of the module with all its information and settings.

 Access & Usage

Displays a pop-up modal A modal is a window that appears on top of the content you are currently viewing. where you control your element's shared location(s).

Set Element Access & Usage

A drop-down where you select where to share your element:

  • Share to Select Workspaces: Lets you limit which of your environment's workspaces you want to share your Library Element.

  • Share to Environment: Your element is available to all current and future workspaces in your environment.

  • Unshare from Library: Removes your element from the Library. You can only unshare an element if no more than one app connects to and uses it. Your element still shows in the environment anywhere you reference it.

Edit

To make any changes, set to  (ON). By default, the setting is set to (OFF) to prevent accidental changes.

This setting only displays if the Creator has permission to manage the element.

Share To

A list of all the workspaces available in your environment. If you select Share to Select Workspaces, use the checkboxes to select which workspaces you want to share you element. If you select Share to Environment, all workspaces are automatically selected.

Used By

The number of applications in a workspace that currently use your Library Element.

 Delete

Delete a Library Element, removing it from the environment. You can only delete an element if no application uses that element.

Navigating the Data Collections Library Elements Ellipsis Menu

In the Library Elements page, click the  Data Collections tab to the left. Open the ellipsis (···) menu to find the following settings:

Static image displaying the Data Collections ellipsis menu settings for library elements in UDesigner.

Option

Description

 Reload

Refreshes the Data Collection you're in. This is a good way to update changes to your Data Collection without refreshing the entire page.

 Export

Downloads your data collection as a .csv file.

 Access & Usage

Displays a pop-up modal where you control your element's shared location(s).

Set Element Access & Usage

A drop-down where you select where to share your element:

  • Share to Select Workspaces: Lets you limit which of your environment's workspaces you want to share your Library Element.

  • Share to Environment: Your element is available to all current and future workspaces in your environment.

  • Unshare from Library: Removes your element from the Library. You can only unshare an element if no more than one application connects to and uses it. Your element still shows in the environment anywhere you reference it.

Edit

To make any changes, set to  (ON). By default, the setting is set to (OFF) to prevent accidental changes.

This setting only displays if the creator has permission to manage the element.

Share To

A list of all the workspaces available in your environment. If you select Share to Select Workspaces, use the checkboxes to select which workspaces you want to share you element. If you select Share to Environment, all workspaces are automatically selected.

Used By

The number of applications in a workspace that currently use your Library Element.

 Delete

Delete a Library Element, removing it from the environment. You can only delete an element if no application uses that element.

Creating and Sharing a New Module

If you don't have an existing module, you can create one from scratch in the Library. You can even share the Library Element as you create it.

To create and share a new module:

1. From the Library drop-down, select Library Elements.
2. To the left of the page, click Modules.
3. In the top-right corner of the page, click Create New.

Static image displaying the Create Library Module modal which displays after creating a new library element.

4. Enter a Module Name and Module Path. Tags are optional.
5. Click Next.
6. Select where you want to share your element.
7. Click Create.

Now your new module displays in the Library Elements under Modules.

Creating and Sharing a New Data Collection

Just like modules, you can also create and share new Data Collections from the Library.

To create and share a new Data Collection:

1. From the Library drop-down, select Library Elements.
2. To the left of the page, click  Data Collections.
3. In the top-right corner of the page, click + Create New.
4. Configure your new Data Collection and its settings.
5. Close the window and return to the  Data Collections page.
6. Refresh the page.

Now your new Data Collection displays in the Library Elements under Data Collections.

Adding an Existing Element to the Library

If you know which element you want to share, it's simple to do from your workspace.

To add an element to the Library:

1. Open the application that contains your element.
2. To the left of the page, select either Modules or  Data Collections (depending on what you want to add).
3. From the element tile's ellipsis (···) menu, select Share to Library.
4. Select where you want to share your element.
5. Click Share.

When you open the Library Elements page, your element is now in the list of Library Elements.

You can open the Library from your application, too. All you have to do is click the  icon in the top-right corner of the page. From there, you can quickly add elements to your Library. In the ellipsis (···) menu, you can Open in Editor, Preview, and Duplicate to App.

Static image displaying the Library Modules menu with the Add button highlighted to add a shared library element to an application.

Sharing and Unsharing an Existing Library Element

At any time, you can control your Library Elements at the workspace and environment level. But, ensure you have the correct RBAC RBAC (Role-Based Access Control) is a method to control system access for authorized users. The role in RBAC refers to the levels of access employees have to a network. permission. You need the correct permission to make edits in the Access & Usage pop-up modal.

It's always important to be careful when changing or promoting Library Elements. Because you can add Library Elements to other workspaces and applications, changes can break those applications.

To edit an element's shared locations:

1. From the Library drop-down, select Library Elements.
2. Locate your Library Element.
3. Click Access & Usage in the element’s tile.
4. Set Edit to  (ON).
5. Select the workspace where you want to share your element.

Static image displaying the Access & Usage tile of the Library Elements settings modal.

6. Click Save.

Unsharing a Library Element

If you no longer want to share a Library element, you can remove it from the Library. But, ensure you disconnect your Library Element from your applications before unsharing. If the element is only connected to one application, it lives there when you unshare it. If it's connected to more, you need to unshare it and choose where it should exist.

To unshare a Library Element from the Library:

1. From the Library drop-down, select Library Elements.
2. Locate the element that you want to unshare.
3. Click Access & Usage in the element tile.
4. Set Edit to  (ON).
5. From the Set Element Access & Usage drop-down, select Unshare from Library.
6. From the Set Destination Workspace drop-down, select the workspace where you want the element to exist.
7. From the Set Destination App drop-down, select the application where you want the element to exist.

Static image displaying the settings configuration that unshares a library element from an application.

8. Click Save.

Deleting a Library Element

Sometimes, you might want to delete a Library Element if it becomes outdated or irrelevant. You can only delete an element if no application uses that element. Deleting a Library Element removes it from the environment.

To delete an element, unshare it from your applications. Then, follow these steps:

1. From the Library drop-down, select Library Elements.
2. Locate the element that you want to delete.
3. From the element tile's ellipsis (···) menu, select  Delete.
4. Enter the element's full name to confirm you want to delete it.
5. Click Yes, Delete.

Resources