Professional Documents
Culture Documents
OpenText Vendor Invoice Management for SAP Solutions Administration 16.3 - First Edition: March 2019
ii V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Welcome
Vendor Invoice Management (VIM) 16.3 for SAP Solutions is a component of the OpenText ECM Suite
for SAP Solutions. VIM is built on top of the SAP Solution and utilizes much of its underlying
technology. For this course, it is essential that you have a solid grasp of the concepts that are found in
the SAP technical space. Many of the features introduced by the latest release of VIM are covered
from a configuration standpoint.
The main objective of this course is to teach the participant how to install and configure the VIM
Baseline system, with special emphasis on pointing out opportunities for customer enhancements.
Participants will become familiar with accessing OpenText development and configuration tables for
VIM. On completion of this course, you should feel confident that you can successfully configure
Vendor Invoice Management 16.3 for SAP Solutions.
Thank you for participating in this course. Should you require any further information, please contact
us at OpenText Learning Services.
Good luck, and enjoy your learning experience.
vi V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Exercise: Perform Inbound Configuration for your new ArchiveLink Document Type ...... 6-16
Summary........................................................................................................................... 6-17
7. Document Processing
Objectives ........................................................................................................................... 7-1
Document Processing Overview......................................................................................... 7-1
Customizing Document Processing .............................................................................. 7-2
Main concepts ..................................................................................................................... 7-3
Product Codes .............................................................................................................. 7-3
Best practices for document processing ....................................................................... 7-3
Document Types .......................................................................................................... 7-3
Process Types ............................................................................................................ 7-11
Configuring Auto-Post determination .......................................................................... 7-19
Processing Logic Modules .......................................................................................... 7-20
Business Rules ........................................................................................................... 7-24
Business Rules Framework ........................................................................................ 7-28
Process Options ......................................................................................................... 7-30
Exercise: Creating a Document Type and a Process Type .............................................. 7-38
User Process Options ................................................................................................. 7-39
Summary of DP objects .............................................................................................. 7-44
The Index screen ........................................................................................................ 7-45
Global Configuration parameters for Document Processing ...................................... 7-52
Characteristic specific rules and configuration ........................................................... 7-54
Exercise: Creating User Process Options and Changing the Indexing Screen ................ 7-60
Other Configuration options ........................................................................................ 7-63
Exercise: Maintaining Duplicate Check Logic and Reason Codes ................................... 7-67
Summary........................................................................................................................... 7-67
viii V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Configuring the Fiori Task App ................................................................................... 11-3
Setting up launchpad content ................................................................................... 11-10
Summary......................................................................................................................... 11-11
This icon represents a lesson symbol where the student watches the
instructor.
This icon represents a lesson symbol where the student follows along
with the instructor.
This icon represents a lesson symbol where the students perform the
exercise on their own.
Training Date:
Instructor:
Location:
Student Name:
Position:
Management Technical Other
Implementation End User Administrator
Industry:
Federal Government Legal
Other Government Manufacturing
Education Financial/Insurance
Integrator Other
Company:
Street Address:
E-mail:
Phone Number:
C hapte r 1 . V endor Invoi ce Manage ment o verview
Objectives
Accounts Payable Accounts Payable is typically a labor intensive and time consuming set of
challenges processes. It involves the ingestion of hundreds, up to tens of thousands, of
invoices a month. The invoices are often paper-based, or they are
electronic and arrive alongside attachments that reflect the original paper-
based layout. These invoices are often the result of purchase orders that
also create their own paper trail. Together, this multitude of paper,
electronic images, and electronic transmission must pass through many
gates in order for the payment process to occur. Therefore, each document
must pass through many hands and might be copied or altered, as well as
being stored multiple times during its journey.
This process is wrought with many opportunities for error, loss, and delay.
The typical process is described next.
AP business process As the figure illustrates, a normal invoice to pay process might look like the
flow without VIM following:
1. The mailroom or other recipient receives the incoming paper invoices
and sends them to Accounts Payable (A/P).
2. A/P parks the invoice in SAP. A parked invoice or document is a
temporary document. It is not included in the General Ledger A/P
liability account but does display in the Vendor account detail screen.
Alternatively, A/P may send the invoice to the approver prior to parking.
3. A/P informs the originator of the purchase (by e-mail, inter-office mail,
phone call, sticky note, etc.) to verify and approve the invoice. A/P may
also send a copy of the invoice to the originator.
4. The originator or a separate approver approves or rejects the invoice
and notifies A/P of the decision. The originator may keep a copy of the
invoice.
– If the invoice is rejected, A/P must process the parked document.
They can delete it or request additional information from the vendor.
If waiting for vendor information, A/P must track the parked
document.
– If the invoice is approved, A/P makes any requested changes and
posts the invoice.
Pag e 1- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 1 . V endor Invoi ce Manage ment o verview
Challenges in traditional In summary, the following challenges are often seen in a typical A/P
invoice processing process:
There is a large amount of manual activity for approvals and exception
processing.
Duplicate payments and postings are misplaced and invoices get lost.
There is an unpredictable variation in workloads due to cyclical volume
increases.
Audit and compliance concerns arise due to contradictory
documentation.
There is low visibility of volume data, throughput statistics, and
bottlenecks.
Lengthy cycle times are common.
A highly skilled workforce ends up performing low valued tasks.
Effects by Role Many roles are involved in the invoice process. In the next figure we
visualize the different roles which are affected in each area of the
organization.
Pag e 1- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 1 . V endor Invoi ce Manage ment o verview
Simplify – Transform – VIM makes it easy for clients to implement the solution and transform their
Accelerate AP process to gain efficiencies, thereby improving supplier relationships
and saving time and resources.
As an option for VIM, OpenText Business Center Capture for SAP Solutions
(BCC) further extends VIM’s capabilities automating the capture of paper
invoices. BCC uses optical character recognition (OCR) to extract invoice
data. The combination of BCC with VIM enables end-to-end automation of
paper invoice processing.
What does AP invoice In order to accomplish these objectives, VIM has been designed to fully
processing look like automate the invoice process with as little manual intervention as possible.
with VIM? When manual intervention is required, it is also captured in the digital record
of the invoice process. VIM conducts an invoice from ingestion through to
payment and keeps track of it along the way, thereby reducing the errors
and complexities introduced by manual processing.
VIM process overview When VIM is integrated into the Scan to Payment process, it can be viewed
in several stages. The following must be completed:
Image capture
Key data capture
Validation of the data
Creation of the SAP document
Posting of the SAP document
Image capture Typically, companies will receive invoices via mail or via e-mail. In both
cases, the invoice image must be saved and SAP must be notified that an
invoice has arrived. For ingesting the invoice, companies can use a
scanning device that then invokes Enterprise Scan software. It
subsequently calls SAP. Or, they might employ an SMTP interface that
routes e-mail invoices from the e-mail server to the SAP VIM application. In
both cases, OpenText Archive Center (or another third-party long term
archiving solution) is used to store the incoming invoice image. This image
is now available in the archiving solution and is linked to the new VIM
Document Processing (DP) document.
Key data capture Now that the invoices are reflected in SAP, it is time to extract the key data
fields from the image. There is a pre-defined job running in SAP which looks
for the notification that an image has been archived and is queued in SAP
for processing. When a new invoice is detected, the BCC server is invoked
(if BCC is being used) and the OCR process begins. All fields which are
identified during extraction are saved with the Document Processing
document that was created in the previous step.
Pag e 1- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 1 . V endor Invoi ce Manage ment o verview
Validation of the Now, the document becomes ready for validation by the company
document personnel. At this stage, another job has run which notifies the persons
responsible for checking the invoice extraction (or for manual extraction in
the case where OCR is not employed). The document is opened by the
coder, the fields in the invoice are either validated, corrected, or
complemented.
Creation of the SAP Once completed, the invoice is saved. If it is deemed to not be a duplicate
document invoice, then the business rules for invoices are applied to the data being
submitted. If it passes all of these rules, an SAP document is created and
the next step of the workflow is invoked.
Posting of the SAP Now the Document Processing document and the respective SAP
document document are available for the levels of approval that are necessary in this
company. (this is configurable). After approval, the SAP document is then
posted in SAP.
Product overview Vendor Invoice Management is part of a larger group of OpenText products:
OpenText Suite for SAP Solutions.
Commercial offering: SAP and OpenText both sell the VIM solution. It is branded differently
SAP vs OpenText according to which party is selling it:
SAP - SAP Invoice Management by OpenText
OpenText - Vendor Invoice Management for SAP Solutions
VIM 7.5 VIM 7.5 is the evolution of the VIM solution from its inception. This version is
currently being further developed (i.e. it has not reached an EOM status).
VIM 16.3 VIM 16.3 is OpenText’s latest release of the VIM product. It runs exclusively
on the SAP S/4HANA system, starting with release 1610.
The following figure shows the various versions of SAP and the version of
VIM which it can work in conjunction with.
Both versions can be run in the private Cloud. Ongoing, OpenText will work
jointly with SAP to develop VIM for the public cloud offering.
Pag e 1- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 1 . V endor Invoi ce Manage ment o verview
To understand which VIM version supports which SAP version, read SAP
Note 2339256.
Version 16.3 In version 16.3, the product has been delivered with two modes for
operation. They are technically supported by the same foundation, yet, they
support different methods of invoice processing. They are the Simple and
the Classic Mode.
Classic Mode Classic Mode is to a large extent compatible with previous VIM versions 7.0
and 7.5. It offers proven architecture and a configurable framework and
many options to extend the pre-delivered invoice management logic.
For VIM 16.3, the classic approach was updated and extended to meet SAP
S/4HANA requirements and optimizations and to follow SAP strategy to
post all invoices through one invoice transaction: VIM Baseline
configuration (discussed in later chapters) uses transaction MIRO for all
invoice types including Non-PO invoices.
Classic mode is the choice for organizations upgrading from SAP ECC and
older VIM versions who want to gradually adopt to new SAP S/4HANA
concepts and maintain their approach to invoice processing.
Classic mode provides powerful SAP GUI/Webgui based tools like VIM
Workplace and the VIM Analytics report, a web portal for invoice coding and
approval, which can be integrated with SAP NetWeaver® Portal and SAP
Fiori Apps for different tasks like simple coding, approval, and confirming
price and quantity on PO-related invoices.
Invoice Entry
– These are the options for introducing an invoice into the VIM
system. This includes paper-based invoices which are scanned and
invoices which arrive electronically (EDI, Ariba Network, SAP Idoc,
e-mailed invoice images, etc.)
OCR (Optical Character Recognition) with BCC (Business Center
Capture)
– This component automates the capture of invoice data fields by
using OCR technology
Inbound Channels
– These make up the processing framework for inbound invoices
Document Processing
– This component captures invoice metadata, handles suspected
duplicate invoices, and collaborates with the other components
Invoice Approval
– This component receives a list of invoices to be approved, checks
for appropriate approvers, and allows those users to code and
approve the invoices
Pag e 1- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 1 . V endor Invoi ce Manage ment o verview
Web Portal
– This is a Java based Approval Portal infrastructure running on SAP
NetWeaver Application Server (Java stack). It is similar to the GUI
Invoice Approval but has a Web interface
Fiori Apps
– These apps allow the user to perform multiple invoice-related tasks,
using standard SAP Fiori technology
Exception Handling (Invoice Exception)
– This component allows for the handling of exceptions that arise
before the SAP document is created.
VIM Reporting / VIM Analytics / BW extractor
– VIM Reporting uses various reports to analyze the status of invoices
in the SAP system.
– VIM Analytics overlooks the invoices in progress in a unified
dashboard
Unblocking Workflows
– This component determines the agents necessary to rectify a
blocked invoice and to carry it through to completion
Auto Post and Manual Post
– This component distinguishes between invoices which can be auto-
posted and those which cannot
SAPGUI Workplace
– This component, commonly referred to as the VIM Workplace, is the
main GUI UI for a super user of Vendor Invoice Management
Simple Mode Simple Mode provides a new invoice process designed which embraces
SAP S/4HANA concepts like: simplification, principle-of-one, digitalization,
cloud-first, and a new user experience from the start. The SAP S/4HANA
environment is the basis for a next-generation invoice automation solution
that focuses on streamlined and simplified invoice processing.
Simple Mode philosophy While the Classic Mode provides many configuration options, the Simple
Mode philosophy is about a uniform best practice approach based on a few
invoice scenarios:
Invoices that can be processed through automation by their nature and
structure (Automate)
Invoices that can be processed through automation with limited manual
intervention (Semi-Automate)
Invoices that need manual processing and may use specific features of
SAP’s Fiori App: Manage Supplier Invoices (Manual)
Pag e 1- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 1 . V endor Invoi ce Manage ment o verview
Simple Mode Vendor Invoice Management (simple mode) provides the following:
functionality
Invoice automation built around SAP’s Fiori App Manage Supplier
Invoices
End-to-end Fiori user experience
Capture of scanned paper invoices and PDF invoices through OCR
cloud service with automated optimization through constant feedback
(other invoices are received from networks like Ariba or classic IDocs or
other channels)
Cloud OCR as the default option - on premise OCR will also be
supported
Advanced machine learning features to optimize data capture
(feedback from SAP process and SAP posting to the data extraction
service)
Leverage SAP invoice drafts as a container to store preliminary invoice
data (instead of separate header and line items tables of Classic Mode)
A Fiori based “automation” screen for capturing core invoices fields
which includes Single Click Entry and Table Auto-completion
Minimum set of mandatory configuration based on pre-delivered best
practices settings
Limited classical customizing
Increased number of settings made available through key user
configuration
New “smart” and self-adapting features like intelligent coding defaults,
dynamic auto-classification of vendors into black, grey and white lists,
and others
Extension points in Business Center process framework to meet
customer specific requirements
Vendor Invoice Management 16.3 provides the first version of the new
Simple Mode. A number of features are not yet released and there are
further limitations.
What is new in VIM With the latest release of VIM, OpenText has introduced several new key
16.3 functionalities. Some of these features have been introduced already,
others will be expanded upon in separate chapters.
Support for SAP S/4HANA 1709
Classic Mode (based on VIM 7.5)
Updated baseline configuration (which uses MIRO for all invoices)
Document Processing component which supports parked and held
documents
Reduced use of batch input (blacklisted technology at SAP)
Simple Mode
Business Center add-ons delivered as a part of the VIM ISO image
Summary
In this chapter the challenges of an Accounts Payable department were
presented, along with how Vendor Invoice Management is able to meet
those challenges. A breakdown of stages was shown so that the student
can further visualize how VIM automates the complex series of exchanges
in the Scan to Payment process. Newly introduced functionality was
highlighted.
Pag e 1- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 2. L andscape and A rchit ectur e
Objectives
Single system The most typical scenario is the Single system landscape, where one SAP
landscapes instance is utilized. An example of this logical landscape is shown in the
next figure.
Multi system landscapes VIM can also be deployed in a scenario where there is more than one
stand-alone SAP system. In this scenario, the following VIM resources
might be used on the Central SAP instance:
Invoice entry point, which includes scanning with Business Capture
Center (BCC)
Archive to archive all incoming invoices
Controlling point for management, which uses Central Reporting
All configuration for both scenarios can be done under transaction code
/OPT/SPRO within the OpenText™ IMG. Navigate to Vendor Invoice
Management -> Document Processing Configuration -> General
Configuration -> Multi-Backend Scenarios.
Pag e 2- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 2. L andscape and A rchit ectur e
The following tasks are only required for Multi System Landscapes:
RFC Destinations - In this step, RFC destinations for each of the logical
systems is defined.
Logical Systems - In this step, the logical systems in the distributed
system are defined.
Assign client to logical system - In this work step, a client is assigned to
each logical system.
Landscape definition As discussed in the previous section, there are different landscape options.
The landscape architecture should be defined and well documented prior to
installation. Next, a more detailed view must be decided on, according to
which functionality the customer is employing. An example of a possible
architecture is shown next.
Pag e 2- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 2. L andscape and A rchit ectur e
Business Center and As the previous architecture diagrams have shown, Business Center and
VIM: Two products, Business Center Capture are two products which are a part of OpenText’s
one architecture Suite for SAP Solutions. These two products, along with Vendor Invoice
Management and Invoice Capture Center are digital processing solutions
which can be used independently or in tandem. A customer can choose to
use one, none, or both. However, in order to use VIM and ICC, some
components of BC and BCC are required.
Although the purchase and use of these products is distinct, their technical
make-up is more complex. They are sold separately from a commercial
standpoint, but they share some components from a technical perspective.
Please see the next figure as an illustration of the high level distinction
between these four products:
Vendor Invoice Management
Business Center
Invoice Capture Center
Business Center Capture
Figure 2-5: Business Center, VIM, ICC & BCC: Commercial products vs technical components
In this figure, the top level represents the commercially available products.
The second level represents the functionalities which are associated with
each product. The last level represents the technical components
supporting this functionality.
Pag e 2- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 2. L andscape and A rchit ectur e
For a more detailed break down of the VIM and ICC products, the next
figure is provided.
SAP vs OpenText In delineating how these products are developed and sold, there should
reseller: ICC, VIM, and also be clarity between the names of the products when sold by either SAP
BC or OpenText. This minimizes confusion when having discussions in support
or sales situations. The following table defines the product names used in
the marketplace.
SAP base product OpenText product and version When sold by SAP
ERP OpenText Invoice Capture Center OCR Add-on for SAP Invoice Management by
for SAP Solutions 16.3 OpenText (16.3)
ERP OpenText Business Center for SAP Digital Content Processing by OpenText
SAP Solutions 16.3 (16.3)
SAP S/4HANA OpenText Vendor Invoice SAP Invoice Management for SAP S/4HANA by
Management for SAP Solutions OpenText (7.5 or 16.3)
(7.5 or 16.3)
SAP S/4HANA OpenText Invoice Capture Center OCR Add-on for SAP Invoice Management by
for SAP Solutions 16.3 OpenText (16.3)
SAP S/4HANA OpenText Business Center for SAP Digital Content Processing for S/4HANA by
SAP Solutions 16.3 OpenText (16.3)
Invoice Capture Center The recommendation from OpenText is to move to Invoice Capture Center
version 16.3.
It should also be noted that ICC is now a technical add-on to the Business
Center OCR product: Business Center Capture. Akin to the Business
Center foundation being required for the Vendor Invoice Management
functionality. Business Center Capture is now the foundation for the
Invoice Capture Center add-on.
Going forward, all new installations and upgrades should be using ICC 16.3,
which is:
compatible with VIM 7.5 SP6+ and VIM 16.3
supported for deployment in MS Azure and AWS
Pag e 2- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 2. L andscape and A rchit ectur e
The next version of BCC and ICC will be an Information Extraction Service,
which will:
enable public cloud deployment
enhance current machine learning offering
ICC and it’s unified deployment with BCC is covered in more detail
in a later chapter.
Summary
This chapter reviewed potential VIM landscapes. It provided general
guidelines for the products used and the architecture of a VIM solution.
Pag e 2- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
Objectives
Installation procedures
At a minimum, the customer should install SP1 for VIM 16.3. The VIM
16.3 SP1 release delivers two possible scenarios for installation. Classic
and Simple modes. This chapter and the rest of the course will focus on
Classic Mode. Please see the OpenText Knowledge Center for
appropriate documentation for Simple Mode installation.
In addition to the core SAP S4/HANA components, VIM can extend it’s
functionality with additional components. For the purposes of this manual,
steps for installing the following optional components will not be covered:
Approval Portal
Mobile Approval Portal
KPI Dashboard
Netweaver Gateway
Supplier Self Service
Ariba Integration
Vendor Invoice Management SAP NetWeaver Business Warehouse
(VIM BW)
General guidelines This course will deliver an overview of the installation process for VIM 16.3
SP1. It is not meant to be used as a comprehensive installation guide.
SAP component
Pre-requisites The basic installation of VIM requires that certain other pieces of software
are already in place. The most obvious of these is SAP. For VIM 16.3, the
earliest release of SAP that can be used is SAP S/4HANA 1610 (S4CORE
101). The Support Package Manager in SAP (transaction SPAM) should be
run to ensure that the support pack level is at least 66.
Obtaining the software Customers can obtain the VIM solution via a download via the OpenText
Knowledge Center. Support Packages along with all of the most recent
documentation should be retrieved from the OpenText Knowledge Center. If
a customer requires instructions for a fix (hot fix) for a single issue, this
should be remedied via OpenText support tickets.
Pag e 3- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
Workflow set-up VIM also requires that the SAP Workflow engine is configured to run
workflow tasks. This can be checked via the SWU3 transaction. With this
transaction, the relevant tasks should be verified as complete (denoted with
the Green Check mark). Most critically, it should be confirmed that RFC
destinations have been configured.
There might be some tasks which have a red ‘X’ indicating they
are not configured completely, such as ‘Edit Additional Settings
and Services’ and ‘Guided Procedures’. This is acceptable.
Ensure the Configure RFC Destination is configured (indicated by
a green check mark to the left of the task).
ArchiveLink The ArchiveLink interface must also be active in the SAP system for
communication with the storage system to be enabled.
SAINT The SAP Add-on Installation Tool (SAINT) will be used for installation.
SAINT requires PAT files (extension *.PAT), which are collections of
transport files or packages. The product is archived into SAPCAR files
(extension *.SAR). The different SAPCAR files are located in a DATA folder
below the respective package folder, named according to package and SAP
release.
File names must be in upper case. File names with lower case characters
will not accepted by transaction code SAINT nor SPAM.
Installing the VIM SAP In order to install the VIM Basis package (which will in turn install the basic
component VIM components), the following steps should be carried out on the
SAP S/4HANA server:
1. Obtain all relevant SAR files for each VIM add-on component. You will
also need all relevant Support Packages for these installation files. For
example:
– Component OTBCBAS has a SAR file named
OTBCBAS_INST_UPG_0700_004.SAR. It also has a Support
Package file named OTBCBAS_SP01_0700_004.SAR. You require
both for each component.
These can be extracted using the SAPCAR command line tool.There is
also a required password that must be supplied to SAINT when VIM is
installed or upgraded. These are found in the installation guide.
2. Copy the respective SAPCAR files from the aforementioned site to the
target SAP Application Server. The file should be placed in /usr/sap/
trans/EPS/ with the following command:
SAPCAR -xvf<name of SAPCAR file>.
Pag e 3- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
Figure 3-2:
Figure 3-3:
Transaction SAINT
6. There are various operations available within SAINT, one menu path for
installing components is pictured next:
Pag e 3- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
Figure 3-5:
Result of SAINT
installation process
Verification In order to verify that the system has the correct components and sufficient
support packages installed, the following steps should be taken:
1. Navigate to the top menu of SAP.
2. Click the System -> Status menu item.
3. Under the SAP System Data section, click on the Magnifying Glass
icon.
Pag e 3- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
Ensure you use Expert Mode within transaction SCPR20 to perform this
activation.
Figure 3-8:
Figure 3-9:
Pag e 3- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
Link the events for VIM workflows - SAP events are trigger points for
VIM workflows. For example, when a logistic invoice is posted, SAP
S/4HANA generates the event POSTED from the business object
BUS2081. The event is linked to trigger the VIM workflow solution for
blocked invoices if the invoice is blocked. Event linkages are not
activated automatically. You must add the event linkages manually. This
is done via transaction SWE2.
Maintain the SAPscript form for approval - this standard SAPScript form
must be copied from client 000 to all clients and modified accordingly
Maintain the standard text - Standard Texts are used to build letters
such as the Return to Vendor e-mail which gets set in the RTV process.
This is done via transaction SO10. Standard texts should be maintained
for this particular e-mail functionality:
– /OPT/VIM_SIGNATURE_RTV - this is for the e-mail footer
– /OPT/VIM_RTV_EXAMPLE - this is for the e-mail body and is
provided as an example. It should be renamed for the customer’s
usage
Figure 3-10:
Set the background user parameters for Non PO invoice posting - this is
for setting a PID specific to user WF-BATCH. WF-BATCH is a user the
system can utilize while performing tasks in the background, such as
workflow oriented tasks or posting.
Install the transport for extended VAT date support - this is a BADI
implementation which should be activated if required.
Maintain the Business Transaction Events - A BTE has a predefined
interface and allows you to attach additional functionality in the form of
a service function module.There are two BTEs which should be called
for VIM. These should be configured via transaction BF42.
Configure the system landscape - transaction /OPT/VIM_SLD will allow
you to set up the system landscape directory.
Figure 3-11: System Landscape Directory in transaction /OPT/VIM_SLD: Single System landscape
Fiori: Activating services - Two services must be activated for the Fiori
Task App:
– OData Service -The Fiori Task App communicates with the ABAP
backend using a dedicated OData service
(/OTX/PS33_DATA_SRV).Set up version 0003 of OData service
using the /IWFND/MAINT_SERVICE transaction.
Pag e 3- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
– UI Service - This must be activated for both VIM and BC. Both of
these services are located via the SICF transaction in SAP. The
VIM and BC UI services are shown in the next figure within
transaction SICF.
Figure 3-13:
Figure 3-14: Configuration of VIM Approval tile for the Fiori Launchpad
Upgrading
Customers should consider several factors when making a choice about
which VIM solution they will upgrade to or implement next. Factors include
the customer’s:
Current SAP landscape (version and database) and road map
Current version of VIM
Desired components or functionality within each VIM product version
OCR strategy
End of Maintenance targets for each product
Resources and time frame available for the project
Pag e 3- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
This type of decision can not be dictated within the limits of a manual,
however, several pieces of information are given in order to aid the
customer in making such a decision.
Figure 3-15:
VIM versions
In the previous figure, the various versions of VIM which are now available
are shown. And in the following figure, the compatibility of these versions of
VIM according to the SAP product and version is presented.
SAP S/4HANA 1709 VIM 16.3 VIM 16.3 SP 1 See SAP Note: 2533336
SAP S/4HANA 1610 VIM 7.5 SP 5 and VIM 16.3 See SAP Notes: 2392527, 2401972
on prem VIM 16.3
SAP Simple Finance VIM 7.5 SP 1+ VIM 7.5 SP 3+ See SAP Notes: 2100133, 1920804
1503
SAP Simple Finance VIM 7.5 SP 1+ VIM 7.5 SP 3+ See SAP Note: 1920804
1.0
SAP ERP 6.0 EHP 7 VIM 7.5 SP 1+ See SAP Notes: 1896062 ,1920804
SAP ERP 6.0 EHP 0 - VIM 7.5 SP 1+ Minimum required SAP Basis SP
6 level per installation guide
SAP ERP Suite on VIM 7.5 SP 1+ 7.5 SP 3 See SAP note 1855666
HANA
SAP R/3 4.6c, SAP Not supported by Versions of VIM 5.1.6 to 7.0 should
R/3 4.7 Enterprise, any VIM version, follow upgrade paths which are
SAP ECC 5.0 which is currently mapped out distinctly for them.
under maintenace However, a general path to upgrade is
shown in the next section for these
situations
SAP S/4HANA Cloud Not currently Add-in solution is Co-developed by SAP and OpenText,
supported available: SAP S/ this product can be purchased from
4HANA Cloud for SAP
invoice processing by
OpenText
Upgrading to VIM 7.5 The General guideline is to use VIM 7.5 for installations on SAP ERP 6.0
and SAP S/4HANA on Premise Edition 1511. In this scenario, the customer
is choosing to stay on VIM 7.5 and therefore is planning to be on SAP ERP
or SAP S4/HANA (but not later than 1511). VIM 7.5 does not support SAP
S/4HANA 1709 and higher.
Upgrading to VIM 16.3 A customer should use VIM 16.3 for installations on SAP S/4HANA 1610
and higher.In this scenario, the customer is choosing to move to the latest
version of SAP S4/HANA. VIM 16.3 does not support SAP ERP 6.0 and
SAP S/4HANA on Premise Edition 1511.
Upgrading ICC The general guideline for Invoice Capture Center is to use the latest version
of 16.3 for all installations. ICC 16.3 supports VIM 16.3 and VIM 7.5 (SP6
and higher).
BCC component Use Business Center 16.3 for all versions of SAP ERP and S/4HANA.
SAP R/3 4.6c, SAP R/3 Enterprise 4.7, SAP ECC 5.0 are no longer
supported by any VIM version that is under maintenance.
Pag e 3- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
These paths are only general depictions of how a customer might reach a
certain patch level. OpenText Professional Services should be contacted
to tailor a strategy and approach for such an upgrade. Please see the
respective Installation and corresponding Upgrade Guides for further
detail on exchange upgrades and upgrade steps.
5.1.6 5.1.6 -> 6.0 SP1 -> 7.5 This is the first version resold
by SAP.
5.2 VIM 5.2 SP6 5.2 -> 7.5 VIM 5.2 SP 6 and 6.0 SP1 are
5.2 -> 6.0 SP1 -> 7.5 almost identical, so upgrade is
low risk and straightforward.
6.0 VIM 6.0 SP1 6.0 -> 7.5 This effort is a true upgrade
project.
Upgrading to VIM 7.5 VIM 7.5 introduced new features, obsolete functionality, migration of
Process Types, Logic Modules, and a new approval workflow. These should
be considered when deciding if the target VIM release level is 7.5. They
include:
Obsolete functions With the release of VIM 7.5 SP2, there are some obsolete functions to
consider.
Simple approvals - These are obsolete for Non-PO approvals. However,
for PO-based processing, OpenText will still support the customer.
However, this support for old/simple PO approvals will be phased out in
upcoming SP releases.
Integrated Invoice Cockpit - The data from the ICC tables must be
downloaded and moved into the VIM Workplace tables.
Old Indexing Screen - If the customer is moving from a version pre-VIM
7.0 or has retained the old indexing screen, then these settings should
be migrated.
Old VIM Analytics Report(/opt/vim_analytics) - An initial data load must
be scheduled and new appropriate authorizations must be assigned for
the New VIM Analytics report to the user base.
Old COA (Chart of Authority, which is used in the Approval functionality)
tables and procedures (a new COA was introduced with 7.0)
Old approval Workflows (new approval workflow was introduced with
7.0, SP1/2)
Integrated Invoice Cockpit (IIC) - replaced by the VIM workplace
Old Web UI of the Approval portal
VIM Inbound process will not be supported in the long term
Migration of Process As some Process Types have been migrated to Logical Modules, old
Types Document Type Process Types must be verified. The following checks can
be done:
Simple check: Firstly, compare your Process Type list against the VIM
7.5 Baseline Standard Document Types. If it is still present in the
standard, then it should work without changes. Otherwise, verify:
– Is it a Business Rule? If yes, this remains as a Business Rule. Verify
that it is enabled for the Document Type.
– Does it update the data? If yes, then it should be migrated to a
Logical Module.
Logical Modules Some processing logic, which was called directly before, is now
encapsulated in logical modules. An example of this is the mapping logic for
additional costs.
New approval workflow Once the COA (Chart of Authority) has been migrated, the customer needs
to continue processing the open workflow tasks.
Pag e 3- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
If they run as-is, the behavior will be unpredictable. The correct approach is
a mass recall and mass resubmit. The new Workflow works with the new
COA.The drawback to this is that approval steps have to be repeated.
Two different ways in There are two separate approaches for upgrading VIM:
order to upgrade VIM
Technical upgrade
– A technical upgrade of VIM is minimally invasive to the customer’s
business continuity
– This might include usage of the new index screen and reports such
as new VIM analytics
– VIM Workplace might be used
– VIM Process and logic will be untouched (except the approval
process flow)
Functional (Full) upgrade
– A full upgrade would include the technical upgrade and would
embrace the functionality changes
– This would Include usage of new features such as the Business
Rule Framework and Logic Modules
– Old custom Business Rules might be needed to be adapted
– New process functions could be activated via a dedicated constant
variable: VIM_VERSION_SWITCH = 7.5
Upgrading to VIM 16.3 There are a couple of variations for upgrading VIM to version 16.3:
Upgrading from VIM 7.5 SP5 (or later) on SAP S/4HANA
Upgrading from any VIM version on SAP ERP
Help from OpenText Starting with VIM 7.5 SP2, OpenText delivers:
An Upgrade Guide
Reports to populate data for the new VAN report and VIM Workplace so
that they work with workflows started before the upgrade.
Migration tools for:
– Migration of document type and indexing screen settings
– Migration of old COA to new COA
– Mass recall and resubmit of approval workflows
Figure 3-16:
OpenText upgrade
approach
Proceed to prepare and perform the upgrade according to Section 7.4 of the
Installation Guide.
Pag e 3- 20 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 3. I nstalla tion and u pgrad e to VI M 16.3 SP 1
1. Navigate to the System -> Status menu from the SAP base menu.
2. Click on the Magnifying Glasses icon in the SAP System data section.
3. Verify the OTEXVIM add on is listed with the correct release number.
Summary
This chapter introduced the high level tasks associated with installing and
upgrading the VIM SAP system, along with some detailed information about
upgrades to VIM 7.5. It provided general guidelines along with a link to the
comprehensive installation guide for 16.3 which is provided by OpenText.
Pag e 3- 22 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
Objectives
Figure 4-2:
Overview of SAP
ArchiveLink functionality
Pag e 4- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
SAP elements used in The SAP-delivered functionality of ArchiveLink is built using foundational
ArchiveLink objects in standard SAP. Database tables, function modules, and the GUI
interface are all key elements in any SAP functionality. The same is true
with ArchiveLink.
Database tables SAP uses database tables and their relationships to each other for housing
master and transactional data that represents the business and its
underlying processes. It also uses them to hold configuration data, which
tells the system how to behave when executing certain processes. In
ArchiveLink the following types of tables are utilized:
Customizing tables (“meta tables”) - these tables hold information about
the objects that describe the ArchiveLink scenario.
Link tables - these tables hold the key to linking a document to an SAP
object.
Function modules A function module in SAP is a set of lines of ABAP code that has a definite
interface. In these modules of code, there are input parameters and output
parameters, tables of data that can be passed back and forth, and explicit
outcomes that can be reported back. These modules are called from certain
places in the system and can be re-used multiple times. ArchiveLink
employs function modules for the following tasks within ArchiveLink:
Queries for customizing settings
Document archiving
Document display
Document retrieval/download
SAP tables in detail Understanding the SAP database tables and their relationships to each
other is key to understanding any SAP functionality. Here, we will present
several key tables which we utilize for controlling ArchiveLink functionality.
The table names are included here for reference, but the table
contents are created separately via transaction codes which will
be covered later.
Link tables TOA01 - Links documents associated with SAP data records (objects)
TOADL - Links print lists; different structure
These are a few examples of tables in the SAP database which are
exclusively used in conjunction with ArchiveLink. The names of most tables
begin with 'TOA', meaning “Table for Optical Archiving”.
When a document is archived and shall be linked to an SAP object, this link
is not stored as part of the object information in the applicable application
module. Instead, some central ArchiveLink link tables hold all object-to-
document link information. This structure yields some advantages:
Application modules do not have to deal with archive document
information; therefore, documents can be linked to all types of objects
without further preconditions on the application side. However, this does
not imply that all archiving scenarios are applicable across all
applications.
Multiple documents can point to the same SAP object.
Pag e 4- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
Building blocks The main building blocks for archiving in SAP are: the SAP document class,
the SAP document type, and the SAP object type.
SAP Document Class This category can also be thought of as the technical document class and is
used to distinguish between archive formats (ALF, ASCII, FAX, PDF, DOC).
SAP Document Type This category places an SAP document class in context and serves as an
identifier for similar documents in SAP (FIINVOICE, SDOORDER, D01,
etc.). It is the semantic descriptor for the documents role. Many standard
document types are delivered with SAP. Differing document types are often
handled by differing workflows.
SAP Object Type This category specifies the type of business object that the document will
relate to and the nature of the object itself (i.e. BKPF, PREL, DRAW, FIPP).
It will describe the internal format, key entries, and properties of the SAP
data sets. These are usually predefined and used within one SAP module.
Content Repository The Content Repository (some places in SAP it is still referred to as the
Archive ID) is defined in SAP. It represents the logical place within the
archiving solution, where the archived document will reside. In SAP, the
nomenclature for Content Repository is upper case and two characters in
length. It must match the actual name of the Logical Archive within the
archiving solution.
Figure 4-4:
Pag e 4- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
1. To view table contents in SAP, the instructor can use transaction SE16
or SE16N. This is called the Data Browser (an example of the SE16
interface is shown in the previous figure).
2. To retrieve an entry in the table, the instructor will populate some of the
fields on the selection screen presented. This might include Client, SAP
object type, SAP document type, or SAP document class.
3. Once an entry is presented on the result screen, it can be highlighted by
clicking on the grey square on the left-most side of the row. The
eyeglasses icon can then be used to look at the full contents of this
record.
In the below figure, the relationship of the link tables and the SAP object
type is depicted.
An SAP table stores a set of static attributes for each archived document.
The archive ID and doc ID that are created for an archived document are
linked using its unique set of static attributes in the link table (e.g, TOA01).
This requires an SAP object type (illustrated above).
Basic customizing For ArchiveLink set up, basic customizing has to be done almost every time
steps a new type of document is prepared for archiving.
Figure 4-6:
Customizing for
ArchiveLink
However, the mentioned steps do not need to be carried out each time. An
existing logical archive may be reused for a new document type, provided
that the logical archive is used appropriately (for example, has the proper
document retention period).
ArchiveLink basic So far, the focus has been on understanding the conceptual elements of
customizing ArchiveLink - how it works behind the scenes. The rest of the chapter will
deal with configuring ArchiveLink within the SAP system, in preparation for
a VIM project. There are several tasks that must be completed. The
following can be used as a check list for ensuring you have completed all of
the necessary steps:
1. Create/check SAP document class with transaction OAD2 - This is only
necessary if a non-standard document class must be used for
archiving. For example, ASCII is a non-standard document class for
archiving document lists.
2. Create SAP document types with transaction OAC2 - An SAP
document type must be created for each different kind of document to
be archived. For example, one document type for fax invoices and
another one for invoices from document lists.
3. Create link information with transaction OAC3 - Link the SAP object
type and an SAP document type with an Archive ID and a Link table.
Pag e 4- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
The following figure helps to reiterate the relationship between each of the
elements being created.
There are several different menu paths or transaction codes that might take
the user to the same place in the SAP system. Throughout this course,
transaction codes will be primarily used. However, it should be noted that
whenever a customizing task is being performed, if a transaction code can
be used then there is also a corresponding menu path within the SAP IMG.
The SAP IMG can be reached as follows:
1. Type /nSPRO in the command field of the SAP GUI (the /n instructs the
system to open a “new” session and closes the current session. In order
to open an additional session, replace the “n” with an “o”).
2. Click the SAP Reference IMG button. This is the root of the SAP IMG.
3. Drill down to the appropriate level of the IMG to find the configuration
step you need.
The SAP IMG houses all configuration steps for all functionality
within the SAP system. It can be daunting and it is easy to get lost.
The best remedy is to click on the binoculars at the top of the
screen, type in a familiar phrase (for example, ArchiveLink) and
the system will return a hit list of menu paths where the
configuration steps contain the word ArchiveLink.
Pag e 4- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
The IMG is generally broken down into sections by functionality and tends
to correspond to the roles of those configuring the system. For instance,
technical communication and system parameters would generally be a task
for an SAP Basis expert, and this is in a distinct location in the IMG. Other
examples would be separate configuration areas for VIM consultants,
ArchiveLink consultants, Netweaver portal consultants, and functional
business consultants.
For the purposes of customizing the basic ArchiveLink settings required for
this course, the steps will be carried out on a transaction by transaction
basis, which is described next.
Transaction OAC2 The next customizing table manipulated by the wizard is the list of
document type definitions (illustrated in the next figure). You can access it
via transaction OAC2. It stores the document type name, description, and
document class (from OAD2) assignment. A fourth attribute “status” is also
included, but it has no significance in the context of ArchiveLink archiving.
For an existing document type, you may alter the description and document
class here. Moreover, you can add descriptions in other languages than the
one used for creating the document type. This is strongly recommended for
companies operating SAP in multiple languages.
You may also choose to create a new document type directly here. To do
this, click the New Entries button to invoke the New Entries: Details of
Created Entries dialog, then enter the requested document type attributes.
Pag e 4- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
If you do so, do not forget to link the document type to a logical archive
afterwards (described in the next step).
Figure 4-10:
Transaction OAC2
Transaction OAC3 This transaction is used to establish a link between the given SAP object
type, document type, and the logical archive. You can review and alter this
information using this transaction. The screen that appears contains an
overview of all the links defined (illustrated below). The fields have the
following meanings:
1. Obj. type - The SAP object to which an archived document of the
specified document type (see below) becomes linked.
2. Doc. type - The archived document to be processed according to this
link information entry.
3. S (“status”) - Effectiveness of the link customizing entry. ‘X’ means
active, everything else means inactive.
4. Content R. ID of logical archive - (content repository) that will receive
documents of the specified document type.
5. Link - Name of the link table where this association is stored in the SAP
database.
6. Ret. per. - Retention period of an archived document (only for
documentation); interpreted as number of months.
For editing existing entries, you first have to switch from display
mode to change mode by clicking the Pencil and Glasses icon.
After this, you may also create new entries by clicking the New
Entries button.
Archiving scenarios
Before we discuss the more complicated aspect of customizing the
scenarios which require workflow, it is prudent that we discuss the archiving
scenarios themselves.
Early Archiving In VIM there will be multiple document types that flow through the Early
Archiving Scenario. For each document type, a distinct storage scenario
can be stipulated. There are four storage scenarios available for Early
Archiving:
Storing for subsequent entry
Storing for subsequent assignment
Store and enter
Store and assign
Pag e 4- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
You can only use the wizard to link the ArchiveLink Document
Type to one SAP Business Object. Therefore, you will need to do
additional customizing (OAC3) after using the wizard.
Workflow Document Setting up a document type for archiving with workflow is therefore
Types mentioned in the next figure as a single customizing step that is shared
between the basic customizing and scenario dependent customizing blocks.
Figure 4-12:
Scenario dependent
customizing
Object Method This tells the system what will happen to the object when the first workflow
step is executed.
Workflow Task Tasks are a part of the SAP Workflow component. They direct certain steps
or an activity in the system in the overall workflow definition.
Workflow Parameters Parameters may be passed for the object method that is called. These are
not necessary in the VIM context.
Set up of a Workflow Let’s take an example for illustration. The information that SAP requires
Document Type when setting up a document type is stored in multiple configuration tables.
However, there is no need to maintain each manually. Instead, ArchiveLink
provides a document type customizing wizard that automates editing of the
involved tables into a single dialog sequence. During this sequence, you are
queried for all of the document attributes discussed in previous steps.
For the Store for Subsequent Entry scenario, for incoming invoices, handled
by the SD module, the following values would be used for the workflow
parameters (Agent may be handled with the wizard or without per the
following instructions):
Pag e 4- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
If you are preparing “Store and Assign” only, nothing outside of the
object type needs to be entered. The wizard will display a warning
in case you have omitted one ore more entries, but this is okay,
confirm it to continue.
7. The workflow parameters dialog appears only if you have filled out the
Entry section of the previous dialog. It presents a list of possible
workflow parameters for the chosen SAP object type and method. Fill in
the parameter values, if required. (this is not required during this
training class) Press Continue.
8. Enter the basic customizing attributes of the document type: Content
Repository ID (logical archive ID), link table, and document retention
period (number of months). Recall retention period is purely for
documentation purposes in this dialog. Click Continue.
9. This and the remaining dialogs let you decide which presettings (lists of
available document types for archiving; usually grouped according to
departments or business areas) you want to include your document
type in. If you want to add your document type to one or more of the
existing presettings, mark them in the list presented here. If you want to
create a new presetting to add your document to, you may enter one (or
more) at the next screen. Make the following entries:
ID: A unique four-character, alpha-numeric identifier. Since the list
of presettings is presented in alphabetical order of these IDs, your
identifier will decide the position at which your new setting will
appear within the presettings list.
Name: The presettings description that will be presented to the user
when he is about to store a document.
10. For each presetting chosen, specify here the workflow agent
responsible for processing a stored document of the given type. Make
the following entries and then click Continue:
OT (“object type” — left column): The type of the target agent.
ID: The specific agent for this document type. The value must be an
existing one with regard to the chosen agent type OT.
You may leave the two aforementioned fields empty. In this case,
the SAP user who archives a document is automatically chosen
as the responsible agent for this document. In this training class,
these fields will be left empty.
Pag e 4- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
The above table shows the possible types of workflow agents for document
archiving with workflow.
Most of the types assume a set of multiple SAP users as possible work item
executors. All included executors can access the work item in their
respective workplace inboxes; as soon as the first one opens the work item,
it automatically disappears from all others’ inboxes.
Example of setting up a Here, we show the steps used in invoking the customizing wizard to create
Workflow Document an ArchiveLink Document Type.
Type: using the Wizard,
transaction OAD5 1. Invoke the customizing wizard by entering transaction OAD5.
3. Enter the name of the new document type and a meaningful description
for it. The name must begin with ‘Y’ or ‘Z’. Click Continue to proceed.
Pag e 4- 20 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
5. Select the Workflow document type check box. Click the Continue
button.
Pag e 4- 22 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
7. Enter the type of SAP objects that documents shall be linked to. Begin
with /OTX/PF01R, which is for the incoming Document. Also, enter the
Workflow Method and Task which correlate to the scenario you are
customizing:
– Method: IDF- Registration of document
– Task: WS000297300
Press the Continue Button. A warning will pop up, click on the Green
Check mark icon to accept it.
Pag e 4- 24 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
Pag e 4- 26 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
11. Optional: Choose an identifier. 0000 would appear as the first entry.
ZZZZ would appear as the last. For this training class, use 00##, where
## is your user number.
12. Choose the Archiving scenario using the check box ‘Storing for
Subsequent Entry’ (this scenario and the others are described in the
next section). Click Continue.
Pag e 4- 28 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
13. Confirm the final wizard dialog by pressing the Complete button.
Linking additional Now that the ArchiveLink Document Type has been created, the additional
Objects to the SAP Business Objects which will reference your archived image, should be
ArchiveLink Document linked to this ArchiveLink Document Type. Use OAC3 to create new link
Type entries via transaction OAC3.
Pag e 4- 30 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
Presettings Presettings are used to pre-populate the values a user needs to start the
archiving scenario. The system allows these to be saved for convenient
reuse. A presetting folder represents a preset group of ArchiveLink
Document Types. The group contains the types that are related by
workplace or by application. Grouping types together in a preset group
provides a more effective overview of ArchiveLink Document Types on the
initial screen of the storage process Store Documents (transaction code
OAWD).
Step by step The below steps iterate how to view and/or maintain document archiving
presettings:
1. Enter transaction OAWS; the screen Change View ‘Default setting’:
Overview appears, displaying a list of all defined presettings on the right
window pane.
2. Add, rename, or delete presettings, using the taskbar buttons.
3. To view/edit on document type level, continue as follows:
Mark the presetting you want to view/edit by clicking into the empty
rectangle button to the left of the list entry.
In window section “Dialog Structure”, double-click Entries; the
screen Change View ‘Entries’: Overview appears, displaying the list
of document type entries of the chosen setting.
You may now add, change, or delete document type items, using
the taskbar buttons.
OAWD ArchiveLink provides personalization options for each SAP users archiving
presettings. To maintain your personal view, enter transaction OAWD
(“Store documents”), then choose menu item Settings -> User settings. The
dialog which is shown in the next figure will appear.
Pag e 4- 32 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 4. SA P A rchive Link C ustomizin g for V IM
1. Log on to the SAP system with your user. User-## where ## is your
assigned participant ID.
2. Type /nOAD5 into the command field, and press enter.
3. Click the continue button.
4. Enter the name Z##_INV in the field Doc. Type. (## should be replaced
by the participant number - assigned by the instructor).
5. Enter a meaningful name in the name field, and click continue.
6. Leave the template Doc.type field blank, and click continue.
7. Check the workflow document type check box, and click continue.
8. Type FAX in the document class field, and click continue.
9. Type /OTX/PF01R in the Obj. Type field and WS00297300 in the Task
field and click continue.
10. Click the Green check mark when the warning pop up appears.
11. Populate Cont.Rep.Id and the Link fields, with A1 and TOA01
respectively, populate Retention per. = 120(optionally), and press
continue.
12. Do not choose an existing presetting. Click Continue.
13. For your presetting, use ID = 00XX where XX is your participant
number. Populate the Name field with something meaningful, include
your name or participant number for quick reference later. Click
Continue.
14. Choose the ‘Storing for Subsequent Entry’ scenario (the first check
box). Do not populate any other fields. Click Continue.
15. Click the Complete button.
16. When the prompt for a customizing request is presented, click on the
Paper icon to create a new request. Give it a descriptive name. Use the
Save icon and assign your customizing to this request for the rest of the
class.
In this exercise, the steps for the Customizing Wizard are dictated.
However, the single SAP transactions could be employed
alternatively.
Exercise: Link additional SAP Object Types to your Workflow Document Type
In this exercise you will link three additional SAP Object Types to your
Workflow Document Type(s) (created in the previous exercise) using
transaction OAC3:
Summary
In order to set up the link between SAP and Archive Center, the standard
ArchiveLink interface is used. In order to utilize this interface for VIM, the
concepts of ArchiveLink were introduced. From these concepts we see that
we can link a document to a descriptive document type, to a document
class to describe its file format, to an SAP object to describe its processing,
and to a logical archive to tell where it will be placed on the Archive Center.
In order to invoke the more robust workflow scenarios, we investigated how
to customize workflow settings associated with a document type.
Pag e 4- 34 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 5. VIM Role Fr amewo rk
Objectives
So, VIM Workflow queries VIM Role Resolution in order to determine the
SAP User and their authorizations, which is then sent back to the workflow
for correct routing of tasks. This is depicted in the figure below.
Baseline Roles Some of the standard VIM roles that are provided out of the box by
OpenText are:
Scanner
Indexer
Duplicate Analyst
Accounts Payable Expert
Accounts Payable Processor
Buyer (PO)
Requisitioner or Requestor
Receiver (PO)
Approver
Coder
Vendor Maintenance
Contract Agent (PO)
Tax Expert
Information provider
Service Requestor
Service Approver
Step by step: Create a In order to create a Role, the following steps should be followed:
Role 1. Type the /OPT/CP_9CX5 transaction code into the command field.
Press Enter.
Figure 5-2:
Transaction /OPT/
CP_9CX5
Pag e 5- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 5. VIM Role Fr amewo rk
Figure 5-3:
Figure 5-4:
Role Templates Each role is based on a Role Template. Role Templates control how a Role
is resolved. One template can be re-used for multiple roles. A template is
usually defined by the Configuration consultant. There are three types of
Role Templates.
Organizational Unit based - In this type of template, role resolution is
semi-dynamic. This is because this template tells the workflow to send
the task to a certain Organizational Unit. This could be a Work Center or
a Position. Since assignments of personnel to each Organizational
Object can change, the routing can change as well. For instance, if the
template assigned a Work Center to a Role, all of the personnel who
are attached to that Work Center (perhaps Tax Agents) would be the
recipients of that workflow task.
Pag e 5- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 5. VIM Role Fr amewo rk
Step by step In many cases, a standard delivered Role Template from OpenText will
(optional): Create a meet the needs of the customer. However, if a need arises for a custom
Role Template Role Template, the following series of steps can be followed:
1. Type the /OPT/CP_9CX2 transaction into the SAP command field.
2. Press Enter.
3. In the Product Role Templates Configuration Overview screen, double-
click Template Definition in the navigation pane.
4. In the Template Definition Screen, populate the following fields:
Template ID - A descriptive character string for the new template.
Description - The description of the new template.
Type - Function Module Based, Org Unit, or Field Based.
Object Type - For org unit based templates only. The Organizational
Unit type (i.e. Position, Work Center).
Agent ID - For org unit based templates only. The organizational
units identifier (ie. Position number or Work Center number).
Function Module - For function module based templates only.
Creating Role Template Role Template Fields must only be maintained for Field-based templates.
Fields and Field Details Template Fields enumerate they key fields used in role determination. Once
the Fields and their value sets are populated, the Field Details should be
maintained. This distinguishes how each field behaves according to Product
Code. For more information on how to create the Fields and Field Details,
see the VIM 16.3.1 Configuration Guide.pdf.
Step by step: Once a template definition is created, it can be assigned to multiple VIM
Assigning Templates roles.
to Roles 1. Type transaction code /OPT/CP_9CX2 into the SAP command field.
Alternatively, navigate to the VIM-specific Easy Access menu, expand
the Roles folder, and highlight Template Maintenance.
Figure 5-7:
Template Maintenance
menu path
Pag e 5- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 5. VIM Role Fr amewo rk
Figure 5-8:
Transaction /OPT/
CP_9CX2
Figure 5-9:
If the Active check box is not selected, then the Role to template
assignment will not be used by workflow. This allows for multiple
assignments to be in configuration, but for exactly one to be picked
up by the system at any given time.
Role Determination or At this stage, the Roles have been created (i.e. AP Processor), the
Resolution Templates have been created (i.e ORGUNIT), the Template to Role
assignment has been made (i.e. the AP Processor role in Product Code 005
will be determined by Org. Unit). The last remaining step is to establish
which organizational unit for Product code 005 will be the AP Processors.
This is Role Determination. In this step, you define the runtime values that
the system uses to resolve roles for a given product code.
These values are populated in the following manner:
Step by step: Setting up 1. Type transaction code /OPT/CP_9CX4 into the command line.
Role Determination Alternatively navigate to the VIM Easy Access Menu and choose the
Simple Mode Role Maintenance option.
Figure 5-10:
Pag e 5- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 5. VIM Role Fr amewo rk
3. Ensure you are in Change mode and on the left pane, highlight the role
that you want to assign values to.
Fail Safe and Default Key Within the User Assignment Interface, in the last diagram, the fields for Fail
Safe and Default Key were introduced. These are explained further here:
Fail Safe - If Role Determination fails for this Role, the task is assigned
to the agent in the Fail Safe field.
Default Key - If a particular user should always be the default agent for
a task, then that agent should be in the Default Key field.
Pag e 5- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 5. VIM Role Fr amewo rk
Figure 5-13:
A Summary of Role
Resolution customizing
in the VIM component
005/INFO_PROVIDER
LIX/RECEIVER
In this exercise you will create two new roles for product code 005:
Z##INDEXER
Z##APPROC
Pag e 5- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 5. VIM Role Fr amewo rk
7. Click Save.
8. Repeat for the second Role.
Summary
In this chapter, the concept of the VIM Role framework was introduced. The
concept of a role to define the users responsibilities in the system was
introduced. Templates for assigning certain criteria for role determination
were discussed, along with the eventual assignment of a template to a role.
Lastly, the assignment of values or agents to the Product Role Template
combination was covered. With these three new concepts, the VIM Role
framework is fully defined.
The Requisitioner should be the value in the field Requisitioner within the PO in the line
item field.
There are two users who handle all vendor maintenance for the organization. They belong
to the Master Data group.
Each AP Processor should own one Company Codes invoices.
Each Buyer should be assigned to handling invoices for a specific Plant.
_________________________________________________________________________
_________________________________________________________________________
_________________________________________________________________________
_________________________________________________________________________
Pag e 5- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Objectives
Overview
VIM uses Business Center Inbound Configuration for incoming invoices. It is
designed to receive and pre-process documents in many formats. When
used with VIM, it supports scanning, OCR, e-mailed invoices, invoice
upload, and OT Archive Pipelines (batch Load, stand-alone scanning
without OAWD) as input.
Invoices can be paper, PDF, XML and IDOC formats. It can be extended
through customizing and additional service modules for flexible support of
all incoming formats. This might include for example, rendering of IDOCs
and XML files or extracting data from XLS and other formats.
Architecture
Inbound Configuration is a Business Center component, an OpenText add-
on to SAP (used here for VIM). Invoice input occurs through SAP channels
such as IDocs, the non OCR interface, the global RFC interface, or the
OpenText OCR interface. Once into the system, the framework then hands
the document off to the DP pre-processing steps in order to determine how
it should proceed through the VIM framework.
Figure 6-2:
BC Inbound
Configuration
architecture
Each document runs through defined process steps, which are indicated by
the inbound handler process. Each process step comprises several service
modules.
Pag e 6- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Figure 6-4:
Inbound Configuration
IMG tasks
Pag e 6- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Channels Channel IDs are maintained in order that the source of a incoming invoice
can be identified. In the case of multiple system landscape scenarios it
becomes critical to maintain Channel ID as the ID is tied to the system
determination procedure.
Pag e 6- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
For VIM, as shown in the previous figure, the ICC channel is used for those
documents which are coming in via OCR. This and the other channels are
pre-delivered. Custom Channels can be created as well.
Document Handlers A Document Handler defines the process which is used to route documents
through the incoming document process, and can therefore be linked to one
or more Channel IDs. It describes a defined order of Service Modules.
Service Modules A Service Module is essentially a grouping of logic that can be performed on
an incoming document to achieve a certain desired output. Service Modules
are grouped together via the Document Handler. Some examples of Service
Module functionality:
data mapping
data transformation
registration
archiving
validation
OpenText delivers predefined Service Modules for the VIM Capture Center
Document Handler (PS03_CAPTU) as follows.:
Registration Types Registrations are configured for each incoming document scenario. They tie
all the previously introduced elements together. The corresponding
Channel, Document Handler Module, Classification, and Document Types
must be assigned. For ICC input (and the ZVIM_ARCH Document Type),
an example Registration is available for the Early Archiving scenario. This is
shown in the next figure.
Figure 6-9:
Registration: Early
Archiving
Pag e 6- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Data Mapping Finally, the mapping of incoming data to VIM data must be done. Mapping
fields on an incoming invoice to the target fields in VIM is accomplished via
the Mapping IDs. A Mapping ID is created to logically group a mapping set
for a particular channel. A Mapping ID is then tied to that Channel.
Figure 6-10:
Mapping IDs
e-invoicing scenario
With this framework, the concept of E-invoicing can be implemented with
VIM. In this scenario discussion, the assumption is that invoices are sent to
the customer via e-mail. First, the VIM SAP system must be prepared for e-
mail input.
Pag e 6- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Preparing e-mail input Configure the Profile Parameter (Transaction Code: RZ10)
– Edit the Instance Profile with Extended maintenance
– Set the SMTP port to 25
– Check if the SMTP service is active (Transaction Code: SMICM)
Customize Service User (Transaction Code: SU01)
– Create a user with type Service and assign the profile S_A.SCON.
This is for communication.
Assign the SAP System Client (Transaction Code: SICF)
– Choose Virtual Host SAPCONNECT
– Enter the logon data of the system user
– Add CL_SMTP_EXT_SAPCONNECT to Handler List
Administer SAPconnect (Transaction code: SCOT)
– Check if the mail host is configured
– Enter the Default Domain of the SAP system client
– Define Inbound Processing (Settings -> Inbound Processing)
Initiating Workflow The start of the incoming document workflow can be triggered by specific
information that is extracted from the incoming e-mail. For example, the
type of attached document that should initiate the incoming document
workflow can be specified. If the e-mail has other documents with different
mime types attached, these documents are handled as simple attachments
to the specific work item.
Logging A couple of options exist for monitoring the activity of e-mail based input.
The first is to view logging e-mail data via SAPconnect Inbound send
requests (Transaction Code: SCOT). From the main menu, access Utilities -
> Inbox Overview. The user can also view incoming e-mail data in the IDH
table /OPT/CT_IDH_MAIL. This table data is available as input for reporting
later.
EDI configuration
The Electronic Data Interchange (EDI) scenario in VIM is based on the
standard SAP document format Intermediate Document (IDoc). IDocs allow
different application systems to be linked through a message-based
interface. The following list shows some examples of the benefits customers
garner from using IDocs.
Business documents are exchanged in a structured way in order to
process them automatically.
The various degrees of structural complexity as displayed by different
application systems can be reduced to a structure which is as simple as
possible.
– Example: The structure of an SAP application document and the
structure of the corresponding EDI message under the UN/
EDIFACT standard.
IDocs allow for extensive exception handling before the data is posted
to the application.
Incoming IDocs are often the means by which a customer utilizing SAP AP
receives some of their invoices. This can be integrated into the VIM
Process. In order to receive invoices as IDocs and subsequently trigger VIM
processing, the ALE configuration must be done along with configuration
that is specific to VIM.
Pag e 6- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Integration with VIM can be integrated with the Ariba Network from the buyer perspective. In
Vendor Invoice this scenario:
Management Suppliers create invoices within the Ariba Network
Invoices are sent to the SAP ERP system of the buyer
The buyer processes all incoming invoices within VIM
Advantages of VIM/ With the standard SAP/Ariba integration, invoices are posted or parked
Ariba Integration automatically in the SAP System. If the customer integrated VIM, they have
the opportunity to catch any invoice exceptions, handle them via the DP
workflow, and then to process them to completion.
Integration Scenarios Ariba can be integrated in different ways within the SAP Business Suite.
PI Adapter Scenario In the first scenario, an integration with the SAP NetWeaver Process
Integration (PI) in combination with the Ariba PI adapter is possible. In this
scenario, invoices arrive in IDoc format (INVOIC02) to the SAP system of
the buyer.
Figure 6-12: The Ariba Network integrated with VIM via the PI Adapter
SAP Add-on Ariba In the second scenario, it is possible to connect Ariba with the new SAP
Network Integration for add-on Ariba Network Integration for SAP Business Suite. Technically, the
SAP Business Suite invoices are sent in cXML format.
Figure 6-13: The Ariba Network integrated with VIM via the SAP Add-on
Pag e 6- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Figure 6-16:
Supplier Network
Processing
Pag e 6- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapt er 6 . B usiness C ent er Inboun d C onfigu rat ion
Summary
In this chapter we introduced Business Center’s Inbound Configuration tool.
This tool is used for configuring the system to handle incoming documents
from inception through to the trigger of the VIM system processing. We
introduced main configuration elements and also covered exceptional
inbound scenarios such as e-invoicing and Ariba invoicing.
Pag e 6- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
7. Document Processing
Objectives
Pag e 7- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Main concepts
Some of the basic concepts of Document Processing are newly introduced.
A detailed explanation of each follows.
Product Codes Product Codes delineate the VIM system according to the functionality.
These codes, when seen in the technical namespace should clue the user
or developer in to where the functionality lies or its use. The following
product codes are typically referred to:
005 - DP Document Workflow
LIX - MM Invoice Exception Workflow
IAP - Invoice Approval Workflow
Best practices for Best Practices are used to support automation and compliance and improve
document processing process control and consists of the following three features:
Logic Modules - newly introduced
Business Rules - changed in this version
Auto Post Determination - newly available
Document Types The DP document type is not the same as the SAP document type. The DP
document type controls how the scanned document is analyzed for
exceptions and routed for resolution. It also determines which SAP
transaction will be called for document creation and the fields available for
indexing. The person doing the scanning must choose the document type
when setting up the scan. If the incorrect document type is chosen, the
incorrect SAP document type and workflow will be initiated. The document
types will map to either an SAP PO invoice, an SAP Non PO Invoice, a
Credit Memo, or a Freight Only Invoice.
Pag e 7- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
5. Highlight one of the existing Document Types (this example will use the
Non PO Processing VIM16.3 (NPO_S4) Document Type) and press the
Copy as icon (two paper documents side by side).
Pag e 7- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-7:
Confirmation of copy
Additional fields in The above steps create the framework for a custom Document Type.
Document Type definition However, to affect the Document Type further, additional configuration is
needed. This is explained next.
Pag e 7- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-12: Tax and Line Item configuration for Document Types
Pag e 7- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Process Types A Process Type defines what is going to happen to the invoice based on
some criteria. It could spell out specific invoice handling, such as the
Process Type which parks the Non PO invoice in the background. Or it
could dictate exception handling. For example, if a PO is not released or is
incomplete, what does the system do with the invoice next? Essentially,
Process Types define the process flow.
Process Types will specify the Roles that are involved in the defined
process including the initial actor of the process (i.e. who executes this
portion?). Process Types also define the user’s options at this stage of the
process (i.e. Create a New PO). And lastly, Process Types define the
background set up for the Batch Data Communication interface (BDC) that
will be used in creating the resultant SAP document.
Pag e 7- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Pag e 7- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
The Characteristic check box tells the VIM system to check the
characteristics configuration before the check defined in the
process type is executed on the invoice. Baseline configuration
provides the check box as selected for the baseline process types
that need additional checks to be performed for the characteristic
configuration.
11. Press the Green check mark and then Save your entries.
Pag e 7- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Step by step: Assigning a In order to use a Process Type in the configuration for Document Type
custom Process Type to processing, it must be assigned to the Document Type. Follow these steps
a Document Type to assign your new Process Type to your Document Type.
Pag e 7- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
6. Enter the newly created Process Type into the field Default Process
Type.
7. Save your entries by pressing the Save icon.
Configuring Auto-Post In VIM 7.5 and later, there is the capability to dynamically determine
determination whether or not a Document Type is auto-posted.
Configuring Auto-post The criteria for determining whether or not a Document should be auto-
determination posted allows for the use of fields, of data, and of user input.
Figure 7-22:
The task ‘Auto Posting Determination - Data’ does not have pre-configured
values from Baseline, but does have the option to include customer specific
data. This configuration indicates which data will be used to determine
documents for auto-posting.
User Input - There is also the capability to allow the user, during indexing, to
determine whether or not a document should be Auto posted.
Figure 7-23:
Processing Logic Logic Modules are used to streamline document processing by providing a
Modules mechanism for adding or subtracting from the data that is available,
according to logical processing (code based class methods).
Business Rules Vs. Logic In the past, this was accomplished by Business Rules. Yet now, there is a
Modules clear separation. Business Rules are for checking data. And Logic Modules
are for changing data.
Pag e 7- 20 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
G_HEAD_006: Example A straightforward example of a Logic Module is one delivered with baseline
Logic Module which determines Vendor Name from the value in the field Vendor Number.
In the figure that follows, several other examples of Logic Module
functionality are shown.
Step by step: The main tasks for configuring Logic Modules are found under the VIM
Customizing Logic specific IMG, transaction code /n/OPT/SPRO. Navigate to Document
Modules Processing Configuration -> Document Type Configuration -> Logic Module
Processing.
Figure 7-25:
Step 1: Module Definition - This is the first IMG task, called Logic
Module Processing in the VIM IMG. Execute this task to display existing
Modules or to create new ones. There are many pre-delivered Modules.
A single Module is further defined by a Class Method.
Pag e 7- 22 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-28:
Step 3: Processing Mapping - This steps maps the Process IDs to the
Document Types, according to certain criteria.
Business Rules As previously mentioned, Business Rules are the set of rules that describe
the operations, definitions and constraints that apply to an organization. And
more specifically to the processing of an organization’s invoices. In VIM,
Business rules are applied to detect any exceptions before attempting to
post the invoice data to the SAP database. The Business Rules are actually
executed at the following points:
The beginning of the DP workflow
User action via the DP Dashboard
Configuration dependent points
Within the Exception Workflows
Step by step: Defining Essentially, once you have a Document Type and a Process Type, you are
Business Rules prepared to configure the Business Rules as well. It is done in the
Document Type Configuration. In this step, you define how the system
determines a Process Type for a given Document Type.
Pag e 7- 24 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Pag e 7- 26 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
4. In the Proc. Type. Det. Sequence Overview screen, select a step and
double-click Sequence Steps.
5. In this step you define, for a given Sequence Step Id, the fields that
need to be considered for validating data. This means you specify the
fields that will be checked in the business rule. You can also enter a
function module. Then you do not specify a field, but rather a step,
which will be executed for this business rule.To define sequence steps:
Populate the following fields:
Step Seq. - Enter a numeric value that identifies this step.
Field Name - Enter the field that should be considered for
evaluation.
Check Type - Instruct the system as to which method the field
should be checked by. For instance, If Table Field is selected, the
system validates that the value of the document field at runtime
exists in the check table mentioned in the Table field.
Table field - This is the check table for Check Type Table Field.
Check Function - This is the function module that is called for
Check Type Function Module.
6. Save your entries with the Save icon in the application toolbar.
Business Rules OpenText Best Practices includes the Business Rules Framework (BRF).
Framework This allows for dynamic decisions as to whether or not a Business Rule is
run for a specific scenario. With the BRF, a Business Rule can be
configured to run:
Always
Never
Periodically
Condition-based
Blind
Check-function based
Counter-based
Randomly
Pag e 7- 28 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Process Options Process Options are the available choices a user has in a dashboard. So,
for example, while coding an invoice, an AP Processor might have the
option to post a PO invoice, park a PO invoice, run the Business Rules on
that invoice, or refer the invoice for additional information to another user.
These are the Process Options for the Process Type defined as Process
PO Invoice. Typically, there are others as well. Below is a sampling of some
of the options that may be configured for processing invoices.
Figure 7-36:
Process Options
Configured for invoice
processing
Pag e 7- 30 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Step by step: Configuring In order to configure the Process Options for your Process Types, follow
Process Options these steps:
1. Type the transaction code: /OPT/SPRO into the SAP command field.
2. Press Enter.
3. Then navigate to Document Processing Configuration -> Process
Configuration -> Maintain Process Options.
Figure 7-38:
Process Options
configuration interface
Pag e 7- 32 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Document Status - Select the status set for the document if the
option is executed successfully.
Maintaining BDC The BDC ID is an SAP Business Data Communication ID. The BDC ID is
Procedures for used by the system to process an SAP transaction to create an SAP
Document Processing Document. BDC allows the user to populate data into SAP transactions
without programming, yet maintaining the integrity of the data by conducting
all application logic checks. Some advantages of using BDC IDs are:
BDC IDs are optimized for both dialog processing and background
processing.
BDC IDs can be used to set dynamic Parameter IDs.
BDC IDs can be used to configure new user collaboration actions.
BDC IDs eliminate the need to code parameterized transactions.
BDC IDs can be used to configure BDC success messages.
Pag e 7- 34 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-40:
Pag e 7- 36 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
4. There are two options at this point, the first is to populate the Custom
BDC Function field, located at the bottom of the screen. This overrides
all other values of the configuration if populated. The template to use for
defining this function module is: template: /OPT/
VIM_IF_BDC_DOCLINES_PO.
5. If you are not using a custom function module, then all of the fields in
the previous figure should be populated. In this option, you will define
the SAP transaction code, the mode for calling the transaction
(synchronously or asynchronously), and ultimately map the index fields
from the invoice to the SAP screen fields that are required by the
chosen transaction code.
6. Save your entries by pressing the Save icon.
Create your own Process Type and assign the Process Type as the
default for your new Document Type.
Pag e 7- 38 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
23. In Change mode, Change the field Default Process Type to be your new
Process Type 9##.
24. Save your entries with the Save icon.
User Process Options After testing the custom Document Type and Process Type from the
previous exercise, it becomes apparent that there is functionality missing for
the user (Role) that executes this workflow task. This is because we have
not yet defined User Process Options.
Below is an example of User Process Options that have been configured for
an AP Processor within the Process Type Process NPO Invoice.
Figure 7-43: Process Options for an AP Processor in the Process NPO Invoice scenario
Step by step: Defining In this example, the configuration will be shown for a swimlane which
User Process Options corresponds to our own example scenario. In this swim lane there are:
Roles - Examples are: INFO_PROVIDER, Z##INDEXER, and
Z##APPROC
Process Options - Examples are: Refer to Z##APPROC, Refer to
Z##INDEXER, Refer for Information, Change Document Type, Enter
Index, etc.
User Process Options - Examples are: The INFO_PROVIDER has the
ability to Refer to Z##APPROC. The swim lane follows.
Pag e 7- 40 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-44:
To configure one of the User Process Options for the example Process
Type (9##), follow these steps:
1. Type the transaction code: /OPT/SPRO into the SAP command field.
Figure 7-45:
Pag e 7- 42 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
In the previous figure, note the field named Sequence. This field
was introduced with VIM 7.0 SP3. It allows the customer to
configure the display order of the process options shown in the
dashboard.
8. To assign this Process Option to the new user, populate the From Actor
field with the appropriate Role.
9. Save your entries by pressing the Save icon.
Summary of DP So, to reiterate, each Document Type encompasses many process flows
objects (which can visually represented as swim lanes). Swimlane diagrams will
each correspond to one Process Type which needs to be configured. And
each Process Type will necessitate Process Options to be configured.
These Process Options will be subsequently assigned to each of the Roles
(user Process Options) involved in the process.
Figure 7-49:
Relationship of
configuration objects in
Document Processing
Pag e 7- 44 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
The Index screen The next component to configure in Document Processing is the Index
Screen itself. The Index Screen can be extended, depending upon each
customer’s unique requirements. Here, we will discuss how to configure the
index screen for each Document Type in the DP Process. The newly
released Index Screen has more functionality which means more
configuration.
Step by step: Configuring To configure index screen options for Document Types:
the Index screen
1. Type the /OPT/VIM_1CX1 transaction code into the SAP command
field. Alternatively, navigate to Vendor Invoice Management ->
Document Processing Configuration -> Document Type Configuration -
> Maintain Document Types.
Pag e 7- 46 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
5. For a given Process Type and Role, the following fields are explained:
Allow Changes - Select this check box for a given role to allow all
users in the role to change the index data. Prerequisite - The
document should not have been submitted, yet.
Figure 7-53: Result of Indexer Role with “Allow Changes” for the Indexing screen
Pag e 7- 48 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Enable Bypass- Select this check box to bypass the business rules.
For example, if a DP document had an Invalid Vendor (PO)
exception, the role executing this work item could bypass this rule if
the configuration was set to Enable Simulate and Enable Bypass.
Dis.Obsolete- Select this check box to hide the Obsolete button in
the DP Dashboard for the selected DP document type and the
current role (see next figure).
Dis.Rescan- Select this check box to hide the Rescan button in the
DP Dashboard for the selected DP document type and the current
role (see next figure).
Figure 7-55: Result of empty Dis. Obsolete and Dis. Rescan configuration
Show Match- Select this check box to display the matching area
within the item data subscreen for PO invoices to the user. This is
relevant to execute the matching for PO related documents based
on the SAP proposal.
Pag e 7- 50 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Index screen Header and Other than configuring the details of the index screen, the customer can
Item fields decide which Index Header fields and Index Item fields should be available.
This is done within the Document Type configuration as well. This is done in
the same dialog for Document Type Maintenance.
Global Configuration Global Configuration will affect the functionality of an entire process. These
parameters for parameters should only be changed with careful consideration. These
Document Processing parameters are housed in a configuration table of constant values.
Pag e 7- 52 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-58: Excerpt of the VIM Reference Guide - Section on WebFlow (Z) constants
Figure 7-59: Web Flow Constant table used for Global Configuration settings
VIM delivers sets of rules to control business and regulatory scenarios for
each customer. They are grouped into two distinct types. They are
Completeness Check Rules and Tax Related Rules. This is achieved by
OpenText with the Core Infrastructure and the Baseline Content.
Pag e 7- 54 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Core infrastructure We have briefly covered much of the Core Infrastructure. It includes
Document Types, Process Types, and Invoice Types. We have not yet
covered Invoice Categories. Invoice Categories are used to define the
business rules for specific invoices. Certain business rules are applicable to
only some invoices that are processed in a specified characteristic. Other
business rules need to be skipped for only some invoices of a characteristic.
The following invoice categories are supported by VIM:
Domestic - Invoices raised by vendors in the same country.
Intra-Community - Invoices raised by vendors in the European Union
(EU) to companies in the EU. Applicable only to EU countries.
Triangulation - Invoices raised by vendors in the EU to companies in the
EU for a delivery of goods or services originating in another EU country.
In this case, both the vendor and the company are in different EU
countries. Applicable only to EU countries.
Import - Invoice raised by vendors outside the company’s country.
Domestic Material - Invoices raised by vendors in India where the
Purchase Order is a Material PO. Applicable only to India.
Domestic Service - Invoices raised by vendors in India where the
Purchase Order is a Service PO. Applicable only to India.
Import Material - Invoices raised by vendors outside India where the
Purchase Order is a Standard PO. Applicable only to India.
Import Service - Invoices raised by vendors outside India where the
Purchase Order is a Service PO. Applicable only to India.
Non VAT - Invoices without VAT amount. Applicable only to China.
VAT Common - Invoices with VAT provided but the VAT amount is not
deductible. Applicable only to China.
VAT Special - Invoices with VAT provided and the VAT amount is
deductible. Applicable only to China.
Baseline Content Baseline Content is the implementation of the business rules as interpreted
by OpenText. This is pre-delivered with the product and is available as an
accelerator for companies to modify as required.This content includes:
Document types for specific processes
User interfaces for each process implementation
Screen field configuration specific to the document types
Business rules implemented for each characteristic
Specific processing is configured for the PO, NPO invoice types and for
Down Payments.
Step by step: Defining In order to define Characteristic Specific Settings for Document Types:
Characteristic settings
1. Type the /OPT/SPRO transaction into the SAP command field to
access OpenText Configuration and navigate to Vendor Invoice
Management -> Document Processing Configuration -> Document
Type Configuration -> Characteristic Specific Document Type
Configuration.
Pag e 7- 56 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
In the Details screen, are the fields which can be set according to each
characteristic. So, for a certain Document Type, for a certain characteristic
(such as country), the customer can decide how fields are populated. An
example, that is pictured in the next figure, shows that for the Characteristic
DE (Germany) for a certain Document Type (not shown), the Posting Date
should be the Date on the Vendor Invoice and the Conversion Date should
be equal to the Posting Date.
These fields should be examined to understand the effect each of them has
on the processing of the invoice. Use these fields to determine if an invoice
is a simple invoice, if it should be treated as a down payment, and what the
invoice’s baseline date is for due date calculations in the SAP system.
Pag e 7- 58 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Other Characteristic Characteristics can also be used to alter the Indexing Screen and the
specific settings Process Types. After the Characteristic Specific Attributes for the Document
Type are configured, then the other options can be traversed on the Left
Pane of the Details Screen. This is shown in the next figure.
Figure 7-63:
Other Characteristic
specific configuration
Exercise: Creating User Process Options and Changing the Indexing Screen
Create User Process Options for your custom Roles: The User
Process Options will be R90## and R91##.
Pag e 7- 60 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-64:
Pag e 7- 62 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Other Configuration Several miscellaneous configuration options are covered in this section.
options
Figure 7-66:
Duplicate Check Logic Duplicate checking is carried out after the OCR fields have been imported
and validated or when the indexer submits the manual index. The check
which is employed depends on the Document Type.
For a Baseline Non-PO Invoice Duplicate Check (KR), the following fields
would be placed in a Duplicate Check Group and then checked together to
decide whether or not two separate documents are duplicates.
Invoice date
Vendor reference number
Vendor number
For a Baseline PO Invoice Duplicate Check (RE), the following fields might
be placed in a Duplicate Check Group and then checked together.
PO number
Invoice date
Vendor reference number
Vendor number
Step by step: Defining If a user chooses to send a document to be scanned again, there should be
rescan reasons an appropriate reason attached. This will alert the scanner and provide a
level of documentation for the action taken. In order to configure Rescan
reasons:
1. Run the /OPT/VIM_1CX7 transaction.
2. Alternatively, navigate to Vendor Invoice Management -> Document
Processing Configuration -> Process Configuration -> Maintain Rescan
Reasons.
Figure 7-67:
Pag e 7- 64 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Figure 7-68:
Defining Rescan
Reasons
4. Maintain the Reason Codes, the Descriptions, and indicate if they are
required or not.
5. Save your entries.
Obsolete Reasons If the Obsolete push button is visible in the Application Toolbar (how to
affect this was discussed previously) then the reasons for marking a
document as obsolete should be configured. In order to create these
reasons, proceed as follows:
1. Type the /OPT/VIM_1CX8 transaction code into the SAP command
field.
2. Press Enter.
3. Alternatively, navigate to Vendor Invoice Management -> Document
Processing Configuration -> Process Configuration -> Maintain
Obsolete Reasons.
Figure 7-69:
Maintain Obsolete
Reasons task
Pag e 7- 66 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Ch apter 7. Do cument P ro ce ssing
Summary
In this chapter, the main concepts used in Document Processing were
introduced. Because Document Processing is the area of the system where
it is determined how an invoice will flow through the system, many
configuration tasks were introduced. This included Document Types, Logic
Modules, Business Rules, the Business Rules Framework, Process Types,
Process Options, and User Process Options.
Pag e 7- 68 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 8. Invoice Pr ocessing configu rat ion
Objectives
Reason Codes Reason codes are used in VIM to determine process flow and control. They
will effectuate where the work item (or invoice) goes and what can be done
to it for resolution.
Reason Codes delivered A sample of the PO reason codes delivered by OpenText are:
Price Discrepancy
Quantity Discrepancy
Date Block
Order Price Quantity
Project Budget Block
Manual Block
Quality Block
PO Parked Document
Non PO Parked Document
In this case, the rollout must be maintained with the correct company codes,
plants, and document types as criteria.
If Rollout criteria is not maintained here, the workflows will trigger for all
documents.
Pag e 8- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 8. Invoice Pr ocessing configu rat ion
Figure 8-2:
Event Linkages - PO The next task in the IMG for blocking configuration is the definition of Event
based Linkages.
Figure 8-3:
Event Linkages are used to affect the workflow or code which is called when
an invoice is parked or blocked.
Object Category: BO
Object Type: /OPT/B2081
Event: ZWFI_PARKED
Receiver Type: WS00275260
Receiver Call: Function Module
Receiver FM: /OPT/BL_PO_PRK_RECEIVER
Check FM: /PTGWFI/PRK_M_CHECKFM
Linkage Activated: X
The Event Linkage settings should not be changed unless the customer
wants to implement a custom Receiver Function Module or Check
Function Module.
PO Parking specific Primarily, invoices can be parked for some further processing. This
configuration includes, for example, waiting for approval, or changing some values like
vendor data, or tax data. The invoice will then be posted in a later step.
Non PO Parking Vendor Invoice Management also provides functionality for managing
specific configuration parked Non PO FI invoices (MIR4 transaction) and the exceptions therein.
Pag e 8- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 8. Invoice Pr ocessing configu rat ion
Configuring parked Parked processing within the DP Workflow is newly introduced. For this
processing scenario:
The new posting logic for VIM 16.3 is (BDC 2200).
Only invoices processed by MIRO or MIR4 are supported. FI postings in
FB60 or other FI transactions or by VIM 7.5 posting logic are not
supported.
For upgrade customers only: The Z constant 005 /
VIM_VERSION_SWITCH is not set to 700. You can configure this logic
for specific vendors.
The Z constant 005 / SYNC_ITEM_PARKED_PO should be set to X.
Trigger points Parked documents can be triggered automatically after the start of the DP
Process, by a Process Option, or by parking a document in MIRO, MIR7 or
the Fiori Managed Supplier App.
Parked and held The DP workflow can process parked and held documents.. The following
documents with a process options are available in the baseline to create or change MM
Process Option documents in dialog:
SAP related input fields in the VIM indexing screen are set to read only and
will be updated automatically when changing the SAP document in MIR4.
PO Blocking specific VIM also provides functionality for managing blocked PO invoices (based
configuration on the MIRO transaction) and exceptions therein. Invoices are blocked if
they show discrepancies. An example of this is a price discrepancy, which
would prevent the invoice from being paid.
The most important reasons are price block and quantity block reasons.
Some of the typical blocking reasons are shown in the next figure.
Figure 8-4:
Example Blocking
Reason for PO invoices
Step by step: Defining PO 1. Type the /OPT/SPRO transaction code into the SAP command field.
Blocking Reasons
2. Press Enter.
3. Navigate to Vendor Invoice Management -> PO Based Invoice
Configuration -> Blocked Process Configuration -> Blocked Reason
Maintenance.
4. Expand this menu. The following three tasks should be executed:
Block Reason Defintion
Process Option Definition
Maintain BDC Procedures
Pag e 8- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 8. Invoice Pr ocessing configu rat ion
Technical configuration
Global parameters control various aspects of the processing logic for PO
invoice parking and blocking and Non PO parking process flows. Various
global customization parameters are available.
This list is just a sampling of the options that are available for
customizing PO parking, PO blocking, or Non PO parking
This processes. Specific options exist for each of the processes and
are found in configuration, under the base menu, under the
Technical Configuration Option. Please consult the OpenText
Vendor Invoice Management for SAP Solutions v16.3.1
Configuration Guide for detailed instructions on customizing each
option.
Summary
This chapter covered specific configuration tasks for PO Parked Invoice
processing, PO Blocked Invoice processing, and Non PO Parked Invoice
processing. Reason codes were shown to be the main driver behind the
options each user has in a particular process and how the invoice will flow
from that exception and consequent user action.
Pag e 8- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Objectives
Invoice approvals
Invoice Approval (IAP) is the component of VIM that handles the approval
processes for both Non-PO based and PO based invoices. Approvals can
be handled before or after posting:
DP Approval - approvals are completed prior to posting
Posted Approval - approvals are completed after documents are posted
Features of the IAP The following are the main features of IAP.
The approval workflow is a new sub workflow; approval steps are a
technically different dialog task, separate from the DP dashboard tasks
or the other VIM workflows.
The approval workflow supports a multi level approval. For Non PO
invoices, this is achieved via configuration.
The approval workflow supports approvals inside the SAP GUI, and
outside of the SAP GUI, if the optional OpenText Approval Portal or
Mobile Approval Portal is implemented. It can also be implemented as a
Fiori app.
Parked invoice documents with the parking reason “Approval Required”
are now handled by the DP workflow.
For DP invoice documents, the approval sub workflow can be triggered
by configuring the Process Type to be Auto submit for approval or
clicking the Submit for approval option.
The approval sub workflow is completed when either the Approved
completely or the Rejected completely flag is set on the monitor table.
Pag e 9- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Posted approval Posted Approval is triggered in one of the following three situations:
A document is manually posted with a configured payment block.
A document is automatically posted from DP processing with a special
payment block.
A document is automatically posted with a specific payment block after
the requester step in the approval workflow.
DP approval For parked invoice documents: When an invoice is parked with a parking
reason that requires invoice approval, the IAP workflow gets initiated. It is
possible to delay the start of the IAP process by first sending the invoice to
the AP processor (for a manual check of the invoice) who can subsequently
submit the invoice for approval.
Approval specific This is the starting point in the Approval Process for DP Approval. We have
Process Types seen previously that Process Types are handled by the system for each
Document Type. In order to initiate the Approval Process for DP invoices,
one of the Process Types should have the workflow type of OpenText
Approval Workflow.
By default, the following Process Types are configured with auto start:
Process Type 150 - PO based invoices
Process Type 250 - Non PO based invoices
Pag e 9- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Multi level approval The main objective of the level based approval is, that each invoice in a
company is processed in an approval hierarchy, which is associated with
different approval levels. When an invoice or invoice lines are approved on
one level by one or more users, the system checks if an additional approval
level is necessary based on the limit assigned to the approval level.
With VIM 7.0, OpenText delivered a new level based approval process.
The approval processing prior to version 7.0 is still accessible as the
simple approval scenario. But, in the future, OpenText will only support the
level based approval introduced with VIM 7.0.
Highlights of level based Some of the advancements in approval processing that were introduced
approval with level based approvals are:
Approval Processing
– Approval flow is based on approval levels
– Approval can be done as header-based or line-based (sequential or
parallel)
– A pack is defined as a group of lines that are assigned to an
approver which he/she can approve; this means, the approver has
the corresponding authorizations for the cost element combination
– All lines (in line based approval) are processed within one level
sequentially or in parallel (based on the existing pack)
– Once one level is finished, the next level is processed sequentially
– Approval is complete when all packs are fully approved through all
levels
The Approver is determined in the following manner:
– Line based - according to Cost Object assignment in the COA, for
the first unapproved line, the user is found, then all approved lines
are shown within a pack
– Header based - according to Cost Object assignment in the COA,
the approver with the highest limit assignment of approvable
invoice lines becomes the approver at a header level for the entire
invoice
Amount Limit is checked in the following manner:
– Line based - Against the pack amount
– Header based (with highest pack option) - Against the total amount
– Header based (with all pack option) - Against the pack amount plus
the additional amount for unassigned lines.
Questions to answer To define a multi level approval process, the following considerations
before configuration should be made:
starts
How is the first approver identified?
Who should approve the invoice after the current approver approves
the invoice?
When is an invoice considered finally approved?
Pag e 9- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Approval flow The flow of an invoice through approval will differ depending on the type of
invoice. The next figure gives a general idea of the progression from Coder
to Requester to Approver.
Figure 9-3:
Approval flow
Figure 9-4:
Pag e 9- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
COA maintenance (OLD and NEW) requires functional users who are
aware of organizational objects involved in the Invoice Approval process.
Level based approval There are several ways to implement an approval hierarchy and approval
levels (authorized amount that an approver may approve). For Level Based
Approvals, the OpenText approval hierarchy table must be used. The NEW
COA must be configured and Approval Flow Settings (AFS) must be
maintained.
Chart of Authority (new) In the NEW COA, approvers can be different with various approval limits for
different combinations or different organizational data, which can be very
complex. The NEW COA provides an interface for maintaining all the
combinations of approvers, approval limits and coders for the Invoice
Approval process.
The data combination maintained in the COA helps to determine the correct
approver for a certain invoice (header based) or a certain set of lines (line
based) in the approval process.
Preparing to configure There are several tasks that must be completed before the COA tables can
the new COA be maintained. They are as follows:
Cost Objects for the IAP must be maintained via transaction code SM30
- table /OPT/BL_T401V.
Fields for Approval User Data must be maintained via transaction code
SM30- table /OPT/BL_T402V.
Levels required for Approval limits and Approval authorities must be
maintained via transaction code SM30 - table /OPT/AT_LEVEL (shown
below) or via the opentext™ IMG
Pag e 9- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
5. For each combination of Company Code and Approval Level, enter all
relevant fields. Some key fields that are explained here are:
Amount Limit - Enter an amount. This amount will be considered as
the approval limit. The user can approve the invoice if the amount of
a certain pack in the invoice is less than or equals the amount
mentioned in this column. If the amount exceeds this limit, the
invoice needs next level approval.
Pag e 9- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Approval Flow Approval Flow Settings are used to complete the configuration by dictating
Settings the flow of the invoice’s approval. AFS configuration consists of three main
tasks:
Step by step: Setting the 1. Start by accessing the OpenText VIM IMG, by typing transaction code
Approval Flow Settings /n/OPT/SPRO into the SAP command line.
(AFS)
2. Press Enter.
3. Navigate to Vendor Invoice Management -> Invoice Approval
Configuration -> Setup Approval Chain -> Approval Flow Settings.
Pag e 9- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Line based vs. header As illustrated by the previous figured, level-based approvals can be done in
based a line based (sequential flow) or header based fashion. Levels are defined
against approval limits.
Pag e 9- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Step by step: Mapping The second step is the mapping of approval flow settings to the VIM
AFS IDs to Document document type - The configured approval template with its approval
Types flow ID (AFS ID) must be mapped to a DP document type. Each
document type can be maintained individually. This is a mandatory
task.
Figure 9-12:
If a level based approval flow starts for a work item, the work item
will keep the AFS settings that are captured initially. Even if the
AFS settings are changed in the middle of the approval, it does not
consider the latest change.
Pag e 9- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Expense Types For one specific approver, different approval limits can be defined for
different expense types. Typical examples of expense type are:
Capital
Marketing Expense
Office Supply
Communication
Utility
The Approval Req flag is used to indicate if the expense type requires an
Invoice Approval process.
E-mail notification When an invoice is sent for approval to an agent, an e-mail can be
generated to alert that user. Approvers will receive these e-mails saying that
new invoices are waiting in their SAP inbox. If the optional Approval Portal
is implemented, the emails contain a URL link to either the portal with the
invoice iView or the invoice list page. The following is an example of a
notification email:
Pag e 9- 20 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Configuring fields for The approval screen in the SAP GUI, Approval Portal and Mobile Approval
the invoice approval Portal contains a number of fields that can be configured depending on the
screen calling application (SAP GUI / Portal / Mobile / Fiori).
Invoice detail fields Header and detail item fields along with their corresponding attributes must
be configured for the invoice detail page. This is mandatory in order to
render the fields on the Approval screen.
Step by step: Configuring 1. Type the /OPT/SPRO transaction code into the SAP command field.
approval screen invoice
2. Press Enter.
detail fields
3. Navigate to Vendor Invoice Management > Invoice Approval
Configuration > User Experience >Invoice Detail Configuration >
Maintain Invoice Detail Fields.
Figure 9-16:
For the coding fields, you must also configure all fields separately.
This configuration separates display functionality and the
functionality to read and store data back in the invoice line items,
independent of the field status on the screen.
Pag e 9- 22 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Invoice List fields Whenever invoices are displayed in a list view in the system, there are
particular fields that are displayed. This aids the agent in being able to
choose the correct item for processing or viewing. This set of fields is
configurable.
Figure 9-18:
Pag e 9- 24 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Exits Exits can be used to integrate individual screen logic in the Approval Portal
and Mobile Approval Portal. These are configured via the Web Flow
constant table as well. The following parameters should be populated with
the appropriate function module that will be called:
EXIT_INVOICE_ACTION
EXIT_INVOICE_DETAIL
EXIT_INVOICE_LIST
Button configuration Buttons can be added to the Invoice List and the Invoice Detail page of the
Approval Portal and the Mobile Approval Portal. The assignment can be
dynamic, according to the type of the invoice and the approver role.
Depending on where the button is displayed, configuration for this option
varies. This is depicted in the next figure.
Figure 9-20:
Configuring buttons
Roles
There are three main Roles in the Invoice Approval Process. They are
Coder, Requester, and Approver. The term Role is used differently here
than in other parts of VIM processing.
The roles used in the IAP process are technically different from the ones
used in all other processes. This section describes the main roles that are
required for the IAP process.
The Coder This terms signifies that the user has the capability to assign accounting
data within an invoice. This role is essentially, just an approver that has also
been granted access to code an invoice. To effectuate this, the Coding flag
is set for a user. If an invoice is parked, it will go to the Coder first. Some
typical ways for determining Coder are in the following table.
Method Details
Use Requester (Default) The Coder will the Requester of the invoice -
allows the requester to complete coding
changes
Coding validation If there are custom requirements for validating the account assignment data
on the invoice coding screens, the BAdI infrastructure can be used to
implement custom validations.
Pag e 9- 26 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
The Approver User identities are maintained in the table /ORS/USERMAP. However, this
table does not have a maintenance interface and therefore must be
maintained via the COA maintenance transaction code /OPT/VIM_7CX1
(for Simple approval).
Step by step: Configuring 1. Enter transaction code /OPT/AR_COA into the SAP command field.
the new COA
2. Alternatively run the /n/OPT/VIM transaction and navigate to OpenText
Vendor Invoice Management -> SAP menu -> Roles -> Level Based
Approval Flow -> Level Based Approval - Chart of Authority
Maintenance.
Figure 9-21:
4. Populate the tabs, according to the rules for Level based approval.
5. Save your entries.
COA upload The initial conversion of data into the COA maintenance tables can be labor
intensive. And the ongoing maintenance, perhaps an interface, might prove
to require a large amount of maintenance. For this reason, OpenText
provides a utility program which allows the customer to do an upload of data
into the New COA maintenance table.
Pag e 9- 28 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
The program can be run for a Full load - where all existing records are
removed and the new records are created via the file. Alternatively, the
program can be run for Delta load, which only updates existing records,
deletes old records, and creates new records. To access this program, type
the transaction code /n/OPT/VIM_COAUPLOAD into the SAP command
field and press Enter.
The COA Upload Report might also be used as a download utility to extract
the existing entries in the COA table.
Approver Personas The Approver Persona is determined by a set of check boxes that define
what an approver can do when approving the invoice. The access rights are
controlled by various flags that can be set for stack entries during approval
logic execution. The table for approver persona attributes is
/OPT/BL_AP_CONF.
Step by step: Editing 1. Enter transaction code SM30 or SM31 into the SAP command field.
Approver Persona
2. Press Enter.
attributes
3. Enter /OPT/BL_AP_CONF into the Table/View field.
4. Press Enter.
Pag e 9- 30 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Override In order to override the next approver, the current user should be able to
override the system-generated next approver. To do so, the process option
associated with approval must have the Override check box marked.
CoDelegate If the current coder/approver can not complete the coding, the current
coder/approver may delegate to another. To do so, the approver persona
needs to have the CODELEGATE check box selected. Some stipulations
for Delegation are:
The user must have same authorization limits as the original approver
The Delegate has effective start and end dates
Invoices are sent directly to the delegate’s Inbox
An approval audit trail log shows the delegate is acting on behalf of the
original approver
Substitution The approver or coder can set a substitute to assume their responsibility
during vacation or a time of leave. This is accomplished as follows:
From the Portal IAP:
– From the approval web page, open the User Preference page.
– Open the Substitution section.
From the SAP inbox:
– Choose Add substitute from the SAP menu.
From the User Substitute Management Utility (/ORS/MAIN_SUBS
transaction).
Pag e 9- 32 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Rejection Rejection reasons are defined for PO based invoices. The approvers are
presented with possible rejection reasons, if they are configured.
Step by step: Configuring Type the /OPT/VIM_IMG421 transaction code into the SAP command field.
Rejection reasons Alternatively, run the SM30 transaction to maintain table
/PTGWFI/Z_CONST, and locate the records with Product Code IAP and
Constant REJECTION_REASON.
Resubmit If the option for resubmitting an invoice is configured then the user can
restart the approval process for an invoice after it has been rejected.
Step by step: Configuring In order to configure Resubmit for Approval Action Codes:
Resubmit for Approval
1. Use the /OPT/VIM_IMG412 transaction code. Alternatively, navigate to
action codes
Vendor Invoice Management -> Invoice Approval Configuration ->
Approval Workflow -> Resubmit for Approval Action Code.
2. Define the Constant Value.
Pag e 9- 34 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Step by step: Approval In order to activate this functionality, a Process Option must be configured
Process Types and for Starting the Approval Process (Typically Process Option 2015). Then:
Options
1. Type the /OPT/VIM_8CX1 transaction into the SAP command field.
2. Press Enter.
3. Mark the Approval related Process Type and click User Process Option
in the navigation panel.
Bulk Approval From VIM 6.0 onwards, the bulk approval/rejection validation function
module /ORS/AINV_BULK_VALIDATE_INV provides a customer exit.
The baseline validation functionality might not meet the customer’s
requirements. A new function module can be created with the same
interface as /ORS/AINV_BULK_VALIDATE_INV.
Pag e 9- 36 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
Custom Classes
With the latest release of VIM, OpenText delivers new opportunities for
extending the solution. Classes are used for modifying or extending
standard functions. Custom classes allow the customer to create a more
robust or more customer specific solution where the Baseline can not be
utilized or configured to meet their needs. For IAP, the following classes
should be noted.
Summary
In this chapter we introduced the Invoice Approval Processing component
for VIM. This component handles the approval flow, workflow, and handling
of all invoices. It uses the concept of the Chart of Authority to allow for
determination of approvers. This chapter covers both the older method of
invoice approval, now referred to as Simple approval but focuses mainly on
the newer method, referred to as Level based approval.
Pag e 9- 38 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapter 9. Invo ice app roval configu rat ion
_________________________________________________________________________
_________________________________________________________________________
_________________________________________________________________________
_________________________________________________________________________
_________________________________________________________________________
_________________________________________________________________________
Pag e 9- 40 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Objectives
History OpenText has over 40 years of experience in providing leading edge OCR
technology. OpenText has previously offered this technology with two other
products, Invoice Capture Center (ICC) and OpenText Capture Center
(OCC). Both of these products have matured over the years to be fore
runners in the OCR space. These products currently support a multitude of
customers, some of whom process millions of pages per year.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 10- 1
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Business Center Capture With the introduction of SAP Business Center, OpenText leveraged its OCR
history and products and developed the SAP Business Center Capture
(BCC). From a licensing perspective, this product is a part of the Business
Center license.
BCC architecture
As described previously, the Business Capture Center is an OCR software
solution for recognizing various types of documents. The functionality for
recognizing the document data and for validating that data is contained in
the Extraction Service and the Validation Service respectively. These
services sit on the Business Center Capture server, and must interact with
the SAP system and the Archive. As such, it requires that each type of
incoming document is assigned certain parameters to inform the system of
how to process the document. There is also the requirement to set up
communication between these various components and the clients (such as
the Scan client, the BCC clients, and the SAP client).
Pag e 10- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 10- 3
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Figure 10-2:
Architecture of the
Business Center Capture
Manual Indexing The first option is to manually capture the data fields from the invoice via a
user who deciphers each invoice.
Pag e 10- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
OCR scenario The second option is to utilize software that recognizes fields on the invoice
and places them into the data fields that VIM requires. This is referred to as
Optical Character Recognition (OCR). OCR can be utilized to further
automate the processing of paper invoices through the SAP VIM system. In
this scenario, the SAP system serves as the backend receiving system for
storing and receiving information from the OCR software.
Business Center If a customer plans on using OCR, OpenText’s Business Center Capture
Capture for VIM (BCC) is the base product for recognition technology. Along with an Invoice
Capture Center (ICC) application, the products work in seamless
conjunction with VIM. The Invoice Capture Center application provides
automatic data extraction via OCR/IDR for invoice header and item data.
The VIM application for ICC (a.k.a invoice accelerator) is delivered with the
VIM Software and is installed on top of the BCC product.
Starting with BCC 16.3, ICC is no longer available. If you used ICC,
remove ICC, install BCC and, in addition, the BCC Invoice Solution plug-
in.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 10- 5
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Intelligent document capture recognizes not only data found on the image
but also determines which fields are needed for invoice processing in SAP
(e.g. Vendor number or Company code) by matching invoice data with SAP
master data that has been shared with the BCC/ICC system.
Pag e 10- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Architecture To show where OCR fits into overall VIM processing, the following figure is
shown. Note that enabling OCR via BCC does not necessarily negate the
need for validation to take place.
Figure 10-4:
Early Archiving Scenario The Document Handler is a part of VIM. Using services of the Document
Handler and the Registration Handler (formerly the ICC Dispatcher), all
tasks related to the following actions can be controlled:
storing documents
retrieving documents
extracting documents
validating documents
In order to understand the true flow of a document when using BCC within
the context of VIM, the scenario for Early Archiving will be dissected. Here,
we assume that EnterpriseScan is being used to first scan the document in
and store it in the Archive Server electronically.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 10- 7
Cha pter 10. C ustomizing Busin ess C enter C aptur e
1. SAP calls Enterprise Scan through the Early Archiving registration type,
using the OAWD transaction.
2. The OAWD transaction creates a registration entry in SAP using the
registration interface class implementation
/OTX/PF01_CL_REGISTER_OAWD.
3. The registration method inserts an entry to tables /OTX/PF01_T_1REG
and /OTX/PF01_T_1IMG and sets the status to Registered.
4. The document handler (periodic job for report
/OTX/PF01_P_IDF_TRIGGER) processes the required service
modules in SAP ERP and sets the status accordingly.
5. The BCC Extraction service calls the API function
/OTX/PF01_IF_GET_NEW_DOC_LIST using a scheduled batch job on
BCC side and gets new documents for processing:
Gets all documents in status Ready for OCR extraction along with
secure URL for image and XML document, which will be created by
the BCC Extraction service.
Updates the document status to Sent to OCR.
6. The BCC Extraction service picks the documents from 3 on page 84
and imports the corresponding images from the Archive.
Pag e 10- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
7. The Export module of the BCC Extraction engine calls the API function
/OTX/PF01_IF_OCR_DATA_UPDATE_N with call point EX:
Updates the status and OCR data appropriately. This API exports
the data to SAP after completion of the extraction phase. Table
/OTX/PF01_T_1EXT will be updated with extracted data.
Updates the DP Document status to Extraction Completed.
8. The BCC Extraction service sends the detailed results XML file of the
exported data to the Archive using the URL retrieved from SAP. The
BCC Validation engine uses the XML file. Results for each data
exported to SAP ERP are stored in an XML file and archived.
9. The document handler picks up the registered items with status
Extraction Completed. The document handler checks if validation is
required or not. If validation is required, the status is set to Ready for
Validation. If validation is not required, the document handler will
process the corresponding service modules and trigger the target
application.
10. The BCC Validation service calls the /OTX/
PF01_IF_GET_VAL_DOC_LIST API and gets a list of documents for
validation:
Gets all the documents in status Ready for Validation.
For each document, it gets the secure URL for image and XML
documents, which will be used by the BCC Validation Client.
11. The BCC Validation service calls the /OTX/
PF01_IF_OCR_DATA_UPDATE_N API with call point VA:
Updates the status and OCR data appropriately. This API exports
the data toSAP ERP after completion of the validation phase. The /
OTX/PF01_T_1EXTtable is updated with validation data.
Updates the document status to Validation Completed.
12. The document handler picks up registered items with status Wait for
Validation completed, and after elapsed time sets the status to Error.
13. The document handler picks up the registered items with status Wait for
Extraction completed and checks the time elapsed. If it exceeds the
configured time, the status is set to Error.
14. The document handler picks up registered items with status Validation
Completed, processes the corresponding service modules, and triggers
the target application.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 10- 9
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Figure 10-6:
The previous figure showcases the steps which are involved in the inbound
process when using ICC/BCC. The document is first registered and then
follows the steps previously outlined through to completion of the inbound
process. Note the status change with each step of the process.
Registered
Linkage created for archived document
Registered in target application
Ready for extraction
Sent for extraction
Extraction completed
Ready for validation
Sent for validation
Validation completed
Ready for the business application/process
Business application/process started
Inbound completed
Pag e 10- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
BCC customizing First, we will cover customizing within the Business Capture Center. The
client Business Capture Center deploys two client interfaces to end users. The
first, the Validation client, is used to confirm and submit recognition results
when a document is in the Ready for validation status. This is covered in a
separate chapter of the course. In this chapter, we cover the Customizing
Client, which is used for preparing the software to recognize documents.
Launching the BCC The Customizing Client is installed on the desktop for those who have the
Customizing client permission to access it.
Figure 10-7:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 11
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Once the authorized user launches the application, they find that the
Customizing client is split into two tabs:
The General tab
The Application tab
Figure 10-8:
Pag e 10- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
General tab The General tab provides the capability to monitor the Applications which
have been installed or created. On the General tab, a user can switch
between several technical views:
HotSpot
Jobs
Cluster
The General tab also shows the Recognition Server status at a global level.
It is used for the administrative tasks associated with the server.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 13
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Application tab Conversely, the Application tab allows the user to affect one application at a
time. From the Application tab, the user clicks on the Blue Paper icon and
then navigates the menu to perform the associated task. The menu of tasks
is shown in the next figure.
Pag e 10- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Invoice Applications BCC uses Applications to process invoices of certain types through the
extraction process.
An Invoice Application is a pre-defined extraction project containing a
set of rules for extraction and validation of invoice data and other
required settings.
BCC allows for several applications running in parallel on the same
BCC server.
Applications can be comprised of single countries, multiple countries, or
might be created for special circumstances.
Figure 10-11:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 15
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Creating a new In the Application menu, the option for New Application can be chosen in
Application order to create a new BCC Application. Once the user makes this selection,
they are given the choice of several Application Types.
Pag e 10- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Once the application has been created, the next step is to choose the
desired country.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 17
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Pag e 10- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
The next step is to designate how the Company Code will be detected.
There are three different methods:
A single, fixed company code for all documents of the current
application
A separate company code for each archive document type
Automatic company code detection
Once SAP connection data has been configured, the application is ready to
be created.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 19
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Continuous Self Beyond these classical OCR methods, three new adaptive methods have
Adaptive methods been developed for BCC automated learning. These are necessitated by
the nature of Business Center as a framework for manifold document
applications.
These adaptive methods learn based on manual data entry by the user.
(user feedback).
Continuous Self- Continuous Self-Adaptation can only be used in BCC applications. It uses
Adaption data collected by the Validation Client and SAP to adapt to reoccurring
document types automatically. The new CSA methods are:
Layout-unspecific Phrase Learning (LUPL)
Layout-specific Rules
Adaptive Line Item Extraction
Pag e 10- 20 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Classical: Full Text This method is the automated recognition of the complete text of an
Reading(RecoStar) incoming document.
Figure 10-16:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 21
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Within BCC, the result of a full text read is shown in the next figure.
Although the fields may or may not be mapped, they have been captured. It
also allows the user to “mouse over” any text fields for the movement of
data fields with the click of a mouse.
Pag e 10- 22 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Classical: Rule-Based This method provides for the automated extraction of structured data within
Free Forms documents of variable layout. Examples of documents which are good
Recognition(DOKuStar) candidates for this method are: Invoices, Sales Orders, and Delivery Notes.
Figure 10-18:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 23
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Classical: SnapMatch This method is for data lookup and matching of that data. The SnapMatch
automation method permits the user to match a key data field against a
database. If a matching database record can be found, all data fields
assigned to the columns of the database are then filled in automatically. For
example, this method might be used to find the Vendor ID or the Customer
ID, based on master data, such as Vendor Name or Customer Name. In
BCC, SnapMatch is used in Look Up Lists.
Figure 10-19:
SnapMatch Vendor
detection
Pag e 10- 24 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Classical: Adaptive ART is an adaptive OCR method. It is initiated by a user who trains the
Recognition Technology system by repeatedly clicking on the target data field and then choosing the
(ART) correct field in the recognized document (via Single Click Entry technology).
The ART method learns from many layout-specific samples. This is used
effectively by a power user. For example, this method would be effective in
training the system to recognize the hand written Invoice Date of a specific
vendor.
Figure 10-20:
In the previous figure, BCC uses LUPL to search for the phrase “Order
Date” and then to find the associated, formatted date field with the value
“10/24/10”.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 25
Cha pter 10. C ustomizing Busin ess C enter C aptur e
CSA: Adaptive line item Automated Learning of layout-specific rules can also be achieved for line
extraction items by collecting user feedback. In this method, the system learns to
recognize line items for specific layouts (such as a table).
The next set of figures will show an example of how a user could initiate the
Auto Table Complete Self Learning (a specific example of Adaptive Line
Item Extraction).
1. The first step is for the user to place their cursor in the first row of the
table in the left frame. They then click on the first row of line item data in
the document image.
2. The next step is to click on the TAC, Table Auto Complete button, which
will complete the line items remaining.
Pag e 10- 26 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 27
Cha pter 10. C ustomizing Busin ess C enter C aptur e
3. The table is now populated and the next document of the same
document type, which is recognized, should have the table line items
recognized and populated correctly (as shown in the next figure).
After several iterations where the user captures data, OCR will begin to
deliver the data automatically. The confidence level of the results will
increase per document. The new learning methods adapt quickly to new
Document Types and new countries.The confidence in the OCR results will
grow quickly with these new adaptive learning methods.
Pag e 10- 28 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 29
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Pag e 10- 30 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Manual validation means keying in the data that could not be extracted
automatically or which failed to run through the verification step.
Company Code detection Company Code is used as a criteria for decision points within VIM and
within SAP. In particular, it is used in determining the Vendor and the Line
Item Mapping. Therefore, it is important to be able to detect Company
Code. Some of the ways ICC supports this detection are:
1. Fixed company code for defined SAP system - If the customer has only
one company code then this setting can be used.
2. Company Code per Archive Document type - If incoming invoices are
scanned separately for subsidiaries then scan jobs can be linked to the
Archive Document Types. Every subsidiary has one Archive Document
type. This allows the Validation task to be done by the user assigned to
that specific subsidiary.
3. Automatic Company Code detection - The company code is detected by
invoice recipient address (in US: ship to address). Ship to address can
be downloaded from SAP (that is the home address assigned to the
company code) and can be used as a template to extend for address
synonyms which are also valid (consider different spelling,
abbreviations etc.). In some countries only one registered address will
be valid.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 31
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Pag e 10- 32 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Obtaining Vendor There are several scenarios concerning the Vendor on the invoice. It is
possible that the Vendor ID may or may not be detected. It is also possible
that the Vendor name appears, but not the Vendor ID. The Vendor is
necessary for posting and may be set as mandatory in the scan. The field
can be found with the aid of the invoice knowledge base or with SnapMatch
mapping to the SAP master data that has been shared with the ICC system.
It might also be deciphered via auxiliary information about the vendor, such
as telephone number, address, etc.
If the Vendor is not found via the PO data, SnapMatch technology. The
SnapMatch automation method matches a document against a database. If
a matching database record can be found, all data fields assigned to
columns of the database are then filled automatically.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 33
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Obtaining invoice For invoice amounts, there are many fields that might need to be discerned,
Amount field such as net, gross, and currency. This data might also be extracted with the
help of the invoice knowledge base or by an iterated key value search.
Logical relationships between values are used for disambiguation. This is a
mandatory field for posting and in configuration, can be hooked to a
language setting.
Several other key fields must be detected with the OCR tool. Each of these
can be discerned with the help of the knowledge base and with techniques
in which OpenText ICC Global Services has extensive experience. Some of
the other fields and key methods of detection are:
Invoice Date and Invoice Number - Iterated key value search, often
invoice date and invoice number are in close proximity
Purchase Order Number - Iterated key value search, use of predefined
syntax (01923XXXX......) or via a downloaded list of open orders
Line Items - Careful document analysis is a prerequisite to use this
customizing feature. Onwards from version 7.0, ICC will deliver line
item data, which previously had been filtered out if this option was
activated. The Line item filter is configurable. It allows for use of
Qualifying terms (or phrase lists) to identify specific line items like
material overhead, discounts, etc.
Figure 10-27:
Pag e 10- 34 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
An optimized invoice After an Application is created and recognition methods are in place, the
accelerator application first document can be processed.
Step 1: First pass of an In this first step, an invoice is sent to the application for recognition. Most of
incoming document the resultant fields are obtained via the invoice knowledge base. Three key
fields have not been detected:
PO Number
Vendor
PO Line Items
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 35
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Figure 10-29:Using TAC (Table Auto Completion) to train the invoice fields for line items
Then, they press the TAC button at the top of the interface and the rest
of the line items are automatically populated.
Now that the invoice fields are accurate, the user can submit this
invoice.
Pag e 10- 36 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
When the next invoice document is presented in this application, all of these
fields are automatically recognized. (as shown in the next figure).
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 37
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Configuring SAP for This section will cover the SAP-specific configuration for getting the BCC
BCC scenario up and running. Much of the configuration was handled in the
Inbound Configuration chapter.
Figure 10-31:
BCC/ICC Configuration
within SAP
Step 1: Set Retry Limits Every time that OCR retrieves the image and XML Document URLs for
for Extraction and Recognition/Validation, the system will increase the Retry count. A
Validation dispatcher program in VIM will monitor all such documents and check
whether any DP document is in the Extraction/Validation process for more
than the allowed time. If so it sets the status back to ready for Extraction/
Validation.
Pag e 10- 38 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Figure 10-32:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 39
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Step 2: Define New The validation framework determines whether a DP Document needs
Validation ID validation or not and assigns the validation agents to validate the DP
Document.
Pag e 10- 40 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Step 3: Assign the In the next step, the Validation ID that should be used for each Archive
Validation ID to the Document type is defined. To configure this, under the Business Capture
Archive Document Type Center Menu, choose Validation Assignment.
Assign the Type of Validation via the ID which is required for each
Document Type.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 41
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Step 4: Assign the agents The next task in the IMG allows for the assignment of an SAP user, job,
organizational unit, work center or position for validation. It is performed in
the same dialog, but in the second row in the left hand frame as shown in
the next figure.
Figure 10-35:
Agent validation
assignment
Administering BCC for As with most SAP functionality, there is some standard maintenance which
VIM is periodically required. Here, we list some of these such tasks.
Document Handler Job This job is required to be run on a recurring basis, preferably every minute.
/OTX/PF01_P_IDF_TRIGGER - When running the IDF trigger job, the
report picks up all items that have been registered to the framework and
that also have finished after the last run. So every item will go through
all steps defined in the customizing.
Download Programs These programs are used to move SAP Master Data to the ICC/BCC
Server.
Vendor Download - This program downloads vendors with all company
and bank information to a staging table. The program name is
/OPT/IR_DL_VENDOR_TO_STG_TABLE.
PO Download - This program downloads all POs and all open POs to a
staging table. The program name is
/OPT/IR_DL_PO_TO_STG_TABLES.
Pag e 10- 42 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
The next table shows the names of the staging tables that are used in the
download procedures.
Table Description
Creation of BCC users The following users must be created for interaction with the BCC Server.
Recognition Server/Node User - The Recognition Server User
communicates with the SAP system to ask for recognition jobs,
download data, and learning data. The Recognition Server and the
Recognition Nodes export results to SAP. The Recognition Server and
Recognition Node are used as a prepared SAP user for the SAP
Download Link Hot Spot and the SAP Extraction Link Hot Spot.
Customizing Client SAP User - This user is used for download and
upload of the BCC configuration to the SAP System.
BCC Validation User - As soon as the Validation user has started the
Validation Client, the user has to log on to SAP using a prepared SAP
user. This user is connected to the VALIDATOR role.
Monitoring Tool VIM is delivered with a monitoring tool for BCC. This tool can be launched
via transaction code /n/OTX/PF03_WP.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 43
Cha pter 10. C ustomizing Busin ess C enter C aptur e
BCC download programs Special programs are provided by OpenText for standalone testing, offline
for Invoice Applications scenarios and the initial load of company codes. There are programs
available for:
Vendor data download
Purchase order data download
Receiver data download
Recipient data download
Evaluating BCC Some general details that should be kept in mind when evaluating BCC as
an OCR option:
BCC doesn’t duplicate SAP business logic in an external system
BCC only uses SAP data downloads for recognition purpose
BCC does some internal logical and mathematical checks on the
invoice (check invoice amounts, check line item amounts) for
recognition purposes but delivers no check result to Validation nor VIM
BCC delivers data 1:1 from the invoice, if fields are recognized with high
reliability. If reliability is not sufficient, a field is delivered empty
BCC doesn’t apply business rules and doesn‘t modify or deduct data
BCC doesn’t complete a field, such as tax rate by calculating from
amount fields
BCC Validation does not do comprehensive checks on a field level,
except for two fields: Vendor ID, Line item mapping
VendorID: if not found, field remains empty. No address data is
delivered
Line item mapping: recognition data is completed item by item by PO
number and PO line item number – for unmapped lines PO number and
PO line item number fields remain empty
BCC incorporates Adaptive Learning Technologies which increase
recognition quickly
Pag e 10- 44 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
1. The instructor will process a PO invoice, using the newly created BCC
application (from the previous demo) and the following data:
Input Invoice: sample PO-based invoice,
PO_ACME_Supply_Invoice(US).pdf
ArchiveLink Document Type: ZVIM_ARCH
DP Document Type: PO_S4
OAWD setting: ZICC - BCC Capture Center Scenario
Data for PO invoice creation
– Materials: TG10, TG11
– Vendor: USSU01
– Purchasing Organization 1710
– Purchasing Group: 100
– Company Code: 1710
– Plant: 1710
– Storage Location: 171A
Exercise: Now that you have watched the demo of the BCC scenario,
distinguish differences in the BCC scenario (SAP-specific
configuration) compared to that of the manual indexing scenario.
1. Compare and contrast the two DP Document Types which have been
used in class.
PO_S4
ZNPO##INV
a. Which field in DP Document Type configuration distinguishes that
processing is manual or OCR?
b. Which ArchiveLink Document Type is assigned (as a default) to
each of these DP Document Types?
2. Compare and contrast the inbound configuration task Registration:
Early Archiving for these two scenarios:
ZVIM_ARCH
Z##_INV
a. What are the two different values for Channel?
b. What are the two different values for Handler?
c. What does the field Classification do?
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 45
Cha pter 10. C ustomizing Busin ess C enter C aptur e
1. The first step is to change the Indexing Type from Online Indexing to
Indexing using OCR.
This is done within the OpenText VIM-specific IMG. Transaction code /
OPT/SPO. Navigate to Document Processing Configuration ->
Document Type Configuration -> Maintain Document Types. Choose
your Document Type and then adjust the Document Index Type field
from Online Indexing to Indexing with OCR, as shown next.
Pag e 10- 46 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
Channel: ICC
Handler: PS03_CAPTU
Question: Why can the Classify field remain the same?
Figure 10-38:
Early Archiving
Registration for an OCR/
BCC scenario
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 47
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Figure 10-39:
Validation agent
assignment
Summary
In this chapter the Business Center Capture architecture, configuration, and
methods for capturing data were introduced. The invoice application (ICC)
which runs in BCC was also highlighted.
Pag e 10- 48 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 10. Cu stomizing Busin ess C enter C aptur e
ICC can be used with Business Center Inbound Configuration to process invoices. New
customers should use Business Center Inbound Configuration for email and paper.
Business Center foundation is included in the VIM license, however, BCC is licensed
separately. A VIM customer does not automatically get the BCC license. ICC and BCC
should be distinguished here.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 10- 49
Cha pter 10. C ustomizing Busin ess C enter C aptur e
Pag e 10- 50 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 11 . T he Fi ori Task A pp
Objectives
The following sections give you detailed information about the landscape,
customizing options and the interface of the Fiori Task App, which are a part
of Business Center Foundation (which comes with VIM).
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 11- 1
Cha pter 11. The Fior i Ta sk App
The Fiori Task App is a light-weight web application following the Fiori
design principles. It represents an inbox showing the a class of items that
have been assigned to the logged-in user. The user then is able to complete
items by performing dedicated actions, entering comments, and editing the
data.
You configure the complete content of the Fiori Task App by customizing
and implementing interfaces of the Web Services. Therefore no extension
points for the Fiori Task App are offered and enhancements of the Fiori
Task App or the Business Center OData service are not supported.
Fiori architecture The next figure gives an example architecture for the deployment of the
Fiori application. Fiori can be accessed either via a mobile device or via a
desktop or laptop. In either case, the device will use the SAP Gateway and
two functionality Add-ons to communicate with the back end SAP system.
Pag e 11- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 11 . T he Fi ori Task A pp
Configuring the Fiori The steps for configuring the Fiori Task App are only highlighted here. The
Task App tasks are split between technical set-up and functional configuration.
Technical set-up 1. Enable the OData Service - The Fiori Task App communicates with SAP
using a dedicated OData service (/OTX/PF05_DATA). To invoke this
service using the HTTP protocol, it must be enabled.
i. Logon to the SAP Fiori server, which has the Fiori UI
functionality.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 11- 3
Cha pter 11. The Fior i Ta sk App
Pag e 11- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 11 . T he Fi ori Task A pp
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 11- 5
Cha pter 11. The Fior i Ta sk App
2. Activating the BSP - The Fiori Task App is a BSP, which is defined on
the SAP ERP server. A prerequisite for launching a BSP is an active
service. This service is created on the Fiori Server in the SICF
transaction. For UI5 applications, the service is created by default,
nevertheless it must be activated.
a. Log on to the SAP Fiori server, which has the Fiori functionality.
Pag e 11- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 11 . T he Fi ori Task A pp
b. To activate the service, run the SICF transaction and activate the /
sap/bc/ui5_ui5/otbcwui/pf07_bc_ui service (as shown in the next
figure).
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 11- 7
Cha pter 11. The Fior i Ta sk App
Functional UI set up After technical set up is completed, the content and the visual aspect of the
Fiori Application must be set up. The area for this configuration is under the
Web Services menu in the OpenText specific IMG. This is depicted in the
next figure.
Figure 11-7:
Work Object Type - Choose which Work Object Types will be enabled
for the Fiori App
Workplace - Define which Nodes will be available for Web Services
Items - Define the behavior of the work objects of a work object type
Input helps - Allows for the definition of input help at a field level for item
or header fields. Input Help can display domain value lists, use SAP
Search Helps, or call an SAP user exit, which has a predefined function
module in the BADI /OTX/PF62_BADI_INPUT_HELP.
Pag e 11- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 11 . T he Fi ori Task A pp
Figure 11-8:
Perspectives Perspectives define which item related data is displayed in the Fiori Task
App and where. They define the content and visual appearance of items for
a specific area of the screen in the Fiori Task App. Only one perspective is
shown at the same time in the Fiori Task App.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 11- 9
Cha pter 11. The Fior i Ta sk App
Setting up launchpad For the Business Center Fiori Task App, set up the Fiori Launchpad tiles.
content
The general setup is described in Chapter 9 of the OpenText Business
Center for SAP Solutions - Configuration Guide 16.3.1. Import the
mentioned transport or configure the tiles.
Pag e 11- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
C hapte r 11 . T he Fi ori Task A pp
When setting up tiles for VIM, you need to know specific parameters for
each App. They are listed in the following table:
These Fiori Apps are specific to VIM 16.3 Classic Mode. Simple mode
apps and configuration are different and separate from these.
Summary
In this chapter the Fiori Task Application installation and configuration were
highlighted. Both technical set-up and functional configuration for enabling
the functionality in the Business Center landscape were covered. VIM
specific set up of the Fiori launchpad tiles was also highlighted.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 11- 11
Cha pter 11. The Fior i Ta sk App
Pag e 11- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
Objectives
Special topics
The Configuration covered in this chapter is optional, but might be required
for specific customer needs.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 12- 1
Cha pter 12. Option al V IM C onfig urat ion
Return to Vendor
The Return to Vendor (RTV) function allows the customer to inform the
vendor by e-mail that an invoice is being returned. (The functionality then
terminates the DP workflow and sets the DP Document to a status of
Obsolete).
Pag e 12- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
RTV e-mail The e-mail is generated based on a template that the VIM user selects. The
e-mail lists the reasons for the return and may contain additional comments.
It can also have the invoice image attached. VIM users may select several
different return reasons that are maintained in VIM customizing.
RTV configuration 1. Configure SAP Connect and SMTP: RTV uses SAP Business
Communication Services (BCS), which in turn relies on SAPConnect for
sending the emails over SMTP protocol.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 12- 3
Cha pter 12. Option al V IM C onfig urat ion
2. Assign the RTV Process Option to your Process Type: In VIM Baseline,
the new process option 2026 performs the RTV function.
Figure 12-3:
3. Maintain the reasons that the invoice might be returned for. The return
reasons are maintained in the /OPT/VIM_RTVV table.
4. Maintain the e-mail template. VIM delivers a standard text,
/OPT/VIM_RTV_EXAMPLE, which can be viewed in transaction SO10
as a template for this e-mail.
Figure 12-4:
Template
Pag e 12- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
Figure 12-5:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 12- 5
Cha pter 12. Option al V IM C onfig urat ion
Figure 12-6:
Signature text
Pag e 12- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
The signature text is made up of parameters, which are derived from the
SAP user data, as follows:
Figure 12-7:
Signature parameters
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 12- 7
Cha pter 12. Option al V IM C onfig urat ion
Pag e 12- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
PDF Log
At various locations throughout VIM, a PDF log can be created. At the
beginning of the VIM process, it is possible to create PDFs of incoming
IDocs. At the end of the VIM process, it is possible to automatically create a
PDF history log.
Figure 12-9:
All comments that have been entered at any of the process or approval
steps are included in the PDF history log file.
The PDF history log file is archived and linked to the DP document and its
SAP invoice.
If any issues occur during the creation of the PDF history log, a log
message is written to the application log for object /OPT/VIM with
subobject DP.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 12- 9
Cha pter 12. Option al V IM C onfig urat ion
To create a log, a profile must be created and that profile must be assigned
to a VIM process step. In the previous example, the following parameters
are delivered with Baseline:
Profile - HISTORY
VIM process step - VIM process is finished
Logs Logs are created in the VIM IMG /n/OPT/SPRO, then navigate to Vendor
Invoice Management > Cross Component Configuration > PDF Log >
Maintain Customizing Profiles.
Profiles Profiles are assigned to VIM process steps in the VIM IMG /n/OPT/SPRO,
then navigate to: Vendor Invoice Management -> Cross Component
Configuration -> PDF Log > Maintain Customizing Profiles.
Incoming IDocs A profile is delivered for PDF creation of incoming IDoc data.There is now
the opportunity to convert incoming IDocs into PDF files. The data is
mapped from the IDoc into the PDF document and creation can be
activated via the Business Center Inbound Configuration.
Figure 12-10:
Extended ECM The VIM integration with Extended ECM (xECM) allows for the direct
display of xECM workspaces in VIM screens. There are three different
places in VIM where an xECM plug-in can be integrated:
VIM Workplace
VIM Indexing Screen
VIM Analytics
Extended ECM for SAP Solutions can also be integrated into VIM Analytics
as a custom button that opens a separate window.
Pag e 12- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
xECM integration In order to use the xECM integration capabilities the customer must ensure
prerequisites that they have:
Vendor Invoice Management 7.0 SP5 or
Vendor Invoice Management 7.5 SP1
Extended ECM 10.5 SP1
xECM Baseline delivery Baseline delivery for this integration consists of:
Example implementation for Vendor Workspaces
Plugin for Indexing screen
Plugin for VIM Workplace
Button for VIM Analytics (7.0)
Button for VIM Analytics (7.5)
Plugin for VIM Analytics (7.5)
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 12- 11
Cha pter 12. Option al V IM C onfig urat ion
Supplier Self Service Supplier Self Service a web interface that enables suppliers to keep track of
their invoices’ status. It also shows additional information such as payment
status and SAP documents linked to the invoice (for example Purchase
Order number, Delivery Note number).
Supplier Self Service is delivered as either a Fiori App or a lean variant. The
Fiori app allows for user-based access in contrast to the lean variant which
allows for anonymous access to search for invoices via certain criteria.
Pag e 12- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
Fiori App Multiple Fiori apps are delivered for self service, user registration and
accountant access are provided.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 12- 13
Cha pter 12. Option al V IM C onfig urat ion
Lean variant The lean variant of Supplier Self Service can be deployed in a HANA Cloud
deployment or On-premise.
Supplier Relationship SAP’s SRM module can also be integrated with OpenText’s VIM
Management (SRM) component. The supported scenarios are:
Missing Goods Receipt
Quantity Discrepancy
Price Discrepancy
Features Some of the integration features between VIM and SRM are as follows:
Configurable E-mail - With the OpenText configurable e-mail
infrastructure, it is possible to compose the e-mail body and pass
attributes of a document without programming.
Configurable URL - It is possible to configure the URL which will be sent
out to the SRM user.
Configurable delay time for quantity and price block - It is possible to
configure the delay time for quantity and price blocks. After the delay
the work item will be routed to a designated agent
Determination of the SRM purchase order is configurable.
Determination of the recipient for e-mail is configurable - In the case of
the missing goods receipt scenario, it is possible to configure the
number of retry attempts that will be made to check for goods receipt
before sending the item to the designated agent.
Pag e 12- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
Configuration tasks All SRM configuration is done from the /OPT/SPRO menu under Vendor
Invoice Management -> PO Based Invoice Configuration -> SRM
Integration.
Figure 12-15:
SRM integration
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 12- 15
Cha pter 12. Option al V IM C onfig urat ion
PO Status Possible SRM Purchase Order statuses are maintained in this step. If
necessary check field "STATU" in table EKKO (e. g. TA: SE16) for
appropriate statuses, if necessary add them separated by a semicolon.
Figure 12-16:
Configuration of PO
statuses
Missing Goods Receipt The Missing Goods Receipt scenario will be covered in this chapter. Detail
scenario on configuration of the other two scenarios is contained in the VIM 16.3.1
Configuration Guide.
Process Type SRM Block process type will be maintained here. This process type will be
maintenance used to determine the Mail configuration ID and Receiver's e-mail finding
Function module. The Default Baseline Value is 162. The constant is used
to determine different attributes.
Verify that the following fields are maintained for the SRM process type:
Workflow Type - SRM System Integration
Max Retry Counter - Maximum number of retries to send the e-mail for
one PO
Retry Time (Minutes) - The e-mail will be sent again after the time
internally maintained here if no Goods Receipt is posted meanwhile.
For each time, the counter is incremented by 1.
Mail Config ID - Function Module for Receiver E-mail, for example
/OPT/S_GET_SRM_USER_EMAIL_ID
Function Module to send e-mail - /OPT/S_DP_EMAIL_NOTIFICATION
Pag e 12- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
Send an e-mail VIM Baseline contains the option ID 2740 which will enable the AP
Processor to send an e-mail to the SRM user. The e-mail text based on the
mail configuration ID must be maintained in the process option. In
configuring the e-mail, the recipient is determined dynamically and the e-
mail contents are editable.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 12- 17
Cha pter 12. Option al V IM C onfig urat ion
SRM Scenario Type SRM Scenario types will be maintained here. The default scenario is
"EXTENDED_CLASSIC". This is configured in the WebFlow Constant
Table. The Constant is SRM_Scenario_Type.
VIM Workplace The VIM Workplace is extensible according to the customer’s needs. to
provide flexibility, several templates have been provided for function module
enhancements. The following list gives an overview of all available exit
function module templates that can be used to implement extensions or
custom enhancements for the VIM Workplace.
/OPT/C_PMC_EXIT_TEMPL_BUTTON
– Purpose: Allows to skip the creation of an action button during
runtime.
/OPT/C_PMC_EXIT_TEMPL_ICON
– Purpose: Allows to influence the icon properties during runtime.
/OPT/C_PMC_EXIT_TEMPL_FLD_STAT
– Purpose: Allows to influence the properties of an output list field
during runtime.
Pag e 12- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
/OPT/C_PMC_EXIT_TEMPL_PRE_ACT
– Purpose: Runs before the action logic of a button or icon action is
executed. In the case of multiple backends, it is always called once
for all selected work items on the local system and a second time
for all corresponding work items of each backend system.
/OPT/C_PMC_EXIT_TEMPL_ACT_EXE
– Purpose: Executes the action logic of a button or an icon action.
/OPT/C_PMC_EXIT_TEMPL_PROC_RFC
– Purpose: Executes the data selection directly on each involved
backend system.
/OPT/C_PMC_EXIT_TEMPL_DISCOUNT
– Purpose: Controls the behavior of the discount light in the output
list, for example when should it switch to red, yellow or green.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 12- 19
Cha pter 12. Option al V IM C onfig urat ion
Integration with VIM can be integrated with the Ariba Network from the buyer perspective. In
Vendor Invoice this scenario:
Management Suppliers create invoices within the Ariba Network
Invoices are sent to the SAP system of the buyer
The buyer processes all incoming invoices within VIM
Advantages of VIM With the standard SAP/Ariba integration, invoices are posted or parked
integration automatically in the SAP System. If the customer integrated VIM, they have
the opportunity to catch any invoice exceptions, handle them via the DP
workflow, and then to process them to completion.
PI Adapter scenario In the first scenario, an integration with the SAP NetWeaver Process
Integration (PI) in combination with the Ariba PI adapter is possible. In this
scenario, invoices arrive in IDoc format (INVOIC02) to the SAP ERP system
of the buyer.
Figure 12-19: The Ariba Network Integrated with VIM via the PI Adapter
Pag e 12- 20 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Chap ter 12. O ptiona l VI M C onfigu rat ion
SAP Add-on Ariba In the second scenario, it is possible to connect Ariba with the new SAP
Network Integration for add-on Ariba Network Integration for SAP. Technically, the invoices are
SAP sent in cXML format.
Figure 12-20: The Ariba Network Integrated with VIM via the SAP add-on
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 12- 21
Cha pter 12. Option al V IM C onfig urat ion
Summary
In this chapter we covered configuration which is optional to the customer. It
can be leveraged to integrate VIM with BW, SRM, and the Ariba network
thereby increasing the number of scenarios where the company’s personnel
can collaborate via the VIM tool. This chapter also introduced ways that the
customer can put their own thumb print on the VIM Workplace. Finally, the
new capabilities for Supplier Self Service (SSS) and for generating a PDF
History Log was reviewed.
Pag e 12- 22 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Objectives
VIM administration
In general the job of administering the VIM system will fall under the
responsibility of the SAP Basis team. This team should be made aware of
the additional responsibilities they will assume once VIM is installed. The
tasks break down into the following categories:
Scheduling jobs
Monthly and Year End reporting
Bulk change of posting date for DP invoices
Support pack and patch maintenance
Standard SAP Workflow tasks
Figure 13-1:
Administration areas in
VIM
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 13- 1
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
Pag e 13- 2 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 13- 3
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
SAP AP processes
The OpenText Vendor Invoice Management year end procedures dictate a
procedure for allowing parked invoice processing to be carried over to the
next fiscal year. The year end procedures for parked invoice processing
must be performed at the fiscal year end.
The year end processing for parked invoices includes running the year end
programs provided by OpenText. These programs were delivered as part
of the original implementation and are already in the VIM system.
OpenText recommends that a customer runs the year end procedures for
parked invoice processing in a test environment before attempting them in
their production environment.
Fiscal year end procedures for parked invoice processing should only be
run in the production environment after the last posting period in the
previous fiscal year is closed and when no user is trying to create or
process parked invoices in the system.
Manually changing the posting date of an invoice so that it falls into the next
fiscal year during processing through a workflow or outside a workflow
process will have adverse effects on the existing workflows that are
associated with that invoice and should not be performed.
Pag e 13- 4 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Figure 13-2:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 13- 5
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
Step by step In order to use the program, proceed in the following manner:
1. Type the /OPT/DP_POST_DT_UPD transaction code into the SAP
command field.
2. Press Enter.
3. Fill in the following fields on the selection screen, in the Settings
section.
New Posting Date - This field is mandatory.
Test mode (display invoices) - This check box is selected by default.
The invoices resulting from the search are only displayed (no
change is effectuated).
Exclude empty posting dates - Select this check box only in special
cases where the posting date is not filled in and should not be
updated.
4. In the Document options section you find standard search criteria for
DP invoices.
5. To execute, un-check the Test mode field and click on the Execute icon.
Month End reporting: The month end report is a tool that is used to change the posting date for
parked invoices parked PO and Non PO documents that need changing due to a closing
period date. The following transaction codes can be used respectively:
/OPT/VIM_MEND_PO
/OPT/VIM_MEND_NPO
Year End reporting: If a document is parked in a particular fiscal year, but the processing of the
parked invoices document is not completed in that year. It is carried over to the next year. If
the posting date has to be changed, the MIR4 transaction must be used to
post it in the new posting period (FBV4 for Non PO invoices).
At this stage, the runtime workflow instance based on this parked document
will be rendered unusable as the object key of the parked document is now
changed. All of the OpenText application tables will be out of sync, as
well.Therefore, the best option is to prevent the entire scenario: Ensure that
all parked documents created in a particular fiscal year get posted in the
same year.
Pag e 13- 6 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Please see the VIM 16.3.1 Administration Guide for all the
required steps in PO and Non PO Year End Reporting Scenarios.
The transaction codes that will be used to invoke the OpenText programs
are:
/OPT/VIM_YEND_PO
/OPT/VIM_YEND_NPO
The year end procedure will also include using the month end
programs, this is described in detail in the Administration Guide.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 13- 7
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
Workflow administration
There are eight workflow templates for VIM processes, OpenText
recommends that the Administrator monitor the VIM Workflows on a regular
basis. This will ensure that problems are detected quickly and handled in a
timely manner. SAP transaction code SWI1 can be used to monitor the
following workflows:
1. WS00275269 – Document Process Workflow (from receiving the
scanned invoice info until the invoice is parked/posted or the document
is marked as obsolete or duplicates). (WS00275255 ≤ 5.1.6)
2. WS00275260 – Parked PO invoice workflow (from the time a PO
invoice is parked until the invoice is posted or deleted). This workflow is
only used in releases prior to 16.3.1.
3. WS00275264 – Blocked PO invoice line level workflow (from the time a
PO invoice is blocked for payment until it is released or cancelled)
4. WS00275266 – Blocked PO invoice header level action workflow (from
the time that a blocked invoice is authorized for header level action until
the action is completed or when AP sends back).
5. WS00275254 – Non-PO parked invoice workflow (from the time a non-
PO invoice is parked until the invoice is posted or deleted). This
workflow is only used in releases prior to 16.3.1.
6. WS00275252 – Web approval of parked invoice (from the time an
invoice is sent for web approval action until approval is completed or
invoice is fully rejected).
Linking Events for the SAP events are trigger points for VIM workflows. For example, when a
Workflows logistic invoice is posted, SAP ERP generates the event POSTED from the
business object BUS2081. The event is linked to trigger the VIM workflow
solution for blocked invoices if the invoice is blocked. Event linkages must
be created manually since VIM 6.0.
Pag e 13- 8 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Pag e 13- 9
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
How to enable the VIM In order to create these linkages, type the SWE2 transaction code into the
Workflows SAP command field and press Enter. Choose the New Entries button and
create all linkages as shown above.
Workflow activities Most companies with a large Workflow footprint employ a Workflow
Administrator. (In the event there is not a Workflow Administrator, these
tasks usually fall under the Basis Team).That role would also need to
perform the following:
Role Maintenance
User ID changes
Role Error investigation and resolution
Chart of Authority (approvals) maintenance
SAP Inbox substitutes setup
Reassigning workitems
Approval Items: Transaction Code: /ORS/UMREASSIGNED
Forwarding items
Releasing locked objects
Approval Items: Transaction Code: /ORS/RELEASE_LOCK
Table size monitoring and archiving
Workflow Transaction Some transaction codes which are helpful for the Workflow Administrator
Codes are shown in the following table:
Run other standard SAP reports Tools > Business Workflow >
Development > Reporting
Pag e 13- 10 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 13- 11
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
Troubleshooting
This section will deal with commonly faced errors when operating VIM. The
suggested approach to understanding or resolving the issue will be
presented. However, this should only be used as a guide and not a
replacement for the Configuration and Administration Guides that are
provided for the VIM for SAP Solutions software.
Role resolution Workflow is a constant thread of tasks that are linked together via the
workflow tasks and the agents who execute them. If Workflow ends up in an
Error Status, it might be that agent resolution (or the workflow determination
of who is to execute a given task) might have failed. The suggested steps to
follow are:
Step by step 1. Type transaction code SWI1 into the SAP command field.
2. Press Enter.
3. Take note of any Error workflows by populating the following information
in the selection screen:
Type: F
Status: Error
Task: WS00275270 (version 16.3), WS00275271(version 16.3),
WS00275269 (WS00275255 ≤ 5.1.6), WS00275260,
WS00275254, WS00275252, WS00275264, WS00275266.
4. Validate that this is a role resolution error. (A typical error is depicted in
the next figure.)
Figure 13-3:
Pag e 13- 12 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Workitem Role flow In this type of error, a workitem ends up in the inbox of an unexpected
agent. A workitem should flow according to the design initiated in the Swim
lane Diagram workshops. If conditions were configured in VIM to be
determined dynamically, then it is beneficial to use transaction code SWI1
to display the step by step flows and roles.
Figure 13-4:
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 13- 13
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
A very typical suggestion for a user that is having trouble is to have them
utilize transaction code SU53. This is used by a Security Consultant to
determine the missing authorization.
To use SU53, the transaction should be invoked directly after the user has
had the authorization issue.
Invoice Approvals Some of the common issues with the Invoice Approval Process and
suggested courses of action are presented in the below table.
Locked invoice object Invoice is locked for processing Use /ORS/RELEASE_LOCK to unlock the
invoice.
Approval not open User can not execute the User may not be the intended approver or
approval of an invoice. have been setup as an official substitute
Use /ORS/MAIN_SUBS to confirm and fix.
Pag e 13- 14 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
Workflow triggering If there is an issue that seems to be preventing an SAP workflow from
triggering properly, the following should be evaluated.
If sending a document to the Archive ends with an error message that says
the DS host for archive cannot be found to get the Document ID then
EnterpriseScan could not determine which Archive Server to send the
document to. The user should check the relevant log files. On the scanning
station, the file name is IXClient.log. On the Archive Server, the log file is
admSrv.log.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 13- 15
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
Archive Center log Some of the log files that can be consulted for understanding issues with
files Archive Server are listed here:
Area Files
The Application Log The application log, which is accessed via transaction code SLG1 can be
used to analyze any issues in Document Processing. The log point helps us
to locate the issue easily. Log points are configured through transaction
code /OPT/IT_LOG_PNTV. Log levels can be maintained through
transaction code /OPT/VIM_LOG_CFG.
OCR related issues If there is an issue with executing the extraction of an invoice (i.e. the
Document remains in status 01 and the application does not pick it up), then
the following can be attempted to understand the issue:
1. Run TraceViewer for detailed error message.
2. Check HotSpot Configuration to see if the service is not running or the
Hotspot is switched off.
3. Check if the Workflow task WS00275270 has not been assigned to the
archive document type.
Pag e 13- 16 V endor In voice Mana gement for SA P Solut ions A dminist rat ion
Cha pter 13. Admin istra tion and t roub leshoot ing
If there is an issue with the actual extraction results (i.e. fields are empty
and an exception is raised in SAP) then the following can be attempted to
resolve the issue:
1. Check if fields and corresponding values are being transferred to SAP
with transaction codes SE16 or SE16N. Check table
/OPT/VIM_1EXT_H.
2. Check if the the wrong documents were scanned (i.e. Italian documents
were scanned for a US application).
If the Validation Client fails during user review, then the corresponding entry
in Business Center inbound administration will have a status of 89, which
denotes: Error in validation.
The application log of a job with error status shows the more specific BCC
error code. Some examples follow:
87 - recognition errors
001 - recognition service broken
002 - empty image
005- archive not accessible
89 - validation errors
003 - unknown image format
OpenText Support
There are many avenues for obtaining support for VIM related issues within
OpenText.
Ven dor Invoice M anagement fo r S AP So lution s Admin istra tion Page 13- 17
Cha pter 13. Ad mi nistr ation and t rou bleshoot ing
Summary
Troubleshooting the VIM process is, in essence, a series of troubleshooting
all of the communication points. Communication between servers, between
processes, and between workflow agents are all common places for break
down in the flow. Use this guide as a place to start for troubleshooting and
use other OpenText resources if it proves insufficient.The administration
effort for a customer implementation of VIM is minimal but is not
insignificant. Plans should be made in advance to handle ongoing
administration duties as well as the month end and year end business tasks
that arise due to VIM.
Pag e 13- 18 V endor In voice Mana gement for SA P Solut ions A dminist rat ion