Home

Livelink Integration Manual

1. Fig 37 Specifying the Livelink system Selecting the Livelink folder In this dialog box you select a Livelink folder The subfolders and docu ments contained in this folder will be integrated in the WCM system 140 Livelink WCM Server Livelink Contents in the Content Client Livelink WCM Server Content Client Microsoft Internet Explorer oj x Please select a Livelink object Livelink Enterprise Eg Accounting amp Finance 5 Company News Channel Eg Company wide Discussions E Development Eg Human Resources B E Training E Presentations B E Tutorials E E T m T Advanced Training Advanced Training Lessons Advanced Training Solutions Basic Training Basic Training Lessons Basic Training Solutions ix lt Back Next gt Ok Help Fig 38 Selecting the Livelink folder E EEOEFEHOR Confirm by clicking the Next button Specifying the version of the Livelink folder The Livelink folder that the Livelink folder relator refers to may be subject to change In this dialog box you determine how the Livelink folder relator reacts when the Livelink folder changes Note For each object in the Livelink folder a separate relator is created The setting that you make here initially applies to all relators However you can subsequently change this setting for individual rela tors see section Modifying Livelink Metadata on page 155 Livelink
2. Problem If the temporary directory contains many files during normal operation the files are possibly not moved to the XML Activator directory Procedure 1 Check whether the WCM server managing the collection has access to the XML Activator directory and the temporary directory 2 Check whether it is possible to move files from the temporary direc tory to the XML Activator directory Problem If the XML Activator directory contains many files during normal opera tion the XML Activator process might not be running Procedure 1 On the Livelink Administration page select the Browse the System Object Volume link in the Search Administration section 2 Select the Slice Name Data Source Folder link 216 Livelink WCM Server Livelink Search in the WCM System 3 Select the Slice Name Data Flow Manager link 4 Check whether the requests are being processed 5 Make sure that the slice takes the data from the same directory the collection uses for writing the XML Activator files Livelink Integration Manual 217 218 Livelink WCM Server Glossary API Application Programming Interface Livelink WCM Server offers various APIs to access the functionalities of the WCM servers the WCM Java API the remote API the Portal Manager API and WCM WebServices Check in Staging action of Livelink WCM Server An object that has been checked out and edited is returned to the WCM system by the action Ch
3. WCM Region Definitions for Livelink Index REGION VIPoid FROM lt VIPoid TO lt VIPoid gt REGION VIPwebsite FROM lt VIPwebsite TO lt VIPwebsite gt REGION VIPdeploymentsystem FROM lt VIPdeploymentsystem TO lt VIPdeploymentsystem gt REGION VIPcollection FROM lt VIPcollection TO lt VIPcollection gt REGION VIPtitle FROM lt VIPtitle TO lt VIPtitle gt REGION VIPsubtitle FROM lt VIPsubtitle TO lt VIPsubtitle gt REGION VIPkeywordlist FROM lt VIPkeywordlist TO lt VIPkeywordlist gt REGION VIPdescription FROM lt VIPdescription TO lt VIPdescription gt REGION VIPurl FROM lt VIPurl TO lt VIPurl gt REGION VIPpath FROM lt VIPpath TO lt VIPpath gt You will find a file named xml tok containing these entries in the directory WCM installation directory examples livelinksearcnh Livelink Integration Manual 177 Chapter 5 All entries for a REGION must be located in a single line The regions VIPoid and VIPcollection are mandatory The other regions can be used for extended search functions Creating an XML Activator Producer Data Flow in Livelink You create an XML Activator Producer data flow to index information generated by a third party application such as the WCM system To create an XML Activator Producer data flow in the Livelink system 1 Open the Livelink Administration page The URL is of type http livelink
4. 7 gt 8 lt form action VIPURL method post gt Livelink Integration Manual 97 Chapter 3 9 Name lt input type text name user gt lt br gt 10 Password lt input type password name pwd gt lt br gt 11 lt input type submit gt 12 lt form gt 13 lt 14 else if user null amp amp pwd null 15 16 sessionBean checkLogin request user pwd 17 gt 18 lt jsp forward page List jsp gt 19 lt 20 21 gt We recommend that you use the JSP tag lt jsp forward gt cautiously as this function is only available if no data has been returned to the browser yet Alternately you can use the following JavaScript command to force forwarding in the browser lt script lLanguage JavaScript gt location href List jsp lt script gt Displaying the Content of Livelink Objects show jsp For displaying the content of a Livelink object you can use the methods hasContent and getContent from the LivelinkObject interface The node ID of the document to display is passed as a parameter to the JSP page Based on the MIME type associated with the object the system diverts the returned output stream 1 lt jsp useBean id 110bjBean scope session class de gauss vip portalmanager LivelinkObjectBean gt lt initialize bean 110bjBean init request Getting request parameter and instantiating Livelink object String nodeStr request getParameter nodeld if n
5. LivelinkId parentId new LivelinkId Integer parseInt dId newObj 110bjBean createTopic parentId subject null comment else LivelinkId parentId new LivelinkId Integer parseInt nId newObj 110bjBean createReply parentId subject null comment LivelinkId newLLId newObj getLivelinkId String url reply jsp discussionId dId amp nodeId newObj getLivelinkId getNodelId if type LivelinkObjectType SUBTYPE_TOPIC url amp topicId newObj getLivelinkId getNodelId else url amp topicId tId lt script lLanguage JavaScript gt Livelink Integration Manual 119 Chapter 3 26 27 28 29 Location href lt url gt lt script gt lt Scenario Providing Discussion Results as a FAQ You want to use discussions that will not be changed anymore to publish FAQs in your intranet The discussion topics are used to formulate ques tions the corresponding answers are created on the basis of the discus sion replies This example also shows the interaction between Java on the server side and JavaScript on the client side N OANDU PW 11 12 13 14 15 16 17 18 19 lt h1 gt VIPTITLE lt h1 gt lt p gt Please select a question The answer s will be listed on this page lt p gt lt table border 0 width 100 cellpadding 0 cellspacing 1 gt lt tr gt lt td bgcolor white gt lt b gt Questions lt b gt lt b
6. 2 Login to the Content client and select the website that you want to edit 3 In the Navigation area mark the relator that you want to release 4 Choose Object gt Release or click the appropriate icon Icon for releasing an object The changed relator is now visible in the published website Livelink Integration Manual 153 Chapter 4 Modifying the Content of a Relator Objective Relators refer to objects in the Livelink system You can use the Content client to modify the content of Livelink objects Prerequisites The relator has the status changed rejected released or delayed release The option Update Edit version automatically is selected for the relator You have the access rights Read and Change object for the relator You have the permission Reserve for the Livelink object Procedure 1 154 Launch the Content client The URL of the Content client is of type htto wcomserver company example cmsclient index jsp Log in to the Content client and select the website that you want to edit Change to the Edit view of the website by choosing Tools gt View gt Edit view In the Navigation area mark the relator whose associated Livelink object you want to edit Choose Edit Check out or click the appropriate icon a Icon for checking out an object Livelink WCM Server Livelink Contents in the Content Clie
7. Oe amp amp ee ee g Fig 9 Assignments of a user in the Admin client You can make the following assignments for a user The overview shows the icons for creating and removing assignments between the items z3 Groups You can assign users to certain groups Users will E Ey receive the rights of the respective group s Roles You can assign users to certain roles Users will 4 G receive the rights of the respective role s Livelink Integration Manual 37 Chapter 2 a Functional areas The functional areas are used to deter vA va mine which types of WCM objects the users may add check out and check in as well as which dialog boxes and func tions are available in the Content client You can assign functional areas to each user individually Websites If you assign a website to a user this user can w wW access the objects of this website via the Content client The exact access rights depend on the user s membership in groups or roles the user s functional areas and on the rights settings of the individual WCM objects Default object rights For each user you can set the default object rights for editing WCM objects These settings are used as preset access rights when a user is added to the list of persons authorized to access an object in the Content client Administration rights Here you determine the users rights for the admin istration of the WCM system
8. 2 Login to the Livelink system as an administrator Note Both user ID and password are case sensitive Correct use of uppercase and lowercase letters is essential For Livelink Admin and admin are two different users 3 Choose Users amp Groups on the Enterprise menu The Users and Groups page opens Aspects of common user administration Due to the different concepts behind the Livelink and the WCM user administrations there are restrictions and differences when compared to the usual handling of the Livelink user administration For administrators used to working with the Livelink user administration the following table provides an overview of these differences Table 3 Notes on managing users with Livelink User administration item Description Adding users User privileges Provided that the user has the Livelink privi lege Log in enabled the user can also log in to the WCM system as the WCM Access check box is selected by default In the WCM system the user initially has the access rights Read and Read Production Livelink Integration Manual 55 Chapter 2 User administration item Description User name and log in name E mail address A WCM user must have a name in addition to the user ID For users who only have a log in name in Livelink the log in name is used as both the user ID and the name in the Admin client Live
9. Glossary generated files to the appropriate directories second notifying the WCM servers of changes in the WCM system Deployment system The deployment systems generate pages from the WCM objects and distribute the generated files to the appropriate directories From there the files become visible for the users via an HTTP server Deployment systems may be of various types and categories Deployment system category Depending on the way of processing deployment jobs deployment systems are assigned to various categories Standard deployment systems automatically generate a new page every time a WCM object is changed The generated pages are stored in the file system Dynamic deployment systems generate the pages on the basis of user defined settings and only when the page is requested via the HTTP server The generated files are stored in a flat file structure By means of Search engine deployment systems you can prepare your website data for use with a search engine WebDAV deployment systems are required for the use of WebDAV clients InSite Editing deployment systems provide the basis for editing and adding content directly in the website without the Content client Deployment system types On the basis of the staging concept of Livelink WCM Server a distinction is made between deployment systems of type Edit QA and Production Different views of the website data are generated depending on the type
10. In Livelink you cannot manage additional information such as the e mail address for groups This means that you have to use the Admin client to edit WCM specific information of groups and roles The procedures for managing groups and roles in the Admin client are identical and are therefore described together If you open the main item Groups or Roles in the User administration view the available groups or roles are shown in the tree on the left 40 Livelink WCM Server Common User Administration D User administration p Users B Groups L Board B DefaultGroup B External HumanResources B Marketing J B OfficeManagement B ResearchDevelopment B Sales E B Training m L3 WebsiteAdmin H a Fig 10 Stored groups in the Admin client The following functions are available to you for managing groups and roles m adding a group or role see the following section m changing the e mail address or the WCM access of groups or roles see Editing Group or Role Information in the Admin Client on page 43 m editing the assignments of a group or role see section Modifying the Assignments of a Group or Role in the Admin Client on page 43 m removing a group or role from the user administration see section Deleting a Group or Role in the Admin Client on page 46 Note Changes to a group or role do not take effect in the WCM system until the c
11. Please enter the parameters of the Search servers to x be installed Content Miner Livelink Lucene Add Search server Remove Search server Help Cancel Back Fig 54 Search servers in the WCM installation program 1 Click the Livelink tab 190 Livelink WCM Server Livelink Search in the WCM System 2 Click the Add Search server button This opens a tab on which you can make the settings for the Livelink Search server fad Livelink Web Content Management Server 9 5 0 xj Search server Please enter the parameters ofthe Search servers to 4S be installed K Content Miner Livelink Lucene Livelink_SearchServer Name Livelink_SearchServer Host name Port URL xample Livelink livelink exe v Use URL for connection User Admin Password p Name ofthe assigned server Master_Content AA Add Search server Remove Search server Fig 55 Installing Livelink Search servers Name name of the server You have a free choice of name but it must be unique within the WCM system The following charac ters are permitted a z A Z 0 9 ASCII 7 Bit dot hyphen and _ underline Livelink Integration Manual 191 Chapter 5 Host name fully qualified name of the computer hosting the Livelink server which is to perform the indexing and to process the search requests Port connection port on the Liveli
12. j 25 retrieving reply 26 LivelinkId tReplyId LivelinkId ans get j 27 LivelinkDiscussionEntry tReply LiveLinkDiscussionEntry 110bjBean get tReplyId 28 if tReply null 29 String con tReply getName lt b gt lt br gt 30 con tReply getContent 31 con de gauss util StringOperator replace con n lt br gt 32 str append lt b gt A con lt br gt 33 34 35 str append 36 37 38 gt 39 lt td gt lt tr gt lt table gt 40 lt div id question style display none visibility hidden gt amp nbsp lt div gt 41 lt div id answer style display none visibility hidden gt amp nbsp lt div gt Livelink Integration Manual 121 Chapter 3 The last part of the code contains the JavaScript which switches the answers After the composed array has been written on the page the function for switching is defined When the user clicks a question this function is called First the DOM elements of the HTML page which must be replaced are retrieved and set to visible After this the node IDs of the question and the associated answer are retrieved based on the selected element A DOM manipulation is performed to exchange the information on the page 42 lt script lLanguage JavaScript gt 43 lt str toString gt 44 array with answer to given questions will be initialized during page creation 45 var
13. onClick javascript window close gt lt td gt 28 lt tr gt lt table gt lt form gt 29 Adding the Document create jsp The create jsp page adds the Livelink document to the folder The page extracts all required parameters from the request object and adds the corresponding Livelink document The ParseMultiFormData class which is part of the Portal Manager API is used for extracting the data OutputStream outS null InputStream inS null LivelinkObject llobj null try ParseMultipartFormData is used to analyze the request of the field input file DU BWNP 106 Livelink WCM Server 10 11 12 13 15 16 17 18 19 20 Livelink Functions in a Website ParseMultipartFormData parseMFD new ParseMultipartFormData request Get the form data String returl parseMFD getParameterValues returl 0 String title parseMFD getParameterValues title 0 String comment parseMFD getParameterValues comment 0 String topicStr parseMFD getParameterValues filetopic 0 int folderId Integer parseInt topicStr The content type is analyzed Extract the file name with parseMFD use java io File to get its name without path and suffix File file new File parseMFD getParameterValues fileinput 0 String fileName file getName determine parent id LivelinkId parent new LivelinkId folderlId The WCM Java API provides functions for retrieving informat
14. Dynamization All or part of the content of a website is not generated until runtime Edit view In the Edit view of Livelink WCM Server the objects of a website are created and edited Here the most current status of the objects is visible Extranet Information platform based on Internet technology for business communication with authorized external users e g partners or customers 220 Livelink WCM Server Glossary Firewall Hardware or software that monitors the data flow between a public and a private network and protects networks against unauthorized access Livelink WCM Server supports architectures protected by firewalls Group Collection of users for which specific access rights can be defined User groups are usually tied to organizational units such as departments and projects Java Object oriented programming language developed by Sun Microsystems and used especially in the field of Internet technology Security aspects and platform independence are the basic philosophies of Java JavaScript Scripting language for integrating executable scripts in HTML pages JavaScript can be used to incorporate plausibility checks and calculation functions in forms JSP JavaServer Pages HTML files with specifically identified embedded Java programs that are converted into servlets by using the JSP engine and then executed on the web server The result is then sent to the client in normal HTML format wit
15. Integration Manual 141 Chapter 4 y Livelink WCM Server Content Client Microsoft Internet Explorer Check whether you selected the right Livelink folder Specify the version Livelink ID E en Nodeld 5246 When a Livelink folder relator is added all subfolders and documents within this folder are also added as relators Thus many objects may i be added to the website The selected Livelink Folder contains at least 6 documents which will be imported Version Update Edit version automatically P Fixed version Cancel lt Back Fig 39 Specifying the version of the Livelink folder relator Livelink ID Livelink ID of the selected folder The Livelink ID is composed of the name and the ID of the folder in the Livelink system You cannot change this entry m Update Edit version automatically f you click this radio button the Edit view of the Livelink folder relator will be automatically adapted whenever the metadata of the associated Livelink folder change If an object is added to the Livelink folder a new relator representing this object is automatically created If an object is removed from the Livelink folder the associated relator will be deleted 142 Livelink WCM Server Livelink Contents in the Content Client For the changes to become visible in the published website you must submit the changed relator which then must be released by Quality Assurance se
16. Livelink WCM Server Integration Manual This manual describes how to integrate your WCM system with a Livelink system It provides information on the following topics e setting up access to the Livelink user administration for the WCM system e using Livelink functions in a website e managing Livelink contents in the Content client e using the Livelink search engine for a website OPEN TEXT Mindt Working Together TO RP OC R A T IGN Copyright 2006 by Open Text Corporation The copyright to these materials and any accompanying software is owned without reservation by Open Text Corporation These materials and any accompanying software may not be copied in whole or part without the express written permission of Open Text Corporation Open Text Corporation is the owner of the trademarks Open Text Great Minds Working Together Livelink and MeetingZone among others This list is not exhaustive All other products or company names are used for identification purposes only and are trademarks of their respective owners All rights reserved Open Text Corporation provides certain warranties and limitations in connection with the software that this document describes For information about these warranties and limitations refer to the license agreement entered into between the licensee and Open Text Corporation Contacting Us Open Text Corporation Corporate Headquarters 275 Frank Tompa Drive Waterloo Ontari
17. 2 Choose Assign pool on the context menu or click the corresponding icon lt lt Icon for assigning a pool to a server 3 In the Select pools dialog box mark the desired pool Select pools xi Name company partner N ooo Cancel Fig 31 Assigning the Livelink pool to the master Content server 4 Confirm by clicking the OK button Livelink Integration Manual 85 Chapter 3 Configuring Multiple Livelink Systems You can configure Livelink WCM Server to set up connections to several physical Livelink systems or connections to different entry points in the same Livelink system The following steps are required 1 Add Livelink pools 2 Assign the Livelink pools to Content servers 3 Shut down the WCM servers 4 Modify the livelink systems xml file 5 Start the WCM servers The individual steps are described in the following sections Adding Livelink pools In the Admin client add a separate Livelink pool for each Livelink system that you want to integrate and for each entry point respectively See Adding a Livelink Pool on page 84 Assigning the Livelink pools to Content servers Assign the individual Livelink pools to the corresponding Content servers See Assigning the Livelink Pool to the Master Content Server on page 85 Shutting down all WCM servers 1 In the Admin client select System administration Active servers 2 Choose Set run level for all ser
18. 73 internal collection Enterprise Server 9 2 1 182 internal collection Enterprise Server 9 5 0 197 Livelink object as WCM object 131 relator 134 relator with Livelink document 144 role Admin client 42 user Admin client 34 user Livelink 61 news 109 P permissions for searching 203 in Livelink 94 Livelink WCM Server poll on website application example 123 Portal Manager API 91 beans for Livelink integration 91 preparations for using Livelink functions 82 principals find Admin client 31 find Livelink 57 manage Admin client 26 manage Livelink 54 Q Query 214 R relator 131 add 134 add with Livelink document 144 configuring automatic synchronization 82 delete 163 edit content 154 edit metadata 155 find after change 150 integrate metadata 159 release 153 submit 152 update manually 162 release relator 153 remove functional area 52 group Admin client 46 group Livelink 79 group from group Livelink 79 role Admin client 46 user Livelink 71 user from group Livelink 79 users Admin client 39 Livelink Integration Manual Index RemoveCollection 213 roles administration rights 45 assign functional areas 51 assign websites 52 assignments Admin client 43 delete Admin client 46 manage Admin client 40 new Admin client 42 settings Admin client 43 S search add collections Enterprise Server 9 2 1 182 add collections Enterprise Server 9 5 0 197 in the Cont
19. 93 159 208 209 209 210 211 212 213 214 10 Livelink WCM Server CHAPTER 1 Introduction Livelink Web Content Management Server Livelink WCM Server for short is a user friendly highly scalable and adaptable content manage ment system for setting up and managing sophisticated and high perfor mance intranet and Internet solutions Thanks to the integration with Open Text Livelink Enterprise Server Livelink for short a comprehensive enterprise content management solution has been developed which covers all aspects of collaboration for creating managing and publishing content in intranets extranets and the Internet LELTE Content The main features of the integration are described briefly below Livelink Integration Manual 11 Chapter 1 Common user administration By integrating the web content management system WCM system for short with Livelink you can use the Livelink user information for both systems The user data will be stored in Livelink For managing principals users groups and roles you can either use the Livelink user administra tion or the Admin client of the WCM system Managing users belongs to the tasks of system administrators If you are a system administrator read about this topic in chapter 2 Common User Administration Publishing Livelink objects in a website You can use JSP pages to easily and conveniently publish Livelink objects such as folders document
20. Change metadata Read Move and copy Change metadata for the source object Copy object Read Move and copy Change metadata for the source object Insert object after cutting or copying Read Create for the target topic Livelink WCM Server Common User Administration Action Required object rights Check access rights of object Change access rights of object Read Read Change rights Change metadata Release or reject object Read Release Release object directly Read Change object Destroy object Read Release Additional information on the WCM tab The lists of websites and functional areas are updated every time the WCM Administration server is started and the configuration is changed For this reason the WCM tab does not display any websites and functional areas directly after installing the WCM User Administration module The list will not be updated before you install the WCM system and create websites m You can add functional areas with the Admin client Livelink initially shows the internal names of these custom functional areas To display the names of the functional areas in the user s language create translations with the Livelink Builder Deleting a User in Livelink The Admin user and all users with the privilege User administration rights are allowed to delete any user Also users with the privilege Can creat
21. Integration Manual 27 Chapter 2 Aspects of common user administration Due to the different concepts behind the Livelink and the WCM user administrations there are restrictions and differences when compared to the usual handling of the Admin client For administrators used to working with the Admin client the following table provides an overview of these differences Table 1 Notes on common user administration with the Admin client User administration item Description Adding users User privileges User name A user added with the Admin client has the Livelink privileges Log in enabled and Public Access enabled and is assigned to the default group The Admin client provides only the field Name for the user s name The contents of this field can be split up into the Livelink name compo nents First Name Middle Initial and Last Name For this purpose first name middle initial and last name must be separated by at least two spaces in the Admin client Example The entry Joshua two spaces F two spaces Stein in the Name field of the Admin client is split up as follows in Livelink First Name Joshua Middle Initial F Last Name Stein Editing user information Finding users You can either use the user ID or the last name of the user for searching 28 Livelink WCM Server Common User Administration User administration item Description Groups
22. PowerPoint file Topic Word document XML document Frame Frame topic HTML template XML template Add check out and check in objects based on these object types Dynamic Assembled object ASP page ASP template ASP topic CGI script Form template JavaScript JSP page JSP template JSP topic PHP page PHP template PHP topic XSLT document XSLT template Form Form instance Add check out and check in objects based on these object types Livelink Integration Manual 67 Chapter 2 68 Workflow Workflow Assign workflows to objects remove work flow assignments Intelligent templates none Not used by default Direct release References dialog Access rights dialog required for compati bility with VIP 5e Work with the Direct release option View the References dialog box View the Access rights dialog box Livelink WCM Server Common User Administration Functional area Default assignment to View or function in View Subordinate objects View Object list View My objects View Template structure Import Search Livelink object type the Content client Log dialog none View the Log dialog box Filter standard Use the standard filters Filter edit Create and edit filters in the filter editor Note Additionally the functional area Filter standard is require
23. The synchronization process matches the WCM managed document set with the document set indexed by the Search server 4 Select System administration gt Search servers Search server name and mark the desired collection 5 Choose Synchronize collection on the context menu or click the corresponding icon g Icon for synchronizing an internal collection 6 Confirm the security prompts by clicking the Yes and OK buttons Adding an external collection for a Livelink slice To add an external collection that is based on a Livelink slice to the Livelink Search server in the WCM system 1 Select Configuration gt Search servers and mark the desired Search server 2 Choose New external collection on the context menu or click the corresponding icon a Icon for adding an external collection Livelink Integration Manual 199 Chapter 5 3 Use the wizard for adding an external collection For Livelink Search servers the following parameter is especially important Livelink slice name of the slice to be indexed Adding an external collection for another type of document set To add an external collection that is based on another document set to a Livelink Search server in the WCM system 1 Select Configuration Search servers and mark the desired Search server 2 Choose New extemal collection on the context menu or click the corresponding icon ras Icon for adding an external collecti
24. gt back lt a gt lt gt Integrating a Livelink Channel in a Website In Livelink you can add and manage News News are grouped to form a Channel The Portal Manager API provides functions for accessing these special Livelink objects You can create read and delete news and chan nels Channels A channel is a special type of a Livelink folder For this reason the LivelinkChannel interface is derived from the LivelinkFolder inter face An instance of type LivelinkChannel contains a list of LivelinkNews objects Two methods are available for retrieving news m getActiveNews returns a sorted list of LivelinkID instances The list contains only those IDs whose news have not expired yet The most current news item is on top of the list m getNews returns all i e also expired news items in an unsorted 108 list of LivelinkID instances Livelink WCM Server Livelink Functions in a Website News In order to retrieve information on a LivelinkNews object you can use the methods getHeadline getStory getUser getImageld etc from the LiveLinkNews interface The getAttachments method returns a list of attachments belonging to a news item The Javadoc contains a complete list of methods Use the createChannel and createNews methods from the LivelinkObjectBean to create new channels and news directly in the connected Livelink system Scenario The Public Relations department of your company wants t
25. manage Admin client 40 manage Livelink 72 new Admin client 42 remove group Livelink 79 remove user Livelink 79 set as group leader Livelink 77 set group leader Livelink 77 settings Admin client 43 settings Livelink 74 unset group leader Livelink 78 l index regions display 188 202 for the WCMS 177 make displayable Enterprise Server 9 2 1 187 make queryable Enterprise Server 9 2 1 186 make queryable Enterprise Server 9 5 0 202 installation automatic synchronization 82 common user administration 19 Livelink Search server Enterprise Server 9 2 1 173 Livelink Search server Enterprise Server 9 5 0 190 WCM Kernel Integration module 82 internal collection 182 197 Livelink Integration Manual Index add Enterprise Server 9 2 1 182 add Enterprise Server 9 5 0 197 synchronize 184 199 introduction 11 L ListSources 212 Livelink common user administration 19 search functions 57 Livelink browser application example 100 Livelink document add with relator 144 Livelink Enterprise Server 9 2 1 set up search 171 Livelink Enterprise Server 9 5 0 set up search 188 Livelink folder integrate content in website application example 95 Livelink folder relator 131 add 139 Livelink functions in a website 81 Livelink ID 137 Livelink metadata edit 155 integrate in page 159 WCM tags 159 WCM tags for standard metadata 159 WCM tags for user defined metadata 160 Livelink metadata dialog b
26. see sections Making Index Regions Queryable in Livelink on page 186 and Displaying Index Regions in Livelink on page 187 These settings are user specific For this reason we recommend that you configure a special user for the Livelink search Enter the infor mation of this user here For further information about permissions for the Livelink search refer to section Permissions for Searching on page 203 m Password password for processing search requests in the Livelink system Name of the assigned server the name of a WCM server that already exists or is to be installed and to which you want to assign this Search server 3 When you have completed all settings for the Search servers confirm the entries by clicking the Next button 176 Livelink WCM Server Livelink Search in the WCM System Preparing Indexing Step 1 Update the xmlactiv program For the Livelink Search server to index the data correctly the most recent version of the xmlactiv program must be executed in your Livelink system Copy the xmlactiv program from the directory livelinksearch operating system bin on the WCM CD to the directory Livelink installation directory bin Step 2 Add WCM regions to the xml tok file Add the following region definitions to the file Livelink Livelink installation directory config xml tok The entries must be inserted directly below the section Basic Open Text region definitions
27. 49 50 51 52 53 Adding members to a group in Livelink Group members in Livelink Setting a user as the group leader in Livelink The Module Administration section on the Livelink Administration page Website extension for Livelink Assigning the Livelink pool to the master Content server Selecting a new run level Specifying the Livelink system Selecting the Livelink object when adding a relator Specifying the version of the Livelink object Entering comments about the relator Specifying the Livelink system Selecting the Livelink folder Specifying the version of the Livelink folder relator Specifying title file and object type Specifying the Livelink system Selecting the Livelink folder Object filter in the Content client Filter results The Livelink metadata dialog box The category Training Materials in the Livelink system Interaction of components in the Livelink search Search servers in the WCM installation program Installing Livelink Search servers The Search Administration section on the Livelink Administration page Creating an XML Activator Producer Data Source Specifying the Livelink parameters for an internal collection The Start Options section on the Specific tab Livelink Integration Manual 76 77 78 83 84 85 87 135 136 137 138 140 141 142 145 147 148 151 151 157 161 170 174 175 179 180 183 186 Fig 54 Search servers in the WCM installation program 190
28. Conversion process Purge Message Logs Purge the log of system object alert messages From the Livelink database Test System Objects for Errors Test the data flows data flow processes and indexes in the System Object Volume Open the System Object Vajume Create and manage Livelink in s and administer Livelink Admin servers The Search Administration section on the Livelink Administration page the Open the System Object Volume link 4 Log in with the user information you specified when setting up the Livelink Search server see section Installing Livelink Search Servers in the WCM System on page 190 5 Onth e Livelink System page click XML Activator Producer Data Source on the Add Item menu 194 Livelink WCM Server Livelink Search in the WCM System General Information None Be internetsite fi 8200 Slice Replacement Processes Prefix Partitions Port available on all selected hosts XML Activator Information Host Default WINDOWS NT x Incoming Directory CAOPENTEXT index InternetSite_in CNOPENTEXT index InternetSite_write Write Directory Operation Tag foperation Identifier Tag bin o a Metadata List EI Intermediate Document Conversion Read Directory COPENTEXT index InternetSite_write Write Directory CAOPENTEXT index InternetSite_write Host Default WINDOWS NT Consumer Livelink Index Read Directory CAOPENTEXT index InternetSi
29. F etl Language English USA a eschmidt Substitute hshepard hshepard AE l E BB jgomez Substitute of gt jstein Password _ kblume D mmoreno A C Trusted login mrossi A i msanchez 3 vi WCM access pdeville smarchetti 4 D solivier 4 EP Groups 4 Roles i Apply Reset Help Fig 8 Modifying settings of a user in the Admin client 2 Make the desired changes For detailed information on the individual fields refer to the Admin client s online help 3 Click the Apply button 36 Livelink WCM Server Common User Administration Modifying User Assignments in the Admin Client By means of assignments you can assign a user to a group or role grant the user access to a website and set the user s default object rights and administration rights For general information on groups roles functional areas and rights refer to the Livelink WCM Server Administrator Manual chapter Concepts To open the assignments of a user select the respective user via User administration gt Users user ID and double click the user ID To modify the assignments use the toolbar or the context menu Z ser administration sers abianchi B a cerdmann claurent dearson eschmidt hshepard jgomez jstein EF Groups amp Roles Functional areas y Websites Default object rights 5 Administration rights
30. Group ResearchDevelopment jo004 Livelink Personal Enterprise Tools Help Workspace workspace 8 Log out B Contents Favorkes D Users amp Groups Settings O For This Page To add members to this group first find the users or groups you wish to add Modify Group Find User Last Name starts with Find D msanchez Delete Group Done j Copyright 1995 2003 Open Text Inc All right recerved Fig 25 Editing group information in Livelink 74 Livelink WCM Server Common User Administration You can do the following on the Edit Group page m adda user or subgroup to a group m set the group leader m change a group name m delete a member from a group Adding a member to a group in Livelink To add a new member user or group to a group in Livelink 1 On the Edit Group page click the Find amp Add link to display the Search bar in the right frame if not present 2 Use the Search bar to display the users or groups you want to add as new members to the group 3 Select the user s or group s Add to group check box Livelink Integration Manual 75 Chapter 2 Type Name LastName a Department Actions B Admin DefaultGroup I Add to group E abianchi Bianchi Board Add to group B kblume Blume Board I Add to group E dearson Carson External T Add to group B odevile Devile External I Add to group B cerdmanr rdmann HDevelopmer B ia X D daurent Laurent HumanResources I Add to group E
31. JSP page lists all available discussions which the logged in user is allowed to view The LivelinkObjectBean is used to find the discus sions Then the application iterates through the search results lt table gt lt int LLFilterId VIPLIVELINKID format nodeid BWNP Livelink Integration Manual 113 Chapter 3 5 define filter 6 String filter OTSubType LivelinkObjectType SUBTYPE_DISCUSSION 7 if 11FilterId 0 8 filter AND OTLocation 11FilterId 9 Search for all discussions and iterate through the result 10 RepositoryIterator iter 110bjBean search filter true 11 while iter hasNext 12 getting discussion object 13 LivelinkId temp LivelinkId iter nextKey 14 LivelinkObject tempObj 110bjBean get temp 15 if you have access to the object display the discussion 16 if tempObj null 17 display node 18 String navImgUrl VIPDEPLOYMENT_URL tempObj getImageUrl1 19 String title tempObj getName 20 gt 21 lt tr gt lt td valign top gt lt img src lt navImgUrl gt title discussion gt lt td gt 22 lt td class nav topic gt lt a href topic jsp discussionId lt temp getNodeld gt gt lt title gt lt a gt lt td gt lt tr gt 23 lt 24 25 26 gt 27 lt table gt 28 Displaying All Topics of a Selected Discussion topic jsp This page lists all topics of the selected Li
32. Livelink Integration Manual 187 Chapter 5 m VIPoid m VIPcollection Confirm by clicking the Update button Choose Search on the Tools menu Click the Display Options button N O on A On the Display Options page select the Display check box for all regions that are to be displayed At least the following regions must be marked m VIPoid m V IPcollection 8 Confirm by clicking the Save button Search Based on Livelink Enterprise Server 9 5 0 Note Livelink and the WCM system use a shared directory for exchanging data For this reason both the Livelink system and the WCM server to which the Search server is assigned must have write access to this shared directory The Livelink search can be used in different scenarios Scenario 1 Searching website contents Realizing this scenario requires the following steps in Livelink and the WCM system 1 WCM system Install Livelink Search server see the following section 188 Livelink WCM Server Livelink Search in the WCM System 2 Livelink system Create XML Activator Producer data flow see section Creating an XML Activator Producer Data Flow in Livelink on page 193 3 WCM system Add collections see section Adding an internal collection for WCM contents on page 197 4 Livelink system Start the XML Activator process see section Starting the XML Activator Process in Livelink on page 201 5 Livelink system Display
33. LivelinkWorkspace object Channel LivelinkChannel object channel News LivelinkNews object channel Discussion LivelinkDiscussion object discussion Topic LivelLinkTopic object discussion Reply LivelinkReply object discussion Project LivelinkProject object project 92 Livelink WCM Server Livelink Functions in a Website Milestone LivelinkMilestone object project Task LivelinkTask object project Task list LivelinkTaskList object project The LivelinkObject interface constitutes the basis for the other inter faces All interfaces mentioned above are directly or indirectly derived from LivelinkObject and thus inherit the methods of LivelinkObject Note When you add Livelink objects using the LivelinkObj ectBean of the Portal Manager API the LivelinkId of the parent object must be specified Please note that such a parent object must always be of type LivelinkFolder or must be derived from an object of this type Livelink users and groups Livelink users and groups can also be accessed via the WCM Java API Table 8 Livelink users and groups and their equivalents in the WCM Java API User LivelinkUser admin Group LivelinkGroup admin The LiveLinkUser and LivelLinkGroup interfaces are directly derived from the LivelinkPrincipal interface and thus inherit the methods of LivelinkPrincipal Livelink Integration Manual 93 Chapter 3 Livelink Permissions In order to read or add Livelink object
34. Members section of the Edit Group page click the name link of the user that you want to remove from the group 2 Click the Remove From Group button Deleting a Group in Livelink To delete a group in Livelink 1 2 Choose Users amp Groups on the Enterprise menu Use the search functions on the Users and Groups page to find the group Click the group s Edit link in the Actions column Click the Delete Group button Confirm the security prompt by clicking the OK button The deleted group is removed from all groups of which the group was a member The members are removed from the deleted group The users themselves are not deleted however If you delete a group which is the department group for some users these users automatically become members of the default group For this reason you should never delete the default group Livelink Integration Manual 79 80 Livelink WCM Server CHAPTER 3 Livelink Functions in a Website Livelink WCM Server provides simple and comfortable methods for accessing special Livelink objects such as folders documents channels and discussions and for publishing these objects on a website In the examples of this chapter WCM managed JSP pages are used to access the Livelink objects The Portal Manager API of Livelink WCM Server provides Java beans for programming such JSP pages The Portal Manager API is based on the WCM Java API which offers exten sive functions for acc
35. The associated Livelink object with the node ID 42 is a folder After this selected metadata of the documents contained in this folder is output in a loop 1 lt jsp useBean id 110bjBean scope session class de gauss vip portalmanager LivelinkObjectBean gt 2 lt 3 initialize bean 4 110bjBean init request 5 retrieve Livelink object instance 6 int nodeld 42 7 LivelinkObject lLlobj 110bjBean get new LivelinkId nodelId 8 if llobj null 9 get children of Livelink object and iterate through them 10 List 1 llobj getChildrenIds 11 for int i 0 i lt l size i 12 get an instance of the i th document in the folder 13 LivelinkId temp LivelinkId 1 get i 14 LivelinkObject tempObj 110bjBean get temp 15 if tempObj null 16 extract metadata to show 17 String comment tempObj getComment 18 LivelinkUser user tempObj getUser 19 gt 20 lt b gt name lt a href show jsp nodeId lt temp getNodelId gt gt 21 lt tempObj getName gt lt a gt lt b gt lt br gt 22 lt b gt comment lt comment gt lt b gt lt br gt 23 lt b gt created on lt tempObj getAttribute new StringValue createdate gt lt b gt lt br gt 24 lt b gt created by lt user getFirstName gt lt user getLastName gt lt user getName gt lt b gt lt br gt 25 lt hr gt 96 Livelink WCM Server Livelink Functi
36. Tools Help E Workspace T Workspace Log out E Contents Favorites G Users amp Groups Settings E For This Page Find UserLastName startswith O i Add New Item Type Name Last Name Department Actions B pem l l i DefaultGroup Edit Browse Groups a B bianchi Bianchi Board Edit Browse Groups D khume Blume Board Edit Browse Groups B darson Carson External Edit Browse Groups D odevi Deville External Edit Browse Groups D cerdman Erdmann ResearchDevelopment Edit Browse Groups D inmez Gomez ResearchDevelopment Edit Browse Groups D daurent Laurent HumanResources Edit Browse Groups D marchetti Marchetti Marketing Edit Browse Groups B mmoreno Moreno WebsiteAdmin Edit Browse Groups B solivier Olivier Training Edit Browse Groups D mosi Rossi HumanResources Edit Browse Groups B msanchez Sanchez ResearchDevelopment Edit Browse Groups D eschmidt Schmidt Office Management Edit Browse Groups B bshepard Shepard Marketing Edit Browse Groups D isten Stein Marketing Edit Browse Groups Livelink Version 3 2 0 Copyright 1995 2003 Open Text Inc All rights reserved Fig 20 Users stored in Livelink 60 Livelink WCM Server Common User Administration The following functions are available to you for managing users m adding a user see the following section edit user information see section Editing User Information in Livelink on page 64 deleting a user from the user administration see section D
37. a Group Name z starts with Find Add New Item z Name Actions 2 B Board Edit DefaultGroup im External m ja x HumanResources m a m 2 Marketing m a OfficeManagement ResearchDevelopment m Sales m 2 Training im WebsiteAdmin m Fig 23 Groups stored in Livelink The following functions are available to you for managing groups m adding a group see the following section m editing group information see section Editing Group Information in Livelink on page 74 m removing a group from the user administration see section Deleting a Group in Livelink on page 79 Adding a Group in Livelink To add a group in Livelink 1 Choose Users amp Groups on the Enterprise menu 2 On the Users amp Groups page choose Group on the Add New Item menu 3 Type a unique name for the new group in the Group Name field Livelink Integration Manual 73 Chapter 2 Group Name E Fig 24 Adding a group in Livelink 4 Click the Submit button Editing Group Information in Livelink The Edit Group page allows you to change the settings of a group To open this page 1 Choose Users amp Groups on the Enterprise menu 2 Use the search functions on the Users and Groups page to find the group see section Finding Principals in Livelink on page 57 3 Click the group s Edit link in the Actions column Edk
38. by choosing Tools gt View gt Edit view 4 In the Navigation area mark the topic in which you want to search 5 Choose View Object filter 6 Click the changed filter in the drop down list 150 Livelink WCM Server Livelink Contents in the Content Client Search beginning with topic InternetSite changed mn delayed release deleted expired objects with references to deleted objects objects with workflow assignment objects without workflow assignment rejected released special access rights submitted without filter Fig 43 Object filter in the Content client The filter hitlist opens automatically It contains all changed WCM objects not only relators Search beginning with topic InternetSite changed 2 Bl IT Apply action to all objects Objects found 8 Type OID Title a Version Status 4 Advanced Training Ta 5 Advanced Training Lessons 0 0 1 G 6 Advanced Training Solutions 0 0 1 fy 2 Basic Training 0 0 1 Ta 7 Basic Training Lessons 0 0 1 Ta 3 Basic Training Solutions 0 0 1 ER 1 Internetsite 0 0 1 Ba 8 Presentations 0 0 1 Fig 44 Filter results You can select one or more objects in the list in order to edit them Livelink Integration Manual 151 Chapter 4 Submitting Relators You have added a relator changed an existing relator or the relator has been updated automatically because the underlying Livelink o
39. determine ContextId of the current user 2 ContextId cid SessionBean getCurrentContextId request 3 extract form data from request 4 ParseFormEncoded pfe new ParseFormEncoded request 5 instantiate LivelinkPoll instance 6 LivelinkId 1lId new LivelinkId Integer parseInt pfe getParameterValue Llid 0 7 LivelinkPoll poll LivelinkPoll livelinkObjectBean get 11Id 8 String comment pfe getParameterValue comment 0 9 if comment length lt 1 comment null 10 for Enumeration enum pfe getParameterNames enum hasMoreElements 11 String parName String enum nextElement 12 if parName startswith Q 13 int questionIndex Integer parseInt parName substring 1 14 get all selected values for this 15 String questionString parValue pfe getParameterValues parName 16 for int idx 0 idx lt parValue length idx 17 int choiceIndex Integer parseInt parValue idx substring 1 18 select answer to the question Type of the question 19 must not be considered 20 poll select questionIndex choiceIndex 21 22 23 24 send data to the server 25 poll vote cid comment 26 gt 27 lt script lLanguage JavaScript gt 28 location href results jsp lLlid lt 1L1Id getNodeId gt 29 lt script gt 126 Livelink WCM Server Livelink Functions in a Website Displaying the Poll Results result jsp The current poll results can only be viewed if the us
40. entry is optional If you do not specify a root node ID the Enterprise Workspace will be used as the starting point lt url gt http livelink company example Livelink lt url gt URL of the Livelink system This entry is optional lt llview gt llview exe lt llview gt Name of the viewer program used for the preview functionality in Livelink lt objectcache gt lt strategy gt de gauss vip ObjectWiperImpl lt strategy gt lt cache_reduce_interval gt 7200000 lt cache_reduce_interval gt lt class gt de gauss vip DisplacingObjectCache lt class gt lt max gt 2500 lt max gt lt min gt 2000 lt min gt lt wipe_strategy gt time lt wipe_strategy gt lt objectcache gt Livelink objects can be loaded from the database into the object cache to speed up access to the objects lt max gt Maximum number of objects in the cache lt min gt Number of objects to which the cache is reduced in server idle times lt cache_reduce_interval gt Interval in milliseconds If the objects in the cache are not accessed during this period objects are removed from the cache until the minimum cache size is reached again Livelink Integration Manual 89 Chapter 3 Element in the XML file Explanation lt principalcache gt lt strategy gt de gauss vip ObjectWiperImpl lt strategy gt lt cache_reduce_interval gt 7200000 lt cache_reduce_interval gt lt class gt de gauss vip Dis
41. folder relators Livelink documents integrated in a website by means of relators are displayed directly in the browser If files cannot be displayed directly in the browser e g PDF files or Word documents a so called surrogate page containing a link to the file is generated Livelink folders become WCM topics As WCM topics have content an HTML page is generated for each Livelink folder In the Navigation area of the Content client the following icons symbolize relators The letters LL in the bottom right corner of the object type icon stand for Livelink The figure shows the relator icon for an Excel document hd bel If the system cannot access the Livelink object referenced by the relator the relator s icon is marked by a red cross The reason for this may be that the Livelink object has been deleted or that the connection between the WCM system and the Livelink system has been interrupted This chapter deals with the following topics m adding relators see section Adding Relators on page 133 m editing relators see section Editing Relators on page 149 deleting relators see section Deleting a Relator on page 163 132 Livelink WCM Server Livelink Contents in the Content Client Adding Relators There are different ways of adding Livelink objects as WCM objects You can add a single Livelink document as a WCM object see the following section add an existing Livelink folder struc
42. index regions see section Displaying Index Regions in Livelink on page 202 Scenario 2 Searching Livelink contents Realizing this scenario requires the following steps in the WCM system 1 Install Livelink Search server see the following section 2 Add collections see section Adding an extemal collection for a Livelink slice on page 199 Scenario 3 Searching other document sets Realizing this scenario requires the following steps in Livelink and the WCM system 1 WCM system Install Livelink Search server see the following section 2 Livelink system Create XML Activator Producer data flow see section Creating an XML Activator Producer Data Flow in Livelink on page 193 3 WCM system Add collections see section Adding an external collection for another type of document set on page 200 4 Livelink system Start the XML Activator process see section Starting the XML Activator Process in Livelink on page 201 Livelink Integration Manual 189 Chapter 5 Installing Livelink Search Servers in the WCM System Note For detailed information on installing a WCM system refer to the Livelink WCM Server Installation Manual During the installation of a WCM system the dialog box Search server opens On the Livelink tab of this dialog box you can add the desired number of Livelink Search servers fal Livelink Web Content Management Server 9 5 0 Search server
43. int i 0 i lt 1Nav size i 25 get child object 26 LivelinkId tId LivelinkId lNav get i 27 LivelinkObject tObj 110bjBean get tId 28 child exists and is a folder create a link calling this 29 JSP with the according node id 30 if tObj null amp amp tObj getCatalogMode LivelinkObject HIDDEN 31 Livelink Integration Manual 101 Chapter 3 32 if tObj getObjectType getSubType LivelinkObjectType SUBTYPE_FOLDER 33 gt 34 lt b gt lt a href VIPURL navNodelId lt tempId getNodelId gt gt lt title gt lt a gt lt b gt 35 lt 36 else The childrenMap created in this process will be used for displaying the Livelink objects which are not of type folder in a list see the following section 37 add element to the children map used in this page 38 childrenMap putValue temp tempObj getAsRepositoryEntry Displaying Documents from a Livelink Folder browser jsp The second part of the JSP page displays a list of the documents which are contained in the Livelink folder The documents are sorted by name in the list Clicking a document name opens a new browser window showing the content of the document see section Displaying the Content of Livelink Objects show jsp on page 98 The JSP page also offers a login method After the user has logged in successfully a link for adding items is shown JavaScript methods are used to open the
44. node ID which is passed on as a parameter identifies the folder to which the document will be added The create jsp page that is called by form jsp creates the document 1 TF 2 String uploadNodeId request getParameter uploadNodeld 3 gt 4 lt form name form action create jsp method post enctype multipart form data gt 5 lt input type hidden name returl value browser jsp gt gt Livelink Integration Manual 105 Chapter 3 6 lt table name table border 0 style width 400px align center gt 7 lt tr gt lt td gt Title lt td gt 8 lt td gt lt input type text name title style width 100 gt lt td gt lt tr gt 9 lt tr gt lt td gt Comment lt td gt 10 lt td gt lt input type text name comment gt lt td gt lt tr gt 11 lt tr gt lt td gt File lt td gt 12 lt td gt lt input type file name fileinput gt lt td gt lt tr gt 13 lt 14 int uld Integer parseInt uploadNodelId 15 LivelinkObject 110bj 110bjectBean get new LivelinkId uld 16 if 110bj null 17 gt 18 lt tr gt lt td gt Folder lt td gt 19 lt td gt lt 110bj getName gt 20 lt input type hidden name filetopic value lt uploadNodeld gt gt 21 lt td gt lt tr gt 22 lt 23 24 gt 25 lt tr gt 26 lt td colspan 2 align center gt lt input type submit value Create gt amp nbsp 27 lt input type button value Close
45. out objects of this object type m They determine which views and dialog boxes are available to the user in the Content client For general information on functional areas refer to the Livelink WCM Server Administrator Manual chapter Concepts Livelink Integration Manual 47 Chapter 2 If you open the main item Functional areas in the User administration view a list of available functional areas is displayed ewe ARR Pee ee B Users B Groups E B Roles a World 5j Functional areas D User administration O Access rights dialog Advanced OD Basic O Direct release Dynamic D gt Filter edit gt Filter standard B Form A Import A Intelligent templates Livelink Log dialog References dialog Search O View My objects View Object list View Subordinate objects View Template structure OA Workflow Fig 13 Available functional areas The following functions are available to you m adding functional areas see the following section m viewing the settings of functional areas see Settings of Functional Areas on page 50 m assigning functional areas to users groups and roles see Assigning Functional Areas on page 51 m deleting functional areas see Deleting a Functional Area on page 52 48 Livelink WCM Server C
46. provided for illustrating how to use the API functionality and how the JSP pages interact The demo application LiveStart provides fully functional code LiveStart is supplied as file livestart 9 5 0 zip The ZIP file is located on the WCM CD in the examples directory Integrating Content from a Livelink Folder in a Website This application example illustrates how to display content and metadata of Livelink documents in your website The permissions of the current user are implicitly evaluated The example contains a simple login mechanism Scenario The training department of your company manages all training materials in Livelink You want to publish some of these materials on the website and provide personalized access to the documents Procedure 1 All documents contained in a Livelink folder are displayed in a list list jsp 2 The user can log in to the system login jsp and thus access addi tional documents Livelink Integration Manual 95 Chapter 3 3 Clicking a document name opens a new browser window displaying the content of the document show jsp Listing Documents of a Livelink Folder list jsp Using instances of the LivelinkObject interface you can retrieve object information from the connected Livelink system You need the node ID of the corresponding Livelink object for this The following sample code first creates an instance of LivelinkObject
47. questions for which the users can choose as many answers as they like In an HTML form check boxes are used for the answers The conditions for voting in a website poll correspond to the conditions in Livelink Users must log in before they can vote m Each user can only vote once Scenario The staff of your company is to take part in a vote concerning Safety on the job You want to make the poll available in the intranet The staff members shall be able to vote via the intranet Procedure 1 The input form form jsp provides functions for voting in a poll which already exists in Livelink Livelink Integration Manual 123 Chapter 3 2 Voting is performed on the vote jsp page 3 The result jsp page displays the poll results Displaying a Form for a Livelink Poll form jsp The form must distinguish two cases m The user has not voted yet and can still do so m The user has voted already and can view the poll results The following example assumes that the user is already logged in to the system see section User Login login jsp on page 97 The canVote cid method makes the distinction between the two cases The method checks whether the user has voted already and whether voting has not been completed yet 1 lt determine ContextId of the current user 2 ContextId cid SessionBean getCurrentContextId request 3 load LivelinkPoll object 11lId points to a LivelinkPoll object 4 Li
48. released by Quality Assurance see section Submitting and Releasing Relators on page 150 Note A relator can only be updated automatically if its status is either changed rejected released or delayed release If this requirement is not met use the appropriate staging action to change the relator s status After this you can adapt the relator to the modified Livelink object by choosing Object gt Synchronize Livelink Integration Manual 137 Chapter 4 m Fixed version If you click this radio button the relator will be based on a certain version of the Livelink object When the object changes in the Livelink system the relator remains unchanged You can however update the relator manually via the Livelink metadata dialog box see section Modifying Livelink Metadata on page 155 m Version f you clicked the Fixed version radio button select the desired version of the Livelink object from the drop down list Confirm your entries by clicking the OK button Entering a remark In this dialog box you may enter information for the relator s log Z Remark Microsoft Internet Explorer 5 x Please enter a remark The remark will be saved in the log Remark T Do not show this dialog again lt Back Next gt OK Help Fig 36 Entering comments about the relator Confirm your entries by clicking the OK button The WCM system creates the relator
49. section Permissions for Searching on page 203 using the Livelink search engine in a website see section Using the Search on page 204 managing external collections with command line tools see section Command Line Tools on page 205 This section is intended for administrators with the necessary knowl edge of the search functions provided by Livelink WCM Server what to do in case of errors see section Problems and Solutions on page 215 Technical Concepts Livelink is able to index documents from external systems in this case from the WCM system The external data source is defined by an XML Activator within the Search Server Connector This XML Activator comprises the following processes 1 168 Process monitoring the directory in which external programs store the documents to be indexed The files stored in this directory contain the actual content as well as the metadata of the documents The most important metadata item is the URL which is also called OTURN Open Text Universal Resource Name in this context Livelink WCM Server Livelink Search in the WCM System 2 Conversion process The XML Activator includes a text converter supporting several file formats such as DOC and PDF 3 Indexing process The documents converted to text are indexed and can thus be searched After converting and indexing have been completed a new slice is defined on the basis of the data source This sli
50. servers Livelink WCM Server Administrator Manual This document explains how to configure and administer WCM systems Moreover it contains a detailed description of the technical concepts of Livelink WCM Server Content Client User Manual This manual provides detailed instruc tions on all tasks involved in editorial work on websites managed with Livelink WCM Server WCM Java API Programmer s Manual This document contains information on interfaces classes and methods of the Java programming interface WCM Java API which enables you to use the functionality of the WCM servers via external programs Livelink WCM Server Introduction Portal Manager API Programmer s Manual This manual contains detailed information on developing dynamic and personalized websites on the basis of the Portal Manager API Content Miner Manual and Search Server Connector for Lucene Manual These documents describe concepts and management of a Search server For detailed information about concepts and use of Livelink refer to the Livelink documentation Typographic Conventions The following conventions are used in the text to draw attention to program elements etc Element Font or symbol Examples Program interface such as menu commands windows dialog boxes field and button names Menu Entry File gt Create Variables i e placeholders for specific elements variable Paths t
51. the User ID field for example the search returns a list of all users whose IDs begin with that letter e g mmoreno or mrossi 32 Livelink WCM Server Common User Administration 2 Confirm the search criteria with ENTER or by clicking the Search and update display button The tree on the left is updated according to the search results For example after a search for individual users the Users item contains only the users found in the search 3 To display all the items again delete the filter criteria and confirm with ENTER or by clicking Search and update display Managing Users in the Admin Client If you expand the main item Users in the User administration view a list showing all the users stored in your Livelink system will be displayed With the installation all Livelink users are automatically granted access to the WCM system However they do not have any administration rights and functional areas assigned Also they only have the default object rights Read and Read Production That means that the users cannot edit any website or modify the configuration of the WCM system Cc ser administration Users D abianchi D Admin D cerdmann D claurent D dearson D eschmidt D hshepard D jgornez D jstein gt kblume D mmoreno D mrossi D msanchez gt pdeville D smarchetti D solivier B e CcEOBCEC C EC CECE ecm cM cM CMCC g Fig 6 Stored users in t
52. the new collection for search requests you must add directory structures to the collection by means of the command line tools AddcDocument and AddDirectory see sections AddDocument on page 209 and AddDirectory on page 210 Livelink Integration Manual 185 Chapter 5 Making Index Regions Queryable in Livelink 1 4 On the Livelink System page click the Processes Prefix Data Source Folder link Click the Functions icon x of the Search Manager and select Info Regions On the Regions tab select the Queryable check box for all regions starting with the prefix VIP Confirm by clicking the Update button Starting the XML Activator Process in Livelink When starting the XML Activator process scans the specified incoming directory and updates the index according to the XML files located in this directory To start the XML Activator process in the Livelink system 1 On the Livelink System page click the Processes Prefix Data Source Folder link Click the Processes Prefix Data Flow Manager link Click the Functions icon of the XML Activator and select Info gt Specific Make the following settings in the Start Options section Scheduled z C At This Time 1 00 am gt l sul mol tul wel thl fr sa Every fi x Minutes z Fig 53 The Start Options section on the Specific tab 186 Livelink WCM Server Livelink Sea
53. the right window pane Livelink Integration Manual 77 Chapter 2 abianchi Log in Name abianchi Name abianchi Department Board E Mail abianchi company example Set as Group Leader Remove From Group Fig 28 Setting a user as the group leader in Livelink 2 Click the Set as Group Leader button A Leader icon 4 B replaces the User icon to identify the user as the group leader Unsetting the group leader in Livelink To unset the group leader in Livelink 1 In the Current Group Members section of the Edit Group page click the name link of the group leader 2 Click the Unset as Group Leader button in the right window pane The user returns to regular member status and is marked with the User icon Changing a group name in Livelink Important Changing a group name in Livelink corresponds in the WCM system to deleting the group and adding a new group with iden tical settings The WCM objects access control lists which contained the original group are not modified automatically To change a group name in Livelink 1 On the Edit Group page click the Edit Group Name link 2 Type the new group name in the Group Name field 78 Livelink WCM Server Common User Administration 3 Click the Submit button Removing a Member from a Group in Livelink Note You cannot remove a member from his or her base group To remove a member from a group in Livelink 1 In the Current Group
54. B E Training E Presentations B E3 Tutorials tH By de o Ba Advanced Training T Advanced Training Lessons TJ Advanced Training Solutions G Basic Training T Basic Training Lessons Bw Basic Training Solutions iy lt Back Next gt OK Help Fig 42 Selecting the Livelink folder Confirm by clicking the Next button Entering a remark In the following dialog box you may enter information for the relator s log Confirm your entries by clicking the OK button The WCM system creates the relator and shows it in the Navigation area The relator s status is changed Also the document will be stored at the specified location in the Livelink system 148 Livelink WCM Server Livelink Contents in the Content Client The relator is created with the settings Update Edit version automatically and Delete Livelink object together with relator You can change these settings in the Livelink metadata dialog box see section Modifying Livelink Metadata on page 155 For the relator to become visible in the published website you must submit it After this the relator must be released by Quality Assurance see section Submitting and Releasing Relators on page 150 Editing Relators Relators do not only enable you to publish Livelink objects on a website They also make it possible to edit Livelink objects In this section the following procedures are introduced submitting and relea
55. CM tab in Livelink always reflects the state of the last WCM system that has been changed All changes to the principals of one WCM system also apply to all other WCM systems connected to the user administration of the same Livelink server Thus it is not possible for example to grant a user a specific default object right for only one WCM system Livelink Integration Manual 25 Chapter 2 Managing Principals in the Admin Client Notes In order to add edit and delete principals in the Admin client you need the administration right Create modify delete principal In order to modify the administration rights of a principal you also need the right Change administration rights Users with appropriate administration rights in the WCM system can make changes to the user information which also affect Livelink These users do not require any privileges in the Livelink system for this You can manage all users who are to access the WCM system and the Livelink system with the Admin client To group users according to their tasks and the company s organizational structure and to assign special access rights you can define groups and roles and assign functional areas Starting the Admin client If the Admin client is installed on your computer use the batch file adminClient bat Windows or adminClient sh UNIX to launch the client These files are located in the directory WCM installation directory adm
56. Fig 55 Installing Livelink Search servers 191 Fig 56 The Search Administration section on the Livelink Administration page 194 Fig 57 Creating an XML Activator Producer Data Source 195 Fig 58 Specifying the Livelink parameters for an internal collection 198 Fig 59 The Start Options section on the Specific tab 201 8 Livelink WCM Server List of Tables Table 1 Table 2 Table 3 Table 4 Table 5 Table 6 Table 7 Table 8 Table 9 Table 10 Table 11 Table 12 Table 13 Table 14 Table 15 Table 16 Table 17 Notes on common user administration with the Admin client Items and functions of the user administration in the Admin client Notes on managing users with Livelink Available functional areas Actions and required default object rights Elements of the livelink systems xml Livelink object types and their equivalents in the WCM Java API Livelink users and groups and their equivalents in the WCM Java API WCM tags for the most common Livelink metadata General parameters of the command line tools Parameters of the command line tool AddDocument Parameters of the command line tool DeleteDocument Parameters of the command line tool AddDi rectory Parameters of the command line tool DeleteDirectory Parameters of the command line tool ListSources Parameter of the command line tool RemoveCol lection Parameters of the command line tool Query Livelink Integration Manual 28 30 55 67 70 88 92
57. In the Configuration dialog box of the Content client the user can also select a language for the client This setting takes priority over the setting on this tab and cannot be changed by the administrator Substitute Click the B button to select a substitute for this user from a list In the Content client the user selected here can log in as the substitute for the user The substitute may perform all functions for which the user is authorized Click the Remove button to unassign the substitute Websites If you want to change the assigned website s of the user select or clear the check boxes of the website s The assignment to a website enables the user to access the website objects with the Content client Livelink WCM Server Common User Administration Functional areas The functional areas are used to determine which types of WCM objects the user may edit and which dialog boxes and functions are available in the Content client If you want to change the assigned functional area s of the user select or clear the check boxes of the functional area s The following table shows the default functional areas available after the installation of the WCM system Table 4 Available functional areas Functional area Default assignment to object type View or function in the Content client Basic Advanced Compound object Excel document GIF image HTML page JPEG image Other PDF docu ment PNG image
58. Livelink Integration Manual 117 Chapter 3 String tId request getParameter topicId String nId request getParameter nodeld get discussion entry LivelinkId discId new LivelinkId Integer parseInt dId LivelinkObject discussion 110bjBean get discld if discussion null String title null int currentType 0 LivelinkDiscussionEntry parent null if the current node id is not set a topic will be created otherwise a reply if nId null title Post a New Topic currentType LivelinkObjectType SUBTYPE_TOPIC else get the current Livelink object title Post a new Reply currentType LivelinkObjectType SUBTYPE_REPLY gt The form calls the create jsp page and passes the input fields for title and contents as well as the required node IDs and the object type topic or reply in hidden attributes 23 lt h1 gt lt title gt lt h1 gt 24 lt form name CreateItem action create jsp method post gt 25 lt input type hidden value lt currentType gt name objectType gt 26 lt input type hidden value lt dId gt name discussionId gt 27 lt input type hidden value lt tId gt name topicId gt 28 lt table cellSpacing 0 cellPadding 2 width 100 border 0 gt 29 lt tr gt lt td gt Subject lt td gt 30 lt td gt lt input maxLength 248 size 60 name Subject gt lt td gt lt tr gt 31 lt tr gt lt td gt Comment
59. Presentations S E Tutorials Ba de yy en Advanced Training By Advanced Training Lessons By Advanced Training Solutions G Basic Training Bw Basic Training Lessons T Basic Training Solutions El lt Back Next gt OK Help Fig 34 Selecting the Livelink object when adding a relator Confirm by clicking the Next button Specifying the version of the Livelink object The Livelink object that the relator refers to may be subject to change In this dialog box you determine how the relator reacts when the Livelink object changes 136 Livelink WCM Server Livelink Contents in the Content Client Livelink WCM Server Content Client Microsoft Internet Explorer loj x Please specify the version Livelink ID Advanced Training Nodeld 4945 Version ce Update Edit version automatically C Fixed version CE on Cancel lt Back Next gt OK Help Fig 35 Specifying the version of the Livelink object m Livelink ID Livelink ID of the selected object The Livelink ID is composed of the name and the ID of the object in the Livelink system You cannot change this entry m Update Edit version automatically f you click this radio button the Edit view of the relator will be automatically changed whenever the object is modified in the Livelink system For the changes to become visible in the published website you must submit the updated relator which then must be
60. The Javadoc documentation is located in the directory WCM installation directory documentation javadoc Portal Manager API The Portal Manager API provides the following beans for integration with the Livelink m de gauss vip portalmanager LivelinkObjectBean This is the main bean for accessing Livelink objects such as docu ments folders discussions and projects Several create methods for adding objects directly in Livelink can be called via this bean m de gauss vip portalmanager LivelinkUserBean This bean enables access to users and groups stored in Livelink The interface definitions for the actual Livelink objects are contained in the WCM Java API The Portal Manager API gives you access to instances of these interfaces Livelink Integration Manual 91 Chapter 3 WCM Java API Livelink object types The following table provides an overview of the supported Livelink object types and their equivalents in the WCM Java API As arule the interface names are built from the Livelink term and the prefix Livelink Table 7 Livelink object types and their equivalents in the WCM Java API Livelink object Interface in the Package type WCM Java API de gauss Livelink Alias LivelinkAlias object Document LivelinkDocument object Folder LivelinkFolder object Rendition LivelinkRendition object URL LivelinkURL object Version LivelinkVersion object Workspace
61. The different rights can be assigned individ ually In this way you can control precisely which settings the individual users can view and what changes they can make Depending on the assigned rights the Admin client displays only those views and functions that the user is entitled to use For example if the user does not have the right to view the configuration the Admin client hides this view The online help of the Admin client provides an overview of the adminis tration rights Note If a user has individual administration rights in addition to the administration rights due to the group or role membership the rights are added up Moreover all users have the administration rights of the prin 1 cipal World see section Managing the Rights of the Principal World on page 47 38 Livelink WCM Server Common User Administration Deleting a User in the Admin Client To delete a user in the Admin client 1 Select the user via User administration Users User ID 2 Choose Delete user on the context menu or click the corresponding icon E Icon for deleting a user 3 Confirm the security prompt by clicking the Yes button The deleted user can no longer log in to the WCM system In Livelink the user will be marked as deleted If you only want to prevent a user from accessing the WCM system you can clear the check box WCM access in the user s settings Thus you do not need to delete the compl
62. The search on the Livelink server does not return any results although there are documents in the system matching the search criteria Procedure 1 Log in to the Livelink system For this purpose use the URL user name and password specified when installing the Search server see section Installing Livelink Search Servers in the WCM System on page 173 Inthe Search menu select the slice that you specified when creating the collection to be searched see section Adding Collections in the WCM System on page 182 Enter a search term and select Go If the Search Results page does not show any results there are really no appropriate documents in the slice In this case there might have been errors during indexing To check whether the slice contains any documents at all enter an asterisk in the search field If search results are displayed check whether the fields ViPcollection and V iPoid are shown Livelink Integration Manual 215 Chapter 5 6 If these two fields are not shown change the configuration according to the instructions in section Displaying Index Regions in Livelink on page 187 7 Repeat the test 8 Repeat the test with an extended URL corresponding to the following pattern http livelinkserver company example livelink livelink exe func search amp outputformat xml amp slice slice name amp nlq search term amp NLQmode LivelinkAware amp hhterms true
63. URL show jsp nodeId lLlid getNodeld 42 gt All Value classes of the Portal Manager API provide a format method for formatting the values of the class according to a locale and a format description In the following example the date is formatted according to the JSP page s locale and the short format 104 Livelink WCM Server Livelink Functions in a Website 43 lt tr gt 44 lt td gt lt type format gt lt td gt 45 lt if url null gt 46 lt td gt lt a href lt url gt target content gt lt title format gt lt a gt lt td gt 47 lt else gt 48 lt td gt lt title gt lt td gt 49 lt gt 50 lt td gt lt comment format gt lt td gt 51 lt td gt lt user getName gt lt td gt 52 lt td gt lt create format null short gt lt td gt 53 lt td gt lt modified format null short gt lt td gt 54 lt tr gt 55 lt 56 57 gt 58 lt table gt LivelinkObject is used to retrieve the icon that is associated with the object The URL used for accessing the icon can be composed with the following code String imgUrl VIPDEPLOYMENT_URL lLivelinkObj getImageUr1 Displaying a Form for Adding a Document form jsp The following form can be provided for entering the information required for adding a Livelink document The form contains input fields for the title the comment and for selecting a file The
64. WCM servers If a connection is required it is taken from the respective pool After the data transfer the connection is returned to the pool Pools always combine connections of the same type e g connections to databases JDBC pools or connections between WCM servers WCM pools Portal A portal is a website that serves the user as a central point of access as a gate to certain Internet services A portal often offers topic specific and personalized offers and information Production view The Production view of Livelink WCM Server makes the released pages of a website available to the user By means of a web server these pages can be accessed in the Internet intranet or extranet Properties file A file containing resource information in a defined format key value pairs Proxy server A proxy server is used to intercept requests from a client application e g a browser to one or more other servers If the proxy server can meet the request it sends the requested data back to the client Otherwise it forwards the request to the specified server In the context of Livelink WCM Server WCM servers of the category proxy do not have write access but only read access to the WCM objects or the configuration Changes to the WCM objects are only possible via the master Content server changes to the configuration of the 222 Livelink WCM Server Glossary WCM system are made only via the master Administrati
65. ailableCollections livelinkURL http livelinkserver company example livelink livelink exe username LivelinkUser password livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp ListSources ListSources returns a list of all documents contained in a collection or in a slice Table 15 Parameters of the command line tool ListSources Parameter Description collection Name of the internal collection whose documents are to be listed This parameter or the parameter al1 must be specified all Enter true to list the documents of a slice This parameter or the parameter collection must be specified 212 Livelink WCM Server Example Livelink Search in the WCM System ListSources livelinkURL http livelinkserver company example livelink livelink exe username LivelinkUser password livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp RemoveColLection RemoveCollection deletes a collection or a slice Table 16 Parameter of the command line tool RemoveColLection collection Name of the internal collection that is to be deleted This parameter or the parameter all must be specified Enter true to delete the slice This parameter or the parameter collection must be specified Example RemoveSources lLivelinkURL http livelinkserver company example Livelink livelink ex
66. and roles in general Group and role concept Livelink provides only users and groups no roles For this reason the WCM roles are represented by Livelink groups For each Livelink group the WCM User Administration module stores the information whether this group is a group or a role in the WCM system Adding groups and roles Unique names In the WCM system the names of groups and roles must only be unique within all groups or roles respectively This means that a group can have the same name as a role When storing the user data in Livelink however this is not allowed as roles are represented by groups in Livelink Editing group and role information Editing WCM specific settings In Livelink you cannot manage additional information such as the e mail address for groups This means that you have to use the Admin client to edit WCM specific information of groups and roles Livelink Integration Manual 29 Chapter 2 User Administration Functions in the Admin Client To open the user administration click the tab _ Useradministration in the Admin client The items you can manage in this view are displayed ina tree structure gt User administration El p Users E B Groups E B Roles E World Ej a Functional areas yy Websites Fig 4 User administration items in the Admin client The following table gives an overview of the functions available for ea
67. and shows it in the Navigation area The relator s status is changed 138 Livelink WCM Server Livelink Contents in the Content Client For the relator to become visible in the published website you must submit it After this the relator must be released by Quality Assurance see section Submitting and Releasing Relators on page 150 Adding a Folder Relator Objective You want to integrate a Livelink folder including all subfolders and subordi nate documents into the WCM system Each Livelink object is to be repre sented by arelator in the WCM system A wizard guides you through this task Starting the wizard 1 Launch the Content client The URL of the Content client is of type http wcmserver company example cmsclient index jsp 2 Login to the Content client and select the website that you want to edit 3 Change to the Edit view of the website by choosing Tools gt View gt Edit view 4 In the Navigation area mark the topic in which you want to integrate the Livelink objects 5 Choose Object New Relator Livelink Integration Manual 139 Chapter 4 Specifying the Livelink system There may be more than one Livelink system in your company In the first dialog box you specify the Livelink system in which the Livelink folder you want to integrate is stored Object attributes Microsoft Internet Explorer loj x Select a Livelink system from the list Livelink_internal
68. answers new Array 46 Shows the answer to the given question 47 function showAnswer inItem 48 var question document getElementById question 49 var answerTable document getElementByld answer_table 50 var answer document getElementBylId answer 51 if answer amp amp answerTable amp amp question 52 question style display block 53 question style visibility visible 54 answer style display block 55 answer style visibility visible 56 var a answers inItem id 57 if a null a length 0 58 a Not answered yet 59 question firstChild nodeValue Q inItem firstChild nodeValue 60 answer innerHTML a 61 62 63 lt script gt 122 Livelink WCM Server Livelink Functions in a Website Polling on the Website In Livelink you can take Polls The Portal Manager API enables you to use these polls in a website You create the poll as usual in Livelink i e you define the questions and alternative answers by means of the default Livelink functions The Portal Manager API provides methods for retrieving these definitions Also users can take part in the poll i e vote and view the poll results A Livelink poll consists of one or more questions with predefined answers There are two types of questions question for which the users can choose exactly one of the predefined answers In an HTML form radio buttons are used for the answers
69. ata for the relator You are assigned the functional area Livelink To check your func tional areas choose Tools gt Login info in the Content client You have the permission Modify for the Livelink object Procedure 1 156 Launch the Content client The URL of the Content client is of type htto wcomserver company example cmsclient index jsp Log in to the Content client and select the website that you want to edit Change to the Edit view of the website by choosing Tools gt View gt Edit view Inthe Navigation area mark the relator whose Livelink metadata you want to edit Choose View Livelink metadata Livelink WCM Server General Livelink data Livelink system Livelink ID Livelink Contents in the Content Client Training Materials Livelink_internal Gl Advanced Training Nodeld 4945 ersion 1 3 Jun 2 2004 Created 2 04 12 PM Created by File name OnlineHelp2 ppt MIME Type Object size Description ersion description Yersion 971 50 KB Update Edit version automatically C Fixed version 7 Delete Livelink object together with relator Save Reset Help Admin application vnd ms powerpoint Fig 45 The Livelink metadata dialog box The dialog provides several tabs for viewing and editing metadata m General Livelink data tab Most entries on this tab are controlled b
70. ate several internal collections in a slice In this case however you have to make sure that all entries in a slice have a unique URL XML Activator directory The command files created in the temporary directory will be moved to this directory Enter the path to the shared Incoming Directory that you speci fied when creating the XML Activator Producer Data Source If Livelink and the WCM system are installed on different host computers the directory must be mapped to a network drive on the WCM system s host computer Enter the path accordingly Livelink Integration Manual 183 Chapter 5 m Temporary directory The WCM system uses this directory for generating the command files for the XML Activator In this way the XML Activator receives instructions when a WCM object changes The instructions refer to how to process the changes e g re index the object or remove the object from the index Create this directory on the same physical drive as the XML Acti vator directory Before you can use the new collection for search requests the collection must be synchronized The synchronization process matches the WCM managed document set with the document set indexed by the Search server 4 Select System administration gt Search servers Search server name and mark the desired collection 5 Choose Synchronize collection on the context menu or click the corresponding icon g Icon for synchronizing an inte
71. ation Functional areas name of functional area 2 Choose Delete functional area on the context menu or click the corresponding icon PN Icon for deleting a functional area Website Assignments In the User administration view you can use the main item Websites to assign users groups and roles to websites To create and configure websites change to the Configuration view of the Admin client For more information refer to the Livelink WCM Server Administrator Manual chapter Managing Websites Open the main item Websites to display the list of assignments to users groups and roles 52 Livelink WCM Server Common User Administration D User administration B Groups B Roles World E y Websites W Companyintranet B Users EF Groups amp Roles W InternetSite Fig 16 Website assignments By means of the toolbar or the context menu you can make and remove the following assignments Assign users and remove assignments gt Assign groups and remove assignments et E a Assign roles and remove assignments If you assign a website to a user group or role the respective users can access the objects of this website via the Content client The exact access rights depend on the users memberships in groups and roles the users functional areas and on the rights settings of the individual WCM objects Note If
72. be published it must be submitted to Quality Assurance for checking This makes the changes to the object visible in the QA view Synchronization The synchronization process matches the WCM managed document set with the document set indexed by the Search server A completely new index is generated Template File that provides the framework for other objects The HTML pages for the Production view are created by bringing together the template and the content Any HTML components may be integrated in a template Topic Combination of an HTML page for direct display of information and a list for accommodating subordinate objects The topics are shown as nodes in the object tree and thus help structure the website URL Uniform Resource Locator A unique address in the World Wide Web 224 Livelink WCM Server Glossary WCM server In a WCM system there are several WCM servers working in parallel server processes The exact tasks of a server depend on the server type and server category WCM tag Special element for integrating WCM specific data in an HTML page WCM tags are used in particular when creating templates Livelink Integration Manual 225 226 Livelink WCM Server Index A access to Admin client groups roles 45 users 37 World 47 add external collection Enterprise Server 9 2 1 184 external collection Enterprise Server 9 5 0 199 folder relator 139 functional area 49 group Admin cli
73. bject was modified Quality Assurance is to check the relator That means that you want to submit the relator Prerequisites m The relator has the status released changed or rejected m You have the access rights Read and Change object for the relator Procedure 1 Launch the Content client The URL of the Content client is of type htto wcmserver company example cmsclient index jsp 2 Log in to the Content client and select the website that you want to edit 3 Change to the Edit view of the website by choosing Tools gt View gt Edit view 4 In the Navigation area mark the relator that you want to submit to Quality Assurance 5 Choose Object Submit or click the appropriate icon g Icon for submitting an object The object has the status submitted and can be checked by Quality Assurance 152 Livelink WCM Server Livelink Contents in the Content Client Releasing Relators You have completed the quality assurance process for a relator and come to a positive conclusion You now want to transfer the current version of the relator to the Production view and thus make it available to the public Prerequisites The relator has the status submitted m You have the access rights Read and Release for the relator Procedure 1 Launch the Content client The URL of the Content client is of type http wcmserver company example cmsclient index jsp
74. browser window The comment VIPURL causes the value which follows the comment to be treated as a WCM managed link In this way you can use WCM managed URLs in scripting code JSP JavaScript 102 Livelink WCM Server BWNPE Livelink Functions in a Website lt script language JavaScript gt function openUploadWin var uploadURL VIPURL form jsp uploadNodeld lt navNodeld gt window open uploadURL name width 650 height 400 Left 200 top 150 function openLoginWin window open VIPURL login jsp name width 650 height 400 lef t 200 top 150 lt script gt The document list is displayed as a table and contains six metadata items for each Livelink object You can easily modify the appearance of the list to suit your requirements The isLoggedIn method from the SessionBean class of the Portal Manager API checks whether the user is logged in to the system 11 12 13 15 16 17 18 20 21 22 23 25 lt table width 100 gt lt tr gt lt td colsapn 6 align right gt lt provide link depending on login status of the current session if SessionBean isLoggedIn request gt lt a href javascript openUploadWin gt Add document gt lt a gt lt else gt lt a href javascript openLoginWin gt Login lt a gt lt gt lt td gt lt tr gt lt tr gt lt td gt Type lt td gt lt td gt Title lt td gt lt td gt Comment lt td gt lt t
75. c Audit Categories Ratings References Versions Training Materials Sd Level amp Advanced z Status in progress j t Py r fo Contact Person fen B E Mail istein company exemple Phone number 1 S55 666 777 1 896 999 333 Subm Acely Reset Remove Cancel Fig 46 The category Training Materials in the Livelink system Use the WCM tag VIPLL category Training Materials set Contact Information attribute Phone number set_no 1 item_no 2 Livelink Integration Manual 161 Chapter 4 to show the mobile phone number of the contact person on the page In case of the employee Joshua Stein who is entered as the contact person this is the phone number 1 898 999 333 Updating a Relator Manually Objective If the Fixed version option is selected for a relator this relator will not be updated automatically when the referenced Livelink object changes You want to update the relator manually Prerequisites The relator has the status changed rejected released or delayed release m The Fixed version option is selected for the relator m You have the access rights Read and Change metadata for the relator m You are assigned the functional area Livelink To check your func tional areas choose Tools Login info Procedure 1 Launch the Content client The URL of the Content client is of type htto wcmserver company example cm
76. ce contains the data generated during indexing A search manager is created for processing the search requests Data flows during indexing In order to use the Livelink search ina WCM system you have to perform several installation and configuration steps see section Configuring the Livelink Search for the WCM System on page 171 After this the Livelink search engine regards the WCM managed websites as external data sources Whenever a WCM object changes in one of the collections managed by the Livelink Search server the ContentMinerNotification agent initiates the generation of a command file for the XML Activator In this way the XML Activator receives instructions on how to process the changes e g re index the object or remove the object from the index The command file is created in a temporary directory and then moved to the directory moni tored by the XML Activator System architecture The following figure illustrates the interaction between the different components Livelink Integration Manual 169 Chapter 5 Command line tools XML Activator ContentMinerNotification Agent Livelink Search server ae WCM Livelink XML Activator directory Fig 47 Interaction of components in the Livelink search To make the illustration more comprehensible only one XML Activator is shown You can however configure several XML Activator
77. cene Livelink_SearchServer Name Livelink_SearchServer Host name Port URL xample Livelink livelink exe vi Use URL for connection User Admin Password p Name ofthe assigned server Master_Content v Add Search server Remove Search server Help Cancel Back Fig 49 Installing Livelink Search servers m Name name of the server You have a free choice of name but it must be unique within the WCM system The following charac ters are permitted a z A Z 0 9 ASCII 7 Bit dot hyphen and _ underline Host name fully qualified name of the computer hosting the Livelink server which is to perform the indexing and to process the search requests Port connection port on the Livelink server default 2099 Livelink Integration Manual 175 Chapter 5 m URL URL to the Livelink server which is to perform the indexing and to process the search requests The URL is of type http livelinkserver company example Livelink livelink exe m Use URL for connection Select this check box if you want to use the Livelink server s URL for the connection In this case the entries in the fields Host name and Port will be ignored m User user for processing the search requests in the Livelink system The user must have read access to the slices Notes For the Livelink search you can determine which index regions are queryable and displayable
78. ch item Table 2 Items and functions of the user administration in the Admin client Item Available functions User Add and configure users and edit user information Assign users to groups roles functional areas and websites as well as assign default object rights and administration rights See section Managing Users in the Admin Client starting on page 33 Groups Add and configure groups and edit group information Assign users functional areas and websites to groups and define default object rights and administration rights See section Managing Groups and Roles in the Admin Client starting on page 40 30 Livelink WCM Server Common User Administration Item Available functions Roles Add and configure roles and edit role information Assign users functional areas and websites to roles and define default object rights and administration rights See section Managing Groups and Roles in the Admin Client starting on page 40 World This entry represents all users of the WCM system You can assign administration rights to it See section Managing the Rights of the Principal World starting on page 47 Functional areas Add functional areas and assign users groups and roles to functional areas See section Managing Functional Areas starting on page 47 Websites Assign users groups and roles to websites See section Website Assignment
79. cify the document to be added to the Livelink system Click the Browse button to select the file Specifying a file is mandatory Note Please choose only files that have a file extension Workflow If you want to assign a workflow to the new object click the desired workflow in the drop down list For more information about the workflow of the WCM system refer to the Content Client User Manual chapter Content Workflow m Object type Select the object type Livelink relator Confirm by clicking the Next button Specifying the Livelink system There may be more than one Livelink system in your company In the following dialog box you select the Livelink system to which the document will be added 146 Livelink WCM Server Livelink Contents in the Content Client Object attributes Microsoft Internet Explorer Select a Livelink system From the list Livelink_internal lt Back Next gt OK Help Fig 41 Specifying the Livelink system Confirm by clicking the Next button Specifying location in Livelink In the following dialog box you select the Livelink folder for the new docu ment Livelink Integration Manual 147 Chapter 4 Livelink WCM Server Content Client Microsoft Internet Explorer Please select a Livelink object Livelink Enterprise Eg Accounting amp Finance 5 Company News Channel Eg Company wide Discussions E Development Eg Human Resources
80. client Edit principals i e users and groups system administrator The principals must be able to access the website created in the previous step They also need the appropriate functional areas and object rights See chapter 2 Common User Administration Optional Create JSP pages in order to use Livelink objects such as news and discussions in a website web designer See chapter 3 Livelink Functions in a Website Optional Add relators editors The editors can continue to use Livelink as their authoring environment See chapter 4 Livelink Contents in the Content Client Livelink Integration Manual 13 Chapter 1 About this Manual This manual describes the different areas that the Livelink integration covers The description is based on Livelink Enterprise Server 9 2 1 The manual is intended for editors web designers and programmers who set up new websites or manage and extend existing websites with Livelink WCM Server in order to publish documents and other Livelink content in an intranet extranet or Internet presence administrators managing the system environment for the websites and integrating the WCM system with an existing Livelink installation In addition to this Integration Manual the following sources provide infor mation 14 Livelink WCM Server Installation Manual This document describes how to install the WCM system and configure web servers and appli cation
81. d View the subordinate objects of a WCM object Object list view My objects and My work list views Template structure view Use import functions Use search functions View the Livelink metadata dialog box Default object rights These settings are used as preset access rights when a user is added to the list of persons authorized to access an WCM object in the Content client Livelink Integration Manual 69 Chapter 2 70 If you want to change one or several default object rights click Yes object right is explicitly allowed No object right is explicitly forbidden or the empty entry object right not set in the drop down list of the right The following table gives an overview of the actions you can perform on WCM objects and the required access rights For detailed infor mation on object rights refer to the Content Client User Manual chapter Concepts Table 5 Actions and required default object rights Action Required object rights Add object Read Create Change object for the parent topic Delete object Read Delete Change object Submit object Read Change object Edit an object check out change check in Read Change object Change an object s metadata Change an object s references Read Change metadata Read Change metadata Rename object Move object Read
82. d Releasing Relators on page 150 Livelink WCM Server Livelink Contents in the Content Client Livelink Integration Manual 165 166 Livelink WCM Server CHAPTER 5 Livelink Search in the WCM System The Search Server Connector for Livelink enables you to use the search engine integrated in Livelink for searching WCM managed websites Several scenarios are possible Scenario 1 Searching website contents Livelink is able to index contents from websites which are managed by the WCM system For this purpose an internal collection is added in the WCM system which forms the basis for searching the contents in a WCM managed website m Scenario 2 Searching Livelink contents An existing Livelink slice can be added as an external collection in the WCM system In this way you can search Livelink contents in a WCM managed website m Scenario 3 Searching other document sets You can also index documents which are neither managed with Livelink nor with a WCM system The external collection created in the indexing process can be searched in a WCM managed website Livelink Integration Manual 167 Chapter 5 This chapter deals with the following topics technical concepts of the search engine integration see the following section setting up the Livelink search fora WCM system see section Configuring the Livelink Search for the WCM System on page 171 permissions for displaying search results see
83. d gt User lt td gt lt td gt Created lt td gt lt td gt Modified lt td gt lt tr gt Livelink Integration Manual 103 Chapter 3 Sorting within a RepositoryMap is very flexible Sorting always considers the attribute type Thus you can sort the entries by date values in ascending or descending order The RepositoryMap can be also be sorted by several attributes For more information refer to the Javadoc of the RepositoryMap class 26 lt show all collected children see above sorted by name 27 RepositoryIterator iter childrenMap sort LivelinkObject NAME 28 while iter hasNext 29 RepositoryEnty entry iter nextEntry 30 retrieve some metadata of the current children 31 LivelinkId llid LivelinkId entry getValue LivelinkObject META_LLID 32 LivelinkObjectType type LivelinkObjectType entry getValue LivelinkObject META_OBJECTTYPE 33 StringValue title StringValue entry getValue LivelinkObject META_NAME 34 StringValue comment StringValue entry getValue LivelinkObject META_COMMENT 35 LivelinkUser user LivelinkUser entry getValue LivelinkObject META_USERID 36 DateValue create DateValue entry getValue LivelinkObject META_CREATEDATE 37 DateValue modified DateValue entry getValue LivelinkObject META_MODIFYDATE 38 generate a URL depending on objecttype 39 String url null 40 if type getSubType LivelinkObjectType SUBTYPE_DOCUMENT 41 url VIP
84. des a function for adding items in the Livelink folder Scenario The training department of your company manages all training materials in Livelink These documents are organized in a folder structure You want to provide personalized access to these folders on the website Also you want to enable the Training staff to add new documents in the folders via the website Procedure 1 The example implements a navigation for the Livelink folder structure in an Explorer like style The documents within the current folder are displayed in a list browser jsp Clicking the document title displays the content of the document see section Displaying the Content of Livelink Objects show jsp on page 98 2 On the browser jsp page the users can click a link referring to the form jsp form in order to add documents to the current folder create jsp Navigating Recursive Livelink Folder Structures browser jsp The JSP page consists of two parts One part displays the folder structure including a navigation the other part displays a list of the documents in the current folder see the following section You can use a table for instance to place the two parts on the JSP page 100 Livelink WCM Server Livelink Functions in a Website The JSP page receives the current Livelink folder in the request param eter navNodeld First the page retrieves the current folder s parent folder and generates a link to this parent folder In thi
85. e gt lt h2 gt 40 lt h3 gt lt user getFirstName gt lt user getLastName gt lt user getName gt lt h3 gt 41 lt p gt created lt date format null medium gt lt p gt 42 lt p gt lt content gt lt p gt 43 lt hr gt A recursive call of the generateOut method generates the complete hier archical structure The topicId serves as the root element for the display Below the hierarchical structure a button for adding a reply is written to the JSP page 44 lt generate a tree for the current topic 45 out printIln generateOut 1lObjBean llTopic param 0 46 47 generate param to add a reply to the selected node 48 param amp nodeId nid 49 gt 50 lt input type button name Add Reply onClick location href form jsp lt param gt gt 51 Displaying a Form for Adding a Topic or a Reply form jsp In this form users can enter the information required for adding a topic or a reply The form contains input fields for title and content The node IDs of the discussion and a discussion entry are passed as parameters to the form If no node ID for a discussion entry is passed a new topic is created within the discussion If a node ID is passed a reply to the passed ID is created The create jsp page that is called by form jsp creates the topic or reply 1 retrieve and check request parameter 2 String dId request getParameter discussionId
86. e username LivelinkUser password livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp Livelink Integration Manual 213 Chapter 5 GetSearchEngineMetadata GetSearchEngineMetadata returns information on the available index regions of the slice in the Livelink Search server These regions are defined when configuring the Livelink search see section Displaying Index Regions in Livelink on page 187 Example GetSearchEngineMetadata livelinkURL http livelinkserver company example livelink livelink exe username LivelinkUser password livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp Query Query performs a search in the slice Table 17 Parameters of the command line tool Query Parameter Description collection Name of the internal collection that is to be searched This parameter or the parameter al1 must be specified all Enter true to search the slice This parameter or the parameter collection must be specified query String to be found batchNr Batch number If the batch number is larger than 1 the first n batch size documents of a search result are skipped 214 Livelink WCM Server Livelink Search in the WCM System Parameter Description batchSize Batch size Maximum number of documents to be returned as search result Problems and Solutions Problem
87. e 21 Fig 2 Specifying the user administration when installing the WCM system 22 Fig 3 Logging in to the Admin client 27 Fig 4 User administration items in the Admin client 30 Fig 5 Finding principals in the Admin client 32 Fig 6 Stored users in the Admin client 33 Fig 7 Adding a user with the Admin client 35 Fig 8 Modifying settings of a user in the Admin client 36 Fig 9 Assignments of a user in the Admin client 37 Fig 10 Stored groups in the Admin client 41 Fig 11 Adding a group in the Admin client 42 Fig 12 Assignments of a group in the Admin client 44 Fig 13 Available functional areas 48 Fig 14 Adding a functional area 49 Fig 15 Settings of functional areas 50 Fig 16 Website assignments 53 Fig 17 Logging in to the Livelink system 54 Fig 18 Finding principals in Livelink 58 Fig 19 Users found in Livelink 59 Fig 20 Users stored in Livelink 60 Fig 21 Adding a user in Livelink 62 Fig 22 Editing user information in Livelink 65 Fig 23 Groups stored in Livelink 73 Fig 24 Adding a group in Livelink 74 Fig 25 Editing group information in Livelink 74 6 Livelink WCM Server Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig Fig 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
88. e accessed by any principal Choose Collect orphan objects on the Tools menu to assign such objects to a user A group or role with administration rights can only be deleted by users that have the right Change administration rights 46 Livelink WCM Server Common User Administration Managing the Rights of the Principal World The principal World represents all users of the WCM system Technically speaking it is a group The administration rights of this principal are valid for all users of the WCM system in addition to the administration rights that have been set for the individual users or for the assigned group or role Note By default all users i e World have only access to the user administration in the Admin client We recommend that you do not change this setting in order to reserve access to the configuration and system administration to administrators When you modify the administration rights of the principal World you proceed in the same way as for users and groups The online help of the Admin client provides an overview of the adminis tration rights Managing Functional Areas Functional areas perform two essential tasks m They determine which types of objects the users may add check out and check in Some functional areas such as Basic are by default assigned to object types Only users that have the corresponding functional area can add check in and check
89. e discussion of the topic and of the currently selected entry The generateOut method generates the hierarchical structure The method traverses the structure of the passed LivelinkDiscussionEntry instance and generates a link for each element Each element is indented according to its level in the hierarchy wne ON DUN lt Generate an entry for the tree Will be called recursively static String generateOut LivelinkObjectBean 110bjectBean LivelinkDiscussionEntry 110bj String param int depth get required data for the given object int width depth 15 15 px per level indention LivelinkId 1lId 110bj getLivelinkId LivelinkUser user 110bj getUser Livelink Integration Manual 115 Chapter 3 10 11 12 13 15 16 17 18 19 20 DateValue date DateValue 110bj getAttribute LivelinkObject META_CREATEDATE String title 110bj getName user getName date format null short String ret lt span width width gt amp nbsp lt span gt lt a href VIPURL i param amp nodeId 1llId getNodeId gt title lt a gt lt br gt iterate through all replies and call this method List 1 110bj getReplies for int i 0 i lt l size i LivelinkId id LivelinkId 1 get i LivelinkDiscussionEntry obj LivelinkDiscussionEntry 1llLObjectBean get id if obj null ret generateOut ll0bjectBean obj para
90. e gauss util StringOperator replace story n lt br gt 9 String headline 11Current getHeadline 10 LivelinkId imgId 11Current getImagelId 11 String imgAlt llCurrent getImageAlt BWNP ON DWM 12 LivelinkUser user 11Current getUser 13 show current entry 14 gt 15 lt h1 gt lt 11Current getName gt lt h1 gt 16 lt h2 gt lt headline gt lt h2 gt 17 lt table width 100 gt 18 lt tr gt lt td width 80 style text align justify gt lt story gt lt td gt 19 lt if an image is assigned to this news show image 20 if imgId null 21 gt 22 lt td width 20 valign top gt lt img src show jsp nodeld lt imgId getNodelId gt alt lt imgAlt gt gt lt td gt 23 lt gt 24 lt tr gt lt table gt lt table gt 25 lt show all attachements to this news instance 26 List a 11Current getAttachments 27 for int i 0 i lt xa size i 28 LivelinkId ald LivelinkId a get i 29 LivelinkObject a0bj 110bjBean get alId 30 if aObj null 31 String attImgUrl VIPDEPLOYMENT_URL aObj getImageUrl 32 gt 33 lt tr gt lt td gt lt img src lt attImgUrl gt title lt aObj getTypeName gt gt lt td gt Livelink Integration Manual 111 Chapter 3 34 lt td width 100 gt lt a href show jsp nodeld lt aObj getLivelinkId getNodelId gt target Livelink_cont
91. e modify users are allowed to delete the users they create To delete a user in Livelink 1 Choose Users amp Groups on the Enterprise menu 2 Use the search functions on the Users and Groups page to find the user see section Finding Principals in Livelink on page 57 Livelink Integration Manual 71 Chapter 2 3 Click the user s Edit link in the Actions column 4 Click the Delete User button 5 Confirm the security prompt by clicking the OK button The user is removed from all groups of which the user was a member The user s profile is not removed from the database but is marked as deleted so that the user s information will still be displayed when viewing audit logs and item permissions Managing Groups in Livelink Notes The WCM system differs between groups and roles whereas Livelink only provides groups For this reason the WCM roles are represented by Livelink groups Thus you cannot distinguish between WCM groups and roles in Livelink Use the Admin client for editing roles To open a list of the groups that exist in the Livelink system Choose Users amp Groups on the Enterprise menu On the Users and Groups page click Group Name in the Find drop down list and click the Find button Directly after the installation of Livelink only the DefaultGroup exists By default this is the department group of the Admin user 72 Livelink WCM Server Common User Administration a 5
92. e section Submitting and Releasing Relators on page 150 Note A relator can only be updated automatically if its status is either changed rejected released or delayed release If this requirement is not met use the appropriate staging action to change the relator s status After this you can adapt the relator to the modified Livelink object by choosing Object Synchronize Fixed version f you click this radio button the Livelink folder relator will be based on the current version of the Livelink folder When the folder s metadata change in the Livelink system the associated Livelink folder relator remains unchanged If an object is added to the Livelink folder a new relator representing this object is not automati cally created However the relator for an object will be deleted if the object is removed from the Livelink folder You can adapt the relator manually via the Livelink metadata dialog box see section Modifying Livelink Metadata on page 155 Confirm your entries by clicking the OK button Entering a remark In the following dialog box you may enter information for the logs of the individual relators Confirm your entries by clicking the OK button The WCM system creates the relators and shows them in the Navigation area Their status is changed For the relators to become visible in the published website you must submit them After this the relato
93. eas allow you to control which types of objects the users may create check in and check out as well as which views dialog boxes and functions are available to them in the Content client See section Assigning Functional Areas on page 51 3 Assign default object rights to groups Livelink Integration Manual 23 Chapter 2 For each principal you can define default access rights for website objects The object rights determine which actions Read Change metadata Release etc a user can perform by default on a WCM object to which the user is assigned See section Modifying the Assignments of a Group or Role in the Admin Client on page 43 4 Repeat steps 1 to 3 for individual users if required You can either use the Admin client or the Livelink user administra tion to make the user assignments Admin client m assigning websites see section Website Assignments on page 52 assigning functional areas see section Assigning Functional Areas on page 51 assigning default object rights see section Modifying User Assignments in the Admin Client on page 37 Livelink All assignments are made in the user settings see section Settings on the WCM tab on page 66 5 Assign administration rights for the WCM system Access to the administration and configuration of the WCM system should be reserved to selected users You can grant administration rights to us
94. eck in This makes the changes visible in the Edit view The object is combined with the template again and is available for further editing Check out Staging action of Livelink WCM Server The content of a WCM object can only be edited after the object has been checked out A checked out object is locked for access by other users The changes to the object do not become available in the Edit view until the object has been checked in Collection An index for a document set is known as a collection There are internal and external collections An internal collection is based on a document set managed by a WCM system An external collection by contrast is based on a document set supplied by any external system Command line tools The command line tools can be used to perform indexing actions for external collections They also make it possible to access information on external and internal collections and on the Index system used Data storage view The data storage view of a server refers to the aspects of the WCM objects that are currently available Edit view QA view Production view The data storage view available on a server is determined in the routing settings of the website Deployment Deployment is the distribution of data The deployment of Livelink WCM Server performs two main tasks first generating pages from the WCM objects stored in the database and distributing the Livelink Integration Manual 219
95. ect release M Dynamic I Filter edit M Fiter standard I Form M Import a Inteligent templates M Livelink O Log dialog v References dialog M Search M view My objects I view Object list E Yiew Subordinate objects Oo View Template structure M workflow Default object rights ote vo Read Yes x Change object Yes Delete Yes E Move and copy Yes Release No Change metadata Yes v Change rights No x Read production Yes _ Apply Reset Cancel Fig 22 Editing user information in Livelink Livelink Integration Manual 65 Chapter 2 5 6 Make the desired changes For information on the individual fields on the General and Personal tabs refer to the Livelink online help The settings on the WCM tab are described in the following section Click the Apply button Settings on the WCM tab 66 WCM access If you want to block the user s access to the WCM system clear this check box In this way you prevent a user from accessing the WCM system without having to delete the user profile The user can still log in to Livelink Trusted login Here you can define whether this user is allowed to perform a trusted login If you select this check box the user does not need any further authentication for accessing other WCM products after initial login to the WCM system Language the preferred language of the user Click the desired entry in the Language drop down list
96. ects no statistics of nor has any validity for any existing company This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit http www openssl org and software developed by the Apache Software Foundation http www apache org Trademarks IXOS IXOS SOFTWARE AG SAP R 3 and SAP ArchiveLink are registered trademarks of SAP AG Microsoft Microsoft Windows NT and the names of further Microsoft products are registered trademarks of Microsoft Corporation Acrobat Reader Copyright 1987 Adobe Systems Incorporated All rights reserved Adobe and Acrobat are trademarks of Adobe Systems Incorporated which may be registered in certain jurisdictions Siebel isa registered trademark by Siebel Systems Inc Other product names are used only to identify the products and they may be registered trademarks of the relevant manufacturers Copyright 2006 Gauss Interprise AG Hamburg Gauss Interprise Inc Irvine California All rights reserved worldwide This document and the related software are property of Gauss Interprise AG or its suppliers and protected by copyright and other laws They are distributed under licenses restricting their use copying distribution and decompilation Neither receipt nor possession of this document confers or transfers any right to reproduce or disclose any part of the contents hereof No part of this document may be reproduced in any form by any means withou
97. eleting a User in Livelink on page 71 Adding a User in Livelink To add a user in Livelink 1 Choose Users amp Groups on the Enterprise menu 2 On the Users amp Groups page choose User on the Add New Item menu 3 Define the settings for the user on the Add New User page Livelink Integration Manual 61 Chapter 2 Log in Name jstein Department rain sts iY Password pe ooo Verify Password paeet First Name Peha o Middle Initia F Last Name Btein Title E mail fjoshua stein company example Phone _ Fax Se Office Location Time Zone z Privileges La Log in enabled public Access enabled m Can create modify users F can create modify groups I User administration rights System administration rights Submit _Reset Fig 21 Adding a user in Livelink For detailed information on the individual fields refer to the Livelink online help 4 Click the Submit button 62 Livelink WCM Server Common User Administration Notes Provided that the user added to Livelink has the privilege Log in enabled the user can also log in to the WCM system as the WCM access is enabled by default In the WCM system the user initially has the access rights Read and Read Production m The log in name is used as the user ID in the WCM system A WCM user must have a name in addition to the user ID For users who only have a log in name in L
98. ent 42 group Livelink 73 group to group Livelink 75 internal collection Enterprise Server 9 2 1 182 internal collection Enterprise Server 9 5 0 197 Livelink object as WCM object 131 relator 134 relator with Livelink document 144 role Admin client 42 user Admin client 34 user Livelink 61 user to group Livelink 75 AddDirectory 210 AddDocument 209 Admin client filter functions 31 administration rights groups roles 45 users 37 World 47 API Portal Manager API 91 WCM Java API 92 Livelink Integration Manual application search websites 204 application example channel in website 108 discussion as FAQ 120 discussion in website 113 integrate folder content in a website 95 Livelink browser 100 poll on website 123 application examples 95 assign functional areas to principals 51 websites to principals 52 assignments functional areas 51 groups Admin client 43 roles Admin client 43 users Admin client 37 websites 52 automatic synchronization 82 B beans for Livelink integration 91 Cc channel 108 integrate in website application example 108 collection add external Enterprise Server 9 2 1 184 add external Enterprise Server 9 5 0 199 add internal Enterprise Server 9 2 1 182 227 Index add internal Enterprise Server 9 5 0 197 external 182 197 internal 182 197 command line tools AddDirectory 210 AddDocument 209 configuration file 206 DeleteDirectory 211 DeleteDocument 209
99. ent gt lt aObj getName gt lt a gt lt td gt 35 lt td gt lt aObj getContentSize gt lt td gt lt tr gt 36 lt 37 gt 38 lt table gt 39 Aas The procedure for adding news or channels in Livelink corresponds to adding documents see section Adding the Document create jsp on page 106 You write a form for entering the required information and create a JSP page which interprets the form data and adds the news items or channels via the LivelinkObjectBean The interface for adding channels is createChannel parentId title comment imageld the interface for adding news is createNews parentId title comment imageId headline story effective expired Integrating Livelink Discussions in a Website Discussions belong to the frequently used Livelink features Livelink discussions allow users to work together collaboratively to resolve issues and problems they encounter while working on projects Thanks to the Portal Manager API this Livelink feature can also be used in a website Livelink makes a distinction between the actual discussion object and the entries contained in the discussion object The entries consist of Topics and Replies to the topics The API provides methods for creating new topics and replies In this way the Portal Manager API enables you to set up interactive discussion forums and to use the WCM functionality to apply your corpo rate design to the discussion L
100. ent client 205 in websites 204 index regions Enterprise Server 9 2 1 186 index regions Enterprise Server 9 5 0 202 install Search server Enterprise Server 9 2 1 173 install Search server Enterprise Server 9 5 0 190 Livelink search for the WCMS 171 permissions 203 prepare indexing Enterprise Server 9 2 1 177 principals Admin client 31 principals Livelink 57 with Livelink Enterprise Server 9 2 1 171 with Livelink Enterprise Server 9 5 0 188 XML Activator Enterprise Server 9 2 1 178 XML Activator Enterprise Server 9 5 0 193 231 Index set up automatic synchronization 82 common user administration 19 Livelink search 171 search with Livelink Enterprise Server 9 2 1 171 search with Livelink Enterprise Server 9 5 0 188 settings edit user information Admin client 36 edit user information Livelink 64 functional areas 50 group Admin client 43 group Livelink 74 role Admin client 43 submit relator 152 T tab General edit 64 tab Personal edit 64 tab WCM edit 64 temporary directory 184 199 U update relator manually 162 Update Edit version automatically folder relator 142 relator 137 user administration common 19 functions Admin client 30 in Livelink 54 in the Admin client 26 install module 20 232 Livelink 19 set up common 19 user profile modify 64 user profile Livelink 64 users administration rights 38 assign functional areas 51 assign websites 52 assignments Admin c
101. er company example livelink livelink exe username LivelinkUser password Livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp sourceDir D InternetSite baseURL http wcmserver company example InternetSite 210 Livelink WCM Server Livelink Search in the WCM System DeleteDirectory DeleteDirectory removes the documents of a directory from the collec tion The directory must have been added to the collection using AddDirectory Table 14 Parameters of the command line tool DeleteDirectory Parameter Description sourceDir Absolute path in the file system to the directory whose documents are to be removed from the collection The directory must have been added using AddDirectory baseURL Fully qualified URL of the directory to be removed from the collection The web server uses this URL to access the directory Example DeleteDirectory livelinkURL http livelinkserver company example Livelink livelink exe username LivelinkUser password livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp sourceDir D InternetSite baseURL http wcmserver company example InternetSite Livelink Integration Manual 211 Chapter 5 GetAvai LableCol lections GetAvailableCollections returns a list of all collections contained in the specified slice The number of documents per collection is also returned Example GetAv
102. er has voted already and if preview is explicitly allowed for the poll 21 22 23 lt determine ContextId of the current user ContextId cid SessionBean getCurrentContextId request instantiate LivelinkPoll object LivelinkId llid new LivelinkId Integer parseInt request getParameter Llid LivelinkPoll poll LivelinkPoll lob get 11Id if poll null show name and comment gt lt h1 gt lt poll getName gt lt h1 gt lt h2 gt lt poll getComment gt lt h2 gt lt hr gt lt load poll results LivelinkPollResults results poll getResults cid int votingsTotal results getTotalNumberOfVotings DecimalFormat decfPerc new DecimalFormat 0 00 gt lt h2 gt Total number of participants lt votingsTotal gt lt h2 gt lt h2 gt Instructions lt poll getInstructions gt lt h2 gt lt table gt lt iterate through the questions for Iterator qiter poll getQuestions iterator riter results getResultsList iterator qiter hasNext Question question Question qiter next List choices question getChoices List votes List riter next gt lt tr gt lt td colspan 4 gt lt question getQuestion gt lt td gt lt tr gt The questions and the corresponding answers of a poll are complemented by statistical information and illustrated by graphics 25 26 27 29 30 lt for Iterator citer choices iterator viter votes i
103. er is not specified the file is expected to be in the current directory and to have the name commands properties The parameter cannot be specified in the properties file It is optional livelinkURL URL URL to the Livelink server which is to perform the indexing and to process the search requests username User user for processing search requests in the Livelink system The user must have read access to the slices password Password password for processing search requests in the Livelink system slice Livelink slice slice name xmlActivatorDir XML Activator directory The command files created in the temporary directory will be moved to this directory tempDir Temporary directory The WCM system uses this direc tory for generating the command files for the XML Activator Producer process In this way the XML Acti vator receives instructions when a WCM object changes The instructions refer to how to process the changes e g re index the object or remove the object from the index 208 Livelink WCM Server Livelink Search in the WCM System AddDocument AddDocument is used to add a single document specified by its URL to an external collection Table 11 Parameters of the command line tool AddDocument source Absolute path in the file system to the document that is to be added url Fully qualified URL of the document that is to be added Example AddDocument lLivelinkURL ht
104. ers groups and roles See sections Modifying User Assignments in the Admin Client on page 37 and Modifying the Assignments of a Group or Role in the Admin Client on page 43 For detailed information on how to develop an access strategy for the WCM system refer to the Livelink WCM Server Administrator Manual chapter Concepts 24 Livelink WCM Server Common User Administration Accessing Several Livelink Servers Currently the WCM User Administration module does not support access to several Livelink servers from the same Admin server as it is possible with LDAP servers Each Admin server can only access the user adminis tration of exactly one Livelink server For information on managing objects from several Livelink systems in one WCM system refer to section Configuring Multiple Livelink Systems on page 86 Accessing Several WCM Systems Currently the WCM User Administration module does not support the integration of more than one WCM system with a Livelink server s user administration Nevertheless you can configure the WCM systems in such a way that they access the user administration of the same Livelink server In this case please consider the following m The responsible Admin server automatically updates the information on the available websites and functional areas in Livelink each time the information is changed in one of the connected WCM systems This means that the information on the W
105. erview shows the icons for creating and removing assignments between the items 5 e e 44 Users From the list of stored users you can select which users are to belong to a certain group or role Functional areas The functional areas are used to deter mine which types of objects the users may add check out and check in as well as which dialog boxes and func tions are available in the Content client If you assign functional areas to a group or role all users belonging to this group or role get the respective rights Websites If you assign a group or role to a website the respective users can access the objects of this website via the Content client The exact access rights depend on the group and role settings the assigned functional areas and the rights settings of the individual WCM objects Livelink WCM Server Common User Administration a Default object rights For each group or role you can set ST the default object rights for editing WCM objects These settings are used as preset access rights when a group or role is added to the list of persons authorized to access an object in the Content client Administration rights Here you determine the rights of the group or role for the administration of the WCM system The different rights can be assigned individually In this way you can control precisely which settings the assigned users can view and what changes they can make In accor dance wit
106. essing Livelink This chapter provides application examples to illustrate the usage of these APIs The chapter deals with the following topics m preparations for using Livelink functions in a website see the following section m configuring multiple Livelink systems see section Configuring Multiple Livelink Systems on page 86 overview of the Portal Manager API and WCM Java API functions for using Livelink objects see section Overview of API Functions on page 91 examples for programming with the Portal Manager API and the WCM Java API see section Application Examples on page 95 Livelink Integration Manual 81 Chapter 3 Preparations Before you can use Livelink functions in your website you must take the following steps 1 Install the Livelink module WCM Kernel Integration see the following section 2 Activate the Livelink functions for the website see Activating the Livelink Functions for the Website on page 83 3 Add a Livelink pool see Adding a Livelink Pool on page 84 4 Assign the Livelink pool to the master Content server see Assigning the Livelink Pool to the Master Content Server on page 85 The individual steps are described in the following sections Installing the WCM Kernel Integration Module The Livelink module WCM Kernel Integration enables Livelink WCM Server to access Livelink objects It is also responsible for automatically updati
107. ete user entry Notes m If you delete a user after you have added this user to the list of persons authorized to access a WCM object in the Content client this change is not adopted automatically You must update the list of authorized persons manually As a result of deleting users there may be WCM objects that can no longer be accessed by any principal Choose Collect orphan objects on the Tools menu to assign such objects to a user A user with administration rights can only be deleted by users that have the right Change administration rights Livelink Integration Manual 39 Chapter 2 Managing Groups and Roles in the Admin Client With Livelink WCM Server you can assign the users of a website to groups and control access to the website objects by assigning rights to these groups Usually groups are tied to organizational structures such as departments or projects e g Marketing or Sales Roles offer another way of classifying users Unlike groups roles are task related e g IntranetAdmin or Editor For general information on controlling access by means of groups and roles refer to the Livelink WCM Server Administrator Manual chapter Concepts Notes Livelink provides only users and groups no roles For this reason the WCM roles are represented by Livelink groups For each Livelink group the information is stored whether this group is a group or a role in the WCM system
108. flow see section Creating an XML Activator Producer Data Flow in Livelink on page 178 172 Livelink WCM Server Livelink Search in the WCM System 4 WCM system Add collections see section Adding an external collection for another type of document set on page 185 5 Livelink system Start the XML Activator process see section Starting the XML Activator Process in Livelink on page 186 Installing Livelink Search Servers in the WCM System Note For detailed information on installing a WCM system refer to the Livelink WCM Server Installation Manual During the installation of a WCM system the dialog box Search server opens On the Livelink tab of this dialog box you can add the desired number of Livelink Search servers Livelink Integration Manual 173 Chapter 5 fal Livelink Web Content Management Server 9 5 0 Search server Please enter the parameters of the Search servers to he installed Hep Canel lt Back Fig 48 Search servers in the WCM installation program 1 Click the Livelink tab 2 Click the Add Search server button This opens a tab on which you can make the settings for the Livelink Search server 174 Livelink WCM Server Livelink Search in the WCM System falLivelink Web Content Management Server 9 5 0 Search server Please enter the parameters of the Search servers to 4 be installed A ContentMiner Livelink Lu
109. general parameters 208 GetAvailableCollections 212 GetSearchEngineMetadata 214 ListSources 212 Query 214 RemoveCollection 213 commands properties 206 common user administration in general 19 installation 19 configuration multiple Livelink systems 86 Content client search 205 D delete functional area 52 group Admin client 46 group Livelink 79 relator 163 role Admin client 46 user Admin client 39 user Livelink 71 DeleteDirectory 211 DeleteDocument 209 discussion integrate in website application example 113 provide as FAQ application example 120 228 E edit content of a relator 154 Livelink metadata 155 external collection 182 197 add Enterprise Server 9 2 1 184 add Enterprise Server 9 5 0 199 F FAQ application example 120 file xml tok 177 filter functions Admin client 31 Livelink 57 find changed relator 150 Fixed version folder relator 143 relator 138 folder relator 131 add 139 functional areas assign 51 delete 52 manage 47 new 49 settings 50 functions user administration Admin client 30 G GetAvailableCollections 212 GetSearchEngineMetadata 214 group leader set Livelink 77 unset Livelink 78 Livelink WCM Server groups add Livelink 73 add group Livelink 75 add user Livelink 75 administration rights 45 assign functional areas 51 assign websites 52 assignments Admin client 43 change name Livelink 78 delete Admin client 46 delete Livelink 79
110. h the rights assigned the Admin client only displays those views and functions that the assigned users are entitled to use For example if the group or role does not have the right to view the configuration this view is hidden in the Admin client The online help of the Admin client provides an overview of the adminis tration rights Note If a user has individual administration rights in addition to the administration rights due to the group or role membership the rights are added up Moreover all users have the administration rights of the prin cipal World see section Managing the Rights of the Principal World on page 47 Livelink Integration Manual 45 Chapter 2 Deleting a Group or Role in the Admin Client To delete a group or role in the Admin client 1 Select the group or role via User administration Groups or Roles group name role name 2 Choose Delete group or Delete role on the context menu or click the corresponding icon Icon for deleting a group Icon for deleting a role Le 3 Confirm the security prompt by clicking the Yes button Notes m f you delete a group or role after you have added it to the list of persons authorized to access a WCM object in the Content client this change is not adopted automatically You must update the list of authorized persons manually As the result of deleting groups or roles there may be WCM objects that can no longer b
111. hat are required to control the commands The parameters determine which WCM server is to process the command and they also contain necessary information about the actual indexing action The command parameters that specify the WCM server are identical for all command line tools For this reason you can simplify the process of calling the command line tools by defining these default parameters in a configuration file and by specifying this file as a call parameter Note Nearly all command specific parameters can be specified in the configuration file We recommend however that you include only those parameters in the file that are rarely subject to changes The commands properties Configuration File By default the configuration file commands properties is saved with the command line tools in the directory WCM installation directory livelinksearch Search server name tools during the installation The file contains default parameters corresponding to the information specified during installation The configuration file looks as follows configuration properties of the Livelink search server options in command line have a higher priority 206 Livelink WCM Server Livelink Search in the WCM System Incoming directory of the XML Activator Data Source xmlActivatorDir F InternetSite_in Temporary directory tempDir F InternetSite_temp URL of Livelink CGI LivelinkURL http livelinkserver company example Li
112. he Admin client Livelink Integration Manual 33 Chapter 2 The following functions are available to you for managing users in the Admin client m adding a user see the following section m editing user information e g the e mail address see section Editing User Information in the Admin Client on page 36 editing user assignments see section Modifying User Assignments in the Admin Client on page 37 deleting a user from the user administration see section Deleting a User in the Admin Client on page 39 Note Changes to a user s settings do not take effect in the WCM system until the user logs in to the WCM system again As an administrator you can log out users via the System administration for detailed information refer to the online help of the Admin client Adding a User in the Admin Client To add a user with the Admin client 1 In the User administration view select the item Users 2 Choose New user on the context menu or click the corresponding icon g Icon for adding a user 3 In the New user dialog box make the settings for the user 34 Livelink WCM Server Common User Administration I x Name Joshua F Stein UserID jstein E mail joshua stein company example Language English USA v Substitute hshepard wl Password changed Cl J Trusted login vi WCM access ox cma e Fig 7 Adding a user
113. hout Java LDAP Lightweight Directory Access Protocol The LDAP is based on the X 500 standard and is supported by most major software manufacturers LDAP directory services are used to manage user information Master server Only master servers have read and write access to the data of a WCM system The master Content server manages website data while the master Administration server manages the configuration and system data of the WCM system See also Server category Metadata Every WCM object has a number of object information assigned to it e g expiration date language These are known as metadata Object Each element of a website is integrated in Livelink WCM Server as a single object Each object is based on an object type such a HTML Livelink Integration Manual 221 Glossary page Object types can be defined in the Admin client or the Content client Object type The specific kind of object e g HTML page HTML template Topic Various properties of the WCM object result from the object type The object type is defined when the object is created There are only a few cases in which it may subsequently be changed Object types can be edited in the Admin client or the Content client Pool The different connections within a WCM system are managed in pools These include for example connections for communication with an LDAP directory service or for communication between the
114. ilable for user defined Livelink meta data e g the attributes of an object category Use the following pattern to form WCM tags for user defined attributes VIPLL category lt category name gt set lt set name gt attribute lt attribute name gt set_no lt number gt item_no lt number gt m category name of the category containing the attribute m set name of the set containing the attribute m attribute name of the attribute for which the WCM tag is created m set_no position of the set in the list of set values item_no position of the attribute value to be shown in the list of attribute values If the attribute to be shown is not of type set the expression becomes simpler VIPLL category lt category name gt attribute lt attribute name gt jtem_no lt number gt 160 Livelink WCM Server Livelink Contents in the Content Client Example For the training materials you created a category named Training Mate rials By means of the attributes of this category you can manage infor mation on the status and the contact person for the materials The attribute set Contact Information of the category contains three attributes in the following order 1 Contact Person 2 E mail 3 Phone number The attribute Phone number may contain two values in the first position the conventional phone number in the second position the mobile phone number General Specifi
115. in To start the web application of an Admin client open your browser and go to the URL of the web application s start page e g http wcmserver company example wcmadminclient index html Immediately after the installation of the WCM system the only user with administration rights is the one you entered during the installation Logging in and out of the Admin client After you have started the Admin client the Login dialog box opens in the language selected for installing the WCM system 26 Livelink WCM Server Common User Administration gt Administration Livelink WCM SERVER User ID Password Cancel Connecting i Fig 3 Logging in to the Admin client Enter your user ID and the corresponding password If this is the first time you start the Admin client after the installation of the WCM system enter the user ID and password of the user who was configured as the adminis trator during the installation process When you log in to the WCM system for the first time you are asked to change your password Note Both user ID and password are case sensitive Correct use of uppercase and lowercase letters is essential For Livelink WCM Server administrator and Administrator are two different users To exit the Admin client choose Quit on the Program menu The connec tion to the Admin server will be closed This may take some time Livelink
116. in Livelink on page 178 Livelink Integration Manual 171 Chapter 5 4 WCM system Add collections see section Adding an internal collection for WCM contents on page 182 5 Livelink system Make index regions queryable see section Making Index Regions Queryable in Livelink on page 186 6 Livelink system Start the XML Activator process see section Starting the XML Activator Process in Livelink on page 186 7 Livelink system Display index regions see section Displaying Index Regions in Livelink on page 187 Scenario 2 Searching Livelink contents Realizing this scenario requires the following steps in the WCM system 1 Install Livelink Search server see the following section 2 Add collections see section Adding an external collection for a Livelink slice on page 184 Note The Livelink module WCM Kernel Integration is required to access Livelink objects via the WCM system For information regarding the installation of this module refer to Installing the WCM Kernel Inte gration Module on page 82 Scenario 3 Searching other document sets Realizing this scenario requires the following steps in Livelink and the WCM system 1 WCM system Install Livelink Search server see the following section 2 Livelink system Prepare indexing see section Preparing Indexing on page 177 3 Livelink system Create XML Activator Producer data
117. in a Page Just like WCM metadata you can integrate Livelink metadata in a template or in the page generated for the object and thus use the meta data in a WCM managed website For integrating metadata WCM tags are provided Note For detailed information on WCM tags refer to the Content Client User Manual chapter Working with WCM Tags Livelink Standard Metadata The following table provides an overview of the WCM tags for the most common Livelink standard metadata The file Livelink_WCM_tags html in the directory WCM installation directory examples wemtags contains all Livelink specific WCM tags Table 9 WCM tags for the most common Livelink metadata Metadata item Internal name WCM tag Description comment VIPLL attribute comment File name filename VIPLL attribute filename Created by createdby VIPLL attribute createdby Created createdate VIPLL attribute createdate Modified modifydate VIPLL attribute modifydate MIME type mimetype VIPLL attribute mimetype Object size filedatasize VIPLL attribute filedatasize in byte Livelink Integration Manual 159 Chapter 4 Metadata item Internal name WCM tag Node ID nodeid VIPLL attribute nodeid Version versionnum VIPLL attribute versionnum Version vcomment VIPLL attribute vcomment description User Defined Metadata The WCM tag mechanism is also ava
118. information on working with the Content client refer to the Content Client User Manual Due to the integration of the WCM system with Livelink you can add Livelink objects as WCM objects to a WCM managed website These WCM objects are called re ators They always refer to a certain version of the Livelink object The WCM object type Livelink relator enables you to integrate a single Livelink object in a website the WCM object type Livelink folder relator is provided for integrating Livelink folders Note The Livelink module WCM Kernel Integration is required to access Livelink objects via the WCM system This module is also responsible for automatically updating the WCM object when the asso ciated Livelink object changes For information regarding the installation of this module refer to Installing the WCM Kernel Integration Module on page 82 You can directly access relators in the WCM system e g with the Content client The actual objects however are stored in the Livelink database Relators are treated like normal WCM objects They are subject to the staging of Livelink WCM Server That means there are three views of arelator Edit QA and Production The reference management of Livelink WCM Server is also available for relators Livelink folder relators Livelink Integration Manual 131 Chapter 4 have a special feature As they do not have any content you cannot check out and check in Livelink
119. ion about WCM servers and their configuration Of course you can use the WCM Java API in conjunction with the Portal Manager API In this example the temporary directory of the installation is retrieved in order to store the file passed to the request 21 22 23 24 25 26 27 29 30 31 32 33 34 35 copy uploaded file to temp directory of current WCM server String dirName VipRuntime getCurrentServer getInstallDirectory File separator VipRuntime getCurrentServer getTempDirectory creating tempfile in tempdir file new File dirName fileName copy stream to file inS parseMFD getFileContent uploadParam 0 outS new BufferedOutputStream new FileOutputStream file de gauss io StreamConnector streamCon new de gauss io StreamConnector inS outS streamCon copyAndClose creating Livelink object llobj 110bjectBean createDocument parent title comment file file delete catch Exception e if inS null inS close Livelink Integration Manual 107 Chapter 3 36 37 38 39 40 41 42 43 45 46 47 48 if ourS null outS close if object could be created if llobj null gt lt script lLanguage JavaScript gt location href lt returl gt navNodeId lt Llobj getLivelinkId getNodeId gt lt script gt lt else gt Error creating page lt br gt lt a href onClick javascript history back
120. istinguish between WCM groups and roles in Livelink Use the Admin client for editing roles Finding Principals in Livelink The search functions of the Livelink user administration enable you to quickly find the right entry even with a large number of users and groups To find principals in Livelink 1 Choose Users amp Groups on the Enterprise menu 2 On the Users and Groups page click the desired search parameter in the Find drop down list Livelink Integration Manual 57 Chapter 2 Users and Groups oa ee 03 2004 Livelink Personal Enterprise Tools Help a Workspace 3 Workspace 8 Log out E Contents Favorites G Users amp Groups Settings 2 For This Page starts with Find add New Item z values and click the Find button Find User Last Name i User Last Name To find u User Log in User E mail Group Name Livelink Version 3 2 0 Copyright 1995 2003 Open Text Inc All rights reserved Fig 18 Finding principals in Livelink You can use the following search parameters m User Last Name default setting a User First Name m User Log in m User E mail Group Name 3 Type a search term in the starts with field Notes The value you supply for the search parameter is not case sensi tive For example If you enter ma for the first name of a user information on all users whose first names start with ma or Ma is displayed If y
121. ite ania lt a Fn Fig 58 Specifying the Livelink parameters for an internal collection m Livelink slice slice name Enter the Processes Prefix you speci fied when creating the XML Activator Producer Data Source Note For performance reasons we recommend that you create only one collection per slice You can create several internal collections in a slice In this case however you have to make sure that all entries in a slice have a unique URL XML Activator directory The command files created in the temporary directory will be moved to this directory Enter the path to the shared Incoming Directory that you speci fied when creating the XML Activator Producer Data Source If Livelink and the WCM system are installed on different host computers the directory must be mapped to a network drive on the WCM system s host computer Enter the path accordingly 198 Livelink WCM Server Livelink Search in the WCM System Temporary directory The WCM system uses this directory for generating the command files for the XML Activator In this way the XML Activator receives instructions when a WCM object changes The instructions refer to how to process the changes e g re index the object or remove the object from the index Create this directory on the same physical drive as the XML Acti vator directory Before you can use the new collection for search requests the collection must be synchronized
122. ivator Producer data flow to index information generated by a third party application such as the WCM system To create an XML Activator Producer data flow in the Livelink system 1 Open the Livelink Administration page The URL is of type http livelinkserver company example Livelink livelink exe func admin index 2 Login to the Livelink system as the Admin user and navigate to the Search Administration section Livelink Integration Manual 193 Chapter 5 Search Administration Fig 56 3 Click Configure Search Options Configure the search options that you want to make available to Livelink users This includes Find Similar and Result Themes Edit the System Default Template Configure the appearance of the default search template This template is displayed on the Livelink Search page for all users who have not created personal search templates Reset Search Templates Reset the default search template to its original state and or delete the personal search templates that Livelink users have created Open the XML DTD Volume Add XML DTDs to the XML DTD volume and then set the corresponding XML regions to allow users to search XML data From Livelink Configure Alert E mail Delivery Configure e mail settings for sending Livelink system object alert e mail messages Configure Debug Settings Configure logging information and other diagnostic settings For Livelink Search the Livelink Admin server and the HTML
123. ivelink the log in name is used as both the user ID and the name in the Admin client Livelink provides three fields for specifying the name of a user First Name Middle Initial and Last Name e g Joshua F and Stein The contents of the Name field in the Admin client is built from these name components Joshua F Stein In order to change the WCM administration rights of users you have to use the Admin client A WCM user needs a valid e mail address If you want to use the notification functions of the WCM system you should specify an e mail address for each user in Livelink The Admin client assigns a default e mail address to all users who are stored in the Livelink database without an e mail address For this purpose the system uses the e mail address of the person who is to be notified if the WCM licenses expire or are exceeded This e mail address is not stored in the Livelink data storage To use a different default e mail address you have to edit the KUAF table in the Livelink server s database Use the following SQL command update KUAF set MAILADDRESS default e mail address where TYPE O and MAILADDRESS is null Livelink Integration Manual 63 Chapter 2 Editing User Information in Livelink In Livelink all information about a user is stored in the so called user profile To view the user profile click the user s log in name on the Users and Groups page U
124. ivelink discussions in websites can go well beyond the simple display of the discussions You can also use the Portal Manager API functions to create Frequently Asked Questions FAQs from these discussions 112 Livelink WCM Server Livelink Functions in a Website Scenario Integrating Discussions in a Website The company staff uses discussions to exchange information on general topics These discussion forums are managed in Livelink You want to publish some of these discussions in the intranet The staff members shall be able to take part in the discussions via the intranet Procedure 1 All discussions from a specific Livelink area are shown find jsp The search method of the LivelinkObjectBean is used for this purpose 2 When the user selects a discussion all topics of this discussion are displayed in a list topic jsp 3 When the user selects a topic the replies to this topic are shown hierarchically reply jsp Additionally the contents of the topic or reply is shown 4 Buttons for adding new topics replies are integrated in the topic and reply JSP page respectively form jsp The create jsp page creates these topics and replies The functions described here can also be implemented with fewer JSP pages you will find an example for this in the LiveStart website To make the application examples more comprehensible the LiveStart code is not shown here Showing All Discussions of a Livelink Area find jsp The
125. k as the search string Example Query query query query query query query query contentMinerBean createQuery serverName setSearchString addAdditionalParameter LookFor1i allwords addAdditionalParameter wherel bread butter addAdditionalParameter booleani AND addAdditionalParameter lLookFor2 anywords addAdditionalParameter where2 cheese salad onion For information on the Livelink Search API refer to the Using the Search API guide which is available on the Open Text Knowledge Center https knowledge opentext com Search in the Content client After installing and configuring a Search server the search functions are also available in the Content client To learn more about this refer to the section Filter and Search Functions of the Content client User Manual As with searching websites the Livelink Query Language is used here too Command Line Tools The command line tools are used for managing external collections They perform the following functions m indexing documents for external collections m retrieving information on external collections and on the Index system used Livelink Integration Manual 205 Chapter 5 The command line tools are located in the directory WCM installation directory livelinksearch Search server name tools To run the command line tools you must specify appropriate parameters t
126. kId tempNewsId LivelinkId 1 get i LivelinkNews tempNews LivelinkNews 110bjBean get tempNewsId String comment tempNews getComment DateValue dateValue new DateValue tempNews getDateEffective gt lt tr gt lt td gt lt a href VIPURL nodeId lt tempNewsId getNodelId gt gt lt tempNews getName gt lt a gt lt td gt lt td align right gt lt dateValue format null medium gt lt td gt lt tr gt lt tr gt lt td colspan 2 style text align justify gt lt comment gt lt td gt lt tr gt lt tr gt lt td colspan 2 gt lt a href VIPURL nodelId lt tempNewsId getNodeld gt gt See our news lt a gt lt td gt lt tr gt lt gt lt table gt 110 Livelink WCM Server Livelink Functions in a Website Displaying Single News Items show_channel jsp A single news item is displayed on a JSP page together with all attributes provided by Livelink The icons and attachments of news are displayed by means of the JSP page show jsp described above see section Displaying the Content of Livelink Objects show jsp on page 98 retrieve news instance given through the request parameter int nId Integer parseInt currentNodeld LivelinkNews 11Current LivelinkNews 110bjBean get new LivelinkId nId extracting metadata for display String story 11Current getStory to format the news content replace newlines with HTML tags story d
127. l the Livelink module WCM User Administration see the following section 2 Select a Livelink user administration when installing the WCM system see section Selecting the Livelink User Administra tion on page 22 Livelink Integration Manual 19 Chapter 2 Installing the WCM User Administration Module Notes Installing the module is only required if you want to use the option Livelink for the user administration when installing your WCM system If the Livelink user information is synchronized with an LDAP direc tory service we recommend that you select the LDAP option for the user administration when installing the WCM system In this case you have to use the Admin client for editing WCM specific principal settings as the Livelink user administration does not provide the WCM tab The module must be installed prior to installing the WCM system Procedure 1 20 The WCM User Administration module is supplied as file wcemadm zip This file is located in the livelink directory on the WCM CD Extract the file to the directory Livelink installation directory staging Open the Livelink Administration page The URL is of type http livelinkserver company example Livelink livelink exe func admin index Log in to the Livelink system as the Admin user and go to the Module Administration section Livelink WCM Server Common User Administration Module Administration Install Mod ile
128. led information on the individual fields refer to the Livelink online help 180 Livelink WCM Server Livelink Search in the WCM System For using the Livelink search in the WCM system the following fields are of special importance Process Prefix display name for objects associated with this index When creating a collection use this identifier as slice name m Incoming Directory absolute path to the directory from which the XML Activator Producer process reads the XML files generated by the third party application Create this directory manually If Livelink and the WCM system are installed on different host computers the directory must be shared m Write Directory absolute path to the directory to which the XML Activator Producer process writes the data it extracts Create this directory on the same file system level as the Incoming Directory The path in this field is automatically entered into the other directory fields of the dialog box Operation Tag Enter Operation here Identifier Tag Enter OTURN here 6 Confirm the settings by clicking the Create Processes button The Livelink system creates a new data source folder This folder contains all of the system objects that correspond to a particular index Alias Data Flow Manager and Search Manager Livelink Integration Manual 181 Chapter 5 Adding Collections in the WCM System Note For detailed information on collections refer to
129. lient 37 delete Admin client 39 delete Livelink 71 manage Admin client 33 manage Livelink 60 modify settings Admin client 36 modify settings Livelink 64 new Admin client 34 new Livelink 61 set group leader Livelink 77 unset group leader Livelink 78 using Livelink functions preparations 82 Ww WCM Java API 92 WCM Kernel Integration install 82 install module 82 uninstall 83 WCM tags for Livelink standard attributes 159 for Livelink standard metadata 159 for user defined attributes 160 for user defined metadata 160 WCM User Administration install 20 uninstall 21 websites assign 52 Livelink WCM Server World administration rights 47 X XML Activator create producer data flow Enterprise Server 9 2 1 178 create producer data flow Enterprise Server 9 5 0 193 directory 183 198 processes 168 xmlactiv 177 Livelink Integration Manual Index 233 Index 234 Livelink WCM Server
130. link Integration Manual 87 Chapter 3 lt min gt 2000 lt min gt lt wipe_strategy gt time lt wipe_ strategy gt lt objectcache gt lt principalcache gt lt strategy gt de gauss vip ObjectWiperImpl lt strategy gt lt cache_reduce_interval gt 7200000 lt cache_reduce_interval gt lt class gt de gauss vip DisplacingObjectCache lt class gt lt max gt 20 lt max gt lt min gt 10 lt min gt lt wipe_strategy gt time lt wipe_strategy gt lt principalcache gt lt livelink system gt lt livelink system name Livelink_2 gt lt livelink system gt lt livelink systems gt Table 6 Elements of the livelink systems xml lt Livelink system name Livelink_1 gt Name of the Livelink system lt default gt true lt default gt You can configure one Livelink system as the default Livelink system The LivelinkObjectBean will initially use the default Livelink system lt pooLname gt lt default gt livelink_1 pool lt default gt lt server name Proxy_server gt proxy livelink_1 pool lt server gt lt poolname gt Name of the Livelink pool If more than one Content server accesses the Livelink system you can configure a separate Livelink pool for each Content server 88 Livelink WCM Server Livelink Functions in a Website Element in the XML file Explanation lt rootnodeid gt 123456789 lt rootnodeid gt ID of the entry point into the Livelink system This
131. link provides three fields for the name of a user First Name Middle Initial and Last Name e g Joshua F and Stein The contents of the Name field in the Admin client is built from these name components Joshua F Stein A WCM user needs a valid e mail address If you want to use the notification functions of the WCM system you should specify an e mail address for all users in Livelink The Admin client assigns a default e mail address to all users who are stored in the Livelink database without an e mail address For this purpose the system uses the e mail address of the person who is to be notified if the WCM licenses expire or are exceeded This e mail address is not stored in the Livelink data storage To use a different default e mail address you have to edit the KUAF table in the Livelink server s database Use the following SQL command update KUAF set MAILADDRESS default e mail address where TYPE O and MAILADDRESS jis null Editing user information Editing WCM specific settings 56 Use the ywem tab to edit the WCM specific user settings in Livelink Livelink WCM Server Common User Administration User administration item Description Managing groups Handling of roles The WCM system differs between groups and roles whereas Livelink only provides groups For this reason the WCM roles are repre sented by Livelink groups Thus you cannot d
132. m depth 1 return ret The request parameters discussionId topicId and nodeld are used as parameters for the JSP page topicId identifies the topic to be displayed This topic also serves as the root element for the hierarchical structure The nodeIdis the currently selected discussion entry which is to be displayed The discussionIdis only required for further processing 21 lt 22 String dId request getParameter discussionId 23 String tId request getParameter topicId 24 String nId request getParameter nodeld 25 String param discussionId dId amp topicId tId 26 int topicId Integer parseInt tId 27 LivelinkTopic llTopic LivelinkTopic 110bjBean get new LivelinkId topicId 28 if 11Topic null 29 LivelinkId nodeId new LivelinkId Integer parseInt nId 30 LivelinkDiscussionEntry entry LivelinkDiscussionEntry 1LLObjectBean get nodeld 31 display the selected discussion entry retrieve manipulate 32 content replace newline characters with line breaks 33 String content entry getContent 34 if content length 0 content amp nbsp 35 content de gauss util StringOperator replace content n lt br gt 36 LivelinkUser user 11Current getUser 116 Livelink WCM Server Livelink Functions in a Website 37 DateValue date DateValue entry getAttribute LivelinkObject META_CREATEDATE 38 gt 39 lt h2 gt lt 11Current getNam
133. modules refer to the Livelink online help Activating the Livelink Functions for the Website 1 Launch the Admin client see section Starting the Admin client on page 26 2 Login to the Admin client 3 Select Configuration Websites gt website name 4 Choose Livelink extension on the context menu Livelink Integration Manual 83 Chapter 3 5 Confirm the security prompt by clicking the Yes button On the General tab of the website settings the check box Website extension for Livelink is selected General Routing Name Companylntranet Master Content server JDBC pool Caching Fig 30 Website extension for Livelink As a consequence the two repositories LivelLinkObjectRepository and LivelinkUserRepository the LivelinkApplication application and the Livelink relator object type are automatically created in the WCM system Adding a Livelink Pool 1 In the Admin client select Configuration Pools Livelink 2 Choose New pool on the context menu or click the corresponding icon oe Icon for adding a pool 3 The wizard for adding a pool starts 84 Livelink WCM Server Livelink Functions in a Website The wizard is described in more detail in the online help of the Admin client Assigning the Livelink Pool to the Master Content Server 1 In the Admin client select Configuration gt Servers name of the master Content server Pools
134. ng relators for which the Update Edit version automatically optionis activated when the associated Livelink object changes To install the module 1 The WCM Kernel Integration module is supplied as a file named wemobj zip This file is located in the livelink directory on the WCM CD Extract the file to the directory Livelink installation directory staging 2 Open the Livelink Administration page The URL is of type http livelinkserver company example Livelink livelink exe func admin index 82 Livelink WCM Server Livelink Functions in a Website 3 Log in to the Livelink system as the Admin user and go to the Module Administration section Module Administration Install Mod iles Install any A Livelink modules that are available for installation Uninstall Modules Uninstall any removable Livelink modules that you want to drop Upgrade Modules Upgrade any current Livelink modules For which an upgrade is available Fig 29 The Module Administration section on the Livelink Administration page 4 Click the Install Modules link 5 On the Install Modules page select the check box of the WCM Kernel Integration module and then click the nsta button For further information on installing modules refer to the Livelink online help To uninstall the module In the Module Administration section of the Livelink Administration page select the Uninstall Modules link For further information on uninstalling
135. nk server default 2099 URL URL to the Livelink server which is to perform the indexing and to process the search requests The URL is of type http livelinkserver company example Livelink livelink exe m Use URL for connection Select this check box if you want to use the Livelink server s URL for the connection In this case the entries in the fields Host name and Port will be ignored m User user for processing the search requests in the Livelink system The user must have read access to the slices Notes For the Livelink search you can determine which index regions are displayable see section Displaying Index Regions in Livelink on page 202 These settings are user specific For this reason we recommend that you configure a special user for the Livelink search Enter the information of this user here For further information about permissions for the Livelink search refer to section Permissions for Searching on page 203 Password password for processing search requests in the Livelink system m Name of the assigned server the name of a WCM server that already exists or is to be installed and to which you want to assign this Search server 3 When you have completed all settings for the Search servers confirm the entries by clicking the Next button 192 Livelink WCM Server Livelink Search in the WCM System Creating an XML Activator Producer Data Flow in Livelink You create an XML Act
136. nk system creates a new data source folder This folder contains all of the system objects that correspond to a particular index Shortcut Data Flow Manager Partition Map and Search Manager 196 Livelink WCM Server Livelink Search in the WCM System Adding Collections in the WCM System Note For detailed information on collections refer to the Content Miner Manual Collections are the basis for searching contents in a WCM managed website An internal collection is created from a set of documents that is managed by the WCM system An external collection is based on a docu ment set that is supplied by any external system e g Livelink Adding an internal collection for WCM contents To add a new internal collection to a Livelink Search server in the WCM system 1 Inthe Admin client select Configuration Search servers and mark the desired Search server 2 Choose New intemal collection on the context menu or click the corresponding icon 3 Icon for adding an internal collection 3 Use the wizard for adding an internal collection For Livelink Search servers the following dialog box is especially important Livelink Integration Manual 197 Chapter 5 Anew internal collection xj Livelink parameters Livelink specific parameters are displayed here lt L Livelink slice InternetSite XML Activator directory F lnternetSite_in Temporary directory F itemptnternetS
137. nt The relator is barred for write access by other users the Livelink object will be marked as reserved in the Livelink system Depending on the configuration of the Content client the content of the Livelink object opens in the integrated HTML editor or in the associated editor program 6 Edit the Livelink object in the respective editor 7 Save your changes and close the editor 8 To return the modified relator to the WCM system and unreserve the Livelink object choose Edit Check in or click the appropriate icon es Icon for checking in an object The relator has the status changed A new version is added to the Livelink object For the changes to become visible in the published website you must submit the modified relator which then must be released by Quality Assurance see section Submitting and Releasing Relators on page 150 Modifying Livelink Metadata Objective Each Livelink object has a number of metadata That means that relators have Livelink metadata in addition to the WCM metadata such as Livelink system and Livelink ID You can view and modify the Livelink metadata of relators in the Livelink metadata dialog box You want to edit the Livelink metadata of a relator Livelink Integration Manual 155 Chapter 4 Prerequisites The relator has the status changed rejected released or delayed release You have the access rights Read and Change metad
138. nt Client E Icon for adding an object on the basis of the object type Specifying title file and object type In the first dialog box you specify the file which is to be added to the Livelink system and the name of the new Livelink document Z Object attributes Microsoft Internet Explorer eT ES Specify a title for the object and select the desired object type IF the object is to be created from an existing file also specify this file You may also assign a workflow to the object Title Jadvanced Training File C temp advancedTraining ppt Browse Workflow lt none gt z CGI script Compound object Form instance Livelink relator i Other PowerPoint file Cancel lt Back Next gt OK Help Fig 40 Specifying title file and object type m Title Enter the name for the document in Livelink The Content client uses this name as the relator s title The title is used to identify the relator and is displayed both in the header and in the Navigation area of the Content client Entering a title is mandatory Livelink Integration Manual 145 Chapter 4 Note Titles must not be more than 255 characters long Also you should adapt the length of the title in such a way that the resulting file name meets the requirements of your operating system Under Windows the absolute path to a topic and a generated page may not be longer than 240 and 260 characters respectively m File Spe
139. o Canada N2L 0A1 519 888 7111 If you subscribe to our Customer Assistance Program or would like more information about the support program write to Open Text Corporation s Customer Support at support opentext com or telephone 800 540 7292 or 519 888 9933 Our support hours are Monday through Friday 8 30 a m to 8 p m EST If you have comments or suggestions regarding this documentation write to the Open Text Corporation Publications Group at documentation opentext com For more information about Open Text Corporation s products and services visit our home page at http www opentext com 2006 IXOS SOFTWARE AG Werner v Siemens Ring 20 85630 Grasbrunn Germany Tel 49 89 4629 0 Fax 49 89 4629 1199 eMail office ixos de Internet http www ixos com All rights reserved including those regarding reproduction copying or other use or communication of the contents of this document or parts thereof No part of this publication may be reproduced transmitted to third parties processed using electronic retrieval systems copied distributed or used for public demonstration in any form without the written consent of IXOS SOFTWARE AG We reserve the right to update or modify the contents Any and all information that appears within illustrations of screenshots is provided coincidentally to better demonstrate the functioning of the software IXOS SOFTWARE AG hereby declares that this information refl
140. o button and enter an interval of 1 minute using the drop down lists Note If necessary adapt the interval to the situation in your system Livelink Integration Manual 201 Chapter 5 5 Confirm the entries by clicking the Update button 6 Click the Functions icon of the XML Activator and select Start Displaying Index Regions in Livelink 1 On the Livelink System page click the Processes Prefix Data Source Folder link 2 Click the Functions icon of the Search Manager and select Properties gt Regions 3 Select the Queryable Displayable and Search By Default check boxes for all regions starting with the prefix VIP Confirm by clicking the Update button Choose Search on the Tools menu Click the Display Options button N O oO Ff On the Display Options page select the Display check box for all regions that are to be displayed At least the following regions must be marked VIPoid m VIPcollection 8 Confirm by clicking the Save button 202 Livelink WCM Server Livelink Search in the WCM System Permissions for Searching Each collection is assigned to a Search server In the Search server s configuration you specify a Livelink user including password whose infor mation is used for checking the permissions for search requests in the Livelink system see section Installing Livelink Search Servers in the WCM System on page 173 For formulating such search reque
141. o directories Drive Directory File D WCM file and directory name admin bat names Quotations from Code quotations lt head gt program code or lt title gt heading configuration files lt title gt lt head gt WCM installation directory Livelink Integration Manual 15 Chapter 1 Important information and warnings are enclosed in gray boxes Make sure to read such information to avoid losing data or making errors when using and managing WCM systems 16 Livelink WCM Server Livelink Integration Manual Introduction 17 18 Livelink WCM Server CHAPTER 2 Common User Administration By integrating the WCM system with Livelink you can use the Livelink user information for both systems The user data will be stored in Livelink For managing principals users groups and roles you can either use the Livelink user administration or the Admin client of the WCM system This chapter deals with the following topics setting up a common user administration see the following section editing principals in the Admin client see section Managing Princi pals in the Admin Client starting on page 26 editing principals in the Livelink user administration see section Managing Principals in Livelink starting on page 54 Setting up a Common User Administration In order to manage Livelink and WCM users in a common data storage you have to perform two installation steps 1 Instal
142. o publish press releases in the website You want to display summaries of the current news in a teaser list as well as the full text of the news items Controlling the Page s Appearance show_channel jsp The page s appearance is defined by the show_channel jsp page The display mode of the JSP page is controlled by means of call parameters The teaser list is displayed if no special node ID is passed to the JSP page lt retrieving node ids from the current object and from the request int nodeId VIPLIVELINKID format nodeid String currentNodeld request getParameter nodelId if no node id is passed show the list if currentNodelId null show list CONDUNBWN PR 10 else 11 show news Livelink Integration Manual 109 Chapter 3 14 Displaying the Teaser List Show_channel jsp The teaser list displays all current news sorted by Valid from date on the JSP page Name date and comment are shown in a table N ou 13 14 15 16 17 18 19 20 21 22 23 24 lt h1 gt VIPTITLE lt h1 gt lt table border 0 align center width 100 cellpadding 0 cellspacing 0 gt lt show all active news from the related channel object LivelinkChannel 11Channel LivelLinkChannel1 110bjBean get new LivelinkId nodeld List 1 11Channel getActiveNews iterate children for int i 0 i lt xl size i retrieving news and extract metadata to display Livelin
143. odeStr null int nodelId Integer parseInt nodeStr AONDUBWHN 98 Livelink WCM Server 10 11 12 13 14 15 17 18 19 21 22 23 25 26 27 28 30 gt Livelink Functions in a Website LivelinkObject llobj 110bjBean get new LivelinkId nodeld if object is accessible and has a content show the content if llobj null amp amp llobj hasContent retrieve mime type information StringValue mime StringValue Llobj getAttribute LivelinkDocument META_MIMETYPE reset response stream and set mime type and status response reset if mime null response setHeader Content Type mime getString response setStatus javax servlet http HttpServletResponse SC_OK copying content to response stream BufferedOutputStream sos null try sos new BufferedOutputStream response getOutputStream llobj getContent sos catch Exception e if sos null sos close You can use the show jsp page for displaying any Livelink document Before the show jsp page is executed no data must be written to the OutputStream ofthe HttpServletResponse For this reason no template must be assigned to this JSP page You also have to omit the normal header and body tags Livelink Integration Manual 99 Chapter 3 Implementing a Livelink Browser This application example extends the previous example by displaying a recursive and personalized folder structure It also provi
144. ommon User Administration Functional areas can also be assigned to object types This is done in the settings of the object types By this assignment you determine that objects with this object type may only be added checked out and checked in by users with a certain functional area Adding a Functional Area To add a functional area 1 In the User administration view select the item Functional areas 2 Choose New functional area on the context menu or click the corre sponding icon A Icon for adding a functional area 3 In the following dialog box enter the name for the new functional area new functional area x Name Images Cancel Help Fig 14 Adding a functional area 4 Confirm the settings by clicking the OK button Notes If you want the name of the functional areas to be displayed in the language of the users you can translate it For more information refer to the Livelink WCM Server Administrator Manual chapter Working in the Admin Client A new functional area must be assigned to a principal in order to take effect Moreover it must be assigned to one or more object types Livelink Integration Manual 49 Chapter 2 Settings of Functional Areas Note For displaying the settings of the functional areas you require the administration right Access to configuration To view the settings of a functional area select it via User administ
145. on 3 Use the wizard for adding an external collection For Livelink Search servers the following parameter is especially important Livelink slice slice name Enter the Processes Prefix you specified when creating the XML Activator Producer Data Source Note You can only add one external collection per slice 4 Before you can use the new collection for search requests you must add directory structures to the collection by means of the command line tools AddDocument and AddDirectory see sections AddDocument on page 209 and AddDirectory on page 210 200 Livelink WCM Server Livelink Search in the WCM System Starting the XML Activator Process in Livelink When starting the XML Activator process scans the specified incoming directory and updates the index according to the XML files located in this directory To start the XML Activator process in the Livelink system 1 On the Livelink System page click the Processes Prefix Data Source Folder link 2 Click the Processes Prefix Data Flow Manager link 3 Click the Functions icon x of the XML Activator and select Properties Specific 4 Make the following settings in the Start Options section Scheduled At This Time 1 foo A am Osul mol mi we th Fer sa Every 1 Minutes gt Fig 59 The Start Options section on the Specific tab m Click Scheduled in the drop down list m Click the Every radi
146. on server See also Server category QA view The QA view of Livelink WCM Server is used for quality assurance of the objects and thus of the website content This view thus performs the control function between editing in the Edit view and publication in the Production view Query system The Query system provides a mechanism for processing search requests and generating corresponding hitlists Relator Due to the integration of web content management and Livelink you can add Livelink objects as WCM objects in a WCM managed website These WCM objects are called relators They always refer to a certain version of a Livelink object For integrating a single Livelink object the WCM system provides the object type Livelink relator For integrating Livelink folders the WCM object type Livelink folder relator is provided Release Staging action of Livelink WCM Server Quality Assurance checks whether the content and the form of a submitted object meet the quality standards of the company If so the object is released The release transmits the quality assured version of the object to the Production view and thus makes it available to the end user in the published website Repository A repository is an abstraction that allows uniform access to data Role Collection of users similar to a user group for which specific access rights can be defined The user role is usually defined in terms of tasks whereas use
147. ons in a Website 26 lt 27 28 29 30 Display login logout button 31 gt 32 Logged in as lt SessionBean getCurrentUserProfile request getName gt lt br gt 33 lt a href Login jsp gt login lt login gt lt br gt The node ID of the Livelink folder is specified directly in the code to simplify the example You can also specify the node ID as a metadata item The metadata item should be of type Livelink ID You can use WCM tags to include metadata items in code e g VIPLIVELINKID format nodeid User Login login jsp The SessionBean a Portal Manager API class associates an applica tion server session with a context in the WCM system The bean provides functions for logging users in to and out of the WCM system and for accessing user profiles The following sample first checks whether the user must log in If so the system displays the corresponding form for entering user ID and pass word After the system has evaluated the login information the JSP page is called again and the user is logged in After login the user will be directed to the page list jsp 1 lt jsp useBean id sessionBean scope session class de gauss vip portalmanager SessionBean gt 2 lt 3 retrieve request parameter 4 String user request getParameter user 5 String pwd request getParameter pwd 6 if sessionBean isLoggedIn request amp amp user null amp amp pwd null
148. or Iterator qiter poll getQuestions iterator qiter hasNext questionIndex int choiceIndex 0 Question question Question qiter next gt lt tr gt lt td colspan 2 gt lt question getQuestion gt lt td gt lt tr gt lt decide to use radio button or check box controls boolean radio question instanceof AlternativesQuestion List choices question getChoices show the choices for Iterator citer choices iterator citer hasNext choiceIndext gt lt tr gt lt td align center gt amp nbsp lt td gt lt td gt lt input name lt Q questionIndex gt type lt radio radio checkbox gt value lt C choiceIndex gt gt lt String citer next gt lt td gt lt tr gt lt gt lt tr gt lt td colspan 2 gt amp nbsp lt td gt lt tr gt lt gt lt table gt lt if comments are allowed add an input element for the comment if poll isCommentAllowed gt lt textarea name Comment cols 80 rows 5 gt lt textarea gt lt gt lt input type submit value Vote gt amp nbsp lt input type reset value Reset gt lt form gt Livelink Integration Manual 125 Chapter 3 Voting vote jsp Voting itself is performed on the vote jsp page The JSP page receives the answers to the questions as request parameters The questions are identified by means of the parameter names and set accordingly in the poll 1 lt
149. orresponding users log in to the WCM system again As an administrator you can log out users via the System administration for detailed information refer to the online help of the Admin client Livelink Integration Manual 41 Chapter 2 Adding a Group or Role in the Admin Client To add a group or role in the Admin client 1 In the User administration view select the item Groups or Roles 2 Choose New group or New role on the context menu or click the corresponding icon B Icon for adding a group csi T Icon for adding a role 3 In the following dialog box make the settings for the group or role I x Name Marketing E mail marketing company example v WCM access Ca ee Fig 11 Adding a group in the Admin client For detailed information on the individual fields refer to the Admin client s online help Note In the WCM system the names of groups and roles must only be unique within all groups or roles respectively This means that a group can have the same name as a role If the user information is stored in Livelink this is not allowed as roles are treated like groups in Livelink 4 Confirm the entries by clicking the OK button 42 Livelink WCM Server Common User Administration Editing Group or Role Information in the Admin Client To change the settings of a group or role 1 Select the desired item via User administration gt Gr
150. ou leave the starts with field blank Livelink retrieves all users or groups in the system 58 Livelink WCM Server Common User Administration 4 Click the Find button Admin Users and Groups jadnesday 06 03 2004 Livelink Personal Enterprise Tools Help T Workspace workspace B Log out E Contents Favorites B Users amp Groups 2 Settings For This Page Find User First Name z starts with fna Find Add New Item z Type Name First Name Department Actions B mmoreno Manuel WebsteAdmin Edit Browse Groups D msanchez Maria ResearchDevelopment Edit Browse Groups D mossi Mario HumanResources Ed Browse Groups Livelink Version 9 2 0 Copyright 1995 2003 Open Text Inc All rights reserved Fig 19 Users found in Livelink The search results are displayed on the Users and Groups page Provided that you have the appropriate privileges the Actions column contains the following links Edit Click this link to modify the settings of a principal Browse Click this link to view the Personal Workspace of a user Groups Click this link to view information on the group s that the user belongs to Livelink Integration Manual 59 Chapter 2 Managing Users in Livelink If you leave the field starts with on the Users and Groups page blank and click the Find button Livelink retrieves all users in the system Users and Groups ne oinin iis Livelink n Personal Enterprise
151. oups or Roles group name role name The settings are displayed in the right window pane 2 Make the desired changes For detailed information on the individual fields refer to the Admin client s online help 3 Click the Apply button Note In Livelink you cannot manage additional information such as the e mail address for groups This means that you have to use the Admin client to edit WCM specific information of groups and roles Modifying the Assignments of a Group or Role in the Admin Client By means of the assignments you can assign users to a group or role allow the group role access to a website and set the default object rights and administration rights for the group role For general information on groups roles functional areas and rights refer to the Livelink WCM Server Administrator Manual chapter Concepts To open the assignments of a group or role select User administration gt Groups or Roles group name role name Use the toolbar or the context menu to modify the assignments Livelink Integration Manual 43 Chapter 2 D User administration p Users B Groups m E Board 2 DefaultGroup B External HumanResources B Marketing B Users Functional areas wW Websites 5 Default object rights Administration rights Fig 12 Assignments of a group in the Admin client You can make the following assignments for a group or role The ov
152. ox 155 Livelink module WCM Kernel Integration 82 WCM User Administration 20 Livelink object add as WCM object 131 229 Index Livelink relator 131 add 134 add with document 144 configuring automatic synchronization 82 delete 163 edit content 154 edit metadata 155 find after change 150 integrate metadata 159 release 153 submit 152 update manually 162 Livelink search add collections Enterprise Server 9 2 1 182 add collections Enterprise Server 9 5 0 197 index regions Enterprise Server 9 2 1 186 index regions Enterprise Server 9 5 0 202 install Search server Enterprise Server 9 2 1 173 install Search server Enterprise Server 9 5 0 190 permissions 203 prepare indexing Enterprise Server 9 2 1 177 set up 171 XML Activator Enterprise Server 9 2 1 178 XML Activator Enterprise Server 9 5 0 193 Livelink Search server install Enterprise Server 9 2 1 173 install Enterprise Server 9 5 0 190 Livelink system configure multiple 86 LivelinkObjectBean 91 LivelinkUserBean 91 230 M manage functional areas 47 groups Admin client 40 groups Livelink 72 roles Admin client 40 users Admin client 33 users Livelink 60 module WCM Kernel Integration 82 WCM User Administration 20 multiple Livelink systems 86 N new external collection Enterprise Server 9 2 1 184 external collection Enterprise Server 9 5 0 199 folder relator 139 functional area 49 group Admin client 42 group Livelink
153. permissions of this user and not of the default user will be checked In this way you can create personalized search requests Scenario 3 Searching other document sets The collection to be searched is based on an XML Activator Producer Data Source This data source is a Livelink object for which you can set permissions in the Livelink system Livelink applies the permissions set for the XML Activator Producer Data Source to all objects contained in the collection For a search to return results the default user specified in the configura tion must have read access to the XML Activator Producer Data Source Using the Search Search in websites For integrating search functions in a website the VipContentMinerBean is provided As this bean offers a general search API you can implement search pages for your website in the same way as for Content Miner or the Search Server Connector for Lucene For detailed information on creating search pages refer to the relevant chapters of the Content Miner Manual or the Search Server Connector for Lucene Manual There are two possible ways to define a search for the search engine inte grated in Livelink 1 The Livelink Query Language NLQ the syntax of this query language is described in the Livelink User Manual 204 Livelink WCM Server Livelink Search in the WCM System 2 The Livelink Search API use a Query object with corresponding additional parameters and a single blan
154. placingObjectCache lt class gt lt max gt 20 lt max gt lt min gt 10 lt min gt lt wipe_strategy gt time lt wipe strategy gt lt principalcache gt Principals can be loaded from the database into the cache to speed up access to the principals This element has the same parameters as the lt objectcache gt element Starting all WCM servers 1 Start the Admin server by means of the file Admin server name bat or Admin server name sh which is located in the WOM installation directory 2 Use the file startvip bat or startvip sh to start the other WCM servers This file is also located in the WCM installation direc tory For starting WCM servers running in an application server use the appropriate function of the application server Starting the servers in this way also starts up the websites The Livelink systems configured above are now available when you work in the Content client or write JSP pages based on the Portal Manager API or the WCM Java API 90 Livelink WCM Server Livelink Functions in a Website Overview of API Functions This section provides a basic overview of handling Livelink objects using the Portal Manager API or the WCM Java API In order to learn how to write code based on the APIs refer to section Application Examples starting on page 95 For detailed information on how to use individual interfaces beans and methods for the integration with Livelink refer to the Javadoc
155. r gt lt determine the node id of the discussion object to show int nId VIPLIVELINKID format nodeid getting discussion and retrieving questions LivelinkDiscussion 11Disc LivelinkDiscussion 11lObjBean get new LivelinkId nId getting topics from the current discussion List 1 11Disc getTopics StringBuffer str new StringBuffer for int i 0 i lt l size i examine topic and generate question LivelinkId tId LivelinkId 1l get i LivelinkDiscussionEntry tObj LivelLinkDiscussionEntry 110bjBean get tId if tObj null String qContent tObj getContent gt 120 Livelink WCM Server Livelink Functions in a Website For each question a lt div gt tag is written on the page that can be identi fied by its ID The tag registers an EventListener that calls a JavaScript function when an element is clicked This function switches the answer area on the client see last code sample in this section After this an answers JavaScript array is generated which contains all answers and is used by the JavaScript method showAnswer The array is embedded in the page see last code sample in this section 20 lt div id lt tId getNodeId gt onClick showAnswer this gt lt qContent gt lt div gt 21 lt adding all replies to the answer array 22 List ans t0bj getReplies 23 str append answers tId getNodeId 24 for int j 0 j lt ans size
156. r groups are generally tied to organizational units such as departments or projects Search server The combination of Index and Query system in Livelink WCM Server is called Search server Each Search server is assigned to exactly one WCM server It is however possible to assign more than one Search server to a WCM server Livelink Integration Manual 223 Glossary Server category Ina WCM system a distinction is made between master and proxy servers Master servers have write access to the data of the WCM system while proxy servers have only read access The master Content server manages the website data the master Administration server manages the configuration and system data In addition to this any number of proxy servers can be set up Server type According to the tasks of the servers there are two server types Content servers for managing website data and Administration servers for managing the user configuration and system data of the WCM system Basically every Content server is able to provide all views of the data of the managed websites Edit QA and Production The available views may be limited by the fact that the Content server only receives the data of certain views Status The processing state of a WCM object Changes to the state are caused by the corresponding actions on the WCM object Submit Staging action of Livelink WCM Server before a newly created or changed object can
157. ration Functional areas gt name of the functional area In the right window pane the name the website and the assigned object types are displayed D User administration aj 3 n Users Name Basic E Groups Website Companylntranet a A Roles a World Assigned object types Compound object d Functional areas Excel document OA Access rights dialog la GIF image H D Advanced HTML page Basic le JPEG image Direct release E Other A Dynamic T PDF document Filter edit le PNG image Filter standard E PowerPoint file a A Form ER Topic A Import E Word document Intelligent templates FA XML document Livelink Log dialog References dialog amp Search O View My objects View Object list E View Subordinate objects View Template structure Workflow Fig 15 Settings of functional areas In the Configuration view you can change the assignments between object types and functional areas and make new assignments for custom functional areas and object types 50 Livelink WCM Server Common User Administration Assigning Functional Areas If you open one of the functional areas the list of assignments opens in the tree Users Groups and Roles If you open one of the assignment items e g Users the
158. rch in the WCM System m Click Scheduled in the drop down list m Click the Every radio button and enter an interval of 1 minute using the drop down lists Note If necessary adapt the interval to the situation in your system 5 Confirm the entries by clicking the Update button 6 Click the Functions icon of the XML Activator and select Start Displaying Index Regions in Livelink After indexing has been completed you specify in Livelink which index regions will be displayed and can thus be searched via a WCM managed website 1 On the Livelink System page click the Processes Prefix Data Source Folder link 2 Click the Functions icon of the Search Manager and select Info Regions 3 To allow users to display a region on their Search Result page select the region s Displayable check box Note If a region does not have a Displayable check box it is because no item with that attribute has yet been added to the Livelink database After an item with the attribute in question is added and indexed a Displayable check box appears in its row on the Configure Regions page To add items with this attribute to the database synchronize the collection To do so launch the Admin client and select System administration Search servers Search server name collection name Right click the collection and choose Synchronize collection on the context menu At least the following regions must be marked
159. released once it is marked as deleted and must be destroyed manually Livelink folder relators for which the Update Edit version automatically option is selected are automatically deleted including all subordinate objects when the referenced Livelink folder is deleted Livelink Integration Manual 163 Chapter 4 If you want to add further WCM objects below the Livelink folder relator you should click the Fixed version radio button for the folder relator Folders with this settings will not be removed when the refer enced Livelink folder is deleted Selecting the Delete Livelink object together with relator option In the Livelink metadata dialog box you can determine that the referenced Livelink object will be destroyed together with the relator Proceed as follows 1 164 Launch the Content client The URL of the Content client is of type htto wcomserver company example cmsclient index jsp Log in to the Content client and select the website that you want to edit Change to the Edit view of the website by choosing Tools gt View gt Edit view Open the Livelink metadata dialog box by choosing View Livelink metadata On the General Livelink data tab select the check box Delete Livelink object together with relator Click the Save button For the change to take effect you must submit the relator which then must be released by Quality Assurance see section Submitting an
160. right window pane shows the list of assigned items e g the users who are assigned to the functional area Direct release By means of the toolbar or the context menu you can make and remove the following assignments oy iy Assign users and remove assignments gt EY Assign groups and remove assignments ay ay Assign roles and remove assignments If you assign a user group or role to a functional area the respective users get the rights associated with this functional area e g the right for direct release or the right to add check out and check in JSP pages If a user is assigned to one functional area due to group or role assign ments and to another functional area due to individual assignments both functional areas apply to the user That means that the rights are added Note If you modify the functional area assignments the changes do not take effect until the relevant users log in to the WCM system again As an administrator you can log out users via the System administration for detailed information refer to the online help of the Admin client Livelink Integration Manual 51 Chapter 2 Deleting a Functional Area Note You can only delete custom functional areas that no longer have any users groups or roles assigned Moreover this functional area must not be assigned to an object type To delete a functional area 1 Select the functional area via User administr
161. rnal collection 6 Confirm the security prompts by clicking the Yes and OK buttons Adding an external collection for a Livelink slice To add an external collection that is based on a Livelink slice to the Livelink Search server in the WCM system 1 Select Configuration Search servers and mark the desired Search server 2 Choose New extemal collection on the context menu or click the corresponding icon a Icon for adding an external collection 184 Livelink WCM Server Livelink Search in the WCM System 3 Use the wizard for adding an external collection For Livelink Search servers the following parameter is especially important Livelink slice name of the slice to be indexed Adding an external collection for another type of document set To add an external collection that is based on another document set to a Livelink Search server in the WCM system 1 Select Configuration Search servers and mark the desired Search server 2 Choose New external collection on the context menu or click the corresponding icon Icon for adding an external collection 2 3 Use the wizard for adding an external collection For Livelink Search servers the following parameter is especially important Livelink slice slice name Enter the Processes Prefix you specified when creating the XML Activator Producer Data Source Note You can only add one external collection per slice 4 Before you can use
162. rocess of adding the relator Starting the wizard 1 Launch the Content client The URL of the Content client is of type htto wcmserver company example cmsclient index jsp 2 Log in to the Content client and select the website that you want to edit 3 Change to the Edit view of the website by choosing Tools gt View gt Edit view 4 In the Navigation area mark the topic to which you want to add the relator 5 Choose Object New gt Relator Specifying the Livelink system There may be more than one Livelink system in your company In the first dialog box you specify the Livelink system in which the Livelink object you want to integrate is stored 134 Livelink WCM Server Livelink Contents in the Content Client Object attributes Microsoft Internet Explorer Select a Livelink system From the list Livelink_internal lt Back Next gt OK Help Fig 33 Specifying the Livelink system Confirm by clicking the Next button Selecting a Livelink object In this dialog box you select the Livelink object that is to be added as a relator in the WCM system Livelink Integration Manual 135 Chapter 4 J3 Livelink WCM Server Content Client Microsoft Internet Explorer Please select a Livelink object Livelink ie Enterprise Eg Accounting amp Finance f Company News Channel Eg Company wide Discussions E Development 9 Human Resources S E Training E
163. rs must be released by Quality Assur ance see section Submitting and Releasing Relators on page 150 Livelink Integration Manual 143 Chapter 4 Note Below a Livelink folder relator you can add further WCM objects If you selected the Update Edit version automatically option for the Livelink folder relator you must consider the following The Livelink folder relator and all subordinate WCM objects will be deleted automati cally when the referenced Livelink folder is deleted Adding a Relator Together with the Associated Livelink Document Objective You want to integrate a relator in the WCM system which refers to a file which does not yet exist as a document in the Livelink system Together with the relator you want to add this file as a new document in Livelink A wizard guides you through this process Note You cannot use the Content client to add folders in Livelink Starting the wizard 1 Launch the Content client The URL of the Content client is of type htto wcomserver company example cmsclient index jsp 2 Log in to the Content client and select the website that you want to edit 3 Change to the Edit view of the website by choosing Tools gt View gt Edit view 4 In the Navigation area mark the topic to which you want to add the relator 5 Choose Object New gt from object type or click the appropriate icon 144 Livelink WCM Server Livelink Contents in the Conte
164. s starting on page 52 Finding Principals in the Admin Client The number of principals stored in a Livelink system can be very high Loading and displaying all principals may thus take a long time To restrict the number of items displayed the user administration of the Admin client provides filters for principals The fields for the filter criteria are displayed in the right window pane when you click one of the items Users Groups or Roles Livelink Integration Manual 31 Chapter 2 fal Livelink WCM Server Administration Admin User administration Program View Tools Help 909 ile G User administration p Users Which elements do you want to display B Groups You can use the filter fields to limit the selection Roles Name O World a Functional areas User ID R W Websites WCM access _ Yes No Search and update display gt User administration Fig 5 Finding principals in the Admin client To find principals in the Admin client 1 Enter the criteria for the display filter You can use the following search criteria name of the principal Only the last name can be used to search for a user userID WCM access You can use the asterisk character as a placeholder in searches The asterisk replaces any number of characters before after or inside a search string If you enter m in
165. s lt td gt 32 lt td gt gt lt textarea name Comments rows 12 cols 60 gt lt textarea gt lt td gt lt tr gt 33 lt tr gt lt td align center gt 34 lt input type submit value Submit gt lt input type reset value Reset gt lt td gt lt tr gt 35 lt table gt 36 lt form gt 118 Livelink WCM Server 37 lt gt Livelink Functions in a Website Adding a Topic or a Reply create jsp The last step in this example is to actually add the topic or reply object via the Portal Manager API Adding these objects corresponds to the Livelink browser implementation see section Adding the Document create jsp on page 106 The request parameters are extracted from the request object Depending on the passed object type a topic ora reply is created After this the reply jsp page is called which displays the new object CONDUBWN PR PrPrPROo WNnNrOo 14 15 16 17 18 19 20 21 22 23 24 25 retrieve request parameter comment request getParameter Comments subject request getParameter Subject String String String String String String did tId nid request getParameter discussionId request getParameter topicId request getParameter nodeld typeStr request getParameter objectType if typeStr null amp amp dId null int type Integer parseInt typeStr LivelinkObject newObj null if type LivelinkObjectType SUBTYPE_TOPIC
166. s Install any al Livelink modules that are available For installation Uninstall Modules Uninstall any removable Livelink modules that you want to drop Upgrade Modules Upgrade any current Livelink modules for which an upgrade is available Fig 1 The Module Administration section on the Livelink Administration page 4 Click the Install Modules link 5 On the Install Modules page select the check box of the WCM User Administration module and then click the nstal button For further information on installing modules refer to the Livelink online help Uninstalling the module After uninstalling the module the WCM system is no longer available as the users cannot log in For this reason you should first uninstall the WCM system and then the module Click the Uninstall Modules link in the Module Administration section on the Livelink Administration page For further information on uninstalling modules refer to the Livelink online help Livelink Integration Manual 21 Chapter 2 Selecting the Livelink User Administration In the Admin server dialog box of the WCM installation program you specify whether the Administration server stores the user data in a rela tional database management system in an LDAP directory service or in Livelink fal Livelink Web Content Management Server 8 6 x Admin server Specify the parameters of the new Admin server Kak Name Admin Hos
167. s That means there may exist more than one m temporary directory XML Activator directory XML Activator m slice The relation between the individual components is always as shown in the illustration 170 Livelink WCM Server Livelink Search in the WCM System Configuring the Livelink Search for the WCM System The procedure for setting up the Livelink search for the WCM system depends on the Livelink Enterprise Server version used in your company If you use m Livelink Enterprise Server version 9 2 1 read the following section m Livelink Enterprise Server version 9 5 0 refer to section Search Based on Livelink Enterprise Server 9 5 0 starting on page 188 Search Based on Livelink Enterprise Server 9 2 1 Note Livelink and the WCM system use a shared directory for exchanging data For this reason both the Livelink system and the WCM server to which the Search server is assigned must have write access to this shared directory The Livelink search can be used in different scenarios Scenario 1 Searching website contents Realizing this scenario requires the following steps in Livelink and the WCM system 1 WCM system Install Livelink Search server see the following section 2 Livelink system Prepare indexing see section Preparing Indexing on page 177 3 Livelink system Create XML Activator Producer data flow see section Creating an XML Activator Producer Data Flow
168. s discussions and channels in a WCM managed website For this purpose you require programming know how If you have the task to program JSP pages read about this topic in chapter 3 Livelink Functions in a Website Another way of publishing Livelink objects in a website is to add Livelink objects as WCM objects to a website These WCM objects are called relators Relators enable you to integrate Livelink contents in a website without the need of programming If you are an editor and want to publish Livelink contents in a website in an easy and comfortable way read chapter 4 Livelink Contents in the Content Client Using the Livelink search for a website The Search Server Connector for Livelink enables you to use the Livelink search engine for a WCM managed website The configuration and administration of search engines belong to the tasks of system administra tors If you are a system administrator read about this topic in chapter 5 Livelink Search in the WCM System 12 Livelink WCM Server Introduction Integration Procedure In order to use the WCM system together with Livelink the following steps are required It is presumed that Livelink is already installed 1 Install the WCM system with a Livelink user administration system administrator See Livelink WCM Server Installation Manual Set up a website with the Admin client of the WCM system system administrator See online help of the Admin
169. s the user profile that is used for logging in must have the required permissions in Livelink These are See Contents for reading the metadata and the content of Livelink objects m See Contents and Add Items for adding Livelink objects via the WCM APIs For some Livelink object types which are similar to folders such as discussions or channels Livelink offers a simplified permission scheme In this case the rights Read or Write must be set for read or write access respectively Permissions when accessing several Livelink systems You can configure more than one Livelink system for your WCM system Each Livelink system manages separate user profiles which contain among other things the user permissions When a user accesses an object the system will only check the permissions which the user has for the connected Livelink system It will not consider the user profile of the WCM system 94 Livelink WCM Server Livelink Functions in a Website Application Examples You can use WCM managed JSP pages to access special Livelink objects such as folders documents channels and discussions in a convenient fashion This section provides application examples which illustrate how to use the Portal Manager API and the WCM Java API Note The examples in this section show extracts from the technical concepts of the demo website LiveStart The sample code cannot be executed as such it is only
170. s and administer Livelink Admin servers Fig 50 The Search Administration section on the Livelink Administration page 3 Click the Browse the System Object Volume link 4 Log in with the user information you specified when setting up the Livelink Search server see section Installing Livelink Search Servers in the WCM System on page 173 5 On the Livelink System page click XML Activator Producer Data Source on the Add New Item menu Livelink Integration Manual 179 Chapter 5 General Information None D0 z internetsite 8200 The next 6 consecutive port numbers must also be available on all selected hosts Slice Replacement Processes Prefix Port XML Activator Information Host Defaut WINDOWS NT Incoming Directory CAOPENTEXT index InternetSite_in Write Directory CAOPENTEXT index InternetSite_write Operation Tag Joperation ts CS SsiCSS Identifier Tag jourN i a Metadata List Ei Intermediate HTML Conversion CAOPENTEXT index InternetSite_write Consumer Livelink Update Index Read Directory Write Directory Host Read Directory CNOPENTEXT index InternetSite_write Index Directory CAOPENTEXT index InternetSite_write Host Default WINDOWS NT x Start Options Start Processes in Data Flow Create Processes Reset Fig 51 Creating an XML Activator Producer Data Source For detai
171. s way the users can navi gate the folder structure The link calls the JSP page again passing the node ID of the corresponding Livelink object in a parameter The topmost folder the Enterprise Workspace object does not have a parent folder Thus no link is generated here After this links for the subordinate folders of the current object are generated into the JSP page 1 nee 2 determine node id 3 int navNodeld 0 4 String navNodelIdStr request getParameter navNodeld 5 if navNodeIdStr null navNodeld Integer parseInt navNodeIdStr 6 if navNodeId 0 navNodelId 2000 7 map storing all non folder objects used later for the list 8 RepositoryMap childrenMap new RepositoryMap 9 retrieve the object and check whether the given object exists 10 LivelinkObject llobjNav 110bjBean get new LivelinkId navNodeld 11 if llobjNav null 12 The navigation is not empty First print a for the 13 parent if the parent exists 14 LivelinkId parentId llobjNav getParentLivelinkId 15 if parentId null 16 Print to link to the parent folder This will call 17 this JSP again but with the node id of the parent 18 gt 19 lt b gt lt a href VIPURL navNodelId lt parentId getNodeId gt gt lt a gt lt b gt 20 lt 21 if 22 Iterate the children print their titles if they are folders 23 List lNav llobjNav getChildrenIds 24 for
172. sclient index jsp 2 Log in to the Content client and select the website that you want to edit 3 Change to the Edit view of the website by choosing Tools gt View gt Edit view 4 In the Navigation area mark the relator that you want to update 162 Livelink WCM Server Livelink Contents in the Content Client Choose View Livelink metadata General Livelink data tab Inthe Version drop down list click the version of the Livelink object that the relator is to reflect Click the Save button For the changes to become visible in the published website you must submit the modified relator which then must be released by Quality Assurance see section Submitting and Releasing Relators on page 150 Deleting a Relator Notes You can delete relators like all other WCM objects For detailed infor mation on deleting WCM objects refer to the Content Client User Manual chapter Editing Objects Delete Livelink object together with the relator In order to destroy the Livelink object you require the Livelink permission Delete If you do not have this permission the relator will be deleted in the WCM system However the object in the Livelink system will not be removed Livelink relators are always deleted when the referenced objects are deleted in Livelink Relators that have the status submitted are automatically rejected and deleted afterwards If a relator has already been
173. ser information is stored on the following tabs The General tab contains the settings which were made General when the user was created en i The Personal tab contains items as a photograph birthday ersona and personal interests All entries on this tab are optional oat The WCM tab is only available if you use a common user administration for Livelink and the WCM system This tab contains the user s WCM specific settings such as access rights as well as assignments to functional areas and websites The Admin user is allowed to edit all user profiles Users who have the User administration rights privilege are allowed to edit all profiles with the exception of the Admin user Users with the privilege Can create modify users are allowed to change the profiles of the users they create To change the user information on one of the tabs in Livelink 1 Choose Users amp Groups on the Enterprise menu 2 Use the search functions on the Users and Groups page to find the user see section Finding Principals in Livelink on page 57 3 Click the user s Edit link in the Actions column 4 Select one of the tabs e g the WCM tab 64 Livelink WCM Server Common User Administration General 2 Personal 2 WM WCM access Trusted login Language Substitute Websites Functional areas Vv ana a C v CompanyIntranet v InternetSite M access rights dialog M advanced M Basic I Dir
174. server company example Livelink livelink exe func admin index 2 Log in to the Livelink system as the Admin user and navigate to the Search Administration section 178 Livelink WCM Server Livelink Search in the WCM System Search Administration Configure Search Options Configure the search options that you want to make available to Livelink users This includes Find Similar and Result Themes Edit the em Default Template Configure the appearance of the default search template This template is displayed on the Livelink Search page for all users who have not created personal search templates Reset Search Templates Reset the default search template to its original state and or delete the personal search templates that Livelink users have created Browse the XML DTD Volume Add XML DTDs to the XML DTD volume and then publish the corresponding XML regions to index XML data in Livelink Configure Alert E mail Delivery Configure e mail settings for sending Livelink system object alert e mail messages Configure Debug Settings Configure logging information and other diagnostic settings for Livelink Search the Livelink Admin server and the HTML Conversion process Purge Message Logs Purge the log of system object alert messages from the Livelink database Test em Objects for Errors Test the data flows data flow processes and indexes in the System Object Volume Browse the em Objet Volume Create and manage Livelink i__ xe
175. sing changed relators see the following section editing the content of a relator see section Modifying the Content of a Relator on page 154 m editing the Livelink metadata see section Modifying Livelink Meta data on page 155 m integrating the Livelink metadata in a web page see section Inte grating Livelink Metadata in a Page on page 159 manually updating the relator when the Livelink object has been changed see section Updating a Relator Manually on page 162 Livelink Integration Manual 149 Chapter 4 Submitting and Releasing Relators Changes to relators only become visible in the published website after the relators were submitted and released by Quality Assurance Finding Changed Relators You want to find all changed relators which can be submitted to Quality Assurance This also includes relators that have been updated automati cally because the referenced Livelink objects were modified You can use the predefined filter changed for finding changed objects Requirement You are assigned the functional area Filter standard To check your func tional areas choose Tools gt Login info in the Content client Procedure 1 Launch the Content client The URL of the Content client is of type htto wcmserver company example cmsclient index jsp 2 Log in to the Content client and select the website that you want to edit 3 Change to the Edit view of the website
176. smarchetti Marchetti Marketing I Add to group B mmoreno Moreno WebsiteAdmin I Add to group B olivier Olivier Training M Add to group B mossi Rossi HumanResources I Add to group B msanche r Developme D eschmidt Schmidt Officemanagement I Add to group D hshepard Shepard Marketing I Add to group E iten Stein Marketing Mi Add to group Submit Fig 26 Adding members to a group in Livelink 4 Click the Submit button On the left side of the window the names of the new group members are displayed 76 Livelink WCM Server Common User Administration Modify Group Eind amp Add Edit G h Current Group Members abianchi cerdmann lgomez istein msanchez solivier Delete Group Done Fig 27 Group members in Livelink Setting the group leader in Livelink Any group member can be selected as the group leader Every group can have exactly one group leader Setting a new group leader automatically unsets the previous group leader The previous group leader returns to regular member status The group leader always has the privilege to edit or delete the group The leader does not require the privilege Can create modify groups or User administration rights for this purpose To set the group leader in Livelink 1 In the Current Group Members section of the Edit Group page click the name link of the member that you want to set as the group leader The user information is displayed in
177. sts the VipContentMinerBean createQuery method is provided Scenario 1 Searching website contents The collection to be searched is based on an XML Activator Producer Data Source This data source is a Livelink object for which you can set permissions in the Livelink system Livelink applies the permissions set for the XML Activator Producer Data Source to all objects contained in the collection For a search to return results the default user specified in the configura tion must have read access to the XML Activator Producer Data Source The actual access rights are checked by the WCM system Before displaying search results the system evaluates the access rights of the logged in user The user will only see objects for which the user has read rights in the WCM system Scenario 2 Searching Livelink contents In the Livelink system you can set different permissions for each Livelink object contained in the collection Before displaying search results the system evaluates the permissions of the default user specified in the configuration In order to protect confidential documents in your Livelink system from unauthorized access this user should have the same permissions as the Public Access group Livelink Integration Manual 203 Chapter 5 Alternately you can specify a different user in search requests For this purpose the VipContentMinerBean createQuery username password method is provided In this case the
178. t prior written authorization of Gauss Interprise AG or Gauss Interprise Inc Moreover the regulations of the software license agreement apply to this documentation All brand names and trademarks mentioned are the property of their respective owners http www opentext com bridgin auss html Program version Livelink Web Content Management Server Content Server 9 5 1 Document version En 01 Publication date May 2006 Table of Contents List of Figures 6 List of Tables 9 Chapter 1 Introduction 11 Integration Procedure 13 About this Manual 14 Typographic Conventions 15 Chapter 2 Common User Administration 19 Setting up a Common User Administration 19 Managing Principals in the Admin Client 26 Managing Principals in Livelink 54 Chapter 3 Livelink Functions in a Website 81 Preparations 82 Configuring Multiple Livelink Systems 86 Overview of API Functions 91 Application Examples 95 Chapter 4 Livelink Contents in the Content Client 131 Adding Relators 133 Editing Relators 149 Deleting a Relator 163 4 Livelink WCM Server Chapter 5 Livelink Search in the WCM System Technical Concepts Configuring the Livelink Search for the WCM System Permissions for Searching Using the Search Command Line Tools Problems and Solutions Glossary Index Livelink Integration Manual 167 168 171 203 204 205 215 219 227 List of Figures Fig 1 The Module Administration section on the Livelink Administration pag
179. te_write Index Directory CAOPENTEXT index InternetSite_write Host Default WINDOWS NT x Start Options Start Processes in Data Flow The next 12 consecutive port numbers must also be Create Processes Reset Fig 57 Creating an XML Activator Producer Data Source Livelink Integration Manual 195 Chapter 5 For detailed information on the individual fields refer to the Livelink online help For using the Livelink search in the WCM system the following fields are of special importance Process Prefix display name for objects associated with this index When creating a collection use this identifier as slice name Incoming Directory absolute path to the directory from which the XML Activator Producer process reads the XML files generated by the third party application Create this directory manually If Livelink and the WCM system are installed on different host computers the directory must be shared Write Directory absolute path to the directory to which the XML Activator Producer process writes the data it extracts Create this directory on the same file system level as the Incoming Directory The path in this field is automatically entered into the other directory fields of the dialog box Operation Tag Enter Operation here Identifier Tag Enter OTURN here 6 Confirm the settings by clicking the Create Processes button The Liveli
180. terator citer hasNext determine statistical data Integer numVotes Integer viter next double percent numVotes doubleValue 100 0 double votingsTotal int pix numVotes intValue gt Livelink Integration Manual 127 Chapter 3 31 lt tr gt lt td align right gt lt numVotes gt x lt td gt 32 lt td gt lt String citer next gt lt td gt 33 lt td align right gt lt decfPerc format percent gt lt td gt 34 lt td bgcolor lt pix votingsTotal 20DD10 EOEQEO gt gt 35 lt table width 100 gt lt tr gt 36 lt 37 if pix gt 0 amp pix lt votingsTotal 38 pix numVotes intValue 100 votingsTotal 2 votingsTotal 39 gt 40 lt td bgcolor 20DD10 width lt pix gt gt amp nbsp lt td gt 41 lt gt 42 lt td gt amp nbsp lt td gt lt tr gt lt table gt lt td gt lt tr gt 43 lt 44 gt 45 lt table gt Comments registered for the poll are listed at the end of the poll analysis 46 lt p gt Total number of comments lt results getNumberOfComments gt 47 lt for iter results getComments 0 1 iter hasNext 48 gt 49 lt p gt lt iter next gt 50 lt gt 128 Livelink WCM Server Livelink Functions in a Website Livelink Integration Manual 129 130 Livelink WCM Server CHAPTER 4 Livelink Contents in the Content Client Note For detailed
181. the Content Miner Manual Collections are the basis for searching contents in a WCM managed website An internal collection is created from a set of documents that is managed by the WCM system An external collection is based on a docu ment set that is supplied by any external system e g Livelink Adding an internal collection for WCM contents To add a new intemal collection to a Livelink Search server in the WCM system 1 Inthe Admin client select Configuration gt Search servers and mark the desired Search server 2 Choose New internal collection on the context menu or click the corresponding icon 9 Icon for adding an internal collection 3 Use the wizard for adding an internal collection For Livelink Search servers the following dialog box is especially important 182 Livelink WCM Server Livelink Search in the WCM System e New internal collection q x Livelink parameters Livelink specific parameters are displayed here Kah Livelink slice InternetSite XML Activator directory F lnternetSite_in Temporary directory F itempllnternetSite eames 820 Fi Fig 52 Specifying the Livelink parameters for an internal collection m Livelink slice slice name Enter the Processes Prefix you speci fied when creating the XML Activator Producer Data Source Note For performance reasons we recommend that you create only one collection per slice You can cre
182. tname wemserver company example VIPP port 5002 HTTP port 5003 SSL E SMTP server mailhost company example Default extension htm v Master vi User administration RDBMS LDAP Add as NT sewice Cancel lt Back Fig 2 Specifying the user administration when installing the WCM system Click the Livelink radio button In the next dialog box you enter the param eters for the connection to the Livelink system 22 Livelink WCM Server Common User Administration For detailed information on installing the WCM system refer to the Livelink WCM Server Installation Manual After the Installation After setting up a common user administration for the WCM system and Livelink all Livelink users and groups automatically have access to the WCM system However they cannot access any websites yet After the installation you must enable website access for the principals and thus make it possible for them to work in the WCM system A clear access strategy allows you to control object access without great effort Organizing users in groups is a precondition for an access strategy Assigning rights to individual users should be the exception Proceed as follows 1 Assign groups to websites The assignment of groups to a website enables the users to access the website objects with the Content client See section Website Assignments on page 52 2 Assign functional areas to groups Functional ar
183. tp livelinkserver company example lLivelink livelink exe username LivelinkUser password Livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp source D InternetSite index html url http wcmserver company example index html DeLeteDocument DeleteDocument removes the specified document from an external collection Table 12 Parameters of the command line tool DeleteDocument url Fully qualified URL of the document that is to be removed Livelink Integration Manual 209 Chapter 5 Example DeleteDocument livelinkURL http lLivelinkserver company example Llivelink livelink exe username LivelinkUser password livelink slice InternetSite xmlActivatorDir F InternetSite_in tempDir F InternetSite_temp url http wcmserver company example index htm1 AddDirectory AddDirectory adds directory structures to an external collection After the command has been executed the individual documents of the added directory are part of the index Table 13 Parameters of the command line tool AddDirectory Parameter Description sourceDir Absolute path in the file system to the directory that is to be indexed recursively Subdirectories will be indexed as well baseURL Fully qualified URL of the directory specified in the parameter sourceDir The web server uses this URL to access the directory Example AddDirectory livelinkURL http livelinkserv
184. ture as WCM objects see section Adding a Folder Relator on page 139 create a Livelink document together with the associated relator in the Content client see section Adding a Relator Together with the Associated Livelink Document on page 144 Notes You cannot use the Content client to add folders in Livelink You should not manually add relators and folder relators below a folder relator The process that synchronizes the WCM system with the Livelink system checks whether all the subfolders and documents in the Livelink folder are represented by relators manually created relators are deleted Prerequisites for adding relators Inthe WCM system you have the access rights Read and Create for the topic to which the relator is to be added If you want to add a new Livelink document together with the relator you also need the permission Add Items for the Livelink folder to which you want to add the object You are assigned the functional area Livelink To check your func tional areas choose Tools Login info in the Content client Livelink Integration Manual 133 Chapter 4 m Your WCM administrator prepared the website in which you want to create the relator for using Livelink functionality see section Prepa rations on page 82 Adding a Relator Objective You want to integrate a single Livelink object in a WCM managed website A wizard guides you through the p
185. velink livelink exe Username for Livelink connections username LivelinkUser Password for Livelink connections password livelink Livelink slice slice InternetSite Notes The configuration file of the command line tools uses the syntax of Java properties files Parameters must be specified in the form Key Value In contrast to the entries in the command line the keys parameter identifiers in the configuration file are specified without a preceding minus sign Backslashes are interpreted as escape characters in Java prop erties files For this reason you have to add a backslash before backslashes that really are to be interpreted as such e g in paths Parameters specified in the command line take priority over the corresponding entries in the configuration file Livelink Integration Manual 207 Chapter 5 General Parameters of the Command Line Tools The parameters described below apply to all commands They are used to define general settings and the basic behavior of the individual commands These parameters are mandatory If a parameter is not speci fied the corresponding entry in the commands properties file is used Table 10 General parameters of the command line tools Parameter Description conf Configuration File name of the configuration file This option can be used to specify the name and or location of the configuration file If this paramet
186. velink discussion sorted by date Below the topic list a button for adding new topics is added to the JSP page lt table gt lt String dId request getParameter discussionId int discId Integer parseInt dId LivelinkDiscussion 11Discussion LivelLinkDiscussion 11lObjBean get new LivelinkId discld 7 if 11Discussion null amp amp 11Discussion hasChildren DnuOBWNP 114 Livelink WCM Server 10 11 12 13 14 15 16 17 18 19 21 22 Livelink Functions in a Website get all topics from the discussion List 1 11Discussion getTopics for int i 0 i lt l size i LivelinkId tId LivelinkId 1l get i LivelinkTopic tObj LivelinkTopic 11l0bjBean get tId String param discussionId dId amp topicId _ tId getNodeId amp nodeId tId getNodeld lt lt tr gt lt td gt lt a href reply jsp lt param gt gt lt tObj getName gt lt td gt lt td gt lt tObj getContent gt lt td gt lt tr gt gt lt table gt lt input type button name Add Topic onClick Location href form jsp discussionId lt dId gt gt Displaying a Topic with all Replies reply jsp The JSP page displays the selected topic and lists all replies to this topic in a hierarchical structure Below the hierarchical structure a button for adding a reply is written to the page The JSP page is called with the following parameters the node IDs of th
187. velinkPoll poll LivelinkPoll livelinkObjectBean get 11Id 5 if poll null 6 user has the right to see and therefore vote the poll object 7 gt 8 lt h1 gt lt poll getName gt lt h1 gt 9 lt h2 gt lt poll getComment gt lt h2 gt lt hr gt 10 lt Check whether the user can vote 11 if poll canVote cid 12 user already voted or poll has been finished 13 gt 14 lt h2 gt You already voted in this poll or 15 the poll is finished already You can 16 lt a href result jsp Llid lt L1LId getNodeId gt gt 17 view the poll results lt a gt lt h2 gt 18 lt 19 else 20 show poll instructions and metadata 21 gt 22 lt h2 gt Instructions lt poll getInstructions gt lt h2 gt 124 Livelink WCM Server Livelink Functions in a Website The questions and answers of a poll must be displayed in the correct order as the system only checks whether a predefined answer has been selected or not when evaluating the votes The form only transfers the selected form elements A corresponding index is embedded into the form elements in order to identify the assigned questions and answers on the vote jsp page 23 25 26 27 28 29 30 31 32 34 35 36 38 40 41 42 43 45 46 47 lt form method POST action vote jsp gt lt input name 1Llid type hidden value lt 1L1lId getNodeId gt gt lt table gt lt int questionIndex 0 f
188. vers on the context menu or click the corresponding icon a Icon for setting the run level of all servers 86 Livelink WCM Server Livelink Functions in a Website The Select new run level window opens select new runlevel eS 0 Server not available 2 No users logged in 3 No agents running 4 Single user mode 5 Server up Cancel Help Fig 32 Selecting a new run level 3 Click the Server not available run level and confirm by clicking the OK button Modifying the livelink systems xml file The livelink systems xml file is located in the directory WCM installation directory config For each Livelink system or entry point add a separate lt Livelink system gt element to the configuration file livelink systems xml lt livelink systems gt lt livelink system name Livelink_1 gt lt default gt true lt default gt lt poolname gt lt default gt lLivelink_1 pool lt default gt lt server name Proxy_server gt proxy livelink_1 pool lt server gt lt poolname gt lt rootnodeid gt 2016091 lt rootnodeid gt lt url gt http livelink company example Livelink lt url gt lt llview gt llview exe lt llview gt lt objectcache gt lt strategy gt de gauss vip ObjectWiperImpl lt strategy gt lt cache_reduce_interval gt 7200000 lt cache_reduce_interval gt lt class gt de gauss vip DisplacingObjectCache lt class gt lt max gt 2500 lt max gt Live
189. with the Admin client For detailed information on the individual fields refer to the Admin client s online help 4 Click the OK button Notes m A user added with the Admin client has the Livelink privileges Log in enabled and Public Access enabled and is assigned to the default group m The user ID is used as the Livelink log in name m The Admin client provides only the field Name for the user s name The contents of this field can be split up into the Livelink name components First Name Middle Initial and Last Name For this purpose first name middle initial and last name must each be sepa rated by at least two spaces in the Admin client Livelink Integration Manual 35 Chapter 2 Example The entry Joshua two spaces F two spaces Stein in the Name field of the Admin client is displayed as follows in Livelink First Name Joshua Middle Initial F Last Name Stein Editing User Information in the Admin Client To edit the user information e g the e mail address 1 Select the user via User administration gt Users User ID The settings for the user are displayed in the right window pane gt User administration a T Users I Name Joshua F Stein i B abjanchi E UserID jstein D Admin cerdmann 2 E mail jstein company example claurent 4
190. y the Livelink system and can only be viewed here In the fields Description and Version description you may enter basic information on the relator and on this special version of the relator Livelink Integration Manual 157 Chapter 4 In the Version area you determine whether the relator is to be updated automatically when the associated Livelink object changes Update Edit version automatically radio button or is to reference a specific version of the Livelink object Fixed version radio button Select the Delete Livelink object together with relator check box to determine that the referenced Livelink object will be destroyed together with the relator see section Deleting a Relator on page 163 Tabs for object categories For each object category assigned to the object in the Livelink system a separate tab with the cate gory s name is shown in the figure Training Materials You can modify the Livelink object s attributes on the tabs 6 Make the desired changes on the tabs 7 Click the Save button The metadata are changed in the Livelink system The relator now has the status changed For the changes to become visible in the published website you must submit the modified relator which then must be released by Quality Assurance see section Submitting and Releasing Relators on page 150 158 Livelink WCM Server Livelink Contents in the Content Client Integrating Livelink Metadata
191. you modify the website assignments the changes do not take effect until the relevant users log in to the WCM system again As an administrator you can log out users via the System administration for detailed information refer to the online help of the Admin client Livelink Integration Manual 53 Chapter 2 Managing Principals in Livelink Note A user with the appropriate Livelink privileges can make changes to the user information which also affect the WCM system These users do not require any administration rights in the WCM system for this You can manage all users who are to access the WCM system and the Livelink system in the Livelink user administration To group users according to the company s organizational structure and to assign appro priate privileges you can create groups For detailed information on privi leges refer to the Livelink online help Opening the Livelink user administration To open the Livelink user administration 1 Enter the URL of the Livelink system in the address field of your browser The URL is of type http livelinkserver company example Livelink livelink exe User Log in To OA Livelink GP Livelink Username l Password 2 velink Version 9 2 spyright 1995 2003 Open Text Inc Al rights reserved For assistance please contact the Administrator Fig 17 Logging in to the Livelink system 54 Livelink WCM Server Common User Administration

Livelink Integration Manual

Contents

Download Pdf Manuals

Related Search

Related Contents