EMC Documentum Content Services for SAP iviews for Related Content

EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide P/N 300 005 446 Rev A01 EMC Corporation Corporate Headquarters: Hopkinton, MA 01748 9103 1 508 435 1000 www.emc.com

Copyright 2004 2007 EMC Corporation. All rights reserved. Published July 2007 EMC believes the information in this publication is accurate as of its publication date. The information is subject to change without notice. THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. EMC CORPORATION MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Use, copying, and distribution of any EMC software described in this publication requires an applicable software license. For the most up to date listing of EMC product names, see EMC Corporation Trademarks on EMC.com. All other trademarks used herein are the property of their respective owners.

Table of Contents Preface... 9 Chapter 1 Introducing Content Services for SAP Portal iviews for Related Content... 13 Overview... 13 Understanding the iviews for Related Content architecture... 14 Understanding SAP and IVRC terms... 15 Chapter 2 Introducing the Interface of IVRC specific iviews... 19 Overview... 19 Introducing Link Documentum iview s interface... 19 Overview... 19 Using the Link Documentum iview GUI... 19 Format of query results table... 22 Configuring columns of the query results table... 23 Introducing Search Documentum iview s interface... 23 Overview... 23 Using the Search Documentum iview GUI... 23 Format of query results table... 25 Configuring columns of the query results table... 25 Search Documentum iview GUI... 26 Introducing the FI Document Browser iviews interface... 27 Overview... 27 Introducing the FI Document Browser (Vendor) iview s interface... 27 Introducing the FI Document Browser (Customer) iview s interface... 30 Format of query results table... 31 Introducing the PrintList Browser s interface... 31 Overview... 31 Using the PrintList Browser iview s interface... 31 Format of query results table... 32 Chapter 3 Administering IVRC... 35 Overview... 35 Working with IVRC related logging... 35 Defining output files for logging... 35 Configuring logging for DFC services container... 36 Integrating iviews for Related Content related logging with SAP Portal s logging system... 37 Overview... 37 Introducing SAP s definition of logging and tracing... 37 Overview... 37 Logging... 38 Tracing... 38 Difference between logging and tracing... 38 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 3

Table of Contents Mapping Log4j s severity levels with SAP logging s severity levels... 38 Integrating iviews for Related Content and SAP Portal logging... 39 Overview... 39 Configuring the severity of logging in SAP... 39 Viewing IVRC related logs in SAP... 41 Modifying the IVRC configuration object... 41 Configuring system landscapes... 45 Overview... 45 Configuring EMC Documentum repository related system landscape objects... 46 Configuring SAP R/3 related system landscape objects... 48 Configuring the SAP_R3_PLM system alias... 49 Configuring support for load balancing... 50 Configuring SLD for FI and PrintList browsers... 50 Configuring SLD for FI browser... 51 Configuring SLD for PrintList browser... 51 User mapping... 52 Overview... 52 User mapping with administrative privileges... 53 User mapping with standard user privileges... 53 Setting up Single Sign On (SSO) connections... 54 Exporting public certificates from SAP Web AS... 54 Configuring SAP R/3... 55 Importing certificates from SAP Web AS to SAP R/3... 56 Configuring pages and iviews... 56 Installing SAP business package iviews... 56 Configuring pages... 57 Creating new pages... 58 Configuring and working with iviews specific to Documentum... 61 Overview... 61 Configuring the Documentum Event Controller iview... 62 Configuring the Search Documentum iview... 64 Configuring the Link Documentum iview... 65 Configuring the FI Document Browser iviews... 65 Configuring the PrintList Browser iview... 66 Working with the Documentum Event Sender iview... 67 Overview... 67 Documentum Event Sender iview s interface... 67 Sample values... 69 Working with query templates using DA or Webtop... 69 Overview... 69 Creating query templates... 71 Creating DQL based query templates... 71 Overview... 71 Creating a dm_query object... 71 Creating an sap_action_link_doc_object object... 72 Creating DIR based query templates... 74 Creating ArchiveLink based query templates... 76 Editing query templates... 79 Overview... 79 Editing dm_query objects... 79 Editing sap_action_link_doc_object objects... 80 Deleting query templates... 80 Connecting to multiple EMC Documentum repositories... 81 Using IVRC to work with DCM controlled documents... 83 4 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Table of Contents Overview... 83 Support for EMC Documentum PDF Annotation Services... 84 Chapter 4 Troubleshooting IVRC... 85 Overview... 85 Operation aborted when trying to log in to SAP Portal or refreshing page in SAP Portal... 85 Problem statement... 85 Possible causes... 86 Suggested resolution... 86 Unable to open pages for which Documentum Event Controller iview has been configured... 86 Problem statement... 86 Possible causes... 86 Suggested resolution... 87 FI and PrintList Browser iviews fail to load... 87 Case 1... 87 Problem statement... 87 Possible causes... 87 Suggested resolution... 87 Case 2... 88 Problem statement... 88 Possible causes... 88 Suggested resolution... 88 Case sensitivity issues when using principal authentication... 88 Problem statement... 88 Possible causes... 89 Suggested resolution... 89 High levels of logging... 89 Problem statement... 89 Possible causes... 89 Suggested resolution... 90 Logging details appear in a pop up window... 91 Problem statement... 91 Possible causes... 91 Suggested resolution... 91 Documentum Event Controller iview shows connection errors... 91 Problem statement... 91 Possible causes... 92 Suggested resolution... 92 Unable to delete links between an EMC Documentum object and SAP R/3 object... 92 Problem statement... 92 Possible causes... 93 Suggested resolution... 93 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 5

Table of Contents List of Figures Figure 1. Content Services for SAP Portal iviews for Related Content architecture... 14 Figure 2. Link Documentum iview interface... 20 Figure 3. Search Documentum iview interface... 24 Figure 4. Search Documentum iview interface... 26 Figure 5. FI Document Browser (Vendor) interface... 28 Figure 6. FI Document Browser (Customer) interface... 30 Figure 7. PrintList Browser iview interface... 32 Figure 8. Documentum Event Sender iview s interface... 68 6 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Table of Contents List of Tables Table 1. Terms and definitions... 16 Table 2. Mapping Log4j s severity levels with SAP logging s severity levels... 38 Table 3. Fields in the IVRC Config object s Properties page... 42 Table 4. Fields in Property Editor <name of system landscape> iview... 47 Table 5. Fields in Property Editor Documentum Event Controller iview... 62 Table 6. Fields in the sap_action_link_doc_object object s Properties page... 72 Table 7. Fields in the sap_action_link_doc_object object s Properties page... 74 Table 8. Fields in the sap_action_link_doc_object object s Properties page... 77 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 7

Table of Contents 8 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Preface Purpose of this guide This guide provides task based instructions for administering and configuring Content Services for SAP Portal iviews for Related Content 6.0 (IVRC 6.0). Note: For the sake of brevity, throughout this document, Content Services for SAP Portal iviews for Related Content 6.0 will be referred to as iviews for Related Content or IVRC. Intended audience In order to address the manuals to the correct audience, the roles of the users of the documentation have been defined as follows: Consumer This role covers users who access related EMC Documentum content in the context of the task that they perform in SAP Portal. Content manager This role covers users who administer content so that the right content is available to the right users in the right business context. System administrator This role covers users who install and configure IVRC. IVRC integrates two enterprise level software packages: the EMC Documentum content management system with the SAP NetWeaver platform. Installing IVRC requires detailed knowledge of SAP NetWeaver and SAP Portal. Therefore, system administrators must have experience with the software products listed in the Content Services for SAP Portal iviews for Related Content Release Notes. This guide is intended for content managers and system administrators. Revision history This section contains a description of this document s revision history. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 9

Preface Revision history Revision date September 2007 Description Initial publication of document for Content Services for SAP Portal iviews for Related Content 6.0. Typographic conventions This guide uses the following typographic conventions: Typographic conventions used in this guide Convention Description > Represents a menu. <Text enclosed within angle brackets> Information in this font Represents a variable name for which you must provide a value, or a defined term. Represents code samples, user input, and computer output. [] square brackets Used in method command syntax specifications, square brackets indicate an optional argument. {} curly brackets Used in method command syntax specifications, curly brackets indicate an optional argument that can be repeated more than once. Related documentation This guide forms part of a documentation suite designed to support those who install, configure, and use IVRC. The product and documentation suite can be found on EMC Powerlink at: http://powerlink.emc.com. From Powerlink, you can download the latest version of IVRC and the related documentation suite. To access the contents in Powerlink, you must provide the login credentials assigned to you when you first applied for access. If you are accessing Powerlink for the first time, you will need to apply for access and obtain a username and password. 10 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Preface Content Services for SAP Portal iviews for Related Content Documentation suite Title Description Target role Content Services for SAP Portal iviews for Related Content Release Notes Content Services for SAP Portal iviews for Related Content Installation Guide Content Services for SAP Portal iviews for Related Content Administration Guide Content Services for SAP Portal iviews for Related Content User Guide Provides an overview of new and amended features, known bugs, limitations, miscellaneous technical notes, and documentation correctness and clarifications. Provides the procedures for installing iviews for Related Content. Describes how to configure and administer iviews for Related Content. Describes how to use iviews for Related Content. Consumer, Content Manager, System Administrator System Administrator Content Manager, System Administrator Consumer, Content Manager Note: More information on performing advanced tasks with SAP Portal is in the SAP Portal section of the SAP Help Web site (http://help.sap.com). EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 11

Preface 12 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Chapter 1 Introducing Content Services for SAP Portal iviews for Related Content Overview The iviews for Related Content (IVRC) is a software package that allows users to access and manage EMC Documentum content in their business context, from within SAP Portal. IVRC consists of a set of iviews and pages that are deployed in SAP Portal. IVRC s iviews and pages interact with other iviews and pages, depending on the ability of non IVRC iviews and pages to subscribe to and publish portal events. iviews for Related Content allows you to: Find and view related content that is stored in an EMC Documentum repository, from within SAP Portal. Link documents from an EMC Documentum repository to SAP. You can link documents to specific materials, functional locations, equipment master records, or other supported object types in SAP. Manage the links between EMC Documentum objects and SAP objects. Delete links to related content. This chapter covers the following topics: Understanding the iviews for Related Content architecture, page 14 Understanding SAP and IVRC terms, page 15 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 13

Introducing Content Services for SAP Portal iviews for Related Content Understanding the iviews for Related Content architecture Figure 1. Content Services for SAP Portal iviews for Related Content architecture Content Services for SAP Portal iviews for Related Content comprises the following components: Search Documentum iview This component enables you to search for related EMC Documentum content from within SAP Portal. Search Documentum iview enables you to search for related content in their business context in EMC Documentum repositories. Link Documentum iview This component enables you to create various types of links that establish relationships between EMC Documentum objects and SAP objects. Documentum Event Controller This component is a technology bridge between SAP iviews and IVRC iviews; Documentum Event Controller listens to SAP iviews broadcasts and communicates this information to IVRC iviews. Documentum Event Sender The Documentum Event Sender iview lets you send events without using SAP business packages iviews. Administrators can use the Documentum Event Sender iviews for test and verification purposes. 14 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing Content Services for SAP Portal iviews for Related Content Sample iviews: FI Document Browser iview This component allows you to search for and browse FI (Financial) documents stored in SAP. EMC Documentum ships the following two types of FI Document Browsers along with IVRC: FI Document Browser (Customer) iview FI Document Browser (Vendor) iview Note: The FI Document Browser iviews are just sample iviews; they demonstrate how you can create custom iviews. As samples, they have limited support and may not have complete functionality. Sample iview: PrintList Browser iview This component allows you to: Search for PrintLists in SAP Display a rendition of the archived PrintList in SAP Portal using one of the following applications: WDK based application Content Services for SAP Portal Repository Manager Note: The PrintList Browser iviews are just sample iviews; they demonstrate how you can create custom iviews. As samples, they have limited support and may not have complete functionality. IVRC Administration and Configuration component This component is a part of the EMC Documentum Webtop client; the IVRC Administration and Configuration component allows you to administer and configure IVRC. Using this component, you can create and store DQL queries; these queries can be used by end users to search for related content in EMC Documentum from within SAP Portal. Note: IVRC can also be administered and configured through any Webtop based client including Documentum Administrator (DA). Understanding SAP and IVRC terms This section presents terms and their definitions, as used in this guide. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 15

Introducing Content Services for SAP Portal iviews for Related Content Table 1. Terms and definitions Term Content Services for SAP Portal iviews for Related Content Search Documentum iview Link Documentum iview Documentum Event Controller IVRC Administration and Configuration component DFC Services Container Repository Definition Application that allows users to access and manage EMC Documentum content in the business context from SAP Portal. IVRC consists of a set of iviews and pages for SAP Portal. These IVRC iviews and pages may interact with other iviews and pages, depending on their ability to publish and subscribe to portal events. IVRC component; allows you to search for related content (in their business context) in EMC Documentum repositories. IVRC component; allows you to create various types of links that establish relationships between EMC Documentum objects and SAP objects. IVRC component; a technology bridge between SAP iviews and IVRC iviews; Documentum Event Controller listens to SAP iviews broadcasts and communicates this information to IVRC iviews. IVRC component; a part of EMC Documentum s Webtop client; the IVRC Administration and Configuration component allows you to administer and configure IVRC. Using this component, you can create and store DQL queries; these queries can be used by users to search for related content in EMC Documentum from within SAP Portal. A shared component that is required to host helper services for all DFC based applications in SAP Portal on UNIX platforms. Any information source such as a file system, content management system, and so on. 16 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing Content Services for SAP Portal iviews for Related Content Term SAP NetWeaver SAP Portal SAP Web AS Web Dynpro User Mapping SAP System Landscape Definition An open integration and application platform that integrates people, information, and processes. SAP NetWeaver powers mysap Business Suite, SAP xapps, partner solutions, and custom built applications. A scalable, robust portal, with an open architecture capable of integrating unlimited content. Portal content is designed to retrieve information from varied information sources such as websites, groupware applications, legacy systems, enterprise applications, databases, and document directories. An evolution of the component SAP_BASIS. Using the web as a technology platform for SAP applications, you can develop business applications in ABAP or Java. SAP NetWeaver s programming model for user interfaces. Provides support when developing the web representation of business applications. A feature that provides login information for users on third party systems. This login information can simply be user ID and password and additional information like MicroNT Domain and language. Enterprise IT system infrastructure managed by SAP, containing various IT applications, objects, and aliases. Through a well defined system landscape, SAP maintains connectivity to various back end applications and information sources. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 17

Introducing Content Services for SAP Portal iviews for Related Content Term EMC Documentum Content Server DFC LDAP DMCL Definition Content Server is the foundation of Documentum s content management system. Content Server is the core component that allows users to create, capture, manage, deliver, and archive enterprise content. The functionality and features of Content Server provide content and process management services, security for the content and metadata in the repository, and distributed services. Documentum Foundation Classes. A key part of the EMC Documentum software platform. From the EMC Documentum functionality point of view, DFC lies between EMC Documentum Content Server and EMC Documentum clients. DFC is Java based. Lightweight Directory Access Protocol. Industry standard networking protocol that queries and modifies directory services. Documentum Client Library. Manages communication between clients and EMC Documentum Content Server. Contains a library of API calls that are used by clients for execution on the EMC Documentum Content server. All client requests to the EMC Documentum Content Server go through the DMCL. 18 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Chapter 2 Introducing the Interface of IVRC specific iviews Overview This chapter introduces you to the iviews shipped along with IVRC. This chapter contains the following topics: Introducing Link Documentum iview s interface, page 19 Introducing Search Documentum iview s interface, page 23 Introducing the FI Document Browser iviews interface, page 27 Introducing the PrintList Browser s interface, page 31 Introducing Link Documentum iview s interface Overview This section contains the following topics: Using the Link Documentum iview GUI, page 19 Configuring columns of the query results table, page 25 Format of query results table, page 31 Using the Link Documentum iview GUI The Link Documentum iview s GUI appears as follows: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 19

Introducing the Interface of IVRC specific iviews Figure 2. Link Documentum iview interface The Link Documentum iview contains the following IVRC specific elements: SAP Object Key field Contains the SAP Object Key of an SAP business object. When you click on an SAP business object, this field is automatically populated by IVRC. Search Term field Contains the term that is being used for a specific search in an EMC Documentum repository. Edit the default search term to customize your search, if required. 20 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing the Interface of IVRC specific iviews Select Query list box Contains the query templates stored in the following location of an EMC Documentum repository: Cabinets > System > Doclink > EP > LinkType. Not all queries stored in this location appear in the Select Query drop down list; only queries that satisfy the following criteria are displayed in this drop down list: The value of the dql_query_type attribute is set to Browse. The value of the sap_object_type attribute is set to one of the following: DQL DIR AL Select an appropriate query to find related content in the EMC Documentum repository. The list of available queries can be configured by content administrators, and may show different values in your environment. Search Documentum button Clicking the Search Documentum button executes the query chosen from the Select Query drop down list. Table containing DQL query results Contains the results of the query chosen from the Select Query drop down list. The information displayed in this table can be configured by content administrators. More information on customizing this table is in Format of query results table, page 31 and Configuring columns of the query results table, page 25. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 21

Introducing the Interface of IVRC specific iviews Drop down list below the table containing DQL query results Contains the query templates stored in the following location of a repository: Cabinets > System > Doclink > EP > LinkType. Not all queries stored in this location appear in the Select Query drop down list; only queries that satisfy the following criteria are displayed in this drop down list: The value of the dql_query_type attribute is set to one of the following: Browse Search The value of the sap_object_type attribute is set to one of the following: DIR DIR_ONLY AL Select an appropriate query to map EMC Documentum object attributes to DIR object attributes in SAP. EMC Documentum Clicking the EMC Documentum icon displays the following information: The version of IVRC The repository to which the iview has connected Note: IVRC iviews are built based on the guidelines provided by SAP for developing iviews. More information on standard GUI elements in an iview is on the SAP Help website (http://help.sap.com). Format of query results table The column headers of the query results table are derived from the user friendly attribute labels of the EMC Documentum object attributes. These attribute labels are read from the dmi_dd_attr_info object in EMC Documentum. More information on the dmi_dd_attr_info object is in the EMC Documentum Content Server s Object Reference Manual. 22 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing the Interface of IVRC specific iviews Configuring columns of the query results table Excepting the DQL linktype, for all other linktypes, each column of the query results table corresponds to the columns specified in the Columns returned by the query attribute in DA or Webtop. For DQL linktypes, each column of the query results table corresponds to the columns specified in the select clause of the DQL query associated with the link type. To change the columns shown in the query results table, you should change the Select clause of the associated DQL query. In addition to the columns specified in the DQL query, you can specify the IS_FOLDER value in the Columns returned by the query attribute of the link type; this adds a corresponding column to the query results table. For example, if the select clause of the DQL query is select subject, object_name from <rest of DQL query>, then only 2 columns, subject and object_name, are shown in the results table. To add the keywords column, you must change the DQL query as follows: select subject, object_name, keywords from <rest of DQL query>. Introducing Search Documentum iview s interface Overview This section contains the following topics: Using the Search Documentum iview GUI, page 23 Format of query results table, page 31 Configuring columns of the query results table, page 25 Using the Search Documentum iview GUI The Search Documentum iview s GUI appears as follows: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 23

Introducing the Interface of IVRC specific iviews Figure 3. Search Documentum iview interface The Search Documentum iview contains the following IVRC specific elements: Search Term field Contains the term that is being used for a specific search in an EMC Documentum repository. Edit the default search term to customize your search, if required. Select Query drop down list Contains all the query templates stored in the following location of a repository: Cabinets > System > Doclink > EP > LinkType. Not all queries stored in this location appear in the Select Query drop down list; only queries that satisfy the following criteria are displayed in this drop down list: The value of the dql_query_type attribute is set to Search. The value of the sap_object_type attribute is set to one of the following: DQL DIR Select an appropriate query to find related content in the EMC Documentum repository. The list of available queries can be configured by content administrators, and may show different values in your environment. Search Documentum button Clicking the Search Documentum button executes the query chosen from the Select Query drop down list. 24 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing the Interface of IVRC specific iviews Table containing DQL query results This table is populated with the results of the query chosen from the Select Query drop down list. The information displayed in this table can be configured by content administrators. More information on customizing this table is in Format of query results table, page 31 and Configuring columns of the query results table, page 25. EMC Documentum Clicking the EMC Documentum icon displays the following information: The version of IVRC The repository to which the iview has connected Note: IVRC iviews are built based on the guidelines provided by SAP for developing iviews. More information on standard GUI elements in an iview is on the SAP Help website (http://help.sap.com). Format of query results table The column headers of the query results table are derived from the user friendly attribute labels of the EMC Documentum object attributes. These attribute labels are read from the dmi_dd_attr_info object in EMC Documentum. More information on the dmi_dd_attr_info object is in the EMC Documentum Content Server s Object Reference Manual. Configuring columns of the query results table Excepting the DQL linktype, for all other linktypes, each column of the query results table corresponds to the columns specified in the Columns returned by the query attribute in DA or Webtop. For DQL linktypes, each column of the query results table corresponds to the columns specified in the select clause of the DQL query associated with the link type. To change the columns shown in the query results table, you should change the Select clause of the associated DQL query. In addition to the columns specified in the DQL query, you can specify the IS_FOLDER value in the Columns returned by the query attribute of the link type; this adds a corresponding column to the query results table. For example, if the select clause of the DQL query is select subject, object_name from <rest of DQL query>, then only 2 columns, subject and object_name, are shown in the results table. To add the keywords column, you must change EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 25

Introducing the Interface of IVRC specific iviews the DQL query as follows: select subject, object_name, keywords from <rest of DQL query>. Search Documentum iview GUI The Search Documentum iview s graphical user interface (GUI) appears as follows. Figure 4. Search Documentum iview interface The Search Documentum iview contains the following IVRC specific elements: Search Term field Contains the term that is being used for a specific search in an EMC Documentum repository. Edit the default search term to customize your search, if required. Select Query drop down list Contains all the query templates that are accessible to your role. Select an appropriate query to find related content in the EMC Documentum repository. The list of available queries can be configured by content administrators, and may show different values in your environment Search Documentum button Clicking the Search Documentum button executes the query chosen from the Select Query drop down list. Table containing DQL query results This table is populated with the results of the query chosen from the Select Query drop down list. 26 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing the Interface of IVRC specific iviews EMC Documentum Clicking the EMC Documentum icon displays the following information: The version of IVRC The repository to which the iview has connected Note: IVRC iviews are built based on the guidelines provided by SAP for developing iviews. More information on standard GUI elements in an iview is on the SAP Help website (http://help.sap.com). Introducing the FI Document Browser iviews interface Overview This section introduces you to the following two FI (Financial Accounting) Document Browsers shipped with IVRC: FI Document Browser (Vendor) FI Document Browser (Customer) FI Document Browser iviews fetch data from the BSEG table in SAP and display them in SAP Portal. Clicking on a specific row in the result set triggers an event that may be used by the Search Documentum or Link Documentum iviews in the business context. You can then search related content in configured EMC Documentum repositories for the selected FI object; you can also link the FI object to EMC Documentum objects. This section contains the following topics: Introducing the FI Document Browser (Vendor) iview s interface, page 27 Introducing the FI Document Browser (Customer) iview s interface, page 30 Format of query results table, page 31 Introducing the FI Document Browser (Vendor) iview s interface The FI Document Browser (Vendor) appears as follows: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 27

Introducing the Interface of IVRC specific iviews Figure 5. FI Document Browser (Vendor) interface The FI Document Browser (Vendor) contains the following elements: 28 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing the Interface of IVRC specific iviews Search section This section contains the following SAP items: Document Number Identifies an SAP document as the main part of a document key. This field accepts string values. Company Code Represents a legally independent firm with its own independent accounting. The company code is identified by a four character alphanumeric code. This field accepts string values. Fiscal Year Usually a period of 12 months for which a company regularly creates financial statements and checks inventories. This field accepts numerical values. Vendor Number Account number of the vendor in the SAP system. This field accepts string values. Note: The vendor number is a 10 character string value. If the length of the vendor number value is less than 10, then FI Document Browser adds leading zeros to the value. When searching for the exact vendor number, type the exact value and FI Document Browser adds the necessary leading zeros. When searching for similar values, type the asterisk symbol (*) before the actual vendor number. This ensures that you do not need to enter leading zeros for the vendor number. For example, to get all values for a vendor number that starts with 59, type *59*. Search button Clicking this button executes a search in SAP, based on the search criteria entered in the Document Number, Company Code, Fiscal Year, and Vendor Number fields. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 29

Introducing the Interface of IVRC specific iviews Results section Contains the results of the search executed in the Search section. Mouse over the column headers of the result set to display the full column name along with their corresponding field names in FI tables. Introducing the FI Document Browser (Customer) iview s interface The FI Document Browser (Customer) iview appears as follows. Figure 6. FI Document Browser (Customer) interface The elements in the FI Document Browser (Customer) and FI Document Browser (Vendor) iviews interfaces share many elements; the only difference is that the FI Document Browser (Vendor) iview has the Vendor Number field, whereas the FI Document Browser (Customer) iview has the Customer Number field. In the Customer Number field, type the account number of the customer in the SAP system. This field accepts string values. Note: The customer number is a 10 character string value. If the length of the customer number value is less than 10, then FI Document Browser adds leading zeros to the value. When searching for the exact customer number, type the exact value and FI Document Browser adds the necessary leading zeros. When searching for similar values, type the asterisk symbol (*) before the actual customer number. This ensures that you do not need to enter leading zeros for the vendor number. For example, to get all values for a customer number that starts with 59, type *59*. 30 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing the Interface of IVRC specific iviews Format of query results table The column headers of the query results table are determined by the values you enter when configuring the FI Document Browser iview. Each column corresponds to the attributes mentioned in the Application Parameters field of the Property Editor FI Document Browser iview. The column headers of the query results table are determined by the values you enter when configuring the FI Document Browser iview. Each column corresponds to the values mentioned in the Application Parameters field of the Property Editor FI Document Browser iview. More information is in the Configuring the FI Document Browser iview section of the EMC Documentum Content Services for SAP Portal iviews for Related Content Administration Guide. The maximum number of columns is 20. Introducing the PrintList Browser s interface Overview This section contains the following topics: Using the PrintList Browser iview s interface, page 31 Format of query results table, page 32 Using the PrintList Browser iview s interface The PrintList Browser s interface appears as follows. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 31

Introducing the Interface of IVRC specific iviews Figure 7. PrintList Browser iview interface The PrintList Browser iview contains the following elements: Search section Report Name Info Storage Date Business Object Document Type User Short Text Storage Sys. Document ID Search button Clicking this button executes a search in SAP, based on the search criteria entered previously. PrintList Results section Contains the results of the search executed in the Search section. Format of query results table The column headers of the query results table are determined by the values you enter when configuring the PrintList Browser iview. Each column corresponds to 32 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Introducing the Interface of IVRC specific iviews the attributes mentioned in the Application Parameters field of the Property Editor PrintList Browser iview. The column headers of the query results table are determined by the values you enter when configuring the PrintList Browser iview. Each column corresponds to the attributes mentioned in the Application Parameters field of the Property Editor PrintList Browser iview. More information is in the Configuring the PrintList Browser iview section of the EMC Documentum Content Services for SAP Portal iviews for Related Content Administration Guide. The maximum number of columns is 20. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 33

Introducing the Interface of IVRC specific iviews 34 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Chapter 3 Administering IVRC Overview This chapter contains the following topics: Working with IVRC related logging, page 35 Modifying the IVRC configuration object, page 41 Configuring system landscapes, page 45 User mapping, page 52 Setting up Single Sign On (SSO) connections, page 54 Configuring pages and iviews, page 56 Working with query templates using DA or Webtop, page 69 Connecting to multiple EMC Documentum repositories, page 81 Using IVRC to work with DCM controlled documents, page 83 Support for EMC Documentum PDF Annotation Services, page 84 Note: The tasks described in this chapter need to be performed infrequently by administrators; these tasks effect changes to application wide settings. Working with IVRC related logging This section contains the following topics: Defining output files for logging, page 35 Configuring logging for DFC services container, page 36 Integrating iviews for Related Content related logging with SAP Portal s logging system, page 37 Defining output files for logging The log output goes to the file specified in the log4j_ivrc.properties file. To define a log output file in log4j_ivrc.properties, do the following: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 35

To define a log output file in log4j_ivrc.properties: 1. Open the log4j_ivrc.properties file available here: In Windows: <DFC installation directory>\config In UNIX: <DFC installation directory>/config 2. Locate the following section in the file: log4j.appender.eiivrclog.file=c\:/documentum/logs/ivrc.log # For Unix platform uncomment following line and comment out the above mentioned windows log file path # log4j.appender.eiivrclog.file=/usr/documentum/logs/ivrc.log 3. Depending on your operating system, edit the code snippet as follows: In Windows: log4j.appender.eiivrclog.file=<required directory for log output> # For Unix platform uncomment following line and comment out the above mentioned windows log file path # log4j.appender.eiivrclog.file=<required directory for log output> In UNIX: #log4j.appender.eiivrclog.file= <required directory for log output> # For Unix platform uncomment following line and comment out the above mentioned windows log file path log4j.appender.eiivrclog.file=<required directory for log output> 4. Save the changes. Configuring logging for DFC services container To configure the logging for the DFC services container: Follow this procedure to configure logging for DFC services container. 1. Set the logging level for the dmcl web application in the log4j.properties file; the log4j.properties file is available here: <$TOMCAT_HOME>/webapps/dmcl/ WEB INF. 2. Locate the following code snippet and set the appropriate logging level: log4j.logger.com.documentum.dmcl.http=warn 36 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Note: The supported logging levels are: FATAL ERROR WARN INFO DEBUG The default logging level is WARN. 3. Save the file. Note: By default, log statements related to the dmcl web application are printed to the dmcl_http.log file available here: <$TOMCAT_HOME>/webapps/dmcl/WEB INF. Integrating iviews for Related Content related logging with SAP Portal s logging system Overview This section contains the following topics: Introducing SAP s definition of logging and tracing, page 37 Integrating iviews for Related Content and SAP Portal logging, page 39 Introducing SAP s definition of logging and tracing Overview You can integrate iviews for Related Content related logging with SAP Portal s logging system. SAP logging clearly differentiates between logs and traces. This section contains the following topics: Logging, page 38 Tracing, page 38 Difference between logging and tracing, page 38 Mapping Log4j s severity levels with SAP logging s severity levels, page 38 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 37

Logging SAP defines logging as creating and storing a permanent record of events that can be reviewed, printed, and analyzed. This record usually contains information about the source of the record, a timestamp of the event, a message, and a severity which specifies the importance of the record. All the information of an event is recorded; administrators use this information to control the status of the system, the database, and all applications. Logs get written automatically and with a predefined granularity (severity), which can be modified during runtime. SAP intends for logs to be used by administrators. Logs have a.log file extension. Tracing SAP defines tracing as a utility that writes detailed information about an operation to an output file. The trace facility produces a detailed sequence of statements that describe the events of an operation as they are executed. Administrators and developers use the trace facility for diagnosing an abnormal condition; therefore tracing is not normally turned on. Traces can be switched on if a problem has occurred and a detailed analysis of a distinct part of a program is necessary. SAP intends for traces to be used by developers. Traces have a.trc file extension. Difference between logging and tracing Logs are normally written to categories and traces are normally written to locations. Categories are semantic topics corresponding generally to administration tasks. Locations refer to certain points in the software code and can be identified with package, class, or function names. Mapping Log4j s severity levels with SAP logging s severity levels The following table indicates how Log4j s severity levels are mapped to SAP logging s severity levels, and the destination where the messages will be written to. Table 2. Mapping Log4j s severity levels with SAP logging s severity levels This log4j severity level Debug Info Is treated in SAP logging as follows Written to trace files. Written to log files. Category defined in the log4j configuration file. 38 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

This log4j severity level Warn Error Fatal Other (user defined severity level) Is treated in SAP logging as follows Written to log files. Category defined in the log4j configuration file. Written to log files. Category defined in the log4j configuration file. Written to log files. Category defined in the log4j configuration file. Written to log files. Category defined in the log4j configuration file. Integrating iviews for Related Content and SAP Portal logging Overview By default, iviews for Related Content logging system is enabled so that it can be configured with SAP Portal logging. The log4j_ivrc.properties file contains the following code snippet that enables the integration of these two logging systems: log4j.appender.saplogging=com.documentum.ei.eplogging.saplogappender log4j.appender.saplogging.categoryname=documentum/ivrc Note: To disable the integration of the two logging systems, comment the code snippet referenced previously. When you integrate the two logging systems, log4j_ivrc behaves as the first level of logging; you can control the severity of the log messages going into SAP logging depending on the settings specified in the log4j_ivrc.properties file. This section contains the following topics: Configuring the severity of logging in SAP, page 39 Viewing IVRC related logs in SAP, page 41 Configuring the severity of logging in SAP Depending on the severity of the log4j log messages, they are written either to SAP s default trace or the appropriate log category. You can control the severity level of the IVRC specific logs in SAP. To control the severity level of IVRC specific logging in SAP: 1. Do one of the following: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 39

In Windows: In the system where SAP NetWeaver is installed, run the go.bat file available in the following directory: <SAP NetWeaver installationdirectory>\<j2eeinstance>\jc00\j2ee\admin. In UNIX: In the system where SAP NetWeaver is installed, run the go.sh file available in the following directory: <SAP NetWeaver installation directory>/<j2eeinstance>/ JC00/j2ee/admin. The Connect to SAP J2EE Engine dialog box appears. 2. Select Default and click Connect. The Login dialog box appears. 3. Enter your login credentials and click Connect. The Visual Administrator interface appears. 4. In the left pane, click the Cluster tab, and browse to <SID> > <server instance> > Services > Log Configurator. 5. To configure the log category, do the following: 1. In the middle pane, click the Categories tab. 2. Click the To advanced mode tab. 3. In the right pane, click the New button. The New Controller dialog box appears. 4. In the New controller name field, type Documentum/IVRC. 5. From the Severity drop down list, select an appropriate severity level. 6. To save the changes, click the Save icon. 7. From the context menu that appears, click Apply to all server nodes. 6. To configure the default trace, do the following: 1. In the middle pane, click the Locations tab. 2. Click the To advanced mode tab. 3. In the right pane, click the New button. The New Controller dialog box appears. 4. In the New controller name field, type com.documentum.ei. 5. From the Severity drop down list, select an appropriate severity level. 6. To save the changes, click the Save icon. 40 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

7. From the context menu that appears, click Apply to all server nodes. Viewing IVRC related logs in SAP To view IVRC related logs in SAP: 1. Do one of the following: In Windows: In the system where SAP NetWeaver is installed, run the go.bat file available in the following directory: <SAP NetWeaver installationdirectory>\<j2eeinstance>\jc00\j2ee\admin. In UNIX: In the system where SAP NetWeaver is installed, run the go.sh file available in the following directory: <SAP NetWeaver installation directory>/<j2eeinstance>/ JC00/j2ee/admin. The Connect to SAP J2EE Engine dialog box appears. 2. Select Default and click Connect. The Login dialog box appears. 3. Enter your login credentials and click Connect. The Visual Administrator interface appears. 4. In the left pane, click the Cluster tab, and browse to <SID> > <server instance> > Services > Log Viewer. 5. IVRC related log files are available here: Cluster > server instance > <SAP_Installation_Directory > > <Server_Instance_Directory> > log. Modifying the IVRC configuration object When you install the EI_Core_Docapp DocApp, a configuration object, IVRC Config, is installed in the repository in the following location: Cabinets > System > Doclink > EP > IVRC. To modify the IVRC configuration object: 1. Using Webtop, log in to the repository where you have installed the EI_Core_Docapp DocApp. 2. Browse to Cabinets > System > Doclink > EP > IVRC. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 41

3. Open the Properties page for the IVRC Config object by clicking the Properties icon next to it. 4. In the page that appears, click the Info tab. 5. Select the Show all properties checkbox. 6. Configure the attributes for this object as described in the following table: Table 3. Fields in the IVRC Config object s Properties page Field Type Description EventName And Object Type Mapping Repeating String attribute Default values are as follows: urn:com.sap.bor:equi=equi urn:com.sap.bor:mara=mara urn:com.sap.bor:bus1001=mara Viewing Application Viewing Application URL Nonrepeating String attribute Nonrepeating String attribute In the value, the left side of the equation represents the name of the event; the right side of the equation represents the name of the SAP object type. The WebDynpro application uses this mapping to determine the SAP object type of an SAP object. Specify which application will be used to view or edit documents that are launched from IVRC related iviews. Possible values are: WDK Any application based on EMC Documentum s WDK framework. RM Repository Manager. The default value is WDK. Specify the URL of the application that is used to display the content of EMC Documentum objects. The URL that you specify here depends on the setting in the Viewing Application field. If WDK has been set as the viewing application, view the contents of a document by specifying the following URL:http://<hostname>:<portnumber>/webtop/action/view?objectId=%r_ object_id&format=%format 42 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Field Type Description Viewing Folder URL Nonrepeating String attribute Note: The values of r_object_id and format parameters are dynamically substituted in the URL if %r_object_id and %format are specified in the URL. If %r_object_id is not specified in the URL, then objectid=<value of r_object_id> is appended by default to the URL. If %format is not specified in the URL, then format=<value of format attribute> is appended by default to the URL. For example, if the value of the viewing application URL is http://<hostname>:<port number>/da/component/ drl, without the %r_object_id and %format parameters, then the URL value, with the value of the appended parameters, is as follows: http://<hostname>:<port number>/da/component/ drl?objectid=<value of r_object_id>&format=<value of format attribute> If Repository Manager (RM) has been set as the viewing application, depending on what tasks you want to accomplish with a document, specify one of the following URLs: To view properties of a document, view the contents of a document, or download or edit a document locally: http://<hostname>:<port number>/<resource_ properties_page_url> To view only the contents of a document: http://<hostname>:<port number>/<content_ access_path_url> To access various actions such as collaboration, discussions, and so on: http://<hostname>:<port number>/irj/servlet/prt/ portal/prtroot/com.sap.km.cm.uidetails (applies to NW 04 release only) To view the contents of a folder, use the following URL: If WDK has been set as the viewing application, and the selected object is a folder: http://<hostname>:<port number>/webtop/ component/doclist?folderid=%r_object_id EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 43

Field Type Description 7. Click OK. Note: The value of r_object_id parameter is dynamically substituted in the URL if %r_object_id is specified in the URL. If %r_object_id is not specified in the URL, then objectid=<value of r_object_id> is appended by default to the URL. For example, if the value of the viewing application URL is http://<hostname>:<portnumber>/da/component/drl, without the %r_object_id parameter, then the URL value, with the value of the appended parameter, is as follows: http://<hostname>:<port number>/da/ component/drl?objectid=<value of r_object_id> If RM has been set as the viewing application, and the selected object is a folder: http://<hostname>:<port number>/ <Navigation_Servlet_url> To obtain the values for resource_properties_ page_url, content_access_path_url, and Navigation_Servlet_url: Log on to the EP as a Administrator Navigate to System Administrator > System Configuration > Knowledge Management > Content Management > Global services (Advance options) > URL generator Obtain the value of the parameter Content Access Path for <content_access_path_url> Obtain the value of the parameter Resource Properties Page for <resource_properties_page_ url> Obtain the value of the parameter Navigation Servlet for <Navigation_Servlet_url> 44 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Configuring system landscapes Overview An SAP system landscape is the enterprise IT system infrastructure managed by SAP, containing various IT applications, objects, and aliases. Through a well defined system landscape, SAP maintains connectivity to various backend applications and information sources. In order to facilitate the mapping of SAP Portal users with EMC Documentum repository users, you should create a system landscape for each EMC Documentum repository. IVRC provides the following two bundled system landscape objects: Documentum_CSSPortal_IVRC_DocumentumRepository You can do one of the following with this object: Copy and edit the object Directly edit the object More information is in Configuring EMC Documentum repository related system landscape objects, page 46. Documentum_CSSPortal_IVRC_SAP_R3_PLM Edit this object according to the SAP R/3 software settings in your enterprise. More information is in Configuring SAP R/3 related system landscape objects, page 48. Note: Some of the business packages provided by SAP require the SAP_R3_PLM system alias to connect to SAP R/3. If an SAP business packages does not require you to use the SAP_R3_PLM alias, then you can use any other appropriate system alias to connect to SAP R/3. These system landscapes are available in SAP Portal after IVRC is installed. This section contains the following topics: Configuring EMC Documentum repository related system landscape objects, page 46 Configuring SAP R/3 related system landscape objects, page 48 Configuring SLD for FI and PrintList browsers, page 50 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 45

Configuring EMC Documentum repository related system landscape objects To configure EMC Documentum repository related system landscape objects: 1. Using SAP Portal, connect to the SAP NetWeaver server on which you have deployed iviews for Related Content. Note: You must log in to SAP NetWeaver as a system administrator. 2. Browse to System Administration > System Configuration > System Landscape. 3. In the content area, to view the objects under Portal Content, click the arrow icon next to Portal Content. The various folders and objects under Portal Content appear. 4. Do one of the following: Create a new system landscape 1. Right click on any folder and choose New From PAR > System. 2. In the Portal Archive Selection iview of the System Wizard, select the com.documentum.pct.ei.dmeventcontroller radio button. 3. Click Next. 4. In the Portal Component Selection iview, select Documentum_ CSSPortal_IVRC_System. 5. Click Next. 6. In the General Properties iview, type values for the following fields: System Name Type a unique name for the system landscape. System ID Type a unique ID for the system landscape. 1. Click Next. 2. In the Summary iview, review the system landscape and click Finish. The Choose your next step iview appears. 3. Select the the object for editing radio button and click OK. 46 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Edit the Documentum_CSSPortal_IVRC_DocumentumRepository system landscape that comes bundled with IVRC. 4. Browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > System Landscape. The contents of the System Landscape folder appear. 5. Right click Documentum_CSSPortal_IVRC_DocumentumRepository and choose > Object. 5. The Property Editor <name of system landscape> iview appears. From the Property Category drop down list, select Show All. 6. Type values in the fields described in the following table: Table 4. Fields in Property Editor <name of system landscape> iview Field Docbase Domain name Docbase name Docbase superuser Domain Docbase superuser ID Docbase superuser password Documentum Repository User Mapping Type Description Name of the label that is displayed in the user mapping editor. The default value is DocbaseDomain. Change the value of this field only if you want different label in the user mapping editor. Name of the repository that you wish to configure for this system landscape. Name of the domain against which superusers (Principal IDs) are authenticated. Principal ID (having superuser privileges) of the repository that you wish to configure. Password associated with the principal ID. Type of single sign on authentication. The options are as follows: Principal: Select Principal if the repository and SAP NetWeaver have users with identical login names, or point to users in a common LDAP directory server. User Mapping: Select User Mapping if you would like to implement single sign on authentication without a common LDAP directory server. More information is in User mapping, page 52. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 47

Field Is a Template User Mapping Type Description Option that determines if the present system landscape can be saved as a template for future reuse.click No. Determines the type of users can perform user mapping. The options are as follows: userall users in a repository can perform user mapping. adminonly users with administrative privileges can perform user mapping. user, adminstandard users and administrators can perform user mapping. 7. Click Save. 8. From the Display drop down field, choose System Aliases. 9. In the Alias field, type the name of the EMC Documentum repository that you wish to map to this system landscape and click Add. By default, the iviews are configured to use the system alias named Documentum_CSSPortal_IVRC_DocumentumRepository. If you name your EMC Documentum related system alias as Documentum_CSSPortal_IVRC_ DocumentumRepository, then you do not need to change the iview configuration. 10. Click Save. Configuring SAP R/3 related system landscape objects Some of the business packages provided by SAP require the SAP_R3_PLM system alias to connect to SAP R/3. If some SAP business packages do not require you to use the SAP_R3_PLM alias, then you can use any other appropriate system alias to connect to SAP R/3. This section contains the following topics: Configuring the SAP_R3_PLM system alias, page 49 Configuring support for load balancing, page 50 48 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Configuring the SAP_R3_PLM system alias To configure SAP R/3 related system landscape objects: 1. Using SAP Portal, connect to the SAP NetWeaver server on which you have deployed iviews for Related Content. Note: You must log in to SAP NetWeaver as a system administrator. 2. Browse to System Administration > System Configuration > System Landscape. 3. In the content area, to view the objects under Portal Content, click the arrow icon next to Portal Content. The various folders and objects under Portal Content appear. 4. Browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > System Landscape. The contents of the System Landscape folder appear. 5. Right click the Documentum_CSSPortal_IVRC_SAP_R3_PLM system landscape object and choose > Object. 6. The Property Editor Documentum_CSSPortal_IVRC_SAP_R3_PLM iview appears. From the Property Category drop down list, select Show All. 7. Edit this object according to the SAP R/3 system settings in your enterprise. Note: If you would like connect to the SAP R/3 system using SAPLogon ticket, instead of user mapping, from the Logon Method drop down list, select SAPLOGONTICKET. 8. Click Save. 9. From the Display drop down field, choose System Aliases. 10. In the Alias field, type a name of your choice and click Add. If you wish to use SAP business packages, specify SAP_R3_PLM as the alias name in the system landscape. 11. Click Save. 12. From the Display drop down list, choose Permissions. The Permission Editor iview appears. 13. In the Search for field, type the name of the user, role, or group to be assigned permissions. Click Go. 14. From the list that appears, select the required user, role, or group and click Add. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 49

The selected user, role, or group appears in the Assigned Permissions section of the iview. 15. For the selected user, assign at least the Read permission. 16. For the selected user, select the End User checkbox. 17. Click Save. Configuring support for load balancing IVRC, by default, uses the Documentum_CSSPortal_IVRC_SAP_R3_PLM system landscape object to connect to SAP R/3. More information is in Configuring the SAP_R3_PLM system alias, page 49. The Documentum_CSSPortal_IVRC_SAP_R3_PLM system landscape object does not support load balancing. To achieve load balancing through IVRC, perform the following high level tasks: 1. Create a new system landscape object using the R/3 System with Load Balancing template in SAP Portal; for general guidelines on creating SAP R/3 related system landscape objects. More information is in Configuring the SAP_R3_PLM system alias, page 49. 2. If your enterprise uses SAP business packages that do not support load balancing using SAP Message Server, then name the system landscape object, and the associated system alias (created in step 1), as something other than SAP_R3_PLM. Note: When creating system landscape objects to support load balancing, avoid using SAP_R3_PLM as the name of the object, and the associated system alias; this is because the SAP_R3_PLM value is hard coded in some SAP business packages. 3. Configure the Documentum Event Controller iview to use the system landscape alias created in step 1. Type the name of the load balancing related system alias in the com.documentum.pct.ei.epiviews.r3_system_alias field of the Property Editor Documentum Event Controller page. More information is in Configuring the Documentum Event Controller iview, page 62. Configuring SLD for FI and PrintList browsers Configure the System Landscape Directory (SLD) of SAP NetWeaver so that end users can use the FI browser and PrintList browser iviews that are packaged with IVRC. This section contains the following topics: 50 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Configuring SLD for FI browser, page 51 Configuring SLD for PrintList browser, page 51 This section contains high level instructions on accomplishing IVRC specific tasks when working with SLDs. More information for working with SLDs is on the SAP Help website (http://help.sap.com). Configuring SLD for FI browser To configure SLD for FI browser, perform the following high level instructions: 1. Ensure that your SLD server is configured and started. 2. Login to the Web Dynpro Content Administrator tool with valid credentials. 3. In the Web Dynpro Content Administrator, create the following SAP Java Connector (JCo) destinations: WD_DCTM_FIBROWSER_MODELDATA_DEST WD_ DCTM_FIBROWSER _RFC_METADATA_DEST 4. To ensure that the JCo destinations are working correctly, do the following: 1. In Web Dynpro Content Administrator, click Maintain JCo Destinations. The JCo Destination Details page appears. 2. Click the Test and Ping buttons for the JCo destinations that you created previously in this section. If no errors are returned, it indicates that your JCo destinations are configured properly. Configuring SLD for PrintList browser To configure SLD for PrintList browser, perform the following high level instructions: 1. Ensure that your SLD server is configured and started. 2. Login to the Web Dynpro Content Administrator tool with valid credentials. 3. In the Web Dynpro Content Administrator, create the following SAP Java Connector (JCo) destinations: WD_DCTM_PLBROWSER_MODELDATA_DEST WD_ DCTM_PLBROWSER _RFC_METADATA_DEST 4. To ensure that the JCo destinations are working correctly, do the following: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 51

1. In Web Dynpro Content Administrator, click Maintain JCo Destinations. The JCo Destination Details page appears. 2. Click the Test and Ping buttons for the JCo destinations that you created previously in this section. If no errors are returned, it indicates that your JCo destinations are configured properly. User mapping Overview iviews for Related Content allows administrators to implement single sign on authentication for users when accessing EMC Documentum repositories from within SAP Portal. This is done in the following two ways: Configuring a common user base using identical login names in EMC Documentum repository and SAP Portal. A common user base, using identical login names in an EMC Documentum repository and SAP Portal, can be achieved by IT conventions; common user bases can also be achieved by configuring EMC Documentum Content Server and SAP NetWeaver to point to users in a common LDAP directory server. More information is in the Configuring LDAP settings for EMC Documentum Content Server and SAP NetWeaver section of the EMC Documentum Content Services for SAP Portal iviews for Related Content Installation Guide). Implementing user mapping in SAP Portal User mapping allows SAP Portal users to seamlessly access EMC Documentum repository objects; this ensures that users do not have to authenticate themselves specifically for the purpose of accessing a repository to which they have been assigned access privileges. Single sign on authentication using user mappings allows you to have differently named users in EMC Documentum and SAP Portal. User mapping can be done in the following ways: User mapping with administrative privileges, page 53 User mapping with standard user privileges, page 53 52 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

User mapping with administrative privileges To map users: 1. Using SAP Portal, connect to the SAP NetWeaver server on which you have deployed iviews for Related Content. Note: You must log in to SAP NetWeaver as a user administrator. 2. Browse to User Administration > User Mapping. 3. Search for the SAP Portal User to whom you wish to grant access to an EMC Documentum. 4. Click Edit for the required user. The Logon Data for <user name> iview appears. 5. From the System drop down list, select the EMC Documentum related system landscape object that you configured previously. More information is in Configuring EMC Documentum repository related system landscape objects, page 46. 6. In the User field, type the required user name in the EMC Documentum repository. 7. In the Password field, type the corresponding password. 8. To save the user mapping, click Save. 9. From the System drop down list, select the SAP R/3 related system landscape that you configured previously. More information is in Configuring SAP R/3 related system landscape objects, page 48. 10. In the User field, type the required user name in the SAP R/3 system. 11. Enter your password in the Password field. 12. To save the user mapping, click Save. User mapping with standard user privileges To map users: 1. Using SAP Portal, connect to the SAP NetWeaver server on which you have deployed iviews for Related Content. 2. In the upper right corner of SAP Portal, click Personalization. 3. In the window that appears, click User Mapping. The User Mapping iview appears. 4. From the System drop down list, select the EMC Documentum related system landscape object that you would like to map your login credentials with. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 53

5. In the User field, type the required user name in the EMC Documentum repository. 6. In the Password field, type the corresponding password. 7. From the System drop down list, select the SAP R/3 related system landscape object hat you would like to map your login credentials with. 8. In the User field, type the required user name in the SAP R/3 system. 9. In the Password field, type the corresponding password. 10. To save the user mapping, click Save. Setting up Single Sign On (SSO) connections This section describes how you can use SSP tickets to authenticate users between SAP Portal and SAP R/3 servers. Note: The basic prerequisite for this type of authentication is that a user should have identical login credentials in all participating systems. This section contains the following topics: Exporting public certificates from SAP Web AS, page 54 Configuring SAP R/3, page 55 Importing certificates from SAP Web AS to SAP R/3, page 56 Exporting public certificates from SAP Web AS To export public certificates from SAP Web AS: 1. Do one of the following: In Windows: In the system where SAP NetWeaver is installed, run the go.bat file available in the following directory: <SAP NetWeaver installationdirectory>\< J2EEinstance>\JC00\j2ee\admin. In UNIX: In the system where SAP NetWeaver is installed, run the go.sh file available in the following directory: <SAP NetWeaver installationdirectory>/< J2EEinstance>/JC00/j2ee/admin. The Connect to SAP J2EE Engine dialog box appears. 2. Select Default and click Connect. The Login dialog box appears. 54 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

3. Enter your login credentials and click Connect. The Visual Administrator interface appears. 4. In the left pane, click the Cluster tab, and browse to <SID> > <server_instance> > Services > Key Storage. 5. In the right pane, click the Runtime tab and the click TicketKeystore. 6. In the Entry section, click SAPLogonTicketKeypair cert. 7. In the Entry section, click the Export button. The Store key entry dialog box appears. 8. In this dialog box, do the following: 1. Set the destination directory as follows: <SAP NetWeaver_Installation_Directory>/ <J2EEinstance>. Files stored here will be remotely accessible through the \\<host name>\sapmnt shared directory. 2. Type a name of your choice for the file. 3. From the Files of Type dropdown list, select Base64 Encoded Certificate (*.cert) 4. Click OK. Configuring SAP R/3 To configure SAP R/3 to receive and validate SSP tickets: 1. Logon to SAP R/3 and execute transaction code rz10. The Edit Profiles page appears. 2. In the Profile field, select the DEFAULT profile. 3. In the Edit Profile section, select Extended maintenance and click the Change button. The Maintain R/3 Profile DEFAULT Version <version_number> page appears. 4. Edit the following parameters as indicated below: Parameter login/accept_sso2_ticket 1 login/create_sso2_ticket 0 5. Restart the SAP R/3 server. Value EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 55

Importing certificates from SAP Web AS to SAP R/3 To import certificates from SAP Web AS to SAP R/3: 1. Logon to SAP R/3 and execute transaction code strustsso2. The Trust Manager for Single Sign On with Logon Ticket page appears. 2. In the Certificate section, click the Import Certificate icon. The Import Certificate dialog box appears. 3. In the File path field, set the filename to point to the certificate file exported previously. More information is in Exporting public certificates from SAP Web AS, page 54. 4. In the File format section, select the Base64 radio button. 5. Save the changes by clicking the Input icon. The certificate details are now displayed in the Certificate section. 6. Click the Add to Certificate List button. 7. Click the Add to ACL button. The Add Entry to Single Sign On Access Control List dialog box appears. 8. Type values that are applicable to your environment and click the Input icon. 9. Click the Save icon. Configuring pages and iviews This section contains the following topics: Installing SAP business package iviews, page 56 Configuring pages, page 57 Configuring and working with iviews specific to Documentum, page 61 Installing SAP business package iviews You must install and configure either your own custom iviews or relevant SAP business package iviews. IVRC s iviews have been tested with (and are compatible with) the following SAP business packages: Business Package for Products 56 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Business Package for Projects Business Package for Assets The packages are available for download at the following location: https://www.sdn.sap. com/irj/sdn/developerareas/contentportfolio. Note: IVRC ships 2 sample pages which include iviews from SAP s Business Package for Assets. You should have a valid installation of Business Package for Assets in order to view these iviews. These sample pages help you to jumpstart the process of configuring pages, if you re also using Business Package for Assets in your enterprise. If you want to integrate IVRC iviews with either the iviews of other SAP business packages or your custom iviews, the you need not install Business Package for Assets. More information on using iviews from Business package for Assets is in the business package s online documentation. In summary, you can use one of the following types of iviews: iviews from one of the compatible SAP business packages iviews from any other SAP business package that transmit Enterprise Portal Client Framework (EPCF) events in the same way that compatible SAP business packages do Custom iviews that transmit EPCF events in a format that conforms to the guidelines in the compatible SAP business package online documentation include: Business Package for Products Business Package for Projects Business Package for Assets Configuring pages IVRC installs sample pages that you can copy and modify. You can also create your own page by performing steps explained in Creating new pages, page 58. You can access the sample pages in SAP Portal from one of the following locations: Content Administration > Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > Pages > IVRC Sample Pages EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 57

Content Administration > Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > Pages > Asset BP > Asset > equipment Note: These sample pages use iviews from SAP s Business Package for Assets. You should install Business Package for Assets in order to use these sample pages. If you want to integrate IVRC s iviews with other business packages, you must install relevant business packages. More information is in Installing SAP business package iviews, page 56. Depending on the kind of functionality that you need, select the search or link page. You can make a copy of these pages and modify the same. Creating new pages To configure pages in SAP Portal: 1. Using SAP Portal, connect to the SAP NetWeaver server on which you have deployed iviews for Related Content. Note: You must log in to SAP NetWeaver as a content administrator. 2. Browse to Content Administration > Portal Content. The Portal Content page appears. 3. In the navigation panel, click the Browse tab. 4. To view the objects under the Portal Content folder, click the arrow icon next to Portal Content. The various folders and objects under Portal Content appear. 5. Right click on the folder for which you want to configure a page; choose New > Page. The Portal Archive Selection iview of the Page Wizard appears. 6. Select the Default Page Template radio button. 7. Click Next. The General Properties iview appears. 8. Type values for the following fields: Name Type a unique name for the page. Page ID 9. Click Next. Type a unique ID for the page. The Select Page Layouts iview appears. 58 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

10. In the Available Layouts scroll down box, select the layout of your choice and click Add. 11. Click Next. The Summary iview appears. 12. Review the page details and click Finish. The Choose your next step iview appears. 13. Select the the object for editing radio button and click OK. The Property Editor <name of page> iview appears. 14. Click the Page Content radio button. 15. Keeping the Property Editor <name of page> iview open, in the navigation panel, browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > iviews > IVRC iviews. The contents of the IVRC iviews folder appear. 16. Right click Documentum Event Controller and choose Add iview to Page > Delta Link. The Documentum Event Controller iview is added to the page. Note: You should add the Documentum Event Controller iview to every page that is configured for IVRC functionality. Without the Documentum Event Controller iview, you cannot correctly configure a page for IVRC functionality. 17. Keeping the Property Editor <name of page> iview open, in the navigation panel, do one of the following: Adding SAP Business Package iview Browse to the folder containing the SAP Business Package iview that you installed previously. More information is in Installing SAP business package iviews, page 56. Right click the SAP Business Package iview and choose Add iview to Page > Delta Link. The SAP Business Package iview is added to the page. Adding FI Document Browser (Customer) iview Browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > iviews > FI Browser. The contents of the FI Browser folder appear. Right click FI Document Browser (Customer) and choose Add iview to Page > Delta Link. The FI Document Browser (Customer) is added to the page. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 59

Adding FI Document Browser (Vendor) iview Browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > iviews > FI Browser. The contents of the FI Browser folder appear. Right click FI Document Browser (Vendor) and choose Add iview to Page > Delta Link. The FI Document Browser (Vendor) is added to the page. Adding PrintList Browser iview Browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > iviews > PL Browser. Right click PrintList Browser and choose Add iview to Page > Delta Link. The PrintList Browser is added to the page. Adding Documentum Event Sender iview Browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > iviews > IVRC iviews. The contents of the IVRC iviews folder appear. Right click Documentum Event Sender and choose Add iview to Page > Delta Link. The Documentum Event Sender is added to the page. 18. Depending on the functionality you need, repeat steps 15 and 16 for one of the following iviews: Link Documentum Search Documentum 19. Click Save. 20. In the first column of the table, select the checkbox for the Documentum Event Controller iview. 21. Click Properties. The Property Editor Documentum Event Controller iview appears in the right side of the content area. 22. Edit the Documentum Event Controller iview s properties as described in Configuring the Documentum Event Controller iview, page 62. 23. Depending on your requirements, do the following: Editing the FI Document Browser (Customer) iview If you added the FI Document Browser (Customer) iview to the page in step 17, repeat steps 20 and 21 for the iview. 60 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Edit the FI Document Browser (Customer) iview s properties as described in Configuring the FI Document Browser iviews, page 65. Editing the FI Document Browser (Vendor) iview If you added the FI Document Browser (Vendor) iview to the page in step 17, repeat steps 20 and 21 for the iview. Edit the FI Document Browser (Vendor) iview s properties as described in Configuring the FI Document Browser iviews, page 65. Editing the PrintList Browser iview If you added the PrintList Browser iview to the page in step 17, repeat steps 20 and 21 for the iview. Edit the PrintList Browser iview s properties as described in Configuring the PrintList Browser iview, page 66. Editing the Documentum Event Sender iview If you added the Documentum Event Sender iview to the page in step 17, repeat steps 20 and 21 for the iview. Edit the Documentum Event Sender iview s properties as described in Working with the Documentum Event Sender iview, page 67. Editing the Search Documentum iview If you configured the page for the searching functionality (in step 18), repeat steps 20 and 21 for the Search Documentum iview. Edit the Search Documentum iview s properties as described in Configuring the Search Documentum iview, page 64. Editing the Link Documentum iview If you configured the page for the linking functionality (in step 18), repeat steps 20 and 21 for the Link Documentum iview. Edit the Link Documentum iview s properties as described in Configuring the Link Documentum iview, page 65. 24. Click Save. Configuring and working with iviews specific to Documentum Overview This section contains the following topics: Configuring the Documentum Event Controller iview, page 62 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 61

Configuring the Search Documentum iview, page 64 Configuring the Link Documentum iview, page 65 Configuring the FI Document Browser iviews, page 65 Configuring the PrintList Browser iview, page 66 Working with the Documentum Event Sender iview, page 67 Configuring the Documentum Event Controller iview Note: Perform the tasks described in this section after completing specific steps from the procedure described in Creating new pages, page 58. To configure the Documentum Event Controller iview: 1. In the Property Editor Documentum Event Controller iview, choose Show All from the Property Category drop down list. 2. Type values for the fields described in the following table: Table 5. Fields in Property Editor Documentum Event Controller iview Field com.documentum.pct.ei.epiviews. dctm_system_alias Description Name of the EMC Documentum repository system alias that points to the appropriate system landscape. More information is inconfiguring system landscapes, page 45. Default value is Documentum_CSSPortal_ IVRC_DocumentumRepository. com.documentum.pct.ei.epiviews. event_urn Uniform Resource Name (URN) and type of the event that you wish to configure. For example, the urn:com.sap.bor:equi?select indicates that the Documentum Event Controller iview is listening to the urn:com.sap.bor:equi event; select refers to the type of the event. You may specify only one URN in this field. IVRC supports the following formats: <event_name>?<event_type> <event_name>;<event_type> For example: urn:com.sap.bor:equi?select 62 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Field Description urn:com.sap.bor:equi;select. com.documentum.pct.ei.epiviews. r3_system_alias com.documentum.pct.ei.epiviews. sap_object_id_key_name Name of the system alias that points to the appropriate SAP R/3 system landscape.the default value is SAP_R3_PLM. Name and format for the object key for the sap object. For example, for material management objects, the key name is objid.ivrc supports multi part keys. Specify the multi field key as a concatenation of different attributes separated by the @ symbol in the right order. For example, for the DRAW object, specify the objectkey value as follows: type@number/l025@part/l03@version/ L02. The objectkey value contains the names of the key fields and the syntax for padding. The syntax is as follows: The / character indicates that this key needs padding. The character next to / indicates whether the padding should be done on the left or the right side, using one character. The character is either L or R. The character next to L or R indicates the character used for padding. This character is usually 0 or (space). The character next to the pad is the effective length after padding. For example, key field number/l025 indicates the following: Padding is necessary. Padding should be done on the left side using 0 The total length after padding should be 25 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 63

Field com.documentum.pct.ei.epiviews. delay_event Description Padding is only done for numeric values Delay time, in milliseconds, used by Documentum Event Controller before sending events to Web Dynpro; this delay ensures that Web Dynpro is fully initialized and ready to receive new events. The default value is 500 milliseconds. 3. Click Save. Configuring the Search Documentum iview Note: Perform the tasks described in this section after completing specific steps from the procedure described in Creating new pages, page 58. To configure the Search Documentum iview: 1. In the Property Editor Search Documentum iview, choose Show All from the Property Category drop down list. 2. In the Application Parameters field, edit the parameters (that are passed on to the Web Dynpro application) as follows: link=false Setting the value of the link parameter as false configures the logic of this iview to search for related content. ep_application_context=equipment_browser This parameter determines the link types that appear in the Search Documentum iview. For example, ep_application_context=equipment_browser. The value of ep_application_context parameter needs to correspond to the value of ep_application_context attribute of the sap_action_link_ doc_object objects; the sap_action_link_doc_object objects are available here in an EMC Documentum repository: Cabinets > System > Doclink > EP > LinkType. 3. Click Save. 64 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Configuring the Link Documentum iview Note: Perform the tasks described in this section after completing specific steps from the procedure described in Creating new pages, page 58. To configure the Link Documentum iview: 1. In the Property Editor Link Documentum iview, choose Show All from the Property Category drop down list. 2. In the Application Parameters field, edit the parameters (that are passed on to the Web Dynpro application) as follows: link=true Setting the value of the link parameter as true configures the logic of this iview to link related content. ep_application_context=<application_context> This parameter determines the link types that appear in the Link Documentum iview. For example, ep_application_context=equipment_browser. The value of ep_application_context parameter needs to correspond to the value of ep_application_context attribute of the sap_action_link_ doc_object objects; the sap_action_link_doc_object objects are available here in an EMC Documentum repository: Cabinets > System > Doclink > EP > LinkType. 3. Click Save. Configuring the FI Document Browser iviews Note: Perform the tasks described in this section after completing specific steps from the procedure described in Creating new pages, page 58. To configure one of the FI Document Browser (Customer) iviews: 1. In the Property Editor FI Document Browser (<Customer/Vendor>) iview, choose Show All from the Property Category drop down list. 2. In the Application Parameters field, the default value is as follows: For FI Document Browser (Customer) iview: eventurn=urn:com.documentum.pct.ei.epiviews:fi_browser;select&rowscount=10 &columnnames= KUNNR,GJAHR,BELNR,BUZEI,KOART,DMBTR,PSWSL,NEBTR,SAMNR,REWRT EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 65

For FI Document Browser (Vendor) eventurn=urn:com.documentum.pct.ei.epiviews:fi_browser;select&rowscount=10 &columnnames= LIFNR,GJAHR,BELNR,BUZEI,KOART,DMBTR,PSWSL,NEBTR,SAMNR,REWRT : 3. Edit the following parameters (which are passed on to the Web Dynpro application) as required: &rowscount The integer that you assign to this parameter determines the number of rows that will be displayed per page of the iview. The maximum number of rows returned is 1000. &columnnames Type field names (from the BSEG table in the FI module) of your choice. You can specify a maximum of twenty columns. Note: 4. Click Save. More information on how the values you assign here determine the format of the search resultset table is in Format of query results table, page 31. More information on field names in FI tables is on the SAP Help website (http://help.sap.com). Configuring the PrintList Browser iview Note: Perform the tasks described in this section after completing specific steps from the procedure described in Creating new pages, page 58. To configure the PrintList Browser iview: 1. In the PL Browser iview, choose Show All from the Property Category drop down list. 2. In the Application Parameters field, the default value is as follows: eventurn=urn:com.documentum.pct.ei.epiviews:printlist_browser; select&rowscount=10&columnnames=report,benutzer,ar_object,kurztext, INFO,DATUM,SAP_OBJECT,ARCHIV_ID,LNR,ARC_DOC_ID : 3. Edit the following parameters (which are passed on to the Web Dynpro application) as required: 66 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

&rowscount The integer that you assign to this parameter determines the number of rows that will be displayed per page of the iview. The maximum number of rows returned is 1000. &columnnames Type SAP field names (corresponding to ARCHIV_GET_CONNECTIONS_PRINTLI RFC) of your choice. Note: 4. Click Save. More information on how the values you assign here determine the format of the search resultset table is in Format of query results table, page 32. Working with the Documentum Event Sender iview Overview The Documentum Event Sender iview lets you send events without using SAP business packages iviews. Typically, you would use the Documentrum Event Sender iview to send events, which are, in turn, captured by the Search Documentum and Link Documentum iviews; administrators can use the Documentum Event Sender iviews for test and verification purposes. EMC Documentum ships 2 sample pages with IVRC; both these pages contain the Documentum Event Sender iview in tandem with a Search Documentum and a Link Documentum iview respectively. This section contains the following topics: Documentum Event Sender iview s interface, page 67 Sample values, page 69 Documentum Event Sender iview s interface The Documentum Event Sender iview appears as follows: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 67

Figure 8. Documentum Event Sender iview s interface The Documentum Event Sender iview contains the following elements: Object ID Key Name Specify the name of the object key. If the key consists of more than one part then separate it with the ampersand (&) symbol. The format for the key need not be specified here. For example, instead of specifying type@number/l025@part/l03@version/l02, just specify type&number&part&version. Object ID Specify the key/value pairs in this box. For example, objid=p 101. Note: For events that have multiple part keys (for example, urn:com.sap.bor:draw events), specify the values of all the parts of the key. Event URN Specify the event s Universal Resource Name (URN) without the event type. For example, urn:com.sap.bor:draw. Ensure that the Documentum Event Controller is listening to this event URN. Note: For events that have multiple part keys (for example, urn:com.sap.bor:draw events), specify all the parts of the key, and separate the parts with the ampersand (&) symbol. Event Name Specify the event type, such as select, refresh, and so on. Ensure that the Documentum Event Controller is listening to this event URN. The default values available in the Documentum Event Sender iview relate to the EQUI event in SAP. Note: To populate the text boxes in the iview, either type the required values in the text box or select a value from the corresponding drop down list. When you select a value from a drop down list, the corresponding text box on the right hand side gets populated with the selected value. If you have typed a value in a text box, then that value takes precedence over the value selected from the corresponding drop down list. If no value has been specified in a text box, then IVRC uses the selected value from the 68 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

corresponding drop down list. Depending on your needs, you may use the text boxes for some parameters and drop down lists for some other parameters. Sample values Sample values to simulate events sent by the FI application are as follows: Parameter Object ID Key Name Object ID Event URN Event Name Value BUKRS&BELNR&GJAHR BUKRS=2000&BELNR=10000&GJAHR=2000 urn:com.documentum.pct.ei. epiviews:fi_browser select Working with query templates using DA or Webtop Overview The IVRC iviews offer a choice of options, under which the related content is determined. The list of available options can be configured by adding or modifying query template objects as described in this section. Query template objects appear in the Select Query drop down list of the Link Documentum and Search Documentum iviews, and determine the columns and rows displayed in the tables. More information is in Introducing Link Documentum iview s interface, page 19 and Introducing Search Documentum iview s interface, page 23. IVRC supports two types of query templates: DQL query templates DQL query templates comprise two EMC Documentum repository objects of the following types: dm_query sap_action_link_doc_object This type is installed when installing the EI_Core_Docapp DocApp archive. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 69

Non DQL query templates Non DQL query templates comprise the following EMC Documentum repository object type: sap_action_link_doc_object. This type is installed when installing the EI_Core_Docapp DocApp archive. Use query templates to create soft links between an SAP object and a query templates (DQL queries); soft links create relationships between an SAP object and the resultset of a linked DQL query. Creating a soft link essentially involves the following steps: 1. Identifying the attributes of EMC Documentum objects that need to be mapped to an SAP object ID. 2. Creating a DQL query that references the EMC Documentum object s attributes that were identified in the previous step. More information on creating DQL queries is in Creating DQL based query templates, page 71. 3. Creating a link type whose sap_object_type attribute is set to DQL. More information on creating link types is in Creating an sap_action_link_doc_object object, page 72. 4. Referencing the DQL query (created in step 2) in the link type created in step 3. More information on referencing DQL queries in link types is in Creating an sap_action_link_doc_object object, page 72. 5. Ensuring that the EMC Documentum attributes (identified in step 1) of documents that you would like to link to a DQL query (created in step 2) are populated in the following ways: When content authors check in content to a repository When executing automation utilities such as Replicate SAP jobs (a feature in the Content Services for SAP software) For example, if the DQL query is looking for documents containing the keyword Electric Pump 001, ensure that the keyword attribute of the document that you want to link to is populated with Electric Pump 001. This section contains the following topics: Creating query templates, page 71 Editing query templates, page 79 Deleting query templates, page 80 70 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Creating query templates This section contains the following topics: Creating DQL based query templates, page 71 Creating DIR based query templates, page 74 Creating ArchiveLink based query templates, page 76 Creating DQL based query templates Overview Creating a DQL based query template in Documentum Administrator (DA) involves the following tasks: Creating a dm_query object, page 71 Creating an sap_action_link_doc_object object, page 72 Creating a dm_query object To create a new dm_query object: 1. On a local system, create a text file (.txt file) containing a valid Documentum Query Language (DQL) SELECT query. The attribute list of the SELECT query is used to specify document attributes that are displayed in the search results. The SELECT query accepts up to three parameters. Parameter placeholders and substituted values are listed in the following table Parameter Placeholder %KEY %NAME %TYPE Substituted Value (Attribute of SAP document or object) Object Key or Document ID Name of the document or object Object type (For example, EQUI ) 2. In DA or Webtop, browse to Cabinets > System > Doclink > EP > LinkType. 3. Do one of the following: In the Classic view, choose File > Import. In the Streamline view, click Import. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 71

The Import: File Selection: <folder name> page appears. 4. Click Add Files. 5. In the Select Files dialog box, browse to the text file containing the DQL SELECT query. Click OK. 6. Click Next. 7. In the Name field, type a name of your choice. 8. From the Type drop down list, select Query (dm_query). 9. Click Finish. Creating an sap_action_link_doc_object object To create a new sap_action_link_doc_object object: 1. In DA or Webtop, browse to Cabinets > System > Doclink > EP > LinkType. 2. Do one of the following: In the Classic view, choose File > New > Document. In the Streamline view, click New Document. The New Document: Create page appears. 3. In the Name field, type a name of your choice. 4. From the Type drop down list, select SysObject (sap_action_link_doc_object). 5. Click Next. 6. Select the Show all properties checkbox. 7. Configure the attributes for this object as described in the following table: Note: Although this page contains many attributes, you do not need to configure attributes that are not described table 7. Table 6. Fields in the sap_action_link_doc_object object s Properties page Field sap_object_type Description Possible values are as follows: DQL Note: The query will be executed when the user searches the repository for related documents. 72 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Field dql_query_type ep_application_ context query Columns returned by the query format_binding version_binding Description Possible values are as follows: search Designates the DQL query as a Search Documentum query. browse Designates the DQL query as a Link Documentum query. The ep_application_context attribute is used to determine which link types will be shown in a given IVRC iview. If the value of the ep_application_context attribute of a link type is identical to value of the ep_application_context attribute of an IVRC iview, then the link type will be displayed in that IVRC iview. The default values are portal_iview and Equipment_Browser. This means link types whose ep_application_context attribute contains default values will be displayed in the iviews whose ep_application_context attribute is set to either portal_iview or Equipment_Browser. Name of the dm_query object created previously. More information is in Creating a dm_query object, page 71) Determines the column configuration of the query results table. IVRC allows you to add the following additional column to the query result; this column gives more information about the documents returned by the query: IS_FOLDER$ Indicates whether the current object is a folder or a document. A folder can be either a folder, cabinet, or any subtype of folder. In the query results table, this attribute is represented in the column header as Folder?. Format of the document (for example, PDF, native format, HTML, best format) that is released to SAP. Not a required field. Version of the document that is released to SAP. You may specify a particular version label, such as ISSUED, or use a keyword like dms_selected_version or dms_all_versions. Not a required field. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 73

8. Click Finish. Creating DIR based query templates To create a DIR based query template: 1. In DA or Webtop, browse to Cabinets > System > Doclink > EP > LinkType. 2. Do one of the following: In the Classic view, choose File > New > Document. In the Streamline view, click New Document. The New Document: Create page appears. 3. In the Name field, type a name of your choice. 4. From the Type drop down list, select SysObject (sap_action_link_doc_object). 5. Click Next. 6. Select the Show all properties checkbox. 7. Configure the attributes for this object as described in the table 7: Note: Although this page contains many attributes, you do not need to configure attributes that are not described table 7. Table 7. Fields in the sap_action_link_doc_object object s Properties page Field sap_object_ type Description Possible values are as follows: DIR DIR_ONLY Note: The FROM clause is ignored when the user searches the repository for related documents; this is because the DIR and DIR_ONLY object types are related to SAP objects. The attribute names listed in the SELECT clause are still used to determine the columns shown in the query results table. The DIR object type indicates that a link type is related to DIRs that are linked to SAP business objects The DIR_ONLY object type indicates that a link type is related to DIRs that are not linked to SAP business objects. 74 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Field attribute_map Description Describes how EMC Documentum object attributes are mapped to SAP R/3 DIR object attributes. When you create links using the Link Documentum iview, this attribute mapping is used to set appropriate properties of the DIR. Note: Each value must follow the C printf syntax. For example: dql_query_ type ep_application_context Columns returned by the query DOCUMENTNUMBER = <Some Text> %s %s,r_object_id,i_ chronicle_id Possible values are as follows: search Designates the DQL query as a Search Documentum query. browse Designates the DQL query as a Link Documentum query. The ep_application_context attribute is used to determine which link types will be shown in a given IVRC iview. If the value of the ep_application_context attribute of a link type is identical to value of the ep_application_context attribute of an IVRC iview, then the link type will be displayed in that IVRC iview. The default values are portal_iview and Equipment_Browser. This means link types whose ep_application_context attribute contains default values will be displayed in the iviews whose ep_application_context attribute is set to either portal_iview or Equipment_Browser. Determines the column configuration of the query results table. Each column of the query results table corresponds to the values entered in this field. For example, object_name, r_modify_date, r_object_type, and so on. IVRC allows you to add two additional columns to the query result that give more information about the documents returned by the query; the relevant custom attributes are: IS_LINKED$ Indicates whether the current object is linked or not. In the query results table, this attribute is represented in the column header as Linked?. If an object is showing as linked, it does not necessarily mean that it has been linked to a selected SAP business object; it merely indicates that the current object is linked to some SAP object. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 75

Field format_binding version_ binding Description IS_FOLDER$ Indicates whether the current object is a folder or a document. A folder can be either a folder, cabinet, or any subtype of folder. In the query results table, this attribute is represented in the column header as Folder?. Format of the document (for example, PDF, native format, HTML, best format) that is released to SAP. Not a required field. Version of the document that is released to SAP. You may specify a particular version label, such as ISSUED, or use a keyword like dms_selected_version or dms_all_versions. Not a required field. 8. Click Finish. Creating ArchiveLink based query templates In IVRC, you can create ArchiveLink based links between EMC Documentum documents and SAP documents. These links will be compatible with the links created using the ArchiveLink interface in SAP GUI. To create an ArchiveLink based query template: 1. In DA or Webtop, browse to Cabinets > System > Doclink > EP > LinkType. 2. Do one of the following: In the Classic view, choose File > New > Document. In the Streamline view, click New Document. The New Document: Create page appears. 3. In the Name field, type a name of your choice. 4. From the Type drop down list, select SysObject (sap_action_link_doc_object). 5. Click Next. 6. Select the Show all properties checkbox. 7. Configure the attributes for this object as described in the following table: 76 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Note: Although this page contains many attributes, you do not need to configure attributes that are not described table 7. Table 8. Fields in the sap_action_link_doc_object object s Properties page Field sap_object_type attribute_map Description Possible values are as follows: INCOMING AL PRINTLIST Note: If the object type is INCOMING, then the query is configured for incoming documents in SAP. If the object type is AL, then when you create a link using the Link Documentum iview, an ArchiveLink based link is created. If the object type is PRINTLIST, then the query searches for all archived PrintLists in an EMC Documentum repository. Contains configuration values that are needed to create ArchiveLink based links. If the value in the sap_object_type field is INCOMING, then set the following key/value pairs in the attribute map: key.doc_type = "<SAP business object type>" For example: EQUI, MARA, and so on. key.archiv_id = "<Name of archiving repository>" For example: user defined archiving repositories such as DCTM_Repository_1. key.ar_object = "<SAP document type> For example: incoming invoices. If the value in the sap_object_type field is AL, then set the following key/value pairs in the attribute map: key.archiv_id = "<Name of archiving repository>" key.ar_object = "<SAP document type> Note: The key/value pairs that you specify in this field must be valid and should have been pre configured in SAP R/3; otherwise, IVRC will return errors. More information on this configuration is in the Content Services for SAP documentation set. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 77

Field dql_query_type ep_application_ context Columns returned by the query Description This field is not applicable if the value in the sap_object_type is PRINTLIST. Possible values are as follows: search Designates the query as a Search Documentum query. browse Designates the query as a Link Documentum query. Note: If the query template is related to searching for archived PrintLists, then the only acceptable value in this field is search. The ep_application_context attribute is used to determine which link types will be shown in a given IVRC iview. If the value of the ep_application_context attribute of a link type is identical to value of the ep_application_context attribute of an IVRC iview, then the link type will be displayed in that IVRC iview. The default values are portal_iview and Equipment_Browser. This means that link types whose ep_application_context attribute contains default values will be displayed in the iviews whose ep_application_context attribute is set to either portal_iview or Equipment_Browser. Determines the column configuration of the query results table. Each column of the query results table corresponds to the values entered in this field. For example, object_name, r_modify_date, r_object_type, and so on. IVRC allows you to add two additional columns to the query result that give more information about the documents returned by the query; the relevant custom attributes are: IS_LINKED$ Indicates whether the current object is linked or not. In the query results table, this attribute is represented in the column header as Linked?. If an object is showing as linked, it does not necessarily mean that it has been linked to a selected SAP business object; it merely indicates that the current object is linked to some SAP object. IS_FOLDER$ Indicates whether the current object is a folder or a document. A folder can be either a folder, cabinet, or any subtype of folder. In the query results table, this attribute is represented in the column header as Folder?. 78 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Field format_binding version_binding Description Format of the document (for example, PDF, native format, HTML, best format) that is released to SAP. Not a required field. Version of the document that is released to SAP. You may specify a particular version label, such as ISSUED, or use a keyword like dms_selected_version or dms_all_versions. Not a required field. 8. Click Finish. Editing query templates Overview This section contains the following topics: Editing dm_query objects, page 79 Editing sap_action_link_doc_object objects, page 80 Editing dm_query objects To edit dm_query objects: 1. In the banner at the top of the DA or Webtop page, click Advanced. The Advanced Search page opens displaying the General tab 2. From the Object Type drop down list, choose Query (dm_query). 3. In the Properties field, frame the query as follows: Name contains <name of dm_query object> 4. Click Search. 5. In the search results, click the Edit link of the required dm_query object. 6. Edit the query as required and save the file. 7. Check in the object. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 79

Editing sap_action_link_doc_object objects To edit sap_action_link_doc_object objects: 1. In the banner at the top of the DA or Webtop page, click Advanced. The Advanced Search page opens displaying the General tab 2. From the Object Type drop down list, choose Sysobject (sap_action_link_doc_ object). 3. In the Properties field, frame the query as follows: Name contains <name of sap_action_link_doc_object object> 4. Click Search. 5. In the search results, click the Info icon of the required sap_action_link_doc_ object object. 6. Edit the attributes as required. 7. To save the changes, click OK. Deleting query templates To delete query templates: 1. In DA or Webtop, browse to Cabinets > System > Doclink > EP > LinkType. 2. Do one of the following: In the Classic view: from the Show Files and Folders list box, choose Show All Objects. In the Streamline view: from the Show Files list box in the Files section, choose Show All Objects. All the dm_query and sap_action_link_doc_object objects created previously. More information is in Creating DQL based query templates, page 71) are displayed. 3. Do one of the following: Delete DQL based query templates: Delete the required dm_query object. Delete the associated sap_action_link_doc_object object. Delete the ArchiveLink based query templates Delete the required sap_action_link_doc_object object. 80 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Connecting to multiple EMC Documentum repositories IVRC does not support connecting to multiple repositories using the same SAP Portal page. However, you can connect to different repositories using the same instance of SAP Portal: this is achieved by using separate pages for each repository. The following example illustrates how this can be achieved. Example 3 1. Connecting to two EMC Documentum repositories by using the same instance of SAP Portal 1. Using SAP Portal, connect to the SAP NetWeaver server on which you have deployed IVRC. Note: You must log in to SAP NetWeaver with the content administrator role. 2. Browse to Content Administration > Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > iviews > IVRC iviews. The contents of the IVRC iviews folder appear. 3. In the IVRC iviews folder, make two copies of Documentum Event Controller. and name them as follows: Documentum_Event_Controller_1 Documentum_Event_Controller_2 4. Click the Portal Content folder. The various folders and objects under Portal Content appear. 5. Right click the folder for which you want to configure a page and select New > Page. The Portal Archive Selection iview of the Page Wizard appears. 6. Select the Default Page Template radio button. 7. Click Next. The General Properties iview appears. 8. Type values for the following fields: Name Type a unique name for the page; in this example, type Page 1. Page ID 9. Click Next. Type a unique ID for the page. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 81

The Select Page Layouts iview appears. 10. In the Available Layouts scroll down box, select the layout of your choice and click Add. 11. Click Next. The Summary iview appears. 12. Review the page details and click Finish. The Choose your next step iview appears. 13. Select the the object for editing radio button and click OK. The Property Editor <name of page> iview appears. 14. Click the Page Content radio button. 15. Keeping the Property Editor <name of page> iview open, in the navigation panel, browse to Portal Content > Content Provided by Other Vendors > Content For Specialists > Documentum:IVRC > iviews > IVRC iviews. The contents of the IVRC iviews folder appear. 16. Right click Documentum_Event_Controller_1 and choose Add iview to Page > Delta Link. The Documentum_Event_Controller_1 iview is added to the page. 17. Click Save. 18. In the first column of the table, select the checkbox for the Documentum_Event_ Controller_1 iview. 19. Click Properties. The Property Editor Documentum_Event_Controller_1 iview appears in the right side of the content area. 20. From the Property Category drop down list, choose Show All. 21. In the com.documentum.ei.epiviews.dctm_ system_alias field, type <repository alias 1> (the name of the EMC Documentum repository system alias that you would like to connect to). 22. Click Save. 23. Repeat steps 4 through 22, with the following exceptions: In step 8, type the value of the Name field as Page 2. In step 16, add the Documentum_Event_Controller_2 iview to the Page 2 page. In step 21, type <repository alias 2> (the name of another distinct EMC Documentum repository system alias that you would like to connect to). 82 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

24. In both Page 1 and Page 2, configure either a Search Documentum or a Link Documentum iview. More information is in Configuring the Search Documentum iview, page 64 and Configuring the Link Documentum iview, page 65. Page 1 can now connect to the repository configured in the <repository alias 1> system alias; Page 2 can connect to the repository configured in the <repository alias 2> system alias. Using IVRC to work with DCM controlled documents Overview Documentum Compliance Manager (DCM) allows you to manage large volumes of documents that must comply with regulatory and quality standards. DCM defines document properties, access permissions, and change management processes for each document type during each stage of its lifecycle from initial draft to publication through retirement. If you need to access DCM controlled documents using IVRC, perform the configurations described in this section to ensure that: IVRC does not violate the document properties, access permissions, and change management processes set for documents by DCM. You can work with the documents in DCM from SAP Portal. In order to use IVRC to work with DCM controlled documents, you should: Implement BOF customization for IVRC. More information is in the Working with BOF customization section of EMC Documentum Content Services for SAP Portal iviews for Related Content Installation Guide. Configure IVRC to open DCM controlled documents in WDK based applications such as DCM. More information is in Modifying the IVRC configuration object, page 41. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 83

Configure IVRC to access DCM controlled documents from the context menu. More information on this task is in the Configuring IVRC to access DCM controlled documents from the context menu section of the EMC Documentum Content Services for SAP Portal Repository Manager Administration Guide. Note: Perform this task only if you have configured IVRC to use Content Services for SAP Portal Repository Manager to view and edit content. More information is in Modifying the IVRC configuration object, page 41. Support for EMC Documentum PDF Annotation Services IVRC is compatible with EMC Documentum s PDF Annotation Services. This means that from the iviews, you will be able to annotate PDF documents using Webtop. PDF Annotation Services must be installed and configured for this purpose. Note: You will need at least relate permission to be able to use the annotation services. You need not checkout a document to be able to annotate. More information is in the PDF Annotation Services documentation. 84 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Chapter 4 Troubleshooting IVRC Overview This chapter discusses commonly encountered issues in iviews for Related Content and how you can resolve them. The topics covered in this chapter are as follows: Operation aborted when trying to log in to SAP Portal or refreshing page in SAP Portal, page 85 Unable to open pages for which Documentum Event Controller iview has been configured, page 86 FI and PrintList Browser iviews fail to load, page 87 Case sensitivity issues when using principal authentication, page 88 High levels of logging, page 89 Logging details appear in a pop up window, page 91 Documentum Event Controller iview shows connection errors, page 91 Unable to delete links between an EMC Documentum object and SAP R/3 object, page 92 Operation aborted when trying to log in to SAP Portal or refreshing page in SAP Portal Problem statement When you try to log in to SAP Portal or refresh a page in SAP Portal, the following error message appears: <Browser> cannot open Internet site <SAP Portal URL> Operation Aborted EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 85

Troubleshooting IVRC Possible causes The delay time, taken by Documentum Event Controller, before sending the first event to Web Dynpro is insufficient. Suggested resolution Increase the value of the com.documentum.pct.ei.epiviews.delay_event parameter of the Documentum Event Controller iview. More information is in Configuring the Documentum Event Controller iview, page 62). Experiment with the value by gradually increasing it; continue doing so until you do not get the error. Unable to open pages for which Documentum Event Controller iview has been configured Problem statement When you try to access a page for which the Documentum Event Controller iview has been configured, the following error message appears: Portal Runtime Error An exception occurred while processing a request for : iview : pcd:portal_content/com.documentum.documentum/com.documentum.ei.epiviews. epiviews/com.documentum.ei.events/com.documentum.pct.ei.epiviews. Documentum_Event_Controller Component Name : com.documentum.pct.ei.dmeventcontroller. DmEventController Possible causes The process size memory setting for the SAP J2EE server has been specified incorrectly. 86 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Troubleshooting IVRC Suggested resolution Specify the correct process size memory setting for the SAP J2EE server. More information is in SAP note 644209 available in the SAP Service Center (http://service.sap.com). FI and PrintList Browser iviews fail to load Case 1 Problem statement When you try to view FI and PrintList Browser iviews, the following error message is displayed: com.sap.tc.webdynpro.services.exceptions.wdtypenotfoundexception: type com.documentum.ei.epiviews.fibrowser.model.types. So_Text001 could not be loaded: com.sap.dictionary.runtime.ddexception: Possible causes The SLD and JCos for the FI and PrintList Browsers iviews have not been configured before using them. Suggested resolution Before you can use the FI and PrintList Browser iviews, configure the SLD and JCos. More information is in Configuring SLD for FI and PrintList browsers, page 50. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 87

Troubleshooting IVRC Case 2 Problem statement After configuring the SLD and JCos as indicated in Configuring SLD for FI and PrintList browsers, page 50, when you try accessing one of the sample FI Document Browser iviews, the iview fails to load and one of the following error message might be displayed: com.sap.mw.jco.jco$exception: (104) RFC_ERROR_SYSTEM_FAILURE: The function module "DD_LANGU_TO_ISOLA" not released for remote calls. com.sap.mw.jco.jco$exception: (104) RFC_ERROR_SYSTEM_FAILURE: The function module "DD_DOMA_GET" not released for remote calls. Possible causes This issue might be caused because, depending on the error message, one of the following function modules have not been remote enabled: DD_LANGU_TO_ISOLA DD_DOMA_GET Suggested resolution Depending on the error message, resolve these issue by remote enabling one of the following function modules in SAP R/3: DD_LANGU_TO_ISOLA DD_DOMA_GET Case sensitivity issues when using principal authentication Problem statement When using principal authentication, sometimes, authentication against configured EMC Documentum repositories fails. 88 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Troubleshooting IVRC Possible causes In some installations, SAP Portal changes the username to upper case. So, if principal authentication is used and if the EMC Documentum repository s username is in lower case, then the authentication against the repository fails. Suggested resolution Set the user_auth_case parameter in your server.ini file to define the case of usernames in configured EMC Documentum repositories. This parameter converts the User ID string to either lower or upper case and validates against the repository. The default value is NONE; due to this setting, EMC Documentum validates the SAP Portal username against the configured repository verbatim. High levels of logging Problem statement In the system where SAP NetWeaver is installed, you may encounter high levels of logging. Possible causes The logging parameter for iviews for Related Content has been set to DEBUG. More information is in the log4j_ivrc.properties section of the EMC Documentum Content Services for SAP Portal iviews for Related Content Installation Guide. By default, this parameter is set as WARN. If you had set the logging parameter as DEBUG, iviews for Related Content logs each and every request; in a production environment, this can translate into extremely high logging levels. This causes the following problems: Because iviews for Related Content writes each and every request to a log, in a production environment, this take up enormous storage space. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 89

Troubleshooting IVRC High levels of logging penalize the performance of the host in a production environment. When the logging level is set to DEBUG, iviews for Related Content writes certain parameters of each request to memory. With each request, the amount of memory used by iviews for Related Content increases incrementally. This leads to a performance penalty. Suggested resolution To change the logging level: 1. Open the log4j_ivrc.properties file. This file is available in the following location: In Windows: <DFC installation directory>\config In UNIX: <DFC installation directory>/config 2. Locate the following parameters: log4j.logger.com.documentum.ptc.ei.epiviews=<logging level> log4j.logger.com.documentum.ptc.ei.epiviews.dmeventcontroller= <logging level> log4j.logger.com.documentum.ei.repository=<logging level> Note: By default, the logging level is set as WARN. The log4j.logger.com.documentum.pct.ei.epiviews parameter determines the logging level for the Search Documentum and Link Documentum iviews. The log4j.logger.com.documentum.pct.ei.epiviews.dmeventcontroller parameter determines the logging level for Documentum Event Controller. The log4j.logger.com.documentum.ei.repository parameter determines the logging level for EMC Documentum repositories. 3. Depending on what level of logging you want, change the value of the specific logging parameters to INFO, WARN, or DEBUG. 4. Save the file. Note: Setting the logging level as DEBUG is only necessary when you need to troubleshoot any issues with iviews for Related Content. In a production environment, the DEBUG logging parameter for iviews for Related Content should be commented to turn it off. 90 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Troubleshooting IVRC You need not restart SAP Web AS for the updates to take effect. Updates are usually reflected in a couple of minutes. Logging details appear in a pop up window Problem statement When working with the IVRC GUI, logging detailed related to Documentum Event Controller appear in a pop up window. Possible causes The logging level for Documentum Event Controller has been set to DEBUG. Suggested resolution Locate the following parameter in the log4j_ivrc.properties file. More information is in the log4j_ivrc.properties section of the EMC Documentum Content Services for SAP Portal iviews for Related Content Installation Guide. log4j.logger.com.documentum.pct.ei.epiviews.dmeventcontroller=debug Depending on your requirements, change the value of the parameter to WARN or INFO. Save the file. Documentum Event Controller iview shows connection errors Problem statement After modifying EMC Documentum repository related system landscape objects, the Documentum Event Controller iview displays the following error message: EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 91

Troubleshooting IVRC Documentum Event Controller Error: Error while reading system landscape objects. Please check IVRC log for details. The IVRC log file contains the following error message: [DM_SESSION_E_AUTH_FAIL]error: "Authentication failed for user <user name> with docbase <repository>. Possible causes After modifying an EMC Documentum repository related system landscape object, you have not re entered the password in the Docbase superuser password field. When saving an edited system landscape object, SAP Portal seems to reset password values to the default value, if it is not re entered by the user. However, SAP Portal does not prompt the user to re enter the password, while saving the edited system landscape object. Suggested resolution Re enter the password in the Docbase superuser password field every time you edit a system landscape object. More information is in r to Configuring system landscapes, page 45). Unable to delete links between an EMC Documentum object and SAP R/3 object Problem statement When deleting a DIR link between an EMC Documentum object and SAP R/3 object, the following error message appears: com.documentum.pct.ei.epiviews.exceptions.epiviewexception: com.documentum.ei.repository.exception.remotesystemexception: BAPI error : Status does not allow you to change certain data 92 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Troubleshooting IVRC Possible causes This error is caused when the DIR has been deleted using a non IVRC user interface. Suggested resolution Do not delete DIRs by using non IVRC user interfaces. To delete a DIR link in IVRC: Remove the Deleted indicator, associated with the DIR object, in SAP R/3. Delete the link using the IVRC interface. EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 93

Troubleshooting IVRC 94 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide

Index C configuring iviews for Related Content, postinstallation, 35 Content Services for SAP Portal iviews for Related Content, 9 I installation troubleshooting issues, 85 intended audience, 9 iviews for Related Content, 9 prerequisites system administrator, 9 Purpose of the Guide, 9 S system administrator prerequisites, 9 T troubleshooting installation issues, 85 P postinstallation configuration, 35 EMC Documentum Content Services for SAP iviews for Related Content Version 6.0 Administration Guide 95