9-6 Oracle Fusion Middleware Users Guide for Site Studio Designer
Copying a Definition from the list 1.
In the menu on the Site Assets pane, select the definition type.
2.
Select the definition you want to copy from the list.
3.
Click the Create New icon Figure 9–5
, select Copy, and then Selected:
The Assign Info Form displays for you to check the item into the content server.
Figure 9–5 Create New Icon
4. Enter appropriate values for the Assign Info Form.
5. When complete, click Assign Info.
6. The definition is copied.
When the definition has been copied, it can then be opened to edit.
Copying a Definition from the server 1.
In the menu on the Site Assets pane, select the definition type.
2. Click the Create New icon
Figure 9–5 , select Copy, and then from Server.
A search results page displays.
3. Click the corresponding Select button of the ones you want to copy.
The Assign Info Form displays for you to check the item into the content server.
4. Enter appropriate values for the Assign Info Form.
5. When complete, click Assign Info.
6. The definition is copied.
Copying a Definition from your local instance 1.
In the menu on the Site Assets pane, select the definition type.
2. Click the Create New icon
Figure 9–5 , select Copy, and then from Local.
An open file dialog displays.
3. On your local instance, navigate to the definition you want to copy.
4. Select the definition and click Open.
The Assign Info Form displays for you to check the item into the content server.
5. Enter appropriate values for the Assign Info Form.
6. When complete, click Assign Info.
7. The definition is copied.
9.5 Viewing the Content Information of a Definition
To view content information for a definition, perform these tasks:
1. In the menu on the Site Assets pane, select the definition type.
2. Select a definition from the list.
3. Click the Doc Info icon
Figure 9–6 .
Working With Definitions 9-7
The content information page is displayed.
Figure 9–6 Doc Info icon
9.6 Adding a Definition to a Site
To add a definition to a site, perform these tasks:
1. In the menu on the Site Assets pane, select the definition type.
2. Click the Add to Site icon
Figure 9–7 .
A search results page displays.
Figure 9–7 Add to Site Icon
3. Select the definition or definitions to add, click Site Studio, and then Select
Marked Documents .
4.
Depending on your configuration, you may receive a caution that you are about to add existing assets to your site. Click OK.
The definition is now associated with the Web site, and you can now open the definition to edit.
9.7 Removing a Definition from a Site
To remove a definition from a site, perform these tasks:
1.
In the menu on the Site Assets pane, select the definition type.
2.
From the list, select the definition to be removed and click the Remove From Site icon
Figure 9–8 .
When you remove a definition, you are simply removing it from the site, not deleting from the content server.
Figure 9–8 Remove from Site Icon
9.8 Working With Placeholder Definitions
When you insert a placeholder on a page template, it is simply a named marker where content displays. The placeholder definition controls how the data displays in the
placeholder. Placeholder definitions also control if the contributor can approve or reject the assets in workflow, if the contributor can view web reports, if the contributor
can edit the assets in the placeholder, and more.
The relationship between the placeholder name and the placeholder definition is called the mapping. These mappings are used to determine the placeholder definition
used as the default when you create a new placeholder.
9-8 Oracle Fusion Middleware Users Guide for Site Studio Designer
The mappings can be done in four ways. A default mapping is defined in the Web site properties under the Default Placeholder Definition. If a mapping is made here, then
it is the one used between a placeholder definition and a placeholder name if none of the other three mappings have been defined.
A global mapping, made in the Placeholder Definition Mappings dialog see Placeholder Definition Mappings Dialog
on page A-104, establishes a default mapping for the placeholder name throughout the site. The placeholder name can be
used on multiple templates in multiple sections, and the same mapping applies. A section property mapping is defined in the section properties under the Primary
Page Placeholder Definition Mappings and Secondary Page Placeholder Definition Mappings. The section this is done in now uses a different mapping from any other
section where the placeholder is used. The section property mapping overrides a global mapping and a default mapping, but not a mapping in a tag.
The fourth method of creating a mapping is by defining the mapping in the placeholder tag itself. This type of mapping overrides all other mappings, including
global mappings. When you define a mapping in the placeholder tag, you are making a change to the placeholder tag in source view. When you use a mapping this way,
this means that every time the page template is used, the placeholder on the template always uses the specified placeholder definition regardless of where in the Web site
the page template is used.
What the contribution region identified by the placeholder contains, and how it looks on the site, is defined using region templates and region definitions see
Region Templates and Region Definitions
on page 3-14. A page template may contain multiple placeholders, each of which represents a contribution region on the page.
There are no files associated with placeholders; that is, there are no placeholder files on the content server.
This section covers the following topics:
■
Specifying a Default Placeholder Definition on page 9-8
■
Creating a Global Placeholder Definition Mapping on page 9-9
■
Creating a Section Property Placeholder Definition Mapping on page 9-9
■
Specifying a Placeholder Definition Directly in the Placeholder Tag on page 9-10
■
Associating a Placeholder with a Global Placeholder Definition on page 9-11
■
Adding a Region Definition to a Placeholder Definition on page 9-11
■
Associating a Region Template with a Placeholder Definition on page 9-12
■
Associating a Subtemplate with a Placeholder Definition on page 9-13
9.8.1 Specifying a Default Placeholder Definition
The default placeholder definition is the placeholder definition used when no other mappings apply. It is considered more of a catch-all.
To specify a default placeholder definition, follow these steps:
1.
In the Web Site Properties, click in the Default Placeholder Definition.
2.
Click the additional information icon that appears. A content server search displays, showing the available placeholder definitions.
3.
Select the placeholder definition to use as the default.
4.
The default placeholder definition appears in the Web site properties.
Working With Definitions 9-9
9.8.2 Creating a Global Placeholder Definition Mapping
The list of available global placeholder mappings are defined on the Placeholder Definition Mappings dialog see
Placeholder Definition Mappings Dialog on
page A-104, which is available by selecting Tools from the menu bar, then selecting Define Placeholder Definition Mappings
. The placeholder mappings allow a placeholder to have a different definition depending on whether the placeholder is
used on a primary or a secondary page. The mappings are stored in the project file for the Web site.
The global placeholder definition mapping overrides the mapping created as the default placeholder definition in the Web site properties see
Specifying a Default Placeholder Definition
on page 9-8. To create a global placeholder mapping, follow these steps:
1. From the menu bar, select Tools, and then Define Placeholder Definition
Mappings .
The Placeholder Mappings dialog opens see Placeholder Definition Mappings
Dialog on page A-104.
2. Click Add to create a new mapping.
The Define Placeholder Definition Mapping dialog opens see Define Placeholder
Definition Mapping Dialog on page A-105.
3. Enter a placeholder name that is easy to recognize, and also helps you understand
what the mapping does. In the two menus, enter a placeholder definition that the placeholder uses on a primary page and on a secondary page. You can enter for
either a primary page or a secondary page, or both.
4. Click OK.
5. Your placeholder definitions now display in the Placeholder Mappings dialog, and
are available to select when you insert a placeholder.
9.8.3 Creating a Section Property Placeholder Definition Mapping
The section property placeholder definition mapping lists the mapping between a placeholder name and a placeholder definition. The section this mapping is in uses a
different mapping from any other section where the placeholder is used.
The section property placeholder definition mapping overrides the global placeholder definition mapping and the default placeholder definition.
There are two ways to make this section property, by using a dialog, and by entering the placeholder name and placeholder definition directly in the section properties.
The dialog uses a friendlier user interface.
To create a section property placeholder definition mapping using the dialog, follow these steps:
1.
Right-click a page template within the appropriate section in the hierarchy. In the menu, select Placeholder Section Properties...
The Placeholder Section Properties dialog opens see Placeholder Section
Properties Dialog on page A-101.
2. Click Add.
The Edit Placeholder Section Properties dialog opens see Edit Placeholder
Section Properties Dialog on page A-102.
9-10 Oracle Fusion Middleware Users Guide for Site Studio Designer
3.
Enter the Name, and the placeholder definition ID . If you want to include a region template, subtemplate, or contributor data file in the section property, add
those as well.
4. Click OK to close the Edit Placeholder Section Properties dialog.
The section property placeholder name mapping is created.
5. Click OK to close the Placeholder Section Properties dialog.
To create a section property placeholder definition mapping directly in the section properties, follow these steps:
1.
View the section properties for the section you want to create the mapping in.
2.
In the Primary Page Placeholder Definition Mappings, enter the placeholder name and placeholder definition in this format:
name=contentID where the name is the placeholder name, and the content ID is the content ID of
the placeholder definition. To enter multiple placeholder names and placeholder definitions, use an ampersand between each pairing, in this manner:
name1=contentID1name2=contentID2name3=contentID3
3.
For the secondary pages, enter a placeholder name and placeholder definition for the Secondary Page Placeholder Definition Mappings. Multiple name and
definition pairings are allowed just as in the Primary Page Placeholder Definition Mappings.
4.
The Primary and Secondary Page Placeholder Definition Mappings display in the section properties.
9.8.4 Specifying a Placeholder Definition Directly in the Placeholder Tag
The placeholder tag can be written so that the placeholder definition is specified explicitly in the placeholder tag. This direct specification is used each time the page
template is used.
This method of correlating a placeholder definition and a placeholder tag overrides all other placeholder definition mappings.
To specify the placeholder definition directly in the placeholder tag, follow these steps:
1.
Open the page template that contains the placeholder.
2. Click the Source View tab.
3.
In the placeholder tag, enter the mapping in this manner: --wcmPlaceholderSales, placeholderDefinitionDocName=placedef_
salescontact-- In this example, the placeholder name is Sales, and the placeholder definition
content ID is placedef_salescontact.
4.
The mapping is now created in the tag. You can also assign a placeholder definition to be written in the tag from the Define
Placeholder dialog see Define Placeholder Dialog
on page A-106:
1.
Open the page template that contains the placeholder.
2.
Double-click the placeholder.
Working With Definitions 9-11
The Define Placeholder dialog opens. You can also do this by inserting a new placeholder.
3.
The name in the menu is the name of the placeholder you selected unless the placeholder is new. Check the Optionally specify the placeholder definition on
the template check box.
The dialog expands. Select the placeholder definition to map in the placeholder tag from the menu.
4.
The mapping is now created in the tag.
9.8.5 Associating a Placeholder with a Global Placeholder Definition
When you have created the placeholder mappings, the placeholder definition is associated to placeholders you create according to the mappings.
By using a different placeholder definition in a placeholder, you can use different subtemplates, region templates, or allow for some instances of a placeholder to be
available to contributors for editing, or any other aspect that has been defined in your placeholder definition.
To associate a placeholder with a global placeholder definition, follow these steps:
1.
Insert the placeholder on the page template see Inserting Placeholders
on page 8-7
2.
As you insert the placeholder, the Define Placeholder dialog see Define
Placeholder Dialog on page A-106 opens. Select a placeholder name.
3. Click OK.
4.
The placeholder definition is now associated with the placeholder.
9.8.6 Adding a Region Definition to a Placeholder Definition
The placeholder definitions list the region definitions, region templates, and subtemplates associated and thus available to use with the placeholder. Adding a
region definition to, or removing a region definition from, a placeholder definition is a very simple task.
When a region definition is associated with a placeholder, then only those elements that are associated with that region definition are available to use in Contributor. This
is especially important to remember in those cases where you might give a contributor access to switch the region content or the region template.
To associate a region definition with a placeholder definition, follow these steps:
1.
Open the placeholder definition from the Site Assets pane. The Placeholder Definition dialog see
Placeholder Definition Dialog on
page A-103 appears.
2. In the Allowed Region Definitions pane, click Add.
The Select a Region Definition Dialog appears.
3. Select a region definition, and click OK.
4.
The region definition is now associated with the placeholder definition. When you have added a region definition, you may want to add a region template to
associate with the definition.
9-12 Oracle Fusion Middleware Users Guide for Site Studio Designer
To remove a region definition from a placeholder definition, follow these steps:
1.
Open the placeholder definition from the Site Assets pane. The Placeholder Definition dialog see
Placeholder Definition Dialog on
page A-103 appears.
2.
In the Allowed Region Definitions pane, select a region definition.
3. Click Remove.
4.
The region definition is now removed from the placeholder definition.
9.8.7 Associating a Region Template with a Placeholder Definition
The placeholder definition lists the region definitions, region templates, and subtemplates associated and thus available to use with the placeholder. Adding a
region definition to, or removing a region definition from, a placeholder definition is a very simple task.
When a region template is associated with a placeholder, then the region template along with the region definition used, can define the element definitions which
displays the data and be available in Contributor. Region templates are used to define a specific layout of elements; when a region template is added, it must be associated
with a region definition already in the placeholder definition.
To associate a region template with a placeholder definition, follow these steps:
1.
Open the placeholder definition from the Site Assets pane. The Placeholder Definition dialog see
Placeholder Definition Dialog on
page A-103 appears.
2.
In the Allowed Region Definitions pane, select a region definition that the region template is used with.
3. In the Allowed Region Templates pane, click Add.
The Select a Region Template Dialog appears.
4. Select a region definition, and click OK.
5.
The region definition is now associated with the placeholder definition. Only those region templates that are associated to a region definition displays in the
Select Region Template dialog. The association between a region template and a region definition is stored as metadata on the region template.
To make a region template the default, complete these steps:
1.
Open the placeholder definition from the Site Assets pane. The Placeholder Definition dialog see
Placeholder Definition Dialog on
page A-103 appears.
2.
In the Allowed Region Definitions pane, select a region definition. The Allowed Region Templates pane displays the associated region templates.
3.
In the Allowed Region Templates pane, select a region definition.
4. Click Make Default.
5.
The region template is now the default template for the selected region definition within this placeholder definition.
To remove a region template from a placeholder definition, follow these steps:
Working With Definitions 9-13
1.
Open the placeholder definition from the Site Assets pane. The Placeholder Definition dialog see
Placeholder Definition Dialog on
page A-103 appears.
2.
In the Allowed Region Templates pane, select a region template.
3. Click Remove.
4.
The region template is now removed from the placeholder definition.
9.8.8 Associating a Subtemplate with a Placeholder Definition
The placeholder definition lists the region definitions, region templates, and subtemplates associated and thus available to use with the placeholder. Adding a
subtemplate to, or removing a subtemplate from, a placeholder definition is a very simple task.
When you use a subtemplate associated with a placeholder, the site assets, and any placeholders on the subtemplate, appear on the final web page. It is not necessary to
use a subtemplate.
A subtemplate can be any section of HTML comprised of static assets and placeholders, each with their own definitions. This is especially important to
remember in those cases where you might give a contributor access to switch the region content or the region template.
To associate a subtemplate with a placeholder definition, follow these steps:
1.
Open the placeholder definition from the Site Assets pane. The Placeholder Definition dialog see
Placeholder Definition Dialog on
page A-103 appears.
2. In the Allowed Subtemplates pane, click Add.
The Select a Subtemplate dialog appears.
3. Select a subtemplate, and click OK.
4.
The subtemplate is now associated with the placeholder. To remove a subtemplate from a placeholder definition, follow these steps:
1.
Open the placeholder definition from the Site Assets pane. The Placeholder Definition dialog see
Placeholder Definition Dialog on
page A-103 appears.
2.
In the Allowed Subtemplates pane, select a subtemplate.
3. Click Remove.
4.
The subtemplate is now removed from the placeholder definition.
9.9 Working With Region Definitions
Each region definition contains a list of associated element definitions. This list of definitions is the complete list of elements available to use in the layout of the region
template, after the region template and region definition are associated.
A region template is not required to use all elements available in a region definition. Usually, not all elements are used to display in the region template. However, after
Contributor is launched, all elements displays in the editor, whether they are displayed in the associated region template or not.
9-14 Oracle Fusion Middleware Users Guide for Site Studio Designer
The association between a region template and a region definition is stored in the xRegionDefinition metadata for the region template.
Associating an element definition with a region definition The region definitions list the element definitions available to use with the region
template. Adding an element definition to, or removing an element definition from, a region definition is a very simple task.
To associate an element definition with a region definition, follow these steps:
1.
Open the region definition from the Site Assets pane. The Region Definition dialog see
Region Definition Dialog on page A-72
appears.
2. Click Add.
The Element Dialog see Element Dialog
on page A-73 appears.
3.
Enter the information for the element using a good naming convention to easily recognize the element definition as it is used, select the element definition from
the menu, and click OK.
4.
The element definition is now associated with the region definition. It is also possible to embed the element definition in the region definition. When you
embed the element definition, you are creating a singular instance of the named element definition within the region definition, which is not affected by global changes
in the way that including the element definition by reference would.
To embed an element definition in a region definition, add it as you would normally, but on the Element Dialog see
Element Dialog on page A-73, check the Embed the
element definition inside the region definition check box.
To remove an element definition from a region definition, follow these steps:
1.
Open the region definition from the Site Assets pane. The Region Definition dialog see
Region Definition Dialog on page A-72
appears.
2. Select an element definition. Click Remove.
3.
The element definition is now removed from the region definition.
Region definitions define the types of content used on a Web site. They are essentially
groups of individual elements which define the various chunks of reusable information for a particular site content type.
In addition to defining site content types in terms of its constituent parts elements, region definitions also specify the content creation and switching options available to
contributors for its associated contribution regions. For example, if a contribution region is set up to allow contributors to switch the content of that region, they might
be allowed to use existing contributor data files on the server only not native documents or new contributor data files. Please note that placeholder definitions
control whether contributors can actually switch content in contribution regions. Finally, region definitions also set the default metadata for content in contribution
regions as it is checked into the content server.
Working With Definitions 9-15
9.10 Working With Element Definitions
