Skip to main content

xSuite Interface Windows Prism 5.x – Online Help

Output Systems "SapXSuiteInterfaceNCo", "SapXSuiteInterfaceNwRfc"

The output systems "SapXSuiteInterfaceNCo" and "SapXSuiteInterfaceNwRfc" transfer data to the SAP function module of xSuite Interface (/WMD/FP_IMPORT).

The two output systems differ primarily in the interface technology used. Both output systems require additional libraries that are not supplied. The following libraries must be downloaded from SAP and copied to the xSuite Interface program directory:

Output system

Interface technology

Required files

SapXSuiteInterfaceNCo

SAP .NET Connector

SapXSuiteInterfaceNwRfc

SAP NETWeaver

The following properties are available for both output systems.

Property

Description

OutputSystem[].ConnectionParam[](*§)

Subparameters with key/value pairs of the parameters for the connection to the SAP system

  1. Name: Key name of the parameter

  2. Value: value of the parameter

Notice

Available key names include AppServerHost, SystemNumber, User, Password, Client, and Language.

This documentation does not include a complete list of the key names available. The list is stored in the Configurator.

OutputSystem[].ConnectionString(§)

Alternative method to set the SAP connection parameters in the form of a complete connection string

Following is the syntax of the connection string:

{Name}={Value}; {Name}={Value}; …

The individual Name and Value parameters correspond to those of the ConnectionParam[]property.

OutputSystem[].FunctionImport

Name of the function module for regular import and update of records

This function module must be called on the SAP side.

Default value: /WMD/FP_IMPORT

OutputSystem[].UpdateFilesMode(%)

Working mode for the case that, for an existing SAP data set, not only its index data but also file attachments are to be updated:

  • None: no update (default value)

  • Also: update of index data and file attachments

  • Only: update of only file attachments

OutputSystem[].FunctionAddFiles(*)

Name of a separate SAP function module for updating file attachments

If the Also or Only work mode is used, specify this function module (e.g., /WMD/FP_ATTACH_IMAGE).

OutputSystem[].Application*(%)

Name of application (SAP import parameter "IV_APPL")

OutputSystem[].ApplicationNew(%)

New name of the application, used if the name is to be changed in the course of a data-record update (SAP import parameter "IV_APPL_NEW")

OutputSystem[].ArchiveDocId(*%)

Reference to a file attachment that has already been archived in advance (SAP import parameter "ARC_DOC_ID")

If omitted, the file attachments are transferred to the SAP function module in binary form and only archived there via the ArchiveLink interface. When using a reference, only the transfer of a single file is supported.

OutputSystem[].RecordNoField(*)

Name of a field from the field catalog that contains the existing SAP record number in the case of a record update (SAP import parameter "IV_RECNO")

The existence of a value in this field also implicitly controls whether a new creation or an update of a record is performed. In the case of a new creation, the generated record number is written back to this field.

OutputSystem[].TextContent(%)

Value that is passed to SAP as content of a special long text field (import table "IT_TEXT") (optional)

OutputSystem[].ArcTableParam[](*)

Definition of the metadata to be transferred for the file attachments of a document (SAP import table "IT_ARC")

The configuration values consist of the following sub-parameters:

  1. Name*: name of the SAP import parameter

  2. FileName: file name pattern (optional)

  3. Value*(%): value to be transferred

The following SAP parameter names can be set in the import table:

  • SAP_OBJECT: ArchiveLink business object type

  • ARCHIV_ID: content repository ID

  • AR_OBJECT: document type

  • DOC_TYPE: ArchiveLink document class

  • FILENAME: file name

  • CREATOR: user name

  • DESCR: file description

  • CREATIME: file creation date

In the value of the file name, you can use the variable %FileName%. This variable represents the current name of a file attachment; it is also the default if this parameter is not configured.

For the same SAP parameter, several alternative entries can be configured that differ in the file name pattern of the FileName parameter and the Value. For each SAP parameter, the name of a file attachment is then compared with the patterns in the order of their definition. The first entry found whose pattern matches will be used.

The field names used in the .OutputName are sent to SAP in the "NAME" parameter of the import table "IT_FIELDS". The field names must correspond to the names of the target fields configured on the SAP side. The SAP-compliant formatting of the textually transferred field values happens implicitly, provided that no deviating .OutputFormat is defined and the field values are of the correct data type. Date fields are passed in the format "yyyyMMdd" and numeric fields in the format "0.00".

In this section: