cascade server technical guide primer · 2018. 3. 8. · hello, world! this is my first page!. 5....

23
Cascade Server Technical Guide Primer Hannon Hill Corporation 950 East Paces Ferry Road Suite 2440, Atlanta, GA 30326 www.hannonhill.com o: 678.904.6900 f: 678.904.6901

Upload: others

Post on 10-Oct-2020

0 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer

HannonHillCorporation950EastPacesFerryRoad

Suite2440,Atlanta,GA30326www.hannonhill.com

o:678.904.6900f:678.904.6901

Page 2: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:

http://www.hannonhill.com

TableofContents

Introduction................................................................................................................................................................... 3

A.CreateaNewSite ..................................................................................................................................................... 3

B.CreateaNewTemplate............................................................................................................................................ 4

C.CreateaNewConfigurationSet............................................................................................................................... 5

D.CreateaNewPageUsingthisConfigurationSet.................................................................................................... 6

E.CreateHeaderandFooterRegionsintheTemplate .............................................................................................. 7

F.CreateaHeaderBlock............................................................................................................................................... 8

G.CreateaFooterBlock ..............................................................................................................................................10

H.AssignHeaderandFooterBlockstoRegionsinTemplate ...................................................................................10

I.CreateaPrinterFriendlyTemplate.......................................................................................................................... 11

J.AssignPrinterFriendlyTemplatetoConfigurationSet..........................................................................................12

K.AddMetadatatoPage.............................................................................................................................................13

L.CreateanAssetFactory ...........................................................................................................................................14

M.UseNewAssetFactorytoCreatePage .................................................................................................................15

N.CreateaDataDefinition..........................................................................................................................................16

O.AttachDataDefinitiontoNewPage ...................................................................................................................... 17

P.CreateXSLTStylesheetforXMLFormatting ..........................................................................................................18

Q.AttachStylesheettoPressReleasePage ...............................................................................................................19

R.CreateAssetFactoryfromPressReleasePage.....................................................................................................20

S.CreateaTransportforPublishing ...........................................................................................................................21

T.CreateaDestinationforPublishing ....................................................................................................................... 22

U.PublishOuttheIntroSite....................................................................................................................................... 23

Page 3: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 3

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

Introduction

WelcometotheCascadeServerTechnicalGuidePrimer!ThepurposeofthisguideistogivenoviceusersabasicintroductiontoCascadeServerandwalkthroughcreatingasimplewebsitefromscratch.Aftercompletingthisguide,youwillhave:

• Createdanewsitetemplatewithmultipleregions• Createdpagesbasedonnewtemplate• Createdprinterfriendlyversionofpages• Createdanassetfactoryforneweasycreationofnewpages• Attachedmetadatatopages• Createdstructureddatafieldsforpages• Publishedoutsite

Estimatedcompletiontime:1hour

A.CreateaNewSite

Wewillbeginbyrunningthenewsitewizard.Thenewsitewizardisatime‐savingconveniencetoolthatsetsupfoldersandothersite‐specificcomponentsforyou;otherwise,thesewouldhavetobecreatedmanually.Inlaterguides,allthevariouscomponentsneededforasitewillbeexplainedindetail.

Tocreateanewsite:

1. ClickHomeonthemenubar.2. SelectTools‐>Import‐>NewSitefromthemenubar.3. FortheSiteNamefield,typeintro.4. Whenfinished,clickSubmittocreatethenewsite.

Afterthenewsitewizardruns,you'llnoticeanewbaselevelfoldertitledintro.Insideisanotherfoldertitled_internalcontainingfourmorefolders:assetfactories,blocks,stylesheets,andtemplates.Asperestablished

Page 4: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 4

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

bestpractices,itisrecommendedthatthesefoldersareusedtostoretheirrespectiveobjects,butthisisbynomeansrequiredandthefolderstructurecanbealteredtosuitindividualneedsorpreferences.Ifusedasrecommended,thesefolderswillonlycontainobjectsusedbyCascadeServerandneverpublishedouttoawebserver.Therefore,thenewsitewizardmarksthesefolderstobeexcludedfromindexingandpublishing(youcanverifythisviatheedittabontheindividualfolders).

B.CreateaNewTemplate

Afterrunningthenewsitewizard,thenextstepistocreateanewtemplate.AtemplateistheXML/HTMLframeworkwherebycontentregionsaredefined.Templatescontainoneormoreregionsthatspecifyareaswherecontentblocksandstylesheetscanbeapplied.Thetemplateservesasabasiclayoutstructureforpagesinthesiteandprovidesamechanismforaggregatingmultiplepiecesofcontenttogether.

Tocreateanewtemplate:

1. Intheleftassettree,navigatetothenewlycreatedtemplatesfolderat/intro/_internal/templates.2. SelectNew‐>Default‐>Templatefromthemenubar.

3. TypethefollowingcodeintheXMLbox:

<html><head><title>IntroSite</title></head><body><system‐regionname="DEFAULT"/></body></html>

4. ClickontheSystempanetogivethetemplateaname.IntheSystemNamefield,typehtml.5. ClickthebrowseiconnexttoTarget.Atargetisasitedefinitionobjectwhosepurposeandimportance

willbeexplainedinfollowingguides.Selecttheintrotarget(whichwascreatedautomaticallybythe

Page 5: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 5

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

newsitewizard)andclickconfirm.

6. Whenfinished,clickSubmittosavethenewtemplate.

Thesystem‐regiontagisthemostbasicandessentialpseudocodethatCascadeServerprovides.Thisdefinesregionswithintemplateswherecontentcanbeinsertedintheformofblocks.AlltemplatesmustincludeaDEFAULTregion,whichwillbepopulatedwithindividualpagecontent.Tocreateadditionalcontentregions,simplywriteanewsystem‐regiontagandreplacetheword"DEFAULT"withanyothernameyoulike.

C.CreateaNewConfigurationSet

Withyourtemplatecomplete,youneedawaytotiethetemplatetopages;thisisdonewithaconfigurationset.

Tocreateanewconfigurationset:

1. ClickAdministrationonthemenubar.2. ClickConfigurationSetsintheleftsidemenu.3. ClickNewConfigurationSet.

4. FortheNamefield,typeStandard.5. ClickthefolderbrowseiconfortheParentContainerandselectintro.6. ClickontheConfigurationspane.

Page 6: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 6

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

7. IntheAddsection,attachatemplatebyclickingthetemplatebrowseiconandselectingtheintro/_internal/templates/htmltemplateinthepopupwindow.Clickconfirm.

8. TypeHTMLintheNamefield.

9. ClickAddthisnewconfigurationwiththeabovetemplateandnameinordertosavethe

configuration.10. Additionalpropertieswillnowbemadeavailable.Checktheboxmarkeddefaultconfiguration,ifnot

alreadychecked.11. Whenfinished,clickSubmittosavethenewconfigurationset.

Youmaybeasking:whynotjustpointeachpagedirectlytothetemplate?Well,thereareseveralreasonswhyusingaconfigurationsetisbeneficial.Primarily,aconfigurationsetisusedtotieseveraldifferenttemplatestoasinglepage.Becausemultipletemplatescanbecreatedforvariouscontentoutputtypes(HTML,WML,PDF,

RTF,andXMLamongothers),aconfigurationsetisusedtotieanarrayoftemplatestoapage.Secondly,aconfigurationsetallowsasingletemplatetobeusedacrossanentiresite,whileallowingdifferentblocksandstylesheetstobeappliedtothetemplate'sregions.Forexample,ifthereisasetofpagesusingonetemplate

thathasaspecifiedfooterblock,butsomeofthosepagesdonotneedthatfooterblock,thenyouwouldcreatetwoconfigurationsinyourconfigurationsets–onethathasthefooterblockassignedandanotherthatdoesnot.Byhavingtwoconfigurations,thesitewillstillhaveonetemplatebuttwosetsofpagesthathave

differentcontentpluggedinitsregions.Lastly,aconfigurationsetallowsforeasytemplateassociationchanges.Withoutaconfigurationset,eachpageinasitewouldhavetobeindividuallyupdatedifyouweretoaddorremoveatemplate.Bypointingeachpagetoaconfigurationset,youonlyhavetoupdatethe

configurationsetitselftoaddorremovetemplateassociations.Ifthisisallabitconfusing,justreadon;theimportanceoftheconfigurationsetwillbecomemoreclearbytheendofthisguide.

D.CreateaNewPageUsingthisConfigurationSet

Withyourconfigurationsetnowready,youcancreateanewpagebasedonthetemplateassociatedwiththisconfigurationset.

Tocreateanewpage:

1. ClickHomeonthemenubar.2. Clickontheintrofolderintheleftassettree.3. SelectNew‐>Default‐>Pagefromthemenubar.

Page 7: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 7

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

4. IntheWYSIWYGeditor,typeinHello,world!Thisismyfirstpage!.

5. ClicktheSystempaneandtypeexampleintheSystemNamefield.6. VerifythattheParentFolderisalreadysettointro.Ifnot,clickthefolderbrowseicon,selectintro

fromthepop‐upwindow,andclickConfirm.

7. ForConfigurationSet,clickthebrowseicon,selectintro/Standard,andclickConfirm.

8. Whenfinished,clickSubmittosavethenewpage.

Congratulations!You'vecreatedyourfirstsiteandpageentirelyfromscratch.Subsequentpagesaremuchfastertocreate,asyoucansimplycopythispageasmanytimesasyouwishor,aswe'llseesoon,youcancreateanassetfactorybasedonthispagewhichcanbeusedtoquicklycreatesimilarpages.

E.CreateHeaderandFooterRegionsintheTemplate

Nowthatwe'vecreatedapagebasedonasimpleone‐regiontemplate,we'llexpandthetemplatetoincludetwomoreregions:headerandfooterregionsintowhichwewillplugcontentintointheformofblocks.

Page 8: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 8

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

Toaddthetwoadditionalregions:

1. Opentheintro/_internal/templates/htmltemplateandclicktheEdittab.2. Addaheaderandfooterregionstothetemplate.Thefinalhtmlshouldbeasfollows:

<html><head><title>IntroSite</title></head><body><system‐regionname="HEADER"/><system‐regionname="DEFAULT"/><system‐regionname="FOOTER"/></body></html>

3. Whenfinished,clickSubmittoupdatethetemplate.

Ourtemplatenowcontainsthreeregions,butifyougobacktotheexamplepage,youonlyseecontentitthedefaultregion.Thisisbecausewehaven'tassociatedanycontentblockstothesenewregions.Nextwewillcreateblocksforthesetworegionsandplugthemintothetemplate.

F.CreateaHeaderBlock

Firstwewillcreateablockfortheheaderregion.Inthisblockwewilldownloadanimageandplugitintotheheaderregion.

Tocreatetheheaderblock:

1. ClickontheintrofolderandselectNew‐>Default‐>Folderfromthemenubar.

2. TypefilesintotheSystemNamefieldandclickSubmittocreatethenewfolder.3. Visithannonhill.comanddownloadtheHannonHilllogotoyourdesktop.

Page 9: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 9

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

4. SelectNew‐>Default‐>Filefromthetopmenubar.

5. IntheUploadsection,usethefileuploaderandselecttheHannonHilllogofromyourdesktop.6. ClickSubmittocreatethenewfile.

7. Clickonintro/_internal/blocksandselectNew‐>Default‐>Blockfromthemenubar.

8. SelectXHTMLBlockfromthelistofblocktypesandclickSubmit.

9. IntheWYSIWYGeditor,clicktheInsert/editimagebuttonandattachthelogoimagebyclickingimagebrowseicon,selecting/intro/files/logo.pngandclickingConfirm.

10. TypeLogointotheAlternateTextfieldandclickInsert.

Page 10: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 10

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

11. CenterthelogobyclickingtheAligncenterbutton.12. ClicktheSystempaneandtypeheaderintotheSystemNamefield.13. Whenfinished,clickSubmittosavethenewblock.

G.CreateaFooterBlock

Nextwewillnowcreateablockforthefooterregion.Inthisblockwewilltypeincopyrightinformationsandplugitintothefooterregion.

Tocreatethefooterblock:

1. Clickonintro/_internal/blocksandselectNew‐>Default‐>Blockfromthemenubar.2. SelectXHTMLBlockfromthelistofblocktypesandclickSubmit.3. IntheWYSIWYGeditor,clicktheHorizontalrulebutton,type75inthewidthfield,select%fromthe

widthdropdown,andclickInsert.4. Belowthehorizontalrule,typeCopyright2008.Allrightsreserved.andcenterthetextbyclickingthe

Aligncenterbutton.

5. ClicktheSystempaneandtypefooterintotheSystemNamefield.6. Whenfinished,clickSubmittosavethenewblock.

H.AssignHeaderandFooterBlockstoRegionsinTemplate

Nowthatwehavetheblockscreatedweneedtoplugthemintothetemplateregionsthatwecreatedearlier

Toassigntheblockstothetemplateregions:

1. Opentheintro/_internal/templates/htmltemplateandclicktheEdittab.2. ClickontheRegionspane.3. Clicktheblockbrowsericonintheheaderregion,selectintro/_internal/blocks/header,andclick

Confirm.

Page 11: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 11

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

4. Clicktheblockbrowsericoninthefooterregion,selectintro/_internal/blocks/footer,andclickConfirm.

5. Whenfinished,clickSubmittoupdatethetemplate.

Ourthree‐regiontemplatenowcontainscontentinallthreeregions.Ifyounavigatetothe/intro/examplepage,you'llnoticethatthatthecontentblocksintheheaderandfooterregionsarenowdisplayed.

I.CreateaPrinterFriendlyTemplate

Atthispointinthesitedesignphase,repurposingcontentfordifferentusesbecomesveryeasy.Saywewantedtomakeaprinterfriendlyversionofourpagebystrippingtheheaderandfooterregions,leavingonlythepage'sDEFAULTregioncontent.Wecaneasilydothisbysettingupasecondtemplatethatonlycontainsthisoneregion.

Tocreateaprinterfriendlytemplate:

1. Opentheintro/_internal/templates/htmltemplateandclicktheCopytab.2. TypeprinterintotheSystemNamefieldandclickSubmit.3. ClickEditonthenewprintertemplate.4. Theprinterfriendlyversionofthepageshouldnotincludetheheaderorfooterregions,soremove

the2linesthatcontaintheseregions.Thefinalhtmlshouldbeasfollows:<html><head><title>IntroSite</title></head><body><system‐regionname="DEFAULT"/></body></html>

5. Whenfinished,clickSubmittoupdatethetemplate.

Page 12: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 12

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

J.AssignPrinterFriendlyTemplatetoConfigurationSet

Theimportanceoftheconfigurationsetwillnowbecomemoreclearasweaddasecondtemplatetohandletheprinterfriendlyversionofourpages.

Toassigntheprinterfriendlytemplatetotheconfigurationset:

1. ClickAdministrationonthemenubar2. ClickConfigurationsSetsintheleftsidemenu.3. Opentheintro/StandardconfigurationsetandclickontheEdittab.4. ClickontheConfigurationspane.5. IntheAddsection,attachatemplatebyclickingthetemplatebrowseiconandselectingthe

intro/_internal/templates/printertemplateinthepopupwindow.6. TypePrinterFriendlyintheNamefield.

7. ClickAddthisnewConfiguration.8. Whenfinished,clickSubmittoupdatetheconfigurationset.

Ifyounavigatebacktotheintro/examplepage,youshouldnowseethetwodifferentoutputsatthetopofthepage:HTMLandPrinterFriendly.NoticethatCascadeisonlyusingthecontentofthepageonce,butbysettingupdifferenttemplates,thecontentisrepurposedtofulfilldifferentneeds.Thisisonlythetipoftheicebergasfarascontentrepurposinggoes.Inlaterguideswewillshowyouhowto setup PDF, XML, RTF, and WML outputtypes.

AdvancedTopic:Thesameresultcouldbeachievedinthisstepbyreusingthehtmltemplateandcheckingthe"NoBlock"checkboxesnexttotheheaderandfooterregionsfortheprinterfriendlyconfiguration.Thisconfigurationwouldusethesametemplateforbothoutputs,butwouldplugtheblocksintotheHTMLoutputandnottheprinterfriendlyoutput.

Page 13: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 13

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

K.AddMetadatatoPage

Metadataissimplydatathatdescribesanasset.Commonfieldssuchastitle,summary,andkeywordsprovide

quickinformationaboutthecontentcontainedinsideofaparticularasset.CascadeServerusestwotypesofmetadata:wiredanddynamic.Wiredmetadatafieldsarethedefaultfieldsincludedinthesystemwheredynamicmetadatafieldsarecustomfieldscreatedbytheenduser.Yourorganizationmaychoosetoadd

custommetadatafields,basedonyourindividualneeds.Besidesbeingapowerfulorganizationaltool,metadatacanhelpboostyoursearchenginerankings.Whensearchenginescatalogwebsites,theyextractcertainmetadatafieldsfrompagesanduseitasabasisforsearchresults.Themoredescriptiveyouare,the

greaterchancethereisthatyourpagewillbereturnedhigheronsearchengineresults.

Toaddmetadatatoapage:

1. Opentheintro/examplepageandclicktheEdittab.2. ClickontheMetadatapane.3. TypeExamplePageintotheTitlefield.4. TypeThisisasummaryoftheexamplepageintotheSummaryfield.5. TypeIntro,Example,PageintotheKeywordsfield.6. TypeIntroUserintotheAuthorfield.

7. Whenfinished,clickSubmittoupdatethemetadataonthispage.

Initscurrentstate,themetadataisonlyinformational.Inlaterguides,wewillshowyouhowtousethismetadatathroughoutyoursiteandalsohowtohavesomeofthisdataplacedinthe<head>ofyourpublishedpagesforsearchengineoptimization.

Page 14: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 14

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

L.CreateanAssetFactory

AnAssetFactoryisawayofprovidingaquickandeasywaytocreateaspecifictypeofassetorspeciallyconfiguredpage‐forinstance,anewfileuploadorapressrelease.

Tocreateanewassetfactory:

1. Opentheintro/examplepageandclicktheCopytab.2. TypepageintotheSystemNamefield.3. Clicktheparentfolderbrowsericon,selectintro/_internal/assetfactories,andclickConfirm.4. Whenfinished,clickSubmittocopythepage.5. ClickAdministrationonthemenubar6. ClickAssetFactoriesintheleftsidemenu.7. ClickNewAssetFactory.

8. FortheAssetFactoryType,selectPageandclickSubmit.9. FortheName,typePage.10. ClickthecontainerbrowseiconforParentsContainer,selectintroandclickConfirm.11. ClicktheassetbrowseiconforBaseAsset,selectintro/_internal/assetfactories/page,andclick

Confirm.12. ClickthefolderbrowseiconforPlacementFolder,selectintro,andclickConfirm.13. Selectallgroupsandclickthegreenarrowbuttontogiveaccessofthisassetfactorytoallgroups.

Page 15: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 15

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

14. Whenfinished,clickSubmittocreatetheassetfactory.

Withtheassetfactorycreated,youwillnowseeitappearintheNewmenuonthetopmenubar.Next,wewillusethisassetfactorytoquicklycreatenewpages.

M.UseNewAssetFactorytoCreatePage

Sincewehaveanexistingpagethatwe'veturnedintoanassetfactory,wecanquicklycreatenewpagesbasedonthestructureoftheexistingpage.

Tocreateapageusingnewassetfactory:

1. SelectNew‐>intro‐>Pagefromthemenubar.

Page 16: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 16

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

2. Thecontentfromtheoriginalpageisalreadythere,whichwecanaddtoorcompletelychange.IntheWYSIWYGeditor,typeinHello,world!Thisismysecondpage!

3. ClickontheSystempaneandtypepage2intheSystemNamefield.4. Allsettingsarethesameasthebaseasset,sowecannowjustclickSubmittocreateournewpage.

N.CreateaDataDefinition

DatadefinitionsareusedbyCascadeServertogeneratepageswhosecontentcomesviaforms‐basedinputfields.AseriesofformsispresentedtotheauthorofapageandthecontententeredisthenstoredaspureXMLuponsubmission.AdministratorscantransformtheXMLdatausinganXSLTstylesheetforthepurposeofpresentationormulti‐purposing.Here,wewillcreateasimpledatadefinitionthatwillbeusedtoissuepressreleases.

Tocreateanewdatadefinition:

1. ClickAdministrationonthetopmenubar2. ClickDataDefinitionsintheleftsidemenu.3. ClickNewDataDefinition.

4. FortheNamefield,typePressRelease.5. ClickthecontainerbrowseiconforParentContainerandselectintro.6. IntheXMLbox,typethefollowing:

Page 17: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 17

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

<system‐data‐structure><textidentifier="title"label="Title"/><textidentifier="content"label="PressRelease"multi‐line="true"/><textidentifier="about"label="AbouttheCompany"multi‐line="true"/><groupidentifier="contact"label="PRContact"><textidentifier="person"label="Name"/><textidentifier="phone"label="Phone"/><textidentifier="email"label="Email"/></group></system‐data‐structure>

7. Whenfinished,clickSubmittocreatethedatadefinition.

Oncecreated,theformfieldsinthedatadefinitionwillbedisplayed.Wecannowattachthisdatadefinitiontoanewpagetoissueanewpressrelease.

O.AttachDataDefinitiontoNewPage

Nowwe'llcreateanewpageusingourassetfactoryandusethedatadefinitiontoissueanewcompanypressrelease

Tocreateanewpressrelease:

1. SelectNew‐>intro‐>pagefromthemenubar.2. Insteadofaddingcontent,switchovertotheSystempane.3. Typepressrelease1intotheSystemNamefield.4. ClicktheassetbrowsernextforDataDefinition,selectintro/PressRelease,andclickConfirm.5. ChecktheboxnexttoUseDataDefinition.

6. Whenfinished,clickSubmit.7. Toentercontent,wemustnowre‐editthispagewiththedatadefinitionattached.ClickontheEdit

tabforthepressrelease1page.8. InsteadoftheWYSIWYGeditor,younowseethefieldsdefinedinthedatadefinition.Fillinall6fields.

Page 18: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 18

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

9. Whenfinished,clickSubmittoupdatepage.

Afteryousubmitthepressreleasedataviathedatadefinitionfields,you'llnoticethattheresultingcontenthasnoformatting.ThisisbecausethedataisstoredaspureXML.Next,we'llcreateanXSLTstylesheettoprovidenicerpresentation.

P.CreateXSLTStylesheetforXMLFormatting

OurnextstepistocreateanXSLTstylesheettoapplytoourdatadefinitionpage.

TocreateanXSLTstylesheet:

1. SelectNew‐>Default‐>Stylesheetfromthemenubar.2. IntheXMLbox,typethefollowing:

<?xmlversion="1.0"encoding="UTF‐8"?><xsl:stylesheetversion="1.0"xmlns:xsl="http://www.w3.org/1999/XSL/Transform"><xsl:templatematch="system‐data‐structure"><h2><xsl:value‐ofselect="title"/></h2><p><xsl:value‐ofselect="content"/></p><h4>Aboutthecompany:</h4><p><xsl:value‐ofselect="about"/></p><xsl:apply‐templatesselect="contact"/></xsl:template><xsl:templatematch="contact"><fieldset><legend><b>ContactInformation</b></legend><b>Contact:</b><xsl:value‐ofselect="person"/><br/><b>Phone:</b><xsl:value‐ofselect="phone"/><br/><b>Email:</b><xsl:value‐ofselect="email"/></fieldset></xsl:template></xsl:stylesheet>

Page 19: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 19

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

3. ClickontheSystempane.4. FortheSystemNamefield,typepress‐release.5. Whenfinished,clickSubmit.

Ifyoureturntotheintro/pressrelease1page,you'llnoticethepagedataisstillnotformatted.Thisisbecausewehaven'tattachedthestylesheettoanything.WecouldattachthestylesheettotheDEFAULTregioninthetemplate,butthestylesheetwouldthenbeappliedtoeverypageusingthattemplate.Sincethat'snotwhatwe'regoingforinthiscase,we'llattachthestylesheettothepageitself.

Q.AttachStylesheettoPressReleasePage

Toattachthestylesheetatthepagelevel:

1. Opentheintro/pressrelease1page.2. ClicktheEdittab.3. ClicktheConfigurationspane.4. ClickthestylesheetbrowseiconfortheDEFAULTregion,selecttheintro/_internal/stylesheets/press‐

releasestylesheetandclickConfirm.

5. Whenfinished,clickSubmit.

Page 20: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 20

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

Thestylesheetisnowattachedtotheintro/pressrelease1page.Ifyouviewthispage,theformattingshouldnowmatchwhatislaidoutinthestylesheet.Nextwe'llcreateacopyofthispagetoactasabaseassetforanewpressreleaseassetfactory.Oncecreated,userscaneasilycreatepre‐styledpressreleaseswithnorequiredknowledgeorXMLformatting.Furthermore,whensitedesignersdecidetochangetheformattinginthestylesheet,thechangeswillapplytoallsubscribedpagesretroactively!

R.CreateAssetFactoryfromPressReleasePage

NowthatwehaveapressreleasepagewithanattacheddatadefinitionandXSLTstylesheet,wecancreateanassetfactoryofthispagetoeasilycreatefuturepressreleases.

Tocreateanassetfactoryofthispage:

1. Opentheintro/pressrelease1page.2. ClicktheCopytab.3. TypePressReleaseintotheSystemNamefield.4. ClickthefolderbrowseiconforParentFolder,selectintro/_internal/assetfactories,andclick

Confirm.5. Whenfinished,clickSubmittocopythepage.6. ClickontheEdittabofthecopiedpage.7. Topreventthecontentoftheoriginalpagefromappearingeverytimeweusethisassetfactory,go

aheadandremovethecontentfromall6fields.8. Whenfinished,clickSubmittoupdatethepage.9. ClickAdministrationonthemenubar.10. SelectAssetFactoriesfromtheleftsidemenu.11. ClickNewAssetFactory.12. SelectPagefortheAssetFactoryTypeandclickSubmit.13. TypePressReleaseintheNamefield.14. ClickthefolderbrowseiconforParentFolder,selectintro,andclickConfirm.15. ClickthepagebrowseiconforBaseAsset,selectintro/_internal/assetfactories/PressRelease,and

clickConfirm.16. ClickthefolderbrowseiconforPlacementFolder,selectintro,andclickConfirm.

Page 21: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 21

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

17. Selectallgroupsandclickthegreenarrowbuttontogiveaccessofthisassetfactorytoallgroups.

18. Whenfinished,clickSubmittocreatethenewassetfactory.

ThisassetfactoryshouldnowappearinNew‐>introonthetopnavigationbar.Youcannowusethisassetfactorytoquicklycreatenewpressreleasesthatarestructuredandpresentedinthesamewayastheoriginal.Ifadministratorseverwanttochangetheformatting,theywouldonlyhavetomodifythestylesheetandchangeswouldautomaticallypropagatetoallsubscribingpages.Nextwewillpublishoutourentiresite.

S.CreateaTransportforPublishing

TransportsarethemechanismsthatmovecontentfromCascadeServertothefinalwebserver.TransportscanpushcontentoutviaFTP/SFTPorthroughatypeoffilesystemlikeaVPN,mappednetworkdrive,shareddrive,ormounteddrive.TransportscanevenpublishcontentouttoaMySQLdatabaseforusebyseparateapplications.

Tocreateanewtransport:

1. ClickAdministrationonthemenubar.2. SelectTransportsintheleftsidemenu.3. ClickNewTransport.

4. SelectFilesystemfortheTransportTypeandclickSubmit.5. TypeServerOutputintotheNamefield.6. FortheServerDirectoryfield,typeinapathtoalocaldirectorythatyouhaveaccessto.7. Whenfinished,clickSubmit.

Page 22: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 22

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

T.CreateaDestinationforPublishing

Destinationsareverysimilartotransports,buttheyaresetforspecificsites.Thisallowsforthereuseoftransportsacrossmultiplesites.Iftransportsweresetatthesitelevel,thenachangetothewebserver(say,achangetocredentials)wouldrequireupdatingeverytransportthatpublishedtothatserver.Byusingdestinationsasanintermediarythatsimplypointasitetoaspecifictransport,thenachangetothewebserverwouldonlyrequireonechangetothetransport.

Tocreateanewdestination:

1. ClickTargets&Destinationsintheleftsidemenu.2. SelecttheintrotargetandclickNewDestination.Again,atargetisasitedefinitionfilethatwillbe

explainedindetaillateron.3. TypeLocalServerintotheNamefield.4. ClickthetransportbrowseiconnexttoTransport,selectFileSystem/ServerOutput,andclick

Confirm.5. VerifythattheEnabledestinationcheckboxischecked.6. Selectallgroupsandclickthegreenarrowbuttontogiveaccessofthisdestinationtoallgroups.

7. Whenfinished,clickSubmit.

Youcannowusethistransport/destinationcombinationtopublishoutpagesfromtheintrosite.

Page 23: Cascade Server Technical Guide Primer · 2018. 3. 8. · Hello, world! This is my first page!. 5. Click the System pane and type example in the System Name field. 6. Verify that the

CascadeServerTechnicalGuidePrimer 23

©2008HannonHillCorporation,allrightsreserved.

950EastPacesFerryRoad∙Suite2440∙Atlanta,GA30326o:678.904.6900f:678.904.6901w:http://www.hannonhill.com

U.PublishOuttheIntroSite

Wewillnowpublishouttheintrositetothefilesystem

Topublishoutthesite:

1. ClickHomeinthemenubar.2. Clickonthebasefolderfortheintrosite.3. ClickonthePublishtabfortheintrofolder.4. Youshouldseetheintro/LocalServerdestinationasavailableforpublishingto.Makesurethat'sthe

onlydestinationcheckedandclickSubmit.

Thesiteshouldhavepublishedout(Giveitaminuteorsotocomplete).Checkthedirectorythatyousetupinthetransportandverifythatallthepageswecreatedpublishedoutcorrectly.You'llnoticethatnoneoftheassetsintheintro/_internalfolderpublishedout.ThatisbecausethoseassetsareonlyusedbyCascadeServerandwillneverbeneededbythefinalwebserver.