Data Workspace
Magnolia’s Data module facilitates the storage and management of structured data in AdminCentral. Data storage is separate and independent from the site structure, but is retrievable for use on web pages, among other uses.
The Data workspace can also be used in the same manner as any other database and allows for the configuration and storage of structured data.
In the standard installation, numerous sub-workspaces have been established in the Data workspace, including Types, JCR Browser, Config (Dialogs), Company (Example), RSSAggregator, Contact and Category.
The Types and Config (Dialogs) areas allow you to set up and configure new workspaces within the Data module and were used to establish the RssAggregator, Contact and Category workspaces. Among other uses, the JCR Browser area allows you to view both the properties and content of the workspaces established using the Types and Config (dialogs) areas.
This section of the manual concentrates on how to use the established workspaces i.e. the RSSAggregator, Contact and Category workspaces. These are of more relevance to editors as they are referenced by the Website workspace in the demo-project and demo-features websites. Items set up in the:
Category workspace are used on all pages based on the Article and Large Article templates.
Contact workspace are used to create Contact teaser paragraphs.
RSSAggregator workspace are used to create RSS Combined Feed and Feed List paragraphs.
Demo-features – Aggregation Paragraphs – RSS Aggregation page
Opening the Workspace
When you launch AdminCentral, the Website workspace opens, by default. How to open AdminCentral is discussed in Getting Started – Opening AdminCentral (link).
To open the Data workspace, click on the Data button in the navigation pane and a drop-down menu of the established areas of the Data workspace will appear.
To open any of the areas of the Data Workspace, click on the workspace name.
Workspace Layout
General
The workspace layout of all areas of the Data workspace is identical and consists of three columns:
Name: the name of the data item or node;
Status: the activation status of the item or node;
Date: the date on which the node was created or last modified.
Selecting Rows
In order to work with a specific item, it is necessary to select or highlight the item’s row.
To select a specific row, click on any of the elements in the row. The elements refer to the item name, status indicator or date.
When you point to any of the elements, the row becomes highlighted by a light blue rectangle, and when you click, the rectangle darkens, indicating that the row is selected.
Commands
The commands available in the various areas of the Data workspaces are identical, except that some sections additionally contain the New Folder and Activate incl. sub pages commands. When a new workspace is set up, the option to include these additional commands is available. How to set up new workspaces is discussed in xxxx.
Some commands are available in both the command bar, located at the bottom of the workspace and the command menu, which is accessed by right-clicking with your mouse. Commands common to both menus may be used in either menu.
The commands common to both menus are magnified in the screenshot below.
Some commands are only available in either menu and these commands are magnified in the screenshot below.
The Import from xml and Export tree to xml commands are beyond the scope of this manual and are excluded, the rest of the commands are discussed in individual sections.
In both menus, to use any of the commands simply select the relevant item row, if appropriate, and then click on the command.
Some commands are item-specific and therefore only clearly visible and usable when a row is selected, while others are other only clearly visible and usable when a row is not selected.
Data Structure
Data within any section may be maintained in a hierarchical structure. The system is extremely flexible and adaptable and there are various ways to create a tree structure. Data structures are created using either the New Folder and New Item commands, or a combination of both. Using these commands is discussed in Creating New Folders (link) and Creating New Items (link).
If the New Folder command is available in the workspace, items may be positioned within folders. It is possible to create folders and subfolders, to an unlimited level, and data items may be stored within folders and subfolders, or individually.
Unlike in the Website and Documents workspaces, items within a folder do not display directly beneath the folders. Here all the folders are displayed first and the items beneath them. The folder/item structure is easily identifiable and is demonstrated in the screenshot below.
Irrespective of whether the New Folder command is available, items may always be positioned as sub-items and a sample structure of sub-items is demonstrated in the screenshot below.
Using the Commands
Creating New Folders
The New Folder command allows you to create folders, which can be used to structure data. Folders and subfolders to an unlimited level are possible and individual items may be placed either within a folder or individually on any level.
New Folder Command
To create a new first-level folder, click on the New Folder command in the command bar or menu, without first selecting a row. If a row is currently selected, click on the Refresh command to deselect all rows. Using the Refresh command is discussed in Refreshing the Workspace (link).
To create a subfolder, select the row of the higher-level folder and then click on the New Folder command in the command bar or menu.
When you click on the New Folder command, a new folder named “untitled” appears in the selected position.
Naming Folders
When you create a new folder or subfolder, it is named “untitled”, by default.
If you create more than one level-one folder or more than one subfolder within the same higher-level folder, at the same time, sequential numbers, starting with zero, appear at the end of the word “untitled” to distinguish the different folders or subfolders.
To rename a new or current folder:
- Double-click on the current name.
- When you double-click, a white text box surrounds the current name. In this text box, highlight the current name, insert the new one and then click on the Enter key on your keyboard to save it
- When you press Enter, the window reloads to display the new folder name.
Creating New Items
The New Item command allows you to create new items. New items may be position within current folders, as sub-items of current items or as first-level items.
To create a new first-level item, click on the New Item command in the command bar or menu, without first selecting a row.
To create a new sub-item or to position a new item within a folder, select the higher-level item or folder row and then click on the New Item command in the command bar or menu.
When you click on the New Item command, the Magnolia Edit dialog opens. The content of this dialog depends on the workspace that you are working in.
Using the Edit dialog in the RssAggregator, Contact and Category sections is discussed below in Edit Dialog - RssAggregator, Contact and Category (links).
Once you have saved the content of the Edit dialog, the new item appears in the selected position.
Edit Dialog
New items are created in the Magnolia Edit dialog, which opens when you click on the New Item command. The options available in this dialog depend on the workspace that you are working in.
RssAggregator Workspace
Items in the RssAggregator workspace are used in the Website workspace when creating RSS Combined Feed and Feed List teaser paragraphs.
The Edit dialog in the RssAggregator Workspace has a single tab area: RSS Aggregators.
The Name Field allows you to name the new RSS aggregator.
The content of this field appears in the Name column of the RssAggregator workspace.
The Title Field allows you to include a title for the feed. The title displays only in the Edit dialog and is not used by the RSS Combined Feed and Feed List paragraphs in the Website workspace.
The Short Description field allows you to include a description of the feed. Like the title, the description displays only in the Edit dialog and is not used by the RSS Combined Feed and Feed List paragraphs in the Website workspace.
The Feeds field allows you to include the feed/s that will be included in the RSS aggregator, and you may include as many individual feeds as you like. Initially, a single row containing two sub-fields, Title and URL, is available.
To include the feed/s:
Insert a descriptive title of the first feed into the initial Title subfield and its URL into the URL subfield.
To add a second feed, click on the Add button below the first row.
When you click on the Add button, a second row containing Title and URL subfields appears. In these subfields, insert the Title and URL of the second feed.
You can add as many feeds as you like, by repeating the procedure described above.
The feeds inserted in the Feeds field/s are used in the Website workspace to produce the content in the RSS Combined Feed and Feed List paragraphs. In order for these paragraphs to render meaningful content, it is necessary to import the feed data into Magnolia, and this is achieved using the Import Data command, which is discussed in Importing Data (link).
In the Website workspace, the RSS Combined Feed paragraph renders content from all the feeds set up in the Feeds field of the Edit dialog in the Data workspace. How to create a RSS Combined Feed paragraphs is discussed in Working with Web Content – Teaser Paragraphs – RSS Feed Paragraphs (link). When a user clicks on an item in the paragraph, the item opens on the host site, i.e. the supplier of the RSS feed.
The RSS Feed List paragraph renders content from all the feeds set up in the Feeds field of the Edit dialog in the Data workspace, but here the feeds are displayed sequentially, in the order inserted in the Data workspace. The individual field titles inserted in the Feeds field/s of the Edit dialog in the Data workspace are used in the paragraph for each feed. How to create RSS Feed List paragraphs is discussed in Working with Web Content – Teaser Paragraphs – RSS Feed Paragraphs (link).
If the field titles are left blank in the Edit dialog, the paragraph uses the feed title supplied with the feed.
The Filters field allows you to filter the items that will display in the feed and more than one filter can be applied. For example, it is possible to display only one or more categories within the feed. Filters apply to all feeds included in the Feeds fields. If no filters are applied, all the items in the feed will be included in the paragraph.
To demonstrate the filters, we set up a RSS aggregator containing a single feed: BBC News – World Edition.
Each Filters field contains three boxes:
The first box allows you to set the “condition’ for the filter and there are three options: AND, OR and NOT. To access the list of options, click on the small down-arrow on the right of the box and the list will appear. Make your selection by clicking on the relevant option and it will be inserted into the box.
The second box allows you to select from a set of predefined options, which are commonly found in RSS feeds: Category, Title, Author and Description. To access the list of options, click on the small down-arrow on the right of the box and the list will appear. Make your selection by clicking on the relevant option and it will be inserted into the box.
The third box allows you to define the value that will be used to meet the condition and option included in the first two boxes.
To add second and further filters, click on the Add button below the first row and a second row will appear. Fill in the individual fields as described above and then click on the Add button to insert third and further filters. You can include as many as you like.
Below are a number of examples that demonstrate the practical application of Filters in RSS feeds. The first screenshot is of the BBC News Worldwide feed in the RSS Feed List paragraph in the Website workspace. With no filters applied, the RSS Feed List paragraph displays news articles from around the world.
A comparison of this screenshot to those that follow should clarify their functioning.
Example 1:
The AND condition displays only those items which match both the option selected in the second box and the value inserted in the third, and excludes all others.
Example 2:
The NOT condition displays all items except those which match the option selected in the second box and the value inserted in the third, and excludes all others.
Example 3:
The NOT condition can be included in multiple filters and items which meet all conditions will be excluded.
Example 3:
AND and NOT conditions can be combined in sequential filters to refine the feed by the options available in the second box in the Filters field.
Contact Workspace
Items in the Contact workspace are used in the Website workspace to create Contact teaser paragraphs.
When you click on the New Item command in the Contact workspace, the Edit dialog opens.
The Edit dialog has three tab areas: Personal, Company and Contact.
The Personal tab area allows you to include the contact’s personal details and upload an image. The available fields are mostly self-explanatory.
In the fields provided, insert the personal details of the contact.
Magnolia uses the User Id field to identify the contact and the content of this field appears in the Name column of the Contact workspace.
The Photo ID field allows you to upload a photo or other suitable image to display in the Contact paragraph. The Browse button in the Photo Id field facilitates the upload and works in the same way as most upload functions. How to use the upload function is discussed in Working with Web Contact – Images – Inserting Images – Uploading Images (link).
Company Tab Area
The Company tab area allows you to include the contact’s business details. These fields also are mostly self-explanatory.
In the fields provided, insert the business details of the contact.
The Contact tab area allows you to include the contact details for the contact. These fields also are mostly self-explanatory.
In the fields provided, insert the contact details of the contact.
In the Website workspace, when you create a new Contact teaser paragraph, the Internal Link button in the Contact field of the Teaser dialog opens a new dialog containing all contacts set up in the Data workspace.
When you select the new contact and save the content of the Teaser dialog, the resultant paragraph displays the detail contained in the Edit dialog of the Contact workspace.
How to create a new Contact paragraph is discussed in Working with Web Content – Teaser Paragraphs – Standard Teaser Paragraphs – Contact Paragraph (link).
Category Workspace
Items in the Category section are used in the Website workspace in the Article Header paragraph of Article and Large Article templates, and in the Category Cloud and Related Categories teaser paragraphs.
When you click on the New Item command in the Categories workspace, the Edit dialog opens.
The Edit dialog has a single tab area: Category.
The Category tab area allows you to set the properties for the new category.
Category Name Field
The Category name field allows Magnolia to identify the category.
In the Category name field, insert the name of the new category.
The content of the Category name field displays in the Name column of the Category workspace.
Display Name Field
The contents of the Display name field displays in the Website workspace in the various paragraphs that make use of categories, and can be completely different from the category name.
In the Display name field, insert the name that you would like to display in the Website workspace.
In the Website workspace, the display name displays in the various paragraphs.
Importance Field
The Category Cloud teaser paragraph uses the Importance field to vary the font size of the different categories according to the importance level set in the Categories workspace.
The importance levels vary from 1 to 5, with 5 being the most important and 1 the least important.
To set the importance level for the category, click on the small down-arrow on the right of the field and the list of options will appear. Next, click on the appropriate level and it will be inserted into the field.
Related Categories Field
The Related Categories field allows you to select other categories in the Categories workspace that relate to or have something in common with the category. Related categories display in the Related Categories teaser paragraph, which is unique to the Category Overview template.
To select the related categories:
Click on the Choose button in the Related Categories field.
When you click on the Choose button, a new dialog containing all the established categories in the Data workspace opens. In this dialog, select a category by clicking on it and then click on the OK button at the bottom of the dialog.
When you click on the OK button, the second dialog closes, returning you to the Edit dialog, where the file path of the selected category appears in the first Related Categories field. To select second and further categories, click on the Add button below the first field.
When you click on the Add button, a second field appears and you can select the next category by repeating the procedure described above.
You can add as many related categories as you like. To delete or change a selected category, click on the relevant Delete or Choose button. When you click on the Choose button, the dialog containing all the categories opens where you can select a different category.
In the Website workspace, if you assign the new category to an article page, by selecting it in the Categories tab area of the Article Header dialog, the category display name appears in the Article Header paragraph.
When you click on the category, the Category overview page of the selected category opens. By default, the Related Categories teaser displays in the first position of the extras area, and the categories selected in the Related Categories field display in the paragraph.
How to create an Article Header paragraph and a Related Categories teaser paragraph is discussed in Working with Web Content – Paragraph Types – Body Content Paragraphs – Header Paragraphs (link) and Teaser Paragraphs – Standard Teaser Paragraphs – Related Categories Paragraph (link).
Editing Items
The Edit Item command allows you to open the Edit dialog of a current item to change the properties by amending the content in the dialog.
To open the Edit dialog of a current item, select the item and then click on the Edit Item command in the command bar or menu.
You can also open the Edit dialog by simply double-clicking on the icon to the left of the item name.
When you click on the Edit Item command or double-click on the icon, the Edit dialog of the selected item opens.
In the Edit dialog, you can amend any of the fields by inserting different information or making new selections. How to insert content in the various Edit dialogs is discussed in Creating New Items (link).
Deleting Items
Deleting Single Items and Folders
The Delete command allows you to delete current items and folders and is available in both the command bar and the command menu.
To Delete an Item or folder, select the item row and then click on the Delete command in the command bar or menu.
When you click on the Delete command, a warning dialog opens asking you to confirm your choice. Click on the OK button to do so.
When you click on the OK button, the warning dialog closes, the workspace reloads and the deleted items no longer appears in the list of items.
Deleting All Items and Folders
The Delete All command allows you to delete all items in the workspace simultaneously, and is available only in the command bar.
To delete all the items in the workspace, click on the Delete All command.
When you click on the Delete All command, the workspace reloads to display a blank workspace.
Copying and Moving Items and Folders
The procedure for copying and moving items and folders is identical, except that when moving them, the original is removed from its original location and no longer exists there, whereas when copying them, the original remains in its original location and also exists in its duplicate location.
Items are copied using the Copy command and moved using the Move command.
Copied and moving items can be positioned in any location within the structure by simply dragging them from the original location and dropping them in the new one.
You can copy and move individual items or entire folders, including their subfolders and items. When you copy or move a folder, the entire contents of the folder is also copied or moved.
Both commands are available only in the command menu.
To copy an item or folder, select its row, then right-click anywhere in the workspace area, other than on an item or folder element, to activate the command menu, and then click on the Copy command in the menu.
To move an item or folder, select its row, then right-click anywhere in the workspace area, other than on an item or folder element, to activate the command menu, and then click on the Move command in the menu.
When you click on the Copy or Move command, a duplicate of the item name and icon attaches to your mouse pointer and will move with your pointer. You can now drag the duplicate to its new or duplicate location within the item or folder structure.
To position the copied or moving item or folder between current items or folders, drag the duplicate name and icon to the location that you would like it to appear in, and then click on the new location. When you indicate with your mouse pointer to a possible location, a solid line appears.
· When you click on the new location, the workspace reloads and your duplicate or moved item or folder appears in the location that you positioned it in.
· To position the copied or moving item or folder in as a sub-item or within a folder, drag the duplicate name and icon to the item or folder and click on the item or folder name.
· When you click on the item or folder name, the workspace reloads and the duplicate or moved item or folder appears in the location that you positioned it in.
Activating and De-activating Items and Folders
Activation is the process of publishing items to one or more public instance of Magnolia. Until activated, items are only viewable in the author instance.
De-activation is the process of removing items from, the public instance/s, while they remain available in the author instance.
About Activation
In a typical Magnolia installation, there is a single author instance and one or more public instance/s. When an item is activated, Magnolia simply copies it from the author instance to the public instance/s. When you amend activated items and folders, it is necessary to reactivate them in order for the latest information to be publically available.
In certain instances, whether an item or folder is activated immediately or not, depends on the modules of Magnolia installed and the procedures relevant to your organization. If, for example, the Workflow module is running, you may have to wait for someone else, typically a publisher, to approve the activation. If the Workflow module is not running, items are activated immediately.
The activation status of each item or folder is indicated in the Status column of the Data workspace.
There are three possible indicators:
- Red: the item or folder has never been activated or has been de-activated;
- Green: the item or folder has been activated;
- Orange: the item or folder has been activated, but has been modified since its last activation.
When items are structured, i.e. when they are contained within folders or positioned as sub-items, it is necessary to activate the folder of higher-level item, before activating the single items or sub-items.
Three commands facilitate the activation of items and folders, the:
Activate this node command is used to activate single items or folders;
Activate incl. sub pages command is used activate multiple folders and/or items in a structure simultaneously;
Activate all command is used to activate all folders and items in the workspace simultaneously.
While the Activate this node and Activate all commands are available in the RssAggregator, Contact and Category workspaces, the Activate incl. sub pages is available only in the Contact and Category workspaces, and not in the RssAggregator workspace. The Activate incl. sub pages command is only available if the New Folder command is available in the workspace.
About De-activation
De-activation is the process of removing items and folders from the public instance/s so that they are no longer publically visible.
When you deactivate an item or folder, Magnolia removes it from the public instance/s.
Even if an item or folder has been de-activated, it will still be available in the Data workspace of the author instance for further use.
There is a major difference between de-activating items and folders, and deleting them. When you delete an item or folder in the Data workspace in the Author instance, Magnolia first automatically de-activates and then removes it from both instances. On the other hand, when you de-activate an item or folder, it is only removed from the public instance/s, but is still be available in Data workspace in the Author instance.
Two commands facilitate the de-activation of items and folders, the:
De-activate command is used to de-activate single items or folders.
Deactivate all command is used to de-activate all folders and items in the workspace simultaneously.
Activating Single Items and Folders
The Activate this node command allows you to activate a single item or folder and is available in both the command bar and the command menu.
Before you can activate a single item contained within a folder, or a sub-item, it is necessary to first activate the folder and/or the higher-level item.
If the Workflow module is running on the installation, the items will only be activated after approval, and not immediately, as is the case if it is not running.
Both items and folders are activated in exactly the same manner.
To activate a single item or folder:
Select the item folder row and then click on the Activate this node command in the command bar or menu.
When you click on the Activate this node command, if the workflow module is not running on your installation, your file or folder will be activated immediately and its status will be reflected as green in the Status column in the Data workspace.
- If the workflow module is running on your installation, when you click on the Activate this node command, a message dialog opens advising you that the request has been initiated. Click on the OK button in this dialog to return to the Data workspace area.
·
· The activation request is sent to the person responsible for approving requests and can be viewed in the Inbox workspace, if you have the requisite permission to access this workspace. To open the Inbox workspace, click on the Inbox button in the navigation bar in AdminCentral and the Inbox workspace will open. Working in the Inbox workspace is discussed in Inbox Workspace (link).
- Once your activation request is approved, the status indicator of the item or folder will change from red to green in the Data workspace.
Activating Multiple Items and Folders
It is possible to activate an entire node or structure containing folders and items simultaneously, using the Activate incl. sub pages command.
If the Workflow module is running on the installation, the items will only be activated after approval, and not immediately, as is the case if it is not running.
The Activate incl. sub pages command is available only in the command menu.
To activate multiple items and/or folders:
Select the row of the highest-level folder or item, then right-click anywhere in the workspace area, other than on an item or folder element, to activate the command menu, and then click on the Activate incl. sub pages command in the menu.
When you click on the Activate incl. sub pages command, if the workflow module is not running on your installation, your file or folder will be activated immediately and its status will be reflected as green in the Status column in the Data workspace.
- If the workflow module is running on your installation, when you click on the Activate this node command, a message dialog opens advising you that the request has been initiated. Click on the OK button in this dialog to return to the Data workspace area.
·
· The activation request is sent to the person responsible for approving requests and can be viewed in the Inbox workspace, if you have the requisite permission to access this workspace. To open the Inbox workspace, click on the Inbox button in the navigation bar in AdminCentral and the Inbox workspace will open. Working in the Inbox workspace is discussed in Inbox Workspace (link).
- Once your activation request is approved, the status indicator of the item or folder will change from red to green in the Data workspace.
Activating All Items and Folders
The Activate All command allows you to activate all items in the workspace simultaneously, and is available only in the command bar. The Activate all command does not invoke the workflow module and the items and/or folders are activated immediately.
To activate all the items in the workspace, click on the Activate all command in the command bar.
When you click on the Activate all command, the workspace reloads and the status indicator of all items changes to green.
De-activating Single Items and Folders
The De-activate command allows you to de-activate single items or folders and is available in both the command bar and the command menu.
When you de-activate a higher-level item or folder, all the items and/or folders beneath it are also de-activated. In other words, it is not possible to de-activate a higher-level item or folder without also de-activating the entire item and/or folder structure.
Both items and folders are de-activated in exactly the same manner.
The Workflow module is not invoked when de-activating and the de-activation occurs immediately.
To de-activate a single item or folder:
Select the item or folder row and then click on the De-activate command in the command bar or menu.
- When you click on the De-activate command, the workspace reloads and the status indicator of the selected item or folder changes to red.
De-activating All Items and Folders
The Deactivate all command allows you to de-activate all items in the workspace simultaneously, and is available only in the command bar.
To de-activate all the items in the workspace, click on the Deactivate all command in the command bar.
When you click on the Deactivate all command, the workspace reloads and the status indicator of all items changes to red.
Item Versions
Magnolia has built-in versioning, which automatically saves previous versions of items and allows you to revert to then, if necessary.
There is an important difference between saving items and activating them. Only when an item is activated, i.e. published to the public instance/s, a new version is created and stored.
The standard installation of Magnolia is configured to store the ten most recent versions of an item.
Versions Command
Item versions are accessed using the Versions command, which is available only in the command menu.
To access previous versions of an item, select the item and then click on the Versions command in the menu.
When you click on the Versions command, the Versions workspace opens in a new window.
Versions Workspace
The versions of the selected item display in the Versions workspace.
The Versions workspace has its own set of commands, which are available in the command bar at the bottom of the workspace, and in the command menu, which is accessed by right-clicking with your mouse. There are two commands in the workspace: Show and Restore.
The item information area of the workspace has three columns:
- Name: item name;
- Date: date on which the item was activated. By default, the date is displayed in ascending order, with oldest version appearing in the first row and the newest in the last row;
- User: user who activated each version of the item.
To the right of the columns, there is a gray panel, which facilitates different grouping options.
By default, the versions display in ascending date order. The grouping options allow you to sort the versions to the second level.
The first grouping level is by User, and the link, displays beneath the “Group by” category heading.
To sort the versions by User, click on the User link and the workspace will reload to display the versions grouped by User.
The second grouping level headed, “Sort within a Group by”, allows you to group the versions, within the first sorting level, by date.
To sort by date, click on the Date link and the workspace will reload to display the versions grouped first by User, and then by Date in ascending order.
Two commands, Show and Restore, are available in the Versions workspace and are both available in the command bar and the command menu. You can use the commands in either menu.
To use the command bar, select the version you would like to work on and then click on the relevant command in the command bar.
The command menu is activated by right-clicking with your mouse. There are two alternative ways to activate and use the command menu:
· Alternative 1:
· Select the version by clicking anywhere within the row, then right-click anywhere within the highlighted row to activate the command menu, and then click on the relevant command in the menu.
·
·
Alternative 2:
Without first selecting a row, point to and right-click anywhere within a row and then click on the relevant command in the menu.
When you point, the row becomes highlighted by a light blue rectangle and when you right-click, the rectangle darkens, indicating that the row is selected, and the command menu appears.
The Show command opens the Edit dialog of the selected version, where you can view the particulars of the version. Working in the Edit dialog is discussed in Creating New Items - Edit dialog (link).
To open the Edit dialog using the Show command, select the row of the version you would like to view, and then click on the Show command in the command bar or menu.
When you click on the Show command, the Edit dialog of the selected version opens. It is not possible to amend information in the Edit dialog and for this reason the dialog does not have a Save button.
The Restore command restores the selected version of the item as the available version in the Data workspace.
To restore a version, first select it and then click on the Restore command in the command bar or menu.
When you click on the Restore command, a message dialog opens advising you that the selected version has successfully been restored as the available version in the Data workspace. In this dialog, click on the OK button to complete the restoration of the version.
Refreshing the Workspace
The Refresh command allows you to refresh or reload the Data workspace.
While the workspace will reload automatically after using most commands, this added function can be extremely useful. For instance, when you have selected a row in error and would then like to deselect all rows, or when a number of folders and items are expanded and would like to collapse them all simultaneously.
The Refresh command is available in both the command bar and menu.
To refresh the workspace, click on the Refresh command in the command bar or menu.
When you click on the Refresh command, the workspace reloads and in the refreshed workspace, all of the previously expanded subfolders are collapsed and only level-one folders and files display.
Importing Data
The Import Data command allows you to import data into the workspace and its behavior depends on the configuration of its import mechanisms, which are beyond the scope of this manual.
The Import Data command is only available in the command bar.
Contact and Category Workspaces
In the Contact and Category workspaces, no import handler is configured and clicking on the command therefore results in an error message.
RssAggregator Workspace
In the RssAggregator workspace, the Import Data command is configured to retrieve the content of the feeds set up in the Feeds field of the Edit dialog.
To demonstrate the behavior of the command, we set up a new feed in the RssAggregator workspace, which displays ESPN Sports headlines.
In the Website workspace, if you link to this RSS Aggregator in a RSS Combined Feed or Feed List paragraph, the items in the feed do not display until you have imported them into Magnolia.
To import the feed items, in the RssAggregator workspace, select the feed and then click on the Import Data command in the command bar.
After importing the data in the Data workspace, the RSS paragraphs in the Website workspace display the feed items.
You can also view details of the feed items in the JCR Browser area of the Data Workspace. Working in the JCR Browser workspace is discussed in xxxx (link).
