Web Services Blog

Create a reference asset

Suppose you have an asset in Cascade you want to display in the left navigation of more than one site. You can copy the asset over and over again into each of the folders for the site, but you don’t want to duplicate an asset multiple times. What do you do? Create a reference asset! A reference asset is a special asset in Cascade that represents an existing asset in another location. This means a single asset can appear to exist in multiple locations.  The asset will appear in the left navigation as if it had been copied to multiple folder but in actuality, it just links to the original asset.

To create the reference:

  1. Select the page you want to create a Reference for from the asset tree.
  2. Go to the Advanced menu and choose Reference. The Reference window is displayed.
  3. Enter a system name for the reference. The system name should be different from any other asset in the same folder as the reference asset. The display name of the asset being referenced will be retained. You may change it after the reference has been created.
  4. Navigate to the folder where the reference will be displayed. Submit the asset.
  5. The Reference is now created!

Notice the reference asset in the asset tree. Select the reference asset and the referenced page will be displayed.

Change the order of left navigation links

The left navigation is built from the folder/file structure is Cascade and is ordered alphabetically by default.

To rearrange the order of your indexed assets, select the parent folder from the asset tree. The asset information will be displayed in columns in a new window. Choose the “Order” column heading to show the order in which your assets are displayed in the left navigation. Move your pointer into the “white space” beside a folder/file until it becomes a small arrow. Click and drag the asset up or down into the desired position.

This only applies to assets that have indexing turned on.

Remember: Reordering your assets will not change how they are displayed in the asset tree. Assets are ordered alphabetically by default.

Create a page that auto builds the left navigation

The Left Column page type includes a column of links on the left side of the page. The links in the column are created dynamically from the indexed folder and page assets that are created within your site. The text for the links in the left navigation column comes from the text you enter into the Display Name field when you create a new Left Column page.

The Left Column – 1st level, Left Column – 2nd level and Left Column – 3rd level page types all look exactly the same. The only difference in the three is how the links are displayed in the left navigation column.

Left Column – 1st level: The left navigation displays all indexed assets that are in your site’s parent folder.

Left Column – 2nd level: The left navigation displays all indexed assets that are in folders within your site’s parent folder.

Left Column – 3rd level – The left navigation displays all indexed assets that are in folders within folders within your site’s parent folder.