MACROMEDIA CONTRIBUTE 3-DEPLOYING CONTRIBUTE User's Guide

SERENA®COLLAGE® 5.1.3Components User’s GuideSerena Proprietary and Confidential Information

10Serena® Collage® 5.1.3Chapter 1 Introduction to Collage ComponentsAbout the ComponentsThe Serena Collage components are a set of pre-built extensio

100Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceYou can use JavaScript to define logic that will create navigation buttons for sub-

Query NavigatorComponents User's Guide101<script language=JavaScript">node[i] = new Array("Contacts", "contacts.html&qu

102Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceThe previous page in the query resultsThe first and last pages in the query resul

Query NavigatorComponents User's Guide103What Buttons Can You Define?You can define the following unique buttons for the Query Navigator componen

104Serena® Collage® 5.1.3Chapter 3 Design-Time Component Reference4Click the Insert Query Navigator button . The Insert Query Navigator component di

Query NavigatorComponents User's Guide105</node:next>This example defines a button for an active link to the next page in the AssetQuery re

106Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceQuery Navigator Component Example<nexus:component classid="nexus/components

SelectComponents User's Guide107</node:last><node:last inactive><a href="$node.url"><img src="nav_last_inacti

108Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceThe Select Component StructureThe Select component includes two sections:The compo

SelectComponents User's Guide109For additional information on these and other data field macros that you can use with the Select component, see &

About the Layout Contribution ComponentsComponents User's Guide11About the Layout Contribution ComponentsLayout contribution components work toge

110Serena® Collage® 5.1.3Chapter 3 Design-Time Component Reference<nexus:select>Web Team</nexus:select>defines content to insert when the

SelectComponents User's Guide1115Complete the Insert Select Component dialog box. See "Select Properties" on page 111 for more informat

112Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceSelect Example 1: Deploying Content inMultiple LanguagesThe example below displays

SelectComponents User's Guide113illustrated above. When you deploy the site, your choice of deploy map automatically determines which version wil

114Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceWhen you preview the asset, it will display the following text:This page was create

WARFilerComponents User's Guide1155Set up and start deployment.6Schedule and run deployment.1: Create the Deploy Folder StructureYou must store a

116Serena® Collage® 5.1.3Chapter 3 Design-Time Component Referenceinto the WAR file. If you want to deploy any additional files, such as a script or

WARFilerComponents User's Guide1179Click OK again, and then click Close.10Click the Update Metadata button, and then click OK.11For any JSP files

118Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceTo upload application files:1In Collage, go to the Content | Deploy Folders view.2S

WARFilerComponents User's Guide1194Click Apply.5: Set Up and Start DeploymentYou must set up deployment as you would for any other deployment act

12Serena® Collage® 5.1.3Chapter 1 Introduction to Collage ComponentsThe Layout Contribution components include:Components and Master PagesYou can use

120Serena® Collage® 5.1.3Chapter 3 Design-Time Component Reference6: Schedule and Run DeploymentDo either of the following to start a deployment acti

Components User's Guide121Chapter 4Layout Contribution Component ReferenceAbout Layout Contribution Components 122Layout Contribution Field 124La

122Serena® Collage® 5.1.3Chapter 4 Layout Contribution Component ReferenceAbout Layout Contribution ComponentsLayout contribution components work tog

About Layout Contribution ComponentsComponents User's Guide123feel specifically for the contributed content, including placement on the page and

124Serena® Collage® 5.1.3Chapter 4 Layout Contribution Component ReferenceWhat are the Layout Contribution Components?Collage includes the following

Layout Contribution FieldComponents User's Guide125can also be achieved by applying a master page which contains the template elements to the lay

126Serena® Collage® 5.1.3Chapter 4 Layout Contribution Component ReferenceOr, click the Check Out button then open the file from within your HTML

Layout Contribution MetadataComponents User's Guide127Layout Contribution Field ExampleThe code example below includes a Layout Contribution Fiel

128Serena® Collage® 5.1.3Chapter 4 Layout Contribution Component ReferenceHow the Layout Contribution MetadataComponent WorksThe Layout Contribution

Layout Contribution MetadataComponents User's Guide1293Do one of the following:4Save the file.5From the Project | Contribution Setup view in Coll

Learning by Doing: Using the Sample Website ProjectsComponents User's Guide13Using the Sample Sites in Your ProjectsIf you have permission to cre

130Serena® Collage® 5.1.3Chapter 4 Layout Contribution Component ReferenceLayout Contribution PropertyYou can add the Layout Contribution Property co

Layout Contribution PropertyComponents User's Guide131How to Insert a Layout ContributionProperty ComponentYou can add the Layout Contribution Pr

132Serena® Collage® 5.1.3Chapter 4 Layout Contribution Component ReferenceVia the component integration to Macromedia DreamweaverTo add a Layout Con

Layout Contribution PropertyComponents User's Guide1335Do one of the following:6Save the file.7From the Project | Contribution Setup view in Coll

134Serena® Collage® 5.1.3Chapter 4 Layout Contribution Component Reference

Components User's Guide135Chapter 5Advanced ExamplesAbout the Examples 136Creating Printer-Friendly Contribution Documents 136Creating Printer-Fr

136Serena® Collage® 5.1.3Chapter 5 Advanced ExamplesAbout the ExamplesThis chapter provides examples of components that can be used together. You can

Creating Printer-Friendly HTML DocumentsComponents User's Guide13711Edit the Press Release_layout.html file and add the following code:12Save the

138Serena® Collage® 5.1.3Chapter 5 Advanced ExamplesTo create a printer-friendly HTML document:1Add the following AssetQuery code into the masterpage

Components User's Guide139IndexSymbols$node.approvedby 26$node.approveddate 26$node.approvedversion 26$node.assetid 26$node.assettype 26$node.che

14Serena® Collage® 5.1.3Chapter 1 Introduction to Collage Components

140Serena® Collage® 5.1.3Indexprocedures 18requirements 16using with master pages 12writing 17Conditional componentabout 57properties 59contribution d

IndexComponents User's Guide141Hhorizontal navigation bar 91HTMLauthoring environment 16knowledge requirement 16layout files 122Iimage banner, ge

142Serena® Collage® 5.1.3IndexOObject Palette, Macromedia DreamWeaver 17orderbycode 41OrderOnMetadata property 42OS redirection 57OS-specific content

Components User's Guide15Chapter 2Developing and DeployingAssets that Use ComponentsDevelopment Requirements 16Setting Up Component Integration w

16Serena® Collage® 5.1.3Chapter 2 Developing and Deploying Assets that Use ComponentsDevelopment RequirementsThis chapter describes the technical and

Inserting Components Using DreamweaverComponents User's Guide17How to Set Up Component IntegrationTo set up component integration:1In your intern

18Serena® Collage® 5.1.3Chapter 2 Developing and Deploying Assets that Use Components6Select the Window pull-down list and click Objects and Properti

Deploying Design-Time ComponentsComponents User's Guide19Deploying Design-Time ComponentsNo extra steps are required to set up deployment of desi

Copyright © 2001-2007 Serena Software, Inc. All rights reserved.This document, as well as the software described in it, is furnished under license and

20Serena® Collage® 5.1.3Chapter 2 Developing and Deploying Assets that Use Components

Components User's Guide21Chapter 3Design-Time Component ReferenceAbout Design-Time Components 22Data Field Macro Reference 23AssetQuery 32Banner

22Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceAbout Design-Time ComponentsDesign-time components are used to build information tha

Data Field Macro ReferenceComponents User's Guide23Data Field Macro ReferenceData field macros are placeholders that you can define for specific

24Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceFor example, with the Navigation Bar component, you could use macros in the followin

Data Field Macro ReferenceComponents User's Guide25How the Data Field Macros WorkEach data field macro identifies the specific type of informatio

26Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceThe standard data fields are:Field DescriptionapprovedbyIf the asset has been approv

Data Field Macro ReferenceComponents User's Guide27CreateDateDisplays the date that the asset was created. For example:$node.CreateDateYou can in

28Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceAsset Metadata FieldTo display the value of a metadata field, you must use the follo

Data Field Macro ReferenceComponents User's Guide29You can use this value to generate a link to the asset, for example:<a href="$node.url

Components User's Guide3Table of ContentsWelcome to Serena Collage . . . . . . . . . . . . . . . . . . . . . 7Typographical Conventions . . . .

30Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceSymbol Description and pattern rules Example'Displays any text or characters wh

Data Field Macro ReferenceComponents User's Guide31yDisplays the year as a number: yy displays the year in two digits yyy displays the full yea

32Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceAssetQueryThis component allows you to query for assets that fulfill certain criteri

AssetQueryComponents User's Guide33which is from the same location in the project. You can use one AssetQuery component to locate the folder that

34Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceAssetQuery PropertiesProperty Value Descriptionamongblessed true or falseWhether to

AssetQueryComponents User's Guide35docconvert(continued)To then generate links to the converted files, include any of the following data field ma

36Serena® Collage® 5.1.3Chapter 3 Design-Time Component Referencefilter (continued)For date properties, you can also use the following to define more

AssetQueryComponents User's Guide37filter (continued) A.ApprovedDate: Asset approval date A.ApprovedBy: User who approved the asset A.CheckOut

38Serena® Collage® 5.1.3Chapter 3 Design-Time Component Referencelevelsdeep (continued)NOTE The levelsdeep property is ignored if you also set the q

AssetQueryComponents User's Guide39metafilterMetadata field name and valueUses metadata fields and values to narrow the query. For example: metaf

4Serena® Collage® 5.1.3Table of ContentsAssetQuery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32How Asset

40Serena® Collage® 5.1.3Chapter 3 Design-Time Component Referencemetafilter (continued)Greater than/less than (< >) statementsGreater than/le

AssetQueryComponents User's Guide41orderbycodeLetter code for a specific sort order.Sort order of listed data. For example, orderbycode="F&q

42Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceorderonmetadataNames of metadata fields which can be used to sort resultsDefines met

AssetQueryComponents User's Guide43rootPath to the deploy folder The deploy folder that will be searched.For example, if root is set to "/We

44Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceskiplevelsNumber Allows you to skip the specified number of folders before beginning

AssetQueryComponents User's Guide45About the AssetQuery bodyThe display of asset information is specified in the AssetQuery body. The AssetQuery

46Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceFor example:<nexus:prelog><table><tr><td>Name</td><

AssetQueryComponents User's Guide47Asset metadata. To display the value of a metadata field, you must use the following syntax:$node.meta('

48Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceRecord information. You can use the following syntax to display the record number o

AssetQueryComponents User's Guide49 <nexus:exit> Indicates that no preceding record display will be repeated. For example,<nexus:next&g

Table of ContentsComponents User's Guide5About Image Buttons. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86How to Insert a

50Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceProlog SectionIf a prelog section is used to open and define headers for a table whi

AssetQueryComponents User's Guide51Querying for Properties and MetadataThe following is an example AssetQuery component with a complete AssetQuer

52Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceQuerying for Contribution Field ContentThe following is an example AssetQuery compon

AssetQueryComponents User's Guide53Modify the $node.contribution line to include a link to the $node.detailsurl field:<li><font face=&q

54Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceYou can also display a list of press releases created between two dates. The followi

BannerComponents User's Guide55How to Insert a Banner ComponentFollow the instructions below to insert a Banner component, either in Dreamweaver,

56Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceManuallyThe syntax varies depending on whether you want to insert an image banner or

ConditionalComponents User's Guide57Banner PropertiesConditionalThe Conditional component generates a javascript that redirects the user's b

58Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceConditional ParametersThe Conditional component body uses <PARAM> tags which i

ConditionalComponents User's Guide59Conditional PropertiesConditional Example 1The example below redirects different browser applications:<nex

6Serena® Collage® 5.1.3Table of ContentsHow the Layout Contribution PropertyComponent Works. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

60Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceDatabase QueryThe Database Query component displays data from records which Collage

Database QueryComponents User's Guide61In order to define a data source, you must know the following about the database:The URL, or address, of

62Serena® Collage® 5.1.3Chapter 3 Design-Time Component Reference4All data source definitions are stored in Collage as assets. Enter an Asset Name an

Database QueryComponents User's Guide636Click OK. The new data source is added to the list in the Project | Data Sources view. The data source is

64Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceHow to Create and Store Structured Queries in CollageYou can create new, blank SQL (

Database QueryComponents User's Guide65Writing the Database Query Component A simple Database Query Component is structured as follows:<nexus:

66Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceSee the following section for a complete description of all of the properties you ca

Database QueryComponents User's Guide67Writing the Database Query BodyThe body section of the Database Query component formats the display of the

68Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceThe body section can consist of three sections, an optional prelog, the database rec

Database QueryComponents User's Guide69The $node.column("column name") macro is a placeholder for the value of the column identified by

Components User's Guide7Welcome to Serena CollageThank you for choosing Serena Collage, a complete web content management package.Purpose of this

70Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceYou can use <nexus:exit>, in combination with <nexus:next>, to define un

Database QueryComponents User's Guide712Create the Database Query component, and include a layout property which specifies the path to the layout

72Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceWhen you deploy the asset that contains the Database Query component, Collage genera

ForceReferenceComponents User's Guide73Complete Database Query ExampleA complete Database Query component tag may look as follows:ForceReferenceT

74Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceTo force Collage to deploy assets whose dependencies are too complex to calculate i

Include AssetComponents User's Guide75ForceReference ExampleThe Sample site project, which gets installed with Collage, includes a sample file th

76Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceDisplay information about or generate links to other assets. You can use the compon

Include AssetComponents User's Guide77ManuallyTo manually insert the component in your own HTML editor:1Open the file to which you want to add th

78Serena® Collage® 5.1.3Chapter 3 Design-Time Component Referencecomplete the body section with a combination of standard HTML, and any combination o

Include AssetComponents User's Guide79Example 1: Including an Entire AssetYou can use the Include Asset component to automatically insert the con

8Serena® Collage® 5.1.3

80Serena® Collage® 5.1.3Chapter 3 Design-Time Component Reference<nexus:component classid="nexus/components/IncludeAsset" code="$ne

MetaTagComponents User's Guide813Select the Serena Collage Design Components palette.4Click the Insert Masterpage Body button .5Accept the defaul

82Serena® Collage® 5.1.3Chapter 3 Design-Time Component Reference3Select the Serena Collage Design Components palette.4Click the Insert MetaTag butto

MetaTagComponents User's Guide83MetaTag Example 1The following example retrieves the value of a metadata field called product, and names it "

84Serena® Collage® 5.1.3Chapter 3 Design-Time Component Reference</nexus:component>If the value of the release_date metdata field is January 18

Navigation BarComponents User's Guide85Choosing Between the NavMap and Navigation Bar ComponentsThe NavMap and Navigation Bar components provide

86Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceAbout Image ButtonsWhen an image is used as a navigation button, the Navigation Bar

Navigation BarComponents User's Guide874Click the Insert Navigation Bar button . The Insert Navigation Bar dialog box appears.5Choose whether th

88Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferencenexusComponents.jar. You can also set this property to: code="$nexusComponents&

Navigation BarComponents User's Guide893Do one of the following to define the inactive link button. This definition will be reused for all inacti

Components User's Guide9Chapter 1Introduction to Collage ComponentsAbout the Components 10About Design-Time Components 10About the Layout Contrib

90Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceSite Structure Node OptionsDeploy Folder Node OptionsUsing Data Field Macros in Butt

Navigation BarComponents User's Guide91macro to generate text for buttons based on the name of the assets they are linking to.Format date fields

92Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceorderbycodeLetter code for a specific order in which to display navigation buttons.T

Navigation BarComponents User's Guide93Navigation Bar ExamplesThe following examples diagram the syntax for Navigation Bar components, one based

94Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceSite Structure Based Navigation BarIn this example, the Navigation Bar component wil

NavMapComponents User's Guide95select property, which limits the navigation buttons to only those assets to which the indexfile metadata field is

96Serena® Collage® 5.1.3Chapter 3 Design-Time Component Referencethe site structure. In this way, you can preserve the site's information hierar

NavMapComponents User's Guide97example, you might use the Navigation Bar component to generate a sub-menu of all pages in one area, for example p

98Serena® Collage® 5.1.3Chapter 3 Design-Time Component ReferenceWriting the NavMap Component BodyThe NavMap body defines code which you will generat

NavMapComponents User's Guide99The following component provides a basic example of how you might do this, using a very simple JavaScript:<nexu