Professional Documents
Culture Documents
Solutions
CPIE230200-AGD-EN-02
OpenText™ Intelligent Capture for SAP® Solutions
Installation and Administration Guide
CPIE230200-AGD-EN-02
Rev.: 2023-July-20
This documentation has been created for OpenText™ Intelligent Capture for SAP® Solutions CE 23.2.
It is also valid for subsequent software releases unless OpenText has made newer documentation available with the product,
on an OpenText website, or by any other means.
Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Support: https://support.opentext.com
For more information, visit https://www.opentext.com
One or more patents may cover this product. For more information, please visit https://www.opentext.com/patents.
Disclaimer
Every effort has been made to ensure the accuracy of the features and techniques presented in this publication. However,
Open Text Corporation and its affiliates accept no responsibility and offer no warranty whether expressed or implied, for the
accuracy of this publication.
Table of Contents
1 About Intelligent Capture for SAP® Solutions ........................ 5
1.1 How does it work? ............................................................................. 5
1.2 Technology ....................................................................................... 7
1.3 Technical operations ......................................................................... 8
1.3.1 Improving the recognition process ...................................................... 8
1.3.2 Optimizing scan results ..................................................................... 8
1.3.3 Configuring Indian QR code signature check for invoices ..................... 9
10 Troubleshooting ...................................................................... 59
Information Extraction Service (IES) is used as a common technical term for both of
the following OpenText products:
VIM
• Intelligent Capture for SAP® Solutions. For more information, see section 7.2
“Integration with Information Extraction Service” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD).
• Solution for Incoming Sales Orders. For more information, see part II “Solution
for Incoming Sales Orders” in OpenText Vendor Invoice Management for SAP
Solutions - Configuration Guide for Solutions Beyond Invoice (BOCP-CCS).
• Solution for Incoming Quotations. For more information, see part III “Solution
for Incoming Quotations” in OpenText Vendor Invoice Management for SAP
Solutions - Configuration Guide for Solutions Beyond Invoice (BOCP-CCS).
• Solution for Incoming Delivery Notes. For more information, see part IV
“Solution for Incoming Delivery Notes” in OpenText Vendor Invoice Management
for SAP Solutions - Configuration Guide for Solutions Beyond Invoice (BOCP-CCS).
• Solution for Incoming Order Confirmations. For more information, see part V
“Solution for Incoming Order Confirmations” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Solutions Beyond Invoice
(BOCP-CCS).
• Solution for Incoming Remittance Advices. For more information, see part VI
“Solution for Incoming Remittance Advices” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Solutions Beyond Invoice
(BOCP-CCS).
1.2 Technology
Intelligent Capture for SAP® Solutions recognition technology is based on adaptive
learning algorithms which learn from user feedback. This provides a fast project
setup as no rules or parameters for data extraction are required, and a fast success
rate for excellent recognition results. Intelligent Capture for SAP® Solutions
combines a proven invoice knowledge base with learning algorithms, which extends
the recognition rate within short time of productive use to a new level for invoices.
VIM integration Beyond excellent recognition results, the tight integration of Intelligent Capture for
SAP® Solutions with VIM provides an ideal technical footprint, not requiring an
external repository, but using SAP repository, not requiring any data duplication
from SAP system but keeping all data in the SAP system. The connection to SAP is
implemented based on REST based web services supporting HTTP and HTTPS. This
architecture is ideal for hosting Intelligent Capture for SAP® Solutions on cloud
platforms as an alternative to the on premises installation. For more information, see
section 5.2.1.1 “Architecture” in OpenText Vendor Invoice Management for SAP
Solutions - Configuration Guide for Foundation (VIM-CGF).
BCC integration Customers using OpenText™ Business Center Capture for SAP® Solutions (BCC)
can integrate Intelligent Capture for SAP® Solutions, as it can run in parallel, also
connecting to the Inbound component of OpenText Process Base. You can use
existing Windows Validation Clients for processing Intelligent Capture for SAP®
Solutions profiles in parallel to ICC and BCC applications.
Solutions and Intelligent Capture for SAP® Solutions supports all VIM solutions. For more
profile configu- information, see “Following scenarios/solutions are supported:”. The configuration
ration
of the solutions is completely done in the VIM Foundation Inbound component, that
means there is no configuration needed on the Intelligent Capture for SAP®
Solutions Server. For more information, see section 5.2.1.2 “Scenarios and Capture
profile concept” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Foundation (VIM-CGF). Here you can find information about
the IDF configuration, business solutions, the profile configuration, and a
description of the complete document processing data flow beginning with inbound
scanning or email, and ending with starting the VIM workflow.
Machine The key advantage of Intelligent Capture for SAP® Solutions is the reduction of
learning implementation and configuration efforts, combined with fast learning success. That
is why Intelligent Capture for SAP® Solutions includes preconfigured scenarios. For
more information, see section 5.2.1.4 “Machine learning” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Foundation (VIM-CGF).
Pre-learning of You can reuse validated extraction results from OpenText™ Invoice Capture Center
profiles for SAP® Solutions (ICC), and BCC to train Intelligent Capture for SAP® Solutions
profiles. This feature is called Pre-learning. For more information, see section 2.4
“Pre-learning of IES Profiles” in OpenText Vendor Invoice Management for SAP
Solutions - Administration Guide (VIM-AGD).
You can find the separator sheet as TIFF and PDF file in the SampleImagesIES
subfolder within the installation folder or on My Support (https://
knowledge.opentext.com/) searching for separatorsheet.zip.
• Sort the paper pages for scanning according to the configured profiles, based on
contents and paper quality. This should be done in the following ways:
– Sort the documents according to the contents (for example invoices), because
the documents will be dealt with differently in terms of their technical
processing, workflows, storage durations, and access rights.
– Sort the documents according to their legibility (for example bad, medium,
good). In some cases it is necessary to insert separator sheets between the
individual documents. The documents are separated for further processing.
• Use professional scanning equipment to achieve optimal image quality.
• Optimize the scanner settings. Documents should be scanned with 300 dpi and
compressed with Fax4. Lower resolution or other compression modes may
worsen the recognition results. OpenText recommends not to use a resolution
higher than 300 dpi, as this increases the data volume but not the recognition
quality.
• If possible, do not use color scanning, as color images significantly increase the
data volume and slow down processing, while recognition quality is not
increased in most cases.
• Especially for barcode detection either switch the scanner to binary mode or turn
off compression if you want to keep the grayscale mode.
• If documents of specific vendors have bad printing quality, bad paper quality, or
an unsuitable layout, contact the vendors. Crumpled, creased or wrinkled paper
cannot produce reliably good results as the geometry is skewed.
If documents from certain vendors have poor print quality, bad paper quality, or
unsuitable layout, contact the vendors. Crumpled, creased, or wrinkled paper
cannot produce reliably good results because the geometry will be distorted.
• Chinese forms are usually smaller than documents from other countries. Images
of such forms should not have a white frame. For optimal recognition results,
forms should be aligned with the upper left corner of the image.
• Documents should not be stamped or marked. This deteriorates the recognition
results.
Note: The certificates are regularly updated on the portal. Make sure that you
always use the latest certificate.
Note: You must install all certificates, because it is not known in which
period the invoice was signed.
Tip: You must upload all certificates individually unless you use the
procedure described in the dialog box.
e. In the Certificate Store dialog box, place all certificates in the Personal
certificate store, and then click Next.
f. In the Completing the Certificates Import Wizard dialog box, click Finish.
g. Repeat these steps for all certificates.
Install and configure Intelligent Capture for SAP® Solutions in the following
sequence:
1. Install Intelligent Capture for SAP® Solutions. For more information, see
“Installing Intelligent Capture for SAP® Solutions” on page 13.
Notes
• Intelligent Capture for SAP® Solutions does not need a database but
stores data in the SAP database.
• Intelligent Capture for SAP® Solutions can be installed stand-alone.
• Intelligent Capture for SAP® Solutions can be installed and run together
with BCC on the same system if both products have the same version.
As a prerequisite, install first BCC. When running the Intelligent
Capture for SAP® Solutions setup it will be installed as add-on into the
same directory as BCC. Do not change this directory.
3. Configure VIM. For more information, see section 5.2 “Information Extraction
Service” in OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Foundation (VIM-CGF).
Note: Windows Validation Client cannot be installed and run on the same
computer as Intelligent Capture for SAP® Solutions.
5. Optional Install Single Click Entry for SAP GUI. For more information, see
“Installing Single Click Entry for SAP GUI“ on page 19.
If you want to use HTTP/2 you must enable the HTTPS communication on Windows
Server 2016 and 2019. For more information, see HTTP/2 on IIS (https://
docs.microsoft.com/en-us/iis/get-started/whats-new-in-iis-10/http2-on-iis).
5. Open this node and its subnode Application Development, and then select
ASP.NET 4.5 and later versions.
Notes
• Before you run the installation save the web.config file located in
<installdir>/WebServiceAPI. Already customized data will be unavailable
as soon as the automatic update process removes the previous installed
Intelligent Capture for SAP® Solutions.
• After you run the installation you must copy all already customized values
from the saved web.config file to the web.config file which has been newly
installed. Do not replace and overwrite the new installed web.config file
with the saved one.
3. In the End-User License Agreement dialog box, accept the license agreement,
and then click Next.
4. In the Destination Folder dialog box, check the path to the installation folder,
and then click Next.
If you want to install Intelligent Capture for SAP® Solutions at a different
location, click Change, and then choose the desired path in the appearing folder
dialog box.
5. Click Install.
6. Click Finish.
The Asian OCR option has its own installation media Asian Option <version> for
SAP Solutions.iso. Install the languages on the Intelligent Capture for SAP®
Solutions Server.
2. In the License Agreement dialog box, accept the license agreement, and then
click Install.
3. Click Finish.
Service packs are cumulative, that is a service pack contains all changes contained in
previous service packs of the respective Intelligent Capture for SAP® Solutions
version. Therefore, it is sufficient to install only the latest service pack after installing
Intelligent Capture for SAP® Solutions. For the same reason, the Release Notes of a
service pack list the changes of all previous service packs.
However, you can install a service pack on Intelligent Capture for SAP® Solutions
with any previous service pack.
Patches Patches are related to a service pack, that is you can only install a patch on an
Intelligent Capture for SAP® Solutions system where the corresponding service pack
has been installed. Patches are cumulative, that is a patch contains all changes
contained in previous patches for the same service pack.
1. In the Server group of the General tab, click Cluster, and wait until all cluster
nodes have finished processing, that is, until all are in state Ready.
Install and use always the most recent version of the Imaging Plug-In without
regard to version and patch level of Intelligent Capture for SAP® Solutions. This
makes bug fixes available as soon as a new Imaging Plug-In version is released, and
you do not must wait until an Intelligent Capture for SAP® Solutions Patch is
available. Intelligent Capture for SAP® Solutions will always use the newest version
of the imaging component.
Windows Validation Client is used for correcting documents, and cannot be used for
recognition, or for customizing and monitoring.
2. In the root folder of the installation media, run Validation for SAP Solutions
CE.msi.
4. In the License Agreement dialog box, accept the license agreement, and then
click Next.
5. In the Destination Folder dialog box, install to the default folder or click
Change to choose another folder, and then click Next.
6. In the Ready to install Validation for SAP solutions dialog box, click Install.
Install Single Click Entry for SAP GUI on all computers on which also SAP GUI is
installed, and where users are using the Single Click Entry functionality in VIM
Indexing Screen.
If Single Click Entry for SAP GUI is installed on a Vendor Invoice Management
system, it permits to capture data for fields on the index screen using the mouse. For
more information, see section 5.2 “Using the Single Click Entry feature” in OpenText
Vendor Invoice Management for SAP Solutions - User Guide for Invoice Solution (VIM-
UGD) and section 14.3 “Installing Single Click Entry for SAP GUI” in OpenText
Vendor Invoice Management for SAP Solutions - Installation Guide (VIM-IGD).
1. Install the most recent version and patch for SCESAPGUI Plug-In. You can find
them on My Support (https://knowledge.opentext.com/) searching for SCE for
SAP solutions.zip.
2. In the root folder of the installation media, run SCE for SAP Solutions.msi.
4. In the License Agreement dialog box, accept the license agreement, and then
click Next.
6. Click Finish.
After Single Click Entry for SAP GUI has been installed, configure SAP GUI.
To configure SAP GUI for Single Click Entry for SAP GUI:
1. Start SAP GUI, and then click Options in the system menu.
2. If the Enable Scripting check box at the user settings is cleared, select it.
3. Clear the two additional check boxes controlling notifications because otherwise
you get two notifications for each document that is opened on the index screen.
4. Click Apply.
You can continue to use existing profiles in VIM. But you must upgrade VIM. For
supported versions, see Release Notes.
1. Close Intelligent Capture for SAP® Solutions and all Windows Validation
Clients.
3. Uninstall Intelligent Capture for SAP® Solutions and all Windows Validation
Clients.
4. Install Intelligent Capture for SAP® Solutions and Windows Validation Client.
For more information, see “Installing Intelligent Capture for SAP® Solutions”
on page 13 and “Installing Windows Validation Client“ on page 17.
5. Check if the installation folder has been changed and update the physical path
information in the IIS Manager if needed.
7. Configure the web service. For more information, see “Configuring the web
service” on page 23.
8. Migrate the learning data. For more information, see section 2.4 “Pre-learning of
IES Profiles” in OpenText Vendor Invoice Management for SAP Solutions -
Administration Guide (VIM-AGD).
9. Update the profiles because the profile data format has been extended. For more
information, see section 5.2.3.16 “Activating and updating a Capture profile” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Foundation (VIM-CGF).
When you start the new installed Windows Validation Client the updated
profiles will automatically been loaded.
1. Create or purchase the certificate. Ensure that you also have the private key.
2. Import the certificate into the Local Computer account. Ensure to select Allow
private key to be exported.
3. Assuming that the Internet Information Services (IIS) website is running under
ApplicationPoolIdentity, do the following:
a. Run certlm.msc.
b. In the console tree, expand Certificates - Local Computer > Personal >
Certificates.
c. In the result pane, right-click the appropriate certificate, and then click All
tasks > Manage Private Keys.
d. Add the %LOCALSYSTEM%\IIS_IUSRS user and grant it Full control.
e. Click Apply.
2. On the Connections view, right-click Sites, and then click Add Web Sites.
4. In the Physical path box, enter the installation path of Intelligent Capture for
SAP® Solutions with its subfolder WebServiceAPI.
5. In the Type list, click http or https depending on your connection type, and
then enter the port in the Port box.
6. Optional If you want to use a SSL certificate for HTTPS communication, click
Select, and then browse to the certificate file (optional). For more information,
see “Adding a certificate for client/server authentication for secure
communication using HTTPS (optional)” on page 23.
8. On the Actions view on the right side, under Manage Web Site, check if web
site is already started. If not, click Start, and then click Browse.
The default web browser opens and shows a start message which indicates that
the web service is running.
9. In the web browser address, add status.aspx to the URL which is already
openend, and then press RETURN.
A webpage should be shown which shows information about the web service
and additional status information on the processed jobs.
3. In the Edit Application Pool dialog box, select .NET CLR v4.0.30319 in
the .NET CLR version list if it is not already selected, and then click OK.
2. In the Application Pools list, click Intelligent Capture for SAP® Solutions.
4. Change the Idle Time-out (minutes) parameter to a value greater than the
default 20 minutes. OpenText recommends to increase the timeout value to 4
hours 15 minutes. This value is similar to the DefaultOcrTimeout setting used
to extract process calls and configured in the application settings in the web.
config file. Do not set the value greater than 4 hours 29 minutes, because the
leading VIM application (SAP system) has a preset default timeout of 4 hours 30
minuntes, which ends the extraction process in any case.
4. If certificates are used for secure communication, click the Require option
under Client certificates.
6.2.4 Increasing the upload size (IIS 7.0 and later versions)
To increase the upload size to the web service, change the properties
maxAllowedContentLength, and maxRequestLength:
6. On the Configuration Editor view, in the Section list, open the System.web
node.
7. Click httpRuntime, select the maxRequestLength property, and then enter the
maximum upload size you want to support (up to 2 GB). The default value is
4096 bytes (4 KB).
To increase the upload size for the Intelligent Capture for SAP® Solutions web
application which communicates via HTTPS, change the property
uploadReadAheadSize:
2. If one of the following settings are not listed you must add it.
In the Actions pane on the right side of the IIS Manager window, click Add,
define the settings, and then click OK.
CompressMultipartResponse
Compress the HTTP multipart which gets sent to the leading (SAP) system.
The default value is true and must not be changed.
CompressRepositoryBlobs
Compresses the data “blobs” which get transferred via HTTP(S) and stored
into the SAP repository. The default value is true and must not be changed.
ClientCallerHttpTimeout
Http timeout used for outbound calls. Must be set in seconds. If no value is
used the default value is 100 seconds.
EncryptRepositoryBlobs
Encrypts the data “blobs” which get transferred using HTTP(S) and stored
into the SAP repository. The default value is false and must not be changed.
DefaultOcrTimeout
Maximum runtime of an operation. If runtime exceeds this value, the
operation will be cancelled. The default value is 4 hours and must not be
changed.
LoadManagerMasterServer
Hostname of the Load Manager Server. The default value is 127.0.0.1
(localhost) and must not be changed.
NoOfOcrRetries
The number of retries if an operation gets failed. Not used for productive
use because retry handling is set by leading (SAP) system. The default value
is 0 and must not be changed.
SendResponseInExternalProcess
If set to true the result call gets executed within a separate cluster node
instance instead of the IIS container.
SupportedSecurityProtocolTypes
Security protocols that are supported for secure communication via HTTPS.
The TLS protocol types Tls,Tls11,Tls12 are supported by default. A comma-
separated string or also a single value can be entered here. If the value is
empty, the default system setting will be used. For more intensive security
reason some SAP systems does not support older TLS protocols than Tls12.
In this case the setting should be changed to value Tls12 only.
TracingConfigFileName
Name of the configuration file which is used for application tracing setup.
The default value is InformationExtractionService.traceconfig and must
not be changed.
WebProxyAddress
Web proxy address if a proxy is used for outbound calls. Must be set in the
format http(s)//:<hostname>:<port>.
When you use client certificates for the communication via HTTPS (see “Adding
a certificate for client/server authentication for secure communication using
HTTPS (optional)” on page 23), set the following configuration parameters
accordingly:
StoreCertLocation
Each of the Microsoft Windows certificate stores has the following types
which you can use:
ClientCertificateOption
Value that indicates if the certificate is automatically picked from the
certificate store or if the caller is allowed to pass in a specific client
certificate.
DistinguishedCertName
Subject value of the client certificate which is used for sending HTTP
requests to the leading SAP system(s). This value must match to an existing
subject name located in the local cert store, for example CN=*.opentext.net,
OU=SAP Solutions Development, O=OpenText, C=DE.
Additional there are a few settings which offers support for error analysis, for
example StoreRequestToFolder, which prints out the HTTP multipart request
to a text file on the local storage. But these settings should only be used by
administrators or customer service for temporary analysis.
6.3.1 Tracers
A tracer represents the source of a trace message. Tracers are named entities with a
hierarchical structure. Hierarchy levels are separated by dots. This corresponds to
the naming of .NET classes including namespaces. Therefore usually the class name,
for example DOKuStar.Runtime.Server, is used as name of the respective tracer.
The tracer name is used to configure the properties of the tracer such as the trace
level. You may use the full name of the trace or only a part of the name. If a
particular trace has not been configured explicitly, it inherits its configuration from
its parent tracer.
A special tracer, called the RootTracer, is the parent of all tracers and has no name.
RollingFileListener
This trace listener writes trace messages to a file. It generates a new file with a
unique file name for every process by merging the current time and the process
identifier into the file name. The output is flushed every 30 seconds. A new file
is created each day. Files older than 10 days (configurable) are removed.
RemotingTraceListener
This listener writes trace messages to a remote sink, for example the Trace
Viewer in order to display trace messages on-the-fly.
ConsoleTraceListener
Writes trace messages to console output.
Trace listeners may trace at different levels. Every tracer may have assigned its own
collection of trace listeners but usually only the root tracer has them all and all other
tracers inherit them.
Note: The Application Data folder is hidden. Therefore, select the respective
option in the Folder Options of Microsoft Windows Explorer to display the
folder.
1. Set the registry value TraceRootPath (type REG_SZ) at the key HKLM\SOFTWARE\
OpenText, and on 64-bit systems also at the key HKLM\SOFTWARE\Wow6432Node\
OpenText to a new path.
Trace configuration files are stored directly under the root path. Trace files are
written to a subfolder, typically the folder name is the application name, for example
DOKuStar Load Manager.
Fatal
Used in case of errors where the administrator has to be called immediately.
Those errors risk to crash down processing for example disk full.
Error
Used in case of errors that aborted the current job. Probably processing
continues with the next job.
Warning
An unexpected issue occurred and should be traced in order to be able to
analyze it later especially if it occurs again.
Info
This is the default level. It is use to trace normal progressing as an administrator
would see it in a monitor, for example:
Fine
First debug level, for example to additionally trace failed polling calls or
important parameters, and so on.
Finer
Next debug level.
Finest
Highest debug level.
Note: The default level is Info. Do not stress tracing using this level Info with
your debug messages.
The trace configuration files must reside in the current trace folder. Therefore do not
forget to copy the trace configuration files to the new location if you change the trace
root path.
You may configure traces by editing the appropriate trace configuration file directly
or by selecting a predefined trace configuration in the Trace Viewer. For more
information, see “Analyzing trace files using Trace Viewer” on page 34. Selecting a
predefined trace configuration in the Trace Viewer changes the trace configuration
files automatically.
listener
This element configures a trace listener by specifying the following:
name
Any describing name.
type
The full qualified name of the class which implements the listener.
threshold
Trace level (optional, default is Finest).
It also specifies other trace listener-specific parameters.
<listener name="file"
type="DOKuStar.Diagnostics.Tracing.RollingFileTraceListener">
<file value="DOKuStar Load Manager\\DOKuStarClusterNode.log" />
</listener>
<listener name="remote"
type="DOKuStar.Diagnostics.Tracing.RemoteTraceListener">
<url value="tcp://localhost:20304/DOKuStar.Diagnostics.Tracing" />
<threshold value="fine" />
</listener>
root
This element configures the root tracer by specifying the following:
level
Trace level.
listener-ref
The listeners. Usually all listeners are configured only at the root tracer, not
at the categories.
<root>
<listener-ref ref="file" />
category
This element configures certain tracers by specifying the following:
name
Name of the tracer or part of its hierarchical name.
level
Trace level.
<category name="DOKuStar.Cluster.Operation">
<level value="fine" />
</category>
merge (default)
Configures only a few items and merges them with a configuration that may
have been initialized by software and already has specified its root tracer and
trace listeners so that you only want to change trace levels of certain categories.
Example:
<?xml version="1.0" encoding="utf-8" ?>
<trace>
<category name="DOKuStar.Cluster.Operation">
<level value="fine" />
</category>
<category name="DOKuStar.Cluster.ClusterNode">
<level value="fine" />
</category>
<category name="DOKuStar.Cluster.Extraction">
<level value="fine" />
</category>
</trace>
overwrite
Configures all features and completely resets an initial configuration made
through software. You must specify the root tracer and its listeners.
Example:
<?xml version="1.0" encoding="utf-8" ?>
<trace update="overwrite">
<listener name="file"
type="DOKuStar.Diagnostics.Tracing.RollingFileTraceListener">
<file value="DOKuStar Load Manager\\DOKuStarClusterNode.log" />
</listener>
<listener name="remote"
type="DOKuStar.Diagnostics.Tracing.RemoteTraceListener">
<url value="tcp://localhost:20304/DOKuStar.Diagnostics.Tracing" />
<threshold value="fine" />
</listener>
<root>
<listener-ref ref="file" />
<listener-ref ref="remote" />
<level value="fine" />
</root>
<category name="DOKuStar.Cluster.Operation">
<level value="fine" />
</category>
<category name="DOKuStar.Cluster.ClusterNode">
<level value="fine" />
</category>
<category name="DOKuStar.Cluster.Extraction">
<level value="fine" />
</category>
</trace>
Tip: You can find examples for trace configuration files in the <Intelligent
Capture for SAP Solutions_install>\TraceConfig folder.
• Trace files
<TraceRoot>\DOKuStar Load Manager\DOKuStarLoadManager*.log
<TraceRoot>\DOKuStar Load Manager\DOKuStar.ClusterNode*.log
All services
The Microsoft Windows event log is used to log creating, starting, and stopping
of the services.
DateTime
Time when the trace message was written, sortable format yyyy.MM.
ddTHH:mm:ss.
Level
Trace level Fatal, Error, Warning, Info, Fine, Finer or Finest.
Computer
Name of the host where the trace message was written.
Application
Name of the application that wrote the trace message.
PID
ID of the process that wrote the trace message.
Category
Trace category (hierarchically to reflect classes and modules).
ThreadId
ID of the thread that created the trace message.
Message
Trace message enwrapped with 2 squared brackets at begin and end. Note: A
trace message is multi-line; it may contain carriage return and line feed.
1. In the Customizing Client, on the General tab, in the Tools group, click Trace
viewer.
Tip: Alternatively, you can start the Trace Viewer on the Microsoft
Windows start menu in the Validation for SAP® Solutions, and in the
Intelligent Capture for SAP® Solutions program group.
The Trace Viewer shows a list of all trace files found on the local computer. The
list is grouped by the different components.
Tip: If the toolbar is not shown, right-click in the right area, and then click
Toolbar.
Local Machine
You can open the trace folder by clicking the link in the header.
Filter
You can display only trace files containing messages of the respective types
by clicking All, Only errors, or Only errors and warnings in the Filter list.
Trace configuration
You can select one of three trace configurations. For more information, see
“Selecting a trace configuration” on page 36.
Display Level
You can specify one of seven different trace levels. In the most restrictive
level only fatal error messages are shown. In the most talkative trace level,
messages of all message types are shown.
The toolbar text indicates the currently selected trace level.
Display filter
You can set different kinds of filters that control which log messages are
shown. For more information, see “Filtering messages” on page 37.
Find
You can search in the currently open file. For more information, see
“Searching trace messages” on page 38.
Tip: You can enable more functions in the main menu, or in the context
menu of the right area.
• This configuration affects the local computer. If you want to search an error
on a processing cluster, you may need to modify the trace configurations on
all computers of the cluster.
• The dialog box cannot indicate the current trace configuration, because you
could modify the trace configuration files using a text editor at any time,
creating a custom configuration differing from all three default
configurations described below.
To filter messages:
1. In the toolbar, click Display filter. Alternatively, in the context menu of the
message list view, click Filter.
Level
This filter permits to switch all trace messages off or to specify a trace level.
If the trace level is set to Error, only error messages are shown. The other
values add messages of other types successively. If the trace level is set to
Finest, messages of all types are shown.
Computer
Lists computers of the cluster used by the project. By default, messages
from all computers are shown. If you work with a cluster you can exclude
some computers or restrict output to the messages of a single computer.
Application
Lists all applications of the current project. By default, all applications are
enabled.
PID
Lists process IDs of all processes of the current project. By default, all
processes are enabled.
ThreadId
Lists thread IDs that created the trace message.
EventId
Lists event IDs that created the trace message.
Category
A category is a group of classes. This filter permits to restrict messages of
the type Info to functional units within the Document Reader during
debugging.
Find filter
If the text box in this area is not empty only matching messages are shown
in the messages list view. The check boxes permit to control text matching.
• If the Match case check box is selected, the message must contain the
string in exactly the same spelling with respect to upper and lower case
letters.
• If the Match whole word only check box is selected, the string will not
be matched against a part of a word.
1. In the toolbar, click Find. Alternatively, in the context menu of the message list
view, click Find.
2. In the Find dialog box, enter the search string. You have the following
additional options: Match case, Match whole word only, Regular expression
3. Click Find Next or Find Previous to search the message list. The next or
previous matching trace message is selected in the messages list view.
By default, the number of cache entries in each project cache is controlled in relation
to a specified cache size. If the number of entries reaches twice the specified number,
the oldest entries are deleted until the number of entries equals the specified cache
size. The default value of the cache size is 32.
The following sections describe which components are located on which participants
and how the different participants interact in respect to the components.
If the Load Manager Service of a Intelligent Capture for SAP® Solutions Cluster
Node is running using the LocalSystem account, which is the default, the temporary
files are written into the temp folder defined in the system temp variable.
The Microsoft Windows Service is started automatically after the installation and at
every system start. In case of failures, you may need to stop, start, or restart a
service. For more information, see “Starting and stopping Microsoft Windows
Services on the Intelligent Capture for SAP® Solutions Server” on page 47.
2. At this key, create a string value tempPath containing the path for these data.
3. For the change to take effect, restart the service DOKuStar Load Manager.
Alternatively, you can move the location of the whole temporary files folder using
Control Panel.
You can move the program data files, for example to a different drive.
The Load Manager is a Microsoft Windows Service which runs on the Intelligent
Capture for SAP® Solutions Server. This Microsoft Windows Service is started
automatically after installation and at every system start. The Load Manager on the
Intelligent Capture for SAP® Solutions Server is the master and controls the load
balancing. This master receives job requests and distributes these tasks. Usually the
Intelligent Capture for SAP® Solutions Cluster contains as many cluster nodes as
processors. If the Intelligent Capture for SAP® Solutions Server is a two-processor
computer and if there are no further Intelligent Capture for SAP® Solutions Server
Nodes, the Intelligent Capture for SAP® Solutions Cluster will consist of two Cluster
Nodes.
A Cluster Node hosts a service of a specified type called the Service Type. For the
Intelligent Capture for SAP® Solutions Server, the default services
types are Document Extraction, Learning (Feedback) and Configuration.
The Intelligent Capture for SAP® Solutions Server automatically creates and
configures the appropriate jobs which runs within specific Cluster Nodes at the
Load Manager. You do not need to configure them manually.
The Load Manager processes a job request by creating an operation. The Load
Manager keeps a list of waiting and active operations and manages them until their
execution has been completed.
The Jobs view and the Cluster view on the Intelligent Capture for SAP® Solutions
Server Cluster Monitor permit to monitor the Load Manager.
The cluster configuration is managed centrally at the Intelligent Capture for SAP®
Solutions Server. You can configure the Intelligent Capture for SAP® Solutions
Server Cluster with the Load Manager Configuration tool hosted within the Cluster
Monitor.
The pre-configuration of the Intelligent Capture for SAP® Solutions Server Cluster
will setup a defined number of cluster nodes which depends on the available system
hardware, that is one Intelligent Capture for SAP® Solutions Server Node for each
processor of the Intelligent Capture for SAP® Solutions Server. The pre-
configuration of the Intelligent Capture for SAP® Solutions Server Cluster will look
as follows on a computer with four processors:
With a high number of processing nodes, you also need more RAM to be able to use
them effectively or throughput will decrease because of increased swapping.
Typically, you need about 1.5 GB per Runtime Node.
2. In the Load Manager Configuration dialog box, click the Cluster node you
want to change in the tree view.
3. Click the property you want to change, define the value, and then click OK.
LookupInterval
Time interval after which the Load Manager checks whether the cluster
node is still alive.
Operation Types
Load Manager operation type.
Optimization Time Window
To prevent loading time, the Load Manager tries to assign an operation of
the currently loaded operation type to a node that becomes available. As
soon as the first operation in the Load Manager queue waits longer than the
specified time, it is assigned to the next available node. Enter the time in the
format hh:mm:ss.
Process Priority
With the default value BelowNormal, priority of the computationally
intensive Runtime Node processes is reduced. Otherwise other important
processes would often have to wait for processor time and would respond
slowly. If you set this property to Normal, priority is not reduced.
Reset Cycle
After the specified number of operations the cluster node is reset
automatically. This can also be used to ensure that the project is reloaded.
Reset on failure
If this property has the value True, the Load Manager tries to reset the
cluster node in case of failure.
Startup Time
Specifies the maximum time the Runtime Nodes should need for start-up. If
the start-up of a Runtime Node exceeds this limit, the corresponding
process is terminated. Enter the time in the format hh:mm:ss.
Use IPC Channel
As default, the Load Manager uses TCP for communication with the local
cluster nodes. If this property is set to True, it uses IPC channels (named
pipes) instead.
Note: Within Intelligent Capture for SAP® Solutions you do not need to
modify any properties.
2. In the Load Manager Configuration dialog box, click the Intelligent Capture for
SAP® Solutions Server Node you want to change in the tree view.
3. Click the property you want to change, define the value, and then click OK.
Name
Cannot be edited. It is comprised from the computer name, service type and
instance number.
Agent Url
URL of the agent service for this cluster node within the cluster.
Description
Only for logging purposes.
Exclusive Operation Types
Restricts a cluster node to the specified Load Manager operation types.
Priority
Priority of the cluster node. The Load Manager prefers Runtime Nodes with
a higher priority value when it wants to assign an operation to a Runtime
Node. The default value is 0. To give a node a higher priority, enter a value
greater 0, to give a node lower priority, you can enter a negative value.
Note: OpenText does not recommend to create more than 16 cluster nodes on
one machine. Especially for failover it is a single point of failure.
4. Change the values as needed for your system. The critical segment is
SharedSection=1024,20480,2048.
Note: The change affects the desktop heap of all services. Stay within the
range recommended by OpenText and do not make it larger than
necessary. By increasing the desktop heap size for non-interactive session
too much you will push the system to consume more resource and you
may run into problems with the total available desktop heap size.
3. Press Enter.
To get the Intelligent Capture for SAP® Solutions application specific data:
1. Open the IIS manager, and then click the site with the default name
InformationExtractionService (could also be named different).
The settings should be the same as listed in step 2 and 3.
2. In the Actions view, click Basic Settings, and then copy the following settings:
3. In the Actions view, click Bindings, and then copy the following settings:
• Type: http
• Binding Information:
1. Install SAP Diagnostics Agent, and then connect it to Solution Manager. For
more information, see SAP Note 1365123.
2. Upgrade the SAP Host Agent to the latest version. For more information, see
SAP Note 2598404.
3. Open the Agent Administration in Solution Manager, and then click the Non-
authenticated Agents tab.
4. Update the Diagnostic Agent agent, and then click Trust Agents.
5. Open Landscape Management (LMDB), click Technical Systems > Select Type:
Microsoft Internet Information Services.
a. Click Software, and then add and configure the Product Instances, and
Software Component Versions.
b. Click Technical Instances, and then copy the Intelligent Capture for SAP®
Solutions application specific data into the corresponding areas.
MSIIS Applications
MSIIS Pools
MSIIS Sites
All components of an IES system register in the SAP Landscape Directory. SLD
registration is provided by the Microsoft Windows service Information Extraction
Service SLD Data Supplier <version>. The service registers IES automatically twice a
day and immediately after it is started.
You must configure the service on each Microsoft Windows computer on which you
use IES.
1. On the Start menu, click OpenText Intelligent Capture for SAP Solutions CE
<version> > IES SLD Data Supplier Settings.
2. In the IES SLD Data Supplier Settings dialog box, enter the NetWeaver
settings SLD host, port, user, and password.
3. Optional To test the configuration, click Test collect and send data.
After you have configured the SLD Data Supplier, you can check registration by
logging in to the System Landscape Directory of the specified host.
3. In the Subset list, click All With Instances > Installed Product.
For monitoring of an Intelligent Capture for SAP® Solutions system, you can use
external monitoring tools, and the Inbound Configuration and Inbound
Administration work center in VIM. For more information, see section 3.6 “Inbound
Administration work center” in OpenText Vendor Invoice Management for SAP
Solutions - Administration Guide (VIM-AGD), and section 4 “Inbound Configuration”
in OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Foundation (VIM-CGF).
If you monitor Intelligent Capture for SAP® Solutions with external monitoring
tools, take the following considerations into account:
• CPU usage: On the server and on Recognition Nodes, CPU usage will often be at
100% while a document is being processed. Whereas a single page is processed in
a few seconds, processing may take up to several minutes for a document with a
large number of pages. Therefore high CPU usage may indicate a problem only if
it persists for more than about 5 to 10 minutes depending on the maximum
number of pages of your documents.
• Disk space: Intelligent Capture for SAP® Solutions does not collect and
accumulate data. Temporary files written during document processing are being
deleted when the document is exported. Trace files are deleted automatically
after several days. Therefore disk space should pose no problems if you provided
sufficient resources.
• Main memory: Because the Cluster Node processes on the Intelligent Capture for
SAP® Solutions Server and the Recognition Nodes are reset automatically after a
certain number of documents has been processed, main memory usage should
not grow on the long run. If you provided sufficient main memory depending on
the number of Cluster Nodes, main memory problems should not occur.
• Microsoft Windows Service: For document processing, the Microsoft Windows
Service DOKuStar Load Manager must be available. Therefore it is meaningful
to monitor whether this service is running. If a service is not running, start it.
The most critical part of a Intelligent Capture for SAP® Solutions system is the
Inbound Configuration, or the Inbound Handler, respectively. These components
are parts of VIM in SAP ERP. Therefore their high availability is guaranteed.
The application configuration data are stored in SAP ERP. Therefore, the high
availability of the application configuration data is guaranteed.
The Operation Nodes which runs on the Intelligent Capture for SAP® Solutions
Server are not critical at all. Therefore, there is no fail-over scenario defined for
them.
For more information about high availability in SAP ERP, see the SAP Netweaver
Technical Operations Manual (https://help.sap.com/doc/erp2005_ehp_03/6.03/en-US/
72/cd1e4261ea5433e10000000a155106/frameset.htm).
In general, high availability can be achieved on the Intelligent Capture for SAP®
Solutions Server by configuration of a standard Microsoft Windows server. It
depends very much on the data center infrastructure.
There are several options for configuring high availability. Two most common
options are:
• Option 1: Simply add one or more additional Intelligent Capture for SAP®
Solutions Servers (VMs), and add load balancing to automatically distribute
requests to all servers. If one of the servers fails, the second server takes all
requests. The SAP system sends the requests to the load balancer, regardless of
how many servers are available in the background.
• Option 2: Take a snapshot of the Intelligent Capture for SAP® Solutions Server
(VM). If the monitoring states of the server VM fail, a new VM with the snapshot
is started immediately. As a result, Intelligent Capture for SAP® Solutions Server
is unavailable for a short period of time. But due to the asynchronous process,
there may be still enough documents in the system that are already OCR-ed but
not yet processed by the users. The users will therefore not notice that the
Intelligent Capture for SAP® Solutions Server is unavailable for a short period of
time.
Replacing the Intelligent Capture for SAP® Solutions Server is possible because this
server does not hold any data or status information: Learning data and profiles are
stored in the SAP database. Status data are stored in the SAP system: Requests,
Validation tasks or Feedback that could not be completed due to the switch to a new
server are repeated by the SAP system according to the settings for automatic retries.
Per default the Load Manager service runs under Local System. There is no need to
change this setting to a domain user account as long as no remote communication
will be setup.
If you want to use a domain user account for running the service, you must prepare
it before the installation and enter during installation. In this case the Load Manager
Service user must have local administrator rights.
For more information about using the Microsoft Windows user management, see
Best Practice Guide for Securing Active Directory Installations (https://
docs.microsoft.com/en-us/windows-server/identity/ad-ds/plan/security-best-
practices/best-practices-for-securing-active-directory).
• Full authorization for the J_6NPF_RFC object is required for all users. For more
information, see section 8.4 “Authorization objects” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Foundation (VIM-CGF).
• Authorization for the S_WFAR_OBJ (ACTVT=03) object is required for all users for
the related content repository (OAARCHIV) and document type (OADOKUMENT).
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=SYST
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=RFC1
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=RFC_METADATA
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME= /OTX/PF11_VALIDATION
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME= /OTX/PF01_IF_OCR
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME= /OTX/PF11_ASYNC
• S_TABU_NAM:ACTVT=03,TABLE=V_CURC
As of SAP Basis Release 7.10 you can choose a finer granularity for authorizations.
For more information, see SAP Note 460089. You can execute the authorization
check on individual function modules, instead of entire function groups.
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=SYST
replace with
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=RFCPING
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=RFC1
replace with
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=RFC_FUNCTION_SEARCH
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=RFC_METADATA
replace with
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=RFC_METADATA_GET
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=/OTX/PF01_IF_OCR
replace with
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF01_IF_LOOKUP_VAL
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=/OTX/PF11_VALIDATION
replace with
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_VAL_GET_DATA
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_VAL_GET_PROFILES
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_VAL_GET_SETTINGS
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_VAL_SET_DATA
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/PF11_VAL_LOOKUP
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_VAL_GET_ADHOC
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_VAL_GET_PAGES
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_VAL_SET_TIMEOUT
• S_RFC:ACTVT=16,RFC_TYPE=FUGR,RFC_NAME=/OTX/PF11_ASYNC
replace with
S_RFC:ACTVT=16,RFC_TYPE=FUNC,RFC_NAME=/OTX/
PF11_ASYNC_SET_VAL_DATA
You can also replace the other function group authorizations by the function module
authorizations but it is not necessary because nearly each function module within
the groups is used.
Security-relevant events on the SAP ERP side can be logged using SAP ERP means.
For those who participate in the customization and implementation of VIM with a
special focus on security aspects, see OpenText Vendor Invoice Management for SAP
Solutions - Security Guide (VIM-GSM).
Also refer to the information about unused OpenSSL files (Windows x86 and
Windows x64) in “Asian Language Option” available as patch note for CRE/CFPR
Asian Languages Option. For more information, see https://
knowledge.opentext.com/knowledge/llisapi.dll?func=ll&objId=77613388&
objAction=browse&viewType=1.
9.7 Responsibilities
In an Intelligent Capture for SAP® Solutions system, no real users are involved.
On the VIM SAP system, there are additional user types and responsibilities.
Troubleshooting
VIM manages the documents which are then proceed by Intelligent Capture for
SAP® Solutions. The components manage a list of all documents and their current
states. This list can be monitored with defined tools in SAP ERP. When a specific
request cannot be processed by the Intelligent Capture for SAP® Solutions Server,
the corresponding entry in the SAP ERP system gets an error status.
Connection problems
• If the connection test has a timeout, check the trace viewer on the OCR server
for details.
– Possible problems:
○ Open the URL of the SICF service for a result in a browser installed on
the IES server.
○ Enhance the log level of the SAP ICM log, and then check the ICM log
file for errors related to the connection from SAP to OCR or from OCR
to SAP.
• The SM59 connection test must display a message like “Intelligent Capture
for SAP® Solutions <version> - web service started.”. Otherwise the Web
Server is not correctly configured.
• Requests are not processed successfully. The error message “503 - Service
Unavailable” is sent from IES (the result service is working but the repository
service is not working as expected). Check the configuration of the repository
service in TC SICF and in the connection settings.
Communication issues
All communication between the SAP ERP system and the Intelligent Capture for
SAP® Solutions Server takes place using HTTP(S). All HTTP(S) request are
logged by the Intelligent Capture for SAP® Solutions Server and Intelligent
Capture for SAP® Solutions application level also. In general, there could be
various reasons for communication problems using HTTP(S).
Example: No client certificate is send with the HTTPS request, although it is requested
by the service. In this case the IIS refuses the request with the following response: “HTTP
error code: 403 / HTTP error message: The page you are attempting to access requires
your browser to have a Secure Sockets Layer (SSL) client certificate that the Web server
recognizes.”
In case IIS reports the HTTP error code 403 13, disable the client revocation
check on the IIS web server as described in https://blogs.msdn.microsoft.com/
kaushal/2012/10/15/disable-client-certificate-revocation-crl-check-on-iis.
Intelligent Capture for SAP® Solutions web application
The Intelligent Capture for SAP® Solutions web application defines the
following specific HTTP response codes for temporary and permanent error
cases:
If an error occurs refer to the application traces for more information. The
Intelligent Capture for SAP® Solutions web application logs are written to a
specific trace folder and can be viewed using the Trace Viewer Tool. For more
information, see “Configuring tracing” on page 28.
Monitoring activity
The Intelligent Capture for SAP® Solutions setup installs following tools which
helps you monitoring the requests:
Additional Intelligent Capture for SAP® Solutions offers a web page where
general information about the service and jobs which has been processed are
available. You can open the web page using http(s)://<hostname>:<port>/
status.aspx.
You can see the last jobs that were processed, together with eventual errors.
Only a limited number of jobs is shown. It may even happen that memory was