Professional Documents
Culture Documents
Administration Guide
VIM200404-AGD-EN-01
OpenText™ Vendor Invoice Management for SAP® Solutions
Administration Guide
VIM200404-AGD-EN-01
Rev.: 2022-Oct-28
This documentation has been created for OpenText™ Vendor Invoice Management for SAP® Solutions 20.4 SPS4.
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 readership ............................................................................ 14
1.2.2 Related documents ......................................................................... 14
1.3 Customer support ........................................................................... 15
1.4 High availability ............................................................................... 16
1.5 Understanding VIM ......................................................................... 16
1.5.1 Delivery model ................................................................................ 16
1.5.2 Workflow scheme ............................................................................ 17
1.5.3 Extensions to VIM ........................................................................... 18
Part 1 Foundation 19
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.
Product docu- The following documentation is available for VIM on OpenText My Support (https://
mentation knowledge.opentext.com/knowledge/cs.dll/Open/10151494):
• OpenText Vendor Invoice Management for SAP Solutions - User Guide for Invoice
Solution (VIM-UGD)
• OpenText Vendor Invoice Management for SAP Solutions - User Guide for Solutions
Beyond Invoice (BOCP-UGD)
• OpenText Vendor Invoice Management for SAP Solutions - Installation Guide (VIM-
IGD)
• OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Foundation (VIM-CGF)
• OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Invoice Solution (VIM-CGD)
• 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 - Configuration Guide for
Solutions Beyond Invoice (BOCP-CCS)
• OpenText Vendor Invoice Management for SAP Solutions - Security Guide (VIM-GSM)
• Documentation extensions
The Release Notes are updated continuously . The latest version of the Release Notes
is available on OpenText My Support (https://knowledge.opentext.com/knowledge/
cs.dll/Open/10151494).
If you bought the solution from SAP, you can open a message in the SAP Service
Marketplace for your component:
• Invoice:XX-PART-OPT-INV.
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.
Remote support is possible through the SAP solution manager with CSS message.
You must open the connection to the system and provide appropriate
authorizations.
For SAP J2EE based components, the Java role SAP_JAVA_SUPPORT is pre-delivered
with NetWeaver and recommended to be used for this purpose. For ABAP based
components, for example the role SAP_RCA_SAT_DISP is shipped via the ABAP add-
on component ST-PI.
Note: Only end user screens are translated in additional languages other than
English. Customizing screens are provided in English language only.
Validate metadata
The metadata or index data are validated against the SAP database. If validation
fails, an exception is triggered.
Check duplicates
The validated metadata is used to check whether the new invoice has been
entered already. If the new invoice is suspected to be a duplicate of any existing
invoice, an exception is triggered.
Apply business rules
Invoice pre-processing: Business rules are applied to detect additional
exceptions before posting.
Post for payment
The invoice is posted and released for payment.
The SAP transport management system will handle the custom development and
configuration changes.
Vendor Invoice Management has one-time administrative tasks like scheduling jobs
and regular administrative tasks like the administration of the SAP Workflow
Engine.
Workflow runtime administration covers several transactions that you can use to
monitor and control execution of workflows like the following.
For details how to administrate the SAP Business Workflow runtime, see the SAP
Help.
For further details, see Section 7.1.2.1 “Maintaining version settings” in OpenText
Vendor Invoice Management for SAP Solutions - Configuration Guide for Foundation
(VIM-CGF) (AUTH_CHECK_DATA method) and Section 8.1.1.1.1 “Authorization
Exit” in OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide
for Foundation (VIM-CGF).
• The status based document handler queue is managed with the document
handler job.
• Information Extraction Service in combination with look-up processing requires
download to staging tables.
• Redundant temporary data is deleted with the clean-up processing.
• Document extraction with Information Extraction Service (IES) is handled by the
IES request handler.
2. In the Inbound Processing - Trigger Handler screen, configure the batch job for
the document handler, using the following parameters.
Registration ID
Enter the specific registration ID from the /OTX/PF01_T_1REG table.
Channel
To run the report only for a specific inbound channel, enter the channel.
Classification Profile
To run the report only for specific business scenario, enter the classification
profile.
Module Handler
To run the report only for a specific Handler ID, enter the Handler ID.
Document Type
To run the report only for a specific ArchiveLink document type, enter the
document type.
Status
To run the report only for a specific document status, enter the status
3. Optional If you want to execute batch job continuously, you can define a
background processing event and plan a periodic job based on the event (see
SAP documentation for events in background processing).
Usually the report runs only within the minimum interval of one minute of the
periodic job scheduling but it provides additional options for an event based job
scheduling.
The report itself will raise the event at the end of the processing after the delay
is reached.
This program splits inbound documents into batches according to selections and
starts a background job with the document handler, for each batch.
The size of the batches and the number of jobs is defined on the selection screen.
The program selects the inbound documents according to their creation time,
starting with the earliest document.
Parallel runs of the document handler do not support an event based job scheduling.
For more informatin, see continuous job processing in “Document handler”
on page 22.
Tip: Make sure that the parameter values correspond to the document volume,
to prevent delays if more documents are outstanding than accepted for each
run, or process all relevant documents by splitting them into group jobs.
The following parameters are passed to the document handler, with the
registration ID that was used to build the document batches:
• Registration ID
• Channel
• Classification Profile
• Module Handler
• Document Type
• Status
• Test mode
If you use multibackend landscapes, you must run the programs on all related
systems.
The download programs create central data tables that contain all information that is
required for data recognition.
You can download the following SAP ERP databases to a central staging table:
• Vendor database
• Customer database
• Company code database
• Purchase order database
• Number range database
• Plant database
Note: Schedule the download programs as batch jobs. Thus, the job logs
provide information about the status of the job.
The OTBCSL00 component includes the programs and tables for calculating and
storing the staging data.
For systems that do not have this component, you can import the staging tables and
programs through a transport for temporary scenarios, such as, importing data in
test phases. For productive usage, the component OTBCSL00 must be installed.
Staging Table
Content
Management For some special use cases, you may need to upload/download data from other
sources or systems instead of the one you are using. For such use cases, the “Staging
Tables – Content Management” report allows the following operations:
Note: The “Change Staging Table Content” is only intended for small tables
with a few entries. To work with higher number of entries, use the
“Download” option and then change the downloaded CSV file.
Note: The staging table programs for Company Code, Customer, Vendor,
and Plant use the default address of an entity which is flagged in the
address table ADRC with field value NATION = blank. Other address
versions are not taken into account.
3. Add the selection criteria for vendor, customer, company code, or plant data for
the data transfer.
Most fields are self-explaining. Find some additional explanation for the
following fields:
4. Add the selection criteria for purchase order data for the data transfer.
Object name:
Set the object for the corresponding number range object. Relevant for the
scenarios is EINKBELEG object .
5. Save your selection criteria as variant and schedule the job with your variant.
You can use the reports for downloading the data to fill the staging table with data
from the current system. Use /OTX/PS00_P_IDF_STG_CLEANUP report to delete
entries in the staging tables
The execution of the reports requires an authorization for J_6NPF_ADM object with
“1” value for the J_6NPF_COM field in the local and the remote systems.
2.2.3 Clean up
You can run the /OTX/PF01_P_IDF_CLEANUP program and schedule it in
background to clean up temporary data. This kind of data has been created by the
inbound handler but is not needed afterwards.
OpenText recommends that you schedule the program once per month and that you
delete data older than 12 months.
2. In the Inbound Processing - Clean-up Tables screen, configure the clean up,
using the following parameters.
IES Sessions
Cancels all active extraction sessions. For each cancelled session a request is
sent to IES to also clean up temporary session data in the repository.
Default is to clean up sessions which are active for more than six month.
You can choose a lower value here. Consider that feedback is not accepted
for a document whose extraction session is already cancelled.
IES Table tab
Cleans up all temporary data (sessions, requests) for documents processed
by IES that have left the inbound handler and completed the extraction
session.
IES Pre-Learning tab
Cleans up all temporary data (sessions, requests) and results (extraction
result, feedback data) for documents that were processed within pre-
learning.
Month count
Indicates the minimum age of the entries to be deleted.
Active
Select this check box to activate cleaning for the selected tab.
If the check box is cleared, the tab is skipped. The green icon disappears
from the tab title.
In the Global settings area, you can select the following check boxes:
Additional options – The Application Logs tab and the Result Table tab
include additional options.
Application Logs includes the Delete IDOC entries as well check box. Select it
to specify that log entries with subobject IDOC are deleted as well.
Result Table includes the following check boxes:
You must configure this report as a periodic background job. The scheduling
frequency and scheduling type depends on the extraction service you are using.
Usually, the report should be scheduled periodically every minute. When using
Core Capture for SAP® Solutions, OpenText recommends that you use periodic
event-based job scheduling with a delay of 10 seconds. This improves the document
throughput compared to the periodic scheduling every minute.
Request ID
To run the report for only a specific request ID, enter the request ID. This
only makes sense for testing purposes.
Detect Timeout for Requests
Select this check box to enable timeout recognition. If a timeout is
recognized, the appropriate error handling is triggered.
Retry Requests
Select this check box to enable the retry functionality for requests sent to the
IES service that were not processed successfully.
Retry is only triggered if a temporary error occurred, for example
unavailability or overload of the IES service.
Send Requests from Queue
Select this check box to send queued requests to IES. Queuing is only
relevant if IES Cloud Edition is used.
Get Results for Requests
Select this check box to query results for requests sent to IES. This is just
relevant if IES Cloud Edition is used.
Display Summary of Actions
Select this check box to have results of the report written on the report
result screen.
3. Optional If you want to execute batch job continuously, you can define a
background processing event and plan a periodic job based on the event (see
SAP documentation for events in background processing).
Usually the report runs only within the minimum interval of one minute of the
periodic job scheduling but it provides additional options for an event based job
scheduling.
The report itself will raise the event at the end of the processing after the delay
is reached.
Note: For details regarding the time-out and retry settings, see OpenText
Vendor Invoice Management for SAP Solutions - Configuration Guide for Foundation
(VIM-CGF).
If you use the event based job scheduling for the document handler or the IES
request handler then you must configure the Event watcher report as a background
job running every 30 minutes.
Job name
Name of the job which is planned with the event based option
Background processing event
Event which is raised and which is configured within SM64 transaction . The
event is only raised in background processing mode.
Background event parameters
Optional parameter which allows to use the event for different cases
Notes
When using ICC and BCC there is already a validation of extraction results in place.
/OPT/VIM_1EXT_H
for VIM Incoming Document Handler (IDH)
/OTX/PF01_T_1EXT
for VIM Foundation Inbound Handler
The extraction results and a so called call point are stored in the extraction result
table. The call point defines the source of the result.
• Priority 1: IX Indexing Validation (Single Click Entry) – only relevant for ICC
• Priority 2: VA Validation (Capture)
• Priority 3: EX Extraction (Capture)
The validated extraction results are transformed into the IES extraction result format
and are used to train an IES profile.
The result of the mapping is saved into an intermediate fieldname - value structure
with the process data fieldnames.
Once this fieldname - value structure is available, the IES process data mapping can
be used to convert this intermediate format into the IES compatible format.
To consider fields in pre-learning, you must maintain a process data mapping for
IES and for ICC/BCC. There is no need to use identical extraction field names. But it
is important that the fields are mapped to the same process data field.
Invoice Solution
To perform data mapping from ICC / BCC Invoice application to the Invoice
process:
1. Run the /OTX/PF00_IMG transaction and navigate to Process Foundation > Data
Model.
2. Mark the Data Model ID PS03_VIMCL and double-click External Data Mapping
in the Dialog Structure.
3. Enter PS03_VIMCL
1. Run the /OTX/PF00_IMG transaction and navigate to Process Foundation > Data
Model.
2. Mark the Data Model ID PS<xy> (where <xy> represents the technical ID of the
solution) and double-click External Data Mapping in the Dialog Structure.
3. Enter CAPTURE or CAPT_BCC.
4. Double-click Level Mapping in the Dialog Structure.
5. Verify and adjust field mapping if needed. Make sure that custom fields are
mapped correctly. The mapping is stored in table /OTX/PF20_T_MAPF.
To perform data mapping from the Solutions Beyond Invoice process to IES:
1. Run the /OTX/PF00_IMG transaction and navigate to Process Foundation > Data
Model.
2. Mark the Data Model ID PS<xy> (where <xy> represents the technical ID of the
solution) and double-click External Data Mapping in the Dialog Structure.
3. Enter CAPT_IES.
4. Double-click Level Mapping in the Dialog Structure.
5. Verify and adjust field mapping if needed. Make sure that custom fields are
mapped correctly. The mapping is stored in table /OTX/PF20_T_MAPF.
Selection Variant
Technical ID of the selection variant. Do not use blank or special characters.
ICC Channel
ID of the relevant input channel. The parameter restricts the set of relevant
documents by the CHANNEL_ID field of /OPT/VIM_1HEAD table.
Start Date
Lower date limit for relevant documents. The parameter restricts the set of
relevant documents by the field CHANGE_DATE of the /OPT/VIM_1HEAD table.
End Date
Upper date limit for relevant documents. The parameter restricts the set of
relevant documents by the CHANGE_DATE field of the /OPT/VIM_1HEAD table.
IES DocType
ID of the ArchiveLink document type which is in IES for such kind of
documents. This parameter is used to determine the corresponding IES
profile and to determine the process data field mapping which is needed to
generate the IES extraction result structure for the feedback.
7. If you refresh the screen, the newly created selection variant appears in the list.
At the beginning, the selection variant is in CALCULATE status.
Once the keys of the relevant documents are determined, the status changes to
READY, and the selection variant is ready for processing.
2. In the IES Administration Work Center, check the result list of the Pre-learning
of Profiles node:
a. Check the selection parameters with their information about the resulting
documents and administrative information.
b. Check the Pending column that shows how many documents are relevant
for pre-learning of the defined selection variant.
c. If you want to perform a detailed review, check the /OTX/PF32_T_CLMI
table which contains the keys of all relevant documents per selection
variant.
3. If you want to initiate the pre-learning, select the selection variant, and then
click Start.
The status of the selection variant changes to STARTED.
The periodic scheduled /OTX/PF32_P_IES_CLM_TRIGGER background report
picks up the documents of the selection variant and process them. The counters
for documents that are pending, running, finished or have an error are updated.
For technical reasons an inbound registration ID has to be assigned for
documents which are processed for pre-learning of profiles. This dummy
registration IDs start with the ID 999900000000.
Once all documents are processed the status of the selection variant changes to
FINISHED.
4. Optional If documents run into an error, check the log entries in the detail pane of
the pre-learning of the profiles node.
Selection Variant
Technical ID of the selection variant. Do not use blank or special characters.
BCC Module Handler
ID of the relevant module handler. The parameter restricts the set of
relevant documents by the HANDLE_ID field of the /OTX/PF01_T_
1REG table.
BCC DocType
ID of the relevant ArchiveLink document type. The parameter restricts the
set of relevant documents by the AR_OBJECT field of the /OTX/PF01_T_1REG
table.
Start Date
Lower date limit for relevant documents. The parameter restricts the set of
relevant documents by the field TSP_FINISH of the /OTX/PF01_T_1REG
table.
End Date
Upper date limit for relevant documents. The parameter restricts the set of
relevant documents by the TSP_FINISH field of the /OTX/PF01_T_1REG
table.
IES DocType
ID of the ArchiveLink document type which is in IES for such kind of
documents. This parameter is used to determine the corresponding IES
profile and to determine the process data field mapping which is needed to
generate the IES extraction result structure for the feedback.
a. Check the selection parameters with their information about the resulting
documents and administrative information.
b. Check the Pending column, that shows how many documents are relevant
for pre-learning of the defined selection variant.
c. If you want to perform a detailed review, check the /OTX/PF32_T_CLMI
database table.
The database table contains the keys of all relevant documents per selection
variant.
2. If you want to initiate the pre-learning, select the selection variant, and then
click Start.
The status of the selection variant changes to STARTED.
To optimize the business entity determination (BED) when migrating to the profile
with scenario version 2 a pre-learning is advisable.
Similar to the pre-learning for ICC or BCC, the already processed documents are
sent to extraction again, utilizing the target profile.
The feedback is based on the validated extraction results of the source profile.
In contrast to the other pre-learning approaches, only the extraction fields relevant
for business entity determination are contained in the feedback here. All other
learning data is taken over by restoring snapshots of the source profile.
Selection Variant
Technical ID of the selection variant. Do not use blank or special characters.
Source Profile Id
ID of the source profile (using scenario version 1).
Source DocType
ID of the relevant ArchiveLink document type. The parameter restricts the
set of relevant documents by the AR_OBJECT field of the /OTX/PF01_T_1REG
table.
Start Date
Lower date limit for relevant documents. The parameter restricts the set of
relevant documents by the TSP_FINISH field of the OTX/PF01_T_1REG table.
End Date
Upper date limit for relevant documents. The parameter restricts the set of
relevant documents by the TSP_FINISH field of the /OTX/PF01_T_1REG
table.
Max. Number Docs
Maximum number of relevant documents.
Target Profile Id
ID of the target profile (using scenario version 2).
a. Check the selection parameters with their information about the resulting
documents and administrative information.
b. Check the Pending column, that shows how many documents are relevant
for pre-learning of the defined selection variant.
c. If you want to perform a detailed review, check the /OTX/PF32_T_CLMI
database table.
The database table contains the keys of all relevant documents per selection
variant.
2. If you want to initiate the pre-learning, select the selection variant, and then
click Start.
3. If documents run into an error, check the log entries in the Detail pane of the
Pre-learning of Profiles node.
Example: If analytical data is only evaluated once a week it is not required to schedule the
program on a daily or even hourly basis.
Note: Running the program for finished processes is usually not required as all
corresponding analytics data is automatically updated whenever a process is
finished.
You must run the program once for finished documents and for running
documents if the analytics feature has not been activated initially and should
be used at a later point of time.
You can also use the program for all documents or a subset of documents to
update new fields which are added to analytics tables at a later time.
OpenText recommends that you schedule the report to run in background for a
large set of documents.
2. On the Update process analytics data screen use the following parameters:
Profile ID
The ID of the Process Foundation profile for which you want to update
analytics data.
Process Key
Restricts the amount of updated processes, enter a special process ledger
key or process ledger key range. This parameter is only an optional
parameter.
Running
Updates the analytics data only for running processes.
You must run the report to enable embedded analytics that uses CDS views, which
are delivered for different BC solutions.
Note: Run the report at least once. This collects the inbound Analytics data for
all solution processes that you created before BC 16.3 SP4.
Data for solution processes that are created from BC 16.3 SP4 are updated
automatically.
Caution
If the update process fails and you select the checkbox, the
analytics table is empty.
Running the license reporting requires an authorization for the J_6NPF_ADM object
with value 2 for the J_6NPF_COM field.
License audit for Vendor Invoice Management for SAP Solutions and ICC/IES is
based on SAP System Measurement, using transaction USMM. For more information,
see the SAP documentation (https://support.sap.com/en/my-support/systems-
installations/system-measurement.html).
Vendor Invoice Management for SAP Solutions and ICC/IES are configured to be
included into the SAP system measurement. For details and prerequisites running
the SAP tools, check the SAP documentation, for example about required SAP
authorizations.
For Vendor Invoice Management for SAP Solutions and ICC/IES, there is an
additional License Report. You can use it to get a more detailed output by product
and to select the reporting year. For example, it lists the number of invoices
triggering a VIM DP workflow and number of invoices in VIM without any
workflow. You should use this report if a license audit is requested by OpenText and
you do not want to provide the full SAP output of USMM to OpenText.
The report lists monthly values for all configured and not empty products. For
Solutions Beyond Invoice and IES the totals of the involved scenarios are listed.
Starting in January 2018, all Vendor Invoice Management for SAP Solutions and
ICC/IES product data are measured under application ID 1160. Except for Core
Capture for SAP® Solutions and Solutions Beyond Invoice without OCR solution,
they all have a unit ID assigned:
1. On the central system, run the SM30 transaction, enter view /OTX/PF09_V_SET,
and then click Maintain.
2. For Business Center without Business Center Capture (BCC), enter X in Use
Business Center w/o OCR.
Note: Only enter X if Business Center w/o OCR is bought directly from
OpenText. If the solution is purchased from SAP, the setting results in
inconsistent license measurements.
3. For Intelligent Capture for SAP® Solutions, enter X in Use IES for invoice
capture.
4. To count all solutions as VIM, enter X in Use VIM for all processing scenarios
row.
At the end of a successful report run, a new entry is logged in table /OTX/PF09_T_
AGLG for each aggregated product (unit).
The RFC for System Communication and the RFC for Dialog Communication must
be maintained correctly for each satellite system.
For this auditing purpose, you can use SAP System Measurement.
• Counts all ICC/IES documents with status Extraction Completed at some point
of time in the selected period.
• Counts all VIM documents with start date in the selected period and status in
VIM workflow or completed.
• Counts all Solutions Beyond Invoice documents with start date in the selected
period.
VIM speciality Table entries without VIM related workflow process are listed in the output list of
the report but do not count in the license audit. This situation occurs if customers
configure the system to include invoices in the VIM Analytics report that are posted
outside VIM. Depending on the global VIM settings, these invoices are shown in
VIM Analytics, but no work process is started. For more information, see Section
14.2.2.7 “Linking events for VIM workflows” in OpenText Vendor Invoice Management
for SAP Solutions - Installation Guide (VIM-IGD) (entries “VIM Analytics” or “VAN”
in table column Usage comments).
In a multiple backend system with all satellite system clients in use, you can run the
License Report on the central system with satellite system data collection active.
Run in dialog To run the License Report in dialog, run the /n/OTX/PF09_COUNT transaction. You
can create, save, and use report variants.
Run in You can use the report /OTX/PF09_CL_LICENCING in a background job definition.
background You can create, save, and use report variants.
The line length used in the output log is too high for a common output device that is
using the X_65_80 format. With such a device, you will lose information. Instead,
use an output format with higher line length like X_65_132.
Enter year
Enter a year. 2018 is the “start year”.
Include systems
To include the satellite systems in the count, select this check box. In Logical
system, enter logical systems.
Important
It is not possible to include clients on satellite systems.
Simple/other process
Simple VIM / delivery note / order confirmation entries
If there are no numbers for this, the column is not displayed.
w/o Process
VIM entries without process: Not relevant for licensing. This number
represents entries in VIM Analytics, which are not related to an actual VIM
process. That means invoices posted directly in SAP standard, for which no
VIM process is started, but which are shown in VIM Analytics.
You can print the result list or save it to a file for delivery.
This part covers administration tasks that must be carried out regularly. These tasks
are not executed on a daily basis by an agent, but must be carried out by a
responsible to keep the business process running.
For Invoice Solution tasks, see “Regular administration tasks for Invoice Solution“
on page 219.
Web IDs are automatically generated the first time an object is displayed in the Fiori
Task App. To avoid a continuous growth of table /OTX/PF62_T_ID, you must delete
(clean up) older web IDs periodically.
Note: Deleting web IDs includes the deletion of data collections that have been
created for these web IDs.
Web ID
Data Collections
You can schedule the report in the background or run it directly. When the report is
run, authorization object J_6NPF_ADM, field J_6NPF_COM (Component) is checked for
value 4 Web UI. For more information, see Section 8.4 “Authorization objects” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Foundation (VIM-CGF).
• Perspective settings
• Layout definition
• Layout texts
• View settings
To download perspectives:
Download Perspective
To enable the download, select this check box.
Perspective ID
Enter the ID of the perspective that you want to download, for example
PF62_PSP_EDIT.
Perspective Type
Enter the perspective type, for example ITEM.
IES Administration Work Center can be used for both, for Intelligent Capture for
SAP Solutions, and for Core Capture for SAP Solutions.
You access the Work Center via VIM Central Workplace with the transaction code /
OTX/PF03_WP.
Note: The IES Administration Work Center does not support remote scenarios.
That means administration and monitoring must be done on the system that is
connected to IES.
Profiles node
Use the node to manage profiles for your Information Extraction Service. You can
filter profiles by scenarios with the respective nodes.
For details see Section 5.2.3.16 “Activating and updating a profile” in OpenText
Vendor Invoice Management for SAP Solutions - Configuration Guide for Foundation
(VIM-CGF).
For troubleshooting issues, tracing can be enabled per profile. For details see “Trace
management” on page 123
Extraction node
Use this node for administering extraction sessions.
You can filter extraction sessions by status with the respective nodes.
Additionally, a selection screen helps to restrict the results. By default, the newest
sessions are displayed first.
You can cancel one or more sessions with the bulk action Cancel Session.
When a session is cancelled its temporary data is cleaned up and can no longer be
used.
Request node
The node shows all requests that are sent to your Information Extraction Service.
You can filter requests by status with the respective nodes.
Additionally, you can use a selection screen to restrict the results. By default, the
newest requests are displayed first.
The detail pane displays the request history and relevant application log entries.
Pre-learning node
Use the node to administrate pre-learning of IES profiles. For details, see “Pre-
learning of IES Profiles” on page 32.
Snapshots node
The node shows all the snapshots either created on the system or imported from
other systems. The following actions are available:
For more information about the specific actions, see “Transfer of machine learning
data of IES“ on page 79.
Layouts node
The node shows all known document layouts that are identified during extraction of
the documents. You can use a selection screen to restrict the displayed layouts.
You can reset the machine learning data for a specific document layout by running
Reset Model action.
Connections node
The node shows all configured connections to the IES servers. The following actions
are available:
• Retrieve system information from IES (bulk action Refresh System Info). The
date and time of last retrieved system information is shown after action is
completed.
• Load trace files from IES (bulk action Load Traces available for Intelligent
Capture for SAP Solutions). The date and time of last retrieved traces is shown
after action is completed.
• Delete retrieved trace files from SAP database (bulk action Delete Traces).
• Display system info after retrieving from IES (Info button in column System
Info).
• Download traces to local file system after retrieving from IES (Trace button in
column Trace).
Waiting
The documents are waiting for special steps to be completed, for example
extraction of OCR data completed or validation of OCR data completed.
Processing
The documents are currently processed by the inbound process.
Processed
Inbound processing of the documents has finished successfully.
Error
The documents have run into an error during inbound processing.
Rejected
The documents have been rejected during inbound processing.
The Work Object Functions provide the following links: Archive Document and
Archive Monitor.
In the header of the Work Object List, the following actions are either with an own
action button or within the bulk action available (besides standard SAP buttons) for
the marked work object(s).
Note: Only Processing shows all action buttons, the other nodes show less or
no buttons.
Change Priority
Click this button to change the priority of the inbound processing of a
document. The priority is taken into account to retrieve documents in the
validation step. It is also considered when the document is processed in the
inbound handler steps.
Change Status
Click this button to change the inbound processing status. Using this
functionality, it is possible to jump back or forth and to skip or repeat single
steps within the inbound processing chain. This can be useful when resolving
occurred errors or for testing purposes.
Reject
Click this button to stop inbound processing of documents by rejecting them
using predefined rejection reasons.
Reset Retry Counters
Click this button to reset the extraction and validation retry counters.
Start IES Training
Triggers training of documents processed with IES. The document will be sent
into the document handler for training documents to process the document with
the same profile and the assigned ArchiveLink document type for training. For
more information, see Section 4.1 “Customizing basic settings for Inbound
Configuration” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Foundation (VIM-CGF).
Reset Training
Resets the marked training status. Documents marked for training are fetched
from ICC / BCC for the training. This action is relevant for documents processed
with BCC / ICC.
For documents processed with IES, the status mark for training does not have a
direct impact and Reset Training does not stop processing of triggered training
documents. Mark for training status can be used to identify documents which
should be sent either manually through the “Start Training” action in Inbound
Administration or automatically through a job based on the “Training required”
indicator and the Reset Training action just clears the status.
Display Validation Agent
If an inbound process is in status Ready for Validation, click this button to
display the currently assigned OCR validation agent(s). You can also add
validation agents: The /OTX/PF32_CL_ACTION_ADD_VALAG action class provides
the possibility to add users and /OTX/PF32_CL_ACTION_DISP_VALAG action
class only displays the agents.
Notes
A Results message shows you if your actions were successful or if an error has
occurred.
Download IES Extraction Trace
Click this button to download the content which was recorded during the
extraction trace for a document. The following content is exported to a zip file:
Important
When you finish processing a work object, use the buttons provided, for
example Cancel or Save.
You can use the Detail pane to display additional information about the document
that is currently marked.
Document
Shows the archived image of leading business document.
History
Shows the history of the already passed status of the inbound process.
Log
Shows the application log of the current document.
External Data
Shows external data. If BCC or IES is used for extraction, the extraction result is
displayed.
Attachments
Shows further archived attachments of the inbound process.
Extraction Trace
Shows traced request (extraction parameter, extraction result, and feedback) for
each extraction step.
Note: The tab is only visible if the traced information is available for a
document. For details, see “Trace extraction with Information Extraction
Service” on page 121.
Entity Candidates
Shows candidates for each relevant business entity. The candidate source shows
why a specific business entity was selected as candidate within the SAP look-up.
For details regarding business entity determination see Section 5.2.3.1
“Customizing the Business Entity determination” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Foundation (VIM-CGF).
Note: The tab is only visible if the traced information is available for a
document. For details, see “Trace extraction with Information Extraction
Service” on page 121.
Waiting
The documents are waiting for special steps to be completed, for example
extraction of OCR data completed or validation of OCR data completed.
Processing
The documents are currently processed by the inbound process.
Processed
Inbound processing of the documents has finished successfully.
Error
The documents have run into an error during inbound processing.
Rejected
The documents have been rejected during inbound processing.
The Work Object Functions provide the following links: Archive Document and
Archive Monitor.
In the header of the Work Object List, the following actions are either with an own
action button or within the bulk action available (besides standard SAP buttons) for
the marked work object(s).
Note: Only Processing shows all action buttons, the other nodes show less or
no buttons.
Change Priority
Click this button to change the priority of the inbound processing of a
document. The priority is taken into account to retrieve documents in the
validation step. It is also considered when the document is processed in the
inbound handler steps.
Change Status
Click this button to change the inbound processing status. Using this
functionality, it is possible to jump back or forth and to skip or repeat single
steps within the inbound processing chain. This can be useful when resolving
occurred errors or for testing purposes.
Reject
Click this button to stop inbound processing of documents by rejecting them
using predefined rejection reasons.
Submit Handler
Click this button to submit the inbound document handler manually. The
inbound document handler executes the configured steps within the inbound
processing chain. If not triggered manually before, the inbound document
handler is automatically submitted by the system using a certain time interval.
Notes
A Results message shows you if your actions were successful or if an error has
occurred.
Download IES Extraction Trace
Click this button to download the content which was recorded during the
extraction trace for a document. The following content is exported to a zip file:
Important
When you finish processing a work object, use the buttons provided, for
example Cancel or Save.
You can use the Detail pane to display additional information about the document
that is currently marked.
Document
Shows the archived image of leading business document.
History
Shows the history of the already passed status of the inbound process.
Log
Shows the application log of the current document.
External Data
Shows external data. If BCC or IES is used for extraction, the extraction result is
displayed.
Attachments
Shows further archived attachments of the inbound process.
Extraction Trace
Shows traced request (extraction parameter, extraction result, and feedback) for
each extraction step.
Note: The tab is only visible if the traced information is available for a
document. For details, see “Trace extraction with Information Extraction
Service” on page 121.
Entity Candidates
Shows candidates for each relevant business entity. The candidate source shows
why a specific business entity was selected as candidate within the SAP look-up.
For details regarding business entity determination see Section 5.2.3.1
“Customizing the Business Entity determination” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Foundation (VIM-CGF).
Note: The tab is only visible if the traced information is available for a
document. For details, see “Trace extraction with Information Extraction
Service” on page 121.
You can download the data and use it for further analytical investigation across
different documents. For further information, check the SAP documentation about
the SAP GUI Standard to download the ALV grid information to, for example Excel.
You can use the Detail pane to display additional information about the document
that is currently marked. The additional available tab is Comparison. The
Comparison plugin provides the possibility to compare the extracted values with
the call point of validation or process finished.
Analytics shows the same values as shown in Inbound Documents but adds
certain information that allows comparison.
Additional values of IES Extraction Analytics:
Header values
Item values
Notes
• Until 20.4 SPS1 release, fields and matches were counted regardless of the
value parameter being empty or filled. From 20.4 SPS2 release, only fields
with a filled value are counted.
• From 20.4 SPS2 release, a comparison plugin is available for detailed analysis
of the calculated values.
Important
OpenText recommends archiving data of the VIM tables only, when the data is
not required in everyday tasks and it is not relevant from auditing perspective.
Make absolutely sure that you run license reporting before you archive data.
Otherwise, you might lose data that is needed for license reporting. For more
information, see “Using the OpenText License Audit Report” on page 47.
The data archiving process follows the SAP standard Data Archiving:
For more details regarding Data Archiving processing, see the Data Archiving
chapter in the SAP Help.
• According to the data archiving standard, the default setting for the
maximum archive file size should be 100 MB. At any rate, the value has to be
between 50 MB and 700 MB. If the value is too low, you will have too many
files. If the value is too high, you will have problems saving the file, for
example on a CD.
• Furthermore, according to the data archiving standard, do not enter a default
value for the maximum number of data objects in an archive file.
As the VIM Foundation is a basis for several scenarios, the following data archiving
use cases need to be considered:
database tables without deleting process or analytics data. For more information,
see “Archiving of Inbound Data” on page 66.
2. Archiving of Inbound, Process, and Analytics data for custom solutions:
You have configured a custom solution based on VIM Process Foundation and
need to archive data from the runtime tables. For more information, see
“Archiving of Inbound, Process, and Analytics data for custom solutions”
on page 67.
3. Archiving of Inbound, Process, and Analytics data for Solutions Beyond Invoice:
You are using a Solution Beyond Invoices and need to archive data from the
runtime tables. For more information, see “Archiving of Inbound, Process, and
Analytics data for Solutions Beyond Invoice” on page 70.
4. Archiving of Inbound, Process, and Analytics data for Invoice Solution:
You are using VIM Invoice Solution. For more information, see “Archiving VIM
information” on page 223.
5. Archiving of related SAP data:
As the VIM Foundation is based on SAP standard technology, other standard
SAP archiving objects need to be considered for your scenario. For more
information, see “Archiving of related SAP data” on page 76.
Unlike the archiving objects for VIM Invoice Solution, ILM objects for VIM Inbound
and Solutions Beyond Invoice are not delivered in the installation packages.
However, the delivered Data Archiving Write Reports do support the ILM
parameters Archiving, Destruction and Snapshot.
If you plan to use custom ILM objects, do not assign these directly to the OpenText
delivered archiving objects. Copy the OpenText archiving objects and reports to
your customer name space and assign these to your custom ILM objects. Assigning
custom ILM objects to the OpenText archiving objects will cause issues when ILM
objects are delivered by OpenText in the installation packages of an upcoming
release.
Inbound Data
• /OTX/PF01_T_1REG
• /OTX/PF01_T_1LOG
• /OTX/PF11_T_DEH
• /OTX/PF11_T_DEHI
• /OTX/PF08_T_DEAI
Because you are using a configured process with custom tables, also custom
Archiving objects need to be configured and custom write and delete reports need to
be implemented. In the VIM Foundation, a template data archiving object and
template reports are available, which you can copy to a custom report and enhance
it according to your requirement.
Template Object
Archiving Object /OTX/PS00
Write Report /OTX/PS00_P_ARC_PRC_WRI
Delete Report /OTX/PS00_P_ARC_PRC_DEL
Reload Report /OTX/PS00_P_ARC_PRC_REL
1. Copy the WRITE and DELETE report to your namespace. Reload is optional
because it is recommended only for testing.
2. Adjust the report to your requirements, for example add selection criteria and
authorizations.
4. Adjust the configuration in AOBJ > Structure Definition so the custom tables are
used instead of the template tables:
For details and hints regarding the implementation, consider the comments given in
the template reports.
In standard custom scenarios, you must copy and adjust only the reports. You do
not need to change the underlying selection and data archiving logic.
For very complex custom scenarios, you can inherit, redefine, and adjust also the
standard selection and data archiving classes, according to your needs.
The template data archiving object is fully functional and can be used to archive data
in the Default project of the VIM Foundation.
• Selection process
– Package Size for Selection: To avoid memory issues, the report selects and
processes the data based on packages defined by this parameter. You can
adjust the value to decrease or increase the memory consumption during an
archiving run, if necessary.
• Processing Options
– Test Mode
– Productive Mode
• Log Options
• /OTX/PF02_T_PLH
• /OTX/PF02_T_PLI
Additionally, all solution-independent runtime and analytics tables for the VIM
Foundation are considered for data archiving. All tables related to inbound data are
archived. For more information, see “Archiving of Inbound Data” on page 66.
Solution independent tables for all processes based on the VIM Foundation:
/OTX/PF00_T_CMNT /OTX/PF02_T_PLE /OTX/PF04_T_WFR
/OTX/PF02_T_IMGF /OTX/PF04_T_PTEL
/OTX/PF02_T_IMGR /OTX/PF04_T_PTEM
Solution independent analytics tables:
/OTX/PF08_T_ACV
/OTX/PF08_T_ACVA
/OTX/PF08_T_CAT
/OTX/PF08_T_DEAP
/OTX/PF08_T_DEAS
/OTX/PF08_T_DEH
/OTX/PF08_T_DEHI
/OTX/PF08_T_HISA
/OTX/PF08_T_MOD
/OTX/PF08_T_PLHA
/OTX/PF08_T_REGA
All Data Archiving objects are including the archiving of related Inbound data,
therefore it is not necessary to run the inbound archiving described in “Archiving of
Inbound Data” on page 66 separately, if not required.
The following archiving objects for Solutions Beyond Invoice are available, if the
corresponding components (OTBCSLOC or OTBCSLPP) are installed.
Remittance Advice
Solution Remittance Advice Process
Analytics
Archiving Object /OTX/PS07 /OTX/PS07A
/OTX/ /OTX/
Write Report
PS07_P_ARC_PRC_WRI PS07_P_ARC_ANA_WRI
/OTX/ /OTX/
Delete Report
PS07_P_ARC_PRC_DEL PS07_P_ARC_ANA_DEL
Remittance Advice
Solution Remittance Advice Process
Analytics
/OTX/ /OTX/
Reload Report
PS07_P_ARC_PRC_REL PS07_P_ARC_ANA_REL
Infostructure /OTX/PS07_AI /OTX/PS07A_AI
• In the Write Report for any Process archiving object, select the Include
Analytics Data check box.
2. Archiving only Process related data and keep data in Analytics tables
• In the Write Report for any Process archiving object, clear the Include
Analytics Data check box.
• The Analytics data is not archived and can be used for analytical use cases
• If the Analytics data is not needed anymore, use the archiving object for
Analytics to also clean this data.
Selection process
Note: Always run the license reporting (see “Running a license report”
on page 55) before data archiving. The Write report will check the status of the
licensing report and not process any work items that were not registered yet
and issue error messages. Because the license report only calculates licensing
data based on the end of the last month, work items created in the current
month are not available for data archiving, even if finished.
• Options
– Test Mode
– Productive Mode
• Log Options
3.7.3.4 Authorizations
General author- The following authorization objects are checked beyond SAP standard Data
ization checks Archiving authorizations for all archiving objects for Solutions Beyond Invoice:
Object ID Field
J_6NPF_ADM J_6NPF_COM 2
J_6NPF_PRJ J_6NPF_PRJ Project ID of the respective solution
ACTVT Activity 24 (Archive)
Solution Each solution incorporates business data related authorization checks, for example
specific authori- on Company Code Level. The authority objects are checked during selection. The
zation checks
following rules apply:
• If the user does not restrict an authority related Select option, for example Select
option Company Code is empty, the logic will check for an * authorization.
• If the user restricts the select options, for example selects all company codes from
1000 to 1200, each relevant business object will be checked. Authority for each
company code between 1000 and 1200 must be present.
• If at least one authorization is missing, the report will cancel and not process any
items.
• Authority Check for business values is done based on the Display activity.
3.7.3.5 Tables
The following solution specific tables are considered:
Quotations Process
/OTX/PS10_T_PLH
/OTX/PS10_T_PLI
Quotations Analytics
(If check box Include Analytics Data is selected or handled by archiving object /
OTX/PS10A)
/OTX/PS10_T_PLHA
/OTX/PS10_T_ACVA
/OTX/PS10_T_HISA
/OTX/PS10_T_DEAS
Additionally, all solution-independent runtime and analytics tables for the VIM
Foundation are considered for data archiving. All tables related to inbound data are
archived. For more information, see “Archiving of Inbound Data” on page 66.
/OTX/PF02_T_IMGF /OTX/PF04_T_PTEL
/OTX/PF02_T_IMGR /OTX/PF04_T_PTEM
Solution-independent analytics tables
If check box Include Analytics Data is selected or handled by archiving object for analytics
/OTX/PF08_T_ACV
/OTX/PF08_T_ACVA
/OTX/PF08_T_CAT
/OTX/PF08_T_DEAP
/OTX/PF08_T_DEAS
/OTX/PF08_T_DEH
/OTX/PF08_T_DEHI
/OTX/PF08_T_HISA
/OTX/PF08_T_MOD
/OTX/PF08_T_PLHA
/OTX/PF08_T_REGA
Note: OpenText advises against archiving data in SAP standard tables if the
underlying process is not archived. This scenario is not supported.
Follow the documentation in SAP Help regarding the following SAP standard Data
Archiving objects and check for the latest SAP Notes for the affected components.
To identify relevant objects for these standard objects for Solutions Beyond Invoice
or custom scenarios, use the following hints:
• The relevant work item IDs are normally stored in the solution header table.
• Another option to collect relevant SAP Business Workflow related instances is
the following (pseudo) select:
SELECT TOP_WI_ID FROM SWW_WI2OBJ WHERE ( TYPE_ID = '/OTX/PF01R' OR
TYPE_ID = '/OTX/PF02' OR )
ArchiveLink (BC-SRV-ARL)
• Link entries are stored in the tables TOA01, TOA02, or TOA03 with business object /
OTX/PF01R or /OTX/PF02.
The VIM Data Archiving is also not handling the archiving of created business
objects like sales orders, invoices, and so on. See the SAP Help regarding Data
Archiving for the respective SAP module.
For more information, see Section 7.1.5 “Configuring data enrichments” in OpenText
Vendor Invoice Management for SAP Solutions - Configuration Guide for Foundation
(VIM-CGF).
However, there might be situations beyond the integrated handling of learned data
enrichments where additional administrative actions are required. The following
administrative use cases are covered:
This chapter describes how you transfer machine learning (ML) data.
• Transfer of ML data from a profile to another profile on the same SAP system
Snapshots of ML data for a profile can be created for IES on-premises and public
cloud. Also the restore function of ML data for a profile can be used on-premises or
on public cloud.
All this data is stored on the leading SAP system. For on-premises and for public
cloud, the ML data is requested via the IES server. There is no direct access of the
repository inside SAP.
Only data that is relevant for machine learning is considered. There is no transfer of
profile customizing.
You must either transport profile customizing through the SAP transport
management system, or take it over manually from the source to the target profile.
An activity allows to copy profile customizing on the same system. For more
information, see Section 5.2.3.3 “Copying a profile” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Foundation (VIM-CGF).
If you want to transfer snapshot from one SAP system to another, you have to use
additional download and upload functions.
The upload and download actions are executed by the SAP application server in a
background task. For each relevant table an own transfer file is created.
Caution
Do not change any data in the transfer files.
To create a snapshot:
4. Select the profile for the snapshot, and then click the Create snapshot button
in the toolbar.
5. In the confirmation dialog specify a description for the snapshot, and the click
Continue.
The snapshot for the profile is created. You can check its status in the Snapshots
node.
All required actions are available in the Snapshots node in IES Administration.
2. If systems do not share a transfer directory, copy snapshot files from source
transfer directory to target transfer directory.
1. Create logical file path definition in your namespace. For example, Z_<Name>.
Note: The operating system-dependent physical file path must end with a
variable <FILENAME>.
Notes
Tip: If possible, use a central transfer directory which can be used by the
source and the target SAP application server.
4. Select the snapshot you want to download, and then click the Download button
in the toolbar.
5. In the confirmation dialog verify that the transfer directory is correct, and then
continue with the download.
A success message in the status bar gives details about the initiated download
in background using an automatically created and started batch job.
5. Specify the relative file name (file name without path) of the index xml file of
the snapshot that you want to upload, and then continue.
The value help for the file name offers a file browser for the files in the transfer
directory.
Make sure that the profile customizing of the source profile fits to the profile
customizing of target profile. Otherwise not all information of the ML data can be
used.
To restore a snapshot:
5. Click the Activate profile button in the Action column of the profile.
6. Select a connection ID and enable the option to restore from a snapshot, and
then click Continue.
7. Select the snapshot you want to restore, and then click Continue.
The list only contains snapshots for the scenario of the selected profile.
The profile is now activated, and the machine learning data of the selected
snapshot is restored.
To delete a snapshot:
4. Select the snapshot that you want to delete, and then click the Delete button
in the toolbar.
Type
US
ID
SAP user ID of the specific user
The report shows all SAP work items belonging to the user, regardless of
whether they are VIM work items or not.
VIM work items have the following task IDs:
TS00275278
DP Document Dashboard
TS00275267
PO Invoice Dashboard (Header WF)
TS00275262
PO Parked Invoice Dashboard
TS00275260
Non PO Invoice Dashboard
TS00275265
PO Invoice Dashboard (Line Level)
With the work item IDs, you can assign the work items to a different user; see
“Reassigning open SAP work items to a different user” on page 90.
1. To access the Execute work items without agent check screen, run the SWIA
transaction.
2. Enter the work item ID retrieved in “Retrieving open SAP work items of a
specific user” on page 87 and click to execute.
Before you can reassign, you must be an owner of the work item.
3. To own the work item, select it and click the Without check button in the
application tool bar.
This action leads you into either the VIM Dashboard or the DP Dashboard.
4. Click to return to the Execute work items without agent check screen.
7. Enter the SAP user ID of the receiver of the work item and click to execute.
At the bottom of the screen, a confirmation message is displayed: Forwarding
carried out.
4. To show the details of the invoice, click the document number in the navigation
panel on the left-hand side.
5.3.1 Backup
The configuration of VIM is stored inside SAP S/4HANA, in the OpenText product
tables. A backup of the underlying SAP S/4HANA system ensures the backup of the
appropriate configuration, runtime and persistent data. In addition, system
transports store any configuration changes that are made.
2. Select the required trace modes and click on the appropriate button under Trace
Requests to start the performance analysis.
SWPC is the SAP Basis transaction in the SAP Workflow area to restart workflows
that stopped running unexpectedly, for example because of system restart or
overload, or short dumps happening in workflow steps. As VIM is built as a SAP
Workflow solution, SWPC can basically be applied to VIM.
However, OpenText strongly advises that you do not select the Select async
workflow steps check box. The reason for this are the asynchronous work items in
Invoice Approval.
Generally, OpenText cannot guarantee that there are no consequential problems, for
the following reasons:
You can also access the reports directly by their transaction codes:
The following list shows all dialog standard tasks that can be used for SAP standard
reports:
TS00275278
DP Document Dashboard
TS00275267
PO Blocked Invoice Dashboard (Header WF)
TS00275265
PO Blocked Invoice Dashboard (Line Level)
TS00275262
PO Parked Invoice Dashboard
TS00275260
Non PO Parked Invoice Dashboard
TS00275253
Invoice awaiting web approval
Note: The web approval work items are always assigned to WF-BATCH
because the actual action is performed by the user on the web approval
page.
According to OSS 1227739, it is no longer possible to forward dialog work
items to a background user. You can apply the correction according to the
OSS note or the corresponding SAP Support Package. In function SWW_WI_
FORWARD, an additional check is applied to retrieve the user type (dialog or
background).
Solution: Work items that have to be executed by a non SAP user must be
assigned to a dialog user and not to WF-BATCH.
Correction instructions: Create a dummy user of type dialog user in the
SAP S/4HANA system. You do not have to assign specific authorizations
to the user. Then overwrite the existing default entry WF-BATCH for
parameter SAP_PROXY_ID (Product Code IAP) in table /PTGWFI/Z_CONST
with the dummy user, using the SM30 transaction.
For a list of workflow templates for the VIM process, see “Monitoring VIM
workflows” on page 236.
SWWWIHEAD
Work item header table for all types of work items
SWW_CONT
Container contents for work item (non-object referenced)
SWW_CONTOB
Container contents for work item (objects only)
SWIVOBJECT
Join SWW_CONTOB with SWWWIHEAD
SWELOG
Event log table
SWWORGTASK
Agent assignment of work item. The agent assignment information for a
particular work item is deleted once the work item is completed.
1. Call TC /OTX/PF01_IDF_INFO.
The output screen of the system report shows the collected system information.
2. To keep the system information, use the standard print function and generate a
PDF using a PDF printer.
Note: If you do not have a PDF printer, you can use a PDF generator provided
by SAP.
2. In General Properties, set the time of printing to Send to SAP Spooler Only for
Now.
6. Paste the spool request number, specify a filename and path for the PDF export,
and run the report.
SAP workflow logs are written for every activity of the process and therefore are
always available.
In addition to the standard system logs, you can use the SM21 transaction to check
system activities. See “Frequently used SAP workflow administration transactions”
on page 108 for transactions you can use for activity logging and traces.
The solution also writes logsto the standard system log infrastructure:
• For VIM Invoice Solution, see “Working with the application log” on page 249
for details.
• For VIM Foundation, see Section 3.5 “Configuring logging” in OpenText Vendor
Invoice Management for SAP Solutions - Configuration Guide for Foundation (VIM-
CGF) for details.
• You can conduct system performance checks using the SAP standard tools. The
SE30 transaction, for example, provides a runtime analysis of projects and
components.
• Resource consumption information can be monitored using the SM50 transaction
and other SAP administration utilities that are part of the SAP Computing Center
Management System (CCMS).
• You can use all the SAP standard logs and other infrastructure like the SM13 and
SM21 transactions for monitoring.
The following sections describe how to use the SAP Standard CCMS functionality
for alert monitoring. For more information, see the SAP Help.
VIM does not need a separate Central Monitoring System (CEN) system. To monitor
VIM, use the existing CEN system that is connected to the SAP S/4HANA system on
which VIM is installed. For configuring the CEN, see the SAP Help.
Notes
Monitor Usage
Availability: Availability monitoring of selected systems and their application servers
Selected
Systems
Background Background processing of the SAP S/4HANA systems and their
Processing application servers
Buffers The various SAP buffers, their hit rates, and swap rates
Change & Transports for a system
Transport
System
Communicatio Data transfers (SAPconnect, SAP Gateway, Application Link Enabling,
ns LDAP, RFC)
Data Archiving Monitored data archiving sessions
Database Database (such as table status, performance, backups, data consistency)
Dialog Overview of the dialog system, broken down by performance attributes
Overview
Enqueue Enqueue service. This service allows ABAP applications to lock data so
that only they can use it. The locking of the data avoids parallel changes to
the data, which would lead to data inconsistency.
Entire System Entire system (including detailed information about SAP services)
Operating Operating system data for any application servers and host systems
System
Security Security Audit Log and security-relevant messages in the system log
Spool System Spool system of the SAP S/4HANA system and the individual output
servers
Syslog System log broken down by application servers and individual topic areas
System Number of logged-on users and configuration settings of application
Configuration servers
You can copy these monitors and change them. See the SAP Help for more details.
1. Run the RZ20 transaction and select the menu option Extras > Activate
maintenance function.
In the CCMS Monitor Sets screen, expand the SAP CCMS Monitor Templates
menu.
As CCMS is a standard monitoring tool from SAP, VIM does not require
specific values for the property thresholds. SAP basis needs to decide the level
and to set the thresholds for this.
To execute, click .
Amongst others, the Receiver function module and the status of the action
is displayed.
• All profiles and settings are copied and the data resides in SAP database.
• ML data is also copied and the data resides in SAP database.
• Separate ML data pools of source and target client
• All profiles and settings are copied and the data resides in SAP database.
• ML data is not copied and the data resides in OT2 repository.
• Source and target client point to same subscription, and therefore, share
same ML data pool which can cause severe issues.
OpenText recommends you to divide ML data pools for CC4S after a client copy. In
the target client ensure the following activities:
When contacting OpenText Customer Support, provide the Support Info. Click
Download Support Info. The Support Info is mandatory for solving the issue that
occurred in your environment.
The ERROR_INFO field shows error messages raised by the backend system. The
REQUEST_URI field shows the call which caused this error.
When an error occurs in the application then you will not only get a pop-up for
the error messages and detailed information but also an error log. In this case it
is useful to provide information about the last errors in the console log to the
OpenText Customer Support.
1. If parts of the URI are hidden due to the secure log level, change the error log
level in the /IWFND/TRACES transaction.
• The developer tools are organized in different tabs. To display Log-Output, click
the Console tab.
• On the Network tab, you can record all requests that were sent.
Note: All $batch requests are OData services calls that the Fiori Task App
performs to get the necessary data from the backend.
Additional Information written to the console log by the Fiori Task App:
• Currently used item perspective. The log entry is: Applying perspective
<Perspective ID>.
• Version of UI and OData Service and compatibility. The log entry is: Minor
Service Implementation version: <Minor Version number> PF05_DATA Service is
compatible: UI <Version number> - Service <Version number>
The <Minor Version number> is increased with each release.
The <Major Version number> is unchanged since 16.3.0.
• System alias for OData service requests. The log entry is: Using one OData
backend system: OTBCWUI_BACKEND.
If the BC Fiori Task App is running you can retrieve additional information from the
console log by entering following commands and press ENTER:
sap.ui.version
returns the currently used UI5 version
sap.ui.Device.system
returns the currently used device type
• Many settings of the BC Fiori Task App are device type specific. In most cases
exists a device type independent setting. If you face the issue that some
information and actions are only available for some users and you already
checked for authorization issues, then it is likely that this occurs due to different
device type settings. Due to the similarity between COMBI and DESKTOP
devices it can be the case that the users are not aware that they are actually using
different device types.
Problem: Sign-in screen is shown when returning to Fiori Task App from
Document View on iPhone or iPad.
Explanation
This happens if the Fiori Task App is launched from the home screen and
inplace document viewing is not configured.
Solutions
Problem: Cannot return to Fiori Task App after viewing a document on iPhone
or iPad using Fiori Client App.
Explanation
This happens if no inplace document viewing is configured, and the native iOS
Viewer is opened in a new tab. This viewing mode is not supported inside the
Fiori Client App.
Solution
Explanation
This happens if Fiori Task App (Launchpad) is served with a different protocol
then the configured archive or viewing system. A mixture of HTTP and HTTPS
is not allowed.
Solution
• SAP
– TC SM59
– SSL options
○ deactivate SSL
2. https communication without client certificate authentication in both directions
• SAP
– TC SM59
– SSL options
○ activate SSL
○ Ignore client certificate
3. https communication with client certificate authentication in both directions
• special requirements for SAP client SSL certificate (include full qualified
hostname)
• SAP
– TC SM59
– TC SICF
– SSL options
○ activate SSL
○ Request client certificate
Frequent problems:
• IES:
– SAP:
○ Path for Repository and Result are not maintained correctly in Connection
Settings (default host is not part of path)
○ Wrong port is configured in RFC destination in SAP (SAP -> IES)
This means that they are requested once from the IES Cloud Edition home document
and they are then buffered in SAP. For all requests to the IES Cloud Edition these
buffered URLs are used.
If a service is not reachable with the buffered URL, the endpoint URLs are
automatically reloaded, and the request is repeated.
Under some circumstances there is a need to the reload of the endpoint URLs
manually. This can be achieved by utilizing report /OTX/PF13_P_CS_RELOAD_URLS.
After selecting the connection Id of the IES Cloud Edition execute the report. The
result screen shows a success message and the reloaded endpoint URLs.
3. Select the the Connection ID of the IES Cloud Edition and click the Execute
button.
The result screen shows a success message and the reloaded endpoint URLs.
In exceptional cases, the home document which contains the endpoint URLs cannot
be retrieved. To solve that issue, the endpoint URLs can be set manually. This can be
achieved by utilizing report /OTX/PF13_P_CS_RELOAD_URLS.
4. Select option Set buffered URLs, verify if values for the endpoint URLs are
pre-defined, and then click the Execute button.
The result screen shows a success message and the endpoint URLs.
Frequent problems:
Make sure that the certificate issue of the Core Capture service certificate was
added to the certificate list of SSL Client (Anonymous). For details refer to
chapter 4 of SAP note 510007 (Setting up SSL on Application Server ABAP).
3. Profile is stuck in ACTIVATING or RESETTING status. Make sure the IES request
handler report is scheduled as described “IES request handler” on page 30.
4. Message: “Error requesting token for <name of RFC destination> (http code 401).”
Make sure that the client id and client secret specified in the RFC destination for
the Core Capture token service is correct.
• the relevant requests to IES and responses from IES can be traced.
• and periodic snapshots of the ML repository can be created.
These features are referred to as tracing in this guide. A trace session is activated per
profile.
When a trace session is deleted, all its related entries in the tracing tables and
snapshot tables are also deleted.
To analyze Business Entity Determination (available for scenarios with version 2) the
results of the entity candidate determination in SAP are included in the tracing as
well. For displaying the results, the plugin Entity Candidates within Inbound
Administration work center can be used. For details, see “Inbound Administration
work center” on page 57.
Note: Start this option only if OpenText support team asks for it.
The data pool containing trace of all documents recorded in the trace session can
then be exported from the customer system. This data pool will be imported into the
OpenText development lab to recreate and fix customer issues.
Snapshots contain profile definitions and machine learning models. This data is
persisted in dedicated snapshot tables in SAP (/OTX/PF12_T_SPRF, /OTX/PF12_T_
SMOD, /OTX/PF12_T_SLT, /OTX/PF12_T_SLTT).
Execute transaction code FILE and configure the logical file name /OTX/PF11_IES_
TRACE_DIR.
Note: The operating system-dependent physical file path must end with
variable <FILENAME>
Notes
3. (Only for extended request trace) Specify the value of the parameter Document
threshold.
The parameter defines the number of fully processed documents, after which a
snapshot of the machine learning repository is created automatically. A
document is fully processed once the extraction session including feedback is
finished.
After that, all requests related to the profile are recorded
This part covers administration tasks that must be carried out only once.
Program: RM08RELEASE
Description: Releases blocks on MM documents and payment blocks on FI
documents (equivalent to MRBR transaction).
Suggested minimum frequency: Once a day
Parameters: Select Automatic Release check box.
Program: /PTGWFI/R_LIX_CLEANUP_WFS_NEW
Description: Handles actions taken outside of workflow, which can clear a
blocked invoice. This job removes associated redundant work items and
completes workflows.
Suggested minimum frequency: Once a day
Run after RM08RELEASE.
Parameters:
Invoice document
invoice document that you want to clear
Fiscal Year
fiscal year of the document that you want to clear
Program: /PTGWFI/R_PIR_CLEANUP_WFS
Description: Handles actions taken outside of workflow, which can clear a
parked invoice. This job removes associated redundant work items and
completes workflows.
Suggested minimum frequency: Once a day
Run after /PTGWFI/R_LIX_CLEANUP_WFS_NEW has completed.
Parameters:
Program: /ORS/000007_LOCK_CLEANUP
Description: Releases invoice locks as set by Web approval workflow.
Suggested minimum frequency: Every 30 min.
Parameters: None
Program: /OPT/VIM_R1A_REMINDER
Description: Sends out VIM reminder emails for overdue items.
Suggested minimum frequency: Once a day
Parameters: Select Background Mode
Table /OPT/T852 defines the number of grace days.
For a comprehensive description, see Section 39 “Using VIM Notifications” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Invoice Solution (VIM-CGD).
Program: RSWWERRE
Description: Restarts work items that are in error status.
Suggested minimum frequency: As defined by the workflow configuration
Parameters: None
Program: /OPT/VIM_TRIGGER_HEADER_WF
Description: Triggers the LIV Header Level Workflow.
Suggested minimum frequency: Twice a day or more often, depending on the
requirements
Parameters: None
Program: /OPT/CR_RERUN_RULES_JOB
Description: If the maximum wait time is configured for some DP Process Types
(exceptions), this program will complete the waiting work items for documents
with those DP Process Types. This job will publish the events PSS_Completed
and ProcessCompletedExternally. These events will enable the workflow to
rerun business rules.
Example: In the DP Goods Receipt Missing scenario of the SAP Supplier
Relationship Management (SRM) scenario, if the goods receipt is posted,
rerunning the business rules will resolve the GR Missing exception and continue
with the next process.
If the maximum number of tries is exceeded, the work item will be sent to the
dialog user to be resolved manually.
For Quantity and Price block scenarios, use the standard MRBR job and the
OpenText workflow clean up job to resolve work items which are in waiting
status.
Suggested minimum frequency: Every 4 hours
Parameters: Use variants for specific groups.
Program: /OPT/DR_BR_WAIT
Description: Reruns the process types that have been set into a wait step. When
the waiting interval has exceeded or the process type has been executed
successfully, the waiting step will be skipped.
Note: You must plan this job only if process types with wait / rerun option
exist.
Full Mode In Full Mode, the report collects all log entries of all existing documents and puts
them in a table, which will be used for the ILC report. Running the collection report
in Full Mode is time consuming, therefore OpenText recommends that you run it
only for documents that are relevant for the business process. You can use the
selection field Doc ID to exclude the irrelevant data for the Full Mode. The Full
Mode must be scheduled as a background job. It can take days to be completed
depending on the data volume.
When Full Mode is completed, a timestamp is inserted in the log table /OPT/VT_JOB
as last-run timestamp. This timestamp is reset every time when Full Mode is run.
Delta Mode The update timestamp is also updated for every run of the report in Delta Mode. In
Delta Mode, all documents that are still in process and which have been changed
since the last run are collected. No specific selection is available here.
Note: Delta Mode is allowed only when Full Mode is already run.
Selection Mode In Selection Mode, the report allows to collect a defined subset of documents. The
last-run timestamp is not updated.
Test Mode When you select this check box, the data is collected according to the selection. All
collected data is displayed in the output screen for checking. In this mode, no data is
saved in the database. The option is not available in Full Mode due to the big
amount of data. Even in Delta Mode, it can take much time to collect all data.
• OpenText recommends that you run the report with Delta Mode once a day, or
more frequently if required.
• The /OPT/VR_ILC_CLEANUP report is delivered for cleaning up all tables that are
filled by the /OPT/VR_ILC_COLLECTION report.
You can run the ILC collection report /OPT/VR_ILC_COLLECTION in Full Mode, Delta
Mode, or Selection Mode:
Full Mode
Run Full Mode only once. OpenText recommends that you run Full Mode in
background.
Delta Mode
Schedule Delta Mode in background periodically. OpenText recommends that
you schedule the report hourly or daily.
Selection Mode
Run Selection Mode in dialog for a small subset of documents. The documents
are included in the next delta run if scheduled.
• Collection Report
• User Master Report
• Text Master Report
• Aggregation Report
Keep in mind that the sequence of the jobs is important. Schedule Collection Report,
User Master Report, and Text Master Report before Aggregation Report.
After you have created variants of the Aggregation Report for the TRANSACT,
MASTER, and USER groups (see Section 31.4 “Creating variants of the Aggregation
Report for each group” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Invoice Solution (VIM-CGD)), you can schedule one batch job
with several steps or a dedicated batch job for each variant.
Regarding the order of the other groups for the batch job, the job for the TRANSACT
group should be scheduled after MASTER and USER jobs. In a multiple backend
system, also schedule jobs for the Group IDs that start with OTH*. You have to
consider how often it is necessary to update the respective data and schedule the job
accordingly.
Description
The OCR training status field is not updated in the DP document. This problem
can happen if the OCR is updating the status at the same time as the DP
document is processed in the system. To solve the problem, a new report is
provided to run in the central system when Inbound Configuration is used.
You need to plan the job only if you use BCC / ICC. For IES the report is not
relevant.
Suggested minimum frequency
Every 2 hours
Parameters
The selection screen provides the following parameters:
Registration ID
Optional: Enter a registration ID.
Backend Related Processing
Select this check box to update the training flag for all satellite system clients
that are in use.
Clear this check box to indicate a single system landscape. This will update
the training flag for the current logical system in which the job is running.
• Collection job
• Aggregation job
Note: Before running periodic jobs, you must complete all customizing steps
for the KPI Dashboard.
For comprehensive information, see Section 29.2 “Periodic jobs - collection and
aggregation” in OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Invoice Solution (VIM-CGD).
The report provides a Delta Mode that must be used in background processing to
fetch the correct data. For dialog processing, you can set a range of document IDs, a
range for company codes, a range for vendors, or also a time range. The Test Mode
displays all data that can be updated to the different tables.
If you do not provide a specific range for vendors or company codes, the report
fetches all relevant vendors and company codes that are relevant for Supplier Self
Service and configured. For more information, see Section 23.5.2 “Mapping
company codes” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Invoice Solution (VIM-CGD) and Section 23.6.2 “Mapping
suppliers” in OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Invoice Solution (VIM-CGD).
You can also use the report in a multiple backend system. In the VIM Invoice
Configuration (/OPT/SPRO transaction), there is a customizing for the Collection and
Aggregation reports; see Section 31 “Central Reporting infrastructure” in OpenText
Vendor Invoice Management for SAP Solutions - Configuration Guide for Invoice Solution
(VIM-CGD). For the Supplier Service Application, an aggregation reporting group
ID (3S) already exists.
For a detailed description of the Supplier Self Service customizing, see Section 23
“Supplier Self Service” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Invoice Solution (VIM-CGD).
Note: This section provides information on background jobs relevant for Ariba
Network integration, the scenario with Business Suite add-on. For other
integration scenarios, no special programs are required apart from those
provided by SAP. For more information, see the respective SAP
documentation.
You can verify the results of the inbound and outbound processing in the
application log, transaction SLG1, to be started with object ARIBA_INTEGRATION.
Note: Make sure that the corresponding background jobs are scheduled as
described in “Batch jobs for Inbound Configuration” on page 22.
Suggested The job run frequency depends on your business processes. OpenText recommends
minimum running fetching and cancellation jobs more often if cancellations are expected. This
frequency
prevents unnecessary processing of invoices that are cancelled by the vendor.
To process invoice cancellations sent by suppliers, if you are using the SOAP
messages scenario, schedule the program /OPT/VIM_ARBCIG_CANCELLATIONS to run
periodically. When setting up a variant for the program, you can enable cleanup of
old entries in the cancellations staging table (/OPT/VIM_CIGCANC). Decide on the
number of months for processed entries to be kept, for example 12 months, select the
Cleanup check box, and enter the month count accordingly.
In the SAP NetWeaver BW context, you can use process chains for the automatic
processing of loading data and updating data targets in reporting. The VIM BW
content provides the meta process chains for BW KPI content and BW ILC content.
Meta Process Chain for Delta Load of VIM Data w/o Corp. Mem. (technical
name: /OPT/VIM_ALL_01)
This meta process chain is used to upload master data and transaction data from
the leading OLTP system without storing data records in the Corporate Memory
Layer and to further upload the data to the Reporting Layer; this means to the
InfoCubes.
Meta Process Chain for Delta Load of VIM Data with Corp. Mem. (technical
name: /OPT/VIM_ALL_02)
This meta process chain is used to upload master data and transaction data from
the leading OLTP system while additionally storing the data records in the
Corporate Memory and to further upload the data to the Reporting Layer; this
means to the InfoCubes.
Note: Before scheduling and triggering the Meta Process Chain, the delta load
of DP Document Headers and Exceptions must be initialized using the
InfoPackages /OPT/VIM_DPDOC_H_TRAN_INIT and /OPTVIM_EXC_TRAN_INIT.
Process options
Meta Process Chain for Delta Load of ILC Data w/o Corp. Mem. (technical
name: /OPT/VIM_ILC_ALL)
This meta process chain is used to upload master data and transaction data from
the leading OLTP system without storing data records in the Corporate Memory
Layer and to further upload the data to the Reporting Layer; this means to the
InfoCubes.
Meta Process Chain for Delta Load of ILC Data with Corp. Mem. (technical
name: /OPT/VIM_ILC_ALL_02)
This meta process chain is used to upload master data and transaction data from
the leading OLTP system while additionally storing the data records in the
Corporate Memory and to further upload the data to the Reporting Layer; this
means to the InfoCubes.
Note: Before scheduling and triggering the Meta Process Chain, the delta load
of ILC entries must be initialized using the InfoPackage /OPT/VIM_ILC_TRAN_
INIT.
Process options
Program name
/OTX/PS03_FCLEANUP
The download programs are used to provide data for look up tables used by ICC for
better recognition results. ICC uses the vendor look up table to determine the
vendor number and in turn supplies it back to SAP S/4HANA. The PO delivery look
up table helps ICC to achieve better recognition and extraction.
There are some tools for staging tables included in the product. You can use the
programs /OPT/VIM_ICC_SIMUL_PO_DL and /OPT/VIM_ICC_SIMUL_VENDOR_DL to
simulate an RFC download by ICC. The simulation can be useful to find out the
reasons for download issues. You can find out how much time is spent in the RFC
function modules and if there are memory or performance issues on the SAP S/
4HANA side.
Note: Schedule the download programs as batch jobs. The job logs provide
information about the status.
Vendor number
Enter the vendor number (range).
Note: The program will run with higher performance if you enter
several single values instead of a range.
If you specify one or more company codes, only the vendors having an
association to the given company codes in table LFB1 are written to the
staging table. The deletion and posting block flags are evaluated in
relationship to the company code (that means, from the LFB1 table). The
entries in the staging table contain company codes. If a vendor is associated
to several company codes, several entries for this vendor are written to the
staging table.
If you do not specify a company code, the vendors that have an association
to any company code in table LFB1 are written to the staging table.
Additionally, also the vendors that do not have an association to a company
code will be drawn from table LFA1 and written to the staging table. The
entries in the staging table contain a company code, if they were taken from
table LFB1. The entries do not contain a company code, if they were taken
from table LFA1.
Output to screen
This program runs in background and collects the vendor information. If the
program is running in the central system, it collects the vendor information from all
satellite systems using function module /OPT/DOWNLOAD_LY_DATA. The program
stores the vendor information in the central system’s staging table (along with the
satellite system’s logical system).
• Vendor number
• Company code
• Bank details
• Vendor address
• VAT and tax information
• Vendor email, IBAN, SWIFT code
• Timestamp (of record creation)
The vendor database contains one or more lines for each vendor number within a
logical system. Several lines for the same vendor are generated in the following
cases:
• There are multiple bank data for the vendor, and the multiple bank data switch is
set.
• There are foreign VAT IDs in table LFAS.
Enhancements VIM 7.5 SP3 (and VIM 7.0 SP7) introduce the following enhancements for the /OPT/
IR_DL_VENDOR_TO_STG_TABLE program.
The downloading program has two basic modes, the delta mode and the full mode.
Delta mode The delta mode selects and adds entries that match with the given selection criteria.
The delta mode is not able to delete any entries.
Full mode The full mode deletes the entries for the selected company codes. Then, it recreates
the entries that match with the given selection criteria. You must use the full mode
from time to time to clear entries that should not be downloaded to ICC anymore.
The report for the PO download should be scheduled twice, one time for the full
download to run once a week or once a month, and one time for the delta download
to run once a day. For a ICC application (since ICC 7.0), two hotspots for PO
download are generated, one for the full download running once a week, and one
for the delta download running once a day. To have the PO database at the ICC as
up-to-date as possible, you must schedule the reports on VIM side to run at an
earlier time than the hotspots on ICC side.
Since VIM 7.5 SP4 (VIM 7.0 SP8), you can use several program runs to fill the staging
tables, separated by the selection criteria for company code. You can configure the
jobs along with the ICC application filters.
Example: If you have two ICC applications, one for company code A and another one for
company code B, you can use one pair of full mode and delta mode runs for each application.
If you want to use several program runs to fill the staging tables, you must modify
your variants and the scheduling of the jobs. Observe the following principles:
• Find out which filters on company codes are used by your ICC applications. You
can schedule a pair of full download and delta download for each different filter.
• Use identical selections on company code in each pair of full download and delta
download.
• Schedule the programs in a way that the run times do not overlap. Parallel
processing is not possible because there still is only one staging table.
Vendor
Enter the vendor number (range).
Company code
Enter the company code (range).
Delta Download
Select this check box to determine that the program reads the table /opt/
it_dl_ts and gets the time stamp of the last program run. The following
date fields will be replaced with the date part of the time stamp:
Note: You can increase the performance of the program, if you use a
date in the future in this field. Use a future date only, if you are not
interested in the delivery notes, and if your quantities and amounts in
the goods receipt match the data from the purchase order.
If the program is running in the central system, it collects the purchase order
information from the satellite systems by calling the Remote function module /
OPT/DOWNLOAD_PO_DATA.
Output to screen
The sections Open only check and Vendor substitution * appear only, when the
respective processing options have been selected in the selection screen.
Note: The number in section Order number table gives the remaining number
of PO entries that are written to the staging table. In the example, 4040 order
numbers have been found, 1970 have been removed due to the “open only”
check, and 2070 have been written to the staging table for download.
The log entry 3 vendors substituted means that the vendor substitution has
been performed in 3 POs. It does not mean that three different vendors were
involved.
In the Global settings area, you can select the following check boxes:
The Minimum Age In Months parameter indicates the minimum age of the entries
to be deleted. Specify the age in months, maximal value is 24.
If the program is not run in test mode, and if dialogs are not skipped, a confirmation
dialog box opens before the deletion occurs. The dialog box does not open if nothing
has been found to be deleted.
For detailed information on IES, see OpenText Intelligent Capture for SAP Solutions -
Installation and Administration Guide (CPIE-AGD).
The programs extract master and transaction data from the central and satellite
systems, and store the data in staging database tables. The following programs are
provided:
/OTX/PS00_P_IDF_COMP_CODE
This program extracts company codes. For more details, see “Batch jobs for
Inbound Configuration” on page 22.
/OTX/PS00_P_IDF_VENDOR
This program extracts vendor information. For more details, see “Batch jobs for
Inbound Configuration” on page 22.
/OTX/PS00_P_IDF_NUM_RANGES
This program extracts number ranges. In particular, it is used for purchase order
number ranges.
/OPT/IR_DL_PO_TO_STG_TABLES
This program extracts purchasing documents data. For more details, see
“Downloading PO data from SAP S/4HANA” on page 144.
/OTX/PS00_P_IDF_PLANT
This program extracts plant information. In particular, it is used for Business
Entity Determination.
Note: Schedule the download programs as batch jobs. The job logs provide
information about the status. You must schedule the jobs on all satellite
systems and on the central system. Make sure that the central system jobs run
only after all satellite systems jobs are finished.
Object name
Name of the number range object. Currently, only the object EINKBELEG, set by
default, needs to be extracted.
7.4 Roles
The VIM role concept is comprehensively described in Section 4 “Roles” in OpenText
Vendor Invoice Management for SAP Solutions - Configuration Guide for Invoice Solution
(VIM-CGD), which covers the following topics:
• Defining roles
• Defining role templates
• Assigning templates to roles
• Maintaining role determination settings
Default Key
If the system cannot find any related key, it uses the Default Key user. It is
essential that you maintain the default key user for all roles to avoid that the
workflow results in error when it cannot perform the role resolution correctly.
Fail Safe
Fail Safe applies if the Default Key is not maintained. Other than the Default
Key, it offers the possibility to make the maintained values applicable only in
background.
2. Maintain the Fail Safe user key types Fail Safe and Default Key for all roles,
using the following parameters:
Notes
Agent Type
Select the agent type.
Agent Id
Select the agent Id.
Purposes
• Supporting when processing large line items and a larger number of levels.
Features
• When the background task is in progress, the user can check the status of the
background task using the SM50 transaction until the background task finishes.
• If the background task fails to update the approval tables, the user who has
approved the invoice gets the following error in their inbox:
Update was cancelled <Date> <User name>
When they open the message in their inbox, they get the following detailed error
message:
After the background task is completed, they would be able to open the invoice.
However, you can create a role to view the VIM configuration with “display only”
authorization.
Note: Depending on the SAP version, the following screens might look
different on your system.
4. In the Copy menus panel, click the From area menu button.
5. Enter /OPT/VIM in the Area menu field and click to start the search.
7. Select all check boxes under Area menu and click the Add button at the bottom
of the dialog.
8. In the Change Roles screen, save.
Select the Authorizations tab.
11. Enter appropriate values in the From and To field and click the Full
authorization button.
13. Expand all nodes and assign Display authorization to the needed Activity
fields. To define values for an Activity field, click the icon next to the field.
14. To add Display authorization for all transaction starting with /OPT/, click the
Manually button in the application tool bar.
15. In the Manual selection of authorizations dialog, enter S_TCODE in the topmost
Authorization object line and click to confirm.
The new authorization object is displayed in the Change role: Authorizations
screen.
16. To open the Maintain Field Values dialog, click the icon next to the
Transaction code field (see highlight).
18. In the Change role: Authorizations screen, click to save your settings.
19. Click the button in the application tool bar to generate the authorization
profile.
20. Click the icon to return to the Change Roles main screen and open the User
tab.
21. Enter the early watch user or a different user that you want to assign to the
newly created Display VIM configuration role.
Users assigned to the new role are allowed to view the VIM configuration with
“display only” authorization.
The Approval Portal is designed to work within SAP NetWeaver Application Server
Java (NWAS) or SAP NetWeaver Portal (NWP). The Approval Portal can be
deployed as a standalone application residing on NWAS only or as an application
inside NWP using the AppIntegrator iView.
Notes
• If you are not using the Approval Portal component, you can skip this
chapter.
As the administrator, you need to access the Administration page to perform various
administration activities for the Approval Portal.
All configurations are saved into the configuration.xml file located in <Approval_
Portal_installdir>/invoiceCfg.
HTTPS support
For Approval Portal 7.5, the heading of the Approval Admin page shows the
Approval Portal version as VIM 7.5.3.<Build Number> Build on <Date>, for example
VIM 7.5.3.1005 Build on 2014/12/10.
With Approval Portal 7.5 SP3, you can decide if you want to use SAP Java Connector
2 (JCo2) or JCo3. The configuration of these versions differs. It is described in the
following sections.
To add the JCo RFC destination, follow the description in “SAP Connection for
JCo3” on page 167.
JCo2
To add SAP connections, follow the description in “SAP Connection for JCo2”
on page 165.
In the SAP Connection tab for JCo2, you can perform the following actions:
Add Connection
Add a new SAP connection. Opens the Connection Details panel. See
“Connection Details” on page 166.
Edit Connection
Edit an existing SAP connection. Opens the Connection Details panel. See
“Connection Details” on page 166.
Delete Connection
Delete a SAP connection.
Refresh All Connections
Refresh the connections after you made changes. Without the refresh, the
Approval Portal will continue to use existing connections.
Up Arrow
Move the connection priority up.
Down Arrow
Move the connection priority down.
Note: The first connection in the list is used as the default connection. The
default connection determines the Invoice List’s action and its Personalization
preferences. For more details, see Section 9.14 “Personalizing your views of the
Approval Portal” in OpenText Vendor Invoice Management for SAP Solutions -
User Guide for Invoice Solution (VIM-UGD).
Connection In the Connection Details panel, the following configuration parameters are
Details available. Enter the relevant information:
SAP SID
Unique identifier for this SAP S/4HANA Logical System. The SAP SID will
appear on the end user screen next to the Logical System to help the user
identify which system the invoice is coming from.
Note: If you want to connect to the same SAP S/4HANA Logical System
but with a different client, you must provide a different SAP SID. The
Approval Portal treats the SAP SID as a unique identifier.
UserName
The CPIC user’s user name that will be used to connect to SAP S/4HANA
Password
The CPIC user password that will be used to connect to SAP S/4HANA
Client
The client number of the SAP S/4HANA system that is connected to
If you are using Application host instead of Message host, provide the following
information:
System number
The system number of the SAP S/4HANA system that is connected to
Application host
The application host IP or DNS of the SAP S/4HANA system that is connected to
If you are using Message host instead of Application host, provide the following
information:
MsHost
The Message host IP or DNS of the SAP S/4HANA system that is connected to
R/3 name
The R/3 name of the SAP S/4HANA system that is connected to
Logon Group
The logon group of the SAP S/4HANA system that is connected to
System number
The system number of the SAP S/4HANA system that is connected to
Save
Save the SAP connections. If the connection is invalid, you will not be able to
save.
Test
Test the SAP connections. If the connection fails, it will return a failure message
to you.
Note: Approval Portal with JCo3 is supported with SAP NetWeaver server
version 7.3 or higher.
On the SAP Connection tab, click Enable JCo3 to start the configuration.
1. In the JCo RFC Destination box, enter the <system ID>, for example TW6.
Note: You must enter the system ID also in the destination configuration.
For more information, see “Configuring the RFC destination name on SAP
NetWeaver Administrator” on page 168.
2. Click Add.
The system ID is added to Available JCo Details.
3. To remove an entry from the Available JCo Details, enter the entry, for
example TW6, in the JCo RFC Destination box, and click Delete.
OpenText recommends that you clear the JCo destinations metadata whenever you
do any modifications to the ABAP RFC structure/table entries. This ensures that the
updated metadata is copied to the server’s cache.
2. On the Availability and Performance tab, click Resource Monitoring > JCo
Monitoring.
3. On the Metadata Cache tab, mark the required Application Server ID.
4. On the Functions tab, click Select All, and then click Clear.
5. On the Structures tab, click Select All, and then click Clear.
6. On the Classes tab, click Select All, and then click Clear.
7. After clearing the metadata cache, log in to the Approval Portal as admin and
reinitialize the application.
Hosting System
Enter the available Local NetWeaver Instance
Destination Name
Enter the destination names: VIMPOOL_<XX> and VIMPOOL_<XX>_<YY>
where <XX> refers to the SAP system ID provided in Destination
Configuration, and
<YY> refers to the language code supported by SAP. The language code
should be the same language as provided in the Logon Data section.
Destination Type
Enter RFC.
5. For every SAP system ID, create the following mandatory destinations:
Default Destination
Destination Name = VIMPOOL_<XX>
where <XX> refers to the SAP system ID provided in Destination
Configuration.
Language Destination
Destination Name = VIMPOOL_<XX>_<YY>
where <XX> refers to the SAP system ID provided in Destination
Configuration, and
<YY> refers to the language code supported by SAP. The language code
should be the same language as provided in the Logon Data section.
• VIMPOOL_TW6
• VIMPOOL_TW6_EN
• VIMPOOL_TW6_DE
• VIMPOOL_TW6_FR
6. For multi-client support of an SAP system ID, create the following mandatory
destinations:
Default Destination
Destination Name = VIMPOOL_<XX>
where <XX> refers to the SAP system ID provided in Destination
Configuration along with the client.
Language Destination
Destination Name = VIMPOOL_<XX>_<YY>
where <XX> refers to the SAP system ID provided in Destination
Configuration along with the client, and
<YY> refers to the language code supported by SAP. The language code
should be the same language as provided in the Logon Data section.
• VIMPOOL_TW6800
• VIMPOOL_TW6800_EN
• VIMPOOL_TW6800_DE
• VIMPOOL_TW6800_FR
• VIMPOOL_TW6400
• VIMPOOL_TW6400_EN
• VIMPOOL_TW6400_DE
• VIMPOOL_TW6400_FR
Hosting System
Enter the available Local NetWeaver Instance
Destination Name
Enter the destination names: VIMPOOL_<XX> and VIMPOOL_<XX>_<YY>
where <XX> refers to the SAP system ID provided in Destination
Configuration, and
<YY> refers to the language code supported by SAP. The language code
should be the same language as provided in the Logon Data section.
Destination Type
Enter RFC.
5. Click Next.
Target host
Enter the application host IP or DNS of the SAP S/4HANA system that is
connected to.
System number
Enter the system number of the SAP S/4HANA system that is connected to.
System ID
Enter the SAP SID of the SAP S/4HANA system that is connected to.
Message Server
Enter the message host IP or DNS of the SAP S/4HANA system that is
connected to.
Logon Group
Enter the logon group of the SAP S/4HANA system that is connected to.
Click Next.
7. Configure logon data
On the Logon Data screen, configure logon data, using the following
parameters:
Authentication
Enter Technical User.
Language
For the default destination VIMPOOL_<SID>, you can enter any default
language. For a language destination like VIMPOOL_<SID>_<LANGUAGE>,
enter the respective language, for example DE in case of VIMPOOL_TW6_DE.
Client
Enter the client number of the SAP S/4HANA system that is connected to.
User Name
Enter the CPIC user name that is used to connect to SAP S/4HANA.
Password
Enter the CPIC user password that is used to connect to SAP S/4HANA.
Click Next.
Click Finish.
In the Mobile Configuration tab, you configure the Mobile Approval Portal. See
“Configuring the Mobile Approval Portal” on page 213.
7.8.1.4 Configuration
With VIM 7.0 and higher, you configure fields and buttons of the Approval Portal
inside SAP S/4HANA. See Section 11.4.12 “Configuring fields for Invoice Approval”
in OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Invoice Solution (VIM-CGD).
With VIM 7.5 SP3 and higher, the Configuration tab of the Approval Portal is split
into four sections.
• General Configuration
• Security Configuration
• Image Configuration
• UX Configuration
General Configuration
Profit Segment
Select YES if you want to enable a Profit Segment button in the Processing
Invoice page. See Section 9.9 “Entering accounting information” in OpenText
Vendor Invoice Management for SAP Solutions - User Guide for Invoice Solution
(VIM-UGD). For configuration aspects of the profitability segment, see Section
11.10 “Configuring the profitability segment feature” in OpenText Vendor Invoice
Management for SAP Solutions - Configuration Guide for Invoice Solution (VIM-
CGD).
Limitations for the Profit Segment dialog box
Special Handling
Select Yes if you want to use Special Handling. The Approval Portal will display
the Handling Instruction link on the Basic Data tab.
For more information, see Section 9.6 “Viewing and adding handling
instructions” in OpenText Vendor Invoice Management for SAP Solutions - User
Guide for Invoice Solution (VIM-UGD).
• The History Count value is higher than the History invoices count
• The user might revert unsaved data back to the original field values. In this
case, the original data is not tracked. The warning message for saving the
data appears nevertheless.
• The warning message is only displayed when the user tries to switch
between tabs or to a new work item in the inbox from the Cost Assignment
tab.
Notes
• For the new bulk field, use the field from the /ORS/INVOICE_HDR
structure of the /OPT/OAP_GET_INVOICE_DETAIL RFC.
• In the Lang_EN.properties file, make sure that the new entries are
present between bulkFieldsStartKey=0 and bulkFieldsEndKey=1.
• Modifying the properties files is also necessary if you want to change the
description of the available bulk fields.
Displayed Bulk Mode Fields
By default, 6 fields are displayed in the Displayed Bulk Mode Fields list.
To change the sort order, use the up and down arrow buttons next to the list.
To remove the selected bulk mode field from the Displayed Bulk Mode Fields
list, click Remove.
To reset the bulk mode fields to the default fields, click Reset.
To have the configured bulk mode fields displayed in all users’ bulk mode
inboxes, save the configuration and reinitialize the application.
Security Configuration
Image Configuration
1. Enter the file extensions of the document types you want to support for
attachments, separated by comma.
For attachments, the Approval Portal only supports the Microsoft Office
document types doc, docx, xls, xlsx, ppt, pptx as standard document
types.
Note: You must customize the specified document types and file
extensions in the SAP/VIM backend customizing accordingly. For
more information, see Section 3.3 “Required customizing for
additional attachment upload in the Invoice Approval process” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Invoice Solution (VIM-CGD).
Example: If you want to add the msg (Microsoft Outlook message) file
extension, add the entry msg = application/msg.
c. Reinitialize the application, see “Administration” on page 181.
UX Configuration
Select the Enable Coding Templates check box to enable the coding templates
feature. By default, the check box is selected.
With coding templates enabled, the Cost Assignment tab provides the following
additional buttons:
• Export Coding
• Upload Coding
Limitations
• Using coding templates, a user can upload a maximum of 50 line items. More
than 50 line items are not supported.
User notes
• For an invoice, a user should only upload the coding template that was
downloaded from that invoice.
• The 1st row of the downloaded coding template is hidden. It contains
the column metadata. The 2nd row displays the column titles. To
properly upload the coding template, users should not edit or delete
these two rows. Users should only do the coding from the 3rd row on.
• The coding templates feature is applicable only for coders.
• In the downloaded Excel file, for the newly added line items, the user
should leave the INVOICE_DOC_ITEM field blank. After uploading the
Excel file, this field is automatically populated with the last line item
number. When saving the changes, the INVOICE_DOC_ITEM field is
automatically generated.
• In the downloaded Excel file, for the newly added line items, the user
might fill the INVOICE_DOC_ITEM field with the existing line item
number. During upload of the Excel file, the additional accounting data
of the respective line item is copied to this line item.
Save
Click this button to save the configuration.
7.8.1.5 Administration
The Administration tab allows you to perform Administration tasks on the
application. It also tells you the Version and the Build Date of the application.
Reinitialize Application
Click this button to reinitialize the application. This is necessary after you
changed the configuration or if you change the language resource files. See
“Changing language resources” on page 201 for more details.
Along with Web Approval Portal, you can integrate Mobile Approval Portal as a tile
in Fiori Launchpad.
Fiori Launchpad is an interface to launch SAP Fiori apps and other applications as
tiles on mobile and desktop devices. Each tile represents an application that the user
can open.
You configure Approval Portal as a tile in Fiori Launchpad using the following tools:
Existing Approval Portal (new UI) customers running on SAP standalone WAS or
SAP NetWeaver Portal can enable this feature with additional installation of SAP
Gateway Front-End Server. The minimum requirement version is SAP Gateway
Foundation 7.40 (AddOn SAP_GWFND).
For standalone WAS Approval Portal, use single sign on users for Fiori Launchpad
access and create them on the SAP Gateway Front-End Server or the other way
round.
For SAP NetWeaver Portal, portal or ABAP UME users for Approval Portal must
exist on SAP Gateway Front-End Server or the other way round. Additionally, the
same users must be available in the VIM Chart of Authority (COA) (/n/opt/ar_coa
table) in the Windows_ID column instead of the SAP Portal column.
Approver1 is an SAP user created on SAP Gateway Front-End server for Fiori
Launchpad access.
Approver1 must exist on Portal UME from data source of ABAP UME or
LDAP.
You can integrate Web and Mobile Approval Portal (new UI) on Fiori Launchpad in
one of the following ways:
Note: Signing out from Fiori Launchpad does not sign out the Web and Mobile
Approval Portal session user. For access by a different user, open a new
browser session and launch Fiori Launchpad.
When creating tiles in Fiori Launchpad, the application must use target mapping of
other SAP Fiori apps. Perform the following procedures:
1. Sign in to SAP Gateway server with administrator rights and run the LPD_CUST
transaction to create Launchpad role and Launchpad instance. Click New
Launchpad in the application toolbar.
2. In the Enter Values for a new Launchpad dialog box, configure the new
launchpad using the following parameters:
Role
Instance
Enter TRANSACTIONAL.
Description
Enter a meaningful description, for example:
Web Approval Portal app
Enter Approval Portal Launchpad Instance.
Mobile Approval Portal app
Enter Mobile Approval Portal Launchpad Instance.
Namespace
Enter any custom namespace.
Type of Launchpad
Enter Standalone Launchpad.
Link Text
Enter description text of the application.
Application Type
Select URL.
URL
Web Approval Portal app
Enter http:<Host>:<Port>/vimportal/wapp.html
Example: http://wtlr3w01.opentext.net:50000/vimportal/wapp.
html
Example: http://wtlr3w01.opentext.net:50000/vimportal/mapp.
html
Note: The application URL that you define here is the same for both
Approval Portal Standalone WAS and NetWeaver Portal scenario.
6. Enter the Application Alias. Leave the rest of the Portal Parameters as default.
If you want to customize parameters, see the SAP Fiori Launchpad
Configuration Guide.
Semantic Object
Web Approval Portal app
Enter ZVIMJAVA.
Mobile Approval Portal app
Enter ZVIMMJAVA.
This section describes how to create catalogs and tiles in Fiori Launchpad Designer.
The created catalogs are assigned to users with role personalization. Finally,
Launchpad users see the Fiori apps based on their role.
2. Create catalog
Make sure that you are in the Catalogs section. Click the plus icon in the footer
of the screen.
In the Create Catalog dialog box, click Standard. Define the new catalog using
the following parameters:
Title
ID
4. Create tile
Click the plus icon on the empty tile and select the App Launcher - static tile.
Title
Subtitle
Standalone WAS Portal
Semantic Object
Action
DISPLAY
8. In the Target area, configure the target mapping using the following
parameters:
Semantic Object
Web Approval Portal app
Enter ZVIMJAVA.
Mobile Approval Portal app
Enter ZVIMMJAVA.
Action
Enter DISPLAY.
Application Type
Select SAP Fiori App using LPD_CUST
Launchpad Role
Web Approval Portal app
Enter ZAPPROVAL.
Mobile Approval Portal app
Enter ZMAPPROVAL.
Launchpad Instance
Enter TRANSACTIONAL.
Application Alias
Web Approval Portal app
Enter VIMJAVA.
Mobile Approval Portal app
Enter VIMMJAVA.
Device Types
Select the Desktop, Tablet, and Phone check boxes.
To create a role and to assign catalog and tiles to the Fiori Launchpad users:
1. Sign in to the SAP Gateway Front-End server. Run the PFCG transaction and
create a Single Role.
2. On the Menu tab, click SAP Fiori Tile Catalog.
3. In the Assign Tile Catalog dialog box, select the Catalog ID that you have
created on Fiori Launchpad Designer.
This section builds a trust relationship between SAP Gateway Front-End Server and
the SAP NetWeaver Portal J2EE engine by import and export of certificates. This
section also describes how to avoid authentication dialog boxes that are opened
when the Web Approval Portal Fiori app or the Mobile Approval Portal Fiori app is
clicked.
1. Sign in to SAP Gateway Front-End Server and run the STRUSTSSO2 transaction.
Click the System PSE folder and then click on the Subject certificate link to
display the complete certificate. To export the certificate, click Export
Certificate.
3. Click Add Trusted System and then click By uploading the certificate
manually.
4. Enter the SystemID of the trusted system and upload the certificate that you
have exported from SAP Gateway Front-End Server. Click Next to complete the
configuration.
4. In the Login Modules area, remove the listed Login Module Names.
5. Save your changes.
To check the Domain setting in the Approval Portal Admin Console and the
Chart of Authority:
1. Open the Approval Portal Admin Console. For more information, see
“Configuration” on page 174.
2. On the Configuration tab, make sure the value of Domain (Standalone WAS
WebApproval Portal & Mobile Portal) is set to OPTURA.
3. Sign in to the SAP S/4HANA system where VIM is installed and run the /OPT/
AR_COA transaction.
4. On the User Details tab, make sure the value in the Windows Domain column
is set to OPTURA.
5. To verify that the configuration was successful, sign in to the Fiori Launchpad
and click the Web Approval Portal Fiori app or the Mobile Approval Portal
Fiori app that you have created.
Note: Signing out from Fiori Launchpad does not sign out the Approval Portal
session user. For access by a different user, open a new browser session and
launch Fiori Launchpad.
This section describes how to create catalogs and tiles in Fiori Launchpad Designer.
The created catalogs are assigned to users with role personalization. Finally,
Launchpad users see the Fiori apps based on their role.
2. Create catalog
Make sure that you are in the Catalogs section. Click the plus icon in the footer
of the screen.
In the Create Catalog dialog box, click Standard. Define the new catalog using
the following parameters:
Title
ID
4. Create tile
Click the plus icon on the empty tile and select the App Launcher - static tile.
Title
Subtitle
Keywords
DISPLAY
Target URL
To create a role and to assign catalog and tiles to the Fiori Launchpad users:
1. Sign in to the SAP Gateway Front-End server. Run the PFCG transaction and
create a Single Role.
3. In the Assign Tile Catalog dialog box, select the Catalog ID that you have
created on Fiori Launchpad Designer.
Follow the description in “Approval Portal Admin Console and VIM Chart of
Authority” on page 195.
Note: The Mobile Approval Portal app, configured as Launchpad tile, supports
the browsers as specified in the VIM Mobile Approval compatibility
specifications. For more information, see the Release Notes.
Product Code
IAP
Constant
EXIT_SEARCH_HELP_FLT
Constant Value
/ORS/SEARCH_HELP_FIELDS_PREFIL
The interface of the custom function must be the same as the interface of the baseline
function /ORS/SEARCH_HELP_FIELDS_PREFIL:
FUNCTION /ORS/SEARCH_HELP_FIELDS_PREFIL.
*"-----------------------------------------------------------------
*"*"Local Interface:
*" IMPORTING
*" VALUE(SHLPNAME) TYPE SHLPNAME
*" VALUE(INVOICE_HEADER) TYPE /ORS/INVOICE_HDR OPTIONAL
*" VALUE(CURRENT_APPROVER) TYPE /ORS/UMOID OPTIONAL
*" TABLES
*" RETURN STRUCTURE BAPIRET2 OPTIONAL
*" FIELDLIST STRUCTURE /ORS/SEARCHHELP_FIELD_LIST
*" ACCT_DATA STRUCTURE /ORS/INVOICE_ACCT_DATA OPTIONAL
*" EXCEPTIONS
*" NOT_FOUND
*"-----------------------------------------------------------------
ENDFUNCTION.
The custom function is called from the standard RFC function /ORS/GET_SEARCH_
HELP_FIELDS.
In the TABLES parameter of the sample function module, the FIELDLIST field refers
to the structure /ORS/SEARCHHELP_FIELD_LIST. The fields Value and Display only
are added to this structure.
Value
This field is used to set the default value for the search field.
Display only
This field is an indicator that the search field value cannot be changed by the
user in the Approval Portal.
The custom function should fill these fields with appropriate values according to
your requirements.
Important
Any changes made by the logic in the custom function module to the fields
other than Value and Display only will result in unexpected results or errors.
Java compiler and other Java tools can only process files which contain Latin-1
and/or Unicode-encoded characters (\u<XXXX> notation).
Tip: You can also use any editor that can save as “Unicode Enabled”, for
example https://marketplace.eclipse.org/content/properties-editor.
• Czech (CZ)
• German (DE)
• English (EN)
• Spanish (ES)
• French (FR)
• Hungarian (HU)
• Italian (IT)
• Japanese (JA)
• Dutch (NL)
• Polish (PL)
• Portuguese (PT)
• Romanian (RO)
• Russian (RU)
• Slowakian (SK)
Note: The Slowakian translation does not include KPI Dashboard and
Central Reporting.
• Turkish (TR)
• Chinese (ZH)
This section describes the configuration to add another language than the
predefined. Therefore, you have to perform the following actions:
Example: If you want to add Swedish language, add the entry V=SV.
Note: This entry is a SAP language key pair. Check the SAP help for a list
of language key pairs.
4. Open the new Lang_<XX>.properties file and translate the English strings into
the other language.
Convert non-ASCII characters to Unicode representative format, see Step 3
on page 201 in “Changing language resources” on page 201.
For Approval Portal 7.5 and higher, there is no need to have a separate CSS
stylesheet for every language, like it was the case in prior versions.
2. To modify any styles, perform the changes in the global CSS file.
You must include calendar popup strings in the new language to the
localization.js JavaScript file.
Note: If the locale file is not existing for the new language, copy the
default coding parts for English language and translate the text into the
new language.
7. For Swedish, as an example, copy the coding for Ext.Date and Ext.picker.
Date from file ext-lang-sv_SE.js into the new else if clause checking the
parameter langId==’SV’.
See Example 7-4, “Adapting the localization.js file for Swedish” for details.
Note: If you do not add the new language here, it will not appear at the
user's preferences.
3. Save your changes.
For a description for NetWeaver 7.3 and 7.4, see “To restart the Approval Portal
application (NetWeaver 7.3 and 7.4):“ on page 206.
To include the new language into the application, you must stop and start the
application from Visual Admin.
1. In Visual Admin, navigate to Instance > Server > Services > Deploy.
2. Expand servlet_jsp.
5. When the application is stopped, select it again and click Start Application.
6. Click OK to confirm.
Important
To make the language change effective, the end user must clear the
browser cache.
2. Navigate to Operations > Systems, and then click Start & Stop.
3. Click the Java Applications tab and mark the Approval Portal application.
Important
To make the language change effective, the end user must clear the
browser cache.
For a description for NetWeaver 7.3 and 7.4, see “To configure attachment support
(NetWeaver 7.3 and 7.4):“ on page 209.
7. Click Update.
7.8.6 Branding
You might need to change the logo of the Approval Portal. This section describes
how to do this.
Notes
• You must perform the same action when you are applying a new patch.
• OpenText recommends backing up the image or the files if you need to
apply a new patch.
The customer specific brand image must have the following size (in pixels) 328x24,
and the name headerbar_vendor_invoice_management.png.
Before rename:
After rename:
3. Stop and start the application instance. For more information, see “To restart the
Approval Portal application (NetWeaver 6.0 or 7.0):“ on page 205 and “To
restart the Approval Portal application (NetWeaver 7.3 and 7.4):“ on page 206.
Important
OpenText strongly recommends that you validate and test this configuration in
the test system before moving to productive environments.
Notes
1. Log on to SAP NetWeaver Portal with a user having the Administrator role.
2. In the application toolbar, click System Administration. Then, in the navigation
panel, click UME Configuration. Click the Open Expert Mode button at the
very right of the window.
The Expert View dialog box opens, showing UME parameters.
3. Search for ume.logoff.redirect as search string. The following parameters
are retrieved. Click the Modify button to enter the parameters:
ume.logoff.redirect.silent = false
ume.logoff.redirect.url = http(s)://<host>:<port>/vimportal/
LogOutServlet?nwpParam=X
<host> is the SAP NetWeaver Portal instance host where Approval Portal is
running
<port> is the SAP NetWeaver Portal instance port where Approval Portal is
running
4. Click Save to save the configuration. When the configuration parameters are
saved successfully, click Close Expert Mode.
5. Close all browser sessions and clear the browser cache, before testing the
configuration.
6. Launch Approval Portal in SAP NetWeaver Portal.
When invoices are loaded, click the logoff button.
The Redirect URL is called and clears the locks from SAP table /ORS/INV_LOCK
of the specific user. When locks are released, the URL redirects to the SAP
NetWeaver Portal standard logon page.
Troubleshoot- The following steps are applicable if this configuration does not work.
ing steps
1. If the browser tries to login again without a redirect to the SAP NetWeaver
Portal standard log on page, the browser cache is not cleared properly. Restart
the computer where the user is working and try again.
2. When the user logs off from the portal and tries to log on with the same user
and browser session, in some sporadic cases a blank screen is displayed. Log off
and log on again.
3. Repeat the procedure up to Step 3 but enter the following changed parameters:
ume.logoff.redirect.silent = true
ume.logoff.redirect.url = http(s)://<host>:<port>/vimportal/
LogOutServlet?nwpParam=Z
<host> is the SAP NetWeaver Portal instance host where Approval Portal is
running
<port> is the SAP NetWeaver Portal instance port where Approval Portal is
running
Save your settings and restart AS Java as mentioned in the SAP standard
documentation.
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.
You configure the OpenText™ Imaging Web Viewer (Web Viewer) settings of the
Mobile Approval Portal in the Approval Admin page, Mobile Configuration tab.
See “Configuring the Web Viewer integration” on page 214.
Example: http://server.opentext.local:50000/vimportal/mapp.html
The URL is very similar to the Approval Portal login URL. The Mobile Approval
Pages are loaded based on a browser user-agent.
The Mobile Approval Portal inbox is applicable only for approvers. Coding must be
completed. Delegated and Referred invoices are visible in the inbox.
For details on the end user perspective of the Mobile Approval Portal, see Section 10
“Approving invoices using the Mobile Approval Portal” in OpenText Vendor Invoice
Management for SAP Solutions - User Guide for Invoice Solution (VIM-UGD).
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.
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.
Notes
• For further information about Web Viewer, see OpenText Imaging Web Viewer
- Installation and Configuration Guide (CLWEBV-IGD), available on My
Support: http://knowledge.opentext.com/knowledge/cs.dll/Open/19644858
You configure the Web Viewer integration in the Approval Admin page, Mobile
Configuration tab. In particular, you must enter the Web Viewer server Host/IP and
Port of the Web Viewer, and enable the display of invoice images on your mobile
device.
1. Open the Approval Admin page using the following URL: http://
<host>:<port>/vimportal/admin
• WebViewer Host/IP
• TomcatServer Port
If the Web Viewer server is hosted on a NetWeaver 7.3 or 7.4 instance, enter
the NetWeaver port.
Note: This feature is only applicable for the Mobile Approval Portal.
If you configure more fields, you might run into performance issues on mobile
devices.
4. Select the Default Language, your preferred Decimal Notation, and your
preferred Date Format from the drop-down lists.
This part covers administration tasks that must be carried out regularly. These tasks
are not executed on a daily basis by an agent, but must be carried out by a
responsible to keep the business process running.
Program name
/OPT/VIM_REPLACE_LOGSYS (no transaction code)
Selection screen
To replace the logical system, enter the name of the original logical system in the
From field, and enter the target value in the To field. You can perform the
replacement on specific DP documents by using the DP document selection. The test
mode, which is enabled by default, allows to review the potential replacement
results.
• For DP documents, see “Changing the posting date for a bulk of DP invoices”
on page 221.
• For upgrade customers still using the deprecated NPO and PO parking
workflows, follow the guidelines in the VIM 7.5 documentation.
Notes
OpenText recommends that you run the year end procedures for parked invoice
processing in a test environment before attempting them in your production
environment. This will allow you to resolve any issues that arise with Customer
Support so they don’t impact your fiscal year end activities.
Fiscal year end procedures for parked invoice processing should only be run in your
production environment after the last posting period in the previous fiscal year is
closed and when no user is trying to create or process parked invoices in the system.
Important
OpenText recommends doing tests of the report on a test system. OpenText
also recommends running the report when no users work on the system,
because this can cause unexpected values in the posting date field. There are no
locks for any objects implemented.
Settings
Document options – All ranges in this area are standard search criteria for DP
invoices.
2. To execute the bulk change, clear the Test mode check box and click .
A dialog box opens, asking for confirmation. In the dialog box, you still can
cancel the whole processing.
Depending on what is implemented at your site, you need to come up with a set of
scenarios to be tested.
Important
OpenText recommends archiving data of the VIM tables only, when the data is
not required in everyday tasks and it is not relevant from auditing perspective.
Make absolutely sure that you run license reporting before you archive data.
Otherwise, you might lose data that is needed for license reporting. For more
information, see “Using the OpenText License Audit Report” on page 47.
Note: You must first archive all DP invoices from all connected SAP S/4HANA
systems before you run the archiving of the reporting data.
To archive DP invoices:
3. Follow the SAP standard archiving processes for the archive object /OPT/DOC.
Note: Starting with VIM 7.5 SP4, the archiving object /OPT/DOC is
enhanced to delete VIM change documents. This refers to the change
document tables CDHDR and CDPOS, key /OPT/VIM_IDXDAT.
• /OPT/VIM_1HEAD
• /OPT/VIM_1ITEM
• /OPT/VIM_1PROC
• /OPT/VIM_1WI_AGT
• /OPT/VIM_2HEAD
• /OPT/VIM_CWHTAX
• /OPT/VIM_HD_DP
• /OPT/VIM_HD_PO
• /OPT/VIM_MSG_T
• /OPT/VIM_PO_WIH
• /OPT/VIM_PO_WID
• /OPT/VIM_HD_NPO
• /OPT/VIM_NPO_WIH
• /OPT/VIM_NPO_WID
• /OPT/VIM_TITEM
• /OPT/VIM_WHTAX
• /OPT/VIM_1ATM_H
• /OPT/VIM_1BDCLOG
• /OPT/VIM_1LOG
• /OPT/VIM_1OCRLOG
• /OPT/VIM_1PO_DN
• /OPT/VIM_8HEAD
• /OPT/VIM_8LOG
• /OPT/AT_APPR_HIS
• /OPT/AT_LBA_LOG
• /OPT/CT_LG_EXC
• /OPT/CT_LG_HIST
• /OPT/CT_PMC_RG03
• /ORS/STACK_HDR
• /ORS/STACK_BODY
• /ORS/INV_ADD
• /ORS/INV_DATA
• /ORS/APPR_LOG
• /ORS/PS_ITEM
• /PTGWFI/M_PRKMTR
• /PTGWFI/F_PIRMTR
• /PTGWFI/F_BIRMTR
• /PTGWFI/F_BIRMWI
• /PTGWFI/F_DELINV
• /PTGWFI/F_LIXMWI
• /PTGWFI/F_LIXMTR
Note: You must first archive all DP invoices using the archive object /OPT/DOC
from all connected SAP S/4HANA systems before you run the archiving of the
reporting data.
3. Follow the SAP standard archiving processes for the archive object /OPT/REP.
The data from the following tables is archived:
• /OPT/VT_ATM_SRC
• /OPT/VT_DOC_HEAD
• /OPT/VT_KPI_SRC
• /OPT/VT_KPI_SRCE
• /OPT/VT_WORKITEM
• /OPT/VT_WI_AGENT
• /OPT/VT_WI_AGNT
• /OPT/VT_WI_ACTN
• /OPT/VT_WI_STEPS
• /OPT/VT_DOC_H
• /OPT/VT_WI
• /OPT/VT_WI_ACTV
• /OPT/VT_WORK
Test mode
In test mode, the clean up program provides a list of DP documents that were
selected based on the selection criteria.
Execution mode
In actual execution mode, the DP documents are selected and cleaned as well.
There are two categories of tables: customizing tables and transaction tables:
Customizing table
For all tables categorized as customizing table, all entries matching the selection
criteria are deleted from the database table.
Transaction table
For all tables categorized as transaction table, the entries matching the selection
criteria are modified. The list of fields for that specific table is checked and these
fields are cleaned. No entries are deleted from transaction tables.
By default all item data is deleted for a specific DP document if it meets the selection
criteria. The following item data tables are cleaned for the DP documents that meet
the selection criteria:
• /OPT/VIM_1ACCT
• /OPT/VIM_1BLOCKS
• /OPT/VIM_CWHTAX
• /OPT/VIM_WHTAX
• /ORS/PS_ITEM
• /OPT/VIM_1ITEM
• /OPT/VIM_1PO_DN
The program provides built-in checks to ensure that only VIM specific data is
modified or deleted. The program also provides a specific authorization check. The
authorization object is J_6NIM_CA6.
To delete both data at the same time, select both check boxes.
5. To delete the transaction data for documents that are open, select the Delete
VIM Data for Open Docs check box.
For open documents, all active workflows are killed.
After running the program in execution mode, the status is updated to 92 - cleaned
upon vendor block.
Expected output for all customizing tables that are maintained in /OPT/CLNP_
TABLST
All relevant entries based on the selection criteria are deleted.
For the following tables (item specific data), all entries relevant to the DOCID and
LIFNR fields are deleted:
• /OPT/VIM_1ACCT
• /OPT/VIM_1BLOCKS
• /OPT/VIM_CWHTAX
• /OPT/VIM_WHTAX
• /ORS/PS_ITEM
• /OPT/VIM_1ITEM
• /OPT/VIM_1PO_DN
For ILM configuration and more details, see Section 40.4 “Configuring ILM objects
for VIM archiving objects” in OpenText Vendor Invoice Management for SAP Solutions -
Configuration Guide for Invoice Solution (VIM-CGD) and Section 2 “General Data
Protection Regulation (GDPR)” in OpenText Vendor Invoice Management for SAP
Solutions - Scenario Guide for Invoice Solution (VIM-CCS).
The ILM action Data destruction is also enabled. You can use it with data
archiving reports for /OPT/DOC and /OPT/REP.
When you implement the SAP note 2787893, the new node for destroying
attachments appears in the customizing.
You can customize the entry /OPT/V1001 for ILM object /OPT/DOC.
This report cleans up the data from table /OPT/DT_BR_WAIT for the selection criteria.
The DP documents that have workflow completed or cancelled or with status
obsolete are considered. You can run these reports once in a while to clean up the
data.
Run the report in test mode with the Test Run check box selected. Clear the check
box to run the report in actual mode.
For the selection criteria, the report will consider the DP documents with main
workflow task status completed or cancelled and also obsolete documents.
Run the report in test mode with the Test Run check box selected. Clear the check
box to run the report in actual mode.
Data from the following tables is deleted when the program is run:
• /otx/pf02_t_plex
• /otx/pf02_t_imgd
• /otx/pf02_t_imgf
Data from the following tables is deleted when the program is run:
• /opt/et_arb_reg
• /opt/et_arb_trg
• /opt/vim_ccpark
• /opt/vim_ccparkn
This part covers administration tasks for troubleshooting and monitoring. VIM
provides some helpful tools to monitor and administer VIM workflows. This part
also describes how to handle frequent abnormal functioning of workflows due to
missing or erroneous configuration in the role resolution or due to an invoice lock
happening during the approval process.
Tip: The standard Refer to... dialog might allow invoice processors to
modify the agent list. This depends on the process option override settings.
Similarly, Invoice Approval has options that can allow to override the next
approver automatically. You must verify the use of these override options
and switch them off if they are unwanted.
COA maintenance authorization checks
The COA maintenance transactions for Invoice Approval allow you to restrict
the data that is displayed and maintained by checking authorization for
company code and user groups (from SAP user master records). In addition,
using the authorization checks by company code allows to maintain COA in
parallel, as long as different maintaining users are responsible for different
company codes. For more information, see Section 6.2.2 “COA maintenance” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide for
Invoice Solution (VIM-CGD).
Note: Running actions in other users’ view may require you to have
additional SAP authorizations. In particular, this refers to the authorization
for the SWIA transaction and potentially for other workflow administration
functions. These checks are imposed by SAP if you are managing work
items of other users.
Note: For lists and descriptions of authorization objects that are available for
specific VIM components, see the subsections of Section 6.2 “Available
authorization checks” in OpenText Vendor Invoice Management for SAP Solutions
- Configuration Guide for Invoice Solution (VIM-CGD).
WS00275269
Document process workflow (from receiving the scanned invoice info until the
invoice is parked or posted or the document is marked as obsolete or duplicate)
WS00275260
Parked PO invoice workflow (from the time a PO invoice is parked until the
invoice is posted or deleted)
WS00275254
Non PO parked invoice workflow (from the time a Non PO invoice is parked
until the invoice is posted or deleted)
WS00275252
Web approval of parked invoice workflow (from the time an invoice is sent for
web approval action until approval is completed or invoice is fully rejected)
WS00275264
Blocked PO invoice workflow (from the time a PO invoice is blocked for
payment until it is released or cancelled)
WS00275266
Blocked PO invoice header level action workflow (from the time that a blocked
invoice is authorized for header level action until the action is completed or AP
sends back)
1. To access the Selection Report for Work Items, run the SWI1 transaction.
Type
F (for Workflow, also subworkflow)
Task
Click the multiple selection button to enter all workflows:
• WS00275269
• WS00275260
• WS00275254
• WS00275252
• WS00275264
• WS00275266
Date created
Enter date range.
Time created
Enter time range.
Tip: You can save the selection criteria as a variant. From the menu, click
Goto > Variants > Save as variant.
STARTED
Workflow is in progress.
COMPLETED
Workflow is completed.
CANCELLED
Workflow has been cancelled.
The Work item text column indicates the type of block (1 = price block, 2 =
quantity block), the type of parked invoice workflow and other workflow item
text.
In the Workflow log screen, click the button in the application tool bar to
display a list with technical details.
The St (Status) column indicates the status of each individual step of the
workflow:
Completed
Error
Click the icon next to a workflow step to display the agents who own this
work item (or possible or excluded agents).
In the Workflow Log (View with technical details), click the highlighted Error
field to display the error messages generated by the system.
If the error message shows the indicator Error or exception resolving role
<...>, role maintenance is required through the role maintenance transaction.
1. To access the Selection Report for Work Items, run the SWI1 transaction.
Type
F (for Workflow, also subworkflow)
Status
ERROR
Task
Click the multiple selection button to enter all workflows:
• WS00275269
• WS00275260
• WS00275254
• WS00275252
• WS00275264
• WS00275266
Date created
Enter date range.
Time created
Enter time range.
Tip: You can save the selection criteria as a variant. From the menu, click
Goto > Variants > Save as variant.
In the Workflow log screen, click the button in the application tool bar to
display a list with technical details.
5. In the Workflow Log (View with technical details), click the highlighted Error
field to display the error messages generated by the system.
6. In the Workflow Log (View with technical details), click the icon next to the
error indicator to view the workflow container.
The element ACTOR or Next Role indicates which role is causing the error. In
the example above, the error role is INFO_PROVIDER.
1. To access the Workflow Restart After Error screen, run the SWPR transaction.
Task ID
Click the multiple selection button ( ) to enter all workflows:
• WS00275269
• WS00275260
• WS00275254
• WS00275252
• WS00275264
• WS00275266
Tip: You can save the selection criteria as a variant. From the menu, click
Goto > Variants > Save as variant.
4. Select the workflow you want to restart and click the Restart workflow button.
If the workflow is restarted successfully, the entry in the Status column changes
from ERROR to STARTED.
2. In the Invoice Lock Clean up program screen, enter the following information:
Invoice Type
Invoice Key
Enter the invoice key which is composed as follows:
Test Only
Select this check box and click to display invoices that are currently
locked.
Tip: If you leave the Invoice Type and Invoice Key fields empty, all
currently locked invoices are displayed.
VIM uses the change document object /OPT/VIM_IDXDAT to track the changes. There
are several standard SAP reports that you can use to view the existing change
documents, for example RSSCD100.
Notes
• When you archive and delete VIM data, as described in “Archiving VIM
information” on page 223, the change documents are also archived and
deleted along with the respective DP documents.
• The Chart of Authority (COA) also supports change documents. For more
information, see Section 4.1.4.6 “Logging with change documents” in
OpenText Vendor Invoice Management for SAP Solutions - Configuration Guide
for Invoice Solution (VIM-CGD).
If configured properly, the PDF history log file can be created automatically at the
end of the VIM process, this means at the end of the DP document workflow.
However, in the following cases, it may be required to create the PDF history log file
manually:
• in case of an error
• in case of old scenarios (direct posting or direct parking)
• for testing purposes
Selection Fields
Use these fields to select the DP documents for which a PDF history log
shall be created.
Processing Options
This section comprises the following fields:
Language Key
Select a language key to specify in which language the PDF history log
shall be created.
Test mode
Select this check box if you want to test the PDF history log in display
mode only. It is neither archived nor linked to the DP document.
Report output
Test mode
When running the report in test mode, you get a dialog box to enter printer
parameters.
Enter the OutputDevice. You can use printer LP01 for test purposes. To view the
PDF history log, use the Print preview button.
In the print preview, you can enter the function code PDF! to create a PDF
document of the PDF history log.
Real mode
When running the report with the Test mode check box cleared, a PDF history
log file is created, archived, and linked to the DP document and its SAP invoice.
Note: Some of the functions described here are standard SAP functions; see
SAP Help for more details.
The application log is also used to store any issues during the creation of the PDF
history log. For more information about the PDF history log, see Section 33.3 “PDF
history log” in OpenText Vendor Invoice Management for SAP Solutions - Configuration
Guide for Invoice Solution (VIM-CGD).
Input parameters
OBJECTID
The Object ID is the currently processing document number, for example the DP
Document number, IDOC number, Work Item, or Financial Document number.
LOG_POINT
The log point is a unique identifier of the calling application or application area.
Using this value, you can identify the area that is generating the message.
MESSAGE
Actual system message that will be used to store.
Select the Object Vendor Invoice Management and double-click Sub-objects in the
navigation panel.
• Object
• Sub-object
• External ID: Enter the DP document number or the IDoc number.
3. Time restriction – Specify a date and time range to display the messages
generated in a particular period.
4. Log class – Specify the log class of the messages you want to display.
• OBJECT
• SUBOBJECT
• EXTERNAL_NUMBER
• DATE_FROM
• SUPPRESS_SELECTION_DIALOG: enter X.
Select the Object /OPT/VIM and double-click Sub-objects in the navigation panel.
Note: In the CRM system, custom configuration for application logging is not
available as it is in the ERP system.
During simulation, the icon can be displayed, meaning: “Business rule run was
not logged.” The following list shows possible reasons for this behavior.
• VIM administration team changed the business rule (in the document type
configuration) or the business rule framework configuration.
• VIM has been recently upgraded to a new version and the document existed
before.
• Business rule framework contains check types random, conditional, counter
based, rule inactive, periodic, or once.
• User changed the document type of the document.
• VIM logging table is empty because the VIM administration team did not
activate BC set /OTEXVIM/VIM60_SP3_KPI during upgrade from a previous
version to VIM 7.0. You can check that by looking into table /OPT/CT_LG_REG:
Make sure that most of the log events are active. Events not set active are parking
and posting events from outside VIM.
Note: The icon can disappear if the user performs an activity that triggers
the rules for another run.
Amount class 2 stands for invoices with medium amounts. The range for
amount class 2 is changed from 1,000 to 10,000 Euro to 10,000 to 100,000 Euro.
The VIM invoice 4711 has a gross amount of 5,000 Euro. Before the
customizing change, the VIM invoice was treated as a medium amount invoice
(amount class 2).
After the customizing change, the VIM invoice is treated as a small amount
invoice (amount class 3). The VIM invoice is already loaded to an InfoCube
with amount class 2 (medium amount). This may be what is wanted because
this VIM invoice was a medium amount invoice at the point of time when it
was loaded into the BW system. But it could also be confusing as amount class
2 (medium amounts) now stands for invoices from 10,000 to 100,000 Euro
whereas the invoice has a gross amount of 5,000 Euro.
Solution If you want to reclassify old invoices according to the most current KPI customizing
settings, you must recalculate the characteristics of these invoices.
One way to reclassify old invoices is to reload the affected invoices. In this case, start
the KPI collection report with an appropriate range for the process start date without
the Delta mode processing option. Then start reloading the VIM invoices into the
BW.
Symptom: Approval workflow does not start (for DP and parked invoices)
Reason
The most common reason is missing or wrong configuration of the COA. When
starting the approvals, VIM must be able to find the first approver (coder or
requester). If this is not possible, the workflow does not start.
Solution
Check if the coder determination is set to another value than Use requester. In
this case, verify in the COA maintenance whether the coder list is maintained
accordingly, for example, if coders are provided for the company code used in
the invoice. If necessary, configure the COA.
In case of DP documents, the DP workflow creates a dialog work item. Using the
process option Start approval workflow, start the approval process with this
work item. The /ORS/000007_SUBMIT_INV program can help if there is no
dialog DP work item but the DP workflow is waiting for the approval workflow
to finish.
Reason
The COA is not properly maintained. Under certain circumstances, the COA
structure becomes very complicated. This can happen if you use many records
per level, depending on different cost elements. You can use multiple cost
elements per COA line, which can be switched on in configuration. You can also
use asterisks in place of cost element values. In these cases, you might miss some
combinations of cost elements.
Solution
Verify the COA data, paying attention to the use of asterisks and different flags
set for the AFS ID that corresponds to the invoice data.
Symptom: Approval workflow does not start for posted SAP documents
Solution
Configure the event linkage /ORS/INVAP POSTED to be active and the processing
set to Event queue.
In addition, verify the general posted approval settings in VIM customizing, and
whether the posted SAP document is actually blocked for payment.
Solution
Verify that the referral task is set to general in the PFTC transaction. If you have
upgraded from a very old VIM version, the task may be not set to general.
Symptom: When referring an invoice with the Wait for feedback check box set,
the invoice is not moved into the resubmission folder
Reason
This can happen if authorizations are missing.
Solution
Verify that all approvers working in SAP GUI are given the authorization S_WF_
WI, activity 12 (resubmit). For Approval Portal and Mobile Approval Portal, the
CPIC user must have this authorization.
Solution
Check if a special handling instruction (entered by a coder) exists for the invoice.
Invoices with special handling are excluded from automatic posting by VIM
design.
Symptom: You open an invoice from SAP inbox and get a message: “You are
not setup to approve this invoice. Do you want to send it back to the following
original approver?”
Reason
This may happen if the invoice is assigned to another approver, and you are not
that approver’s substitute. However, the invoice is forwarded into your inbox,
for example, using the SWIA transaction.
Solution
Confirm the message to send the invoice to the actual approver because you are
not authorized for that invoice.
Note: If sending back does not work, you can use the Replace or Forward
functions of the SAP inbox.
You can change the size and number of the Approval Portal log files. See “To change
the size and number of log files:“ on page 259.
5. Select the Severity level you need, click Save and select one of the following
options, according to your needs:
For more details, also consult the SAP NetWeaver Application Server Java
Administration Guide.
Log level Info is used to log the initial Servlet loading information and when an
RFC is called.
The name of the log will be VimlapLog<Logindex>.log. These logs will contain all
application's Info log level. Up to 10 files will be created and will be reused.
Limit
for log file size
Count
for number of log files
These trace files include the import, export parameters of functions, and the RFC the
application is calling. These trace files are useful to troubleshoot any error when
connecting and retrieving data from SAP S/4HANA. Make sure that you turn the
level back to Info or Error in the production environment.
To determine that NWAS writes the trace files to the location specified above instead
of defaultTrace.trc, you must perform the following setting.
For NetWeaver 7.3 and 7.4, this is configured in the J2EE Config Tool. For details
about the J2EE Config Tool, see Section 16.3.2 “Preparing the installation” in
OpenText Vendor Invoice Management for SAP Solutions - Installation Guide (VIM-IGD).
Change this setting to NO. Then NWAS will produce multiple trc files.
8. Select the required severity level from the Severity drop-down list.
Logging (Categories)
Categories contain log information for the system administrator. You can use
them to check the system status.
Tracing (Locations)
Locations contain trace information that is intended for the developer. You can
use them to check the program flow and to detect program errors.
If you want the application to write different Logging and Tracing, you first must
disable ForceSingleTraceFile in the Log Manager. So, the application can
implement its own logic.
To disable ForceSingleTraceFile:
2. Navigate to cluster > data > instance > managers > LogManager.
3. Click ForceSingleTraceFile.
3. Click New. In the New Log Controller dialog box, enter /Appliccations/
VIMIAP and click OK.
A new application entry VIMIAP is created.
2. Navigate to cluster > data > instance > log configuration > categories > Root
Category > Applications > VIMIAP.
Destination If you do not want the application to write to the default application.log file, you
have to manually create the destination.
To create destinations:
Example: D:\usr\sap\W73\J00\j2ee\cluster\server0\log
Note: All generated Log and Trace files will be generated in this folder.
3. Navigate to cluster > data > instance > log configuration > destinations.
5. Click New.
8. Click the created destination and change the Pattern value to the following: ./
log/VIMIAP/VIMIAP_${NODE_INDEX}.log
The following step is optional. If you want to change the default severity level,
you must perform this step; otherwise, you can skip it.
9. Navigate to cluster > data > instance > log configuration > categories > Root
Category > Applications > VIMIAP.
10. Click Add and select the destination you just created.
2. Navigate to cluster > data > instance > log configuration > destinations
4. Click New.
6. Click the created destination and change the Pattern value to the following: ./
log/VIMIAP/VIMIAPTrace_${NODE_INDEX}.trc
The following procedure is optional. If you want to change the default severity level,
you must perform this step; otherwise, you can skip it.
2. Navigate to cluster > data > instance > log configuration > locations > Root
Location > com > opentext > vim > portal > util > LogUtil.
Destination If you do not want the application to write to the default application.log file, you
have to manually create the destination.
To change destinations:
2. Navigate to cluster > data > instance > log configuration > destinations.
4. Click New.
3. Configure HTTP:
Property name
url
Property value
http://<NWAS>:<NWASHOST>/vimportal<Support Package>/
GRMGServlet
For example: http://opwast38:50100/vimportalSP3/GRMGServlet
4. Configure the Java Connector (JCo). You also must monitor the JCo connection
from Approval Portal to SAP S/4HANA.
While configuring a single JCo component, give the name as JCo1. If you need
to configure multiple SAP S/4HANA backend systems, increment the index
suffix to JCo, like JCo2, JCo3.
In the application, the list of components is read with the component name from
scenario. As the JCo component can be repeated multiple times, add an index
number to identify the specific component.
Note: It is not necessary to enter a value for the Component type field.
propname: client
propvalue: the SAP S/4HANA Client
propname: username
propvalue: the CPIC user ID
propname: password
propvalue: the CPIC user password
propname: language
propvalue: the language
propname: apphost
propvalue: the application host
propname: sysnumber
propvalue: the system number
propname: client
propvalue: 800
propname: username
propvalue: otapportal
propname: password
propvalue: xxxxxx
propname: language
propvalue: EN
propname: apphost
propvalue: 10.2.192.49
propname: sysnumber
propvalue: 00
propname: client
propvalue: the SAP S/4HANA Client
propname: username
propvalue: the CPIC user ID
propname: password
propvalue: the CPIC user password
propname: language
propvalue: the language
propname: mhost
propvalue: the message host
propname: r3name
propvalue: the R/3 name
propname: group
propvalue: the group
propname: client
propvalue: 800
propname: username
propvalue: otapportal
propname: password
propvalue: xxxxxx
propname: language
propvalue: EN
propname: mhost
propvalue: 10.2.192.49
propname: r3name
propvalue: T38
propname: group
propvalue: 00
For NetWeaver 7.3 and 7.4, follow the steps in the SAP NetWeaver Administration
Guide, section “Monitoring Portal Availability”. If you need more assistance, contact
OpenText Customer Support.
Also backup a copy of the .sca or .sda file. If restoring is needed, do the following:
To perform a restore:
2. Redeploy the backup or the original delivery of the .sca or the .sda file. See
OpenText Vendor Invoice Management for SAP Solutions - Installation Guide (VIM-
IGD).
• Check in the Visual Admin if the application has been restarted and is running.
• Login to the Administration page of the Approval Portal to see if all the
configurations are still correct.
• Ask the end user to try to access the application to see if everything is working.
If a restore is needed, see “Managing backup and restore” on page 278 for
information how to restore.
• With VIM 7.5 SP4 and later, the initial load time of the Approval Portal is
improved by reducing the Read Preference RFC calls.
• JS Minified version is available from the VIM 7.5 SP3 JCo3 version for good
performance.
9.11.12 Troubleshooting
The following issues can occur on the Approval Portal. See symptoms and solutions.
Symptom
The end user receives a message: “Exception: Please consult with your
administrator”
Solution
Review the logs and check for relevant information. Send the NWAS server
trace and the VIM trace to OpenText.
Symptom
You are not able to save the Configuration information to the configuration.
xml file
Solution
Make sure the <Approval_Portal_installdir>/invoiceCfg folder has write
permission.
Symptom
The user is not able to view the image and the SAP S/4HANA side is configured
correctly.
Solution
Make sure the Image Display Type in the Configuration section of the
Administration page is configured correctly.
Issue #4: Some of the texts in other languages display in English only
Symptom
Some of the texts in other languages display in English only when user selects
other languages.
Solution
The language properties file for that language might not have the translation;
this might be due to the release date of the build. Change accordingly or contact
OpenText Customer Support to obtain the latest language properties files.
Approval Portal logs the information about Protocols, Security and other actions
performed on the application that are described in the following.
Security logs
Security related log information is available in the following path. Pick the latest
files.
<drive>:\usr\sap\<SAP instance>\JC00\j2ee\cluster\server0\log\
system
where <drive> is the SAP NetWeaver Portal instance having Approval Portal.
Application logs
Application log information is available in the following path. Pick the latest
files.
<drive>:\usr\sap\<SAP instance>\J00\j2ee\cluster\server0\log
where <drive> is the SAP NetWeaver Portal instance having Approval Portal.
Capture the following files: In NetWeaver 7.0, capture applications.XX.log
and defaultTrace.XX.trc files. In NetWeaver 7.3, capture applications_XX.
X and defaultTrace_XX.X.
Note: This is the default log location for both standalone WAS and
NetWeaver landscapes.
See “Working with log and trace files” on page 258 for NetWeaver 7.0 and “Working
with logging and tracing (NetWeaver 7.3 and 7.4)” on page 264 about the
customization of logs. Here, the log location will be defined at the time of
configuration.
For information about SAP ABAP logs, see “Using logs and traces” on page 102.
The following screenshot helps in identifying the deployed Approval Portal version
and build information.
In the COA table, if OPTURA is configured as the Windows domain, make sure
the OPTURA domain is also configured in the Configuration tab of the Admin
console. See the following screenshots of the COA table and the Admin
console.
Note: Do not forget to delete the breakpoint(s) that you have set for
debugging.
• You can turn on the status bar through the menu: press ALT on the keyboard to
show the menu bar and then navigate to View > Toolbars > Status bar.
• Another approach to show the status bar is to right-click the title/tab area and
select Status bar from the context menu.
In your Advanced settings, you might have cleared the Display a notification about
every script error option. In this case, even if you have the status bar visible, you
will not know there was an error. The only hint of a JavaScript error would be if the
page did not respond properly (something did not load for example).
If you double-click anywhere on the status bar, if there was a JavaScript error on the
page, the error log will open.
The status bar is no longer reliable for viewing if there was a JavaScript error on the
page. However, there is another approach available for viewing JavaScript errors.
In the developer tools (press F12 as shortcut key), the Console tab shows all
JavaScript errors on the page since the Developer Tools window has been opened.
The trick with the Console tab of the developer tools is that the error log only starts
logging errors after the developer tools window is opened.
To see the error in the Console tab, you must repeat the action that triggered the
error in the first place.
The following is a screenshot of the Console tab with a JavaScript error logged.
The Console tab of the developer tools (F12) will also give you a list of all JavaScript
errors that happened on the page.
1. Before accessing the Approval Portal in the browser, click F12 developer tools
on the Tools menu.
3. Save the Network traffic in XML and send it to OpenText Customer Support for
further investigation.
When SAP GUI perfectly displays the invoice image and when only Approval Portal
shows the error message when viewing the image, cross-check that the necessary
authorizations are granted for the logged-in user in viewing the images.
Check the SU53 transaction for the CPIC user ID when this error is shown.
If you are using Web Viewer to access the invoice image, cross-check the settings
that are configured in the Mobile Configuration tab of the Admin console of
Approval Portal.
It is important to check if Web Viewer is up and running where the Web Viewer is
installed.
To ensure that Web Viewer is up and running, invoke the following URL. It should
display the Web Viewer is up home page: http://<Configured ip:port>/
WebViewer/.
For more information, see “Configuring the Web Viewer integration” on page 214.
The configurations above might be in place and you still encounter issues in viewing
the images. In this case, check if the invoice image file type is supported by the
respective browser.
Google Chrome
To manually allow pop-ups from a site:
1. At the end of the address bar, click the pop-up blocker icon .
2. Click the link for the pop-up window that you want to see.
3. To always see pop-ups for the site, select Always show pop-ups from [site].
The site will be added to the exceptions list, which you can manage in the
Content Settings dialog.
Internet Explorer
To manually allow pop-ups from a site:
Mozilla Firefox
To manually allow pop-ups from a site:
Mac OS Safari
To manually allow pop-ups from a site:
1. Select the settings gear, then click Preferences. Mac users click Safari >
Preferences.
5. Select the Approval Portal application instance and click the Edit button.
6. On the Authentication Stack tab, change the Used Template value to ticket.
Then, click the Save button.
To avoid errors when using the Mobile Approval Portal, perform the following
configurations.
JavaScript In the browser settings of the mobile device, enable JavaScript before launching the
Mobile Approval Portal.
If JavaScript is not enabled, AJAX calls to the server are interrupted and there is no
response on the Mobile Inbox.
Login user To change the Login user, clear Browser cache, cookies and form data.
change
Logging You cannot view or extract logging information on mobile devices themselves.
information Instead, you must open the Mobile Approval Portal URL on the Chrome desktop
browser. Developer Tools are part of Chrome. They offer various information and
useful features. To open the Developer Tools, click Wrench Menu > Tools >
Developer Tools.
Inside the Developer Tools, you can view detailed logging information on the
Console tab. You can view network traffic on the Network tab. To extract
information, copy specific text parts out of the Console tab.
For more information, see the Google Developer Tools documentation: https://
developers.google.com/web/tools/chrome-devtools/
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 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.
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
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.