Professional Documents
Culture Documents
DC160208-UGD-EN-01
User Guide
OpenText™ DocuLink for SAP Solutions
DC160208-UGD-EN-01
Rev.: 25. Mar. 2019
This documentation has been created for software version 16.2.8.
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 DocuLink for SAP Solutions? ................... 7
5 Navigating ................................................................................ 25
5.1 Navigating in the tree ...................................................................... 25
5.1.1 Expanding nodes ............................................................................ 27
5.1.2 Hiding nodes .................................................................................. 27
5.2 Viewing Details ............................................................................... 28
5.3 Displaying hit lists ........................................................................... 29
5.4 Displaying hit lists in tree view .......................................................... 30
5.5 Displaying original documents .......................................................... 31
5.6 Accessing SAP transactions ............................................................ 32
5.7 Refreshing the display ..................................................................... 32
5.8 Getting more values for a restricted number of hits ............................ 32
5.9 Starting GOS .................................................................................. 32
5.10 Using list view ................................................................................. 33
5.11 Launching DocuLink Web UI ............................................................ 34
5.12 Browsing in DocuLink Web UI .......................................................... 34
5.13 Browsing thumbnails for fast document retrieval ................................ 35
5.14 Using button tool bar and context menu in DocuLink Web UI ............. 38
OpenText DocuLink for SAP Solutions (short: DocuLink) is a fully integrated, cross-
module application used for a document-oriented representation of processes
executed with SAP applications.
DocuLink makes it possible to store, administer and retrieve both SAP documents
and any other types of document, independently of transactions in the SAP
standard. This data may either be stored in a database or may already be stored on
an archive server (e.g. as a result of the reorganization of data). By default, access is
performed via the SAP GUI for Windows or the SAP GUI for HTML.
One of the most important objectives of DocuLink is the ability to provide a method
of displaying and retrieving documents to be administered which is flexible and can
be easily adapted to suit the requirements of individual users. A traditional search
dialog is used to locate documents and a browser to navigate through the
hierarchical structures (similar to folders). This makes use of the advantages of a
paper folder, but eliminates many of the disadvantages (i.e. only one sort sequence).
You can define different search forms and structures (so-called views) for the same
document pool.
Target readership
The user guide is designed for end users and provides detailed information about
the procedures and options available when working with DocuLink.
2.1 Attributes
When they are archived, documents are associated with attributes that are
subsequently used to retrieve documents. Attributes may also exist independently of
documents. Documents can be associated with attribute records and attribute
records linked to other attribute records. (An attribute record contains concrete
values used to provide a detailed description of an object, e.g. an invoice receipt has
a document number, a company code, a year, and a date).
2.2 Nodes
Data can be accessed not only via table fields as in conventional search methods but
also by navigating through a browser-type structure. The individual hierarchical
levels are defined by so-called nodes.
2.3 Folders
Due to the independent representation of the attributes, it is possible to map
logically associated document sets together in a so-called folder structure. In order to
access a group of associated SAP documents (e.g. order documents, goods receipt
documents, invoice documents and accounting documents etc.) you no longer need
to know the relevant SAP standard transaction. It is possible to display documents
associated with the current attribute records.
There is a basic distinction between structuring folders and folders which mask an
SAP document or other document.
You are, however, able to edit customer tables. In particular, write access is possible
if it should be required.
2.4 Views
In most companies, several employees need to access the same documents, albeit
from different perspectives. One person requires a general overview, another is
searching for a particular document and already knows, for example, the customer
number and archive date. For this reason a number of different search paths can be
configured in DocuLink. These are called views or access paths.
In this way, a document can be accessed via various (search) paths. The figure below
illustrates how you can navigate through different views in DocuLink.
Different search paths leading to the same data source(s) are usually displayed in
different views belonging to a common project. If there is no interdependence
between the employed data sources then a separate project should be set up for each
data source.
Our Linked objects sample project features a product table containing information
relating to various products, and a customer table which contains information (e.g.
addresses) and documents relating to the customers. The customers themselves are
divided into three classes: Computer industry, trade, and car industry. These tables
are linked by the relationship between customers and (purchased) products.
• Products and Customers (e.g. which customer has bought what products)
• Linked products (e.g. which products are based on other products)
• Customer classification which explains the use of the @LANGU internal
selection field.
In the following examples, we shall refer mainly to the Products and Customers
view.
The Products and Customers view has been designed to visualize different access
paths to the same (link) table. On the one hand, it can be accessed via the products
(“Who already purchased this product?”) and on the other, via the customers
(“What has this customer purchased?”). In this way, a number of products can be
assigned to each customer, and likewise a number of customers to each product.
This represents an M:N relationship.
Caution
Due to technical restrictions, not all DocuLink functions are available in the
different visualizations. Note the respective limitations indicated in the
following chapters.
SAP system SAP GUI for SAP GUI for HTML DocuLink Web UI
Windows
SAP Netweaver 7.0, Yes Yes Yes
EHP1 for SAP NW
7.0, EHP2 for SAP
NW 7.0, EHP1 for
SAP NW 7.3, SAP
NW 7.40 = ERP 6.0,
EHPx for ERP 6.0,
CRM 7.0, EHPx for
CRM 7.0, SRM 7.0,
EHPx for SRM 7.0
In the following chapters you will get an overview of the functionality supported by
DocuLink. As DocuLink uses different visualizations, the descriptions are grouped
according to the respective user interface.
Note: Since the functions of DocuLink can be customized to a large extent, you
may not be able to access all functions described in the following.
You can invoke DocuLink using various methods which depend on the visualization
used:
2. Specify the J6NY transaction in the command field or select it in the list of
favorites.
• Hierarchy area
with the navigation tree listing the nodes depicted by folder icons.
• Document area
lists the documents assigned to the data records (if available) in the relevant
application. For Content Management (CM) documents, only the familiar CM
functions can be used here.
Tip: You can access only the views that you are authorized to see.
To add DocuLink to your list of favorites, right-click the favorites folder in the
SAP GUI and select Insert transaction from the context menu.
3. Click Open transaction field and specify the J6NY transaction in the transaction
field or select it in the list of favorites.
Note: The standard Web browser Next and Back buttons are not supported by
DocuLink Web UI. When you click Refresh, the starting page of DocuLink
Web UI is displayed.
Nodes are the basic elements of a DocuLink hierarchy. Normally, you work on node
level when you create new records or documents, or edit existing ones.
Depending on the type of node, different functions are available. Thus a warning
may appear on the toolbar or in a special window indicating that the operation is not
permitted for this particular node.
Tip: In addition to the icons in the toolbar, you can use the corresponding
(context) menu items or the key combinations given in the menu to trigger an
operation. In the following, however, only the icons are described.
Note: The standard node functions in DocuLink are also available for Content
Management (CM) objects. However, for some functions you must use special
icons, see “Integrating SAP Content Management Functions“ on page 81.
To open a project:
To open a node:
2. Click the folder name or the folder icon to select a node in order to perform a
function.
A selected node is highlighted. A document node becomes a link to the
document after selecting it.
• Click to see the additional nodes for the views that have been set up.
1. Click Another view and select the required view from the selection list.
2. When you have already displayed different views, click Previous view or
Next view to switch between these views.
As soon as a node is expanded in the tree, the resulting contents are stored in the
cache. When you close and then re-open the same node later, the contents is not
generated again from the actual data source, thus accelerating the display.
In addition, the system 'remembers' the status of the subnodes, so when you expand
a node again, it displays the same subnodes as the last time it was expanded.
Important
This only applies when the node was expanded or collapsed using the icon.
When you double-click a node name, the selection is performed again. This
method is recommended when the data in the data source is likely to have
changed, although it may slow down operation.
To expand nodes:
Important
With large volumes of data this function may slow down performance!
To hide nodes:
Tip: To see these nodes again, either click the Refresh or close and reopen
the parent node twice.
To display details:
2. Click Detail .
Alternatively, you can double-click the node (if not configured otherwise; not in
DocuLink in Web).
The properties of the record are either displayed in a separate window or in the
same one, depending on the configuration.
2. Deselect the fields in the Field selection column that you do not want to
display. To display a field again, select the respective checkbox.
Optionally, select all the fields simultaneously ( ) or deselect them all ( ) by
clicking the respective button.
All the fields that are checked are displayed in the detail screen.
3. Click Accept .
Tip: Hit list generation can be run in the background. This saves time and
you can continue work while the function is running. To do this, click Hit
list in background instead of Execute. This opens the standard dialog box
for setting up background processes.
To expand the nodes of the separate hit list further, click the associated node icon.
The hit list is then replaced by a list of subnodes. To return to the hit list, click Back
.
Tip: The representation of objects from the hit list can be modified to suit users'
requirements using a range of functions, see “Changing the display”
on page 60.
3. Enter the criteria, if necessary using the standard selection functions (see
“Selection functions” on page 52).You can also define and use user-specific
variants (see “Variants” on page 53).
4. Click Execute .
Tip: Hit list generation can be run in the background. This saves time and
lets you continue working while the function is running. To do this, click
Hit list in background instead of Execute. This opens the standard dialog
box for setting up background processes.
You can expand the nodes of the hit list and use the usual DocuLink functions on
these nodes. Furthermore, some functions are available to change the display, see
“Changing the display” on page 60.
3. When a selection list with several different documents appears, select the
required documents and click Display original.
When you access archived data executing this function, the SAP transaction is not
started. Instead, you will see the associated business or technical view.
To refresh display:
• Click Refresh .
Using GOS, you can also display Content Server documents. To do so, select the
Attachment list option from the context menu of a node which is configured
accordingly, and then select the required document.
Note: This function is only available in the SAP GUI for Windows
visualization.
Since the list view represents an extract from the hierarchy which, unlike a genuine
hit list, contains no implicit structure information, the node names configured for the
subnodes are used as the column titles.
Note: Certain functions are not available in the list view because of its non-
hierarchical structure.
The basic element of the DocuLink Web UI hierarchy is a row in the Search Results
table; each row represents a node or a document.
Tip: To additionally display the Tree View in DocuLink Web UI, click to the
very right of the heading bar and select Show Tree. Repeat this action to turn
the Tree View off again.
In addition to the table hierarchy, DocuLink Web UI offers navigation with the
breadcrumb mechanism. The breadcrumb line above the Search Results table will
help you to identify your current position in the levels and sub-levels within a node.
You can click any of the breadcrumb elements to go directly to the respective level.
Notes
• Using the standard BACK button or shortcut of your browser will result in a
display error in DocuLink Web UI.
• Depending on the customizing done by your administrator, the DocuLink
Web UI might look different on your system.
3. Click the to the very right of the heading bar and select Thumbnails.
The pages of the documents in the node are displayed as thumbnails.
Notes
• You can navigate through the document folder like in the list view.
Folders are displayed in the thumbnails with a folder symbol. To open
the folder, click the symbol.
• To switch off the thumbnails view and return to the list view, click the
View link on the right of the heading bar.
TXT
Text document format
PDF
Adobe Reader document format
OTF
SAP output text format
ALF
SAP print list format
TIF
Tagged Image File format (graphics)
FAX
Graphic format
PNG
Portable Network Graphics format
JPG
Graphic format
GIF
Graphic format
Page tab
Displays the current page.
Notes tab
Displays notes on the current document, if there are any.
Zoom In/Zoom Out
You can increase or reduce the size of the page in the Page tab.
Layout
You can switch between Vertical and Horizontal layout of the thumbnails.
Default value: Horizontal
Thumbnail size
You can switch between Small, Medium and Large thumbnail size. Default
value: Small
Previous/Next
The thumbnails hit list shows only a certain number of documents at a time. The
actual number depends on the settings of the system. You can navigate between
the displayed documents, using the Previous and Next buttons.
More hits
Displays the next portion of a hit list exceeding the current page display.
Refresh
Refreshes the current view and returns to the first hit list of pages.
Note: Since the configuration of DocuLink can be changed, you may not be
able to access all functions described in the following.
Tool bar The tool bar in DocuLink Web UI provides the following buttons:
Up
Goes to the next higher level.
Create
Adds new records and documents with in the SAP system.
Delete
Deletes the selected document(s).
Copy
Copies the selected element to a new location within the SAP system, see
“Moving and copying elements in DocuLink Web UI” on page 46.
Move
Moves the selected element to a new location within the SAP system, see
“Moving and copying elements in DocuLink Web UI” on page 46.
Display Original
Displays ArchiveLink and Content Management (CM) documents.
Refresh
Rebuilds the page display.
More hits
Displays the next portion of a hit list exceeding the current page display.
Context menu In addition to the buttons in the tool bar, you can use menu items from the context
menu (indicated by next to the folder/document) to trigger an operation.
Note: Some of the context menu items are also available in the tool bar. They
are described in “Tool bar” on page 38.
• Editing a record
• Creating an element
• Moving an element
• Copying an element
• Deleting an element
For CM hierarchy nodes you can only change the document properties or attributes
with this function, not the document itself. To edit the actual document, see “Editing
a CM document and/or create a new version” on page 87.
Tip: In DocuLink Web UI, the navigation path above the input fields
indicates your current position in the list.
3. Perform the required changes; fields that cannot be edited are grayed out.
Important
Only those fields that were neither defined as key fields in the table nor
have a structuring function in the hierarchy may be edited. The key fields
are used to uniquely identify a data record. Fields that cannot be edited
are grayed out.
4. Click Accept to confirm your changes.
In the user settings, you may also specify that when a record is changed, any
document assigned to it automatically opens (see “Other functions and settings“
on page 93). When you make further changes to the same record, the system asks
you whether you want to reopen the document again.
• Create data record: Create a new data record without an assigned document. For
more information, see “Creating data records in SAP GUI” on page 40).
• Create several data records: Create several data records of the same type in the
same position in the tree, successively; in this case, the create screen remains
open after creating a new element (see “Creating data records in SAP GUI”
on page 40).
• Create and archive one document: Create a data record and simultaneously
archive an assigned document. For more information, see “Creating and
archiving documents” on page 42.
• Create and archive several documents: Create a data record and simultaneously
archive a number of assigned documents consecutively. For more information,
see “Creating and archiving documents” on page 42.
Note: In the SAP GUI for HTML visualization, it is not possible to create
documents.
1. Navigate to the position in the tree where you want to create a new element.
2. Click Create .
A selection box with the available elements is displayed. In addition, an option
allows you to create a copy of the selected element, i.e. the input fields of the
new element are already filled with the values of the currently selected element.
4. Enter the necessary data for the corresponding element in the Create dialog,
especially in the mandatory fields highlighted by color. All other fields are
optional.
6. To create several records of the same type in the same position in the tree
Click Create several records .
The entered field values are transferred and the record is created. This is
confirmed by a message in the status bar. Now you can create as many records
as you like, one after the other:
a. Repeat the process described above; enter the record values and click .
b. After the last record, click Cancel to close the Create dialog.
1. Select the record you wish to use as a template and click Create .
When you select the element as copy from the selection list the first time, and
after entering the values you click Create several records, the values of the
selected element are preset for each further element. However, you can click
Delete entire selection to delete the preset settings.
1. Navigate to the node in the tree to which the document shall be assigned.
2. Click Create .
Depending on the configuration, a selection box with the available elements is
displayed.
3. Select a document.
4. Select the required archiving scenario, e.g. file import via DesktopLink.
Depending on the selected archiving scenario, different steps may follow to
store the document, e.g. scanning or file selection (see “Importing documents“
on page 67).
Tip: For more details on the different archiving scenarios see “Importing
documents“ on page 67.
5. Assign a document type to the document by selecting a type from the selection
list.
6. Click Accept .
The document is inserted in the required position in the tree.
After you exit the creation dialog box, the newly created documents are displayed in
a different color. This color is reset when you refresh the display.
1. Navigate to the position in the tree where you want to create a new data record
with a document.
2. Click Create .
A selection box with the available elements is displayed. In addition, an option
allows you to create a copy of the selected element, i.e. the input fields of the
new element are already filled with the values of the selected element.
3. Select the required element for the data record in the dialog.
4. Enter the necessary data for the corresponding element in the Create dialog,
especially in the mandatory fields highlighted by color. All other fields are
optional.
When you selected Create and archive one document the create dialog is closed
and the newly created record with the document is displayed in the tree.
8. When you selected Create and archive several documents, the record with the
document is displayed in the tree, however the create dialog remains open.
Now you can assign another document to the same record.
Depending on the selected archiving scenario, perform one of the following:
a. Select an option for the archiving scenario for the next document in the
dialog:
In the hierarchy, the new data records (possibly with a document) are displayed in a
different color after you exit the create dialog. When no document node exists, the
value table node for which a document was archived is highlighted and the
archiving information is displayed in the status bar. This color is reset when you
refresh the display.
1. Navigate to the position in the list where you want to create a new element and
select the corresponding node.
2. Click Create in the toolbar of the list control and select the type of data record to
be created.
Tip: This function is also available from the context menu of the selected
element.
A dialog with the data available for the new data record is displayed.
3. Enter the necessary data for the new element in the Create dialog, especially in
the mandatory fields highlighted by color. All other fields are optional.
4. To add an attachment, click Browse to navigate to the document that you want
to archive.
Click Attach to transfer the document to the Current file attachment(s) field.
5. If prompted, select the document type from the drop-down-list. In case you
have chosen a wrong document type, click Remove to remove it.
6. If required, repeat the procedure using the Browse and the Attach button to
add more files.
7. Click Create.
The data record with the document(s) is inserted in the required position in the
list
To archive documents:
1. Navigate to the node in the list to which the document shall be assigned and
select the corresponding node.
2. Click Create in the toolbar of the list control and select the type of document to
be created.
Tip: This function is also available from the context menu of the selected
element.
3. To add an attachment, click Browse to navigate to the document that you want
to archive.
Click Attach to transfer the document to the Current file attachment(s) field.
4. If prompted, select the document type from the drop-down-list. In case you
have chosen a wrong document type, click Remove to remove it.
5. If required, repeat the procedure using the Browse and the Attach button to
add more files.
6. Click Upload.
The document is inserted in the required position in the list.
Notes
• Locked (i.e. checked out) CM documents remain locked after moving. On the
other hand, copies of locked (i.e. checked out) CM documents are no longer
locked after they have been inserted.
• Copying between different SAP systems is not possible.
2. Drag the selection to the required position in the tree and release the mouse
button.
2. Keep the CTRL key pressed, drag the selection to the required position in the
tree and release the mouse button.
To move a document:
2. Click Move.
The Move View dialog opens.
3. In the Move to field, use the breadcrumb trail to navigate to the target folder
you want to move the document to.
4. Click Move.
5. If prompted, select a document type from the drop-down list and click Move.
The document(s) is/are moved to the selected folder.
To copy a document:
2. Click Copy.
The Copy View dialog opens.
3. In the Copy to field, use the breadcrumb line to navigate to the target folder you
want to copy the document to.
4. Click Copy.
5. If prompted, select a document type from the drop-down list and click Copy.
The document(s) is/are copied to the selected folder.
The same applies to linked documents. When you specify a record for deletion
without the assigned document, you are first asked whether you also want to delete
the original. If you do not want to do this, you cannot delete the associated record,
either.
Before the deletion takes place, you are asked whether you really want to delete the
records. The number of records marked for deletion is also displayed for checking
purposes. The question is then repeated for the documents you selected for deletion.
Deleted data records and documents are initially moved to a special table. It is then
the administrator's responsibility to delete them completely (see OpenText DocuLink
for SAP Solutions - Customizing and Administration Guide (DC-CGD)). Until this
happens, deleted records can still be 'rescued' and restored by the administrator.
Tip: CM documents that have been locked (i.e. checked out) by another user
cannot be deleted.
2. Click Delete .
Alternatively, press the DEL key.
3. Confirm the message whether you really want to delete the record by clicking
on Delete.
4. Confirm the message whether you really want to delete the assigned document
by clicking on Delete.
The selected record(s) or document(s) are deleted and disappear from the tree.
2. Click Delete.
3. Confirm the message whether you really want to delete the items by clicking
Yes.
The selected record(s) or document(s) are deleted and are not displayed any
more.
When you want to create a hit list or a selection was set up on a node in the
hierarchy tree to restrict the volume of data to be displayed, a drill down screen
appears, also called a selection screen.
1. Double-click the node you want to display. The selection screen appears.
2. Enter the required values for the selection to restrict the number of displayed
entries. To do so, you can use the selection functions and/or variants as
described below.
3. Click Execute .
When you display separate hit lists, you can execute the selection in the
background, so that you can continue to work in the foreground during an
extended selection process. In this case, select Execute in background.
The standard procedure for starting background processes then follows.
In DocuLink Web UI, selection screens are used to restrict the number of displayed
entries.
1. Enter the search criteria; you can search both for single values and for value
ranges. To search for ranges, enter threshold values in both fields in a row.
2. To display a list of possible entries, click to the right of the search field, if
available. In the list of possible entries, double-click an entry to fill it in the
search field.
Selection options)
Invokes standard SAP selection options (such as Greater than, Less than,
Single value, Not equal to).
Delete selection
Deletes a single entry in the field and restores the last value saved.
Multiple selection
Allows a multiple selection in a selection screen, for instance to select several
individual objects or sequences of object numbers. This uses the SAP standard
dialog for multiple selection. It contains four tabs where you can specify or
exclude individual values or ranges of values.
In the example, the single values OpenText Document Access for SAP and
OpenText Archiving for SAP Solutions are entered as multiple selection
values for the product name. Use Check to test whether the entries you
made are correct. Click Accept to close the multiple selection screen.
Click Accept again to close the selection screen. The result of this selection
can be seen here:
7.2 Variants
You can save the entries for a selection screen that is used on a regular basis in a
user-specific (personal) variant. This way, you can access it directly for the next
retrieval and do not have to enter all the values again.
If other users require the same entries, you can save the variant globally (provided
you have the correct authorization) and make it available to all users. The next time
you make a selection, you can choose this type of pre-defined variant. The input
values are then entered in the appropriate selection fields.
To create a variant:
1. Enter the required values in the selection screen and click Save as variant... .
A dialog opens.
3. Click Save as personal variant or, if you have the necessary authorization,
Save as global variant .
To use variants:
2. Select a variant.
The value entries defined in the variant are copied to the selection screen.
To delete a variant:
• In a selection screen, click Delete variant and select the variant you want to
delete.
Tip: You can delete personal variants always, since these are only available to
you. You can delete global variants only if you have the necessary
authorization.
2. De-select the checkboxes for the fields that you want to hide in the selection
screen.
To display hidden fields again, select the respective checkboxes.
You can make a selection on any data source, for example to examine a group of
elements belonging to a node. You do this using the hit list function. In order to
generate a hit list, the selection criteria entered by the user in a search screen are
evaluated. All the data records that match the criteria are then displayed in a
resulting hit list.
Hit lists for CM You can create hit lists for CM document folders as well. For CM hierarchies, the CM
folders documents and folders are displayed without a selection screen, but with their KPro
attributes and, if available, checkout information.
Expanding You can expand the nodes of the separate hit list further by clicking on the
nodes associated node icon. The hit list is then replaced by a list of subnodes. To return to
the hit list, click Back .
Standard As in other SAP applications, you can change the column widths by dragging the
functions for dividing line with the mouse, define the column order by means of Drag&Drop and
lists
select multiple entries using the SHIFT and CTRL keys. Many additional functions
are available in the context menus.
In the case of separate hit lists, which are displayed in a separate view, further SAP
standard functions for lists are available. Refer to the SAP documentation for a
description of these functions.
This can be useful, for example, when a product was purchased by a large number
of customers and you are searching for a particular customer but do not want to
have to scroll through all the records at once. When large volumes of data are
involved this also has an impact on performance, since selecting all the data at once
can lead to significant delays and even timeouts.
8.2.3 Refreshing
When a data source on which the hit list is based is subsequently modified, the hit
list must be refreshed. To do this you do not have to start a new search, instead click
Refresh . The most recent status of the hit list is displayed.
To move a column:
2. Use Drag&Drop to move the column where you want to place it.
Tip: In the case of hit lists in tree view, it is not possible to move columns with
Drag&Drop. Click Output Settings to define the sequence of columns (see
“Configuring hit lists in tree view” on page 62).
Tip: Alternatively, you can exclude a column from the display by using the hit
list configuration screen (see “Configuring hit lists in tree view” on page 62).
To sort records:
1. Select the attribute to be used for sorting by clicking on the respective column
title.
• When no column is selected, the rows of the table are sorted using key fields.
• When one attribute is selected, the sort order is unambiguous and the records are
immediately sorted in ascending or descending order on the basis of this
attribute.
• When several attributes are selected, the sort order depends on the type of hit
list.
Note: In the case of hit lists in tree view, the Output Settings screen appears
(see also “Configuring hit lists in tree view” on page 62) and allows you to
specify the sort order. The columns that are selected in the hit list are also
selected in the configuration screen.
Sort order in Sorting is automatically performed in the order in which the columns were selected.
separate hit Click the columns by which you want to sort (in the correct order!) and then choose
lists
the sort function.
1. Click Select layout in the list view or the small arrow next to that icon in
the separate hit list.
3. Specify the settings for column selection, sorting, filters and display purposes.
Refer to your SAP documentation for a description of these functions.
Tip: Alternatively, you can configure the hit list using the layout function (see
“Editing the list layout” on page 61).
Tip: When you select specific columns in the hit list before invoking
Output Settings, the corresponding lines are also selected in the
configuration screen.
2. You can define the following output settings for each attribute object:
Selection
Attribute selection; only fields marked with a checkmark are displayed.
Sort
Sorts the data in ascending (U) or descending order (D); this automatically
forces an entry in Sort order.
Sort order
Determines the sequence of the sort fields. When more than one sort field is
specified, you have to make an entry in the Sort field.
Output length
Number of displayed characters; it is determined automatically, but can be
overwritten
a. Select the line to be moved by clicking in the field at the beginning of the
line.
A small arrow indicates that the attribute is selected.
b. Click the line above which the selected line is to be inserted.
c. Click Move .
Now the attribute is displayed at the selected place.
d. Repeat this process until you have the order you want.
In the following chapters, you will find the day-to-day operations with DocuLink.
Caution
Due to technical restrictions, not all DocuLink functions are available in the
different visualizations. Note the respective limitations indicated in the
following chapters.
In order to enter documents that already exist in electronic format, one of the
following methods can be used via the back-end (usually on the archive server):
• Interface for entering external data (documents + attributes) with transfer of the
attributes to the SAP application; this interface can be used, for example, by
scanning service providers.
• Interface for the transfer of COLD data together with transfer of attributes to the
SAP application.
• Special data transfers from external systems are possible by designing a separate
function group and using project-specific user exits (for example the Invoice
Reader solution package).
The system asks you to specify which archiving method is to be used (if alternatives
are available) when a document is created (see “Creating and archiving documents”
on page 42). The last selected scenario is automatically used unless the Always ask
option has been defined as the default archiving mode. To select a different scenario,
click Reset archiving scenario.
The necessary customizing must be carried out for each of these archiving scenarios
before they can be used (see OpenText DocuLink for SAP Solutions - Customizing and
Administration Guide (DC-CGD)).
SAP GUI
There are various ways to start archiving from the SAP application:
• Via the context menu Send to >Livelink ECM – Suite for SAP Solutions in
the Windows Explorer
• Via Drag&Drop on the Livelink ECM – Suite for SAP Solutions desktop
icon
• Via a special print driver that converts the file to PDF or TIFF format first
and then archives it (OpenText PDF Converter or OpenText TIFF Converter)
1. Start archiving via DesktopLink using one of the starting points described
above.
2. In the SAP GUI, select the document type, the default settings and the DocuLink
scenario. This step may not be necessary, if these settings have been predefined.
4. In the hierarchy, navigate to the node to which the file is to be assigned. This
may be:
• A value table node in order to create a record and archive the document to
this record.
• A document node in order to add a document.
• A value table node with a subordinate document node, in order to add a
further document to the existing record.
5. Click Create . When the document type has not been uniquely determined, a
selection dialog box is displayed for each file.
All the current files are assigned to a single node (i.e. the current node).
Note: Document export is only supported for the SAP GUI for Windows and
requires a prior installation of OpenText Rendition Server.
DocuLink offers the following export options for the archived documents:
• Download
Copies the document and converts it to the PDF, TIFF or TXT format for local
storage.
• E-Mail
Copies the document and sends it as an E-mail.
• Print
Prints the document on a specified printer.
Tip: To ease access, all export functions are also accessible from the context
menu.
For all options, DocuLink allows you to export documents either as single
documents or as part of a complete folder structure. Thus it is possible to export also
large collections of documents in one batch.
Tip: Processing of large export jobs may be time consuming due to the
considerable computing workload.
4. Select the Task Profile field and click to open the Task Profile dialog. Select
the required task profile from the selection dialog.
Note: The index page is only generated when this is activated in the
Rendition Server profile.
4. Select the Task Profile field and click to open the Task Profile dialog. Select
the required task profile from the selection dialog.
5. Click Copy to confirm your selection and press ENTER key.
The task profile is displayed in the Send document as E-mail dialog.
6. If required, enter any additional information in the Comment field.
7. Select the To field and enter the recipient's mail address. Alternatively, click
to open the E-Mail Address dialog and select the recipient from the SAP mail
system.
To enter multiple recipients:
c. Press F4 key to open the E-Mail Address dialog and select the required
recipient. Click Copy to confirm your selection.
d. Repeat the sub-steps a. through c. for every recipient you want to add.
e. Click Copy to close the Multiple Selection for dialog.
The defined recipients are added in the To field; however, only the first
entry is visible.
10. If required, enter additional text to be mailed in the field below the Subject
field; a maximum of 1024 characters is supported.
4. Select the Task Profile field and click to open the Task Profile dialog. Select
the required task profile from the selection dialog.
The log entries for the currently processed output jobs are displayed with their
current status.
The status messages show the following information:
– in the log entry, click to display a more detailed error list. In this list,
some count information is stated if available. A list of source documents
associated with errors that happened during processing is also provided.
Note that parts of this list are currently only localized in English.
Example 10-1:
– the index page creation fails or the index page displays an error message:
Example 10-2:
0000000000 (0000000000) – 0 of 0 documents were processed. For
example, the job was started with no source documents and
therefore no documents were processed. This occurs if a user selects
an area without documents in a DocuLink project view.
0000000003 (0000000003) – 3 of 3 documents were processed.
0000000005 (0000000010) – 5 of 10 documents are processed but 5 are
still outstanding. If you find such a count in a message stating the job
is Finished! or Index HTML creation has failed, some unusual
problem has occurred. The job has probably been aborted. In usual
error cases, the number of processed documents ends with the same
count as the target number.
Tip: You can define how to highlight these special CM folders user-specifically,
see “Other functions and settings“ on page 93.
Apart from the standard functions for nodes, documents in these folders also feature
the familiar CM functions from the SAP Content Viewer (assuming you have the
required authorization). These functions includes checking documents out or in,
displaying document properties and versions, changing the document status or
storing a local copy without checking out.
Hierarchy area - In CM document hierarchies, the hierarchical structure is displayed on the left-hand
document area side of the screen in the so-called hierarchy area, as in the user interface for the
individual business objects. On the right-hand side of the screen, the actual
document is displayed in the document area and can be edited in the Content Viewer.
The functions in the document area (Content Viewer) always refer to the document
currently being displayed there. To switch the current document, double-click the
required document's name in the hierarchy area.
To preview a document:
Tip: You can browse through the views that have already been displayed (e.g.
version overview, document preview, attribute properties, etc.) by clicking
Back or Next Page .
• Documents
• Folders
• Versions
• Document attributes (corresponds with the contents of the Properties tab in the
document properties dialog)
In the following sections we will describe how to display the various properties. To
edit the properties, switch to edit mode in the display screen.
Note: To edit the properties you require the correct user rights and permission
for the node type.
• Select the required version in the version overview and click Properties in
the document area.
The attribute properties for the current document (which corresponds to the
contents of the Properties tab in the document properties screen) are displayed
in the document area.
Tip: When you select several documents to display the attribute properties,
these views are “stacked” in the document area. You can browse through the
views by clicking Back or the Next Page .
To create a CM folder:
4. Click .
Note: To edit a document (especially when using templates) you require the
appropriate user authorization and permission for the node type.
6. When several different document classes are available, select the correct one for
your document.
7. Click .
The new document appears in the hierarchy.
5. When several different document classes are available, select the correct one for
your document.
6. Select the MIME type for the new document. According to this type, the
corresponding editor will be used.
8. Edit the file in the editor. The file is automatically given the name you entered
in the previous dialog.
9. Save the file and close the editor.
The new document appears in the hierarchy.
Important
While a user edits a CM document it is automatically locked for use by other
users. Meanwhile, other users can access the document only in read-only
mode. Only after the document has been saved and closed in the editor, it is
released for all users.
6. Click Store .
The version overview is updated.
Tip: Locked documents are highlighted for distinction; you can change the
highlighting color (see “Defining color settings” on page 94).
3. In the File Save dialog, enter a path and a name where the document will be
stored locally.
4. Click Save:
The document is stored locally in your file system.
Tip: Locked documents are highlighted for distinction; you can change the
highlighting color (see “Defining color settings” on page 94).
3. In the dialog, enter a path and a name where the document will be stored for
editing.
4. Click Save.
The document is stored locally in your file system and can be edited. In the
hierarchy, the checked-out document is highlighted.
To check in a CM document:
3. If necessary, enter a comment such as the reason for modifying the document.
4. If you do not want to create a new version of the document, activate the
Overwrite old version option.
5. Click Save .
The document is unlocked for other users and no longer highlighted.
To unlock a CM document:
Note: To set a document status you require the appropriate user authorization
and permission for the node type.
3. Select the required new status for the selected document from the selection list.
The status symbol for the document in the tree, if available, is changed
accordingly.
In DocuLink Web UI, maintained hyperlinks can be used either with the Related
Links button of the list view toolbar or via the context menu of the respective list
item.
Note: This specific DocuLink Web UI function is not available in the SAP GUI
for Windows or SAP GUI for HTML visualization.
1. Navigate to an item in the list where you want to open the hyperlink.
1. Navigate to an item in the list where you want to open the hyperlink.
2. Invoke the context menu of a list item, open the sub-menu Related Links and
select the desired hyperlink.
The hyperlink is opened in a browser window.
Any of the maintained hyperlinks are accessible in the list view, if the node type
with hyperlink mapping is opened or selected.
In addition to the functions for special elements, there are also some general
functions and settings in DocuLink.
In addition, specific help functions are available for the different visualizations.
SAP GUI for For the SAP GUI for Windows, you have the following options:
Windows
• To open the user documentation, select the menu command DocuLink-
Help>DocuLink Documentation.
• To access general on-line help, place the cursor on the object you need help about
and press F1.
• To access input help while entering information in dialog boxes, press the F4 key.
DocuLink Web For the DocuLink Web UI, you have the following options for an input help:
UI
• To access input help in a selection or create screen, click next to the input field.
• To fill in date fields, a calendar is provided as input help. You can browse
through the months and select a date.
• For all other input fields, a selection list with the possible values is displayed. If a
large number of values is available, you can browse through the entries. To select
the required value for your input, click OK. The value is copied to the input field.
• Attribute records, also for data from an archive (offline) and for displaying
alternate row colors
5. When you have customized all the colors, click Okay to close the dialog.
Start viewer
Opens the associated original automatically (if one exists) when you start
the detail or edit function or displays a list of available documents for you
to select from.
No start picture
Deactivates the background screen for the inplace view.
This option is only available when inplace view was customized for the
view.
No inplace view
Deactivates the inplace view (i.e. simultaneous view of the navigation tree
and document or hit list).
This option is only available when inplace view was customized for the
view and when no CM document hierarchies exist in the view.
Assuming the required configuration, you can also call DocuLink views from SAP
Interaction Center (IC) WebClient. In many cases the view can be opened by a
hyperlink of the navigation bar.
Functionality
DocuLink is started in the DocuLink Web UI. All familiar DocuLink functions for
the Web UI are available.
In case DocuLink is installed together with OpenText Extended ECM for SAP
Solutions, it integrates seamless into this environment. Extended ECM for SAP
Solutions in turn plugs into OpenText Content Server. This integration applies in
particular to the business workspace feature, which is based on a special node type,
and to Records Management with ArchiveLink documents.
If you want to see any content, double-click the respective workspace item or use the
functionality of the item's context menu. Depending on the customized setting, an
inplace view or an external view is used to display the content.
In case of a folder or another “non-content” object like e.g. a discussion channel, its
properties are displayed. In case of an external view, the properties view of such an
item will not be available.
In case of a shortcut item, the content of the original item will be opened.
Note: Navigating on the Content Server side may offer more functionality for
an item than is currently supported by DocuLink. Also it may happen that you
cannot navigate back to DocuLink; in this case, just double-click the item in
DocuLink.
Workspaces in The basic structure of workspaces in DocuLink Web UI is the same as in the SAP
DocuLink Web GUI. The basic element of the workspace view is a row in the Search Results table;
UI
each row represents either a workspace item or a workspace document. The
following features are special for DocuLink Web UI:
• The DocuLink Web UI list view offers access to the functions via the list toolbar
and the context menu of the individual elements.
• All workspace-related dialogs are displayed in an external browser window.
• Navigate through the workspace by selecting workspace folders in the list or tree
view. In addition to the table and tree hierarchy, you can also the breadcrumb
mechanism.
Important
Since the functions of DocuLink can be customized, you may not be able to
access all functions described in the following.
Standard Basically, DocuLink supports the following Content Server standard functions:
functions
Add Document/Folder
This function adds a new document or folder. Navigate to the position in the
tree where you want to create a new element and select the corresponding node.
Select the Add Document / Folder command from the context menu, which
opens in an external window a create sub-dialog. Specify the required data for
the new element, especially in the mandatory fields and click Add to finish the
action.
Open item
This function displays the content of the item. In case of Microsoft Office
documents, the proper application to edit the item will be opened, e.g. double-
clicking a Microsoft Word document will present a dialogue if item should be
saved or opened, depending on the users choice word will open and user is able
to work with the document and save a local copy of his changes. This will not
change the document in Content Server.
Edit item
This function enables you to work with different supported document types and
immediately save the changes in Content Server. The respective document type
defines what application is used for editing. This assignment can be customized;
i.e. whether a Word document is opened with Microsoft Word or another word
processor depends on the customized setup.
Download item
This function downloads the content of the item as a local copy. Note that this
action does not reserve the respective item.
Reserve/Unreserve
With this function, you can reserve an item exclusively; all other users only have
read access until you revoke your reservation by unreserving the item. The
item's status of reservation is indicated by a little icon showing a green arrow
and a pencil. You can unreserve the item by again clicking this icon.
Add Follow up
This function triggers in Content Server a follow-up function with the possibility
to specify for a certain user an action on a certain date and time.
Properties
For non-content objects, properties are shown as the default action. Properties
are only shown when an inplace view is activated. Different object types may
have different properties; the details depend on the setup of Content Server.
Open Workspace
Opens your preferred browser displaying the selected workspace. You are able
to navigate at random in Content Server.
Special Content Server elements feature special properties; the following are also accessible
functions from DocuLink:
Shortcuts
Shortcuts are indicated by the icon adjacent to the icon that indicates the type
of a shortcut. If a folder is shown you cannot open it in this version; in this case,
you can only see the properties when you try to open it.
Note: In the DocuLink Web UI, the shortcut icon is displayed in an
additional column at the end of the workspace list item.
Task lists
Task lists are indicated by the icon; double-clicking the icon and/or the line
will open the task list on Content Server side. Navigation on Content Server side
is completely separated from DocuLink.
Note: In the context of Records Management, record does not refer to a distinct
data row of a database table, but rather to a document stored on an Content
Server and maintained with Records Management with a defined retention
period, etc. If the expression “a document is a record” is used in the following,
this means the document has been declared as a record on Content Server.
Declare as record
Available if the ArchiveLink document is not yet declared as a record. You can
access it via the context menu only in the SAP GUI for Windows; it opens a
dialog for records declaration.
Show record details
Available if the ArchiveLink document is either a record or an official record.
You can access it via the context menu or by double-click the record's icon (SAP
GUI for Windows) or by single click in (DocuLink Web UI). It opens the
Property:Records Detail page of Content Server on which the record is declared.
Overview of functions
In the following you will find an overview of the functions supported for various
DocuLink elements with the corresponding icons and menu options, as well as a
short description. Furthermore, the overview indicates which functions are available
for which types of visualization.
For the standard visualization in SAP GUI for Windows, all functions described in
the following are available.
The other visualizations are abbreviated as follows:
• HTML
SAP GUI for HTML
• Web
DocuLink Web UI
• Lists
external (hit)list view
Note:
In the user view, and therefore also in the screen shots in this document, you
sometimes see placeholder buttons. These currently have no real function.
However, they indicate that user-specific buttons can be set up in their place.
Ask your system administrator for further information.
[d] not via DesktopLink or via the SAP ArchiveLink scenario Storing for subsequent entry
[e] not via Drag&Drop, only using move and insert icons
[f] not via Drag&Drop, only using copy and insert icons
Standard views of the existing business objects are provided in DocuLink. Thus it is
possible to use the folder even if you simply want to archive using standard
procedures (scanned documents, outgoing SAP documents, print lists). In the
following, some chosen sample projects will be described in more detail.
Here PLM documents of various document types are displayed in a DocuLink tree
together with their SAP document info record. Double-click the document to display
the original document in the appropriate viewer. Double-click the document info
record to display it in the corresponding PLM transaction. Other functions are
currently not supported for this node type.
Sample view The sample view has a simple structure consisting of a product and a customer
with product branch. Both contain a record for each customer or product, and underneath that
and customer
branches
any number of CM hierarchy nodes. However, the CM hierarchy nodes differ in the
underlying document models.
CM structures While for customers only a flat hierarchy is supported, i.e. simple CM document
subnodes, the product branch allows creating more complex structures using CM
subfolders and CM document nodes. However, such a CM structure is treated as a
single CM hierarchy node in the DocuLink tree.
17.2.1 Functionality
You can try out the CM functionality, such as checking in and out documents,
setting the status or creating documents with templates, at the CM hierarchy nodes,
i.e. at all documents and folders below the product and customer data records.
• In process
• Quality check
• Released
• Rejected
An appropriate icon was assigned to each status and is displayed in the application
view next to each document in the tree to indicate the status.
The possible status transitions are defined as the Status flow. In the example, these
are:
• After release the document is converted to a different format and stored as a new
version (rendering).
• After rejection the document is moved to a different storage system (migrating).