Structure Editor

The LumisXP provides a tool for easy creation and editing of page structures, channels, and service instances. The structure editor can be accessed through the Studio Portal. To do this, simply right-click on the channel whose structure you want to edit and then select the "Edit structure" option, as shown in the figure below:

The editor will then open, as shown in the figure below:

The available actions for a given item displayed in the structure tree can be accessed when that specific item is focused. This can be done by clicking on the desired item or using the keyboard shortcut keys for navigation (up arrow, down arrow, left arrow, and right arrow). When an item gains focus, its appearance changes to mark it, and the action buttons are displayed. An example can be seen in the figure below:

At this moment, it can be seen that the channel "Portal" has focus. The only action available for the root channel of the structure is to add a new item. When selecting this option, some options will be displayed for selecting the type of item to be added, as shown in the following figure:

At this moment, you can create a new channel, a new page, a new service instance, a new channel template, or a new page template. To do this, simply click on the desired item type or use the up arrow, down arrow, and enter keys to confirm. Assuming that the new page option has been selected, a new item of type page will be created, and an input will be created for you to define its title, as shown in the figure below:

After entering the title of the new page, simply click "OK" to confirm or use the enter key shortcut. To rename an item, the procedure is quite similar. For this, simply double-click on the element you want to rename or press the enter key shortcut when the desired item is selected. Once created, the page becomes part of the structure, as shown in the figure below:

For this created page, two actions can be performed: move it down or delete it. When moving it down, it will swap places with the page immediately after it, the Welcome page. This can be seen in the figure below:

To create a new service instance, before defining its title, you must choose from which service this instance will be. Then, when the new service instance option is activated, a list is displayed with the services available in the portal, as shown in the figure below:

To select the desired service, simply click on it or use the up and down arrow shortcut keys and enter to confirm. It is also possible to filter the services using the filter input, as shown in the following figure:

After that, an input will be displayed for defining the title of the service instance, as shown in the figure below:

The movement of an item can be done through the movement buttons or through the control + up and down arrow shortcuts. The movement of an item is visual. That is, when selecting an item and moving it up, it will be moved to the first available position in the hierarchy above it. The same occurs for down. It is worth noting that at a certain level, items are always displayed in the following order:

1. Service Instances
2. Pages
3. Page Templates
4. Channels
5. Channel Templates

This order is always respected, even when moving items. As an example, suppose the following hierarchy:

The selected item is a channel called Sports News. In this hierarchy, there are four possible positions where this channel could be moved:

1. As the previous sibling of the channel Intranet.
2. As the previous sibling of the channel News.
3. As the next sibling of the channel News.
4. As the next sibling of the channel Intranet.

It cannot be the previous or next sibling of the channel Portal since this is the root channel of the structure being edited.

In this case, the possible movement locations would be:

• As the previous sibling of the channel News (position 2) in the case of moving up.
• As the next sibling of the channel News (position 3) in the case of moving down.

As an example, it has been moved up, resulting in the following structure:

As a second example, suppose the following structure:

In this case, the selected item can only be moved down. In this case, it would become a child of the channel template. Analogously, the channel template can only be moved up, and in this case, it would become a child of the channel, as shown in the figure below:

Once the channel template is moved up, it will become a child of the channel and will have only one movement option: down, as shown in the following figure:

Similarly, if the channel had been moved into the channel template, it would only have one movement option remaining, which would be up, and in this case, it would become the previous sibling of the channel template, as shown in the figure below:

Now suppose another structure, this time with two sibling channels called My Channel and My Other Channel. They are shown below, with the possible movement locations:

In this example, the channel My Channel could occupy positions 3 (child of the channel My Other Channel) and 4 (next sibling of the channel My Other Channel) indicated by moving it down one or two times, respectively. On the other hand, the channel My Other Channel could occupy positions 2 (child of the channel My Channel) and 1 (previous sibling of the channel My Channel) by moving it up one or two times, respectively. As an example, suppose that the channel My Other Channel has been moved up once. Thus, it would become a child of the channel My Channel, as shown in the following figure:

At this moment, it could be moved to positions 1 (previous sibling of the channel My Channel) or 2 (next sibling of the channel My Channel). Assuming that it is moved up one more time, it would now be the previous sibling of the channel My Channel. At this point, it could occupy positions 1 or 2 shown in the figure below, being moved down one or two times, respectively.

It is worth noting that when a channel (or channel template) is closed, the movement of other items cannot be performed inside it. As an example, see the figure below:

The selected channel, My Other Channel, when moved up will become a previous sibling of the channel My Channel. It will not become a child of the channel My Channel because it is closed. Similarly, assuming it has been moved up, it cannot become a child of the channel My Channel when moving it down, as shown in the figure below:

Analogously, if the existing structure were the structure of the figure below, the channel template My Channel Template could not be moved up, since the channel My Channel is closed and a template cannot be a previous sibling of a channel.

If desired, the structure can be reloaded to the currently existing version in the portal by clicking the Reset button. A confirmation message will be shown asking for confirmation to reload the structure.