Sunteți pe pagina 1din 37

Conguring SAP R/3® for Archive

Services for SAP®

Version 5.3 SP1


October 2005
SAP®, SAP® R/3®, SAP NetWeaver®, SAP ArchiveLink®, ABAP™, BAPI® are trademarks or registered trademarks of SAP AG in Germany
and in several other countries.
Copyright © 1994-2005 EMC Corporation. All rights reserved.
Table of Contents

Preface ........................................................................................................................... 7

Chapter 1 Introducing Archive Services for SAP ................................................... 13


Overview ................................................................................................... 13
Understanding the Archive Services for SAP architecture .............................. 14
Supported SAP document formats ............................................................... 15
Understanding SAP and Archive Services for SAP terms............................... 15

Chapter 2 Conguring ArchiveLink for Archive Services for SAP ......................... 19


Overview ................................................................................................... 19
oac0 — Defining a logical ArchiveID ............................................................ 19
oag1 – Configuring basic settings ................................................................. 20
oanr – Configuring number ranges .............................................................. 20
oaqi - Creating queues ................................................................................ 21
oaat - Scheduling jobs ................................................................................. 21
spad – Configuring optical archives as output devices................................... 22
sm50 – Verifying spool processes ................................................................. 23
oaa3 – Configuring the SAP inline Print List viewer protocol ......................... 24

Chapter 3 Customizing SAP Document Classes .................................................... 27


Overview ................................................................................................... 27
oac0 – Configuring content repositories........................................................ 27
oac2 - Defining document types ................................................................... 29
oac3 - Defining links ................................................................................... 29

Chapter 4 Testing the Archiving Process Using a Print List .................................. 31


Overview ................................................................................................... 31
Creating a document type in SAP ................................................................ 31
Testing connection between SAP and Archive Services .................................. 32
Archiving a Print List.................................................................................. 32
Displaying the archived Print List in SAPGUI .............................................. 33
Deleting archived and linked documents ..................................................... 34

Conguring SAP R/3® for Archive Services for SAP® 3


Table of Contents

List of Figures

Figure 1–1. Archive Services and SAP ............................................................................... 14

4 Conguring SAP R/3® for Archive Services for SAP®


Table of Contents

List of Tables

Table 1–1. Terms and definitions ..................................................................................... 15


Table 2–1. Field descriptions of Change Output Device screen .......................................... 23
Table 3–1. Field descriptions of Change Content Repositories screen ................................. 28
Table 3–2. Field descriptions of New Entries table ............................................................ 30

Conguring SAP R/3® for Archive Services for SAP® 5


Table of Contents

6 Conguring SAP R/3® for Archive Services for SAP®


Preface

Purpose of this guide


This guide explains how to configure SAP to use Archive Services for SAP 5.3 SP1 (Archive
Services 5.3 SP1.) It provides task-based instructions for configuring SAP, so that it works
together with Archive Services.
Note: For the sake of brevity, throughout this document, Archive Services for SAP will
be referred to as Archive Services.

Intended audience
In order to address the manuals to the correct audience, the roles of the users of the
manuals have been defined as follows:
• System Administrator - This role covers users who install and configure Archive
Services. The Archive Services application integrates Documentum and the SAP R/3
system. As a result, system administrators may require experience with:
— Windows XP, 2000, 2003, or HP-UX 11i
— UNIX (if Documentum Content Server or SAP R/3 are installed on a UNIX-based
platform).
— Tomcat Web server
— Apache HTTP server (if your installation scenario includes load balancing)
— Documentum Technologies like Content Server and DFC
— SAP R/3 versions 4.6c or 4.7
— The following databases, depending on your system platform:
— DB2
— Oracle
— SQL Server
— Sybase
• Archive Services Administrator - This role covers users who manage Archive Services
using WebAdmin.
• Standard User - This role covers users who view documents using SAPGUI.
This manual is intended for system administrators.

Conguring SAP R/3® for Archive Services for SAP® 7


Preface

Revision history
This section contains a description of this document’s revision history.

Revision history

Revision Date Description


June 2005 Initial publication of document for CS for
SAP - Archiving Server 5.3
October 2005 Revised publication for Archive Services
for SAP 5.3 SP1

Organization of this guide


This guide contains the following chapters. The table below lists the information that
you can expect to find in each.

Organization of this guide

Chapter Contents
Chapter 2, Configuring ArchiveLink for Describes how to configure SAP for
Archive Services for SAP document, report, and data archiving.
Chapter 3, Customizing SAP Document Describes how to configure SAP for
Classes scanning.
Chapter 4, Testing the Archiving Process Describes how to test the archiving
Using a Print List process using a Print List.

Typographic conventions
This guide uses the following text conventions:

Typographic conventions used in this guide

Convention Description
> Represents a pop-up or pull-down menu.
<Text enclosed within angle brackets> Represents a variable name for which you
must provide a value, or a defined term.

8 Conguring SAP R/3® for Archive Services for SAP®


Preface

Convention Description
Represents code samples, user input, and
Information in this font
computer output.
[] square brackets Used in method command syntax
specifications, square brackets indicate an
optional argument.
{} curly brackets Used in method command syntax
specifications, curly brackets indicate an
optional argument that can be repeated
more than once.

Related documentation
This manual forms part of a documentation suite designed to support those who install,
configure, and use Archive Services for SAP. The product and documentation suite can
be found on Documentum’s download center: https://documentum.subscribenet.com.
From Subscribenet, you can download the latest version of Archive Services for SAP and
the related documentation suite. To access the contents in Subscribenet, you will need to
provide the login credentials assigned to you when you first applied for access.
Note: Your login ID, by default, is your email address. If you cannot locate your
password, use the password finder at the bottom of the login page.
If you’re accessing Subscribenet for the first time, you will need to apply for access and
obtain a user name and password. Refer to Applying for access.

Archive Services for SAP — Documentation suite

Title Description Target role


Archive Services for SAP Provides an overview Standard User, System
Release Notes of new and amended Administrator, System
features, known bugs, Administrator (SAP),
limitations, miscellaneous and Archive Services
technical notes, and Administrator
documentation correctness
and clarifications.
Archive Services for SAPr Provides the procedures System Administrator
Installation Guide for installing Archive
Services.

Conguring SAP R/3® for Archive Services for SAP® 9


Preface

Title Description Target role


Configuring SAP R/3 for Describes the configuration System Administrator
Archive Services for SAP tasks that need to be (SAP)
performed in SAP so that
SAP can communicate with
Archive Services.

Archive Services for SAP Describes how to configure Archive Services


Administration Guide Archive Services using the Administrator
WebAdmin tool.
Archive Services for SAP Describes how SAP users Standard User
User Guide view documents.

Note: Archive Services extensively uses SAP’s ArchiveLink component. Please refer to
SAP ArchiveLink’s documentation for information on how you can perform advanced
tasks.

Applying for access


To apply for access to Support online:

1. In your Web browser, open http://www.documentum.com


2. Click the Support link.
3. Click the Request Access link.
4. Complete the form and send it.
Documentum will respond to your request within two business days.

Accessing documentation online


Customers with a Software Support Agreement can read our product documentation
at the Documentum Web site. You must have a valid user name and password, and
Adobe Acrobat Exchange or Acrobat Reader installed on your system in order to view
the documentation.

To access documents online:

1. In your Web browser, open http://www.documentum.com


2. Click the Support link.
3. Log on to the Support page.
4. Click the Documentation link.

10 Conguring SAP R/3® for Archive Services for SAP®


Preface

5. Select how you want to display the documentation.


6. Click List.
7. Click the name of the document.

Purchasing bound paper manuals


Our product documentation is available for purchase as bound paper manuals. To
place an order, call the Documentation Order Line at (925) 600-6666. You can pay with
a purchase order, check, or credit card.

Conguring SAP R/3® for Archive Services for SAP® 11


Preface

12 Conguring SAP R/3® for Archive Services for SAP®


Chapter 1
Introducing Archive Services for SAP
Overview
The Archive Services application integrates the EMC Documentum content management
system with the SAP R/3 system. Based on SAP’s ArchiveLink interface, Archive Services
provides a technology bridge between EMC Documentum and SAP R/3.
Archive Services provides the following functionalities:
• Enables users to easily access and display documents stored in a Documentum
repository from within a variety of SAP modules.
• Links documents stored in Documentum to a variety of SAP documents.
• Archives SAP data, reports, and documents through ArchiveLinkTM certified
interfaces in Documentum.
This chapter covers the following topics:
• Understanding the Archive Services for SAP architecture, page 14
• Supported SAP document formats, page 15
• Understanding SAP and Archive Services for SAP terms, page 15

Conguring SAP R/3® for Archive Services for SAP® 13


Introducing Archive Services for SAP

Understanding the Archive Services for SAP


architecture
Figure 1-1. Archive Services and SAP

Archive Services for SAP consists of two components:


• HTTP Archiving Server
A server component that, using an HTTP connection to SAP, enables you to archive
reports, data, incoming and outgoing documents from SAP to the Documentum
repository. Archive Services is a J2EE servlet that communicates with SAP
ArchiveLink. The reports and archived documents can later be retrieved and viewed
through SAPGUI.
• WebAdmin

14 Conguring SAP R/3® for Archive Services for SAP®


Introducing Archive Services for SAP

An administrative console that allows you to:


— Create, configure, and manage archives
— Manage certificates for the archive
— Create repository connections for Archive Services
— Configure document archival for Archive Services
Note: Please refer to the Archive Services for SAP Release Notes for detailed information
about specific OS versions and supported software environments.

Supported SAP document formats


Documentum supports the following SAP document classes/formats:
• Incoming or Scanned Documents (FAX class, Tiff format)
• Outgoing Documents (OTF class, PDF format)
• Archived Data (REO class, REO format)
• Reports or Print Lists (ALF class, ALF format)

Understanding SAP and Archive Services for SAP


terms
This section presents some terms and their definitions, as used in this guide.

Table 1-1. Terms and denitions

Term Definition
Archive Services for SAP Product that connects Documentum to
SAP and vice versa.
Archive Services Server component that, using an HTTP
connection to SAP, enables you to archive
reports, data, incoming and outgoing
documents from SAP to the Documentum
repository. Archive Services is a J2EE
servlet that communicates with SAP
ArchiveLink. The reports and archived
documents can later be retrieved and
viewed through .

Conguring SAP R/3® for Archive Services for SAP® 15


Introducing Archive Services for SAP

Term Definition
WebAdmin An administrative console that allows you
to:
• Create and manage archives
• Manage certificates for the archive
• Create repository connections for the
Archive Services
ArchiveLink Cross-functional interface that is part
of the SAP Basis System. ArchiveLink
handles storing and retrieving documents
and data to and from a repository external
to SAP.
SAP DMS Document Management System that is
part of the SAP Basis System. Presents
a logical layer to integrate with external
systems like AutoCAD or Documentum.
Not directly related to ArchiveLink.
SAP PLM Product Life-Cycle Management (PLM).
SAP PLM provides an integrated
environment that ensures all people
involved in product development,
manufacturing, and service have quick
and secure access to current information.
It provides a set of BAPI calls that
can be used by external systems like
Documentum.
SAP Master Record A set of master data, such as customer or
vendor data, which is used in the creation
of SAP documents.
SAPGUI SAP Graphical User Interface. Graphical
menu/screen tool that connects a client to
the SAP server.

16 Conguring SAP R/3® for Archive Services for SAP®


Introducing Archive Services for SAP

Term Definition
Original Document Paper based version of a document.

Example 1-1.
An invoice may consist of two sheets of
paper received from a supplier. Paper
documents are scanned in and stored as
electronic originals in Documentum.
SAP Document An electronic transactional record of
header data and line items in SAP.

Conguring SAP R/3® for Archive Services for SAP® 17


Introducing Archive Services for SAP

18 Conguring SAP R/3® for Archive Services for SAP®


Chapter 2
Conguring ArchiveLink for Archive
Services for SAP
Overview
The Archiving Server component is the part of the Archive Services for SAP application
that handles archive requests for a repository. This means that you can store and retrieve
documents, reports, and data through SAP ArchiveLink and DMS interfaces.
Prior to running the Archive Services, the SAP R/3 system must also be configured. This
chapter describes how to configure your R/3 ArchiveLink and other related transactions
through SAPGUI and the R/3 system.
Note: The configuration steps often reference direct transaction codes. These codes
allow you to navigate directly to the correct configuration screen. Most of the system
configuration is performed in the SAP Implementation Guide for R/3 customizing (IMG).
You can navigate to this screen using the following transaction code: spro.
The various configuration tasks that you have to perform are described in the following
sections:
• oag1 – Configuring basic settings, page 20
• oanr – Configuring number ranges, page 20
• oaqi - Creating queues, page 21
• oaat - Scheduling jobs, page 21
• spad – Configuring optical archives as output devices, page 22
• sm50 – Verifying spool processes, page 23
• oaa3 – Configuring the SAP inline Print List viewer protocol, page 24

oac0 — Dening a logical ArchiveID


Note: The name of the logical ArchiveID must be the same as the ArchiveID created
using WebAdmin (refer to the Configuring, Viewing, and Editing Archives section of the
Archive Services for SAP Administration Guide).

Conguring SAP R/3® for Archive Services for SAP® 19


Conguring ArchiveLink for Archive Services for SAP

To dene a logical ArchiveID in SAP:

1. Execute the following transaction in the transaction code field: oac0.


2. In the Display Content Repositories: Overview page, click on any content
repository (specifically whose Storage type is HTTP content server.
3. In the Display Content Repositories: Detail page, click the Display/Change icon
The Copy as ... button is now enabled.
4. Click the Copy as ... button.
5. Edit the Content Rep. field so that it’s the same as ArchiveID created using
WebAdmin (refer to the Configuring, Viewing, and Editing Archives section of the
Archive Services for SAP Administration Guide).
6. In the Transfer drctry field, enter the directory path where SAP can write the Print
List till it is in the Storage Queue.
7. In the HTTP Server field, type your system name.
Note: You are recommended to type the IP address of your system in this field.
8. In the HTTP Script field, type the following:
/archivelink/archivelink/<name-of-repository>

9. To save the logical ArchiveID configuration, choose Content Repository→Save.

oag1 – Conguring basic settings


You must define the basic settings for ArchiveLink.

To congure the basic settings:

1. Execute the following transaction in in the transaction code field: oag1.


2. Ensure that the Deactivate Print List Management in DMS box is checked.
3. Save your changes.

oanr – Conguring number ranges


You must configure the number ranges for ArchiveLink.

To congure the number ranges:

1. Execute the following transaction in the transaction code field: oanr.

20 Conguring SAP R/3® for Archive Services for SAP®


Conguring ArchiveLink for Archive Services for SAP

2. To edit the configuration, click on the Intervals button (marked with a pencil).
The Display Number Range Intervals window opens.
3. Configure the Number Range 01 with default values.
4. Save your changes.

oaqi - Creating queues


When Print Lists are archived, the SAP print spooler puts the document into the
asynchronous queue. The scheduler then picks up the document and sends it to the
archive. The queue serves as a buffer for everything sent to an SAP archive. Other
queues are used for outgoing documents and barcodes. These queues can be seen on
the ArchiveLink Monitor screen (transaction code: oam1). If this screen shows the word
MISSING instead of zeros, you must create queues and specify an administrator. Define
an SAP user with the proper ArchiveLink administrator profile as the administrator for
this queues. Defining an administrator will automatically create the queues. Check that
the queues have been created by reviewing transaction oam1.

To create queues:

1. Execute the following transaction in the transaction code field: oaqi


The SAP ArchiveLink: Create All Queues (CFBC, CARA, CGDA) screen appears.
2. Fill in all the options with ‘x’.
3. Enter a valid SAP login name in the Queue Administrator field.
4. Choose Program>Execute.
5. Click Cancel to exit this window.

oaat - Scheduling jobs


The SAP schedule job periodically checks the output queue and sends all the items in
the queues to the archive. You must configure the schedule job to successfully archive
documents to an SAP archive.

To schedule a job:

1. Execute the following transaction in the transaction code field: oaat


2. Create a new job.
3. Type ILQBATCH in the ABAP Program field.

Conguring SAP R/3® for Archive Services for SAP® 21


Conguring ArchiveLink for Archive Services for SAP

4. To verify that there are no errors, click Check.


5. Save your changes.
6. Click Back to return to the Define Background Job window.
7. Click the Start Date button.
8. Set Start Time to Immediate.
9. Select the Periodic Job checkbox.
10. Click Period Values and specify an interval such as 20 minutes.
This value should be determined by the following factors:
• Frequency of archival
• Time taken to archive your largest document; for example, your largest Print List
11. Save your changes
12. Click Exit.

spad – Conguring optical archives as output


devices
An output device is the driver software for the logical output device which archives
documents using the ArchiveLink interface. To correctly archive a document to SAP,
you must define the output device as an optical archive. Configuring an output device
includes defining the type, the device, the spool server, and so on. There should be only
ONE ARCH device; therefore, prior to defining a device with the ARCH short name, you
should delete any existing ARCH devices such as ARCHIXOS.

To congure an optical archive as the output device:

1. Start SAPGUI and connect to your R/3 server.


2. Execute the following transaction in the in the transaction code field: spad.
3. Click the Output Devices button.
4. Click the pencil button to edit settings.
Note: You can only have one printer and that printer must be named ARCH. If
you are already using a printer named ARCH you can either delete it or using the
existing ARCH device.
5. In case ARCH already exists, select device ARCH and click the Delete button.
6. Click the New Entries button to create a new output device.
The Change Output Device screen is displayed.

22 Conguring SAP R/3® for Archive Services for SAP®


Conguring ArchiveLink for Archive Services for SAP

7. Fill in the following information:

Table 2-1. Field descriptions of Change Output Device screen

Field name Value


Output Device ARCHIVE
Short Name ARCH
Device Type ARCHLINK
Spool Server Select spool server from drop down list.
Usually there is only one spool server
listed
Device Class Type A, for archive program
Access Method Fill I, for archive service
Location Fill Archive
Message Fill ArchiveLink Device

8. Click Enter and the dialog box changes.


9. Save your changes.

sm50 – Verifying spool processes


Archive Services uses the standard SAP print spooler to send reports to the ArchiveLink
queue. To successfully archive a document, the print spooler must be running.

To verify if a spool process is running:

1. Execute the following transaction in the transaction code field: sm50.


2. Verify that a process named SPO is waiting or running.
If you do not have a spool process running, contact your SAP system administrator.
Starting a spool process usually involves restarting the SAP server.

Conguring SAP R/3® for Archive Services for SAP® 23


Conguring ArchiveLink for Archive Services for SAP

oaa3 – Conguring the SAP inline Print List


viewer protocol
SAP R/3 includes a Print List viewing feature that allows you to view saved Print Lists,
in SAPGUI, in their native ALF format. To view saved Print Lists in SAPGUI, you must
configure the protocol to support the viewer.

To congure the Print List viewer to display the Print Lists in SAPGUI:

1. In the transaction code field, execute the following transaction: oaa3.


The SAP ArchiveLink: Communications interface administration page appears.
2. Click Create.
The New Protocol dialog box appears.

Example 2-1.
You may wish to define the protocol name as DCTMALF; this could refer to Archive
Services with ALF Viewer.

3. Type version 0045 for HTTP-based archiving.


4. Save your changes.
The Overview of a Protocol window appears, displaying your newly-defined
protocol.
5. Double-click Display Stored Document.
The Overview of a Protocol window appears, showing a list of Document Classes.
6. Select the * row which indicates all document classes.
7. Click the pencil button.
The Overview of a Protocol dialog box appears.
8. Type OPEN in the Communication Type field.
9. Press the [Enter] key.
10. Type DCTM in the Application field.
11. Click Continue.
12. In the Overview of a Protocol window showing the list of Document Classes, select
the ALF document class.
13. Click the pencil button.
The Overview of Protocol dialog box appears.
14. Type R/3 in the Communication Type field.

24 Conguring SAP R/3® for Archive Services for SAP®


Conguring ArchiveLink for Archive Services for SAP

15. Press the [Enter] key


No application is entered here.
16. Save your changes.
You are returned to the Overview of a Protocol window.
If you repeat step 4 and 11, you should see that the * document class and the ALF
document class are indicated as Maintained Explicitly. All other document classes
should be indicated as Not Maintained Explicitly.

Conguring SAP R/3® for Archive Services for SAP® 25


Conguring ArchiveLink for Archive Services for SAP

26 Conguring SAP R/3® for Archive Services for SAP®


Chapter 3
Customizing SAP Document Classes
Overview
The following sections describe how to archive document classes from SAP. The
customization of each SAP setup is different depending on which document class the
archived document belongs to. The document classes are:
• ALF
• FAX
• OTF
• REO
For all classes, you must configure, at least:
• oac0
• oac2
• oac3
plus any specific customizations. These customizations are described in the following
sections:
• oac0 – Configuring content repositories, page 27
• oac2 - Defining document types, page 29
• oac3 - Defining links, page 29

oac0 – Conguring content repositories


SAP allows you to define a content repository (previously known as a logical archive).
This content repository is mapped to a Documentum archive via WebAdmin. The
Documentum archive links to a set of rules such as content folders, Documentum
document types, and so on in the Documentum repository. It is recommended that
you store each document type in a separate archive. Using WebAdmin, you must
create a matching archive for each ArchiveID defined in SAP. This ArchiveID defines
what actions (types, folders, retention, and so on) are applied on a SAP document when
it is archived. The following sections explain how to create an archive in SAP for each
represented document class.

Conguring SAP R/3® for Archive Services for SAP® 27


Customizing SAP Document Classes

When configuring archives, you are essentially configuring HTTP-based archives. The
steps below provide information on configuring HTTP-based archives.

To dene an SAP content repository:

1. Execute the following transaction in the transaction code field: oac0


2. Click the pencil button to edit the table.
3. Click New Entries.
4. Select Full administration.
The Change Content Repositories window opens.
5. Fill in the following information on the Change Content Repositories window:

Table 3-1. Field descriptions of Change Content Repositories screen

Field name Value


Content rep Specify a two-letter archive name. For
example, AA
Description A meaningful name. For example, SAP
Print Lists (AA)
Storage Type Select HTTP
Protocol The previously configured protocol.
Version No. 0045 for HTTP
Output Device ARCHIVE

6. Type appropriate values in the following fields for the HTTP Archiving Server:
• HTTP server
Type the hostname or IP address of the Archive Services host. If you use a server
name here, ensure that you can ping the server by name from the SAP server.
• Port Number
Type the port number being used (default is 80).
When using a default Tomcat configuration, this value is usually 8080.
• HTTP Script
Type the following value in this field:
archivelink/archivelink/<repository>
where <repository> is the name of the repository that you will be archiving
content into. You must configure a corresponding archive in the Archive
Services, using WebAdmin.

28 Conguring SAP R/3® for Archive Services for SAP®


Customizing SAP Document Classes

• Basic path
Type the file system path to the location where SAP will put archived documents
to be picked up by Archive Services.
• Arch path
Usually, the same as the Basic path.
Repeat this procedure to define the additional archives. You may use this procedure to
define any Documentum archives in SAP.

oac2 - Dening document types


You must select which document types you will be archiving, and correlate those to SAP
document classes, such as FAX, ALF, OTF, and REO, The list of document types provided
by SAP, when using transaction OAC2, are the templates to be used for categorizing your
SAP documents for archiving. You can customize the standard document types by
using the SAP XYZ naming conventions.
• FAX documents are documents that will be scanned and linked to SAP.
• ALF are reports produced and linked from SAP.
• OTF are outgoing SAPSCRIPT documents produced and linked from SAP.
• REO documents are data archive files which are compressed by the SAP ADK and
stored externally in that format.
To dene document types for SAP:

1. Execute the following transaction in the transaction code field: oac2.


2. If you are defining a new document type, select New Entries.
You may also copy existing document types.
3. If you are modifying an existing document type, use Change and Details.
4. Enter information in the Description and Doc. class fields as appropriate for your
configuration.
5. When you have finished selecting document types, save your changes.

oac3 - Dening links


Using the link table, you can categorize SAP documents to define what combination of
SAP object type (for example, SOOD) and SAP document type (for example, GENPRILIS)
are stored and linked to which archive.

Conguring SAP R/3® for Archive Services for SAP® 29


Customizing SAP Document Classes

The SAP document type is linked to the SAP document class, previously known as SAP
document type (for example, ALF, OTF, REO) which determines how the document is
produced and linked. For example, the ALF class refers to reports, FAX to scanned
documents, and OTF to outgoing SAPSCRIPT documents.

To dene links:

1. Execute the following transaction in the transaction code field: oac3.


The Display View “Links for Content Repositories": Overview screen appears.
2. Select Table View > Display -> Change.
3. Fill in the following information in the New Entries table:

Table 3-2. Field descriptions of New Entries table

Field name Value


Object Type Use legitimate object type such as SOOD
for Print Lists, and BKPF for accounting
documents
Document Type The SAP doc type as defined in OAC2
above such as GENPRILIS
S (Status) Enter an “x” in this column

Arch. ID Enter the archive ID of a newly created


archives for example, AA
Link Enter the name of the link tables where
links will be maintained. TOA01-TOA03
Ret Prd. 0

4. Save your changes.

30 Conguring SAP R/3® for Archive Services for SAP®


Chapter 4
Testing the Archiving Process Using a
Print List
Overview
Once you have completed the configuration procedures described previously in this
guide, you should test the archiving process by:
• defining an ArchiveID in WebAdmin.
For more information, refer to the Configuring, Viewing, and Editing Archives section of
the Archive Services for SAP Administration Guide.
• testing the connection between SAP and Archive Services.
• creating a document type in SAP.
• archiving a Print List.
• displaying the archived Print List in SAPGUI.
This chapter contains the following topics:
• Creating a document type in SAP, page 31
• Testing connection between SAP and Archive Services, page 32
• Archiving a Print List, page 32
• Displaying the archived Print List in SAPGUI, page 33
• Deleting archived and linked documents, page 34

Creating a document type in SAP


To fully test the archival and retrieval cycle, a simple Print List can be configured by
following the instructions give below:
1. Execute the following transaction in the transaction code field: oac3.
The Display View “Links for Content Repositories": Overview screen appears.
2. Select Table View > Display -> Change.
3. From the list, select any item with the ObjectType SOOD.

Conguring SAP R/3® for Archive Services for SAP® 31


Testing the Archiving Process Using a Print List

4. Click the Copy As ... icon and execute.


5. In the page that appears, enter any piece of text starting with the alphabet Z in the
Document type field.
Thus, Z<Your Text> will be the document type.
6. In the Storage system field, enter the name of the logical ArchiveID that you created
earlier (refer to ), where the documents will be archived.
7. Save your changes.

Testing connection between SAP and Archive


Services
1. Execute the following transaction in the transaction code field: oac0.
2. In the Display Content Repositories: Overview page, click on any content
repository (specifically whose Storage type is HTTP content server).
3. In the Display Content Repositories: Detail page, click the Test connection button.
An information messages appears at the bottom of the page, indicating that the
connection test has been successful.

Archiving a Print List


To archive a Print List:

1. Execute the following transaction in the transaction code field: : f.21.


2. Click the Execute button.
3. In the List of Customer Open Items page that appears, select List>Print.
The Print Screen List dialog box appears.
4. Click the Properties button.
The Spool Request Attributes dialog box appears.
5. In the Parameters name column, click Output Options.
6. From the Storage Mode drop-down menu, select Archive only.
Note: Whenever you edit a parameter in this dialog box, we recommend that you
check the Show Selected Print Parameters on Initial Screen checkbox. This ensures
that the customized settings are available in the initial Print Screen List dialog box.

32 Conguring SAP R/3® for Archive Services for SAP®


Testing the Archiving Process Using a Print List

7. Verify that the Object Type and Document Type fields contain the correct values, as
configured in the New Entries table (refer to oac3 - Defining links, page 29). Pick
the following values for example: SOOD GENPRILIS.
If your Document Type is incorrectly configured, refer to the following procedures
for configuring document types in SAP archives:oac2 - Defining document types,
page 29 and oac3 - Defining links, page 29.
8. Type additional information in the Information field.
This label may be anything you wish; for example, your initials.
9. Optionally, type a description of the Print List in the Text field.
10. In the Parameter name column, select General attributes > Time of printing.
11. From the Time of print drop-down list, select Print out immediately.
12. Click Continue in the Spool Request Attributes dialog box.
13. Click Continue in the Print Screen List dialog box.
14. To verify that the Print List is in the archiving queue, execute the following
transaction in the transaction code field: oam1.
The ArchiveLink Monitor screen appears.
The Print List is now queued, waiting for the scheduler to pick it up and transfer it
to the archive.
oaat - Scheduling jobs, page 21, contains information about configuring the
ArchiveLink scheduler.
15. To accelerate the transfer of the Print List from the queue to the archive in the
repository, click Storage Queue.
The Queue: Content server (CARA) screen appears. You should now see an entry
for the newly-archived Print List in this screen.
16. To view the archiving parameter details, double-click the Print List entry.
The Archiving request window opens.
Verify that the details are correct
17. To archive the Print List in an archive located in a repository, click Execute.
You should see a confirmation message that the queue has been processed.
If no errors occur, you can continue testing by displaying the archived Print List.

Displaying the archived Print List in SAPGUI


To display the newly-archived Print List in SAPGUI:

1. Execute the following transaction in the transaction code field: oadr.

Conguring SAP R/3® for Archive Services for SAP® 33


Testing the Archiving Process Using a Print List

2. To find a particular Print List, type appropriate search parameters in the appropriate
fields.
The ArchiveLink: Hit List for Stored Print Lists page appears.
3. Double-click an item in the list to select it.
4. Choose Print List>Display From Content Server.
SAP executes the GET command to retrieve the document from the Documentum
archive. The retrieved document is displayed in SAPGUI and has the DocumentID
of the Print List in Documentum.

Deleting archived and linked documents


In a repository, if you delete version 1.0 of a document that is linked to SAP or archived
from SAP, the link to SAP is also deleted. This is because the dm_relation object which
creates the link to SAP is deleted when the parent object (which is always version 1.0)
is deleted.
We recommend that you do not delete the original version of objects that are linked to
SAP if you want to maintain their link to SAP. If you need to delete version 1.0 of a
document, but want to keep the link to SAP, then, after deleting the document, you must
relink the object to SAP, outside of Archive Services.

34 Conguring SAP R/3® for Archive Services for SAP®


Index

8080 HTTP server field, 28


port used by Tomcat, 28 Port Number field, 28
class
ALF, 15
A FAX, 15
Administrative Console, 14 OTF, 15
ALF, 27, 29 REO, 15
ALF class, 15 configuring
ALF format, 15 ArchiveLink for Archive Services, 19
Arch path field, 29 basic settings, 20
Archive Services, 7 number ranges, 20
configuring ArchiveLink for, 19 optical archive as output device, 22
Archive Services administrator, 7 SAP inline Print List viewer
Archive Services for SAP, see Archive protocol, 24
Services connection
defined, 13 between SAP and Archive Services,
archived and deleting documents, testing of, 32
deleting, 34 content repositories, 27
archived data, 15 creating
archived Print List document type, 31
displaying in SAPGUI, 33 queues, 21
ArchiveLink
configuring for Archive Services, 19
ArchiveLink Monitor window, 33 D
archiving DB2, 7
Print List, 32 defining
archiving process document types, 29
testing using a Print List, 31 links, 30
Archiving request window, 33 logical ArchiveID, 20
asynchronous queue, 21 deleting
archived and linked documents, 34
displaying
B archived Print List in SAPGUI, 33
Basic path field, 29 document
basic settings, configuring, 20 incoming, 15
outgoing, 15
C scanned, 15
supported formats in SAP, 15
Change Content Repositories window, 28
Arch path field, 29 document classes
Basic path field, 29 ALF, 27
HTTP Script field, 28 FAX, 27

Conguring SAP R/3® for Archive Services for SAP® 35


Index

OTF, 27 O
REO, 27 oaa3, 24
document formats, supported in SAP, 15 oaat, 21
document type oac0, 19, 27, 32
creating, 31 oac2, 29
document types oac3, 29, 31
ALF, 29 oadr, 33
defining, 29 oag1, 20
FAX, 29 oam1, 21
OTF, 29 oanr, 20
REO, 29 oaq1, 21
oaqi, 21
F ObjectType, SOOD, 31
f.21, 32 optical archive, configuring as output
FAX, 27, 29 device, 22
FAX class, 15 Oracle, 7
format organization of this guide, 8
ALF, 15 OTF, 27, 29
PDF, 15 OTF class, 15
REO, 15 output device
Tiff, 15 configuring logical archive as, 22
frequency of archival, 22 Overview of a Protocol window, 24

H P
HTTP Archiving Server, 14 PDF format, 15
HTTP Script field, 28 prerequisites
HTTP server field, 28 system administrator, 7
HTTP-based archiving, 24 Print List
archived, displaying in SAPGUI, 33
archiving, 32
I testing archiving process using, 31
intended audience, 7 Print Lists, 15
ALF class, 15
ALF format, 15
J purpose of the guide, 7
jobs, scheduling, 21

Q
L queues, creating, 21
links
defining, 30
logical ArchiveID R
defining, 20 REO, 27, 29
REO class, 15
REO format, 15
N Reports, see Print Lists
number ranges, configuring, 20

S
SAP

36 Conguring SAP R/3® for Archive Services for SAP®


Index

print spooler, 23 OTF class, 15


supported document formats in, 15 PDF format, 15
transaction code, f.21, 32 REO class, 15
transaction code, oaa3, 24 REO format, 15
transaction code, oaat, 21 Tiff format, 15
transaction code, oac0, 19, 27, 32 Sybase, 7
transaction code, oac2, 29 system administrator, 7
transaction code, oac3, 29, 31 prerequisites, 7
transaction code, oadr, 33
transaction code, oag1, 20
transaction code, oam1, 21
T
transaction code, oanr, 20 Test connection button, SAPGUI, 32
transaction code, oaq1, 21 testing
transaction code, oaqi, 21 connection between SAP and Archive
transaction code, sm50, 23 Services, 32
transaction code, spad, 22 testing archiving process using a Print
transaction code, spro, 19 List, 31
SAP Document Classes Tiff format, 15
customizing, 27 Tomcat, port 8080, 28
SAP inline Print List viewer protocol, transaction code
configuring, 24 f.21, 32
SAPGUI oaa3, 24
ArchiveLink Monitor window, 33 oaat, 21
Archiving request window, 33 oac0, 19, 27, 32
Change Content Repositories oac2, 29
window, 28 oac3, 29, 31
displaying archived Print List in, 33 oadr, 33
Overview of a Protocol window, 24 oag1, 20
Queue Administrator field, 21 oam1, 21
Test connection button, 32 oanr, 20
scheduling oaq1, 21
jobs, 21 oaqi, 21
sm50, 23 sm50, 23
SOOD, ObjectType, 31 spad, 22
spad, 22 spro, 19
SPO process, 23 Transfer drctry field, 20
spool process, 23
spool processes, verifying, 23 U
spro, 19 ueue Administrator field, 21
SQL Server, 7 user roles, 7
standard user, 7
supported databases, 7
DB2, 7 V
Oracle, 7 verifying, spool processes, 23
SQL Server, 7 version 0045, 24
Sybase, 7
supported document formats in SAP, 15
ALF class, 15
W
ALF format, 15 WebAdmin, 14
FAX class, 15

Conguring SAP R/3® for Archive Services for SAP® 37

S-ar putea să vă placă și