PROCESS DIRECTOR Import Guide 7.7.x
PROCESS DIRECTOR Import Guide 7.7.x
Date: 2018-11-20
Legal Notice
Kofax is a trademark of Kofax, Inc., registered in the U.S. and/or other countries. All other trademarks
are the property of their respective owners. No part of this publication may be reproduced, stored, or
transmitted in any form without the prior written permission of Kofax.
2
Table of Contents
Legal Notice...................................................................................................................................................2
Overview........................................................................................................................................................ 5
About ReadSoft PROCESS DIRECTOR transports.......................................................................... 5
Transports for different SAP versions..................................................................................... 5
Contents................................................................................................................................... 5
Location....................................................................................................................................6
Licensing............................................................................................................................................. 6
Web Application..................................................................................................................................7
Upgrading............................................................................................................................................7
Upgrading ReadSoft PROCESS DIRECTOR Accounts Payable............................................7
Upgrading ReadSoft PROCESS DIRECTOR..........................................................................7
Upgrading SAP........................................................................................................................ 9
Import procedure......................................................................................................................................... 10
Implementing prerequisite SAP Notes............................................................................................. 10
Required SAP notes.............................................................................................................. 10
Recommended SAP notes.................................................................................................... 16
Importing the transports................................................................................................................... 19
Service Packs........................................................................................................................ 20
ReadSoft PROCESS DIRECTOR......................................................................................... 21
Languages..............................................................................................................................22
Reading the import log.....................................................................................................................22
Checking the namespaces............................................................................................................... 22
After importing the transports...........................................................................................................22
Executing the load generator................................................................................................ 22
Installing licenses..............................................................................................................................23
Importing and activating indexes for PD AP performance optimization......................................................24
Index types....................................................................................................................................... 24
Type 1.................................................................................................................................... 24
Type 2.................................................................................................................................... 25
Type 3.................................................................................................................................... 25
Prerequisite....................................................................................................................................... 26
Importing indexes into the development system..............................................................................26
Activating indexes.............................................................................................................................26
Space calculation..............................................................................................................................30
3
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Troubleshooting........................................................................................................................................... 32
ReadSoft PROCESS DIRECTOR Accounts Payable...................................................................... 32
Import errors.......................................................................................................................... 32
Other problems...................................................................................................................... 32
ReadSoft PROCESS DIRECTOR.................................................................................................... 32
Import errors.......................................................................................................................... 32
Short dumps...........................................................................................................................32
Other problems...................................................................................................................... 33
Setting the buffer size...................................................................................................................... 34
4
Overview
This document explains how to import the Kofax ReadSoft PROCESS DIRECTOR™ transports into your
SAP system.
• ReadSoft PROCESS DIRECTOR transports. Which ones to use and the download location.
• Tasks to perform when before upgrading from a previous version of ReadSoft PROCESS DIRECTOR.
• Tasks to perform before and after upgrading your SAP system.
• Implementing prerequisite SAP Notes.
• Importing the transport(s).
• Checking the necessary namespace(s).
• Required tasks after importing.
• Troubleshooting information.
Note From ReadSoft PROCESS DIRECTOR 7.4, only versions from SAP ECC6 and higher are
supported, including SAP S/4HANA on-premise releases.
Contents
This table lists the processes and supplementary products that the transports contain.
5
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Transport Contents
PD AP Transport ReadSoft PROCESS DIRECTOR Accounts Payable
ReadSoft PROCESS DIRECTOR WORK CYCLE (SAP parts)
ReadSoft EDI COCKPIT™
ReadSoft Email-based Approval™ (formerly MOBILE APPROVAL) (SAP
parts)
ReadSoft INFO MAIL™ (SAP parts)
ReadSoft REPORTER™ EXTRACTOR
PD Transport Requisitions
Order Confirmations
Goods Receipts
Payment Approvals
Accounts Receivable (formerly Payment Advices)
• Includes Electronic Bank Statements
Customer Orders
Financial Postings
Master Data:
• Customer
• Vendor
• Cost Center
• Profit Center
• GL Account
• Asset
Asset Management:
• Acquisition
• Transfer
• Retirement
Generic Archiving
Location
ReadSoft PROCESS DIRECTOR transports are available for partners and customers on the Kofax E-
Delivery web service.
Licensing
You must order a license from Kofax to activate ReadSoft PROCESS DIRECTOR. Each process type and
supplementary product can only be used if a valid license is activated. For details on installing licenses,
see the following guides in the Product Documentation website at:
https://docshield.kofax.com/Portal/Products/en_US/RSPD/RS_Process_Director.htm
• PROCESS DIRECTOR License Installation Guide
6
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
https://docshield.kofax.com/Portal/Products/en_US/RSPDAP/RS_Process_Director_AP.htm
• PROCESS DIRECTOR Accounts Payable Configuration Guide
Web Application
When installing a new version of ReadSoft PROCESS DIRECTOR or a service pack, we strongly
recommend that you also deploy the latest version of the Web Application with the latest patch.
In general, since ReadSoft PROCESS DIRECTOR 7.4, the Web Application is independent of the SAP
version.
Upgrading
This section lists the tasks that you need to perform when upgrading to ReadSoft PROCESS DIRECTOR
from previous versions.
Note ReadSoft PROCESS DIRECTOR and ReadSoft PROCESS DIRECTOR Accounts Payable can be
upgraded independently of one another, for only all the currently supported versions. Thus, it is possible,
for example, to remain with ReadSoft PROCESS DIRECTOR Accounts Payable 7.5, but upgrade other
processes to 7.7, and vice versa.
Note If you are using the EOL solution, ReadSoft ANALYZER, do not upgrade to the 7.6 version as this
will remove the existing ANALYZER package.
7
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
PROCESS DIRECTOR prior to 7.2 and have customized processes, checks, or determinations, you
should run the /EBY/PDBO_CHECK_CUST_PROCESS consistency check program. This program lists
all the obsolete customizing entries that must be removed.
Remove the entries in the appropriate IMG configuration activity. For example, to remove obsolete
determination entries, go to Initial settings > Rules > Determinations and delete the entries
for the corresponding Actions. Similarly, do it for Initial settings > Rules > Checks .
• The workflow start action was modified to allow bulk workflow start with manual assignment.
If custom checks or actions have been configured for workflow start, these must be redefined
after upgrading. In most cases, this involves replacing the WCSTRT10CHECK_DOC action with
WCSTART10CHECK_DOC_, and the WCSTART0CHECK_OWNER action with WCSTART0CHECK_OWNER_.
You can run the /EBY/PDBO_CHECK_CUST_PROCESS consistency check program to list the
customizing entries that must be changed. Refer to RSPDN3026 for more information and detailed
instructions.
• From ReadSoft PROCESS DIRECTOR 7.7, the /EBY/PDVI_TRANSLATE_OLD_MENU program is
available to transition the existing custom menu and toolbar function code settings to the current design
tables.
The /EBY/PDVI_TRANSLATE_OLD_XY_MEN program is also available to transition the standard
configuration containing the customer document types that are based on the XY template. This report
transfers the menu configuration from the old to the new format, which makes it visible in the new
configuration transaction available in the IMG tree.
Note After the transition, the report asks for the transport number a couple of times. Workbench
transports handle the standard settings, like the menu configuration; whereas the customizing
one transfers the information that the menu has been modified. The destination system needs this
information to decide about menu regeneration.
If you are upgrading from a lower version, refer to the corresponding Import Guide and perform the
upgrade in two steps; first from the lower version to the supported one, and then to the latest version.
8
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Upgrading SAP
If you upgrade an SAP S/4HANA version, it is recommended to upgrade to the latest PROCESS
DIRECTOR Service Pack.
9
Import procedure
Important Before importing the ReadSoft PROCESS DIRECTOR transport requests, ensure that the
prerequisite SAP notes are implemented in your system. Also, check the Upgrading chapter for tasks
that you may need to perform before importing.
Note Most of the referenced SAP Notes are for very old SAP releases and not applicable.
10
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
11
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
12
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
13
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
14
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
15
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
16
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
17
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
18
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Warning: Import the transports one at a time for the main version transports. If a return code greater
than 4 is returned after importing a transport, do not import any further transport requests! Contact Tech
Support for assistance and provide details of the return code.
For importing service packages, the SP transports can be imported in one queue.
Note In systems with Enhancement Pack 5 and later, you may get the error message “n of n requests
do not match the component version of the target system” when trying to import the ReadSoft
PROCESS DIRECTOR transports, and the import cannot be carried out. It is recommended to activate
the Ignore Invalid Component Version import option in the Import Transport Request dialog box.
See SAP Note 1742547 for more information.
19
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Service Packs
When importing service packs, you need to import only the most recent service pack. Later service packs
always include previous service packs. Therefore, for example, if you want to upgrade to Service Pack 3,
you do not need to import Service Packs 1 and 2 first, as these are included in Service Pack 3.
20
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Service packs do not, however, include the main transport. You must always import the main transport
before importing a service pack.
New installation
Warning: Import the transports one at a time. If a return code greater than 4 is returned after importing a
transport, do not import any further transport requests. Contact Tech Support for assistance and provide
details of the return code.
Import order Transport
1 ReadSoft_PROCESS_DIRECTOR_AP_7_7*.zip
This is the main transport for Accounts Payable.
2 READSOFT_INVOICE_COCKPIT_Create_Indexes_*.zip
This transport creates the indexes required for ReadSoft PROCESS DIRECTOR
Accounts Payable. Indexes must be activated after import. See Importing and
activating indexes for instructions.
This transport is not required when a HANA database is in use.
3 Kofax_ReadSoft_Namespaces_FQAK901961.zip
This transport creates the /EBY/, /COCKPIT/, and /RSE/ namespaces. Make sure
that the namespaces are activated after importing.
4 READSOFT_PROCESS DIRECTOR 7.7* .zip
This transport provides components for the integration of Accounts Payable in
ReadSoft PROCESS DIRECTOR and use of the ReadSoft PROCESS DIRECTOR
Web Application, as well as other process types.
Optional READSOFT_WEB_CYCLE_PDF_Form_*.zip
This transport is required only if you use the old style SAPSCRIPT form to archive
notes in the HTML format in the /COCKPIT/WI8 transaction. You have to import the
transport into client 000.
This is not required for new installations.
Note If additional components are used (for example, Business Solution Package, Data Import), these
should be imported after all the other transports.
Upgrade
See Upgrading first for tasks that you may need to perform before or after importing.
Warning: Import the transports one at a time. If a return code greater than 4 is returned after importing a
transport, do not import any further transport requests. Contact Tech Support for assistance and provide
details of the return code.
Import order Transport
1 ReadSoft_PROCESS_DIRECTOR_AP_7_7*.zip
This is the main transport for Accounts Payable.
21
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Languages
The languages listed in the PROCESS DIRECTOR Product availability and GUI Languages document are
delivered with ReadSoft PROCESS DIRECTOR 7.7.
If a required language is not available in the standard delivery, contact your Kofax representative or Tech
Support for assistance.
Important: If you get a return code greater than 4, do not import any further transport requests! Contact
Tech Support for assistance and provide details of the first log with return code > 4.
Note Even if errors or aborts occur during the import, this has no adverse effect on your SAP system!
See the Troubleshooting section for other information on other import errors.
22
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Installing licenses
To install the licenses you have been provided, which are text files, execute one of the following
transactions.
• For Accounts Payable and its supplementary products in transaction /COCKPIT/C46.
• For other ReadSoft PROCESS DIRECTOR processes in transaction /EBY/PD_LICENSES.
See the PROCESS DIRECTOR License Installation Guide for detailed information.
23
Importing and activating indexes for PD AP
performance optimization
This section describes how to import and activate indexes to optimize the performance of new ReadSoft
PROCESS DIRECTOR Accounts Payable. It is not required if a HANA database is in use.
ReadSoft PROCESS DIRECTOR Accounts Payable contains indexes to support the current selection
screen, scheduled reports and other developments. Activation of indexes is project specific. This saves
database space because indexes are activated only when they will be used in a ReadSoft PROCESS
DIRECTOR Accounts Payable installation.
Installation and activation of indexes requires the following steps. Make sure that the prerequisites are
fulfilled, and then complete the following steps.
1. Import the new indexes into the development system.
2. Activate the indexes that should be used in the development system. The indexes must be explicitly
activated so that they take effect.
Note Importing and activating indexes has to be done only once. There is no need to perform this task
again after an upgrade.
Index types
There are three types of indexes available for performance optimization.
Type 1
Indexes for optimizing performance with the /COCKPIT/1, /COCKPIT/2, /COCKPIT/WL1, /COCKPIT/
WL2, and /COCKPIT/WL3 transactions.
Name Short description Status Mandatory/optional
S01 Company code (COMP_CODE) Inactive Optional.
Can be activated if the project uses more
than one company code in ReadSoft
PROCESS DIRECTOR Accounts Payable.
S02 Currency (CURRENCY) Inactive Optional.
Can be activated if the project uses more
than one currency code in ReadSoft
PROCESS DIRECTOR Accounts Payable.
S03 Vendor (VENDOR_NO) Inactive Mandatory. Must be activated.
S04 Document date (DOC_DATE) Inactive Mandatory. Must be activated.
24
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Type 2
Indexes for optimizing performance with the /COCKPIT/PAYMENT_CONTROL report.
Name Short description Status Mandatory/optional
P01 Only PAYMENT_CONTROL Inactive Mandatory for payment control report.
(AUGBL) Must be activated if the project uses the
COCKPIT/PAYMENT_CONTROL scheduled
report to update the payment information in
ReadSoft PROCESS DIRECTOR Accounts
Payable.
Type 3
Indexes for optimizing performance with project-specific requirements. These indexes will be locally
created as a part of the normal project activity.
Name Short description Status
Z** Xxx Inactive
Y** Xxx Inactive
25
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Prerequisite
• The namespaces must be modifiable as described in Checking the namespaces.
This step must be performed by the responsible database administrator. When migrating to new
indexes, some steps can create a huge amount of database load, which can slow down the system.
Those steps should be done during a period that does not have a normal production load.
Activating indexes
Index activation must be done in the development system, imported into a test/QA system, and then into a
production system. The activation of indexes is a repair, so this will create a local transport request. Local
transport requests need to be released after all the indexes have been activated. You need to create a
Transport of Copies and include the local transport requests to import the indexes into successor systems.
If you migrate from old indexes to new indexes, this step can create a huge amount of database load.
The installed ReadSoft PROCESS DIRECTOR Accounts Payable already contains data, so the database
not only has to create the new indexes, but also calculate the index entries for the existing entries in the
COCKPIT/THDR table. All the steps in this chapter need to be performed by the responsible Database
Administrator.
26
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
27
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
6. Click the Display/Change button, and then click the Continue (Enter) button for each of the
Information pop-up messages.
28
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
9. The Workbench request cannot have an entry set in the Target field.
29
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
10. Save the changes. If there are already a lot of documents in ReadSoft PROCESS DIRECTOR
Accounts Payable, this step can take several minutes or even hours.
The index will be active after Step 10 has been completed and changes have been saved.
Space calculation
The table below contains the length of each delivered index.
Name Short description Length
P01 Only PAYMENT_CONTROL (AUGBL) 53
S01 Company code (COMP_CODE) 68
S02 Currency (CURRENCY) 69
S03 Vendor (VENDOR_NO) 53
S04 Document date (DOC_DATE) 51
S05 Purchasing Document Number (PO_NUMBER) 53
S06 Document number of an invoice document (SAP_DOC_NO) 53
S07 Reference document number (REF_DOC_NO) 59
S08 Agent (CR_USER) 80
S09 Transfer date (CR_TIMESTAMP) 64
30
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
(i1 + i2 + .. + in) * (row count of table, /COCKPIT/THDR) = required space to store indexes
The DDIC size of the /COCKPIT/THDR table is less than 1K. Most fields are from type, VARCHAR2,
and some fields are normally empty. The real size of a /COCKPIT/THDR entry on the database is ~527.
Mandatory indexes total to 390.
These figures are only a clue to calculate the required space of indexes. The calculation must be
balanced with the transaction, DB02 > Detailed analysis and real measurement of the used space on the
database.
31
Troubleshooting
If a specific structure cannot be activated during the import, please check the structure in the SE11
transaction. It could be that a field from a Customer Include is now a part of the standard structure. In
such a case, remove that field from the Customer Include and test if you can activate the structure.
Other problems
• If you encounter the following problems:
Images cannot be opened in docking mode in the SAP GUI
Images cannot be opened in the Web Application
Change the settings in the /COCKPIT/C21 transaction to Y- first archive (image data), then Web server
(URL).
These problems may arise because this configuration table is now different from the version of PD AP
you are upgrading from.
• If you get a license error (license not valid) after upgrading to ReadSoft PROCESS DIRECTOR
Accounts Payable, delete the entries in /COCKPIT/C46 and re-enter them.
Short dumps
LOAD_PROGRAM_LOSS short dump occurs during document transfer, check, post, or other action.
Solution: Increase the abap/buffersize parameter in transaction RZ11, Recommended value: 400000 or
higher.
32
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
Call the SGEN transaction and generate all objects of the PD main transport.
DYNPRO_READ_FAILED short dump (terminations) occurs when you load or generate certain screens.
Other problems
Poor performance in ReadSoft PROCESS DIRECTOR.
Solution: Check the Tune Summary in transaction ST02 with the SAP System Administrator.
33
ReadSoft PROCESS DIRECTOR Import and Upgrade Guide
34