Академический Документы
Профессиональный Документы
Культура Документы
Products and Customers (e.g. which customer has bought what products)
DocuLink Web UI
Caution
Due to technical restrictions, not all DocuLink functions are available in the
different visualizations. Note the respective limitations indicated in the
following chapters.
3.1 SAP GUI for Windows
This visualization uses the common SAP environment. From there you can easily
switch to other SAP transactions.
DC100500-UGD-EN-1 User Guide 15
Figure 3-1: Visualization in SAP GUI for Windows
3.2 SAP GUI for HTML
This visualization uses a standard Web browser and the Internet Transaction Server
(ITS). The screen elements are the same as for SAP GUI for Windows.
The following limitations apply:
DocuLink Web UI
4.1 SAP GUI for Windows
To invoke DocuLink in the SAP GUI for Windows:
1. Log on to the SAP system.
2. Specify the J6NY transaction in the command field or select it in the list of
favorites.
The screen is divided as follows:
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.
DC100500-UGD-EN-1 User Guide 21
Tip: You can access only the views that you are authorized to see.
To add DocuLink to your list of favorites, right-click on the favorites folder in
the SAP GUI and select Insert transaction from the context menu.
4.2 SAP GUI for HTML
To invoke DocuLink in the SAP GUI for HTML:
1. Enter the URL given to you by your administrator in a Web browser.
Note: Do not omit the exclamation mark (!) at the end!
2. Log into the SAP application.
3. Click the Open transaction field icon and specify the J6NY transaction in the
transaction field or select it in the list of favorites.
Chapter 4 Invoking DocuLink
22 User Guide DC100500-UGD-EN-1
4.3 DocuLink Web UI
To invoke DocuLink in DocuLink Web UI:
1. Enter the URL given to you by your administrator in a Web browser.
The appropriate URL may be available in the Favorites menu of your browser
or on an Intranet page. In case of problems, contact your administrator.
2. Log into DocuLink
The DocuLink web start screen is displayed, showing hyperlinks to the
available views.
Depending on the kind of URL you are using, you might get redirected directly
to the search mask.
4.3. DocuLink Web UI
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 23
Note: The standard Web browser Next and Back buttons are not supported by
DocuLink Web UI. When you click the Refresh button, the starting page of
DocuLink Web UI is displayed.
Chapter 4 Invoking DocuLink
24 User Guide DC100500-UGD-EN-1
Chapter 5
Navigating
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.
5.1 Navigating in the tree
You can navigate in DocuLink using various methods which depend on the
visualization used:
DocuLink Web UI
SAP GUI for Windows
To open a project:
1. Click on the small arrow in front of a project name.
The project node is expanded and all assigned views are displayed.
2. Click on a view name to start the view.
The hierarchy tree of the view is displayed.
To open a node:
1. Click on the small arrow in front of the folder icon.
2. Click on 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.
DC100500-UGD-EN-1 User Guide 25
To expand a project node:
Click the icon to see the additional nodes for the views that have been set up.
To switch between views:
1. Click the (Change view) button and select the required view from the
selection list.
2. When you have already displayed different views, click the (Previous view)
or the (Next view) button to switch between these views.
To navigate down in the tree:
Either click the icon or double-click on the name of the next node.
When the administrator has configured the view accordingly, a selection screen
appears (see below), where you can enter selection criteria for the attributes in
order to restrict the number of records displayed.
Caching node displays on expanding and collapsing
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.
Chapter 5 Navigating
26 User Guide DC100500-UGD-EN-1
Important
This only applies when the node was expanded or collapsed using the
icon. When you double-click on 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.
5.1.1 Expanding nodes
You can expand an entire subtree at once, e.g. after you have hidden some lines.
Note: This function is not available in the external (hit)list view.
To expand nodes:
1. Select the uppermost node of the subtree you want to expand.
2. Click the (Expand all) button.
Important
With large volumes of data this function may slow down performance!
To expand an entire tree of a node in a view:
1. Select the required node.
2. Click the (Expand all) button.
All subnodes of this node are expanded.
To expand all nodes in a view:
1. Make sure no nodes have been selected or opened.
2. Click the (Expand all) button.
All nodes and subnodes are expanded.
5.1.2 Hiding nodes
If you want to simplify the way views are displayed, you can hide nodes that are
currently of no interest. These nodes will be visible the next time the parent node is
expanded.
To hide nodes:
1. Select the required node.
2. Click the (Hide node) button.
Tip: To see these nodes again, either click the (Refresh) button or close and
reopen the parent node twice.
5.1. Navigating in the tree
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 27
5.2 Viewing Details
You can use the detail view to display the attribute values of the selected records.For
CM documents, the status information is also displayed here.
To display details:
1. Select the required node.
2. Click the (Detail) button.
Alternatively, you can double-click on 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.
If configured accordingly, the original document assigned to the entry may be
displayed as well.
You can also specify which properties are displayed.
To configure the detail view:
1. Click the (Configuration) button in the detail screen.
The Administration Detail screen opens.
Chapter 5 Navigating
28 User Guide DC100500-UGD-EN-1
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 the (Accept) button.
5.3 Displaying hit lists
You can display a separate hit list with the attributes of the subnodes. In this case, a
selection screen is displayed first in order to restrict the data (see Using selection
screens on page 51 and Using hit lists on page 57).
Note: For CM hierarchies, the CM documents and folders are displayed
without a selection screen, but with their KPro attributes and, if available,
checkout information.
To generate a separate hit list:
1. Select the required node.
2. Click the (Hit list) button.
5.3. Displaying hit lists
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 29
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 the (Execute) button.
The hit list appears in a separate window.
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 on the associated node icon.
The hit list is then replaced by a list of subnodes. To return to the hit list, click the
(Back) button.
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 59.
5.4 Displaying hit lists in tree view
You can display a hit list with the attributes of the subnodes directly in the tree. In
this case, a selection screen is displayed first in order to restrict the data (see Using
selection screens on page 51 and Using hit lists on page 57).
Note: For CM hierarchies, the CM documents and folders are displayed
without a selection screen, but with their KPro attributes and, if available,
checkout information.
To generate a hit list in tree view:
1. Select the required node.
2. Click the (Hit list in hierarchy) button.
A selection dialog containing the available attributes opens.
Chapter 5 Navigating
30 User Guide DC100500-UGD-EN-1
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 the (Execute) button.
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 59.
5.5 Displaying original documents
When original documents are assigned to a record, they can be displayed directly.
Depending on the configuration, you can automatically display the original at the
same time using the button. When there is more than one original associated
with a record, a selection list of originals is displayed first.
To display original documents:
1. Select the required record.
2. Click the (Display original) button.
3. When a selection list with several different documents appears, select the
required documents and click the Display original button.
5.5. Displaying original documents
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 31
5.6 Accessing SAP transactions
If there is a valid SAP transaction for the data record (e.g. for an SD sales receipt),
you can jump directly to this transaction.
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 access an SAP transaction:
1. Select the required record.
2. Click the (SAP document) icon.
The assigned SAP transaction is started.
5.7 Refreshing the display
You can refresh the display manually, e.g. after changes to the data have taken place.
Note: This function is not available in the DocuLink Web UI visualization.
When you use the Refresh function of the Web browser, the starting page of
DocuLink Web UI is displayed again.
To refresh display:
Click the (Refresh) button.
5.8 Getting more values for a restricted number of
hits
If the number of displayed entries is restricted (e.g. for performance reasons), you
can display the rest of the entries one block by another.
To get more values:
Click the (Get more data) button.
5.9 Starting GOS
Depending on the configuration, various generic object services (GOS), e.g.Start
Workflow or the Attachment list, can be started via the context menu at the node
(records only).
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.
Chapter 5 Navigating
32 User Guide DC100500-UGD-EN-1
Note: This function is only available in the SAP GUI for Windows
visualization.
5.10 Using list view
If you want to view the sub nodes of a particular node in more detail, you can
display them in the list view as an extract of the hierarchy in the external list view,
similar to a hit list. You can then use the same functions as for the hit list (see Using
hit lists on page 57).
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.
To display a list view:
1. Select the required node.
2. Open the View menu and choose the List view option.
5.10. Using list view
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 33
5.11 Launching DocuLink Web UI
To launch DocuLink Web UI:
Open the appropriate URL for DocuLink Web UI in your browser.
Note: The appropriate URL might be available in the Favorites menu of
your browser or on an Intranet page. In case of problems, contact your
administrator.
The DocuLink web start screen is displayed, showing hyperlinks to the
available views of the DocuLink project.
5.12 Browsing in DocuLink Web UI
The principal structure of a tree view in DocuLink Web UI is the same as in the SAP
GUI. Here the example of the personnel files view of the DocuLink project Employee
File Management is illustrated. You will find the same elements, like Browse, Add
and All Documents.
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 the
icon 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 on 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.
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.
DocuLink Web UI displays thumbnails for the following document formats:
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
Chapter 5 Navigating
36 User Guide DC100500-UGD-EN-1
JPG
Graphic format
GIF
Graphic format
For MS Office documents, DocuLink Web UI displays an icon instead of a
thumbnail. Click the icon to display the document in its corresponding MS
Office application, for example MS Word, embedded in DocuLink Web UI.
4. Browse through the thumbnails to locate the required document.
5. Click a thumbnail to display an enlarged view of the document. Click on the
enlarged view to open the document in the viewer configured in your system.
In the thumbnails view, the following settings are available:
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.
5.13. Browsing thumbnails for fast document retrieval
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 37
5.14 Using button tool bar and context menu in
DocuLink Web UI
The DocuLink Web UI visualization offers access to the functions either via the tool
bar buttons or the context menu of the individual elements.
Note: Since the configuration of DocuLink can be changed, you may not be
able to access all functions described in the following.
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.
In addition to the buttons in the tool bar, you can use menu items from the context
menu (indicated by the icon 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.
Tool bar
Context menu
Chapter 5 Navigating
38 User Guide DC100500-UGD-EN-1
Chapter 6
Performing basic operations
Basic operations with DocuLink comprise the following:
Editing a record
Creating an element
Moving an element
Copying an element
Deleting an element
6.1 Editing a record
You can edit records as long as they are not key fields. Editing is only possible when
a node actually represents a record and is available in editable tables, i.e. not in SAP
standard tables. Optionally, you can also display the original document
automatically.
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.
Note: In DocuLink Web UI, neither properties nor the contents of CM
documents can be edited.
To modify a data record:
1. Select the required node.
2. Click the (Edit) button.
The record properties are displayed in edit mode. Mandatory fields are
highlighted (by color or with a *) and must contain values.
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 the (Accept) button to confirm your changes.
DC100500-UGD-EN-1 User Guide 39
In DocuLink Web UI, click the Change button and modify the node.
Some fields are validated to ensure that the entry is correct (e.g. foreign keys or
dates are checked). In case of an error, a warning message appears. Invalid data
will not be saved.
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.
6.2 Creating an element
Depending on the configuration, the following options are available:
Create data recordto create a new data record without an assigned document
(see Creating data records in SAP GUI on page 40).
Create several data recordsto 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 documentto create a data record and simultaneously
archive an assigned document (see Creating and archiving documents
on page 42).
Create and archive several documentsto create a data record and simultaneously
archive a number of assigned documents consecutively (see Creating and
archiving documents on page 42)
Note: In the SAP GUI for HTML visualization, it is not possible to create
documents.
Creating data records and documents in DocuLink Web UI is described in Creating
data records with documents in DocuLink Web UI on page 44
Creating CM documents and folders is described in Creating a CM document
on page 86.
6.2.1 Creating data records in SAP GUI
To create a data record:
1. Navigate to the position in the tree where you want to create a new element.
2. Click the (Create) button.
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.
3. Select the required element and click the (Accept) button.
Chapter 6 Performing basic operations
40 User Guide DC100500-UGD-EN-1
The Create dialog for the required element is displayed.
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.
5. To create only one record:
Click the (Create record) button.
The Create dialog closes and the new record is displayed in the tree.
6. To create several records of the same type in the same position in the tree
Click the (Create several records) button.
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 the
button.
b. After the last record, click the (Cancel) button to close the Create dialog.
6.2.2 Creating as copy
When you want to create a record which is very similar to an existing one (for
example if many of the attributes are the same), you can use the Create as copy
command.
To create a copy of an existing record:
1. Select the record you wish to use as a template and click the (Create) button.
2. Select as copy from the selection list and click the (Accept) button.
The Create dialog for the element is displayed with preset, editable fields.
3. Make the necessary changes, not forgetting the key fields.
4. Click the (Create record) or the . (Create several records) button.
The new record is displayed in the tree.
Creating several records as copies
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
the (Delete entire selection) button to delete the preset settings.
6.2. Creating an element
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 41
6.2.3 Creating and archiving documents
Note: Creating data records and documents in DocuLink Web UI is described
in Creating data records with documents in DocuLink Web UI on page 44.
To create and archive documents:
1. Navigate to the node in the tree to which the document shall be assigned.
Tip: Remember that, depending on the configuration, documents cannot
be stored at all documents. In this case, no create function is available.
2. Click the (Create) button.
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 the (Accept) button.
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.
6.2.4 Creating and archiving data records with documents
Depending on the configuration, you can create a data record and simultaneously
archive a document for it. You can choose whether you want to archive one or more
documents together with a single data record.
Note: Creating data records and documents in DocuLink Web UI is described
in Creating data records with documents in DocuLink Web UI on page 44.
To create and archive data records with documents:
1. Navigate to the position in the tree where you want to create a new data record
with a document.
Chapter 6 Performing basic operations
42 User Guide DC100500-UGD-EN-1
Tip: Remember that, depending on the configuration, documents cannot
be stored at all documents. In this case, no create function is available.
2. Click the (Create) button.
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.
5. Click the (Create and archive one document) or the (Create and archive
several documents) button, depending on how many documents you want to
assign to the data record.
A selection screen for the archiving scenario is displayed, unless the scenario
was already defined during configuration.
6. Select the required archiving scenario.
The selected archiving scenario is automatically re-used for all following
records (for the same user at the same node type). The current scenario is then
specified for the archiving function, unless Always ask was defined as the
standard archiving scenario. In this case, you are asked anew which mode to
use for each archiving operation).
7. If necessary, click the Archiving senario button to change the current archiving
scenario.
Depending on the selected archiving scenario, different steps may follow to
store the document, e.g. scanning or file selection.
For more details on the different archiving scenarios see Importing
documents on page 67.
Note: If the archiving operation is interrupted, you can decide whether
you still want to create the record despite this.
6.2. Creating an element
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 43
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:
Same scenario: Using the same archiving scenario (same archiving
mode, document type, etc.).
Other scenario: Using a new archiving scenario; the archiving scenario
selection screen is displayed again.
ArchiveLink Scanning: In this scenario, you may select all the
documents in the scanner to be archived to the same data record. This is
only possible if Scan has already been set as the archiving scenario.
b. Repeat the last step for each additional document you want to assign to the
current data record.
c. Finally, click Cancel to close the dialog.
You return to the create dialog and can create the next data record.
d. Finally, click Cancel again to close the create 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.
6.2.5 Creating data records with documents in DocuLink Web
UI
In DocuLink Web UI, creating SAP ArchiveLink documents is possible via file
upload.
To create and archive data records with documents:
1. Navigate to the position in the list where you want to create a new element and
select the corresponding node.
2. Click the Create button 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.
Chapter 6 Performing basic operations
44 User Guide DC100500-UGD-EN-1
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 the Browse button to navigate to the document that
you want to archive.
Click the Attach button 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, use the Remove button to remove it.
6. If required, repeat the procedure using the Browse and the Attach button to
add more files.
7. Click the Create button.
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 the Create button 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.
The File Upload - Create documents dialog is displayed.
3. To add an attachment, click the Browse button to navigate to the document that
you want to archive.
Click the Attach button 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, use the Remove button to remove it.
5. If required, repeat the procedure using the Browse and the Attach button to
add more files.
6. Click the Upload button.
The document is inserted in the required position in the list.
6.2. Creating an element
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 45
6.3 Moving and copying elements in SAP GUI for
Windows
Moving and copying of elements is only possible via Drag&Drop.
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.
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
Chapter 8 Using hit lists
60 User Guide DC100500-UGD-EN-1
specify the sort order. The columns that are selected in the hit list are also
selected in the configuration screen.
Sorting is automatically performed in the order in which the columns were selected.
Click on the columns by which you want to sort (in the correct order!) and then
choose the sort function.
8.3.4 Editing the list layout
You can edit the appearance of a hit list using the layout function.
To edit the list layout:
1. Click the (Select layout) button in the list view or the small arrow next to
that icon in the separate hit list.
2. Select Change layout... from the context menu.
3. Specify the settings for column selection, sorting, filters and display purposes.
Refer to your SAP documentation for a description of these functions.
Sort order in
separate hit
lists
8.3. Changing the display
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 61
8.3.5 Configuring hit lists in tree view
You can (permanently) define the representation of the hit lists in tree view with
regard to the scope and sequence of all the columns in a single screen.
Tip: Alternatively, you can configure the hit list using the layout function (see
Editing the list layout on page 61).
To configure hit lists in tree view:
1. Click the (Output Settings) button in the tree.
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.
Chapter 8 Using hit lists
62 User Guide DC100500-UGD-EN-1
Output length
Number of displayed characters; it is determined automatically, but can be
overwritten
3. Change the order of the attributes as required:
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 on the line above which the selected line is to be inserted.
c. Click the (Move) button.
Now the attribute is displayed at the selected place.
d. Repeat this process until you have the order you want.
4. Click the (Accept) button to close the configuration screen.
The hit list now appears as you configured it.
8.3. Changing the display
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 63
Part 3
Working with DocuLink
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.
Part 3 Working with DocuLink
66 User Guide DC100500-UGD-EN-1
Chapter 9
Importing documents
The documents to be stored in DocuLink can be imported or entered in the system in
different ways. There is a range of options, depending on whether the documents
already exist (for example, in a third-party system) or whether they must be
imported.
Note: This function is not available in the DocuLink Web UI visualization.
In DocuLink Web UI, creating SAP ArchiveLink documents is possible via file
upload (see Creating data records with documents in DocuLink Web UI
on page 44).
9.1 Entry via scenarios and backend
In order to enter new documents and the indexing information they require in the
archive system, the following scenarios are supported on the front-end PC:
Late storing with bar codes
When a new document record is created in DocuLink, an entry screen is
displayed where you can enter the bar code of the document to be linked to. The
document with the bar code can be scanned later and archived.
Storing for subsequent entry
When storing a document for subsequent entry, the document is scanned and
archived in the SAP application before the workflow starts. The document type
assigned to the document determines the workflow and, if configured
accordingly, how a record is stored with the archived document in DocuLink.
Archiving from the file system (standard ArchiveLink)
Selecting and archiving the file from the SAP GUI. Requires no additional
software on the client.
Archiving from the file system (DesktopLink)
Fast option for selecting and archiving the file from the SAP GUI, but requires
additional software (DesktopLink) to be installed on the client.
Tip: For more details see Entry via DesktopLink on page 68.
Archiving from the scanner
Scans a document using the scan client and archives the document from there.
Entry via DesktopLink
Document is archived from other programs using DesktopLink. When entering
documents from ODMA-compatible applications using DesktopLink, you can
preset fields in the input screen using user-defined properties. Furthermore, you
DC100500-UGD-EN-1 User Guide 67
can specify which DocuLink view is automatically displayed and which nodes
are expanded. This eases navigation to the required node for the user.
Creating in the editor (CM documents only)
The CM document is created and edited in the editor during entry.
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.
Note: The transfer of COLD data always represents an additional project.
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 the Reset archiving scenario button.
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)).
9.2 Entry via DesktopLink
Note: This function is only available when the add-on DesktopLink is
installed.
DesktopLink offers various possibilities to start archiving documents; for more
details see OpenText DesktopLink - User Guide (CLDL-UGD).
SAP GUI
There are various ways to start archiving from the SAP application:
via the SAP transaction of the individual business objects (document lists)
via the SAP transaction for Livelink ECM Suite for SAP Solutions PLM (/
IXOS/PLM)
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)
To enter documents via DesktopLink:
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.
3. In DocuLink, navigate to the required view if this is not yet displayed.
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 the (Create) button. 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).
9.2. Entry via DesktopLink
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 69
Chapter 10
Exporting documents (OpenText Rendition Server)
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.
10.1 Downloading documents
When you download a document, DocuLink generates a local copy of the document
in the specified format together with an additional index page. The original
document in the archive remains unchanged. In this way, it is possible to create a
local copy of SAP documents e.g. if you must provide certain documents to users
who have no access to your SAP system, but are able to use an internal file share.
To download one or more documents:
1. Navigate in your SAP system to the required documents.
2. Select the required document(s) either as single documents or a complete folder
containing documents.
3. Click the (Document Processing) button and select Download document
entry in the Document Processing dialog.
The Download document dialog opens.
DC100500-UGD-EN-1 User Guide 71
4. Select the Task Profile field and click the icon to open the Task Profile
dialog. Select the required task profile from the selection dialog.
5. Click the (Copy) button to confirm your selection and press ENTER key.
The task profile together with its defined download path are displayed in the
Download document dialog.
6. If required, enter additional information in the Comment field.
This comment will be visible in the Overview of my Document Processing jobs
dialog.
7. Click the Download button to trigger the download of the selected
document(s).
Depending on the Task Profile setting, the download renders either to separate
target files or to one single merged target file. In the former case, the
document(s) is downloaded and an index page in HTML format is generated in
the download path.
Note: The index page is only generated when this is activated in the
Rendition Server profile.
In the case of a merged download, no index page in HTML format is generated
in the download path.
Chapter 10 Exporting documents (OpenText Rendition Server)
72 User Guide DC100500-UGD-EN-1
10.2 Sending documents as e-mail
Prior to sending documents as an e-mail, a correct e-mail address must be defined in
your user profile.
Note: Depending on the configuration, this definition may be your
responsibility.
To send one or more documents as e-mail:
1. Navigate in your SAP system to the required documents.
2. Select the required document(s) either as single documents or a complete folder
containing documents.
3. Click the (Document Processing) button and select Send document as E-
mail entry in the Document Processing dialog.
The Send document as E-mail dialog opens.
10.2. Sending documents as e-mail
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 73
4. Select the Task Profile field and click the icon to open the Task Profile
dialog. Select the required task profile from the selection dialog.
5. Click the (Copy) button 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 the
icon to open the E-Mail Address dialog and select the recipient from the
SAP mail system.
To enter multiple recipients:
a. Click the button to open the Multiple Selection for dialog.
b. Select an empty row in the Multiple Selection for dialog.
c. Press F4 key to open the E-Mail Address dialog and select the required
recipient. Click the (Copy) button to confirm your selection.
Chapter 10 Exporting documents (OpenText Rendition Server)
74 User Guide DC100500-UGD-EN-1
d. Repeat the sub-steps a. through c. for every recipient you want to add.
e. Click the (Copy) button to close the Multiple Selection for dialog.
The defined recipients are added in the To field; however, only the first
entry is visible.
Tip: To view your entries, click button to open the Multiple
Selection for dialog again.
8. If required, repeat the above step for the Cc field.
9. Enter the subject of your mail in the Subject field.
10. If required, enter additional text to be mailed in the field below the Subject
field; a maximum of 1024 characters is supported.
11. Click the Send button to trigger the mailing of the selected document(s).
10.3 Printing documents
When you print a document, DocuLink converts the document to the PDF format
prior to sending it to the printer.
To print one or more documents:
1. Navigate in your SAP system to the required documents.
2. Select the required document(s) either as single documents or a complete folder
containing documents.
3. Click the (Document Processing) button and select Print document entry in
the Document Processing dialog.
The Print document dialog opens.
4. Select the Task Profile field and click the icon to open the Task Profile
dialog. Select the required task profile from the selection dialog.
5. Click the (Copy) button to confirm your selection and press ENTER key.
10.3. Printing documents
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 75
The task profile together with its defined printer path are displayed in the Print
document dialog.
6. If required, enter any additional information in the Comment field.
This comment will be visible in the Overview of my Document Processing jobs
dialog.
7. Click the Print button to trigger the printing of the selected document(s).
10.4 Monitoring output jobs
In order to monitor the progress of your own output jobs, DocuLink allows to
display their status in the SAP system.
New: Monitoring of output jobs has been improved.
To monitor the current output jobs:
1. Click the Document Processing button and select My job overview entry in
the Document Processing dialog.
The Overview of my Document Processing jobs dialog opens.
The log entries for the currently processed output jobs are displayed with their
current status.
The status messages show the following information:
- download job was finished successfully. Click the icon to access
the generated index page in HTML format. The creation of the index page
does not start until the document download is finished. To open a
document, click the respective link.
Chapter 10 Exporting documents (OpenText Rendition Server)
76 User Guide DC100500-UGD-EN-1
- download job was processed with errors.
in the log entry, click the icon 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:
10.4. Monitoring output jobs
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 77
The system checks for which documents a problem occurred and
invalidates the respective document links. In addition, archive document
id and archive id are displayed, if available.
Date and Time - Date and time of job request.
Fcode - Type of process: download, print or send document as E-mail.
Comment - Comment entered by the user launching document processing.
Message - If the message shows Finished!... or Index HTML creation
failed, a counter info is displayed. The counter info has the format
000000xxxx (000000xxxx). The number before the brackets is the number of
already processed documents. The number in brackets is the target number
of documents to be rendered.
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.
Note: If the user is not logged on in English language, the Message
column title is displayed as <TRFC_STATUS_MSG>. Currently, there is
no localization available. See the latest release notes for more
information.
UNC path - path to html index page.
2. Click the (Continue) button to close the dialog.
Chapter 10 Exporting documents (OpenText Rendition Server)
78 User Guide DC100500-UGD-EN-1
To delete the logs entries of output jobs:
1. Click the (Document Processing) button and select My job overview entry
in the Document Processing dialog.
The Overview of my Document Processing jobs dialog opens.
The log entries for the processed output jobs are displayed with their current
status.
2. Select the required job and click the (Delete) button.
The Delete record dialog opens.
3. Confirm deletion by clicking the Yes button.
The selected log entry is deleted.
Tip: In addition to the monitoring of your own output jobs, administrators
may use an additional function to provide more detailed information on job
processing.
10.4. Monitoring output jobs
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 79
Chapter 11
Integrating SAP Content Management Functions
11.1 Content Management (CM) functionality
Document hierarchies from an SAP Content Management (CM) system may be
integrated into DocuLink structures as special folders. These so-called CM folders
are highlighted (usually in color).
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.
Note: CM functions are not available in DocuLink Web UI.
However, you can display the CM documents themselves just as ArchiveLink
documents (see Displaying original documents on page 31).
In CM document hierarchies, the hierarchical structure is displayed on the left-hand
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.
Hierarchy area -
document area
DC100500-UGD-EN-1 User Guide 81
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.
11.2 Displaying CM documents and versions
Note: CM functions are not available in DocuLink Web UI.
However, you can display the CM documents themselves just as ArchiveLink
documents (see Displaying original documents on page 31).
To display the current document in a viewer:
Click the (Display) button in the document area.
To preview a document:
Click on the document name in the hierarchy.
Alternatively, Select the required document in the hierarchy and click the
Preview button in the document area.
In both cases the most recent version of the document is displayed.
To display a version overview:
Click the Versions button in the document area.
An overview of all existing versions of the current document displays.
Chapter 11 Integrating SAP Content Management Functions
82 User Guide DC100500-UGD-EN-1
Tip: You can browse through the views that have already been displayed (e.g.
version overview, document preview, attribute properties, etc.) by clicking the
(Back) or the (Next Page) button.
11.3 Displaying and editing CM properties
In a CM hierarchy, you can display additional properties of the following elements:
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.
To display document properties:
Click the (Detail) button in the DocuLink toolbar.
Alternatively, double-click the document name.
A dialog with the various properties for the current document appears.
11.3. Displaying and editing CM properties
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 83
To display folder properties:
Click the (Detail) button in the DocuLink toolbar.
Alternatively, double-click the folder name.
A dialog with the various properties for the current folder appears.
To display version properties:
Select the required version in the version overview and click the (Properties)
button in the document area.
To display attribute properties:
Click the Properties button in the document area.
Chapter 11 Integrating SAP Content Management Functions
84 User Guide DC100500-UGD-EN-1
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 the (Back) or the (Next Page) button.
11.4 Creating a CM folder
You can create CM folders directly in the DocuLink tree.
To create a CM folder:
1. Select a node which is configured for CM folders and click the (Create)
button.
2. Select Create CM folder in the selection dialog.
3. Enter a name and a description for the new folder.
Note: The options Hidden and Order of Contents Freely Determinable
are currently not supported in DocuLink.
4. Click the button.
11.4. Creating a CM folder
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 85
11.5 Creating a CM document
You can create CM documents directly in the DocuLink tree by using the following
methods:
Using an editor.
To find out which DocuLink version installed, select the menu command
DocuLink-Help About DocuLink.
To display a detailed list of the transports imported to your system, click on the
button in the About dialog (not in DocuLink in Web); the installed Add-On
packages also appear as transports in this list.
In addition, specific help functions are available for the different visualizations.
For the SAP GUI for Windows, you have the following options:
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.
For the DocuLink Web UI, you have the following options for an input help:
To access input help in a selection or create screen, click the icon 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 the OK button. The value is copied to the
input field.
SAP GUI for
Windows
DocuLink Web
UI
DC100500-UGD-EN-1 User Guide 93
13.2 Specifying program settings
The Settings menu contains options that allow you to adapt the user-specific display
in DocuLink.
Note: These functions are not available in DocuLink Web UI.
13.2.1 Defining color settings
You can specify how the different node types and highlighted elements (e.g. selected
attribute record) are displayed.
The following display settings can be defined:
Attribute records, also for data from an archive (offline) and for displaying
alternate row colors
The DocuLink Web UI list view offers access to the functions via the list toolbar
and the context menu of the individual elements.
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.
Workspaces in
DocuLink Web
UI
DC100500-UGD-EN-1 User Guide 101
15.2 Using Content Server functions
The functions available for workspace items depend on your user access rights on
the Content Server side and on the functionality supported by your DocuLink
system.
Important
Since the functions of DocuLink can be customized, you may not be able to
access all functions described in the following.
Basically, DocuLink supports the following Content Server standard 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 the Add button to
finish the action.
Note: These functions are not available in DocuLink Web UI.
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 the Enterprise Server.
Edit item
This function enables you to work with different supported document types and
immediately save the changes in the Enterprise 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.
Standard
functions
Chapter 15 Integrating workspaces provided by Extended ECM for SAP Solutions
102 User Guide DC100500-UGD-EN-1
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 the Enterprise
Server.
Open Workspace
Opens your preferred browser displaying the selected workspace. You are able
to navigate at random in the Enterprise Server.
Content Server elements feature special properties; the following are also accessible
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 the Content Server side. Navigation on the Content
Server side is completely separated from DocuLink.
15.3 Using Records Management with ArchiveLink
documents
Extended ECM for SAP Solutions also supports Records Management with
ArchiveLink documents. If DocuLink is employed on the same SAP system and if
Records Management was enabled for a DocuLink view, Records Management
functionality is available for (ArchiveLink) document nodes.
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 the Enterprise
Server.
Special
functions
15.3. Using Records Management with ArchiveLink documents
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 103
15.3.1 Displaying records
If Records Management is enabled in DocuLink, the ArchiveLink documents that
have been declared as records are marked in the user interface.
SAP GUI for Windows
An additional icon to the right of the document type icon is displayed.
The descriptions record or official record is visible after a right-click on the icon
or after pointing to the icon and pressing SHIFT + F10 keys.
SAP GUI for HTML
The descriptions of the icons are shown as tooltips.
DocuLink Web UI
An additional icon like in SAP GUI for Windows is displayed, but in an
additional column at the end of each document line.
The following icons are used:
Icon for records
Icon for official records.
15.3.2 Using additional commands
If Records Management is enabled, DocuLink also offers additional commands for
ArchiveLink document nodes. Note that the availability of these commands depends
on the respective user permissions.
The following commands are available.
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 on the record's icon
(SAP GUI for Windows) or by single click in (DocuLink Web UI). It opens the
Property:Records Detail page of the Content Server on which the record is
declared.
Chapter 15 Integrating workspaces provided by Extended ECM for SAP Solutions
104 User Guide DC100500-UGD-EN-1
Part 5
Appendix
Chapter 16
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.
16.1 Functions for nodes
Icon Name Menu path/
access
Description HT
ML
We
b
Lis
ts
Detail Edit Detail Displays selected records (detail
view)
For CM documents, the status
information is also displayed
here.
x x x
Edit Edit Edit Modifies the selected records
(only non-key fields).
For CM hierarchy nodes, only the
document attributes or properties
can be modified using this
function, not the document itself.
x x x
Create Edit Create Creates an attribute record and/or
document.
x
[a]
x
[b]
x
[c]
,
[d]
DC100500-UGD-EN-1 User Guide 107
Icon Name Menu path/
access
Description HT
ML
We
b
Lis
ts
Delete Edit Delete Deletes the selected attribute
records or documents.
x x x
Move Only via
Drag&Drop
Moves a subtree. x
[e]
x -
Copy Only via
Drag&Drop
Copies a subtree. x
[f]
x -
Hit list Goto Hitlist Calls a selection screen with a hit
list.
For CM hierarchies, the CM
documents and folders are
displayed without a selection
screen, but with their KPro
attributes and, if available,
checkout information.
x x x
Hit list in
hierarchy
Displays hit lists in tree view. x x -
SAP document Goto SAP
document
Switches to the assigned SAP
transaction. Invokes the
configured method (default:
Display) of the SAP object
specified in the attribute source.
For archived data, this calls the
corresponding business or
technical view.
x x x
Hide node Edit Hide
node
Hides selected nodes. x - x
Display
original
Edit Display
original
Displays the original document
or a selection list of documents
assigned to the selected nodes.
For GOS URL attachment nodes,
the web URL defined in the node
is opened either in a browser
window or inplace.
x x x
Refresh View Refresh Refreshes the display after
changes have been made to the
database.
x x x
Get more data Edit Get next
packet of data
Retrieves further data if the
amount of data to be displayed is
restricted.
x x x
Expand all Edit Expand
all
Opens all nodes and displays the
subnodes.
x - -
[a]
no documents
[b]
only ArchiveLink documents, only via file upload
[c]
only on the same level of the hierarchy
Chapter 16 Overview of functions
108 User Guide DC100500-UGD-EN-1
[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
16.2 Functions for Content Management
Content Management (CM) functions, such as displaying properties and versions,
are not available in DocuLink Web UI. However, you can display the CM
documents themselves just as ArchiveLink documents, in the right or separate
window.
The same applies to the visualization in an external (hit)list.
For the visualization in SAP GUI for HTML, all described functions are available.
Icon Name Menu path/
access
Description HT
ML
We
b
Lis
ts
Preview In the document
area
Displays a preview of the
document in the document area.
x x
Display In the document
area
Displays current document in a
viewer.
x x
Detail Edit Detail Displays document properties for
the current document or folder.
x -
Properties In the document
area
Displays attribute properties in
the document area.
x -
Versions In the document
area
Displays an overview of the
existing versions of the current
document.
x -
Properties In the document
area
Display properties of the selected
document version.
x -
Create Edit Create Creates a CM folder or
document.
x -
Edit CM
document
Edit CM
document Edit
Edits CM document and/or
creates a new version.
x -
Local copy CM
document
Edit CM
document
Local copy
Stores a local copy of a CM
document.
x -
Check out CM
document
Edit CM
document
Check out
Locks a CM document for other
users.
x -
Check in CM
document
Edit CM
document
Check in
Unlocks a CM document x -
Undo check
out CM
document
Edit CM
document
Unlock
document
Unlocks a CM document
manually.
x -
16.2. Functions for Content Management
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 109
Icon Name Menu path/
access
Description HT
ML
We
b
Lis
ts
Set status Edit CM
document Set
status
Changes the status of a CM
document.
x -
16.3 Functions in selection screens
These functions are not available in the DocuLink Web UI visualization.
For all other visualizations, all described functions are available.
Icon Name Description HT
ML
We
b
Lis
ts
Execute in
background
Executes the selection in the
background.
x
Selection
options
Range of standard SAP selection
options (greater than, less than,
including, excluding, etc.).
x
Multiple
selection
Defines multiple selection
(multiple single objects,
sequences of object numbers,
etc.).
x
Delete
selection
Deletes a single entry in the field
and restores the last value saved.
x
Delete entire
selection
Deletes all entries from the fields
and restores the last values
saved.
x
Save as
variant...
Saves selection entries in a
variant either for the individual
user or globally (appropriate
authorization required).
x
Get variant... Retrieves user-specific or global
selection entries from a
previously defined variant.
x
Delete variant Deletes user-defined or global
variant (appropriate
authorization required).
x
Configuration Selects displayed attributes. x
Chapter 16 Overview of functions
110 User Guide DC100500-UGD-EN-1
16.4 Functions in hit lists
These functions are not available in the DocuLink Web UI visualization.
For all other visualizations, all described functions are available.
Icon Name Menu path/
access
Description HT
ML
We
b
Lis
ts
Get more data Edit Get next
packet of data
Retrieves further data if the
amount of data to be displayed is
restricted.
x
Refresh Edit Refresh Only for separate hit list:
Refreshes the display after
changes have been made to the
database.
x
Header data Goto Header
Info
Only for separate hit list:
Displays the header data for the
hit list (e.g. project, version, view,
attribute object, node type).
x
Sort in
ascending
order
Edit Sort
ascending
Sorts the rows in selected
columns of a table in ascending
order.
x
Sort in
descending
order
Edit Sort
descending
Sorts the rows in the selected
columns of a table in descending
order.
x
Move column only via
Drag&Drop
Removes a column from the
current view.
x
Output
Settings
Settings
Hitlist (for hit list
in tree only)
Configures a hit list in tree view:
Hides and displays columns, and
defines sequences.
x
16.4. Functions in hit lists
DC100500-UGD-EN-1 OpenText DocuLink for SAP Solutions 111
Chapter 17
Sample projects
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 R/3 documents, print lists). In the
following, some chosen sample projects will be described in more detail.
17.1 Retrieval DVS/PLM Documents example
The sample project Retrieval DVS/PLM Documents ($EX_DVS) shows the document
integration of an SAP PLM DMS document model in a DocuLink view.
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.
DC100500-UGD-EN-1 User Guide 113
17.2 CM document model example
Besides integrating ArchiveLink documents, it is also possible to integrate
documents from SAP-specific, user-defined Content Management document models
in DocuLink. Unlike static, completed ArchiveLink documents, CM document
models are rather used for documents that are still being processed, e.g. in order to
allow for versioning or editing a document by several users. The different
processing states can be indicated by the status. This functionality is also supported
by DocuLink.
As an example for integrating CM document models and in order to describe the
CM functionality, the DocuLink project CM document model is supplied, in which
two different models are implemented.
The sample view has a simple structure consisting of a product and a customer
branch. Both contain a record for each customer or product, and underneath that
any number of CM hierarchy nodes. However, the CM hierarchy nodes differ in the
underlying document models.
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.
Static vs.
Dynamic
documents
Sample view
with product
and customer
branches
CM structures
Chapter 17 Sample projects
114 User Guide DC100500-UGD-EN-1
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.
17.2.1.1 Status management in the sample project
In the product branch of the sample project status management is implemented as
well. Four different document statuses are defined:
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.
Double-click the status icon to change 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).