13-20 Oracle Fusion Middleware Users Guide for Site Studio Designer
in the code where you would like to add the parameter or parameter declaration, right-click, and then choose the appropriate action.
Figure 13–22 Menu for Inserting a Parameter Declaration
Figure 13–23 Menu for Inserting a Parameter
A good way to learn how to create and use parameters is to open a sample fragment from the Toolbox and see how its parameters are used. For a description of these
fragments and their parameters, see Appendix C, Sample Fragments.
13.12.7 Adding, Editing, and Deleting Fragment Elements
Elements are areas in a contribution region that can be edited using the Contributor application. These elements appear as fields in Contributor, where users contributors
can edit text, graphics, and other content.
The most common use of an element is to first create a contribution region on a page template, and then add one or more elements WYSIWYG, plain text, image, or
custom to that region. Contributors can then open the web page containing the region and add and edit the text or graphics in each field.
A more advanced use of an element is to include it in a fragment to create a static list. A static list bundles multiple elements in a table-like layout that allows contributors to
add, edit, delete, and even rearrange rows and columns of elements see Static List
Fragments on page C-23.
13.12.7.1 Adding an Element to a Fragment
To add an element to a fragment, perform these tasks:
1. With the fragment open in the Fragment Editor, click Elements.
This opens the Fragments Elements dialog see Fragment Elements Dialog
on page A-91.
Working With Fragments 13-21
Figure 13–24 Fragment Elements Dialog
2. Click the type of element to add to the fragment: WYSIWYG, plain text, image, or
custom.
Figure 13–25 WYSIWYG Element Icon
Figure 13–26 Plain Text Element Icon
Figure 13–27 Image Element Icon
Figure 13–28 CustomElement Icon
3.
In the Element dialog, follow the same steps as if you were adding the element to a contribution region.
4. Click OK to close the Element dialog and then OK again to close the Fragment
Elements dialog.
13.12.7.2 Editing an Element in a Fragment
To edit an element in a fragment, perform these tasks:
1. With the fragment open in the Fragment Editor, click Elements.
2.
In the Fragment Elements Dialog
on page A-91, select the desired element and
then click Edit. 3.
In the Element dialog, follow the same steps as if you were editing an element in a contribution region.
4. Click OK to close the Element dialog and then OK again to close the Fragment
Elements dialog.
13.12.7.3 Deleting an Element in a Fragment
To delete an element in a fragment, perform these tasks:
1. With the fragment open in the Fragment Editor, click Elements.
13-22 Oracle Fusion Middleware Users Guide for Site Studio Designer
2.
In the Fragments Element dialog see Fragment Elements Dialog
on page A-91,
select the desired element and then click Delete. 3.
Click OK to close the Fragment Elements dialog.
The Elements button only displays in the Fragment Editor when the fragment is of the type staticlist see
Specifying Fragment Properties on page 13-12.
The Fragment Elements dialog contains an Advanced button. This opens a text editor that you can use to customize your element even more. However, when you start
editing an element this way, you cannot return to the Fragment Elements dialog graphical user interface because there is no interface support for these edits.
Static list fragments are designed for use with the Contributor application. As such, when you add the static list to a page template, you must add it to a contribution
region and then assign a data file to that region.
13.13 Fragment Libraries
A fragment is a container for code HTML, XML, JavaScript, Idoc Script, and optionally JSP or ASP, files referenced by that code graphics, CSS, and additional
scripts, and parameters that govern how that code is added to a template.
A fragment library is a container for one or more fragments, and it is how Site Studio stores and manages fragments.
You work with fragment libraries in the following ways:
■
About Fragment Libraries on page 13-22
■
Saving a Fragment in a Fragment Library on page 13-23
■
Making a Fragment Library Read-Only on page 13-24
■
Uploading and Downloading Fragment Libraries on page 13-24
13.13.1 About Fragment Libraries
Fragments are stored in fragment libraries. A fragment library is stored in the content server as a managed content item.
The library comprises two parts: an XML file and a zip file. The XML file describes every fragment in the library, and the zip file holds all of the fragment assets
referenced by each fragment in the library.
In the content server, the XML file serves as the alternate file the Web Location, and the zip file serves as the native file. If you were to search for the fragment library SS_
Fragments_Examples a library included with Site Studio, you would see the following on the content information page:
Metadata Assigned values
Content ID: SS_Fragments_Examples
Title: SS_Fragments_Examples
WebsiteObjectType: Fragment
Web Location: HTTP:Sitegroupspublicdocumentsadacct ss_fragments_
examples.xml Native File:
SS_Fragments_Examples.zip
