Professional Documents
Culture Documents
Installation Guide
VIM200400-IGD-EN-09
OpenText™ Vendor Invoice Management for SAP® Solutions
Installation Guide
VIM200400-IGD-EN-09
Rev.: 2021-Mar-24
This documentation has been created for OpenText™ Vendor Invoice Management for SAP® Solutions 20.4.
It is also valid for subsequent software releases unless OpenText has made newer documentation available with the product,
on an OpenText website, or by any other means.
Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Support: https://support.opentext.com
For more information, visit https://www.opentext.com
One or more patents may cover this product. For more information, please visit https://www.opentext.com/patents.
Disclaimer
Every effort has been made to ensure the accuracy of the features and techniques presented in this publication. However,
Open Text Corporation and its affiliates accept no responsibility and offer no warranty whether expressed or implied, for the
accuracy of this publication.
Table of Contents
1 About Vendor Invoice Management for SAP Solutions ....... 11
1.1 Architectural Overview ..................................................................... 13
1.2 About this document ........................................................................ 14
1.2.1 Target audience .............................................................................. 14
1.2.2 Further information sources ............................................................. 14
1.2.3 Document overview ......................................................................... 15
2 Introduction .............................................................................. 17
3 General ..................................................................................... 21
7 Patches ..................................................................................... 29
Part 2 Foundation 35
10 Installing ................................................................................... 37
10.1 Installing packages .......................................................................... 37
10.1.1 Mandatory SAP installation packages ............................................... 38
10.1.2 Optional SAP installation packages .................................................. 38
10.1.3 Optional S/4HANA installation packages .......................................... 39
10.1.4 Installation steps ............................................................................. 39
10.2 Post installation activities ................................................................. 40
10.2.1 Configuring number ranges .............................................................. 40
10.2.2 Configuring general tasks ................................................................ 41
10.2.3 Maintaining event type linkages ....................................................... 43
10.3 Installing language packages ........................................................... 44
12 Upgrading ................................................................................. 63
13.5.3.3.5 Adjusting BAdI for extended VAT date support ................................ 111
13.5.4 ACP files ...................................................................................... 111
13.6 Troubleshooting ............................................................................ 112
13.6.1 Table length restrictions for /OPT/VIM_1HEAD ............................... 112
13.6.2 Handling workflow container inconsistencies ................................... 112
13.6.3 Missing translations in line items of indexing screen ........................ 113
13.6.4 Issue with loading Fiori apps .......................................................... 114
16.3.4.1 Optional: Starting the Approval Portal J2EE application manually ..... 152
16.3.4.2 Optional: Clearing the browser cache ............................................. 152
16.3.5 Deploying the Software Component Archive with SAP NetWeaver
7.3 ............................................................................................... 155
16.3.6 Deploying the Software Component Archive using SUM .................. 158
16.4 Configuring SAP NetWeaver Portal components ............................. 161
16.4.1 Creating AppIntegrator iViews for users .......................................... 162
16.4.2 Creating AppIntegrator iViews for users with SAP NetWeaver 7.3,
7.4, and 7.5 .................................................................................. 168
16.4.3 Creating roles for users ................................................................. 178
16.4.4 Creating roles for users with SAP NetWeaver 7.3, 7.4, and 7.5 ........ 182
16.4.5 Assigning roles to SAP NetWeaver Portal users .............................. 185
16.4.6 Configuring iViews and roles for the administrator ........................... 186
16.4.7 Administering the OpenText Approval Portal ................................... 187
16.5 Applying a new patch .................................................................... 187
16.6 Upgrading the Approval Portal from previous versions ..................... 188
16.7 Troubleshooting ............................................................................ 189
16.8 Supporting installation of the standalone NWAS Portal and Mobile
Approval Portal on Unix or Linux .................................................... 189
16.9 Uninstalling the Approval Portal ..................................................... 189
16.9.1 Uninstalling using Software Deployment Manager ........................... 190
16.9.2 Uninstalling with SAP NetWeaver 7.3, 7.4, and 7.5 .......................... 191
16.9.3 Removing SAP NetWeaver Portal components ............................... 192
16.9.4 Deleting properties files ................................................................. 193
16.9.5 Optional: Removing the startup parameter in the Config Tool ........... 193
21.2.2 Deploying the application on the SAP HANA Cloud Server .............. 219
21.2.3 Installing the SAP HANA Cloud connector ...................................... 221
OpenText Vendor Invoice Management for SAP Solutions (VIM) is an ABAP add-on
solution to SAP ECC and SAP S/4HANA.
If no business rules fail, the document is posted in SAP without human intervention.
Although a straight through, no-touch process is the ultimate objective, VIM also
supports the fast and efficient handling and resolution of exceptions.
Exceptions are routed via workflow to the relevant user or user group based on the
role assigned to the exception.
• Invoice Solution
– Order Confirmation
– Delivery Note
– Quotation
– Sales Order
– Remittance Advice
Since VIM resides inside SAP, enrichments and business rules have direct access to
SAP master and transactional data, which avoids complex interfaces and the
replication and duplication of data.
Each solution offers a Workplace used by end-users and managers to manage and
monitor outstanding and completed work items. Each solution includes a
preconfigured set of analytical measures tailored for the specific document scenario.
Solutions can be enhanced to support company-specific business requirements.
VIM Solutions use features offered by its powerful feature rich Foundation.
• Inbound
• Process
• Workplace
• Analytics
VIM also supports custom solutions where a preconfigured solution is not available
for a specific, less common business process.
VIM offers a simple and intuitive user interface for end-users, managers and
administrators.
Users can choose between the classic SAP GUI or the modern SAP Fiori interface.
SAP Fiori offers a responsive web-based user interface that supports desktop and
mobile devices.
VIM supports various input channels including scan, fax¸ e-mail and web services.
It also supports various input formats, including paper, PDF, TIFF, IDoc and XML.
Document Access for SAP Solutions or OpenText Core Archive for SAP Solutions for
the storage of documents.
VIM integrates seamlessly via its Inbound component with OpenText Intelligent
Capture for SAP Solutions and OpenText Core Capture for SAP Solutions, which
uses advanced machine learning algorithms to extract metadata from imaged-based
documents like PDF and TIFF.
VIM also offers integration with OpenText Extended ECM for SAP Solutions and
OpenText Document Presentment for SAP Solutions.
Beside the components of this graphic, VIM offers additional components such as
SAP NetWeaver Business Warehouse or BW/4Hana for specific solutions which are
not shown in this basis architectural overview.
VIM features the optional component Web Invoice Approval. The target audience for
this component includes:
• Site administrators
• Database administrators
• Network administrators
• OpenText Vendor Invoice Management for SAP Solutions - User Guide for Invoice
Solution (VIM-UGD)
• OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Invoice Solution (VIM-CGD)
• OpenText Vendor Invoice Management for SAP Solutions - Administration Guide
(VIM-AGD)
• OpenText Vendor Invoice Management for SAP Solutions - Reference Guide for Invoice
Solution (VIM-RGD)
• OpenText Vendor Invoice Management for SAP Solutions - Scenario Guide for Invoice
Solution (VIM-CCS)
• OpenText Vendor Invoice Management for SAP Solutions - Security Guide (VIM-GSM)
• OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Foundation (BOCP-CGD)
• OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Solutions Beyond Invoice (BOCP-CCS)
• OpenText Vendor Invoice Management for SAP Solutions - User Guide for Solutions
Beyond Invoice (BOCP-UGD)
• Requirements
• Restrictions
• Important dependencies
• New features
• Known issues
• Fixed issues
• Documentation extensions
The Release Notes are updated continuously . The latest version of the VIM Release
Notes is available on OpenText My Support (https://knowledge.opentext.com/
knowledge/cs.dll/Open/10151494).
Vendor Invoice Management for SAP Solutions consists of different solutions for
your business processes. You do not only have management solutions for invoices,
but also for sales orders, remittance advices, delivery notes, quotations or order
confirmations.
Depending on the solution and on the features that you want to use, you have to
download different components and install them on your system.
This guide bundles the information about installation steps and available setup files
into three areas:
1. Foundation
2. Invoice Solution
3. Solutions Beyond Invoice
Depending on the solution that you plan to install and on the features that you want
to use, different areas of the guide are providing the information that you are
searching for.
Foundation
The Foundation bundles information that is valid for all your installations, no matter
which solution you are planning to install.
The mandatory installations that are listed here, must be installed. You cannot set up
a running system if these installations are not completed.
The installations that are marked as optional in this area depend on your
environment or the features that you want to use:
• If you want to set up an integration with Extended ECM, you must complete the
Extended ECM installation.
• If you want to use embedded Analytics you must install the package.
Invoice Solution
Invoice Solution bundles a number of packages and components that are all relevant
if you want to use the invoice solution.
You must only read this section if you plan to use the invoice solution.
Just as the foundation, invoice describes mandatory installation packages that are
relevant for further additional components.
1. Order to Cash consist of the solution for sales orders and remittance advices.
2. Procure to Pay consist of the solution for delivery notes, quotation and order
confirmation.
You must only read this section if you plan to use one of the listed solutions.
Caution
The following information is very important. Read the table carefully
before the installation.
Caution
If you are performing an upgrade and you have several VIM components
in your system (this may include former Business Center components), all
components must be upgraded at the same time to prevent errors because
of dependencies.
The component structure has been partially reorganized in VIM 7.6 / 20.4.
To aid you in identifying the components, information is provided on the
structure changes in “Upgrading“ on page 63 for VIM Foundation and
Solutions Beyond Invoice and in “Changes in VIM Invoice Solution
component structure” on page 98 for Invoice Solution.
Important
Make sure the SAP workflow system is configured to run workflows. To check
this, run the SWU3 transaction. Make sure most of the relevant items are
configured correctly, indicated by the icon. It is very important that, in the
Note: Check for and download the available latest support packs and hot fixes
on OpenText My Support.
Check the latest version of the Release Notes for any version support and
prerequisites.
Prior to installation, check the following prerequisites. For more information about
the overall system landscape, see “System landscape” on page 48.
SAP support Check the latest version of the Release Notes on OpenText My Support for required
packages support packages for the employed SAP system.
SAP Notes Check the following SAP Notes to avoid known problems with the SAP Add-On
Installation Tool (SAINT):
– SAP Note 2767228 : ODATA: Date variable value help throws an error
– SAP Note 2415249 : Using SAP Analytics Cloud as Client for SAP BW queries
on BW 7.50
OpenText prerequisites
Document Archived documents are displayed with the viewing application installed on your
viewer desktop. On your mobile device, they are displayed according to Mime type and
ArchiveLink settings. Alternatively, they are displayed and rendered into PDF with
the OpenText Imaging Web Viewer (Web Viewer) or OpenText Brava! View for SAP
Solutions (Brava! View) if it is installed and configured.
To support the document view in plug-ins for Mime types where no HTML-based
plug-in is installed, Web Viewer 10.0.0 or Brava! View 16.0 is required as a
minimum. OpenText strongly recommends using Web Viewer with the latest patch.
You can download the corresponding software from My Support.
Desktop iPad/iPhone
Web Viewer / Web Viewer / No Web Viewer / Brava! View
Brava! View on Brava! View off support[a]
Display variant Inplace Inplace New tab
PDF Web Viewer / Acrobat plug-in Built in
Brava! View
XLS Web Viewer / Not supported Built in
Brava! View
PPT Web Viewer / Not supported Built in
Brava! View
DOC Web Viewer / Not supported Built in
Brava! View
Others Web Viewer / Not supported Not supported
Brava! View
[a]Web Viewer or Brava! View may be used in custom solutions to convert the ArchiveLink document in
a PDF for displaying it on an iOS device.
Integration You can integrate the VIM Foundation into other OpenText solutions, like the Fiori
Business Object Browsing for Document Access and Extended ECM for SAP
Solutions solution accelerator. If you do so, make sure to check dependencies and
compatibility.
Recent For more information, download the most recent product documentation, release
information notes and patches description released on My Support.
Vendor Invoice Management for SAP® Solutions uses the SAP Add-On Installation
Tool (SAINT) for installation.
On the ISO image or ZIP archive of the product, the single PAT files are archived in
SAPCAR files (extension *.SAR). You can extract SAPCAR files with the SAPCAR
command line tool.
SAINT uses single PAT files (extension *.PAT) which integrate several transport files;
these collections are also called packages.
The OpenText Vendor Invoice Management packages are protected with specific
passwords. During installation, passwords are requested by SAINT. You find the
passwords in this guide, in the chapters on the respective components.
Patches Patches (Hot Fixes), Support Packages and the latest versions of the Release Notes
for VIM are available on OpenText My Support.
For information about all OpenText products resold by SAP (including VIM
and ICC), check SAP Marketplace Note 1791874: SAP Products by OpenText -
Software and Support Lifecycle. This note provides detailed information about
software life cycle, access to Support Packages, access to latest documentation,
language packages, and other patches, as well as Support ticket handling.
Some steps of the installation and upgrade procedures make use of transports. These
transports have been created in the OpenText development or packaging systems.
These systems do not have the same components and component versions as your
systems. So, when the transport is imported, you must select the Ignore invalid
component version check box.
The following knowledge is required for the person dealing with the installation as
described in this document:
This section describes the installation of the VIM packages on an SAP application
server. For general information about installing in an SAP environment, see also
“Prerequisites for installation” on page 19.
Notes
• Customers who purchase VIM from SAP receive the packages from SAP
Marketplace.
• Customers who purchase VIM directly from OpenText download the
packages, including installation packages, from OpenText My Support.
2. Load the installation packages and support packages from the front end by
selecting the respective SAPCAR file (*.SAR) from the local file system. The
SAPCAR file is decompressed automatically.
3. Carry out the import of the packages and support packages as described in the
SAP documentation.
4. After the import has finished, continue with the activation of the BC sets. For
more information, see:
You can bypass messages you might get during installation. These warn you
about not digitally signed packages/software.
OTBCBAS
OpenText Process Base.
Mandatory for the whole VIM installation
OTBCSL00
OpenText VIM Solution Base. Mandatory except in case where the product is
installed not on SAP ECC and SAP S/4HANA but another type of SAP
Netweaver system
OTBCWUI
OpenText Process Fiori Base.
Needs to be installed if VIM Fiori apps are used
OTBCRM
OpenText Extended ECM integration.
Needs to be installed if the integration between VIM and Extended ECM is used
(OpenText Extended ECM for SAP Solutions is installed – for details check the
Release Notes for Foundation of Vendor Invoice Management for SAP
Solutions)
For details about the components, see Section 3.1 “Analytics and SAP S/4HANA
Backend System” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Solutions Beyond Invoice (BOCP-CCS).
OTBCS4
OpenText VIM S/4 Base.
Needs to be installed if the basic embedded analytics capabilities is used.
1. Install the OpenText Process Base (OTBCBAS) add-on using the SAINT
transaction.
Notes
3. Optional If you want to use the Fiori Task App, install the OpenText Fiori Process
Base Web UI (OTBCWUI) add-on using the SAINT transaction on the system that
you want to use for the Web UI.
• Install the OpenText VIM Extended ECM Integration (OTBCRM) on the same
system as the OpenText Process Base (OTBCBAS) add-on using the SAINT
transaction.
Install the OpenText VIM S/4 Base (OTBCS4) using SAINT transaction.
/OTX/PF01
Document registration
/OTX/PF02L
Default number range for process ledger entries. You can also replace this by a
solution specific number range object; see the end of this section.
For both objects, create a number range interval 01 with the following attributes:
Instead of using the default number range object for every solution or for your
custom business solution, you can also configure a solution number range object and
interval.
The delivered solutions refer to the unique number range object /OTX/PF02. All
documents in the process use the same number range.
To configure a custom number range object for each solution, you can copy the
standard number range object. You need to assign it to the related data model of the
Process Foundation. For details, see Section 6.2.3 “Maintaining level key fields” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Foundation (BOCP-CGD).
The Process Foundation allows to control running workflow instances from external
applications by using some special event type linkages, which you must maintain in
the SWETYPV transaction. This refers to the following events and settings:
Field Setting
Event • FINISH_PROCESS
• INIT_PROCESS
• RUN_ASSIGNMENT
• RUN_CATEGORIES
Field Setting
Linkage Setting (Event Receiver) Receiver Call
Function Module
Receiver Function Module
/OTX/PF02_EVENT_RECEIVER
Event delivery
Using tRFC (Default)
Linkage Activated
Activate checkbox.
Behavior Upon Error Feedback
3 Do not change linkage
Receiver Status
0 No errors.
1. ABAP translation
2. Fiori translation
For the OTBCWUI add on installation package, the Fiori translation is delivered in
OTBCWUI_0740_006_I18N.zip. Import the transport into the system where
component OTBCWUI is installed (frontend system).
The ABAP translation is delivered in language packages. You find the language
packages on My Support in the folder of the respective support package.
You must import language packages for the relevant add-ons. For Vendor Invoice
Management Foundation and Solutions Beyond Invoice, language packs are
available for OTBCBAS, OTBCSLOC and OTBCSLPP which include all supported
languages.
3. Select the language, and the click the Import package button.
5. Select the .SAR file that was delivered for the language and the solution.
Tip: This step is skipped, if the .SAR file is already decompressed in the
server directory.
6. Carry out the import of the language package as described in the SAP
documentation.
When the import is finished, all translations for the selected languages are
imported into Client 000.
7. Select the language, and then click Menu Language > Special Actions > Client
Maintenace.
Note: If the old translation displays after you imported the translation, try
to refresh the translation of the language at runtime.
Run the RSLANG20 program for the selected language, and then run the
following transactions:
• /$CUA
• /$DYN
The settings described in this section are only relevant if you want to use the Fiori
Task App.
* OTBCSL33 add-on, which is listed in the graphic is not relevant for the invoice
component of 20.4.
The Fiori Task App of Vendor Invoice Management for SAP Solutions comes with
the OpenText Process Fiori Base (OTBCWUI add-on). This add-on requires the SAP
component SAP_UI. For detailed system requirements, check the Release Notes.
The WebUI retrieves data from the technical service /OTX/PF05_DATA comes with
the OpenText Process Fiori Base (OTBCWUI add-on ). The activation of this service is
described in “Enabling OData service” on page 56.
The /OTX/PF05_DATA service is part of the OpenText Process Base (OTBCBAS add-on).
This add-on requires the SAP component IW_BEP or SAP_GWFND. For detailed system
requirements, check the Release Notes.
Note: The protocol for Launchpad access (typically HTTPS) must be the same
for archive access.
The Fiori Task App of VIM comes with the VIM WebUI (IZIP file PF07_BC_NEO_
UI_<version>.zip).
For a detailed description of installing the ZIP file in your SAP Cloud Platform
account, as well as the necessary steps for configuring the destinations with your
SAP Cloud Connector, see “Installing the VIM UI on SAP Cloud Platform Neo
account” on page 51. For product limitations connected with the SAP Cloud
Platform Deployment Option, see the dedicated Release Notes.
OpenText recommends the following installation procedure, to ensure that you can
run multiple VIM UI applications in parallel against different backends. The general
idea is to use one sub-account as provider (where the application becomes installed)
and one or more other sub-accounts (under your global account) that subscribe the
VIM UI application from the provider account (called consumer in this procedure).
With that mechanism, the application is only patched at one place and becomes
distributed from there.
The description assumes that you run the SAP_GWFND (SAP Gateway Hub)
component on your backend. If you are using a dedicated frontend server, the
procedure is the same, but the system that becomes connected with the Cloud
Connector is the frontend server.
1. Configure principal propagation: setup trust between the backend and SAP
Cloud Connector; map platform users to SAP system users. For more
information, see the SAP Help: SAP Cloud Platform Connectivity: “Configuring
Principal Propagation”.
a. On the SAP Cloud Platform Cockpit, expand the Applications node, and
then click HTML5 Applications. Using Import from File, import the
OTBCWUI_NEO_0740_006.zip file.
Name BC_PF05_DATA
Type HTTP
Description
Location ID
URL http://<virtual_host_name>:<port>/sap/opu/
odata/OTX/PF05_DATA;mo;v=3;
Proxy Type OnPremise
Authentication PrincipalPropagation
Name BC_ARCHIVE
Type HTTP
Description
Location ID
URL http://<virtual_host_name>:<port>
Proxy Type OnPremise
Authentication NoAuthentication
Important
Take exactly this name, as the content for the Fiori Launchpad Site
refers to this name.
e. In the list of Subscribed HTML5 Applications, click the Application link
to maintain the required destinations.
This concept enables you to instruct the Fiori Task App to fetch the data from a
dedicated backend system. You provide the configured backend system alias in the
front-end server as a URL parameter: &system=<SYSTEM_ALIAS>. This allows you
to connect different backends with one front-end server.
The same system alias has to be configured for the /OTX/PF05_DATA OData service .
It is not possible to run the app without system alias configuration.
Prerequisite All connection settings must be configured accordingly and the SAP NetWeaver
Gateway must be activated.
Therefore you might need to connect to the backend system where the OTBCBAS add-
on package is installed according to your system landscape setting
After that you must activate the registered service. To activate the service, run the
SICF transaction and activate the /sap/opu/odata/OTX/PF05_DATA service.
The OData service classes (OTBCWSR add-on) can be installed on several backend
systems. In this case, you can configure the service at the gateway system in a way
that data from multiple of the backend systems is requested.
You can perform this using Multiple Origin Composition (MOC). For detailed
information, see the SAP Help.
With regards to MOC, the Fiori Task App provides the additional parameter system
to define which system should be used. If the parameter is not set, the system alias
LOCAL is used.
Important
If several systems are connected, you must set the OData service to error
tolerant, using the following path: SPRO > SAP NetWeaverGateway > OData
Channel > Composition > Flag OData Services to be error tolerant in case of
MDC. If not all users exist in all connected systems, consider using the SAP
“User Role” concept to control the backend system that the users connect to.
To activate the service, run the SICF transaction and activate the /sap/bc/ui5_ui5/
otbcwui/pf07_bc_ui_03 service.
Customizing transports contain the Fiori perspectives for the VIM Foundation and
SAP Solutions Beyond Invoice components.
11.4.3.1.1 Transports
You can access the transports on My Support: Import these transports into the
frontend systems where the OTBCWUI add-on is installed
/OTBCWUI/PF07_BC_ADMIN
Perspective Manager
Foundation
/OTBCWUI/PF07_BC_FOUNDATION
Stores and archives documents and triggers VIM Inbound
Solutions
/OTBCWUI/PF07_BC_SOL_DELIVERY_NOTE
Solution for incoming delivery notes
/OTBCWUI/PF07_BC_SOL_ORDER_CONF
Solution for incoming order confirmation
/OTBCWUI/PF07_BC_SOL_SALES_ORDER
Solution for incoming sales order
/OTBCWUI/PF07_BC_SOL_REMITTANCE_ADV
Solution for incoming remittance advice
/OTBCWUI/PF07_BC_SOL_QUOTATION
Solution for incoming quotations
With the delivered launchpad content, also a system alias for the multi origin access
is predefined in the service URL. See <Node parameter> in Section 10.1.1 “Integrating
Fiori Task App into Fiori Launchpad” in OpenText Vendor Invoice Management for
SAP Solutions - Configuration Guide for Foundation (BOCP-CGD). You must use the
system alias OTBCWUI_BACKEND and configure it for the delivered launchpad content
according to your system landscape in the SAP IMG Manage SAP System Aliases.
Tip: If you want to use a differnet system alias then the delivered OTBCWUI_
BACKEND you have to change each semantic navigation configuration besides
the launchpad content . For more information, see OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Foundation (BOCP-CGD).
• Foundation:
For more details, see OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Foundation (BOCP-CGD).
Upgrading
Integration You can integrate the VIM Foundation into other OpenText solutions, like the Fiori
Business Object Browsing for Document Access and Extended ECM for SAP
Solutions solution accelerator. If you do so, make sure to check dependencies and
compatibility.
Important
Several components of the Foundation are now included in
OTBCBAS (OpenText Process Base). If the OTBCINB, OTBCWSR or OTBCFND
components are installed on your system, no action is required. These
components are now included in the OpenText Process Base package.
Mandatory activities
After upgrading, you must process the following activities manually:
This part describes the installation of the SAP components of Vendor Invoice
Management (VIM) - Invoice Solution.
Note: Compared to VIM 7.5 and VIM 7.6, some software components have
been restructured in VIM 16.3 and VIM 20.4. If you are performing a new
installation and you know VIM components from a prior installation, make
sure to review “Changes in VIM Invoice Solution component structure”
on page 98.
SAP S/4HANA
Note: For a list of all currently supported combinations of VIM versions and
SAP products, see SAP Note 2339256 (https://launchpad.support.sap.com/#/
notes/2339256).
Fiori frontend version – If you want to use the VIM Fiori apps, check the supported
SAP UI versions in the release notes for VIM Foundation.
Core Invoice Solution scenarios, including inbound and Fiori apps, are delivered
with the component OTEXVIM. The component OTBCSL30 provides objects shared by
Classic Mode and Simple Mode of Invoice Solution.
The components that are required for each scenario are marked in “Invoice Solution
components depending on scenario” on page 68. The different components do not
necessarily have to be installed on the same server. For more information, see
“Architectural Overview” on page 13.
Additional,
Core, Inbound
Component Description depends on
and Fiori
scenario
OTEXVIM Invoice Classic x x
OTBCSL30 Invoice Base x x
Ariba Integration using Cloud
OTVIMARC x
Integration Gateway
OTVIMBW BW Invoice Component x
OTVIMBW4 BW/4 Invoice Component x
OTVIMGW Invoice 3s Gateway x
OTBCSL38 Invoice eDocument Connector x
1. Collect the installation files for the components listed in “VIM components -
installation files” on page 69.
Notes
• Customers who purchase VIM through SAP receive the packages from
SAP Marketplace.
Note: The Business Center-based packages existing prior to VIM 20.4 have
been reorganized:
3. If upgrading from VIM 16.3 SP3, SP4, or SP5, you may want to use delta BC sets
instead of full BC sets. You can download delta BC sets from OpenText My
Support under Resources > Patches > Vendor Invoice Management >
OpenText Vendor Invoice Management 20.4 > Invoice Solutions > Additional
Components. Download the file that corresponds to your source VIM version.
For more information, see “Activating business configuration sets”
on page 110.
To install packages:
1. Locate the component SAR files on the installation media in the folder Software
\Invoice Solution\ABAP Addons. In the SAINT transaction, load the .SAR files
from the front end. Alternatively, extract the .PAT files from the .SAR files and
put the .PAT files into the application server transport directory \usr\sap\
trans\EPS\in.
2. Add the support packages to the queue, using the same procedure. Adding
support packages at this point saves time and is a safer variant of the
installation.
3. Carry out the import of the packages as described in the respective SAP
documentation.
5. Continue with the post installation steps. For more information, see “Post
installation activities” on page 73.
You find post installation transports on the installation media / package under the
path Software\Invoice Solution\Postinstall.
Parameters for When setting up tiles for VIM, you need to know specific parameters for each Fiori
manual configu- Task App. They are listed in the following table.
ration
Due to limitations of BC set technology, the entries are not correctly entered in the
table when the BC sets are activated. Therefore copy the transport Q02K900040 into
the transport directory and install the transport using STMS. You must install the
transport to every client because the transport contains client specific data.
Notes
1. Activate Foundation (Process Base and Solution Base) BC sets. For more
information, see:
Tips
• You can ignore any warnings during the activation. If you get an
error during activation of a BC set, then activate it again. In many
cases the error will disappear. You can ignore activation errors like
2. In the Task type field, select Standard task, enter the task ID and click the
button.
3. In the Standard Task: Display screen, select Additional data > Agent
assignment > Maintain.
4. In the Standard task: Maintain Agent Assignment screen, select the name of
the assignment and then click the Attributes button.
5. In the Task popup, select General Task and click the Transfer button.
The standard task is now configured as a General Task.
If you are prompted to create a new transport, continue with the next step.
If you are asked if you want to Transfer missing elements from the object
method?, click No.
7. Repeat the procedure for all the tasks mentioned in Table 13-3 on page 77.
2. Enter SGOSATTR in the Table/View field and click the Maintain button.
3. When a dialog box is displayed, indicating that the table is cross client, click the
button.
4. Add the entries for the service WF_ZOPT/VIM, as shown in the following
screenshot.
Object Description
/PTGWFI/RI CP Document
/OPT/DOCID Document Processing
/ORS/STACK Invoice Approval
/ORS/USRMP Invoice Approval Usermap
Important
All the number ranges intervals must be 01.
2. Enter the object name from the table above, for example /OPT/DOCID and click
the Number ranges button.
Note: The entries should have been installed by the activation of the BC sets.
But you have to activate the linkages and switch on the event queue. If an entry
is missing, add the entry.
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.
In case of not properly raised parking events, perform the following actions:
2. To schedule the Event Queue Job, run the SWEQADM transaction. You can
set the frequency according to your requirement how often to update the
respective data.
The following event linkages can be turned on or off to enable or disable VIM
workflows:
TS00275270 —
BUS2081 DELETED SWW_WI_CREATE_VIA_EVENT IAP
TS00275270 —
TS00275270 —
BUS2081 POSTED /OPT/BL_PO_BLK_RECEIVER Invoice
Exception (IE)
TS00275264 /OPT/BL_PO_CHECK_ROLL_OUT Posted
Approval
/OPT/FIPP ZWFI_ /OPT/BL_NPO_PRK_RECEIVER IE
CREATED
/PTGWFI/PIR_F_CHECKFM
WS00275254
/OPT/B2081 ZWFI_PARKED /OPT/CL_C_BAPI_MM_PARK_HANDLER Parked
processing
VIM_PARKED_ —
DP
FIPP DELETED /OPT/VIM_RPT_RECEIVER_FM VIM Analytics
(VAN)
— —
FIPP POSTED /OPT/VIM_RPT_RECEIVER_FM VAN
— —
BUS2081 DELETED /OPT/VIM_RPT_PO_INV_RECEIVER VAN
— —
BUS2081 POSTED /OPT/VIM_RPT_PO_INV_RECEIVER VAN
— — May be used in
special
situation.
Should be
inactive in
standard
configuration.
BUS2081 RELEASED /OPT/VIM_RPT_PO_INV_RECEIVER VAN
— —
BUS2081 CANCELLED /OPT/VIM_RPT_PO_INV_RECEIVER VAN
— —
/ORS/INVAP POSTED /OPT/AAFS_POST_RECEIVER Posted
Approval
— —
Note: There is a dependency between two entries for Object Type BUS2081 and
Event POSTED, the one with Receiver Type TS00275264, and the one with an
empty Receiver Type.
In transaction SWETYPV, make sure that only one of these event linkages is
activated.
• If you use your own blocking workflow, activate only the event linkage with
empty Receiver Type. This event linkage ensures that VAN will be correctly
updated.
• If you use the standard blocking workflow template, activate only the event
linkage with Receiver Type TS00275264. This event linkage updates VAN
with the same function module as the other event linkage but it also starts
the blocking workflow.
1. To open the Event Type Linkages screen, run the SWE2 transaction.
2. Create the event linkage entries shown in “Event linkages for VIM workflows”
on page 84 (if not already existing) by clicking the New Entries button.
To edit an existing event linkage entry, double-click the entry.
3. To enable the workflow, select the Type linkage active check box.
To disable the workflow, clear the check box.
4. Save your changes with a transport and move this transport to subsequent
systems.
Note: Repeat the procedure for all event linkage entries shown in “Event
linkages for VIM workflows” on page 84.
4. Enter values in the required fields. In Form Name, enter SYSTEM, and in Target
Form, enter /ORS/SAPSCRIPT.
5. To submit, click .
If you are asked for a package, enter /ORS/000007.
• /OPT/VIM_RTV_EXAMPLE
• /OPT/VIM_SIGNATURE_RTV
Note: To copy the text in all languages at once, you can use an asterisk in
the Language field.
3. Enter values in the required fields. Text Name and Target Name must be the
same.
Click .
6. Repeat the steps for all standard text shown in the list above.
1. Run the SU01 transaction and open the user WF-BATCH (or SAP_WFRT) in edit
mode.
Note: Use O like Oscar in FO3. Note that there is a blank in front of the
parameter value 2. The 2 is the second character.
• Regarding online posting using the MIRO transaction and Enhancement Points,
see Section 8.11.3 “Enhancing MIRO for pre-population of data during online
invoice creation” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Invoice Solution (VIM-CGD).
• Regarding the configuration of BAdIs for invoice processing, see Section 8.9.1
“Activating BAdI for invoice processing” in OpenText Vendor Invoice Management
for SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD).
Use transaction SE19 to check the runtime behavior of the BAdIs. The following
are the standard values:
To maintain BTEs:
2. On the Process BTE: Partner Enhancements screen, add the following entries
for process 00005010:
Process
00005010
Function Module
/OPT/BTE_IF_00005010
Partner
/OPT/
Product
/OPT/VIM
Process
RWBAPI01
Function Module
/OPT/BTE_RWBAPI01_BAPIEXTN
Partner
/OPT/
Product
/OPT/VIM
1. The Fiori Task App communicates with the ABAP backend using a dedicated
OData service (/OTX/PS33_DATA_SRV). To invoke this service using the HTTP
protocol, activate it first on the Gateway Frontend Server. For VIM 16.3, you
need to set up the version 0003 of OData service in the /IWFND/MAINT_SERVICE
transaction. The activation has to be performed like the activation of /OTX/
PF05_DATA. For general information, see “Enabling OData service” on page 56.
The general setup is described in Section 10.1.1 “Integrating Fiori Task App into
Fiori Launchpad” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Foundation (BOCP-CGD). Import the mentioned transport or
configure the tiles.
The tiles are also delivered in the installation package / media under path Software
\Invoice Solution\Postinstall: invoice solutions-launchpad content.zip.
The following Fiori tile catalogs are delivered. You can assign them to the related
role used in the corresponding business scenario.
/OTBCWUI/PS30_VIM
Vendor Invoice Management
/OTBCWUI/PS08_IM_SIMPLE
Vendor Invoice Management (Simple Mode)
/OTBCWUI/PS34_VIM
Vendor Invoice Management - Supplier Self Service
/OTBCWUI/PS34_VIM_ACC
Vendor Invoice Management - Supplier Accountant Perspective
Parameters for When setting up tiles for VIM, you need to know specific parameters for each Fiori
manual configu- Task App. They are listed in the following table.
ration
The VIM Supplier Self Service Registration UI for SCP is delivered in ZIP file neo-
invoice solutions_otusrregui.zip, available in the installation package/media
under path Software\Invoice Solution\Postinstall.
For more details, see “Installing the VIM UI on SAP Cloud Platform Neo account”
on page 51.
Download the correction instruction from OpenText My Support under Resources >
Patches > Vendor Invoice Management > OpenText Vendor Invoice Management
20.4 > Invoice Solutions > Additional Components, and perform the steps
described in the document.
Note: Leaving the rollout criteria empty will trigger VIM workflows for all
company codes, plants, or document types. Therefore OpenText recommends
that you restrict the rollout criteria accordingly. For more information, see
Section 4 “Defining rollout criteria for parking and blocking processes” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Invoice Solution (VIM-CGD).
If Single Click Entry for SAP GUI is installed on a Vendor Invoice Management
system, it permits to capture data for fields on the index screen using the mouse. For
more information, see Section 4.2 “Using the Single Click Entry feature” in OpenText
Vendor Invoice Management for SAP Solutions - User Guide for Invoice Solution (VIM-
UGD), and “Installing Single Click Entry for SAP GUI” on page 95.
After Single Click Entry for SAP GUI has been installed, configure SAP GUI.
To configure SAP GUI and VIM for Single Click Entry for SAP GUI:
1. Start SAP GUI, and then click Options in the system menu.
2. If the Enable Scripting check box at the user settings is cleared, select it.
3. Clear the two additional check boxes controlling notifications because otherwise
you get two notifications for each document that is opened on the index screen.
4. Click Apply.
8. Configure clean-up of XML files for documents that have left the VIM
Foundation Inbound component. For more information, see Section 7.2.3 “Batch
Program /OPT/VIM_ICC_DL_CLEANUP” in OpenText Vendor Invoice
Management for SAP Solutions - Administration Guide (VIM-AGD).
Identify and download the Support Packages needed for each component used for
your Invoice Solution scenarios. While SPs for the main Invoice Solution component
OTEXVIM are provided regularly, other components are not necessarily updated
every time.
After you have identified and downloaded the support package files, perform the SP
installation in the SPAM transaction.
You find post installation transports on OpenText MySupport, in the folder of the
respective support package. You only need the transport provided with the highest
support package that you are installing.
Notes
• To activate the BC sets, sign in in English and use the expert mode.
• You must activate the BC sets in every client separately.
• OpenText recommends that you activate only one BC set in one call of the
SCPR20 transaction. Close the SCPR20 transaction after each activation and
call the transaction again. Some activation errors depend on this: they do not
occur if the activation is performed in a separate SCPR20 transaction.
The load manager and the hotspots of the ICC/BCC server will continue to use the
old data definitions. This may lead to inconsistencies if you do not restart the server.
13.5 Upgrading
For the Invoice Solution component, no specific upgrade packages are delivered.
For an upgrade from an earlier version, install the standard installation packages for
the components used in your business scenarios. Identify these packages with the
information provided in “Selecting required components and downloading the
packages” on page 68 and “Changes in VIM Invoice Solution component structure”
on page 98.
• Upgrading from VIM 7.5 or VIM 7.6 to VIM 20.4 on SAP S/4HANA. For more
information, see “Upgrading VIM 7.5/7.6 to VIM 20.4” on page 101.
• Upgrading from VIM 16.3 to VIM 20.4. For more information, see “Upgrading
VIM 16.3 to VIM 20.4” on page 108.
For information about upgrading from any VIM version on SAP ERP to VIM 7.5 or
VIM 7.6, see Section 13.6.5 “Upgrading VIM” in OpenText Vendor Invoice Management
for SAP Solutions - Installation Guide (VIME070600-IGD) (Installation Guide VIM 7.6).
The structure changes are different when upgrading from VIM 7.5 or from 7.6.
“Changes in VIM Invoice Solution component structure from VIM 7.5 to VIM 20.4”
on page 99 explains the changes in components structure, comparing VIM 7.5 up
to SP8, VIM 7.5 from SP9 to SP11, being upgraded to VIM 20.4.
“Changes in VIM Invoice Solution component structure from VIM 7.5 to VIM 20.4”
on page 99 lists software components with technical release numbers applicable to
the respective VIM support package. If you are upgrading from VIM 7.5 SP8 and
older, follow each line for a component starting from the far left to find the changes
related to the component. When upgrading from VIM 7.5 SP9 to SP11, follow the
respective lines starting in the middle.
Table 13-5: Changes in VIM Invoice Solution component structure from VIM 7.5
to VIM 20.4
From To From To
7.5 up to 7.5 SP9- Comments 7.5 SP9- 20.4 Comments
SP8 SP11 SP11
OTBCUS03 OTBCUS03 OTBCUS03 - Included into
0740_004 0740_004 0740_004 OTBCWUI (VIM
Foundation)
OTBCSL33 OTBCSL33 OTBCSL33 OTEXVIM VIM Invoice,
0700_004 0700_005 0700_005 81610_106 Fiori apps
objects included
into OTEXVIM
OTBCSL03 OTBCSL33 VIM Invoice OTBCSL03 OTEXVIM VIM Invoice,
0700_004 0700_005 Fiori objects 0700_005 81610_106 Inbound objects
moved from included into
SL03 to SL33 OTEXVIM
OTBCSL03 VIM Invoice
0700_005 Inbound objects
remain in SL03
OTBCSL30 OTBCSL30 OTBCSL30 OTBCSL30
0700_004 0700_005 0700_005 81610_106
OTVIMWUI OTVIMWUI OTVIMWUI - Not supported
anymore, must
be uninstalled
before upgrade
(see the Note at
the end of this
table)
OTVIMWS OTVIMWS OTVIMWS - Not supported
R R R anymore, must
be uninstalled
before upgrade
(see the Note at
the end of this
table)
OTVIMARB OTVIMARB OTVIMARB OTEXVIM Included into
750 750 750 81610_106 OTEXVIM
From To From To
7.5 up to 7.5 SP9- Comments 7.5 SP9- 20.4 Comments
SP8 SP11 SP11
OTVIMARC New. Replaces
80700_006 the transport
package
provided earlier
OTVIMGW OTVIMGW OTVIMGW OTVIMGW
700 / 740 700 / 740 700 / 740 81610_106
OTVIMCDS OTVIMCDS OTVIMCDS OTEXVIM Included into
750 750 750 81610_106 OTEXVIM
OTVIMBW OTVIMBW OTVIMBW OTVIMBW
700 / 700 / 700 / 80700_006
700_730 700_730 700_730
OTBCSL38 New with SP9 OTBCSL38 OTBCSL38
0700_005 0700_005 80700_006
https://mimage.opentext.com/support/ecm/secure/patches/vim/oneoff/
vimi-23593/ACP_OTVIMWUI_OTVIMWSR.zip
Import the respective ACP files using the transaction SAINT on the systems
where the components are installed.
“Changes in VIM Invoice Solution component structure from VIM 7.6 to VIM 20.4”
on page 100 explains the changes in components structure of VIM 7.6 being
upgraded to VIM 20.4.
Table 13-6: Changes in VIM Invoice Solution component structure from VIM 7.6
to VIM 20.4
From To
7.6 20.4 Comments
OTBCSL30 OTBCSL30 Compared to 7.6, contains only DDIC objects on
80700_006 81610_106 20.4
OTEXVIM All invoice inbound objects included into
81610_106 OTEXVIM
OTEXVIM OTEXVIM
80700_006 81610_106
OTBCSL33 OTEXVIM All Fiori apps objects included into OTEXVIM
80700_006 81610_106
From To
7.6 20.4 Comments
OTVIMCDS OTEXVIM Included into OTEXVIM
80700_006 81610_106
OTVIMARB OTEXVIM Included into OTEXVIM
80700_006 81610_106
OTVIMARC OTVIMARC Same component used, no need to upgrade
80700_006 80700_006
OTVIMGW OTVIMGW
80700_006 81610_106
OTVIMBW OTVIMBW Same component used, no need to upgrade
80700_006 80700_006
OTBCSL38 OTBCSL38 Same component used, no need to upgrade
80700_006 80700_006
For a description of an upgrade from VIM 7.5 to VIM 20.4 without an SAP S/
4HANA conversion, see “Upgrading VIM 7.5 to VIM 20.4 without conversion”
on page 104.
Important
For upgrades from VIM 7.5, an ACP file to modify the installation package
attributes is required if you were using any of the following additional
components:
• OTBCSL03
• OTBCSL33
• OTVIMARB
• OTVIMS4
• OTVIMCDS
You can download the ACP file from OpenText My Support: Patches > Vendor
Invoice Management > Vendor Invoice Management for SAP Solutions 20.4
> Invoice Solutions > ACP Files > OTEXVIM81610_106_UPG_75.SAR
If you purchased VIM through SAP and you are performing the upgrade with
SAP Maintenance Planner, the package attributes will be adjusted
automatically.
SAP S/4HANA In your environment, you might have VIM 7.5/7.6 installed in the system and plan to
conversion and run a conversion from SAP ERP to SAP S/4HANA. During the conversion, VIM
VIM licenses
needs to be upgraded to 20.4.
Note: If there are issues with the SAP Maintenance Planner, open a ticket at
SAP for the component BC-UPG-MP. Clearly explain in the ticket if the
software was bought from SAP and Maintenance Planner does not proceed as
expected or if the software was bought from OpenText and help is needed how
to do the conversion for a partner add-on not licensed by SAP.
OTVIMGW If you have installed the OpenText Gateway component for Supplier Self Service,
OTVIMGW, on your VIM 7.5 system, you must uninstall the Gateway component
before you begin the conversion. There is no upgrade path maintained for it in the
SAP Maintenance Planner, and the versions provided with VIM 7.5 are not
compatible with SAP S/4HANA. When the conversion is finished, install the
component OTVIMGW that is provided with the VIM 20.4 installation package.
2. If the tables exist, open the table definition, and check the data element for table
field CONFIG_LINE.
3. For each of the tables, change the data element for table field CONFIG_LINE from
VERI_LRAW to /OPT/LRAW2048.
You can perform the conversion to the following SAP S/4HANA versions:
Notes
• After the conversion, continue with the post installation steps after upgrade.
For more information, see “Post installation activities after an upgrade”
on page 105.
Performing the SAP S/4HANA conversion – For the actual SAP S/4HANA
conversion, use the guides provided by SAP.
Prerequisites
Note: OpenText advises against activating the complete BC set during the
upgrade without checking, because it might overwrite any changed standard
configuration. Instead you can detect missing entries manually, using the
compare functionality in the SCPR20 transaction.
Notes
• Several components of VIM 7.5 are now included in the OTEXVIM main
package: OTBCSL03, OTBCSL33, OTVIMARB, OTVIMCDS, OTVIMS4. If these
components are installed on your system, no action is required because
these are included into the main package.
• OTBCUS03 of VIM 7.5 is now included in the OTBCWUI OpenText Process
Fiori Base package. If OTBCUS03 component is installed on your system,
no action is required because it is included in the OpenText Process Fiori
Base package
• If the demo package OTVIMWSR is installed on your system, it needs to be
uninstalled. This demo component is not supported anymore.
For the installation steps that you need to perform, see “Installing the package”
on page 72.
If you perform the upgrade during an SAP S/4HANA conversion, also see
“Upgrading to VIM 20.4 during an SAP S/4HANA conversion” on page 102
After upgrading, you must import the following transport to the systems where you
have performed the upgrade. It is necessary for the Fiori apps to work.
You find post installation transports on the installation media / package under the
path Software\Invoice Solution\Postinstall.
Notes
• To activate the BC sets, sign in in English and use the expert mode.
• You must activate the BC sets in every client separately.
• OpenText recommends that you activate only one BC set in one call of the
SCPR20 transaction. Close the SCPR20 transaction after each activation and
call the transaction again. Some activation errors depend on this: they do not
occur if the activation is performed in a separate SCPR20 transaction.
The business configuration sets (BC sets) for post installation activities after an
upgrade are the following. All post installations sets of 7.5 Support Packages must
be executed and all BC sets must be activated.
Upgrading from OpenText recommends that you upgrade to VIM 7.5 SP6 before the upgrade.
VIM 7.5 < SP5
If this is not possible, it is possible to perform an upgrade to VIM 20.4. However it is
necessary to review the release notes for all VIM 7.5 support packages before SP6
that are not yet installed on your system and follow the post installation steps.
13.5.2.3.3 Checking status and runtime behavior of BAdIs for Invoice Processing
Use transaction SE19 to check the runtime behavior of the BAdIs. The following are
the standard values:
The installation of VIM delivers a BAdI implementation for SAP BAdI VATDATE_
VALUES.
When the target SAP release is SAP S/4HANA 2020 and later releases, an important
manual correction instruction must be implemented to adjust the implementation of
VAT date BAdI.
Download the correction instruction from OpenText My Support under Resources >
Patches > Vendor Invoice Management > OpenText Vendor Invoice Management
20.4 > Invoice Solutions > Additional Components, and perform the steps
described in the document.
The Inbound component is mandatory for VIM 16.3 and later versions. Do not use
the Incoming Document Handling (IDH) framework and the ICC Dispatcher
framework any longer.
Make sure that the Z constant 005 / BC_INBOUND is set to X. To do this, run the SM30
transaction for view /OPT/VIM_ZCONST.
VIM 7.5 introduced logic module processing. For more information, see Section 8.4
“Processing logic modules” in OpenText Vendor Invoice Management for SAP Solutions
- Configuration Guide for Invoice Solution (VIM-CGD).
As an upgrade customer on VIM 7.5, you might still be running VIM in a 7.0 mode
without logic modules. From VIM 16.3, this is no longer supported.
Check if the Z constant VIM_VERSION_SWITCH is set to 700. To do this, run the SM30
transaction for view /OPT/VIM_ZCONST. If the setting is 700, delete the Z constant.
VIM 16.3 has introduced new logic modules. Check the currently used document
types for correct logic module configuration. Add missing logic modules to your
configuration if necessary. As a reference, you can use the default document types
delivered in the main BC Set /OTEXVIM/VIM20_4_BASELINE.
In VIM 16.3, logic for enhancing initial data was moved to logic modules. Therefore
you have to include the following modules to your existing logic module
configuration:
PO Document Types
For more information, see Section 31.5 “Enrich NPO Line Items” in OpenText
Vendor Invoice Management for SAP Solutions - Reference Guide for Invoice Solution
(VIM-RGD).
VIM 16.3 has introduced a new posting logic for NPO and PO invoices using
logistics invoice verification.
OpenText recommends that you evaluate the new posting logic and switch
processing of invoices to the new logic.
For more information, see Section 32 “Posting invoices” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD).
VIM 16.3 has replaced parked processing for NPO and PO invoices by processing
parked documents in DP. For more information, see Section 8.3 “Configuring parked
processing” in OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Invoice Solution (VIM-CGD).
Old parked processes are no longer supported. Continuing their usage must be
evaluated and tested customer-specifically.
If you use VIM Fiori apps, you must adjust the launchpad tile configuration. For the
current parameters, see “Fiori: Setting up Launchpad content on-premise”
on page 92.
Prerequisites
The following applies if you have purchased VIM licenses from OpenText directly:
It can happen that the SAP Maintenance Planner will not be able to automatically
perform the VIM upgrade because you do not have a VIM license from SAP. For
more information, see the SAP Note 2523380 - “Improvements to Rectify Erroneous
Systems in Maintenance Planner”.
OpenText also recommends that you check the latest version of the SAP Note
2721274 - “SAP S/4HANA conversion/upgrade planning for reseller Add-ons”.
Note: If there are issues with the SAP Maintenance Planner, open a ticket at
SAP for the component BC-UPG-MP. Clearly explain one of the following in the
ticket:
• The software was bought from SAP and Maintenance Planner does not
proceed as expected.
• The software was bought from OpenText and help is needed how to do the
conversion for a partner add-on not licensed by SAP.
2. Select required components and download the packages. Collect all missing
installation and Support Packages files as shown in “Selecting required
components and downloading the packages” on page 68.
13.5.3.2 Upgrading
If you are upgrading VIM without an SAP S/4HANA upgrade, install VIM packages
following standard procedures. For the installation steps that you need to perform,
see “Installing the package” on page 72.
If you are upgrading VIM at the same time as upgrading SAP S/4HANA, select the
new VIM version and SP level (if SPs are available) in the component selection step
of the upgrade tool of your choice, typically SAP Maintenance Planner. Follow the
standard procedures as recommended by SAP.
After upgrading, you must import the following transport to the systems where you
have performed the upgrade. It is necessary for the Fiori apps to work.
You find post installation transports on the installation media/package under the
path Software\Invoice Solution\Postinstall:
Notes
• To activate the BC sets, sign in in English and use the expert mode.
• You must activate the BC sets in every client separately.
• OpenText recommends that you activate only one BC set in one call of the
SCPR20 transaction. Close the SCPR20 transaction after each activation and
call the transaction again. Some activation errors depend on this: they do not
occur if the activation is performed in a separate SCPR20 transaction.
Several BC sets are provided for upgrades. A full BC set containing complete
configuration is included into the main VIM installation package. Three delta BC
sets are provided for download in OpenText My Support under Resources > Patches
> Vendor Invoice Management > OpenText Vendor Invoice Management 20.4 >
Invoice Solutions > Additional Components:
/OTEXVIM/VIM1633_204_UPGRADE
Delta BC set for upgrades from VIM 16.3 SP3 to 20.4. Transport Q02K900159
/OTEXVIM/VIM1634_204_UPGRADE
Delta BC set for upgrades from VIM 16.4 SP4 to 20.4. Transport Q02K900162
/OTEXVIM/VIM1635_204_UPGRADE
Delta BC set for upgrades from VIM 16.4 SP5 to 20.4. Transport Q02K900164
/OTEXVIM/VIM20_4_BASELINE
Complete BC set. Use this BC set for all other upgrade scenarios.
13.5.3.3.3 Checking status and runtime behavior of BAdIs for invoice processing
Use the SE19 transaction to check the runtime behavior of the BAdIs. The following
table shows the standard values:
If you use VIM Fiori apps, you must adjust the launchpad tile configuration. For the
current parameters, see “Fiori: Setting up Launchpad content on-premise”
on page 92.
When the target SAP release is SAP S/4HANA 2020 and later releases, an important
manual correction instruction must be implemented to adjust the implementation of
VAT date BAdI.
Download the correction instruction from OpenText My Support under Resources >
Patches > Vendor Invoice Management > OpenText Vendor Invoice Management
20.4 > Invoice Solutions > Additional Components, and perform the steps
described in the document.
13.6 Troubleshooting
13.6.1 Table length restrictions for /OPT/VIM_1HEAD
This section applies if some custom fields have been added into VIM table /OPT/
VIM_1HEAD.
Historically, SAP systems were able to use different database back ends, each with
different capabilities. To support all of them, SAP imposes restrictions on table row
size. The most common limit for current releases is 4030 or 4096 characters. The
table /OPT/VIM_1HEAD as delivered by OpenText does not surpass the limit, but the
limit can be surpassed when custom fields are added through an append structure.
In this case, during the activation phase of VIM upgrade or support package
installation, you might get the following error in the activation log:
Table /OPT/VIM_1HEAD is too long (>4096)
All modern databases are able to handle longer rows, and it is possible to set a
different length limit according to your needs. If your upgrade is affected by the
restriction, see SAP Note 2458652 that explains the problem and describes the
procedure to solve it.
Notes
Inconsistent data in workflow containers often results in short dumps. They happen
when, after an upgrade, a user tries to open a work item that was created before the
upgrade.
The only VIM database table that is currently known to cause these problems is
table /OPT/VIM_1HEAD. OpenText recommends that you create a copy (for example
with the name ZZZ1HEAD) in transaction SE11. It is important that the table copy will
not reference any include or append structures. You can achieve this by performing
the following steps:
To expand includes:
3. Set the pointer on each include line (.INCLUDE) that is still displayed, and, on
the Edit menu, click Include > Copy Components.
Normally, all fields will be expanded at once. After this, you can activate the
table.
During installation of language packs, all labels should be available. If line item
labels are missing for a language, you can run this program.
• You can process the program for all available languages or for a set of languages.
• You can choose which languages you want to load in the selection screen.
• Running the program updates line item labels only, not header labels.
• After running the program, you must add the table entries in /OPT/IDX_ITM_T
into a customizing request manually to transport them to the rest of the systems
in the landscape.
Note: You can also add entries using an /OPT/SPRO node or the /OPT/VIM_
ITM_SCR_DES transaction. For more information, see Section 8.1.7
“Customizing field labels in the index screen” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-
CGD). In this case, the entries are automatically stored in a customizing
request.
• Check, if the PLDA post install transport is imported to the current client.
• Check if BC set /OTEXVIM/VIM20_4_BASELINE has been activated correctly,
including all Sub-BC-sets.
This part describes the installation of Simple Mode VIM. For Simple Mode, all
Business Center components are mandatory. For more information, see “Installing
the package” on page 72.
14.1 Overview
Simple Mode provides additional apps, which are based on SAP Fiori:
Notes
14.2.1 Prerequisites
Backend system
Notes
• Minimal UI5 version: For the supported UI5 version, see the Business Center
Release Notes.
• Installed and configured SAP Fiori app Manage Supplier Invoices. For more
information, see the Fiori Apps Library.
• Installed and configured SAP Fiori fact sheet Supplier. For more information,
see the Fiori Apps Library: https://fioriappslibrary.hana.ondemand.com/sap/
fix/externalViewer/#/detail/Apps('F0354')/S11OP
• Installed and configured SAP Fiori app Purchase Order (Version 2). For more
information, see the Fiori Apps Library: https://
fioriappslibrary.hana.ondemand.com/sap/fix/externalViewer/#/detail/
Apps('F0348A')/S13OP
For more information, see “Selecting required components and downloading the
packages” on page 68.
3. Collect the languages for OTBCSL08. They are delivered together with all other
languages for Invoice Solution. For more information, see “Language packs”
on page 94.
4. Install VIM – Simple Mode:
a. Install the add-on OTBCSL08 and all support packages using the SAINT
transaction.
If the Business Center components described in “Prerequisites” on page 116
are not installed on the system, install all add-ons with all Support
Packages at once.
b. Follow the instructions in “Installing“ on page 37 regarding post
installation activities like BC sets activation, service activation, and so on.
c. Activate the BC set /OTX/PS08_INVOICE_106 using the SCPR20 transaction.
This BC set is cumulative, it is not necessary to activate BC sets from lower
support packages.
d. Import the post installation transports to all clients where the apps are
intended to run. See Step 2 on page 118.
e. Install the language pack for component OTBCSL08.
f. Perform the customizing as described in Part V “Simple Mode VIM” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide
for Invoice Solution (VIM-CGD).
5. Set up the Fiori Launchpad tiles for the Simple Mode based Fiori apps.
The general setup is described in Section 10.1.1 “Integrating Fiori Task App into
Fiori Launchpad” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Foundation (BOCP-CGD).
When setting up tiles for VIM, you need to know specific parameters for each
Fiori app. The parameters are listed in the following table:
The following texts are delivered as a template for the Vendor Reject Functionality
(only English). For more information, see Section 20.4 “Maintaining email
templates” in OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Invoice Solution (VIM-CGD) and Section 20.6 “Maintaining the email
signature” in OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Invoice Solution (VIM-CGD). If you want to use custom specific texts, you
may skip copying the following texts.
• /OTX/PS08_RTV_TEMPLATE
• /OTX/PS08_RTV_SIGNATURE
Note: To copy the text in all languages at once, you can use an asterisk in
the Language field.
3. Enter values in the required fields. Text Name and Target Name must be the
same.
Click .
4. If a dialog box like the following opens, click Yes.
6. Repeat the steps for all standard text shown in the list above.
14.2.4 Update
For updating Simple Mode from any 16.3 version to 20.4, follow the steps in
“Installing the Simple Mode components” on page 117.
The BC Set of 20.4 delivers new process profile settings, which overwrite the existing
profile. Before activating the new BC Set, save any custom specific customizing
especially in the Process Profile Customizing (roles or country specific
characteristics, and so on). For more information, see Section 7 “Process
Configuration” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Foundation (BOCP-CGD)
If you are upgrading during a system conversion of your SAP S/4HANA version, a
warning during phase RUN_RSUPG_TADIR_COMPONENT_CHECK for component
OTBCSL08 might occur. Several obsolete objects (especially in package /OTX/PS80)
were deleted in version 20.4. Therefore, you can ignore this message for component
OTBCSL08.
14.2.5 Troubleshooting
This section collects possible problems with the installation of Simple Mode. It also
provides information how to solve these problems.
1. Use the Business Center app Perspective Manager to delete all perspectives of
type ITEM starting with PS08 for the current client.
2. Re-import the post installation transport for Perspective Layouts in the
current client.
This part describes the installation and post installation activities needed for the
“Key Performance Indicator” Dashboard (KPI Dashboard). The KPI Dashboard is a
tool for managers showing VIM related process data at a glance in graphical charts.
For further information, see Section 27 “KPI Dashboard” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD).
Notes
• The KPI Dashboard is not supported in the VIM 7.5 version for SAP S/
4HANA on Premise.
• The KPI Dashboard is an optional component.
• If you are not using the KPI Dashboard, you can skip this part.
Prerequisites
There are specific OpenText name spaces that have to be modifiable in order to
change the service settings. So first check with transaction SE03
Navigate to Transport Organizer Tool > Administration > Set System Change
Option
Make sure, the Open Text Name space / Prefix /OPT and /ORS are set to Modifiable.
After you have finished the customizing of services, change back the settings.
1. To activate the Web Dynpro service on the SAP S/4HANA system, run the SICF
transaction.
Error Handling
You can customize a few default pages for error handling in the Web Dynpro
service.
Error pages are shown for defined reasons; for example, if the timeout is reached for
the web session. The default setting is to show SAP standard error pages.
You can change these settings for the following use cases:
• Logon Errors
• Application Errors
• Logoff Page
• Not Accessible
15.2.2 Setting the connection for the SAP Web Dynpro service
You activate the SSL connection for Web Dynpro by configuring the SAP Web AS, as
described in the SAP help.
Do not change the service settings described in “Activating the SAP Web Dynpro
service” on page 123. Make sure that the SSL settings are not activated in the Logon
Data tab.
A System Object is needed to integrate the KPI Dashboard in the SAP NetWeaver
Portal. The System Object is a set of connection properties to represent an external or
SAP system (SAP R3, CRM, BW) used to retrieve data into portal iViews. If not
existing, you must create a System Object in the NetWeaver Portal.
Note: If you use an SAP NetWeaver Portal version higher than 7.0, refer
directly to the SAP Portal documentation. Follow the description of creating an
iView type based on a Web Dynpro ABAP application.
15.2.3.1 Prerequisites
This example shows the customizing for the connection to a specific ABAP® system.
3. Connector settings
In the Display drop down list, select Object, and then, in the Property
Category drop down list, select Connector.
Provide minimum connector properties for example. See the following
screenshot for example values.
4. ITS settings
ITS settings are maintained for displaying SAP transactions in the portal as an
iView.
In the Display drop down list, select Object, and then, in the Property
Category drop down list, select Internet Transaction Server (ITS).
Provide ITS properties as shown in the following screenshot.
The property values to enter can be read from the ABAP system using
transactions SICF and SMICM.
For a detailed description how to set up the System Object in the Portal, see
http://wiki.sdn.sap.com/wiki/display/EP/How+to+Create+System+Object+in+the
+Portal+for+Connecting+to+SAP+backend+System.
2. Choose a folder or generate a new folder. To select the iView object, right-click
the folder and select new > iView.
3. In the Display drop down list, select Object, and then, in the Property
Category drop down list, select Content - Web Dynpro.
Provide properties as shown in the following screenshot.
Check also other properties for design or layout, and customize them if needed.
4. To test the newly generated iView object, click the Preview button. If everything
is customized correctly, a separate window opens and shows the KPI
Dashboard content in the iView.
This chapter describes the installation of the OpenText Approval Portal component.
The Approval Portal is designed to work within SAP NetWeaver Application Server
Java (NWAS) 7.3 or 7.4 or SAP NetWeaver Portal (NWP) 7.3, 7.4, or 7.5.
Notes
• If you are not using the Approval Portal, you can skip this part.
• You might want to install multiple instances of the Approval Portal on the
same SAP NetWeaver Portal. In this case, contact OpenText Customer
Support.
Server
Notes
• Approval Portal 20.4 JCO3 Java 1.8 and Approval Portal 20.4 Java 1.8
packages are supported only in NWAS 7.5 and NWP 7.5.
• The requirement “SPx or above” does also refer to the EhP level.
• For further information, see the SAP Note: 994791-SPNego Wizard.
Supported The following list shows the supported resolution modes that have been tested in
Screen the OpenText R&D lab. The resolution modes have been tested in all supported
Resolution
browsers.
Web browsers The following matrix shows the web browsers and versions that are supported by
the new interface of the Approval Portal, which is delivered since VIM 7.0 SP2. The
matrix is based on tests performed at OpenText R&D Lab. It considers accessibility
and usability aspects.
NWAS 7.4
NWAS 7.5
NWP 7.3
NWP 7.4
NWP 7.5
Operating The Approval Portal supports Windows, Unix and other operating systems
systems supported by SAP.
Note: The new Approval Portal has not been tested in Unix environment.
Aligned with SAP operating system support, see the SAP Product Availability
Matrix (PAM) for more details.
Sizing require- Standard sizing requirements for NWAS or NWP 7.3 apply.
ments
SAP user An SAP CPIC user in the SAP S/4HANA server
User type
Communication Data (CPIC)
Profile
Create a profile with the following authorization objects and add it to the CPIC
user:
Object: S_RFC
Activity
Execute (16)
Names of RFC to be protected
/OPT/VIM_FG1A2, /ORS/*, /OPT/*, /ORS/SAPL000007_APPR_SCREEN, /
PTGWFI/*, OPTB, ARFC, ERFC, RFC1, SDIFRUNTIME, SUNI, SYST, SYSU
RFC_TYPE
FUGR (Function Group)
Object: S_CPIC
Activity
Accept, Initialize (37 and 51)
Name of an ABAP/4 FORM routine
CPIC
Symbolic destination
*
If you wish to narrow this down, examine table TXCOM and choose entry
under the SDEST field that represents the destination of the system you are
communicating with.
Program Names with Search Help
/ORS/*, /OPT/*, /PTGWFI/*
Activity
Read, Write (33 and 34)
Filename
* (physical file name)
The following 2 authorization objects for the CPIC user are applicable for SAP
ERP 702 SP14 and higher and SAP NetWeaver Portal 702 SP15 and higher:
Object: S_RZL_ADM (Authorization object for R/3 system administration)
Activity
Display (03)
Activity
Display (03)
Additional SAP Standard Profile needed: S_A.CPIC and S_A.USER
Note: If you are using an Archive Server to pull in images, you may need
to assign additional roles. See the Archive Server Installation manual.
Example: OpenText™ Archive Center provides the following profiles that need to
be assigned to the CPIC user to access images:
Note: For SAP ERP systems with EHP5 or higher, one additional authorization
is required for the CPIC user.
S_WF_WI
Classification of tasks
*
Activities
12 (Resubmit work item)
Work item type
W – Dialog work item
For all Support Packages of VIM 20.4, the respective OpenText Vendor Invoice
Management 20.4 Support Package folder on My Support provides an
installation package of the VIM 20.4 SPx Approval Portal in the Web and
Mobile Approval Component folder.
There are 2 ways to configure the Approval Portal application. It can be deployed:
The SAP help pages linked in the following discuss some of the communication
channels between each component:
Note: Approval Portal can be used if the SAP NetWeaver Portal is configured
to use SAML-based authentication. No specific VIM configuration is required
in this case. For more information on SAML, see the SAP documentation.
Dual Stack installation (SAP ABAP and Java Stack) utilizing integrated
authentication
SAP GUI Logon ID required. Dual Stack forces to use SAP user management
based on ABAP Stack.
Standalone J2EE application residing on NWAS with NWP utilizing integrated
authentication by accessing application directly without iView
No need for SAP GUI Logon ID; only network ID is required.
Important
If you have not installed Web Viewer or Brava! View, OpenText recommends,
as a general advice, that you create PDF files from scanning and use the PDF
viewer that is installed on your computer for displaying invoice images.
Note: When using Web Viewer, OpenText recommends that you use the latest
patch of the supported Web Viewer software version.
As an alternative, you can use OpenText™ Brava!™ View for SAP Solutions (Brava!
View).
• To install Web Viewer 10.5, 16, or 20.3, download the software from OpenText
My Support.
• For the Web Viewer installation, see the appropriate section in Section 3
“Installing Web Viewer” in OpenText Imaging Web Viewer - Installation and
Configuration Guide (CLWEBV-IGD).
• To install Brava! View 16.2 or 20.3, download the software from OpenText My
Support.
• For the installation of Brava! View, see Section 2 “Installing Brava! View for SAP
Solutions” in OpenText Brava! View for SAP Solutions - Installation and
Configuration Guide (BRWEBV-IGD).
• To apply the latest patch for Web Viewer, download the software from OpenText
My Support.
• It is necessary to install Archiving and Document Access for SAP Solutions 10.5.
For more information, see OpenText Archiving and Document Access for SAP
Solutions - Installation and Upgrade Guide (ER-IGD).
• You perform the configuration that is necessary for the Web Viewer integration
in the /IXOS/OA_CUST_A archive tables in SAP ERP. For a description of the
configuration, see Section 17.2 “Configuration for Web Viewer” in OpenText
Archiving and Document Access for SAP Solutions - Scenario Guide (ER-CCS).
Note: Web Viewer 16 and Brava! View 16.2 versions are not supported on the
Mobile Approval Portal. For more details on Web Viewer and Brava! View
support, see the Web Viewer Support and Brava! View Support sections in the
Release Notes.
• JCo3 by framework takes care of Connection Management Handling, and all JCo
destinations are created on SAP NetWeaver Administrator Portal.
• The JCo3 package is completely aligned with JCo2 package, having all
functionalities, except connector usage.
Table 16-1: JCo3 compatibility matrix for versions 7.6 and 20.4 of the Approval
Portal
Important
OpenText recommends you to create and deploy to the folder usr/sap/
<SID>/SYS/global/opentext/invoiceCfg. This is the default location
for putting the application configuration file. If you deploy to another
location, you will have to manually add a startup parameter in the Config
Tool to tell the application where to look for the configuration files. This
will also require restarting the SAP NetWeaver Application Server Java
(NWAS). See Step 2 on page 145 for details.
<SID> is the system ID of the NWAS. Example: T39.
Example: E:\usr\sap\T39\SYS\global\opentext\invoiceCfg
configuration.xml
containing all the configuration for the application
Note: Each Approval Portal Support Package (SP) delivers an
configuration.xml file. If you overwrite your existing file, your
settings will be gone. If you keep the old file, you may be missing
some new options introduced for the new SP. See the Release Notes of
the respective SP if the file can be left as it is or if it must be merged to
incorporate the new settings.
mobileconfiguration.xml
containing all the configuration for mobile support
RequestMappings.xml
OpenText strictly recommends not to modify this file. The Approval Portal
application internally uses this file.
Lang_Support.properties
containing all the mapping of languages code; see Section 7.8.4.2
“Configuring additional languages” in OpenText Vendor Invoice Management
for SAP Solutions - Administration Guide (VIM-AGD) for details.
Lang_DE.properties
containing all the text for the German language resource
Lang_EN.properties
containing all the text for the English language resource
Lang_ES.properties
containing all the text for the Spanish language resource
Lang_FR.properties
containing all the text for the French language resource
Lang_IT.properties
containing all the text for the Italian language resource
Lang_JA.properties
containing all the text for the Japanese language resource
Lang_NL.properties
containing all the text for the Dutch language resource
Lang_PT.properties
containing all the text for the Portuguese language resource
Lang_RU.properties
containing all the text for the Russian language resource
Lang_ZH.properties
containing all the text for the Chinese language resource
There might be more .properties files, depending on the package and the
release for additional languages. The language resource files can be changed.
See Section 7.8.4.1 “Changing language resources” in OpenText Vendor Invoice
Management for SAP Solutions - Administration Guide (VIM-AGD) for details.
Important
Make sure the <Approval_Portal_installdir> folder has:
Important
This step is only needed if you deploy the configuration files to a location
other than the folder usr/sap/<SID>/SYS/global/opentext/
invoiceCfg.
Notes
a. Add the startup parameter to the Java parameters on the server: -Dcom.
opentext.vim.portal.invoiceCfg=<Approval_Portal_installdir>.
Example: -Dcom.opentext.vim.portal.invoiceCfg=c:/opentext/
invoiceCfg
b. Save the new parameter.
3. To apply the new startup parameter, restart the NWAS.
Restarting informs the server that the <Approval_Portal_installdir> folder
contains application specific information.
This section describes the installation activities to assign the administrator role to the
user for the Approval Portal application. As the Administrator, you must login to
the Administrator page to perform some application configuration and to perform
other administration tasks. See Section 7.8 “Administering the Approval Portal” in
OpenText Vendor Invoice Management for SAP Solutions - Administration Guide (VIM-
AGD) for additional information.
You must perform this configuration before deploying the .sca or .sda, to ensure
that the application recognizes the role.
1. Log in to J2EE Visual Administrator and navigate to Instance > Server >
Services > Security Provider.
3. Click the Runtime tab > Policy Configurations tab > Security Roles tab.
6. In the Add Security Role dialog box, enter the role name: com.opentext.vim.
portal.administrator.
Click OK.
2. Click the Add button which is on the right hand side next to Users.
3. In the Choose Users or Groups dialog box, type the domain user to whom you
want to assign the administrator role.
4. Click on Search.
6. Click OK.
Note: Check this after you have deployed the .SCA or .SDA file, see
“Deploying the Software Component Archive” on page 152.
• Navigate to http://<NWAS>:<NWASPORT>/vimportal/admin.
If you see a screen similar to the one above, you have configured the
administrator role successfully.
To configure the administrator role for access through NWAS for SAP
NetWeaver 7.3 and 7.4:
4. Click the Assigned Users tab and perform a search. Select the user and click
Add.
• “Optional: Starting the Approval Portal J2EE application manually” on page 152
1. Click on a server.
2. Expand Services.
3. Expand Deploy.
5. Click on opentext.com/IM_APPROVAL_PORTAL.
2. On the Tools menu, click Delete browsing history. Alternatively, press CTRL
+SHIFT+DEL.
3. In the Delete Browsing History dialog box, select the check boxes, as shown in
the following screenshot.
Make sure that the Preserve Favorites website data check box is cleared.
4. Click the Delete button. Then wait for the browser to clear the cache.
2. Press CTRL+SHIFT+DEL.
3. In the Clear All History dialog box, select the check boxes, as shown in the
following screenshot.
Make sure to select Everything in the Time range to clear list.
4. Click the Clear Now button. Then wait for the browser to clear the cache.
1. Open Chrome.
2. Press CTRL+SHIFT+DEL.
3. In the Clear browsing data dialog box, select the check boxes, as shown in the
following screenshot.
Make sure to select the beginning of time in the Obliterate the following
items from list.
4. Click the Clear browsing data button. Then wait for the browser to clear the
cache.
Notes
5. Click Start.
Example: To undeploy the 7.0 SP4 packaging file, the command is: undeploy name=
IM_APPROVAL_PORTAL7_0SP4 vendor=opentext.com
4. Press ENTER.
1. To place the Properties files, download the Approval Portal package and
extract opentext.zip in the following directory: <drive>:\usr\sap\<SAP
instance>\SYS\global.
2. If a SUM installation already exists in the system, you must rename or delete it.
3. Ensure to have a .SAR file at the location, where the SUM installation takes
place.
4. To install SUM, open a command prompt, navigate to the directory where
the .SAR file is located, and run the following command.
Syntax
sapcar -xvf <SUM…… file.SAR> -R <drive>:\usr\sap\<SAP instance>\
Example
sapcar –xvf SUM10SP10_8-20006676.SAR –R D:\usr\sap\MO3\
Example: http://localhost:1128/lmsl/sumjava/d9e/index.html
Notes
the same SUM that you have previously used for deploying, it will not
work.
Click Next.
9. Specify Credentials
Enter User Name and Password.
Click Next.
10. Select Target
Select the Manually prepared directory check box. Click Browse, navigate to
the OpenText Approval Portal package directory, and click OK.
Cross check the selected path and click Next.
11. Initialization - System Analysis
Click Next.
12. Extraction - Initial Software Extraction
Click Next.
13. Configuration - Information Gathering
Enter the AS Java Administrator Password and click Continue.
Note: This is not the same password that was configured for the SUM
authentication.
Another step list is executed. Wait until Component Status is displayed. Click
Continue.
Another step list is executed. Wait until System Parameters are displayed. Click
Continue.
Another step list is executed. Wait until a success message is displayed. Click
Next.
14. Checks - Requirements Check
A step list is executed. Wait until a success message is displayed. Click Next.
15. Preprocessing - Update Preparation
A step list is executed. Wait until Begin Update is displayed. Click Continue.
Click Next.
Another step list is executed. Wait until a success message is displayed. Click
Next.
16. Execution - Actual Update
A step list is executed. Wait until a success message is displayed. Click Next.
17. Postprocessing - Post-Update Activities
A step list is executed. Wait until Update Complete is displayed. Click
Continue.
Wait until a success message is displayed. Click Next twice.
18. Summary and Evaluation of the Process
Summary and Feedback Form are displayed. Click Next.
You can send an email to SAP. To finish the package installation, click Exit.
A summary page is displayed.
For a description of the configuration with SAP NetWeaver 7.3, 7.4, and 7.5, see
“Creating AppIntegrator iViews for users with SAP NetWeaver 7.3, 7.4, and 7.5”
on page 168 and “Creating roles for users with SAP NetWeaver 7.3, 7.4, and 7.5”
on page 182.
Note: For information on how to change the title of the iView, page, workset,
or role, refer to the SAP NetWeaver Portal Administration Guide from SAP.
As the SAP NetWeaver Portal administrator, you create the Appintegrator iView. To
make the application available for SAP NetWeaver Portal users, you have to
perform the following steps:
1. Login to SAP NetWeaver Portal as Administrator and expand Portal Content >
Content Provided by Other Vendor.
2. Create a folder under End User Content or under another location, if wanted.
4. In the iView wizard, click Portal Component – create an iView from a portal
component ... and click Next.
• Description
10. In Property Editor, scroll to the Entry Point line and click Yes.
Scroll to the HTTP Request Method line and select HTTP:GET.
Click Save.
$host$
NWAS server name where the Approval Portal J2EE application was
deployed
$port$
Port of that NWAS
To create AppIntegrator iViews for users with NetWeaver 7.3, 7.4, and 7.5:
3. Right-click End User Content, point to New, and then click Folder.
4. On the New Folder tab, enter Folder Name and Folder ID Prefix (for example,
com.opentext); then click Finish at the bottom of the page.
8. Navigate to Portal Content > Content Provided by SAP > End User Content.
9. In the Approval Portal folder, paste the Generic iView as PCD Object. See the
following screenshot.
13. From the Show Category list, select Content - Generic Launcher.
URL Template
http://<host name>:<port number>/vimportal/?urlView=
Y&PORTALUSER=<User.UserID>
The URL is different for the Admin iView:
http://<host name>:<port number>/vimportal/admin?urlView=
Y&PORTALUSER=<User.UserID>
Enter the following values:
<host name>
Name of the NWAS where the Approval Portal J2EE application was
deployed.
<port number>
Port of that NWAS.
15. To create an Admin iView, repeat Step 1 to Step 14. Choose the relevant URL
Template from Step 14.
1. In the SAP NetWeaver Portal, navigate to the folder you created in “Creating
AppIntegrator iViews for users” on page 162.
3. In Step 1, enter Role Name, Role ID, Role ID Prefix and Description.
Select the Master Language.
Notes
4. Click Next.
5. Click Finish.
7. In Property Editor, scroll to the Entry Point line and click Yes.
Click Save.
9. Click Close.
16.4.4 Creating roles for users with SAP NetWeaver 7.3, 7.4,
and 7.5
After creating a new AppIntegrator iView, you must create a role and add the
AppIntegrator iView to the role.
To create roles for users with SAP NetWeaver 7.3, 7.4, and 7.5:
1. In the SAP NetWeaver Portal, navigate to the Approval Portal folder; see
“Creating AppIntegrator iViews for users with SAP NetWeaver 7.3, 7.4, and
7.5” on page 168.
2. Right-click on the folder, select New > Role > Freestyle Role.
3. Enter properties as shown in the screenshot above: Role Name, Role ID, Role
ID Prefix and Description.
Select the Master Language.
Note: Role ID Prefix is not mandatory. If you enter this parameter, you
must search by giving Role ID Prefix and Role Name when assigning the
role to the user.
4. Click Finish.
6. Enter the Name (as shown in the screenshot) and select the Entry Point check
mark.
Click Save.
8. To create an Admin role, repeat Step 1 to Step 7. Enter the relevant name for the
Admin role.
9. Click Close.
2. In the Search Criteria, enter the users or groups you want to assign to the new
role (created in “Creating roles for users” on page 178).
Click Go.
4. Click Modify.
5. In the Search Criteria field, search for the new role you created and click Go.
7. Click Save.
The following screenshot shows a role being assigned to a demo coder.
You can use Approval Admin for the iView Name and Approval Admin Role for the
role.
The only difference from the user configuration is the URL template:
http://$host$:$port$/vimportal/admin?urlView=Y&PORTALUSER=<User.
UserID>
See Step 11 on page 167 for details on the URL template for users.
Once you have finished the creation of the Administrator iView and the role, assign
it to the appropriate administrators, as described in “Assigning roles to SAP
NetWeaver Portal users” on page 185.
When you, as the administrator, navigate to the Approval Admin iView, it will look
like the following screenshot:
You have now finished the installation and configuration of the OpenText Approval
Portal.
• Undeploy the old and deploy the new .SCA file, and
• Freshly install the OpenText installation directory.
Make sure that all files mentioned in opentext.zip are deployed correctly.
For an upgrade from Approval Portal 7.0 (new UI) to 7.6, you can reuse the original
configuration.xml file. However, it is best to make a backup of the
configuration.xml. For all other upgrade paths, OpenText recommends that you
use the new configuration.xml.
If you changed the language properties files from the previous version and would
like to reuse them in VIM 7.5, change the new language properties files manually.
To upgrade, perform the actions described in “Applying a new patch” on page 187.
16.7 Troubleshooting
For information on troubleshooting the Approval Portal, see Section 9.11.12
“Troubleshooting” in OpenText Vendor Invoice Management for SAP Solutions -
Administration Guide (VIM-AGD).
To support Unix or Linux operating systems, you must maintain the Domain field
with the same value, as maintained in the Windows Domain column in the COA
table. For details about the COA configuration, see Section 3.1.4.1 “User Details
View” in OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide
for Invoice Solution (VIM-CGD).
Example: If the Windows Domain column in the COA table is not maintained for users,
leave the Domain field in the Configuration tab of the Approval Portal Administration
console empty as well.
1. Connect to the SAP Software Deployment Manager (SDM) in the host server:
You find SDM in the following directory: usr/sap/<SID>/<INSTANCE_NAME>/
SDM/program.
Notes
Refer to the Software Deployment Manager Guide for more details on how to
use SDM.
4. Click Select.
To undeploy the Approval Portal with SAP NetWeaver 7.3, 7.4, and 7.5:
Note: First, unassign the role if you already have assigned it to a user.
4. Navigate to the folder that was created in “Creating AppIntegrator iViews for
users” on page 162.
Removing the startup parameter, using the J2EE Config Tool, finishes the
uninstallation process.
Notes
Example: -Dcom.opentext.vim.portal.invoiceCfg=c:/opentext/
invoiceCfg
This part describes the installation of the Mobile Approval Portal, which is an
enhancement to the Invoice Approval. Users can approve their invoices, using a
mobile device, for example a Blackberry, an iPhone, or an iPad. The Mobile
Approval Portal is based on HTML5.
Note: The Mobile Approval Portal is an optional component. If you are not
using the Mobile Approval Portal, you can skip this part.
For information on the configuration of the Mobile Approval Portal, see Section 7.9
“Configuring the Mobile Approval Portal” in OpenText Vendor Invoice Management
for SAP Solutions - Administration Guide (VIM-AGD).
The Mobile Approval Portal component is enhanced with the mobile capabilities
Sencha Touch. This enriches the look and feel on the supported mobile platforms.
For detailed information about Sencha Touch, see http://www.sencha.com/products/
touch/features/.
Operating The Mobile Approval Portal supports Windows, Unix and other operating systems
systems supported by SAP.
The following table shows which mobile operating systems, devices, and browsers
are fully supported.
Web Viewer Mobile Approval Portal users can display invoices using OpenText Imaging Web
integration Viewer.
Important
If you have not installed Web Viewer or Brava! View, OpenText recommends,
as a general advice, that you create PDF files from scanning and use the PDF
viewer that is installed on your computer for displaying invoice images.
Web Viewer is a web application for displaying and printing documents in Web-
based scenarios and for appending comments to these documents. The documents
may be stored in OpenText Archive Center or other repositories.
The Web Viewer integration is completed for the invoice document and supports all
documents supported by Web Viewer.
On the Mobile Browser without Web Viewer, it is not possible to render TIFF
documents. JPG, PNG and GIF documents are supported to be shown in browser by
default. To support PDF documents, a specific browser-plugin or a separate viewer
app is needed.
However, Web Viewer is able to display TIFF documents on the Mobile Browser on
Mobile Approval Portal.
Web Viewer is installed on a web server. It generates HTML pages containing the
document to be displayed and sends them to the browser. The Web Viewer can be
used by any leading application server configured appropriately.
Limitations
Notes
The Mobile Approval Portal uses domain authentication. It can be accessed using
WiFi or VPN on the same network or on an external network.
To access from external network without WiFi or VPN, keep the Mobile Approval
Portal URL in the DMZ and connect with Virtual Host. This requires IT help to
configure the URL in the DMZ.
Note: For security reasons and also to grant stable access to the Mobile
Approval Portal, OpenText recommends that you use a VPN connection.
The detail authentication mechanism is the same as for the Approval Portal, for
example, which SSO mechanism is used. See “Preparing installation” on page 135
Important
If you have not installed Web Viewer or Brava! View, OpenText recommends,
as a general advice, that you create PDF files from scanning and use the PDF
viewer that is installed on your computer for displaying invoice images.
To ensure security for the Web Viewer integration, OpenText recommends that you
verify the “Use Signature” setting in /IXOS/OA_CUST_A with the following
prerequisites:
Notes
• OpenText recommends that you use the latest patch available for these
versions.
• See also the Release Notes of Archiving and Document Access for SAP
Solutions 10.5.
The Mobile Approval Portal supports Windows, Unix and other operating systems
supported by SAP. For the Web Viewer installation, see the appropriate section in
Section 3 “Installing Web Viewer” in OpenText Imaging Web Viewer - Installation and
Configuration Guide (CLWEBV-IGD).
To install Web Viewer 10.5, 16, or 20.3, download the software from OpenText My
Support.
To apply the latest patch for Web Viewer 10.5, 16, or 20.3, download the software
from OpenText My Support.
Notes
• OpenText recommends that you use the latest patch of the supported Web
Viewer software version.
• OpenText also recommends installing Web Viewer on a NetWeaver 7.3, 7.4,
and 7.5 instance where Mobile Approval Portal is not running or on a
supported Tomcat version. This approach improves the performance of
viewing invoice images on Mobile devices.
• OpenText also recommends installing Web Viewer on the same domain as
the Archive Center and SAP NetWeaver Application Server Java.
• Web Viewer 16 and Brava! View 16.2 versions are not supported on the
Mobile Approval Portal. For more details on Web Viewer and Brava! View
support, see the Web Viewer Support and Brava! View Support sections in
the Release Notes.
The Mobile Approval Portal software component is packaged along with the
Approval Portal component. The installation of the Mobile Approval Portal is
similar to Approval Portal. Refer to “Installing the Approval Portal” on page 143.
The Mobile Approval Portal software component is packaged along with the
Approval Portal component. The installation of the Mobile Approval Portal is
similar to Approval Portal. Refer to “Installing the Approval Portal” on page 143.
17.4.2.1 Prerequisites
The following versions are supported:
3. Deploy the Approval Portal with the officially supported Support Package.
2. Deploy the Approval Portal with the officially supported Support Package.
This part describes the installation of the Vendor Invoice Management SAP
NetWeaver Business Warehouse (VIM BW) component.
The same procedure must be followed when upgrading the component OTVIMBW
from the following earlier versions:
• OTVIMBW 700
• OTVIMBW 700_730
1. Locate the OTVIMBW component SAR file on the installation media in the folder
Software\Invoice Solution\ABAP Addons. In the SAINT transaction, load
the .SAR file from the front end. Alternatively, extract the .PAT file from
the .SAR file and put the .PAT file into the application server transport directory
\usr\sap\trans\EPS\in.
2. Add the support packages (if available) to the queue, using the same procedure.
Adding support packages at this point saves time and is a safer variant of the
installation.
3. Carry out the import of the package as described in the respective SAP
documentation.
2. In the System: Component information dialog box, you should see the OTVIMBW
add-on component installed, with Release number 80700_006.
This part describes the installation of the Vendor Invoice Management BW/4HANA
add-on (VIM BW/4HANA) component.
The VIM BW/4HANA add-on delivers the same content as the content delivered by
VIM BW 7.0. While VIM BW 7.0 can be installed on BW 7.5 systems (also on HANA
database), VIM BW/4HANA 100 can be installed on a SAP BW/4HANA system. The
version number 100 implicates that the add-on is created for a BW/4HANA system
installed with component DW4CORE version 100.
The VIM BW/4HANA component is a new add-on for the new SAP product BW/
4HANA. It is not the successor of any VIM BW add-on, therefore the upgrade from
any earlier VIM BW add-on to BW/4HANA is impossible.
All custom views and queries created for the VIM BW add-on must be recreated
again using the new Composite Providers delivered in the VIM BW/4HANA add-
on. Tools for creating BW frontend reports must be SAP tools compatible with the
SAP BW/4HANA platform.
The OLTP (source) system for VIM BW/4HANA must be an SAP S/4HANA system
installed with VIM 16.3 or later.
The following list shows the main differences between the two VIM add-ons:
• The VIM BW/4HANA add-on is content delivered for the new SAP BW/4HANA
product, not for other SAP BW versions.
• The VIM BW/4HANA content is communicated with the OLTP system using
ODP Framework. ODP-enabled DataSources (ODP – SAP Extractors) are used
instead of BW Extractors.
• PSA (Persistent Source Area) is not supported any more. Data load from source
system will be written directly in advanced DSO.
– All transformations are either converted or created for the new objects
– All DTP (Data Transfer Processes) are created for new objects.
• Like in VIM BW 7.0, the VIM BW/4HANA 100 content provides the same set of
Query Variables, which can be used in queries to offer the user a selection
regarding the variables.
• Process Chains are created for new VIM BW/4HANA objects. Their names in the
BW/4HANA version begin with /OPT/VIM_B4H. Their purpose is the same as
the two meta process chains delivered in VIM BW 7.0.
• Documentation: this part of OpenText Vendor Invoice Management for SAP Solutions
- Installation Guide (VIM-IGD).
Note: For the latest compatibility information for OpenText products, refer to
the Compatibility Matrix on My Support: https://knowledge.opentext.com/go/
matrix.
Note: This transport will be included into the VIM package as soon as the
uninstallation of objects is supported by SAP tools.
2. Call transaction SAINT (in client 000). On the initial screen, which shows the
installed components, load the package OTVIMBW4_INST_100_004.SAR from
Front End using the menu Installation Package > Load packages > SAR
archives from Front End.
4. After installing, verify that the system is successfully installed: On the menu,
click System > Status. Click the Component icon for the Product Version, all
components are displayed:
This part describes the installation of the Vendor Invoice Management SAP
NetWeaver Gateway package (VIM GW). The VIM GW component is needed to run
the Supplier Self Service component.
Note: This component is not supported in the VIM 7.5 version for SAP S/
4HANA on Premise.
SAP_BASIS Password
751 and later 8099C251AB
• Implement SAP note 1744864: Multiple Origin for Generated BOR/RFC Objects
does not work
On the product CD, the single PAT files are archived in SAPCAR files (extension
*.SAR), which can be extracted using the SAPCAR command line tool.
3. On the menu, click Installation Package > Load packages > From Front End
and load file OTVIMGW_81610_106.SAR.
5. Choose the package for component OTVIMGW. Carry out the import of the
package as described in the respective SAP documentation.
Therefore, run the SE03 transaction, and, under Administration, run Set System
Change Option.
This part describes the installation of the Vendor Invoice Management Supplier Self
Service - Lean Variant component.
The Supplier Self Service lean variant is enabled for multiple deployment options:
Operating This section covers support and restrictions of Supplier Self Service in regards to
system and operating systems and web browsers.
browser support
• The Supplier Self Service web application does not support any mobile operating
systems. It does not support any other operating systems than Windows.
Therefore, Mac/iOS, Linux, and Android operating systems are not supported.
• For supported browsers, see SAP note 1716423: SAPUI5 Browser Support for
Mobile and Desktop Applications
• Some additional browser settings are necessary:
Firefox
You must customize the language preferences: Go to Tools > Options, and
click the Content tab. In the Languages area, click Choose.
Add languages from the Select a language to add list. When performing
an HTTP request, Firefox will send all the languages chosen with the Accept-
Language header in the order of preference in which they are arranged in the
list.
Windows Internet Explorer 9
The website might appear blank or might not be displayed correctly. In this
case, set and use the Compatibility View on the menu bar of the browser:
SAP user The communication with the SAP NetWeaver Gateway system is accomplished by
using a Service user ID. Creation and assignment of the specific profile is described
in Section 21.1.3 “Configuring Gateway users” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD).
The on-premise application is part of the GW 740 package, and will be automatically
deployed to the ABAP stack.
If you plan to use the On-Premise deployment, skip “Installation on the SAP HANA
Cloud” on page 219.
Note: You need an SAP account for accessing the SAP HANA Cloud.
1. Log on to the cockpit, and click Java Applications in the navigation area.
3. In the Deploy Application dialog box, select the specific WAR file
vimsupplierselfservice.war to deploy. Initially the Cockpit proposes the
same name as for the WAR file. OpenText recommends that you enter the
application name vim3s but you can choose any other identifier you want.
Note: The application name must start with a letter, can contain lowercase
letters and numbers only, and must not exceed 30 characters. You can also
assign a display name and a description to the Java application.
5. Click Deploy to deploy the WAR file to the cloud platform. The Deploy
Application dialog box remains on the screen while the deployment is in
progress. When the deployment is finished, a confirmation appears that the
application has been successfully deployed.
Next steps To make your deployed application available for requests, you must start it inside
the SAP HANA Cloud Cockpit. For more information, see Section 21.2
“Customizing the HANA Cloud Server (option)” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD).
You can update or redeploy the application with a new WAR file or make changes
to the configuration parameters whenever required. To open the Deploy
Application dialog box in update mode, click Update application.
Important
The SAP HANA Cloud connector must not be used with products other than
SAP HANA Cloud Platform.
Note: OpenText strongly recommends that you use the latest version of the
SAP HANA Cloud connector software. Due to known security vulnerability
risks, do not use any version of SAP HANA Cloud connector earlier than 2.4.1.
This part describes the installation of the Vendor Invoice Management electronic
invoices component.
Currently, this covers Italian FatturaPA, German XRechnung, and generic electronic
invoice (UBL). For general information about e-invoicing, see Section 10 “Processing
electronic invoices” in OpenText Vendor Invoice Management for SAP Solutions -
Scenario Guide for Invoice Solution (VIM-CCS).
The minimum supported VIM release and support package levels for the transport
deliveries are VIM 7.5 SP7 with Business Center 16.3 Update 1, and VIM 16.3 with
Business Center 16.3.
For more information about the transport deliveries, see VIM 7.5 SP11 or VIM 16.3.5
Installation Guides that are provided on OpenText My Support.
22.2.1 Prerequisites
The objects for integration with SAP Document Compliance are delivered as a new
component OTBCSL38. Before the installation, make sure that you installed and
configured the prerequisites.
The following table lists the SAP notes to be implemented for specific scenarios. It
assumes that you have already installed and configured SAP Document
Compliance / eDocument Framework.
Note: You find the most current list of the SAP notes in SAP documentation
and support documents.
Note Scenario
2777052 - eDocument: Prerequisites for SAP Note 2765690 General
2765690 - eDocument Framework (21) General
2771424 - eDocument Italy: Enhancements for Incoming
Italy
Invoices
2690949 - eDocument Germany - EU eInvoicing: Overview Note Germany
2690993 - eDocument Germany - EU eInvoicing: Prerequisite for
Germany
SAP Note 2613785
2613785 - eDocument Germany - EU eInvoicing Germany
2690958 - eDocument Germany - EU eInvoicing: Configuration
Germany
and Customizing
2805582 - eDocument Germany - EU eInvoicing: Corrections Germany
2618098 - eDocument EU: Prerequisite for SAP Note 2523477 General/PEPPOL
2523477 - eDocument EU: eInvoice General/PEPPOL
Note Scenario
2432169 - eDocument EU: ABAP Proxy Objects General/PEPPOL
2433472 - eDocument EU: Prerequisite for SAP Note 2390901 General/PEPPOL
2390901 - eDocument EU: AIF Implementation General/PEPPOL
2440686 - eDocument EU: AIF Customizing General/PEPPOL
2442063 - eDocument EU: AIF Setup General/PEPPOL
2778717 - eDocument EU: AIF Interface Connector
General/PEPPOL
Implementation
2783795 - eDocument EU PEPPOL: Installation Overview General/PEPPOL
2813297 - eDocument EU: Prerequisites for SAP Note 2805188 General/PEPPOL
2805188 - eDocument EU: eInvoice Corrections General/PEPPOL
2423423 - eDocument Netherlands - EU eInvoicing: Prereq. for
Netherlands
SAP Note 2438748
2438748 - eDocument Netherlands - EU eInvoicing Netherlands
2420449 - eDocument Netherlands - EU eInvoicing:
Netherlands
Configuration and Customizing
2819556 - eDocument Netherlands: Enablement for Push
Netherlands
Scenario
2805560 - eDocument Netherlands - EU eInvoicing: Corrections Netherlands
22.2.2 Installation
If you have purchased VIM through SAP, you can download the installation
package from SAP Marketplace. In case you purchased VIM directly from OpenText,
install the component OTBCSL38 using the SAINT transaction or with other tools like
SAP Maintenance Planner.
Password: 8B87C935A7
VIM can be integrated with Ariba® Network. For detailed information about the
integration, see Section 23 “Integration with the Ariba Network” in OpenText Vendor
Invoice Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-
CGD). When you have decided which integration scenario you want to use, you can
perform the appropriate installation and configuration steps as described in the
following sections.
If you decide to use PI-based integration, or for Ariba CIG integration, you must
import additional transports. For more information, see the sections later in this
guide.
Note: Consider the most recent Release Notes for latest information on new BC
sets and additional post installation activities.
1. Run the SPRO transaction and navigate to the following node: Integration with
Other SAP Components > Business Network Integration > Integration with
the Ariba Network > Application-Specific Settings > Business Add-Ins
(BAdIs) > BAdI: Outbound Mapping
2. In the Outbound Mapping, select the Active check box (very first column) for
the implementation /OPT/EH_E_ARB_BADI_OUTB_MAPS4.
In case of an SAP S/4HANA conversion from SAP ERP, if you already had the
Ariba integration component OTVIMARB installed, you might have the older
implementation /OPT/EH_E_ARB_BADI_OUTB_MAP active in the Outbound
Mapping. To set it to inactive, clear the check box.
You can select Ariba CI components to be used for your Ariba integration project
with the PI scenario. If you need to send status updates from SAP S/4HANA back
into the Ariba Network, you need to import a set of transports and then adjust the
VIM configuration as described in Section 23.2 “Integrating the Ariba SAP
NetWeaver Process Integration adapter” in OpenText Vendor Invoice Management for
SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD). The adapter
version CI-8 and later is supported.
Because of dependencies on the Ariba CI-8 adapter, OpenText delivers the necessary
ABAP workbench objects as a separate set of transport files. You find the transport
files on My Support.
The delivery of the transport files is provided with VIM 7.5 SP5. This scenario is
supported by VIM 7.0 SP3 and VIM 7.5 SP1 and later VIM versions, including 16.3
and 20.4. You can use the provided transport files with the mentioned older VIM
versions and SPs.
1. On My Support, access VIM 7.5 SP5 and Ariba Cloud Integration with PI.
1. EW3K901050
2. EW3K901080
3. EW3K901083
This part describes the installation of the additional objects required to integrate
VIM with Ariba Network using the Ariba Cloud Integration Gateway (CIG).
SAP Ariba Cloud Integration Gateway (CIG) is the recommended integration option
to integrate VIM with Ariba Network.
The minimum VIM release and SP levels are VIM 7.5 SP5 with Business Center 16.0
update 1, and VIM 16.3 with Business Center 16.3. On VIM 7.6 and 20.4, the initial
package and all later SPs are supported.
Component: Component:
Option VIM release
ARBCI1 ARBCI2
1 SAP ERP 6.0 7.5, 7.6 100 100
2 SAP S/4HANA 16.3, 20.4 10S 10S
On the product CD, the single PAT files are archived in SAPCAR files (extension
*.SAR), which can be extracted using the SAPCAR command line tool.
You can also use the SAR files directly in the SAINT transaction.
1. Copy the respective SAPCAR file (*.SAR) from My Support to a local folder.
File – OTVIMARC_80700_006.SAR (for VIM 16.3/20.4 installation on SAP S/
4HANA)
3. On the menu, click Installation Package > Load packages > From Front End,
and then load file OTVIMARC_80700_006.SAR.
5. Choose the package for component OTVIMARC. Carry out the import of the
package as described in the respective SAP documentation.
Note: Before performing the import, verify whether you already have such an
entry. Save the values of non-key fields to restore them after import. The
corresponding IDoc mapping entries are created for development object
ARBCIG_INVOIC.
Note: Consider the most recent Release Notes for latest information on
new BC sets and additional post installation activities.
Before you start installing, the Foundation must be installed. For more information,
see “Foundation” on page 35.
Installing
This section describes the installation of the Solutions Beyond Invoice packages on
an SAP application server. For general information about installing in an SAP
environment, see also “Prerequisites for installation” on page 19.
Collect the installation files for the components listed in the corresponding sections.
Notes
• Customers who purchase VIM from SAP receive the packages from SAP
Marketplace.
2. Load the installation packages and support packages from the front end by
selecting the respective SAPCAR file (*.SAR) from the local file system. The
SAPCAR file is decompressed automatically.
3. Carry out the import of the packages and support packages as described in the
SAP documentation.
4. After the import has finished, continue with the activation of the BC sets. For
more information, see:
You can bypass messages you might get during installation. These warn you
about not digitally signed packages/software.
OTBCSLOC
OpenText VIM Order to Cash.
Mandatory if you want to use the preconfigured Remittance Advice, or Sales
Order processing solutions of Order to Cash .
OTBCSLPP
OpenText VIM Procure to Pay.
Mandatory if you want to the preconfigured Delivery Note, Order
Confirmation, or Quotation processing solutions of Procure to Pay.
The Solutions Beyond Invoice components for S/4HANA are used as follows:
OTBCS4OC
OpenTextVIM S/4 Order to Cash.
Needs to be installed if you want to use the embedded analytics capabilities for
Remittance Advice or Sales Order.
OTBCS4PP
OpenText VIM S/4 Procure to Pay.
Needs to be installed if you want to use the embedded analytics capabilities for
Delivery Note, Order Confirmation, or Quotation.
Notes
Notes
• Sales Order
• Remittance Advice
• Install the OpenText VIM Order Cash (OTBCSLOC) add-on using the SAINT
transaction.
• Delivery Notes
• Order Confirmation
• Quotations
• Install the VIM for SAP Procure to Pay Solutions (OTBCSLPP) add-on using
the SAINT transaction.
To upgrade the Solutions Beyond Invoice component, you must also upgrade the
Foundation component. This also applies the other way round for a Foundation
upgrade. For more information, see “Upgrading“ on page 63.
Note: Several solutions that were formerly separate, are now included in one
of the listed packages. If you installed one of the solutions, that are listed here,
you must also install the related solution within one step with
the OTBCBAS and the OTBCSL00 add-on.
Caution
The Solution for Incoming HR Documents (component OTBCSL05) is not
included in Vendor Invoice Management 7.6 or 20.4. Before upgrading to
Vendor Invoice Management 7.6 or 20.4, check if the component OTBCSL05
is installed. If this is the case, uninstall it before the upgrade. By doing this,
all objects including data of the Solution for Incoming HR Documents are
deleted. No other solutions are affected. If OTBCSL05 is not installed, no
action is required.
• E914DBE8165BA2F196340050560113B8
• E9157F793F770DF196340050560113B8
• E73EB8F34F90A6F19EC50050560113B8
• E73EB975BADD30F19EC50050560113B8
• E7768D17052979F19EC50050560113B8
• E792185A3EFCABF19EC50050560113B8
• E7921869F37C3DF19EC50050560113B8
VIM add-ons, see list in “Installing“ on page 37, can be deleted. It is definitely the
decision of the customer to delete an add-on and thereby lose data in the VIM tables.
Important
The VIM add-ons must be deinstalled in the following sequence due to package
dependencies in the import conditions. Add-ons to be deinstalled must exist in the
system.
1. OTBCSLPP.
2. OTBCSLOC
3. OTBCSL00
4. OTBCRM
5. OTBCWUI
6. OTBCS4PP
7. OTBCS4OC
8. OTBCS4
9. OTBCBAS
27.2 Prerequisites
Mandatory SAP Notes
2507738
Change to object directory entry of DDLS-dependent VIEWs and STOBs
Important
Example: If workflows were started in the system, the entries in the SAP workflow
tables remain.
The following instructions does not cover the removal of this data.
• OpenText recommends that you select all VIM related components in one
deinstallation run. The following steps are based on a complete
deinstallation, including all Business Center components.
Note: Sections that are marked with (VIM) at the beginning of the heading are
only relevant for VIM, other sections also for Business Center.
During workflow runtime, temporary objects are created by the workflow runtime
environment. You have to delete these objects manually using the SWF_CNT_STR_
EDIT transaction. Delete local types for structures (if present) with the field Package
pointing to the following packages:
• /OTX/PF02
• /ORS/000007
• /OPT/VIM
Delete table entries in table /OTX/PF62_T_AIC (Fiori Advanced Line Items). The
deinstallation program cannot remove these entries automatically. Delete these
entries in all clients.
Layouts have been imported by a separate transport. You have to delete them
manually before deinstallation.
• Run the /OPT/VIM_VA2 transaction, and click the Processes tab: Manage Layouts:
Delete layouts /OPT/VA2_P01.
• Run the /OPT/VIM_VA2 transaction , and click the Line items tab: Manage
Layouts: Delete layouts /OPT/VA2_I01 and /OPT/VA2_I02.
You need to clear table entries for the VIM GOS menu if they are available.
1. Run the SM30 transaction to maintain the SGOSATTR table and delete the
following entries if they are present:
WF_ZOPT/VIM
OpenText DP Document > Document Dashboard
ZOPT_SERVC
OpenText Dashboard > OpenText Dashboard
You have to remove the Business Transaction Event (BTE) customizing manually
before deinstallation.
2. Run the BF22 transaction and remove entry /OPT/VIM > /OPT/ OpenText Vendor
Invoice Management.
3. Run the BF23 transaction and remove entry /OPT/VIM > /OPT/.
4. Run the BF24 transaction and remove entry /OPT/VIM > OpenText VIM.
5. Run the BF32 transaction and remove all entries with handler names beginning
with /OPT.
6. Run the BF42 transaction and remove all entries with handler names beginning
with /OPT.
• Run the SWETYPV transaction and remove the following linkages (if present):
You might have created implicit enhancements in the SAP includes LMR1MF3U and
LMR1MF3S. For more information, see Section 8.11.3 “Enhancing MIRO for pre-
population of data during online invoice creation” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-CGD). In
this case, you must delete those implicit enhancements prior to removing OpenText
add-ons.
You might have used the Ariba Network integration with PI and imported the
required transports. For more information, see “Importing ABAP workbench
objects, PI scenario” on page 229. In this case, you must delete the corresponding
objects manually. Perform this first in a development system. Then import the
resulting transport into each system prior to removing OpenText add-ons. This
applies to the following objects:
• Class /OPT/CL_E_SUPPLIER_NETW_ARB_PI
• Class /OPT/CL_IM_VIM_ARB_PI_OUTB
• BAdI Implementation /OPT/VIM_ARB_PI_OUTB
• Package /OPT/VIM_ARB_PI
Before:
After (example):
27.3.3 Troubleshooting
27.3.3.1 Error in phase CHECK_LOCKED_OBJ
Symptom After post-installation step “Maintaining the SAPscript form for approval”
on page 86 is done, the following error occurs:
Solution Release the mentioned transport and click Repeat to repeat the deinstallation step.
Solution If the mandatory SAP Note 2507738 has not been installed before deinstallation, you
need to manually set the entries to source system “SAP”. You can use the following
coding in a custom created report:
UPDATE tadir SET srcsystem = 'SAP' WHERE object = 'STOB'
AND srcsystem = sy-sysid AND obj_name LIKE '/OPT/%'.
Custom objects
Solution Not all custom objects referencing to objects in the OTEXVIM component have been
removed. Delete all mentioned objects.
Modifications
Symptom The deinstallation stops at phase CHECK_MOD, if modifications are still present.
BUS2017 /OTBC/1DN1
BUS2017 /OTBC/1DN2
BUS2032 /OTBC/2SO1
BUS2032 /OTBC/2SO2
BUS2012 /OTBC/9OC1
BUS2012 /OTBC/9OC2
Remove services
Delete all services within SICF: OData and UI Services which have been
activated according to Installation Guide
After Image
Technical option to realize an delta upload from the source systems into the SAP
NetWeaver BW system. A data record loaded as After Image provides the status
of the record after it has been changed, or after data has been added.
Aging Report
Part of the Central Reporting infrastructure. The Aging Report reports about the
aging of documents and work items in the current system.
Approval Portal
VIM web interface for approving invoices.
Archive system
Computer system that enables storage, management and retrieval of archived
data and documents
ArchiveLink
Service integrated in the SAP NetWeaver Application Server ABAP for linking
archived documents and the application documents entered in the SAP ERP
system.
Authorization profiles
The SAP administrator assigns authorizations to the users that determine which
actions a user can perform in the SAP system. These authorizations are stored in
Authorization profiles.
Automation Report
Tool that provides data about automated and manual processing steps of VIM
documents
BAdI
BAPI®
SAP programming interface: Business Application Programming Interface
Baseline
Set of functionality with pre-defined configuration and the starting point to
implement VIM
BasisCube
See: InfoCube
BDC ID
Business Data Communication ID. The BDC ID is used by the system to process
an SAP transaction to create an SAP Document in user context.
Block
Situation where an invoice has a price or quantity variance that prevents invoice
from posting
BTE
Business Center
The name Business Center groups features of the VIM product that help receiving
incoming documents, capturing processes, and filing them within a SAP system.
These feature are an addition to the Vendor Invoice Management features that
form the VIMproduct.
Business rules
Rules that describe the operations, definitions and constraints that apply to an
organization
Central Reporting
Reporting infrastructure that provides several reports that enable you to measure
certain properties of VIM documents and their work items, in order to optimize
working with VIM. Central Reporting comprises the following individual reports:
Aging Report, Central Audit Report, Exception Analysis Report, Key Process Analytics
Report, Productivity Report, and Summary Report.
Characteristic
Type of InfoObject in SAP NetWeaver BW that represents descriptions of fields,
such as Vendor ID, Invoice Number, Unit of Measure, and Posting Date.
COA
Coding
Coding allocates an invoice to G/L account and cost object if required.
Dashboard
User interface that organizes and presents information in a way that is easy to
read. Users can also perform actions from the dashboard.
DataSource
Set of fields in SAP NetWeaver BW that provide the data for a business unit for
data transfer to the SAP NetWeaver BW system; technically, it contains an extract
structure and an extraction function module.
DocuLink
OpenText™ DocuLink for SAP Solutions enables the archiving, management and
retrieval of SAP CRM or SAP S/4HANA documents from within the SAP
infrastructure.
Document type
Type of document such as PO, Non PO, OCR, Non OCR
DP
DSO
DTP
EDI
Exception
Action that is not part of normal operations or standards
FI
IAP
IDoc
IE
Inbound Configuration
Connection to various inbound channels, for example scanned paper documents,
fax, email, or IDoc, and the corresponding configuration. Business Center
Inbound Configuration is also used in VIM.
Indexing
Process of entering or storing data into the system
InfoArea
Folder in SAP NetWeaver BW to organize InfoCubes, DataStore Objects, InfoObjects,
and InfoObject Catalogs
InfoCube
Self-contained dataset in SAP NetWeaver BW, for example, of a business-oriented
area; an InfoCube is a quantity of relational tables arranged according to the
enhanced star schema: A large fact table in the middle surrounded by several
dimension tables
InfoObject Catalog
Folder structure in SAP NetWeaver BW to organize InfoObjects
InfoObject
Smallest information unit in SAP NetWeaver BW. Key figures and Characteristics
are collectively called InfoObjects.
InfoPackages
Object in SAP NetWeaver BW that specifies when and how to load data from a
given source system to the SAP NetWeaver BW system
InfoProvider
Object in SAP NetWeaver BW for which queries can be created or executed.
InfoProviders are the objects or views that are relevant for reporting.
Invoice characteristic
A value specific to each invoice (for example country) that allows flexible
processing in VIM. An invoice characteristic is determined during runtime and
depends on the corresponding index data of the document.
Invoice coder
Person who enters the accounting info on invoices to allocate the cost
Invoice requester
Person who requested goods and services for Non PO invoices
Key Figure
Type of InfoObject in SAP NetWeaver BW that represents numeric values or
quantities, such as Number of Invoices and Gross Invoice Amount.
KPI Dashboard
Tool for managers showing VIM related process data at a glance in graphical
charts.
LIV
MM
MultiProvider
Object in SAP NetWeaver BW that is based on InfoCube(s), DataStore Object(s),
and/or InfoObject(s). A MultiProvider is used as a layer for the creation of end user
queries; the MultiProvider itself does not contain any data; rather, data resides in
the BasisCubes.
Namespace
Name range reserved by SAP for customer objects and SAP objects to make sure
that objects are not overwritten by SAP objects during the import of corrections or
an upgrade
Number range
Array of numbers that can be used for an object in the SAP S/4HANA system
OCR
Park
Situation where an invoice is not posted and is waiting for further processing
Perspective
Web Services element that defines which item related data is displayed in the
Fiori Task App and where. A perspective defines the content and visual
appearance of items for a specific area of the screen in the Fiori Task App. The
Fiori Task App displays only one perspective at the same time.
PIR
PO
Price variance
Situation where the price on the invoice is different from the price in the purchase
order
Process Chain
Sequence of processes in SAP NetWeaver BW that are scheduled to wait in the
background for an event; used to automate, visualize and monitor the processes.
Process Configuration
Easy and technically simplified configuration of complex business scenario
aspects. Process Configuration covers profile configuration, profile assignment,
and authorizations.
Process Foundation
Flexible framework to configure and run processes. It utilizes generic workflow
definitions, which are processed by the SAP Business Workflow engine.
Process options
Processing options for the user in the dashboard, such as Referral, Authorization,
and Actions
Process type
Process type for a document. The process type determines the initial actor and
various collaboration options available to the various actors during the process
flow.
Productivity Report
Part of the Central Reporting infrastructure. The Productivity Report reports
about the productivity of users/roles and the activities of users/roles.
PSA
Quantity variance
Situation where the quantity on the invoice is different from the quantity in the
purchase order
Roles
Set of predefined roles for the SAP user
Scan operator
Person who scans the invoices into images (may not have a SAP ID)
Summary Report
Part of the Central Reporting infrastructure. The Summary Report provides a
summary of all documents processed through VIM.
Transformation (TRF)
Object in SAP NetWeaver BW to connect source objects to data targets; it allows
to consolidate, cleanse and integrate data
TRF
VAN
VIM Workplace
Tool for VIM super users, which allows users to display lists of their work items
that meet a selection they have entered before. Users also can display work items
of other users and of their team as a whole.
Web Services
Underlying technical concept of the Fiori Task App interface. You configure the
complete content of the Fiori Task App either by customizing or by implementing
an interface for the Web Services.
Workflow
SAP Business Workflows can be used to define business processes that are not yet
mapped in the SAP S/4HANA system.