Documente Academic
Documente Profesional
Documente Cultură
INTRODUCTION .............................................................................................. 2
W HY USE DOCUMENTUM?................................................................................... 2
DOCUMENTUM AT KBR........................................................................................ 2
INTRANET & INTERNET ACCESS ........................................................................... 2
LINES OF SUPPORT ............................................................................................. 3
NEW TERMINOLOGY...................................................................................... 4
GETTING STARTED ........................................................................................ 6
INSTALLING DOCUMENTUM................................................................................... 6
STRUCTURE OF DOCUMENTUM DOCBASE SETUP .................................. 7
STARTING DOCUMENTUM..................................................................................... 7
BASIC DOCUMENTUM FUNCTIONS ............................................................. 9
CONNECTING TO A DOCBASE ............................................................................... 9
Changing Display Options................................................................................. 9
DISCONNECTING FROM A DOCBASE/EXITING DOCUMENTUM .................................. 9
OPENING/VIEWING A DOCUMENT ....................................................................... 10
CHECKING OUT / EDITING A DOCUMENT ............................................................. 11
REFRESHING THE DISPLAY ................................................................................ 11
SAVING AND CHECKING IN A DOCUMENT ........................................................... 11
Versions .......................................................................................................... 12
Displaying/Viewing Different Versions ............................................................ 12
CREATING A FOLDER ......................................................................................... 14
CREATING A DOCUMENT & SETTING PROPERTIES .............................................. 14
Defining Properties.......................................................................................... 17
DELETING AN ITEM ............................................................................................ 17
SEARCHING FOR DOCUMENTS (USING FIND) ...................................................... 18
SETTING PERMISSIONS ...................................................................................... 19
IMPORTING A DOCUMENT FROM OUTSIDE DOCUMENTUM .................................... 19
IMPORTING AN EMAIL MESSAGE ......................................................................... 20
Page 1 of 20
DOCUMENTUM AT KBR
Documentum is an application within the Knowledge Management suite being implemented at KBR. It is
currently being used on several projects and is deployed as a data repository, providing controlled access for
both working (in progress) and released (finalized/approved) documents. The documents can be accessed
from a KBR PC or laptop, the Intranet, and/or by Internet clients. This means users can access, view or edit
content stored in one or more Documentum Docbases (document database) from either their desktops or a Web
browser.
Various document formats being captured include the MS Office products Access, Excel, PowerPoint, Word,
MicroStation drawings, AutoCAD drawings, and pdf formats. Documents created outside applications included in
a normal COE build, such as Aspen or Primavera, can be put into .pdf format and placed in a Docbase for
everyone to read through Adobe Acrobat view capabaility. Documentum is also fully MS2000 compatible, so
when KBR moves to the newest version of Microsoft Office, all Documentum structure and content will remain
completely viable.
Documentum 4.1 is installed via Software Downloads and takes about 20 minutes and two
automatic reboots to complete. Successful installation places the Documentum icon on the
desktop for initialization. Other software that needs to be installed for comprehensive use of
Documentum: Adobe Acrobat 4.0 and Autovue Professional 15.2.
Documentum Icon
NOTE
The link DOES NOT contain the usual www or the @ anywhere in the link. It does,
however, contain the letter s after the normal http. The link must be entered exactly as
Page 2 of 20
LINES OF SUPPORT
Should there be a support issue, whether it is a how-to question or a setup question, the first contact a user
should make is with the Documentum project administrator on his project. If the project administrator is unable
to resolve the problem or question, he will contact one of the system administrators. At no time should questions
go through the regular help line (ext. 4357), as IBM does not support this application.
There is a KBR-based support website on our Intranet that is an excellent source of information for anyone using
Documentum. The link is http://www1.mwk.com/kbr/kbr_documentum/documentum.asp. This website also
contains an up-to-date list of project support personnel.
Page 3 of 20
ACL
(Access Control List) Set of people who have permission to assess certain
objects or documents
Annotate
Cabinet
Check In
Check Out
Consumer
Content
Content
Management
Contributor
Coordinator
Desktop Client
User who accesses Documentum via the desktop rather than through
Internet Explorer
Docbase
Drill-down
EDMS
Import
Inbox
Internet Client
Key
Icon indicating that the user seeing that icon has that object checked out
Launch
Local Files
Temporary resting place of files that are checked out, or files that are stored
offline work on Local Files is stored on the C:/ drive
Lock
My Cabinet
The users Documentum cabinet in the users home Docbase. Only the user
has rights to this cabinet. This cabinets title is the users name.
Page 4 of 20
Permissions
Properties
Refresh
[F5]; updates the user window to reflect any changes that have taken place
in the Docbase
Released Cabinet
Rendition
Vault
Version
Working Cabinet
Workflow
Page 5 of 20
Drive mappings for Q,R,S drives (Q: must map to server nts009). Most likely this has already been done
during COE setup, but please check by going to your Windows NT Explorer and look for a drive called
Q:\\nts009\userapps.
2.
3.
4.
Page 6 of 20
Each Documentum user has access to a folder called Inbox, Local Files, and My Cabinet, as well as Docbases
as allowed by the coordinator (administrator). Documentum Explorer is structured in tree format and visually is
structurally identical to Windows Explorer.
Because Documentum really does reside on the Desktop, the extension of the directory tree is short and direct
from the Desktop icon and can be seen at the bottom of all local and network drives in either Windows or
Documentum Explorer. The tree structure is
Docbase > Cabinet > Folder > Folder > Document
If the Desktop tree structure is completely collapsed, it looks like this:
1
2
3
4
1. Docbases - Central repositories in which users store documents and other objects. Created and
administered at this level by a Documentum coordinator. This is the structure's backbone, and cabinets and
folders can be created in each Docbase.
2. Inbox - Resting-place of every forwarded document to a particular user: e.g., in a workflow.
3. Local Files - Files that could be checked-out documents, or copies of documents to be referenced when
working off-line.
4. My Cabinet - Equivalent of personal (home) drive on Halhouston. If a user has access to multiple
docbases, he has a cabinet called My Cabinet in each.
STARTING DOCUMENTUM
Although there are a few different ways to initialize Documentum once it has been installed, two are
recommended over the others:
1. Right-click Start > Explore > Documentum.
2. Right-click Documentum > Explore.
These two methods result in a cleaner display of Documentum when it opens; i.e., the directory tree is displayed
and only one window remains open as the user moves through the Docbase; this allows the collapse and
Page 7 of 20
Documentum also has its own menu bar, and each menu has its own set of
drop-down options. These options are similar to those in Internet Explorer, but
are specific to Documentum tasks.
There are basically three types of users in Documentum, and each has a
separate role:
Consumer
Needs and has view-only access to the contents of the docbase, and cannot edit or
add content to existing documents.
Contributor
Creates, edits and contributes content to the docbase and has ownership of his own
work. Most users fall in this category, and this document is intended for them.
Coordinator
Manages the structure of the docbase(s), can add or delete users or groups of
users to docbase, managers the organization of information. These people are
sometimes called administrators or superusers. At KBR, the Document Control
Group falls into this category, as does an appointed coordinator on each project.
Page 8 of 20
CONNECTING TO A DOCBASE
1. Open Documentum from the desktop.
2. Double-click the Docbase icon to view available docbases (or click the + sign next to it)
COMMANDS
3. Select the appropriate one, and if prompted for userid and password, type in.
4. Click Connect.
If you are not prompted for a password, the Docbase opens automatically and there is no
further input required of the user past step #3.
3
1
2
Page 9 of 20
2. Select the Docbase name and click either Tools > Disconnect or press [ctrl+K]
To completely exit from Documentum, click File > Close, or click the close button in the top
right corner of the window.
OPENING/VIEWING A DOCUMENT
COMMANDS
1. Open a cabinet from the left side of Documentum Explorer by single-clicking the icon, or
by clicking the + sign next to it. This will expand the tree to show subfolders or
documents.
Double-click the desired document. The Open dialog box will ask whether to View or
to Edit; click the appropriate choice, OR
Right-click the document to get the same options.
The Open dialog box allows the user to state the reason for opening the document either to View it or to Edit it.
If the View option is chosen, the file will open in the appropriate
application, but the title bar will carry the file name, followed by
(Read-Only). The file is uneditable via this option, even by the
Owner. The View option does not actually check out the
document, but displays only a copy of it. This allows many users
to view it simultaneously.
Result of double-clicking:
The Edit option opens the document to the user and allows it to
be edited, provided the permission settings allow it. It also
automatically checks the document out, so no more than one user can ever work on the same version of a
document at one time.
Page 10 of 20
Double-click it and select the Edit option or select it and click File > Edit, OR
Right-click the document to get the same option.
To Save a document, complete the editing and save with any regular method of saving.
COMMANDS
To check in a document, select it and right-click > Check in, or select it and click File >
Check in.
Saving will not automatically check-in a document, and remember that if a document is checked out, no one else
can use it. If a person needs to find out who has it checked out in order to call and request a check-in, he will be
able to do so by right-clicking the document name and clicking the Properties option and going to the
Page 11 of 20
Versions
Versions could also be called editions or revisions. The process of versioning allows users to keep on file a
history of every version/edition/revision that has occurred in a document. Version 1 may have three pages,
version 2 may have nine pages, version 3 may be cut back to seven pages. The document can be saved
(stored) in each of those multi-page states for later reference. Versions are divided into what are called major
and minor categories. Heres an example of major/minor version upgrades:
1.0
Major
1.1
1.2
1.3
Minor
Minor
Minor
2.0
Major
3.0
Major
3.1
3.2
3.3
3.4
4.0
Minor
Minor
Minor
Minor
Major
2. For all other subsequent check-ins, the dialog box always offers the
choices of checking it in at the same version, or increasing
it by a minor or major change. Notice that it does not say
new anymore. The increment is the users choice.
Page 12 of 20
1. The last version checked-in is always shown as the current version. Its possible to always have a list of all
versions of a selected document visible at one time by clicking View > Document Info on the Documentum
toolbar.
rd
NOTE: The word Current in the contents panel is a result of the default
setting in the Check In dialog box to make each new version, whether
minor or major, the current version. Please always leave this option
activated.
Page 13 of 20
CREATING A FOLDER
2. Click File > New > Folder or right-click to New > Folder
In My Cabinet, users can structure folders any way they want. However, in the Working cabinet they may or
may not be able to add subfolders to existing folders; this is dependent upon the permissions set by the owners
of those folders.
Page 14 of 20
Name
Document names must follow the configuration as defined by the project guide. They are
comprised of numbers and letters, and use dashes as separators. If you dont know what the
configuration is, or dont know where to find it, see the project coordinator.
Names can be up to and include 32 characters.
Names are NOT case-sensitive.
Do not add any file extension to the name. Extensions are added automatically as a result of
the format (application) chosen.
Type
Format
The term format is equivalent to application, and there are many choices to be made from this
box. Always choose only formats resident on the PC being used, such as current Office 97
applications, or other software that has been installed. Do not choose an application template
templates are uneditable. Once the format is chosen and the dialog box is closed, the chosen
application will launch.
Template
The choices available in the Template list box are dependent upon the type and format chosen. As
examples:
If the Type chosen is KBR General Document, and if the format chosen is Word 97/2000
Document, the templates available are General Basic Word, General Document Travel
Authorization, and General Project Plan or Procedure.
If the Type chosen is KBR Letter Document, and the format chosen is still Word 97/2000
Document, the template choices are Letter Blank Page and Letter KBR Letterhead.
Page 15 of 20
SPECIAL
NOTE ON
CREATING
NEW FILES
When a user creates his first new file by selecting New > File, the only option available at that
time is Other (see the illustration at the beginning of this Section, Creating a Document &
Setting Properties). For each subsequent new file created, a history list of each format and
template combination used is added to the Other option (example below). Because this list
contains combinations specific to each document created, we recommend that the other
option always be used.
History List
Page 16 of 20
All fields in the Properties dialog box (the dialog box title bar holds
the name of the document being worked on) should be filled in with
the Find function in mind.
The Request Full-Text Indexing option is activated by default in any
text document so that its body can be searched for any words, or for
keywords as entered in this dialog box.
Properties dialog boxes all will have the first four tabs as illustrated
here. The Type of document selected when the document is
created determines any subsequent tabs. These tabs contain
information that is germane to the selection maybe it is a General
Document, Engineering Document, Letter Document, etc. Choices
are made by reference to your Project Plan for instruction.
Note that there are scroll buttons available to move through the tabs
of the dialog box.
DELETING AN ITEM
In Documentum Explorer, right-click the item to be deleted and choose Delete from the popup menu.
COMMANDS
Page 17 of 20
Tab #2 Text
When Properties were set for this
particular document, Full Text
Indexing was activated. That
enables the search to find key words
in the document body.
Tab#
4
Find
Documentum
Items
Once a user gets to this tab, he is ready to use the
Find button. All documents meeting the criteria
entered are listed here, and can be edited or viewed
from here by double-clicking on them.
It is very important to use the Clear All button
before closing the dialog box; otherwise, the next
time it is activated, it combines all the previous search
criteria with the present search criteria and searches a much narrower field. For example, it would combine a
prior search on gold with a newer search on platform to produce a current search on gold platform.
Page 18 of 20
SETTING PERMISSIONS
This document does not discuss setting permissions, but simply explains permission settings that can be seen in
properties of existing documents. There are four main classifications of user categories:
USER CATEGORIES
Owner
Group
Larger entity to which one or more users belong. At KBR some of these groups might be
suppliers, engineering groups, vendors, certain staff members, etc. These groups are named
by the project coordinator and assigned permission rights to certain areas.
User
World
Each of these categories may be assigned different levels of permissions. Categories below are listed from the
lowest level of permission to the highest.
PERMISSION LEVELS
None
No access permitted
Browse
Can see lists of content in Documentum, such as cabinets, folders and document names, but
cannot read contents
Read
Relate
Version
Can create new versions of objects, i.e. edit, can update properties but cannot check-in with
same version number
Write
Can write to (edit) and update files; also can save to current or sequential version
Delete
Page 19 of 20
COMMANDS
1. Select the file from the folder and drive in Explorer; whether it is a local or network drive
doesnt matter.
2. Use any Copy command.
3. In the Docbase, select the folder or cabinet where it is to be placed.
4. Use any Paste command.
5. Check to make sure that the correct document displays in the Files to Import list.
6. Click Import.
7. Assign Properties.
8. Check in.
COMMANDS
1. In the Outlook Mail Inbox, select the email to be saved into the Docbase.
2. Click the Docbase icon on the toolbar.
3. In the Save To dialog box, drill down to the appropriate cabinet and folder in the Save to
Docbase dialog box
4. Click the Save button to bring up the Import As Document dialog box
5. Select the appropriate format and click Import
6. Rename the attached document(s) according to the projects document number plan.
7. Select the appropriate Type. At this point, the user can also add other files from the
Network drives repeat Steps 5-7.
8. Click Import.
Page 20 of 20