Professional Documents
Culture Documents
Configuration Guide
VIM060000-CGD-EN-4
OpenText Vendor Invoice Management
Configuration Guide
VIM060000-CGD-EN-4
Rev.: 07. Feb. 2012
This documentation has been created for software version 6.0.
It is also valid for subsequent software versions as long as no new document version is shipped with the product or is
published at https://knowledge.opentext.com.
Open Text Corporation
275 Frank Tompa Drive, Waterloo, Ontario, Canada, N2L 0A1
Tel: +1-519-888-7111
Toll Free Canada/USA: 1-800-499-6544 International: +800-4996-5440
Fax: +1-519-888-0677
Email: support@opentext.com
FTP: ftp://ftp.opentext.com
For more information, visit http://www.opentext.com
PRE Introduction 7
i About Vendor Invoice Management......................................................... 7
ii About This Document............................................................................... 9
iii Contact Information................................................................................ 11
Part 1 Configuration 19
4 Roles ........................................................................................ 29
4.1 Defining Roles........................................................................................ 29
4.2 Defining Role Templates........................................................................ 31
4.3 Assigning Templates to Roles ............................................................... 35
4.4 Maintaining Role Determination Settings............................................... 37
20 E-Invoicing Support...............................................................499
20.1 Interface Remote Functions................................................................. 500
ii.ii Conventions
In general, this documentation uses the following typographical conventions:
User interface
This format is used for elements in the graphical user interface (GUI), such as
buttons, names of icons, menu items, and fields.
Filenames, commands, and sample data
This format is used for file names, paths, URLs, and commands at the command
prompt. It is also used for example data, text to be entered in text boxes, and
other literals.
Note: If you copy command line examples from a PDF, be aware that PDFs
can contain hidden characters. OpenText recommends copying from the
HTML version of the document, if it is available.
KEY NAMES
Key names appear in ALL CAPS, for example:
Press CTRL+V.
<Variable name>
Angled brackets < > are used to denote a variable or placeholder. The user
replaces the brackets and the descriptive content with the appropriate value. For
example, <server_name> becomes serv01.
Internal cross-references
Click the cross-reference to go directly to the reference target in the current
document.
External cross-references
External cross-references are usually text references to other documents.
However, if a document is available in HTML format, for example, in the
Knowledge Center, external references may be active links to a specific section in
the referenced document.
Warnings, notes, and tips
Caution
Cautions help you avoid irreversible problems. Read this information
carefully and follow all instructions.
Important
Important notes help you avoid major problems.
Swimlanes
Business blue print sessions result in a set of finalized swimlane diagrams
representing the to-be process. Figure 1-1 on page 15 is an example of such a process
swimlane that is delivered with the VIM Baseline Configuration. A swimlane
diagram comprises the following main items:
Process Description
The description in the headline represents the process scenario.
Roles
Each lane represents a business role, a unique grouping of people required to
collaborate to complete the process.
Dashboard
The dashboard is the user interface for the actors in the process. The dashboard
type identifies the VIM component that is used to realize a specific functionality.
The following dashboard types are available:
DP dashboard
The DP dashboard represents a process as implemented in the Document
Processing component of VIM.
This part describes the particular configuration steps for Vendor Invoice
Management (VIM). It covers the following chapters:
• “ArchiveLink Document Type Configuration” on page 21
• “Roles” on page 29
• “Document Processing Process Configuration” on page 41
• “PO Parking Process Configuration” on page 121
• “PO Blocking Process Configuration” on page 149
• “Non PO Parking Process Configuration” on page 171
• “Invoice Approval” on page 195
• “Approval on a Mobile Device” on page 275
• “OpenText Approval Portal” on page 287
• “KPI Dashboard” on page 289
• “VIM Reporting Module” on page 333
• “Tools” on page 343
• “Country Specific Configuration” on page 353
• “ICC Integration” on page 385
• “Multiple Backend System” on page 421
• “SSF Integration” on page 437
• “EDI Configuration” on page 487
• “E-Invoicing Support” on page 499
• “Central Reporting Infrastructure” on page 507
• “Individual Report Configuration” on page 511
• “System Log” on page 525
• “Archiving Configuration” on page 527
• “Supplier Relationship Management (SRM) Integration” on page 535
Task
WS00275271
Method
PREPROCESS_NON_OCR
Task
WS00275270
Method
PREPROCESS_OCR
3. Enter the name of the new document type in the Doc.type field and PO Invoice
- Indexing 5i - OCR in the Name field. Click the Continue button.
4. Select the Workflow document type check box. Click the Continue button.
5. Enter the value FAX in the Doc. class field. Click the Continue button.
6. Enter the value /OPT/V1001 in the Obj. type field. See “Assignment to
workflow tasks” on page 21 for Task and Method to enter for the different
scenarios.
7. Click the Continue button.
12. Enter the relevant information and click the Continue button.
13. Click the Complete button to finish the wizard.
PIR
Product codes for Non-PO parking workflows
Every assignment bases on the product code/role combination. For example, to
create a role called BUYER in a PO parking process, create a role BUYER with product
code LIX.
OpenText delivers standard roles used in most process scenarios. You can define
your own roles if needed.
To maintain roles:
1. Execute the /OPT/CP_9CX5 transaction.
Alternatively, follow OpenText LiveLink VIM Menu > SAP menu> Roles >
Role Maintenance.
Description
Enter the description of the role.
Role Function Module
Enter function module for the role. Refer to enhancements in roles for
interface structure and details.
Key Determination
Select the check box, if the role is defined by object information – the context
in which the role is used.
Deactivate the check box, if the role is fixed and defined by organization
data, for example: if you want to determine the role by company code, scan
location, or plant.
Object Type
Maintain the object type, based on the workflow.
Alternatively, follow OpenText LiveLink VIM Menu > SAP menu > Roles >
Template Maintenance.
2. In the Product Role Templates Configuration Overview screen, double-click
Template Definition in the navigation pane.
Allow Org
For Key Determination Based templates, only: If the Allow Org flag is set,
you can set an Org Unit instead of a fixed SAP User ID while maintaining
agents for role template in the role determination transaction.
Object Type
For Org Unit based templates only: Select the default value for Agent Type
(User, Position, and Work Center etc.).
Agent Id
For Org Unit based templates only: Select the agent ID.
Function Module
For Function Module Based based templates only: Select the function
module that is used to determine agents for this template. The interface
value for the function module can be found in the OpenText delivered
function /OPT/BL_ROLE_SELF_DIRECTED.
Search Help
Select the search help. When maintaining values for the field in the role
determination transaction, the system uses this value to provide F4 help for
the field.
Allow Range
Select this check box to allow ranges. The values can have a range from
“Low Value” to “High Value”. The system checks the runtime data for the
product code in which the template is used to validate if it can resolve the
field.
Wild Card
Select this check box to allow the wild card character *. Users can define a
wild card for values in the role determination transaction for the product
code in which the template is used.
Example: If all company codes starting with 10 should be considered to
resolve a role, 10* can be maintained if wild card is selected. If the check box
is not set, the system checks to match the entry as is.
2. In the Template Fields Details Overview screen, maintain the Template Field
Details, using the following parameters:
Product Code
Select the OpenText product code in which the template is used.
Object Type
Select the object type. Object types are defined for each OpenText product
code. You can however create a subtype for the OpenText Object Type to
define your own attributes. At runtime, the system instantiates the object
with the object key. The type should be compatible to the OpenText object
type for the given product code.
Attribute
Select the attribute the system uses for the given OpenText product code for
getting the runtime value for the given field Id.
• Determine the initial actor and various collaboration options available to the
various actors during the process flow.
Business rules
• Represent a rudimentary engine for determining
• process type
• document type (in case of OCR or external data input)
• Use configuration to apply logical conditions.
• Allow defining of multiple criteria.
• Can be specified regarding order and exclusivity.
• Can be used for validating data from external systems (OCR).
• Can be automatically applied to the metadata to effect the process flow.
• Can be configured to be called at multiple stages in the process flow.
Roles
• Use the standard OpenText role/actor infrastructure.
• Can use the standard key determination infrastructure to configure complex
actor determination logic without programming.
Options and option types
• Comprise the following main types of options:
• Actions
Actions can be based on transactions or class method or workflow tasks.
• Referrals (for collaboration)
• Can effect the processing logic.
• Can effect the user experience.
• Can trigger the workflow engine to re-run the rules on the most current
metadata to effect the process flow.
• Can be configured to change the document status.
BDC IDs
• Build a powerful infrastructure for pre-populating data into SAP transactions
without programming.
• Are optimized for both dialog processing and background processing.
• Allow to set dynamic parameter IDs.
• Can be used to configure new user collaboration actions.
The starting point for any configuration is a set of process flow swimlanes.
Figure 5-1 shows an example for a process swimlane as implemented by the DP
workflow:
2. Create new SAP ArchiveLink document types, using the following parameters:
Document type
Enter the SAP ArchiveLink document type.
Description
Enter the description of the SAP ArchiveLink document type.
Document Class
Enter document class. The technical document class identifies the archive
format for documents in the content server.
Note: OpenText recommends that you maintain one SAP ArchiveLink
document type for each DP document type even if you think the process is
the same. This proceeding allows the separation of database and most of
the custom functions.
Online Indexing
Use this option if archiving a document using the SAP ArchiveLink Early
Archiving process. Indexing is manual and the person responsible
maintains the data and submits for further processing.
No Indexing
Use this option if there is no indexing required and the document is
directly processed. Use this option if there is no scanned image and the
process is triggered using an API provided by OpenText.
Indexing using Idoc
This is not supported at the moment.
Invoice Type
Decide whether the document generates a Non PO Invoice or a PO Invoice.
Number Range
Enter the number range for the number range object. If a custom number
range object is not defined in global configuration, you can maintain the
number range for object /OPT/DOCID in the Maintain Number Ranges step,
see “Configuring Global Parameters” on page 115.
SAP FI DocType
To determine the SAP document type in the background, enter a fixed
document type or a custom function module.
If you use a function module, enter FM:<Function Module Name>. As the
interface for the function module, use the template
/OPT/BL_IF_DETERMINE_SAP_DTYPE.
From VIM 5.2 SP4 onwards, you can configure separate FI document types
for invoices and credit memos at the DP document type level. Fill the SAP FI
DocType field with two separate FI document types, separated by comma.
Example: If the value in the field is AA,BB, the system will set the FI
document type AA for invoice and BB for credit memos.
You can still configure a custom function module to determine the FI
document type.
Archive Doc. Type
Select the archive doc type defined in the SAP ArchiveLink process, see
“Creating SAP ArchiveLink Document Types” on page 45. We strongly
recommend that each OpenText document type has a unique archive doc
type.
Lines item data
Select the check box if line item data is used that needs to be managed for the
document (for example PO lines).
Header Program/Header Subscreen
OpenText provides subscreens for managing index data both at header level
and item level. If the layout or information on the subscreen is inadequate to
the business process, you can define your own header program and custom
subscreen.
Note: The sections Header Fields and Item Fields in this transaction
are not supported in this VIM version.
Item Program/Item Subscreen
OpenText provides subscreens for managing index data both at header level
and item level. If the layout or information on the subscreen is inadequate to
the business process, you can define your own item program and custom
subscreen.
Note: The sections Header Fields and Item Fields in this transaction
are not supported in this VIM version.
Example: If the document is all okay, the user might want to post it directly,
without displaying the document data.
Display Image
Select this check box to display the archived image linked to the document in
a separate session when the user processes the work item.
Note: Archiving must be active in the system.
4. In the Document Processes Details screen, define the process type, using the
following parameters.
Process Type
Select the process type that is valid for the document type.
Active check box
Select this check box to achieve that the process type is considered for the
document type, for example if you want to delimit a specific process type
delivered by OpenText or defined in the system but no longer used.
BDC Transaction Id
Select the BDC Id that the system uses to process an SAP transaction to
create an SAP document in user context.
Background Tran Id
Select the BDC Id that the system uses to process an SAP transaction to
create an SAP document in the background. This is relevant if the user does
not want to see the index data (dashboard) during document posting.
Autopost Flag
The following settings are possible:
• Enter X to let the system try to create an SAP document in the
background, using the BDC Id set in the Background Tran Id field. If the
posting fails, the role defined in the Posting Role field in the document
type definition receives a work item to post the SAP document in dialog.
• Enter a custom function module that can be used to determine if the
system should automatically post the document. The interface for the
function module is defined in the /OPT/BL_IF_DETERMINE_AUTOPOST
function module.
ParkReason
Enter the parking reason the system uses to park the document.
Prerequisites
• The BDC Id defined for Document Create is used for parking the
document.
• A valid parking reason is defined in the Maintain Parking Reasons step
for Non PO or PO documents, see “Configuring Parking Reasons” on
page 130 and “Configuring Parking Reasons” on page 176.
Example: If the process type determined is to park a PO invoice for missing
or invalid information, create a parking reason and enter that parking reason
here.
3. In the Index Screen Options Overview screen, click the New entries button in
the application tool bar to create a new index screen option.
4. Configure index screen options, using the following parameters:
Process Type
Select a valid process type, as defined in “Defining Process Types” on
page 49.
Description
Description of the selected process type
Current role
Role which processes the work item
Allow Changes
Select this check box for a given role to allow all users in the role defined to
change the index data.
Prerequisite – The document should not have been submitted, yet.
Example: If INDEXER and AP_PROCESSOR roles should be able to change
index data, select the Allow changes check box in the Index Screen Options
screen for INDEXER and AP_PROCESSOR roles.
Show Duplicates
Select this check box to achieve that the duplicates identified by the system
are displayed below the index data screen for the role that is processing the
work item.
Example: It might be relevant for the DUP_CHECKER role to look at the
duplicates to decide whether the document is actually a duplicate. For the
AP_PROCESSOR role, showing duplicates might not be that important as the
document might have already completed the duplicate check process and
might be ready to be posted or parked.
Initial Tab
Select the initial tab in document processing. The following values are
available:
Dashboard
The user processing the work item in the role gets to see the Dashboard
(Process Options, Log etc.) subscreen first. However, users can switch
between screens themselves.
Index Data
The user processing the work item in the role gets to see the Index Data
subscreen first. However, users can switch between screens themselves.
Simulate and Bypass
Note: These parameters are introduced with VIM 5.2 SP1, as an
enhancement to the DP Dashboard. See also section 3.2.2 "Application
Toolbar" in OpenText Vendor Invoice Management - User Guide (VIM-
UGD).
Enable Simulate
Select this check box to simulate skipping certain business rules. The
Simulate process will check the relevant business rules.
Example: If any DP document got an exception Invalid Vendor (PO),
you can simulate this by selecting the current role and selecting Enable
Simulate.
Enable Bypass
Select this check box to bypass the business rules.
Example: If any DP document got an exception Invalid Vendor (PO),
you can bypass this by selecting the current role and selecting Enable
Simulate and Enable Bypass.
Dis.Obsolete
Select this check box to hide the Obsolete button in the DP Dashboard for
the selected DP document type and the current role.
Dis.Rescan
Select this check box to hide the Rescan button in the DP Dashboard for the
selected DP document type and the current role.
Run in Central
This column appears in satellite systems, only.
Select this check box for any business rule to have it run in the central system
by an RFC call from the satellite system. Some business rules are centralized.
Satellite systems can use such centralized rules by this option.
Example:
If a PO number is missing or invalid, the system should determine process type
101 (Invalid PO number).
In the document processes, you can configure the initial role that gets the work
item to resolve the exception (defined in the definition of the process type).
Check Type
Select the type of check to be performed:
• If Table Field is selected, the system validates that the value of the
document field at runtime exists in the check table mentioned in the
Table field. If the value does not exist, the step is considered to be
successful and the system will determine the process type.
You have to maintain the Table field.
• If Check Function is selected, you can define your own check against the
document field. If the function raises an exception the step is considered
to be successful and the system will determine the process type.
You have to maintain the Check Function field.
• If Constant Value is selected, you can define a constant value against
which the runtime data of the document is compared. If the runtime
value matches the configured value, the step is considered to be
successful and the system will determine the process type.
You have to maintain the value of the constant in the Check Val field.
• If Required Field is selected and if there is blank data in the document
field, it is considered as meeting the criteria. The step is considered to be
successful and the system will determine the process type.
You have to maintain the Required Field field.
Note: VIM 5.2 SP6 introduces a business rule check function library. This
library offers additional check function modules that are not directly
delivered as pre-customized business rules. You can use the function
modules as new business rules depending on your needs. The new library
is located in function group /OPT/VIM_PROC_TYPE_LIBRARY which has
been created to collect such function modules.
If you want to activate one of the library function modules as a new
business rule for any VIM document type, perform the following
customizing steps:
4. Maintain the fields you want to use for the PO line determination.
In the example screenshot, MENGE (Quantity), NETPR (Unit Price) and WBRTR
(Amount) have been maintained for determining the PO line match in the
baseline configuration.
5. Click to save your settings.
6. Continue with DP Document Type configuration: Execute the /n/OPT/SPRO
transaction and follow LiveLink VIM - Configuration > Document Processing
> Document Type Configuration > Maintain Document Types.
7. Double-click a line to open the Document Type Definition Details screen.
Note: If the PO line determination doesn’t find the PO line item number while
running the Business Rules, you will get an exception as shown in the
following screenshot of VIM Analytics. You will also get this exception if the
PO line item number is blank or if it is invalid.
In the Tax Code Determination group, the options for tax code determination
are displayed. The following options are available:
• “SAP Tax Determination Logic with OT Tax Table (Simple Maintenance)” on
page 64
• “Tax Determination using OpenText Tax Table (Simple Maintenance)” on
page 65
• “SAP Tax Determination Logic” on page 66
• “Customer Tax Determination” on page 66
Note: Select the Tax Code from Vendor Master check box to retrieve the
tax code from Vendor Master in case any of the other options fails to
retrieve the tax code.
Note: If the tax procedure with tax jurisdiction is used, the jurisdiction code is
determined first and this code is used in conjunction with tax code to retrieve
the match. For details on the jurisdiction code determination, see “Tax
Jurisdiction Code Determination” on page 63.
2. For a given Country key and Vendor ranges, maintain Tax Rate versus
Tax Code.
For tax procedures with jurisdiction code, additionally use the
Jurisdiction code field to maintain Tax Rate versus Tax Code entries.
b. If the above step does not result in a tax code match, the system retrieves the
tax code from Vendor Master if the Tax Code from Vendor Master check
box is selected in the DP configuration. The system checks if the vendor tax
code contains only one tax rate and if that tax rate matches with the tax rate
supplied. If it matches, the tax code is determined.
Note: If the tax procedure with tax jurisdiction is used, the jurisdiction code is
determined first and this code is used in conjunction with tax code to retrieve
the match. For details on the jurisdiction code determination, see “Tax
Jurisdiction Code Determination” on page 63.
*"--------------------------------------------------------
*"*"Local interface:
*" IMPORTING
*" REFERENCE(LOCATION) TYPE CHAR1 OPTIONAL
*" TABLES
*" INDEX_ITEM STRUCTURE /OPT/VIM_1ITEM
*" CHANGING
*" REFERENCE(INDEX_DATA) TYPE /OPT/VIM_1HEAD OPTIONAL
*"--------------------------------------------------------
3. Define the new duplicate check group, using the following parameters:
Duplicate Check Grp
Enter the 3 digit id identifying the duplicate check group.
Description
Enter a description for the duplicate check group.
Duplicate Check Type
Select Function Module or Index Data Fields from the drop down list.
Function Module
Select Function Module to configure duplicate check in a custom
function module. Enter the function module in the Duplicate Chk Func
field.
2. Define duplicate check fields for the selected group, using the following
parameter:
Dup Check Step Id
Enter a value to group different fields from document data.
Example:
If a document should be considered duplicate if document date, reference
number and gross amount matches or document date, reference number and
PO number matches, you can define:
• Step Id 1, Field name BLDAT
• Step Id 1, Field name XBLNR
• Step Id 1, Field name GROSS_AMOUNT
• Step Id 2, Field name BLDAT
• Step Id 2, Field name XBLNR
• Step Id 2, Field name EBELN
The system first checks the entries in table /OPT/VT_DOC_DET. If the vendor is found,
the DP document is considered as a PO based invoice. If no vendor entry is found,
the system checks for the existence of any PO numbers on the invoice.
You can maintain vendors per company code and also ranges of company code and
vendor combinations.
To create a new role, follow the process described in “Defining Roles” on page 29,
with product code 005.
Class Method
At this point, this is not supported.
Call Transaction
The system calls the transaction that is defined in the Transaction Code
field.
Note: If you select Call Transaction you have to maintain the
Transaction Code field.
Workflow Task
The system calls a (sub) workflow or task before continuing the process.
Select Workflow Task to define any custom post processing steps for a
given option.
Auto Action Required
Select this check box to let the system try to post the document (create SAP
document) in background. The transaction that is called for posting depends
on the process type configuration.
Recheck Proc Type
Select this check box to let the system try to run the business rules as
defined.
Confirm Check Rules
Select this check box to let the system try to get a confirmation from the user
to rerun the business rules.
Confirm Execute
Select this check box to let the system get a confirmation from the user to
execute the option.
Confirm Completion
Select this check box to let the system get a confirmation from the user that
the option is successfully executed.
Display Index Data
New since VIM 5.2 SP6. Select this check box to let the system display
indexing data of the DP in a separate window while executing this process
option.
Note: After Display Index Data is selected for a certain Process Option,
the feature is applied to all Document Types.
Document Status
Select the status set for the document if the option is executed successfully.
CATT Mode
Select the CATT mode. The following values are possible:
No CATT
’ ’ No CATT active
Not a BI Session
Select this check box to specify no batch input mode, that is, SY-BINPT =
SPACE.
End: No BI
Select this check box to specify no batch input mode after the end of BDC
data.
Custom BDC Function
Maintain the custom BDC function, and the system will ignore all settings in
the BDC Definition Details screen. Figure 5-2 on page 75 shows the
function module interface.
To define parameters:
1. In the BDC Definition Details screen, double-click Parameters in the
navigation pane.
As the data head is structure, it is not specified. Use field symbol to pass
it on to the respective structure.
You can use the function module parameter ID also as exit before calling
BDC transaction.
Create a dummy parameter ID and use the custom function module for
any processing that needs to be done before BDC call.
Application Variable
Application Variable is used to reference index field values.
System Field
System Field is used to reference system fields.
Default Value
Default Value is used to set default values as parameters.
Class Method
Currently not implemented.
Class Method
Currently not implemented.
BDC Extension Function Module
You can use this option to add a screen field to BDC Data structure based
on special logic, for example country specific screen fields. When you use
this option, enter the following values and leave the remaining fields
empty. See the following screenshot.
Program
EXTENSION
The function module interface must be like the one shown in the
following screenshot. Append the BDC field information to the table
BDCDATA for each field.
The success message is not required for all transactions. In a few cases, like MIRO and
FV60 transactions, the transaction itself exports a Process_key-complete flag to
memory ID name as work item ID, and then the system also treats the transaction as
completed.
The following is the example code for exporting a document creation flag in case of
MIRO and FV60 transactions.
CHECK sy-subrc EQ 0.
l_prockey-bus_objtype = 'BUS2081'.
l_prockey-bus_objkey = l_rbkp+3(14).
l_prockey-complete = 'X'.
Usage:
• When a PO document is parked, the VIM BAdI triggers an OpenText process to
capture the reason for parking the invoice which triggers the OpenText PO
parked invoice workflow process.
• When a PO document is posted and the PO document is blocked for any reason,
the VIM BAdI triggers the PO blocked invoice workflow process.
You can also check the activation in the Switch Framework, which is accessible
through transactions SFW2 and SFW5.
2. In the Switch Framework: Change Business Function Status screen, make sure
that Planned Status for /OPT/VIM_SFW_MIRO is On.
Prerequisites
• Document entry by OCR required
• Document data structures extended as described in “Extending Document Data”
on page 85 (optional)
Every line represents one line item field of a DP document type, indicated by
the Field Name. The table comprises all line item fields of all DP document
types.
2. Configure the fields in the Field Stat column, using the following parameters:
Input
Users can enter values on the indexing screen.
Required
Users must enter values. The field is marked as mandatory.
Hide
The field does not appear on the indexing screen.
Note: If you want to import and store data from an external system but
you do not want to show them in the indexing screen, you can use this
setting.
Display Only
The field appears on the indexing screen, but the user cannot enter values.
The user process options for each role define the options on the dashboard for each
role.
Initial Actor
Select the initial role that gets the work item.
Initial Actor Function
Select a custom function module to determine the initial role. The system
first checks if there is an initial actor. If there is no initial actor, the system
tries to get the initial actor from the function module.
Is Exception
Select this check box to mark the process type as exception. If this check box
is selected, the process type is not relevant for automatic background
document posting.
Auto Start
Relevant for DP based approval workflow. If the process type corresponding
to the approval workflow is determined, the system checks whether the
Auto Start check box is enabled. If yes, the system starts the approval
workflow if it is enabled. If Auto Start is not enabled, processing continues
with the initial actor assigned to the current process type. The initial actor
will manually start the approval workflow.
Create SR
Relevant for the SSF integration. This column is only available if VIM is
integrated with CRM SSF. See “SSF Integration” on page 437.
Select this check box to configure that an automatic Service Request is
created in background when this process type is triggered.
Country Check
Relevant for country specific configuration, for the following kinds of
process types:
• Process types that are specific to a single country or multiple countries
• Process types that need to be checked for specific invoice categories in
specific countries only
• Custom process types that need to be executed only for certain invoice
categories of a country
Select this check box for these process types.
This check box tells the VIM system to check the country configurations also
before the check defined in the process types is executed on the invoice.
Baseline configuration provides the check box as selected for the baseline
process types that need additional checks to be performed for the country
configuration.
See “Process Types” on page 361
Workflow Type
Select Opentext Approval Workflow from the drop down list to start the DP
based approval workflow. With Opentext Approval Workflow selected, it is
possible to select or clear the Auto Start check box, as the case may be.
Select External Workflow from the drop down list to run any external
workflow (based on SAP technology) outside SAP IM workflows as a part of
any business rule. With External Workflow selected, the Auto Start option
is always enabled.
Select SRM System Integration from the drop down list for SRM scenarios
or any other external systems where an email will be sent and the workflow
will be in wait status. See “Supplier Relationship Management (SRM)
Integration” on page 535.
Task ID
Enter the workflow template to be triggered. The workflow template
container can be of any interface as the binding is controlled by a custom
binding function module.
Binding Function
Enter the Workflow Binding function module.
It must be implemented in the system where the SAP IM workflow is
running, to pass appropriate data to the external workflow. The function
module should have an interface as /OPT/VIM_DASHBOARD_BINDING. Inside
the custom function, in this case, implement Dataflow = E (Inward Binding).
You can access the complete container elements of the DP workflow from the
table parameter CALLING_CONTAINER. Regarding how actual to implement
the binding function, you can refer /OPT/VIM_DASHBOARD_BINDING.
As a simple implementation, element INDEXDOCUMENT can be accessed from
the container CALLING_CONTAINER. DP (Document Processing number) can
be retrieved and other indexing information can be extracted and passed to
the elements of the CALLED_CONTAINER container, which is the container of
the external workflow. The external workflow must also raise the event
/OPT/V1001.PSS_COMPLETED at the end in the system where the SAP IM
workflow runs so that the SAP IM workflow proceeds further.
Example 5-2: Sample code for the Workflow Binding function module
FUNCTION Z_SHV_BINDING.
*"-----------------------------------------------------------
*"*"Local interface:
*" IMPORTING
*" VALUE(DATAFLOW) LIKE SWABINDEF-DATAFLOW
*" TABLES
*" CALLED_CONTAINER STRUCTURE SWCONT
*" CALLING_CONTAINER STRUCTURE SWCONT
*"-----------------------------------------------------------
include <cntn01>.
SWC_CONTAINER_TO_RUNTIME called_container.
SWC_CONTAINER_TO_PERSISTENT called_container.
SWC_CONTAINER_TO_RUNTIME CALLING_CONTAINER.
ENDIF.
ENDFUNCTION.
Option Id
Process option identifier
Description
Description of the option
From Actor
Select the source role that gets the work item.
To Actor
Select the target role that receives the work item if the action is performed.
This is only available if the option is a referral.
Check FM
Enter a check function module to restrict the option for a role. You find the
interface for the check function module using /OPT/VIM_BL_CHECK_FM_2012.
OCR lines
• If no OCR lines are supplied, the entire proposal that is based on reference
documents is used to form indexing lines, based either on PO orders in the
documents or on Delivery Notes, but not on both.
• If OCR lines are supplied, and all lines’ mandatory fields are filled, no business
exception occurs.
• If OCR lines are supplied, but some lines have empty mandatory fields, these
lines are considered as incomplete.
Incomplete OCR lines are checked if certain fields are complete. According to the
configuration, either the lines proposed by the MIRO transaction or the OCR
supplied lines can then form the basis for indexing lines. See “To configure Z
constants for the business rule Manual Check Needed for Indexing Lines:” on
page 97.
Business exception
A business exception occurs under the following conditions:
• When a line is still considered incomplete due to missing mandatory fields.
• When the system automatically derives a line or a field value.
To configure the business rule Manual Check Needed for Indexing Lines:
1. Execute the /OPT/VIM_1CX1 transaction.
Alternatively, follow LiveLink VIM - Configuration > Document Processing >
Document Type Configuration > Maintain Document Types.
See also “Defining the Process Type Determination Sequence” on page 53.
2. At DP Document Type level, configure process type 110 Manual Check Needed
for Indexing Lines anywhere after process type 109 Unable to determine PO
line no.
3. Clear the Exclusive Indicator check box for process type 109.
Since process type 110 is used to further determine missing lines, this is
necessary to avoid exceptions occurring as a result of the system not being able
to determine the PO item number.
4. Clear the Exclusive Indicator check box for process type 107.
Process type 107 is obsolete when process type 110 is used.
5. Open the Sequence Steps screen for process type 110. See also “Defining
Sequence Steps” on page 55.
To configure Z constants for the business rule Manual Check Needed for
Indexing Lines:
1. Execute the /n/OPT/SPRO transaction and follow LiveLink VIM -
Configuration > Document Processing > External System Data (OCR / IDoc) >
PO Line Determination > Maintain Constants for PO Invoice Lines >
Maintain PO Invoice Lines Related Constants.
This menu path takes you to the list of Z constants that influence the PO line
matching.
The following Z constants are relevant for the business rule Manual Check
Needed for Indexing Lines:
• PATH_INCOMPLETE_LINE
• LEVEL_PREFERENCE
• REF_DOC_PREFERENCE
3. Enter Constant Value MO, OK, or OD. See the following description.
MO
Use MIRO proposal as basis for incomplete OCR lines.
All lines that are based on reference documents are read from the MIRO
proposal. All MIRO lines for which matches are found in OCR line items are
overwritten with OCR Amount/Quantity.
• While matching, PO/PO item will be used as a key for Non GR IV case.
• PO/PO item or delivery note will be used as a key for GR IV case.
All lines that could not be matched against OCR lines stay unchanged.
Finally, the modified MIRO lines are updated in the indexing item table.
OK (default value)
Use OCR lines as basis for incomplete OCR lines without deleting any
unmatched OCR lines.
OCR lines are evaluated line by line. All lines based on reference documents
are read from the MIRO proposal. All OCR lines for which matches are found
in the MIRO proposal are overwritten with MIRO Amount/Quantity if the
OCR Amount/Quantity is missing.
• While matching, PO/PO item will be used as a key for Non GR IV case.
• PO/PO item or delivery note will be used as a key for GR IV case.
All lines that could not be matched with MIRO lines stay as they are. Finally,
the modified OCR lines are updated in the indexing item table.
OD
Use OCR lines as basis for incomplete OCR lines and delete those lines from
OCR for which no match could be found.
OCR lines are evaluated line by line. All lines that are based on reference
documents are read from the MIRO proposal. All OCR lines for which
matches are found in the MIRO proposal are overwritten with MIRO
Amount/Quantity if the OCR Amount/Quantity is missing.
• While matching, PO/PO item will be used as a key for Non GR IV case.
• PO/PO item or delivery note will be used as a key for GR IV case.
All lines that could not be matched against MIRO lines and that are
incomplete are deleted. Finally, the modified OCR lines are updated in the
indexing item table.
4. In the list of Z constants, double-click LEVEL_PREFERENCE to configure if users
choose PO/delivery note either at header level or line level.
Important
LEVEL_PREFERENCE is used in conjunction with REF_DOC_PREFERENCE.
These two values indicate the starting point for selecting reference
documents, in order to propose lines for invoicing: either purchase
orders or delivery notes that appear either at line item level or at header
level.
Example:
If LEVEL_PREFERENCE is L and REF_DOC_PREFERENCE is PO, the system
uses purchase orders at line item level as the basis for getting proposals.
If no purchase order exists at line item level, the system uses delivery
notes at line item level.
If no documents exist at line level, the system uses the header level and
starts with purchase orders, there.
If no purchase order is supplied, the system uses delivery notes at
header level.
Process option BDC Configuration Id 200 is a special BDC Configuration Id. It, therefore, needs to
be attached to a user process option, which in turn is called from the DP Dashboard.
Either create a new process option or change the existing process option for PO
invoice posting, as shown in the following procedure.
User process You need to configure the user process option 2009 Post PO Invoice for process
option type 110 Manual Check Needed for Indexing Lines.
3. Maintain process option 2009 Post PO Invoice for appropriate roles under
process type 110, as shown in the screenshot.
Note: These functions are valid for SAP version ECC 6.0. For versions earlier
than ECC 6.0, use SAP Modification.
/OPT/VIM_BUILD_REFERENCE_DOCS
This function is used for passing the reference documents (include LMR1MF3S).
Call this function inside the subroutine ZUORDNUNGSKRITERIEN_AUFBAUEN.
/OPT/VIM_CHANGE_PROPOSAL_MIRO
This function is used to manipulate the lines from proposal (include LMR1MF3U).
Call this function inside the subroutine ZUORDNUNG_DURCHFUEHREN.
********BEGIN OF CODE PIECE**************************
data: vim type c.
.
***********BEGIN OF ADDITIONAL MIRO CHECKS*******************
if VIM = 'X'.
loop at ydrseg.
endloop.
endif.
***********END OF ADDITIONAL MIRO CHECKS***********************
You might not want to entirely overwrite the BAPIs with custom BAPIs as described
above. The other way to allow some custom modifications is to use a custom plug-in
function module.
This Z constant allows you to plug in your own function module, in order to
enhance the functionality lines for posting or parking via BAPI. This plug-in
custom function is called within /OPT/VIM_52_BAPI_DOCLINES_PO and
/OPT/VIM_52_BAPI_PO_PARK, just before creating the SAP documents.
If multiple GRs are allowed for a PO item, the delivery note or GR document needs
to be supplied to find a match.
Sometimes, when a delivery note has multiple GRs linked to it, the business rule 110
Manual Check Needed for Indexing Lines will result in an exception, even if the
delivery note is supplied. If this is the case, you may need to explicitly supply a GR
document.
If the delivery note and the GR document correspond at a 1:1 ratio, supplying the
delivery note along with the PO/PO item is sufficient for finding a match.
PO item You must determine a PO item number before you run the new business rule 110
numbers Manual Check Needed for Indexing Lines for better matching.
Service-based PO line items are not fully supported. If you use MO as the basis for
incomplete OCR lines or always derive lines from the SAP proposal, the service-
based PO line items can be determined. However, if a service-based PO line item is
supplied but incomplete (mandatory fields missing), it may not be possible to
determine missing fields correctly.
The older business rule 109 Unable to determine PO line no complements the new
enhanced functionality. Business rule 109 Unable to determine PO line no is used
to determine PO item numbers for a particular indexing line only. If business rule
109 Unable to determine PO line no derives PO item numbers automatically, the
exception is not raised by the Baseline configuration. The older rule for finding PO
item numbers is set up by the configuration in transaction /OPT/VIM_POL where you
set up a PO line determination ID and then associate this determination ID to the DP
document type.
Notes on the MIRO enhancement to pass indexing lines from DP Dashboard –
All the lines from indexing that could be matched are manipulated with Indexing
Amount and Quantity and are highlighted when selected.
Lines that could not be matched stay unselected.
Matching is the key to pass Indexing Amount and Quantity.
Matching works the best when all key values are available for the indexing lines.
Example 5-4: The OCR indexing lines are supplied, but certain lines are not
complete
Example 5-5: The OCR indexing lines are supplied, but certain lines are not
complete for GR-IV based lines
Neither a delivery note nor a GR reference document exists for line item 1 which is
GR-IV based.
It is important to have the delivery note or the actual GR document mentioned in
the indexing line if the PO line item is GR-IV based.
The exception related to the business rule 110 is triggered.
Missing fields (GR documents) are derived for GR-IV based lines.
Comm Required
If you select this check box, the user must maintain the comments to
proceed.
Table Field
Data will be populated from the /OPT/VIM_1HEAD table.
Container Expression
Data will be populated from container data from task TS9578003.
Custom Function
Data is derived using a custom function module. A sample interface can
be found from function module /OPT/BL_IF_SET_DYNAMIC_COLUMN.
Important
Take care when you change the global configuration parameters. Changes
can affect the functionality of the process.
GR_CHECK_EXIT
Usage
This constant defines the function that is called to check if the Goods
Receipt (GR) for the PO is already done.
This constant is only applicable for Brazil.
Default value
/OPT/VIM_BL_CHECK_GR_EXIT
GR_MOVEMENT_TYPE
Usage
This constant defines the movement type to be used when posting the
goods receipt (GR) document in background. It can either be a fixed
value or a function module name.
This constant is only applicable for Brazil.
Default value
For a fixed value, just mention the movement type in the constant value,
for example: 101.
For a function module, use the format FM: <function_name>.
GR_POST_BAPI_EXIT
Usage
This user exit bases on a function module. The function module defined
in this constant is called by the standard program before the SAP BAPI is
called while posting the goods receipt (GR). You can use this user exit to
change values being passed to the BAPI.
This constant is only applicable for Brazil.
Default value
None
The interface of the custom function module must be the same as
/OPT/DPPO_GR_BAPI_POST_EXIT.
DP_NPO_POSTING_EXIT
Usage
This user exit bases on a function module. The function module is called
before calling the non PO invoice posting BAPI
BAPI_ACC_DOCUMENT_POST in function module
/OPT/DNONPO_INVOICE_BAPI. You can use this user exit to modify the
baseline data in BAPI structures.
This constant is applicable for all countries.
Default value
None
APP_DOCU_URL
Usage
The custom help URL for the DP dashboard. You can provide custom
help for users to look up processing steps they need to take when they
are processing the DP dashboard.
Default value
www.opentext.com
IMG_DOCU_URL
Usage
The custom help URL for OpenText IMG. Do not change this constant.
Default value
www.opentext.com
MAIN_WF_TEMPLATE
Usage
The default workflow template that will be triggered for DP. Do not
change this value.
Default value
WS00275255
NUMBER_RANGE_OBJECT
Usage
The default number range object for DP is /OPT/DOCID. If you want to
define a custom number range object for document number ranges,
define the value of the number range object here.
Default value
None
Note: If you change this value, you will have to maintain the number
ranges for the documents separately. The OpenText delivered
/OPT/VIM_1CX6 transaction will not work in this case for maintaining
number ranges.
PREPROCESS_EXIT_FM
Usage
A custom function module can be used as a value for this constant to
change the document values (Index Data etc.) before the workflow starts.
Default value
None
Interface
CALL FUNCTION <CONSTANT>
CHANGING
INDEXER = LCL_INDEXER TYPE REF TO
/OPT/CL_VIM_DOC_PROCESSOR
REMINDER_USER_EXIT
Usage
This configuration value is used to maintain a custom function allowing
to format e-mail content when sending reminders to users holding work
items.
Default value
/OPT/VIM_NOTIF_USER_EXIT_TEMP
Interface
CALL FUNCTION <CONSTANT>
TABLES
OUT_DATA STRUCTURE /OPT/VIM_S1_REMINDER_DISPLAY
FIELDS_CATALOG STRUCTURE LVC_S_FCAT
SORT_FIELDS STRUCTURE LVC_S_SORT
SERVICE_ENTRY_BSART
Usage
This configuration value is relevant for service entry processing: The
service entry document type.
Default value
None
SERVICE_ENTRY_BSTYP
Usage
This configuration value is relevant for service entry processing:
Purchase document category for service entry.
Default value
None
WI_TEXT_FM
Usage
This configuration value is used to maintain a custom function allowing
to format the work item text.
Prerequisite
Knowledge about work item data
Default value
/OPT/BL_IF_DETERMINE_WI_TEXT
Interface
CALL FUNCTION <CONSTANT>
EXPORTING
VALUE(INDEX_DOCID) TYPE /OPT/DOCID
IMPORTING
REFERENCE(WI_TEXT) TYPE SWW_WITEXT
DP_DASHBOARD_TASKID
Usage
This configuration value is used to determine the dashboard task in DP.
The task should be compatible to task TS00275257.
Prerequisite
Knowledge about workflow tasks
Default value
TS00275257
Note: Do not change this value as a change affects the behavior of the
application.
DUP_CHECK_DELIMIT
Usage
This configuration value is used to determine which characters in the
document reference number are considered as delimiter to determine a
document as a duplicate.
Default value
/-
Example
If a document with reference number REF-1 should be considered as a
duplicate for REF, the delimiter that should be maintained is -.
LIST_WF_STATUSES
Usage
This configuration value is used to determine at which document statuses
the PO parked workflow should be triggered. The document status in
question is the SAP document status.
Default value
A
Usage
This configuration value is used to determine for which SAP document
types the PO/Non PO workflow is triggered. This eliminates the
Example
If you want to trigger the workflow for GL documents (document type
AB) maintain value AB here.
WFTRGPLANT
Usage
This configuration value is used to determine for which plants the PO /
Non PO workflow is triggered. This eliminates the triggering of the
workflow for unwanted plants. If you want to consider all plants,
maintain the value * here.
Default value
*
Example
If you want to stop triggering the workflow for plant 0001, maintain all
plants different from 0001 here.
Main concepts
Parking reasons
• Parking reasons effect the process flow as required by the swimlane
definition.
• Each swimlane diagram translates to one parking reason.
• Parking reasons determine the initial actor and various collaboration options
available to the various actors during the process flow.
Roles
• Roles use the standard OpenText role/actor infrastructure.
• Roles can use the standard key determination infrastructure to configure
complex actor determination logic without programming.
• For the PO parking process, the role concept uses the product code LIX.
Options and option types
• The following main types of options are available:
• Actions
• Referrals (for collaboration)
• Actions can base on transactions or class methods or workflow tasks.
• Options and option types can effect the processing logic.
• Options and option types can effect the user experience.
• Options and option types can make the workflow engine rerun the rules on
the most current metadata to effect the process flow.
• Options and option types can be configured to change the document status.
BDC IDs
• BDC IDs build a powerful infrastructure for pre-populating data into SAP
transactions without programming.
• BDC IDs are optimized for both dialog processing and background
processing.
• BDC IDs can be used to set dynamic Parameter IDs.
• BDC IDs can be used to configure new user collaboration actions.
• BDC IDs eliminate the need to code parameterized transactions.
• BDC IDs can be used to configure BDC success messages.
Main steps The following are the main steps involved in implementing process scenarios in the
PO parking process:
1. Identify the various parking reasons that are required for the realization of the
process scenarios.
2. Identify the subscreen to be called during the document parking process.
3. Identify the roll out criteria.
4. Identify the various roles and configure the roles in the appropriate process
types.
5. Identify and configure the process options according to the swimlanes.
6. Configure global customization setting as per customer requirements.
The starting point for any configuration is a set of process flow swimlanes. The
following swimlane is an example of such a process as implemented by the PO
invoice parking workflow:
The following sections describe the main steps of the PO parking process
configuration:
• “Defining Rollout Criteria” on page 123
• “Configuring Process Options” on page 126
• “Configuring Parking Reasons” on page 130
• “Configuring Global Parameters” on page 135
• Rollout company codes, plants, and document types are maintained in the
respective tables by using the OpenText Customization:
Company codes
/OPT/VIM_CCODE_A
Plants
/OPT/VIM_PLANT_A
Document types
/OPT/VIM_DTYPE_A
2. In the Allowed Company Codes screen, select either both PO Invoice Process
and Non PO Invoice Process or only one of the check boxes for the respective
Company Code.
3. Click New entries to add a company code.
Save your settings when finished.
4. Double-click Allowed Plants and Allowed Document Types in the navigation
panel to switch to the respective screens and define the rollout criteria for plants
and document types, as described for company codes.
The respective receiver function module triggers the workflow based on the
data in the tables. The workflow is triggered when there is no data maintained
in the table(s) or the data meets all the conditions such as company code,
document type and plant (only for PO invoices).
Caution
If you change the configuration in this section, the PO parking process might
not trigger at all.
Check Autopost
Define if the system shall try to post a parked document in background after
successful execution of the option:
• Enter X to enable automatic posting.
• Enter FM:<FUNCTION> where <FUNCTION> is a custom function module
to determine if the document will be posted. This is relevant when it is
difficult for the system to define the auto-post criteria directly.
Comments Required
Select this check box to force the user to maintain comments once this option
is executed.
Hdr Level Decision
Select this check box to achieve that the system applies the decision to the
entire document rather than to the current line item in the process. This is
applicable in the PO blocked invoice processing scenario where there may be
options that need to be applied to the entire PO invoice and not just the line
item that is being worked on.
Confirm Execution
Select this check box to achieve that the user will be prompted to confirm the
option selected.
Example: If an option deletes the SAP document, a confirmation from the
user to really perform the action makes sense.
Confirm Completion
Select this check box to achieve that the user will be prompted to confirm
successful completion of the option.
Override
Select this check box to achieve that the user will be able to select any SAP
user in the system as the user(s) that will receive the work item when it is
referred, and not just the users the system proposes after running the role
resolution process. This parameter is applicable only in the Referral option
type.
Validate Override User
Select a function module that is used to validate the users that the current
user overrides.
Example: If a work item needs to be sent for approval, which is technically a
referral, and the user is allowed to change the proposed users, this custom
validation is required to disallow users to choose anyone they want.
Run Inv. Verification
Select this check box to run invoice verification when the current process
ends.
Process Complete
Select this check box to end the current process and start the next process.
Option Type
Select the type of process option (Action, Referral, BDC Action, Approve,
Reject, etc., see “Configuring Process Options” on page 126)
Option ID
Select the ID of the process option.
Condition FM
• Define a condition function module to restrict availability of an option to
a role even if the availability is defined here.
Example: If you would like to show the option “Change Purchase Info
Record” only if the Purchase Order has a Purchase Info Record (PIR), you
can define a custom function to verify the existence of the PIR and issue
an error if there is no PIR.
• If an error is issued in the function module, the option will not be
available to the user.
• For the interface of the condition function module, see function module
/OPT/BL_CONDFM_INFOPROVIDER.
In this step, you define the valid parking reasons. Each parking reason represents a
process scenario as represented in a swimlane diagram.
Configuring a parking reason comprises the following actions:
• Define the parking reason.
• Define the roles that are responsible for receiving the first work item in the
process, for posting the PO invoice, and the initial approver.
• Define if the process triggering needs to be delayed.
• Delimit the available options for the parking reason.
Autopost
Select this check box to achieve that the system tries to post the parked
invoice after the routing is complete.
Posting Actor
Define the role responsible for posting the invoice and also responsible for
handling errors if the posting in background fails.
Initial Actor
Define the role who receives the first work item in the process when the
current parking reason is selected.
Initial Actor FM
You can define a custom function module to determine the initial actor.
Example:
A PO is parked for a reason that is applicable to BUYER or REQUISITIONER
depending on the availability of a value REQUESTER in Purchase Info Record
or Goods Receipt. You can then define a custom function module to
determine the availability of value for REQUESTER in Purchase Info Record or
Goods Receipt and set the initial actor accordingly.
For the interface of the function module, see function module
/OPT/BL_Q_INIT_ACT_FM.
Available Options
Define the options that are available for the role on the dashboard during PO
parked invoice process for the current parking reason. Separate the options
by semicolon. The option format is AXXXX where A is the option type and
XXXX is the 4 digit value representing the option ID.
The system uses these values in conjunction with the user process options
defined in “Configuring User Process Options” on page 129 to determine
which options show up for the role’s dashboard.
Initial Approver
Define the role of the initial approver if the invoice document is sent for
approval.
Delay Function
• Define the custom function module that can be used to restrict the
immediate triggering of the PO parking process even if the user selected
the current parking reason when the invoice is parked.
Example: The PO is parked for “Credit Memo Required” and you know
that Credit Memo is on its way and will not show up for the next two
days. You might then want to send the work item to the AP's inbox not
before two days. For this purpose, you can define a custom function to
restrict the triggering of the work item for the user for the next two days.
• For the interface of the delay function module, see function module
/OPT/BL_P_DELAYFM_SRM.
Important
Take care when you change the global configuration parameters. Changes
can affect the functionality of the process.
Constant: PRKSCREEN
Usage
Subscreen number for parked invoice dashboard header subscreen. To
provide additional data on the invoice dashboard, you can define your
custom screen here.
Default Value
9901
2. Configure the order in which the options will appear in the user’s dashboard,
using the following parameters:
Description
Enter a description of the option order.
Constant Value
Value for the option order. Default value: 10ATR
Example: If you want all actions to show up first, maintain A10TR. The
options will be shown in order actions, approvals, rejections, authorizations
and referrals.
Default value
/PTGWFI/PRK_TMP_BIND_EXT_FM
Constant PRK_PSS_BIND_FM2
Usage
This function module is used to manipulate the workflow container
during outward binding (workflow container to task container). This
manipulation facilitates the user to capture process information and
populate with additional information.
Default value
/ORS/000007_LIX_PSS_BIND_O
Constant Value
• Enter a function module. This function module can be used to post a
document automatically using a custom function. If the function module
configured here throws an exception, the system will however post the
document using the standard posting logic for PO invoice documents.
• Default value: None
• For the interface of the function module, see function module
/PTGWFI/PRK_M_TMP_PRE_AUTOPOST.
VIM 5.2 SP6 introduces new function modules for this scenario. They populate the
new invoice with a subset of the header data of the deleted document:
• Company code
• Document date
• Vendor reference number
• Currency
• Vendor number
You can insert these function modules in the corresponding Z constants or you can
create an own logic on basis of these function modules.
For the creation of a PO invoice, maintain the new function module
/PTGWFI/VIM_CRE_PO_INV_PREF in table /PTGWFI/Z_CONST, using the SM30
transaction.
Main concepts
Blocking reasons
• Blocking reasons effect the process flow as required by the swimlane
definition.
• Each swimlane diagram translates to one blocking reason.
• Blocking reasons determine the initial actor and various collaboration options
available to the various actors during the process flow.
Roles
• Roles use the standard OpenText role/actor infrastructure.
• Roles can use the standard key determination infrastructure to configure
complex actor determination logic without programming.
• The role concept uses the product code LIX, same as for PO invoice parking
scenarios described in “PO Parking Process Configuration” on page 121.
Options and option types
• The following main types of options are available:
• Actions
• Referrals (for collaboration)
• Actions can base on transactions or class methods or workflow tasks.
• Options and option types can effect the processing logic.
• Options and option types can also effect the user experience.
• Options and option types can make the workflow engine rerun the rules on
the most current metadata to effect the process flow.
• Options and option types can be configured to change the document status.
BDC IDs
• BDC IDs build a powerful infrastructure for pre-populating data into SAP
transactions without programming.
• BDC IDs are optimized for both dialog processing and background
processing.
• BDC IDs can be used to set dynamic Parameter IDs.
• BDC IDs can be used to configure new user collaboration actions.
• BDC IDs eliminate the need to code parameterized transactions.
• BDC IDs can be used to configure BDC success messages.
Main steps The following are the main steps involved in implementing process scenarios in the
blocked PO invoice process configuration:
1. Identify the various blocking reasons that are required for the realization of the
process scenarios.
2. Identify the roll out criteria.
3. Identify the various roles and configure the roles in the appropriate process
types.
4. Identify and configure the process options according to the swimlanes.
5. Configure global customization setting as per customer requirements.
The starting point for any configuration is a set of process flow swimlanes. The
following swimlane is an example of such a process swimlane, as implemented by
the blocked PO invoice processing workflow:
The following sections describe the main steps of the PO blocking process
configuration:
• “Defining Rollout Criteria” on page 151
• “Configuring Process Options” on page 153
• “Configuring Blocking Reasons” on page 155
• “Configuring Global Parameters” on page 157
Note: Company codes are part of the rollout criteria, besides document types
and plants, for the PO parking process, the PO blocking process, and the Non
PO parking process. For details, see “Defining Rollout Criteria” on page 123.
2. In the Allowed Company Codes screen, select either both PO Invoice Process
and Non PO Invoice Process or only one of the check boxes for the respective
Company Code.
3. Click New entries to add a company code.
Save your settings when finished.
4. Double-click Allowed Plants and Allowed Document Types in the navigation
panel to switch to the respective screens and define the rollout criteria for plants
and document types, as described for company codes.
The respective receiver function module triggers the workflow based on the
data in the tables. The workflow is triggered when there is no data maintained
in the table(s) or the data meets all the conditions such as company code,
document type and plant (only for PO invoices).
Caution
If you change the configuration in this section, the PO blocking process
might not trigger at all.
Option Type
Select the type of process option (Action, Referral, BDC Action, Approve,
Reject, etc., see “Configuring Process Options” on page 126)
Option ID
Select the ID of the process option.
Condition FM
• Define a condition function module to restrict availability of an option to
a role even if the availability is defined here.
•
Example: If you would like to show the option “Change Purchase Info
Record” only if the Purchase Order has a Purchase Info Record (PIR), you
can define a custom function to verify the existence of the PIR and raise
an error if there is no PIR.
• If an error is raised in the function module, the option will not be
available to the user.
• For the interface of the function module, see function module
/OPT/BL_CONDFM_INFOPROVIDER.
Initial Actor
Define the role who receives the first work item in the process when the
current blocking reason is selected.
Example: If a PO invoice is blocked for “Price discrepancies”, the initial role
that needs to look at the invoice is the BUYER to correct the PO. Maintain
BUYER as initial actor.
Initial Actor FM
• You can define a custom function module to determine the initial actor.
Example: A PO is blocked for a reason that is applicable to BUYER or
REQUISITIONER depending on the fact that there is at least one Goods
Receipt posted. You can then define a custom function to determine the
availability of a Goods Receipt for the invoice and to set the initial actor
accordingly.
• For the interface of the initial actor function module, see function module
/OPT/BL_Q_INIT_ACT_FM.
Object Type
This parameter is obsolete.
Event
This parameter is obsolete.
Reference table
This parameter is obsolete.
Reference field
This parameter is obsolete.
Important
Take care when you change the global configuration parameters. Changes
can affect the functionality of the process.
Constant: LIXSCREEN
Usage
Subscreen number for blocked invoice dashboard header subscreen. To
provide additional data on the invoice dashboard, you can define your
custom screen here.
Default Value
9902
Constant: LIXDBSCREEN
Usage
Sub screen number for blocked invoice dashboard header sub screen. To
provide additional data on the invoice dashboard, you can define your
custom screen here.
Default Value
9902
2. Configure the order in which the options will appear in the user’s dashboard,
using the following parameters:
Description
Enter a description of the option order.
Constant Value
Value for the option order. Default value: 10ATR
Example: If you want all actions to show up first, maintain A10TR. The
options will be shown in order actions, approvals, rejections, authorizations
and referrals.
2. Configure the post dashboard method exit, using the following parameters:
Constant Value
This value is used to manage document data after calling the dashboard.
Default value
/PTGWFI/LIX_BK_TMP_PST_EXT
2. Configure the send back functionality exit, using the following parameters:
Constant DB_SNDBACK_EXIT
Usage
This function module is used to capture option information from the
dashboard step when the work item is sent back successfully in the
header level dashboard.
Default value
None
Interface
The interface of the function module is found in function module
/PTGWFI/LIX_TMP_DB_SBK_EXIT.
Interface
For the interface of the image display function module, see function
module /PTGWFI/LIX_F_TMP_DISP_IMG.
VIM 5.2 SP6 introduces new function modules for this scenario. See “Configuring
Populating Screens for Re-enter Options” on page 147 for details.
Main concepts
Parking reasons
• Parking reasons effect the process flow as required by the swimlane
definition.
• Each swimlane diagram translates to one parking reason.
• Parking reasons determine the initial actor and various collaboration options
available to the various actors during the process flow.
Roles
• Roles use the standard OpenText role/actor infrastructure.
• Roles can use the standard key determination infrastructure to configure
complex actor determination logic without programming.
• For the Non PO parking process, the role concept uses the product code PIR.
Options and option types
• The following main types of options are available:
• Actions
• Referrals (for collaboration)
• Actions can base on transactions or class methods or workflow tasks.
• Options and option types can effect the processing logic.
• Options and option types can also effect the user experience.
• Options and option types can make the workflow engine rerun the rules on
the most current metadata to effect the process flow.
• Options and option types can be configured to change the document status.
BDC IDs
• BDC IDs build a powerful infrastructure for pre-populating data into SAP
transactions without programming.
• BDC IDs are optimized for both dialog processing and background
processing.
• BDC IDs can be used to set dynamic parameter IDs.
• BDC IDs can be used to configure new user collaboration actions.
• BDC IDs eliminate the need to code parameterized transactions.
• BDC IDs can be used to configure BDC success messages.
Main steps The following are the main steps involved in implementing process scenarios in the
Non PO parking process:
1. Identify the various parking reasons that are required for the realization of the
process scenarios.
2. Identify the sub screen to be called during the document parking process.
3. Identify the roll out criteria.
4. Identify the various roles and configure the roles in the appropriate process
types.
5. Identify and configure the process options according to the swimlanes.
6. Configure global customization setting as per customer requirements.
The starting point for any configuration is a set of process flow swimlanes. The
following swimlane is an example of such a process as implemented by the Non PO
invoice parking workflow:
The following sections describe the main steps of the Non PO parking process
configuration:
• “Defining Rollout Criteria” on page 173
• “Configuring Parking Reasons” on page 176
• “Configuring Global Parameters” on page 181
2. In the Allowed Company Codes screen, select either both PO Invoice Process
and Non PO Invoice Process or only one of the check boxes for the respective
Company Code.
3. Click New entries to add a company code.
Save your settings when finished.
4. Double-click Allowed Document Types in the navigation panel to switch to the
Allowed Document Types screen and define the rollout criteria for document
types, as described for company codes.
The respective receiver function module triggers the workflow based on the
data in the tables. The workflow is triggered when there is no data maintained
in the table(s) or the data meets all the conditions such as company code and
document type.
Caution
If you change the configuration in this section, the Non PO parking process
might not trigger at all.
In this step, you define the valid parking reasons in the VIM Non PO parking
process.
Configuring a parking reason comprises the following actions:
• Define the parking reason.
• Define the roles that are responsible for receiving the first work item in the
process, for posting the Non PO invoice, and the initial approver.
• Define if the process triggering needs to be delayed.
• Delimit the available options for the parking reason.
Approval Required
Select this check box to achieve that the parking reason is flagged for
approval and that the Invoice Approval process is triggered.
Autopost
Select this check box to achieve that the system automatically posts the
invoice after Invoice Approval is completed.
Initial Actor
Define the role who receives the first work item once this document is
parked for the current parking reason.
Example: If a Non PO invoice is parked for “Approval Required”, the initial
role that needs to look at the invoice is the APPROVER. If the Approval
Required check box is selected, the initial role will be CODER.
Initial Actor FM
You can define a custom function module to determine the initial actor.
For the interface of the function module, see function module
/OPT/BL_Q_INIT_ACT_FM.
Delay Function
• Define the custom function module that can be used to restrict the
immediate triggering of the Non PO parking process even if the user
selected the current parking reason when the invoice is parked.
•
• For the interface of the delay function module, see function module
/OPT/BL_P_DELAYFM_SRM.
Initial Approver
Define the role of the initial approver if the invoice document is sent for
approval.
Posting Actor
Define the role responsible for posting the invoice and also responsible for
handling errors if the posting in background fails.
Available Options
Define the options that are available for the role on the dashboard during
Non PO parking process for the current parking reason. Separate the options
by semicolon. The option format is AXXXX where A is the option type and
XXXX is the 4 digit value representing the option ID.
The system uses these values in conjunction with the user process options
defined in “Configuring User Process Options” on page 179 to determine
which options show up for the role’s dashboard.
Example: If you want to show the option “Change Tax Information” only
if the Non PO invoice has taxable line items, you can define a custom
function to verify the existence of taxable line items and raise an error if
there are no taxable line items.
• If an error is raised in the function module, the option will not be
available to the user.
• For the interface of the condition function module, see function module
/OPT/BL_CONDFM_INFOPROVIDER.
Important
Take care when you change the global configuration parameters. Changes
can affect the functionality of the process.
Constant: PIRSCREEN
Usage
Subscreen number for Non PO parked invoice dashboard header
subscreen. To provide additional data on the invoice dashboard, you can
define your custom screen here.
Default Value
9901
Default value
None
Constant PSS_BIND_EXIT_FM2
Usage
This function module is used to manipulate the workflow container
during outward binding (workflow container to task container). This
manipulation facilitates the user to capture process information and
populate with additional information.
Default value
/ORS/000007_PIR_PSS_BIND_O
2. Configure the pre PSS method exit, using the following parameters:
Constant Value
This value is used to manage document data before calling the dashboard.
Default value
None
2. Configure the post PSS method exit, using the following parameters:
Constant Value
This value is used to manage document data after calling the dashboard.
Default value
None
Constant Value
Enter a function module. This function module can be used to post a
document automatically using a custom function. If the function module
configured here raises an exception, the system will however post the
document using the standard posting logic for Non PO invoice documents.
Default value
None
Interface
For the interface of the function module, see function module
/PTGWFI/PIR_F_TMP_PRE_AUTOPOST.
Interface
For the interface of the function module, see function module
/PTGWFI/BIR_F_TMP_DISP_IMG.
For the creation of a Non PO invoice, maintain the new function module
/PTGWFI/VIM_CRE_NPO_INV_PREF in table /PTGWFI/Z_CONST, using the SM30
transaction.
9.1 Overview
People involved There are several people (roles) that are involved in the IAP process. The actual
in the IAP names might be different; but the activities are the same.
process
Coder
The person who is responsible for entering accounting data. The coder can be
both a SAP user and/or a web user if Web IAP is implemented.
Goods or Service Requester (Requisitioner)
The person who requested the goods or the service.
Approver
The person who is responsible for approving the invoices. The approver can be a
SAP user or a web user if Web IAP is implemented.
AP Processor
A member of the Accounts Payable (AP) department who deals with invoices.
The roles that are part of this process are different from the standard roles described
in “Roles” on page 29. Since the functional requirements are different for IAP roles
compared to other exception processes, a separate role infrastructure is required.
Trigger for the When an invoice is parked with a parking reason that requires invoice approval, the
IAP process IAP workflow gets initiated. It is possible to delay the start of the IAP process by
first sending the invoice to the AP processor who can subsequently submit the
invoice for approval.
End of the IAP There are several activities that mark the end of the IAP process:
process
Configuration This section outlines all the aspects of implementation and configuration of the IAP
outline of the IAP component of VIM.
process
Note: You can perform most of the configurations using the VIM Customizing
IMG with the /OPT/SPRO transaction code.
To configure the IAP process, the following steps are necessary:
• Identify the approval parking reasons or process types.
• Identify any parking reason info that needs to be collected during the parking
step.
• Determine the user framework to be used. This deals with configuring or
extending the /ORS/USERMAPPING class.
• Identify the approval steps:
• Identify who is responsible for account assignment (Coder role).
• Identify approval logic:
• Who is the first approver?
• How to go up the approval chain (if needed)?
• What marks the end of approval?
• What needs to happen in case of rejections?
• Identify the account assignment screen layout and logic:
• Identify fields to be displayed.
• Identify validation requirements.
For the Non PO IAP process, the following screen serves to capture the requester
information:
If you need to capture custom logic or customer data during the parking process to
initiate the approval workflow, you have to replace the above screen with a custom
screen. For details, refer to “Configuring Parking Reasons” on page 176.
2. Configure the trigger points for the approval workflow, using the following
parameters:
BLOCKRSN
• Block Reason 9 is for PO based invoices.
• Block Reason V is for Non PO based invoices.
Start Approval Immediately
Select this check box to start the approval workflow immediately
disregarding the delay function module.
when parking the document. Sometimes, the initial approver may be entered as part
of the invoice indexing before parking the SAP document.
Notes:
• Implementation note
When you enter the first approver at the parking reason screen or indexing
screen, we recommend using the combination of last name, first name and
email address. If the combination fails to identify one user, the system may
suggest a list of matching users.
• Technical note
The initial approver is usually stored in the parking monitor table
(/PTGWFI/F_PIRMTR) and retrieved by the /ORS/APPROVER-> NEW method.
The subsequent approvers (only for Non PO invoices) are determined when the
current approver approves the invoice. The system proposes the next approver by
the predefined organizational hierarchy.
Technical note
The initial approver is usually stored in the parking monitor table
(/PTGWFI/F_PIRMTR) and retrieved by the /ORS/APPROVER-> NEXT method.
If the current approver rejects the invoice, the invoice is sent to the previous
approver. However, if the previous approver is a delegated coder, the invoice is sent
to the original approver who delegated the task. All approvers who approved the
invoice are stored in the approval stack so that in case the current approver rejects
the invoice, the system knows who the last approver was. If the first approver
rejects the invoice, the invoice is sent back to the AP department.
Technical Notes
• You can configure who receives the work item after the first approver
rejects the invoice. You perform this configuration in the parking reason
table /PTGWFI/F_PRKRSN for a non-PO invoice or /PTGWFI/M_PRKRSN for a
PO invoice.
• The approval is considered completed if one or more of the following
conditions apply:
• The current approver has sufficient authorization for the invoice
amount.
• There is no more person that is defined as the superior of the current
approver in the current approval structure.
• Other predetermined termination conditions apply, such as a
predetermined number of approvers is reached.
Description
Enter a description of the expense type.
Approval Req
Activate by typing X if the expense type requires an Invoice Approval
process.
Technical notes
• Table /ORS/APPRLEVEL has included expense type as a key field.
• Table /ORS/EXPENSE_DEC stores the description and the language and table
/ORS/EXPENSE_TYP stores Approval Req and ExpType.
Call Sequence:
/ORS/INVAP-> Get_Approver_List
/OPT/CL_IAP_USERMAP_BL-> sendemail
/PTGWFI/CP_SENDMAIL
7. Make sure that at least one additional SAP GUI session is available.
• InvoiceDate
• VendorInvoiceNumber
• Currency
• GrossInvoiceAmount
• Vendor
• VendorName
• DocumentNumber
• FiscalYear
• CompanyCode
• InvoiceAmount
Other option
Overwrite the sendemail method. See “To overwrite email sending with a
customer specific email function:” on page 205.
Important
If no text can be found for the current value of sy-langu, then no email
is sent.
Therefore the text should be maintained in all languages that are typically used
for logon.
Function /PTGWFI/CP_SENDMAIL:
2. Enter the Text name, select Text ID ST (Standard text) and click Create.
3. Enter the text of the Certify message and click to save.
4. Execute the /n/OPT/SPRO transaction and follow LiveLink VIM -
Configuration > Non PO Processing > Invoice Approval Process > Technical
General > Invoice Approval Configuration.
5. To maintain the Z constant CERTIFY_MESSAGE, double-click the respective line.
The coding field titles, like G/L Account and Cost Center, are configured using table
/ORS/GL_TITLE. See “To configure GL coding field titles:” on page 210.
You can use table /ORS/APPR_GL_CFG to determine if a field is displayed in the line
section and/or in the detail section of the coding window. Moreover, you can
determine the sequence of the fields in the coding window. See “To configure
accounting information fields for Non PO invoices:” on page 211.
This configuration table defines the coding fields. The table determines which
fields are shown and in which sequence they are shown in the coding window.
It also determines which SAP field is mapped to each coding field.
2. Double-click a line to open the Screen Config table for /ORS/000005
Development: Details screen.
This configuration table defines the coding fields for PO invoices. The table
determines which fields are shown and in which sequence they are shown in the
coding window. It also determines which SAP field is mapped to each coding
field. It is very similar to the configuration for Non PO invoices; see “To
configure accounting information fields for Non PO invoices:” on page 211.
2. Double-click a line to open the details screen for a field.
3. Configure the search help, using the following parameters (at the bottom of the
screen):
Search help name
Enter the name of the search help to be called by the web approval screen
when the user requires input help.
SearchHelpParam
Enter the name of the search help field which will actually hold the value for
the web approval screen field.
By company
Each company code has an associated coder.
Both
The coder is determined by both requester and company code.
Use requester
The coder is the requester.
The configuration is done in the CODER_DETERMING constant.
the ABAP class /ORS/USERMAPPING. You can extend this class if you need custom
logic to be incorporated.
The following sections describe user map maintenance and chart of authority
maintenance. For a detailed description, see “Maintaining Chart of Authority” on
page 223.
The following check boxes for the approver persona are available:
Approval Flag
Select this check box always.
Coding Flag
Select this check box to achieve that the approver is able to enter accounting
data.
You might want to remove the following buttons from the Approve Invoice
screen, both in the SAP GUI and in the Approval Portal:
• I will enter accounting information
• I want someone else to enter accounting information
The Approve Invoice screen will display the accounting information
immediately.
To perform this configuration, select the Approval Flag and the Coding Flag,
and clear the Coding Delegate check box.
Coding Display
Select this check box to achieve that the coding block is displayed.
If Coding Flag is selected, the coding block is always displayed in change mode.
If Coding Flag is cleared, you can use the Coding Display check box to display
or hide the complete coding block.
Coding Delegate
Select this check box to achieve that the approver is able to delegate the coding to
others.
If Coding Delegate is selected and, additionally, Coding Flag or Coding
Display is selected, the buttons I will enter accounting information and I want
someone else to enter accounting information are displayed.
If only Coding Delegate is selected (and no Coding Flag or Coding Display
check box), the buttons are not displayed. In the approval screen, you can
delegate the coding. The Please Specify the Coder field is displayed directly.
Configuration
Select this check box to achieve that the approver can set the persona for the next
approver.
Override
Select this check box to achieve that the approver can override the system
generated next approver.
Look Ahead
Select this check box to achieve that the approver is able to retrieve all the
approvers.
Custom Flag 1
Select this check box to indicate the expense type as read only.
Custom Flag 2
Select this check box to indicate the approver as a delegated coder.
Custom Flag 3
Not used
9.5.2.6 Override/Delegation/Substitution
Because of the compliance implication of the IAP process, Invoice Approval needs
to guarantee that only the designated approver approves the invoice. However,
there are situations that require others to take over the responsibility temporarily,
for example, unexpected termination, illness, vacation, etc. VIM Invoice Approval
provides the following mechanisms and utilities to address these situations:
The log event is written to the approval log file /ORS/APPL_LOG, whenever the
invoice is approved and an override approver has been entered.
The event is shown in the approval log:
The entry does not show directly who executed the override action. To find this
out, look at the corresponding action entry, which has the same time stamp.
Coding delegation
If the current coder/approver does not have all the knowledge to provide the
correct coding, the current coder/approver may delegate to another coder. To do
so, the approver persona needs to have the CODING_DELEGATE check box
selected.
Substitution
The approver or coder can set up personal substitutes to temporarily take over
their responsibility. The substitute can be defined by one of the following ways:
• If the optional Web IAP is implemented: From the approval web page, open
the User Preference page and open the Substitution section.
• From the SAP inbox, add substitute from the SAP menu.
Note: This is only available when both substituted and substituting
users are SAP users.
• From User Substitute Management Utility (/ORS/MAIN_SUBS transaction).
This transaction can maintain all the substitute relations in the system.
Note: Only an administrator can execute the substitution.
Notes:
• When a substitute is set up, the substitute will assume all the authority
of the original approver regarding the invoices belonging to the original
approver. The authority of the substitute is not considered.
• The invoices belonging to the original approver will be added to the
substitute's invoice list.
• When the substitute approves an invoice that is not originally sent to the
substitute, the action will be logged as XXX approves the invoice on
behalf of YYY.
Prerequisites
• The Org Units allowed in the Invoice Approval process are maintained. You can
maintain the Org Units in the SM30 transaction for table/view /OPT/BL_T401V.
• The fields required for approval user data are maintained. You can maintain the
fields in the SM30 transaction for table/view /OPT/BL_T402V.
Access You can access COA maintenance using transaction code /OPT/VIM_7CX1.
Alternatively follow OpenText LiveLink VIM Menu > SAP menu > Roles >
Invoice Approvals -> Chart of Authority Maintenance.
The default access to COA is in display mode. Use the Display/Change button to
switch to maintenance mode.
The following views are available:
• “User Details View” on page 224
• “COA Details View” on page 228
• “Coder Details View” on page 229
• “Logging with Change Documents” on page 231
• R-Reject
• N-None
Last Name
User’s last name
First Name
User’s first name
Middle Name
User’s middle name (optional)
Department
User's department (optional)
Windows Domain
If implementing optional Approval Portal with WAS authentication scenario:
Windows domain. Required if COA uses Approval Portal with WAS
authentication scenario and users are authenticated using Windows domain.
Windows_ID
If implementing optional Approval Portal with WAS authentication scenario:
Windows ID or the login ID. Required if COA uses Approval Portal with WAS
authentication scenario and users are authenticated using Windows domain.
Personnel number
Personnel number of the user
SAP User ID
SAP User ID of the user
SAP Portal User ID
If implementing optional Approval Portal with Portal authentication scenario,
this will be the login ID for the user in the portal.
Email Address
User's email address. Identifying field for all COA users (approvers). This field
cannot be duplicated with existing users.
Name and address
Name, other form of user's address (optional)
Telephone number
User's telephone number
In the User Details View screen, you can perform the following actions:
Show History
Select this check box to automatically open the History section in the
Approve Invoice screen.
Clear this check box to display only the History link in the Approve Invoice
screen.
Default Coder
Enter the default coder that you want to do the coding.
Invoice List Field
Enter the sequence of list fields.
Mobile List Field
Only relevant for Mobile Integration: Enter columns that should be
displayed in the inbox of the mobile App.
Max. Recent List
Enter how many names should be displayed in the drop-down list for
previously selected persons.
E Notify Active
Select this check box to receive an email notification regarding any invoice
that requires your attention.
Invoice per Page
Enter the number of invoices to be displayed in the Invoice List and the
Processed Invoice List.
Language
Also relevant for Mobile Integration: Enter the default language.
Date format
Also relevant for Mobile Integration: Enter the date format. Click for a list
of possible formats.
Dec.pt.format
Also relevant for Mobile Integration: Enter the format of the decimal
notation. Click for a list of possible formats.
Currency
Enter the default currency.
Show Attachment
This check box is not relevant. Users can always use the attachment function,
regardless of the Show Attachment check box.
Display Type
Determine where the invoice image should be displayed when opening the
detail page. Click for a selection.
Logical system
Enter the SAP system that you want to use as the user preference for your
Invoice List page.
Time Zone
Also relevant for Mobile Integration (as the time zone in Approval log):
Enter the default time zone for the user. Click for a selection.
4. Click Save and Continue.
WBS Element
The WBS element that the user is authorized to approve.
Note: One user cannot have different approval limits for the same combination
of org units in the same currency. However the user can have different
approval limits in different currencies for the same combination of org units.
In the COA Details View, you can perform the following action:
Constant
CODER_DETERMING
Description
Constant Coder Details View
Value
S Use Requestor. The Coder Details View is not visible. The system
will return a message.
R By requestor ID. The Requestor field is available along with Coder,
Counter, and Default fields for displaying/editing.
C By company code. The Company Code field is available along with
Coder, Counter, and Default fields for displaying/editing.
B By both requestor ID and company code. Both Company Code and
Requestor fields are available along with Coder, Counter, and De-
fault fields for displaying/editing.
from/to
Enter a dedicated period.
Name
Select the user.
User Mapping Object ID
Enter the change object.
Table Name
Enter /ORS/USERMAP or /OPT/BL_APPCOA.
Click to open the change document.
The change document displays all relevant information about the last changes in a
list view with the changed values and the user who changed the data.
Table /ORS/USERMAP:
• MIDDLENAME
• DEPARTMENT
• WINDOWS_DOMAIN
• SAP_USER_ID
• OTHER_ID
• PHONE
Table /OPT/BL_APPCOA:
• COUNTER
7. Test /ORS/COMPANY_CODE.
5. In Defined filters, select ZCOMPANY_CODE from the drop down list and save.
Internal Order
/ORS/CL_IM_INTERNAL_ORDER
Item Text
/ORS/CL_IM_ITEM_TEXT
Material
/ORS/CL_IM_MATERIAL
Plant
/ORS/CL_IM_PLANT
Profit center
/ORS/CL_IM_PROFIT_CENTER
Tax Code
/ORS/CL_IM_TAX_CODE
Trading Partner
/ORS/CL_IM_TRADING_PARTNER
Unit
/ORS/CL_IM_UNIT
Valuation Type
/ORS/CL_IM_VALUATION_TYPE
WBS Element
/ORS/CL_IM_WBS_ELEMENT
WARNING
The system issues a warning message.
This setting allows in some cases that the coding is not completed, but the
information is entered in the special handling instruction section.
Note: The validation happens in the VALIDATEACCTDATA method of the Non
PO invoice class.
0;1
Rejection comments are mandatory.
1;1
Both rejection reason and rejection comments are mandatory.
The default value is 0;1.
2. This function module will in turn call a configurable function module that is
defined in OpenText /PTGWFI/Z_CONST table. The data that is passed to this
pluggable module is:
• Invoice object type
• Invoice object key
3. The output of the function module is a table of URLs if using URL (in most cases
there will be only one URL that is returned) or the binary data if using JPEG.
The web application will open a browser window.
4. The OpenText delivered base function module for opening the browser window
is the following:
FUNCTION /ORS/000007_TMP_IMAGE_DISP_URL and /ORS/-
000007_TMP_IMAGE_DISP_JPEG
5. In the OpenText delivered base function module, the standard SAP function
module ARCHIVELINK_URL_GENERATE is called with the appropriate information
(Archive ID and Archive_Document_ID).
6. If the archiving system is setup as an http Content Server, the standard SAP
function module will generate the appropriate URL which can be used to
display the image in a browser window.
7. It is possible to replace the function module ARCHIVELINK_URL_GENERATE with a
Z-function module and incorporate any logic as deemed fit based on customer
requirements.
Important
Take care when you change the global customization parameters. Changes
can affect the functionality of the process.
2. Define the resubmit for approval action codes, using the following parameter:
Constant Value
Maintain action codes, separated by comma.
If you want to enable the functionality to submit for approval again after a DP based
approval has been rejected, perform the following steps:
3. Configure the DP process option, as shown in the screenshot above. For further
information, see “Configuring DP Process Options” on page 70.
4. Make sure the same DP process option (as above) is maintained also in the Z
constant Entries table, see screenshot below.
The DP process option should be configured as user option for the Approval
related Process Type.
2. Define the custom invoice class (exit), using the following parameter:
Constant Value
Define the custom invoice class. This class must be a subtype of
/ORS/NON_PO_INVOICE.
2. Define the supported currency and language, using the following parameters:
Constant LANGUAGE
Determines which languages are supported in invoice processing. You can
maintain multiple languages by using a comma as separator.
Default Value: E,D
Constant SUPPORTED_CURRENCY
Determines which currencies are supported in invoice processing. You can
maintain multiple currencies by using a comma as separator.
Default Value: USD,DEM
1 (default)
/ORS/7_2_APB
2
SAP HR
With VIM 5.2 SP3 and higher, you also can add custom buttons to the invoice list
page of the Approval Portal. For these buttons, you must select Button Type List.
Coder
The button is available only to those users whose user attributes contain
CODING = X or CODING_DELEGATE = X.
Everyone
The button is available to all users.
Handling Function
The Handling Function determines the RFC function that is called when the
user clicks the button in the approval screen or the Approval Portal.
Enter the function module to handle the button. Create a custom function
module by copying the sample function module /OPT/BUTTON_FM.
For buttons on the invoice list page of the Approval Portal (Button Type
List), use the sample function module /OPT/BUTTON_FM_LIST. You can use
the handling function module to call a dynamic URL.
URL
Enter the static URL to be displayed after the button is clicked.
URL Function
Enter the function module to get the URL dynamically. Create a custom
function module by copying the sample function module
/OPT/BUTTON_URL_FM.
Note: This field is not relevant for buttons on the invoice list page
(Button Type List).
The custom fields available for configuration are highlighted in the following
screenshot. You can access this screen by executing the SE11 transaction and
displaying the Database table /ORS/INV_DATA.
You can configure these fields separately for PO and Non PO invoices, applicable to
both DP as well as parked invoices.
• Required
• Hide
• Display only
Table no.
Enter a numeral to indicate the sequence of the custom field in the web
approval screen.
Search help name
Enter the name of the search help for the custom field.
4. Change the field label of the custom fields in the Medium column in the
required languages.
5. Save your settings.
The “referrer” is the user who has sent the approval invoice to another user (referee)
for more information on the invoice.
The “referee” is the user who provides additional information on the approval
invoice.
Automated VIM 6.0 SP3 (and also VIM 5.2 SP8) also introduce automated coding. In
coding combination with the automatic processing of the posted approval, the coding step
can be completely skipped.
Configuration The whole configuration for the posted approval is integrated in the VIM
aspects Customizing IMG tree: Follow LiveLink VIM - Configuration > Non PO
Processing > Invoice Approval Process > Approval Workflow.
To configure the posted approval process, the following steps are necessary:
1. Configure posted approval settings (mandatory)
2. Configure event linkage for posted approval trigger (mandatory)
3. Define dynamic determination for the auto processing:
Note: This step is optional: If you configure to use the determination for
the automatic posted approval activation type, then you have to process
this step. If you activate it always or by custom function module, you do
not need to process this customizing.
• Define determination fields
• Define determination data
3. Configure the Posted Approval Settings (PAS), using the following parameters:
Process Type
Baseline delivers the process type 149 for PO documents and the process
type 249 for Non PO documents. A posted document that is rejected in the
approval process will be processed within the DP workflow with this
process type. For this process type, baseline delivers the following process
options:
2020
Re-Submit for Approval
2021
Submit for one step Approval
2022
Remove payment block and complete DP
2023
Keep payment block and complete DP
Automatic processing
For Non PO documents
In the DP process, a document can be submitted for approval (manually
or automatically with exception “Approval required”). In this case, the
automatic processing defines that the DP or parked approval process
terminates after the requester step. The document will be posted with the
configured payment block.
When the coding happens in background with auto coding (see
“Configuring Auto Coding” on page 269), also the coding step can be
skipped and the document will be posted directly.
For PO documents
The automatic processing defines that the document is posted
automatically with the configured payment block.
Activation type
• Inactive: Automatic processing is deactivated.
Constant Value
Enter Constant Values for payment blocks: Possible payment blocks for
which the posted approval is relevant to be triggered. Maintain the
standard Payment blocks of table T008. Separate them by comma.
Exit confirmation
Integrate an own logic for the posted approval to keep the DP process
alive according to your start conditions. All other configurations to keep
the process alive according to the manual or automatic blocking are not
taken into account (maintained within /OPT/AT_PAS). Only the own logic
within the exit function is used. The interface of the exit function has to
be compatible with the function /OPT/AAFS_SAMPLE_EXIT_CONFIRM.
Object Type
/ORS/INVAP
Event
POSTED
Linkage Activated
Selected
Enable Event Queue
Selected.
You must maintain the event queuing and configure a job (transaction SWEQADM).
Non PO For Non PO documents, the event is raised in the BTE exit 1050 and exit 1030
within exit function /OPT/BTE_IF_00001050 and /OPT/BTE_IF_00001030. The
corresponding BTE has to be activated. Check transaction FIBF > Settings > P/S
Modules -> …of a partner.
Field Name
Select the corresponding field of the /OPT/VIM_1HEAD or /OPT/VIM_1ITEM
table.
Sequence
Define the processing sequence of the determination.
Search Help Name
Configure the search help that will be used in the data determination
configuration.
Allow Ranges
Select this check box to allow ranges in the data determination configuration.
To integrate a process type, follow the customizing steps in “Defining the Process
Type” on page 89.
The process type needs the following settings:
• No exception
• No user process options
• Autopost flag activated
• Bypass and simulate deactivated
• Process type determination sequence before Approval Required process option
• Sequence step function module /OPT/VIM_DETERMINE_PROC_LIB003
The following screenshots show example settings of the process type:
Process Type Definition (no other settings relevant); see also “Defining the Process
Type” on page 89:
Index Screen Options (no other settings relevant): see also “Configuring Index
Screen Options” on page 51:
Process Type Determination Sequence (no other settings relevant); see also
“Defining the Process Type Determination Sequence” on page 53
In this example, all data is collected from the own system D94CLNT800 and from
system T90CLNT810, using an RFC call.
2. Double-click a line.
In Constant Value, enter the fields that should be displayed in the mobile App. You
find the possible fields in structure /ORS/INV_LIST_FIELDS. The sorting of the
fields corresponds to the display in the mobile App’s invoice list.
To display the fields in the mobile App, you must translate them into the
corresponding languages; see “Configuring Invoice List Fields” on page 280.
In the Chart of Authority, in the user preferences (see “User Details View” on
page 224) you can perform some configuration that is relevant for the mobile App:
Execute the /N/OPT/SPRO transaction and follow the menu path LiveLink VIM -
Configuration > Non PO Processing -> Invoice Approval Process -> Mobile
Integration > Mobile Inbox Fields > Maintain Invoice List Fields.
In the Medium column, enter translations for the fields in the language specified in
the Language column.
PO header fields
Execute the /N/OPT/SPRO transaction and follow the menu path LiveLink
VIM - Configuration > Non PO Processing -> Invoice Approval Process ->
Mobile Integration > Mobile Header Fields > Maintain PO Header Fields.
GL header fields
Execute the /N/OPT/SPRO transaction and follow the menu path LiveLink
VIM - Configuration > Non PO Processing -> Invoice Approval Process ->
Mobile Integration > Mobile Header Fields > Maintain GL Header Fields.
2. Double-click a line.
The screenshot shows the customizing screen for PO header fields. For GL
header fields, only the heading of the screen differs.
For the mobile integration, only the Mobile area is relevant. In the SAP / Portal
area, only set the Field Status to Hide. Thus, you prevent the field from being
additionally displayed inside SAP or the Approval Portal.
The field names have to match the fields of structure /ORS/INVOICE_HDR.
3. Configure the field.
To activate the field for the mobile App, select Active MobileApp.
To change the sequence of fields in the mobile App, enter a digit in Sequence
MobileApp. The fields are displayed on the detail screen in the header field
section following this order, from top to bottom.
The screenshot shows the customizing screen for GL item fields. For PO item
fields, the screen differs only slightly.
For the mobile integration, only the Mobile area is relevant. In the SAP / Portal
area, only the BAPI Field name is used. It matches for the label translation.
The BAPI field names must match the field names of structure
/ORS/PO_LINE_ITEM (for PO items fields) and /ors/invoice_acct_data (for
GL item fields).
3. Configure the field.
To activate the field for the mobile App, select Active MobileApp.
To change the sequence of fields in the mobile App, enter a digit in Sequence
MobileApp. The columns for the line item information on the detail screen are
displayed following this order, from top to bottom.
Execute the /N/OPT/SPRO transaction and follow the menu path LiveLink VIM -
Configuration > Non PO Processing -> Invoice Approval Process -> Mobile
Integration > Mobile Item Fields > Maintain Item Labels.
The customizing is the same as in “Configuring Invoice List Fields” on page 280,
except that you translate item fields, here.
Important
KPI Dashboard data is based on the VIM logging infrastructure, which is a
completely new but just internally used technical VIM component. The first
KPI Dashboard version introduced with VIM 6.0 SP3 has no functionality to
show VIM related data that has been created before the KPI Dashboard BC
Set has been activated.
Control panel
The control panel is located on the very left of the screen and stays the same for
all 3 graphic screens. The control panel covers filter related selection criteria like
time range, company code group, and input channel.
Display Category
For the second half of the actual screens, the Display Category list is available.
You can select the following categories to be displayed in the second half of the
respective screen:
• PO/Non-PO Invoices
• Amount Classes
• Vendor Groups
The categories Amount Classes and Vendor Groups are customer specific. You
must customize them before using the KPI Dashboard.
Screen - KPI Group Volume and Amounts
The first half of the screen shows the number and amount of invoices processed
and aggregated by the input channels like ICC, EDI, or other.
The second half of the screen shows the category, which by default is “purchase
order based”, “non purchase order based”, or “unclassified”. It can be either
switched to amount class category or to vendor group category.
Screen - KPI Group Exceptions
The Exceptions screen bases on a customer specific mapping of VIM exceptions
to KPI exception classes.
The first half of the screen shows the following:
• number of occurrences of exception classes
• percentage of invoices that belong to an exception class that contains
customer specific “allowed exceptions” and that are therefore considered to
be exception free
The second half of the screen shows the categorized data for the most important
exception class (Exception Class 1).
Screen - KPI Group Processing and Approval Time
The first half of the screen shows the number of invoices processed or approved
in a certain customer specific time frame (“on time”, “almost on time”, or
“delayed”).
The second half of the screen shows the categorized data for delayed invoices.
Export to Excel
You can export the KPI Dashboard data to an Excel sheet by clicking this link.
Help
You can use the content of the current section to provide a customized help for
your end users. See “KPI Dashboard Help URL” on page 314.
Info
You can view additional information by clicking this link.
Amount
What is the total amount of invoices with end timestamp in the current
period (month) that have been processed
Definitions for KPI3: Number of Occurrences of Exception Classes
Exception
VIM invoice exception in the sense of “process step that requires manual
interference”
All exceptions of an invoice in the VIM process are collected and classified.
The corresponding exception classes are displayed in the period (month) in
which the invoice has the VIM end timestamp.
Exception Class
Group of invoice exceptions defined in the KPI customizing
Definitions for KPI4: Exceptions Free Rate
Exception Free
Some process steps requiring manual interference are considered to be “no
real exception”; therefore they are “exception free”. The exception free rate
reflects the rate of “no real exceptions” and the completely exception free rate
in comparison with the rate of “real exceptions”.
All exceptions of an invoice in the VIM process are collected, classified, and
taken into account for the exception free rate in the period (month) in which
the invoice has the VIM end timestamp.
Definitions for KPI5: Number of Invoices Processed with Delay
Invoices processed with delay
Invoices where the VIM end timestamp is in the current period (month) and
the processing number of days between start and end process timestamp is
greater than a certain threshold value for delay (see “Time Groups” on
page 305)
Definitions for KPI6: Number of Invoices Approved with Delay
Invoices approved with delay
Invoices where the VIM end timestamp is in the current period (month) and
the approval duration is greater than a certain threshold value for delay (see
“Time Groups” on page 305)
Level 1a
The VIM logging continuously writes data to special Log Tables and Index Data
Tables in the Central System and the Satellite Systems (if involved). The
activation of the KPI Dashboard BC set starts the logging mechanism.
Level 1b
The KPI Data Collection assembles document and exception data from the
logging and saves them in the KPI Source Tables. A periodic collection job is
required on each involved system to fill the KPI Source Tables.
Level 2
The KPI Aggregation selects data from the KPI Source Tables (in different logical
systems if required), aggregates the data, transforms it and saves the data in the
KPI Target Tables. A periodic aggregation job is required only in the Central
System (or Single System) to fill the KPI Target Tables.
Level 3
The Web Dynpro uses the KPI Target Tables for visualization in the Web
Frontend.
KPI Source Tables and KPI Target Tables can always be refilled from the logging
tables.
Manual Run
Run frequency
Ad hoc / on demand
Business background
Ad hoc reporting / short term KPI analysis for a certain period of time
Execution
Manually in dialog or background
Parameter settings
• Process start date from (required)
• Process start date to (optional)
• Delta mode check box cleared
If you want to load just a special period of time for the KPI Dashboard, you can use
the KPI collection report on demand manually. All processes which have been
started and also finished within the chosen process start interval are included in the
resulting collection output and stored to the KPI source data tables. From there, the
KPI aggregation report picks up the data and writes it to the KPI target data tables
as data basis for the Web Frontend.
To run the KPI collection report in test mode, select Test mode. This setting will
display the collected data in an ALV grid before saving the result to the database.
Important
When using this ad hoc type of KPI data supply, you must completely clear
the KPI source and target data tables before. Otherwise, reloading just a
special period of time could probably result in inconsistent overall results
and interrupt the regular delta collection runs in a significant way.
Therefore, the following steps are required to fulfill short term ad hoc KPI
reporting requirements whenever needed:
3. Collect KPI source data for the required special time period using the
KPI collection report /OPT/VR_KPI_COLLECTION
4. Aggregate the collected KPI source data and write it to the KPI target
data tables using the report /OPT/VR_A_AGGREGATION using aggregation
group KPI.
Configure the collection program as a job with a variant for the processing option
Delta mode.
When running the KPI collection in the regular delta mode, the report picks up all
processes which have been started and also finished after the last delta run. The
report stores the result to the KPI source data tables. From there, the KPI
aggregation report picks up the data that has been collected after the last
aggregation run and writes it to the KPI target data tables as data basis for the Web
Frontend.
The following steps are required to fulfill ongoing KPI reporting requirements:
strongly recommends activating the delivered BC Set instead of doing the single
activities manually.
Back end systems
Maintain the character set for logical systems. See section 18.1 "Maintaining
Logical Systems for the Aggregation Report" in OpenText Vendor Invoice
Management - Administration Guide (VIM-AGD).
Aggregation report groups
Enter KPI as an aggregation report group (ID and description).
Note: For best performance, OpenText recommends that you select only the
Init source table check box for all KPI entries.
The check boxes may not be combined!
Maintain KPI Settings
Make the KPI related sub function modules available in Maintain KPI Settings.
Execute the /n/OPT/SPRO transaction and follow LiveLink VIM - Configuration
> Central Reporting > KPI Dashboard > Maintain KPI Settings.
To prevent overlapping jobs, the aggregation job should run daily well after the
collection report.
Dashboard Currency
Which currency should be used to show invoice amounts on the Web Frontend?
Amount Classes
What is considered to be the range for small / medium / big?
Exception Class Mapping
Which Dashboard exception classes should be used? How should the VIM
exceptions be mapped to the classes?
Company Code Authority Check
Should the display of Dashboard data be limited to the SAP user access rights for
company codes (standard delivery)? Or should every Dashboard user see all
data? If the authority check is active, different users see different data.
Currency Conversion Date
Which conversion date should be used to convert foreign currency invoices: the
system date of the monthly aggregation run? Or the posting date of the
document? Or a fix date in the current year? If a fix date, which one (1st of
January)?
Filter Start Period
Which month-year is the earliest that can be selected in the Dashboard Filter
Time Range From? Be aware that only data is available for display for which the
VIM process has started after introducing the KPI Dashboard on the SAP system.
Grouping A lot of customizing has to do with the grouping of data. The KPI Dashboard is not
the right tool to display a large range of values; for example, to show 20 different
company codes. The KPI Dashboard rather shows grouped data like company code
groups or vendor groups.
2. Create groups with a 4 character grouping ID and two descriptive fields (long,
short). Fill both description fields.
Note: Do not use special characters for the Short Description.
If you have between 1 and 20 different company codes that are relevant for the
KPI dashboard, enter each company code as a company code group and fill the
description fields.
It is also possible to mix new company code groups with company code groups
that are identical with existing company codes.
The Flg: Disp. check box is for future use. It is not relevant now.
Important
If one company code is mapped to different company code groups, the
data displayed on the dashboard is not disjoint.
Important
Do not change the time groups.
• Delayed
Note: The text symbols &1 and &2 in the Short Description will be replaced
during runtime with the Days from and Days to values.
Time Group 1 represents processing time:
Enter the maximum number of days for time group 1 and time type On time
(representing the invoices processed on time). In the example, all invoices with a
processing time less or equal 5 days are considered to be on time.
Enter the maximum number of days for time group 1 and time type Acceptable
(representing the invoices processed almost on time). In the example, all invoices
with a processing time more than 6 and less or equal 15 days are considered to be
almost on time.
Enter the minimum number of days for time group 1 and time type Delayed
(representing the invoices with delayed processing). In the example, all invoices
with a processing time more than or equal 16 days are considered to be delayed.
Time Group 2 represents approval time:
Enter the maximum number of days for time group 2 and time type On time
(representing the invoices approved on time). In the example, all invoices with an
approval time less or equal 2 days are considered to be on time.
Enter the maximum number of days for time group 2 and time type Acceptable
(representing the invoices approved almost on time). In the example, all invoices
with an approval time more than 2 and less or equal 4 days are considered to be
almost on time.
Enter the minimum number of days for time group 2 and time type Delayed
(representing the invoices with delayed approval). In the example, all invoices with
an approval time more than or equal 5 days are considered to be delayed.
In the VIM Customizing IMG (see “Customizing Menu” on page 302), open
Maintain KPI Constants, constant KPI_VENDOR_CLASS.
<Empty>
Use SAP standard LFM1 mapping (continue with next section)
X
Use KPI Dashboard specific mapping
If you want to use a KPI specific vendor grouping, set the constant value to X,
and fill the vendor mapping table, as shown in the following.
In the VIM Customizing IMG (see “Customizing Menu” on page 302), open
Vendor Mapping.
The text symbols &1 and &2 will be replaced during runtime with the From amount
and To amount values for the amount classes.
In the VIM Customizing IMG (see “Customizing Menu” on page 302), open
Maintain KPIs.
Check whether the following entries with Aggregation Group ID KPI and KPI
Group 1 are available:
• /OPT/KAGR_SUB_KPI1
• /OPT/KAGR_SUB_KPI2
• /OPT/KAGR_SUB_KPI3_TO_4
• /OPT/KAGR_SUB_KPI5_TO_6
If they are not available, add them.
The constant DASHBOARD_HELP_URL contains the link to the KPI Dashboard Help
page. Store the help file in the SAP mime repository and use the whole directory
structure in the URL link.
If the field is empty, the help link is not shown on the web page.
Example:
http://op60vimd89.optura.local:8000/sap/bc/webdynpro/opt/vim_kpi_main
If the application uses secure http (https) for communication, apply changes as
described in “Secure Connection” on page 325.
Enter the currency in which the amount of all invoices should be displayed. This is a
central constant also used during aggregation.
Important
It is absolutely necessary to enter the value with the YYYYMM notation.
Example: If the year is 2011, and the month is October; enter 201110
<Empty>
The standard SAP vendor grouping of table LFM1 is used.
X
You have to fill the KPI specific customizing vendor mapping. See “Mapping
Vendor Groups” on page 307.
SAP-CLIENT
Enter the client number of the SAP system where the KPI Dashboard has been
installed and activated.
SAP-EP-THEMEROOT
Enter the path from where the theme of the Web Dynpro application is taken (to
use MIME objects, such as pictures and style sheets for visualization). You can
change the parameter for using custom CI-style guides. Default value: OpenText
SAP-LANGUAGE
Only EN, DE, and FR are allowed at the moment.
SAP-SYSTEM-LOGIN-BASIC_AUTH
If you have sap-system-login-basic_auth=X in the URL, a session cookie is
created. That is the reason why you can still load the application without re-
authentication. If you have the IE Developer Toolbar, you can clear session
cookies and try again. It will ask for credentials then.
SHOW_BANNER
Enter Y to show banner images (default setting). To deactivate banners, set the
value to N.
Time Range TO
Current month/year
Company Code Group
All
Channel
All
With the user parameter /OPT/VIM_KPI_MONTHS, you can set the KPI Dashboard
Time Range filter From. The value entered represents the number of months that
the KPI Dashboard goes into the past to collect data. The value must be a number
between 1 and 12. Other values are not allowed.
For users without this user parameter, the default value of 8 months is used.
Note: The KPI constant FILTER_START_PERIOD can be set to date that is higher
than the time range calculated as current month/year minus user specific
number of months. In this case, the value FILTER_START_PERIOD is used for
the initial display.
Example: FILTER_START_PERIOD is 201106 and the calculated Time Range FROM
value would be 201103. In this case, the initial display uses 201106.
Make sure that all relevant VIM import channels that you want to see in the KPI
Dashboard are included in the table.
Prerequisites
There are specific OpenText name spaces that have to be modifiable in order to
change the service settings. So first check with transaction SE03
Follow Transport Organizer Tool > Administration > Set System Change Option
Make sure, the Open Text Name space / Prefix /OPT and /ORS are set to
Modifiable. After you have finished the customizing of services, change back the
settings.
Error Handling
You can customize a few default pages for error handling in the Web Dynpro
service.
Error pages are shown for defined reasons; for example, if the timeout is reached for
the web session. The default setting is to show SAP standard error pages.
You can change these settings for the following use cases:
• Logon Errors
• Application Errors
• Logoff Page
• Not Accessible
Do not change the service settings described in “SAP Web Dynpro Settings” on
page 320. Make sure that the SSL settings are not activated in the Logon Data tab.
SAP system (SAP R3, CRM, BW) used to retrieve data into portal iViews. If not
existing, you must create a System Object in the NetWeaver Portal.
12.7.1 Prerequisites
This example shows the customizing for the connection to a specific ABAP system.
4. ITS settings
ITS settings are maintained for displaying SAP transactions in the portal as an
iView.
In the Display drop down list, select Object, and then, in the Property
Category drop down list, select Internet Transaction Server (ITS).
Provide ITS properties as shown in the following screenshot.
The property values to enter can be read from the ABAP system using
transactions SICF and SMICM.
For a detailed description how to set up the System Object in the Portal, see
http://wiki.sdn.sap.com/wiki/display/EP/How+to+Create+System+Object+i
n+the+Portal+for+Connecting+to+SAP+backend+System.
Check also other properties for design or layout, and customize them if needed.
4. To test the newly generated iView object, click the Preview button. If everything
is customized correctly, a separate window opens and shows the KPI
Dashboard content in the iView.
If a user has problems downloading the KPI data from the Dashboard to Excel,
change the browser’s internet security settings in the Downloads sub tree as shown
in the following screenshot:
12.8.4 Authorizations
The access to the KPI Dashboard is limited to users that have a SAP user on the
central SAP system.
The OpenText standard delivery restricts the user to see only the company code
data that he is authorized to access. The filter Company Code Group displays only
groups that contain at least one authorized company code. So, the ALL filter in
Company Code Group contains only the company code groups that the user is
authorized to access.
You can abolish this restriction and change the setting to: All users can see all
company code data. Therefore, change the value for constant DO_NOT_CHECK_BUKRS
to X. For details, see “Company Code Authority Check” on page 316.
Important
If the company code check for authorization is running, and different users
have different company code authorizations, they will see different KPI
Dashboard filters and data.
Adding a user item to the selection screen comprises the following steps:
• “Creating a User Program with Selection Screen” on page 335
• “Adding Selection Screen Items” on page 335
• “Updating Table /PTGWFI/Z_CONST” on page 335
• “Getting User Selection Screen Values” on page 335
These items can be any valid selection screen items. Any number of item lines
can be added but if the line number is larger than 4, a scroll bar will be
displayed.
3. Delete statements select-options: po_num for /opt/vim_hd_po-po_doc_num
and select-options: ref_num for /opt/vim_hd_po-REF_DOC_NUM.
**************************************************
**************************************************
* DATA
**************************************************
data: Ti_seltab TYPE RSTI_T_PAR.
**************************************************
* PROCESS
**************************************************
* GET SELECTION SCREEN FROM USER EXTENSION
Adding or changing document view and workflow view fields comprises the
following steps:
• “Adding Fields to /OPT/VIM_DISPLAY_STRUCTURE” on page 337
• “Creating a Subclass for /OPT/VIM_RPT_CALL_USER_EXTEN” on page 338
• “Redefining Method USER_PROCESS in the Created Subclass” on page 338
• “Updating Table /PTGWFI/Z_CONST” on page 339
2. Find appending structure name using Goto > Append Structure (OpenText
default: ZAVIM_DISPLAY_STRUCTURE).
3. Click the Continue button, the appending structure will be displayed on the
screen. If this structure has not been created, add all information to activate it.
4. Add the customer fields you want to add into the structure fields and give
related data elements. The data element will give the field label, for example the
column heading. You have to create data elements for the fields with labels you
want to show in the views.
5. Save the appending structure and put it into a transport request.
method USER_PROCESS.
endmethod.
Adding a function button to the ALV toolbar comprises the following steps:
• “Adding a Function to Table /OPT/VIM_FCODE” on page 340
• “Creating the Processing Function Module” on page 341
Quickinfo
Enter quick reference text.
Icon name
Enter icon name.
FM name
Enter processing function module.
Important
Keep all interface unchanged. Any change will cause a system dump.
• DOC_NUM
• FISCAL_YEAR
In the following sub step, you configure the information that will show up in the
notification for the user.
2. Define the users that are excluded from receiving notification, using the
following parameter:
User Type
Select the user type: OpenText User ID or manually maintained user ID.
User Id
Enter the user ID.
The result for that role shows the message “No users resolved for this role”.
4. Click the Role-User Administration button to open the Role - User
Administration screen.
6. In the New Values panel, enter Agent Type and Agent Id. Click to submit
changes.
The newly assigned users are displayed in the Role - User Administration
screen.
2. Enter the task ID (TS00275257 in the example) and press the ENTER key.
15.1 Introduction
Globalization, mergers and acquisitions, increased competition, emerging markets,
new compliance laws, and new technologies all present enormous challenges to
business as they strive for market leadership and increased shareholder value. A
constant cycle of changes demands prompt innovations and requires management
to continuously reallocate their resources and reorganize the way they drive
business.
A global company must adapt to the local conditions in the countries where it does
business. The ability to comply with laws and regulations and respond to business
requirements can have a direct impact on its globalization success.
With respect to invoice processing, there are various business and regulatory rules
that need to be complied that differ from region to region. VIM provides a flexible
infrastructure for implementing these rules that empowers the customers to fine
tune these rules to be in line with their interpretation of legal rules and for
optimizing their business processes.
There are two main types of rules that need to be implemented:
Completeness check rules
These rules are based on the regulatory requirements that stipulate the need to
have specific pieces of information on the invoice before the invoice can be paid.
Tax related
Specific pieces of information relating to Value Added Tax (VAT) and other
taxation rules that need to be followed. SAP ERP implements the various tax
rules in the standard software and has a flexible infrastructure to link with tax
software like Vortex and Taxware. VIM by itself does not duplicate any of these
pieces of functionality. VIM provides a way to implement certain metadata
based business rules that can be implemented before the invoice data is entered
in to the SAP ERP transactions.
VIM realizes these requirements with the following:
Core infrastructure
Infrastructure that supports the ability to model and realize different business
process flows depending on the country specific rules.
Baseline content
Out-of-box content that includes common implementation of business rules
specific to the various regions.
Triangulation
Invoices raised by vendors in the EU to companies in the EU for a delivery of
goods or services originating in another EU country. In this case, both the vendor
and the company are in different EU countries. Applicable to EU countries, only.
Import
Invoice raised by vendors outside the company’s country
Domestic Material
New category with VIM 6.0 SP3. Invoices raised by vendors in India where the
Purchase Order is a Material PO. Applicable to India only.
Domestic Service
New category with VIM 6.0 SP3. Invoices raised by vendors in India where the
Purchase Order is a Service PO. Applicable to India only.
Import Material
New category with VIM 6.0 SP3. Invoices raised by vendors outside India where
the Purchase Order is a Standard PO. Applicable to India only.
Import Service
New category with VIM 6.0 SP3. Invoices raised by vendors outside India where
the Purchase Order is a Service PO. Applicable to India only.
Non VAT
New category with VIM 6.0. Invoices without VAT amount. Applicable to China
only.
VAT Common
New category with VIM 6.0. Invoices with VAT provided but the VAT amount is
not deductible. Applicable to China only.
VAT Special
New category with VIM 6.0. Invoices with VAT provided and the VAT amount
is deductible. Applicable to China only.
For information on maintaining invoice categories, see “Invoice Categories,
Category Groups, and Mapping” on page 357.
The following table lists the document types that are delivered as a part of VIM
baseline version:
Each document type has a set of business rules defined against it. These business
rules determine the DP Exception to be raised in case of missing or invalid data on
the DP indexing screen.
Each business rule is driven either through configuration or a function module
which will in turn trigger the business logic for validating the invoice information.
The DP indexing screen is different for each document type. Based on the document
type, the respective Indexing screen is displayed. The screen configuration for each
document type is a part of the document type configuration.
For the invoice categories provided by VIM Baseline, see the following
screenshot.
Prerequisites
• Invoice categories must be maintained. See “Maintaining Invoice Categories” on
page 357.
• Invoice category groups must be maintained. See “Maintaining Invoice Category
Groups” on page 358.
2. Maintain the invoice categories for each invoice category group. One invoice
category can be assigned to multiple category groups.
Prerequisites
• Invoice category groups must be maintained. See “Mapping of Invoice
Categories to Groups” on page 359.
2. Map your invoice category groups to the countries that are supported in your
system.
Each business rule has a corresponding process type attached with it. In case of an
exception, the corresponding process type is triggered.
The process types are reused for multiple document types. Based on all the business
rules that are valid for a document type, the corresponding process types are
defined during document type configuration.
The screenshots below display process types defined in the baseline version of VIM
for PO and Non PO invoices.
To configure or to see what is configured for the baseline version, execute the
/N/OPT/SPRO transaction to access VIM Customizing IMG and navigate to
Document Processing > Process Configuration > Maintain Process Types.
For further details on configuring process types, see “Defining the Process Type” on
page 89.
The following screenshot shows the PO Invoice Process Type Definition.
As shown in the screenshot, each process type is assigned with an initial actor.
Based on the exception triggered, the workflow will assign the document to the
respective user.
Process types for Non PO invoices are defined similarly. The following screenshot
shows the process type definitions for Non PO invoices.
2. Select the document type for which the screen needs to be customized and click
the Submit button.
The screenshot above displays the various attributes that can be modified for a
screen field.
Required
Select this radio button to make the field mandatory at runtime.
Display Only
Select this radio button to only display the field.
Hide
Select this radio button to hide the field on the screen.
Field Text on Screen
Edit the label for the fields on the screen.
State Central VIM 5.2 SP4 introduces the State Central Bank Indicator (SCB Indicator). The SCB
Bank Indicator Indicator defines the possible reasons for payment. The SCB Indicator is configured
for documents in the following countries:
• Austria
• Belgium
• Germany
• Japan
• Netherlands
A field SCB Ind for the SCB Indicator is available in the DP document at header
level. You can configure this field for each DP document type. See “To configure
country specific screen fields:” on page 363.
Supplying VIM 5.2 SP5 introduces the Supplying Country field. This field is configured for
Country documents for Germany. Together with the German SCB Indicator, the Supplying
Country field is needed for creating reports in line with German foreign trade
regulations.
A new field Supplying Cntry is now available in the DP document at header level.
You can configure this field for each DP document type. See “To configure country
specific screen fields:” on page 363.
2. Enter the DP Document Type that you want to copy from and click Copy as.
3. In the Enter target document type dialog box, enter the target DP document
type that you want to copy to.
The target document type must be valid and exist in the system.
4. Click to continue.
The program checks if a configuration already exists for this DP document type.
If a configuration is found, you get a warning in a dialog box.
5. Click Yes to overwrite the screen configuration.
Another dialog box is displayed, asking if you want to copy the item
configuration as well.
6. Click Yes.
The copy is finished, you return to the first screen. A status message is shown.
The new DP document type is set as default entry. You can look at the results
using the Submit button.
Each process type for a particular document type is assigned with a BDC Id that
will trigger the document creation based on the definition of the BDC Id. The
BDC Id in the BDC Transaction Id column will process the document in
foreground and the BDC Id in the Background Tran Id column will process the
document in background.
3. Select the Autopost Flag to create the document always in the background.
4. In the Parking Reason column, specify the parking reason for this Process Type
if any. For details, see “Configuring Parking Reasons” on page 130 for PO
invoices and “Configuring Parking Reasons” on page 176 for Non PO invoices.
5. In the Active column, select the check box to set the Process Type active.
Conversion Date
This attribute determines the date to be used while converting the invoice
amount from foreign currency to company code or local currency.
Select one of the following values:
• Current System Date
• Posting Date
The following check boxes are indicators for credit memo check:
CM Ref No. Req.
Select this check box to determine that the credit memo must have a valid
reference invoice number.
CM Ref Date Req.
Select this check box to determine that the credit memo must have a valid
reference invoice date.
CM Data Validate
Select this check box to determine that the credit memo reference number
and the credit memo reference date must match with the existing invoice in
the SAP system.
2. Configure the process types for the country, using the following parameters:
Process Type
Process type number. You cannot change this setting here.
Description
Description of the process type. You cannot change this setting here.
InvoiceTyp
Select the invoice type that is applicable to the process type in this country.
The following values are available:
• All invoices
• PO based invoices
• Not applicable
Ignore Sim
Ignore for simplified invoice. Select this check box to determine that the
process type will be ignored for Simple Invoices.
Inv. Cat.
Invoice category: Select the categories of the invoice to which the process
type is applicable. You can select single categories or combinations of
categories. For information about the categories, see “Invoice Categories” on
page 354.
15.4 Z Constants
For some country specific configuration, you need to maintain Z constants. To
access Z constants, execute the SM30 transaction with table /PTGWFI/Z_CONST.
AFTCS_PROCESS_TYPES
Only relevant to invoices processed under Chinese DP document types
Usage
• This Z constant defines the process types that are relevant for the AFTCS
(Anti Forge Tax Control System) file upload/download program. The
program /OPT/VR_AFTCS_FILE downloads the data of only those invoices
that are in process types defined in this Z constant.
You can maintain multiple process types (as in baseline) with each process
type separated by comma.
Product code
005
Baseline
141, 241
DETERMINE_INV_CAT
Usage
In VIM 6.0, baseline provides 7 invoice categories. You can also create your own
invoice categories. But the system will not determine the custom invoice
category. You must write your own function module to determine the custom
invoice category. You must define this custom function module in this Z
constant.
Product code
005
Baseline implementation
/OPT/VIM_TEMPLATE_DET_INV_CAT
For document type NPO_INV_IN, the exclusive screen fields are the same. The only
difference is that the field ECC NO is marked as Hide, not as Normal because the
ECC Number is not relevant for Non PO invoices.
ICC If ICC is used as OCR, ICC does not explicitly supply the ship-to-region. In this case,
VIM uses Company Code/PO (based on the selected configuration option) to derive
the ship-to-region. There might be cases where you cannot use Company Code/PO
to derive the ship-to-region. In these cases, you must use custom functions or
manual entries, for example, if one of the following cases applies:
• The Company Code address cannot be treated as the ship-to-address. In this
case, do not use the Company Code option to derive the ship-to-region. Use the
custom function option.
• A PO or a combination of multiple POs has any line items with varying ship-to-
regions for various PO line items (based on different receiving plants at PO line
item level). In this case, do not use the PO as an option to derive the ship-to-
region. Use the custom function option.
• Without the ship-to-region determined automatically or supplied, new business
rules for validation of tax rate fields/tax code determination fail on VIM side.
Manual user input is needed.
• ICC does not supply taxes at line item level. ICC should supply taxes only at
header level. The same tax rate at the header is applicable for each line item if no
lines are supplied with a tax rate. Different line items in the vendor invoice
might have different tax rates; for example, if a combination of free goods line
(tax-free) and lines with a tax rate exists in the vendor invoice. Use the custom
function option.
Note: The Find Text for Field at Header and Line Item Level table with its
entries is delivered out of the box. Therefore, you do not have to maintain
or change anything, unless some exceptional cases occur.
Keywords – Assigning a keyword to a particular field specifies the kind of the
field. For example, if GST is the keyword for the TAXRATE_1 field, this means that
the TAXRATE_1 field is the GST tax rate field for Canada.
Entries in the KeyWord column are language dependent.
The following fields at header level should be maintained for the tax line
keyword:
• TAXRATE_1: Maintain GST, if this field is supposed to store the GST tax rate.
• TAXRATE_2
• TAXRATE_3
• TAXRATE_4
The following fields at line level should be maintained for the tax line keyword:
• TAXRATE1_1
• TAXRATE2_2
• TAXRATE3_3
• TAXRATE4_4
Labels – Besides maintaining keywords, the Find Text for Field at Header and
Line Item Level table is used for maintaining labels for tax rate fields and tax
amount fields at line item level.
Note: For header level fields, you maintain texts by transaction
/OPT/VIM_NW_SCRN_CFG.
For the line item level, the following fields should be maintained for texts:
• TAXAMT_1
• TAXAMT_2
• TAXAMT_3
• TAXAMT_4
• TAXRATE1_1
• TAXRATE2_2
• TAXRATE3_3
• TAXRATE4_4
Customer Tax Determination
You can create an own logic to find the missing tax code. Embed the logic in the
Z function module. The interface of the custom function should be like the
following:
*FUNCTION ZXXXXXXXXX
*" TABLES
*" INDEX_ITEM STRUCTURE /OPT/VIM_1ITEM
*" CHANGING
*" REFERENCE(INDEX_DATA) TYPE /OPT/VIM_1HEAD OPTIONAL
Note: You can use any scan client and content repository that are certified by
SAP; for example OpenText Imaging Enterprise Scan and OpenText Archive
and Storage Services.
2. The scan client deposits the image of the paper invoice to the content repository.
The OAWD transaction creates a DP document in SAP using function module
/OPT/VIM_IF_NEW_DOC_INSERT.
• Updates the status and OCR data appropriately. This API exports the data to
SAP after completion of the extraction phase. Table /OPT/VIM_1EXT_H will
be updated with extracted data.
• Updates the DP Document status with Extraction Completed.
6. The ICC Extraction engine sends the detailed results XML file of the exported
data to the content repository using the URL retrieved from SAP in step 3. The
XML file is used by the ICC Validation engine.
Results for each data exported to SAP are stored in an XML file and archived
back to the content repository.
7. A periodic job (program /OPT/VIM_STATUS_EXTR) runs on SAP side, picks up
the DP items with status Sent to OCR and checks the time elapsed. If it exceeds
the configured time, the status is set back to Scanned.
The maximum allowed time for extraction can be maintained in table
/OPT/VIM_RETRY using the SM30 transaction. Table /OPT/VIM_RETRY contains an
entry with call point EX for extraction.
8. A periodic job (program /OPT/VIM_DP_TRIGGER) runs on SAP side, picks up the
DP items with status Extraction Completed. The job runs business rules to
check if validation is required or not. If validation is required, the status is set to
Ready for Validation. If validation is not required, the DP workflow is started.
If validation is required, the system evaluates the agents for the VALIDATOR role
and updates the SAP tables.
9. The ICC Validation engine calls the API (G) /OPT/VIM_IF _GET_VAL_DOC_LIST
and gets a list of documents for validation:
• Gets all the documents in status Ready for Validation.
• For each DP document, it gets the secure URL for image and XML
documents which will be used by the ICC Validation Client.
• The function module SCMS_DOC_URL_READ will return the URL by taking
Archiving ID and Archiving Doc ID as input.
10. The ICC Validation engine picks documents (both image and XML) from the
content repository for each validation document, using the URL retrieved from
SAP at step 9.
After validation, the ICC Validation engine sends the results XML file
(including changes done during validation) back to the content repository using
the same URL.
11. The ICC Validation engine calls the API (I) /OPT/VIM_IF_OCR_DATA_UPDATE
with call point VA:
• Updates the status and OCR data appropriately. This API exports the data to
SAP after completion of the validation phase. Table /OPT/VIM_1EXT_H is
updated with validation data.
• Updates the DP Document status with Validation Completed.
12. A periodic job (program /OPT/VIM_STATUS_VALD) runs on SAP side, picks up
DP items with status Sent for validation, and after elapsed time sets the
status to Ready for Validation.
The maximum allowed time for Validation can be maintained in table
/OPT/VIM_RETRY using the SM30 transaction. Table /OPT/VIM_RETRY contains an
entry with call point VA for validation.
13. A periodic job (program /OPT/VIM_DP_TRIGGER) runs on SAP side, picks up DP
items with status Validation Completed, and starts the DP workflow.
• Description
• DocArea (Document Area)
• Storage type
• Protocol: This setting defines the file source for archiving and image
displaying media.
• Version no.
• HTTP srvr:port (HTTP server and port)
• HTTP script
• Transfer drctry (Transfer directory)
4. Click to save your settings.
2. In the Default setting: Overview screen, click New Entries in the application
tool bar.
4. Add the Doc. type, for example /OPT/ICC, and select the appropriate storage
scenario check box, for example Storing for subsequent entry.
Note: Optionally, you can select an Object Type in the OT column and an
Agent ID for the document type.
5. Click to save your changes.
2. Click Continue.
3. Document type
Doc.type
Enter an archive document type for ICC exported XML results, for example
ZOPT_XML.
Name
Enter a description.
Click Continue.
6. Document class
In the Doc. class field, enter XML, and click Continue.
2. Document type
Doc.type
Enter the document type. Use an archive document type from your own
namespace, for example ZOPT_ICC.
Name
Enter a description.
Click Continue in the upcoming screens until you reach the following screen.
4. Document class
Enter Doc. class FAX and click Continue.
Entry
Method
PREPROCESS_OCR
Task
WS00275270
Assignment
Task
WS00275270
Click Continue.
6. In the Workflow Parameter screen, click Continue.
Note: If the retry limit is reached, and you want to reset the document to
be processed again, you must reset the retry counters manually.
3. Click to save your settings.
• Function Module.
If you select Function Module, you must maintain the field Validate Chk
Func.
Validate Chk Func
Maintain this field if you selected Check Type Function Module. The
Validate Check function module will determine whether validation is
required or not.
Click one of the following radio buttons:
Validate For Selected Fields
If you select this option, you must maintain the Validation Determination
Fields that are required, see step 4 on page 407.
The system will check whether all the listed fields are maintained for the DP
document. If one of the fields is not maintained, it will send those DP
documents for validation to the Validation Client.
Validate Never
Select this option to determine that the DP document will not be sent for
validation and continues with the workflow.
Validate Always
Select this option to determine that all DP documents that are assigned to
this Validation group will be sent to the Validation client for validation.
4. To maintain the Validation Determination Fields, double-click the Validation
Determination Fields link in the navigation panel.
2. Link the Document type to the Validation Determination ID, represented by the
Validate Grp.
Constant Meaning
DP_EX_VA_REJECT OCR Extraction/Validation is Reject
DP_EX_VA_SUCCESS OCR Extraction/Validation is Success
DP_SYNC_PROC Process Code to control parallel DP Trigger Process
DP_SYNC_REFRESH_TAB Refresh DP Sync Table
URL_READ_FM Function module to read the Image/Document URL
PO_REC No of Records - Purchase Order Search
VEND_REC No of Records - Vendor Search
XML_AR_ASSIGN_LATE If set to X, the archive document ID for XML will be
assigned via RFC from ICC.
Set the parameter value to X, if ICC V6.0 SP3 or
higher is used. Leave the parameter empty, if a lower
ICC version is used.
XML_AR_CONTREP Content Repository for XML Document (if not de-
fined in OAC3)
XML_AR_OBJECT AR Object of XML Document (Deprecated)
Channel ICC represents the ICC integration. To view details, double-click the
line.
The VALIDATOR node represents the assigned Validation agents for Product code
005. You can assign Validation agents to Archive Document types and to the
following Agent Types:
A
Work center
AC
Role
C
Job
O
Organizational unit
S
Position
US
User
With the configuration shown in the screenshot, the document type is determined in
the following way:
• A document scanned with archive document type ZICC_HF gets the DP
document type NPO_INV_AT. Therefore the document type determination rules
engine is skipped.
• A document scanned with archive document type /OPT/ICC gets the DP
document type DEFAULT initially. Then the rules engine is triggered to determine
the DP document type.
• A document scanned with any other archive document type gets the DP
document type DEFAULT initially. Then the rules engine is triggered to determine
the DP document type.
16.5.1 Methods
The rules engine consists of a sequence of procedures. Each procedure is responsible
for one DP document type. If one procedure says NEXT, the next procedure is
performed. If a procedure says TRUE, the document type of this procedure is applied
to the document. The last procedure should be responsible for the DP document
type DEFAULT. This last procedure should always return TRUE.
16.5.2 Configuration
You configure the rules engine in the VIM Customizing IMG (/OPT/SPRO):
LiveLink VIM - Configuration > Document Processing > Document Type
Configuration > Maintain Document Type Determination Procedure (Only for
OCR)
The baseline configuration uses the existence of an invoice order number in the
OCR results for an invoice to tell if the invoice is a Non PO or a PO invoice. In
case of a Non PO invoice, the company code of the OCR results decides on the
DP document type. In case of a PO invoice, the company code of the PO decides
on the DP document type.
You can use the Exclusive check box to deactivate a procedure. If the check box
is not selected, the procedure will never return TRUE but always return NEXT.
2. For VIM 6.0, configure the following additional procedures:
You can change the sequence of the procedures, and you can introduce
additional procedures. As the procedures are executed in alphabetical order
according to their procedure name, OpenText recommends that you insert new
procedures in their correct position.
16.5.4 Steps
The procedures consist of steps, which can be modified. There are four check types
that you can use:
A
Missing value of an OCR field
B
Constant value of an OCR field
C
Custom function
D
Invalid value of an OCR field (value cannot be found in a check table)
The baseline configuration uses steps with custom functions only:
16.5.5 Using the Rules Engine with the OCR Simulation Tool
You can use the rules engine with the OCR simulation tool (/OPT/VIM_7AX2).
New for VIM 6.0 The engine can be skipped only if the copy option in the OCR simulation tool is
SP3 (VIM 5.2 used, and if an additional mapping entry is created in the table that controls the
SP8)
mapping of the OCR simulation tool.
To create this entry, execute transaction SE16N for table /OPT/VIM_T109, and add
the line for field ORIG_AR_OBJECT as shown in the following screenshot:
2. Select the line of the client you want to assign to a logical system.
3. To display details, click the button in the application tool bar.
4. In the Logical system field, enter the name of the logical system to which you
want to assign the selected client.
5. Click to save your settings.
• Satellite System
External System refers to any system which is not an SAP ERP system.
For example, a non SAP system is treated as an External System. An SRM
system could also be part of the landscape. SRM is an SAP system but not
of ERP type. Therefore, an SRM system must also be classified as an
External System.
Select this value if your system landscape comprises only one system.
Central System
Enter the Central System if the own system is classified as Satellite
System.
Status
Select the status of the system. Available values: Active or Inactive.
4. Click to save your settings.
To maintain channels:
1. Execute the /n/OPT/VIM_CHNL transaction.
Alternatively, execute the /N/OPT/SPRO transaction and follow the menu path
LiveLink VIM - Configuration > Document Processing > General
Configuration > Maintain Channels.
2. Double-click a line to open the Opentext Channel Set Up Details screen.
Description
Enter the channel description. It is language dependent.
Mapping ID
If you want to link a Mapping ID to the channel, enter the Mapping ID. See
“Maintaining Mapping IDs” on page 432.
Sys Det. ID
If you want to link a System Determination ID to the channel, enter the
System Determination ID. If no System Determination ID is linked here, the
Default Company Code Look up system determination can be used in a
multiple system scenario.
Ignore Mapping Error
Errors might occur during the mapping stage (when data from a particular
channel flows into the SAP system).
Select this check box to determine that these errors are ignored for the
channel and the SAP IM workflow is started.
Clear the check box to determine that, in case of a mapping error, processing
stops at this point and the SAP IM workflow is not started.
4. Click to save your settings.
Ignore Chars
Enter characters that are deleted in an extra step before mapping continues.
This is useful, for example, if there are apostrophes in the Reference
Number. Enter the apostrophe in the Ignore Chars field in the XBLNR line, to
avoid a short dump in duplicate check.
The field can contain up to 6 characters.
6. Click to save your settings.
Note: You must perform the tasks either in the SAP ERP (VIM) system or in
the CRM system. The system is indicated in square brackets, for example
[ERP], in the title of each section.
• “Maintaining a Logical System for the CRM System in VIM [ERP]” on page 438
• “Creating an ITS Service in the Backend ERP System [ERP]” on page 438
• “Defining Transaction Launcher Logical Systems and URL [CRM]” on page 446
• “Creating a Transaction Launcher for VIM Work Centers to Call VIM Analytics
(Service Request) [CRM]” on page 448
• “Creating a Transaction Launcher for VIM Work Centers to Call VIM Analytics
(Account ID Confirmation) [CRM]” on page 455
• “Configuring Work Centers for VIM Analytics [CRM]” on page 456
• “Configuring Business Context Links for OpenText Linked Objects in Service
Request [CRM]” on page 461
• “Configuring the OpenText Vendor Factsheet BSP Component [CRM]” on
page 467
• “Maintaining the Logical System in OpenText Configuration Tables [CRM]” on
page 479
• “Defining Prefill Business Role Settings for RFC (Service Request Display)
[CRM]” on page 480
3. Expand default_host > sap > bc > gui > sap > its and right-click the ITS Service
name.
~COOKIES 0
~GENERATEDYNPRO 1
~LISTSCROLLING 0
~POPUPS 1
~STYLE DHTML
~WEBGUI 1
~TRANSACTION /OPT/VIM_SSF_LAUNCH
~FLICKERFREE 1
~DISCONNECTONCLOSE 1
~THEME 99
~WEBGUI_SIMPLE_TOOLBA 114
R
Click to continue.
8. In the Handler List tab, set the Handler class name CL_HTTP_EXT_ITS.
9. Save the Service.
When prompted, enter the name of a development package and click .
Note: If you do not have a development package for your own
developments, create a new development package.
When prompted, enter a workbench request and click .
Exit the screen to create a Service.
10. To activate the service, select the service and right-click.
Click .
2. Maintain the Mapping name and the corresponding backend ERP Logical
System name with the ITS Client and the URL of ERP ITS, specifically for
OpenText components.
Determine the URL of ITS, for example: <http>://<Host
Name>:<Port>/<sap><created service name path>?sap-client=<CLIENT>.
Notes:
• Mapping logical systems and setting the URLs for standard SAP objects
like Vendor Links in business context must follow SAP conventions to
determine the URLs.
• You must maintain 2 URLs for each backend ERP system, one URL for
standard SAP objects and another URL for OpenText objects.
• Mapping names for OpenText objects follow a convention: The first 5
characters in the mapping name are ZZZZZ, followed by free text that
identifies the backend ERP system, for example ZZZZZD94.
3. Save and exit.
URL of ITS:
http://op60vimd94.optura.local:8000/sap/bc/gui/sap/its/opt_ltx
?sap-client=800
To create a transaction launcher for VIM work centers to call VIM Analytics
(Service Request):
1. In the CRM system, follow SAP Customizing Implementation Guide >
Customer Relationship Management > Interaction Center WebClient > Basic
Functions > Transaction Launcher > Configure Transaction Launcher
(Wizard)
2. Click Continue.
3. Enter the Launch Transaction ID, for example ZVIM_TL_CONFIG_SRQ, and the
Component Set ALL.
Click Continue.
5. In the Transaction Type list, select A BOR Transaction and fill in the following
details:
Logical System
Example: D94CLNT800 (belonging to mapping ZZZZZD94)
See “Defining Transaction Launcher Logical Systems and URL [CRM]” on
page 446.
BOR Object Type
/OPT/V1001
Method Name
DISPLAY
6. Click Continue.
9. Click Complete.
10. Change the Handler Class of the newly created Transaction Launcher ID.
Perform the following steps:
a. Follow SAP Customizing Implementation Guide > Customer
Relationship Management > Interaction Center WebClient > Basic
Functions > Transaction Launcher > Copy/Delete Launch Transactions
c. Change the Handler Class entry for the selected Launch Transaction ID to
/OPT/CL_VIM_TL_CONFIG_SRQ.
Definition 2: DISPLAY
Definition 3: <Mapping name for logical system of ERP system>, for example
ZZZZZD94.
If the Definition fields are not populated correctly, delete the newly created
Launch Transaction and repeat the above steps beginning from step 1. Check
the fields in step 5 carefully.
To create a transaction launcher for VIM work centers to call VIM Analytics
(account ID confirmation):
1. Create a new Launch Transaction ID with name ZVIM_TL_CONFIG and
description OpenText Transaction Launcher.
Therefore, follow step 1 to step 9 in “Creating a Transaction Launcher for VIM
Work Centers to Call VIM Analytics (Service Request) [CRM]” on page 448.
Note: When entering the same handler class in step 4, the fields in the
Details section are prefilled automatically in step 5.
2. Change the Handler Class of the newly created Transaction Launcher ID.
Perform the following steps:
a. Follow SAP Customizing Implementation Guide > Customer
Relationship Management > Interaction Center WebClient > Basic
Functions > Transaction Launcher > Copy/Delete Launch Transactions
c. Change the Handler Class entry for the selected Launch Transaction ID to
/OPT/CL_VIM_TL_CONFIG.
2. In the Define Logical Links screen, click New Entries and create a new Logical
Link ID using the following parameters:
Logical Link ID
<Name of the Logical Link ID>, for example ZAIC_LINK1
Type
Launch Transaction
Target ID
EXECLTX
Parameter
<Your Launch Transaction ID>, for example ZVIM_TL_CONFIG_SRQ; see
“Creating a Transaction Launcher for VIM Work Centers to Call VIM
Analytics (Service Request) [CRM]” on page 448
Parameter Class
CL_CRM_UI_LTX_NAVBAR_PARAM
Title
VIM Analytics SRQ
Description
VIM Analytics SRQ
Logical Link ID
<Name of the Logical Link ID>, for example ZAIC_LINK2
Type
Launch Transaction
Target ID
EXECLTX
Parameter
<Your Launch Transaction ID>, for example ZVIM_TL_CONFIG; see “Creating a
Transaction Launcher for VIM Work Centers to Call VIM Analytics (Account
ID Confirmation) [CRM]” on page 455
Parameter Class
CL_CRM_UI_LTX_NAVBAR_PARAM
Title
VIM Analytics Account ID
Description
VIM Analytics Account ID
5. Create one work center for VIM Analytics with regards to Account ID and
another work center for VIM Analytics with regards to Service Request. Enter
the Logical Link ID, created in step 2 and step 3.
6. In Dialog Structure, double-click Define Navigation Bar Profiles. Select the
Navigation Bar Profile you want to enhance.
Note: SAP's default navigation bar profile for the Accounting Interaction
Center Agent is AIC_AGENT. SAP strongly recommends that you never alter
the SAP Standard Navigation Bar Profiles. Always create a new one or use
an existing copy of the Navigation Bar Profiles. See the SAP documentation
for more information about copying the Navigation Bar Profiles, assigning
them to business roles, and so on.
7. In Dialog Structure, double-click Assign Work Centers to Navigation Bar
Profile. In the Assign Work Centers to Navigation Bar Profile view, click New
Entries.
8. Assign the 2 work centers you have created and enter the position at which the
work centers should be located within the navigation bar.
Save your changes.
3. Define a Link Type with the same name as business object name: /OPT/V1001
with Description of Object Link Type: OpenText DP document and save the
Link Type.
Note: Ignore a warning to choose the key from the allowed namespace.
4. Select the Link Type /OPT/V1001 and double-click Define Object Link Type
Details in Dialog Structure.
5. In the Define Object Link Type Details screen, click New Entries.
6. Enter Object Link Class /OPT/CL_FSSC_BC_LINK_DP for the Object Link Type
/OPT/V1001 and save the configuration.
Note: Ignore a warning to choose the key from the allowed namespace.
7. Double-click Define Object Link Profile in Dialog Structure and select the
Link Prof. SSF_AIC.
.
9. Click New Entries and assign the new entry /OPT/V1001 to the Link Types of
Object Link Profile SSF_AIC and save the configuration.
Note: Ignore a warning to choose the key from the allowed namespace.
10. In Dialog Structure, double-click Define Business Context Profile and select
the SSF_AIC Business Context Profile.
17. In the Define Logical Links screen, click New Entries and create a new Logical
Link ID for Service Request Business Context DP links, using the following
parameters:
Type
Enter Link.
Parameter
Enter the already created Launch Transaction ID (see “Creating a
Transaction Launcher for VIM Work Centers to Call VIM Analytics (Service
Request) [CRM]” on page 448) with regards to the Service Request work
center.
Save the configuration.
18. In Dialog Structure, double-click Define Navigation Bar Profiles and select the
custom Navigation Bar Profile.
20. In the Define Generic Outbound Plug Mappings screen, click New Entries,
create a new entry with name WRAPPED_/OPT/V1001, and assign the Logical
Link ID created for Business context links, for example ZOPTBC.
Note: The Object Type should be concatenated with text WRAPPED_.
Save the configuration.
21. Repeat step 18 to step 20 for all custom Navigation Bar Profiles that are affected;
that means, also for the navigation bar profile belonging to the SSF Occasional
User (for example, navigation bar profile ZVIM_SSF_OCC_USER).
Note: SAP's default navigation bar profile for the SSF Occasional User is
SSF_OCC_USER. SAP strongly recommends that you never alter the SAP
Standard Navigation Bar Profiles. Always create a new one or use an
existing copy of the Navigation Bar Profiles. Please see the SAP
documentation for more information about copying the Navigation Bar
Profiles, assigning them to business roles, and so on.
22. To create an OpenText Business Context object type in Table/View
BSPDLCV_OBJ_TYPE, execute the SM30 transaction to maintain
BSPDLCV_OBJ_TYPE.
Description
OpenText Document
Note: All OpenText CRM BC SETs must be activated before the following
step.
2. Define a new entry in Component Definition with a new custom Component
Name, for example ZOPTVS. To create a new Component Definition, click New
Entries in the Component Set Definition screen. Use the following parameters:
Implementation Class
/OPT/CL_FACTSHEET
Object Table
/OPT/FS_OBJECT
Model Table
/OPT/FS_MODEL
In the Component Assignment screen, click New Entries, assign the newly
created Component Name to the newly created Component Set, and save the
configuration.
5. To assign models to the Business Component, execute the BSP_WD_CMPWB
transaction (UI Component Workbench), enter the Component
/OPT/VENDOR_FS, and click Display.
6. Click Runtime Repository Editor, expand the Models node and click to
switch to edit mode.
9. Open the Models node. Right-click Models and click Add Model.
10. Enter the Component Set name created in step 3 on page 468, for example
ZOPTCOMPSET.
Click .
Press the ENTER key and assign to a Transport Request.
14. Select the fields in Available Fields and move them to Displayed Fields.
Note: You must move the fields one by one.
15. When you have moved all fields to Displayed Fields, save and exit from the
transaction.
16. To maintain the Factsheet, follow SAP Customizing Implementation Guide >
Customer Relationship Management > UI Framework > UI Framework
Definition > Fact Sheet > Maintain Fact Sheet.
17. Choose the Fact Sheet ID to plug the OpenText Vendor Factsheet. You can add
the BSP Component /OPT/VENDOR_FS to any of the Fact Sheet IDs. In the
example, the BSP Component /OPT/VENDOR_FS is added to Fact Sheet ID
FSSC_VEND_FS.
Interface View
Select /OPT/VENDOR_FS/MainWindow from the drop-down list (F4 help).
Inbound Plug
DEFAULT
Title
OpenText Vendor Factsheet ID
Save and exit from the customizing.
Note: Ignore a warning to choose the key from the allowed namespace.
19. To link the configured Factsheet ID to the BSP Vendor Factsheet ID, execute the
BSP_WD_CMPWB transaction (UI Component Workbench), enter the Component
BSP_DLC_FS, and click Display.
21. From the drop-down list, select the Factsheet where you added the OpenText
business component. In the example, the BSP Component /OPT/VENDOR_FS was
added to Factsheet ID FSSC_CUST_FS
Select the Factsheet FSSC_CUST_FS and click New.
22. From the drop-down lists, select the Fact Sheet ID FSSC_CUST_FS and the Role
Key Accounting IC Default Key and click Next.
Note: If you use a customer specific role configuration key, select your role
configuration key for the field Role Key instead of selecting the default
role configuration key Accounting IC Default Key.
23. From the drop-down lists, select the Page Type, for example Tiles, and the Tile
Layout, for example 2_X_3 (2 columns and 3 rows), then click Next.
Each cell (tile) in Tiles represents a View. Tiles are grouped under a Tiles group
which is displayed in the CRM UI page.
24. To move the OpenText Vendor Factsheet to any of the tiles, select a tile, then
select the OpenText Vendor Factsheet ID, and click the down arrow which will
place the OpenText Vendor Factsheet into the selected tile.
Use the Up and Down arrows to move the OpenText Vendor Factsheet to the
target position within the tile.
Click the Configuration link to the right of the assigned OpenText Vendor
Factsheet.
27. Select the Available Fields and move them to the Displayed Fields. To do so,
select each field and click the arrow button.
29. Click Save and then click Finish. The new configuration is saved.
Exit from the transaction.
3. In the Mapping column, enter an appropriate mapping name for the Logical
system of the VIM system. See also “Defining Transaction Launcher Logical
Systems and URL [CRM]” on page 446.
4. Save your settings.
2. In the Define Prefill Business Role Settings for RFC screen, add a new entry
with the following values:
RFC Name
CRM_PREFILL_SRVQ_RFC_DISPLAY
Business Role
<Name of your business role for the SSF Occasional User>, for example
ZVIM_SSF_OCC
Object Type
CRM_SRQM_INCIDENT
Object Action
Display
Business Role
<Name of your business role for the SSF Occasional User>, for example
ZVIM_SSF_OCC
Object Type
CRM_SRQM_INCIDENT
Object Action
Create
5. Repeat step 2 and step 3 to create a third entry with the following values:
RFC Name
CRM_PREFILL_SRVQ_RFC_SEARCH
Business Role
<Name of your business role for the SSF Occasional User>, for example
ZVIM_SSF_OCC
Object Type
CRM_SRQM_INCIDENT
Object Action
Search
2. Select the Initializing Procedure Default and double-click Field config for
Initializing Procedure.
• Function Module
• Application variable
Field value
Enter the field value, depending on the setting in Value Determination
Type.
3. Execute the SPRO transaction and follow the menu path Cross-Application
Components > Processes and Tools for Enterprise Applications > Shared
Service Framework > Integration with SAP CRM > Integration with Service
Request > Define Customer Application > Define Activities.
5. Execute the SPRO transaction and follow the menu path Cross-Application
Components > Processes and Tools for Enterprise Applications > Shared
Service Framework > Integration with SAP CRM > Integration with Service
Request > Processing > Activate Manual Service Request Creation for
Activities.
Activity
SAIC
Application Area
VIM
Man. Creat
Select the check box.
7. Execute the SPRO transaction and follow the menu path Cross-Application
Components > Processes and Tools for Enterprise Applications > Shared
Service Framework > Integration with SAP CRM > Integration with Service
Request > Processing > Determine Service Request Attributes from
Application Context.
Application Area
VIM
Trans. Type
SAIC
9. Based on the application area, you can perform some further settings, for
example determine service request attributes from the application context. For
example, you may want to populate the subject category fields. For more
information, see the SAP documentation of the IMG activities mentioned in this
section.
To assign the inbound function module to IDoc type and message type:
1. Execute the WE57 transaction.
2. In the IDoc: Assignment of FM to Log. Message and IDoc Type view, click
to enable changes.
3. Click New Entries.
4. Configure the assignment, as shown in the following screenshot.
Note: You can choose a name for the process code that suits your needs.
5. Click to save your settings.
6. Double-click Logical message in the Dialog Structure.
7. Assign the new process code to the logical message, as shown in the following
screenshot.
Note: Use the process code you created in “Creating a New Process Code”
on page 489.
5. Click to save your settings.
The target system is determined based on the company code. Each system in the
multiple backend system is identified by a logical system name.
The following configuration steps are necessary:
• “Configuring the External Field Mapping” on page 492
• “Configuring the VIM Field Mapping” on page 493
• “Creating a Channel ID” on page 494
Obj. name
Development Object name: the IDoc type INVOIC02
Segm.type
Segment type in IDoc type
Field name
Segment field
IDOC Qualf(Fld/VAl)
Qualifier of the Segment
Qualifier Value
Value of Segment Qualifier
Field Type
Select either Header or Item type from the drop-down list.
Document Field Name
Enter the Intermediate field name.
Field Mapping Type
Select one of the following mapping types from the drop-down list:
• From IDOC Segment Field
• System variable
• Function Module
Value
In case you selected Constant (fixed value), System variable, or
Function Module as the field mapping type, enter the corresponding value.
2. In the Opentext: Channel Set Up Overview screen, click New entries to create a
new channel.
In the screenshot above, Company code 2000 is mapped to the Logical system
T90CLNT090.
Important
Take care when you change the global configuration parameters. Changes
affect the functionality of the process.
Process flow
1. The E-Invoicing provider module receives digitally signed invoices from
vendors.
FUNCTION /OPT/ARCHIV_DOC_URL_CREATE.
*"-----------------------------------------------------------------
*"*"Local Interface:
*" IMPORTING
*" VALUE(ARCHIV_ID) TYPE /OPT/VIM_1RHEAD-ARCHIV_ID OPTIONAL
*" VALUE(SIGNATURE) TYPE CHAR1 OPTIONAL
*" VALUE(AR_OBJECT) TYPE SAEOBJART OPTIONAL
*" EXPORTING
*" VALUE(ARCHIV_DOC_ID) TYPE /OPT/VIM_1RHEAD-ARC_DOC_ID
*" VALUE(MIMETYPE) TYPE CHAR128
*" VALUE(RC) TYPE SUBRC
*" TABLES
*" URL_ROWS STRUCTURE /OPT/VIM_URL
Import parameters
The E-Invoicing provider must enter the correct parameters to match the SAP
ArchiveLink configuration.
Export parameters
Error handling
If the RFC raises an exception, the call has failed. The call can be resubmitted if
possible. If the RC returns value 8, a data error has occurred. This record should be
placed into a separate queue for error handling. Resubmitting without investigation
will not make much sense.
FUNCTION /OPT/VIM_START_DOC_PROCESS_EXT.
*"------------------------------------------------------------------
*"*"Local Interface:
*" IMPORTING
Import parameters
When calling this function, provide the following information:
1. Archived image info:
Parameter Name Data Type Size Comments
ARCHIV_ID Char 2 Content Repository Identification
(constant)
ARC_DOC_ID Char 40 SAP ArchiveLink Document ID (re-
turned from Interface Remote Func-
tion 1)
AR_OBJECT Char 10 SAP Archive Document Type (con-
stant: /OPT/ICC, /OPT/POI6)
2. Channel info:
Parameter Name Data Type Size Comments
CHANNEL_ID Char 10 SAP Channel ID (Constant). Rec-
ommended to be supplied. It helps
in identifying the source of any
supplied invoice.
SYSTEM Char 10 Logical name of the SAP target sys-
tem
Structure/OPT/VIM_1REXTDATA:
For each invoice field passed, the External Partner must specify field name
(EXTFIELD) and value (EXTVALUE).
4. Other optional parameters:
Parameter Name Data Type Size Comments
DOCTYPE Char 10 SAP IM Processing Document Type
I_DOC_HEADER Structure Structure of Indexing Document
Type Header /OPT/VIM_1HEAD
I_DOC_ITEMS Table Type Table of Indexing Document Item
/OPT/VIM_1ITEM
Export parameters
Error handling
If the RFC raises an exception, the call has failed. The call can be resubmitted if
possible. If the RC returns value 8, a data error has occurred. This record should be
placed into a separate queue for error handling. Resubmitting without investigation
will not make much sense.
FUNCTION /OPT/VIM_DOCUMENT_STATUS.
*"----------------------------------------------------------
*"*"Local Interface:
*" IMPORTING
*" VALUE(CHANNEL_ID) TYPE /OPT/CHANNEL_ID OPTIONAL
*" VALUE(SYSTEM) TYPE LOGSYS OPTIONAL
*" EXPORTING
*" VALUE(RC) TYPE SY-SUBRC
*" TABLES
*" DOC_QUERY STRUCTURE /OPT/DOCID_ST
*" DOC_STATUS STRUCTURE TYPE /OPT/VIM_DP_STATUS1
*" RETURN STRUCTURE BAPIRET2
*"----------------------------------------------------------
Import parameters
When calling this function, provide the following information:
1. Channel info:
Parameter Name Data Type Size Comments
CHANNEL_ID Char 10 SAP Channel ID (Constant). Rec-
ommended to be supplied. It helps
in identifying the source of any
supplied invoice.
SYSTEM Char 10 Logical name of the SAP target sys-
tem
Export parameters
Error handling
If the RFC raises an exception, the call has failed. The call can be resubmitted if
possible. If the RC returns value 8, a data error has occurred. This record should be
placed into a separate queue for error handling. Resubmitting without investigation
will not make much sense.
The Integrated Invoice Cockpit differentiates between global layouts that apply to
all users and user-specific layouts.
VIM baseline delivers default layout variants for all exceptions. These default layout
variants are independent of a logical system, to support any names of logical
systems on customer site.
If you want to use baseline default layout variants as a basis, you must copy these
default layout variants to your logical system.
In a next step, you can adjust the layout variants to your needs.
If you have adjusted layout variants to your needs on one logical system, you can
copy these custom layout variants to another logical system that is shown as a
satellite system within your current system.
Note: Copying layout variants does not support any copies to other systems. It
is always a copy within the same system but for different connected systems.
If you copy adjusted layout variants from a central system to a satellite system, the
layout variants will only affect the view in the central system. If you log in directly
to the satellite system, you still see the original layout.
3. Copy default layout variants from baseline to user-specific layouts. You can
copy layout variants for single nodes or for multiple nodes, including or
excluding subnodes.
Example:
Copy the default layout variants for the group of exceptions 4 (Posted PO
Invoices), including all subnodes, to the logical system T90CLNT090.
Report Options
Overwrite (if layout with same name is existing)
Select this check box.
Set as Default Layouts
Select this check box.
Click to execute copying.
4. In the Maintain global layout variants for IIC screen, adjust the copied layout
variants to your needs.
For this purpose, open the copied layout variants and change them, using the
button (Select Layout) in the ALV grid control.
5. Save the variants as user-specific default layout variants.
6. Provide the adjusted layout variants as global default layout variants:
Example:
Copy the adjusted layout variants for the group of exceptions 4 (Posted PO
Invoices), including all subnodes, as global default layout variants to the
logical system T90CLNT090.
Click Copy layouts in the ALV grid control.
Group of Exceptions
Enter 4 for the Posted PO Invoices group.
Exception Type/Exception ID
Leave these fields empty.
Include Subnodes
Select this check box to copy all exceptions in the Posted PO Invoices
group.
Report Options
Overwrite (if layout with same name is existing)
Select this check box.
Set as Default Layouts
Select this check box.
Click to execute copying.
Note: End users can change the global default layout variant to their personal
needs and save them as user-specific default layout variant.
The following steps are required to add customer workflow tasks to the Integrated
Invoice Cockpit:
• “Maintaining Customer Workflow Tasks” on page 516
• “Determining Key Fields of Work Items” on page 516
• “Maintaining Object Related Information” on page 517
• “Optional: Maintaining Texts of Tree Nodes” on page 519
In the IIC: Workflow tasks view, enter all workflow tasks that you want to add to
the Integrated Invoice Cockpit.
Important
Do not change the interface as any change will cause a system dump.
2. Delete the source code of the new function module. Add your own logic to the
new function module.
For more information about the importing and exporting parameters and how
to implement your own logic, see the function module documentation for
/OPT/VIM_IIC_DETERMINE_OBJ_KEY in the SAP system.
3. Execute the /N/OPT/SPRO transaction and follow the menu path LiveLink VIM -
Configuration > Central Reporting > Integrated Invoice Cockpit > Extensions
to Support Customer Workflow Tasks > Maintain Function Module to
Determine Object Key.
Important
Do not change the interface as any change will cause a system dump.
Delete the source code of the new, copied function module. Add your own
logic to the new function module.
PO invoices
For PO invoices or line items of PO invoices (object types /OPT/B2081 and
/OPT/LIV), you can reuse function module
/OPT/VIM_IIC_GET_PO_INV_DATA. If the logic of this function module is not
sufficient, you must copy function module
/OPT/VIM_IIC_GET_PO_INV_DATA to a Z* or Y* function module, for exam-
ple Z_IIC_GET_PO_INV_DATA.
Important
Do not change the interface as any change will cause a system dump.
Delete the source code of the new, copied function module. Add your own
logic to the new function module.
Non PO invoices
For Non PO invoices or line items of Non PO invoices (object type
/OPT/FIPP), you can reuse function module
/OPT/VIM_IIC_GET_NPO_INV_DATA. If the logic of this function module is
not sufficient, you must copy function module
/OPT/VIM_IIC_GET_NPO_INV_DATA to a Z* or Y* function module, for exam-
ple Z_IIC_GET_NPO_INV_DATA.
Important
Do not change the interface as any change will cause a system dump.
Delete the source code of the new, copied function module. Add your own
logic to the new function module.
All other object types
For all other object types, you must copy function module
/OPT/VIM_IIC_GET_OBJECT_DATA to a Z* or a Y* function module, for ex-
ample Z_IIC_GET_OBJECT_DATA.
Important
Do not change the interface as any change will cause a system dump.
Delete the source code of the new, copied function module. Add your own
logic to the new function module.
2. Execute the /N/OPT/SPRO transaction and follow the menu path LiveLink VIM -
Configuration > Central Reporting > Integrated Invoice Cockpit > Extensions
to Support Customer Workflow Tasks > Maintain Function Modules to Read
Object Related Information.
Note: The data element of the customer specific fields gives the field label,
for example the column heading.
5. Save the append structure and add it to a transport request.
Important
Do not change the interface as any change will cause a system dump.
2. Delete the source code of the new, copied function module. Add your own logic
to the new function module.
For more information about the importing and exporting parameters and how
to implement the customer specific logic, see the function module
documentation of /OPT/VIM_IIC_UPDATE_CUSTFIELDS in the SAP system.
3. Execute the /N/OPT/SPRO transaction and follow the menu path LiveLink VIM -
Configuration > Central Reporting > Integrated Invoice Cockpit > Extensions
for Customer Specific Fields > Maintain Function Module to Update
Customer Specific Fields.
Groups are the highest level unit in the Summary Report. They have one or
more Category IDs assigned to them. In the Report output, groups appear as
headings. Baseline configuration provides the following group IDs:
In process
Invoices that are in VIM processes
Pre Processed
Invoices that are in OCR processing
Processed
Invoices that are posted
Others
Invoices that have statuses, for example Obsolete, or Rescan completed
2. To configure the mapping of Category IDs and text, double-click Category
id/text Configuration in the Dialog Structure panel. Each category is assigned
to a group ID. Baseline configuration provides the following category IDs:
StatusCode
Enter the Status Code for the Category ID. You can assign multiple Status
Codes for each Category ID.
When the Summary Report is run, the program distinguishes the invoice
documents depending on the Status Code. Then, the program categorizes
and displays the Category (text) in the report, as a subsection of the Group.
If the Status Code of a Category is not found in the Summary Report, the
corresponding Category Text is not displayed in the report.
4. To configure the assignment of Category IDs and Group IDs, double-click
Category/Group ID configuration in the Dialog Structure panel.
2. To invoke the View Cluster Maintenance screen, execute the AOBJ transaction.
3. Select Archiving Object /OPT/DOC and click .
Important
Do not change the Structure Definition of the archiving object; see the
following screenshot. This would cause inconsistency between the
programs and the structure.
5. Assign the logical file name created in step 1 to the archiving object in the
Logical File Name field.
6. Enter the customizing settings for the archiving object for Archive File Size and
Settings for Delete Program according to your requirements.
Note: The Baseline settings provided are for guidance only.
Important
Do not change the Structure Definition of the archiving object, see the
following screenshot. This will cause inconsistency between the
programs and the structure.
5. Assign the logical file name created in step 1 to the archiving object in the
Logical File Name field.
6. Enter the customizing settings for the archiving object for Archive File Size and
Settings for Delete Program according to your requirements.
Note: The Baseline settings provided are for guidance only.
2. Check the values in table EKKO, field STATU, for SRM related purchase orders
and maintain the appropriate statuses in the Constant Value field, separated by
semicolons.
3. Click to save your settings.
The function module /OPT/S_DETERMINE_SRM_PO_TYPE uses this constant value
to determine if a purchase order is an SRM related purchase order.
Z constant VIM 5.2 SP4 introduces the Z constant SRM_PO_CHECK for the product code LIX. This
SRM_PO_CHECK Z constant enables you to write custom logic to determine if a particular PO is an
SRM PO. You must write the custom logic in a custom function module. This
function module is called from the standard function
/OPT/S_DETERMINE_SRM_PO_TYPE. Your custom function module must have the
same interface as the standard function module /OPT/S_DETERMINE_SRM_PO_TYPE.
Program to rerun Schedule the program /OPT/CR_RERUN_RULES_JOB to clean up the work item
rules waiting after the number of retries exceeds or the time limit from last run exceeds.
This program publishes the events PSS_Completed and
ProcessCompletedExternally which will complete the wait step. The business
rules will be rerun. After the number of retries exceeds or the wait period completes,
the work item will be routed to the AP Processor.
Option to send VIM Baseline contains the option ID 2740 which will enable the AP Processor to
email send an email to the SRM user. You can configure the email text based on the mail
configuration ID maintained in the process option. See “Configuring the SRM Mail
Infrastructure” on page 546 for details on how to maintain the email text.
2. Enter the SRM Quantity Block process type in the Constant Value field. The
OpenText Baseline value is 162.
The maximum number of days (delay time) will be based on the process type.
The delay time will be calculated as the Maximum Number of retry time
multiplied by the Maximum Retry time limit.
The Email Receiver function module to get the receivers is also derived from the
process type.
3. Click to save your settings.
2. Enter the mail configuration ID in the Constant Value field and save your
settings. For details on the mail configuration ID, see “Configuring the SRM
Mail Infrastructure” on page 546.
2. Enter the initial actor's role in the Constant Value field and save your settings.
2. Enter the mail configuration ID in the Constant Value field and save your
settings. For details on the mail configuration ID, see “Configuring the SRM
Mail Infrastructure” on page 546.
1. In the VIM Customizing IMG, under SRM Integration (see “Configuring SRM
Purchase Orders” on page 539), open .
2. Enter the initial actor's role in the Constant Value field and save your settings.
2. Enter the amount of time for the wait period (in days) in the Constant Value
field and save your settings.
2. Enter EXTENDED_CLASSIC or CLASSIC in the Constant Value field and save your
settings.
2. To add a new entry, click New Entries in the application tool bar.
Text Block 3
Enter a text object for the conclusion and/or the address of the email
generating location. For example, /OPT/VIM_DP_SRM_QTY_FOOTER is a text
for the email footer.
Include Image Attachment
Select this check box to attach the invoice image to the email.
URL Function Module
Enter the function module that will generate the URL for user reference. This
URL will contain the tracking information for the PO. For example, the
function module /OPT/CNOTIF_GET_URL_LIST populates the URL with the
following parameters:
Importing parameters
I_MAIL_CFG_ID
Mail configuration ID
I_OBJTYPE
Object type
I_OBJKEY
Object key
Exporting parameters
T_URL
Table of URLs
URL
Enter a URL that is used in the mail body, in case the URL generating
function module is not maintained.
Line Item Function Module
Enter the function module that will populate the line item information and
construct the table. For example, the function module
/OPT/CNOTIF_GET_LINE_ITEM_DATA will populate the line item information
with the following parameters:
Importing parameters
I_MAIL_CFG_ID
Mail configuration ID
I_OBJTYPE
Object type
I_OBJKEY
Object key
I_GROUP_BY
Group by (used as SRM PO Requester in baseline)
Exporting parameters
T_LINE
Table parameter, with PO line item information
4. To configure the mail fields which need to be populated in the email content,
double-click Mail field list and description in the Dialog Structure panel.
The list shows all object key fields that can be shown in the email. These fields
derive from the object type defined in step 3 on page 548.
5. Maintain the field description.
Note: You can maintain the field description in different languages.
Therefore, log in using a different language.
6. To configure the mail subject line, double-click Mail subject/Title in the Dialog
Structure panel.
Maintain the (language dependent) mail subject. The mail sending function
module will populate the appropriate subject if it is not set while invoking the
mail.
In the example, the Image File extension TIF is maintained for the archive
object type /OPT/ICC. For /OPT/ICC, invoice images will be archived and
attached to emails as *.TIF.
AP processor
Accounts Payable personnel
Archive system
Computer system that enables storage, management and retrieval of archived
data and documents
ArchiveLink
Service integrated in the SAP Web Application Server for linking archived
documents and the application documents entered in the SAP system
Authorization profiles
The SAP administrator assigns authorizations to the users that determine which
actions a user can execute in the SAP system. These authorizations are stored in
Authorization profiles.
BAdI
See: Business Add-Ins (BAdI)
Baseline
Set of functionality with pre-defined configuration and the starting point to
implement VIM
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
See: Business Transaction Event (BTE)
Business rules
Rules that describe the operations, definitions and constraints that apply to an
organization
Buyer
Person who is in charge of the PO. This role should have authorization to create
and change the purchase order. This role is also responsible for negotiating and
communicating with vendors.
COA
See: Approval chart of authority (COA)
Coding
Coding allocates an invoice to G/L account and cost object if required.
Contract agent
Person who can create and modify SAP contracts.
Dashboard
User interface that organizes and presents information in a way that is easy to
read. Users can also perform actions from the dashboard.
DocuLink
OpenText DocuLink enables the archiving, management and retrieval of CRM or
ERP documents from within the SAP infrastructure.
Document type
Type of document such as PO, Non PO, OCR, Non OCR
DP
See: Document Processing (DP)
Duplicate analyzer
Person who is responsible to identify duplicate invoices
Exception
Action that is not part of normal operations or standards
FI
See: Financial Accounting (FI)
IAP
See: Invoice Approval (IAP)
ICC
See: Invoice Capture Center (ICC)
IE
See: Invoice Exception (IE)
Indexer
Person responsible for entering index data
Indexing
Process of entering or storing data into the system
Information provider
Receiving role for option Refer for Information
Invoice approver
Person who approves invoices
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
LIV
See: Logistic invoice (LIV)
MM
See: Materials Management (MM)
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 system
OCR
See: Optical character recognition (OCR)
Park
Situation where an invoice is not posted and is waiting for further processing
PIR
See: Non purchase order (Non PO) invoice (PIR)
PO
See: Purchase order (PO)
Price variance
Situation where the price on the invoice is different from the price in the
purchase order
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.
Quantity variance
Situation where the quantity on the invoice is different from the quantity in the
purchase order
Receiver
Person who can create and reverse the goods receipt in SAP
Requisitioner
Person who requested goods and services
Roles
Set of predefined roles for the SAP user
Scan operator
Person who scans the invoices into images (may not have a SAP ID)
Service approver
Person who approves a service entry
Service requisitioner
Person who enters a service entry
Swimlane
Diagram representing a specific VIM process. A swimlane comprises the process
description, roles, user interface and options of the process.
Tax expert
Person who advises on invoices that need tax audit. Normally tax department
personnel.
VAN
See: VIM Analytics (VAN)
Vendor maintenance
Person who is responsible for creating and maintaining the vendor master
records
Workflow
SAP business workflows can be used to define business processes that are not
yet mapped in the R/3 system.
Indexing line matching from OCR results multi level approval 201
Document Processing 94 optional coding 241
India override 220
country specific configuration 374 overview 196
screen fields 376 parking reason 198
vendor data download 376 people involved 196
Individual report configuration 511 posted approval 260
Integrated Invoice Cockpit configuration process basics 200
511 process end 196
Summary Report configuration 522 process trigger 196
Integrated Invoice Cockpit configuration process type 198
authorization for approval and rejection referral wait time 258
515 rejection reason 243
customer specific fields 520 resubmit for approval action codes 245
customer workflow tasks 515 roles 216
individual report configuration 511 search help for web screen fields 215
layout variants 511 standard validations 240
System Landscape Directory 511 substitution 220
Invoice Approval 195 supported currency 249
access rights 204 supported language 249
approval flow for DP invoices 201 swimlane 196
approval flow for parked invoices 201 tax calculation on net amount 259
approval hierarchy 203 trigger points 200
approval level 203 user map maintenance 218
approval on mobile device 275 user map object 218
approver persona 219 usermap data source 251
approver role 217 usermap modification 252
automatic maintenance 218 usermap web ID 252
BAdI validation for Non PO invoices 233 Invoice categories
bulk approval validation exit 260 country specific configuration 357
certify message 208 Invoice list fields
Chart of Authority 223 approval on mobile device 280
coder role 216 Item field labels
coding validation 233 approval on mobile device 284
configuration outline 197
configuring cross company coding 242 K
cross company coding 242 KPI Dashboard 289
custom approver class 248 aggregation job 296
custom buttons 253 amount classes 309
custom fields 256 authorizations 331
custom invoice class 248 channel IDs 320
custom usermap class 250 collection job 294
delegation 220 company code groups 304
email notification 204 company code groups prerequisite 332
expense type 203 constants 313
General Ledger fields 209 customizing settings 301
global parameters 245 definitions 291
image display infrastructure 244 exception classes 310
manual maintenance 218
Roles 29 SRM
assign templates 35 use cases 535
defining 29 SRM integration 535
defining templates 31 archiving image file extensions 551
Invoice Approval 216 configuring SRM purchase orders 539
maintaining 29 determining purchase order types 538
maintaining determination 37 mail infrastructure 546
Roles in Document Processing 70 missing goods receipt scenario 540
Rollout criteria price discrepancy scenario 543
Non PO parking process 173 quantity discrepancy scenario 541
SRM scenario type 546
S SRM scenario type
SAP ArchiveLink document types SRM integration 546
creating 45 SSF integration 437
SAP business objects Business Context links 461
linking to ArchiveLink document types 27 maintain logical system in OpenText
SAP NetWeaver Portal integration configuration tables 479
KPI Dashboard 326 new ITS service in the backend ERP
SAP Tax Determination Logic 66 system 438
SAP Tax Determination Logic with OT Tax OpenText linked objects in Service
Table 64 Request 461
SAP Web Dynpro settings OpenText Vendor Factsheet BSP
KPI Dashboard 320 component 467
Scan locations prefill business role settings for RFC 480
process configuration 112 transaction launcher (account ID
Screen buttons confirmation) 455
approval on mobile device 277 transaction launcher (Service Request)
Screen exits 448
PO parking process 137 transaction launcher logical systems and
Screen fields URL 446
India 376 work center configuration 456
Search help for web screen fields SSF integration activities 437
Invoice Approval 215 Standard validations
Secure connection Invoice Approval 240
KPI Dashboard 325 Substitution
Selection screen: adding user items Invoice Approval 220
VIM Analytics 333 Success messages
Send back functionality exit BDC IDs 81
PO blocking process 167 Summary Report configuration
Sequence steps individual report configuration 522
defining 55 Supplier Relationship Management
Service requests initialization procedure use cases 535
CRM integration 481 Supplier Relationship Management (SRM)
Settings integration 535
KPI Dashboard 312 configuring SRM purchase orders 539
Ship-to-region determining purchase order types 538
Canada 377 Supported currency
SLD Invoice Approval 249
multiple backend system 427
W
Work center configuration
SSF integration 456
Work item text
changing 350
Workflow template
ICC Dispatcher 414
Z
Z constants
country specific configuration 374