Configuring for searching for and viewing archived documents by using SAP Document Finder

You can search for, and view, documents that are archived in IBM® Content Manager or Content Manager OnDemand by using SAP Document Finder. SAP Document Finder can handle queries that contain more than one search argument.

About this task

SAP Document Finder searches in a document area. A document area corresponds to an item type of IBM Content Manager or to an application group of Content Manager OnDemand. The document area determines all of the following:
  • The operating system, the application, and the logical archive where the documents are to be searched
  • The attributes that are to be used for the search
  • The layout of the result list, which contains the found documents

Content Collector for SAP supplies the attributes to SAP. SAP supplies the query classes that refer to the attributes and the display classes. You can use these classes or implement your own.

Because you normally do not know in which document area your documents are, you can group several document areas in an aggregated document area. With aggregated document areas, you can search across the document areas and thus in different logical archives. Attributes with the same data type and semantics from different document areas do not need the same technical name. However, by configuring SAP Document Finder, you can group the different attributes under one name in an aggregated document area.

The following figure shows which parts of the Content Collector for SAP environment must be configured so that you can use SAP Document Finder.
Figure 1. Configuration of your Content Collector for SAP environment for searching for and viewing documents by using SAP Document Finder
The architecture of the Content Collector for SAP environment showing only the parts that must be configured so that you can search for and view documents by using SAP Document Finder. These parts include SAP ArchiveLink, a Collector Server instance, IBM Content Manager or Content Manager OnDemand, and the communication between the Collector Server instance and SAP.
In your basic instance configuration, you configured the following parts:
  • An HTTP connection between the Collector Server instance and SAP
  • At least one Java™ RFC dispatcher for the communication between the Collector Server instance and SAP
  • An RFC destination in SAP
  • The logical archives where the documents are stored

To use SAP Document Finder, you must change the instance configuration and you must create a document area with the SAP GUI.

Procedure

  1. Change the instance configuration. In Configuration Feature, take these steps in Extended settings view:
    1. Open the instance configuration that you want to change.
    2. Go to Basic Configuration > Communication > Java RFC Dispatchers and select the Use SAP Document Finder check box.
    3. Go to SAP System > General > General. In the Program ID field, type the program ID that you specified in the RFC destination in SAP. Omit the number 1.
    4. Go to Logical Archives > Logical IBM Content Manager Archive id or go to Logical Archives > Logical Content Manager OnDemand Archive id.
    5. In the General section, select the Logical archive is read-only. Use SAP Document Finder to view the documents. check box.
    6. Repeat steps 1.d and 1.e for each logical archive that is to be searched.
  2. Create a document area in SAP:
    1. Enter the transaction code SPRO to open the Customizing: Execute Project window.
    2. Click SAP Reference IMG.
    3. In the Display IMG window, expand the navigation tree as follows: SAP NetWeaver > Application Server > Basis Services > ArchiveLink > Document Finder Customizing > Register Document Areas.
    4. Click the IMG - Activity icon IMG - Activity in front of Register Document Areas.
      If a window opens with the message Caution: The table is cross-client., press Enter.
    5. In the Change View "ArchiveLink: Document Areas": Overview window, click New Entries.
    6. In the Document Area field of the New Entries: Details of Added Entries window, type the ID of the logical archive that contains the documents.

      For example, type:
      A1

    7. In the Destination field, specify the name of the RFC destination.

      For example, type:
      KD7.iccsap

    8. Optional: Under ArchiveLink: Document Areas, type a description for the document area.
    9. In the Query Class field, type:
      CL_ALINK_QUERY
    10. In the Maximum No. of Hits field, type 1000.
      If you leave this field empty, your result list shows all documents that match the search criteria.
    11. Ensure that the FTS Active check box is not selected.
      Checking it enables full-text search, which is currently not supported by Content Collector for SAP.
    12. Select the Document Area Active check box.
    13. Click the Save icon.Save (CTRL+S).
    14. In the “Prompt for Workbench request” window, select a request in the Request field.
      If a request does not exist yet, click the Create icon Create (F8) to create a request.
    15. Click the Continue icon Continue (Shift+F1).
    16. Click the Back icon Back (F3) to return to the Change View "ArchiveLink: Document Areas": Overview window.

Results

The new document area is displayed in the list of document areas in the Change View "ArchiveLink: Document Areas": Overview window.

In a server configuration profile, you find the following specifications that relate to SAP Document Finder:

Section in server configuration profile Keyword UI field that supplies the value Where to find the UI field in Configuration Feature
DESTINATION PROGID Program ID SAP System > General > General
ARCHIVE ARCHIVETYPE The selection of the Logical archive is read-only. Use SAP Document Finder to view the documents. check box results in the value GENERIC. Logical Archives > Logical repository Archive id > General