Professional Documents
Culture Documents
Solutions
Customizing Guide
ERLK160206-CGD-EN-03
OpenText™ Extended ECM for SAP® Solutions
Customizing Guide
ERLK160206-CGD-EN-03
Rev.: 2018-Oct-25
This documentation has been created for software version 16.2.6.
It is also valid for subsequent software versions as long as no new document version is shipped with the product or is
published at https://knowledge.opentext.com.
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 .......... 13
1.1 What is new in version 16.2.6 .......................................................... 13
1.2 Related documentation .................................................................... 14
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.
“Integrating Extended ECM for SAP Solutions into SAP Hybris Cloud for
Customer“, page 250
You can now integrate business workspaces in SAP Hybris Cloud for Customer.
Extended ECM provides seamless integration for business objects account, lead,
and business opportunity.
“Creating a search form for business attachments”, page 328
You can now provide saved queries in the business attachment widget. Users can
use these queries and the search form to easily find business attachments.
“Transporting configuration objects“, page 371
You can now transport business object types using the Content Server Transport
Warehouse.
The following documentation is available for Extended ECM for SAP Solutions on
OpenText My Support (https://knowledge.opentext.com/knowledge/llisapi.dll/
Open/10194282):
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) (this
guide)
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 discusses user management and access control scenarios.
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.
Release Notes The Release Notes describe the following aspects in detail:
• The software supported by the product
• Requirements
• Restrictions
• Important dependencies
• Last-minute changes regarding the documentation
• Manual IDs of the current documentation
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).
2.1 Concepts
2.1.1 Business objects
A business object is the representation of a real-life entity in a business application.
For example, a business application for Enterprise Resource Planning (ERP)
maintains business objects for products, orders, deliveries and so forth. Every
business object is defined by a set of attributes and by its relations to other business
objects.
Content is visible in the Documents tab. You can have a dedicated folder structure
for each workspace type.
The layout of this business workspace is defined by a perspective, which you can
design for each business object. A perspective can also be specific to a role or to a
device.
Relationships are created and maintained in the SAP system and transferred to
Content Server through the property provider, thus, additional coding may be
required.
You have customer data in two different SAP systems, in the CRM system
and in the ERP system. You want to create business workspaces for the
customer data. Because the data in both systems is semantically identical,
you only want to create one cross-application business workspace for each
customer that contains the information from both the CRM and the ERP
system.
You have vendor data in two different SAP systems, in the SRM system and
in the ERP system. You want to create business workspaces for the vendor
data. Because the data in both systems is semantically identical, you only
want to create one cross-application business workspace for each vendor
that contains both the information from the SRM system and from the ERP
system.
Composite business workspaces are used for complex business objects in an SAP
system, which contain dependent entities that cannot stand alone. For example, in
the SAP Plant Maintenance module, a task list operation can only exist in the context
of a task list. This mandatory relation can be mirrored by composite business
workspaces where each sub-entity has a separate business workspace inside its parent
business workspace. This feature is recommended for cases where dependent
business objects are involved.
Example: When a business workspace for a maintenance task list is created from SAP side,
either manually or automatically, business workspaces for all operations are created
automatically inside the task list’s business workspace.
Note: For the composite business workspace scenario, you need a property
provider that supports composite business workspaces. For more information,
see the SAP Extended ECM Solution Accelerator for SAP PM which is available
in OpenText My Support (https://knowledge.opentext.com/knowledge/cs.dll/
Open/SAP_PM__Plant_Maintenance__Blueprint).
For more information, see Section 3.24: “Enabling composite business workspaces”
on page 136.
From Content Server perspective, a user adds a business object to an item in Content
Server. Users can then view the business object information in Content Server
without the extra effort of accessing the SAP system and logging on to it.
From the SAP system, the document is a business attachment in the Business Content
window of the business object. SAP user can access the document without leaving
the SAP system.
Your company maintains several different oil pumps. All oil pumps share
the same manual. You store the oil pump manual in Content Server and add
this document as business attachment to the pumps’ business objects.
In Content Server, you see all oil pumps that use this manual. In other
words, you see which business objects are added to this document.
In SAP, you see the manual attached to each pump business object in the
Business Content window.
In Content In Content Server, business objects are displayed in a tab in the properties of
Server Content Server item. With sufficient permissions, you can display the business
object, edit it or remove the link. If available, you can access the related business
workspace.
In SAP GUI, business attachments are displayed in the Business Content window.
Types of creation
On an SAP system, users have different options, depending on the system and the
user interface, for example the Business Content window (Figure 2-5), or a button in
the Web Client UI (Figure 2-6).
Automatic adding is triggered when a certain category attribute has a defined value.
You configure, which attribute triggers the creation, and which attributes determine
the target business object.
The category attribute that triggers the automatic adding must deliver true or
false (Boolean). You can reach that by creating an attribute with type Flag:
Checkbox. This provides the information checked or unchecked. In addition,
another attribute contains the business object ID to which the Content Server item
will be attached to automatically. The business object type is defined in the business
object type configuration where you define the automatic adding.
A Content Server item has got the category that contains both attributes: Attribute
for triggering and attribute with business object key. The automatic attach function
will be executed, if this trigger attribute has got the value true or checked. This
Content Server item is now automatically attached to the business object instance
that was defined by ID & type.
For more information, see “Content Server: Configuring the automatic adding of
business objects” on page 166.
Print lists are generated by reports in the SAP system. They can be archived using
the standard ArchiveLink functionality.
Note: If you plan to make documents and print lists available in business
workspaces, you also must configure the system for the use of business
workspaces before you can configure document declarations. For more
information, see section 24.12 “Preparing document declaration” in OpenText
Extended ECM for SAP Solutions - Installation and Upgrade Guide (ERLK-IGD) and
“Configuring business workspaces“ on page 39
Records Management
Records Management ensures that content is under a formal program that provides
consistent control and lifecycle management rules. This includes capabilities to
define content retention policies in addition to formalizing the procedures to classify
(ensuring appropriate metadata), retain, destroy or archive content in Extended
ECM for SAP Solutions.
As you add a document to Content Server, the object and its content can be classified
and managed as a record, based on metadata, retention schedule, or vital record
status. In addition, administrators can set up the metadata fields desired for
population during record declaration. This can be accomplished through categories
and attributes. Categories and attributes are additional metadata that are applied
based on the specific business needs and processes.
Extended ECM for SAP Solutions allows you to declare an SAP ArchiveLink
document and print lists as records that are under control of Records Management.
The declaration can be performed automatically during document creation or
manually by a user. In addition, an administrator can perform the declaration
procedure in batch mode.
For more details on declaring records in OpenText DocuLink for SAP Solutions, see
OpenText DocuLink for SAP Solutions - User Guide (DC-UGD).
• Folder structure
• Team roles
• Folder permissions
• Categories and attributes
• Group replacements
• Classifications
To help users find sub-items of a business workspace, not just the business
workspace, you index these sub-items with the same metadata as the business
workspace. This setting is located in the workspace type. For more information,
see “Indexing documents and other items with business workspace attributes”
on page 325.
Disable classification inheritance
You can add classifications to the workspace template for various reasons. One
reason is to link workspace type, template and folder and thus identify which
workspace type can be created in a certain folder. You can disable classification
inheritance for these technical classification.
Keep folder names unique within a workspace template
When you are designing more complex folder structures, avoid using the same
folder name in different folder hierarchies. For example, do not create two Email
sub-folders in different folders. While this is still valid, you will run into issues
when creating a Livereport or WebReport against the Email folder. Also when
adding the Email folder to your favorite items, it becomes unclear which folder
you are actually referring to.
You should have a clear picture who needs access to what and what kind of access
before you set up the permissions in Content Server. The permission concept ideally
is simple to implement and simple to maintain. It should follow some basic rules
and ideally does not contain exceptions.
• Define a consistent naming convention for groups and roles.
• Assign permissions to groups and not individual users.
• Permissions on documents are defined by the parent folder. If there is a need to
have documents with different access rights inside one folder, add sub-folders
for each set of permission rights.
• Higher in the folder structure more people have restricted access, lower in a
folder structure less people have access but with more rights. Ideally, end users
should not have Edit permissions, because then it is no longer possible to control
who has which access to documents. This is especially the case for compliant
systems.
• Make the workspace template the only source to determine permissions: Disable
the Merge permission with the target location check box on the Specific tab of
Extended ECM adds the following access control concepts to the standard Content
Server permission concept:
• Group Replacement, which determines access control based on category
attributes. For more information, see “Group Replacement” on page 29.
• Team Roles, which can be individually configured for each business workspace.
For more information, see “Defining team roles and team participants”
on page 101.
You can only use attributes on business workspace level for group replacement
definition.
For more information, see “Defining group replacement settings” on page 104.
Enable indexing
Indexing applies the category attributes of the business workspace to all sub-
items in the business workspace and makes them findable. For more
information, see “Indexing documents and other items with business workspace
attributes” on page 325.
Search in related workspaces
You can enable the search in related workspaces. This extends a search within a
business workspace to all its related workspaces. However, depending on the
complexity of your business relations, this can lead to serious performance loss.
The search follows every configured every relation. So, the more of those related
workspaces exist, the broader will be the search scope and the longer takes the
search result. You should test the performance before your enable the option
Always enabled.
Use fast bulk creation
For the initial load, you can use the fast bulk creation method. This method is
much faster than the standard creation method, but come with restrictions,
regarding the template and structure of the business workspaces. For more
information, see “Create workspaces with fast bulk method” on page 61.
• Use a meaningful grouping criteria and descriptive folder names. Users need
to understand to which folder they have to navigate.
• Keep the number of items on one grouping level manageable, preferably
keep it so low that the folder list does not expand over several pages.
• Although there are no hard limits for how many workspaces can exist in a
single folder, you should ensure that the folder size is not adversely affecting
performance while adding or accessing workspaces. It depends on the
system resources. Storing millions of workspaces inside one single folder
may cause a performance decrease for the workspace creation, and
subsequential higher efforts for database tuning.
• You can avoid performance loss and make better use of different threads, if
you created workspaces in different folders rather than only one.
• While latest Content Server versions have improved the performance for
handling large folders, there are still scenarios where the performance of
large folders have negative impact on system performance. For example,
when pagination is enabled, and if a user wants to access sequential pages
the performance of a very large folders will not be ideal.
You can create your sub-folder structure based on attributes. In the workspace type,
you can create a pattern for the sub-folder name, and it can contain values of an
attribute. For more information, see “Using patterns for the location path ”
on page 73.
If you use a pattern with attributes, you must mind the following:
1. Define an SAP event to the business object, which triggers the workspace
creation. You can, for example use the CREATE event, to create a business
workspace when a business object is created. Extended ECM provides function
modules for this method for use in real-time and in asynchronous mode.
For business objects that have frequent changes, it is probably better to use the
asynchronous receiver function module, whereas business objects, which are
rarely changed, for example business partners, can be updated in real-time. For
more information, see “Configuring events for business workspaces and
business attachments“ on page 169.
2. Plan regular batch reports in the SAP system to create business workspaces
periodically and in bulks.
You can use these two techniques side by side: Create business workspaces for new
business object in off hours to reduce the system workload, and use the CHANGE
event to update changes in the metadata immediately to Content Server.
• If Content Server instances are also used for running agent processes, you
can consider disabling agent processes, especially the distributed agent,
which is used for processing facets and custom columns. To disable the
agent, edit the following section in the opentext.ini file:
[loader]
load=sockserv;agents;notify;wfagent;wrscheduleagent;wrcollectio
nagent
load_daagent=daagent
load_distributedagent=distributedagent
load_relagent=relagent
load_verify=verifyAgent
changed into
[loader]
load=sockserv
#load_daagent=daagent
#load_distributedagent=distributedagent
#load_relagent=relagent
#load_verify=verifyAgent
• Run the scheduled background job for the initial load of business workspaces
• Using the asynchronous queue to create and update business workspaces
• If the workspace creation and update requests are triggered by a SAP event, you
may consider to create a new logical destination with this technical user to
receive the events.
The technical user must have the required SAP roles and Content Server
permissions to create or update business workspaces. Business workspaces that are
created by background jobs with a technical user, will have this user as owner of the
business workspace.
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. In the IMG structure field, open the search help and search for the search term
OpenText*. With this search term, you also find IMG structures for other
OpenText products.
3. Double-click on entry.
5. In the Favorites list, select one entry and click to access the IMG structure.
e. Click Save.
f. Click Continue.
g. Double-click the newly created enhancement ID in the Enhancement ID:
Original list to select it for the Enhancement ID field.
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
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 specifiv business application available, select Default WebService
Adapter.
Licensing Model
Select the licensing model that applies to this connection. Each installed module
with a licensing model contributes to this list.
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
Schema Version
Select the interface version.
User Name
Enter the user that is used to access business object type information in the
business application.
Password
Specify the password of the defined user.
Test Connection
Click Test to perform a connection check to the specified business application.
After a successful check, the message Connection test to <Logical System Name>
was successful is displayed next to the button. The system ID will also be
retrieved and displayed.
Note: You can only test the connection after you have configured the SPI
service in the business application accordingly. For more information, see
section 23.2.4 “Configuring the Service Provider Interface service” in
OpenText Extended ECM for SAP Solutions - Installation and Upgrade Guide
(ERLK-IGD).
System Name
Enter localized names for the business application if required.
This chapter explains how you customize your system so that business workspaces
can be created, manually or automatically.
Connected Workspaces
Specific Functions
Workspace Type Business Object Type
Content Server
SAP
Property
Provider
Note: Other optional steps, like the automatic creation of business workspaces,
are not listed in this short list.
2. SAP IMG - The business object declaration defines an SAP business object for
Extended ECM. Create a business object declaration for a business object type,
and activate it.
For more information, see “Creating a business object declaration in SAP”
on page 44.
3. Content Server - Create a classification and the root folder for business
workspaces.
Requires access rights to the classification volume and to the folder, in which
business workspaces will be created.
For more information, see “Creating a classification for workspace templates
and location” on page 52 and “Creating a root folder for the business
workspaces” on page 53.
4. Content Server - Create categories for the metadata of the SAP business object.
Requires Business Administration Data Policies usage privilege and Category
object privilege.
For more information, see “Creating a category for workspace type and
business object type” on page 50.
6. Content Server - Create a workspace type, which controls the layout of the
business workspaces of this type.
Requires Business Administration Connected Workspaces usage privilege.
For more information, see “Creating a workspace type” on page 55.
7. Content Server - Define the document template for the workspace type. The
workspace template name is what users see in the Add dialog when they create
a new business workspace.
Requires system administrator’s access to define that a template can be created
for the Content Server subtype business workspace (type 848). Requires access
to Document Templates volume to create new templates.
For more information, see “Defining a workspace template” on page 94.
9. Optional SAP IMG - For automatic workspace creation and update when SAP
business objects are created or changed: In the SAP system (IMG), maintain the
receiver modules.
For more information, see “Configuring events for business workspaces and
business attachments“ on page 169.
10. Optional Content Server - Define general access restrictions for workspaces.
For more information, see “Granting usage privileges to users” on page 123
and section 6.1 “Defining general restrictions on Content Server” in OpenText
Extended ECM for SAP Solutions - User Management and Access Control Scenarios
(ERLK-CUM).
12. Optional SAP IMG - Customize the search help in SAP. For more information, see
“Customizing the search help in SAP” on page 126.
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.
• Category Folder
• Category
• Classification
• Custom View
• Appearance
• ActiveView
• LiveReports if you want to configure widgets, which use LiveReports
• WebReports if you want to configure widgets, which use WebReports
Tip: When you create a category for the workspace type, you should use
attributes according to the properties that property provider provides. For
more information, see “Creating a category for workspace type and business
object type” on page 50.
You can use all fields of the reference table as attribute of a workspace.
2. Later, create a category and single-value attributes for the business properties
that you want to use.
3. Later, in the business object type definition, map the business properties to the
created attributes.
2. To enhance the basic metadata, you derive a new class from the default business
property provider class. All the elements needed for this implementation are
collected in the package interfaces of the /OTX/RM package and the /OTX/
RM_WSCI package.
Tip: Property providers for composite business workspaces must also provide the
workspace location for the child business workspaces, which is the location of
the hierarchically closest parent. Any customizing of a static or dynamic
location ID for child business workspaces in the IMG is overruled by the
property provider.
1. In the IMG, navigate to the Extended ECM > Maintain Business Object
Declarations activity and click Execute.
Object Type
Select the business object type for which you want to create the declaration.
Connection ID
Enter the ID of the Enterprise Library that you created during installation.
For more information, see section 23.2.5 “Maintaining Extended ECM
connections” in OpenText Extended ECM for SAP Solutions - Installation and
Upgrade Guide (ERLK-IGD).
Note: You can only use Elementary Search help. Collective search help
is not supported.
Activation
Select the check box to activate the business object declaration.
Important
Only after you activated the declaration, you can continue with the
definition of the business object on Content Server. For more
information, see “Configuring business object types” on page 109.
Tips
• To view a complete business object declaration from versions prior to 10.5,
see section 25.2 “Viewing the old configuration in SAP” in OpenText
Extended ECM for SAP Solutions - Installation and Upgrade Guide (ERLK-IGD).
• If you are migrating from an existing configuration, you can display the old
business object declaration in read-only mode. To show the full business
object declaration, enter &SHOW_LEGACY_ON in the transaction field and
press ENTER. To switch to the current view again, enter &
SHOW_LEGACY_OFF and press ENTER.
The value of the custom attribute to be added is defined as a unique name. This
unique name must be defined in Content Server. For more information about
defining unique names, see “Unique names for Content Server items” on page 194.
Typically, you define at least two conditions to cover all possible values.
Notes
• The conditions are evaluated from top to bottom. The first condition that is
met for a custom property determines the value of the custom property. The
next conditions for the same custom property are not processed anymore.
• The logic of minimum and maximum values follows standard SAP rules:
1. In the IMG, navigate to the Extended ECM > Maintain Business Object
Declarations activity and click Execute.
2. Select a business object declaration from the available list; then double-click
Generic Property Provider Custom Properties in the Dialog Structure area.
Config ID
Enter a numeric ID. The ID defines the order in which the conditions are
processed.
Attribute
Enter the attribute that is used to define the condition.
Operator
Enter the operator. You can use the following operators:
• =, <>, <, <=, >, >= to define a value that is equal, greater or less than the
value defined in the Value / Min Value field.
• Pattern, Not Pattern to define a pattern that is met or is not met, for
example Z* for all entries starting with Z. Use plus + as wildcard for one
character and asterisk * as wildcard for 0 to n characters.
Max Value
Enter a maximum value.
Active
Select to make the condition active.
Custom Property
Enter the name of the custom property, for example TEMPLATE_ID or
LOCATION_ID.
Unique Name
Enter the unique name that you defined. The unique name refers to a
Content Server item. For more information, see “Unique names for Content
Server items” on page 194.
Important
Administrators need Business Administration Connected Workspaces and
Business Administration Extended ECM usage privileges to configure
Extended ECM.
Few tasks require access to the Content Server administration pages, see
“Configuration steps, which need system administrator’s permissions”
on page 41.
The Connected Workspaces volume and the Extended ECM volume are your entry
point to configuration. To access the volumes, on the global menu, click Enterprise >
Connected Workspaces or Enterprise > Extended ECM.
Categories
Requires Business Administration Data Policies usage privilege and Category
object privilege.
“Creating a category for workspace type and business object type”
on page 50
Classifications
“Creating a classification for workspace templates and location” on page 52
Facets
Requires Business Administration Columns and Facets usage privilege and
Column object privilege.
“Smart View: Creating custom columns ” on page 79
Outlook Add-in Configuration
Requires Business Administration Connected Workspaces usage privilege.
“Allowing users to save MS Outlook emails to business workspaces”
on page 142
Perspectives
“Smart View: Creating a perspective with Perspective Manager” on page 80
Saved Queries Volume
Requires Business Administration Connected Workspaces usage privilege.
“Configuring a simple search for Classic View” on page 330
Variables for Replacement Tags
Requires Business Administration Connected Workspaces usage privilege.
“Defining and using variables” on page 105
Workspace types
Requires Business Administration Connected Workspaces usage privilege.
“Creating a workspace type” on page 55
Unique names
Requires Business Administration Extended ECM usage privilege.
“Unique names for Content Server items” on page 194
Attachment Declarations
Requires Business Administration Extended ECM usage privilege.
Not used in Extended ECM for SAP Solutions, instead see “Configuring
document declarations“ on page 183.
Scheduled Processing
Requires Business Administration Extended ECM usage privilege.
“Using scheduled processing “ on page 219
Licensing
Requires Business Administration Extended ECM usage privilege.
Not used in Extended ECM for SAP Solutions, instead see .“Performing license
measurement“ on page 347
Tip: To create a category, you need the Business Administration Data Policies
usage privilege and Category object privilege.
Categories and attributes can be used for the following in the workspace type or the
business object type:
For more information about categories, see the Content Server Administration help.
To create a category:
1. On the global menu, click Enterprise > Connected Workspaces, and then click
Categories.
2. Click Add Item > Category. Define the new category according to your
requirements, and click Add.
a. Click Add Attribute and select an attribute type, usually this is Text: Field
or Text: MultiLine.
Notes
• The attribute type must be the same type as provided by the
property provider.
OpenText recommends that the attribute field length is the same for
both Content Server and the business application.
b. Define the attribute.
OpenText recommends that you use a name similar to the business
property name. You will later map these attributes to the business
properties.
c. Click OK and repeat the steps for all other attributes.
Tip: OpenText recommends that you have an attribute that you can
use to uniquely identify the business workspace, for example an ID.
You can also use the Text:Reference to uniquely identify the
business workspace. For more information, see “Using the Reference
attribute” on page 75.
4. Click Submit.
To create a classification for the folder where the business workspaces are
created:
1. On the global menu, click Enterprise > Connected Workspaces, and then click
Classifications.
2. Open an existing classification tree or create a new one. You can name the
classification tree, for example, Workspace Types. The classification tree must
be set in the Document Template settings. For more information, see
“Configuring document template settings” on page 95.
3. Click Add Item > Classification and define the new classification according to
your requirements. Usually, you create a classification for each workspace type.
For example, customers are classified by their sales districts “South” or “North”.
You can use the sales district attribute to determine if the business workspace is
stored in the South or the North folder. For more information, see “General settings
of a workspace type” on page 58.
1. In Content Server, go to the location where you want to create the root folder
for your business workspaces.
2. Add a new folder and configure it as required: Add a name, description. For
Classic view, you can also select an icon.
3. From the Classifications list, select the classification that you created in
“Creating a classification for workspace templates and location” on page 52.
Important
This classification must be the same for folder and template, which you
will configure in “Defining a workspace template” on page 94.
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.
Note: You can use cross-application business workspaces if you want to display
similar business objects from different business applications in one type of
workspace. For this, you use one workspace type for several business object
types. For example, a person is stored as a customer in Salesforce® and as a
vendor in SAP ERP, both of these roles are displayed in the same workspace
type.
Name
Provide a name for the workspace type. This is an internal name and only
visible for administrators. This field is mandatory.
Workspace Type Names
Add a workspace type name for each language available in Content Server. The
workspace type name can be displayed in the header tile of a business
workspace. Depending on the language users have chosen, they see the
localized workspace type name.
Generate names also for workspaces without business object: Select this
option if you want to use the name pattern also for business workspaces that do
not have a business object, which could provide the metadata for the name
pattern. If you use this option, OpenText recommends that you use mandatory
attributes for the name pattern. So, when creating a workspace, users must
provide metadata required for the name generation.
Workspace Icon
Specify an icon, which is displayed in business workspaces of this type in
Classic View. Click Select Icon to browse the available icons. The icon is visible
to users in the Classic View on business workspaces and their root folder. For
Smart View, you use the Widget Icon.
Widget Icon
Select an icon for widgets. The icon is used in the Header widget, in a Related
Workspaces widget, the Workspaces widget, and in the expanded view of the
Team widget. For more information, see “Widget icon” on page 63.
Perspective Manager
The Perspective Manager is a tool with which you design different layouts. If
you start the Perspective Manager from this link, it opens with a predefined
layout template for business workspace perspectives. You can edit an existing
perspective or create a new one. For more information, see “Smart View:
Creating a perspective with Perspective Manager” on page 80. To use
Perspective Manager in its default version, you need access to ActiveView
Administration > Open the Perspective Manager.
Workspace Copying
Select this option to prevent users from copying business workspaces of this
type.
Workspace Creation Settings
Define the folders under the root folder where business workspaces are created
and stored.
New: You can now use the fast bulk method to create business
workspaces.
• Location
Define the root folder where business workspaces of this type are created
and stored. Root folder and template must have the same classification. Only
business workspaces based on templates with the same classification as the
location can be created in this location. For more information about the root
folder, see “Creating a root folder for the business workspaces” on page 53.
Select one of the following options:
• Content Server Folder
A fixed Content Server folder. Click Select and browse to the Content
Server folder that you created as root folder. All business workspaces are
created in this folder or in subfolders.
• Current Location
The folder in which users create a business workspace. This is the default
option.
• From Business Property
A business property from the business application determines the
location of the business workspace. You must enter the name of the
business property manually. Enter only the name of the business
property without parentheses, for example, CUSTOMER. You can only use
business properties of type Text.
Important
The business workspace is not moved automatically when the
value of the business property, which determines the location, is
changed.
• From Category Attribute
A category attribute determines the location of the business workspace.
Click Select and select a category. Then select an attribute. The attribute
must contain the Content Server node ID of the folder.
The business workspaces are then created in a folder that corresponds to
the attribute.
Important
The business workspace is not moved automatically when the
attribute, which determines the location, is changed.
• Sub Location Path
Create a subfolder structure rather than saving all business workspaces in
one folder. Select From Pattern to enter a pattern for the subfolder creation.
You can use normal text, categories and attributes, business properties, and
modifiers to create subfolders, for example [2032760:Region:(3)]/
[2032760:City:+5].
This option is only available for location options Content Server Folder,
From Category Attribute, From Business Property (with Extended ECM),
but not for option Current Location. For more information, see “Using
patterns for the location path ” on page 73.
Click Insert Attribute to select a category and an attribute.
You can also use multivalue attributes. This creates a folder path in the order
of the values in this mulivalue attribute. Empty values may only be at the
end of the multivalue attribute.
If a sub-location folder does not exist when the business workspace is
created, the folder is created. You must ensure that the category attribute is
never empty, for example by making it mandatory. If all attributes for a sub
location are empty, the business workspace is created in the location folder.
This applies to both single value and multivalue attributes.
• Use also for manual creation
Select this option if you want to use the location settings also for manual
creation of business workspaces. Business workspaces are then only created
in the specified location, regardless of the folder where the user started the
creation. In Classic View, after the business workspace has been created, the
user is directed to the newly created business workspace. In Smart View,
users see a confirmation message. Obviously, this option does not apply if
you chose Current Location for the workspace creation.
For more information about multilingual properties, see the SDK Guide on
OpenText My Support (https://knowledge.opentext.com/knowledge/cs.dll/
Open/63007681).
• Create workspaces with fast bulk method
When creating big number of business workspaces, for example for the initial
load, you can use the fast bulk method. This method creates business
workspaces much faster but has its restrictions:
• Sub-items
A business workspace template can only contain the following items:
• Business workspace
• Folder
• Email-Folder
• Collection
• Nested workspaces
Composite Workspaces and Workspace Hierarchies are not supported
• Node data
Only the following node data is attached:
• Categories and attributes
• Classifications
• Create Audit entry
• Connected Workspaces Roles
• Connected Workspaces Relations
• Custom Columns
• Facets
Other node data are not supported, most notably, Records Management
and Recommender.
Important
Business workspaces are created in batches. If one business
workspace of a batch with fast bulk method fails to be created, the
whole batch call is ended and no business workspace of that batch is
created.
Files must not be larger than 1 MB. For best results, use a square image with the
recommended size of 128x128 pixels.
You can select from sample icons, which are in the following folder on your Content
Server installation: <Content Server Home>\module\otsapxecm_16_2_0\support\
business_object_icons, for example \\mycontentserver\C\OPENTEXT\module
\otsapxecm_16_2_0\support\business_object_icons.
Note: If no icon is configured for the workspace type, a default is taken. Users
with sufficient permissions can change the icon for an individual business
workspace.
Indexing Settings
Select if the category attributes of the business workspace should become
supplementary indexed metadata for child objects and nested business
workspaces. With this option, users can use category attributes in the advanced
search to also find items like documents, emails, folders, or task lists, which are
located in a business workspace. You can select which Content Server object
types will be indexed. Changing this setting takes effect only for documents that
are added after this change. Already existing documents must be re-indexed.
For more information, see “Indexing documents and other items with business
workspace attributes” on page 325.
Sidebar Widgets
Configure sidebar widgets that display metadata in the business workspace in
Classic View. For more information, see “Classic View: Configuring sidebar
widgets” on page 65.
Classification
Optionally, select a classification for this particular workspace type. This
classification is not added to business workspaces and not related to the
classification that links storage location and template.
Records Management
Enable Records Management for the creation of business workspaces. You can
view RM Classification information in the business workspace properties.
Changing this option immediately effects business workspaces of this type.
Roles
Copies all roles from the template and adds the creator of a business workspace
to the Team Lead role.
This option is enabled by default. It is also set for all existing workspace types.
Policies Enabled (SAP integration only)
Specify whether policies apply to the resulting business workspaces. Policies can
be generated from authorizations in the SAP system or possibly other business
applications. For more information, see section 7 “Using SAP authorizations to
restrict workspace access (optional)” in OpenText Extended ECM for SAP Solutions
- User Management and Access Control Scenarios (ERLK-CUM).
Click Select and select a category. Then select an attribute. The attribute
must contain the Content Server node ID of the RM classification.
• Select RM Classification if you want to add one specific RM
classification. Click Select and select the classification.
Note: You must save or apply the settings of the workspace type before you
can configure sidebar widgets.
Tip: You can drag the sidebar widgets configuration to change their order.
Each sidebar widget type requires characteristic configuration parameters. You can
configure each sidebar widget individually. You can also use the same sidebar
widget type several times with a different configuration.
You manage and configure sidebar widgets for each workspace type.
5. To configure each sidebar widget, click Detailed Configuration. For details, see
the following sections.
Attributes
Defines which attributes are displayed. Click Browse Content Server to select
the category; then select the attribute. It depends on the selected category which
attributes are available.
Categories Tab
Defines if a link is displayed in the sidebar widget that opens the Categories tab.
All categories and attributes of the business workspace are displayed on the
Categories tab.
Date to Use
Defines which date field is used to determine if an item is displayed in the list.
You can either use the date when the latest version was added (Version Added)
or the date of the last modification (Modify Date).
Oldest Change
Changes older than the defined number of days are not displayed. If you do not
enter a number, all changes are displayed.
Items to Display
Number of items that you want to be displayed in the list. If the number of
recent changes is higher than what you defined here, only the latest changes are
displayed.
Relationships are defined in the SAP system and delivered by the property provider.
They can also be added manually.
Display Style
Defines if the related items are displayed as list (List) or as tree view (Tree).
Show Ahead
Only work items with a due date before the specified number of days from
today are displayed.
Task Lists
A workflow can be started for the business workspaces and items inside a
business workspace with the function menu entry Initiate Business Workflow.
The sidebar widget displays all tasks in the My Assignments tab of the current
user for these workflows.
Reminders
Displays all follow ups of the current user for any Content Server item in the
business workspace. The follow ups are also displayed in the My Assignments
list of the user. Only reminders with status Active or In Progress are displayed.
Initiated Workflows
Defines if workflow steps related to the business workspace are displayed and if
steps without due date are also displayed.
Personal Assignments
Defines if a link to the personal assignments is displayed. These are all personal
assignments, not only those related to the business workspace.
You can use the multilingual texts option for master data business objects.
Note: For business workspaces without business object types, you can specify
any name here. These workspace types always have the name that the user
entered during creation, independent of the settings you specify here.
You can use the multilingual texts option for master data business objects.
Example: The workspace type for “Equipment” has been configured to display workspace
names in English and French.
Kate has set her preferred metadata language in Content Server to English; she sees the
business workspace for equipment 1000476 under its English name “Equipment Truck 12”.
Monique, whose metadata language is French, sees the same workspace under its French
name “Équipement Camion 12”.
Tip: Users can change their preferred metadata language in Content Server:
Tools > Settings > Metadata Language.
3. Add workspace name patterns for each language in the workspace type
configuration. You can use category ID and attributes, business properties, free
text as well as modifiers for the name pattern.
Important
You must at least enter a pattern for the default language. Other
languages are optional.
4. Generate names also for workspaces without business object: Select this
option if you want to use the name pattern also for business workspaces that do
not have a business object, which could provide the metadata for the name
pattern. If you use this option, OpenText recommends that you use mandatory
attributes for the name pattern. So, when creating a workspace, users must
provide metadata required for the name generation.
Important
• Do not use a colon (“:”) to separate attributes, because the colon is
used in Content Server syntax.
• If one of the attributes in the name pattern for multilingual
workspace names and business object names does not provide a
value, this attribute is omitted without error message.
• Pattern - Material - [123117:Material Description] ([2032760:Id])
• Result - Material - Standard Water Pump SWP123 (00000123)
Offset: +0
Cut off the specified number of characters and displays the rest. Separate the
modifier from the attribute by a colon. An out-of-bound offset causes an error.
Length: (0)
Display the specified number of characters. Separate the modifier from the
attribute by a colon. An out-of-bound length causes an error.
• Pattern - Material - [123117:Material Description:(20)]
([2032760:Id])
• Result - Material - Standard Water Pump (00000123)
Displayed only the first twenty characters of the Material Description.
Combination
Combine all pattern modifiers.
• Pattern - Material - [123117:Material Description:(20)]
([2032760:Id:+4(3)])
• Result - Material - Standard Water Pump (012)
Added the string “Material - ”, displayed only the first twenty characters
of the Material Description, cut off the first four digits of the material ID and
displayed only three, set the material ID in parenthesis.
Important
• Do not use a colon (“:”) to separate attributes, because the colon is used in
Content Server syntax.
• The forward slash (“/”) separates subfolders.
• If one attribute of many attributes used for a subfolder is empty, the
business workspace is not created. Empty attributes can cause an
unwanted location and are therefore handled as error. OpenText
recommends that you define attributes, which are used for the location in
manual creation, as mandatory.
• If a multivalue attribute contains empty values, which are not at the end
of the multivalue attribute, the business workspace is not created. Empty
3. Enter text or syntax elements to form your pattern. The forward slash (“/”) is
used to separate folders.
Tip: You can also use the reference number attribute for a more elaborate
number schema. For more information, see “Using the Reference attribute”
on page 75.
Offset: +0
Cut off the specified number of characters and displays the rest. Separate the
modifier from the attribute by a colon. An out-of-bound offset causes an error.
• Pattern - [2032760:Id:+4]
• Result - 0123
Cut off the first four digits of the ID.
Length: (0)
Display the specified number of characters. Separate the modifier from the
attribute by a colon. An out-of-bound length causes an error.
• Pattern - [123117:Material Description:(20)] ([2032760:Id])
• Result - Standard Water Pump (00000123)
Displayed only the first twenty characters of the Material Description.
Combination
Combine all of those pattern modifiers.
• Pattern - Material/[123117:Material Description:(20)]/
[PRODUCT_YEAR]
• Result path - Material/Standard Water Pump/2017
Added the folder “Material” as root folder, displayed only the first twenty
characters of the Material Description, and displayed the production year
from a business property.
You can also use the reference attribute to create the name. If you use the reference
attribute for the workspace name, you must be aware of the following behavior: If
you change the reference number schema in a category and update all existing
objects with the changed category, only the attribute changes. The generated name
of the business workspace does not change.
Note: You can only have one Text:Reference attribute per category.
Reference [241162:CustomerName]-%fileplan%/%sequence%
schema
Result Brown Lawnmowers-FS01/0015
Variable Description
241162:CustomeName Attribute CustomerName. In this
example, the category has the ID 241164.
%fileplan% Folder name.
%sequence% Serial number. It is formatted as a four-
digit number 000N. In this example, it
creates the number 0015.
1. Open the category that you use for the workspace type.
2. Add the Text:Reference attribute to this category.
• Name: Name as it displays for the user, for example, file number or
reference number.
• Order: Attribute, which precedes the reference attribute in the category.
• Show in Search: Allows users to search based on this attribute.
• Length and Display length: Maximal length of the reference. Consider also
the length of other attributes and variables that you use in the Attribute
number schema.
• Attribute number schema: Define the schema. You can use the following
elements:
Variable Description
%sequence% Consecutive number within the
schema
%parentFileId% Reference of the parent business
workspace
%fileplan% Name of the folder in which the
business workspace is stored
%rm-classification% Name of the RM classification which
the business workspace uses
%a% Abbreviated weekday with three
characters. The characters depend on
the Content Server language settings.
For example, Mon or Tue for English
%b% Abbreviated month name with three
characters. The characters depend on
the Content Server language settings.
For example, Jan or Mar for English
%c% System date
%d% Day in the month with two digits from
01 to 31
%j% Day in the year with three digits from
001 to 366
%m% Month with two digits from 01 to 12
Variable Description
%w% Weekday in one digit from 1 to 7,
where 1 stands for Sunday
%y% Year with two digits. For example, 18
for 2018
%A% Full weekday name. The characters
depend on the Content Server
language settings. For example,
Monday
%B% Full month name. The characters
depend on the Content Server
language settings. For example, March
%H% Hours in two two-digit hours on a 24-
hour clock, from 00 to 23
%I% Hours in two two-digit hours on a 12-
hour clock, from 01 to 12
%p% AM or PM on a 12-hour clock
%M% Minutes in an hour from 00 to 59
%S% Seconds in a minute from 00 to 59
%P% Years marked as AD or BC
%U% Week number in the year, with
Sunday as the first day of the week
%W% Week number in the year, with
Monday as the first day of the week
%Y% Year with four digits. For example
2018
%% A percentage sign
• Attribute number format: Number of digits and leading zeros that are
added to a serial number created with the %sequence% variable. The entry
only adds digits if you use the variable in the Attribute number schema.
4. Click OK.
1. On the global menu, click Enterprise > Connected Workspaces, and then click
Workspace Types.
2. To enable a workspace type, from the function menu, select Enable Creation.
You see the current status of the workspace type in the Creation Status column.
Enabled
This workspace type is available to create new business workspaces.
Disabled
This workspace type is not available to create new business workspaces;
however, this workspace type will be used to display business workspaces
that were already created from this type.
3. To edit an existing workspace type, click the name of the workspace type.
5. To check the indexing status of the items in a business workspace, see the
Indexing Status column:
Re-indexing required
This status always occurs when you change the indexing settings of the
workspace type.
You may see this status even if no workspaces or no sub-items within
workspaces exist yet. When performing the test run and no documents are
found for re-indexing, the status will change again to Indexing is up to
date.
Up to date
All items have been passed to the index engine. However, it may still take
some time until the items are fully processed and searchable.
For more information about indexing, see “Indexing documents and other items
with business workspace attributes” on page 325.
With the installation of Connected Workspaces, the following custom columns have
already been created in the Facets volume in the Workspace Columns folder.
However, they are not prepared for sorting and filtering.
• Workspace Type ID
• Workspace Name in each language that is configured on Content Server, for
example Workspace Name en.
If you added another language after installation of Connected Workspaces, you
must create the respective column manually and prepare it for sorting and
filtering.
Tip: To create custom columns, you need the Business Administration Facets
and Columns usage privilege and Column object privilege.
Example: The collapsed view of the Workspaces widget displays the workspace name only.
The expanded view of the same widget displays columns for workspace name, creation date
and owner. It is sorted by creation date.
The workspace name is a default custom column, which is created during installation.
Custom columns for creation date and owner must be created.
1. On the global menu, click Enterprise > Connected Workspaces, and then click
Facets. Then navigate to a folder, where you want to store your custom
columns.
2. Click Add Item > Column.
3. Add a name and, optionally, a description.
4. Select a Data Source from the list of available category attributes. Each attribute
can only be used once in a custom column. If an attribute is already used as data
source for a custom column, it is not displayed anymore.
6. Wait for the column to be built. To monitor the status, select Properties >
Specific from the function menu.
7. Smart View: From the function menu of the custom column, select Properties >
Workspace. Then select Used for Sorting and Filtering. When you click Update
the database index is created concurrently, which may take a few minutes.
After the database index has been created, the custom column can be used for
filtering and sorting.
Notes
For more information about custom columns, see the Content Server help.
Note: System administrator rights are required for this task. Please ask
OpenText Professional Services for assistance.
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.
• The perspective takes effect immediately. So if you need testing, create
the perspective on a test system first.
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
metadata language installed on Content Server.
1. On the global menu, click Enterprise > Connected Workspaces, and then click
Workspace Types and open a workspace type.
4. On the General tab, click Create new and enter a title for the perspective.
5. On the Rules tab, you create logical rules, which control when the perspective is
used. The workspace type from which you called Perspective Manager is the
first rule. You must not remove this rule but you can add others.
6. 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 Connected Workspaces.
• The working area in the middle is where you place the widgets.
• The options pane on the right displays configuration options of the selected
widget.
7. Click Code Editor to edit the ActiveView code directly. However, this option is
only for advanced users who are familiar with ActiveView.
Important
Changes in the ActiveView code are not visible in the Perspective
Manager when you return to the design mode. You must save and
reload the perspective first.
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 3.6 “Creating an activity manager
object for the Activity Feed” in OpenText
Connected 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.
Property Description
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.
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.
Property Description
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 3.5
“Creating custom columns for Content
Server Smart View search and widgets” in
OpenText Connected Workspaces -
Configuration Guide (CSCWS-CGD).
Related workspace title Name of the related workspace. You can
use 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.
Related workspaces description Description of the related workspace. You
can use 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.
Property Description
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.
Custom columns Custom columns to be displayed in the
expanded view. Select a custom column,
then click Add to array. You can drag the
columns to change the order.
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.
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.
Property Description
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,
then click Add to array. You can drag the
columns to change the order.
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.
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
displays the dropbox.
Hide metadata Provides an option for users to hide
metadata of documents. The default settings
displays the metadata.
Hide empty fields Hide metadata fields that contain no data.
The default settings displays empty
metadata fields.
Workspace Properties
Property Description
Title Name of the business workspace, prefilled
with the {name} 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.
Click Add Attribute to Field and select attributes from the categories that
contain information for this business workspace.
Metadata settings
Property Description
Hide metadata Provides an option for users to hide
metadata of documents. The default settings
displays the metadata.
Hide empty fields Hide metadata fields that contain no data.
The default settings displays 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.
• 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.
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.
If you want to also monitor attribute changes, you must create an activity manager
object. An activity manager object is linked to one category attribute. When the
value of the attribute changes, it creates an activity, which is then shown in the
Activity Feed widget.
Note: System administrator rights are required for this task. Please ask
OpenText Professional Services for assistance.
Example: You add the category attribute Amount of a Sales Order to an activity manager
object. When the amount changes, it is displayed in the Activity Feed.
For detailed information about the activity manager object and Pulse, see the online
help for Content Server Pulse.
Notes
• Each activity manager evaluates its rules by the order in which they are
listed.
• The Activity Feed message supports localization and starts with a default
activity string message. Optionally, you can customize the activity string
with substitution placeholders for the attribute value.
Tip: To create activity manager objects, you need the Business Administration
Facets and Columns usage privilege and Activity Manager object privilege.
To enable activity monitoring with Content Server Pulse, you need access to
the Content Server administration pages.
2. From the Select Object Types to Manage list, select the Business Workspace
object type and click the Add Object Type button .
4. Click Update.
1. From the global menu bar, select Tools > Facets Volume.
2. Optional Create a folder for the activity manager objects.
3. Click Add Item and select Activity Manager.
4. Enter at least a name and select a category attribute as data source.
5. Click Add.
5. Edit the list of Included Object Types. Remove object types that you do not
want to monitor.
6. Click Submit.
Tips
• For more information about Content Server Document Templates, see
section “Document Templates Volume Administration” in the Content
Server online help.
• Classic View: You may also add a Related Business Workspaces folder to
the template. This type of folder is used to display business workspaces that
are related, for example a customer workspace is related to business
workspaces for all its sales orders. For more information, see “Displaying
related business workspaces in a folder” on page 106.
2. In the Managed object types section, click Configure and select at least the
Business Workspace (subtype 848) item.
3. For the Classification tree for document types, select a classification tree for
business workspaces. For more information, see “Creating a classification for
workspace templates and location” on page 52.
4. Set the other options as required. For more information, see the Content Server
online help for that page.
Note: If the Business Workspace option is not available, you must enable
it. For more information, see “Configuring document template settings”
on page 95.
Tips
• Typically, you create a template for each workspace type.
• You may define several templates for the same workspace type but
with differences in their attributes. For example, you can have
Customers with a revenue larger than one million Euros and Customers with
a revenue of less than one million Euros represented in business
workspaces based on different templates.
Alternatively, you can copy an existing template. Select the template and click
Copy. In the Copy To field, enter a location within the Document Templates
Volume. Then configure the new template according to your requirements. You
must create the copy only within the Documents Templates Volume, though,
and not in the Enterprise workspace.
Important
When you copy a folder that contains a workspace template, the
workspace template is not copied.
Important
Users will see the name of the template in the Add menu of Content
Server Smart UI when they create a business workspace in Content
Server, for example Add > Customer or Add > Material.
4. From the Classifications list, select the same classification that you selected for
business workspace location. For more information, see “Creating a root folder
for the business workspaces” on page 53.
Important
The workspace template and the business workspace location must have
the same classification.
5. Select a Workspace Type from the list.
6. Click Add.
7. Configure the template as required.
In addition to the standard Content Server settings like classification and
permissions you can also configure the following:
9. To test the configuration, open the location folder, which is configured for this
template. The Add dialog now contains an option with the template name.
Important
Changes to the workspace template are not applied to existing workspaces
that have already been created from the template. They apply only to
business workspaces that will be created after you made the changes.
Tip: If you want to organize your templates in folders, you can move them.
You can move them within the Document Templates volume but not to a
folder outside the volume, for example the Enterprise workspace.
Example: In a Human Resources scenario, birth certificate and diploma are required
documents in a personnel business workspace. You create classifications Birth Certificate and
Diploma and assign them to the respective documents when uploaded. You create a
document validation rule that check the existence of one birth certificate in a specific folder.
For a manager level, two diplomas are required, one from high school and one from college,
which you can distinguish using category attributes.
Tip: Extended ECM Platform provides a Header widget for Smart View, which
displays the number of missing documents based on your validation rules.
The Rule expression is evaluated at the time of the document upload. The validity of
a document is based on the mandatory Date of Origin attribute and the
classification assigned during upload. The document is saved to the specified
workspace folder. The Document Type rules are customized in the document
templates.
2. Edit an existing rule or create a new one. To create a new rule below an existing
one, click the Add Classification button .
• Location - from the list, select the workspace folder in which the document
is expected to be available.
• Groups and Roles - click Select to open the Select Roles dialog box.
Select the Grant Access check box for the roles that you want to grant access.
The selected roles are then displayed in the text box.
• Validity (Months) - enter a period in months to determine how long the
document shall be valid.
• Required - Select the check box if the document must be available in the
workspace folder. If the document is not available, a notification about the
missing document is displayed in the header widget of the employee
workspace.
The merging also applies to the items in the template. The permissions are merged
with the permissions of the location where the business workspace is created.
Notes
• If merging is enabled, the owner of the newly created business workspace
will be the one defined for the folder in which the new business workspace is
created. If merging is not enabled, the owner will be the same as the owner
of the template.
Example: User AMILLER creates a new business workspace for a customer using the
Customer template. For the Customer template, user AMILLER only has See access. For the
folder Customer, where the new business workspace is created, user AMILLER also has
Modify access.
If the Merge with creation location option is selected, user AMILLER will have both See and
Modify access. If the Merge with creation location option is not selected, user AMILLER will
have only See access.
1. From the function menu of the workspace template, select Properties > Specific.
Prerequisites You fully configured all workspaces types for what will later be parent workspaces
and child workspaces.
If parent workspace template and child workspace template have differing roles,
you can map a parent role to a child role. The role of the child workspace will then
be replaced by the mapped role of the parent workspace with all the access rights of
the child workspace role. With this mechanism, users with roles of the parent
workspace can access the child workspace even if their specific role was not initially
assigned to the child workspace. On the other hand, members of roles of the child
workspace do not automatically gain access to the respective parent workspace.
With this role mapping, you reduce the number of roles to maintain.
To create a hierarchy:
You can also define d team participants directly in the Team widget of a business
workspace.
Note: You can change team participants for each business workspace
separately.
• Team Roles
You create team roles and assign permissions to them. These team roles become
the defaults for the business workspaces that are created from the templates.
When you add Content Server users or groups as team participants to roles, they
inherit the permissions of the team role.
Special roles
• Template Administrator
1. Switch to Classic View: Click your profile image and click Classic View.
2. From the global menu, select Enterprise > Document Templates and find the
template that you want to edit.
3. From the function menu of the workspace template, select Team Roles and
Permissions.
4. Create a role:
a. On the left side of the page in the Role Access section, click the Add Role
button .
b. On the right side of the page, in the Add new role section, enter a name in
the Role box.
c. Optional Enter a description in the Role Description box.
d. Click Add.
The following handling applies when business workspaces are created and moved:
• Business workspaces are created from templates:
• All team roles and team participants except for the Template Administrator
are copied to the created workspace.
• If the new business workspace is created within a business workspace, the
team roles and team participants that are assigned to the destination are
copied to the created business workspace. This applies only if the merging of
permissions is enabled.
• A business workspace is moved to a destination with team roles, for example
into another business workspace:
• Inherited team roles and permissions are removed.
• Team roles and team participants that are assigned to the new destination, are
copied to the business workspace. This applies only if the Always inherit the
permissions from target destination option is enabled.
• Team roles assigned to the business workspace directly are still there.
• A business workspace is moved to a destination without team roles:
• Inherited team roles and permissions are removed.
• The team roles assigned to the business workspace directly are still there.
The group replacement always applies when one of the attributes that is used to
define the group is changed: when the business workspace is created, when the
attribute of a business workspace is changed later, and when an attribute is filled
manually.
You can also use this mechanism to remove groups. If you define that a group
should be removed, this group has access only to the template and not to the
business workspace based on the template. For a detailed description of the
complete process, see Section 6.2.2.1 “Using generated groups to define permissions
for workspace folders ” in OpenText Extended ECM for SAP Solutions - User
Management and Access Control Scenarios (ERLK-CUM).
Prerequisites
• You use groups to restrict access to the template or parts of it. The groups are
only used for the template.
• You grant the groups direct access instead of adding them as team participants to
a team role.
• If you want to use variables, you have already defined them. For more
information, see “Defining and using variables” on page 105.
• If you want to use a category and an attribute, retrieve their ID.
1. From the function menu of the workspace template, select Properties > Specific.
The Group Replacements section lists all groups that are granted access to the
template or items within the template.
2. To remove the group, select the group name and leave the Target Group field
empty.
When a business workspace is created from this template, the group is removed
and will not be granted access to the created workspace.
3. To generate a group, select the group name. In the Target Group field, add the
name of the group to be generated. You can use the following replacement tags:
The replacement tags are replaced with actual values when a workspace is
created from the template.
To define variables:
3. Enter the name of the variable and the value and save your changes. The name
of a variable must not contain characters from regular expression, for example [
/<>].
4. Click the Add variable button to add a row. Click the Remove variable
button to delete a row.
Example: A customer workspace can have relationships to all sales orders, which this
customer placed. Or a product workspace can have relationships to all customers who bought
this product.
Tip: Alternatively, you can use the Related Items sidebar widget to display
relationships of a business workspace. For more information, see “Related
Items sidebar widget” on page 68.
In the SAP system, you have defined relationships between customers and
products. In the Customer workspace template, you can add a Related
Business Workspaces folder for products and call this folder Products.
Every created customer business workspace then contains a specific
Products folder with links to the related products ordered by this specific
customer.
Prerequisites
• Relationships are defined in the SAP system.
• The property provider for this business object provides the relationships.
• Business workspaces must exist for the related business objects.
Prerequisites
• Relationships between business workspaces are defined in Content Server.
Manual relation- Users can manually create relationships between business workspaces. This option
ships is only available in folders of the type Related Business Workspaces in Classic View.
Manually added relationships always are in child relation to the containing business
workspace. Only manually added relationships can be removed again.
Prerequisites
• Simple Search forms must be set up. For more information, see “Configuring a
simple search for Classic View” on page 330.
• The Related Business Workspaces folder is configured to display child business
workspaces. Only in this case, the Add manual Business Relationships menu
option is available.
3. In the Workspace Types Shown section, you can restrict, which workspace
types are shown. Click Change and select the relevant types. The user of the
business workspace can later change this setting on the Specific tab.
Tip: You can use several Related Business Workspace folders for different
types of related items.
Tip: For more information about the user experience of this search option, see
Section 4.1.4 “Searching related items” in OpenText Extended ECM for SAP
Solutions - User Guide (ERLK-UGD).
• Status
Defines if related workspaces are not followed, always followed, or, if
following workspaces is provided as a selectable option, the user then can
select the Follow Contained Workspaces option in the Search From Here
menu.
• Limit
Sets the maximum number of business workspaces that are searchable. If the
content of the Related Business Workspaces folder exceeds this number, the
business workspaces that have been recently modified are searched first.
2. Find the binder/case template that you want to convert. You cannot convert
templates that contain nested binders or cases.
• Area: Template Workspace Area for which the case or binder template was
available. For more information about areas, see Section 6 “Administering
Template Workspaces Areas” in OpenText Template Workspaces - Installation
and Administration Guide (LLESCSB-IGD).
• Workspace Type Path: Workspace type for the new workspace template
• New Name: Name for the workspace template. You can enter a new name
or leave the suggested name, which has this format: <Name of the binder/
case template> <Name of workspace type selected>.
A new workspace template is created with the settings of the binder or case
template. Permission inheritance is set to Merge With Creation Location if you
did not select any area, or if the respective subtype of the selected area has this
value. For more information, see “Defining permission handling for business
workspace templates” on page 100.
The old template remains unchanged.
Note: You can use cross-application business workspaces if you want to associate
similar business object types from different business applications with one type
of workspace. For this, you use one workspace type for several business object
types. For example, a person is stored as a business partner in SAP SRM and as
a vendor in a different business application, both roles are displayed in the
same workspace type. For more information, see “Cross-application business
workspaces for multiple business objects” on page 19.
3. Click the Add Item button and select Business Object Type.
4. To save the new business object type, you need at least the information
described in “Configuring a basic business object type” on page 111. All other
configuration sections are optional at this point and can be completed later.
Name
Name of the business object type. This is an internal name and only visible to
administrators. OpenText recommends that you use the name under which the
business object is known in the business application. You can also add the name
of the business application.
Business Application
Business Application: Select one of the business applications that is connected
to Content Server. If a connection could be completed, you see a green
checkmark and you can then select the business object type from the business
application.
Tip: You can also create the business object type without connection to the
SAP system. The Extended ECM configuration tries to link to the SAP
system.
Important
You must select a business object that is not already used in a business
object type configuration. Otherwise, you cannot save this business
object type.
Display URL
The URL which displays business object information on the business application
server. For more information, see “Creating the display URL” on page 117.
Tip: You can later change this with an option in the function menu of a
business object type.
Whenever you select the Default Display ... option for a business object type, it
will be removed from other business object types that are linked to the same
workspace type.
Workspace Template
When users create a business workspace from the business application, they
cannot select the document template manually. With these options, you select
the method how the document template is determined:
• Content Server Template: Select the document template that you created for
this business object type from Content Server. For more information, see
“Defining a workspace template” on page 94.
• From Business Property: The business property provides the ID of the
template. This method is used when a dynamic template determination is
needed. To use this method, the property provider must be implemented
accordingly.
You must also map business properties to category attributes. For more information,
see “Mapping business properties to category attributes” on page 114.
• Document Type: Select a document type from the list that displays all
document types configured for the business object in the business
application. A document type may be specified at most once.
• Attachment Declaration: From the list of available attachment declarations
saved in Content Server, select a declaration to map to a document type. An
attachment declaration can be mapped to multiple document types.
Notes
• Map all fields of the business object type that you want to display in
Content Server. Make sure that you also map all fields that are required
for the determination of the workspace name and the location. If you
need attributes for Content Server policies that are generated from SAP
authorizations, you must map them as well. For more information, see
“Mapping authorizations in SAP” on page 124.
• You cannot assign a property group to a simple attribute.
Business Properties
• Business Property: Name of the business property as it is provided by the
property provider. If the SAP System is available, click in the field to get a list
of all business properties of this business object.
• Mapping Method and Category / Attribute
Business Property: Enter the exact name of the business property and the
attribute name.
Category Attribute: Select the category and its attribute from Content Server.
New: You can now use a QR code scanner on mobile devices to open business
workspaces.
Configure Barcode
Select From Category Attribute and provide the respective category and
attribute.
In Perspective Manager, you configure this business object type in the widget with
which users scan the code. For more information, see “Scan barcode widget”
on page 92.
For more information about OpenText™ Content Server Mobile, see OpenText
Content Server Mobile App - Installation Guide (CSMOB-IGD) and OpenText Content
Server Mobile - Configuration Guide (CSMOB-CGD)
3. Select the menu option Disable so that this business object type cannot be used
to create business workspaces, neither can it be used to add business objects to a
Content Server item, regardless of whether the Can be Added as Business
Object option is selected or not.
The business object type will still be available to display previously created
business workspaces or added business objects.
The business object type cannot be used for the search or display of the
corresponding workspace type.
4. To delete a business object type, select the business object type and click the
Delete button .
• For workspace references, this URL is used for the Display button on the
General tab of the business workspace's properties (function menu Properties >
General).
• For added business objects, this URL is used when the user clicks the Display
action of an added business object in the Business Objects tab.
The following sections provide example display URLs for selected business
applications.
$BaseUrl$/sap/bc/gui/sap/its/webgui?
~logingroup=SPACE&~transaction=%2fOTX%2fRM_WSC_START_BO+KEY%3d
$BorObjectId$%3bOBJTYPE%3d$BorObjectName$&~OkCode=ONLI
$BaseUrl$/sap/bc/gui/sap/its/webgui?
~logingroup=SPACE&~transaction=%2fOTX%2fRM_WSC_START_BO+KEY%3d
$attribute:catname=<Cat ID>,attrname=<attribute name>$%3bOBJTYPE
%3d$BorObjectName$&~OkCode=ONLI
<Cat ID> Category ID which you find in the URL of the category in
Content Server: ...&objId=1234567&...
<attribute name> Name of the attribute
<set name> With attributes grouped in a set, you must also use the set
name followed by a colon and the attribute name.
$attribute:catname=<Cat ID>,attrname=<set
name>:<attribute name>$
$BaseUrl$/sap/bc/gui/sap/its/webgui?
~logingroup=SPACE&~transaction=%2fOTX%2fRM_WSC_START_BO+KEY%3d
$attribute:catname=1234567,attrname=LastName$%3bOBJTYPE%3d
$BorObjectName$&~OkCode=ONLI
$BaseUrl$/sap/bc/gui/sap/its/webgui?
~logingroup=SPACE&~transaction=%2fOTX%2fRM_WSC_START_BO+KEY%3d
$attribute:catname=1234567,attrname=Company:Name$%3bOBJTYPE%3d
$BorObjectName$&~OkCode=ONLI
$BaseUrl$/sap/bc/webdynpro/ixos/dcview?
project=ECMLINK_PC&viewid=001&version=01&sap-client=800&sap-
language=EN&SELFIELD1=SF_LIFNR&SELOPTION1=CP&SELSIGN1=I&VALUE_LOW
1=$BorObjectId$&sap-wd-configId=/IXOS/DC_WD_DCVIEW_FULL
To identify the SAP SRM business object, you can use the BorObjectID or a category
attribute. Business partners (BUS1006), however, are handled differently.
The following provides URL templates that you can fill with the values from the
table below.
$BaseUrl$/sap/bc/bsp/sap/crm_ui_start/default.htm?crm-object-
type=<Object Type>
&crm-object-action=B&crm-object-value=$BorObjectId$
Substitute <Object Type> with values from the respective column in “CRM business
objects that are supported by Extended ECM” on page 289.
$BaseUrl$/sap/bc/bsp/sap/crm_ui_start/default.htm?crm-object-
type=BT111_OPPT
&crm-object-action=B
&crm-object-value=$BorObjectId$
Example URL for Business Partner displayed for Business Role “Sales
Professional”
$BaseUrl$/sap/bc/bsp/sap/crm_ui_start/default.htm?crm-object-
type=BP_ACCOUNT
&crm-object-action=B&crm-object-value=$BorObjectId$
&crm-object-keyname=PARTNER&saprole=SALESPRO
$BaseUrl$/sap/public/byd/runtime?bo_ns=http://sap.com/
thingTypes&bo=COD_GENERIC
&node=Root&operation=OnExtInspect¶m.InternalID=$BorObjectId
$¶m.Type=<item type>
More information about the URL and a list of item types, see Predetermining URLs
for Direct Navigation (https://help.sap.com/viewer/
cea15f900ca04c4faa35d3044577fe27/1802/en-US/
186e89d9763d1014b759b19d50be576b.html) in the SAP Hybris Cloud for Customer
Administrator Guide.
The Lead business object is not yet mentioned in the official list, though.
Alternatively, you can also use the GUID. To do so, however, the GUID must be
stored in a category attribute. For more information, see the SAP Hybris Cloud for
Customer Administrator Guide linked above.
$BaseUrl$/sap/public/byd/runtime?bo_ns=http://sap.com/
thingTypes&bo=COD_GENERIC
&node=Root&operation=OnExtInspect¶m.InternalID=$BorObjectId
$¶m.Type=COD_ACCOUNT_TT
$BaseUrl$/sap/public/byd/runtime?bo_ns=http://sap.com/thingTypes&
bo=COD_GENERIC&node=Root&operation=OnExtInspect¶m.InternalID=
$BorObjectId$¶m.Type=COD_OPPORTUNITY_THINGTYPE
$BaseUrl$/sap/public/byd/runtime?bo_ns=http://sap.com/
thingTypes&bo=COD_GENERIC&
node=Root&operation=OnExtInspect¶m.InternalID=$BorObjectId
$¶m.Type=COD_SRQ_AGENT_TT
$BaseUrl$/sap/bc/ui5_ui5/ui2/ushell/shells/abap/FioriLaunchpad.html?
sap-client=<client>
&sap-language=<language>#<semantic object>-<action>
&/newdetail/SalesOrders(\'$attribute:catname=<category
name>,attrname=<attribute name>
$BaseUrl$/sap/bc/ui5_ui5/ui2/ushell/shells/abap/
FioriLaunchpad.html?sap-client=100
&sap-language=EN#<Semantic Object>-Action
&/newdetail/
SalesOrders(\'$attribute:catname=6377616,attrname=Sales Order ID
$\')/$attribute:catname=6377616,attrname=Customer ID
$/$attribute:catname=6377616,attrname=Ship To$/1000/10/00
Note: This sample URL contains line breaks for better readability.
For more information, see “Integrating Extended ECM for SAP Solutions into
SAP Fiori apps“ on page 259.
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).
Important
The Content Server category attributes used for policies must be defined in
the metadata mapping configuration.
For information about the complete configuration, see Section 7 “Using SAP
authorizations to restrict workspace access (optional)” in OpenText Extended ECM for
SAP Solutions - User Management and Access Control Scenarios (ERLK-CUM).
1. In the IMG, navigate to the Extended ECM > Maintain Business Object
Declarations activity and click Execute.
2. Select a business object declaration from the list and double-click Workspace
Authorization.
3. Click New Entries and provide the following information:
4. Select the entry from the list of available authorizations and double-click Field
Mapping.
Object Type
SAP business object type related to the workspace.
Object
Authorization object in SAP which is related to the SAP business object
type.
Field name
Field name of authorization object in SAP which is related to the SAP
business object type.
CS category attribute
Attribute name of the Content Server category.
You define the search help in the business object declaration. For more information,
see “Creating a business object declaration in SAP” on page 44.
Note: You can only use Elementary Search help. Collective search help is not
supported.
1. In the IMG, navigate to the Extended ECM > Maintain Business Object
Declarations activity and click Execute.
2. Select a business object declaration from the available list; then double-click
Search Help F4 Support in the Dialog Structure area.
3. Enter or modify the following parameters:
Exact Search
If active, the search looks for values that exactly equal the search criteria
(value = search criteria). If not active, the search will look for values that
contain the search criteria (search for values with pattern
*search criteria*) .
1. In the IMG, navigate to the Extended ECM > Business Object Declarations
activity, select a business object declaration from the available list and double-
click Search Help Business Object Key.
Object Type
Business object that is used as workspace reference or as a business object
that is added to a Content Server item.
Key field
Key field of the business object.
SearchHelpParam
Parameter of the search help.
Key inactive
If active, the key field of business object will not be filled. This setting is
used in cases where a key of a business object is composed of several key
fields, but not all fields should be filled.
For example, the business object WBS Element (BUS2054) has a key with two
key fields; but only one is actually used by SAP, for example when storing a
document with ArchiveLink.
To be consistent with SAP, deactivate the key field that is not used by
setting this parameter.
Example: You decided to create a business workspace for each one of your customers.
Instead of creating the workspace manually when you created a new customer, you customize
Extended ECM for SAP Solutions to automatically create a business workspace for each new
customer.
For this, you use the SAP event CREATED that triggers the creation of a workspace.
In addition to the steps you take to enable manual workspace creation, you must
customize the events that trigger the automatic creation.
Extended ECM for SAP Solutions provides the following function modules for the
automatic update and creation of workspaces. To use the asynchronous queuing,
use the respective function module that end with _ASYNC or _ASY. For more
information, see “Creating business workspaces and declaring document
asynchronously” on page 129.
For more information about the Maintain Receiver Module Events IMG activity,
see “SAP: Linking events to receiver type function modules” on page 170.
Parallel You can use parallel processing for the asynchronous queue. In order to increase
processing speed, you can define that several processes run in parallel for a defined number of
items. You can define the settings for the program when you schedule the
background job.
Monitoring You can monitor the queue, check errors and re-start a queued item manually. You
can also control the queuing process by locking writing to or reading from the
queuing database table or locking the process itself. For more information, see
“Setting queue properties” on page 131.
Queue processing
API functions The Extended ECM for SAP Solutions contains function modules for Create or
and function Update events to be processed either synchronously or asynchronously. For
modules
workspace creation that is not event-based, you can use the new API methods. The
API is described in the SDK documentation, which you find in OpenText My
Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/63007681).
Note: OpenText recommends that you first analyze the rate of the workspace
creation and update operations and the time one operation consumes. In most
cases, the manual queue processing can deliver the best system response time
and resource consumption rate. So according to the results of the analysis
schedule the queue processing manually to run in periodically.
If you want to process manual workspace creation via the asynchronous queue, you
must address the BOR API. For more information, see the SDK documentation,
which you find in OpenText My Support (https://knowledge.opentext.com/
knowledge/cs.dll/Open/63007681).
1. In the IMG, navigate to the Extended ECM > Maintain Receiver Module
Events activity and click Execute.
2. Configure events with a function module that is designed for the asynchronous
queue. For more information, see “SAP: Linking events to receiver type function
modules” on page 170.
1. In the IMG, navigate to the Extended ECM > Maintain Declaration Queue
activity and click Execute.
• Lock queue filling: Writing to the queue is disabled. No more items can be
added.
• Lock queue reading: The queue processing background process is disabled.
Reading from the queue is disabled and thus, no business workspaces will
Server group
You can define which server group should process the queue. For more
information about parallel processing with asynchronous RFC, see the
SAP documentation about parallel processing with asynchronous RFC
(for example at http://help.sap.com/saphelp_snc700_ehp01/helpdata/
en/22/0425c6488911d189490000e829fbbd/frameset.htm)
4. Use the SAP background job scheduler (transaction SM36) to plan the queue
processing program /OTX/RM_WSC_Q_CONSUMER_BGJOB.
Select a user with which the business workspaces will be created. This user
must have the authorizations defined in “Setting up asynchronous queueing for
event-based creation” on page 131 and all necessary permissions in Content
Server. This user is also the owner of the business workspaces in Content
Server.
2. Select an action that you want to monitor. Also select if you want a detailed
deletion log.
5. The report displays the content of the queue. It also summarizes the settings
you made in the queue properties.
• Priority: While adding new items, the process can also define the processing
priority and with that differentiate the workspace creation scenarios.
• SLG Reference: Click to view a more detailed entry in the SAP application
log.
• Created by: Creator of the item
• Created on: Creation date and time in the format YYYYMMDDHHMMSS.
• Activity: Activity, for example Create a workspace. For information about
the value, press F4.
• Obj. Type: Business object type
• Key: Business object key
• Cont. Rep., Doc ID, Doc.type StrgeDat, Date, Reserver, Flag: Only relevant
for document declaration items.
6. To retry the creation of business workspaces for queued items, select one or
more rows, then click Re-process selected items.
Any user who has access to one of the business objects in one of the SAP system also
has access to the workspace, and thereby to the information provided by both
systems.
• Property providers
At least one property provider must contain information about the other related
business object type. OpenText My Support (https://knowledge.opentext.com/
knowledge/cs.dll/Open/63007681).
• Template and categories
Create a template and categories with attributes. You can either create a category
that fits both business object types or create separate categories for the two
business object types.
• Business object types
Create business object types for each of the business object. The business object
types must have the same document template and the same workspace type.
Also define, which of the business object types should be the default for
displaying the business object in the respective enterprise application.
For the mapping of business properties to category attributes, you have the
following options:
• Map the properties of the business object to the same category attributes on
Content Server.
If information changed for one business object in one of the enterprise
applications, the business workspace is updated. If two business objects map
their properties to the same attribute on Content Server, the last update wins.
Example: The following BOR objects are examples for a composite business workspace
scenario in SAP Plant Maintenance:
Child: Operations (custom business object /OTX/RMTLO is part of the SAP Extended ECM
Solution Accelerator for SAP PM)
Tip: A sample property provider for SAP ERP task lists and operations is part
of the SAP Extended ECM Solution Accelerator for SAP PM (https://
knowledge.opentext.com/knowledge/cs.dll/Open/37717526).
For more information, see “Configuring business object types” on page 109.
Workspace type
You only need to specify the Workspace Location for the workspace type for the
topmost parent business object. For a child business object, the location is always
the business workspace of the parent, regardless what you specify in the
workspace type.
Policies
Child business workspaces cannot have their own policies; they inherit policies
from their parent.
Creation
SAP - When you create a business workspace for a parent business object
automatically or manually, business workspaces for all according child business
objects are created.
Content Server - When you create a business workspace for a parent business
object, no business workspaces for child business objects are created.
Deletion
When you delete a parent business workspace, all child business workspaces are
deleted, too.
Search behavior
Documents that are indexed with the metadata of their business workspace,
inherit also the metadata of all parent business workspaces.
For more information, see “Indexing documents and other items with business
workspace attributes” on page 325.
Sidebar widgets
• Attributes sidebar widget displays the attributes of the current business
workspace.
• Recent Changes sidebar widget displays all recently added or changed
documents in the current and all child business workspaces.
• Related Items sidebar widget displays the relationships of the current
business workspace.
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.
• elservice.knownContainerTypes
• elservice.knownNonContainerTypes
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 “Unique names for Content
Server items” on page 194.
Note: System administrator rights are required for this task. Please ask
OpenText Professional Services for assistance.
3. Check if the following settings are present according to Figure 3-6 or Figure 3-7.
• Workspace section
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.
When the add-in is installed, users can open a panel called Business Workspaces
whenever they open an email in Outlook. By default, users can use this panel to
browse to and search for business workspaces and select a folder in which to save an
email. You can also require 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 manifest file from the Content Server system you want to
use to store emails. During the download process, information about the Content
Server system you are using is saved to the manifest file. You can then use that
manifest file to install the add-in in Microsoft Exchange.
When users subsequently browse to the Business Workspaces Outlook add-in panel
in Microsoft Exchange, the add-in automatically connects to the Content Server
system you used to download the manifest file.
Tip: For more information about Outlook add-in manifest files, see Outlook
add-in manifests (https://dev.office.com/docs/add-ins/outlook/manifests/
manifests?product=outlook).
1. On the Content Server system you want to use to store emails, browse to the
Content Server Administration page, and click Connected Workspaces > Set up
Outlook Add-in.
2. In the Outlook Add-in Manifest File area, confirm that the Content Server
URL field displays the correct URL for your Content Server system. 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 and confirm that the
new URL that starts with https appears in the Outlook Add-in
Manifest File area.
• If you edit the URL, you must add your server port number to the URL
if you are using a port other than 443 for HTTPS connections. 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.
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).
2. Click the New icon (+) and select Add from file.
4. Click Save.
You must create one or more regular or Email folders in each business workspace
based on the functionality you plan to configure.
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
Content Server User Online Help.
By default, a Select a search form list appears in the Business Workspaces Outlook
add-in panel. When a user selects a search form from this list, the search fields that
are configured within that form appear in the panel and the user can use those fields
to search for a business workspace in which to save an email.
To add a search form to the list, you must add a search form or a shortcut that points
to a search form to the Search Forms container in the Connected Workspaces
volume. You must also configure the search form as a custom view search.
If no search forms have been added to the Search Forms container, the list displays
the search forms that are saved in the Saved Queries volume.
Notes
• For more information about creating search forms and configuring them as
custom view searches, see Section 3.14.4 “Classic View: Configuring a simple
search” in OpenText Connected Workspaces - Configuration Guide (CSCWS-
CGD).
• If you choose not to create search forms for the add-in, you can hide the
Select a search form list from the Business Workspaces Outlook add-in
panel. For more information, see “Configuring add-in settings” on page 146.
• Create a search form in the Search Forms container. Browse to the Search
Forms container, click Search on the Tools menu, and then configure the
search fields for the form.
• Create a search form in the Saved Queries volume and then add a shortcut
that points to that search form in the Search Forms container.
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 click Save.
2. Remove a search form or shortcut from the container, for example, delete the
item from the container or move it to a different folder outside of the container.
The corresponding search form is removed from the Select a search form list in
the add-in.
1. On the global menu, click Enterprise > Connected Workspaces, and then click
Outlook Add-in Configuration.
3. Optional In the Email Saving Options area, configure the following options to
specify the folders and folder types that users can save emails to:
Note: If you clear this check box, you must select and configure the
Save emails to a pre-configured folder option instead.
When this check box is selected, the Save icon appears only when users
place their pointer on Email folders in the Business Workspaces Outlook
add-in panel. When this check box is cleared, the Save icon appears when
users place their pointer on any type of folder in the panel.
• Save emails to the first email folder in the workspace: Select this
option to require users to save emails to the first Email folder that
appears alphabetically in a business 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.
• Save emails to the following workspace folder: Select this option to
require users to save emails to a specific regular folder or Email 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, you must specify the name of the folder that
users can save emails to. You must also create an instance of the folder
in each business workspace that users can access in Content Server.
Notes
• You cannot specify a subfolder name. You must specify the
name of a folder that has been created directly in a business
workspace.
• The specified folder name applies to all of the business
workspaces that users can access in Content Server.
For example, if you specify the folder name Folder1, users can
save emails only to a folder called Folder1 in each business
workspace. In this scenario, if you want to allow users to save
emails to multiple business workspaces, you must create a folder
called Folder1 in each business workspace.
4. Optional In the Page Size area, specify the number of items that are displayed
from business workspaces and folders at a time. By default, this value is 10.
5. Optional In the Search Forms area, select Show search form selection in Search
workspaces section if you want to make search forms available to users in the
add-in.
By default, this option is selected and the Select a search form list is displayed
in the Business Workspaces Outlook add-in panel. In this case, you must create
one or more search forms and configure them as custom view searches. For
more information, see “Creating search forms for the add-in” on page 145.
When this option is cleared, the Select a search form list is hidden from the
panel and users can search for business workspaces only by name and type.
6. Optional In the Single Sign-on area, select Enable if you want the add-in to use
single sign-on (SSO) authentication to access Content Server. By default, this
option is cleared and SSO authentication is not used. If you select this option,
you must also configure your environment for SSO authentication. For more
information, see Section 3.16.6 “Configuring your environment for SSO
authentication” in OpenText Connected Workspaces - Configuration Guide (CSCWS-
CGD).
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
In this example, users are not permitted to expand business workspaces to browse
the folder structure. The Save icon appears whenever users place their pointer on a
business workspace. Clicking this icon saves an email to the first Email folder that
appears alphabetically in the 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
In this example, users are not permitted to expand business workspaces to browse
the folder structure. The Save icon appears whenever users place their pointer on a
business workspace. Clicking this icon saves an email to a regular folder called
Folder1.
Folders to create
• Clear the Allow users to expand workspaces and browse workspace folders
option.
• Select Save emails to a pre-configured folder and Save emails to the
following workspace folder, and specify Folder1 as the name of the folder
to which users can save emails.
Whenever a user opens the panel to save an email, the Business Workspaces
Outlook add-in automatically performs the following tasks 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, you can create a rule to search for business workspaces by type
and name if the email that is open has a specific term in 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 appear in the
Suggested Workspaces list. By default, the five most relevant business workspaces
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 150.
3.28.6.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 Connected Workspaces volume. For more information,
see “Configuring and testing rules and email search settings” on page 153.
When the add-in uses a rule to search for business workspaces, the following actions
take place:
1. 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.
The add-in checks whether the email property in the opened email contains the
pattern.
Example 3-3:
If you specify the regular expression order[\s]\d+ as the Matching
Condition pattern and select Subject as the email property to search, the
add-in searches for the term order followed by a space and any
combination of numbers in the subject line of the opened email.
2. 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 3-4:
If you specify the regular expression order[\s](\d+) as the Extraction
Term pattern and select Subject as the email property to search, the add-
in extracts the number that appears after the word order from the
subject line of the opened email.
For example, if the subject line of the email is order 1234, the add-in
extracts the value 1234. The add-in then searches for business workspace
names that contain 1234.
3. The add-in retrieves business workspaces based on the Workspace Type value
specified within the rule and whether the business workspace names contain the
value that was extracted from the email property.
Example 3-5:
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.
4. 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 3-6:
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 3-7:
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.
When the add-in uses email search settings to perform a search, the following
actions take place:
1. 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 3-8:
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.
2. 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.
3. 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.
4. 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 3-9:
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.
To calculate an overall weight value for each business workspace, the add-in then
uses the weight values that are assigned as a result of applying the rules and
searching for emails.
Example 3-10:
The business workspaces that have the highest overall weight values are then
displayed in the Suggested Workspaces list.
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 > Connected Workspaces, and then click
Outlook Add-in Configuration.
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. To configure a rule, click Add a Rule in the Rules area, and configure the
following settings.
Name
Specify a name for the rule.
Enabled
Select this option to allow the rule to find business workspaces. When
this option is cleared, the rule is not used to find business workspaces.
Email Property
Select the email property that you want use to find business
workspaces. When a user opens an email, the add-in checks whether
this property contains the pattern specified in the Matching Condition
field. If that pattern is found in the opened email, the rule uses the
regular expression specified in the Extraction Term field to retrieve
business workspaces.
Select one of the following properties:
• 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.
Weight
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 and the value that is selected in
the Default Weight list 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. Configure additional rules as needed. In 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.
5. On the Email Search tab, configure the following settings:
Sort Emails by
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.
Weight of Each Email
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.
Search Email Sender
Select this option to allow the add-in to find previously saved emails that
have the same sender as the email that is open.
Search Email Recipients
Select this option 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 in the simulated email.
• Cc: Specify one or more email addresses to include 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
You can specify whether tracing messages are displayed only to a specific Content
Server user who is signed in to the add-in (for example, an administrator) or to all
Content Server users.
1. On the Content Server Administration page, click Connected Workspaces > Set
up Outlook Add-in.
2. In the Debug Tracing area, select Enable tracing for and select one of the
following options:
• All users: Displays tracing messages to all Content Server users who are
signed in to the add-in on any client.
Before transporting add-in settings, you must do the following on the target Content
Server system:
• Confirm that Connected Workspaces is installed.
• If you want to transport rules you configured for the Suggested Workspaces list,
create a matching workspace type for each workspace type you specified in the
rules or transport the workspace types from the source Content Server system.
The workspace types on the target system must have the same names as the
workspace types specified in the rules.
You can then use the Transport Warehouse to complete the transport process. This
process requires you to complete the following general tasks:
1. Create a Workbench on the source Content Server system where the add-in
settings are configured.
2. Add the General Configuration, Search Forms, or Suggested Workspaces
Configuration item to that Workbench, depending on the settings you want to
transport.
Tip: These items are located in the Connected Workspaces volume. Click
Enterprise > Connected Workspaces and then click Outlook Add-in
Configuration.
3. Add the Outlook Add-in Configuration item from the Workbench to a
Transport Package.
4. Deploy the Workbench on the target Content Server system.
When the transport process is complete, the Outlook Add-in Configuration item on
the target system is overwritten.
Note: For more information about how to use the Transport Warehouse to
complete these tasks, see the Content Server User Online Help.
2. In the Frame Embedding area, clear the Prevent request check box.
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.
Business attachments are links between an item in Content Server and a business
object.
• From the SAP perspective, you open your business object; then you add a
Content Server item as a business attachment. Business attachments are displayed
in the Business Content window. Typically, this a document, a folder or an URL.
• From the Content Server perspective, you add a business object to the Content
Server item.
A business object that is added to a Content Server item is displayed in the
Business Objects tab of that item. They are also indicated by the Business
Objects icon.
1. SAP Property Provider - Write your own property provider or use the default
property provider which is part of Extended ECM for SAP Solutions.
For more information, see “Implementing a property provider in SAP”
on page 43.
2. Content Server - Enable a business object type so that it can be used as business
attachment, and select which Content Server object types can be used for
business attachments, typically folders or documents.
For more information, see “Configuring the adding of business objects to
Content Server items” on page 164.
3. Create a search form to find business objects in the business attachment widget.
For more information, see “Creating a search form for business attachments”
on page 328.
4. Optional Content Server - Configure the automatic adding of business objects.
For more information, see “Content Server: Configuring the automatic adding
of business objects” on page 166.
5. Optional For an automatic update of the attributes when business objects are
changed: In the SAP system (IMG), maintain the receiver modules. For more
information, see “SAP: Linking events to receiver type function modules”
on page 170.
Important
If metadata mapping is configured for added business objects, you
can only create one business attachment per workspace type for a
business object.
• Enable Callback Interface Before Adding Business Objects (SAP only):
Optional execution of additional Business Add-Ins (BAdIs), which enhance
the SAP functions; these are executed prior to the process of adding a
business object.
• Enable Callback Interface Before Removing Business Objects (SAP only):
Optional execution of additional Business Add-Ins (BAdIs), which enhance
the SAP functions; these are executed prior to the process of removing a
business object.
Tip: You must first save a business workspace before you can click the
Manage Object Types button.
Note: The available parameter values are the key fields of the selected
business object type.
1. Open the business object type that you want to use to automatically add
business object to Content Server items.
2. Add a category to the business object type that contains a boolean attribute
(“true” or “false”) which you can use as a trigger.
Note: The available parameter values are the key fields of the selected
business object type.
For more information about the automatic handling, see “Configuring events for
business workspaces and business attachments“ on page 169.
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).
For more information, see “SAP: Linking events to receiver type function modules”
on page 170.
You can customize the system so that whenever a business object is changed or
created, an action is triggered in Content Server. For example, when a business
object is created, a business workspace is created. Or when metadata is changed, this
change is transferred to the Content Server.
Typically, this is based on CREATED and CHANGED events which are triggered by
the business object. However, if a business object does not provide events, you can
use change documents as an alternative method. This chapter explains how to find
out which method is appropriate and how you customize it.
Important
The following describes only roughly how to find event methods for a
business object type. For a detailed description, see the SAP NetWeaver help
(http://help.sap.com/saphelp_nw70/helpdata/EN/c5/
e4aeef453d11d189430000e829fbbd/frameset.htm).
To find out which event method the business object type requires:
1. Find out if your business object type provides the CREATE and CHANGE
events:
c. Check if the business objects provides the required events. If so, you can
maintain the events in the IMG for Extended ECM for SAP Solutions. For
more information, see “SAP: Linking events to receiver type function
modules” on page 170.
2. If the business object type does not provide events, check which change
documents it writes that you can use to trigger events:
a. Run transaction SE16 to view table TCDOB which maintains the change
documents.
b. In this table, the TABNAME is the name of the table, and the OBJECT is
the name of the change document object. For example, the business object
type KNA1 (Business Partner) writes a change document DEBI.
For more information, see “SAP: Using change documents for the automatic
creation and updates when events are missing” on page 177.
You define entries for every relevant business object event and link them to the
respective function modules.
Tip: For composite workspaces, you might need a custom function module
with additional logic.
To use the asynchronous method via queuing, use the respective function module
that end with _ASYNC or _ASY. For more information, see “Creating business
workspaces and declaring document asynchronously” on page 129.
Important
The SAP Workflow System must be set up and running correctly for events
to be created (SWU3 transaction). For more information, see the SAP
documentation.
Table 5-1: Receiver type function modules and events for business
workspaces
Table 5-2: Receiver type function modules and events for added business
objects
1. In the IMG, navigate to the Extended ECM > Maintain Receiver Module
Events activity and click Execute.
2. Click New Entries.
3. It depends on the object type if you define settings for a BOR Object Type or a
ABAP Class.
• Object Type: Name of the object type, e.g. EQUI. For print lists, enter
PRINTLIST.
• Event: Event of the SAP business object type, for example CHANGED,
CREATED, ASSETTOBECREATED. The name depends on the object type.
5. Click Save.
For examples of possible entries for the different scenarios, see “Configuration
examples for business workspace and business object updates” on page 175.
Tip: To find out if a business object writes the documents, see “Preparing
events implementation” on page 169.
Note: You can use only one of the function modules. If you need both the
update of business workspaces and of business objects, contact OpenText
Global Technical Services for assistance.
1. In the SWO1 transaction, derive a new subtype for the business object that does
not have the required events. For example, create a subtype Z_KNA1 for the KNA1
supertype. As program, enter Z_KNA1.
2. In the SWO1 transaction, for the created subtype, add the /OTX/RMWSC interface.
This interface creates the relevant events for the derived business object.
4. Link the function module to the event of the new subtype as described in “SAP:
Linking events to receiver type function modules” on page 170. In the Receiver
Type field, enter the name of the supertype of the derived business object, for
example KNA1.
Tip: For more information about the creation of events when change
documents are written, see the SAP Help portal (http://help.sap.com/
saphelp_nw70/helpdata/EN/c5/e4aeef453d11d189430000e829fbbd/
frameset.htm).
1. In the IMG, navigate to the Extended ECM > Maintain Change Document
Events activity and click Execute.
• Change doc. object: Enter the change document object, for example DEBI.
• Object Category: BOR Object Type
• Object Type: Derived business object type, for example Z_KNA1.
• Event: Enter CHANGED or CREATED.
• Trigger Event: Select On Create or On Change.
For the update of policies when role assignments are changed or deleted, create
two entries. For more information, see Section 7.5 “Enabling automatic policy
assignment for changed role assignments” in OpenText Extended ECM for SAP
Solutions - User Management and Access Control Scenarios (ERLK-CUM).
• Event: USER_CHANGED
• Trigger Event: Select once On Change and once On Delete.
3. Click Save.
With Extended ECM for SAP Solutions, you can make ArchiveLink documents and
print lists available on Content Server. In addition, you can set the declared
documents under the responsibility of OpenText Records Management by assigning
an RM Classification.
Record B
Multiple links to You can link one archived document to multiple business objects in the SAP system.
an ArchiveLink The business objects point to one document in Archive Server. At the same time,
document
Content Server creates multiple records with links to the archived document. You
can store the records in a business workspace or any other location in Content
Server.
Deleting With Records Management, you defined retention periods, which control when a
documents and record must be deleted. You can delete each record for the same document
records
independently of each other. However, the archived document is only deleted when
the last record has been deleted.
SAP
Business Business Business
Object 1 Object 2 Object 3
1 2
Content Server
Record A Record B
Archive Server
Archived
document
1. Record A is deleted:
Link between Business Object 1 and the Archived document is deleted. The
archived document is not deleted, though, as there is still another record linked
to the document.
2. Record B is deleted:
Link between Business Object 2 and the Archived document is deleted. The Archived
document is deleted because the last record was deleted.
Link between Business Object 3 and the Archived document is deleted.
Prerequisites
• The system is set up for document declaration according to Section 24.12
“Preparing document declaration” in OpenText Extended ECM for SAP Solutions -
Installation and Upgrade Guide (ERLK-IGD). After this the following must be
available:
The following steps in this order are required to configure document declaration:
Steps overview
2. Optional SAP IMG - Create a new Enterprise Library item type for document
metadata. You can use the property provider to create the category
automatically. For more information, see “SAP: Creating an Enterprise Library
item type and additional categories for a specific property provider”
on page 190.
3. SAP IMG - Create a document declaration. For more information, see “SAP:
Creating a document declaration” on page 196.
5. SAP IMG - Assign the newly created declaration ID to a business object and a
document type. For more information, see “SAP: Assigning a document
declaration to a business object and a document type” on page 207.
Prerequisites The system is set up for document declaration according to Section 24.12 “Preparing
document declaration” in OpenText Extended ECM for SAP Solutions - Installation and
Upgrade Guide (ERLK-IGD).
1. In the SAP system, create a new business property provider if the default
property provider is not suitable for you. For more information, see “SAP:
Implementing a property provider for document declaration” on page 188.
4. Define unique names for all Content Server items, for example categories and
folders, that you want to use in your document declaration. For more
information, see “Unique names for Content Server items” on page 194.
5. In the SAP system (IMG), define a declaration for the defined Content Server
location, categories and classifications. For more information, see “SAP:
Creating a document declaration” on page 196.
If you want to enable Records Management, for the Records Management
settings, specify an existing RM classification and all additional fields as
required.
6. Optional In the SAP system, enter the names of declared documents in additional
languages. For more information, see “SAP: Providing multilingual document
names” on page 205.
7. In the SAP system (IMG), assign a declaration ID to the document type and SAP
object type. For more information, see “SAP: Assigning a document declaration
to a business object and a document type” on page 207.
8. Optional For automatic declaration, select the Automatic check box. Any new
ArchiveLink entry matching the given object type and document type is
automatically declared as a record.
In the SAP system (IMG), maintain the receiver modules to make sure that the
documents are updated automatically. For more information, see “Maintaining
receiver modules for CHANGED events (optional)” on page 215.
Your SAP system creates daily reports that you want to store on Content
Server. You can define a root folder for print lists created by the same report
and create subfolders for every day the report runs.
Prerequisites The system is set up for document declaration according to Section 24.12 “Preparing
document declaration” in OpenText Extended ECM for SAP Solutions - Installation and
Upgrade Guide (ERLK-IGD).
1. In the SAP system, create a new business property provider if the default
property provider is not suitable for you. For more information, see “SAP:
Implementing a property provider for document declaration” on page 188.
4. Define unique names for all Content Server items, for example categories and
folders, that you want to use in your document declaration. For more
information, see “Unique names for Content Server items” on page 194.
5. In the SAP system (IMG), define a declaration for the defined Content Server
location, categories and a classification. For more information, see “SAP:
Creating a document declaration” on page 196.
For the Document Location setting, keep the following in mind:
• If you select Constant and leave the field empty, the Enterprise Library
Services application folder becomes the root folder and the documents are
not accessible for users.
If you want to use Records Management for the Records Management settings,
specify an existing RM classification and all additional fields as required.
7. In the SAP system (IMG), assign a declaration ID to the document type and SAP
object type. For more information, see “SAP: Assigning a document declaration
to a business object and a document type” on page 207.
8. Optional For automatic declaration when print lists are created: Select the
Automatic check box if any new print list entry matching the given object type
and document type should be declared as record automatically.
For automatic declaration when print lists are created: In the SAP system (IMG),
maintain the receiver modules events. For more information, see “Maintaining
receiver modules for automatic declaration of print lists” on page 212.
Note: These interfaces may change with the next version of Extended
ECM for SAP Solutions. Therefore, be aware that possible upgrade tasks
will not be covered by Extended ECM for SAP Solutions.
For more information about property providers, see the SDK in OpenText My
Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/63007681).
OpenText My Support (https://knowledge.opentext.com/knowledge/cs.dll/Open/
63007681).
You can also create system categories manually, but copying the imported item
types ensures that no mandatory category attributes are missing.
Caution
Do not delete the original category under Open the Enterprise Library
Types Volumes.
5. Create unique names for the system categories. You will need the unique name
for the document declaration configuration in the SAP IMG. For more
information, see “Unique names for Content Server items” on page 194.
In addition to the system categories, you can create further categories for the
documents and records in Content Server. For more information, see “SAP: Creating
an Enterprise Library item type and additional categories for a specific property
provider” on page 190.
Note: This program only creates categories for non-generic property providers.
For more information about creating categories for a generic property
provider, see “SAP: Creating an Enterprise Library item type and additional
categories for a generic property provider” on page 192.
Note: To define categories manually, on the global menu, click Enterprise >
Connected Workspaces, and then click Categories. Create categories and add
attributes to them.
1. Navigate to the Extended ECM > Document (ArchiveLink) ... > Create Content
Server Category in the Enterprise Library Types Volume activity and click
Execute.
2. Create a new Enterprise Library item type for each used property provider.
Specify the following parameters:
3. Click Execute.
2. Browse to the folder named like the item type you just created and open it.
Caution
Do not delete the original category under Open the Enterprise Library
Types Volumes.
Note: Note the location of the copied category. You will need this information
to configure new document declarations in the IMG in SAP. For more
information, see “SAP: Creating a document declaration” on page 196.
2. Create a new Enterprise Library item type for each business object type that
uses the generic property provider.
3. Click Execute.
2. Browse to the folder named like the item type you just created and open it.
Caution
Do not delete the original category in the Enterprise Library Types
Volumes.
Note: Note the location of the copied category. You will need this information
to configure new document declarations in the IMG in SAP. For more
information, see “SAP: Creating a document declaration” on page 196.
To define classifications:
Note: After you created all relevant items on Content Server and before you
create the document declarations or policy definitions, you must define unique
names for all Content Server items that are relevant for your document
declarations or policy definitions.
3. To add a unique name, click the Add Item button and then click Unique
Name.
b. Click Browse and navigate to the Content Server object that you want to
associate with the unique name. Select it.
c. Select the group where you want to store the unique name.
d. Click Add.
a. You can rename a unique name, however you must then change the unique
name in all places where it is used.
b. You can move a unique name from one group to an other group.
Notes
• If you delete a unique name, you must make sure that it was not
used anymore.
• You cannot restore a unique name.
• If you delete a unique name group that contains unique names, the
unique names are deleted as well.
Notes
• If you delete a unique name group that contains unique names, the
unique names are deleted as well.
• If you delete a unique name, you must make sure that it was not used
anymore.
• You cannot restore a unique name.
• You cannot delete the default groups General and Appearances.
For the document declaration, you need the following information; some of them
must be configured before you begin this procedure.
• Name of property provider
• Connection ID
• Unique names of system category and other categories
• Unique name of location folder or definition of business workspace
• Names of business properties and category attributes
• Unique name of RM Classification
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Extended ECM > Document (ArchiveLink) ... > Maintain Document
Declarations activity and click Execute.
• Declaration ID
Enter a unique name for this declaration.
• Description
Enter a description that states the purpose of the document declaration.
• Business Property Provider
Select one of the available property providers from the value list.
Extended ECM for SAP Solutions includes the following default property
providers:
Click Next.
Connection ID
Select one of the configured connection to Content Server from the value
list. For more information about the connected Content Server, see Section
23.2.5 “Maintaining Extended ECM connections” in OpenText Extended ECM
for SAP Solutions - Installation and Upgrade Guide (ERLK-IGD).
Categories (optional)
You can add more categories that store the non-system properties coming
from the property provider specified before. Click Insert Category to add
a row and select an existing Content Server category by its unique name.
Note: The category that has been specified under System Category
cannot be selected.
Document Location
ArchiveLink documents and print lists declared as records are stored in
Archive Center. The document location defines the target folder where
records will be stored. You refer to folders using the unique names you
defined for them. For more information about unique names, see “Unique
names for Content Server items” on page 194.
The following parameters are available:
• Unique Name
Unique name of an existing folder within Content Server. However,
if the field is empty, the Enterprise Library Services Application
folder becomes the root folder. In this case, the document will not be
accessible to users.
• Workspace
By using the fields Object and Key, the business workspace where
the document will be located can be specified explicitly. If the fields
Object and Key are empty, the document or print list will be located
according to the workspace definition for the associated business
object.
• Object
Optional: SAP object type (e.g. EQUI)
• Key
Optional: Property of the property provider with the key of the
business object for the workspace where the document is stored.
• Business Property
ID of an existing folder within Content Server provided by a
property of the assigned property provider. If the value of the field is
0, the Content Server application folder becomes the root folder.
Document Name
ArchiveLink documents and print lists declared as records are stored in the
defined document location; the record name is defined in the Document
Name field. You can create a name pattern with normal text, placeholders
and modifiers similar. For more information, see “Creating a name pattern
for record declaration” on page 204. Modify the default document name
according to your storage strategy. Insert the property placeholder using
the Insert Placeholder button.
Note: The URL, with which users will open the document, consists of
the host name, the port, and the document name. This URL may not
be longer than 1024 ASCII characters. With URL-Encoding, a single
non-ASCII character, for example, from the Cyrillic alphabet, uses
three and more ASCII characters, thus, the maximum length can easily
be reached.
Tips
• OpenText recommends that you define the Document Name in a way
that it gets a unique name.
• You can also configure different document names for different
languages. For more information, see “SAP: Providing multilingual
document names” on page 205.
Click Next.
4. Categories Mapping
The Categories Mapping dialog always displays a tab for the system category
and a tab for each additional category.
Click Search help in the respective rows to define the mappings between
SAP business properties and category attributes.
Business properties with the same type and name as a category attribute are
suggested as default mapping. For each mapping pair, the F4 value list displays
all business properties with the same type as the corresponding category
attribute.
5. If the mapping table has property groups, click the respective Map button to
define the mappings of the subproperties.
Click OK to close the Property Group Mapping dialog.
Click Next.
• RM Classification (optional)
If you select Unique Name, you refer to the RM classification using the
unique name you defined for it. For more information about unique names,
see “Unique names for Content Server items” on page 194.
If you select Template, a template mechanism with placeholders is provided
similar to the one for Document Location field. You can create a pattern to
define the RM Classification template using normal text, document property
values and modifiers.
Insert the property placeholder using the Insert Placeholder button. For
more information, see “Creating a name pattern for record declaration”
on page 204.
• Record Date
• Status
• Status Date
• Mark Official
Notes
• Empty RM classification field
Be aware of the following behavior:
• Creating a document: If the document inherits an RM classification,
all other RM configuration parameters are applied.
• Updating a document: If no RM classification is set but the document
already has an RM classification, the document keeps its current RM
classification, and all other RM configuration parameters are applied.
• If you do not provide an RM classification and the document does not
inherit an RM classification then this document will not be under
Records Management. The other RM parameters are therefore not
applied.
• If you fill the Record Date, Status, and Status Date field, but leave the
RM Classification empty, then the provided fields are only applied if
the document to create receives an RM classification via inheritance or
the document to update already has a RM classification.
• The values for RM Classification and Status must exist on the Content
Server Records Management server.
• Constant values for Record Date and Status Date are interpreted as
being in the GMT time zone.
Tip: These parameters correspond to the fields on the Records Detail tab
for a declared document in the Content Server Web UI.
Offset: +2
Cut off the specified number of characters and displays the rest. Separate the
modifier from the attribute by a colon. An out-of-bound offset causes an error.
• Pattern - [AL_PLUS_Attributes.DocDesc_engl], archived
[ArchiveLink.Storage Date+2]
• Result - Delivery slip for customer, archived 1403152015
The first two digits of the date are cut off.
Length: (8)
Displays the specified number of characters. Separate the modifier from the
attribute by a colon. An out-of-bound length causes an error.
• Pattern - [AL_PLUS_Attributes.DocDesc_engl], archived
[ArchiveLink.Storage Date(8)]
• Result - Delivery slip for customer, archived 20140315
Only the first eight digits of the date are displayed.
Combination
You can combine all of those pattern modifiers.
• Pattern - [AL_PLUS_Attributes.DocDesc_engl], archived
[ArchiveLink.Storage Date+2(6)]
• Result - Delivery slip for customer, archived 140315
The first two digits of the date are cut off and only six are displayed. The
word , archived was added.
An out-of-bound offset or length will cause an errors during the creation of the
record.
You can compose a name of several attributes. However, if one of those attributes
does not provide a value, this attribute is omitted without error message.
Example: You define the path with the following attributes: [Country]/[City]/
[MaterialType]. If the [City] attribute delivered no value the subpath would consist of
only [Country]/[MaterialType].
Note: To separate folders, use the forward slash (“/”). The colon (“:”) cannot be
used in Content Server paths. It is replaced by a space.
Customizing overview
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Extended ECM > Document (ArchiveLink) ... > Maintain Multilingual
Document Declaration Templates activity and click Execute.
• Declare ID: Select the document declaration that you created in Step 2 of
“SAP: Creating a document declaration” on page 196.
• Lng ISO: Select a language ISO code.
• Title template: Enter naming schema for this language.
You can use variables for the document names. For more information, see
“Creating a business object declaration in SAP” on page 44.
1. In the IMG, navigate to the Extended ECM > Document (ArchiveLink) ... >
Assign Declaration ID to Object Type and Document Type activity and click
Execute.
b. Select Automatic if any new ArchiveLink document or print list entry that
match the given object type and document type should be declared
automatically. For manual declaration via report and GOS menu, leave the
check box deselected.
Note: For automatic declaration of print lists, the CREATED event for
print lists must be linked to the respective receiver module; for details
see “Maintaining receiver modules for automatic declaration of print
lists” on page 212.
c. Select Async. if you want to put the processing in the asynchronous queue.
You can only use the asynchronous queue if you also selected Automatic.
If the process creating the document declaration is a batch or workflow
process, the declaration will always be processed by the asynchronous
queue, regardless of this setting.
d. Optional You can select Auth.Check if you want to perform an additional
Enterprise Library authority check on display and delete access of declared
ArchiveLink documents or print lists.
Caution
Do not select the Auth.Check check box when the GOS
enhancement /OTX/RM_BF_GOS_ATTACHMENT is activated; as it also
performs an authority check, performance will be impaired. For
more information, see “Customizing the GOS Attachment list for
Records Management” on page 246.
4. Click Save .
The following explains how you configure each field of the respective sections.
Tip: See Section 5.6.1 “Declaring records ” in OpenText Extended ECM for SAP
Solutions - User Guide (ERLK-UGD) for detailed explanations on how to use the
declare dialog.
2. Define, which record detail fields are visible and which of the visible ones are
mandatory
From the global menu, select Enterprise > Records Management > Records
Management Administration > System Settings > RM Fields. Notice that the
Update Cycle Period field and the Next Review Date field are only mandatory
if the Essential field is mandatory and the user selects a vital essential code. The
Records Management Configuration page (see Content Server Administration
> Records Management Administration > Enable and Configure Records
Management) defines which essential codes are vital.
3. The Records Management Fields configuration also defines whether the Cross
Reference field is visible or not. Selecting a cross reference is never mandatory.
4. The Configure Records Management page (Records Management Workspace >
Records Management Administration > System Settings > RM Settings)
defines whether cross references can optionally be a version or not. If they can be
a version, a check box appears to let users choose whether the selected cross
reference should be a version or not.
5. The Categories field is always visible. This field is only mandatory if the MIME
type of the current document has been associated to one or more categories.
To configure the MIME types, go to Content Server Administration > System
Administration > Administer MIME Types and Categories.
Asynchronous To use the asynchronous method via queuing, use the respective function module
queue that end with _ASYNC or _ASY. Also document declarations initiated by the workflow
processing
user are processed via the asynchronous queue. For more information about the
asynchronous queue, see “Creating business workspaces and declaring document
asynchronously” on page 129.
For ArchiveLink documents and printlists, the following function modules are
relevant:
Tip: The _ASYNC events are for using the asynchronous queue. For more
informations, see “Creating business workspaces and declaring document
asynchronously” on page 129.
For more information, see “Maintaining receiver modules for CHANGED events
(optional)” on page 215.
Table 6-1: Receiver function modules and events for document declaration
You must activate the creation of the PRINTLIST.CREATED event. After activation, a
receiver module must be linked to the CREATED event of the PRINTLIST Object Type.
Note: The SAP Workflow System must be set up and running correctly for
events to be created (SWU3 transaction). For more information, see the SAP
documentation.
1. Navigate to the Extended ECM > Activate Receiver Module Events activity and
click Execute.
Click the Activate Receiver Module Events activity in the IMG.
3. Click Save.
1. Navigate to the Extended ECM > Maintain Receiver Module Events activity
and click Execute.
Figure 6-3:
• Destination of Receiver: Enter NONE to use the context of the user that runs
the functions. If you leave this field empty, the WF-BATCH user is used. It
must exist in your system.
• Linkage Activated: Select this option.
4. Click Save.
Example 6-2:
Depending on the SAP version used, the following screens might look different on
your system.
1. Navigate to the Extended ECM > Maintain Receiver Module Events activity
and click Execute.
2. Click New Entries.
• Event: Changed
• Destination of Receiver: Enter NONE to use the context of the user that runs
the functions. If you leave this field empty, the WF-BATCH user is used. It
must exist in your system.
• Linkage Activated: Select this option.
4. Click Save.
Notes
• In some application areas, events can be activated using SAP Change
Documents.
• The SAP Workflow System must be set up and running correctly for events
to be created (SWU3 transaction). For more information, see the SAP
documentation.
The Scheduled Processing framework lets you process a large number of items.
Using Content Server Expression Builder, you can select ranges of items. You can
suspend a running job and resume processing. The error handling functionality lets
you view error items and schedule them to be processed again.
Depending on your scenario and the installed modules, you can use the framework
to perform the following tasks:
• Create or update large numbers of business workspaces for the initial creation of
business workspaces from a SAP Hybris Cloud for Customer integration.
• Create or update large numbers of documents from a business application
integration
• Only when the connection is using the S/4HANA SPI Adapter: Listen to events
triggered in S/4HANA
• Only with Extended ECM for Microsoft Office 365: Create Office 365 groups,
connect them to a business workspace, and send email notifications when
business workspaces are connected to groups.
You can schedule jobs to run periodically and during off-hours with a low server
workload.
1. On the global menu, click Enterprise > Extended ECM > Scheduled Processing.
• Office 365 Send Email Notifications: Sends out emails notifying users
that they are now members of a business workspace group
• Office 365 Group/Team Add Membership: When an Office 365 group/
team is connected to a business workspace, the team participants of the
business workspace are added to the Office 365 group/team as members.
The participant of a buisness workspace who is designated as the team
lead is set as the owner of the group/team. Multiple participants can be
team leader. If there is no team lead defined, the owner of the group/
team is the user as defined in the configuration.
If you selected one of these options, you must set the following Business
Application and Business Object Type options to None.
5. From the Business Application list, select the business application. The
connection to the business application must have been configured before.
6. Select one Business Object Type that is available on the selected system. You
will later be able to set filters for the business object type.
7. Click Add.
In the next step you filter the business objects and create a schedule.
• Default Group Owner: Enter the Office 365 email address of a user who
will be the owner of each automatically created group if the Content
Server user who creates a business workspace does not have a valid
Office 365 email address configured in Content Server. For more
information, see Section 4.7.1.2 “Understanding how owners are
assigned to automatically created groups” in OpenText Extended ECM for
Microsoft Office 365 - Installation and Configuration Guide (CSSOG-ICG).
Click Verify User to validate the email address.
• Changed since last run: Finds new and changed objects since the last
run of the scheduled job.
• Created since last run: Finds new objects since the last run of the
scheduled job.
• Business Object Filter: Click the Edit Query button to open the
Expression Builder. Design your expression to filter only the business
objects that you want to process. For restriction in the Expression
Builder for SAP Hybris Cloud for Customer, see “Restrictions in logical
operations in SAP Hybris Cloud for Customer” on page 223.
• Update Only
Select this option if you only want to update existing business
workspaces with changed metadata rather than creating new business
workspaces.
• Page Size
Number of business objects fetched from the business application in one
step. Tweak this value to optimize the performance of the job. Default is
100. OpenText recommends that you use a page size that is n times the
block size.
• Block Size
Number of business objects to be processed by one Distributed Agent.
Tweak this value to optimize the performance of the job. Default is 100.
Important
If you change the values of Scenario, Business Object Filter and
Update Only, it will remove the checkpoint of the last run. The job
will then process all business objects again
3. Select a Scheduling Agent. You can create a schedule for one of the three
Extended ECM Scheduled Processors.
5. Click Save and Run Now to save the settings start the scheduled task
immediately.
You can monitor the progress of your scheduled jobs on the overview page. You see
the number of scheduled and progressed objects. If there is an error, you can click a
link to the log file. You may have to update the page from time to time.
defined business object filter. Additionally, if it turns out that more than one
sub-request must be made to get the next batch of data, the processing stops by
design. To overcome this limitation either redesign the filter criteria.
3. If you fixed the error cause, click Queue all to reprocess the error items.
The Content Server integration widget provides JavaScript libraries, which you can
use to display business workspaces and other Content Server functionality in a
modern and more flexible way. By defining a custom theme you can define how the
widget displays.
User When a user starts creating a new business workspace, the integration widget first
experience offers business workspaces without business object. Users can then decide if they
want to complete one of the available early workspaces or create a new on.
You can use the Content Server integration widget for the integration of business
workspaces into the following:
• Business Content window (optional)
• SAP Fiori (required)
• SAP Web Dynpro applications (in Floorplan Manager)
• SAP SRM
• SAP PPM
8.1 Prerequisites
Browser
Browser must be HTML5-compliant, which is any recent version of Firefox,
Safari, Chrome, and Internet Explorer starting from Version 10.
If you are using Internet Explorer, ensure that it starts in Standard mode.
SAP System
WebDynpro, for example SAP ERP, SAP SRM
• SAP_BASIS 731
• SAP_UI 740 (see SAP Note 1742528)
• Class CL_WD_HTML_ISLAND must exists on your system. Use transaction SE24
to check.
Configuration
• In the IMG activity OpenText Extended ECM for SAP Solutions >
Infrastructure > Maintain Extended ECM Connections, the Support
Directory field must contain the directory on Content Server where the files
for the Content Server integration widgets are stored.
• In the IMG activity OpenText Extended ECM for SAP Solutions > Extended
ECM > Maintain Business Object Declarations, the Use Widgets for UI
field must be selected. For more information, see “Creating a business object
declaration in SAP” on page 44.
SAP Notes
1746385 - Main WEBCUIF Browser Support Note
1753544 - Web Dynpro - HTML standards mode
1737445 - Internet Explorer standards mode rendering for EP
1742528 - Web Dynpro HTML integration: HTMLIsland, Container, Fragment
Microsoft IIS
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 240,
• 1956448 - Unequal rendering for NWBC and Web Dynpro ABAP - Prerequisite
for SAP Note 1963267 - SAP NWBC ABAP Runtime Patch 36
• 1963267 - SAP NWBC ABAP Runtime Patch 36 - For SAP NetWeaver Business
Client (NWBC) for HTML: Enables Web Dynpro applications to be started as
defined in the WdPreferredRendering application parameter. For this, the SAP
NWBC for HTML automatically switches Internet Explorer to the suitable
rendering mode.
See also SAP Note 1753544 - Web Dynpro - HTML standards mode
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.
You can allow users to report incidents directly from Smart UI to your local SAP
Solution Manager. For more information about SAP Solution Manager, see https://
help.sap.com/viewer/p/SAP_Solution_Manager.
New: You can now enable users to report incidents directly from Smart UI.
1. On the Content Server Administration page, click Extended ECM for SAP >
Configure SAP support integration.
2. Click Enable and provide the connection parameters to the server, which hosts
the SAP Solution Manager: Server, Port Number and Protocol. Make sure, that
you have no spaces at the end of the server name or the port number. The URL
to the SAP support portal is https://support.sap.com/en/index.html.
3. Fill in the required information in the incident report and save your data.
You have several customizing options when integrating Extended ECM for SAP
Solutions into SAP GUI:
• Make business workspaces and business attachments available via Generic
Object Services (GOS).
• Customize the functions and appearance of the Business Content window.
• Customize the GOS Attachment list for Records Management.
Tip: For a detailed description of the Business Content window, see Section 25.2
“OpenText Business Content window” in OpenText Archiving and Document
Access for SAP Solutions - Scenario Guide (ER-CCS).
1. Start the SM30 transaction and 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.
Service Type
Select Single Service .
Icon
ICON_BUSINAV_DATAMODEL
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 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 239.
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 239.
1. In the IMG, navigate to the Extended ECM > Business Content Window >
Maintain Business Content Window Menu and 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 (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 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 240.
1. In the IMG, navigate to the Extended ECM > Maintain Business Object
Declarations activity and select Use Widgets for UI for the business objects for
which you want to enable the integration widget. For more information about
the activity, see “Creating a business object declaration in SAP” on page 44.
2. Optional To define the theme, in the IMG, navigate to the Extended ECM >
Business Content Window > Maintain Business Content Window Display
Options and click Execute.
Note: You can now use the new belize theme for the folder browse
widget integration. However it is currently not recommended for
page view.
Tip: For more customizing options for the Business Content window, see
“Select items to be displayed in Business Content window ” on page 236
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
ECM Connections. For more information, see Section 23.2.5 “Maintaining
Extended ECM connections” in OpenText Extended ECM for SAP Solutions -
Installation and Upgrade Guide (ERLK-IGD).
• Subtype: ID of the Case subtype. You find this information in the Content
Server Administration page > Template Workspaces Administration >
Administer Case Types. The subtype ID of a Case is a positive integer
between 31350 and 31399. For more information, see the Content Server
online help for this administration page.
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.
entry for the viewer and define that the document opens in the Content Suite Viewer
when the user double-clicks it.
• Enable Content Suite Viewer as Content Server viewer
• Brava! Installation: Brava Server Components for OpenText Content Suite Viewer
– Installation and Administration Guide, available on OpenText My Support
(https://knowledge.opentext.com/knowledge/llisapi.dll/Open/61356446).
• Content Suite Viewer Administration on Content Server Administration page:
Content Suite Viewer Admin Online Help - Content Server Administration
(LLESDV-H-AGD)
• On Content Server, disable that the document opens for editing when the user
double-clicks it.
• Maintain mime types and define that Microsoft Office document are opened with
the viewer. For more information, see “Customizing MIME types for preview”
on page 245.
• Configure the Business Content window so that there is a new menu entry and
the document opens in Content Suite Viewer when the user double-clicks it.
• Activation: Select.
• Function Code: PICK
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 233.
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.
Extended ECM for SAP Solutions provides an integration solution for SAP Hybris
Cloud for Customer. You can display the business workspace of a business object
along with the structured data. Integration points are the business objects Account,
Lead and Opportunity, and Service Request (ticket).
Prerequisites
• Content Server module Extended ECM for SAP (xecmsap) must be installed
• You must have access to Content Server administration pages
• You must have access to SAP Hybris Cloud for Customer administration pages
New: You can now integrate business workspaces in SAP Hybris Cloud for
Customer. Extended ECM provides seamless integration for business objects
account, lead, and business opportunity.
SAP Hybris Cloud for Customer uses an Identity provider (IdP) for authentication.
For a single sign-on scenario, you set up a connection between OpenText Directory
Services and the corporate IdP using Security Assertion Markup Language (SAML). For
more information, see Section 4.1.4 “Configuration and use of SAML authentication”
in OpenText Directory Services - Installation and Administration Guide (OTDS-IWC).
If you need other business objects, you can write your own SPI adapter. For more
information, see Extended ECM Platform 16.2 - SDK and API documentation and
the SPI Java SDK (https://knowledge.opentext.com/knowledge/cs.dll/Open/
66215224).
1. Business Application
Create a connection to the SAP Hybris Cloud for Customer system:
2. Business workspace
Create workspace types, categories, classifications, and business object types for
the following business objects:
• Account
• Lead
• Opportunity
• From the main menu, select Adapt > Launch in Microsoft Silverlight. The
screens reload in a new window with additional options and menus or
prompts you to install Microsoft Silverlight®.
b. Click New > New HTML Mashup and configure the following for each
business object:
a. From the menu, select Adapt > Enter Adaptation Mode and confirm.
b. From the menu, select Adapt > Edit Screen.
c. In the right Adapt pane, in the Mashups and Web Services section, select
the mashup you created for this business object.
d. In the Properties area below, enter the following:
Appearance: New Facet
Full Width: select
e. Click Save and then Publish to make the mashup available to all users.
f. From the menu, select Adapt > Leave Adaptation Mode.
You need a slightly different procedure, to integrate the Service Request (Ticket)
business object into Responsive UI.
1. Create an HTML mashup for the Service Request (Ticket) business workspaces
as described in Step 2 of the above procedure or use an existing mashup.
2. Login to Fiori using Responsive UI, for example with a URL like the following:
https://my12345.crm.ondemand.com/sap/public/ap/ui/repository/
SAP_BYD_UI/HTML5/newclient.html
a. In the new tab, click the main area. When it is yellow, click Select Parent
.
1. Create a SAML metadata.xml file from your identity provider. Consult the
provider's documentation for details.
2. In SAP Hybris Cloud for Customer, open the Identity Provider tab.
3. Click New Identity Provider and select the metadata.xml file.
You can make business workspaces available in SAP Fiori apps. The business
workspaces are displayed in a custom tile.
In addition, the UI apps are deployed on a central SAP ABAP NetWeaver server,
which also contains the UI Service Add-on for the shell services and the Gateway
Add-on for the OData enablement of the ABAP-based Suite system.
Fiori apps are created using HTML5 and SAPUI5. For some extensions, the
underlying jQuery JavaScript library may be used. All supported form factors and
operating systems are supported with one development project and a single code
line per user interface app.
As a user of OpenText Extended ECM for SAP Solutions and Archiving and
Document Access for SAP Solutions, you are entitled to use the framework of
OpenText Business Center for SAP Solutions, with which you can build custom Fiori
apps to browse for business objects. This collection of ABAP Add-Ons provided by
OpenText Business Center for SAP Solutions is called OpenText Fiori Business
Object Browsing Enabler for SAP Solutions.
Additional resources
• Release notes for Archiving and Document Access for SAP Solutions (https://
knowledge.opentext.com/knowledge/llisapi.dll/Overview/67835278): list of
required Add-Ons and versions, basic steps for building a custom Fiori app for
business object browsing.
• OpenText Business Center for SAP Solutions - Configuration Guide (BOCP-CGD):
detailed information about the Fiori app framework.
The picture how Archiving and Document Access for SAP Solutions integrates into
the different layers of SAP Fiori, then looks as follows:
Prerequisites
• You have installed and configured the SAP Fiori system landscape. For more
information about the system landscape, see SAP Help Portal at Setup of SAP
Fiori System Landscape with ABAP Environment (http://help.sap.com/
fiori_bs2013/helpdata/en/ba/f61f533f86ef28e10000000a4450e5/frameset.htm).
• SAP UI5 version as stated in the Release Notes. This version corresponds to
SAP_UI 750 and is required for the OTEXBASF and OTEXRLF add-ons.
If you use Microsoft Internet Explorer as browser, it is highly recommended to
install at least version 1.44.17 of SAP UI5. For information about the installation,
see SAP Note 2213049 (http://service.sap.com/sap/support/notes/2213049).
• You have done the initial configuration of SAP Gateway. For more information,
see the following documentation:
For SAP NetWeaver 7.4, see SAP Help Portal at http://help.sap.com/nw74.
Important
The connection between the backend system and the frontend system
must be configured as a trusted connection.
• You have set up the SAP Fiori infrastructure. For more information, see SAP
Help Portal at Configuration of SAP Fiori Infrastructure (http://help.sap.com/
fiori_bs2013/helpdata/en/25/4a4c52eea9c871e10000000a44176d/frameset.htm).
The following steps are relevant to enable the Extended ECM for SAP Solutions
functionality in the different systems:
After you have enabled the functionality in general, further steps are necessary to
integrate a specific application.
Example:
http://mucr3d5o.opentext.net:8000/sap/bc/ui5_ui5/otx/RMF_LAUNCH/
version.html
Configuration overview
• The application comes with its OData services. You check if they are available
after installation and activate them if necessary.
• In the Fiori Launchpad, users work with their apps. You configure the Fiori
Launchpad to show the OpenText Test Launcher for relevant users such as
administrators who test the integration. For this, you create a tile catalog and a
tile group.
• The application is displayed in a tile. The tile is configured to show a specific
navigation target with a defined semantic object.
• The PFCG role defines which users can access a specific tile catalog and tile
group. For the test user, you define a specific role and assign a catalog and a
group to it.
To activate the service select it and on the menu, click Service/Host > Activate.
Each application within the launchpad has a resource locator (URL) by which it can
be loaded. Instead of directly encoding the (technical) name of the target application
into the URL hash, the launchpad performs an indirection by so-called intents.
The intent is resolved to the concrete navigation target by the launchpad target
resolution service. The concrete application targets have to be configured by the
administrator. In this configuration (called target mapping), administrators map the
combination of a semantic object and an action (both defined in the app launcher
tile) to the navigation target by specifying launchpad role and instance as well as
application alias or ID. This allows any link specifying an intent-based URL to
trigger the correct application assigned to the user. Since target mappings are
assigned to users as part of a catalog, they can be assigned to PFCG roles, while an
intent is independent of a role and can therefore be resolved differently based on the
role of the user that triggers the navigation.
• The user who performs the customizing must be assigned the composite role
SAP_UI2_ADMIN or its related sub roles, and the SAP_UI2_USER_700 role.
Table 12-5 list all values that are needed in different configuration contexts. Define
meaningful values and make a note of them as you need them later in the process.
2. Click New Entries and add a semantic object, for example ZZXECM_SO.
4. Click Save.
• A catalog that contains target mapping, groups and tiles. Later, you assign the
catalog to the PFCG role.
• A target mapping for the catalog. For each application you define an intent
(semantic object) and a target (defined by the launchpad).
• A tile for each of your apps, for example the OpenText Test Launcher.
• A group within the catalog. Later, you assign the group to the PFCG role.
You can add tiles to the group.
Note: Maintain catalogs and groups either only in current client or only
across clients. Maintaining catalogs and groups mixed in current client
and across clients can lead to inconsistencies.
To create a catalog:
1. In the Launchpad Designer, on the Catalogs tab, in the footer, click + Add.
2. Add a title, for example Extended ECM Test, and an ID, for example
XECM_TEST_CAT.
3. Click Save.
• Semantic Object: Enter the ID of the semantic object that you defined
previously, for example ZZXECM_SO
• Action: Define a unique name in the context of the semantic object, for
example launcher.
• URL: /sap/bc/ui5_ui5/otx/rmf_launch
• Component: otx.ecmlink.launcher
To create a tile:
• Title and Subtitle: Enter the titles of the tile that are displayed for the user.
• Semantic Object: Enter the ID of the semantic object that you defined
previously, for example ZZXECM_SO
• Action: Define a unique name in the context of the semantic object, for
example launcher.
4. Click Save.
To create a group:
1. In the Launchpad Designer, on the Groups tab, in the footer, click + Add.
• ID: Enter an ID, for example XECM_TEST_GROUP. You use this ID later when
defining the PFCG role.
3. Click Save.
5. Click the search icon. In the window, enter the title of the tile that you defined
before, for example OpenText Test Launcher and filter the list for it.
6. The catalog list displays all catalogs that contain the tile. Click the catalog.
7. In the list of contained tiles, select the tile that you want to add, for example
OpenText Test Launcher.
4. On the Menu tab, open the menu of the button for adding objects and click SAP
Fiori Tile Group.
6. On the Menu tab, open the menu of the button for adding objects and click
Authorization Default.
7. In the Service window, in the Authorization Default list, click Tadir Service.
Specify the following values:
8. In the table, enter the name of the OData service you have activated. Enter the
name as follows: technical name_<four-digit version number with leading
zeros>:
Service for business workspaces: ZRM_WSC_ODATA_SRV_0001.
9. On the User tab, assign the role containing the catalogs, groups, and OData start
authorizations to a user by specifying the user ID.
Thereby, the user has UI access to the apps in the catalogs and the start
authorizations for the respective OData services on the frontend server.
10. On the Authorization tab, click the button next to Profile Name to generate the
authorization profile for the role.
The Fiori-related solution accelerator “Integrating Extended ECM in the SAP Fiori
App Track Sales Orders” provides sample custom applications that integrates the
Extended ECM for SAP Solutions functionality, for example into the Track Sales
Order app. When you create your own extension, review this solutions accelerator.
You can download the solution accelerator from OpenText My Support (https://
knowledge.opentext.com/knowledge/llisapi.dll/Open/62692551).
Prerequisites
• You have installed the following development tools: ABAP Development Tools
for SAP NetWeaver, SAPUI5 Application Development Tool for Eclipse.
• SAP UI5 version as stated in the Release Notes
• Ensure the local Tomcat web server is configured to work with SAPUI5 Eclipse.
• You have installed the relevant Extended ECM for SAP Solutions Add-on
packages for Fiori integration and customized the system for the SAP Fiori
integration.
At the end of all the steps to create a custom application that extends an SAP-
delivered standard application, the SAP Fiori sees a custom tile on the SAP Fiori
Launchpad.
Read the usage restrictions listed in the Release Notes of OpenText Extended ECM
for SAP Solutions. Always follow supported customizing options and enhancements
as described in OpenText Business Center for SAP Solutions - Configuration Guide
(BOCP-CGD).
Additional resources
• Release notes for Archiving and Document Access for SAP Solutions (https://
knowledge.opentext.com/knowledge/llisapi.dll/Overview/67835278): list of
required Add-Ons and versions, basic steps for building a custom Fiori app for
business object browsing.
• OpenText Business Center for SAP Solutions - Configuration Guide (BOCP-CGD):
detailed information about the Fiori app framework.
Prerequisites
See the Release Notes for the latest supported or recommended versions.
• SAPUI5 plug-ins
• Archiving and Document Access for SAP Solutions Add-on packages for Fiori
integration are installed and
• You customized the system for the SAP Fiori integration
• You have installed the relevant Business Center for SAP Solutions Add-on
packages for Fiori integration
• On the SAP frontend the Fiori apps of Document Access, Extended ECM and
Business Center are active. The OData services of these products are also
registered. Trusted system connections and system aliases to SAP backend
systems are also defined.
License restrictions
The license for Extended ECM for SAP Solutions only includes the use of the
following branches of the IMG for OpenText Business Center for SAP Solutions
(transaction /OTX/PF00_IMG):
• General Settings
• Workplace Configuration
• Web Services
Basic information
• Business center configuration is done in transaction /OTX/PF00_IMG.
• In OpenText Business Center for SAP Solutions > General Settings > Logical
Systems you must have an entry with Logical system = LOCAL. For more
information, see Section 3.2 “Configuring logical systems” in OpenText Business
Center for SAP Solutions - Configuration Guide (BOCP-CGD)
• The Business Center framework provides the specific Fiori task app /sap/bc/
ui5_ui5/otbcwui/pf07_bc_ui_03, which renders the pattern of a Master-Detail
app. For more information about the Master-Detail app, see SAP Fiori Design
Guidelines ( https://experience.sap.com/fiori-design-web/v1-30/master-detail-
app/).
The following URL parameters determine which data records and business
objects are displayed:
• Work object type wobjType is an abstraction of the business object and how it
is displayed
• Node nodeId is an abstraction of an item to navigate to usually an business
object instance or a list of instances of a specific business object
• Work center or Workplace workplaceId is an abstraction for navigation to
group access to several nodes which are related to each other
• J_6NPF_NAV restricts users to specific work centers and thus to specific nodes
assigned to those work centers. The value of the authorization object is the Work
Center ID.
• J_6NPF_WTY restricts permissions to specific actions on specific nodes and work
objects.
Depending on what the user shall be able to see in Extended ECM the related
permissions must also be assigned.
4. Create a node:
7. Define a web item handler class for the work object type:
b. Define a web item handler class for your work object type, for example /
OTX/CL_AL_EX_BOBCUST_ITEM for the work object type OTX_EX_CUST01.
Such a class must implement the interface /OTX/PF62_IF_ITEM_HANDLER.
For more information, see the BC configuration guide.
Do not implement methods, which are indicated as OBSOLETE or NOT
RELEASED.
c. Set a Key definition for the work object type, for example KUNNR at field
position 1.
d. Define the Related business object, for example Object Type = KNA1 and
Field List (Key) = KUNNR, because at runtime this information is
conveyed from the Business Center app to the Fiori controls of Extended
ECM for SAP Solutions.
8. Create an item type perspective for the layout of your Fiori app:
b. On the start page of the Perspective Editor, you have access to all available
perspectives and layouts. Click Create Perspective on the toolbar at the
bottom of the page.
c. In the Create Perspective dialog box, create a perspective, using the
following parameters:
a. The detail page of a perspective or layout enables you to perform all actions
to configure the perspective to your needs.
b. For example, the perspective view [ot_bc_app_namespace].view.
item.ItemHeaderAttrStats is the item header for which the data binding
is maintained in configuration Web Services > Workplace > Nodes in
dialog structure Nodes > Master List - Data Binding.
Another example of a perspective view is [ot_bc_app_namespace].view.
item.AttributeList. It renders a list of attributes, which can be used for
details. It is maintained in configuration Web Services > Perpsectives >
Data Binding in dialog structure Perspective > Attributes List View.
Further perspective views may be the areas to open an Extended ECM
business workspace control (BSP application /OTX/RMF_BWS4BC_02) and
business documents control (BSP application /OTX/ALF_DOCS4BC_02).
c. To make perspective views of Extended ECM and Archiving and
Document Access for SAP Solutions available in the detail page of a
perspective, right-click on the node Views. Select and execute the function
Add Module Views. In the following pop-up window, enter the name of
the BSP application, for example /OTX/RMF_BWS4BC_02 or /OTX/
ALF_DOCS4BC_02. Then click OK. The related item views are added under
the node Views.
d. In the list under the node Views, you may then find the following views:
• otx.alplus.doc4otbcwui02.view.item.BusinessDocuments:
renders the list of business documents. A click on a document opens it
in an overlay over the existing web page.
• otx.alplus.doc4otbcwui02.view.item.BusinessDocumentsSplit:
use together with view DocumentDisplay. It renders the list of business
10. Define the name of your work center that is displayed to the users:
11. For each pair of node ID and work object type define a perspective ID:
13. Define the data binding of a perspective in the Fiori app. For more information,
see Section 8.8 “Input helps” in OpenText Business Center for SAP Solutions -
Configuration Guide (BOCP-CGD):
b. You can define a semantic object link to navigate to a different Fiori app.
This requires further enhancement by custom code. See the BC
configuration guide and the solution accelerator for more details.
14. Define the properties to be listed in the detail section of a selected item in the
Fiori app.
c. At sub node Header View, you define the header view of a perspective.
e. At sub node Table View, you define the content of tables, that you want to
see in the perspective.
15. Maintain and translate the perspective texts. For more information, see Section
8.3.3 “Maintaining perspective texts” in OpenText Business Center for SAP
Solutions - Configuration Guide (BOCP-CGD):
c. At sub node Texts, you define the texts of every text ID, which is defined in
the perspective. With menu Goto > Translation, each text can be translated
into target languages.
Note: In the OpenText Business Center for SAP Solutions > Web Services >
Basic Settings > Basic Settings, the Use web viewer settings have no impact
on the display behavior of the Extended ECM for SAP Solutions control.
https://[sapsystem].example.net:[port]/sap/bc/ui5_ui5/sap/
arsrvc_upb_admn/main.html
3. Create a target mapping for each of your browsing apps. The content consists of
the semantic object, which you defined earlier, and an action.
Notes
• OpenText recommends that you add the URL parameters nodeid,
wobjType and workplaceId as mandatory with specific values, for
example OTX_ALCUST_NODE, OTX_EX_CUST01 and OTX_EX01_WP.
By doing so, you prevent that a person, who is allowed to use this target
mapping, can misuse it to call the Business Center Fiori app for a
different configuration.
• Do not forget to set a default value for Parameter system with a valid
system alias, for example OTXADAEXAMPLE, which is delivered by
the customizing of the Fiori solution accelerator.
4. In the same Fiori catalog, define a tile for each target mapping with the URL
parameters according to the target mapping.
5. After you have created or edited your Fiori catalog, use the PFCG transaction to
change or create an authorization role on the SAP frontend system to assign the
Fiori catalog to that role. This is done in the Menu tab as a item of type SAP
Fiori Tile Catalog.
6. The following is the customizing of an example authorizations role.
Related to personalization:
You also need access to the SAP Fiori Tile Catalog(s) and perhaps also to SAP
Fiori Tile Group, if you want to also have default tile group.
The following authorization objects are used:
For more information about further frontend basis authorizations, see the SAP
documentation (http://help.sap.com).
To use the Extended ECM for SAP Solutions functionality in SAP CRM, you add
Extended ECM for SAP Solutions specific views, for example, for business partners,
opportunities, or leads.
Tip: Extended ECM for SAP Solutions also provides a Content Server
appearance that provides an SAP-like skin for business workspaces in Content
Server. For more information, see “Checking the appearance of the SAP
integration” on page 139.
Table 13-1 contains a list of all SAP CRM business objects that have been identified
by OpenText. If you require other business objects, you can extract the necessary
information from the system:
• Component Name and View Set can usually be found in the Web Client UI by
clicking the header of the view and pressing F2.
• The Main Context can usually be found in the code of the
IF_BSP_WD_HISTORY_STATE_DESCR~GET_MAIN_ENTITY method of the Main
Window of the UI component.
Important
CRM Lean Order (LORD) with all its business objects and UI components,
for example ERP_H, are not supported.
Table 13-1: CRM business objects that are supported by Extended ECM
To display business workspaces and business attachments in the SAP CRM Web
Client UI as assignment blocks, perform the following steps.
Note: If you are completely new to the way the SAP CRM Web UI framework
works, see the documentation and literature on Web UI development for a
better understanding.
To edit the component for Extended ECM for SAP Solutions integration:
1. You need an enhancement set active in the client that you want to use. If there is
no active enhancement set, create one. For information on how to create an
enhancement set, see the respective SAP documentation.
3. If your component has not been enhanced yet, create an enhancement for it
using the Enhance Component button.
4. In the Runtime Repository Editor, switch to the edit mode and add a new
component usage with the name CUECMLink. The new component usage should
use the /OTX/RMCRM_GS_ECMLK component and the /OTX/RMCRM_GS_ECMLK/
WrkSpceWindow interface view for business workspaces.
On the ComponentUsages context menu, click Add Component Usage.
6. In the Runtime Repository Editor, open the ViewSets node, select the view set
you want to enhance, and add the /OTX/RMCRM_GS_ECMLK/WrkSpceWindow
view for business workspaces and the /OTX/RMCRM_GS_ECMLK/BusRefWindow
view for business attachments to the respective view area.
For example, for business partners, go to the BP_HEAD\BPHEADOverview view
set. To the OverviewPage view area, add the /OTX/RMCRM_GS_ECMLK/
WrkSpceWindow view for business workspaces and the /OTX/RMCRM_GS_ECMLK/
BusRefWindow view for business attachments.
8. Open the Configuration tab for the view set and edit the Customer
Configuration. If there is no customer configuration, open the standard
configuration and click Copy Configuration to create a new one.
a. Move the newly added interface views to the list of displayed assignment
blocks and enter a title for each of them.
For example, for business partners, open the configuration tab for the
BP_HEAD\BPHEADOverview view and move the /OTX/RMCRM_GS_ECMLK/
WrkSpceWindow view for business workspaces and the /OTX/
Important
You must use the enhanced component controller. Do not use the
original component controller.
METHOD wd_usage_initialize.
ELSE.
" Super method
super->wd_usage_initialize( iv_usage ).
ENDIF.
ENDMETHOD.
For more information about SAP CRM and the Web Client UI framework, see the
respective SAP documentation in the SAP Help Portal (http:\\help.sap.com):
• SAP CRM: http://help.sap.com/saphelp_crm70/helpdata/en/19/
68a028d02b460fa899066d948ed3ab/frameset.htm
• Web Client UI framework: http://help.sap.com/saphelp_crm70/helpdata/en/4c/
ea2be450e94597b5a6017f095a6132/frameset.htm
Special cases
METHOD if_ex_crm_prodil_uiu_badi~get_views_to_display.
DATA:
ls_static_view TYPE bsp_dlc_ovw_dyn_views_list,
ls_view TYPE crmc_pril_uiu.
To display business workspaces and business attachments in the SAP CRM IC Web
Client UI as additional tabs, perform the following steps.
Note: If you are completely new to the way the SAP CRM Web UI framework
works, refer to the documentation and literature on Web UI development for a
better understanding.
To edit the component for Extended ECM for SAP Solutions integration:
1. You need an enhancement set active in the client you want to use. If there is no
active enhancement set, create one. For information on how to create an
enhancement set, see the respective SAP documentation.
3. If your component has not been enhanced yet, create an enhancement for it.
4. In the Runtime Repository Editor, start the edit mode and add a new
component usage with the name usageECMLink.
The new component usage should use the /OTX/RMCRM_GS_ECMLK component
and the /OTX/RMCRM_GS_ECMLK/WrkSpceWindow interface view for business
workspaces.
6. In the Runtime Repository Editor, open the ViewSets node, select the view set
you want to enhance, and add the /OTX/RMCRM_GS_ECMLK/WrkSpceWindow
view for business workspaces and the /OTX/RMCRM_GS_ECMLK/BusRefWindow
view for business attachments to the respective view area.
For example, for the overview page for business partners in IC Utilities, go to
the IUICOVW/BottomVS view set. To the view area BottomVA, add the
usageECMLink./OTX/RMCRM_GS_ECMLINK/WrkSpceWindow for business
workspaces and the usageECMLink./OTX/RMCRM_GS_ECMLINK/BusRefWindow
view for business attachments.
8. In the Component Structure Browser, go to the view that contains the tabs and
where you would like to add the business workspace tab and the business
attachments tab.
For example, for the overview page for business partners in IC Utilities, go to
the IUICOVW/AccOvwNav view.
From the context menu of the view, select Enhance.
9. On the View Structure tab in the right pane, navigate to View Controller. To
open the view controller class, double-click on the implementation class of the
view controller.
METHOD fill_table.
* Super method
super->fill_table( ).
* OpenText Links
ls_link-id = 'AccWrkSp'.
ls_link-text = 'Business Workspace'.
ls_link-onclick = 'WORKSPACE_CLICKED'.
APPEND ls_link TO links_tab.
ls_link-id = 'AccBusRef'.
ls_link-text = 'Business Attachment'.
ls_link-onclick = 'BUSREF_CLICKED'.
APPEND ls_link TO links_tab.
ENDMETHOD.
d. To activate the code, click Activate.
e. To return to the Component Structure Browser, click Back twice.
10. On the View Structure tab in the right pane, navigate to Outbound Plugs.
a. From the context menu of Outbound Plugs, select Create and create the
following outbound plugs:
Tip: The OP_ prefix is added automatically. You only need to provide
the plug name.
b. Double-click the OP_ACCWRKSPACE outbound plug to implement it.
Implement it with the following coding:
METHOD op_accwrkspace.
view_manager->navigate( source_rep_view = rep_view
outbound_plug = 'NavToAccWrkspace' ).
ENDMETHOD.
METHOD op_accbusref.
view_manager->navigate( source_rep_view = rep_view
outbound_plug = 'NavToAccBusRef' ).
ENDMETHOD.
a. From the context menu of Event Handler, select Create and create the
following event handlers:
Note: The name of the event is case sensitive. Provide the name of the
events exactly like stated in uppercase.
b. Double-click the EH_ONWORKSPACE_CLICKED event handler to implement it.
Implement it with the following code:
METHOD eh_onworkspace_clicked.
selected_index = 'AccWrkSp'.
op_accwrkspace( ).
ENDMETHOD.
METHOD eh_onbusref_clicked.
selected_index = 'AccBusRef'.
op_accbusref( ).
ENDMETHOD.
12. In the Runtime Repository Editor, go to Navigational Links and add an entry
for every new tab.
Add the navigational link NavToAccWrkspace for the workspace tab and
NavToAccBusRef for the business attachment tab.
The source is the current enhanced view with the relevant outbound plug
(ACCWRKSPACE for workspace, ACCBUSREF for business attachment).
The target is your newly defined usage (usageECMLink./OTX/
RMCRM_GS_ECMLK/WrkSpceWindow for workspaces, usageECMLink./OTX/
RMCRM_GS_ECMLK/BusRefWindow for business attachments).
For example, for the overview page for business partners in IC Utilities, add the
following navigational links:
Important
You must use the enhanced component controller. Do not use the
original component controller.
METHOD wd_usage_initialize.
ENDMETHOD.
Note: If the predefined SAP mapping of SAP CRM objects to BOR objects is
not suitable for your needs, you can implement a BAdI using the IMG activity
CRM Settings > BAdI: Business Object Binding.
To enable this function, you add a button to the email creation pages of SAP CRM
Web Client UI or SAP CRM Interaction Center Web Client UI. The user can click this
button to select a document from a business workspace and attach it to the email.
For more information about the user experience, see Section 8.5 “Adding a business
workspace document to an email” in OpenText Extended ECM for SAP Solutions - User
Guide (ERLK-UGD).
For more information about SAP CRM and the Web Client UI framework, see the
respective SAP documentation in the SAP Help Portal:
1. You need an active enhancement set in the client that you want to use. If there is
no active enhancement set, create one. For information on how to create an
enhancement set, see the respective SAP documentation.
4. In the Runtime Repository Editor, switch to the edit mode. From the
ComponentUsages context menu, select Add Component Usage to add the
new component usage CUCSTargetTree with the following parameters:
• component /OTX/RMCRM_TARG_TREE
• interface view /OTX/RMCRM_TARG_TREE/TargetTreeWindow
7. On the View Structure tab in the right pane, navigate to View Controller. To
open the view controller class, double-click the implementation class of the
view controller.
• Attribute: MH_ADDATTACHMENTCS_HELPER
• Level: Instance Attribute
• Visibility: Private
• Typing: Type Ref To
• Associated Type: /OTX/RMCRM_CL_BT126H_MAIL
d. Click Activate to activate the code.
e. Click Back to return to the Component Structure Browser.
8. On the View Structure tab in the right pane, navigate to Event Handler.
a. From the context menu of Event Handler, select Create and create the
following event handlers:
Note: The name of the event is case sensitive. Provide the name of the
events exactly like stated in uppercase.
METHOD eh_onaddattachmentcs.
IF mh_addattachmentcs_helper IS INITIAL.
CREATE OBJECT mh_addattachmentcs_helper
EXPORTING
pih_view_controller = me
pih_component_controller = me->comp_controller.
ENDIF.
mh_addattachmentcs_helper->open_target_tree_popup(
pih_view_context = me->typed_context ).
ENDMETHOD.
METHOD eh_onaddattachmentcs_closed.
ENDMETHOD.
9. On the View Structure tab in the right pane, navigate to View Layout.
<thtmlb:button id="AddAttachmentCSButton"
onClick="ADDATTACHMENTCS"
text="<%=page->otr_trim( '/OTX/RMCRM_EMAIL_ATTACHMENT/
ADDATTACHMENTCS_BTN' ) %>"
tooltip="<%=page->otr_trim( '/OTX/
RMCRM_EMAIL_ATTACHMENT/ADDATTACHMENTCS_BTN' ) %>"/>
1. You need an enhancement set active in the client you want to use. If there is no
active enhancement set, create one. For information on how to create an
enhancement set, see the respective SAP documentation.
4. In the Runtime Repository Editor, switch to the edit mode. From the
ComponentUsages context menu, select Add Component Usage to add the
new component usage CUCSTargetTree with the following parameters:
• component /OTX/RMCRM_TARG_TREE
• interface view /OTX/RMCRM_TARG_TREE/TargetTreeWindow
7. On the View Structure tab in the right pane, navigate to View Controller. To
open the view controller class, double-click the implementation class of the
view controller.
• Attribute: MH_ADDATTACHMENTCS_HELPER
• Level: Instance Attribute
• Visibility: Private
• Typing: Type Ref To
• Associated Type: /OTX/RMCRM_CL_CRMCMP_CCS_EML
d. Click Activate to activate the code.
e. Click Back to return to the Component Structure Browser.
8. On the View Structure tab in the right pane, navigate to Event Handler.
a. From the context menu of Event Handler, select Create and create the
following event handlers:
Note: The name of the event is case sensitive. Provide the name of the
events exactly like stated in uppercase.
METHOD eh_onaddattachmentcs.
IF mh_addattachmentcs_helper IS INITIAL.
CREATE OBJECT mh_addattachmentcs_helper
EXPORTING
pih_view_controller = me
pih_component_controller = me->comp_controller.
ENDIF.
mh_addattachmentcs_helper->open_target_tree_popup(
pih_view_context = me->typed_context ).
ENDMETHOD.
METHOD eh_onaddattachmentcs_closed.
mh_addattachmentcs_helper->target_tree_popup_closed(
pih_view_context = me->typed_context ).
ENDMETHOD.
9. On the View Structure tab in the right pane, navigate to View Layout.
<thtmlb:button id="AddAttachmentCSButton"
onClick="ADDATTACHMENTCS"
text="<%=page->otr_trim( '/OTX/RMCRM_EMAIL_ATTACHMENT/
ADDATTACHMENTCS_BTN' ) %>"
tooltip="<%=page->otr_trim( '/OTX/
RMCRM_EMAIL_ATTACHMENT/ADDATTACHMENTCS_BTN' ) %>"/>
To use the Extended ECM for SAP Solutions functionality in SAP SRM, you add
Extended ECM for SAP Solutions specific Web Dynpro components for business
objects like suppliers, purchase orders or shopping carts.
• OTEXBAS
• OTEXRL
• OTEXRLS
Tip: Extended ECM for SAP Solutions also provides a Content Server
appearance that provides an SAP-like skin for business workspaces in Content
Server. For more information, see “Checking the appearance of the SAP
integration” on page 139.
You can use Extended ECM for SAP Solutions, for example, in the following
component configurations:
In the next steps, you modify each component configuration to show tabs for
business workspaces and business objects.
Important
Make sure, you use the enhanced configuration and not the original.
1. In the Editor for the Component configuration, click Change for the enhanced
version and not the original.
2. Click Add Main View. A new main view is added to the Hierarchy area.
Note: If you are using multiple languages, log on in each language and
define the title in the corresponding language.
4. In the Hierarchy area, open the node of the newly created main view and click
the user-interface building block (UIBB).
The browser view for your business object now contains the new tabs.
For SAP SRM business objects that do not respond to the BBP_DOC_SAVE_BADI BAdI,
for example, BUS1006 for Supplier or Bidder, see “Configuring events for business
workspaces and business attachments“ on page 169.
3. Double-click /OTX/RMSRM_DOC_SAVE.
5. Maintain the white list to ensure that the log out is only possible from the
specific URL:
To circumvent this, you can define that instead of the original version-dependent
business object, a version-independent object is used for Extended ECM. With this,
changes in the business object may create a new version of the business object but do
not create a new business workspace but update the metadata of the existing
business workspace.
Tip: To customize if SRM business objects are versionable in your SRM system,
use IMG activity SAP Supplier Relationship Management > SRM Server >
Cross-Application Basic Settings > Switch On Version Control for
Purchasing Documents.
The sample property providers for version-independent business object types are
available in OpenText My Support (https://knowledge.opentext.com/knowledge/
llisapi.dll/Overview/25089410).
1. In the IMG, navigate to the Extended ECM > SRM Settings > Maintain Version
Independent Objects activity and click Execute.
2. Create a new entry for the business object that you want to use version-
independent and select Version Independent Object.
Extended ECM for SAP Solutions indexes metadata, which is stored for business
workspaces and added business objects. To make this information available via the
search, Extended ECM automatically creates index regions.
To simplify the search for Content Server items, you can define search slices and
saved queries for a business workspace search or the search for business objects.
To support users in effectively reduce their search to only one specific workspace
type, you create a search slice for each workspace type.
• In Smart View: A selection list contains all search slices. The selected search slice
filters the search accordingly.
• In Classic View: The Search dialog contains a Slices list, which contains, for
example, a slice for the workspace type Customer. Users can reduce the search to
business workspaces of type Customer.
Searchable fields are called index regions within Content Server. The module
automatically creates the respective index regions as soon as the first business
workspace or the first business attachment are created and indexed.
2. From the function menu of the Enterprise Search Manager object, select
Properties > Regions.
Business Workspaces
For each business workspace type, you can configure the search behavior and
the options of the Search From Here box.
If enabled, the related workspaces search follows all related items that are
configured in the Related Items sidebar widgets for this business workspace
type.
For detailed information, see “Creating a workspace type” on page 55.
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. For
more information, see “Advanced settings of a workspace type” on page 63.
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. For more information, see “Creating a workspace type”
on page 55.
5. From the list of all available Content Server object types, select the object types
that you want to be indexed with metadata from the business workspace. A
typical list could contain the following:
• Folder
• Shortcut
• Generation
• URL
• Task List
• Task
• Email
• Document
• Business Workspace
4. From the function menu of the workspace type, select Schedule for Re-
indexing.
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.
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.
In the business attachments widget, users can search for Content Server items, which
they want to add to the business object. You can provide saved queries, which
already reduce the search criteria to a necessary set.
2. In Classic View, from the global menu, select Tools > Search.
3. Design your search. You can use categories, locations, or system attributes, for
example, only a certain Content Server item type. If you reduce the search to a
certain Content Server item type, this item type must be enabled for business
attachments. For more information, see “Configuring the adding of business
objects to Content Server items” on page 164.
4. Click Save Search Query. Enter a name and a description and save the search
form to the Content Server Saved Queries Volume.
5. From the menu, select Enterprise > Connected Workspaces > Saved Queries
Volume and find your new search form.
6. From the function menu of the search form, select Make Custom View Search.
7. Click Save.
Users with sufficient permissions can now use the simple search.
Users can use those templates where they have sufficient permissions.
Smart View
• On the business attachment widget when they want to add a business
attachment:
Classic View
• On the global menu with menu option Business Workspaces > Search.
• In the target browse window when users copy or move a Content Server item.
• Extended ECM: When users add a business relationship and search for the
related business workspace. For more information, see Section 4.7 “Creating a
relationship between business workspaces” in OpenText Extended ECM for SAP
Solutions - User Guide (ERLK-UGD).
Tips
• Simple searches are based on the Content Server concept of Custom View
Searches.
• Simple searches can be multilingual, so a search form can have different
names per language.
1. Go to Tools > Search to create an advanced search. For more information about
advanced search options in Content Server, see the Content Server online help.
Tip: To find only business workspaces, you can use the system attribute
Object Type.
2. Click Save Search Query. Enter a name and a description and save the search
form to the Content Server Saved Queries Volume.
Tip: You can define multilingual names and descriptions. Click the Click
to edit multilingual values button to add the names.
3. From the menu, select Enterprise > Connected Workspaces > Saved Queries
Volume and find your new search form.
4. From the function menu of the search form, select Make Custom View Search.
5. Configure the search as desired. In the Options section, add the title and a
description for this simple search.
Click Save.
Users with sufficient permissions can now use the simple search.
Permission definitions on Content Server can either apply to the whole Content
Server system or to individual Content Server items.
Important
For a detailed discussion of authorization concepts on different levels, see
OpenText Extended ECM for SAP Solutions - User Management and Access
Control Scenarios (ERLK-CUM).
• System wide: Object privileges define who can create items of a specific type;
usage privileges define who can perform specific actions. For more information,
see Section 6.1 “Defining general restrictions on Content Server” in OpenText
Extended ECM for SAP Solutions - User Management and Access Control Scenarios
(ERLK-CUM).
• On item level: Content Server permissions, security clearance. Content Server
permissions define access to each item, typically using groups. Permissions can
be inherited. For more information, see Section 6.2 “Defining item level
permissions on Content Server” in OpenText Extended ECM for SAP Solutions -
User Management and Access Control Scenarios (ERLK-CUM).
• On workspace level: Business policies are generated from SAP authorization
profiles. They restrict access to a workspace and its subitems.
Note: For general information, see OpenText Extended ECM for SAP
Solutions - User Management and Access Control Scenarios (ERLK-CUM).
For information on detailed subjects, see the following:
• “SAP: Exporting authorizations” on page 336 and “Opening the policies
volume” on page 338
• “Configuring the creation of business workspaces” on page 112,
Mapping of Business Properties section
• “Defining permission handling for business workspace templates”
on page 100
Before you export the SAP authorization objects, you must create an appropriate
field mapping; each field of the authorization object that should be included in the
policies must be mapped to a Content Server category attribute. For more
information, see Section 3.16.2: “Configuring the creation of business workspaces”
on page 112 and “Mapping authorizations in SAP” on page 124.
For information about the overall process and all relevant activities, see Section 7
“Using SAP authorizations to restrict workspace access (optional)” in OpenText
Extended ECM for SAP Solutions - User Management and Access Control Scenarios
(ERLK-CUM).
Example: A user has the authorization to see customers in the SAP ERP system, but no
authorization to see the same customer in the SAP CRM system. In Content Server,
policies created from authorizations both in the SAP ERP system and in the SAP CRM
system restrict access to the created workspaces. The user can see the business
workspace because the policy created from the SAP ERP system gives access.
To export roles:
1. Make sure that in the Business Object Declaration activity of the SAP IMG the
fields that are used to restrict access are mapped to corresponding attributes of
a Content Server category, for example Sales Organization. For more
information, see “Mapping authorizations in SAP” on page 124.
Tip: If you want to assign the policies to users with the Grant Policies
option, set the filter so that only users which also exist in Content
Server are included.
Caution
Select the Delete existing Policies option only if you want to reset
all policies and assignments.
Grant Policies
Select this checkbox to assign the generated policies to Content Server users.
As an alternative, you can assign policies to Content Server users manually
in Content Server.
4. Click Execute.
The authorization mapping is transferred to the Content Server.
Note: For the respective business objects, you must enable the use of policies
for the workspace type in Content Server (Policies Enabled checkbox); see also
“Creating a workspace type” on page 55.
1. On the Content Server Administration page, click Extended ECM > Open
Policies Volume.
The Content Server Policies page displays the global policies volume with the
SAP policies that are applied to the business workspaces. The policies are
grouped in folders; there is one folder for each business object declaration.
2. To display the properties for each policy using the Properties functions menu:
1. From the Content Server main menu, select Enterprise > Users & Groups.
2. Find the user to which you want to grant policies and click Edit in the Actions
column.
3. On the General tab, in the Policies granted field, add the policies you want to
grant the user.
You can fill OTDS groups with users from the SAP system depending on their role
assignment. The OTDS users and groups are synchronized to the Content Server
groups.
For the mapping, you create the OTDS groups in a separate non-synchronized
partition. You configure the Content Server resource in OTDS, define the partition
and a mapping in the SAP system, run it and configure events. Permissions for
groups in Content Server must be defined separately by the Content Server
administrators. For information about all relevant settings, see Section 8 “Mapping
SAP roles to groups” in OpenText Extended ECM for SAP Solutions - User Management
and Access Control Scenarios (ERLK-CUM).
Note: For earlier versions, a Solution Accelerator was available for the
mapping of SAP roles to Directory Services groups. If you have been using this
Solution Accelerator, you can either stay with your former implementation or
switch to the new implementation. If you want to switch to the new
implementation, copy the mapping from the Solution Accelerator table to the
product table.
For more information about setting up user mapping, see Section 3.2.3.1 “One-to-one
user mapping without impersonation” in OpenText Extended ECM for SAP Solutions -
User Management and Access Control Scenarios (ERLK-CUM).
Note: The OTDS group can be in a different partition which must be non-
synchronized.
Content Server For Content Server groups, the partition is only appended if
groups OTExternalID2,OTExternalID3, or OTExternalID4 is defined as _NAME_
attribute. In this case, define the partition.
1. In the IMG, navigate to the OpenText Extended ECM for SAP Solutions >
Infrastructure > Maintain Extended ECM Connections activity and click
Execute.
• When synchronizing SAP roles to OTDS groups, enter the domain name.
• When synchronizing SAP roles to Content Server groups or business
policies, do the following:
Tip: To find the OTDS attribute value for the _NAME_ resource
attribute, go to Directory Services Integration Administration >
Configure Directory Services > Resources > Properties (for
Content Server) > User Attributes Mappings.
Note: For information about all relevant settings, see Section 8 “Mapping SAP
roles to groups” in OpenText Extended ECM for SAP Solutions - User Management
and Access Control Scenarios (ERLK-CUM).
Warning
If you select the Strict Group Membership option, you delete all OTDS
or Content Server users from the group, who are not also members of
the SAP role. Only OTDS or Content Server users, who have an
equivalent in the SAP role remain in that group.
You have the following auditing options for Extended ECM for SAP Solutions:
• ArchiveLink auditing
Relevant to all ArchiveLink operations in SAP, e.g. in the GOS attachment list.
• Content Server auditing
Relevant to business workspaces and Content Server operations.
• DocuLink auditing
Relevant to all DocuLink operations.
• License Cockpit auditing
Relevant for all operations during license measurement
• OAG1: Archive Link Basic Settings: Select the ArchiveLink Logging check box.
• OALOGCUST: Customize ArchiveLink Logging: Define what should be logged.
• OA_LOG_VIEW_DOC: Display Application Log for Documents: Selection and
display report (Authorization for S_WFAR_LOG authorization object required for
display).
To monitor user actions in DocuLink for certain projects and attribute objects, you
can specify a protocol in customizing. These actions are saved in the protocol table /
IXOS/DC_TBPROT. For more information, see Section 21.3 “Administrating the
protocol tables” in OpenText DocuLink for SAP Solutions - Customizing and
Administration Guide (DC-CGD).
• Open the following page: Core System – Feature Configuration > Event
Auditing > Set Auditing Interests.
• Select the following items: AL Create, AL Read, AL Update.
With the Extended ECM for SAP Solutions license measurement, you assess the
number and types of users who are working with an SAP system and Extended
ECM for SAP Solutions. License measurement for Archiving and Document Access
and Extended ECM for SAP Solutions can be integrated in the SAP license
measurement Global License Audit System (GLAS). With this information, you can
align your contract with SAP or OpenText to meet your requirements more
accurately.
Extended ECM for SAP Solutions license measurement consists of the following
parts:
Important
The authorization object J_6NLC_TYP is not used to grant access
permissions.
Note: A user is not locked, if the actual days of usage exceed the number
of days that are covered by the assigned license type. This mismatch is
noted in the license report.
The following license types are available, depending on whether they are sold by
SAP or OpenText.
Type Description
Licenses sold by OpenText
OXECMF OpenText Extended ECM for SAP – Professional User
OXECMO OpenText Extended ECM for SAP – Occasional User
OXECMB OpenText Extended ECM for SAP – External B2B User
OXECMC OpenText Extended ECM for SAP – External B2C User
OXECMN OpenText Extended ECM for SAP – Non-SAP User
ODOCF OpenText Document Access – Full Named User
ODOCW OpenText Document Access – Web Named User
ODOCO OpenText Document Access – Occasional User
OARCF OpenText Archiving – Full Named User
OARCW OpenText Archiving – Web Named User
OARCO OpenText Archiving – Occasional User
Licenses sold by SAP
SXECMF SAP Extended ECM by OpenText – Named User
SXECMO SAP Extended ECM by OpenText limited access option
SAP Document Access by OpenText – User: Business Expert, Ltd.
SDOCF
Professional
SAP Document Access by OpenText – User: Employee, Employee Self
SDOCW
Service (ESS) User
SARCF SAP Archiving by OpenText – User: Business Expert, Ltd. Professional
SAP Archiving by OpenText – User: Employee, Employee Self Service (ESS)
SARCW
User
SARCF2 SAP Archiving by OpenText
SARCO SAP Archiving by OpenText limited access option
SDOCF2 SAP Document Access by OpenText
SDOCO SAP Document Access by OpenText limited access option
19.2 Prerequisites
To use the Extended ECM for SAP Solutions license measurement, you must do the
following:
1. On the SAP system, create roles for each license type that you need with the
authorization object and appropriate license type, and assign them to the users.
2. In Content Server, assign the appropriate license type to the users of Extended
ECM for SAP Solutions. For example, a user who rarely needs to work with
business workspaces needs a different license than users that daily work with
business workspaces.
user who runs a license measurement needs a business role with the following
authorization objects:
2. Create a role for a user who runs license measurement according to the
information given in the table above.
3. On the systems which are called via RFC, create a role for communication users
who are called via RFC from a central license measurement system.
• Writing status, warning and error messages to application log object SLG1.
If validation issues have been found, this shows as a warning message in the log
of each function. You then must check the more detailed license report in
transaction /otx/license.
• Each function module contains an external ID referring to the related application/
product.
• The function modules call a central method of the OpenText license evaluation to
calculate the license counts.
Important
Add the following entries only if you purchased your licenses from
SAP. If you purchased your licenses directly from OpenText, set
Call? = false for all these entries.
Unit Measurement
1140 OT: Licensed User: Buss. Expert, Ltd Pro
1141 OT: Licensed User: Employee, ESS User
1144 OT: Licensed User: Buss. Expert, Ltd Pro
1145 OT: Licensed User: Employee, ESS User
1152 OT: User limited access option
1154 OT: User
Note: If there are conflicting license assignments for users, because one of
their groups has a different type, the most comprehensive license type is
counted.
Only users with the Access Business Workspaces privilege can access business
workspaces. Each time a user with this privilege accesses business workspace is
counted for the license measurement.
2. Edit the restrictions for the usage privilege Extended ECM Operation > Access
Business Workspaces (Mandatory for Licensing) according to your license
model. Mismatches between granted privileges and license type assignment are
displayed in the report.
Note: The SAP administrator who runs the license measurement has
administration rights in Content Server.
Standard Mode
Use standard mode for a simple scenario:
• The SAP client on which you run the license dashboard is the only system
that is being measured.
• The Content Server instance that is being measured is customized in the IMG
activity OpenText Extended ECM for SAP Solutions > Infrastructure >
Maintain Extended ECM Connections. You can select a Content Server if
more than one is configured.
Expert Mode
Use the expert mode for an system measurement of more than one SAP client
and possibly more Content Server installations.
You can use expert mode to include Content Servers that are connected to a
remote SAP system.
This section is only visible if Extended ECM is installed and Connection IDs are
maintained in the IMG activity.
Save your settings.
3. OpenText Products Sold by SAP That Have Been Licensed: Select if you
licensed OpenText Employee File Management (EFM) or OpenText Travel
Receipts Management for SAP Solutions (TRM). When you selected an option,
DocuLink projects that are recognized as EFM or TRM projects are ignored
when validating access permissions to DocuLink. In any case, TRM or EFM
DocuLink projects are listed in the license report.
4. Include OpenText Content Server: Select an option from the list of available
Content Servers. This list contains entries that are maintained in the IMG
activity OpenText Extended ECM for SAP Solutions > Infrastructure >
Maintain Extended ECM Connections.
Save your settings.
5. Click Start License Measurement and confirm the creation of the background
job.
The Status section informs you about the status of the measurement. Click
Refresh to update the status. If the measurement was performed without errors,
click Display Latest License Report to view the report.
For more information, see “Understanding the consolidated measurement
results” on page 364.
In expert mode, you have the following options how license data is retrieved for
consolidation:
• Direct transfer through RFC connection. The remote system must be available
during the measurement.
• Export an XML file from the remote SAP system and import it to the license
measurement cockpit inbox. Use this option if the remote system is not available
during measurement. You can either create and export file manually on the
remote system, save it to a disc, and then upload it to the measuring system, or
you can retrieve the export file through the RFC connection. In both cases, you
must make sure that the age of the retrieved license data does not exceed the
maximum age that you set for license data.
• Content Server connected to an SAP system.
This section is only visible if Extended ECM is installed and Connection IDs
are maintained in the IMG activity.
Save your settings.
b. OpenText Products Sold by SAP That Have Been Licensed: Select if you
licensed OpenText Employee File Management (EFM) or OpenText Travel
Receipts Management for SAP Solutions (TRM). When you selected an
option, DocuLink projects that are recognized as EFM or TRM projects are
ignored when validating access permissions to DocuLink. In any case, TRM
or EFM DocuLink projects are listed in the license report.
Activate / deactivate
Activate or deactivate an SAP client or a Content Server. Inactive systems
are only visible in the list of inactive systems. They are not deleted,
though. Measurement data that has been uploaded to the inbox for that
system, is invisible when the system is inactive. It is available again once
you activate the system.
New system
Create a system connection manually. Alternatively, create a destination
through an RFC destination.
For this, you need the following information. Most of the SAP related
information are available in transaction SLICENSE. Content Server related
information are taken from the Maintain Extended ECM Connections
IMG activity.
Edit entry
Edit an entry.
b. Confirm that you want to start a background job for this. While the
background job is running, License Measurement Cockpit is locked for
other activities.
You can use transaction SM37 to monitor the background job. The status of
the background job is also displayed in the title bar of the inbox.
a. Click Display Latest License Report to open the latest report in PDF
format.
c. Open the Consolidated Users tab to view a consolidated list of users from
all systems. For more information, see “Understanding the consolidated
measurement results” on page 364.
When you create the export file, the remote system must be available through an
RFC connection. The export file will first be uploaded to the inbox and then can be
saved to the local file system.
File types - Measurement data for an SAP system consists of one XML file of file
type SA. Measurement data of a Content Server consists of two files: Content Server
license info of file type CL and Content Server users list of file type CU.
Tip: If the measured system has no connection to the system where you are
going to do the actual measurement, and you cannot create the export file from
remote, you can do the following: In the License Measurement Cockpit of the
measured system, create an entry for an active SAP Client, and then create the
export file and save it to the file system or portable disk. Then import it to the
inbox of the measuring system.
3. Select the system, for which you want to create the export file.
5. On the Servers and Inbox for Measurement tab, click Export to File
System.
7. After the import, select a directory to save the export file to.
If you exported measurement data from a Content Server, two files are saved:
First a file of file type CL with the Content Server license, and immediately after
that a file of file type CU with user information.
Overview list
On the Status and Result tab, you see the results of the consolidated measurement.
Total number or users, grouped by license type.
Compressed list
On the Consolidated Users tab, you see the Compressed User List of
Consolidation. Users from the measured systems are grouped to unique ID's and
properties. Duplicate users were identified by matching login names. Partition
suffixes of Content Server logins are ignored so that they match the SAP user IDs.
Example: User login on the SAP system is PETER, and user login on Content Server is
peter@partition. Both logins are consolidated into one count.
Column Count of grouped user IDs contains the number of different logins from
the measured systems that were mapped to one entry in the compressed user list.
Complete list
Click Change view and select Grouped users to view the Complete User List of all
Measured Systems.
Important
If the source system is an SAP Client users with classification types T for
technical users and X for specifically excluded users were not transferred.
Also not transferred are users with invalid Valid from or Valid To dates in
the user management.
Aside from detailed information about the measured system and the user, this list
also contains license type information and the number of days in which the user has
used functions of Archiving, Document Access or Extended ECM. This information
is relevant for users with a license type for occasional users. If this number exceeds
52, an issue is displayed.
In single source systems, a license type of Extended ECM is sufficient for usage of
Archiving, Document Access or Extended ECM; a license type for Document Access
is also sufficient for usage of Archiving.
At least in one of the measured systems, the user has accessed Archiving, Document
Access or Extended ECM functions on more than 52 days in the past year but none
of his license types is sufficient.
The license type is assigned to SAP logins by roles. Due to the role assignment, it can
occur that a role related to more than one license type is assigned to a user login.
Validation issue type CL occurs if licenses sold by OpenText and SAP are maintained
at the same time for the same user login and client.
ID Description
CL Users with an OpenText license and an SAP
license
Important
As the consolidation merges data of duplicate users, it may be that in some
cases issues that were seen in the single source systems disappear. In other
cases, it may be that new issues are raised.
Example: Content Server user hmueller@ECM has no license type assigned and issue
XECM_NO_LICENSE was indicated.
SAP user hmueller has license type SXECMF Extended ECM Full User sold by SAP and issue
CL was found.
After consolidation, both user entries were identified to belong to the same person. The
resulting license type of this unique user is SXECMF. Therefore the issue XECM_NO_LICENSE
is no longer valid, which means that issue CA_XECM will not be raised for that unique ID. But
issue CL persists and is indicated as the inconsistency between seller models could still be a
source of error.
For each user, the license type of the highest priority is obtained from the values of
authorization object J_6NLC_TYP authorization object assigned to this user:
• Extended ECM > Document Access > Archiving
• Full > Occasional > Web
In addition, the program checks for access permissions of the user based on other
authorization objects:
• Archiving - S_WFAR_OBJ, S_WFAR_PRI
• Document Access - J_6NG_DATA (EFM, TRM projects excluded if licensing flags
for EFM and TRM are set), J_6NRL_SEA
• Extended ECM - J_6NRL_DOL, J_6NRL_WSC
License types for occasional usage are maintained when a user is accessing OpenText
applications only occasionally. This concerns, for example, ESS usage, usage as
Employee, or Web usage.
For license measurement, the maintained license type set in authorization object
J_6NLC_TYP is counted. At the same time, the access log entries not older than the
current date -1 year are cross checked in table /OTX/CL_T_ACCESS.
If the count of entries for a user login in a client is greater than 52, and the license
type is classified as a type for occasional usage, this causes a validation issue of type
CO.
Table 19-4: CO: Users with occasional license used the product on more than
52 days per year
ID Description
OARCO OpenText Archiving – Occasional User
OARCW OpenText Archiving – Web Named User
SARCW SAP Archiving by OpenText – User:
Employee, ESS User
The license type is assigned to SAP logins by roles. Due to the role assignment, it can
occur that a role related to more than one license type is assigned to a user login.
Validation issue type CL occurs if licenses sold by OpenText and SAP are maintained
at the same time for the same user login and client.
ID Description
CL Users with an OpenText license and an SAP
license
Data older than one year is not required and can be regularly deleted.
To delete log entries older than one year, run transaction se38 to start the
program /OTX/CL_MAINTAIN_ACCESS_LOG. It checks for ACTVT = 03 of
authorization object S_USER_GRP.
The data of this log table has no further relevance beyond license validation.
XECM_NO_LICENSE
User has access permissions to use Extended ECM features on Content Server but
has no sufficient license type.
XECM_MAX_ACCESS_EXCEEDED
User has an “occasional” license type but has accessed Extended ECM functions on
Content Server on more than 52 days in the past year.
XECM_MULTIPLE_SELLERS
License types sold by OpenText (type O) are mixed with license types of SAP
reselling (type S).
New: You can now transport business object types using the Content Server
Transport Warehouse.
You can use Content Server Transport Warehouse to transport one Extended ECM
for SAP Solutions configuration from one Content Server installation to another, for
example if you are using development, test and productive systems.
• Categories, classifications and folders
• Workspace types and variables for group replacement
• Workspace templates including workspace hierarchies, if available
• Unique names and unique name groups
• Business object types
For more information about the Transport Warehouse, see the Content Server online
help.
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 are prefilled with that suggestion. You can change
the node.
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.
You can chose what to convert first, binders or cases. In either case, your scenario
remains fully functional: You can have a business workspace that contains cases,
however you cannot create new cases in it. The same applies to binders that contain
business workspaces, which were converted from cases. You can create new
business workspaces in that binder, but you cannot create anymore cases in this
binder.
2. Find the binder/case template that you want to convert. You cannot convert
templates that contain nested binders or cases.
• Area: Template Workspace Area for which the case or binder template was
available. For more information about areas, see Section 6 “Administering
Template Workspaces Areas” in OpenText Template Workspaces - Installation
and Administration Guide (LLESCSB-IGD).
• Workspace Type Path: Workspace type for the new workspace template
• New Name: Name for the workspace template. You can enter a new name
or leave the suggested name, which has this format: <Name of the binder/
case template> <Name of workspace type selected>.
A new workspace template is created with the settings of the binder or case
template. Permission inheritance is set to Merge With Creation Location if you
did not select any area, or if the respective subtype of the selected area has this
value. For more information, see “Defining permission handling for business
workspace templates” on page 100.
The old template remains unchanged.
• Area: Workspace Area for which this binder and case is valid.
• Path: Path to a folder, binder or case, which contains items that you want to
migrate.
• Open: You are still working on it, the mapping will not be processed.
• Active: The mapping will be processed. To start the migration, see
“Running and monitoring a migration process” on page 375.
• In Progress: The mapping is currently being processed.
• Completed: The agent processed all binders and cases. For a detailed
result and possible errors, see “Running and monitoring a migration
process” on page 375.
2. Batch Size: Enter how many binders and cases you want to process in one
batch. If an error occurs, the process stops this batch and continues with the
next batch.
4. Select an option from the Refresh list to update the result lists.
The Overall Migration Status shows the sum of all migrated binders and cases. The
Migration Status table details this information per migration mapping. If an error
occurs, check the log file for more information. The log files are located in <OpenText
home>\logs\migration_logs\. If an error occurs during migration, it will be
always logged even if logging is turned off. You can filter the Migration Status
table, for example, to see only the entries of the last seven days. You can also sort the
table by creation date.
3. Click Submit.
Once the migration starts, you can see log files under in <OpenText home>\logs\
migration_logs\.
Important
The business object declaration must be maintained before the report can be
executed; see also “Creating a business object declaration in SAP”
on page 44.
The search help, which is configured in the business object declaration, must
not have a Search Help exit. Search helps with search help exits are not
supported for batch creation.
Prerequisites
• The OTEXRL software component and the OTX namespace must be set to
modifiable using the SE03 transaction.
• Your SAP user must be registered as a developer.
c. Click Execute.
The generated report has the name /OTX/RM_WSC_CREATE_<business
object>; by default it is added to the /OTX/RM_WSCG package and inserted
in a transport request.
2. Run the report that you created to actually generate the workspaces:
g. Click Execute.
If not simulated, the specified workspaces are created or updated in
Content Server.
• With synchronous processing: errors that may occur are added to the
error queue and logged in the SAP log, which you can access with the
SLG1. At the end, the batch process returns status and error information
for each workspace that was or was not created.
• With asynchronous processing: the asynchronous queue processes the
batch declaration, status information and errors are logged there as
well. For more information, see “Monitoring the asynchronous queue”
on page 133.
3. Select the Update properties check box to update ArchiveLink entries that have
already been declared.
Tip: If you selected a large amount of data, run the report in the
background using the Execute in Background command from the
Program menu.
4. Click Execute.
5. Click Execute.
The output shows ArchiveLink entries that have been placed in the asynchronous
queue. Green indicates that an entry in the asynchronous queue has been created.
You can use the asynchronous queue to monitor the actual processing of the
declaration. For more information, see “Monitoring the asynchronous queue”
on page 133.
The following parameters are displayed:
BLOCK NUM
ArchiveLink entries are declared in blocks; this is the block number.
BLOCK IDX
The number within a block.
Message
Error message for an ArchiveLink entry.
3. Select the Update properties check box to update entries that have already been
declared.
Tip: If you selected a large amount of data, run the report in the
background using the Execute in Background command from the
Program menu.
4. Click Execute.
The output shows the processed entries; icons signal the result of the declaration.
Entries which are ignored are already records.
The following parameters are displayed:
BLOCK NUM
Entries are declared in blocks; this is the block number.
BLOCK IDX
The number within a block.
Message
Error message for an entry.
Note: If you used asynchronous processing for the batch job, you must use the
asynchronous queue monitor. For more information, see “Monitoring the
asynchronous queue” on page 133.
3. Click Execute.
Besides the standard SAP job attributes the number of processed entries, their
process status and the current declaration rate/minute are tracked. These values
are updated during the job execution. Click Refresh to display the most current
values.
4. Click Job Details to access the SAP standard job overview, job log and spool
functions.
For the report to run, you must select the Delete notifications option in your
Enterprise Library application. For more information, see Section 24.4 “Creating an
Enterprise Library application” in OpenText Extended ECM for SAP Solutions -
Installation and Upgrade Guide (ERLK-IGD).
To schedule a job:
1. Navigate to the Extended ECM > Document (ArchiveLink) ... > Schedule Job
Removing Deleted Records activity and click Execute.
2. Define the job and schedule it. Create a variant for each connection ID.
3. Click Step.
5. Click Save.
Important
You can run the infrastructure diagnostic program after specifying at least
the Extended ECM connection in the Infrastructure section of the IMG.
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 388.
Note: You can also run the Diagnostic Program as a background job.
3. Click Execute.
Note: For the Infrastructure part of the Diagnostics Program, see Section 26.1.2
“Understanding the details of the Diagnostic Program” in OpenText Extended
ECM for SAP Solutions - Installation and Upgrade Guide (ERLK-IGD).
BO Declarations
Are there business object Extended ECM > Maintain “Creating a business object
declarations for this Business Object declaration in SAP”
connection ID? Declarations on page 44
Document Declarations
Are there document Extended ECM > Document “SAP: Creating a document
declarations for this (ArchiveLink) ... > Maintain declaration” on page 196
connection ID? Document Declarations
Are there assignments for Extended ECM > Document
these document declarations? (ArchiveLink) ... > Assign
Declaration ID to Object
Type and Document Type
Are there automatic Extended ECM > Document
assignments? (ArchiveLink) ... > Assign
Declaration ID to Object
Type and Document Type
Item Types
Is the “otx.sap.rm.Folder” OpenText Administration Section 24.12.2 “Importing
folder type present? Client > Enterprise Library folder and item type” in
Services server > Enterprise OpenText Extended ECM for
Library Services > SAP Solutions - Installation
Document Model > Folder and Upgrade Guide (ERLK-
Types IGD)
or rather
Does the folder type have a “SAP: Creating an Enterprise
default classification? Library item type and
Is the OpenText Administration additional categories for a
“otx.sap.rm.Document” item Client > Enterprise Library specific property provider”
type present? Services server > Enterprise on page 190
Library Services >
Document Model > Item
Types
Is the
“otx.sap.rm.SystemArchiveLi
nk” item type present?
Is the
“otx.sap.rm.SystemPrintList”
item type present?
Use Widgets in UI “Using the Content Server
Integration Widget“
on page 225
Is the “Support Directory” Infrastructure > Maintain Section 23.2.5 “Maintaining
provided for business objects Extended ECM Connections Extended ECM connections”
declarations using Widgets in OpenText Extended ECM for
in UI? SAP Solutions - Installation
and Upgrade Guide (ERLK-
IGD)
Are parameters for Widgets See detailed error message if
available? applicable.
Is the OTDS REST Service
available?
For SAP ERP or SRM only: Is Check if software component “Prerequisites” on page 226
the class SAP_UI is 740 or later.
CL_WD_HTML_ISLAND
available?
For SAP CRM only: Is the “Prerequisites” on page 226
WEBCUIF 701 component
available?
Roles
Does the current SAP user Checks the permissions of Section 23.1.2 “Assigning
have sufficient permissions the current user SAP roles” in OpenText
in SAP to declare records? Extended ECM for SAP
Solutions - Installation and
Upgrade Guide (ERLK-IGD)
Does the current SAP user Checks the permissions of Section 23.1.2 “Assigning
have sufficient permissions the current user SAP roles” in OpenText
in SAP to view record Extended ECM for SAP
details? Solutions - Installation and
Upgrade Guide (ERLK-IGD)
1. In the IMG, navigate to the Extended ECM > Configuration Report activity and
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 “Creating business workspaces and
declaring document asynchronously” on page 129.
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):
In addition to the standard values you can also enter the user who failed in the
declaration process (Error created by field) and the date of the error entry (Error
created at field).
3. You may process the records either in the manual or in the automatic mode:
Proceed as described under Step 3 on page 391 or Step 4 on page 392,
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.
/OTX/TEST Test
/OTX/UPD Update events
/OTX/WSSET Read, create, or update business workspace
/OTX/CRM SAP CRM related issues
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 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.
For Extended ECM for SAP Solutions, the following information has been added at
the end of the report:
Tip: You could use this report to compare two system environments, for
example the development system and the production system.
2. Select either the Lite System Report or the Full System Report option.
3. Click Generate.
Caution
Depending on the size of your system, the Full System Report may take
some time to be generated.
The generated report is a text document, called sysreport.txt, that resides in the
logs directory of your Content Server installation. When you finish generating a
System Report, the file path to the location where the file resides appears in the File
Path section on the Content Server System Report page. You can click the System
Report's link to access the report.
If a System Report has already been generated, a link to the most recently generated
report will appear as part of the header on the System Report page. To get the most
current version of the System Report, you must generate the report again.
Notes
• To use logging in Content Server in general, you must enable it: On the
Content Server Administration page, click Core System - Server
Configuration > Log Settings, and select log levels, for example, 2 – INFO
for Thread Logs.
• Changing the log level settings does not require a restart of the Content
Server services. You set the logging for the current Content Service instance
not for other instances of the Content Server.
1. Open OpenText Administration Client and login to the server where Enterprise
Library Services is installed.
2. Navigate to Enterprise Library Services > Configuration and adjust the
following value:
logging.OTDS.level = TRACE
3. Start the Directory Services web administration client in a web browser. Open
http://<fully_qualified_domain_name_of_server:<port_number/otds-
admin/ and sign in.
4. Sign in as otadmin@otds.admin.
5. From the web administration menu, under the Info heading, click System
Status.
If you can stop and restart the system, you can generate a specific log files that
contain exactly the information that OpenText Customer Support needs to analyze
the problem.
6. From the logging directories <Content Server home>\logs and <Tomcat home>
\logs, delete all files, including those in subdirectories of the \logs directories.
Note: Do not delete the logs directory itself; any subdirectories under it
can be deleted.
7. Restart the following services so that the above changes take effect:
10. Optional If OpenText Customer Support asked you to generate a Content Server
system report, do it now. For more information, see “Understanding the
Content Server System Report” on page 398.
11. Stop the Content Server (OTCS), Content Server Admin (OTCSAdmin), Content
Server Cluster Agent, and Tomcat services.
12. Go to the <Content Server home>\logs directory and zip all files in there.
14. Reset the original logging settings. On the Content Server Administration page,
click Core System – Server Configuration > Log Settings and set the log level.
15. Restart the Content Server (OTCS), Content Server Admin (OTCSAdmin) and
Tomcat services.
16. Contact OpenText Customer Support on how you can provide them with the
zipped log files.
1. On your Content Server server, open a command prompt window and navigate
into the <Content Server home>\bin directory.
2. Start the following command, where <cs-home> is the root directory of your
Content Server installation.
OTUpdateAnalyzer.bat -m <cs-home> -c
3. After the script completed, you can open the report in your default web
browser. When prompted, type y and press ENTER.
4. Navigate into <Content Server home>\temp\OTUA and copy the files that
include the date on which the report was run, for example
OT_DELTA_REPORT_1372769971871.csv or
OT_DELTA_REPORT_1372769971871.html.
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
“Understanding the Content Server System Report” on page 398.
• Connected Workspaces module on Content Server
On the Content Server Administration page, click Core System – Module
Configuration > Install Modules. You see the version of the module next to its
name, for example, 16.2.0.
• 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
“Understanding the Configuration Report” on page 390.
• 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
numbers of OTEXBAS, OTEXERP, OTEXRL, OTEXRLC, OTEXRLS, OTEXBASO,
OTEXBASF, OTEXRLO, and OTEXRLF, you can use this instead of the
configuration report.
• SAP Fiori apps
For each application, there is a static version.html file, which includes the
version number. To retrieve the file, enter the following in a browser:
http(s)://<SAP hostname>:<SAP port>/sap/bc/ui5_ui5/otx/<subpath of
fiori app>/version.html
22.6 Troubleshooting
Troubleshooting describes some commonly encountered problems, with solutions or
tips on how to avoid them. For further information on known problems for your
Extended ECM for SAP Solutions version see the corresponding Release Notes in
OpenText My Support.
• Verify that there is a corresponding Content Server user for the SAP user.
Cause Time difference between the SAP server and the Content Server server.
Solution Verify that time settings of the SAP server and Content Server (RCS Server) are
identical.
It is recommended to use a time server to keep time settings of SAP and Content
Server identical.
In case of a virtualized server, modify the time settings of the respective real server,
as the virtual server draws its time settings from the real one.
Solution If you experience problems with viewing certain document types, add the fax
extension as an alternative to the image/tiff entry in the config\mime.types file
of OpenText Content Server.
Solution In the business object type definition, select a workspace type for default display.
For more information, see “Configuring a basic business object type” on page 111.
Solution
SAP system
Content Server
System Report: “Understanding the Content Server System Report” on page 398
Contains the complete configuration information of the Content Server system.
Look for the “Extended ECM Information” section.
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.
attribute
BAdI
See Business Add-In (BAdI).
Window in SAP ERP that contains content, which is related to the business object.
The Business Content window can be opened in an SAP ERP system from the
Generic object services (GOS) menu of a business object. The Business Content
window displays the business workspace and its content, business attachments,
business documents (ArchiveLink), notes and local files.
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.
Configuration item for business objects in Content Server. The business object
type describes the structure of the data. A business object type in Content Server
has its counterpart in the business application.
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 workspace
Content Server item that contains documents and other items which are related to
a business object.
category
Classic UI
See Classic View.
Classic View
Content Server user interface with folders, function menus and sidebars. As
opposed to Content Server Smart View.
See Also Smart UI.
classification
Connected Workspaces
Content Server module that enables the use of business workspace with or
without a connection to a business application.
declaration
See document declaration.
document declaration
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
See workspace templates.
SAP: Functions that are not application-specific and can generally be used for any
business object, e.g. creating or displaying the business workspace.
GOS
See Generic Object Services (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
Content Server module that controls documents and other objects based on rules
and classifications. Compliance and other legal regulations require that
documents have a controlled life cycle, that they are archived, that they can be
frozen, or that they are deleted after a certain time. Records Management also
controls access to the documents. To set a document under the regulations of
Records Management, it is declared as record.
OSS notes
See SAP Notes.
OTDS
See OpenText Directory Services (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
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
See OpenText Records Management.
Records Management
See OpenText Records Management.
relationship
RFC service
A program used for communication between the SAP application and the archive
system via RFC (Remote Function Calls).
SAP Notes
A tool for customizing in the SAP system, opened with the SPRO transaction.
sidebar widget
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
See Smart View.
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.
See Also Classic UI.
SPRO
See SAP Reference IMG (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
workspace templates
Basis for new business workspaces that are managed with Extended ECM for
SAP Solutions. 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.