Home

Ektron CMS400.NET Developer Reference Manual

1. 486 characters left Default Separator Character 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 110 e MetaDataList Server Control Properties on page 111 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 110 Ektron CMS400 NET Server Controls MetaData Server Control see MetaData Server Control on page 107 MetaDataList Server Control Properties The MetaDataList 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 Authenticate
2. Cancel Reset Help 9 Select the NET Framework Components tab 10 Browse to the directory that stores Ektron CMS400 NET s dll files 1ocalhost CMS400Example bin Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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
3. Book ASP NET Unleashed News _ gt Programming C NET hao VB NETHowto Y Edtmenu f Addor Edit CY Edit Menu Add or Edit submenu This subsection contains the following topics e Menu Server Control vs DhtmiMenu Server Control on page 103 e DhtmiMenu Server Control Properties on page 103 e Code Behind Only Properties on page 105 e Using a Stylesheet on page 106 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 102 Ektron CMS400 NET Server Controls Menu Server Control vs DhtmiMenu Server Control See Menu Server Control vs DntmlMenu Server Control on page 96 Dhtm IMenu Server Control Properties NOTE The DhtmlMenu 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 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 inserted this Integer server control if no other content block is identified or is not available If you don t know the ID number of the menu use the
4. 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 Administrator 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 7 Revision 11 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
5. News 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 The DhtmIMenu Server Control also lets developers add content to a menu when they are logged into their site You can modify the menu s style via a style sheet Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 101 Ektron CMS400 NET Server Controls Before using the DhtmIMenu 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 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 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 ona 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
6. 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 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 7 Revision 11 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
7. lt td gt lt tr gt strHTML 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 wsCms400WebService 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 7 Revision 11 150 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
8. 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 Controls design time gt lt add key WSPath value http localhost cms400example cms400scripts ServerControlWS asmx gt Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 permis
9. To make this calendar dynamic select calendar_id When you do this server control uses the calendar passed as a URL parameter String Hide Used to hide output of calendar in design time and run time True Hide calendar False Display calendar 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 Calendar Style Sheet Before you insert a Calendar into your Ektron CMS400 NET template Ektron recommends referencing the style sheet yourproject folder ekCalendar css in your template This style sheet s styles define the Calendar For example Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 92 Ektron CMS400 NET Server Controls html gt lt head gt lt title gt Company Calendar lt title gt lt link href ekcalendar css rel stylesheet type text css gt lt head gt This can also be accomplished via drag and drop Drag and drop the ekcalendar css from the Solution Explorer to your Web form and the reference will be created in the HTML automatically Solution Explorer cms400example Z Solution cms400example 1 project A cms400example References CS
10. on page 87 e Using the Collection Server Control Programmatically Example on page 88 Collection Server Control Properties The Collection 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 7 Revision 11 85 Ektron CMS400 NET Server Controls 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 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 DisplayXslt Determines how the information on the page is displayed None databind only ecmNavigatio
11. 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 7 Revision 11 137 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 7 Revision 11 Username password Domain content_title content_comment ContentHTML SummaryHTML ContentLan guage Folder D GoLive EndDate Metalnfo ErrString 138 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 is a sa
12. 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 59 column Vertical DisplayXslt Determines how the information String ecmNavigation on the page is displayed Example of None databind only dine aes i ecmNavigation lists the title of eine ied 8 every content block in the folder ecmTeaser Example of ecmTeaser Display ecmTeaser lists the title of on page 87 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 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 7 Revision 11 52 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
13. 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 direction 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 69 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 7 Revision 11 68 Ektron CMS400 NET Server Controls Property Description Data Type Values Weighted If you set this value to true content blocks are ranked by the number of criteria matches For example if a content block matches all search criteria it appears at the top of the results page A hit marker appears for each ma
14. 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 7 Revision 11 62 Ektron CMS400 NET Server Controls 10 Use the search dialog Vr U ewe Address http flocalhost CMS400Example 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
15. 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 unlimited 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 7 Revision 11 53 Ektron CMS400 NET Server Controls Property Description Data Type For more information see ShowDate If True displays the content block s last modified date This 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 Boolean ShowDate Examples on page 59 ShowSearchBoxAlway
16. 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 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 7 Revision 11 103 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 MenuBackColor Sets the background color for the root menu String MenuHoverOverColor Sets the background color for the root menu when String hovering over it Stylesheet Specify the stylesheet for the menu Leave blank to use String the default pop_style css is the default style sheet It is located in webroot CMS400Example cms400scripts csslib For more information on Stylesheets see Using a Stylesheet on page 106 SubMenuBackColor Sets the background color for the submenu String SubMenuHoverOverColor Sets the background color for the submenu when String hovering over it SubMenultemHeight S
17. 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 7 Revision 11 45 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 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 DefaultCont
18. NOTE When creating an IndexSearch Server Control form 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 7 Revision 11 72 Ektron CMS400 NET Server Controls Start Page WebForm aspx ebForm aspx vb 2 E El Ektron Authenticated ButtonText ContentParameter DisplayXslt 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
19. 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
20. Reference Manual Version 4 7 Revision 11 73 Ektron CMS400 NET Server Controls 5 Add the following code to the code behind IndexSearchl 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 7 Revision 11 74 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 Replace
21. 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 selecting a language from the dropdown list Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 34 Ektron CMS400 NET Server Controls 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 LanguageAPI Server Control on page 35 e LanguageSelect Server Control Properties on page 35 LanguageSelect Server Control vs LanguageAPI S
22. 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
23. View 10 Search All the words C Any of the words Exact Phrase I Match Partial Words 50 _TT Search All the words C Any of the words Exact Phrase I Match Partial Words Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 56 Ektron CMS400 NET Server Controls Button Image Source Examples Value Web Page View blank 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 7 Revision 11 57 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 7 Revision 11 58 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 M
24. a Login function via an ASP NET method lt tr gt lt td gt lt S 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 7 Revision 11 121 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 extron cms UI CommonUI d1ll 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 7 Revision 11 122 Standard ASP N
25. can syndicate a collection and a list summary via RSS Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 154 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 10calnost 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 co
26. 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 appear Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 7 Revision 11 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
27. 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 7 Revision 11 14 Ektron CMS400 NET Server Controls This line sets the Random property to true See Also Random on page 82 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 l
28. 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 37 Ektron CMS400 NET Server Controls Property Value Data Type DefaultLanguage Read only What the default language of the site is set String to For example the demo site is English Standard DefaultLanguagelD Read only Returns the value that is the default Integer language id of the site For example the demo site is 1033 for English 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 P
29. 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 DynamicParameter 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 7 Revision 11 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
30. 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 Any 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 69 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 Ref
31. in Atlz DateCreated Displays the date when the coment wasi iirst chested i level RC racer currently on the mark st the 3rd aed RC pone ee in A LastEditorFname Displays the first name of the user who last edited the content block nid level RC racer currenth eres John X growifseougaa in the Ri host the 3rd annual RC cc 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 c 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 84 Ektron CMS400 NET Server Controls 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 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 85 e Example of ecmNavigation Display on page 87 e Example of ecmTeaser Display
32. item changes each time a user views the page 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 7 Revision 11 87 Ektron CMS400 NET Server Controls Home Products Support LatestNews Careers Search Calendar Employment Opportunities Plastic Molder 123 RC International is looking for 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 7 Revision 11 88 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 T
33. 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
34. 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 114 Opening the Sample Project To help get you started these directions explain how to open the sample site delivered with Ektron CMS400 NET 1 Browse to and double click Ektron CMS400 NET s solution file localhost CMS400Example CMS400Example sin 2 The sample site project opens Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 2 Ektron CMS400 NET Server Controls 3 To work on a template page click it from the Solution Explorer om EY BAR as i c E aalala E E article aspx pa AssemblyInfo vb FR ae O UPAle dspx Al default css Aj DHTML_Menu_Styles css Al ekcalendar css employee_information aspx hr aspx hr_forms aspx j lo Solution Explo 24 Class view aa Search Propertes s AX 4 E El atone a 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 labe
35. 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 112 Ektron CMS400 NET Server Controls Property Value Data Type 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 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 f
36. strHTML news asp WebServiceDemo news 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 134 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 144 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
37. 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 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 7 Revision 11 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 WebForml aspx WebForm1 aspx vb oy Page Events Imports Ektron Cms Controls f Public Class WebFormi Inherits System Web UI Page 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 th
38. 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 Preview Preview Turns off site preview mode Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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
39. 3 4 5 6 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 A dynamic calendar is passed to the page by a URL parameter This subsection contains the following topics e Calendar Server Control Properties on page 91 e Calendar Style Sheet on page 92 e Event Calendar Sample on page 94 Calendar Server Control Properties The Calendar Server Control properties are described in this table Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 91 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 Authenticated Value 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 Data Type String DefaultCalendarlID The ID number of the calendar that appears where you 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 Integer DynamicParameter
40. 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 7 Revision 11 130 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 and act on
41. 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 drop method to insert a server control explained in Inserting Server Controls Using Drag and Drop on Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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
42. ET Methods Solution Explorer CMS400Intranet 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 Ektron 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 7 Revision 11 123 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 can be used by each m
43. ET Server Controls Property Description Data Type Values FolderPath 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 84 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 7 Revision 11 82 Ektron CMS400 NET Server Controls Property Descripti
44. Insert a Server Control Programmatically ccceeee 12 Server Control Properties in Code Behind cccceeeeceeeeeeeneees 16 Customizing Server GON Sis ceccectesas eresice a 26 Using Drag amp Drop and Programmatically Together 29 List Of Server ControlScan eee 32 Login Servet COMO basra 33 LanguageSelect Server Control s ssssssssseeessssssssssssrsssnsssrnsssrnsesee 35 LanguageAPI Server COMO scctssieisccases pcatevadesteteteragantaniietesaiatueds 36 ContentBlock Server Control sc cicisasseccceiccvasass cocesasdatecccasassstscaesvainiecea 38 FormBlock Server CONG as scsssasaxdinsassmaracstuasaasatiiganiassidemmnninans 47 Search Server COnUol caccascesasteatsasnatatira a AA E ARAR Ri 50 IndexSearch Server Control cssssscsacisssainenaasnssaemaiannnsanenaasedsansvadann 63 ListSummary Server COMTO socccessseseccnesssssceseveesseceasetseeunessecersseneneae 79 Collection Server CONUO ls ss asaceasasacsanedenadsessnananscaasdnadasanaaisnaninananteces 84 Calendar Server Gomtlacwsesssntcocssestetesassatatinnaiaas aheteaaneatammaanetin 90 Menu Server Canol si ciatasncecacagacibistadbiatanatevecantamsiavaaansanielasinbenniels 95 DhtmlMenu Server COnttols iicidecsssincctdenovarecedetsatalccevaaivaleccetdasiere 101 MetaData Server COntrOl vsssisicsasscnncacnasastonccadansantaccaaaansanaeadanaacnncc 107 MetaDataList Server Comitissa 110 Data Binding with Server Controls cccssseeccseeeeeteeeeeee
45. 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 ListSummary1 EkItems myString amp lt a href amp 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 7 Revision 11 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 in a List Summary PULA IUSYUNSTUVEAGINpIeys 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 7 Revision 11 31 List of Server Controls To cus
46. Path to Custom Xslt Enter the path to an Xslt that determines the display of the page For more infomation on using the SampleMenu and TreeMenu DisplayXslt see Using DisplayXslt Samples on page 98 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 7 Revision 11 97 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 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 Ka MenuExample o CMS Developer o Book a ASP NET Unleashed a Programming C NET a VB NET How to o News All Stars Customer a Web Design Firms a Enhanced Workflow a Visual Rapid CMS Integration a Ektron Partn
47. 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 7 Revision 11 129 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 Service is an
48. S This section explains how to add RSS syndication 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 7 Revision 11 153 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
49. SMenu Intranet H A dynamicContentInContent aspx dynamicdrive js ecmiIndexSearchCollectionDisplay aspx Aj ekcalendar css ExampleSummary xslt faq aspx FormBlock aspx header aspx IndexSearch aspx ao a Y 7 Solution Explorer 94 Class View A Search 3 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 93 Ektron CMS400 NET Server Controls Event Calendar Sample Here is an example of Calendar properties H Authenticated True DefaultCalendarID 1 DynamicParameter Hide True Language 1033 When this code is displayed in a browser the Calendar with an ID 1 is displayed 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 Login Calendar display Status Logged in vember Pepember 2004 January TEDE 15a 0 2 Bal 4 Fal E Eaa JEJE g EJT 10 EA 5 11 2 amp PIENI 13 E40 1455 15240 16 E5 17 50 19E PIENI 20 FAE 210 234000 29 Fal Gi 24 E0 25 F40 PIEN 27 600 29 600 29236 30 Fal 5 31 F35 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 94 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 Me
50. SOAP The following is a sample SOAP request 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 marketing news folder using the List Summary format Else strHTML wsCms400WebService ListSummary Marketing News 0 1 Title ase DateModified 0 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 145 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 Spor
51. String arStr IndexSearchl GetXPathValues root publisher For Each Str In arStr strRet lt a href webform aspx publisher amp Server UrlEncode Str 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 7 Revision 11 Books lt h1 gt amp wins amp Str amp 76 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 7 Revision 11 77 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 stru
52. 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 content 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 7 Revision 11 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
53. 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 7 Revision 11 63 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 via the IndexSearch Server Control Genre novel v Price Between l f1 Last Name 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 64 IndexSearch Server Control Properties on page 64 SearchParmXML Property on page 69 Using the IndexSearch Server Control Programmatically Example on page 72 IndexSearch Server Control vs Search Server Control See Search Server Control vs IndexSearch Server Control on page 50 IndexSearch Server Control Properties The IndexSearch Server Control properties are described in this table Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 64 Ektron CMS400 NET Server Controls NOTE The following table only lists Ektron specific properties It does not describe native Net
54. Val 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 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 7 Revision 11 28
55. a DataGrid to display a Collection Dim myCol As New Ektron Cms Controls Collection myCol DefaultCollectionID 1 myCol Fill DataGridl DataSource myCol DataGrid1l 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 DataGrid1 DataBind This subsection contains the following topics Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 114 Ektron CMS400 NET Server Controls e Steps to Data Binding Using Drag and Drop Server Controls on page 115 e Customizing the DataGrid Table View on page 117 Steps to Data Binding Using Drag and Drop Server Controls The following example uses a Collection 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 7 Revision 11 115 Ektron CMS400 NET Server Controls 3 Drag and drop a DataGri
56. a list summary object to an RSS 2 0 object and serialize it To accomplish this use these methods Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 156 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 10 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 7 Revision 11 157 Learning About Visual Studio NET Learning About Visual Studio NET This sectio
57. a 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 89 Ektron CMS400 NET Server Controls Address http flocalhost cms400example randomcontent Go Links 4 CMS300 Samples Menu Welcome to RC International N Hello There Gail Elliott gelliott test com Sales 603 555 1113 Responsible for the Northeast region 1 a CT e Maine e Mass e NH e NY E e VT Mi Calendar Server Control The Calendar Server Control displays a calendar that was created in the Workarea Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 90 Ektron CMS400 NET Server Controls When added to a template and visited the calendar display looks like this You can modify the display to suit your needs by modifying its properties November December 2004 January sun ton rue
58. amp glsCms400ListSummaryResult Item iLoop ContentID 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 StrHTML 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 DateModifi
59. ass in a valid language name and it will return the language ID String Argument IsValid LanguageldList 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 Read only Lists all the language IDs that are activated 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 Argument Array of Integers LanguageTitleList Read only Lists all the languages that are activated in Ektron CMS400 NET Array of Strings MultiLanguageEnabled Read only Tells if the site supports multi language mode True Multi language enabled False Multi language not enabled 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 Boolean ContentBlock Server Control The ContentBlock Server Control displays a content block on an Ektron CMS400 NET Web page Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 38 Ektron CMS400 NET Server Controls Ektron CMS400 NET has two types of content blocks e Static displays one specified content block e Dynami
60. atch 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 7 Revision 11 59 Ektron CMS400 NET Server 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 Onl
61. b 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 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 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 7 Revision 11 100 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 cee CMS Developer E Book ASP NET Unleashed Pro ing C NET VB NET How to ey All Stars Customer Web Design Firms Enhanced Workflow TE Visual Rapid CMS Integration Ektron Partners and Customers
62. 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 Show 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 7 Revision 11 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 coms 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 Wit
63. c 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 46 This subsection contains the following topics e Static Content Block on page 39 e ContentBlock Server Control Properties on page 39 e Dynamic Content Block on page 41 e XML Content Block on page 43 e The OverrideXsit and DisplayXslt Properties on page 44 e Using the ContentBlock Server Control Programmatically Example on page 46 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 content 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 39 Ektron CMS400 NET Server Controls Property Value Data Type Authenticated Indicates if you are logged in to the CMS Explor
64. ch 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 57 server path to it ButtonText The text used for the button if no String Search Button Text image source is identified If an Examples on page 58 image source is identified this is alternative text for the button Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 51 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
65. ctures and web services Si Visual Basic NET 2003 An Application 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 7 Revision 11 78 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 hig
66. d 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 7 Revision 11 96 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 page 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
67. d By Specific Search Results This Code behind example 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 7 Revision 11 75 Ektron CMS400 NET Server Controls IndexSearch1l Parm XPath root publisher IndexSearchl1 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 Literall Text lt hl gt Publisher amp Request QueryString publisher amp Literal2 Text lt a href webform aspx gt Back lt a gt Else Literall Text lt hl gt Publishers lt h1 gt Dim arStr As String Dim Str As String Dim strRet As
68. d 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 all types archived content archived forms content forms To learn about archived content see the Ektron CMS400 NET User Manual Scheduling Content to Begin and End gt Setting Archive Options Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 111 Ektron CMS400 NET Server Controls Property Value Data Type 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 87 ecmTeaser lists the title of every content block in the folder plus the content summary See Also Example of ecmTeaser Display on page 87 Path to Custom Xslt Enter the path to an Xslt that determines the display of the page ExactPhrase Determines 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
69. d 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 116 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 formatti
70. 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 7 Release What s New in the 4 7 Release e Server Controls Ektron CMS400 NET features server controls that facilitate the insertion of standard methods and properties within the Visual Studio NET environment 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 For more information see Ektron CMS400 NET Server Controls on page 2 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 i What s New in the 4 7 Release Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 ii Summary Table of Contents What s New in the 4 7 Release sseccecceeeseeeees About THIS Maal scccccsscesesscsassnscseccstcesasssssne
71. dio 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 7 Revision 11 17 Ektron CMS400 NET Server Controls Property Value 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 7 Revision 11 18 Ektron CMS400 NET Server Controls Literall Text ContentBlockl IsLoggediIn If ContentBlockl IsLoggedIn Then Literal2 Text ContentBlockl loggedInUserName amp is logged in Literal3 Text ContentBlockl loggedInUserID amp i
72. e 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 7 Revision 11 16 Ektron CMS400 NET Server Controls 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 following list explains these properties NOTE These properties do not display values within Visual Stu
73. ed e Modified By e Content Teaser Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 147 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 144 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 Confere
74. ees 114 Steps to Data Binding Using Drag and Drop Server Controls 115 Customizing the DataGrid Table View ccceeeeeeeeettteeeeeeees 117 Standard ASP NET Methods ccccccceececcceeceeeeeeeeeeeeees 120 Replacement of Standard Methods eeeeeesseeeeenenees 120 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 v Referencing Methods in Visual BaSiC s cceeessseeeeeenes 122 Adding a New Web FOR iicsisscscstsstsietncriteasiaiatestaicieaineesentininiins 122 Requirements for Standard Method eccesseseeeseenees 123 Standard Methods sisca sssaaa a aaraa 124 Add Content ciisiintiiniimnainntinninnniiumanianmiad 125 Add Contem Example sisiane aaiae anaiai 127 WeD SEIVICES coi cassettes sce siveceecorenstnceetncccdscociecee 130 Introduction to Web Services ccsssseeecesseeseeeeeseneeeeeeeseeeees 130 CMS400 NET s Implementation of Web Services 00eee 131 Benefits of Using Web Services cccccescceeeesceeeeeeeeeeeeeeeeeeeees 131 WS Components and CMS400 NET Architecture 131 Software and Hardware Requirement ecceseseeeeeeeees 131 Installation Of PUl S ssscisessininideiniteassicissiicssieeesieeasaciaess teen tassios 132 Setup INSTHUCTIONG vispa 132 Providing Web Service Information in Your CMG 134 CMS400 NET Methods csccsssscssssesscsesccsesccsescesssecseee
75. entID 8 MyContentBlock Fill Literall Text MyContentBlock EkItem Title Literal2 Text MyContentBlock EkItem Html Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 46 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 mmiddiy yyy Total Days Absent With Pay Without Pay Comments a This subsection contains the following topics Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 47 Ektron CMS400 NET Server Controls e FormBlock Server Control Properties on page 48 e Automatic versus Manual Generation of Form Tags on page 49 FormBlock Server C
76. er 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 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 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 40 Ektron CMS400 NET Server Controls El Ektron Authenticated True DefaultContentID 28 ar DisplayXslt DynamicParameter Hide False Language 1033 OverrideXslt Default In the above example the server control retrieves content bl
77. erence Manual Version 4 7 Revision 11 66 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 have 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 7 Revision 11 67 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
78. erence Manual Version 4 7 Revision 11 70 Ektron CMS400 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 7 Revision 11 71 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
79. ers 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 98 Ektron CMS400 NET Server Controls 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 e MenuExample o CMS Developer o Book a ASP NET Unleashed a Programming C NET a VB NET How to a Add or 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 99 Ektron CMS400 NET Server Controls gt MenuExample CMS Developer Book News All Stars Customer We
80. erver 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 LanguageAPI Server Control on page 36 LanguageSelect Server Control Properties The following table explains the properties of the LanguageSelect control Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 35 Ektron CMS400 NET Server Controls 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 Authenticated Value can use it to browse to Content Collections etc See Also Using CMS Explorer to Browse Your Ektron CMS400 NET Site on page 10 Data Type String Indicates if you are logged in to the CMS Explorer and Hide Used to hide language select dropdown box and label in design time and run time True Hide language select dropdown box and label False Show language select dropdown box and label Boolean LabelName Lets you define the label next to the language select dropdown box The default label is Language String Language Design time only View content blocks collections etc in different languages Note The language propert
81. ethod 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 125 Collection Displays links generated by collections Collection Server Control on page 84 Content Block Displays and manages a content block ContentBlock Server Control on page 38 Event Calendar Displays an event calendar Calendar Server Control on page 90 Form Displays a content block that is associated with a form FormBlock Server Control on page 47 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 124 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 63 your Web site List Summary Displays a list of content block ListSummary Server summaries Control on page 79 Login Displays the login or logout button Login Server Control on which lets the user log in and use page 33 Ektron CMS400 NET Metadata Display
82. ets the height each submenu item displayed This Integer number is in pixels The Default is 20 Example set to 20 CMS Developer Example set to 30 CMS Developer SubMenultemWidth Sets the width each submenu item displayed This Integer number is in pixels The Default is 150 Example set to 150 CMS Developer Example set to 130 CMS Developer Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 104 Ektron CMS400 NET Server Controls Property Value Data Type SubMenuTopOffset Sets the location the top of the submenu appears This number is in pixels The Default is 5 Example set to 0 zero ASP NET Unleashed News gt Programming C NET VB NET How to Example set to 5 ASP NET Unleashed Programming C NET VB NET How to Example set to 10 Book gt ASP NET Unleashed Programming C NET VB NET How to Integer Code Behind Only Properties The following DhtmlMenu specific properties can only be used programmatically in code behind to set the absolute location of the DhtmlMenu Property Value Data Type RootMenuLeftOffset The location from the left of the screen that the menu Integer will appear This number is in pixels RootMenuTopOffset The location from the top of the screen that the menu Integer will appear This number is in pixels Ektro
83. ew 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 7 Revision 11 133 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 7 Revision 11 134 Web Services All me
84. example if you want to display XML data about content 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 7 Revision 11 151 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 codeBehina 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 ContentWSs 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 7 Revision 11 152 Syndicating Web Content as RS
85. h falutin but all it means is this they introduce new concepts in 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 7 Revision 11 79 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 80 e List Summary Example on page 83 e OrderKey Property on page 84 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 Man
86. he help topics in Visual Studio Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 119 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 Ektron CMS400 NET Server Controls on page 2 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 7 Revision 11 120 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 Adding
87. he 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 The metadata information added is shown below WebForm5 1 Notepad lt DOCTYPE HTML PUBLIC W3C DTD HTML 4 0 Transitional EN gt lt HTML gt lt HEAD gt lt tit le gt webForm5 lt title gt lt title gt cmMs Developer lt title gt lt meta name keywor ds content CMS400 NET CMS gt lt meta name description content CM5400 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 vs_targetSchema gt lt HEAD gt Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 109 Ektron CMS400 NET Server Controls 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 Title Contact Ektron English U S Content Summary Metadata Schedule Comment Required fields 500 max Separator Character Contact Ektron
88. hin 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 HTML 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 7 Revision 11 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 By
89. ime 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 108 Ektron CMS400 NET Server Controls 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 t 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_targetSchema 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 t
90. is 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 7 Revision 11 13 Ektron CMS400 NET Server Controls Ektron Cms Controls Collection MyColl new Ektron Cms Controls Collection j 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
91. 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 7 Revision 11 131 Web Services e Ektron CMS400 NET version 4 5 or higher Installation of 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 ContentWS asmx disp
92. ived 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 content 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 7 Revision 11 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 st
93. lays 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 7 Revision 11 132 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 are creating a n
94. le 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 140 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 140 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 7 Revision 11 136 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 form gt tag
95. led as illustrated below Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 3 Ektron CMS400 NET Server Controls gp Solution Explorer 19 Class view al Search Properties A x FormBlock1 ServerControlLibrary FormBlock 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 7 Revision 11 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 De
96. llection page copy the collection object to an RSS 2 0 object and serialize it To accomplish this use these methods ConvertToRSS ByVal result CMS400WS CollectionResult ByVal Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 155 Syndicating Web Content as RSS title As String ByVal description As String As RSS20 rss Serialize Optional ByVal stream As System 1I0 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
97. loper Reference Manual Version 4 7 Revision 11 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 107 MetaDataList Creates a list of content blocks based on the MetaDataList Server Control on metadata contained in the content blocks page 110 Search Inserts a text box with a search button in the Search Server Control on page 50 template The site visitor enters criteria and launches a search of the XHTML content on your Web site For information on using XML Indexing search see the following e IndexSearch Server Control on page 63 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 a Logout user log out When logged in this button appears under the logout button Workarea allowing the user to access the Workarea Lets the
98. lue that is set by selecting a language from the dropdown list OverrideXslt An internal Xslt file used to display XML content if one is must be one of not identified in the Xslt property these values See Also The OverrideXslt and DisplayXslt Properties default one two on page 44 three DisplayXslt Specify an external XSLT file See Also The String OverrideXslt and DisplayXslt Properties on page 44 The OverrideXslit and DisplayXslt Properties Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 44 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 since 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
99. mp gcbCms400ContentXml Item Xslt1l Case 2 strTmp gcbCms400ContentXml Item Xs1t2 Case 3 strTmp gcbCms400ContentXml Item Xslt3 Case 4 strTmp gcbCms400ContentXml Item Xslt4 Case 5 strTmp gcbCms400ContentXml Item Xslt5 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 gcoCms3400ContentXml Web Service to retrieve any XSLTs assigned to the content If no XSLTs are Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 149 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 tro 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
100. mple 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 7 Revision 11 139 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 Recur
101. n lists the title of every content block in the collection See Also Example of ecmNavigation Display on page 87 ecmTeaser lists the title of every content block in the collection plus the content summary See Also Example of ecmTeaser Display on page 87 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 86 Ektron CMS400 NET Server Controls Property Description Data Type Hide Used to hide output of collection in design time Boolean and run time True Hide collection False Display collection 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 Random Set to True if you want to randomly display one Boolean collection item The
102. n 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 generation
103. n contact the sales department by sending an e mail to 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 7 Revision 11 160 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 7 Revision 11 161
104. n CMS400 NET Developer Reference Manual Version 4 7 Revision 11 105 Ektron CMS400 NET Server Controls Using a Stylesheet The stylesheet must be located in the site root You can only define one menu stylesheet for each web page If you have more than one menu on a single Web page they share the stylesheet You can create your own stylesheet or modify the existing default one This lets 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 will insure you always have a clean file to start with This will also give you something to reference if you are not getting the results you expect The following is a list of the style sheet properties that can be modified in the pop_style css Property Description Attribute Default Value lowText Defines the text of e color e 000000 Black the floating menu as it is displayed e font e 12px Arial sans serif on theimenur e text align e left e text decoration e none highText Defines the text of e color e 000000 Black the floating menu when highlighted e font e 12px Arial sans serif e text align e left e text decoration e none roothighText Defines the text of e color e 000000 Black the root menu as displayed on a e font e 16px Arial sans serif Web page e text align e center e text deco
105. n introduces some background information about using Microsoft 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
106. nce 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 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 7 Revision 11 148 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 a demonstration 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 StrHTML 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 strT
107. ng for the table In the following example we choose table columns Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 117 Ektron CMS400 NET Server Controls 1 In Web form design right click the DataGrid and choose Property Builder verece 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 Reference Manual Version 4 7 Revision 11 118 Ektron CMS400 NET Server Controls 3 Choose the fields for the custom table from the available columns DataGrid Properties C General 7 Create columns automatically at run time F Columns ON l g Paging Available columns Selected columns AA Format Data Fields A Title Borders All Fields EJ QuickLink EJ LastEditorFname Em EJ DateModified x lel 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 t
108. nseeenseeensees 134 The CMS400 NET Content Sample Page cccceeeeeeeeeees 138 Sample Output trom One Methodisme 142 The News aspx Sample MON XML cccceseseeeeeeeeeeeeeeeeeeneeeeee 143 The News aspx Sample XML ccccccccseseeeeeeeeeeeeeeeeeeeeeseaeeeees 146 Creating a Page that Provides a Web Service s 000 151 Syndicating Web Content aS RSS cece ceseseeeeseeeeeeeeeees 153 What is RSS SynGleaon siccistcctesicsseasersatessasorestacereeretedensacans 153 WEISS OPECIN ON nerriet oE ATOA 153 RSS Syndication in Ektron CMS400 NET ccssessseesseeens 154 Syndicating Via NE Ticusarcniessn 155 Architecture of RSS Syndication ccceecessseeeeeesseeeeeeeeees 155 ASPX pago Sacis iienaa E eE TETEE AEE 155 Creating Your Own aspx Collection Page csssccssseee 155 Sea E Cy E E T O TA PEE EA EA 156 E e E AA A E E A ET 156 Creating Your Own aspx List Summary Page csssce 156 SU a E P E T A T E T T E 157 EXIM Os nuanian a 157 Learning About Visual Studio NET 0008 158 Grid Layout vs Flow Layout sssssnnsenennnnnnnnunnnnnnnnnnnnnnnnnnnne 158 Additional Information ccccsseeseeeeeeeeeeeeeeeeeeeeeeeeseneeees 160 Suppo rting DOCUMEN S gic cnscicincccisicensccrssonseccceenscccnseacasecensaenes 160 SUD OCU iiinn 160 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 vi SalOS sy eiisecicasecersasrvessies
109. nu Server Control calls a menu to be displayed on a page Using the Menu Server Control you can manipulate a menu by using the 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 7 Revision 11 95 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 96 e Menu Server Control Properties on page 97 e Using DisplayXslt Samples on page 98 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 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 behin
110. o 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 Ce Search All the words C 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 50 e Search Server Control Properties on page 51 e Search Server Control Property Example on page 54 e Text Box Examples on page 56 e Button Image Source Examples on page 57 e Search Button Text Examples on page 58 e Display Examples on page 59 e ShowDate Examples on page 59 e Specify Search Control To Display Search Results on a Separate Page on page 60 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 50 Ektron CMS400 NET Server Controls IndexSearch Server Control see IndexSearch Server Control on page 63 Search Server Control Properties The following table explains the properties of the Sear
111. ock 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 Rt International Home Products Support News Careers Search Calendar The following table explains how to complete the ContentBlock 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 41 Ektron CMS400 NET Server Controls Property Value 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 DefaultContentID The ID of a content block that appears where you 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 Integer DynamicParameter Select id When you do thi
112. on Data Type Values Recursive Determines if the display Boolean True includes content blocks in child False folders of the selected folder List Summary Example Below is an example of the List Summary Server Control properties E 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 marketing News folder e MaxResults Unlimited results appear 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 83 Ektron CMS400 NET Server Controls OrderKey Property The OrderKey property determines what information appears to the right of the hyperlinked title The values are described below Value Description Web Page View DateModified Displays the date the comen WAS last imipoMned RC Sportster The RC Sportster is design nid level RC racer currently on the market nferdoce 6 27 2002 2 eda oe 44 PM growing host the 3rd sa RC poe
113. ontrol 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 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 7 Revision 11 48 Ektron CMS400 NET Server Controls Pro
114. perty Value Data Type Include Tags Determines if tags are generated automatically of Boolean manually See Also Automatic versus Manual Generation of Form Tags on page 49 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 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 Let Ektron CMS400 NET generate form tags automatically A pure script aspx page Set Include Tags property to True Modify HTML form tags in the aspx file An aspx page and associated code behind web form Set Include Tags property to False Here is the default NET generated form tag lt form id Forml method post runat server gt Modify the form tag as indicated in red lt form id Forml method post runat server OnSubmit EkFmValidate this gt Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 49 Ektron CMS400 NET Server Controls Search Server Control The Search Server Control displays a text box with a search button on the template T
115. price performance ration is simply incredible stated 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 134 to find the type of content and the kind of information that is available about it For
116. 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 li gt lt li gt Excellent written and oral communication skills lt li gt lt li gt Ability to work with very little supervision lt 1li 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 7 Revision 11 142 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 Xsl lt Xsl lt Xs lt Xs lt Xsl t1 gt C Inetpub wwwroot CMS400Example XMLFiles xslt rce_jobs_display xsl lt Xslt1 gt t2 gt lt3 gt lt4 gt t5 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 ne
117. 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 page 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 87 ecmTeaser lists the title of every content block in the folder plus the content summary See Also Example of ecmTeaser Display on page 87 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 7 Revision 11 65 Ektron CMS400 NET Server Controls Property Description Data Type Values EmptyResultMsg The message that displays
118. ration e none Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 106 Ektron CMS400 NET Server Controls Property Description Attribute Default Value itemBorder Defines border color and size on the menu e border e 1px solid 666666 itemBorderBlank Defines border color and size on the menu e border e 1px solid CCCCDD For more information on stylesheets visit http www w3 org Style CSS MetaData Server Control The Metadata Server Control lets you add the metadata from 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 107 e MetaData Server Control Properties on page 107 e Using the MetaData Server Control on page 108 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 MetaDataList Server Control see MetaDataList Server Control on page 110 MetaData Server Cont
119. ring 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 Begin 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 7 Revision 11 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
120. rol Properties The Metadata Server Control properties are described in this table Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 107 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 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 DynamicParameter Gets or sets the QuerySitring parameter to read a String content ID dynamically Hide Used to hide a Metadata Server Control in design t
121. rom 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 113 Ektron 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
122. s If set to false the search box does not appear on PostBack Boolean Text Box Size Search Server Control Property Example The size of the display text box for user input The width is based on the number of characters Integer Text Box Examples on page 56 The following example places a text field and a search button ona template Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 54 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 7 Revision 11 55 Ektron CMS400 NET Server Controls Text Box Examples Value Web Page
123. s 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 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 To make this content block dynamic select id When String you do this server control uses the content block passed as a URL parameter Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 43 Ektron CMS400 NET Server Controls Property Value Data Type 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 design time in Visual Studio and does not affect the site Content on the site is managed by a cookie va
124. s 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 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 OverrideXslit 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 The following example shows how the ContentBlock Server Control can be used to pass the id as a URL parameter Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 42 Ektron CMS400 NET Server Controls El Authenticated False DefaultContentID 1 DisplayXslt DynamicParameter id Hide False Language 1033 OverrideXslt 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 doe
125. s 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 Address 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 7 Revision 11 19 Ektron CMS400 NET Server Controls To access additional properties use the same syntax you use for standard properties but add ckitem Or 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 Con
126. s the metadata in the source MetaData Server Control of the Web page displaying the on page 107 content Menu Customizes the DHTML menus DhtmIMenu Server Control feature on page 101 Search Inserts a text box with a search Search Server Control on button in the template When the page 50 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 7 Revision 11 125 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 content block Pass
127. server gt lt asp DataGrid gt Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 158 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 7 Revision 11 159 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 Ektro
128. sion 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 Close Login Logout Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 1D 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
129. sive Search Defines whether search is recursive 1 recursive search 0 non recursive search Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 140 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 7 Revision 11 141 Web Services Parameter Where How Implemented by CMS Defined i
130. t a gt Next Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 bulleted 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 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 1i 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 featur
131. tava aa ee 160 aliied faite lite Meninin 160 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 vii Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 server 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 7 Revision 11 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
132. tch 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 Boolean True display every content block that matches at least one search criteria False show only content blocks that match all search criteria xmlConfigID ID of the XML configuration whose indexed fields will appear on the search screen Integer 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 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 Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 69 Ektron CMS400 NET Server Controls 1 To activate the window click the gray box in the SearchParmXML property SearchParmxML ia 2 The Build Search Parameter screen appears Ektron CMS400 NET Developer Ref
133. thods are demonstrated on the sample page webroot CMS400Example cms400scripts ContentwsS asmx For more information see The CMS400 NET Content Sample Page on page 138 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 7 Revision 11 135 Web Services SingleSummary ecmSingleSummary Sing
134. 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
135. tomize 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 90 Collection Displays links generated by collections Collection Server Control on page 84 ContentBlock Displays and manages a content block ContentBlock Server Control on page 38 DhtmIMenu Displays a drop down menu with submenus DhtmlMenu Server Control on page 101 FormBlock Displays a content block that is associated FormBlock Server Control on with a form page 47 IndexSearch Perform XML index searches on XML IndexSearch Server Control on content page 63 For information on using XHTML Search see the following Search Server Control on page 50 LanguageAPI Allows developers to force a language for a LanguageAPI Server Control on Web site page 36 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 79 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 95 to display the menu Ektron CMS400 NET Deve
136. trols 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 EkIten End Sub F Comment a 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 7 Revision 11 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 arch
137. tster is designed to compete with the entry and 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 143 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 asc DateModified 0 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 7 Revision 11 146 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
138. ual Version 4 7 Revision 11 80 Ektron CMS400 NET Server Controls 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 87 ecmTeaser lists the title of every content block in the folder plus the content summary See Also Example of ecmTeaser Display on page 87 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 7 Revision 11 81 Ektron CMS400 N
139. vanecesteeses Ektron CMS400 NET Server Controls cccssceee Standard ASP NET Methods cccccccceeceeceeceeeeeeeeeeeeees WED SOPVICES nriiiersssii i n aa Syndicating Web Content as RSS ssssseeeeeeeeeeeees Learning About Visual Studio NET sssssssssssssnssssnsnnnnns Additional Information 2 c0sceceeeececeececeececeeeeceeeeeeees Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 iii Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 Detailed Table of Contents What s New in the 4 7 Release ccccccssseseeeeeeeenseeeeeeeees i ADOUt TRIS WIAA ssa seccssssncsseastissssassrsntitercciaeenecsemnccaian 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 iczcerzes etcsaccctsceicsaleacencentestesaumsatcee ra Updating the Server Gontrels ccissiccatscesazspcdcndesepapaicecsasinntacstecenmmencaunas 7 Inserting Server Controls Using Drag and Drop 0ess1 7 Adding a Server Control to a Template ccccceeeseeeeeeeeeeeeneeees 7 Builth Projet EA A E A A 11 Inserting Server Controls Programmatically s sceee 11 Steps to
140. veloper Reference Manual Version 4 7 Revision 11 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 Toolbox 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
141. word 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 7 Revision 11 126 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 Add Content E
142. ws sample NET page news aspx which 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 7 Revision 11 143 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 iId StrHTML Replace strHTML asp aspx NewsInfo InnerHtml strHTML Else strHTML wsCms400WebService ListSummary Marketing News 0 1 Title asc DateModified 0 strHTML Replace
143. xample 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 RAEN 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 7 Revision 11 127 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 7 Revision 11 128 Standard ASP NET Methods Teer io R aCA D Content a s0 Human
144. y Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 60 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 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 7 Revision 11 61 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
145. y 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 LanguageAPI Server Control The LanguageAPI Server Control lets a developer force a Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 36 Ektron CMS400 NET Server Controls 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 37 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 LanguageSelect see LanguageSelect Server Control on page 35 LanguageAPI Server Control Properties The LanguageAPI Server Control properties are described in this table NOTE The
146. z k tr on __ Redefining Web Content Management Ektron CMS400 NET Developer Reference Manual Version 4 7 Revision 11 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 7 Revision 11 March 25 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

Ektron CMS400.NET Developer Reference Manual

Contents

Download Pdf Manuals

Related Search

Related Contents