Home

Ektron CMS400.NET Developer Reference Manual

Contents

1. Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 115 Ektron CMS400 NET Server Controls Property Value Data Type DynamicParameter Gets or sets the QuerySiring parameter to read a String content ID dynamically Hide Used to hide a Metadata Server Control in design time boolean and run time True Hide Metadata Server Control False Show Metadata Server Control Using the MetaData Server Control These steps show how to use the MetaData Server Control 1 Drag a MetaData Server Control into a template 2 Set the properties of the Metadata Server Control This will create the following HTML in the HTML body lt coms MetaData id MetaDatal runat server DefaultContentID 12 gt lt cms MetaData gt Or if you are using multiple content block IDs In the DefaultltemList the following HTML will be created lt cms metadata id MetaDatal runat server DefaultItemList 12 7 4 gt lt cms metadata gt 3 Click on the HTML tab and copy that line from the lt body gt tag into the lt head gt tag lt HEAD gt lt title gt WebForm5 lt title gt lt cms MetaData id Metadata2 runat server DefaultContentID 12 gt lt cms MetaData lt meta name GENERATOR content Microsoft Visual Studio NET 7 1 gt lt meta name CODE LANGUAGE content Visual Basic NET 7 1 gt lt meta name vs_ defaultClientScript content JavaScript gt lt meta name vs_targetS
2. Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 94 Ektron CMS400 NET Server Controls Property Value Data Type DisplayType Specify the Calendar view type The default is Month String e Month A 30 day calendar month view ee ed J s 7 tockey perme u o out neceey deena testets yore thet w co n n D n e Day Single day view ssi a4 e Event Display events for the current day Friday April 01 2005 Sunday May 01 2005 4 1 2005 April Fools Day World Wide Start 3 00 PM End 4 00 PM e Inline Display events that occur from the start date of the calendar through the end date Sanday May 01 2905 Saturday July 20 2008 SSIs sams vah asetas Mereana Hga Ama surtou cecscere e MonthUpWithEvent Displays a month calendar events appear to the right of the calendar when you click on a day Sher Way aS den 51512005 Sun Mon Tue Wed Thu fri sat Hockey game z Location VWA KSEAEALIO TILS 3 n 12 13 1 End 10 30PM 1s 16 17 18 9 20 21 z2 z3 24 2s 26 27 28 TEJE Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 95 Ektron CMS400 NET Server Controls Property Value Data Type DynamicParameter To make this calendar dynamic select calendar_id String When you do this server control uses the calendar passed as a URL parameter
3. Value Description Web Page View DateModified Displays the date the content was last modified RC Sportster The RC Sportster is design nid level RC racer currently on the market nferdoce 8 27 2002 2 44 44 PM growing atoms aY host the 3rd annual RC conference in Atle DateCreated Displays the date when the content waa rat greeted i level RC racer currently on the mark LastEditorFname Displays the first name of the user who last edited the content block nid level RC racer currenth vere John X growimeeonga in the R host the 3rd annual RC cc Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 85 Ektron CMS400 NET Server Controls Value Description Web Page View LastEditorLnames Displays the last name of the user who last edited the Cl KU Sportster ine KL gt p content block d mid level RC racer currentl to host the 3rd annual RC ct Collection Server Control The Collection Server Control is used to display a list of content block links that were created as a collection in the Ektron CMS400 NET Workarea The control is highly customizable allowing you to define the display of the collection on a Web page When added to a template and visited collections can look like this The following illustration shows three collections on the same page of asample site You can modify the display by editing its properties Human Resources Forms While you were out
4. Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list Integer Random Set to True if you want to randomly display one collection item The item changes each time a user views the page Boolean Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 88 Ektron CMS400 NET Server Controls Property Description Data Type WrapTag Allows a developer to specify a server control s String tag The default is Span Span The lt span gt tag is used to designate an inline portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag Example of ecmNavigation Display The following is an example of a collection being used as a navigation menu Products RC Sportster RC Cheetah RC Lilly RC Redstar Example of ecmTeaser Display The following is an example of a collection using the ecmTeaser display style Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 89 Ektron CMS400 NET Server Controls Home Products Support LatestNews Careers Search Calendar Employment Opportunities Plastic Molder 123 RC International is looking f
5. Employee Forms Absence Request Form Direct Deposit Form Manager Forms Personnel Action Form This subsection contains the following topics e Collection Server Control Properties on page 87 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 86 Ektron CMS400 NET Server Controls e Example of ecmNavigation Display on page 89 e Example of ecmTeaser Display on page 89 e Using the Collection Server Control Programmatically Example on page 90 Collection Server Control Properties NOTE The Collection Server Control properties are described in this table The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Description Data Type Authenticated Indicates if you are logged in to the CMS Explorer and can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 String ContentParameter Checks the QueryString for this value and replaces the collection with a content block when specified Leave blank to always display the Collection or List Summary String DefaultCollectionID The ID of a collection that appears where you inserted this server control if no other collection is identified or is not
6. J Private Sub Page Load ByVal sender As System Object ByVal e Dim MyColl As New Collection MyColl DefaultCollectionID 1 MyColl Random True MyColl des End Sub e DefaultCollectionID End Class Dispose Public Property DefaultCollectionID As Integer eS DynamicParameter eS Enabled eS EnableviewState iis eS Error Fill FindControl eS Font ES ForeColor The intellisense box displays all properties that can be applied For a description of Ektron s standard server control properties see List of Server Controls on page 32 To learn about native VS NET properties see its documentation The property s tooltip text indicates its type In the above example you can see that the DefaultCollectionID s type is integer For more information about accessing Ektron CMS400 NET object properties see Customizing the Server Control in the Code Behind on page 28 Mutual Server Control Properties in Code Behind There are several read only properties that can be called in the code behind and used by every server control The list below explains these properties NOTE The properties do not display values within Visual Studio NET during design time Instead they only display values at run time which are dependent on the user s login status Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 17 Ektron CMS400 NET Server Controls Property Value
7. Add Content Example The following is an example of the add content method hard coded in a template lt tr gt lt td gt lt AddContent admin admin Content Title Comment This is the lt b gt body lt b gt of the content This is the lt i gt summary lt i gt for the content 1 31 06 14 2004 11 55 AM lt metadata gt lt meta id 3 gt ContentTitle lt meta gt lt metadata gt Ww 4 gt lt td gt lt tr gt The previous example has the following properties e The user admin is used for authentication e The title of the new content block is Content Title Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 137 Standard ASP NET Methods e The comment for the content is Comment e The body of the content is This is the body of the content e The summary of the content block is This is the summary for the content e The language ID 1033 or English e The new content block is added to content folder ID 31 e The start date is set at June 14 2004 at 11 55 AM e No end date is specified e The metadata Content title is set for the metadata definition ID 3 When this method is executed the content is added to Ektron CMS400 NET Displayed here is the record of the content in the workarea Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 138 Standard ASP NET Methods Teer io R aCA D Content a
8. Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 164 Syndicating Web Content as RSS Syndicating via NET Architecture of RSS Syndication aspx pages You can use an aspx page as a URL to dynamically create and return RSS documents To display an RSS feed on a Web site the site administrator identifies the URL of the aspx page The aggregator determines how to use the document s elements such as lt title gt lt description gt and lt link gt to display the syndicated content Three sample aspx templates news aspx hr aspx and products aspx are installed by default to 1ocainost cMS400Example folder They use the WebService ContentWS class to retrieve the collection or list summary data Then they create CollectionToRSS20 or ListSummaryToRSS20 These classes fill the RSS 2 0 data classes and serialize them to an XML document which can be returned as an HTTP response Since these pages are part of the CMS400 NET sample you should modify them or create your own aspx pages for your Web site Place your custom pages in the yourwebsite webServices folder so that the web config file is within the path Retrieving a Collection or List Summary as an RSS Feed The left frame of the corporate aspx page is hardcoded to retrieve the News Collection The right frame retrieves a ListSummary Creating Your Own aspx Collection Page To create your own collection page copy the collection object to an RSS 2 0
9. Adding a Login function via an ASP NET method lt i gt lt td gt lt AppUI ecmLogin gt lt td gt lt tr gt Best Practice Ektron recommends using CMS400 NET server controls when available over Ektron standard ASP NET methods The methods are being replaced by the server controls Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 131 Standard ASP NET Methods You can still use the standard ASP NET methods in Ektron CMS400 NET Referencing Methods in Visual Basic Before you can use methods with Visual Basic you must add a reference to them from Visual Basic Follow these steps to do so Open Visual Basic Choose or add a project In Solution Explorer right click References and choose Add Reference Solution Explorer CM5400Sample 2 Be pat Solution CM5400Sample 1 project A CMs400Sample Ektron 0 Ektron 9 Ektrontomsrconcrors 4 Inthe Add Reference dialog box click Browse Go tO tnetpub wwwroot CMS400Example Bin To load the standard methods click ext ron cms UI CommonUI dll To load the XML Indexing methods click Extron cms Common dll 7 Click Open then OK Adding a New Web Form To add a new Web form follow these steps 1 Open your project in Visual Studio NET 2 Right click the project 3 Click Add gt Add Web Form Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 132 Standard
10. Metadata Displays the metadata in the source MetaData Server Control of the Web page displaying the on page 114 content Menu Customizes the DHTML menus DhtmIMenu Server Control feature on page 106 Search Inserts a text box with a search Search Server Control on button in the template When the page 51 user completes the search screen it looks through XHTML content on the Web site ShowSiteLanguage Lets a site visitor select a language LanguageSelect Server in which to view site Control on page 35 Add Content The add content method lets you programmatically add a new content block to Ektron CMS400 NET without logging in This method can be used for several applications such as e A Web form allowing you to collect data from users about the content block e A loop function that moves information from a database to an Ektron CMS400 NET database Here is the format for the add content method Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 135 Standard ASP NET Methods lt AddContent UserName Password Domain content_title content_comment ContentHtml SummaryHTML Metalnfo ContentLanguage FolderlID GoLive EndDate ErrString gt The table below lists attributes of the add content block method Attribute Description Type UserName The user to be authenticated for permissions for As String eligibility to add a c
11. Property Description Data Type Values Authenticated Indicates if you are logged in to the CMS Explorer and can use it to browse to the folder needed for the FolderPath property See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 String ContentParameter Checks the QueryString for this value and replaces the collection with a content block when specified Leave blank to always display the Collection or List Summary String Direction How to order the hyperlinks on the list The sort field is determined by the OrderKey property either ascending or descending ascending they are arranged A B C or 1 2 3 descending they are arranged Z Y X or 3 2 1 If sorting by date descending puts the most recent first DisplayXslt Determines how the information on the page is displayed String None databind only ecmNavigation lists the title of every content block in the folder See Also Example of ecmNavigation Display on page 89 ecmTeaser lists the title of every content block in the folder plus the content summary See Also Example of ecmTeaser Display on page 89 Path to Custom Xslt Enter the path to an Xslt that determines the display of the page Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 82 Ektron CMS400 NET Server Controls Property Description Data Type Values F
12. s0 Human Resources Content Title Content Title An Marketing Content ID 31 7 Products Status Approved Published s Support Last User To Edit admin SE Syndication Last Edit Date 14 Jun 2004 22 54 00 PM Start Date 14 Jun 2004 11 55 00 AM End Date None Specified Date Created 14 Jun 2004 22 49 00 PM Approvals None Specified XML Configuration None Specified HTML Content Assumed inherited Path History Comment Comment Metadata itle ContentTitle Keywords Summary his is the summary for the content Content his is the body of the content Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 139 Web Services Introduction to Web Services Web Services WS are reusable software components that can be consumed by variety of clients independent of operating system programming language or Web server using standard Internet technologies Because Web Services allow heterogeneous systems to communicate with each other in a standard way they have received quick acceptance for data interchange over the Web It s easy for anyone to integrate your WS into their application The client application can be a Web application a Windows application a Java application a Visual Studio net application or a host of others it does not matter as long as it supports Web Services A Web Service consists of one or more methods that expose functionality In this sense a Web Se
13. Ektron ___Redefining Web Content Management Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 Ektron Inc 5 Northern Blvd Suite 6 Amherst NH 03031 Tel 1 603 594 0249 Fax 1 603 594 0258 Email sales ektron com http Awww ektron com Copyright 2005 Ektron Inc All rights reserved EKTRON is a registered trademark of Ektron Inc Version 4 8 Revision 1 April 8 2005 For updated versions of this manual please visit http www ektron com cms400 web cms aspx id 1701 documentation EKTRON INC SOFTWARE LICENSE AGREEMENT READ THIS BEFORE LOADING SOFTWARE YOUR RIGHT TO USE THE PRODUCT DELIVERED IS SUBJECT TO THE TERMS AND CONDITIONS SET OUT IN THIS LICENSE AGREEMENT USING THIS PRODUCT SIGNIFIES YOUR AGREEMENT TO THESE TERMS IF YOU DO NOT AGREE TO THIS SOFTWARE LICENSE AGREEMENT DO NOT DOWNLOAD CUSTOMER should carefully read the following terms and conditions before using the software program s contained herein the Software Downloading and or using the Software or copying the Software onto CUSTOMER S computer hard drive indicates CUSTOMER S acceptance of these terms and conditions If CUSTOMER does not agree with the terms of this agreement CUSTOMER should not download Ektron Inc Ektron grants and the CUSTOMER accepts a nontransferable and nonexclusive License to use the Software on the following terms and conditions 1 Right to use The Software is
14. Ektron CMS400 NET Server Controls Login Calendar display Status Logged Out vember December 2004 Januz Mon l mue i wea fO mhu o ri Sat 1 2 3 4 6 7 8 9 10 11 13 14 15 16 17 19 20 21 22 23 24 25 27 28 29 30 34 Menu Server Control The Menu Server Control calls a menu to be displayed on a page Using the Menu Server Control you can manipulate a menu by using the DisplayXslt property Below is a menu display with the SampleMenu Xslt e Products o RC Cars a RC Cheetah a RC Sportster o RC Planes a RC Lilly a RC Redstar o Products Page o Visit Ektron com Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 99 Ektron CMS400 NET Server Controls Before you can use the Menu Server Control you must create a menu in the Ektron CMS400 NET work area To learn about creating menus see Working with Menus in the Ektron CMS400 NET User Manual This subsection contains the following topics e Menu Server Control vs DhtmiMenu Server Control on page 100 e Menu Server Control Properties on page 101 e Using DisplayXslt Samples on page 102 Menu Server Control vs DhtmiMenu Server Control The Menu Server Control calls a menu to be displayed on a page You can manipulate the menu by using the DisplayXslt property With the DhtmIMenu Server Control you display a dynamic menu with drop down boxes and submenus You manipulate DhtmlMenus with a style sheet DhtmlMenus
15. e MenuExample o CMS Developer o Book a ASP NET Unleashed a Programming C NET a VB NET How to AA Addor Edit a Edit Menu submenu o News a All Stars Customer Web Design Firms Enhanced Workflow Visual Rapid CMS Integration Ektron Partners and Customers Add or Edit submenu TreeMenu The TreeMenu DisplayXslt lets you display an Ektron CMS400 NET menu as a Clickable folder list You can expand and collapse the menu by clicking on the folder icons See below for an example amp MenuExample CMS Developer Book News All Stars Customer Web Design Firms Enhanced Workflow Visual id CMS Integration Ektron Partners and Customers When you are logged in to your Ektron CMS400 NET site two menu items are added to each section of the menu Add and Edit Menu Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 104 Ektron CMS400 NET Server Controls The user can use these to add a new menu item or edit an existing menu item See example below For Information on a adding a menu Item see Ektron CMS400 NET Users Manual gt Working with Menus gt Managing Menus gt Adding a New Content Block to a Menu via Navigation Link on a Web Page For Information on a editing a menu see Ektron CMS400 NET Users Manual gt Working with Menus gt Managing Menus gt Editing a Menu via Navigation Link on a Web Page MenuExample CMS Developer
16. gcbCms400ContentXml Item Xs1t2 Case 3 strTmp gcbCms400ContentXml Item Xs1t3 Case 4 strTmp gcbCms400ContentXml Item Xs1t4 Case 5 strTmp gcbCms400ContentXml Item Xs1t5 End Select If Len strTmp 0 Then strTmp None Used HTML Content assumed This code uses the gcbcms400Contentxm1 Web Service to get the content title gcbcms400ContentXml Item ContentTitl The code also uses the gcbCms3400ContentXml Web Service to retrieve any XSLTs assigned to the content If no XSLTs are Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 159 Web Services assigned as is the case with this sample page the message None Used HTML Content assumed appears This code results in the following section of the page Latest News Content Block Information from GetContentBlock Web Service Content Block Title RC International Announces the RC Cheetah Xslt Used for Rendering None Used HTML COntent assumed Next the page uses the GetContentBlock method to display the content block in raw HTML or XML format Here is the code that displays that section of the page StrHTML strHTML amp lt tr gt lt td gt lt b gt Raw HTML or XML from GetContentBlock Web Service lt b gt lt td gt lt tr gt strHTML strHTML amp lt tr gt lt td gt amp nbsp lt td gt lt tr gt strHTML strHTML amp lt tr gt lt td gt amp strRawHtml amp lt td gt lt tr gt strHTML
17. 8 MyContentBlock Fill Literall Text MyContentBlock EkItem Html To display a content block with the content block title do the following Before adding these lines of code you need to drag and drop a two literal boxes on your Web form Dim MyContentBlock As New ContentBlock MyContentBlock DefaultContentID 8 MyContentBlock Fill Literall Text MyContentBlock EkItem Title Literal2 Text MyContentBlock EkItem Html Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 47 Ektron CMS400 NET Server Controls FormBlock Server Control The FormBlock Server Control displays a content block associated with a form IMPORTANT If you create a template for an existing form content block you must manually change its quicklink to point to the new template This change does not occur automatically This procedure is described in the Ektron CMS400 NET Administrator manual Managing Library Assets gt Updating Default Template for Multiple Quicklinks When added to a template and visited the form content block might look like this You can change the display to suit your needs by modifying its properties Absence Request Form Name E mail Address Position Department Select Department Reason For Floating Holiday Absence Vacation Sick Leave C FMLA other hemi mm ddiyyyy to mmiddfy yyy Total Days Absent With Pay Without Pay
18. Close Login Logout Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 10 Ektron CMS400 NET Server Controls Enter your Ektron CMS400 NET username and password When you do the CMS Explorer window appears providing a visual way to browse your Ektron CMS400 NET Web site Ektron CMS Explorer 8 Folders Corporate H Human_Resources Marketing MISIT News Sales E Users Select Cancel Navigate through the folders select an object then click the Select button The selected object is pasted to the server control property Language Folder Selection NOTE Although you see the object in the selected language in Visual Studio NET the language is not stored For example if you select a German content block whose ID 2 Ektron CMS400 NET only stores content block ID 2 When a visitor to your site browses to that page the content block does not appear in the selected language Instead it is determined by a cookie or the user s language selection Build the Project After you open the solution file in Visual Studio NET and add the required files build the project This may take a while the first time you do so After the project is built a browser opens and it is displayed as a Web page You can also view a Web page while working on it by right clicking on the Web form and clicking View in Browser Inserting Server Controls Programmatically Besides using the drag and dro
19. Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 91 Ektron CMS400 NET Server Controls Address http localhost cms400example randomcontent Go Links CMS300 Samples Menu Welcome to RC International Hello There A Gail Elliott gelliott test com Sales 603 555 1113 Responsible for the Northeast region CT Maine Mass NH NY VT Calendar Server Control The Calendar Server Control displays a calendar that was created in the Workarea By using the Calendar Server Control s properties you can select multiple views of the calendar to display See Also DisplayType on page 95 You can adjust a calendar s look and feel by using a style sheet See Also Calendar Style Sheet on page 97 The Calendar Server Control can output the raw XML data of the calendar You can use this XML data to create a completely customized calendar Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 92 Ektron CMS400 NET Server Controls When added to a template and visited the Month view calendar display looks like this November December 2004 January 5 g 7 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 A calendar can be static or dynamic e A static calendar is selected in the server control properties e Adynamic calendar is passed to the page by a URL parameter This subsection contains the
20. Recursive Search Defines whether search is recursive 1 recursive search 0 non recursive search Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 150 Web Services Parameter Where How Implemented by CMS Defined in Application API xxx Starting Folder Search Describes path to folder in which search begins Here are some examples e root content folder e Products RC Cars begins search in the RC Cars folder Allow Fragments n a Selected by user on page that performs search Search amp All the words Any of the words Exact Phrase O Match Partial Words Options 0 false do not allow fragments 1 true allow fragments If fragments are allowed and the user enters AT as the search string the search returns topics with these words pat ate hatter If fragments are not allowed and the user enters AT as the search string the search only returns topics with the word at Note This parameter is handled automatically by CMS when displayed on Web page For Web Services this needs to be defined Max Number Search Specify the maximum number of topics to display Display when a search is performed For example 0 unlimited 1 one result 7 seven results Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 151 Web Services Parameter Where How Implemented by CMS Defi
21. Search All the words C Any of the words Exact Phrase Match Partial Words search jpg EN All the words C Any of the words Exact Phrase I Match Partial Words http www ektron com images search jpg ETEN All the words C Any of the words Exact Phrase I Match Partial Words Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 58 Ektron CMS400 NET Server Controls Search Button Text Examples Value Web Page View Click Me to Search Click Me to Search All the words C Any of the words Exact Phrase I Match Partial Words Click Me to Search Exact Phrase I Match Partial Words Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 59 Ektron CMS400 NET Server Controls Display Examples Value Web Page View Vertical Search All the words Any of the words Exact Phrase I Match Partial Words Horizontal Search all the words Any of the words Exact Phrase Match Partial Words ShowDate Examples Value Web Page View False Search Results RC Sportster RC Redstar RC Lilly RC Cheetah Products Page RC International Ships RC Sportster RC International Hosts RC Conference RC International Announces the RC Cheetah Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 60 Ektron CMS400 NET S
22. a menu When you are logged in to your Ektron CMS400 NET site two menu items are added to each menu Add and Edit Menu The user can use these to add a new menu item or edit an existing menu item See example below For Information on a adding a menu Item see Ektron CMS400 NET Users Manual gt Working with Menus gt Managing Menus gt Adding a New Content Block to a Menu via Navigation Link on a Web Page For Information on a editing a menu see Ektron CMS400 NET Users Manual gt Working with Menus gt Managing Menus gt Editing a Menu via Navigation Link on a Web Page CMS Developer Book gt ad venerHowto E E Ly Edit menu Ia Add or Edit CY EditMenu whole menu Add or Edit submenu This subsection contains the following topics e Menu Server Control vs DhtmiMenu Server Control on page 108 e DhtmlMenu Server Control Properties on page 108 e Code Behind Only Properties on page 112 e Using a Style Sheet on page 113 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 107 Ektron CMS400 NET Server Controls Menu Server Control vs DhtmiMenu Server Control See Menu Server Control vs DntmlMenu Server Control on page 100 Dhtm IMenu Server Control Properties The DhtmlMenu Server Control properties are described in this table NOTE The following table only lists Ektron specific properties It does not describ
23. page Note If you set DefaultResultDisplay to True the ShowDate and DisplayXslt properties will not work This is because the server control is using a default display Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 53 Ektron CMS400 NET Server Controls Property Description Data Type For more information see EmptyResultMsg The return message displayed if the search returns no hits The default is Search returned zero results String FolderPath The folder at which the search begins The starting folder need not be the root folder The Recursive property determines if the search examines this folder s subfolders String Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 Hide Used to hide Search Server Control in design time and runtime True Hide control False Show control Boolean Language Design time only View content blocks collections etc in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list Integer MaxCharacters The maximum number of characters the input text box accepts when doing a search Integer MaxResults The Maximum number of content blocks returned O unlim
24. 163 What Is RSS Syndication siccccscccncccnsncsessincnscncnatncccrerezecccreacare 163 The RSS Specifica Nuusnan aaa 163 RSS Syndication in Ektron CMS400 NET sssssssensssensssnssnnnns 164 SYNGICATING via INET wvesiscccanesscecscscscanesesanenssenesssencsunescscatecanne 165 Architecture of RSS Syndication ccceeeessseeeeeeeseeeeeeeeeees 165 ASPX PaO Sonini a mecaanm atacaonmaneain 165 Creating Your Own aspx Collection Page sssccsseeee 165 EKO OaE O 166 EXGIM DIG cns 166 Creating Your Own aspx List Summary Pag sss000 166 EXGIM DIG eiiiissscssinnistseamnnnnrnneesenmerucesn wenn vues vennuruuuensumenuuevnamnarreevasemne 167 421 119 E E E E E TE 167 Learning About Visual Studio NET 008 168 Grid Layout vs Flow LayOut ecccssseeeeesesseeeeeseeeeeeeensnenees 168 Additional Information cccccseesseeeeeeeeseeeeeeeeeseeeeseeeeees 170 Supporting Documents s 2 0c 2 5 es sh cee eee 170 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 vi SUPP Oler eatin 170 Sale Sei 170 Ini rmatiO Mesurier 170 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 vii Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 viii About This Manual About This Manual To utilize the full potential of an Ektron CMS400 NET driven Web site learning and using the server controls supplied by Ektron is essential These serv
25. ASP NET Methods Solution Explorer CMS400Intranet le Rebuild Add New Item Add Existing Item Add Reference New Folder Add Web Reference Set as StartUp Project Add Web User Control Debug Add HTML Page Save CMS5400Intranet Add Web Service aste Add Component _ Remove Add Class Rename 4 Click Web Form 5 In the code behind add an imports zEktron cms UI CommonUI statement Requirements for Standard Methods Ektron CMS400 NET maintains and displays content through the use of Ektron ASPX methods and ASP NET assembly objects To use the methods include the following code in your template lt Page Language vb AutoEventWireup false gt lt Import Namespace Ektron Cms UI CommonUI gt lt Dim AppUI As New ApplicationAPI gt Each line is explained below Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 133 Standard ASP NET Methods Line Description lt Page Language vb AutoEventWireup false gt in the template A generic net line of code that should always be placed lt Import Namespace Ektron Cms UI CommonUI gt An import statement that calls the namespace Ektron CMS UI CommonuUI to display information from the net assembly file lt Dim AppUI As New ApplicationAPI gt Creates an instance of the ApplicationUI class that c
26. Book ASP NET Unleashed Programming C NET VB NET How to Add Add or Edit Edit Menu submenu News Add Add or Edit Edit Menu whole menu Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 105 Ektron CMS400 NET Server Controls NOTE When using the TreeMenu Server Control with Visual Studio and Windows 2003 the folder images do not display during design time They do however display correctly during run time E E CMS Developer E Book ASP NET Unleashed Pro ing C NET VB NET How to brew All Stars Customer Web Design Firms Enhanced Workflow TE Visual Rapid CMS Integration Ektron Partners and Customers Dhtm IMenu Server Control NOTE For optimal performance Ektron recommends using at minimum Internet Explorer 5 5 Netscape 6 0 or Mozilla Firefox 1 0 The DhtmlMenu Server Control lets you display a menu with drop down boxes and submenus This lets developers add a menu to a page without taking up a lot space You can modify the menu s style via a style sheet Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 106 Ektron CMS400 NET Server Controls Before using the DhtmlMenu Server Control you must add items to a menu in the Ektron CMS400 NET workarea To learn about creating menus see Working with Menus in the CMS400 NET User Manual The DhtmIMenu Server Control also lets developers add content to
27. CMS400 NET Developer Reference Manual Version 4 8 Revision 1 157 Web Services The result looks like this Latest News Content Block Information Return from the GetListSummary Web service call Content ID 11 Content Title RC International Announces the RC Cheetah Date Created 25 Apr 2002 04 43 42 PM Date Modified 27 Aug 2002 02 43 01 PM Modified By Application Administrator Content Teaser RC International a leading RC racing company has announced the availability of its new flagship product the RC Cheetah Content ID 10 Content Title RC International Hosts RC Conference Date Created 25 Apr 2002 04 42 55 PM Date Modified 27 Aug 2002 02 44 44 PM Modified By Application Administrator Content Teaser RC International the fastest growing company in the RC industry announces plans to host the 3rd annual RC conference in Atlanta Georgia Content ID 9 Content Title RC International Ships RC Sportster Date Created 25 Apr 2002 04 42 10 PM Date Modified 27 Aug 2002 02 46 12 PM The lower portion of the page also displays the content block in a ListSummary format as described in Getting Content Blocks on page 154 Latest News RC International Announces the RC Cheetah 8 27 2002 2 43 01 PM RC International a leading RC racing company has announced the availability of its new flagship product the RC Cheetah RC International Hosts RC Conference 8 27 2002 2 44 44 PM RC International the f
28. CMS400 NET Server Controls Data Binding with Server Controls With data binding you can bind Ektron server controls to a DataGrid Control DataList Control or Repeater Control This gives more flexibility when you use data from the Ektron server controls Some benefits of data binding are ease of data manipulation and the ability to format data Plastic Molder 123 13 RC International is looking for an experienced plastics molder trol J EET p de ternational is looked fo ig r Skilled servo c The following are data bindable Ektron Server Controls e Collection e Content Block e Form Block e List Summary e Search The following is an example of code behind that uses a DataGrid to display a Collection Dim myCol As New Ektron Cms Controls Collection myCol DefaultCollectionID 1 myCol Fill DataGridl DataSource myCol DataGrid1 DataBind NOTE When using drag and drop server controls for the Collection and DataGrid you need to call the DataBind method in the code behind An example line of code would be DataGridl DataBind This subsection contains the following topics Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 122 Ektron CMS400 NET Server Controls e Steps to Data Binding Using Drag and Drop Server Controls on page 123 e Customizing the DataGrid Table View on page 125 Steps to Data Binding Using Drag and Drop Server Controls The following example uses a Co
29. Comments a Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 48 Ektron CMS400 NET Server Controls This subsection contains the following topics e FormBlock Server Control Properties on page 49 e Automatic versus Manual Generation of Form Tags on page 50 FormBlock Server Control Properties The following table explains the properties of the FormBlock Server Control NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type AddValidation Set to True to add Validation to your main runat server Boolean form Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DefaultFormID The ID of a FormBlock that appears where you inserted Integer this server control if no other form block is identified If you don t know the ID number of the form block use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DynamicParameter To make this form block dynamic select id When you String do this server control uses the form block passed as a URL parameter FormName Set this
30. Data Type IsLoggedIn Tells if a user is logged in to Ektron CMS400 NET Boolean True User is logged in False User is not logged in LoggedInUserName Gets the Ektron CMS400 NET user name to display String LoggedInUserlD Gets the Ektron CMS400 NET ID of the user to Integer display These properties will allow you to personalize any page with your users names and IDs and show if they are logged in Here is an example of using these properties in code behind NOTE You must be logged in to Ektron CMS400 NET for this example to show your name and ID 1 Drag an Ektron CMS400 NET server control onto a Web form 2 Drag three Literals onto the Web form ContentBlock ID 0 f Literal Literall f Literal Literal2 f Literal Literal3 3 Open the code behind for the Web form 4 Add the following code to the Page_Load event Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 18 Ektron CMS400 NET Server Controls Literall Text ContentBlockl IsLoggedIn If ContentBlockl IsLoggedIn Then Literal2 Text ContentBlockl loggedInUserName amp is logged in Literal3 Text ContentBlockl loggedInUserID amp is the User ID End If Build and run the solution Browse to the login page and log in Browse to the new Web form you added ONO The login information is displayed F WebForm5 Microsoft Internet Ex File Edit View Favorites Tools t O O AAS Addres
31. Developer Reference Manual Version 4 8 Revision 1 117 Ektron CMS400 NET Server Controls Title Contact Ektron English U S Content Summary Metadata Schedule Comment Required fields 500 max Separator Character Contact Ektron 486 aracters left l Default Keywords 500 max Separator Character email support questions ektron contact The list can display the information as a list of hyperlinks You can choose based on properties you set if you would like to have a summary displayed You can also choose how to order the display For information on adding Metadata to a content block see the Users Manual gt Adding or Editing Metadata This subsection contains the following topics e MetaData Server Control vs MetaDataList Server Control on page 118 e MetaDataList Server Control Properties on page 118 MetaData Server Control vs MetaDataList Server Control With the MetaData Server Control you add metadata from content blocks to your Web page With the MetaDataList Server Control you create a list of content blocks to display on your site based on the Metadata in each content block For Information on the MetaData Server Control see MetaData Server Control on page 114 MetaDataList Server Control Properties The MetaDataList Server Control properties are described in this table Ektron CMS400 NET Developer Re
32. Driven Tutorial Approach Local intranet Notice the second Literal now contains a hyperlink to go back 11 Click on a book Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 79 Ektron CMS400 NET Server Controls 12 The XML Content Block for that book appears Address 2 http flocalhost CMS400Example collection aspx id 23 Mi Go Links 4 EktronNet Welcome Ektron Inc CMS400 Example Welcome to RC International Title Visual Basic NET How to Program Subject Computer Programming ISBN 0130293636 Genre Non Fiction Publisher Prentice Hall Author s First Name Tem Last Name Neito Harvey Last Name Deitel Price 87 40 Paperback Pub date Saturday December 01 2001 Description Visual Basic NET How to Program Second Edition is an awesome resource for the beginning VB NET developer who is serious about the craft of programming In 1 500 pages this book covers an incredible amount of territory from the evolution of programming languages and web development all the way to advanced data structures and web services Authors Harvey and Paul Deitel have long been world class programming trainers they ve taught at IBM Sun NASA Lucent and Compaq to name just a few famous clients In their seminars and books they ve evolved what they call the Live Code approach to programming instruction Sounds high falutin but all it means is this they introduce new concepts in
33. Ektron CMS400 NET Server Controls This line sets the Random property to true See Also Random on page 83 Step 4 Call the Fill Method Because there is no render event when using objects as components not as controls use the Fill method to fill an object s properties on the page An example is below Dim MyColl as New Collection MyColl DefaultCollectionID 1 MyColl Random True MyColl Fill Step 5 Use text Property to Display the Control Finally use the text property to determine what appears on the Web page For example to display the first item in a collection use this syntax NOTE Before adding this line you need to drag and drop a label on your Web form Dim MyColl as New Collection MyColl DefaultCollectionID 1 MyColl Random True MyColl Fill Labell Text myColl EkItems 0 Title To display all items in a collection use this syntax Dim myColl As New Collection Dim ekitem As New Ektron Cms Common ContentBase myColl DefaultCollectionID 2 myColl Fill Labell Text lt ul gt For Each ekitem In myColl EkItems Labell Text amp lt li gt lt a href amp ekitem QuickLink amp gt amp ekitem Title amp lt a gt Next Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 15 Ektron CMS400 NET Server Controls Labell Text amp lt ul gt This example displays the quick link for every content block in the collection formatted as a bul
34. EndDate Specify the end date the calendar displays Used in Date conjuction with the StartDate property For example you have a calendar that shows only classes for the next three month semester Hide Used to hide output of calendar in design time and run Boolean time True Hide calendar False Display calendar Language Design time only View the calendar in selected Integer languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list ShowXML At runtime output the raw XML data instead of the Boolean calendar With this XML data you can apply your own XSL to create your own custom display formats Default is False True Show raw XML data False Show Calendar StartDate Specify the start date the calendar displays Used in Date conjuction with the EndDate property For example you have a calendar that shows only classes for the next three month semester WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an inline portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag Ektron CMS400 NET Developer Reference Manu
35. ListSummaryl EkItems i QuickLink amp gt amp ListSummaryl EkItems i DateCreated amp lt a gt lt br gt ListSummaryl Text myString Next An Explanation of the code Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 30 Ektron CMS400 NET Server Controls ListSummary1 is the ID of the object It is used to get access to its properties Create a string that contains the output myString Dim myString As String Set the object s text property to that string myString amp lt a href amp ListSummaryl EkItems i QuickLink amp gt amp ListSummaryl EkItems i DateCreated amp lt a gt lt br gt Wrap in a loop so it loops through each of the items Dim i For i LBound ListSummaryl EkItems To UBound ListSummaryl EkItems Next This example outputs the date created for each content block ina List Summary NULSIIUSYUTISTUVEAGINIpIeys iu C Browse WebForms 1 4 2005 4 23 36 PM 1 4 2005 7 35 38 PM 1 4 2005 7 31 25 PM 1 4 2005 4 27 47 PM 1 4 2005 7 26 08 PM 1 4 2005 4 17 18 PM Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 31 List of Server Controls To customize your Ektron CMS400 NET application you can use these server controls Ektron CMS400 NET Server Controls Server Control Description More Information Names Calendar Displays an event calendar Calendar Server Control on page 92 Collec
36. Multi language is enable by default in Ektron CMS400 NET To disable Multi language see Administrator Manual gt Multi Language Support gt Working with Multi Language Content gt Disabling Support for Multiple Language Content ContentBlock Server Control The ContentBlock Server Control displays a content block on an Ektron CMS400 NET Web page Ektron CMS400 NET has two types of content blocks e Static displays one specified content block e Dynamic displays the content block of the ID passed through a URL parameter In addition a content block can contain XHTML or XML content For an example of using the ContentBlock Server Control programmatically see Using the ContentBlock Server Control Programmatically Example on page 47 This subsection contains the following topics e Static Content Block on page 40 e ContentBlock Server Control Properties on page 40 e Dynamic Content Block on page 42 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 39 Ektron CMS400 NET Server Controls e XML Content Block on page 44 e The OverrideXsit and DisplayXslt Properties on page 45 e Using the ContentBlock Server Control Programmatically Example on page 47 Static Content Block A static content block displays one identified content block on a Web page The following table explains how to complete the server control properties to insert a static conten
37. OR ITS REPRESENTATIVES HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH LOSS 6 Miscellaneous This License Agreement the License granted hereunder and the Software may not be assigned or in any way transferred without the prior written consent of Ektron This Agreement and its performance and all claims arising from the relationship between the parties contemplated herein shall be governed by construed and enforced in accordance with the laws of the State of New Hampshire without regard to conflict of laws principles thereof The parties agree that any action brought in connection with this Agreement shall be maintained only in a court of competent subject matter jurisdiction located in the State of New Hampshire or in any court to which appeal therefrom may be taken The parties hereby consent to the exclusive personal jurisdiction of such courts in the State of New Hampshire for all such purposes The United Nations Convention on Contracts for the International Sale of Goods is specifically excluded from governing this License If any provision of this License is to be held unenforceable such holding will not affect the validity of the other provisions hereof Failure of a party to enforce any provision of this Agreement shall not constitute or be construed as a waiver of such provision or of the right to enforce such provision If you fail to comply with any term of this License YOUR LICENSE IS AUTOMATICALLY TERMINATED This License represents the entire un
38. Reference Manual Version 4 8 Revision 1 iii Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 Detailed Table of Contents What s New in the 4 8 Release cccccssssseeeeeeeenseeeeeeenes i PROOUIE TRIS WIAA sia snccssvsncsinastisssnasssnntiterccintmenecsemnccaian 1 Ektron CMS400 NET Server Controls ccssssseseeeeeeeeeeees 2 Opening the Sample Project scseciscscscccccccectecsesessccscsesatentsrerscccaresce 2 Setting Up a Template sisscccacscssiccecesnccncccnaceeeccenancecesencanenorreneencces 4 Making the Server Controls Available cccssseeeesseeeeeeeeees 5 Removing the Server GOninolS c iczcerzers stcscccctsceiesaleacencentestenaumsatese ra Updating the Server Gontrels ccissiccatscesssspcdcndedepapaicecsasiantantecennnenaunss 7 Inserting Server Controls Using Drag and Drop 0se1 7 Adding a Server Control to a Template ccccceeeseeeeeeeeeeeeeneeees 7 Buileithe Projet EA AA E A A T 11 Inserting Server Controls Programmatically s sceee 11 Steps to Insert a Server Control Programmatically 00ceeeee 12 Server Control Properties in Code Behind ccceeesseeeeeeeerteees 16 Customizing Server GON Sis ceccectesaseresice a 26 Using Drag amp Drop and Programmatically Together 29 List OF Server ConWols icc ce ee 32 Login Servet COMO basra 33 LanguageSelect Server Control s ssssssssseeessssssssssss
39. Reference Manual Version 4 8 Revision 1 126 Ektron CMS400 NET Server Controls 3 Choose the fields for the custom table from the available columns DataGrid Properties C General j F Create columns automatically at run time F Columns Column list g Paging Available columns Selected columns AA Format Data Fields Borders E All Fields J LastEditorFname EJ DateModified xo 4 Click OK 5 Right click the DataGrid and choose View in Browser 6 The custom table appears Title QuickLink ID RC Lilly CMS400Sample products aspx id 6 6 For more information on working with DataBind or DataGrid review the help topics in Visual Studio Caching with Server Controls One of the most important factors in building high performance scalable Web applications is the ability to store items in memory the first time they are requested These items include data objects pages or parts of a page Known as caching this process allows you to use a number of techniques to store page output or application data across HTTP requests and reuse it You can store items on the Web server or other software in the request stream such as the proxy server or browser With caching the server does not have to recreate information particularly information that demands significant processor time or other resources This saves valuable time and resources Ektron CMS400 NET Developer Reference Manual Version 4 8 Revi
40. Server Control s properties to insert a dynamic content block on a template NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 42 Ektron CMS400 NET Server Controls Property Value Data Type DefaultContentID The ID of a content block that appears where you Integer inserted this server control if no other content block is identified or is not available If you don t know the ID number of the content block use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DynamicParameter Select id When you do this server control uses the String content block passed as a URL parameter Hide Used to hide a content block in design time and run Boolean time True Hide content block False Show content block Language Design time only View content blocks collections etc Integer in different languages Note The language property shows results only in desi
41. This License shall continue so long as CUSTOMER uses the Software in compliance with this License Should CUSTOMER breach any of its obligations hereunder CUSTOMER agrees to return all copies of the Software and this License upon notification and demand by Ektron 3 Copyright The Software including any images applets photographs animations video audio music and text incorporated into the Software as well as any accompanying written materials the Documentation is owned by Ektron or its suppliers is protected by United States copyright laws and international treaties and contains confidential information and trade secrets CUSTOMER agrees to protect the confidentiality of the Software and Documentation CUSTOMER agrees that it will not provide a copy of this Software or Documentation nor divulge any proprietary information of Ektron to any person other than its employees without the prior consent of Ektron CUSTOMER shall use its best efforts to see that any user of the Software licensed hereunder complies with this license 4 Limited Warranty Ektron warrants solely that the medium upon which the Software is delivered will be free from defects in material and workmanship under normal proper and intended usage for a period of three 3 months from the date of receipt Ektron does not warrant the use of the Software will be uninterrupted or error free nor that program errors will be corrected This limited warranty shall not apply
42. csssesssesseeeseenees 130 Referencing Methods in Visual BasSiC s ececeessseeeeeeeeee 132 Adding a NOW Web FOU sissssssssccsissisinedinessnacstesssionseaassnstciaiadaas 132 Requirements for Standard Methods cccssseeeesseeeeeeeees 133 Standard MOMS va issinisntiniiuneianinemandinnmunnuiand 134 Add TU AN asso sescscteceescccecsacecssneseceacecceieecemeaibonteccansessccnnienaaes 135 Add Content Example ssis 137 WED BCS acces ei ansarar aAA AES 140 Introduction to Web Services cccsssseeeeessseeeeeeessneeeeeeeeeeeees 140 CMS400 NET s Implementation of Web Services cc0 141 Benefits of Using Web Services c c cccccceeeeeeeeeeeeeeeseteeeeeeaeees 141 WS Components and CMS400 NET Architecture 141 Software and Hardware Requirement ccessseseseeees 141 Installation OF FuleS siiissistissisiiesiiniie niin nee ant 142 Setup INSUUCHONS issii ete 142 Providing Web Service Information in Your CMGS 144 CMS400 NET Molh S ecran 144 The CMS400 NET Content Sample Page cccceeeeeeseeeees 148 Sample Output from One Method ccceeeeeceeeseeeeeeeeeeeeseeeeneees 152 The News aspx Sample NON XML cccceeseeeeeeeeeeeeeeeeeeenaeeeeee 153 The News aspx Sample XML eimiiiionssnininninaunanaaa a 156 Creating a Page that Provides a Web Service s 000 161 Syndicating Web Content aS RSS ccccceeeeeeeeeeeeeees
43. following topics e Calendar Server Control Properties on page 93 e Calendar Style Sheet on page 97 e Event Calendar Sample on page 97 Calendar Server Control Properties The Calendar Server Control properties are described in this table NOTE There are additional settings to help define the calendar in the Ektron CMS400 NET Workarea these include display weekends forward only show all label etc For information on these properties see Ektron CMS400 NET Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 93 Ektron CMS400 NET Server Controls Administrator s Manual gt Calendars gt Managing Calendar Modules gt Viewing Calendar Modules NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DefaultCalendar ID The ID number of the calendar that appears where you Integer inserted this server control If you don t know the ID number of the calendar use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10
44. id Formi method post runat s lt cms search id Searchi runat se1 lt body gt lt HTML gt eee C Design Hm 4 Inthe body after Method post replace runat server with action Name of Web form you want the results displayed on See example below NOTE webform2 aspx represents the name of the second webform Before lt body gt lt form id Formi method post runat server gt lt cms Search id Searchi runat server gt lt cms Searc lt body gt After lt body gt lt form id Formi method post laction webform2 aspx gt lt cms search id Searchi runat server DefaultResu lt body gt 5 Add a second web form Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 62 Ektron CMS400 NET Server Controls 6 Drag and drop a Search Server Control on it WebForm2 aspx _Search All the words C Any of the words C Exact Phrase Match Partial Words 7 Set the Ektron property ShowSearchBoxAlways to false 8 Build the solution 9 In your browser go to the first web form Vw wim wee y Links EktronNet Welcome Ektron Inc CMS400E All the words Any of the words Exact Phrase CI Match Partial Words Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 63 Ektron CMS400 NET Server Controls 10 Use the search dialog Vr U ewe Address http flocalhost C
45. is a sample SOAP request and response The placeholders shown need to be replaced with actual values POST cems300sample cms300ws CMS300Content asmx HTTP 1 1 Host 192 166 0 219 Content Type text xml charset utf 8 Content Length length SoOsPaction urn ektron webservices content cms300 v21 GetContentBlock The top section of the page lets you test the method by using the HTTP Get protocol to retrieve data from the sample database To do this you must insert valid parameter values The next section of the CMS400 NET content sample page displays the following kinds of sample output e A sample SOAP request and response e A sample HTTP GET request and response e A sample HTTP POST request and response Review the test pages to learn the kind of content you can retrieve from this method Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 149 Web Services The Search Display Method Parameters Parameter Where How Implemented by CMS Defined in Application API xxx Search Text n a Search text used in search method Ektron All the words Any of the words Exact Phrase C Match Partial Words Search Type n a Type of search used in search method Options and all the words or any of the words exact phrase exact phrase Note This parameter is handled automatically by CMS when displayed on Web page For Web Services however this needs to be defined
46. licensed for use only in delivered code form Each copy of the Software is licensed for use only on a single URL Each license is valid for the number of seats listed below the Basic Package Any use of the Software beyond the number of authorized seats contained in the Basic Package without paying additional license fees as provided herein shall cause this license to terminate Should CUSTOMER wish to add seats beyond the seats licensed in the Basic Package the CUSTOMER may add seats on a block basis at the then current price for additional seats see product pages for current price The Basic Packages are as follows Ektron eMPower for ColdFusion Licensed for ten seats 10 named users per URL Ektron CMS100 Licensed for five seats 5 named users per URL Ektron CMS200 Licensed for ten seats 10 named users per URL Ektron CMS300 Licensed for ten seats 10 named users per URL Ektron CMS400 Licensed for ten seats 10 named users per URL Ektron eWebEditPro Licensed for ten seats 10 named users per URL Ektron eWebEditPro XML Licensed for ten seats 10 named users per URL Ektron eWebWP Licensed for unlimited seats per URL For purposes of this section the term seat shall mean an individual user provided access to the capabilities of the Software The CUSTOMER may not modify alter reverse engineer disassemble or decompiler the Software This software product is licensed not sold 2 Duration
47. object and serialize it To accomplish this use these methods ConvertToRSS ByVal result CMS400WS CollectionResult ByVal Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 165 Syndicating Web Content as RSS title As String ByVal description As String As RSS20 rss Serialize Optional ByVal stream As System I0 Stream Nothing Optional ByVal o As Object Nothing Example Dim objRSSConverter As New CollectionToRSS20 Request Response objRSSConverter ConvertToRSS objResult objResult CollectionTitle objResult CollectionDescription objRSSConverter Serialize Remarks The ConvertloRSS method returns the RSS 2 0 object so that you can fill in or modify additional fields as desired before calling Serialize The Serialize method has optional parameters that let you send the RSS to a stream other than HttpResponse You can add code to serialize a different object such as an RSS 1 0 data class or to run an XSLT on the serialized XML document before returning it as the HTTP response Example Dim objRSSConverter As New CollectionToRSS20 Request Response Dim objRSS20 As rss RSS20 rss objRSSConverter ConvertToRSS objResult objResult CollectionTitle objResult CollectionDescription objRSS20 channel language en us objRSSConverter Serialize Creating Your Own aspx List Summary Page To create your own list summary page copy a list summary object to an RSS 2 0 object and serialize
48. save space on the Web page by having the drop down menus and submenus float over content WARNING You cannot create a DHTML menu using the code behind you must drag and drop it Once the menu is on the template you can manipulate its properties using the code behind Menu Server Control DhtmlMenu Server Control MenuExample AlS Desna Book Book News gt Programming C NET ogramming C NET ASP NET Unleashed Programming C NET VB NET How to News Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 100 Ektron CMS400 NET Server Controls Menu Server Control Properties The Menu Server Control properties are described in this table NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DefaultMenulD The ID of a menu that appears where you insert this Integer server control if no other menu is identified or available If you don t know the ID number of the menu use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on pa
49. similar to the following after the Page_load command Dim MyObj As New Ektron Cms Controls ContentBlock This code declares a variable named MyObj and assigns to it the value of a content block The content block is part of the Ektron CMS Controls content base so it has access to the Ektron CMS400 NET database After defining MyObj as a content block you can access its properties For example to assign a defaultID of 24 insert the following Dim MyObj As New Ektron Cms Controls ContentBlock MyObj DefaultContentID 24 Now the content block can be specified dynamically in the URL of the hyperlink that calls it If not content block 24 displays This is just an example of programmatically applying property values to content blocks For a complete list of properties available to Ektron CMS400 NET objects see List of Server Controls on page 32 Troubleshooting Error Creating Control Message If you get an Error Creating Control message while trying to use a server control you can view the text of the error message by hovering the mouse over the control See illustration below Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 28 Ektron CMS400 NET Server Controls Literal DhtmlJavaScript a lo Solution C RG international cms4o 3 Gy Refe Home Literal DropDownMenu oF Support Nevs Careers Search Calendar OE Copyright 2003 Ektron Inc Sample
50. strHTML amp lt tr gt lt td gt amp nbsp lt td gt lt tr gt Finally the page uses the ContentBlock Web method to display the content block in processed format Here is the code that displays that section of the page strHTML strHTML amp lt tr gt lt td gt lt b gt Processed HTML or XML from ContentBlock Web Service lt b gt lt td gt lt tr gt strHTML strHTML amp lt tr gt lt td gt amp strProcessedHtml amp lt td gt lt tr gt strHTML strHTML amp lt table gt Earlier in the news aspx vb file the strProcessedHtm1 variable was defined as strprocessedHtml wsCms400WebService ContentBlock ild So the strProcessedHtml variable uses the wsCms 400WebService ContentBlock Method to retrieve content in processed format Here is the resulting section of that page As you can see the content appears as within a browser Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 160 Web Services RC International Announces the RC Cheetah January 14 2001 RC International a leading RC racing company has announced the availability of its new flagship product the RC Cheetah After nearly two years of development the RC Cheetah is designed to compete at the highest level in the RC racing arena The excitement level of the hard core enthusiasts can be felt at all the demonstrations of the RC Cheetah The RC Cheetah price performance ration is simply incredible sta
51. the context of real working code and they don t just explain what the code does they also show you with a full color screen capture There s no shortage of code to illustrate in Visual Basic NET How to Program some 21 000 lines in nearly 200 programs all fully color coded and provided on CD ROM ListSummary Server Control The List Summary Server Control is used to display a list of content blocks on a Web page Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 80 Ektron CMS400 NET Server Controls When added to a template and visited a List Summary looks like this It displays each content block s title and summary information You can modify the display to suit your needs by modifying its properties The List Summary Server Control properties are described in this table This subsection contains the following topics e ListSummary Server Control Properties on page 81 e List Summary Example on page 84 e OrderKey Property on page 85 ListSummary Server Control Properties The ListSummary Server Control properties are described in this table NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 81 Ektron CMS400 NET Server Controls
52. vs LanguageAPI Server Control The LanguageSelect Server Control lets users view your site in the language they choose The LanguageAPI Server Control on the other hand forces users to view a site in a particular language For information on LanguageSelect see LanguageSelect Server Control on page 35 LanguageAPI Server Control Properties The LanguageAPI Server Control properties are described in this table Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 37 Ektron CMS400 NET Server Controls NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type SiteLanguage Sets the site language Runs through the IsValid String function to verify that the language is an active language in the system SiteLanguagelD Numeric value of the site language This is the property Integer you will use if you are using code behind to set the sites language ID Example 1036 French For a list of supported languages see The Administrator Manual gt Appendix A List of Supported Languages Code behind Only Properties The following is a list of LangaugeAPI specific properties that can only be used programmatically Property DefaultLanguage DefaultLanguagelD Value Read only What the defa
53. 15 Each step is described below These steps show an example of using the Collection Server Control Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 12 Ektron CMS400 NET Server Controls Step 1 Declare the Namespace Before inserting the server control you can declare the namespace at the top of the code behind Visual Basic file as shown below WebFormi aspx WebForm1 aspx vb oy Page Events Imports Ektron Cms Controls Public Class WebFormi Inherits System Web UI Page ta Web Form Designer Generated Code NOTE You do not need to declare a namespace However if you do not you must fully qualify objects that you create Best Practice For any customization of the CMS classes or controls that inherit from Ektron classes it is recommend that you create your own namespace within Ektron cms Custom For example if your company is AcmeExampleTech Inc you should create all of your custom classes within the namespace Ektron Cms Custom AcmeExampleTech Step 2 Create an Instance of the New Control Next declare a control as an object in the code behind In this example we create a collection named myco11 dim MyColl as New Collection or dim MyColl as new Ektron Cms Controls Collection With C use this syntax Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 13 Ektron CMS400 NET Se
54. Controls design time gt lt add key WSPath value http localhost cms400example cms400scripts ServerControlWS asmx gt Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 9 Ektron CMS400 NET Server Controls You will need to edit this line if you change the location or name of the ServerControlWS asmx file Using CMS Explorer to Browse Your Ektron CMS400 NET Site Ektron CMS400 NET provides a window called the CMS Explorer that lets you browse through your Web site to identify CMS objects such as folders calendars and content blocks For example if you insert a List Summary Server Control its FolderPath property identifies the folder whose contents are displayed If you are not sure of the folder path click the gray button VITSLLVI ASCENUNIyY DisplayXslt ecmNavigation a Hide False annuane 10337 When you do a login screen appears illustrated below NOTE A user cannot be logged into the CMS Explorer and the CMS400 NET Workarea at the same time If you log into the CMS Explorer while logged into the Workarea you will receive the following error when you try to use the Workarea Error The current user does not have permission to carry out this request CBR R31 If you log into the Workarea while logged into the CMS Explorer you will need to re login to the CMS Explorer when you return to using it CMS Login Status Logged Out Username Password Domain Select
55. Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 124 Ektron CMS400 NET Server Controls 7 Switch to Design mode and right click on the DataGrid Then choose View in Browser The table appears LastEditorFname DateModified Html QuickLink HasErrors Teaser ID RC Internationals most successful entry in to the competitive 2 17 2004 CMS400Sample products aspx False RC racing 4 12 11 PM id 5 world is the RC Cheetah Application Customizing the DataGrid Table View Customizing the DataGrid is a great way to display and format specific information from a data source You can select formatting for columns paging and borders plus other general formatting for the table In the following example we choose table columns Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 125 Ektron CMS400 NET Server Controls 1 In Web form design right click the DataGrid and choose Property Builder VEIE 15 ab 00 ea view in Browser 15 ab view Code 00 Synchronize Document Outline Auto Format Property Builder Properties ab 2 Click Columns and uncheck the Create columns automatically at run time checkbox DataGrid1 Properties C General 8 Paging 4vailable columns Selected columns AA Format Data Fields a All Fields Bord rs o oe E EJ DateModified v am a x Column properties Ektron CMS400 NET Developer
56. ID amp lt td gt lt tr gt StrHTML strHTML amp lt tr gt lt td gt lt b gt Content Title lt b gt amp glsCms300ListSummaryResult Item iLoop ContentTitle amp lt td gt lt tr gt strHTML strHTML amp lt tr gt lt td gt lt b gt Date Created lt b gt amp glsCms400ListSummaryResult Item iLoop DisplayDateCreated amp lt td gt lt tr gt StrHTML strHTML amp lt tr gt lt td gt lt b gt Date Modified lt b gt amp glsCms400ListSummaryResult Item iLoop DisplayDateModified amp lt td gt lt tr gt strHTML strHTML amp lt tr gt lt td gt lt b gt Modified By lt b gt amp glsCms400ListSummaryResult Item iLoop EditorFname amp amp glsCms400ListSummaryResult Item iLoop EditorLname amp lt td gt lt tr gt StrHTML strHTML amp lt tr gt lt td gt lt b gt Content Teaser lt b gt lt td gt lt tr gt StrHTML strHTML amp lt tr gt lt td gt amp glsCms400ListSummaryResult Item iLoop ContentTeaser amp lt td gt lt tr gt SstrHTML strHTML amp lt tr gt lt td gt amp nbsp lt td gt lt tr gt Next This code loops through all content blocks in the Market ing News folder For each block the page uses the Web Service method glsCms400ListSummaryResult Item iLoop to display the following XML data e Content ID e Content Title e Date Created e DateModified e Modified By e Content Teaser Ektron
57. ML above is circled below to help you see their relationship 4 Region Web Form Designer Generated Code This call is required by the Web Form Designer H lt System Diagnostics DebuggerStepThrough gt Private Sub InitializeComponent Protected WithEvents MetaDatadrea As System Web UI WebControls Literal Protected WithEvents DhtmlJavaScript As System Web UI WebControls Literal Protected WithEvents DropDownMenu As System Web UI WebControls Literal Protected WithEvents ctrlTopContentBlock As Ektron Cms Controls ContentBlock Protected WithEvents ctrlBottomLeftContentBlock As Ektron Cms Controls ContentBl Protected WithEvents ctrlBottomRightContentBlock As Ektron Cms Controls ContentB Protected WithEvents ctrlLangquageSelect As Ektron Cms Controls LangquageSelect E NOTE The following placeholder declaration is required by the Web Form Designe Private desigqnerPlaceholderDeclaration As System Object Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 27 Ektron CMS400 NET Server Controls The next section of the code behind page loads the page into the browser Private Sub Page_Load ByVal sender As System Object ByVal e As System EventArgs Handles MyBase Load We want our events to occur while the page is loading so we ll add custom code following this line Customizing the Server Control in the Code Behind To customize an Ektron server control in the code behind insert code
58. MS400 NET Developer Reference Manual Version 4 8 Revision 1 51 Ektron CMS400 NET Server Controls e Button Image Source Examples on page 58 e Search Button Text Examples on page 59 e Display Examples on page 60 e ShowDate Examples on page 60 e Specify Search Control To Display Search Results on a Separate Page on page 61 Search Server Control vs IndexSearch Server Control The Search Server Control lets users search your Web site for XHTML Content The IndexSearch Server Control lets users search XML content on your Web site For more information on the IndexSearch Server Control see IndexSearch Server Control on page 64 Search Server Control Properties The following table explains the properties of the Search Server Control NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Description Data Type For more information see Authenticated Indicates if you are logged in to String Using CMS Explorer the CMS Explorer and can use it to Browse Your Ektron to browse to the folder needed CMS400 NET Site on for the FolderPath property page 10 ButtonImgSrc If you want to display an image String Button Image Source on the submit button enter the Examples on page 58 server path to it ButtonText The t
59. MS400 NET Server Controls 3 Click the check boxes for the parameters you want to search with a Build Search Parameter Search Parameter root authors author lastname string 4 Define the parameter HE Build Search Parameter Search Parameter V root publisher string Contains v Presl o Coc The drop down box in this example contains the following variables Select One Prompts you to choose a variable Exact Phrase You enter a phrase and search for that exact phrase contained within the XML content Contains You enter a word or phrase and search for any XML content that has that word or phrase contained within it Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 72 Ektron CMS400 NET Server Controls 5 Click OK 6 Build the Web form 7 Browse to the Web page in your browser A WebForm Microsoft Internet Explorer provided by Ektron Inc File Edit View Favorites Tools Help OQ x Z MD JO Search P Favorites E Address http localhost CMS400Example webform aspx Links 4 EktronNet Welcome J Ektron Inc 4 CMS400 Example 4 Welcome Microsoft ASP NET Pro ing with Microsoft Visual C NET HTML for the World Wide Web with XHTML and CSS 8 The page appears with a list of XML content blocks that match the parameters you set Using the IndexSearch Server Control Programmatically Example NOTE When creating an IndexSearch Server Control form
60. MS400Example webform aspx Links EktronNet Welcome Ektron Inc 4 CMS400 Ektron aah All th words Any of the words Exact Phrase CI Match Partial Words 11 The search results are loaded and displayed in the second Web form automatically I D gt LB GD YS FH Pavers 49 SM Lad Address http flocalhost CMS400Exampld webform2 aspx Links EktronNet Welcome Ektron Inc 4 CMS400 Example Welcome to RC International 4 Welco Web Server eWebEditPro XML V4 2 supports the vision of create content once reuse many times Ektron Inc Named One of New s Fastest Growing Technology C anies Ektron S S id and Efficient Globalization Strategies on the Web Ektron Offers a Visual Development Environment for Rapid CMS Integration and Deployment Ektron Introduces an Enhanced Workflow Suite Ektron Expands Presence with Marketing Interactive and Web Design Firms Ektron Announces Winner of All Stars Customer Competition Corporate CMS Developer IndexSearch Server Control Use the IndexSearch Server Control to display an XML configuration s search screen on any Web form This lets a user search your site based on XML parameters Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 64 Ektron CMS400 NET Server Controls See Also The Ektron CMS400 NET Administrator Manual section XML Indexing Below is a sample screen that can be generated vi
61. Site Site Languac Using Drag amp Drop and Programmatically Together All server controls can be further manipulated after dragging and dropping them on a web form by using the code behind Here is an example of using a drag and drop ListSummary Server Control then modifying it programmatically Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 29 Ektron CMS400 NET Server Controls First drag and drop a List Summary on your Web form and set your properties Toolbox 2 X StartPage Intranet WebForm5 aspx Intranet WebForm5 asp Data 0p m Web Forms ASP NET Unleashed Components Content Management Bible HTML HTML for the World Wide Web with XHTML and CSS Clipboard Ring OMicrosoft ASP NET Pro ing with Microsoft Visual General i C NET Ektron Server Controls Simply Visual Basic NET 2003 h Pointer _ Visual Basic NET How to Pros am Calendar Properties Collection E ContentBlock FormBlock E e amp LanquageAPI E gt E Ektron LanguageSelect ni Authenticated z ContentParameter x oe Direction A Login gt DisplayXstt RE Menu FolderPath g MetaData f Hide MetaDatalist Language dh Search n MaxResults OrderKey Random Recursive False Then add the following code to the code behind Dim myString As String Dim i For i LBound ListSummaryl EkItems To UBound ListSummaryl EkItems myString amp lt a href amp
62. T Developer Reference Manual Version 4 8 Revision 1 55 Ektron CMS400 NET Server Controls E Authenticated True k ButtonImgSrc ButtonText Search DefaultResultDisplay True Display Vertical DisplayXslt ecmNavigation FolderPath Marketing Hide False Language 1033 MaxCharacters 50 MaxResults 0 Recursive True ShowDate True ShowSearchBoxAlways True TextBoxSize 25 The above example has the following parameters e No image is used for the button e The text on the submit button is Search e The results will display on the page e The search options are arranged vertically e Searches content in the content marketing folder e The search allows a maximum of 50 characters e Returns unlimited results when the search is performed e Search is recursive e Shows the last modified date of the content e The search box will appear on PostBack e The size of the text box is 25 characters Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 56 Ektron CMS400 NET Server Controls Text Box Examples Value Web Page View 10 Search All the words C Any of the words Exact Phrase I Match Partial Words 50 _ Tao Search All the words C Any of the words Exact Phrase I Match Partial Words Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 57 Ektron CMS400 NET Server Controls Button Image Source Examples Value Web Page View blank
63. a the IndexSearch Server Control Genre novel v Price Between i f1 LastName Jones Paperback Publishdate Select m Title Contains ems Submit Search You can also predefine a search and have the results appear ona Web form template by using the SearchParmXML property This subsection contains the following topics IndexSearch Server Control vs Search Server Control on page 65 IndexSearch Server Control Properties on page 65 SearchParmXML Property on page 70 Using the IndexSearch Server Control Programmatically Example on page 73 IndexSearch Server Control vs Search Server Control See Search Server Control vs IndexSearch Server Control on page 52 IndexSearch Server Control Properties The IndexSearch Server Control properties are described in this table Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 65 Ektron CMS400 NET Server Controls NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Description Data Values Type Authenticated Indicates if you are logged in String to the CMS Explorer and can use it to browse to the folder needed for the FolderlD property See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on pa
64. al Version 4 8 Revision 1 96 Ektron CMS400 NET Server Controls Calendar Style Sheet Before you insert a Calendar into your Ektron CMS400 NET template Ektron recommends referencing the style sheet webroot cms400example cms400scripts csslib calendarStyles css N your template Copy the style sheet to your webroot folder then add it to your project Next create a reference to calenderStyles css For example html gt lt head gt lt title gt Company Calendar lt title gt lt link href calendarStyles css rel stylesheet type text css gt lt head gt This can also be accomplished via drag and drop If you drag and drop the calendarStyles css from the Solution Explorer to your Web form the reference is created in the HTML automatically Event Calendar Sample Below is a Calendar displayed on the Web Page When logged in you can add and view calendar events When logged out calendar events only appear Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 97 Ektron CMS400 NET Server Controls Login Calendar display Status Logged in vember December 2004 January Sun mon Tue Tha ri osat O 2 Eaa a Eaa 4 Fal Eaa J640 Jae 10 E30 FEEN PIENI 1330 14700 is Fa 16700 17630 1ga PIENI 20 Fal 21 Fa 22 Fal 23700 24 Fal 6 25 Fal do 27 Fa 29700 29740 20 Fa 0 ajaa Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 98
65. alues root publisher For Each Str In arStr strRet lt a href webform aspx publisher amp Server UrlEncode Str amp gt amp Str amp lt a gt lt br gt Next Literall Text strRet End If 5 Save your Web form 6 Build your Web form 7 Browse to the Web form in your browser Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 77 Ektron CMS400 NET Server Controls 8 The list of publishers appears i Address http localhost CMS400Example webform aspx gt co Links EktronNet Welcome Ektron Inc CMS400 Example Publishers Microsoft Press 9 Click on a publisher Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 78 Ektron CMS400 NET Server Controls 10 A list of books with teasers by that publisher appears Address http localhost CMS400Example webform aspx publisher Prentice Hall Ej co Links 4 EktronNet Welcome Ektron Inc CMS400 Example si Publisher Prentice Hall Books Visual Basic NET How to Program Visual Basic NET How to Program Second Edition is an awesome resource for the beginning VB NET developer who is serious about the craft of programming In 1 500 pages this book covers an incredible amount of territory from the evolution of programming languages and web development all the way to advanced data structures and web services Si Visual Basic NET 2003 An Application
66. an be used by each method Standard Methods Method Description More Information These lines call the Ektron net assembly object to allow the page to function properly They must appear at the top of each template To customize your Ektron CMS400 NET application you need to be familiar with these methods Add Content Programmatically adds a content block s to Ektron CMS400 NET Add Content on page 135 Collection Displays links generated by collections Collection Server Control on page 86 Content Block Displays and manages a content block ContentBlock Server Control on page 39 Event Calendar Displays an event calendar Calendar Server Control on page 92 Form Displays a content block that is associated with a form FormBlock Server Control on page 48 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 134 Standard ASP NET Methods Method Description More Information IndexSearch Displays on a Web page a set of search fields A site visitor uses the IndexSearch Server Control page to search for information on on page 64 your Web site List Summary Displays a list of content block ListSummary Server summaries Control on page 80 Login Displays the login or logout button Login Server Control on which lets the user log in and use page 33 Ektron CMS400 NET
67. and act on it however they see fit Benefits of Using Web Services Web Services make it easy to connect with partners They can also deliver more personal integrated experiences to users via smart devices including PCs WSs can save time and money by reducing development time and increase revenue by making your own XML Web services available to others WS Components and CMS400 NET Architecture Web Services require the installation of the NET Framework on the server Ektron s Web Service ContentWS asm x runs within the NET Framework Through the Application API class in the Ektron cms commonuL dll NET managed code can communicate with asp net assembly code ContentWS asmx utilizes the ektron com commonui dll file to provide access to the Content Business Objects content blocks menus collections list summaries etc Software and Hardware Requirements e NET framework version 1 1 SP2 must be installed on the server for more information see http msdn microsoft com netframework Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 141 Web Services Installation of e Ektron CMS400 NET version 4 5 or higher Files Below is a list of the files and their locations that make up the Web Services feature They are installed when you install CMS400 NET File or folder location Description webroot CMS400Example cms400scripts Entry point for Web Service This Web page Co
68. and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DefaultContentID The ID of a content block that appears where you Integer inserted this server control if no other content block is identified or is not available If you don t know the ID number of the content block use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 44 Ektron CMS400 NET Server Controls Property Value Data Type DynamicParameter To make this content block dynamic select id When you do this server control uses the content block passed as a URL parameter String Hide Used to hide a content block in design time and run time True Hide content block False Show content block Boolean Language OverrideXslit Design time only View content blocks collections etc in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the
69. ary Single Summary information as an HTML string GetSingleSummary ecmSingleSummary An XML data structure parameters Stylelnfo representing the Single ShowSummary Summary information ShowlInfo not available MetaData ecmMetaData Meta Data information as does not have the an HTML string unused spare parameter GetMetaData ecmMetaData An XML data structure does not have the representing Meta Data unused spare information parameter SearchDisplay ecmSearchDisplay Search Display See Also The Search information as an HTML Display Method string Parameters on page 150 GetSearchDisplay ecmSearchDisplay An XML data structure Stylelnfo and See Also The Search representing the Search ShowDate Display Method Display information parameters not Parameters on available page 150 GenerateHTMLMenu ecmGenerateMenu Menu details as an html Parameters as menu string ids Comma separated value DropHTMLMenu ecmDropMenu Required menu as an html Parameters string e Root menu id that is the gen erateHTML Menu value e Menuld required menuid e title required title Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 146 Web Services GetFormBlock ecmFormBlock Form information as an Parameters HTML string e formid e formdata gener ated through webservicesUI e formtag required flag set to true to embed lt fo
70. astest growing company in the RC industry announces plans to host the 3rd annual RC conference in Atlanta Georgia RC International Ships RC Sportster 8 27 2002 2 46 12 PM RC International an emerging leader in the RC racing industry has begun shipments of its first product RC Sportster The RC Sportster is designed to compete with the entry and mid level RC racer currently on the market If the user selects a content block and clicks the blue text of any title a new page appears with Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 158 Web Services e information about the block title and any XSLTs used for rendering e a demonstration of the GetContentBlock method to display the content block in raw HTML or XML format e ademonstration of the ContentBlock method to display the content block in processed HTML or XML format Here is the code that displays the top section of the page strHTML lt table gt lt tr gt lt td gt lt b gt Content Block Information from GetContentBlock Web Service lt b gt lt td gt lt tr gt StrHTML strHTML amp lt tr gt lt td gt lt b gt Content Block Title lt b gt amp gcbCms400ContentXml Item ContentTitle amp lt td gt lt td gt SstrHTML strHTML amp lt tr gt lt td gt lt b gt Xslt Used for Rendering lt b gt Select Case gcbCms400ContentXml Item DefaultXslt Case 1 strTmp gcbCms400ContentXml Item Xslt1l Case 2 strTmp
71. available If you don t know the ID number of the collection use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 Integer Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 87 Ektron CMS400 NET Server Controls Property Description Data Type DisplayXslt Determines how the information on the page is displayed None databind only ecmNavigation lists the title of every content block in the collection See Also Example of ecmNavigation Display on page 89 ecmTeaser lists the title of every content block in the collection plus the content summary See Also Example of ecmTeaser Display on page 89 Path to Custom Xslt Enter the path to an Xslt that determines the display of the page String DynamicParameter To make this collection dynamic select coll_id When you do this server control uses the collection passed as a URL parameter String GetHtml Set to True if you want to retrieve and display content html body for all content blocks in the collection For example to display content inside a web server control such as a DataGrid Boolean Hide Used to hide output of collection in design time and run time True Hide collection False Display collection Boolean Language Design time only View content blocks collections etc in different languages
72. ave a French LabeldateBetween site you change Equal to LabelEqual Egale LabelExactPhrase LabelGreaterThan English Labelinputdate PARTAS Equal Labelinputnumber ena Than LabelLessThan French Labelon Eitri Egale LabelSelect Aucun Choix Note These label properties will not change based on the Language property s setting Moins Que For example setting the Plus Grand Que Language property to 1036 Entre will not change these labels to French Language Design time only View Integer content blocks collections etc in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 68 Ektron CMS400 NET Server Controls Property Description Data Values Type OrderBy The order of the list to be String e Title The title of the con returned For example you tent block want to sort search results by last modified date e ID The XML content block ID number e Date Created The date the content block was cre ated e Date Modified The date the content block was last modified e AuthorLName The last author s last name e AuthorFname The last author s first name e StartDate The GoLive Date OrderByDirection The dire
73. ce it is selected XSLT Packaged is the XSLT from the Edit XML configuration screen that is the XSLT created in the Data Designer Default Edit XML Configuration new configuration Title new configuration ID 6 Description xstt 2 Display Information Files prefixed with CMS300SampleTest xmlFiles Default C XSLT 1 xmlfiles xslt samplexsit1 xsl 0 XSLT 2 xmifiles xsit samplexsit2 xsl 0 c O XSLT 3 D XSLT Packaged XSLT 1 from the Edit XML configuration screen XSLT 2 from the Edit XML configuration screen XSLT 3 from the Edit XML configuration screen Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 46 Ektron CMS400 NET Server Controls To use this display XSLT Enter this Enter this value for value for XSLT Override XSLT An absolute or relative path to an XSLT file An external does not matter XSLT file not if XSLT value specified in the exists Edit XML OverrideXSLT configuration is ignored screen For example sample xslt See Also The Managing XML chapter of the Ektron CMS400 NET Administrator manual Using the ContentBlock Server Control Programmatically Example NOTE NOTE The following code will display a content block Before adding these lines of code you need to drag and drop a literal box on your Web form Dim MyContentBlock As New ContentBlock MyContentBlock DefaultContentID
74. chema content http schemas microsoft com intellisense i lt HEAD gt lt body gt lt form id Formi method post runat server gt lt form gt lt body gt Save the Web form and rebuild the solution Open the Web page in the browser Right click on the Web page and click View Source Look in the head tag The meta tags from the content block are added to the page Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 116 Ektron CMS400 NET Server Controls The metadata information added is shown below lt DOCTYPE HTML PUBLIC W3C DTD HTML 4 0 Transitional EN gt lt HTML gt lt HEAD gt lt title gt webForm5 lt title gt lt title gt cmMs Developer lt title gt name keywords content CMS400 NET CMS gt name description content CMS400 developer section gt lt meta content Microsoft visual Studio NET 7 1 name GENERATOR gt lt meta content Visual Basic NET 7 1 name CODE_LANGUAGE gt lt meta content JavaScript name vs_defaultclientScript gt lt meta content http schemas microsoft com intellisense ie5 name Vvs_targetSchema gt lt HEAD gt MetaDataList Server Control Use the MetaDataList Server Control to create lists based on Keyword Names and Keyword Values contained within the metadata of a content block In the example below the KeyWordNames are circled in red and the KeyWordValues are circled in green Ektron CMS400 NET
75. ction the results will String Ascending be sorted in This property Descending works with the OrderBy property only Recursive Determines whether the Boolean True IndexSearch Server Control False will use this folder s child folders in the search SearchParmXML Opens a separate window For more information on that lets you predefine a SearchParmXML see search For example you SearchParmXML Property on want a predefined list of page 70 books to appear on a web page To access the window click the gray button ShowSearchBoxAlways If set to false the search box Boolean True does not appear on PostBack False Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 69 Ektron CMS400 NET Server Controls Property Description Data Values Type Weighted If you set this value to true Boolean True display every content content blocks are ranked by block that matches at least one the number of criteria search criteria matches False show only content For example if a content blocks that match all search block matches all search criteria criteria it appears at the top of the results page A hit marker appears for each match If a second content block only matches one criterion it also appears on the results page underneath the first content block One asterisk appears above the page s title to indicate the single match WrapTag Allows a developer to specify String Span The lt
76. d DhtmlMenu Server Control The Dhtm Menu Server Control has been updated The following are new properties Align Sets the text alignment of the root menu CssClass Assign a css class to be used with the root menu HorizontalDisplay Have the first submenu appear to the right of the root menu instead of appearing below it MenuStyle Specify an inline style to be used with the root menu For more information on the updated DhtmlMenu Server Control See DhtmlMenu Server Control on page 106 Caching with Server Controls An explanation of caching and how to use Server Controls to help define caching parameters For more information see Caching with Server Controls on page 127 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 i What s New in the 4 8 Release Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 ii Summary Table of Contents What s New in the 4 8 Release sssccecsseseeeees About This Mala ccccssscesesssinssntcieccctsstasessseesacncesseaces Ektron CMS400 NET Server Controls cccsscee Standard ASP NET Methods cccccccccceeeceeeceeeeeeeeeeeeees WED SOPVICES nriiiersssniin a aaa Syndicating Web Content as RSS ssssseeeeeeeeeeees Learning About Visual Studio NET ccccccsessseessseeees Additional Information 2 c0sceceeeeceeeececeececeeeeceeeeeeees Ektron CMS400 NET Developer
77. derstanding between the parties with respect to its subject matter YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT THAT YOU UNDERSTAND THIS AGREEMENT AND UNDERSTAND THAT BY CONTINUING THE INSTALLATION OF THE SOFTWARE BY LOADING OR RUNNING THE SOFTWARE OR BY PLACING OR COPYING THE SOFTWARE ONTO YOUR COMPUTER HARD DRIVE YOU AGREE TO BE BOUND BY THIS AGREEMENT S TERMS AND CONDITIONS YOU FURTHER AGREE THAT EXCEPT FOR WRITTEN SEPARATE AGREEMENTS BETWEEN EKTRON AND YOU THIS AGREEMENT IS A COMPLETE AND EXCLUSIVE STATEMENT OF THE RIGHTS AND LIABILITIES OF THE PARTIES Copyright 1999 2003 Ektron Inc All rights reserved LA10031 Revision 1 4 What s New in the 4 8 Release What s New in the 4 8 Release Updated Calendar Server Control The Calendar Server Control has been updated The following are new properties DisplayType Lets you choose the view of the calendar You can choose from Month Day Event Month with Event or Inline StartDate and EndDate Allows you to Select the start and end dates for the calendar For example a calendar that has the date range of May 5th 2005 through July 5th 2005 ShowXML Outputs the raw XML data for use with an XSL This allows you to create a completely custom calendar There is a new style sheet for the Calendar Server Control calendarStyles css For more information on the updated Calendar Server Control See Calendar Server Control on page 92 Update
78. dropdown list An internal Xslt file used to display XML content if one is not identified in the Xslt property See Also The OverrideXslt and DisplayXslt Properties on page 45 Integer must be one of these values default one two three DisplayXslt Specify an external XSLT file See Also The OverrideXslt and DisplayXslt Properties on page 45 String WrapTag Allows a developer to specify a server control s tag The default is Span Span The lt span gt tag is used to designate an in line portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag String The OverrideXslit and DisplayXslt Properties Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 The DisplayXslt property is optional If used it specifies an external XSLT file If the DisplayXslt property is not defined the OverrideXsit property specifies an XSLT identified in the Edit XML Configuration screen The following table provides more information about these properties 45 Ektron CMS400 NET Server Controls To use this display XSLT Enter this Enter this value for value for XSLT Override XSLT The default XSLT specified in the Edit XML Configuration screen illustrated below Note that in this example the XSLT Packaged option is the default XSLT sin
79. e creating a new directory for your Web site you must copy the following files into it from webroot cms400Example bin WebService dll Ektron Cms BE Content dll Ektron Cms BE Font dll Ektron Cms BE Library dll Ektron Cms BE License dll Ektron Cms BE Message dll Ektron Cms BE Module dll Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 143 Web Services e Ektron Cms BE Site dll e Ektron Cms BE ToolBar dll e Ektron Cms BE User dll e Ektron Cms BE UserMgmt dll e Ektron Cms Common dll e Ektron Cms DataAccess dll e Ektron Cms DataRW dll e Ektron Cms Global dll e Ektron Cms UI CommonuI dll e Ektron Cms UI dll e Ektron Cms WebserviceUI dll Providing Web Service Information in Your CMS CMS400 NET Methods CMS400 NET implements a single Web Service ContentWS asm x that exposes several methods for retrieving CMS400 NET content These methods mirror those in the WebService dll file The methods determine the kind of content that is made available for example a content block a collection of content blocks a summary list along with the presentation of that information for example an HTML string or an XML data structure representing content block information Below is a list of methods that ContentWS exposes with a brief description of functionality and differences from the applicationAPI implementation Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 144 Web Servic
80. e native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Align Specifies the horizontal alignment of the root menu text String The default is Center NotSet Use the default setting Left Aligns text to the left Center Aligns text to the center Right Aligns text to the right Justify Aligns text justified to both margins Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 BackColor Sets the background color for the root menu This String property appears in the Appearance category Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 108 Ektron CMS400 NET Server Controls Property Value Data Type CssClass Apply a css class to the root menu Enter the class String name from the css defined in the Stylesheet property See Also Stylesheet on page 111 Since pop_style css is the default style sheet you can use it s classes without defining it in the Stylesheet property For example enter lowtext in the property the root menu changes as shown below No CssClass applied lowT ext CssClass applied DefaultMenulD The ID of a menu that appears where you inserted this Integer server co
81. egin and End gt Setting an End Date on a Content Block EndDateAction e archive display Ektron CMS400 NET User Manual Scheduling Content to e archive expire Begin and End gt Setting e refresh report Archive Options FolderlD The ID of the folder that contains each content block GoLiveDate The content block s start date formatted Ektron CMS400 NET User as a NET date type Manual Scheduling Content to Begin and End gt Setting a Start Date Html The content that makes up the content block If content block is in XML it will return it as raw XML content Hyperlink Content block title wrapped by lt a href gt tags Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 22 Ektron CMS400 NET Server Controls Property Description For more information see Id The content block s ID number InheritedFrom If folder permissions are inherited the Ektron CMS400 NET folder from which they are inherited Administrator manual Setting Permissions gt Inheritance IsInherited Whether a content block s permissions Ektron CMS400 NET are inherited Administrator manual Setting Permissions gt Inheritance IsPrivate Whether or not a content block is private Ektron CMS400 NET Administrator manual Managing Users amp User Groups gt Private Content amp Memberships Language The content block s language Ektron CMS400 NET Admini
82. ent such as content title date modified date created use a method that begins with Get such as GetContentBlock GetCollection and GetListSummary Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 161 Web Services 3 Create a new folder within the CMS400Example folder This folder and some of its subfolders have files that are needed to run Web Services Place all of your files within the new folder 4 Using a development tool that supports Web Service integration for example Visual Studio NET create a NET aspx file that manages page layout The file must refer to a Visual Basic or C file via a codeBenina Command which manages the page s functionality Note You can refer to the samples provided in wwwroot CMS400Example WebServiceDemo aS examples Rename and modify them as needed 5 Add to each NET project a Web Reference to the WSDL file by default webroot CMS400Example WebServiceDemo Web References ContentWS ContentWS wsd1 The environment then builds the appropriate proxy class to access the Web Service s methods You can use the proxy class within the application to invoke those methods CMS300 s sample aspx pages demonstrate how to do this 6 Provide to your consumers a URL to the NET aspx file Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 162 Syndicating Web Content as RSS This section explains how to add RSS syndication
83. er Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 111 Ektron CMS400 NET Server Controls Property Value Data Type SubMenuTopOffset Sets the location of the top of the submenu This Integer number is in pixels The default is 5 Example set to 5 ASP NET Unleashed Programming C NET VB NET How to Example set to 0 zero ASP NET Unleashed Programming C NET VB NET How to Example set to 10 ASP NET Unleashed Book gt SS SSS VB NET How to WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an inline portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag Code Behind Only Properties The following DhtmlMenu specific properties can only be used programmatically in code behind to set the absolute location of the DhtmIMenu Property Value Data Type RootMenuLeftOffset The location from the left border of the window that the Integer menu will appear This number is in pixels Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 112 Ektron CMS400 NET Server Controls Property Value Data Type RootMenuTopOffset The location from the
84. er Control Properties on page 36 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 35 Ektron CMS400 NET Server Controls LanguageSelect Server Control vs LanguageAPI Server Control The LanguageSelect Server Control lets users view your site in the language they choose The LanguageAPI Server Control on the other hand forces users to view a site in a particular language For information on LanguageAPI see LanguageAP Server Control on page 37 LanguageSelect Server Control Properties The following table explains the properties of the LanguageSelect control NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 Hide Used to hide language select dropdown box and label in Boolean design time and run time True Hide language select dropdown box and label False Show language select dropdown box and label LabelName Lets you define the label next to the language select String dropdown box The default label is Language Language Design time only View content blocks collections
85. er controls help make your site more robust and easier to maintain This manual can be used as a reference for a developer or the person setting up your Ektron CMS400 NET Web site This manual explains all server controls supported by Ektron CMS400 NET Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 1 Ektron CMS400 NET Server Controls Ektron CMS400 NET Server Controls Ektron CMS400 NET s server controls let you insert many standard methods and properties within the Visual Studio NET environment This means that you can see the effect of your changes in real time you don t have to modify a page then compile a sample project to see the results You can insert server controls using drag and drop or programmatically You can also use databinding to retrieve and display data from Ektron CMS400 NET This chapter explains the use of the Ektron CMS400 Server Controls through the following topics e Opening the Sample Project on page 2 e Setting Up a Template on page 4 e Making the Server Controls Available on page 5 e Inserting Server Controls Using Drag and Drop on page 7 e Inserting Server Controls Programmatically on page 11 e Using Drag amp Drop and Programmatically Together on page 29 e List of Server Controls on page 32 e Data Binding with Server Controls on page 122 e Caching with Server Controls on page 127 Opening the Sample Project To help get yo
86. er property on a content block to check for a query string you must provide access to the page object if you declared your control in the code behind To do this set the control s page property to the Web page you re working on For an example see the code in red and italics below dim search as new Ektron Cms Controls Search MySearch Page me MySearch Fill With C use this syntax Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 25 Ektron CMS400 NET Server Controls Ektron Cms Controls Search MySearch new Ektron Cms Controls Search MySearch Page this MySearch Fill This relationship is only required when inserting a control in the code behind When dragging and dropping even if you make changes in code behind the relationship is automatically generated Best Practice Ektron recommends including the page property reference when using the server controls as components in the code behind Customizing Server Controls One of Visual Studio NET s strengths is its separation of coding and logic from presentation Web page formatting is handled by a page s HTML while the logic is handled by the code behind which is stored in the corresponding vb file For example if the ASP NET page is mypage aspx the code behind file is mypage aspx vb NOTE If you do not see the code behind files click the Show All Files button on the VS hr aspx Sho
87. erOverColor Sets the background color for the root menu when hovering over it String Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 110 Ektron CMS400 NET Server Controls Property Value Data Type MenuStyle A specified inline style that defines the root menu String For example enter the following in the MenuStyle property box font bold 18px Arial color royalblue background color slateblue Stylesheet Specify the location and style sheet for the submenu String For example cms400scripts csslib mytest css Leave blank to use the default pop_style css is the default style sheet It is located in webroot CMS400Example cms400scripts csslib For more information on style sheets see Using a Style Sheet on page 113 The Stylesheet property can be used in conjunction with the CssClass property to define the root menu See Also CssClass on page 109 SubMenuBackColor Sets the background color for the submenu String SubMenuHoverOverColor Sets the background color for the submenu when String hovering over it SubMenultemHeight Sets the height of each submenu item in pixels The Integer Default is 20 Example set to 20 CMS Developer Example set to 30 CMS Developer SubMenultemWidth Sets the width of each submenu item in pixels The Integer Default is 150 Example set to 150 CMS Developer Example set to 130 CMS Develop
88. ermines whether the KeyWordValue needs to Boolean match the phrase exactly For example if site is the KeyWordValue and the title of a content block is Welcome to the site and ExactPhrase is set to true you would not see the content block in the metadata list This is because site does not equal Welcome to the site True Match the exact phrase False Doesn t need to match exact phrase FolderlD The root folder content will be pulled from Integer GetHtml Set to True if you want to retrieve and display Boolean content html body for all content blocks in the collection For example display content inside a web server control such as a DataGrid Hide Used to hide a metadata list in design time and run Boolean time True Hide metadata list False Show metadata list KeyWordName The KeyWordName is the container where the String KeyWordValues are located Some examples of a KeyWordName might be Keywords or Title For information on creating KeyWordNames for Metadata see the Ektron CMS400 NET Administrators Manual gt Managing Content gt Metadata gt Managing Metadata Definitions gt Adding a Metadata Definitions KeyWordValue The value that is associated with the KeyWordName String Some examples of a KeyWordValue might be Home page or company Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 120 Ektro
89. erver Controls Value Web Page View True Search Results RC Sportster 8 27 2002 7 52 40 PM RC Redstar 8 27 2002 7 52 01 PM RC Lilly 8 27 2002 7 51 26 PM RC Cheetah 8 27 2002 7 50 53 PM Products Page 8 27 2002 7 50 09 PM RC International Ships RC Sportster 8 27 2002 2 46 12 PM RC International Hosts RC Conference 8 27 2002 2 44 44 PM RC International Announces the RC Cheetah 8 27 2002 2 43 01 PM Specify Search Control To Display Search Results on a Separate Page The following example shows a search dialog box on a Web form and the results displayed on separate Web form This is done when you have the search dialog box in a navigation pane and the results displayed on a separate Web form 1 Drag and drop a Search Server Control on a Web form WebForm aspx Search All the words C Any of the words C Exact Phrase l Match Partial Words 2 Set the following Ektron properties for the Search Server Control DefaultResultsDisplay False DisplayXslt None Databind Only Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 61 Ektron CMS400 NET Server Controls 3 Click on html Circled below lt title gt WebForm lt title gt lt meta content Microsoft Visual Studio lt meta content Visual Basic NET 7 1 r lt meta content JavaScript name vs_dei lt meta content http schemas microsoft lt HEAD gt lt body gt lt form
90. es All methods are demonstrated on the sample page webroot CMS400Example cms400scripts ContentWS asmx For more information see The CMS400 NET Content Sample Page on page 148 an HTML string whose format is determined by the display function that you specify You can create a custom display function in a separate NET dll Method Exposes this Returns Changes to applicationApi standard method as a web parameter values service method ContentBlock ecmContentBlock The content block as an HTML string ContentBlockEx ecmContentBlockEx The content block as an XML string If necessary performs XSLT transformation on content prior to its return GetContentBlock ecmContentBlock An XML data structure representing information in the ContentBlock Collection ecmCollection A Collection presented as GetCollection ecmCollection An XML data structure representing information about a Collection additional parameter GetHTML Possible values 1 returns html content for each collection item 0 does not return it ListSummary ecmListSummary List Summary information as an HTML string GetListSummary ecmListSummary An XML data structure parameters representing information ShowSummary about the List Summary Stylelnfo ShowInfo not available Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 145 Web Services SingleSummary ecmSingleSumm
91. etc Integer in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 36 Ektron CMS400 NET Server Controls Property Value Data Type WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an in line portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag LanguageAPI Server Control The LanguageAPI Server Control lets a developer force a particular language for a Web site You can do this simply by dropping the server control on the page and then choosing a language in the SiteLanguage property box You can also override site language logic by programmatically using the LanguageAPI Server Control to detect the browsers language and display the site in that language This subsection contains the following topics e LanguageSelect Server Control vs LanguageAPI Server Control on page 37 e LanguageAPI Server Control Properties on page 37 e Code behind Only Properties on page 38 LanguageSelect Server Control
92. eveloper Reference Manual Version 4 8 Revision 1 168 Learning About Visual Studio NET lt form gt lt body gt In Grid layout you can position your controls like a WYSIWYG editor with no knowledge of HTML However because absolute positioning is not rendered consistently by all browsers the page layout can be flexible based on the size of other controls on the page and the Web browser window When other controls are dynamically populated such as a DataGrid controls that appear beneath it in the Web form would be obscured if they were positioned absolutely at design time In addition when utilizing globalization of pages with different languages the size of text areas can vary and cause obstructions Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 169 Additional Information Additional Information Supporting Documents Support Sales Information You can find more detailed information about Ektron CMS400 NET in the following manuals e Ektron CMS400 NET Administrator Manual e Ektron CMS400 NET User Manual e Ektron CMS400 NET Quick Start Manual e Ektron CMS400 NET Setup Manual If you are experiencing trouble with any aspect of Ektron CMS400 NET please contact the Ektron Support Team via our Web Site at http www ektron com support cms400_support aspx For questions and answers about purchasing Ektron CMS400 NET from Ektron contact the sales department by sending an e mail to
93. ext used for the button if no String Search Button Text image source is identified If an Examples on page 59 image source is identified this is alternative text for the button Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 52 Ektron CMS400 NET Server Controls Property Description Data Type For more information see DefaultResultDisplay Select true to use the default Boolean Ektron display for search results Select false to pass the results through as an object to be manipulated in code behind for a customized display Some examples are to change formatting or filter the displayed results by using code Note If you set DefaultResultDisplay to True the ShowDate and DisplayXslt properties will not work This is because the server control is using a default display Display Determines if the search options either vertical Display Examples on are in a row Horizontal or a or horizontal page 60 column Vertical DisplayXslt Determines how the information String ecmNavigation on the page is displayed Example of None databind only dine ads ecmNavigation lists the title of imei 83 every content block in the folder ecmTeaser Example of ecmTeaser Display ecmTeaser lists the title of on page 89 every content block in the folder plus the content summary Path to Custom Xslt Enter the path to an Xslt that determines the display of the
94. ference Manual Version 4 8 Revision 1 118 Ektron CMS400 NET Server Controls NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer String and can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 ContentType One of the following String e all types e archived content e archived forms e content e forms To learn about archived content see the Ektron CMS400 NET User Manual Scheduling Content to Begin and End gt Setting Archive Options DisplayXslt Determines how the information on the page is String displayed None databind only ecmNavigation lists the title of every content block in the folder See Also Example of ecmNavigation Display on page 89 ecmTeaser lists the title of every content block in the folder plus the content summary See Also Example of ecmTeaser Display on page 89 Path to Custom Xslt Enter the path to an Xslt that determines the display of the page Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 119 Ektron CMS400 NET Server Controls Property Value Data Type ExactPhrase Det
95. g a language from the dropdown list Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 34 Ektron CMS400 NET Server Controls Property Value Data Type WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an in line portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag LanguageSelect Server Control The LanguageSelect Server Control displays a language selection dropdown list on an Ektron CMS400 NET Web page This control lets a visitor to your Web site select a language in which to view the site Here is what the control looks like when published on a Web page Site Language English US Danish French Standard German Standard It lists all languages selected on the Settings gt Configuration gt Language settings screen For more information see the Multi Language Support chapter of the Ektron CMS400 NET Administrator manual You can place this control in any location of any page on your site On the sample site it appears in the lower right corner of the home page This subsection contains the following topics e LanguageSelect Server Control vs LanguageAP Server Control on page 36 e LanguageSelect Serv
96. ge 10 DisplayXslt The Xslt to use to render the menu String None databind only SampleMenu A sample display formatted as a bulleted menu list TreeMenu A sample display formatted as a folder tree You can expand the tree by clicking on the folder icon Path to Custom Xslt Enter the path to an Xslt that determines the display of the page For more information on using the SampleMenu and TreeMenu DisplayXslt see Using DisplayXslt Samples on page 102 DynamicParameter Select menu_id When you do this server control uses String the menu passed as a URL parameter Hide Used to hide a menu in design time and run time Boolean True Hide menu False Show menu Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 101 Ektron CMS400 NET Server Controls Property Value Data Type Language Design time only View content blocks collections etc Integer in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an inline portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a b
97. ge 10 ButtonText The text that appears on the String The default is button Search ContentParameter Checks the QuerySiring for String None Use Default the content block ID value and ID The server control uses the replaces the search with content block passed as a URL content a when ID is parameter specified Leave blank to always display the search Display Xslt Determines how the String None databind only information on the page is ecmNavigation lists the title displayed of every content block in the folder See Also Example of ecmNavigation Display on page 89 ecmTeaser lists the title of every content block in the folder plus the content summary See Also Example of ecmTeaser Display on page 89 Path to Custom Xslt Enter the path to an Xslt that determines the display of the page Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 66 Ektron CMS400 NET Server Controls Property Description Data Type Values EmptyResultMsg The message that displays if String the search returns no hits The default value is Your search did not match any documents Folderld The numeric id of the folder Integer that you want to search See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 The Recursive property determines whether the IndexSearch Server Control will use this folder s child folders in the search An
98. gn time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list OverrideXslt Ignore for a non XML content block must be one of these values default one two three DisplayXslt Ignore for a non XML content block String WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an in line portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 43 Ektron CMS400 NET Server Controls The following example shows how the ContentBlock Server Control can be used to pass the id as a URL parameter A Authenticated False DefaultContentID 2 DisplayXslt DynamicParameter id Hide False Language 1033 OverrideXsit Default When a user clicks a link that passes the content block ID as a URL parameter that content block appears If that content block is not available content block 1 appears XML Content Block Use an XML content block to display an XML content block on an Ektron CMS400 NET Web page NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width
99. gs A pure script aspx page Set Include Tags property to True Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 50 Ektron CMS400 NET Server Controls Option Recommended if How to Enable you are developing Modify HTML form tags in the aspx file An aspx page and Set Include Tags property to False associated code Here is the default NET generated form tag behind web form lt form id Form1 method post runat server gt Modify the form tag as indicated in red lt form id Form1 method post runat server OnSubmit EkFmValidate this gt Search Server Control The Search Server Control displays a text box with a search button on the template To learn about which content is considered by this search function see the Ektron CMS400 NET Administrator manual section Searching Content on the Web Site When added to a template and visited the Search Server Control looks like this Users can enter text and click the search button to search for XHTML content on the Web site Search All the words Any of the words Exact Phrase C Match Partial Words This subsection contains the following topics e Search Server Control vs IndexSearch Server Control on page 52 e Search Server Control Properties on page 52 e Search Server Control Property Example on page 55 e Text Box Examples on page 57 Ektron C
100. h is installed tO webroot CMS400Example WebServiceDemo Specifically four key sections of code are explained e Identifying the Code Behind File e Setting Up an Instance of Web Services e Retrieving the Web Service s URL e Getting Content Blocks Identifying the Code Behind File Here is the first line in the news aspx file lt Page CodeBehind news aspx vb Language vb AutoEventWireup false Inherits WebServicesDemo news gt This line indicates that the page s functionality is set up in the Code Behind Visual Basic file news aspx vb The rest of the news aspx file contains only page display information Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 153 Web Services Setting Up an Instance of Web Services The following code in news aspx vb sets up an instance of the Web Services Every page that uses Web Services must contain such a declaration Dim wsCms400WebService As New ContentWS ContentWs Getting Content Blocks The following lines of news aspx vb code retrieve all content blocks in the sample database s news folder formatted as an HTML string If iId gt 0 Then strHTML wsCms400WebService ContentBlock ild strHTML Replace strHTML asp aspx NewsInfo InnerHtml strHTML Else strHTML wsCms400WebService ListSummary Marketing News 0 1 Title asc DateModified 0 strHTML Replace strHTML news asp WebServiceDemo new
101. ide content block False Show content block Language Design time only View content blocks collections etc Integer in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list OverrideXslt Ignore for a non XML content block must be one of these values default one two three DisplayXslt Ignore for a non XML content block String WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an in line portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag 41 Ektron CMS400 NET Server Controls In the above example the server control retrieves content block id 28 and displays it in the browser Dynamic Content Block Use a dynamic content block to display a content block whose ID is passed through a URL parameter You would use this server control with a dynamic template i File Edit view Favorites T Hoe A News RC International Announces the RC E CHECHEN Microsoft Internet pornea RG International Home Products Support News Careers Search Calendar The following table explains how to complete the ContentBlock
102. if e text align e left e text decoration e none roothighText Text of the root e color e 000000 Black menu as displayed Note This class on a Web page e font e 16px Arial sans serif only works when e text align e center called by the CssClass e text decoration e none property Use the Font property in the Appearence category to define root menu text itemBorder Border color and e border e 1px solid 666666 size of the menu itemBorderBlank Separator border e border e 1px solid CCCCDD color and size of the menu MetaData Server Control The Metadata Server Control lets you add the metadata from For more information on style sheets visit http www w3 org Style CSS content blocks to a Web page This will let developers add metadata quickly without having to type it in You can add metadata from a single content block multiple content blocks or by dynamically passing a content ID from a URL This subsection contains the following topics e MetaData Server Control vs MetaDataList Server Control on page 115 e MetaData Server Control Properties on page 115 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 114 Ektron CMS400 NET Server Controls e Using the MetaData Server Control on page 116 MetaData Server Control vs MetaDataList Server Control With the MetaData Server Control you add metadata from content blocks to you
103. it To accomplish this use these methods Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 166 Syndicating Web Content as RSS ConvertToRSS ByVal result As CMS400WS ListSummaryResult ByVal title As String ByVal description As String As RSS20 rss Serialize Optional ByVal stream As System I0 Stream Nothing Optional ByVal o As Object Nothing Example Dim objRSSConverter As New ListSummaryToRSS20 Request Response objRSSConverter ConvertToRSS objResult News The latest news objRSSConverter Serialize Remarks The ConvertloRSS method returns the RSS 2 0 object so that you can fill in or modify additional fields as desired before calling Serialize The Serialize method has optional parameters that let you send the RSS to a stream other than HttpResponse You can add code to serialize a different object such as an RSS 1 0 data class or to run an XSLT on the serialized XML document prior to returning it as the HTTP response Example Dim objRSSConverter As New ListSummaryToRSS20 Request Response Dim objRSS20 As rss RSS20 rss objRSSConverter ConvertToRSS objResult Title Description objRSS20 channel language en us objRSSConverter Serialize Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 167 Learning About Visual Studio NET Learning About Visual Studio NET This section introduces some background information about using Micro
104. ited Integer Recursive Whether to search sub folders of the identified root folder The root folder is identified in the Folderpath property Boolean Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 54 Ektron CMS400 NET Server Controls Property Description Data Type For more information see ShowDate If True displays the content Boolean ShowDate Examples block s last modified date This on page 60 is useful for determining the most recent content block Note If you set DefaultResultDisplay to True the ShowDate and DisplayXslt properties will not work This is because the server control is using a default display ShowSearchBoxAlways If set to false the search box Boolean does not appear on PostBack Text Box Size The size of the display text box Integer Text Box Examples for user input The width is on page 57 based on the number of characters WrapTag Allows a developer to specify a String server control s tag The default is Span Span The lt span gt tag is used to designate an in line portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag Search Server Control Property Example The following example places a text field and a search button ona template Ektron CMS400 NE
105. ks in child False folders of the selected folder WrapTag Allows a developer to specify a String Span The lt span gt tag is used server control s tag to designate an inline portion of The default is Span an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag List Summary Example Below is an example of the List Summary Server Control properties authenticated ContentParameter Direction Ascending DisplayXslt ecmNavigation FolderPath Marketing News Hide False Language 1033 MaxResults 0 OrderKey Title Random False Recursive False The example has the following properties e Direction The results are displayed in ascending order by title e FolderPath Displays summaries from the market ing News folder e MaxResults Unlimited results appear Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 84 Ektron CMS400 NET Server Controls e OrderKey Summaries sorted by content block title e Random Displays summary for all content blocks in folder not just one random one e Recursive Includes only selected folder not its child folders e Xsit will use the navigation display format OrderKey Property The OrderKey property determines what information appears to the right of the hyperlinked title The values are described below
106. l Version 4 8 Revision 1 33 Ektron CMS400 NET Server Controls This subsection contains the following topics e Placing a Login Button on page 34 e Login Server Control Properties on page 34 Placing a Login Button You can add any number of login buttons to a template You can insert a login button on each template or set up a special Web page called login aspx from which users can log into the CMS400 site without the public being able to access the page Login Server Control Properties The following table explains the properties of the Login Server Control NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 Hide Used to hide login button in design time and run time Boolean True Hide login button False Show login button Language Design time only View content blocks collections etc Integer in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selectin
107. leted list You can use similar code to display a List Summary or search results The following explains the new red code above e labell Text lt ul gt displays the opening tag for the bulleted list e For Each ekitem In myColl EkItems Creates a loop for all content blocks in the collection e labell Text amp lt li gt lt a href amp ekitem QuickLink amp gt amp ekitem Title amp lt a gt lt li gt for each content block in the collection displays its quicklink and title e Next loops through all content blocks in the collection e labell Text amp lt ul gt Closes the bulleted list Server Control Properties in Code Behind Every server control has properties associated with it that you can only access programmatically This subsection explains what they are how to access them and how to use them e Displaying Properties for a Control on page 16 e Mutual Server Control Properties in Code Behind on page 17 e Accessing Additional Properties on page 19 e Accessing Items in an Array on page 25 e Referencing the Page Property on page 25 Displaying Properties for a Control You can use Visual Studio NET s intellisense feature to display a control s properties The intellisense box appears as soon as you insert the period after the object as illustrated below Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 16 Ektron CMS400 NET Server Controls
108. list of content blocks based on the MetaDataList Server Control on metadata contained in the content blocks page 117 Search Inserts a text box with a search button in the Search Server Control on page 51 template The site visitor enters criteria and launches a search of the XHTML content on f your Web site For information on using XML Indexing search see IndexSearch Server Control on page 64 Login Server Control The Login Server Control paints a login button on the template when displayed in a browser When the Login Server Control is inserted and the project is built the control displays the following buttons on a Web page Button Description Login When user is not logged in this button appears Clicking the button opens the login window where a user can enter a username and password Upon authentication the user is logged in to the Ektron CMS400 Web site After a user logs in this button replaces the login button to let the Logout user log out When logged in this button appears under the logout button Workarea allowing the user to access the Workarea Lets the user preview the entire Web site as if all checked in content were published For more information see the Ektron CMS400 NET User Manual section Logging In and Out gt Site Preview y Preview Preview Turns off site preview mode Ektron CMS400 NET Developer Reference Manua
109. llection 1 Drag and drop a data bindable Server Control on the Web form Eil 5 Y a X Start Page WebForm1 aspx WebFormi aspx Oy o o OC ollection ID 0 o o o o 2 In properties choose the Ektron default ID for the Server Control and make sure the XSLT is set to None DataBind Only Collection1 Ektron Cms Controls Collection Aj aai Authenticated True CmsSitePath http localhost CMS40 DefaultCollectionID 1 DynamicParameter GetHtml False Language 1033 Random True xslt None Databind Only Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 123 Ektron CMS400 NET Server Controls 3 Drag and drop a DataGrid on the web form EE 7 nat a X Start Page WebForm1l aspx WebFa a Collection ID 1 Count 1 o o Column Column Column2 l abc abc abc on abc abc abc o o abc abc abc Ha abc abc abc abc abc abc o o o 4 In the DataGrid properties choose the DataSource Properties DataGrid1 System Web UI WebControls DataGrid AK E Data I DataBindings DataKeyField DataMember DataSource Collection1 5 The DataGrid is populated with column headers and the type of information that will be in the table 6 Go to code behind and add DataGrid1 DataBind to the Page_Load event Private Sub Page Load ByVal sender As System Object Put user code to initialize the page here DataGrid1 DataBind End Sub
110. lock 4 E CssClass Font ForeColor E Behavior Accesskey Enabled EnableViewState TabIndex ToolTip Visible Authenticated DefaultFormID DefaultFormID The default ID of the Form Block to be displayed Setting Up a Template To create a new template aspx page follow these steps 1 Click Project gt Add Web Form 2 On the Add New Item screen click Web Form and assign a name Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 4 Ektron CMS400 NET Server Controls Add New Item CMS400Intranet Categories Templates EE ul Code Web Service Mobile Web G Data Form web utility 5 a Module Component Class Data Form DataSet Web User Wizard Control gt Yv 4 form For Web Applications Name WebForm3 aspx cect nee 3 Add controls to determine the page content Making the Server Controls Available NOTE You must copy the dlls to a local drive before installing them You cannot copy them from a network drive 1 Display the Visual Studio NET toolbox View gt Toolbox 2 Right click the mouse within the Toolbox 3 Click Add Tab Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 5 Ektron CMS400 NET Server Controls 4 Type Ektron Server Controls then press enter Components HTML Clipboard Ring General Ektron Server Controls Seay Server Expl 3 Toolbo
111. lock of code Custom Allows you to use a custom tag Using DisplayXsIt Samples Two DisplayXslt samples are provided with the Menu Server Control SampleMenu and TreeMenu This section explains how to use them SampleMenu The SampleMenu DisplayXslt lets you display an Ektron CMS400 NET menu as a bulleted item list See below for an example Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 102 Ektron CMS400 NET Server Controls e MenuExample o CMS Developer o Book a ASP NET Unleashed a Programming C NET a VB NET How to o News a All Stars Customer Web Design Firms a Enhanced Workflow a Visual id CMS Integration a Ektron Partners and Customers When you are logged in to your Ektron CMS400 NET site two menu items are added to each section of the menu Add and Edit Menu The user can use these to add a new menu item or edit an existing one See example below For Information on a adding a menu Item see Ektron CMS400 NET Users Manual gt Working with Menus gt Managing Menus gt Adding a New Content Block to a Menu via Navigation Link on a Web Page For Information on a editing a menu see Ektron CMS400 NET Users Manual gt Working with Menus gt Managing Menus gt Editing a Menu via Navigation Link on a Web Page Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 103 Ektron CMS400 NET Server Controls
112. mid level RC racer currently on the market The News aspx Sample XML The news aspx sample file in the cma400zxample WebServiceDemo folder includes all elements described in The News aspx Sample non XML on page 153 plus demonstrations of how to retrieve XML content Setting Up Instances of Web Services In addition to creating an instance of the Web Service the XML version of news aspx vb creates instances of the ContentBlock and ListSummary methods which are used on the page Dim wsCms400WebService As New localhost CMS400Content Dim gcbCms400ContentXml As localhost ContentBlockResult Dim glsCms400ListSummaryResult As localhost ListSummaryResult Getting Content Blocks Look at this code from news aspx vb glsCms400ListSummaryResult wsCms400WebService GetListSummary Marketing News Oo 1 Title ase DateModified 0 T If Len glsCms400ListSummaryResult ErrorString 0 Then strHTML lt table gt lt tr gt lt td gt lt b gt Content Block Information Return from the GetListSummary Web service call lt b gt lt td gt lt tr gt Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 156 Web Services StrHTML strHTML amp lt tr gt lt td gt amp nbsp lt td gt lt tr gt For iLoop 0 To glsCms400ListSummaryResult Item Length 1 StrHTML strHTML amp lt tr gt lt td gt lt b gt Content ID lt b gt amp glsCms400ListSummaryResult Item iLoop Content
113. mple shows a predefined search appearing on a Web page then being replaced by more specific search results This example creates a hyperlink list of book publishers When you click a specific publisher it replaces the publisher list with a book list from that publisher Follow these steps Add an IndexSearch Server Control to a Web form 2 Set the following properties e DisplayXslt ecmTeaser e Hide True e HitsMarker blank e ShowSearchBoxAlways False e Weighted True e XmlConfigld 4 3 Add two Literals Add the following code to the Page Load Event in code behind Dim bRet As Boolean If Request QueryString publisher lt gt Then IndexSearchl Hide False Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 76 Ektron CMS400 NET Server Controls IndexSearchl Parm XPath root publisher IndexSearchl Parm DataType Ektron Cms Common EkSearch XMLDataType String IndexSearchl Parm SearchType Ektron Cms Common EkSearch XMLSearchRangeType ExactPhrase IndexSearchl Parm Valuel Request QueryString publisher bRet IndexSearchl AddParm IndexSearchl Search Else Literall Text lt hl gt Publisher amp Request QueryString publisher amp Books lt h1 gt Literal2 Text lt a href webform aspx gt Back lt a gt Literall Text lt h1l gt Publishers lt h1 gt Dim arStr As String Dim Str As String Dim strRet As String arStr IndexSearchl GetXPathV
114. n 1 6 Ektron CMS400 NET Server Controls 11 Add the Ektron Cms Controls dll file and press OK This file provides access to Ektron CMS400 NET s server controls Removing the Server Controls Display the Visual Studio NET toolbox View gt Toolbox Right click the mouse within the Toolbox Click Add Remove Items Click Namespace or Assembly Name to sort the Server Controls by manufacturer ale ae ae oe Uncheck all boxes that are Ektron Cms Controls Click OK Right click the Ektron Server Control Tab Click Delete Tab to remove it NO Updating the Server Controls To update the server controls you must first remove the existing server controls in Visual Basic then add the new server controls For information on removing server controls see Removing the Server Controls on page 7 For information on adding server controls see Making the Server Controls Available on page 5 Inserting Server Controls Using Drag and Drop Because Visual Studio NET is a visual environment you can watch the page layout change as you add or move a control and adjust its properties And whenever you need to identify an Ektron CMS400 NET object such as content block or collection you can use the CMS Explorer to visually browse to and select it Adding a Server Control to a Template 1 Display the Visual Studio NET toolbox View gt Toolbox 2 Click the Ektron Server Control tab Ektron CMS400 NET s server controls a
115. n CMS400 NET Server Controls Property Value Data Type Language Design time only View content blocks collections Integer etc in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list MaxNumber The maximum number of results returned for display Integer 0 unlimited OrderBy The order of the list to be returned String e Title The title of the content block e 1D The content block ID number e Date Created The date the content block was created e Date Modified The date the content block was last modified e LastEditorLname The last editor s last name e LastEditorFname The last editor s first name Recursive Whether to search sub folders of the identified root Boolean folder The root folder is identified in the Folderpath property SortOrder Ascending or Descending String WrapTag Allows a developer to specify a server control s tag String The default is Span Span The lt span gt tag is used to designate an inline portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 121 Ektron
116. ned in Application API xxx Style Info Search Specify an inline style that is applied to the Display hyperlinked portion of topics that result from a search For example font family arial font weight bold backgroundcolor cccccc border solid blue lpt margin 2px width 50 Show Date Search Specify whether the last modified date is displayed Display with search results 0 date is not displayed 1 date is displayed Sample Output from One Method The following is an example of the content that can be retrieved from one of the methods GetContentBlock As you can see the HTML content is provided within the lt contentutmi gt XML element GetContentBlock lt xml version 1 0 encoding utf 8 gt lt ContentBlockResult xmlns xsd http www w3 org 2001 XMLSchema xmlns xsi http www w3 org 2001 XMLSchema instance xmlns urn ektron webservices content cms400 v45 gt lt ErrorString gt lt Item gt lt ContentTitle gt Plastic Molder 123 lt ContentTitle gt lt ContentHtml gt lt xml version 1 0 gt lt jobposting gt lt job title gt Plastics Molder lt job title gt lt job number gt 123 lt job number gt lt description gt lt p gt RC International a leading supplier of consumer level radio controlled vehicles is looking for an experienced plastics molder to join our team The candidate will join our highly skilled team of enthusiastic molders to bring to life our next genera
117. ntentWS asmx displays examples of all methods webroot CMS400Example bin Directory for compiled Web Service code webroot CMS400Example bin WebService dll Web Service dll Setup Instructions After you install CMS400 NET you need to open IIS select CMS400Example cms400scripts and make it an application To make a folder an application follow these steps 1 Open IIS 2 Right click one of the folders listed above 3 Select Properties The Properties dialog appears Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 142 Web Services 5 6 7 21xI Directory Documents Directory Security HTTP Headers Custom Errors When connecting to this resource the content should come from amp share located on another computer A redirection to a URL Local Path cMs400s ample webservice I Script source access IV Log visits MV Read IV Index this resource M Write I Directory browsing Application Settings Application name Cmsao0s ample WebService Remove Starting point lt Default We WebService Configuration Execute Permissions Scripts only bs Application Protection Low IIS Process Unload Cancel Apply Help Make sure you are on the Directory tab which is selected by default Press the Create button next to the Application Name field Assign the folder s name in the Application name field Press OK If you ar
118. ntrol if no other content block is identified or is not available If you don t know the ID number of the menu use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DynamicParameter Select menu_id When you do this server control uses String the menu passed as a URL parameter ForeColor Sets the color of the font for the root menu This property appears in the Appearance category Hide Used to hide a menu in design time and run time Boolean True Hide menu False Show menu Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 109 Ektron CMS400 NET Server Controls Property Value Data Type HorizontalDisplay Displays submenu to the right of the root menu This only affects the first submenu of the root menu All subsequent submenus appear to the right of each submenu The default is False True Submenu appears to the right of the root menu Sub menu False Submenu appears below the root menu Root Menu gt Submenu Latest Changes Boolean Language Design time only View content blocks collections etc in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list Integer MenuHov
119. olderPath The folder that contains the String Any folder content blocks which appear in the List Summary See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 The Recursive property determines whether content blocks in this folder s child folders also appear Hide Used to hide output of List Boolean True Hide results Summary in design time and False show results run time Language Design time only View content Integer Integer blocks collections etc in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list MaxResults Maximum number of summaries Integer any integer displayed on a Web page 0 unlimited OrderKey Sort the list by one of the must be one Title values of the values DateModified DateCreated LastEditorFname LastEditorLname See Also OrderKey Property on page 85 Random Set to True if you want to Boolean True randomly display one content False block in the specified folder The content changes each time a user views the page Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 83 Ektron CMS400 NET Server Controls Property Description Data Type Values Recursive Determines if the display Boolean True includes content bloc
120. ontent block Password The password for the username being authenticated As String Domain If using Active Directory specify the domain needed As String to authenticate the user Content_title Title of content block being added See Also As String Managing Content in the Ektron CMS400 NET Administrator Manual Content_comment Historical comment for content being added As String ContentHTML Content for content block As String SummaryHTML Summary information about content block As String Metalnfo Information for the metadata that will be used as a As Object reference point for finding other words or information Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 136 Standard ASP NET Methods Attribute Description Type ContentLanguage Language of the content See Also Multi Language As String Support in the Ektron CMS400 NET Administrator Manual FolderID ID number of content folder to which content block As String will be added See Also Managing Content Folders in the Ektron CMS400 NET Administrator Manual GoLive Date and time content will go live on the Web site As String Must match date time format set in web config EndDate Date and time content will no longer display on Web As String site Must match date time format set in web config ErrString String returned if content fails to get added to Ektron As Object CMS400 NET
121. ontent block s second Xslt as defined in Ektron CMS400 NET Xslt3 The content block s third Xslt as defined in Ektron CMS400 NET Xslt4 The developer can use this property programmatically Ektron CMS400 NET only uses Xslt1 2 and 3 in the workarea Xslt5 The developer can use this property programmatically Ektron CMS400 NET only uses Xslt1 2 and 3 in the workarea Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 24 Ektron CMS400 NET Server Controls Accessing Items in an Array To access and manipulate content blocks returned by an object use the common class ext ron cms Common ContentBase Ekltems is an array of Ektron Cms Common ContentBase Ek tem is a single Ektron Cms Common ContentBase Search Collection and ListSummary have Ekltems an array of ContentBase while and ContentBlock have a single Ekltem Here is an example of how to use this feature dim MyC as new Ektron Cms Controls Collection MyC DefaultCollectionID 1 MyC Fill dim item as Ektron Cms Common ContentBase MyC Text lt ul gt for each item in MyC EkItems MyC Text amp lt li gt amp item Title amp lt lI gt next MyC Text amp lt ul gt Response Write MyC Text This example formats every item in the collection in a bulleted list Referencing the Page Property If a control requires a reference to its parent page for example utilizing the DynamicParamet
122. ontent block was modified formatted as a NET date type DefaultXslt The default Xslt DisplayDateCreated The date when the content block was created It is formatted as a string that represents Ektron CMS400 s display of the date Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 21 Ektron CMS400 NET Server Controls Property Description For more information see DisplayDateModified The date when the content block was edited It is formatted as a string that represents Ektron CMS400 s display of the date DisplayEndDate The content block s end date It is Ektron CMS400 NET User formatted as a string that represents Manual Scheduling Content to Ektron CMS400 s display of the date Begin and End gt Setting an End Date on a Content Block DisplayGoLiveDate The content block s start date It is Ektron CMS400 NET User formatted as a string that represents Manual Scheduling Content to Ektron CMS400 s display of the date Begin and End gt Setting a Start Date DisplayStartDate The content block s start date It is Ektron CMS400 NET User formatted as a string that represents Manual Scheduling Content to Ektron CMS400 s display of the date Begin and End gt Setting a Start Date EndDate The content block s end date formatted Ektron CMS400 NET User as a NET date type Manual Scheduling Content to B
123. or an experienced plastics molder Servo Control Engineer 124 RC International is looked for a highly skilled servo control engineer to join our team Using the Collection Server Control Programmatically Example The following is an example of using code behind and a drag and drop Collection Server Control to display random content from a collection 1 Drag and Drop a Collection Server Control on your Web form 2 Set the properties in the properties window NOTE In this example the Random property and the GetHtml property must be set to True Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 90 Ektron CMS400 NET Server Controls StartPage randomcontent Idisplay aspx randomcontent_htmidisplay aspx vb soona vug pawg e a ee a a a a Authenticated brat Gis Grip e AE Ta n E Gr ba CmsSitePath a ae ah aa E E E a a ContentParameter ig bce EE ete 4 are T Ge as eas DefaultCollectionD EOE E Ga amp nue eracaie aera DisplayXsit er reer ee ee DynamicParameter ah fait ay Otek 8A sou an ae OH dal Svea aren GetHtml Pr ae We Teer VO a SOR Se ee ee Hide Se a eae 8 eae ee Bee 6 Oe eee a Language SOIIIIIIIIIIIIIIIIIIILI I Ef properties Dynamic Help 3 Add the following code to the code behind Dim str As String str lt hl gt Hello There lt hl gt lt br gt str amp Collectionl EkItems 0 Html Collectionl Text str 4 Build and browse your web form
124. p method to insert a server control explained in Inserting Server Controls Using Drag and Drop on Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 11 Ektron CMS400 NET Server Controls page 7 you can insert one programmatically You might prefer to insert server controls programmatically for several reasons such as e you want the control to be loaded into memory only under certain conditions In this case insert the logic that only displays the control if the condition exists e you want to display only certain properties of an object such as the title of last edited date of a content block Note that you can drag and drop controls on your page then customize them using code behind For more information see Using Drag amp Drop and Programmatically Together on page 29 The following sections explain how to use the server controls programmatically e Steps to Insert a Server Control Programmatically on page 12 e Server Control Properties in Code Behind on page 16 e Customizing Server Controls on page 26 Steps to Insert a Server Control Programmatically To insert an Ektron server control programmatically follow these steps Step 1 Declare the Namespace on page 13 Step 2 Create an Instance of the New Control on page 13 Step 3 Set the Properties on page 14 Step 4 Call the Fill Method on page 15 Step 5 Use text Property to Display the Control on page
125. ppear Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 7 Ektron CMS400 NET Server Controls 3 Drag a server control and drop it into the desired location on the page 4 As desired modify the control s properties using the Properties area of Visual Studio NET Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 8 Ektron CMS400 NET Server Controls gp Solution Explorer 2 Class view aJ Search Properties a x FormBlock1 ServerControlLibrary FormBlock gt 4 E CssClass Font ForeColor L E Behavior Accesskey Enabled True X EnableViewState True gt TabIndex 0 ToolTip visible True El Data DataBindings E Ektron Authenticated False DefaultFormID 0 x z DefaultFormID The default ID of the Form Block to be displayed For a description of server control properties see List of Server Controls on page 32 ServerControlWS asmx Best Practice For improved security Ektron recommends renaming or removing the Web services file when you move it to your production server After installation this file is named ServerControlWS asmx and resides in the CMS400Example CMS400Scripts folder in your Web root ServerControlWS asmx is the Web service that lets the server controls talk to Ektron CMS400 NET The path is coded in the web config file This is how it appears lt Web Service URL for Server
126. r Web page With the MetaDataList Server Control you create a list of content blocks to display on your site based on the Metadata in each content block For Information on the MetaDataList Server Control see MetaDataList Server Control on page 117 MetaData Server Control Properties The Metadata Server Control properties are described in this table NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DefaultContentID The ID of the content block that the server control will Integer get the metadata from If you want to add metadata from several content blocks set this property to zero 0 and use the DefaultltemList property to identify the content blocks If you don t know the ID number of the content block use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DefaultltemList A comma delimited list of content block IDs to get Integer metadata from DefaultContentID must be set to zero 0 so you can add IDs to the list DefaultItemList 12 4 7
127. rm gt tag oth erwise set to false GetEventsByCalendar ecmEvtCalendar Calendar information as e Calendar id an HTML string e event id e month e year e url e querystring Show ecmShowRandomSum Randomly displays the e collection ID RandomSummary mary summary content of a collection item ShowRandomContent ecmShowRandomCon Randomly displays the e collection ID tent content of a content block in a specified collection e xsitID Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 147 Web Services AddContent ecmAddContent Lets you programmatically add a new content block to Ektron CMS400 without logging in The CMS400 NET Content Sample Page The CMS400 NET content sample page webroot cms400scripts ContentWS asmx lists the methods described in the table above Click each method on the page to see sample calls and output using various protocols Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 Username password Domain content_title content_comment ContentHTML SummaryHTML ContentLan guage Folder D GoLive EndDate Metalnfo ErrString 148 Web Services When you open the detail page you see Test followed by parameters Click here for a complete list of operations GetContentBlock Test To test the operation using the HTTP GET protocol click the Invoke button Parameter Value Contentld Invoke SOAP The following
128. ron CMS400 NET Server Controls 5 Add the following code to the code behind IndexSearch1 Parm XPath root subject Dim arStr As String Dim Str As String Dim strRet As String arStr IndexSearchl GetXPathValues root subject For Each Str In arStr strRet Str amp lt br gt Next Literall Text strRet Here is a description of what is happening in the code e This line defines the parameter XPath location IndexSearchl Parm XPath root subject e The next three lines create variables Dim arStr As String Dim Str As String Dim strRet As String e This line set the variable arStr as an array of the XPathValues arStr IndexSearchl GetXPathValues root subject e The for next loop iterates through the array of XPathValues For Each Str In arStr strRet Str amp lt br gt Next e The last line displays the values on your web form Literall Text strRet Build the project Browse to your web form 8 The list of book subject titles appears Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 75 Ektron CMS400 NET Server Controls File Edit View Favorites Tools Help O O DAG Ae Address http localhost CMS400Example webform aspx Links EktronNet Welcome 4 Ektron Inc CMS400 C2 CMS Computer Programming Web development Programmatically Predefined General Search Results Replaced By Specific Search Results This Code behind exa
129. rver Controls Ektron Cms Controls Collection MyColl new Ektron Cms Controls Collection You can declare any server control as an object by using the server control name in the List of Server Controls on page 32 Another example would be Dim MyMdl as New MetaDataList Step 3 Set the Properties NOTE For descriptions of the properties and how to use them see Server Control Properties in Code Behind on page 16 After inserting the control you can set the properties that you want to display on the page For example Dim MyColl as New Collection MyColl DefaultCollectionID 1 or dim MyColl as new Ektron Cms Controls Collection MyColl DefaultCollectionID 1 With C use this syntax Ektron Cms Controls Collection MyColl new Ektron Cms Controls Collection MyColl DefaultCollectionID 1 This line tells the page to display CollectionID 1 unless otherwise specified NOTE If you do not know an object s ID number you can switch to Design mode drag and drop the object then use the CMS Explorer to find the ID number See Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 If you do this remember to delete the dropped object when you are done You can also obtain the ID number via the Workarea Dim MyColl as New Collection MyColl DefaultCollectionID 1 MyColl Random True Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 14
130. rvice is an API that can be accessed using SOAP over HTTP SOAP is an XML based lightweight protocol that defines the message format of Web Services For example you might develop a purchasing application that automatically obtains price information from several vendors lets the user select a vendor submits the order and then tracks the shipment until it is received The vendor application in addition to exposing its services on the Web might in turn use XML Web services to check a customer s credit charge the customer s account and set up the shipment with a shipping company This manual does not explain how Web Services work To learn more about them try these sites e http msdn microsoft com webservices understanding readme default aspx Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 140 Web Services e http aspalliance com jnuckolls articles introws default aspx e http aspnet 4guysfromrolla com articles 062602 1 aspx e http www 15seconds com Issue 010430 htm CMS400 NET s Implementation of Web Services CMS400 NET supports XML Web Services This means that you can create pages that offer your content to any Web enabled device and you can create pages that consume existing Web Services CMS400 NET s Web Services feature can return data separated from presentation In combination with XML support this feature lets consumers retrieve your XML data independent of presentation information
131. s http localhost CMS400Exampl Links 2 EktronNet Welcome 8 Ektron True John Edit is logged in 2 is the User ID Accessing Additional Properties In addition to the standard properties Ektron CMS400 NET provides access to additional properties for the following objects e List Summary e Collection e Search e ContentBlock e FormContentBlock Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 19 Ektron CMS400 NET Server Controls To access additional properties use the same syntax you use for standard properties but add ckitem OF ckitems after the object Here is an example dim MyCB as New ContentBlock labell text MyCB EkItem dateCreated or dim MyCB as new Ektron Cms Controls ContentBlock labell text MyCB EkItem dateCreated IMPORTANT To access additional properties for the Collection ListSummary and Search objects use ekitems not ekitem For example MyColl ekitems 0 dateCreated where 0 is the index of the array For more Information on using ekitems see Accessing Items in an Array on page 25 With C use this syntax Ektron Cms Controls ContentBlock MyCB new Ektron Cms Controls ContentBlock labell text MyCB EkItem dateCreated You can use intellisense to select from a list of additional object properties as shown below Private Sub Page Load ByVal sende Put user code to initialize Dim mycb As New Ektron Cms Cc mycb EkI
132. s aspx NewsInfo InnerHtml strHTML End If NOTE Since the database was created with NET you could use this code to get the HTML for the requested ID NewsInfo InnerHtml wsCms400WebService ContentBlock iId As you can see we are assigning to the variable NewslInfo InnerHtml the Web service wsCms400WebService followed by the ContentBlock method For a list of methods see CMS400 NET Methods on page 144 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 154 Web Services If the user selects a content block on the List Summary page that is clicks the blue text of the content title that action passes an id value The blue text is circled in the illustration below RC International Ships RC Sportster8 27 2002 2 46 12 PM RC International an emerging leader in the RC racing industry has begun shipments of its Sportster The RC Sportster is designed to compete with the entry and mid level RC racer A new page appears using the ContentBlock method to display the selected block If iId gt 0 Then strHTML wsCms400WebService ContentBlock ild The ContentBlock method retrieves the content block as an HTML string so the result looks like this Click here for a complete list of operations GetContentBlock Test To test the operation using the HTTP GET protocol click the Invoke button Parameter Value Contentld Invoke SOAP The following is a sample SOAP req
133. sales ektron com For general information about Ektron and its products you may send an e mail to info ektron com Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 170 Additional Information Ektron Inc 5 Northern Blvd Suite 6 Amherst NH 03031 Email sales ektron com Tel 1 603 594 0249 Fax 1 603 594 0258 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 171
134. seconds when you refresh you get the new time Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 129 Standard ASP NET Methods Standard ASP NET Methods Use these methods to customize Ektron CMS400 NET To use them insert them onto your template pages to invoke content blocks list summaries and other objects stored in your database They are the primary building blocks of your Ektron CMS400 NET Content Management System Replacement of Standard Methods Beginning with Release 4 7 Ektron CMS400 NET utilizes ASP NET server controls which replace most Standard ASP NET methods With Ektron CMS400 NET s new toolbox of pre built reusable data bindable ASP NET controls Ektron empowers developers working in Visual Studio NET to rapidly integrate Ektron CMS components into their templates and sites For more Information on Ektron CMS400 NET controls see DhtmlMenu Server Control on page 106 The following examples shows the Login Server Control added by drag and drop vs adding a Login method by the ASP NET method Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 130 Standard ASP NET Methods Drag and Drop Login Server Control Toolbox 2 X WebForm2 aspx WebForm2 aspx vb Data Web Forms Components HTML Clipboard Ring General ektron h amp Pointer E Calendar Collection E ContentBlock FormBlock 3 LanguageSelect ListSummary RE Menu 9 Search
135. sion 1 127 Ektron CMS400 NET Server Controls Below is an example of a page level cache for non logged in users In this example you use a Server Control to define whether a user is logged in or not Then further define if the time is cached based on the user s status Create a new Web form in your Ektron CMS400 NET project 2 Add the following text to the Web form Refresh the page The page will cache for 20 seconds when not logged in Time is 3 Next to Time is add a literal p Debug Times New Roman Refresh the page The page will cache for 20 seconds when not logged in Tame is Literal Literall Below that add a ContentBlock Server Control 5 Set the DefaultContentID For this example DefaultContentID 20 6 Add the following code to the code behind If Not ContentBlockl IsLoggediIn Then Response Cache SetExpires DateTime Now AddSeconds 20 Response Cache SetCacheability HttpCacheability Public Response Cache SetValidUntilExpires True Response Cache VaryByParams id True Response Cache SetVaryByCustom cmsCache End If Literall Text Now 7 Build your Web form 8 Browse to your Web form with your browser Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 128 Ektron CMS400 NET Server Controls 9 Press the refresh button on your browser If you are not logged in to CMS400 NET the time remains the same for twenty seconds After twenty
136. soft s Visual Studio NET For more information use the help feature installed with Visual Studio NET and Microsoft s developer Center http msdn microsoft com vstudio Grid Layout vs Flow Layout NOTE The following definitions are from Visual Studio Help Grid Layout Absolute positioning attributes are inserted into elements that are added and updated in elements that are moved Elements can be dragged across the Design view surface The positioning grid and Snap to Grid are available Flow Layout Elements are added without absolute positioning attributes Web browsers arrange elements in the order that they occur on the page from top to bottom You cannot drag elements across the Design view surface or use the positioning grid Grid layout is the default which means that all controls drawn to the Web form in the designer window will have absolute positioning Here is an example lt body MS_POSITIONING GridLayout gt lt form id Form1 method post runat server gt lt asp Button id Buttonl style Z INDEX 101 LEFT 160px POSITION absolute TOP 80px runat server Text Button gt lt asp Button gt lt asp Button id Button2 style Z INDEX 102 LEFT 480px POSITION absolute TOP 88px runat server Text Button gt lt asp Button gt lt asp DataGrid id DataGridl style Z INDEX 103 LEFT 208px POSITION absolute TOP 152px runat server gt lt asp DataGrid gt Ektron CMS400 NET D
137. span gt tag is used a server control s tag to designate an in line portion of The default is Span an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag xmlConfigID ID of the XML configuration Integer whose indexed fields will appear on the search screen SearchParmXML Property The SearchParmXML property is used to create a predefined XML search whose results appear upon page load Clicking on the gray box in this property opens a window where you define the search The parameters in this window are defined by the xmIConfigID you choose Using this property launches the CMS Explorer login if you are not already logged in For more information on the CMS Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 70 Ektron CMS400 NET Server Controls Explorer login see Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 The following example uses the SearchParmXML property to create a list of books based on publishers with press in their name 1 To activate the window click the gray box in the SearchParmXML property SearchParmXML 2 The Build Search Parameter screen appears ES Build Search Parameter Search Parameter root publisher Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 71 Ektron C
138. ssssnsssrrsssrnseeese 35 LanquageAP Server COM Olssisiasrn oa a 37 ContentBlock Server Control sc cicisasssccceicavesase coraserdstecccasassstccaesvairicec 39 FormBlock Server Contre jas icsssasandiniasmaracstuasastiiuaniact deanna 48 Search Server Conio ccccassesnasteatsasnatatcera n AEO ARATE Ei 51 IndexSearch Server Control csssssssacisssatnenaasnssdonaianennsanenaandsansvadace 64 ListSummary Server COmtol cocccessseseccnesssssceseeeessscezseteareenessecerssenesece 80 Collection Server CONUO ls ss asaceasasacsanadenadsessnanandcaasdnadasaxaaisnaninanandecds 86 Calendar Server GomtOlacwsesssntcocssestetemsazca la tanuaiaas iabeteaaneatrammaanetted 92 Menu Server Canol si ciatansxcocscagacebistadedatasntevasantassiavaaensancelasasnniers 99 DhtmlMenu Server Control sisicideessssnccidennmaaccedereatelcccdaiaivaleccetdasnecs 106 MetaData Server Control ccccccccecseeeceeeeeesseeeeeeesesneeeeeeseseeeaeess 114 Metabatalist Server Comil 117 Data Binding with Server Controls ccssseeccseseeetteeeeeeeees 122 Steps to Data Binding Using Drag and Drop Server Controls 123 Customizing the DataGrid Table View c cccceeeeeseeeeetteeeeenes 125 Caching with Server Controls sssseccccsssseeeeeseseeeeseseeeees 127 Standard ASP NET Methods ccccccsssssssseseeseeeeeeeeeeees 130 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 v Replacement of Standard Methods
139. strator manual Multi Language Support gt Working with Multi Language Content LastEditorFname The first name of the last person to edit the content block LastEditorLname The last name of the last person to edit the content block PackageDisplayXSLT If the content block is XML the name of its XSLT QuickLink The content block s quicklink Ektron CMS400 NET User manual Library Folder gt Quicklinks StartDate The content block s start date formatted Ektron CMS400 NET User as a NET date type Manual Scheduling Content to Begin and End gt Setting a Start Date Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 23 Ektron CMS400 NET Server Controls Property Description For more information see Status Teaser The status of the content block e approved e checked out e checked in e expired e pending deletion e pending expiration e pending start date e submitted The content block summary Ektron CMS400 NET User manual Appendix A Content Statuses Adding a Content Block Summary in the Ektron CMS400 NET User manual TemplateLink Currently empty and not being used with the ContentBlock server control Title UserID The content block title Last user who edited the content Xslt1 The content block s first Xslt as defined in Ektron CMS400 NET Xslt2 The c
140. t block on a Web page ContentBlock Server Control Properties The following table explains the properties of the ContentBlock Server Control NOTE The following table only lists Ektron specific properties It does not describe native Net properties such as font height width and border style For documentation of these properties see VisualStudio Net help Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explorer and String can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DefaultContentID The ID of a content block that appears where you insert Integer this server control If you don t know the ID number of the content block use the CMS Explorer to browse to it See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 DynamicParameter Select None Use Default This parameter is used for String dynamic content blocks Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 40 Ektron CMS400 NET Server Controls Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 El Authenticated True DefaultContentID E DisplayXslt DynamicParameter Hide False Language 1033 OverrideXsit Default Property Value Data Type Hide Used to hide a content block in design time and run Boolean time True H
141. ted Bob Dickerson RC International YP of engineering The RC Cheetah has been devastating its competition in all the pre release races and we expect that to continue The major industry magazines are agreeing with Mr Dickerson s assessment RC Magazine has tested the RC Cheetah head to head with the competition s best and they concluded There is no comparison between the RC Cheetah and its nearest competitor In speed handling and price the RC Cheetah out shines them al The RC Cheetah is now available at all RC International distributors and major Hobby stores Please contact RC International to locate a local dealer Creating a Page that Provides a Web Service Below are the typical steps you would follow to create your own page that provides a Web Service 1 Decide which content blocks you want to provide Here are some examples a specific content block for example wsCms400WebService ContentBlock 2 WOuld display content block 2 regardless of the URL parameters all blocks in a folder the GetListSummary method s first parameter is folder all blocks in a collection the Collection method s first parameter is collection ID 2 Decide what information you want to provide about those blocks and how to present it Review CMS400 NET Methods on page 144 to find the type of content and the kind of information that is available about it For example if you want to display XML data about cont
142. ten End Sub F Comment FA ContentStatus Class ContentType DateCreated DateModified Defaultxslt DisplayDateCreated DisplayDateModified DisplayEndDate DisplayGoLiveDate a The additional properties are listed below Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 20 NOTE Ektron CMS400 NET Server Controls The following properties are read only For example you can get a content block s ID and pass it through to another part of the code however you cannot set a content blocks ID to be shown mycb Ekitem id 8 will not set a content block s ID The correct way to set a content blocks ID is DefaultContentID 8 Property Description For more information see Comment ContentStatus The content block s comment The status of the content block e approved e checked out e checked in e expired e pending deletion e pending expiration e pending start date e submitted Ektron CMS400 NET User Manual Appendix A Content Statuses ContentType One of the following e all types e archived content e archived forms e content e forms To learn about archived content see the Ektron CMS400 NET User Manual Scheduling Content to Begin and End gt Setting Archive Options DateCreated The date when the content block was created formatted as a NET date type DateModified The date when the c
143. tion Displays links generated by collections Collection Server Control on page 86 ContentBlock Displays and manages a content block ContentBlock Server Control on page 39 DhtmIMenu Displays a drop down menu with submenus DhtmlMenu Server Control on page 106 FormBlock Displays a content block that is associated FormBlock Server Control on with a form page 48 IndexSearch Perform XML index searches on XML IndexSearch Server Control on content page 64 For information on using XHTML Search see Search Server Control on page 51 LanguageAPI Allows developers to force a language for a LanguageAPI Server Control on Web site page 37 LanguageSelect Lets user select language of site LanguageSelect Server Control on page 35 ListSummary Displays a list of content block summaries ListSummary Server Control on page 80 Login Displays the login or logout button which lets Login Server Control on page 33 the user log in and use Ektron CMS400 NET Menu Calls a defined menu to be used with an Xslt Menu Server Control on page 99 to display the menu Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 32 Ektron CMS400 NET Server Controls Server Control Description More Information Names MetaData Adds metadata contained in content blocks MetaData Server Control on to a Web page page 114 MetaDataList Creates a
144. tion products RC International is experiencing extremely rapid growth and offers many opportunities for advancement lt p gt lt description gt lt qualifications gt lt ul gt lt li gt 3 years experience in commercial grade plastic molding technologies lt 1li gt lt li gt Excellent written and oral communication skills lt li gt lt li gt Ability to work with very little supervision lt li gt lt li gt An AS degree in chemistry lt li gt lt ul gt lt qualifications gt lt offering gt lt p gt First and second shift opportunities exist RC International offers competitive pay an extensive benefits package including a 401k plan profit sharing and health coverage lt p gt lt offering gt lt contact gt Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 152 Web Services lt contact name gt Human Resources Manager lt contact name gt lt contact email gt jobs CMS400site com lt contact email gt lt contact fax gt 1 555 555 5555 lt contact fax gt lt contact gt lt jobposting gt lt ContentHtml gt lt Xsl1t1 gt C Inetpub wwwroot CMS400Example XMLFiles xslt rc_jobs_display xsl lt Xslt1 gt lt Xs1t2 gt lt Xs1t3 gt lt Xslt4 gt lt Xs1t5 gt lt DefaultXslt gt 1 lt DefaultXslt gt lt Item gt lt ContentBlockResult gt The News aspx Sample non XML To help you understand how the samples work this section explains the news sample NET page news aspx whic
145. to Ektron CMS400 NET for ASP NET RSS syndication allows you to prepare Ektron CMS400 NET content for reading by RSS news feed aggregators To make this task easier Ektron provides sample files to illustrate RSS syndication You should customize the files to meet your needs What is RSS Syndication RSS stands for Really Simple Syndication a common method of syndicating Web content as an XML document There are several versions of RSS Ektron has implemented version 2 0 In Ektron CMS400 NET you use RSS to prepare a collection list or a list summary for reading by an aggregator An aggregator consumes an RSS feed and displays it to the user An aggregator is similar in function to a portal There are several popular aggregators including e AmphetaDesk http www disobey com amphetadesk e NewzCrawler http www newzcrawler com The RSS Specification The RSS specification is a document htip backend userland com rss Ektron has implemented the specification but you can customize the RSS classes to support advanced features Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 163 Syndicating Web Content as RSS RSS Syndication in Ektron CMS400 NET Ektron CMS400 NET allows you to syndicate content by using NET Syndicating via NET requires that you have the Microsoft NET framework installed on your computer With Ektron CMS400 NET you can syndicate a collection and a list summary via RSS
146. to any error or failure resulting from i machine error ii Customer s failure to follow operating instructions iii negligence or accident or iv modifications to the Software by any person or entity other than Company In the event of a breach of warranty Customer s sole and exclusive remedy is repair of all or any portion of the Software If such remedy fails of its essential purpose Customer s sole remedy and Ektron s maximum liability shall be a refund of the paid purchase price for the defective Products only This limited warranty is only valid if Ektron receives written notice of breach of warranty within thirty days after the warranty period expires 5 Limitation of Warranties and Liability THE SOFTWARE AND DOCUMENTATION ARE SOLD AS IS AND WITHOUT ANY WARRANTIES AS TO THE PERFORMANCE MERCHANTIBILITY DESIGN OR OPERATION OF THE SOFTWARE NO WARRANTY OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED EXCEPT AS DESCRIBED IN SECTION 4 ALL WARRANTIES EXPRESS AND IMPLIED ARE HEREBY DISCLAIMED NEITHER COMPANY NOR ITS SUPPLIERS SHALL BE LIABLE FOR ANY LOSS OF PROFITS LOSS OF BUSINESS OR GOODWILL LOSS OF DATA OR USE OF DATA INTERRUPTION OF BUSINESS NOR FOR ANY OTHER INDIRECT SPECIAL INCIDENTAL OR CONSEQUENTIAL DAMAGES OF ANY KIND UNDER OR ARISING OUT OF OR IN ANY RELATED TO THIS AGREEMENT HOWEVER CAUSED WHETHER FOR BREACH OF WARRANTY BREACH OR REPUDIATION OF CONTRACT TORT NEGLIGENCE OR OTHERWISE EVEN IF COMPANY
147. top border of the window that the Integer menu will appear This number is in pixels Using a Style Sheet You can create your own style sheet or modify the existing default one pop_style css It is located in webroot CMS400Example cms400scripts csslib Style Sheets let you choose different text colors text alignment text fonts and text size to create a customized menu Best Practice Ektron recommends copying and renaming the default style sheet This insures you always have a clean file to start with This also gives you something to reference if you are not getting the results you expect The style sheet must be located in the site root You can only define one menu style sheet for each Web page If you have more than one menu on a single Web page they share the style sheet The following is a list of style sheet properties that can be modified in the pop_style css Style Class Description Attribute Default Value lowText Text of the floating e color e 000000 Black menu as displayed on the menu e font e 12px Arial sans serif e text align e left e text decoration e none Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 113 Ektron CMS400 NET Server Controls Style Class Description Attribute Default Value highText Text of the floating e color e 000000 Black menu when highlighted e font e 12px Arial sans ser
148. u started these directions explain how to open the sample site delivered with Ektron CMS400 NET Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 2 Ektron CMS400 NET Server Controls 1 Browse to and double click Ektron CMS400 NET s solution file localhost CMS400Example CMS400Example slIn 2 The sample site project opens 3 To work on a template page click it from the Solution Explorer rc Aba aon ut M uy mr i Il Solution Ex rer a 400Intranet E article aspx AssemblyInfo vb BobsTest aspx calendar ee TATY css Aj DHTML_Menu_Styles css Aj ekcalendar css employee_information aspx E hr aspx E hr forms aspx Els Tas Solution See 2 Class view rs Search Properties 4 x corporate aspx File Properties gt 44 When you select a page its properties appear in the Properties area below Solution Explorer and the page appears in the center of the screen A control s properties include several standard NET properties along with Ektron specific ones The Ektron properties are labeled as illustrated below Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 3 Ektron CMS400 NET Server Controls gp Solution Explorer 19 Class view al Search Properties A x FormBlock1 ServerControlLibrary FormB
149. uest and response The placeholders shown need to be replaced with actual values POST cms300sample cms300ws CMS300Content asmx HTTP 1 1 Host 192 168 0 219 Content Type text xml charset utf 8 Content Length length SoOsPaction urn ektron webservices content cms300 v21 GetContentBlock If the user does not select a content block which is true when the page first appears the page uses the ListSummary method to display all blocks in the market ing news folder using the List Summary format Else strHTML wsCms400WebService ListSummary Marketing News 0 1 Title asc DateModified 0 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 155 Web Services The ListSummary method retrieves the content blocks as an HTML string so the page looks like this Latest News RC International Announces the RC Cheetah 8 27 2002 2 43 01 PM RC International a leading RC racing company has announced the availability of its new flagship product the RC Cheetah RC International Hosts RC Conference 8 27 2002 2 44 44 PM RC International the fastest growing company in the RC industry announces plans to host the 3rd annual RC conference in Atlanta Georgia RC International Ships RC Sportster 8 27 2002 2 46 12 PM RC International an emerging leader in the RC racing industry has begun shipments of its first product RC Sportster The RC Sportster is designed to compete with the entry and
150. ult language of the site is set to For example the demo site is English Standard Read only Returns the value that is the default language id of the site For example the demo site is 1033 for English Data Type String Integer GetLanguage This method returns a string Pass in a valid language ID and it will return the language name Integer Argument GetLanguagelD This method returns an integer Pass in a valid language name and it will return the language ID String Argument IsValid This method returns a boolean You can pass ina language ID or a string and it will tell you if the system is supporting it Argument Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 38 Ektron CMS400 NET Server Controls Property Value Data Type LanguageldList Read only Lists all the language IDs that are activated Array of Integers in Ektron CMS400 NET For information on how to enable languages see The Administrator Manual gt Multi Language Support gt Working with Multi Language Content gt Determining Which Languages are Available LanguageTitleList Read only Lists all the languages that are activated in Array of Strings Ektron CMS400 NET MultiLanguageEnabled Read only Tells if the site supports multi language Boolean mode True Multi language enabled False Multi language not enabled
151. user interface using code behind only you need the IndexSearch Server Control to be connected with the page events Otherwise you will not be able to submit your search parameters You can use the IndexSearch Server Control in code behind to manipulate the way users view the search results The following example using code behind shows how to return values associated with an XPath This example shows a list of book subject titles Open a Web form 2 Drag and drop an IndexSearch Server Control on your Web form 3 Set the properties in the properties window NOTE In this example the hide setting must be set to true Remember to set the XmlConfigID This example uses ID number 4 4 Drag and drop a Literal on the Web form Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 73 Ektron CMS400 NET Server Controls Start Page WebForm aspx ebForm aspx vb 4 E El Ektron Authenticated ButtonText ContentParameter DisplayXsit EmptyResultMsg FolderId Hide HitsMarker Labelafter Labelbefore LabelBetween LabelContains LabeldateBetween LabelEqual LabelExactPhrase LabelGreaterThan Labelinputdate Labelinputnumber LabelLessThan Labelon LabelSelect Language OrderBy OrderByDirection Recursive SearchParmXML ShowSearchBoxAlways Weighted XmlConfigid ES Properties Dynamic Help Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 74 Ekt
152. value to the name of your main runat server String form Hide Used to hide a form block in design time and run time Boolean True Hide form block False Show form block Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 49 Ektron CMS400 NET Server Controls Property Value Data Type Include Tags Determines if tags are generated automatically of manually See Also Automatic versus Manual Generation of Form Tags on page 50 Boolean Language Design time only View content blocks collections etc in different languages Note The language property shows results only in design time in Visual Studio and does not affect the site Content on the site is managed by a cookie value that is set by selecting a language from the dropdown list Integer WrapTag Allows a developer to specify a server control s tag The default is Span Span The lt span gt tag is used to designate an in line portion of an HTML document as a span element Div The lt div gt tag is used when you want to apply attributes to a block of code Custom Allows you to use a custom tag String Automatic versus Manual Generation of Form Tags When using the FormBlock Server control s Include tags property you have two options Option Recommended if How to Enable you are developing automatically Let Ektron CMS400 NET generate form ta
153. w All Files FS index asnx NET Solution Explorer toolbar Within the vb file you can use Visual Basic to insert code to manipulate the events that occur on the page This subsection contains the following topics e Recognizing the Server Control Within the HTML on page 27 e Recognizing the Server Control Within the Code Behind on page 27 Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 26 Ektron CMS400 NET Server Controls e Customizing the Server Control in the Code Behind on page 28 e Troubleshooting Error Creating Control Message on page 28 Recognizing the Server Control Within the HTML Within a Web page s HTML a lt cms gt tag wraps the VS NET object as shown below lt cms Search id Searchl runat server ButtonText Search Display Vertical gt lt cms Search gt Above is an example of a Search Server Control Below is an example of a ContentBlock Server Control lt cms ContentBlock id ctrlMainContentBlock runat server DefaultContentID 1 DynamicParameter id OverrideXslt Default gt lt cms ContentBlock gt Recognizing the Server Control Within the Code Behind Within the VS NET code behind file the Ektron server controls appear along with the VS NET controls in the Web Form Designer Generated Code section When you click the plus sign to display this section you see something like the following The content block listed in HT
154. x I Output E 7 Click the Ektron Server Controls Tab Right click the mouse in the empty area Click Add Remove Items The Customize Toolbox dialog appears oN Oo Customize Toolbox E E x Name Namespace Assembly Name 14 O apone Microsoft VisualBasic Comp Microsoft YisualBasic Compatibility Dat Dlapopcarray Microsoft VisualBasic Comp Microsoft visualBasic Compatibility Dat AdRotator System Web UI MobileCont System Web Mobile 1 0 5000 0 AdRotator System Web UI WebControls System Web 1 0 5000 0 O AssemblyInstaller System Configuration Install System Configuration Install 1 0 5000 Button System Windows Forms System CF Windows Forms 7 0 5000 0 Button System Web UI WebControls System Web 1 0 5000 0 Button System Windows Forms System Windows Forms 1 0 5000 0 DButton rray Microsoft visualBasic Comp Microsoft visualBasic Compatibility 7 0 Calendar ServerControlLibrary ServerControlLibrary 1 0 1787 20128 J i 1 a s A wew tA om o a nss dome ty fs on mnnm mi ADOBE Browse B Language Invariant Language Invariant Country Bowe be Version 7 0 5000 0 Cancel Reset Help 9 Select the NET Framework Components tab 10 Browse to the directory that stores Ektron CMS400 NET s dll files Localhost CMS400Example bin Ektron CMS400 NET Developer Reference Manual Version 4 8 Revisio
155. y folder s numeric ID 0 zero represents the root folder Hide Used to hide output of the Boolean index search in design time and run time For example you want to pass the results to code behind for further manipulation True Hide results False show results HitsMarker This symbol shows how many String search criteria each hit matched The following example shows the first hit met three of the criteria The second group met one criterion E Microsoft ASP NET Prog Ea Content Management Bible Visual Basic NET How to ASP NET Unleashed Simp Visual Basic NET This property is used when the weighted property is set to true See Also Weighted on page 70 Custom Custom lets you choose the marker to use The custom marker can be any text numeric or symbol character except amp and lt For more Information see The Ektron CMS400 NET Administrator Manual section XML Indexing gt Displaying Search Results Ektron CMS400 NET Developer Reference Manual Version 4 8 Revision 1 67 Ektron CMS400 NET Server Controls Property Description Data Values Type Labelafter All of these properties let you String Examples of what the user will Labelbefore change their label names see on the site in French and LabelBet This is useful for Multi English anene WEEN language issues For LabelContains example if you h

Download Pdf Manuals

Related Search

Related Contents

給水装置工事（分岐工事）施工について 佐賀市水道局  Kenwood R-600 user manual  

Copyright © All rights reserved. Failed to retrieve file