Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameter name

Description

Example

PI: Ignore parent message during TC creation

This flag is used for scenarios with multiple receivers. If you create a test case based on the message that is part of the bigger scenario, then engine will search for the initial message that SAP PI/PO received.
This requires at least logging the BI processing step (as SAP does not recommend staging).
If you would like to create the test case for a single receiver or the BI logging is not available, then you need to check this checkbox

Message version before processing

A version of the message to be fetched from the SAP PI/PO persistence. Here we specify the version which contains the original message - before being processed by SAP PI/PO. If empty, Global Parameter is used.

Depending on the SAP PI version can be either:

numeric: 0
caption: EDI

Message version after processing

A version of the message to be fetched from the SAP PI/PO persistence. Here we specify the version which contains after mapping version of the message - already processed by SAP PI/PO.  If empty, Global Parameter is used. 

Depending on the SAP PI version can be either:

numeric: -1
caption: AM

Read Successor Message(s) based on Reference ID

Collect output messages from subsequent ICOs based on Reference ID instead of parent relation

 

Ignore messages from interfaces

Used when ‘Read Successor Message(s) based on Reference ID’ parameter is set to exclude messages from specified interfaces from saving

Output Automation Object

Automation Object(s) used to read the output payloads. This parameter allows for testing scenarios where message is injected into one ICO and results are compared on a different one.
Automation Objects(s) of type 5 ( PI Outbound) and 20 (PI Unit Test) are allowed to be used.

Child Test Case Automation Object

Automation Object(s) used to link and create child test cases. This parameter allows for automatic creation of linked outbound test cases during save.

Following Automation Object types can be used as child:

5 PI E2E Outbound
7 IDoc Outbound
13 SAP CPI E2E Outbound

PI: Allows Receiver interface be same as Sender interface

For pass-through interfaces

In particular scenarios, sender and receiver interfaces may be the same, for instance, in the EDIFACT scenario. If this parameter is not provided and the sender is the same as the receiver interface, no test case would be created for such messages, or during execution, an error may occur.

X

...

Parameter name

Description

Example

Inject using PIT

This flag will use SAP PIT WS as a message injector (SAP PO > 7.5 SP14) for this automation object.

This flag can be set up also globally for whole environment.

HTTP RFC Destination

Alternative RFC Connection where the REST message should be sent. If this parameter is populated, then the message will be sent there alternative RFC.

SAPSYS1_RFC

PI: Asynchronous: Direct HTTP operation

If the Direct HTTP URL is provided, here you can specify the HTTP operation (for asynchronous REST testing).

POST

PI: Asynchronous: Direct HTTP URL

Direct endpoint to tested interface (asynchronous). Fulfillment of this parameter is a mandatory condition for testing asynchronous REST/JSON interfaces.

/RESTAdapter/webshop/material_async

PI: Reference Sender Channel Name

Name of the sender channel to be used as a reference. 

CC_SOAP_SENDER

PI: Reference Sender Channel BC

Business Component of the sender channel to be used as a reference. 

BC_SENDER

PI: Reference Sender Channel Party

Party of the sender channel to be used as a reference. 

SENDER_PARTY

Flag for

Flat File interfaces

Used to mark interface input as Flat File

Flat File Line Separator

The character used for end-of-line determination in Flat File messages: for example, CLRF - Unix. The parameter is used to display the comparison report better and display the reference and new message line by line.

"Carriage Return and New line" character should be stored as CRLF

"Line Feed" should be stored as LF (Unix based files)

Separator can be also specified using hexadecimal representation of Numeric Character Reference (NCR).

There is no default value, so the parameter is obligatory for CSV files

CLRF

 

NCR Use || to enter multiple alternative separators e.g. CLRF||'

CLRF

 

NCR Example:


Line Separator Escape Character

Escape character for line separator. Used to avoid line breaks in case separator is used in the file content.
Value of this parameter should be aligned with specific format used by tested interface.
Example: If line separator is set to ' and escape character is ? following split is applied:

Source:
NAD+SU+8720121000874::3++Test?'file'NAD+SU+8236459000874

Split:
NAD+SU+8720121000874::3++Test?'file'
NAD+SU+8236459000874

Flat Files Compare with payload validations applied

If this checkbox is checked, Payload Validation rules are applied before files comparison and the match content is replaced by the placeholders. This can in some cases result in better flat file comparison results, especially in case of many missing lines.

Stop Receiver Processing

Stops Receiver Processing when using PIT as a message injector.

Do not fail TC if DB reference not found

This flag determines if in the situation when DB validation for reference messages have not been found whether it should be treated as Error or Successful message.

Checked or 'X' - if reference document is not found test case will not be failed

Unchecked or '' - if reference document is not found test case will be failed (default setting)

...

Parameter name

Description

Example

PI: Message Search - Interface Name

Used to specify the Interface Name within which the Message Selector should search for the version of the message. This parameter is only to be entered if Interface Name visible in the Message Monitor main screen differs from the Interface Name used to create the object definition. 

If we only have receiver interfaces visible in the message monitor, then use the receiver name specified in the ICO of the sender interface specified in the automation object used.

PI: Message Search - Namespace

Used to specify the Interface Namespace within which the Message Selector should search for the version of the message. This parameter is only to be entered if Interface Namespace visible in the Message Monitor main screen differs from the Interface Namespace we have used to create the object definition.

The same condition as the previous parameter but then for the namespace of the receiver interface

Include Page
isMissingRequiredParameterstrue

Backend Systems

...

Parameter name

Description

Example

Backend system line for current doc.

This parameter points out the system where the reference backend document is stored. The value should be a system line described in the landscape configuration.

Note:

If Backend system line for the current doc. has the same value as the Backend system line for the reference doc. (for instance, both are S4/HANA) then the RFC connection between the systems will be maintained both in:

a) the original environment of the reference document (for instance, production system)

b) the environment where the current test case execution takes place (for instance, development system) 

If Backend system line for the current doc. is different than the Backend system line for the reference doc. then, the RFC connection will be maintained only in the environment of the current execution (for instance, development system), but for both system lines (like ECC and S4HANA) 

ECC

SAP_ERP

Backend system line for reference doc.

This parameter points out the system line where Int4 Suite should create test documents during test case execution. In most cases, reference documents and documents created during current test execution are stored in the same system line. However, suppose Int4 Suite is used in a migration scenario (for example, migration from ECC to S4/HANA). In that case, the documents might be created in the new system and then compared with the references from the old system.

The value should be a system line described in the landscape configuration.

Note:

If Backend system line for the current doc. has the same value as the Backend system line for the reference doc. (for instance, both are S4/HANA) then the RFC connection between the systems will be maintained both in:

a) the original environment of the reference document (for instance, production system)

b) the environment where the current test case execution takes place (for instance, development system) 

If Backend system line for the current doc. is different than the Backend system line for the reference doc. then, the RFC connection will be maintained only in the environment of the current execution (for instance, development system), but for both system lines (like ECC and S4HANA) 

S4HANA

...

Parameter name

Description

Example

Database validation ruleset

Reference database validation ruleset object name.

Database validation ruleset specify how related backend validation should be performed. Specify tables, fields and join conditions for the backend validation.

Buttons allow navigation to the chosen database validation ruleset and creation of a new database validation ruleset
DB Validation Rulesets

GENERIC_SO

Dynamic Columns

...

Persist reference DB Data

When switched on, DB reference data will be fetched from backend system during test case creation. Otherwise, it will be fetched during test case execution.

https://int4support.atlassian.net/wiki/spaces/IUM/pages/2062843993/Automation+Objects#Database-Validations

Dynamic Columns

...

Dynamic Column Set field allows to assign previously defined set to an Automation Object. A dynamic column set defines additional, custom columns in the result list of message selector.

excerpt-include
PI Unit TestPI Unit Testnamevariablesint4rcl:_Text, AO Variables
int4rcl:_Text, AO Variables

Payload Validations

...

Output payloads after processing by SAP PI/PO are validated against previously stored references. This configuration enables adding rules with exceptions that will allow for differences.

...

Parameter name

Description

Example

Description

Free text for the exception rule

Field1

Expression Type

Expression type. Available options:

  • unspecified

  • XPath

  • Flat expression

This field is optional for all interfaces where there is a single type of output. However, for interfaces that output might be both XML and flat file, it is mandatory to specify the expression type.

XPath

Expression

Path pointing to the field/node where the exception should be applied.

//ORDER/DATE/text()  (XPATH expression) or

START_TAG(BGM+220+)&&END_TAG(+)&& (Flat file expression) or

$.order.date (JSONPath expression)

REGEX(BGM\+220\+(.*)\+) (REGEX expression)

Rule

Rule to be applied to the field.

  • Warning

Marks the compared fields with yellow color as a "warning".

  • Warning when different based on variable replacement

In case compared values are different Int4 Suite compares them with specified variable. If reference/current value pair from comparison matches variable values result is marked as "warning".

Variable name used for checking the values has to be specified in the Processing Parameter column.

  • Warning when different based on value mapping object

In case compared values are different Int4 Suite compares them with specified values in the Mapping Object. If reference/current value pair from comparison matches mapping values result is marked as "warning".

Mapping Object name used for checking the values has to be specified in the Processing Parameter column.

  • Ignore

Even if it is different in the content, it is not highlighted.

  • Change Request

The difference will be highlighted green in the test report.

Note

These rules are active only when Test Case is run within Test Run type: Change Request Test

 

Parameter

Used in correlation with Warning Rules.

...