Funktionsbaustein-/Methodendefinitionen (X4 SAP JCo 2)

In einem Konfigurations-Dokument (standardmäßig <X4>/X4DB/0/jco_method_def.xml) kann für jeden Funktionsbaustein (Methode), die vom SAP-Host angesprochen wird, über den JCo 2 Server ein entsprechender X4-Prozess zur Weiterverarbeitung zugeordnet werden.

In der zentralen Konfigurationsdatei <X4>/X4config.xml muss für jede JCo Server-Instanz jeweils eine Funktionsbaustein-/Methodendefinition referenziert werden.

Erwartete XML-Struktur

In der Funktionsbaustein-/Methodendefinition können Sie innerhalb des Wurzel-Elements <definitions> beliebig viele Elemente <method> nach folgendem Muster anlegen:

HTML/XML

<method>
  <name><!--Funktionsbaustein-/Methodenname--></name>
    <wait_for_result><!--Boolescher Wert--></wait_for_result>
    <class>de.softproject.integration.sapjcoserver.requesthandlers.WorkflowStarter</class>
    <properties>
      <property Name="workflowname"><!--Pfad zum X4-Prozess--></property>
      <property Name="userID"><!--Benutzerordner in X4DB--></property>
      <property Name="raw"><!--Boolescher Wert--></property>
    </properties>
</method>

Für jede Funktionsbaustein-/Methodendefinition gilt:

Element <name> enthält den Namen des durch SAP aufgerufenen Funktionsbaustein (Methode); Der Platzhalter * steht für alle anderen Funktionsbausteine , für die kein expliziter Funktionsbaustein definiert wurde.
In Element <wait_for_result> können Sie konfigurieren, ob SAP auf die Antwort warten soll (false), oder ob der Funktionsbaustein-/Methodenaufruf asynchron erfolgt (true).
Element <class> gibt die verwendete Klasse an, die zur Verarbeitung des Funktionsbausteins (bzw. der Methode) hinterlegt ist (normalerweise ist dies de.softproject.integration.sapjcoserver.requesthandlers.WorkflowStarter zum Starten von X4-Prozessen); in den Kindelementen von <class> geben Sie die zugehörigen Eigenschaften in jeweils einem Element <property> an.

Für die X4-Prozess-Starterklasse werden folgende Eigenschaften angegeben:

workflowname: Pfad zum X4-Prozess, der die Verarbeitung des Funktionsbaustein-/Methodenaufrufs übernimmt
userID: Repository-Benutzerordner, in dem der X4-Prozess liegt
raw: IDoc im Raw-Format verarbeiten (true) oder (false)

Hinweis:

In älteren Funktionsbaustein-/Methodendefinitionen finden sich ggf. zusätzliche Angaben in einem Element <type> und in einem Element <property Name="languageID">. Diese besitzen keine Funktion und können daher weggelassen werden.

Beispiel

Im folgenden Beispiel wird für den Funktionsbaustein (Methode) ORDERS05 der X4-Prozess save_idoc.wrf aufgerufen und es werden Daten im IDoc Raw-Format für die nachgeordnete Verarbeitung bereitgestellt.

HTML/XML

<method>
  <name>ORDERS05</name>
    <wait_for_result>false</wait_for_result>
    <class>de.softproject.integration.sapjcoserver.requesthandlers.
           WorkflowStarter</class>
    <properties>
      <property Name="workflowname">Project/Folder/ProcessIDoc.wrf</property>
      <property Name="userID">1</property>
      <property Name="raw">true</property>
    </properties>
</method>