Managed Assets Administration

Overview

Managed Assets Administration is where you store static media files used in your application. A static media file can refer to anything from your corporate logo to a supporting image.  Once uploaded and linked to your module, these media files show in Express View Express View is how your end-user views you 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..

The Unqork Designer Platform accepts these file types: JPG, JPEG, PNG, PDF, TXT, XLSX, DOCX, SVG, ICO, GIF, and CSV. You can add media files of any size; there’s currently no restriction.

Creating Folders and Sub-folders

A good way to organize your media files is to use folders and sub-folders.

To add a folder:

1. Click the Settings ▾ drop-down at the top right of the Unqork Designer Platform.
2. Click Administration.
3. Under Assets, select Managed Assets Administration.
4. Click the (Create Folder) icon, located at the top of the Managed Assets list.  

A static image of the Managed Assets page, the Create Folder icon is highlighted.

5. Enter a unique name for your folder. 
6. Click Create. Your new folder displays in the Managed Assets list.

Clicking Cancel stops the process and returns you to the Managed Assets list.

7. Double-click the folder name to open it. Once opened, you can upload your media files.
8. To return to the top-level Managed Assets list, click the  (Back) icon at the top left of the list.

A static image displaying the Managed Assets page, the Back button is highlighted.

Uploading a Media File

Uploading your media files makes them available on the Managed Assets Administration list.  Once uploaded, you can use these files during the application building process.  

To upload a media file, continue as follows:

1. Click the Settings ▾ drop-down at the top right of the Unqork Designer Platform.
2. Click Administration.
3. Under Assets, select Managed Assets Administration.
4. Click the (Upload) button, located at the top right of the list.
5. Navigate to and select your file for upload.

Files types that are not supported do not display for selection. Remember, Unqork accepts these digital file types: JPG, JPEG, PNG, PDF, TXT, XLSX, DOCX, SVG, ICO, GIF, and CSV.

6. Click Open. Your uploaded file displays in the Managed Assets list.

Replacing a Media File

After uploading a media file, you can reupload the file if it changes.

To replace a media file:

1. Click the Settings ▾ drop-down at the top right of the Unqork Designer Platform.
2. Click Administration.
3. Under Assets, select Managed Assets Administration.
4. In the Managed Assets list, navigate to your original media file.
5. Select the file.
6. Click the (Upload) button, located at the top right of the list.
7. Navigate to and select your file for upload.
8. Click Open.
9. At the File Exists message, click Confirm. 

Clicking Cancel stops the process and returns you to the Managed Assets Administration list.

The uploaded file replaces your original file in the Managed Assets Administration list. The Last Modified column now shows the current date/time.

Removing a Media File

You can also remove media files from the Managed Assets Administration list. If you remove a file referenced in an application, the reference no longer works. You must remove or replace the reference in the application before removing the file.

To remove a media file:

1. Click the Settings ▾ drop-down at the top right of the Unqork Designer Platform.
2. Click Administration.
3. Under Assets, select Managed Assets Administration.
4. In the Managed Assets list, navigate to the file to remove.
5. Select the file.
6. Click the (Remove) button, located at the top right of the list.
7. At the Remove message, click Confirm. The file no longer displays in the Managed Assets list.

Clicking Cancel stops the process and returns you to the Managed Assets list.

Downloading a Media File

When you promote your module, your associated media files are not promoted. As you promote applications, you’ll need to add the media files to each environment. To do this, you’ll download the files from the original environment and upload to the new environment.

To download a media file:

1. Click the Settings ▾ drop-down at the top right of the Unqork Designer Platform.
2. Click Administration.
3. Under Assets, select Managed Assets Administration.
4. In the Managed Assets list, navigate to the file to download.
5. Select the file.
6. Click the (Download) button, located at the top right of the list.
7. Locate the file in your Downloads folder. 

To reupload the files to the new environment, return to Uploading Media Files.

Retrieving Managed Assets With a Plug-In Component

To retrieve a file from Managed Assets, use a Plug-In component:

1. In the Module Builder, drag and drop a Plug-In component onto the canvas
2. In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. field, enter plugGetAsset.
3. In the Canvas Label Text field, enter plugGetAsset.
4. In the Data Service Type field, enter: {{data.getEnv.REMOTE_ROOT}}assets/[filePathAndName.jpg]. Replace [filePathAndName.jpg] with the folder path and image file. For example, {{data.getEnv.REMOTE_ROOT}}assets/Enablement/exampleLogo.jpg.

A static image displaying a Plug-In Component with the Data Source URL filled out.

5. Click Save.

Use a Button to Trigger the Plug-In component to retrieve the asset:

1. Drag and Drop a Button component Icon Button  component onto the canvas.
2. In the Property ID A Property ID is the unique field ID used by Unqork to track and link components in your module. field, enter btnGetAsset.
3. In the Label Text field, enter Get Asset.
4. From the Button component navigation panel, click Actions Icon Actions.
5. Under Action Type, click Event.
6. In the On Click field, enter or select plugGetAsset.

A static image displaying a Button Component with the with the On Click set to trigger the Plug-In.

7. Click Save & Close.
8. Save your module.

Preview the module and click the Get Asset button to retrieve the Managed Asset. Inspect the page and use the Angular Command The Angular command, or data command, is a tool that displays submission data in a browser's developer console. In Express View, enter the following command in the devtool console: angular.element('.unqorkio-form').scope().submission to view the submission data.

To learn how to inspect a module submission and run the angular command, view our Viewing Submission Data in the DevTools Console article.

Using the example above to retrieve a JPG image, the data structure looks like the following:

A static image displaying the Data Structure of a Managed Asset JPG retrieved into a Plug-In.

Labs

Here are examples of how to access and use a Managed Asset: https://training.unqork.io/#/form/65aa8a1db8bc1e37b2b730f2/edit

Resources