OpenText Extended ECM For SAP Solutions CE 21.4 - Installation and Upgrade Guide English (ERLK210400-IGD-En-03)
OpenText Extended ECM For SAP Solutions CE 21.4 - Installation and Upgrade Guide English (ERLK210400-IGD-En-03)
OpenText Extended ECM For SAP Solutions CE 21.4 - Installation and Upgrade Guide English (ERLK210400-IGD-En-03)
Solutions
ERLK210400-IGD-EN-03
OpenText™ Extended ECM for SAP® Solutions
Installation and Upgrade Guide
ERLK210400-IGD-EN-03
Rev.: 2021-Dec-13
This documentation has been created for OpenText™ Extended ECM for SAP® Solutions CE 21.4.
It is also valid for subsequent software releases unless OpenText has made newer documentation available with the product,
on an OpenText website, or by any other means.
Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Support: https://support.opentext.com
For more information, visit https://www.opentext.com
One or more patents may cover this product. For more information, please visit https://www.opentext.com/patents.
Disclaimer
Every effort has been made to ensure the accuracy of the features and techniques presented in this publication. However,
Open Text Corporation and its affiliates accept no responsibility and offer no warranty whether expressed or implied, for the
accuracy of this publication.
Table of Contents
1 What is OpenText Extended ECM for SAP Solutions .......... 11
1.1 Related documentation .................................................................... 11
23.21.1 Installing and upgrading the Business Workspaces Outlook add-in ... 203
23.21.1.1 Preparing to install or upgrade the Business Workspaces Outlook
add-in ........................................................................................... 204
23.21.1.2 Downloading the latest Outlook add-in manifest file ......................... 204
23.21.1.3 Migrating custom settings to the new Outlook add-in manifest file ..... 205
23.21.1.4 Uploading the Outlook add-in manifest file ...................................... 205
23.21.2 Preparing your environment ........................................................... 206
23.21.2.1 Creating Content Server folders for the add-in ................................. 206
23.21.2.2 Creating search forms for the add-in ............................................... 207
23.21.3 Configuring add-in settings ............................................................ 209
23.21.3.1 Examples: Configuring email saving options ................................... 211
23.21.4 Configuring rules and email search settings to display suggested
workspaces .................................................................................. 214
23.21.4.1 Understanding how rules and email search settings are applied ....... 214
23.21.4.2 Understanding how rules are applied to emails sent from Extended
ECM mobile clients ....................................................................... 216
23.21.4.3 Testing your rules and email search settings ................................... 217
23.21.4.4 Configuring Rules and Email Search Settings ................................. 217
23.21.4.5 Testing Rules and Email Search Settings ....................................... 221
23.21.4.6 Examples: Workspace rules ........................................................... 221
23.21.4.7 Allowing email fields to be extracted for indexing ............................. 223
23.21.5 Configuring your environment for SSO authentication ...................... 223
23.21.5.1 Configuring security settings for SSO authentication ........................ 224
23.21.6 Adding URLs to the list of trusted sites in Internet Explorer .............. 224
23.22 For SAP CRM and SRM: Configuring security settings .................... 225
23.23 Repairing a group replacement migration ........................................ 225
23.24 Considering virus-scanning ............................................................ 225
Business A business workspace in Content Server contains content that is relevant for a business
workspaces, object. From Content Server side, users can easily view the data of this business
cases and
binders
object. From the business application, users can access Content Server items in the
business workspace without leaving their system. To make full use of the Content
Server functionality, not only business workspaces but also cases and binders can be
configured for Extended ECM for SAP Solutions.
Business In addition to the content that is stored in a business workspace for a business object,
attachments users can connect additional documents as business attachments to a business object.
Business rela- Extended ECM for SAP Solutions provides tools to illustrate a relationship between
tionships business workspaces. For example, a hierarchical relationship between business
workspaces can be displayed in a sidebar widget of a business workspace.
OpenText Extended ECM for SAP Solutions - Installation and Upgrade Guide (ERLK-IGD)
The Installation Guide describes the installation and upgrade of Extended ECM
for SAP Solutions up to the point where the connection between SAP and
Content Server is established.
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD)
The Customizing Guide describes how to customize SAP and configure Content
Server for Extended ECM for SAP Solutions functionality.
OpenText Extended ECM for SAP Solutions - User Management and Access Control
Scenarios (ERLK-CUM)(this guide)
This guide discusses user management and access control scenarios.
OpenText Directory Services - Installation and Administration Guide (OTDS-IWC)
This guide describes the configuration of OpenText Directory Services.
OpenText Extended ECM for SAP Solutions - User Guide (ERLK-UGD)
The User Guide describes how to use Extended ECM for SAP Solutions
functionality in both SAP and Content Server. This guide is also available as
online help.
OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Microsoft SQL Server (ERLK-IWS)
This specific Installation Guide describes the setup of one architecture scenario
for Extended ECM for SAP Solutions with Microsoft SQL Server as database.
OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Oracle Database (ERLK-IWO)
This specific Installation Guide describes the setup of one architecture scenario
for Extended ECM for SAP Solutions with Oracle as database.
OpenText Extended ECM for SAP Solutions - Installation Guide for SAP HANA (ERLK-
IWH)
This specific Installation Guide describes the setup of one architecture scenario
for Extended ECM for SAP Solutions with SAP HANA as database.
OpenText System Center Manager - Installation and Configuration Guide (SYSCM-IGD)
OpenText™ System Center simplifies the installation, configuration, patching,
and updating of supported OpenText software applications.
OpenText Extended ECM for SAP Solutions eBook
The eBook describes the key concepts and capabilities of Extended ECM for SAP
Solutions.
The “OpenText Extended ECM for SAP Solutions eBook” is available on
OpenText My Support (https://knowledge.opentext.com/knowledge/llisapi.dll/
Open/18208703).
Content Server Champion Toolkit
A variety of documents deals with deployment scenarios of Content Server as
well as Best Practices examples.
The Content Server Champion Toolkit documents are available on OpenText My
Support (https://knowledge.opentext.com/knowledge/llisapi.dll/open/19905386).
Release Notes The Release Notes describe the following aspects in detail:
The Release Notes are continually updated. The latest versions of the Extended ECM
for SAP Solutions Release Notes is available on OpenText My Support: Extended
ECM for SAP Solutions (https://knowledge.opentext.com/knowledge/llisapi.dll/
Open/67811874).
This part describes the overall architecture of Extended ECM for SAP Solutions and
provides best practices regarding deployment options.
The following sections of this chapter describe the architecture of an Extended ECM
system by breaking down the system into multiple layers:
For an overview, see Figure 2-1. For detailed information, see “Components of
Extended ECM for SAP Solutions“ on page 291.
Presentation
Smart UI
integration Search form Mobile app
widget
Business logic
SAP SAP
Content Suite Extended SAP ECMLink
Document Document
Platform ECM platform package
Access Archiving
Network / communication
Directory Web service AppWorks
Services components Gateway
Persistence / storage
Database Archive Center
Most database tuning tips are documented thoroughly in the database optimization
paper of Content Server, which is also valid for Extended ECM in general. For more
information, see Best Practices SQL Server for OpenText Content Server (https://
knowledge.opentext.com/knowledge/cs.dll/Overview/61019094) or Best Practices
Oracle for OpenText Content Server (http://knowledge.opentext.com/knowledge/
cs.dll/Overview/64127492).
See also “Best practices for the network and communication layer“ on page 21.
An Extended ECM system differs from standard OpenText™ Content Suite Platform
in several characteristics. In general, during the initial phase of an Extended ECM
system, storing one document implies on average 1.7 times the amount of business
workspaces and 5.5 times the number of folders stored in the same system (see
Figure 3-1).
Noticing these differences can help you creating a sizing concept, index and search
configurations.
Metadata Further, business workspaces are linked with business objects from the business
application, which contributes metadata about the business object. The majority of
business properties are stored with the business workspace and not necessarily with
documents. Therefore, when calculating required search partitions, not only
consider the number of documents but also the amount of metadata. For more
information about search and index settings, see the Content Server Champion
Toolkit on My Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/
19905386).
From Extended ECM version 16 on, business administrators can enable the Smart UI
widgets in the SAP Business Content window. This changes the communication
flow between Extended ECM components to a certain extent.
Communication The communication channels can be grouped into two major categories: SOAP (web
channels service) communication or HTTP/HTTPS communication.
SOAP communication
HTTP/HTTPS communication
• Displaying the workspace folder structure in a tree view uses the Content Server
REST API.
• SAP Business Content window Drag & Drop operations use the Content Server
REST API.
• Search within the Business Content window through the Content Server Search
API.
• Document-related activities like editing, versioning, etc.
• With the three-tier system landscape, you make all changes to your system (to
include customizing) in a separate development system.
• Changes can then be imported into a quality assurance system where
stakeholders can thoroughly test them.
• Once you can confirm the changes are safe, they can be transported into the
production system.
• All Content Server installations in this three-tier system landscape are clearly
separated from each other, the communication flow between the leading
application system and the Content Server system is easy to understand and to
manage.
For considering a Content Server cluster deployment, see the “Content Server
Architecture Overview” on My Support (https://knowledge.opentext.com/
knowledge/cs.dll/Overview/RKA500025).
• The communication between the business application and Content Server relies
on web services. If you are planning bulk operation from the SAP system to
Content Server, you can setup a separate server, and use it only to interact with
web service requests. Alternatively, load balance the web service requests.
Consider using a non-sticky load balancer setup for consuming the requests from
SAP system.
Note: From version 20.2, Extended ECM for SAP Solutions fully supports
active-active clustering in a scenario without Enterprise Library Server.
SAP
ECMLink ArchiveLink
Load balancer
If you decide for this deployment option, ensure that the configuration entities, like
workspace types, business object types, categories, templates, and root locations, are
well structured. Since they will be created in a single Content Server system, you can
best distinguish them by adding the external systems ID to the name. For example, if
you are using the same Content Server for your SAP DEV and QA systems, you can
consider using the following naming schema:
The disadvantage of sharing Extended ECM is the blur edge of different SAP
systems. Also, in situations where SAP DEV and QA systems are sharing one
Extended ECM, you may lose the opportunity to test your customization transport
packages, which consequentially adds risk of transporting customizations into the
production system.
Also keep in mind that sharing a Content Server system with different SAP systems
may change the hardware demand of the underlying Content Server.
• By default, you cannot create business workspaces for the same business objects
in different Content Server installations. For example, with standard
configuration, you cannot create equipment workspaces from the SAP system
into different Content Server systems.
• Business relationships between business objects need to be carefully considered.
When the multiple SAP systems are not connected to each other, workspace
relationships might not be updated automatically by the SAP property provider.
A business user must maintain the business relationships manually in Content
Server.
This part covers the details of the Extended ECM for SAP Solutions installation and
the SAP Add-on.
OpenText also recommends that you read one of the following comprehensive
installation instructions for certain scenarios, which are available on OpenText My
Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/10194282):
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Microsoft SQL Server (ERLK-IWS)
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft Windows
with Oracle Database (ERLK-IWO)
• OpenText Extended ECM for SAP Solutions - Installation Guide for SAP HANA
(ERLK-IWH)
Deployment Extended ECM for SAP Solution is available for different deployment methods.
method Depending on your requirements you may chose one of the following:
• On premises and purchased from OpenText: Use the OpenText System Center
Manager. For more information, see “Installing with OpenText System Center
Manager” on page 29.
• On premises and purchased from SAP SE: Download an ISO image from the SAP
Store
• In a Kubernetes cluster on a cloud platform, such as Microsoft Azure, Amazon
Web Services, and Google Cloud Platform: Download Docker images. For more
information, see OpenText Content Suite Platform and Extended ECM - Cloud
Deployment Guide (SULCCD-IGD).
Extended ECM for SAP Solutions consists of a number of components and parts, all
of which are available for download from OpenText System Center. Depending on
your scenario, you may need not all of them. This chapter gives an overview, which
installable parts you may need for the most common scenarios. You will also find a
comprehensive list of all components with description.
Important
If you purchased your license from SAP SE directly, you may download the
ISO images from SAP Store.
OpenText System Center Manager helps you download the respective software. As a
direct customer of OpenText, you find OpenText System Center Manager on
OpenText My Support. Customers of SAP find it in SAP Store.
2. Install the OpenText System Center Manager for SAP on your computer or
server. Follow the install instructions.
You can install certain scenarios. For more information, see “Scenarios and their
components” on page 31 and “List of all components by scenario” on page 35.
After you installed OpenText System Center Manager for SAP, you can use the
predefined execution plan (extended_ecm_plan.pln) to install an all-in-one
scenario for OpenText Extended ECM for SAP Solutions including all basic software
and modules. The execution plan conducts the following installations in 19 steps:
Note: You can also create an execution plan on your own. If you do, take care
that the execution plan still has to follow the above mentioned order.
• OpenText Archive Center - IBM TSM SSAM Installation and Configuration Guide
(AR-IDR)
• OpenText Archive Center - Dell EMC Elastic Cloud Storage Installation and
Configuration Guide (AR-IECS)
• OpenText Archive Center - HDS HCP Installation and Configuration Guide (AR-
IHC)
Extended ECM for SAP Solutions - SAP Add-on Packages - OTEXRL <version>
Extended ECM for SAP Solutions - SAP Add-on Packages - OTEXRLC <version>
Extended ECM for SAP Solutions - SAP Add-on Packages - OTEXRLE <version>
Extended ECM for SAP Solutions - SAP Add-on Packages - OTEXRLF <version>
Extended ECM for SAP Solutions - SAP Add-on Packages - OTEXRLO <version>
Extended ECM for SAP Solutions - SAP Add-on Packages - OTEXRLS <version>
Extended ECM for SAP Solutions - SAP Add-on Packages - OTEXRLSA <version>
Vendor Invoice Management Foundation - SAP Add-on Packages - OTBCBAS <version>
Note: When you install Extended ECM Platform or Extended ECM for SAP
Solutions, OpenText System Center offers Extended ECM Web Services and
Extended ECM CMIS for download. Still, you have to deploy these
components manually.
General prerequisites
• System Center Manager for SAP needs to be configured with System Center
Agent.
• Java has to exist on the system or needs to be installed. To be able to install it
with the execution plan, upload the Java installer to System Center Manager for
SAP under Settings > External Vendor Files. It is then available for the execution
plan.
• Apache Tomcat has to exist on the system or needs to be installed. To be able to
install it with the execution plan, upload the Tomcat installer to System Center
Manager under Settings > External Vendor Files. It is then available for the
execution plan. For more information, see Section 1.3 “Setting up Tomcat” in
OpenText Archive Center - Installation Guide for Windows (Integrated Archive
Installer) (AR-IGW).
• OTDS product has to be downloaded from the Catalog tab in System Center
Manager.
• Since System Center Manager does not install OTDS on Windows, the agent
should have Windows Server OS as a base.
• Details on OTDS have to be defined. For example, it has to be defined whether to
use an internal or an external OTDS.
• Content Server product has to be downloaded from the Catalog tab in System
Center Manager.
• Details on the database on which Content Server will be deployed must be
defined.
In this part, the extended_ecm_plan.pln execution plan will install the relevant
OpenText Extended ECM modules on the specific agent. The following prerequisites
apply:
• OpenText Extended ECM Platform, OpenText Extended ECM for SAP Solutions,
and OpenText Activator for SAP Solutions products have to be downloaded
from the Catalog tab in System Center Manager.
• OpenText Content Server has to be installed and configured on the agent.
In the last step, the extended_ecm_plan.pln execution plan will install OpenText
Archive Center and related modules on the specific agent. The following
prerequisites apply:
As soon as these prerequisites are fulfilled, you can start the execution plan.
2. Import the downloaded plan into System Center. To do so, in System Center
navigate to the Plans tab, In Plans Overview page, click on the Import plan.
Then select the downloaded plan.
3. To open the plan, in the Plan Overview select extended_ecm_plan, and click
Edit. You can see the details of the execution plan with the separate steps of the
complete installation.
4. Optional: If Java and Apache Tomcat do not yet exist on the system yet, you can
define to install them in the first step Install Directory Services for Windows of
the plan. For this, open the Step. In the Apache Tomcat tab rsp. the Java tab in
Installation Type, select New Install.
6. If passwords are required, a dialog opens. Enter the necessary passwords and
click Yes.
7. After you started the execution plan, the Execution Plans view in the Activities
tab opens. Here, you can monitor the progress of the execution plan.
3. Run the Mastersetup.exe file located on the installation medium and accept
the license agreement.
Extended ECM for SAP Solutions supports the following SAP products:
• SAP S/4HANA
• SAP ERP 6.0
• SAP CRM 7.0
Basis package
The SAP Add-On OTEXBAS of Archiving and Document Access for SAP
Solutions must be installed on your SAP system. Check the Release Notes for
required versions and dependencies. This component is provided on the
Extended ECM for SAP Solutions installation medium. For more information
about the installation of Archiving and Document Access for SAP Solutions, see
OpenText Archiving and Document Access for SAP Solutions - Installation and
Upgrade Guide (ER-IGD).
Transport system
The SAP application transport system is installed, this means the jobs RDDPUTPP
and RDDIMPDP are set up in the correct clients and scheduled to run periodically
or event-triggered.
SAP notes
The following SAP notes must be applied:
Patch levels
• Patch level for SAP ERP 6.0 – The minimum requirement for software
components SAP_BASIS and SAP_ABA is release 700, patch level 16. This
patch level is required for enhanced functionality, for example, additional
icons in the GOS attachment list, based on the SAP enhancement technology.
• Patch level for SAP CRM 7.0 – The minimum requirement for software
components SAP_BASIS and SAP_ABA is release 701, patch level 03
BBPCRM release 700, patch level 02
WEBCUIF release 700, patch level 02.
Content Server integration widget is only supported for CRM 7.0 Ehp 1.
• Patch level for SAP SRM 7.0 – The minimum requirement for software
components SAP_BASIS and SAP_ABA is release 701, patch level 07; for
component SRM_SERVER, the minimum requirement is release 700, patch
level 08.
• Patch level for optional Fiori UI package – At runtime, the Fiori apps
require SAPUI5 1.52, which is based on User Interface Technology SAP_UI
release 750. At installation time, this package can be installed on SAP
frontend systems with User Interface Technology (SAP_UI release 740, patch
level 13 or later). The Fiori Add-On package of OpenText Archiving and
Document Access for SAP Solutions, OTEXBASF 2040_740 is required.
Though not required for installation, the Fiori app calls the OData services of
Extended ECM for SAP Solutions at runtime. For optimal accessibility, use
the highest SAPUI5 version with long-term maintenance. For more
information, see SAP Note 2564165.
For more information, see https://ui5.sap.com/versionoverview.html.
• Patch level for optional OData package – This package can be installed on
SAP backend systems either with Backend Event Provider (IW_BEP release
200, patch level 10) or with SAP Gateway Foundation (SAP_GWFND, at least
release 740, patch level 09). On systems with SAP_GWFND release 750, like
SAP S/4HANA, use SPAM/ level 0059 or later for installation. Though not
required for installation, the OData services of Extended ECM for SAP
Solutions call RFC functions of the basis add-on of Extended ECM for SAP
Solutions (OTEXRL) at runtime.
Note: The documentation and the Release Notes are updated regularly. Check
for the latest version on OpenText My Support (https://
knowledge.opentext.com/knowledge/llisapi.dll/open/16514655).
Important
See the Release Notes for a comprehensive and most current list of
prerequisites.
Do not install this module in combination with Extended ECM for SAP
Solutions.
ArchiveLink customizing
Customizing of the SAP system and Archive Center must be completed
according to Part II “SAP basis customizing” in OpenText Archiving and
Document Access for SAP Solutions - Scenario Guide (ER-CCS).
Host and port for the logical archive
Check that store and retrieval of ArchiveLink documents functions properly
with the server.
Important
If AL filter is in use, the logical archive (OAC0 transaction) must use the
host and port of the server, where the AL filter process is installed. Usually
this is the Content Server system. Link to OAC0 transaction.
With the newest Archive Center version, the logical archive (OAC0
transaction) must use the host and port of Archive Server.
For older versions, it must use the host and port of Enterprise Library
Services. In this case, restrict access to the Archive Server host and port
exclusively to Enterprise Library using a firewall configuration.
If you are using a firewall between SAP and Content Server, enable
communication for the following ports:
• 8080 (HTTP) or 8090 (HTTPS) on Apache HTTP Server™: used for the Web
service communication from SAP to Content Server
• 8000: used for the communication between Content Server and the SAP
Client.
• 80 (HTTP) or 443 (HTTP): only required for connection tests from SAP to
Content Server
On the installation medium, the PAT file is located in an SAPCAR file (extension
*.SAR), which can be extracted using the SAPCAR command line tool. The SAPCAR
file is located in a DATA folder below the package folder named as the package and
SAP release, for example: Archiving and Document Access for SAP Solutions\
SAP\INST_BAS_700\DATA\OTEXBAS_INST_2040_700.SAR
Note: The handling of the installation procedure within SAINT depends on the
SAP system. For details, see the SAP documentation.
For more information, see the AppWorks Gateway Release Notes on the AppWorks
Developer website (https://developer.opentext.com/webaccess/#url=%2Fawd
%2Fintro).
Version information is also included in the system reports of Content Server and the
configuration report in the SAP system.
• Content Server
On the Content Server menu, select Help > About Content Server. The
version is displayed, for example, Content Server 16.2. You also find detailed
information in the Content Server system report. For more information, see
Section 25.2 “Understanding the Content Server System Report” in OpenText
Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
• Web Services and other OpenText components
Go to Control Panel > Add/Remove Programs or Programs and Features. In the
list of programs, you see which version is installed.
• SAP System, Database information and OpenText Components
In the SAP IMG (transaction SPRO, OpenText Extended ECM for SAP Solutions
> Extended ECM > Configuration Report), run the Configuration Report to get
information about the SAP server. In this report, you find information like the
versions of OTEXBAS, OTEXERP, OTEXRL, OTEXRLC, OTEXRLS, OTEXBASO,
OTEXBASF, OTEXRLO, and OTEXRLF. For more information, see Section 25.1.3
“Understanding the Configuration Report” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).
• Support Package of installed SAP System
In the SAP GUI application, on the menu, select System > Status. Click
Component information to see the installed SAP components with release
number and highest support package. If you only want to know the version
This chapter describes the installation sequence for Extended ECM for SAP
Solutions.
Tip: The installation of a complete OpenText Extended ECM for SAP Solutions
environment is described in the following comprehensive installation
instructions:
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft
Windows with Microsoft SQL Server (ERLK-IWS)
• OpenText Extended ECM for SAP Solutions - Installation Guide for Microsoft
Windows with Oracle Database (ERLK-IWO)
Important
Always check for the most recent version of an installation guide on OpenText
My Support.
2. On the server, install OpenText Extended ECM for SAP Solutions using the
master setup. During installation, select the following:
a. Select the deployment scenario. For a typical all-in-one installation for one
instance of Content Server, select All-in-one Deployment (Archive Center,
Directory Services, Content Server, etc.).
For a two-server landscape, select Content Server Deployment on one
server and Extended Archive Center Deployment (Archive Center,
Directory Services, etc.) on the other server.
b. Windows only: In the Services section, keep the selections and select
Extended ECM Web Services in addition.
UNIX/Linux only: Deploy the WAR file for Extended ECM Web Services
(otsapxecm.war) in Apache Tomcat manually.
c. Install the ArchiveLink Filter into the Apache Tomcat instance, that you
used for Archive Center.
3. Install the required patches; see the respective installation guides. Also check
the installation medium for relevant patches.
a. Set up security.
b. Set up communication with OTDS.
c. Configure Records Management (declaration, doctypes, jobs).
d. Configure Extended ECM for SAP Solutions business functionality:
business workspaces, business attachments, business relations. For more
information, see OpenText Extended ECM for SAP Solutions - Customizing
Guide (ERLK-CGD).
New: The installation of Extended ECM for SAP Solutions Business Scenarios
on the SAP system is now supported.
This chapter describes how to install the following components of Extended ECM
for SAP Solutions on an SAP application server.
Extended ECM for SAP Solutions uses the SAP Add-On Installation Tool (SAINT)
for installation of the SAP part. SAINT uses single PAT files (extension *.PAT) which
integrate several transport files. These collections are also called packages.
On the installation medium, the PAT file is located in an SAPCAR file (extension
*.SAR), which can be extracted using the SAPCAR command line tool. The SAPCAR
file is located in a DATA folder below the package folder named as the package and
SAP release, for example: Archiving and Document Access for SAP Solutions/
SAP/INST_BAS_700/DATA/OTEXBAS_INST_2040_700.SAR
Note: The handling of the installation procedure within SAINT depends on the
SAP system. For more information, see the SAP documentation.
• OTEXRL: Mandatory main package for Extended ECM for SAP Solutions
• OTEXRLC: Extended ECM for SAP Solutions for SAP CRM Add-On
• OTEXRLS: Extended ECM for SAP Solutions for SAP SRM Add-On
• OTEXRLO: Extended ECM for SAP Solutions SAP OData Services Add-on
• OTEXRLF: Extended ECM for SAP Solutions SAP Fiori Apps Add-On
• OTEXRLE: Extended ECM for SAP Solutions for SAP ERP, S/4HANA
• OTEXRLSA: Extended ECM for SAP Solutions Business Scenarios
Prerequisites The component OTEXBAS of Archiving and Document Access for SAP Solutions must
be installed on your SAP system. If you want to integrate into SAP Fiori, also the
component OTEXBASF of Archiving and Document Access for SAP Solutions must be
installed on your SAP system. Check the Release Notes for required versions of
these components.
See also “SAP system requirements” on page 51 with general information on the
installation in an SAP environment.
1. Copy the respective SAPCAR files (*.SAR) located on the installation medium
in Extended ECM\SAP to the target SAP application server in the /usr/sap/
trans folder, which is the parent folder of the DIR_EPS_ROOT folder.
If you are performing a new installation, you need the installation packages and
their passwords.
Note: With Basis 7.00 or later, you can use the SAINT and SPAM
transactions to upload and extract the SAR files from the frontend system.
3. Import the package as described in the respective SAP documentation. You will
need the password for the package.
After the installation, activate a Business Configuration Set (BC set) for every client.
• /OTX/RM_ADMIN
• /OTX/RM_CS_SAP_USER
• /OTX/RM_USER
• /OTX/RM_IMPERSONATED_USER_ROLE
3. Select Roles with Non-Current Profiles, and in the Role field, enter /OTX/RM*.
After an upgrade, select Roles with Current Profiles for New Generation, and
in the Role field, enter /OTX/RM* to generate updated profiles.
4. Follow the steps to generate the profiles.
6. Start transaction PFCG and check the following roles one by one:
• /OTX/RM_ADMIN
• /OTX/RM_CS_SAP_USER
• /OTX/RM_USER
• /OTX/RM_IMPERSONATED_USER_ROLE
7. Ensure that the Authorizations tab has a green icon. If it is yellow, you must
regenerate the authorizations: Click Display Authorization Data, and then
click Generate.
The Add-On installation packages include the default language English. You must
use the optional language packages to install other languages. For more information
about available languages, see Extended ECM for SAP Solutions Release Notes. You
can find the language packages related to the SAP Add-Ons of Extended ECM for
SAP Solutions on OpenText My Support (https://knowledge.opentext.com/
knowledge/cs.dll/Open/8521552).
Notes
• Extract the SAPCAR file (.SAR extension) to the SMLT path folder of your
SAP system. Usually, the path is set to the EPS\in system folder. Use the
SAPCAR tool to extract the file.
• Starting with SAP_BASIS 7.00, you can import and extract the file
directly in transaction SMLT.
3. Use transaction SMLT to import your language package.
Important
Before starting to import language packages, OpenText recommends to
red the SAP help (http://help.sap.com/) about importing a language. In the
SAP help, navigate to the application help for the appropriate SAP release
and read the following chapters:
5. Optional Only for localization of Fiori apps – Starting with version 16.2, the Fiori
apps contained in the Fiori UI Add-on packages OTEXBASF and OTEXRLF
deliver i18n properties files, which are mapped to text tables on the SAP
system. Therefore, specific language packages for Add-On packages OTEXBASF
and OTEXRLF are available. The procedure of installation is the same as
described above.
The installation procedure closely resembles the procedure for any other Content
Server optional module.
3. Under Content Server and Modules, verify that the Extended ECM for SAP
Solutions and the Extended ECM Platform entries are selected.
As the Enforce selection dependencies checkbox is selected by default, all the
dependent modules will be selected as well.
4. Click Next.
If more than one Content Server instance is installed, select the one to which
you want to add the module.
5. Check your entries in the Summary pane, and the click Install.
6. Content Server modules are installed using the same steps. The setups of
Content Server modules are initiated from the installer, one after the other. If
more than one Content Server instance is installed, select the one to which you
want to add the module. After the installation of the module is finished, the
installation of the next module starts automatically.
The files are copied to the staging directory of the server instance of Content
Server that you specified.
Tip: If you want to install the module to several Content Server instances,
you can start the Mastersetup.exe program again selecting another
Content Server instance.
Important
The installation fails if you check all listed modules simultaneously for
installation.
This chapter describes how to install the Extended ECM for SAP Solutions
Enterprise Asset Management Business Scenario on the Content Server. The
configuration is provided in four transport packages:
– Basic setup
– Enterprise Asset Management setup
• OpenText Business Scenario Enterprise Asset Management – 01
The package contains:
– Categories
– Classifications
• OpenText Business Scenario Enterprise Asset Management – 02
The package contains:
– Workspace types
– Unique names
– Business workspace templates
– Business object types
– Enterprise structure (workspace folders)
– Custom columns
– Facets
– Webreports for folders
• OpenText Business Scenario Enterprise Asset Management – 03
Prerequisites Download the transport packages (zip files) from the support directory of the
Extended ECM for SAP Solutions module on OpenText My Support and execute the
steps mentioned below for the following transport packages:
6. Click on Choose File, select OpenText Business Scenario EAM Setup.zip that
you downloaded before. Then click Ok.
3. In the next screen, click on Browse Content Server and select the workbench
created before.
6. In the next screen, click Deploy and, in the confirmation popup, click Ok.
Note: After deploying, a dialogue shows the status of deployment. For all
objects, the status Ok should be displayed now.
Note: If you do not want to use the Enterprise Asset Management sample
application, create a business application for your planned external system.
Then enter its ID in the Sample App ID field and no sample app will be
created.
6. In the next screen, click Deploy and, in the confirmation popup, click Ok.
Note: After deploying, a dialogue shows the status of deployment. For all
objects, the status Ok should be displayed now.
To prepare deploying:
2. In the Columns section, select the checkbox Enable browse list column
customization and click Save changes.
3. To enable the WR trigger for folder and workspace types, navigate to Enterprise
> Content Server Administration > WebReports Administration > Manage WR
Triggers.
4. In the Node Types section, select the Folder and the Business Workspace
checkboxes, and click Add.
Note: Before you continue deploying, make sure that a business application is
configured to connect to the business objects deployed in the next step. For an
easy start, OpenText delivers the Enterprise Asset Management sample
application. As well, you can configure a new business application.
Note: You can also connect a business application like SAP. For more
information, see “Connecting SAP as the business application” on page 159.
To continue deploying:
Note: After deploying, a dialogue shows the status of deployment. For all
objects, the status Ok should be displayed now.
To prepare deploying:
To integrate perspectives:
3. Navigate to Content Server > Perspectives > Business Workspaces and select
OT Equipment(x). Click Save and then click Close.
4. Repeat the steps for the following perspectives of the Business Scenario
Enterprise Asset Management:
• OT Equipment Perspective
• OT Functional Location Perspective
• OT Maintenance Order Perspective
• OT Maintenance Order Operation Perspective
• OT Material Perspective
• OT Notification Perspective
• OT Task List Perspective
• OT Task List Operation Perspective
Note: After deploying, a dialogue shows the status of deployment. For all
objects, the status Ok should be displayed now.
This chapter describes how to install language packs on Content Server. The module
installation packages and module support packages include the default language,
which is English. Use the language packs to install other languages. For more
information about available languages, see the Release Notes.
If not stated otherwise, the language packs related to support packages are
cumulative. They include merged language texts of the main version and of
previous and current support packages.
The language packs are available on OpenText My Support at the following location:
OpenText My Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/
63201449)
Note: Depending on the delivery bundle, you may also have System Center
access to installation files for components that must not be installed on Content
Server, for example, language installations of Imaging clients and the SAP
language package. For more information, see the installation guides and
release notes for these components.
1. Download the language packs from OpenText My Support. You can also obtain
the language packs for support packages and other patches navigating through
the Patches area.
2. Extract the files for the relevant modules in the Content Server root installation
directory.
6. Click Continue.
Notes
• Make sure that Tomcat has enough initial memory pool. See Section 2.2.2
“Configuring Tomcat options” in OpenText Enterprise Library - Installation and
Upgrade Guide (EL-IGD) for memory pool size recommendations.
• The Tomcat service must be running during the installation.
• Use the default service name for Tomcat. Otherwise, the installer may be
unable to find the service.
• Restart Tomcat manually after the installation.
5. After deploying the services, change the directory of the log files.
Deploy the web service cws to the Tomcat installation on the server where you also
installed Archive Center.
2. UNIX/Linux systems only: After deploying the services, change the directory of
the log files.
2. Find the following elements and change the values according to your needs:
<context-param>
<param-name>LivelinkServer</param-name>
<param-value>cs.example.com</param-value>
</context-param>
<context-param>
<param-name>LivelinkServerPort</param-name>
<param-value>2099</param-value>
</context-param>
<context-param>
<param-name>LivelinkEncoding</param-name>
<param-value>UTF8</param-value>
</context-param>
Prerequisites Content Server and the Tomcat server in which you want to install OpenText
ArchiveLink Filter must be running.
Restrictions See the Content Server release notes for supported OpenJDK versions.
• Port: Port of the Apache Tomcat server that hosts the OpenText
ArchiveLink Filter webapp.
• Protocol: Select the protocol that you want the ArchiveLink Filter to use.
• Content Server URL: Enter the Content Server URL with protocol, port
and path to the cs.exe, for example https://mycontentserver.
example.com:9090/OTCS/cs.exe.
Tip: You can later change your settings in the properties file <TOMCAT_
HOME>/lib/alfilter_resources/application.properties.
3. Optional If you are running Content Server and the ArchiveLink Filter in the same
Tomcat instance, check if the following tags are present in the Server/
Service/Engine/Host section of the TOMCAT_HOME/conf/server.xml file.
<Context path="/OTCS" reloadable="true"/>
<Context path="/alfilter" reloadable="true"/>
AppWorks Gateway acts as a proxy server and allows the Content Server Mobile
app to communicate securely with Content Server. It is deployed in Apache®
Tomcat™.
Using the Content Server Mobile app, your users can access and share Content
Server content, manage documents and files, complete Workflow assignments that
are designed for Smart View, and view documents that users have marked for
offline viewing. Offline viewing allows a user to view and edit Content Server files
on their mobile device when the device is not connected to Content Server or
AppWorks Gateway.
Upgrade scenarios
There are different upgrade scenarios depending on the Content Server version from
which version you upgrade.
1. Upgrade the Content Server system. The new Content Server system will be
working with an SAP system that is not updated yet.
2. Upgrade the SAP system. “” on page 93 lists possible working combinations of
old and new versions of the Content Server module and the SAP Add-on.
Important
You can run Content Server on a higher version than the SAP system, but you
must first upgrade Content Server to 20.4 before you update the SAP ABAP
Add-On OTEXRL (and depending Add-Ons) to 20.4. This order is mandatory if
you use Records Management. If you do not use Records Management, still
OpenText recommends that you keep this order.
Table 16-1:
16.2.10 16.2
16.2.10 16.2 SP1 (16.2.4)
16.2.10 16.2 SP2 (16.2.10)
1. Upgrade your Extended ECM system to 20.2 or later, both SAP and Content
Server.
2. Upgrade Enterprise Library to 16.2.11
3. Migrate your documents from Enterprise Library to Extended ECM. For more
information, see “Migrating Enterprise Library records and other items”
on page 95.
4. In Content Server Administration, under Search Administration, select Open
the System Object Volume. Then delete all Enterprise Library Data Source folders.
Tip: After deleting the Enterprise Library Data Source folder(s) go back to
System Object Volume. Under Slices recheck that all Enterprise Library
slices are deleted too.
Important
Any slices related to the Enterprise Data Source in Content Server
Administration under Slices must not be deleted.
5. Uninstall the Enterprise Library module and web service, that is unless you are
using SAP ILM. If you are using SAP ILM, you must keep Enterprise Library.
OpenText recommends the following order for your migration process. However,
you can switch step 1. and 2., but the third conversion step must remain the last one.
Migration is done by scheduled processing tasks. You can schedule the tasks or run
them immediately. For more information about scheduled processing, see Section 8
“Using Scheduled processing” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
a. Create a scheduled processing job with the job type Migrate Enterprise
Library Records.
Leave Business Application and Business Object Type blank.
b. Review the settings for Records per Task and Records Fetch Size.
OpenText recommends that you leave the default values.
c. Run this job either scheduled or start it immediately.
a. Create a scheduled processing job with the job type Migrate Enterprise
Library Volume.
Leave Business Application and Business Object Type blank.
b. Edit the processing job and enter a volume name. You find the Enterprise
Library volumes in the Content Server Administration > Enterprise
Library Administration > Open the Enterprise Library Volumes.
c. Review the settings for Child Objects per Task and Child Objects per
Fetch. OpenText recommends that you leave the default values.
If the volume contains child folders with an extremely huge number of
objects, for example hundreds of thousands or millions, and especially
when it contains deeply nested folder hierarchies, OpenText recommends
that you use a low value for the Child Objects per Task. In extreme cases it
might be necessary to increase the database transaction log size.
d. Run this job either scheduled or start it immediately.
e. Check if the Enterprise Library volumes are empty.
a. Create a scheduled processing job with the job type Migrate Enterprise
Library Types.
Leave Business Application and Business Object Type blank.
b. Edit the processing job and enter the following:
• Type Names: Enter the name of the types. Separate multiple names
with a comma. Leave this field empty to select all types. You find the
Enterprise Library types in the Content Server Administration >
Enterprise Library Administration > Open the Enterprise Library
Type Volumes.
Important
If you have custom applications, you must keep all types for these
applications as long as you want to run the applications. You must
thoroughly check, which types are used with objects for the
custom application.
If you use backslash “\” or commas “,” in your type names, you must
escape them with a backslash resulting in “\\” and “\,”.
c. Review the settings for Types per Task and Types per Fetch. OpenText
recommends that you leave the default values.
d. Run this job either scheduled or start it immediately.
e. Check in the Content Server Administration if the Enterprise Library Type
volumes are empty and the Extended ECM System Record Type Categories
are filled.
When you perform an upgrade, you must upgrade the various components of
Extended ECM for SAP Solutions.
Note: Always use the latest patches for upgrade. Particularly, always install
the latest patch for Business Workspaces before you upgrade the database
schema.
To perform an upgrade:
1. Refer to the Release Notes of Extended ECM for SAP Solutions to determine
which versions of the different components are required. On System Center,
you have access to all supported components.
“” on page 93 lists possible working combinations of old and new versions of the
Content Server module and the SAP Add-on. For information about the necessary
steps see the checklists for the different upgrade paths.
The database schema is upgraded with the standard Content Server mechanism.
When an upgrade is necessary, you are prompted accordingly and can upgrade the
database.
Note: You can monitor the database schema upgrade in a separate log file. This
log file is created in the logs directory of Content Server during the upgrade:
ECMLinkDBSchemaUpgrade_<threadID>.log. It logs all SQL statements of the
upgrade.
Important
Make sure that you installed the latest patch of Business Workspaces before
you upgrade the database schema.
“” on page 93 lists possible working combinations of old and new versions of the
Content Server module and the SAP Add-on. For information about the necessary
steps see the checklists for the different upgrade paths.
The database schema is upgraded with the standard Content Server mechanism.
When an upgrade is necessary, you are prompted accordingly and can upgrade the
database.
Note: You can monitor the database schema upgrade in a separate log file. This
log file is created in the logs directory of Content Server during the upgrade:
ECMLinkDBSchemaUpgrade_<threadID>.log. It logs all SQL statements of the
upgrade.
Important
Make sure that you installed the latest patch of Business Workspaces before
you upgrade the database schema.
The Extended ECM for SAP Solutions Business Scenarios Add-on for SAP ERP
(component OTEXRLSA), release 2140_700 has import conditions which allow to
install it or keep it from SAP ERP 6.0 up to SAP S/4HANA 2120.
To have the full Business Scenarios functionality forSAP S/4HANA 1909 and later,
OTEXRLSA release 2140_754 must be installed instead.
If you upgrade an older SAP ERP release to SAP S/4HANA 1909 or later, and
previously installed OTEXRLSA 2140_700, you have to install OTEXRLSA 2140_754.
This part explains the tasks that you perform after the installation. You need system
administrators access to Content Server.
Content Server
The Content Server instance has been prepared for the connection: ports and
firewall are configured accordingly. Content Server uses the following default
ports:
443 – Content Server HTTPS default port
8442 – Tomcat HTTPS default port for Web services and OTDS
For more information about the connection settings in Content Server, see
“Importing root certificates for Secure Sockets Layer (SSL) connections”
on page 157 and “Connecting SAP as the business application” on page 159.
SAP
In your SAP system the HTTPS port must be open. Default port number in SAP
is 44300.
For more information about the connection settings in the SAP system, see
“Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP
SRM 7.0” on page 125.
1. In IMG, run the OpenText Archiving and Document Access for SAP Solutions
> DesktopLink and Archiving for SAP Solutions > ArchiveLink > Maintain
Content Repositories activity. Alternatively, you can run the OAC0 transaction.
The Content Repositories overview table is displayed.
Content Rep.
Two-character archive name, which may only contain capital letters and
numbers. When you use a two-character name, you have the highest degree
of compatibility for different archiving scenarios. For example, for KPro and
Data Archiving scenarios, you can use up to 30 characters. For pure
ArchiveLink scenarios, only two characters are allowed.
Description
Description of the archive, for example, indication of archive usage and the
Archive Center.
Document Area
For an ArchiveLink archive, enter ArchiveLink. For a KPro archive enter
the corresponding document area.
Storage type
HTTP Content Server
Protocol
Name of the protocol used for communication. For more information, see
Section 6.1.1.4 “Protocol” in OpenText Core Archive for SAP Solutions -
Scenario Guide (ER-CCL).
The OpenText protocols OT_* can be created manually as described in
OpenText Archiving and Document Access for SAP Solutions - Installation and
Upgrade Guide (ER-IGD). They are also available with transports that can be
downloaded from OpenText My Support (https://knowledge.opentext.com/
knowledge/cs.dll?func=ll&objId=15777379&objAction=browse).
Version no.
ArchiveLink interface or SAP Content Server HTTP Interface version 0045
is the minimum required version.
HTTP server
Name of the Server where AL filter is installed. Usually this is the host
where Content Server is installed. In addition, the port should be shown, for
example: monopoly:8080.
From SAP basis 6.20, the port no. is entered in a separate field.
Port Number
For HTTP connections, enter the port number 8080.
Port Number of ArchiveLink connection.
SSL Port Number
For HTTPS connections, enter the SSL port number 8090.
When using the secure transfer protocol SSL (Secure Socket Layer).
Program (CRM: HTTP Script)
Enter alfilter/archive.
Basic Path, Archive Path
Path to the exchange directories. For HTTP communication, the Archive
Center does not require access to this directory.
The SAP system server stores the documents to be archived on the basic
path. The Archive Center makes the documents requested by the SAP
system available on the archive path. For data archiving, the exchange
directory must be entered identically in the FILE or SARA transaction with
particular attention to upper/lower case. For more information, see Section
6.3 “Creating an exchange directory” in OpenText Archiving and Document
Access for SAP Solutions - Scenario Guide (ER-CCS)
Notes
• The basic path and the archive path are only displayed in Full
administration mode.
• The path must always be closed using a forward slash (/) on UNIX
platforms and a backslash (\) on Windows platforms:
\\<Host name>\<Share name>\<Exchange directory>\.
OutputDevice
Enter ARCH.
No signature
If you select this option, the URLs for this archive are transmitted without
encryption. When you disable this option, the URL is given a SecKey, in
which important data is encrypted. In the latter case, a certificate must be
sent from the SAP system to the Archive Center and the signature check
must be configured in the OpenText Administration Client (see the Section
8 “Configuring security settings” in OpenText Archive Center - Administration
Guide (AR-ACN)).
6. Click Save.
You can send a certificate from your SAP system directly to the content repository
defined here.
Before using the Extended ECM for SAP Solutions functions, you must perform a
series of post-installation and customizing tasks in SAP. For more information,
see“Performing post-installation tasks for SAP ERP 6.0, SAP CRM 7.0, and SAP SRM
7.0” on page 125.
3. Navigate to the OpenText Extended ECM for SAP Solutions structure and
open it.
If an SAP system displays a different IMG structure rather than standard reference
IMG, the Extended ECM for SAP Solutions customizing is not visible. You have the
following options to access the Extended ECM for SAP Solutions customizing
structure:
• Use transaction SIMGH, save the Extended ECM for SAP Solutions IMG structure
as a favorite and call it from there.
• Add the Extended ECM for SAP Solutions customizing to the existing
customizing structure of transaction SPRO.
2. Enhance the SAP IMG structure for Extended ECM for SAP Solutions:
a. In the IMG structure field, select the IMG structure that is currently
displayed in the SPRO transaction and which you want to enhance.
For example, in SAP Extended Warehouse Management, select the IMG
structure SAP - Implementation Guide.
b. Click Favorite to add the IMG structure to your favorites.
c. Select the IMG structure in the Favorites list by double clicking.
d. If not already done, in field Enhancement ID, select the enhancement ID
created in Step 1.
e. Click Enhance Structure.
f. Select the root node of the IMG structure.
g. From the menu, select Edit > Nodes > Insert IMG Structure > As Subnode.
h. Enter the node name for the customizing, for example OpenText Extended
ECM for SAP Solutions.
i. Click Find structure to search for the Extended ECM for SAP Solutions
customizing IMG structure. Search for OpenText - Extended ECM for SAP
Solutions.
j. Click Copy.
k. Click Save.
3. Enhance the SAP IMG structure for Archiving and Document Access:
Repeat the steps described in Step 2 for the OpenText Archiving and Document
Access customizing with the corresponding data:
• Name of the node: OpenText Archiving and Document Access for SAP
Solutions
• Name of the IMG structure: OpenText Archiving and Document Access for
SAP Solutions
Notes
• If you do not want to use these roles, you must assign the respective
authorization objects to your own roles. You can also perform transaction
assignments in the SU24 transaction, and use them later in the profile
generation tool PFCG.
• If you want to use field values other than those recommend here, field help
provides additional information.
/OTX/RM_USER
Role for Extended ECM for SAP Solutions application users. This role allows an
SAP user declare ArchiveLink documents as records, search Content Server,
display a business workspace in the Business Content window, and show record
details.
This role contains the following authorizations objects:
/OTX/RM_ADMIN
Role for SAP administrator; this role allows for the post-installation and
customizing steps as well as administrative tasks like monitoring or running
batch jobs.
This role contains the following authorizations objects:
/OTX/RM_CS_SAP_USER
Role for the SAP system connection between Content Server and the SAP
system. This role is needed for the SAP user which is configured in Content
Server for the connection to SAP. For more information, see “Connecting SAP as
the business application” on page 159.
/OTX/RM_IMPERSONATED_USER_ROLE
Role for the SAP user which is used in the RFC destination. For more
information, see Section 5.7.1 “Enabling user-specific impersonation (SAP
BAdI)” in OpenText Extended ECM for SAP Solutions - User Management and
Access Control Scenarios (ERLK-CUM).
The installation packages provide only the standard entries for SAP assignments,
which means those visible in the SU22 transaction. Copy the standard Extended
ECM assignments into the “customer” tables (SU24) through the standard SAP
download/upload programs RSU22DOWN and RSU22UPLD in the following way.
1. Import the Extended ECM for SAP Solutions installation and support packages.
a. Use the SE38 transaction to run the RSU22DOWN program, which downloads
the transaction assignments.
c. Click Execute.
d. Enter a name for the data file.
3. Repeat this for the following transaction:
• /OTX/RMMIG
• /OTX/RMMIGPRINTL
• /OTX/RMMON
• /OTX/RMPEQ
• /OTX/RMPEQPRINTL
• /OTX/RM_DIAGNOSTIC
• /OTX/RM_DIAG_INFRA
• /OTX/RM_CFGREP
• /OTX/RM_WSC_PEQ
• /OTX/RM_WSC_Q
• /OTX/RM_WSC_Q_NR
• /OTX/SEA_UI
If Extended ECM ERP component OTEXRLE is installed, repeat this for the
following two transactions too:
• /OTX/RMERP_DMS_PEQ
• /OTX/RMERP_DMS_MIG
4. Upload the files with the transaction assignments:
a. Use the SE38 transaction to run the RSU22UPLD program, which upload the
transaction assignments to your customer’s table.
b. Enter the same list of transactions, for which you downloaded the data
files.
• SAP Data
Optionally, you can perform a test run first and also use the option to create
a transport file if needed.
d. Select the same file that you created with the download program.
5. After you have successfully completed the upload steps for all transaction, you
can adjust the transaction assignments in the SU24 transaction.
Note: For authorization checks that will be added or changed in future support
packages, OpenText will deliver a list of transactions whose assignments can
be copied into the “customer” list of the SU24 transaction. However, you must
verify existing transaction assignments in the SU25 transaction using step
Postprocess the Settings > 2B Compare Affected Transactions.
Note: If your system uses a different PSE file for SAP Logon Ticket signing (for
example, if you have implemented SAP Note 2420548), then you need to export
that file without the system PSE. The procedure is similar as described for the
system PSE.
1. In the IMG, navigate to the Export System PSE Certificate to File System
activity, and then click Execute.
2. Open the System PSE section, and then check whether there is a certificate in
this folder.
If this is not the case, create a new one. For more information, see SAP Help
Portal (http://help.sap.com/saphelp_nw70/helpdata/de/0e/
fb993af7700577e10000000a11402f/frameset.htm).
3. Make sure the certificate's CN value in the Owner field equals to the system ID;
in this case, the value is D67.
If this is not the case, delete the current one and create a new one.
4. Click Veri. PSE. If there are more certificates available, click Yes in the message
window to add only your own certificate to the verification PSE.
5. Click Yes, and then copy the PSE file to an appropriate location on the Directory
Services server.
Only if you want to use SAP SRM you must export the SAP certificate from an SAP
SRM portal.
In addition to the SAP server certificate, you must export a certificate for the portal.
– In the SAP Certificate (PSE) 1 field, add the certificate you exported
from SAP, and, optionally, provide a password. You can add additional
– Only if you want to map all SAP users to one user in Content Server
according to the scenario described in Section 3.2.3.4 “Mapping all SAP
users to one OTDS user in OTDS SAPSSOEXT authentication handler” in
OpenText Extended ECM for SAP Solutions - User Management and Access
Control Scenarios (ERLK-CUM), in the Map all SAP users to field, enter
the name of the OTDS user name to which all authenticated SAP users
will be mapped once their logon ticket is verified. Use the same format
that you define in the Authentication principal attribute field.
– From the list box, select an attribute that will uniquely find a given user
in Directory Services. Enter the attribute that complies to the SAP user ID
which is sent with the SAP logon ticket, for example oTExternalID or
oTExtraAttr1. Typically, this is oTExternalID1.
5. Click Save.
Note: Make sure that the SSO profile parameters of your SAP system are set to
the following values:
For a temporary setting, start the RZ11 transaction, enter the parameter name,
and then click Display. For a permanent setting, use the RZ10 transaction, and
restart the system after setting the parameter.
1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Activate HTTP Service activity, and then click Execute.
2. In the Hierarchy Type field, select SERVICE, and then click Execute.
3. In the Maintain service dialog, open the following node default_host > sap >
public.
4. From the context menu of the myssocntl item, select Activate Service.
2. In the Define Services window in the Filter for Calling ICF Hierarchy section,
select the Hierarchy Type SERVICES and click Execute.
• Extended ECM
• OpenText Directory Services
• Content Server Member Services
• Enterprise Library (only if still required due to Content Server version older than
16.2.10)
• Enterprise Library Content Services (only if still required due to Content Server
version older than 16.2.10)
1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create HTTP Connections activity, and then click Execute.
2. Click Create.
• RFC Destination
Enter a name for this connection, for example ELS_DEST_CORE.
• Connection Type
G (HTTP Connection to External Server)
• Description
Enter a descriptive text.
4. Click Save.
7. Check that the value in the Status HTTP Response field is 200 which indicates
that the request was successful.
• On the Logon & Security tab, select No Logon, and Send SAP Logon
Ticket.
• On the Messaging tab, in the Message ID Protocol field, select the Suppress
ID Transfer value.
If you are using an SAP_BASIS component with a version later than 16, you
might experience the following changes:
The Send SAP Logon Ticket is now called Send SAP Assertion Ticket and
you must provide as destination system the system ID and the client of the
current SAP system.
– SAPSYSTEMNAME
– SAPSYSTEMCLIENT
After creating the HTTP connection, you must create a corresponding logical port
for each connection:
1. In IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity, and then click Execute.
2. Extended ECM
Optional In the Proxy Class field, enter /OTX/CO_RM_WSW_ECMLINK.
3. Enter a new name in the Logical Port field, for example ECMLINK_LOGICAL_
PORT.
4. Select the Default Port check box. Select it for your main Content Server if you
have more than one.
5. Click Create.
8. Click Save and Activate (Ctrl + F3) to activate the logical port.
• Proxy Class
Enter /OTX/CO_OTDSAUTHENTICATION.
• Logical Port
Enter the name of the logical port, for example OTDS_LOGICAL_PORT
• HTTP Destination
Enter the HTTP destination created before, for example OTDS_DEST.
• State Management
Select this option for the OpenText Directory Services web service. If you did
not select this option, you will get an according message during the
connection check.
• Proxy Class
Enter /OTX/CO_MBLLMEMBER_SERVICE.
• Logical Port
Enter the name of the logical port, for example CSMEMBER_LOGICAL_PORT.
• HTTP Destination
Enter the HTTP destination created before, for example CSMEMBER_DEST.
• State Management
Select this option for the Content Server Member Services web service.
If you did not select this option, you will get an according message during
the connection check.
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity, and then click Execute.
3. On the Search tab, change the Search by value to Consumer Proxy, enter a * in
the Search Pattern field, and then click Go.
4. In the Search Results pane, select the entry for Extended ECM (/OTX/CO_RM_
WSW_ECMLINK), and then click Apply Selection.
6. Enter a new name in the Logical Port Name field and add a description.
Select Logical Port is Default if you have only one logical port for the Extended
ECM. If you have multiple logical ports for Extended ECM, select this option
only for one of the logical ports.
For the Configuration Type, select Manual Configuration.
8. Open the Consumer Security tab, and then select SAP Authentication
Assertion Ticket.
10. Open the Transport settings tab, and then enter the following parameters:
Click Save.
A message at the top of the screen indicates that the binding has been created.
11. Create the other logical ports according to the following table. If not indicated
otherwise, use the settings as described for the Enterprise Library port.
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity, and then click Execute.
3. On the Design Time Object Search tab, select the search criteria Object Type,
and then search for Consumer Proxy.
4. In the Search Results list, select the entry for Extended ECM (/OTX/CO_RM_
WSW_ECMLINK).
6. In the Logical Port Name step, enter a new name in the Logical Port Name
field, and then add a description.
Select Logical Port is Default if this is the only logical port for Enterprise
Library Services or if this is the preferred port of several logical ports for
Enterprise Library Services. Click Next.
Click Next.
9. In the SOAP Protocol step, set the Message ID Protocol option to Suppress ID
Transfer.
Click Next.
Click Finish.
The new logical port is saved and activated.
11. Repeat Step 4 to Step 10 to create a logical ports according the following table:
• Extended ECM
• OpenText Directory Services
• Content Server Member Services
• Enterprise Library (if required)
• Enterprise Library Content Services (if required)
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Create New Logical Ports activity, and then click Execute.
4. In the Search Results list, select the entry for Extended ECM (/OTX/CO_RM_
WSW_ECMLINK).
6. In the Logical Port Name step, enter a new name in the Logical Port Name
field, and then add a description.
Select Logical Port is Default if this is the only logical port for Enterprise
Library Services or if this is the preferred port of several logical ports for
Enterprise Library Services. Click Next.
Click Next.
9. In the SOAP Protocol step, set the Message ID Protocol option to Suppress ID
Transfer.
Click Next.
11. Repeat Step 4 to Step 10 to create a logical ports according the following table:
Notes
• To use the assertion based authentication, Extended ECM for SAP Solutions
has to use RFC destinations managed by SM59 transaction. In these RFC
destinations you can maintain the assertion ticket parameters.
For using the assertion based authentication mechanism you have to modify
configuration by:
2. Download wsdl_for_assertion_tickets_level_3.zip.
3. To install the predefined WSDL/OTDS web service, unpack the Zip file and
click on wsdl_for_assertion_tickets_level_3.
To create and configure the WSDL/OTDS web service for using the assertion
based authentication mechanism:
1. Download the web service WSDL from your installation, for example, from
http[s]://[host]:[port]/otsapxecm/services/ECMLink?wsdl.
2. Open this WSDL file in an editor and add the following policy definition to the
definition section:
<wsp1_2:UsingPolicy required="true"/>
<wsp1_2:Policy wsu:Id="BN__PLCY_ECMLink">
<wsp1_2:ExactlyOne>
<wsp1_2:All>
<sapattahnd:Enabled xmlns:sapattahnd="http://www.sap.com/710/
features/attachment/">false</sapattahnd:Enabled>
<saptrnbnd:OptimizedMimeSerialization xmlns:saptrnbnd="http://
schemas.xmlsoap.org/ws/2004/09/policy/optimizedmimeserialization"
wsp1_2:Optional="true"/>
<wsaw:UsingAddressing xmlns:wsaw="http://www.w3.org/2006/05/
addressing/wsdl" wsp1_2:Optional="true"/>
<wsp1_2:All xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/
policy">
<sp:TransportBinding xmlns:sp="http://docs.oasis-open.org/ws-
sx/ws-securitypolicy/200702" xmlns:sapsp="http://www.sap.com/webas/630/soap/
features/security/policy" xmlns:wsa="http://www.w3.org/2005/08/addressing"
xmlns:wst="http://docs.oasis-open.org/ws-sx/ws-trust/200512" xmlns:wsu="http://
schemas.xmlsoap.org/ws/2002/07/utility" xmlns:wsx="http://schemas.xmlsoap.org/ws/
2004/09/mex">
<wsp1_2:Policy>
<sp:TransportToken>
<wsp1_2:Policy>
<sp:HttpsToken>
<wsp1_2:Policy>
<sapsp:HTTPSSO2 SAPClient="999"
SID="ABC"/>
</wsp1_2:Policy>
</sp:HttpsToken>
</wsp1_2:Policy>
</sp:TransportToken>
<sp:AlgorithmSuite>
<wsp1_2:Policy>
<sp:Basic128Rsa15/>
</wsp1_2:Policy>
</sp:AlgorithmSuite>
<sp:Layout>
<wsp1_2:Policy>
<sp:Strict/>
</wsp1_2:Policy>
</sp:Layout>
</wsp1_2:Policy>
</sp:TransportBinding>
</wsp1_2:All>
</wsp1_2:All>
<wsp1_2:All>
<sapattahnd:Enabled xmlns:sapattahnd="http://www.sap.com/710/
features/attachment/">false</sapattahnd:Enabled>
<saptrnbnd:OptimizedXMLTransfer uri="http://xml.sap.com/
2006/11/esi/esp/binxml" xmlns:saptrnbnd="http://www.sap.com/webas/710/soap/
features/transportbinding/" wsp1_2:Optional="true"/>
<wsaw:UsingAddressing xmlns:wsaw="http://www.w3.org/2006/05/
addressing/wsdl" wsp1_2:Optional="true"/>
<wsp1_2:All xmlns:wsp="http://schemas.xmlsoap.org/ws/2004/09/
policy">
<sp:TransportBinding xmlns:sp="http://docs.oasis-open.org/ws-
sx/ws-securitypolicy/200702" xmlns:sapsp="http://www.sap.com/webas/630/soap/
features/security/policy" xmlns:wsa="http://www.w3.org/2005/08/addressing"
xmlns:wst="http://docs.oasis-open.org/ws-sx/ws-trust/200512" xmlns:wsu="http://
schemas.xmlsoap.org/ws/2002/07/utility" xmlns:wsx="http://schemas.xmlsoap.org/ws/
2004/09/mex">
<wsp1_2:Policy>
<sp:TransportToken>
<wsp1_2:Policy>
<sp:HttpsToken>
<wsp1_2:Policy>
<sapsp:HTTPSSO2 SAPClient="999"
SID="ABC"/>
</wsp1_2:Policy>
</sp:HttpsToken>
</wsp1_2:Policy>
</sp:TransportToken>
<sp:AlgorithmSuite>
<wsp1_2:Policy>
<sp:Basic128Rsa15/>
</wsp1_2:Policy>
</sp:AlgorithmSuite>
<sp:Layout>
<wsp1_2:Policy>
<sp:Strict/>
</wsp1_2:Policy>
</sp:Layout>
</wsp1_2:Policy>
</sp:TransportBinding>
</wsp1_2:All>
</wsp1_2:All>
</wsp1_2:ExactlyOne>
</wsp1_2:Policy>
<!--Insert this into the definitions section END-->
3. Link the binding with the policy definition and save the file.
4. Upload the modified WSDL definition and create a logical port based on this
definition. Set the parameters as follows:
• Authentication section
– Process Attachments: No
5. Repeat the above steps for each Extended ECM web service in use.
2. In the RFC Connections list open the HTTP Connections to External Server
section and find the destination configuration which is referred to in the
Extended ECM communication configuration.
3. In the Logon & Security tab in section Logon with Ticket select Send Assertion
Ticket for Dedicated Target System.
4. In the System ID field enter <your SAP Client ID>, and in the Client field enter
<your SAP Client ID>.
Note: If you chose this configuration path, the diagnostic report might display
a warning for the particular web service. You can ignore that.
1. Use the SM59 transaction and create a custom destination of type G HTTP
Connection to External Server.
7. Maintain the logical port name in the Extended ECM connection definition. For
more information, see “Maintaining Extended ECM connections” on page 152.
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure structure and open it.
Note: In the SOA Manager, the option names differ from release to
release. The following steps cover some of the possible option names. For
detailed information, see the SAP documentation.
• New Service Name or Web Service Name: Enter a name of your web
service, for example ECMLinkSPIService.
• Description: Enter a description for your web service.
• New Binding Name: Enter a binding of your web service, for example
BasicAuthBinding.
Note: The information you enter here will be part of the address used to
access the SAP system from Content Server:
https://<common url:port/sap/bc/srt/xip/otx/ecmlinkservice/<Client>/
<WebServiceName>/<BindingName>
Example:
https://mucr3d6v.example.com:44300/sap/bc/srt/xip/otx/ecmlinkservice/800/
ecmlinkspiservice/basicauthbinding
11. To configure your web service and binding, select your web service and end
point in the table, and then click Edit.
12. Define the security and authentication settings. The following authentication
scenario is supported:
For this, you define a logical destinations for each of the following systems:
You will need these logical destinations when you set up the connection to the
Extended ECM system. For more information, see “Maintaining Extended ECM
connections” on page 152.
Connection ID
Enter a connection ID.
• Logical Destination: Enter the logical destination as defined for it. For
more information, see “Creating logical destinations” on page 150.
• Partition: Enter the OTDS partition that is used to authenticate SAP
users in Content Server, only if you are using policies and only if you
have consolidated those users in OTDS in the format user@partition.
Do not enter @ together with the partition, only the partition name.
Leave the field empty if you do not use partitions at all.
Example: Users in your system are created using the following scheme
USER@PARTITION, for example nick@SAP_USER. In this case, here, you enter
SAP_USER.
• Impersonation RFC: If you are using impersonation, enter the RFC
destination used for impersonation. In addition, you must implement
and activate the /OTX/RM_IMPERSONATE BAdI and perform additional
configuration tasks. You also must provide the CS Resource ID.
RFC Impersonation uses a web service for SSO: If you want to restrict
this web service to redirect to a certain Content Server, you can maintain
a whitelist. For more information, see “Improving data security for
impersonation connections” on page 155.
• For more information about implementation, see the Extended ECM for
SAP Solutions SDK on OpenText My Support.
For more information about the impersonation scenario and relevant
configuration, see Section 5.7.1 “Enabling user-specific impersonation
(SAP BAdI)” in OpenText Extended ECM for SAP Solutions - User
Management and Access Control Scenarios (ERLK-CUM).
• Logical Destination: Enter the logical destination as defined for it. For
more information, see “Creating logical destinations” on page 150.
• Path: OTCS/cs.exe
– Enable the OTDS SSO authentication and disable the IIS IWA
configuration. (recommended)
– If you need IIS IWA for all others users except SAP users, and
there is no way to use OTDS SSO, you can create a second
mapping in IIS that does not have IIS IWA, and configure that in
the Extended ECM connection settings.
• Support Directory defines the directory on Content Server where the
files for the Content Server widgets are stored, for example img. This is
only relevant if you want to use widgets and meet all prerequisites. For
more information, see Section 9 “Using the Content Server Integration
Widget” in OpenText Extended ECM for SAP Solutions - Customizing Guide
(ERLK-CGD).
• External System ID: Enter the SAP System ID.
• CS Resource ID: Content Server Resource ID as defined for Directory
Services. This option is necessary if you want to use impersonation with
web-based SSO. To retrieve the ID, open Administration Client. Go to
Directory Services > Resources > <Content Server entry> > Edit and copy
the Resource identifier, for example, d7c6b26b-
af12-4d87-87cd-050de0768f4a.
RFC Impersonation uses a web service for SSO: if you want to restrict this
web service to redirect to a certain Content Server, you can maintain a
whitelist. For more information, see “Improving data security for
impersonation connections” on page 155.
Suppress Sending SAP Logon Ticket
Select this option if you do not want to send the SAP Logon Ticket.
Search UI
Enter the logical destination, you created for it.
4. Click Save.
2. Create an entry for each Content Server that is allowed to connect to your SAP
system:
Use Redirect URL /sap/public/otx_rmuic_sso as Whitelist Entry Type.
Provide the protocol, host name, port and an URL template.
Notes
Example:
Prerequisite
6. Repeat the steps for the SSL client SSL Client (Standard) node.
After the actual installation of the module, you have to perform post-installation
tasks in Content Server.
Note: You must restart Content Server after your enabled Business
Workspaces and Template Workspaces.
Notes
• If you want to use self-signed certificates, you must import them into the
following keystores:
The following procedure describes how to import a certificate to the Extended ECM
keystore ecmlink-spi.cacerts.
To import a certificate:
Example:
C:\OPENTEXT\jre\bin\keytool
‑import
‑alias mycertificate
‑file c:\temp\mycertificate.cer
‑keystore c:\opentext\config\ecmlink-spi.cacerts
‑storepass mypassword
1. On the global menu, click Enterprise > Extended ECM, and then click
Connections to Business Applications (External Systems).
3. Specify the parameters for your business application according to the list below.
4. Click Add.
Connection Type
Select the adapter for your business application. If there is no special adapter for
your specific business application available, select Default WebService
Adapter.
Enabled
Select this option to enable the configuration.
Tip: You can disable a configuration, for example if you created it only for
testing and you do not want it to be used.
Comment
Enter a comment to give further information.
Base URL
Enter the common URL for accessing the business applications via a Web
browser. You can use this base URL when configuring business object types on
Content Server. The base URL is represented by the $BaseURL$ variable for new
business object types.
For example, https://r3d5g.example.com:44300
Application Server Endpoint
Specify the URL that will be called to obtain business object information.
• 800 is the client number. Replace this number with your own client
number.
Schema Version
Select the interface version.
User Name
Enter the user that is used to access business object type information in the
business application.
Notes
– The Content Server user who is assigned to this user needs reading
permission on the unique names.
3. In the Archive Server field, enter the name of the Archive Center host.
6. Click OK.
To declare records, Extended ECM for SAP Solutions needs an Enterprise Library
application. ArchiveLink documents and print lists declared as records by the SAP
system can either be stored in the Enterprise Workspace or in this application area.
To restrict access to these documents, you must set additional permissions on the
application level.
To create an application:
1. In the OpenText Administration Client, navigate within the Enterprise Library
Services to the Applications entry.
2. In the Actions pane, select the New Application entry.
3. Enter the required parameters for the application.
see Section 24.8 “SAP: Scheduling jobs for removing deleted records” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
b. In the Password field, you define an application password that is used for
“Maintaining Extended ECM connections” on page 152.
c. Click Next.
4. Select the required audit interests that correspond to your audit scheme, and
then click Finish to complete the assistant.
The new application is now displayed in the list of applications.
2. Click the button of the application folder with the application ID you just
created, and then select the Permissions.
• Full access rights to the volume for the user who created the application (in
our case the user is otadmin@otds.admin).
• Only See and See Contents access rights for the groups DefaultGroup and
Public Access.
3. Add users and groups that must have access to this volume.
4. Grant full access to those users and groups that have to declare records within
SAP.
Therefore, OpenText recommends doing the following before any records are
created.
3. Click the button of the folder you just created, and then select the
Permissions.
4. Add users and groups that must have access to this volume.
5. Grant full access to those users and groups that have to declare records within
SAP.
Create the Content Server users according to your authentication scenario. For
example, for each SAP user working with Extended ECM for SAP Solutions, you can
create a Content Server user with the same user name as in SAP. Alternatively, you
can have one Content Server user for many SAP users.
For test purposes or a small number of users, this can be done manually in OpenText
Directory Services. For a large number of SAP users this can achieved using an
Active Directory server that provides users for both the SAP system and for Content
Server via Directory Services.
In your SAP system, the users are either provided and maintained in your SAP
system or in an external identity provider. Directory Services can synchronize with
your identity provider to pull user and group information from your identity
provider automatically.
The following access rights (either directly, via a group, or via public access) are
required:
Records should be created for HR and Finance department; you could now
separate the records either by storing them in different locations or by
classifying them differently. To use the classification approach, create a Finance
Content Server group and add all the users that should have access to the
Finance records; then create a similar HR group. Assign the Finance group
access rights to the Finance classification and the HR group to the HR
classification.
4. Add the Business Administrators group and grant the required permissions up
to and including the Delete permission. Make sure the Delete permission is
only for sub-items not for the root folder, for example for the categories but nor
for the Categories volume.
• ActiveView
• Appearance
• Category
• Category Folder
• Classification
• Custom View
• LiveReports if you want to configure widgets, which use LiveReports
• WebReports if you want to configure widgets, which use WebReports
• License metering if you want to run the License report.
• Business Administration:
Content Server Document Templates
Business Workspaces
Extended ECM
Extended ECM for SAP
• Move Business Workspaces: Only users with this privilege can move a business
workspace to a different folder.
• Edit attributes relevant for group mapping: This privilege is relevant if you use
group replacement in the template. It restricts the editing of attributes that are
used to define the groups that have access to a business workspace. For more
information, see Section 3.16.1.8 “Defining group replacement settings” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
• Regenerate Reference Attribute: This privilege allows to generate a new
reference number. This may be necessary if the reference number contains
attributes and these attributes have changed. For more information, see Section
3.11.7 “Using the Reference attribute” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).
• Change/Remove Workspace Reference: This privilege allows users to change
the business object of a business workspace, or remove the business object from
the workspace.
• Access Business Workspaces (<Product Name>): This privilege is provided by
each installed Extended ECM product. It necessary to access a business
workspace. It is also the basis for license measurement. .
• Display Business Objects: This privilege allows users to display the data of a
business object in the business application.
• Add/Edit/Remove Business Objects: This privilege allows users to add business
objects to Content Server items.
2. Find the Business Workspaces and Extended ECM usage types and configure
them according to your requirements.
For more information about permissions and privileges in Content Server, see
Section 4.3 “Permissions on Content Server” in OpenText Extended ECM for SAP
Solutions - User Management and Access Control Scenarios (ERLK-CUM).
For more information about permissions and privileges on Content Server, see
Section 4.3 “Permissions on Content Server” in OpenText Extended ECM for SAP
Solutions - User Management and Access Control Scenarios (ERLK-CUM).
Per workspace You can inhibit copying for each workspace type.
type
Usage You can grant the Move Business Workspaces usage privilege to a group of users.
Privileges You need administrator permissions for this.
Classification As default, users can copy or move business workspaces only to folders, which have
independent the same classification as their original folder. However, you can disable this check
and allow users to copy or move business workspaces wherever they want to. This
is a system-wide setting and you need administrator permissions for it.
Note: System administrator rights are required for this task. Please ask
OpenText Professional Services for assistance.
2. Add an entry for each language that you want to support, and enable it.
Important
Select languages whose Language Code matches the value of the Lng ISO
field in the SAP system, for example en.
You can have more languages in Content Server than you have
customized in the business application, but you must not have less.
2. In the Managed object types section, click Configure and make sure that at
least the Business Workspace (subtype 848) item is configured.
3. For the Classification tree for document types, select a classification tree for
business workspaces.
4. Set the other options as required. For more information, see the Content Server
online help for that page.
3. From the Look For list, select Complex Query. Then create a complex query
and specify as search criterion: XECMWkspLinkRefTypeID:<ID_CFG value>.
5. Click Save as Slice and enter a name. The slice is saved to the Slice Folder.
6. Set the permissions for the created slice to make it available for the respective
users.
Attributes that were changed in the business workspace are propagated to the sub-
items to ensure clean data. Because of this feature as well as for performance reasons
you should prefer indexing over metadata inheritance in document templates.
You enable indexing for each business workspace type, and you select which items
are to be indexed. After changing the indexing setting, it may be necessary to re-
index documents.
• Folder
• Shortcut
• Generation
• URL
• Task List
• Task
• Email
• Document
• Business Workspace
5. Select Run in test mode without indexing to see how many documents need re-
indexing.
Tip: Run the test mode first to estimate the impact of the indexing process
on Content Server performance.
6. To start the re-indexing, clear the Test run option and click Start.
The re-indexing process is scheduled. You can monitor the actual indexing
progress on the Content Server System page.
Click the respective link on the current window to go to Content Server
System, then click Enterprise Data Source Folder > Enterprise Data Flow
Manager. You can monitor the processing in the Interchange Pools section.
Important
• This chapter only covers perspectives for business workspaces. For more
information about the full functionality of Perspective Manager and
perspectives, see the online help of Perspective Manager.
Some widget parameters support multilingual text. You recognize them by the globe
icon . When you click into one such box, a pop-up opens with text boxes for each
installed language.
Note: In each business workspace, you can have only one Node Browsing
Table widget, regardless of how many tabs you have.
1. On the global menu, click Enterprise > Business Workspaces, click Workspace
Types, and then open a workspace type.
3. In the Perspective Manager, on the General tab, click Create new, and then
enter a title for the perspective.
4. On the Rules tab, you create logical rules, which control when the perspective is
used.
5. On the Configure tab, you design the perspective of the workspace type.
• The widget library pane on the left contains widgets from installed modules,
one of which being Business Workspaces.
• The working area in the middle is where you place the widgets.
• The options pane on the right shows configuration options of the selected
widget.
• The tabs are configurable. You can create new tabs or edit them. Double-click
a tab name to rename it. To remove a tab, select another tab, and then drag
the tab, which you wanted to delete, out of the picture.
Note: When you transport perspectives using the Transport Warehouse, you
must follow a certain order to keep dependencies. For more information, see
Section 6.4 “Transporting the configuration” in OpenText Business Workspaces -
Configuration Guide (CSCWS-CGD).
With version 20.2, all ActiveView perspectives use a new “Perspectives” node type
and must be converted, therefore all rule-based workspace perspectives must be
manually migrated to type-based perspectives.
Important
If you have more than one perspective for the same workspace type, you must
follow a certain order for the conversion of these perspectives.
4. Open the workspace perspective that you want to convert, click Edit
Perspective and convert it. Stick to the order that you noted in Step 2.c.
a. On the General tab, click Edit existing and select the perspective you want
to migrate.
b. As Type, select Workspace.
c. Select the corresponding workspace type. If you are unsure, which
workspace was associated to this perspective, check the rule in the Rules
tab.
d. On the Rules tab, delete the rule with the workspace type.
e. Click Update.
For more information, see the online help for Perspective Manager.
You can also embed another widget in the Header widget, currently only the
Activity Feed widget.
Workspace Properties
Workspace properties are displayed in the left part of the Header widget in the
following top-down order, with the font becoming smaller. You can use the
suggested properties, add others, and combine attributes and properties with
text.
Property Description
Title Name of the business workspace, prefilled
with the {name} node property.
Type Name of the workspace type, prefilled
with the {business_properties.
workspace_type_name} business
property.
Description Description of the business workspace,
prefilled with the {description} node
property.
Widget
You can embed another widget in the header widget. It depends on your
system, which widgets are available.
Property Description
Embed Widget Select one of the available widgets to
embed it into the header widget. It is
displayed in the right half of the header
widget. Currently available is the Activity
Feed widget, which displays all activities
in relation to this business workspace and
its related child workspaces. You see
comments or recently added documents.
If you want to use the Activity Feed
widget, you must enable Content Server
Pulse and, optionally, create activity
manager objects. For more information, see
Section 5.7 “Creating an activity manager
object for the Activity Feed” in OpenText
Business Workspaces - Configuration Guide
(CSCWS-CGD).
General
Property Description
Title Title of the widget, typically the
workspace type name in plain text.
Workspace type Workspace type of the related workspaces.
Relation type Child or Parent.
Collapsed view
Property Description
Message for empty result Custom message if no business
workspaces of this type are available.
Preview pane The preview pane is a window that opens
when you hover with the mouse over a
related workspace in the widget. The
preview pane contains additional
information as well as team members of
this business workspace.
• Preview title – Title of the preview
pane, for example the workspace type.
The title is displayed in small font
above the display name of the related
workspace.
• Message for empty metadata – Custom
message if there is no metadata to
display.
• Name of role – Name of the role whose
members are displayed in the preview.
• Message for empty role – Custom
message if there are no roles or team
members to display.
Message that is displayed if the
specified role has no members. The
default text is No role members
assigned.
Property Description
Metadata in preview pane The preview pane uses data from category
attributes. You select a category or single
attributes. To group attributes, enter a
group name and then select the categories
and attributes. Leave the group name
empty to add a category or attribute
without a group. Drag attributes or groups
to change the order.
• Group name – Name of a group of
attributes or categories
• Category or attribute – Category or
single attributes. You can use the
following data sources: A single
attribute or a complete category with
all its attributes.
Order by Orders the list of related workspaces by a
custom column and defines the sort
direction. The default sorting is ascending
by the name of the business workspace.
If you have not selected a custom column
in the Order by option, the workspaces are
ordered by the custom column configured
in Related workspace title. And in this
case, you can only use custom columns
that are configured for ordering. If you
selected a custom column that is not
configured for ordering, an error message
is displayed when the widget is loaded.
For more information about configuration
of custom columns, see Section 5.6
“Creating custom columns for Content
Server Smart View search and widgets” in
OpenText Business Workspaces -
Configuration Guide (CSCWS-CGD).
If you want to have the workspaces sorted
by another order than by name, you must
explicitly define the column and the sort
order in the order by section.
• Default is an order ascending by name.
• Sort ascending by the column that you
want to display as Title: Select that
column as Title, do not specify
anything in the Order by field.
• Sort descending by the column that
you want to display as widget title:
select that column as Title, additionally
select this column in the Order by field,
and select the sort order Desc.
Property Description
Related workspace title Name of the related workspace. You can
use the following:
Variables: {name}. It uses the name of the
business workspace, which may already be
assembled from several attributes.
{modify_date}. For this, the custom
column for Workspace Modify Date
must be configured and have the Used for
Sorting and Filtering option enabled.
Custom columns if they have the Used for
Sorting and Filtering option enabled.
Related workspaces description Description of the related workspace. You
can use the following:
Variables: {name}, {description},
{type_name}, {modify_date},
{create_date}
System Default Columns: {id}, {size},
or {type}
Custom columns if they have the Used for
Sorting and Filtering option enabled.
Metadata fields Additional fields to display metadata in
the widget. Enter a label and the value,
which can be a custom column or one of
the following variables: {name},
{description}, {type_name},
{modify_date}, {create_date}. The
{name} variable uses the name of the
business workspace, which may already be
assembled from several attributes.
To format a custom column to be
displayed in currency format,
add :currency within in the brackets, for
example: {wnf_att_fl14_
5:currency}. With this format, zeros are
displayed and thousands separators are
added.
Expanded view
Property Description
Order by Orders the list of workspaces by a custom
column and defines the sort direction.
Property Description
Custom columns Custom columns to be displayed in the
expanded view. Select a custom column,
and then click Add to array. You can drag
the columns to change the order.
You can enable sorting by date in the
Related Workspaces widget. For this, you
create a custom column for the Workspace
Modify Date data source and configure it
to be sortable and used for sorting and
filtering. No further configuration is
required in the widget. For more
information, see Section 5.6 “Creating
custom columns for Content Server Smart
View search and widgets” in OpenText
Business Workspaces - Configuration Guide
(CSCWS-CGD).
Property Description
Title Title of the Team widget. Default is Team.
Property Description
Title Title of the Metadata widget. Default is
Metadata.
Hide empty fields Hide metadata fields that have no value.
Default is False.
Property Description
Metadata The Metadata widget uses data from
category attributes. You select a category or
single attributes. To group attributes, enter a
group name and then select the categories
and attributes. Leave the group name empty
to add a category or attribute without a
group. Drag attributes or groups to change
the order.
• Group name – Name of a group of
attributes or categories. You can use this
option to visually group attributes.
• Category or attribute – Category or
single attributes. To add an attribute,
select the category and then select the
attributes that you want to display.
General
Property Description
Title Title of the Workspaces widget, typically
the type of business workspaces listed
here. Default is My workspaces.
Workspace type Type of business workspaces that you
want to display.
Collapsed view
Property Description
Title Title of the Workspaces widget, typically
the type of business workspaces listed
here. Default is My workspaces.
Message for empty result Custom message if no business
workspaces of this type are available.
Expanded view
Property Description
Title Title of the Workspaces widget, typically
the type of business workspaces listed
here. Default is My workspaces.
Order by Orders the list of workspaces by a custom
column and defines the sort direction.
Custom columns Custom columns to be displayed in the
expanded view. Select a custom column,
and then click Add to array. You can drag
the columns to change the order.
You can enable sorting by date in the
Workspaces widget. For this, you create a
custom column for the Workspace Modify
Date data source and configure it to be
sortable and used for sorting and filtering.
No further configuration is required in the
widget. For more information, see Section
5.6 “Creating custom columns for Content
Server Smart View search and widgets” in
OpenText Business Workspaces -
Configuration Guide (CSCWS-CGD).
Notes
Set notifications
To support the Follow feature in the Discussion widget, you must configure
notifications just as you would for a Forum in Classic View. For information
about how to configure the frequency of notifications if a user chooses to follow
a topic, see Section 1.2 “Configure Notifications” in OpenText Content Server -
Notifications Administration (LLESWBN-H-AGD).
Set eLink
To support the Follow feature in the Discussion widget, you must configure
eLink just as you would for a Forum in Classic View. For information about how
to configure eLink, see Section 1.2 “eLink Settings” in OpenText Content Server -
eLink Administration (LLESELK-H-AGD).
Parameter Description
Width Choose the size that you want for the Discussion widget.
For the Overview tab of a business workspace, the recommended size is
single width.
Forum object To associate the widget with the Forum object in the business workspace,
leave this parameter empty and the widget will automatically link to the
forum. Typically, the administrator creates a new Forum object in the
business workspace or in the business workspace template.
Notes
• The Forum objects must be available in the root folder of the
business workspace. If the root folder does not include a Forum
object, the Discussion widget will display a message that no
discussion is configured. If you later add a Forum to the root
folder, the Discussion widget will automatically link to it.
• If there is more than one Forum object in the root folder of the
business workspace, the Discussion widget automatically links to
the oldest Forum.
For information about how to create a Forum, see Section 1.1 “Creating
and Configuring Forums” in OpenText Content Server - Forums (LLESFOR-
H-UGD).
Users can create a snapshot for all business attachments displayed in the widget.
Snapshots are folders in Content Server, which contain a Generation of the latest
version of each business attachment that is a document. A Generation is a copy of a
document, which is separated from the original document, unlike a version. For
more information, see the Content Server help. The snapshot contains a shortcut to
objects other than documents. The name of the folder starts with a prefix, which you
configure for the widget.
In the expanded view, you see additional information for each business attachment
such as description, location and version.
General
Property Description
Title Title of the Business Attachments widget.
Default is Business attachments.
Property Description
Snapshot folder name prefix Prefix that is added to the snapshot folder
when you create a snapshot from this
widget. A snapshot freezes the current
version of all business attachments of the
business object and stores them in a folder.
Business attachment
Property Description
Business object ID Category attribute that contains the ID of the
business objects for which you want to
display business attachments.
Business object type Category attribute that contains the business
object type.
Business application ID Category attribute that contains the ID of the
business application where the business
object type resides.
If you want to use attribute sets in these fields, you must use the following format:
{categories.<category ID>_<set number>_<attribute ID>}, for example,
{categories.37275_33_1_34}. If the attribute picker does not provide this format,
you must enter it manually.
To retrieve the attribute ID, run the following report: <URL of content server>?
func=attributes.dump.
Collapsed view
Property Description
Message for empty result Custom message if no business attachments
are available.
Property Description
Order by Orders the list of business attachments by a
column. The default sorting is ascending by
the name of the business attachment.
Expanded view
Property Description
Order by Orders the list of business attachments by a
column and defines the sort direction.
Snapshot
Property Description
Parent folder name Folder in business workspace, where
Snapshots are created.
Snapshot name prefix The name of a snapshot consists of the prefix
and a timestamp.
Property Description
Default group by criterion Groups the documents by their creation date
or a classification.
Hide group by criterion dropbox Provides an option for users to hide certain
groups of documents. The default settings
display the dropbox.
Hide metadata Provides an option for users to hide
metadata of documents. The default settings
display the metadata.
Hide empty fields Hide metadata fields that contain no data.
The default settings display empty metadata
fields.
Note: Do not use multivalue attributes and multi-row set attributes in the
header widget. You can only use text attributes.
Workspace Properties
Property Description
Title Name of the business workspace, prefilled
with the {name} node property.
Type Name of the workspace type, prefilled with
the {business_properties.
workspace_type_name} business
property.
Description Description of the business workspace,
prefilled with the {description} node
property.
Workspace properties are displayed in the left part of the Header widget in the
following top-down order, with the font becoming smaller. You can use the
suggested properties, add others, and combine attributes and properties with text.
Widget
You can embed another widget in the header widget. It depends on your system,
which widgets are available.
Property Description
Embed Widget Select one of the available widgets to embed
it into the header widget. It is displayed in
the right half of the header widget. Currently
available is the Activity Feed widget, which
displays all activities in relation to this
business workspace and its related child
workspaces. You see comments or recently
added documents.
Metadata settings
Property Description
Hide metadata Provides an option for users to hide
metadata of documents. The default settings
display the metadata.
Hide empty fields Hide metadata fields that contain no data.
The default settings display empty metadata
fields.
Metadata The Header widget uses data from category
attributes. You select a category or single
attributes. To group attributes, enter a group
name and then select the categories and
attributes. Leave the group name empty to
add a category or attribute without a group.
Drag attributes or groups to change the
order.
Favorite
You can hide the Favorite button in the Header widget.
In the configuration of this widget, select one or more business object types. The
business object type must have a configuration for the category attribute, which
contains the barcode value.
With the installation of Extended ECM, a logo and the overrides.css are already
on your system. The override.css file is located in the <Content Server home/
support/xecmpf> folder. You need to change the filename, edit the CSS file and
propagate it.
1. Copy the overrides.css file and name it, for example, my-overrides.css.
2. Open the my-overrides.css file in an editor. Change the graphic file name in
the background-image parameter:
– header_extended_ecm.svg
– header_extended_ecm_inv.svg
• Use your own graphic file. If you use your own graphic file, you copy it to
the support directory <Content Server home/support/xecmpf>. If you
store it in a different folder, you must provide the correct path in the CSS
description.
3. Propagate the my-overrides.css in Content Server:
• Leave the Enable Document Overview Pages option clear to open the
viewer by clicking the document link.
Note: Business workspace documents will not receive the View Document
option, even if the Review and Notes module is installed.
You can configure the Open Link option to be the default viewing method. For
more information, see Section 6.3 “Integrating in Content Server” in OpenText
Imaging Web Viewer - Installation and Configuration Guide (CLWEBV-IGD).
Users of smart view can work with ArchiveLink documents using Web Viewer and
can access notes and annotations for these documents. For non-ArchiveLink
documents, in business workspaces, users can use Content Suite Viewer, OpenText
Viewing or OpenText Intelligent Viewing (licensed version), whichever is
configured and available.
Online help
Some of the help in Content Server is built-in: It is delivered as online help that
is included in the Content Server application directory. Content Server online
help is updated when you apply a Content Server Update, or when you upgrade
Content Server.
OpenText Global Help Server help
Help for the Content Server Smart View, and for certain products such as
Perspective Manager and Business Workspaces is delivered as OpenText Global
Help Server help, which is available over the Internet. Global Help Server help is
updated by OpenText. Updates can occur at any time without requiring any
action on your part. However, if your organization restricts access to the public
Internet, you may need to implement the OpenText Private Help Server: a local
installation of the Global Help Server. For more information, see “Providing the
online help on a local help server (Private Help Server)” on page 197.
Notes
• The Private Help Server can support multiple OpenText products. If the
Private Help Server has already been installed within your organization to
support another OpenText product, you can add additional OpenText
product online helps to that installation.
• If you are replacing a previous PHS installation, see Section 2.5 “Updating a
Private Help Server installation” in OpenText Help System - Private Help Server
Administration Guide (OTHS-AGD).
• If the server you want to use for the PHS installation cannot connect to the
Internet, see Section 1.2 “Deploying online help files in a secure environment
(no Internet)” in OpenText Help System - Private Help Server Administration
Guide (OTHS-AGD).
Once the PHS is installed or upgraded, you can use its Online Help Deployer to
download online helps from the GHS system by entering the help deployment codes
listed below. For more information about using the codes, see Section 3 “Adding
product online help to the Private Help Server” in OpenText Help System - Private
Help Server Administration Guide (OTHS-AGD).
Code Product
ERLK210400-IGD OpenText™ Extended ECM for SAP®
Solutions CE 21.4
Note: This section applies only to the OpenText Global Help Server help,
which is available over the Internet.
For information about the built-in online help that is included in the Content
Server application directory, see Section 7.4 “Set Up the Help Environment” in
OpenText Content Server - Installation Guide (LLESCOR-IGD).
To have your Content Server installation call the help topics on your Private Help
Server, set the URL Root of your Private Help Server on the Configure Smart View
administration page.
2. On the Configure Smart View page, enter the base URL of your Private Help
Server in the URL Root box:
http://<Private_Help_Server>:<port>/OTHelpServer/mapperpi
Example: http://tomcat.example.com:8080/OTHelpServer/mapperpi
You find the transport file in the staging directory of the Extended ECM for SAP
Solutions module at the following location: support/transport/System
Categories.zip. The ZIP file contains the transports for the otx.sap.rm.
SystemArchiveLink and the otx.sap.rm.SystemPrintList categories.
When the business workspace is restored from the Recycle Bin, it is not re-connected
to the original business object. Users must manually assign a business object as
workspace reference again.
The object types Business Workspaces (848) and Related Business Workspace (854)
are mandatory restorable object. This means, that they are always restorable and
cannot configured otherwise.
After installation, unique names for standard SAP themes already exist. You can edit
these unique names and their assignment. Changes take effect immediately. The
following SAP themes are already configured: content_server, default, sap_
tradeshow, sap_tradeshow_plus. Unique names for appearances must use the
prefix theme_ and they are always expected in lower-case, even if SAP sends the
parameter in upper-case. For more information, see Section 3.18 “Creating unique
names for Content Server items” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
Note: System administrator rights are required for this task. Contact OpenText
Professional Services for assistance.
These settings will turn off certain standard Content Server UI components such
as header and footer; an additional JavaScript will be added to the appearance
to manipulate the breadcrumb navigation.
By default, the add-in allows users to browse to and search for business workspaces
and select a folder in which to save an email. If needed, you can also force users to
save emails to a specific regular folder or Email folder in a business workspace.
Tip: For more information about Outlook add-ins, see Add-ins for Outlook
(https://technet.microsoft.com/EN-US/library/jj943753(v=exchg.150).aspx).
You must download the latest manifest file for the Business Workspaces Outlook
add-in from the Content Server system you want to use to store emails. During the
download process, information about that Content Server system is saved to the
manifest file. You can then use the downloaded manifest file to install or upgrade
the add-in in Microsoft Exchange or Microsoft Exchange Online.
When users subsequently open the add-in in Outlook, the add-in automatically
connects to the Content Server system you used to download the manifest file.
If you upgrade the Business Workspaces Outlook add-in, downloading the manifest
file, as documented in “To download the latest Outlook add-in manifest file:
“ on page 204, allows you to see all functionality of the upgraded module.
Tips
Note: You must use the manifest file you downloaded to install the Business
Workspaces Outlook add-in in Microsoft Exchange or Microsoft Exchange
Online. During the installation process, when you are prompted to select the
location from which to install the add-in, select Add from file and then select
the manifest file you downloaded.
For more information, see Install or remove add-ins for Outlook for your
organization (https://technet.microsoft.com/en-us/library/
jj943752(v=exchg.150).aspx).
For more information about configuring a web server for Content Server, see
OpenText Content Server - Installation Guide (LLESCOR-IGD).
1. On the Content Server system you want to use to store emails, browse to the
Content Server Administration page, and click Business Workspaces > Set up
Outlook Add-in.
2. On the Set up Outlook Add-in page, in the Outlook Add-in Manifest File area,
do the following:
a. The File name field cannot be edited. This field contains the filename of the
manifest file, BusinessWorkspace.Manifest.xml.
b. The File version field cannot be edited. It displays the Outlook add-in
manifest file version that is available to be downloaded.
c. In the Content Server URL field, confirm that the value in this field
displays the URL for the Content Server system you want to use. The URL
must start with https.
By default, the URL of your current Content Server system is pre-populated
in this field. In most cases, you can keep the default URL. However, you
can edit the URL if, for example, the pre-populated URL does not contain
the correct protocol value or if your Content Server system requires a
different URL for external access.
Notes
• If the pre-populated URL starts with http, you must map Content
Server to a web server that has HTTPS enabled. You must then
confirm that the new URL, that starts with https, appears in the
Outlook Add-in Manifest File area.
• If you edit the URL, and you are using a port other than 443 for
HTTPS connections, you must add your server port number to the
URL. For example, if you are using port 4430 for HTTPS
connections, the URL must have the following form:
https://MyHost.example.com:4430
3. Click Download.
23.21.1.3 Migrating custom settings to the new Outlook add-in manifest file
If you are upgrading the Business Workspaces Outlook add-in, you must migrate
settings from your old manifest file to the new manifest file you downloaded if you
previously edited your old manifest file to add custom settings, for example, image
URLs.
Note: If you did not add custom settings to your old manifest file, you can skip
this task.
To migrate custom add-in settings to the new Outlook add-in manifest file:
2. From your old manifest file, copy the custom settings you want to migrate and
paste them to the corresponding locations in the new manifest file.
Tip: For more information about installing Outlook add-ins, see Install or
remove add-ins for Outlook for your organization (https://
technet.microsoft.com/en-us/library/jj943752(v=exchg.150).aspx).
1. In Microsoft 365 admin center, open the Services & add-ins page.
4. Select I have a manifest file (.xml) on this device and click Choose File to select
the BusinessWorkspace.Manifest.xml file you downloaded.
1. Create and configure the business workspaces and folders in which you want
users to save emails. For more information about the types of folders you can
create and the guidelines for creating the folders, see “Creating Content Server
folders for the add-in” on page 206.
2. Grant users the Add Items permission, or higher, on the business workspaces to
which they will save emails.
3. Optionally, if you want users to specify metadata values when saving emails to
folders, assign any of the following categories to those folders:
You must create one or more regular or Email folders in each business workspace
based on the functionality you plan to configure.
• If you plan to allow users to browse to, and then select, folders in which to
save emails, you can create as many regular folders as you want in each
business workspace.
• If you plan to force users to save emails to a specific, regular folder, you must
create an instance of the same folder in each business workspace. The
spelling and capitalization of each folder instance must match in all of the
business workspaces.
Example: If you want to allow users to save emails to a business workspace called
BW1, and also save emails to a second business workspace called BW2, create a regular
folder called Email communication in BW1, and a separate folder with the same name
in BW2.
• If you plan to allow users to browse to, and then select, folders in which to
save emails, you can create as many Email folders as you want in each
business workspace.
• If you plan to force users to save emails to a specific Email folder, you must
create an Email folder in each business workspace. You can choose to create
an Email folder with a different name in each business workspace or create
an instance of the same Email folder in each business workspace.
If you create an Email folder with a different name in each business
workspace, each folder that you create must be the first Email folder that
appears alphabetically in each business workspace. When a business
workspace has multiple Email folders, emails are saved only to the first
Email folder that appears alphabetically in that business workspace.
If you create an instance of the same Email folder in each business
workspace, the spelling and capitalization of each folder instance must
match in all of the business workspaces.
Tip: Regular folders and Email folders are specific types of folders that you can
create in Content Server. For more information about each folder type, see
Section 4.7 “Adding and Configuring Folders” in OpenText Content Server - Get
Started (LLESRT-H-UGD).
If you want to display a different set of search forms in the Select a search form list,
you can add search forms, or shortcuts that point to search forms, to the Search
Forms folder in the Business Workspaces volume. You must also configure each
search form as a custom view search.
1. For more information about creating search forms and configuring them as
custom view searches, see Section 5.15.4 “Classic View: Configuring a
• Create a search form in the Search Forms folder. Browse to the Search
Forms folder, click Search on the Tools menu, and then configure the search
fields for the form.
• Create a search form in any other Content Server location, and then add a
shortcut that points to that search form in the Search Forms folder.
Tip: When you create a search form, consider setting its Content Type
system attribute to Business Workspace. When this attribute is set, only
business workspaces are returned in the search results.
2. Configure the search form as a custom view search. On the Make Custom View
Search page of the search form, select the Show check box for one or more
search fields, and then click Save.
2. Remove a search form or shortcut from the folder, for example, delete the item
from the folder or move it to a different location outside of the folder. The
corresponding search form is removed from the Select a search form list in the
add-in.
Before Outlook Add-in version 20.3, single sign-on (SSO) was disabled by default.
Beginning with version 20.3, for new installations, SSO is enabled by default. You
can change this setting in Step 6. Single sign-on requires configuration, the
instructions can be found in Section 5.17.5 “Configuring your environment for SSO
authentication” in OpenText Business Workspaces - Configuration Guide (CSCWS-CGD).
1. On the global menu, click Enterprise > Business Workspaces, and then click
Outlook Add-in Configuration.
2. Click General Configuration. On the Configure Outlook Add-in page, do the
following:
3. In the Email Saving Options area, if you want to specify the folders and folder
types to which users can save emails, configure the following options:
• In addition, if you want to restrict users, so that they can only save
emails to Email folders, select Save emails only to email folders. Clear
this box if you want to allow users to save emails to any type of folder.
This box is cleared by default.
When this box is selected, the Save icon appears only when users place
their pointer on Email folders in the add-in. When this box is cleared,
the Save icon appears when users place their pointer on any type of
folder in the add-in.
b. Optional If you want users to save emails to a specific folder in a business
workspace, select Save emails to a pre-configured folder. This box is
cleared by default.
Clear this box if you want to allow users to save emails to any folder in a
business workspace. If you clear this box, you must select and configure the
Allow users to expand workspaces and browse workspace folders option
in Step 3.a instead.
If you select this box, you must choose one of the following options:
• If you want users to save emails to the first Email folder that appears
alphabetically in a business workspace, select Save emails to the first
email folder in the workspace.
You can use this option if, for example, you want to allow users to save
emails to Email folders with different names in each business
workspace (for example, an Email folder called MyFolder in one
business workspace and an Email folder called Communication in
another business workspace).
If you select this option, you must create an Email folder in each
business workspace that users can access in Content Server. Each folder
you create must be the first Email folder that appears alphabetically in
each business workspace.
• If you want users to save emails to the workspace root folder, select
Save emails to the workspace root folder. For information about the
workspace root folder, see Section 1.11 “Creating a root folder for the
business workspaces” in OpenText Content Server User Online Help -
Business Workspaces (LLESCWS-H-UGD).
• If you want users to save emails to a specific regular folder or Email
folder, select Save emails to the following workspace folder. You can
use this option if, for example, you want users to save emails to a
specific folder that has the same name in each business workspace.
If you select this option, in the associated box, you must specify the
name of the folder to which users will save the emails. You must also
create an instance of the folder in each business workspace that users
can access in Content Server.
By default, this option is selected, and users can use search forms to search for
business workspaces. You can specify which search forms are available in the
add-in. For more information, see “Creating search forms for the add-in”
on page 207.
When this option is cleared, the Custom search button is hidden from the add-
in and users can search for business workspaces only by name and type.
6. Optional In the Single Sign-on area, clear Enable if you do not want the add-in to
use single sign-on (SSO) authentication to access Content Server. By default, this
option is selected and SSO authentication is used.
You must configure your environment for SSO authentication. For more
information, see Section 5.17.5 “Configuring your environment for SSO
authentication” in OpenText Business Workspaces - Configuration Guide (CSCWS-
CGD). If your environment is not configured for SSO authentication, users will
still be able to sign in, although the sign-in time will be delayed.
7. In the Trusted Exchange Servers area, specify the name of each Exchange
Server system that will be used to save emails. Users will be permitted to save
emails only from the Exchange Server systems you add to this list.
You must specify each Exchange Server name on a separate line. By default, the
Office 365 Exchange Server name, outlook.office365.com, appears in the list.
In this example, users can browse to and select any folder in which to save
emails. The Save icon appears whenever users place their pointer on any folder
in any business workspace.
Folders to create
Any number of regular folders or Email folders in each business
workspace.
Folders to create
An Email folder in each business workspace. Each folder can have a
different name in each business workspace. Make sure that each folder you
create is the first Email folder that appears alphabetically in each business
workspace.
In this example, users can expand business workspaces to browse the folder
structure; however, they are permitted to save emails only to Email folders. The
Save icon appears whenever users place their pointer on an Email folder. The
Save icon does not appear when users place their pointer on regular folders.
Folders to create
Any number of Email folders in each business workspace.
Folders to create
An instance of a regular folder called Folder1 in each business workspace.
Email saving options to configure
1. Clear the Allow users to expand workspaces and browse workspace
folders option.
2. Select Save emails to a pre-configured folder.
3. Select Save emails to the following workspace folder, and then specify
Folder1 as the name of the folder to which users can save emails.
Folders to create
You do not need to create any folders. You need to designate the
workspace root folder. For more information, see Section 1.11 “Creating a
root folder for the business workspaces” in OpenText Content Server User
Online Help - Business Workspaces (LLESCWS-H-UGD).
Email saving options to configure
1. Clear the Allow users to expand workspaces and browse workspace
folders option.
2. Select Save emails to a pre-configured folder.
3. Select Save emails to the workspace root folder.
Whenever a user opens the add-in to save an email, the add-in performs the
following steps to determine which business workspaces to display in the Suggested
workspaces list:
1. The add-in uses the rules you configured to search for business workspaces
based on whether the email that is open contains a specific term or pattern in one
of its properties, for example, its subject line.
2. The add-in uses the email search settings you configured to search for business
workspaces containing emails that have the same sender and similar recipients
as the email that is open.
3. After performing both search processes, the add-in assigns the numeric weight
values that are specified within the rules and email search settings to each
business workspace. An overall weight value is calculated for each business
workspace based on the combined results of both search processes.
The business workspaces that have the highest overall weight values are then
displayed in the Suggested workspaces list. By default, up to five business
workspaces can appear in the list.
For more information about how the add-in performs each of these steps, see
“Understanding how rules and email search settings are applied” on page 214.
23.21.4.1 Understanding how rules and email search settings are applied
You can configure rules and email search settings on the Suggested Workspaces
Configuration page in the Business Workspaces volume. For more information, see
“Configuring Rules and Email Search Settings” on page 217.
Whenever a user opens the add-in to save an email, the following actions take place:
1. The add-in uses each rule that you configured to search for business workspaces.
When a rule is applied, the following actions take place:
a. The add-in uses the Matching Condition pattern and email property
specified within the rule to determine whether to apply the rule to the email
that is open. Specifically, the add-in checks whether the email property in the
opened email contains the pattern.
b. If the email that is open contains that pattern, the add-in searches for
business workspaces based on the Workspace Type value and Extraction
Term pattern specified within the rule.
The add-in uses the Extraction Term pattern to extract a value from the
email property you specified within the rule, and then uses the extracted
value to search for business workspaces by name.
Example: If you select Order as the Workspace Type value, and if the Extraction
Term pattern extracts 1234 from the email property, the add-in retrieves all business
workspaces that have the type Order, and have names that contain 1234.
d. The add-in assigns a numeric weight value to each business workspace that
is retrieved. These weight values are added to the overall weight value of
each business workspace.
By default, the Default Weight value specified on the Workspace Rules tab
is assigned to each business workspace that is retrieved.
Example: If the Default Weight value is set to 20, a value of 20 is assigned to the
overall weight value of each business workspace that is retrieved.
However, if a Weight value is specified within the rule itself, the Weight
value overrides the Default Weight value.
Example: If you set the Weight value to 100, but set the Default Weight value to 20,
a weight value of 100 is assigned to each business workspace that is retrieved by that
rule specifically.
2. The add-in then uses email search settings you configured to search for relevant
emails. The following actions take place:
a. The add-in searches within all business workspaces to find previously stored
emails that contain the same sender or similar recipients as the email that is
open. In the email search settings, you can specify whether the add-in
performs searches based on the sender, recipients, or both.
Example: If you configured the add-in to perform searches based on both the sender
and recipients, and if the email that is open lists jdoe@domain.com as the sender
and jsmith@domain.com as a recipient, all previously stored emails that list
jdoe@domain.com as the sender or jsmith@domain.com as a recipient are
returned in the search results.
b. When such emails are found, the emails are sorted based on the Sort Emails
by option specified in the email search settings. For example, you can sort
the emails based on their last modified dates.
c. The add-in retrieves emails from the top of the sorted set. The add-in
retrieves a maximum of 50 emails and any emails that appear after the first
50 emails are excluded from the set of retrieved emails.
d. The add-in assigns a numeric weight value to each business workspace that
contains emails that were retrieved in the previous step. The weight values
are assigned based on the number of retrieved emails that each business
workspace contains.
These weight values are added to the overall weight value of each business
workspace and are calculated using the Weight of each Email value
specified in the email search settings.
Example: If the Weight of each Email value is set to 5, and a business workspace
contains 3 of the retrieved emails, a value of 15 is added to that business workspace’s
overall weight value.
3. To calculate an overall weight value for each business workspace, the add-in
uses the weight values that are assigned as a result of applying the rules and
searching for emails.
Example: If a business workspace is assigned a value of 20 after the rules are applied and
a value of 15 after the email search takes place, that business workspace’s overall weight
value is 35.
4. The business workspaces that have the highest overall weight values are then
displayed in the Suggested workspaces list.
Tips
• For more information about rules and email search settings, see “Testing
your rules and email search settings” on page 217.
• For more information about creating regular expressions, see https://
regex101.com/.
If a user opens an email that has this type of subject line in Outlook, the Business
Workspaces Outlook add-in automatically applies a default rule to determine which
business workspaces to display in the Suggested workspaces list. Specifically, the
add-in uses both the workspace type name and workspace name from the subject
The add-in assigns a numeric value of 30 to each business workspace that is found,
and then displays the relevant business workspaces in the Suggested workspaces
list.
If you configure rules and email search settings, the default rule is applied in
conjunction with the configured rules and email search settings.
You must first configure and save the rules and email search settings you want to
test on the Workspace Rules and Email Search tabs on the Suggested Workspaces
Configuration page. On the Test tab, you can then specify the properties to include
in a simulated email you want to test.
When you run the test, the add-in applies the rules and email search settings you
configured to the simulated email and displays the actions that would occur if a user
were to open an email containing the properties you specified. For example, the test
results show which values would be extracted from email properties and which
values would be used to search for emails and business workspaces when specific
rules are used.
If the test does not produce the intended results, you can edit the rules and email
search settings and run the test again. You can also run the test with different
simulated email properties.
1. On the global menu, click Enterprise > Business Workspaces, and then click
Outlook Add-in Configuration.
2. Click Suggested Workspaces Configuration.
3. On the General tab, configure the following options, as needed:
a. Optional Select the Show Suggested Workspaces Section option if you want
to display the Suggested workspaces list in the Business Workspaces
Outlook add-in. Clear this option to hide the list from the add-in. By
default, this option is selected.
a. Select the Default Weight value you want to assign to each business
workspace that is found by any of the rules you configure. By default, this
value is added to the overall weight value of each business workspace that
is found by a rule.
b. Optional If you want to configure a rule, in the Rules area, click Add a Rule,
and then configure the following settings.
• Subject: allows the add-in to search for patterns within the subject
line of the opened email.
• Sender: allows the add-in to search for patterns within the Sender
field of the opened email.
• To: allows the add-in to search for patterns within the To field of
the opened email.
• Cc: allows the add-in to search for patterns within the Cc field of
the opened email.
Note: You can specify only one capturing group within the
regular expression. If you specify multiple capturing groups,
only the first capturing group is used to extract the value
from the email property.
v. In the Weight field, if needed, select the weight value you want to
assign when business workspaces are retrieved by this rule
specifically. This value is added to the overall weight value of each
business workspace that is found by this rule.
By default, this value is set to Default, meaning that the value that is
selected in the Default Weight list in Step 4.a is assigned to business
workspaces that are found by this rule. If you select a value other than
Default, the Weight value overrides the Default Weight value.
c. Click OK.
Note: Clicking OK adds the rule to the rules list; however, the rule is
not saved until you click Save Changes or Apply.
d. You can now configure additional rules, as needed, by following the steps
in Step 4.b.
Once you are finished configuring your rules, you will see the rules list.
The rules are sorted by weight and then by name. Rules are applied in the
order they are listed.
Tip: In the rules list, you can click the Edit button to edit a rule, or
the Delete button to delete a rule. You can also enable or disable a
rule by selecting or clearing its check box in the Enabled column.
a. In the Sort Emails by field, select one of the following options to specify
how to sort the emails that are returned in the search results:
• Last modified date: sorts the emails by the last modified date in
descending order.
• Relevance: sorts the emails according to the relevance rules that are
defined in Content Server. For more information about relevance rules,
see the Content Server Administration Online Help.
The Sort Emails by option specifies which emails are retrieved if more than
50 emails are returned in the search results. The add-in retrieves only the
first 50 emails from the search results and excludes all emails that appear
after the first 50 emails. If more than 50 emails are returned in the search,
the sort order specifies which emails are included in the set of retrieved
emails and which emails are excluded from that set.
b. In the Weight of Each Email field, if needed, specify a numeric value that is
added to the overall weight value of a business workspace whenever an
email is found by the search. By default, the weight value is set to 1;
however, you can specify any positive integer.
For example, if the Weight of Each Email value is set to 5, and if 3 emails
are found in a business workspace, a value of 15 is added to that business
workspace’s overall weight value.
c. Optional Select Search Email Sender if you want to allow the add-in to find
previously saved emails that have the same sender as the email that is
open.
d. Optional Select Search Email Recipients if you want to allow the add-in to
find previously saved emails that include similar recipients as the email
that is open.
6. Click Save Changes to save the rules and search settings and return to the
Outlook Add-in Configuration folder.
Tip: You can also click Apply to save the rules and search settings without
leaving the page.
1. On the Test tab, in the Outlook User area, specify an Outlook email address to
represent the user who saves emails in Outlook.
2. In the Email Properties area, specify one or more email property values to
include in the simulated email you want to test.
• Sender: specify the email address of the sender to include in the simulated
email.
• To: specify one or more email addresses to include as the recipient in the
simulated email.
• Cc: specify one or more email addresses to include as additional recipients in
the simulated email.
• Subject: specify a phrase or term to include in the subject line of the
simulated email.
3. Click Test.
When the rule is applied, the add-in searches the subject line of the opened
email for the term customer. If the subject line contains that term, the add-in
uses the extraction term pattern to extract the characters that appear after
customer in the subject line.
For example, if the subject line is customer ABCD, the add-in extracts the value
ABCD. The add-in then retrieves all business workspaces that have the type
Customer and whose names include ABCD.
When the rule is applied, the add-in searches the subject line of the opened
email for the pattern order[\s|-]+\d+, that is, the term order, followed by
one or more spaces or hyphens, followed by one or more numbers. If the
subject line contains this pattern, the add-in uses the extraction term pattern to
extract the numbers that appear after order in the subject line.
For example, if the subject line is order - 1234, the add-in extracts the value
1234. The add-in then retrieves all business workspaces that have the type
Order and whose names include 1234.
When the rule is applied, the add-in searches the Sender field of the opened
email for the pattern equipment_[\d]+@server.com, that is, the term
equipment, followed by an underscore, followed by any combination of
numbers, followed by @server.com. If the Sender field contains this pattern,
the add-in uses the extraction term pattern to extract the numbers that appear
between equipment_ and @server.com.
2. In the Extractable Email Fields area, confirm that the following email fields are
selected:
• OTEmailSenderAddress
• OTEmailRecipientAddress
For more information about configuring security parameters, see the OpenText
Content Server Administration Online Help.
If you are configuring SSO authentication in your environment, you must also add
the URLs of all servers that provide access to Content Server (for example, the
OpenText Directory Services server, ADFS server, and any proxy servers).
3. Click Sites, add the required URLs to the list of trusted web sites, and then close
the Trusted sites dialog box.
4. Click OK.
Frame Embedding
Must be unchecked. You do not want to prevent request handlers from
being embedded in external frames.
• An antivirus application must be able to read files from the file system.
Sometimes, the process of reading the file will “lock” it and prevent other
applications from reading from or writing to the file.
Therefore configure your antivirus software to exclude the <Content_Server_
home> folder and subfolders and the folders that contain the Content Server
search index files.
• When an antivirus application has detected what it believes to be an infected file,
the antivirus application might “quarantine”, which means move and restrict
access, the file or delete the file entirely. However, antivirus applications
sometimes identify non-malicious files as a virus. As a result, these files can be
inadvertently deleted or quarantined. When this happens, important files can be
made inaccessible, which can prevent services from running correctly or from
running at all.
OpenText partners have also created modules that can integrate directly with
Content Server and an organization’s existing antivirus solutions to block malware
and viruses from being uploaded to Content Server. To inquire about these
solutions, contact your Customer Support channel.
For more information, see the “Best Practices: Content Server Application Security
Hardening Guide” in OpenText My Support (https://knowledge.opentext.com/
knowledge/llisapi.dll/Overview/65175979).
You can make business workspaces and business attachments available for users in
SAP GUI via Generic Object Services (GOS). The user can then create workspaces,
display existing ones and display, create and delete business attachments in SAP
GUI. For this, you customize the GOS table.
Tip: For a detailed description of the Business Content window, see Section 8
“Working with the Business Content window” in OpenText Archiving and
Document Access for SAP Solutions - User Guide (ER-UGD).
1. Start the SM30 transaction, and then enter SGOSATTR in the Table/View field.
Click Maintain.
3. Customize the new entry according to the following list. The OTX_ATTACH
service displays the Business Content window: business workspaces, business
attachments and business documents (ArchiveLink documents). From the
Business Content window, users can access the complete functionality.
Name of service
Enter OTX_ATTACH.
Description
Provide a description, for example, Business Content. This description is
displayed in the GOS menu.
Quick Info
Provide a quick info, for example, Business Content. This information is
displayed for the icon.
4. You must define the position of the new service in the General Object Services.
In the Next service field, enter the name of the service that should follow after
this service. If the service is the last, leave the field empty.
Important
If you do not define the position correctly, it might not be displayed at all.
• You want to add the new service at the beginning of the existing services:
Enter the name of the first existing service in the Next service field of the
new service.
• You want to add the new service at the end of the existing services: Enter the
name of the new service in the Next service field of the last existing service.
Leave the Next service field of the new service empty.
• You want to add the new service in between the existing services: Enter the
name of the new service in the Next service field of the predecessor of
existing services. Enter the name of the successor existing service in the Next
service field of the new services.
5. Click Save.
Note: For more information about maintaining the SGOSATTR table, see the SAP
documentation (https://www.sdn.sap.com/irj/scn/index?rid=/library/uuid/
a0139058-ef9d-2b10-598c-9e23dc6f44fc).
For problems when displaying services in GOS, see SAP Note 961713 -
Structure of table SGOSATTR.
1. In the IMG, navigate to the Extended ECM > Business Content Window >
Maintain Business Content Window Display Options, and then click
Execute.
2. Click New Entries.
3. Select a business object type and then select the options that you want to be
displayed:
• Full page: Uses the whole Business Content window to display the business
workspace in Smart View
• Bus. Wrks: Display a node for the business workspace
• Wrks thumbs: Business workspace thumbnails
• Drag Drop: Enable Drag and Drop in business workspaces
• Attachment: Display a node business attachments
• Documents: Display a node for business documents
• Doc. thumb: Display thumbnails for business documents
• Notes: Display a node for notes
• Files: Display a node for local files
Tip: For general settings of the Business Content window, which are also
placed in this dialog, see “Enabling the integration widget in the Business
Content window” on page 233.
• Remove Content Server menu entries that are not relevant and add specific menu
items that are available on Content Server, for example when a new module was
installed. The added menu items are displayed in the context menu only if they
are available for the item type. For more information, see “Customizing the
Business Content window context menu with Content Server menu entries”
on page 231.
• In addition to the available Content Server menu entries, you can add new
entries and implement custom functionality. For more information, see “Adding
custom functionality to the Business Content window context menu”
on page 232.
Note: The customizing applies only to Content Server Classic View. It does not
apply if the integration widget is used as described in “Enabling the
integration widget in the Business Content window” on page 233.
1. In the IMG, navigate to the Extended ECM > Business Content Window >
Maintain Business Content Window Menu, and then click Execute.
Code ID
Enter the code ID. Use the F4 help to retrieve the code ID.
BROWSE Open
COPY Copy
DELETE Delete
DOWNLOAD Download
FETCH Open
MAKEFAVORI Add to Favorites
TE
MOVE Move
PRINT Print
TEXTEDIT Edit
Add/Remove
Click Add or Remove. When you add an entry, it is added according to the
sequence in the Content Server menu. You cannot add already existing
entries.
Description
Enter a description. This description is displayed in the context menu. You
can use && to display the & character.
If you want to add the entry in other languages, use the standard SAP
mechanism clicking Goto > Translation.
Example: In the following example, the new menu item Zip & Download is added to
the menu.
1. In the IMG, navigate to the Extended ECM > Business Content Window >
Implement Business Content Window Menu BAdI, and then click Execute.
2. Implement your code. For detailed information, see the sample code provided
with the BAdI definition (menu Goto > Sample Code > Display).
To copy files, users can drag between different nodes in the Business Content
window. To download files, they drag a file to the Local Files node.
For this functionality, users must have the S_GUI authorization object with the
ACTVT=60 parameter. This authorization object is part of the /OTX/RM_USER role.
Important
If you want to use the integration widget and if you use Content Server on
Microsoft IIS, you must configure detailed errors messages on local and remote
requests. For more information, see “Configuring Microsoft IIS to return
meaningful REST API error messages” on page 234.
1. In the IMG, navigate to the Extended ECM > Maintain Business Object
Declarations activity, and then select Use Widgets for UI for the business
objects for which you want to enable the integration widget in Business Content
window, Web Dynpro or CRM UI.
For more information about the activity, see Section 3.4 “Creating a business
object declaration in SAP” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
2. Optional To define the theme, in the IMG, navigate to the Extended ECM >
Business Content Window > Maintain Business Content Window Display
Options, and then click Execute.
Note: You can now use the new belize theme for the integration
widget integration. However it is currently not recommended for
page view.
Tip: For more customizing options for the Business Content window, see
“Selecting items to be displayed in Business Content window” on page 230.
Example: With Detailed errors enabled, IIS returns a message similar to An item with the
name <filename.txt> already exists, but if Detailed errors is not enabled, IIS returns
only Error: Bad Request (400).
2. On the left, expand the Content Server website, and click the Content Server
Application.
5. On the right, under Actions, click Edit Feature Settings On the Edit Error
Pages Settings, enable Detailed errors in the Error Responses section, and then
click OK.
All Content Server items that can be targets for a copy/move operation are
maintained in the /OTX/RM_STWL table. This table is part of Extended ECM for SAP
Solutions and it is filled with a predefined set of subtypes. The new table /OTX/RM_
STWL_C is available to maintain new entries.
Important
As soon as /OTX/RM_STWL_C has one entry, the /OTX/RM_STWL is not used
anymore. If you intend to use /OTX/RM_STWL_C, you must copy the entries of /
OTX/RM_STWL into the custom table.
1. Copy all entries from the /OTX/RM_STWL table to the Subtype column of the /
OTX/RM_STWL_C table.
• Conn. ID: Connection ID. You find this information in the IMG > OpenText
Extended ECM for SAP Solutions > Infrastructure > Maintain Extended
2. Find the relevant role and add the J_6NRL_LFS authorization object.
Security settings – When a user accesses a local folder from the Business Content
window, an SAP security alert informs the user about the risk. Users can confirm the
message per access attempt or they can set the security options for their client.
• If you want to use OpenText Viewing or Intelligent Viewing, enable this viewer
in Content Server Administration. For more information, see Section 2
“Configuring OpenText Viewing” in OpenText Content Server Admin Online Help -
Viewing and Transformation Administration (LLESVWX-H-AGD).
• If you want to use one of these viewers, define the relevant settings in Content
Server Administration.
• Configure the mime types. For more information, see Section 12.9 “Customizing
MIME types for preview” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
• Configure the viewer settings in the SAP system. For more information, see
Section 17.2 “Configuration for Web Viewer” in OpenText Archiving and Document
Access for SAP Solutions - Scenario Guide (ER-CCS).
2. In the Document Function section, for the Open function, select Disabled.
Note: If you do not want to disable the Open document function on Content
Server, the FETCH function will be used instead of the defined VIEWDOC function
when users double-click a document in Business Content window. You can
circumvent this by defining a description that is alphabetically before the
description of the FETCH action, for example FETCH with description Open and
VIEWDOC with description Display.
The /OTX/RM_GOS_DD table keeps a default list of MIME types for which Internet
Explorer add-ons enable an in-place rendition. If this list is not sufficient, you can
maintain a custom list in the /OTX/RM_GOS_DD_C table.
Important
Also add the MIME types from /OTX/RM_GOS_DD if you want to keep the
behavior of these MIME types as well.
Restrictions Web Viewer can only render documents that are archived to an OpenText archive.
For example, if you want to display a Microsoft Word document, Internet Explorer
starts Microsoft Word, but leaves an empty browser window open.
Important
Also add the MIME types from /OTX/RM_GOS_DD if you want to keep the
behavior of these MIME types as well.
Note: This customizing step is not necessary if you are using Business Content
window. For more information, see “Customizing the Generic Object Services
(SAP GUI)” on page 227.
With business functions, you integrate the following into the GOS Attachment list:
Business functions
• /OTX/RM_BF_GOS_ATTACHMENT
Integrates Records Management functions into the GOS Attachment list.
• /OTX/RM_DOL_BF_GOS_ATT_LIST
Integrates business attachments into the GOS Attachment list.
• /OTX/RM_BF_DISP_PRINTLIST
Integrates Records Management functionality into the OADR and OADD
transactions.
1. In the IMG, navigate to the Extended ECM > Activate Business Functions
activity and click Execute.
To display the old business object type configuration from the SAP system:
For information about the new business object type configuration, see Section
3.17 “Configuring business object types” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).
5. To display the old field mapping for authorization based on category IDs,
navigate to Workspace Authorization > Field Mapping and enter &show_
legacy_on.
Restriction If either SSO cannot be achieved in your server and desktop environment or the
when SSO is option Suppress Sending SAP Logon Ticket is turned on in the connection ID
not enabled
configuration (see “Maintaining Extended ECM connections” on page 152), the
Extended ECM for SAP Solutions functionality is restricted as follows:
• The interactive declare dialog will not allow selecting RSI, categories and cross
references. See Section 6.1.8 “SAP: Assigning a document declaration to a
business object and a document type” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).
• In some cases the user gets a logon screen when accessing Content Server
functionality.
For the caller dialog, the logon screen appears only once, as long as an SAP GUI
session or the SAP Logon application is open. For the Content Server popup
dialog, a logon is always necessary unless an instance of the Web browser has
been open since the latest logon.
Tip: In order to avoid that the user must log in every time a Content Server
dialog pops up under Microsoft Windows, keep an instance of Microsoft
Internet Explorer open.
In order to avoid that the cookie expires and a logon screen is displayed, you can
switch off cookie expiration in the Content Server security settings.
Note: This viewer is not enabled by default. Before you can enable this viewer,
download and install the Brava! Server Components package, which can be
found on My Support. For more information, see OpenText Brava! - Server
Components for Content Suite Viewer Admin Guide (CLBRVW-ICS).
3. In the Viewer Server URL section, type the URL to the Brava! Server in the
following format:
http://<computer_name>:<port number>, where <computer_name> is the
name of the computer where the Brava! Server Components package is
installed, and <port number> is the port number specified for the Brava! Server
Components.
Important
You can run the infrastructure diagnostic program after specifying at least the
Extended ECM connection in the Infrastructure section of the IMG.
• The Infrastructure part is for technical consultants who set up the connection
between the SAP system and the OpenText servers. The report contains the
following types of information: the connection to Content Server, Web service
communication such as logical ports, the OTDS service or HTML controls.
• The Extended ECM part contains the infrastructure information in addition to
information about the customizing, like business object declarations, document
declarations, or item types.
This information only displays if you start the activity from OpenText Extended
ECM for SAP Solutions > Extended ECM > Diagnostic Program.
A green light icon indicates that everything is in order. For checks with a red light
icon, a recommendation is displayed. For more information about each check, see
“Understanding the details of the Diagnostic Program” on page 246.
Note: You can also run the Diagnostic Program as a background job.
3. Click Execute.
If both Content Server and the SAP system are upgraded to 16.2.10, Enterprise
Library is not used anymore and therefore not mentioned in the Diagnostic
Program. This is also indicated by a positive test “Does the REST API replace the
Enterprise Library web service?” in the Service Communication section. For test
entries regarding the Enterprise Library, see a previous version of this guide, for
example Section 23.1.2 “Understanding the details of the Diagnostic Program” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK160209-CGD).
1. In the IMG, navigate to the Extended ECM > Configuration Report activity,
and then click Execute .
The report opens. You can use standard SAP functions to view details, browse
the report, or filter separate lists in the report.
2. To save the report to a local file in, for example in HTML format or as a
spreadsheet, click Local file ..., and select the format that you want.
All errors that occur during document declaration in batch mode are stored. Also
update declaration errors are tracked. The error queue then allows reprocessing the
entries that failed. Errors that occur during the processing of the asynchronous
queue can be monitored there. They are not logged in an error queue. For more
information about the asynchronous queue, see Section 3.24 “Creating business
workspaces and declaring document asynchronously” in OpenText Extended ECM for
SAP Solutions - Customizing Guide (ERLK-CGD).
a. If you want to first have a look at the error entries and afterwards re-
process these entries, select the Process records in manual mode check box
and specify the maximum number of entries in the Hit restriction field.
b. Click Execute.
The Error Queue Management dialog displays the selected entries. In this
manual mode, the number of hits is restricted to the value specified before.
d. Click Yes.
A result list of the re-processed ArchiveLink entries is displayed.
e. To view the SAP log of the error that caused the entry in the error queue,
click the number in the Log number column.
To open the print list record error queue (SAP ERP 6.0 only):
3. You may process the records either in the manual or in the automatic mode:
Proceed as described under Step 3 on page 248 or Step 4 on page 249,
respectively.
3. You may process the records either in the manual or in the automatic mode:
Proceed as described under Step 3 on page 248 or Step 4 on page 249,
respectively.
4. To view the SAP log of the error that caused the entry in the error queue, click
the number in the Log number column.
3. You may process the records either in the manual or in the automatic mode:
Proceed as described under Step 3 on page 248 or Step 4 on page 249,
respectively.
4. To view the SAP log of the error that caused the entry in the error queue, click
the number in the Log number column.
The application object for Extended ECM for SAP Solutions is /OTX/RM.
Note: There are no additional objects or subobjects for an SAP SRM system.
2. Enter the application object /OTX/RM in the Object field and specify additional
parameters as required. Use a subobject to filter the log.
3. Click Execute.
4. Select a log entry, and then click Technical Information to display the
entry's technical context information.
In an error situation with a specific ArchiveLink entry, you can view the
property values Client, Object Type, and SAP object ID.
5. Click Detailed Information to show the calls stack where the error or
warning occurred. Expand the selected log entry to get more detailed
information.
SAP system
Content Server
System Report: Section 25.2 “Understanding the Content Server System Report”
in OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD)
Contains the complete configuration information of the Content Server system.
Look for the “Extended ECM Information” section.
OpenText Administration Client
You can generate a report for OpenText Archive Center, which provides
information for the ArchiveLink setup in SAP (OAC0 transaction).
3. In the Reports pane, open the Scenarios tab and select the scenario.
4. In the Actions pane, click Generate Report. A new window opens, which
you can close.
1. From the web administration menu, under the Info heading, click System
Status.
You can export and import a OpenText Extended ECM for SAP Solutions
configuration with the standard functions of Content Server Transport Warehouse.
This helps you moving an existing configuration from one Content Server
installation to another, for example if you are using development, test and
production systems.
Between versions 10.5.1 and 16.2.6, OpenText Extended ECM for SAP Solutions used
a custom transport mechanism, which was gradually replaced by Content Server
Transport Warehouse. You can still import transport files from versions prior to
16.2.6 but you cannot export configurations anymore. In addition, you could migrate
the business object type configuration from a 10.5 SAP system to a 10.5.1 Content
Server.
• The import evaluates Content Server nodes like folders, classifications and
categories as they are used in the configuration of business object type,
workspace type and unique names by the name they had in the source system. If
a node with the same name exists in the target system, it is used, otherwise a
warning is issued. If more than one node with the same path is found, the first
one is used and a warning is issued. You can change the node on the preview
page.
• The import checks the usage of categories with attributes and attribute sets for
location and sub location path in workspace type and external document storage,
RM Classification, classification and multilingual names. If it is not correct a
warning is issued. Additionally, if the category does not contain the used
attributes or attribute sets a warning is issued.
• To transport the configuration from the Extended ECM SAP side version 10.5
to Content Server 10.5.1 – When a transport file from the SAP Configuration
Export Report /OTX/RM_EXPORT_BUS_O is imported, the property usages
including the property modifier in location, sub location path of workspace type
and multilingual names are substituted by their corresponding category attribute
according to the property mappings in the transport file. If there is no mapping
or if there are multiple mappings, a warning is issued.
• If the transport file contains names for multilingual names in languages that are
not enabled in the target system, a warning is issued. The name is imported, but
it cannot be seen in the workspace type configuration as long as the language is
not enabled. If you change the workspace type before the language has been
enabled, this name is removed from the configuration.
• To find out whether a workspace type in the transport file must be created or
updated, workspace types are searched by their name given in the transport file.
If no business object type can be found, a new type is created. If there is no name
for a workspace type in the transport file, which is the case for an export from an
SAP system, but the workspace type is associated to a business object type in the
target system, this workspace type is used.
• To find out whether a business object type in the transport file must be created or
updated, business object types are searched by their name, and also by the
combination of business object type/business application. If no business object
type can be found that way, a new type is created. If different types are found,
the import is rejected with the message Different Object Types found ….
• If workspace types are used in the Related Items sidebar widget and they are not
exported to the same file, these workspace types are also searched by their
names. You can change the found type on the preview page. This is also done if
only business object types are exported and imported but not their associated
workspace types.
3. Select the transport file from your local file system. If you want to use the
transport file that is stored in your personal workspace, you must first
download it.
4. Click Preview. The transport file is checked and you can preview everything
that is going to be imported and where. Errors and warnings are also displayed.
ID Mapping
Contains all node IDs that have been found in the transport file, for example
for classifications, or for categories that are used for the location or the
workspace name. If the target system contains nodes with the same name as
the source system, they prefilled with that suggestion. You can change the
node.
Workspace Types, Business Object Types, Unique Names, Variable
Definitions
If workspace types, business object types, unique names and variable
definitions are part of the export, they are listed in these sections. You can
see what data is being imported, if workspace types or business object types
are created or updated.
a. Click Select to map another node. These settings are buffered and used
when you refresh the preview or start the import. Alternatively, edit the
transport file and save it.
b. Click Preview to read the new changes into the preview.
6. When you are satisfied with the import preview, click Import.
A result page informs you in detail about what has been imported.
This part explains how you can remove Extended ECM for SAP Solutions and undo
related customizing.
You remove Extended ECM for SAP Solutions with the same tool that you use to
install, the SAP Add-On Installation Tool (SAINT).
SAINT shows a new tab for uninstallable components. Before the actual removal,
you must perform mandatory steps. This varies according to your system. There
may also be optional steps, which you can perform to completely clean your system
from Extended ECM remnants.
You need not undo customizing in the Extended ECM for SAP Solutions component
itself, for example, deleting business object types. These will be deleted with the
component’s removal.
Customizing for Extended ECM for SAP Solutionsdone in the SAP system outside
the component itself, need to be undone manually, for example, service entries in
table SGOSATTR related to Extended ECM for SAP Solutions only.
You must apply this note BEFORE you start uninstalling OTEXRL.
Perform the following steps before you uninstall. Otherwise, the uninstallation will
not run or the SAP system will have issues after you removed the component.
For more information, see “Assigning SAP roles” on page 122 and “Providing
access to local folders for the Business Content window” on page 236.
Remove custom code depending on Extended ECM code
Custom code includes the following:
• Generated Mass creation reports. For more information, see Section 24.2
“SAP: Creating or updating business workspaces using batch operations” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
• Business Workspace Mass creation jobs. For more information, see Section
24.2 “SAP: Creating or updating business workspaces using batch
operations” in OpenText Extended ECM for SAP Solutions - Customizing Guide
(ERLK-CGD).
• Document Declaration creation jobs. For more information, see Section 24.4
“SAP: Declaring ArchiveLink documents using batch operations” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
• Remove Deleted Records job. For more information, see Section 24.8 “SAP:
Scheduling jobs for removing deleted records” in OpenText Extended ECM for
SAP Solutions - Customizing Guide (ERLK-CGD).
• Delete the asynchronous queue job. For more information, see Section 3.24.2
“Setting queue properties” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
Note: Before you delete an event, make sure that it is not used for any other
purpose than Extended ECM.
You must perform these mandatory steps before the uninstalling the OTEXRLE
component. Otherwise uninstalling process will not run or the SAP system will have
issues after you removed the component.
• DMS Document Declaration creation job. For more information, see Section
24.5 “SAP: Declaring SAP DMS documents using batch operations” in
OpenText Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
• Any other job using Extended ECM ERP Reports.
Remove Event Type Linkages using Extended ECM ERP function modules
Use the SWETYPV transaction. For more information, see Section 6.2.2.6 “SAP:
Linking events to a receiver function module” in OpenText Extended ECM for
SAP Solutions - Customizing Guide (ERLK-CGD).
Remove Extended ECM ERP Roles
Use PFCG transaction to remove the /OTX/RMERP_DMS_TECH_USER_ROLE from all
users. For more information, see Section 6.2.3.2 “SAP: Creating a technical user
and a technical user role” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
Remove custom code depending on Extended ECM code
Custom code includes the following:
For more information, see Section 6.2.3 “Creating a technical user” in OpenText
Extended ECM for SAP Solutions - Customizing Guide (ERLK-CGD).
Important
You must perform these mandatory steps before uninstalling the OTEXRLC
component, otherwise the CRM Web UI will not work correctly anymore.
The following uses the CRM object Business Partner BP_HEAD to explain how you
remove enhancements.
Important
You must repeat this procedure for all other enhancements that you created.
For more information, see Section 15.1 “Customizing the integration into SAP
CRM Web Client UI or S/4CRM” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
1. Start the BSP_WD_CMPWB transaction, and then open the BP_HEAD component
with the enhancement set.
b. In the following pop-up window, select all rows and delete them, for
example Custom Controller, Controller Implementation, and Context.
3. Remove Workspace and Business Reference Assignment Blocks from the View
Set Configuration.
a. In the Runtime Repository Editor, click View Sets > ViewSet BP_HEAD,
for example.
b. Open the Configuration tab, and then double-click Edit.
c. Move the following Extended ECM Assignment Blocks to the left list of
Available Assignment Blocks:
• /OTX/RMCRM_GS_ECMLK/WrkSpceWindow
• /OTX/RMCRM_GS_ECMLK/BusRefWindow
The following uses the CRM component IUICOVW to explain how you remove
enhancements.
Important
You must repeat this procedure for all other enhancements that you created.
For more information, see Section 15.2 “Customizing the integration into SAP
CRM Interaction Center Web Client UI” in OpenText Extended ECM for SAP
Solutions - Customizing Guide (ERLK-CGD).
1. Start the BSP_WD_CMPWB transaction, and then open the IUICOVW component
with the enhancement set.
b. In the following pop-up window, select all rows and delete them, for
example Custom Controller, Controller Implementation, and Context.
b. In the following pop-up window, select all rows and delete them, for
example Controller, View, View Controller Implementation, and Context.
Deleting the integration into SAP CRM Web Client email screen
You must remove all enhancements that you implemented for the integration into
CRM Web Client email screen.
To delete the integration into SAP CRM Web Client email screen:
1. Start the BSP_WD_CMPWB transaction and open the BT126H_MAIL component with
the enhancement set.
b. In the following pop-up window, select all rows and delete them, for
example Controller, View, View Controller Implementation, and Context.
To delete the integration into SAP CRM Web Client email screen:
b. In the following pop-up window, select all rows and delete them, for
example Controller, View, View Controller Implementation, and Context.
• If the backend on which you plan to do the uninstallation of OTEXRLO is the last
backend providing data for /OTX/RM_WSC_ODATA_SRV to your Fiori frontend
system, then please make sure to also remove all Extended ECM applications on
the frontend system. See next section about OTEXRLF for details.
Remove alias assignments, services and ICF nodes on the frontend system:
i. Delete or deactivate its ICF node. There is a manage ICF Node menu
for the service. Or you may search in transaction SICF for <default_
host>/sap/opu/odata/otx/rm_wsc_odata_srv
ii. Delete the service from the list.
f. Optional If you do not have another need for the system alias, you can
remove it in transaction /UI2/GW_SYS_ALIAS.
2. If service /OTX/RM_WSC_ODATA_SRV has no aliases assigned or has been deleted
completely, make sure that there is no active Fiori app running on the frontend
system, which uses the Fiori app of OTEXRLF.
• Identify and delete Extended ECM related applications both cross-client and
client-specific on the frontend system.
• Clean-up roles on the frontend.
• Remove alias assignments, services and nodes of the OData service /OTX/
RM_WSC_ODATA_SRV. For more information, see “Remove alias assignments,
services and ICF nodes on the frontend system:“ on page 278.
1. Find a Business Object Browsing Fiori app based on OpenText Business Center.
On the SAP backend system on which the Business Center configuration is
maintained, search for entries of database table /OTX/PF62_T_PERV with
column BSP_APPL containing a pattern *OTX/RMF*. This leads you to the
perspective IDs, which are integrating Extended ECM apps. You have the
following options.
Use the perspective maintenance of Business Center to remove the usage of
Extended ECM perspective views.
If specific target mappings exist on the frontend system, deleted the mappings
with the Fiori Launchpad Designer.
2. Find an Extended ECM app. On the frontend system, run transaction /UI2/
FLIA to open the Fiori Launchpad Intent Analysis. Find intents, which use
pattern */otx/rmf* in column Launchpad Application.
3. Find custom apps, which are extended with Extended ECM app. Run
transaction /UI2/FLIA to open the Fiori Launchpad Intent Analysis. Identify
custom Fiori apps, which integrated Extended ECM controls by code extension.
Make sure that you are deleting only apps, which you do not need anymore.
You must perform these mandatory steps before the uninstalling the OTEXRLSA
component. Otherwise uninstalling process will not run or the SAP system will have
issues after you removed the component.
Remove event type linkages using Extended ECM Business Scenarios function
modules
Use the SWETYPV transaction. For more information, see:
• Use the PFCG to remove the following authorization objects from custom created
roles/profiles for DocuLink, Archiving, and Licensing:
• Delete all custom implementations and objects, which refer to data dictionary
objects delivered by Add-On OTEXBAS.
– Remove the storage tables for the ArchiveLink attributes, which make use of
data elements, domains or structures of OTEXBAS.
○ If no data records in those tables are required anymore, you can delete the
tables.
○ If you still require the data, please replace any references to OpenText
data dictionary objects with other objects accordingly.
• Remove the customizing of the Generic Object Services in the table SGOSATTR .
You must remove entries for DocuLink or DesktopLink. Adapt the Next service
field of predecessor entry of removed entry to point to the following entry if any.
– Section 20.2 “Customizing the Business Content window in the GOS menu”
in OpenText Archiving and Document Access for SAP Solutions - Scenario Guide
(ER-CCS)
• DocuLink – Delete all generated programs. For more information, see Section
25.1 “Administrating (deleting) generated programs” in OpenText DocuLink for
SAP Solutions - Customizing and Administration Guide (DC-CGD).
• If you do not have any movable data of SAP Records Management, you can
remove some predefined element types. For more information, see Section 13.3.1
“Providing element types in the SAP NetWeaver Folders Management system”
in OpenText Archiving and Document Access for SAP Solutions - Scenario Guide (ER-
CCS).
Run the SRMREGEDIT transaction. Delete the following nodes:
S_AREA_RMS > /IXOS/RM_SP620_DC > /IXOS/SRM_SPS_CUSTOMER
If you integrated DocuLink views into the IC Web client, undo the customizing in
reverse order to delete any customizing from the IC WebClient:
• Section 18.3.1.3 “Adapting the navigation bar profile” in OpenText DocuLink for
SAP Solutions - Customizing and Administration Guide (DC-CGD)
• Section 18.3.1.2 “Configuring the transaction launcher” in OpenText DocuLink for
SAP Solutions - Customizing and Administration Guide (DC-CGD)
• Section 18.3.1.1 “Creating a transaction launcher URL” in OpenText DocuLink for
SAP Solutions - Customizing and Administration Guide (DC-CGD)
If the SAP CRM system has an upgrade history starting from old CRM 5.0 and using
OTEXBAS 10.0 or lower in its past, there may still be residuals of old customizing of
the IC Win Client integration. Undo the customizing of the 10.0 version in reverse
order:
Note: The following links point to the 10.0 version of OpenText DocuLink for
SAP Solutions - Customizing and Administration Guide (DC100000-CGD).
• Section 19.3.1.4 “Adapting the CIC profile” in OpenText DocuLink for SAP
Solutions - Customizing and Administration Guide (DC100000-CGD)
To clean up the Fiori backend and frontend systems, you reverse the customizing
you did before. For more information, see .
• Remove alias assignments, services and nodes of the OData service /OTX/ALDS_
ODATA_SRV on the frontend system.
• If the backend, on which you plan to remove OTEXBASO, is the last backend
providing data for /OTX/ALDS_ODATA_SRV to your Fiori frontend system, remove
all Extended ECM for SAP Solutions applications on the frontend system. For
more information, see “Archiving and Document Access Fiori Apps component
OTEXBASF” on page 285.
Remove alias assignments, services and ICF nodes on the frontend system:
i. Delete or deactivate its ICF node. There is a manage ICF Node menu
for the service. Or you may search in transaction SICF for <default_
host>/sap/opu/odata/otx/rm_wsc_odata_srv
ii. Delete the service from the list.
f. Optional If you do not have another need for the system alias, you can
remove it in transaction /UI2/GW_SYS_ALIAS.
To clean up the Fiori backend and frontend systems, you reverse the customizing
you did before. For more information, see Section 14 “Integrating Extended ECM for
SAP Solutions into SAP Fiori apps” in OpenText Extended ECM for SAP Solutions -
Customizing Guide (ERLK-CGD).
• Identify and delete applications related to Extended ECM for SAP Solutions both
cross-client and client-specific on the frontend system.
• Clean-up roles on the frontend system.
• See in previous section, the manual steps before uninstalling of component
OTEXBASO, how to remove alias assignments, services and nodes of the OData
service /OTX/ALDS_ODATA_SRV.
1. Find a Business Object Browsing Fiori app based on OpenText Business Center.
On the SAP backend on which the Business Center configuration is maintained,
search for entries of database table /OTX/PF62_T_PERV with column BSP_APPL
containing a pattern *OTX/ALF*. This leads to the perspective ID’s integrating
Archiving and Document Access apps. You have the following options:
Use the perspective maintenance of Business Center to remove the usage of
Archiving and Document Access perspective views.
If specific target mappings exist on the frontend, delete the mappings with the
Fiori Launchpad Designer.
2. Find a Archiving and Document Access app. On the frontend system,
run /UI2/FLIA to open the Fiori Launchpad Intent Analysis. Find intents,
which use pattern */otx/alf*, or have the value for test launcher = /sap/bc/
ui5_ui5/otx/rmf_launch in column Launchpad Application.
3. Find custom apps, which are extended with Archiving and Document Access
app. Run transaction /UI2/FLIA to open the Fiori Launchpad Intent Analysis.
Identify custom Fiori apps, which integrated Archiving and document Access
controls by code extension.
Make sure that you are deleting only apps, which you do not need anymore.
2. Find the Archiving and Document Access application, and drag it to the recycle
bin icon, which occurs once you start dragging.
2. Find all roles that you created for Archiving and Document Access.
You use the SAINT transaction for the removal. You can first use it in test mode to
simulate an uninstallation process before you actually run it.
3. Click Confirm.
4. Perform the uninstallation. If it reports errors, you can view error logs, continue
or roll back.
5. Clear the Test option if the test mode did not report errors.
3. Click Start.
This part provides additional information about the components and architecture of
Extended ECM for SAP Solutions.
The core of Extended ECM for SAP Solutions is the combination of the two major
components OpenText Content Server (Content Server) and OpenText Archive
Center (Archive Center).
Content Server is tightly integrated with Archive Center. All content managed by
Content Server can be stored in Archive Center, which is mainly an abstraction layer
to the underlying storage hardware.
• Document Management
• Records Management
• Content-centric Workflow
• Collaboration
The components of Extended ECM for SAP Solutions are deployed in three ways:
– Content Server
Content Server provides the core document management, search, records
management, collaboration, and workflow capabilities of Extended ECM for
SAP Solutions.
– Archive Center
Interface and abstraction layer for the storage layer. It is responsible for the
long-term preservation of content.
• Components running in SAP Business Suite, for example the following:
Note: This overview does not cover the optional components AppWorks
Gateway and Content Server mobile app.
This chapter shows some typical deployment scenarios. For detailed information
and other possible deployment scenarios with Content Server, see Section 1.2
“Common deployments” in OpenText Enterprise Library - Installation and Upgrade
Guide (EL-IGD) or Section 2 “Design Your Content Server System” in OpenText
Content Server - Installation Guide (LLESCOR-IGD).
All-in-one scenario
In an all-in-one scenario, all components are deployed on one server. This scenario is
primarily intended for demonstration and testing.
All-in-one server
SAP ERP Archive Center
Development system Directory Services
Content Server
OpenText ABAP Add-ons Database
Document Pipelines
Distributed scenario
In a distributed scenario, Archive Center and all web services are installed on one
computer and are connected to one or more Content Server installations.
Each Content Server computer can host one or more Content Server instances.
Multiple frontend servers are deployed with a load-balancer to provide highly
available end-user services.
The Service Provider Interface (SPI) is required to access business information that is
available in the leading application, for example, SAP ERP or SAP CRM, from
Content Server. To access Content Server from the external system, you use the
Extended ECM web services. A detailed description of SPI and the API is available
on OpenText My Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/
44140285).
Legend:
Extended ECM for SAP Solutions OpenText component
SAP component
R R
R
R
RFC HTTP R
HTTP (Content Server UI)
R
R R
R
R HTTP (SAP UI) Document HTTP
HTTP
Pipeline
RFC R
HTTP AppWorks
HTTP
SAP R/3 (ERP, CRM, SRM)
R Gateway
R
Event Tomcat
Workflow ArchiveLink
Archive Center
Remote Cache
BAdI Imaging Web Server
R Document Storage
Fiori Business R R R
The following communication protocols are used between the systems and
components:
– between the SAP add-on Extended ECM for SAP Solutions and the Business
Workspaces module on Content Server via the Extended ECM Web service
(API)
– between the Business Workspaces module and the SAP add-on Extended
ECM for SAP Solutions (SPI)
– between the SAP add-on Extended ECM for SAP Solutions and Directory
Services (API)
– only for versions 16.2.10 or earlier: between the SAP add-on Extended ECM
for SAP Solutions and Enterprise Library Services (API)
• OLE for communication between SAP GUI
– between SAP system using SAP ILM and Extended ECM (WebDAV)
• HTTP(S)
The methods simulate a transactional behavior. The API supports placing more than
one workspace creation/update request at the same time. In that case the request are
bundled and handled in a transactional manner, meaning if one creation fails in a
bundle, the other eventually created workspaces are also not visible until the failure
is corrected. Note that this behavior is only valid if you use the corresponding
asynchronous read method to get information about a workspace. For more
information, see the SDK Guide on OpenText My Support (https://
knowledge.opentext.com/knowledge/cs.dll/Open/63007681).
attribute
Content Server concept to store metadata. Attributes are organized in categories.
Business properties of a business object are mapped to attributes.
BAdI
business object
Representation of a “real-life” object in the business application. This can be, for
example, a business partner, a service process, or a product. Business objects are
the center point of Extended ECM.
Business Workspaces
Content Server core module that enables the use of business workspaces with or
without a connection to a business application.
business attachment
Content Server item, for example a document or a folder, that is added as a link to
the business workspace of a business object. The item, which is used as business
attachment elsewhere, is indicated by an icon and has a link to the respective
business object. The other way around, you can configure a business object type,
so that it can be added to a Content Server item.
business workspace
Content Server item that contains documents and other items which are related to
a business object.
category
Content Server concept to store metadata. A category contains attributes or
attribute sets. A category can be mapped to store metadata delivered from the
business application.
Classic UI
Classic View
Content Server user interface with folders, function menus and sidebars. As
opposed to Content Server Smart View.
See also: Smart UI
classification
Classifications are used to categorize Content Server items, for example,
documents, compound documents, and folders into a taxonomy of Classifications
called Classification Trees. For business workspaces, classifications control what
kind of business workspace can be created in a certain folder.
declaration
document declaration
Definition of how a document is to be stored in Archive Center via ArchiveLink.
document metadata
Describes the document and its business context. Different types of documents
may have different metadata assigned. Metadata can be used to search for a
document.
document properties
Set of attributes that all documents share; for example, the owner of a document
or the creation date.
document templates
Templates for documents with default content and attributes.
See also: workspace templates
GOS
group replacement
Method to dynamically assign access rights for a Content Server item such as a
business workspace or a document to a group of users. The group replacement is
typically based on attributes of the Content Server item.
impersonation
Method in which users of the business application utilize other users to gain
access to Content Server. Impersonation must be implemented according to the
requirements of the business application.
indexing
Process of collecting data about Content Server items so that they can be searched
with Content Server search functionality.
integration widget
Enables an integration method to display Content Server content in HTML-based
application. Content is displayed with JavaScript and HTML5 technology rather
than embedding the classical Content Server user interface.
OSS notes
OTDS
perspective
Controls how users see the layout of a business workspace in Content Server
Smart View. Perspectives consider rules, for example, the workspace type,
template, or the user group. You design and configure a perspective in
Perspective Manager, a tool that walks you through the creation of a perspective
and translates it into ActiveView coding.
Perspective Manager
See: perspective
policies
Method to transfer and apply SAP authorization objects in Content Server.
print lists
Documents that are created by the SAP system and, if necessary, can be processed
automatically. They represent extracts from the SAP data base, compiled
according to specific criteria, and created by reports.
property provider
Program or web service that delivers properties of a business object from the
business application to Content Server.
record
Records Management
relationship
Hierarchical relationship between business objects that are visualized as
relationships between business workspaces. A sidebar widget and Related
Workspaces Folders make related business workspaces visible in Classic View. In
Smart View, a Related Workspaces widget makes related business workspaces
visible. Automatic relationships are defined in the property provider. Users can
establish manual relationships.
RFC service
A program used for communication between the SAP application and the archive
system via RFC (Remote Function Calls).
SAP Notes
Notes provided by SAP that contain post-release changes or corrections for
already released versions of SAP products. When you encounter SAP-specific
problems or false behavior in SAP programs, especially after or during a new
installation of product components, check the SAP Support Portal for necessary
SAP notes.
sidebar widget
Element of a business workspace in Classic View that displays various types of
business workspace metadata and information to the end user.
simple search
Saved query and customized search form that can be used to find business
workspaces, cases and binders, and to create shortcuts. Also known as Custom
View Search in Content Server.
Smart UI
Smart View
Content Server user interface with a landing page and container pages. The
content is presented in tiles that contain widgets. The pages are highly
configurable using the Perspective Manager.
SPRO
system attributes
Metadata that all content items have in common, for example item names, creator
of an item, or the modification date.
widget
Element of the user interface that displays information for the user.
workspace reference
Business object that is linked to a business workspace. If the business workspace
already exists, users add the business object as business reference to it.
workspace templates
Templates for new business workspaces with default configuration, folder
structure, and optionally default content. Templates are offered to the user based
on the classification and the storage location of the new document.
workspace type
Content Server object that controls the location where a business workspace is
stored, some of the GUI components such as sidebar widgets, and the name
pattern of the business workspace.