Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Ausgabesysteme "SapXSuiteInterfaceNCo", "SapXSuiteInterfaceNwRfc"

Die Ausgabesysteme "SapXSuiteInterfaceNCo" und "SapXSuiteInterfaceNwRfc" übergeben Daten an den SAP-Funktionsbaustein von xSuite Interface (/WMD/FP_IMPORT).

Die beiden Ausgabesysteme unterscheiden sich primär in der eingesetzten Schnittstellentechnologie. Beide Ausgabesysteme benötigen zusätzliche Bibliotheken, die nicht mit ausgeliefert werden. Die folgenden Bibliotheken müssen bei SAP heruntergeladen werden und in das Programmverzeichnis von xSuite Interface kopiert werden:

Ausgabesystem

Schnittstellentechnologie

Benötigte Dateien

SapXSuiteInterfaceNCo

SAP .NET Connector

SapXSuiteInterfaceNwRfc

SAP NETWeaver

Die folgenden Eigenschaften sind für beide Ausgabesysteme verfügbar.

Eigenschaft

Beschreibung

OutputSystem[].ConnectionParam[](*§)

Teilparameter mit Schlüssel-/Wert-Paaren der Parameter für die Verbindung zum SAP-System

  1. Name: Schlüsselname des Parameters

  2. Value: Wert des Parameters

Hinweis

Die verfügbaren Schlüsselnamen sind z. B. AppServerHost, SystemNumber, User, Password, Client und Language.

Eine vollständige Liste der verfügbaren Schlüsselnamen ist nicht Bestandteil dieser Dokumentation. Die Liste ist im Konfigurator hinterlegt.

OutputSystem[].ConnectionString(§)

alternative Methode zum Setzen der SAP-Verbindungsparameter in Form einer vollständigen Verbindungszeichenfolge

Die Verbindungszeichenfolge hat die folgende Syntax:

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

Die einzelnen Name- und Value-Parameter entsprechen denen der Eigenschaft ConnectionParam[].

OutputSystem[].FunctionImport

Name des Funktionsbausteins für den regulären Import und die Aktualisierung von Datensätzen

Dieser Funktionsbaustein muss auf SAP-Seite aufgerufen werden.

Standardwert: /WMD/FP_IMPORT

OutputSystem[].UpdateFilesMode(%)

Arbeitsmodus, wenn bei einem bestehenden SAP-Datensatz nicht nur dessen Indexdaten, sondern auch Dateianlagen aktualisiert werden sollen:

  • None: keine Aktualisierung (Standardwert)

  • Also: Aktualisierung von Indexdaten und Dateianlagen

  • Only: Aktualisierung nur von Dateianlagen

OutputSystem[].FunctionAddFiles(*)

Name eines separaten SAP-Funktionsbausteins für die Aktualisierung von Dateianlagen

Dieser Funktionsbaustein muss angegeben werden, wenn der Arbeitsmodus Also oder Only verwendet wird, z. B. /WMD/FP_ATTACH_IMAGE.

OutputSystem[].Application*(%)

Name der Applikation (SAP-Importparameter "IV_APPL")

OutputSystem[].ApplicationNew(%)

neuer Name der Applikation, wenn der Name im Zuge eines Datensatz-Updates geändert werden soll (SAP-Importparameter "IV_APPL_NEW")

OutputSystem[].ArchiveDocId(*%)

Referenz auf eine bereits vorab archivierte Dateianlage (SAP-Importparameter "ARC_DOC_ID")

Bei Weglassung werden die Dateianlagen in Binärform an den SAP-Funktionsbaustein übergeben und erst dort über die ArchiveLink-Schnittstelle archiviert. Bei der Nutzung einer Referenz wird nur die Übergabe einer einzelnen Datei unterstützt.

OutputSystem[].RecordNoField(*)

Name eines Feldes aus dem Feldkatalog, das im Fall eines Datensatz-Updates die bestehende SAP-Satznummer beinhaltet (SAP-Importparameter "IV_RECNO")

Über die Existenz eines Wertes in diesem Feld wird implizit auch gesteuert, ob eine Neuanlage oder ein Update eines Satzes durchgeführt wird. Bei einer Neuanlage wird die generierte Satznummer in dieses Feld zurückgeschrieben.

OutputSystem[].TextContent(%)

optionaler Wert, der als Inhalt eines speziellen Langtextfeldes an SAP übergeben wird (Importtabelle "IT_TEXT")

OutputSystem[].ArcTableParam[](*)

Definition der zu übergebenden Metadaten zu den Dateianlagen eines Dokumentes (SAP-Importtabelle "IT_ARC")

Die Konfigurationswerte bestehen aus den folgenden Teilparametern:

  1. Name*: Name des SAP-Importparameters

  2. FileName: optionales Dateinamensmuster

  3. Value*(%): zu übergebender Wert

Folgende SAP-Parameternamen können in der Importtabelle gesetzt werden:

  • SAP_OBJECT: ArchiveLink-Business-Objekttyp

  • ARCHIV_ID: Content-Repository-ID

  • AR_OBJECT: Dokumentart

  • DOC_TYPE: ArchiveLink-Dokumenttyp

  • FILENAME: Dateiname

  • CREATOR: Benutzername

  • DESCR: Dateibeschreibung

  • CREATIME: Erstellungsdatum der Datei

Im Wert des Dateinamens kann die Variable %FileName% verwendet werden. Diese Variable repräsentiert den aktuellen Namen einer Dateianlage und stellt auch die Vorbelegung dar, wenn dieser Parameter nicht konfiguriert ist.

Für denselben SAP-Parameter können mehrere alternative Einträge konfiguriert werden, die sich im Dateinamensmuster des FileName-Parameters und dem Value unterscheiden. Pro SAP-Parameter wird dann der Name einer Dateianlage mit den Mustern in der Reihenfolge ihrer Definition verglichen. Der erste gefundene Eintrag, dessen Muster passt, wird genutzt.

Die Feldnamen, die im .OutputName verwendet werden, werden im "NAME"-Parameter der Importtabelle "IT_FIELDS" an SAP übergeben. Die Feldnamen müssen den Namen der Zielfelder entsprechen, die auf der SAP-Seite konfiguriert sind. Die SAP-konforme Formatierung der textuell übergebenen Feldwerte erfolgt implizit, sofern kein abweichendes .OutputFormat definiert ist und die Feldwerte im korrekten Datentyp vorliegen. Datumsfelder werden im Format "yyyyMMdd" und numerische Felder im Format "0.00" übergeben.

In diesem Abschnitt: